Files
Gnuboard7/templates/_bundled/gnuboard7-hello_user_template/docs/components.md
T
HeuJung 6c63536f81 docs(core,extensions): 확장 20개 개발자 문서 완비와 문서 소유 이관
번들 확장 20개 전부에 AGENTS.md · README.md · docs/ 를 채우고, 코어가 들고
있던 확장 소유 문서 두 갈래를 그 확장으로 옮긴다. 번들 템플릿의 컴포넌트·
핸들러·레이아웃 상세와 확장이 구독하는 활동 로그 훅 목록이 그 대상이며,
코어에는 총계와 링크만 남아 확장이 기능을 늘릴 때 코어 문서를 고쳐야 하던
역방향 의존이 사라진다.

전수 완비를 확인하고 강제를 조인다 — 문서 동반 룰을 대상 목록 없는 error 로
승격하고, 검사 스크립트가 문서 미보유를 실패로 올리며, 미채움 마커 baseline 을
0 으로 기록한다. 한쪽만 조이면 "새 확장이 문서 없이 들어와도 초록" 인 상태가
남는데 그 결과는 이상 0건과 구분되지 않는다.

집필 과정에서 드러난 생성기 결함 셋을 함께 고친다. 스케줄 주기 열이 계약 키를
읽지 않아 모든 확장에서 '-' 였고, 네임스페이스를 붙인 핸들러 등록 키가 수집에서
통째로 빠졌으며, README 골격이 폐기된 히어로 배지를 계속 찍어내고 있었다.
셋 다 산출물이 아니라 원천이 틀린 것이라, 가드의 모집단에 생성기 출력 자체를
넣어 다음 확장이 같은 상태로 태어나는 경로를 막는다.
2026-08-31 22:57:36 +09:00

1.5 KiB

Hello 사용자 템플릿 — 컴포넌트

템플릿이 제공하는 컴포넌트 · 진입점: AGENTS.md

제공 컴포넌트

컴포넌트 8개 (루트: src/components).

분류 개수
basic 8개

Basic 8개뿐이며 composite·layout 은 없습니다 — HTML 태그를 그대로 래핑한 최소 단위만으로 방문자 화면 골격을 그릴 수 있음을 보이는 구성입니다.

sirsoft-basic 이 79개(basic 38 · composite 36 · layout 5)를 갖는 것과 비교하면 그 차이가 곧 "필수" 와 "그 템플릿의 선택" 의 경계입니다. 상품 카드·이미지 뷰어·모바일 메뉴 같은 것들은 그 템플릿이 자기 화면을 위해 만든 것이지 템플릿의 요건이 아닙니다.

이 목록이 다른 확장과의 계약입니다. 모듈·플러그인이 이 템플릿의 화면에 조각을 끼워 넣을 때 여기 없는 컴포넌트를 쓰면 그 조각은 렌더되지 않습니다.

컴포넌트를 추가할 때는 소스(src/components/{분류}/) · template.json 의 레지스트리 · components.json 을 함께 갱신합니다. 하나라도 빠지면 레이아웃이 그 이름을 찾지 못해 그 컴포넌트만 조용히 렌더되지 않습니다. TSX 를 고쳤으면 template:build --production 후 dist/ 를 함께 커밋합니다.