HeuJung
6c63536f81
번들 확장 20개 전부에 AGENTS.md · README.md · docs/ 를 채우고, 코어가 들고 있던 확장 소유 문서 두 갈래를 그 확장으로 옮긴다. 번들 템플릿의 컴포넌트· 핸들러·레이아웃 상세와 확장이 구독하는 활동 로그 훅 목록이 그 대상이며, 코어에는 총계와 링크만 남아 확장이 기능을 늘릴 때 코어 문서를 고쳐야 하던 역방향 의존이 사라진다. 전수 완비를 확인하고 강제를 조인다 — 문서 동반 룰을 대상 목록 없는 error 로 승격하고, 검사 스크립트가 문서 미보유를 실패로 올리며, 미채움 마커 baseline 을 0 으로 기록한다. 한쪽만 조이면 "새 확장이 문서 없이 들어와도 초록" 인 상태가 남는데 그 결과는 이상 0건과 구분되지 않는다. 집필 과정에서 드러난 생성기 결함 셋을 함께 고친다. 스케줄 주기 열이 계약 키를 읽지 않아 모든 확장에서 '-' 였고, 네임스페이스를 붙인 핸들러 등록 키가 수집에서 통째로 빠졌으며, README 골격이 폐기된 히어로 배지를 계속 찍어내고 있었다. 셋 다 산출물이 아니라 원천이 틀린 것이라, 가드의 모집단에 생성기 출력 자체를 넣어 다음 확장이 같은 상태로 태어나는 경로를 막는다.
2.0 KiB
2.0 KiB
템플릿 전용 핸들러
메인 문서: actions-handlers.md 관련 문서: template-development.md | actions-handlers-ui.md
TL;DR (5초 요약)
1. setLocale: 앱 언어 변경 — 엔진 빌트인 (ActionDispatcher)
2. setTheme/initTheme: 다크/라이트 모드 — 양쪽 템플릿 공통
3. 각 템플릿별 전용 핸들러 → 아래 링크 참조
4. sirsoft-admin_basic: scrollToSection, initMenuFromUrl, filterVisibility 4종, multilingualTag 3종
5. sirsoft-basic: 장바구니 6종, 상품 옵션 2종, 다중 통화 5종, 스토리지 6종
템플릿별 상세 문서
sirsoft-admin_basic은 문서를 그 템플릿이 직접 소유합니다 — templates/_bundled/sirsoft-admin_basic/docs/. 템플릿별 문서 위치는 templates/README.md 를 따릅니다.
엔진 빌트인 핸들러
아래 핸들러는 템플릿과 무관하게 엔진 레벨(ActionDispatcher)에서 제공됩니다:
| 핸들러 | 설명 |
|---|---|
setLocale |
앱 언어 변경 (번역 파일 재로드) |
setLocale은 별도 템플릿 등록 없이 모든 레이아웃에서 사용 가능합니다.
공통 핸들러 (양 템플릿 모두 등록)
| 핸들러 | 설명 | 소스 |
|---|---|---|
setTheme |
테마 변경 (light/dark/auto) | setThemeHandler.ts |
initTheme |
저장된 테마 복원 | setThemeHandler.ts |