@simplysm/sd-claude 14.0.87 → 14.0.89

package/claude/references/sd-simplysm14/README.md

@@ -44,21 +44,20 @@ ORM 호출, 파일 변환, 비즈니스 로직 등은 위 두 경우에 해당
 
 ## 패키지 인덱스
 
-- **angular** — Angular 21 standalone/signal/zoneless 기반 업무 클라이언트 UI 라이브러리. `provideSdAngular` 부트스트랩, 폼/시트/CRUD/모달/토스트/사이드바·탑바·드롭다운/공유데이터·칸반 등 화면 컴포넌트와 인프라 프로바이더 제공. 자세히: [apis/angular/README.md](./apis/angular/README.md)
-- **capacitor-plugin-auto-update** — Android Capacitor 앱에서 APK 자동 업데이트와 APK 설치 권한·버전 조회. 자세히: [apis/capacitor-plugin-auto-update/README.md](./apis/capacitor-plugin-auto-update/README.md)
-- **capacitor-plugin-file-system** — Capacitor 모바일/웹 파일 시스템 접근(권한·경로·디렉토리·파일 IO). 자세히: [apis/capacitor-plugin-file-system/README.md](./apis/capacitor-plugin-file-system/README.md)
-- **capacitor-plugin-intent** — Android 인텐트 브로드캐스트 송수신 및 `startActivityForResult` 연동(산업용 스캐너·PDA·외부 결제 등). 자세히: [apis/capacitor-plugin-intent/README.md](./apis/capacitor-plugin-intent/README.md)
-- **capacitor-plugin-usb-storage** — Android/Browser 에서 USB Mass Storage 장치 목록·권한·디렉토리/파일 읽기. 자세히: [apis/capacitor-plugin-usb-storage/README.md](./apis/capacitor-plugin-usb-storage/README.md)
-- **core-browser** — 브라우저 전용. `Element`/`HTMLElement` 프로토타입 확장, DOM 탐색·포커스·레이아웃 보정, 클립보드/측정, 파일 다이얼로그·다운로드, 진행률 fetch, IndexedDB 키/값 저장소와 가상 파일시스템. 자세히: [apis/core-browser/README.md](./apis/core-browser/README.md)
-- **core-common** — 공통 유틸리티(타입·에러·큐·이벤트·변환·확장 메서드·환경변수). simplysm 모든 패키지의 공용 기반. 자세히: [apis/core-common/README.md](./apis/core-common/README.md)
-- **core-node** — Node 전용 IO/경로/프로세스/감시/consola/worker_threads 래퍼(`fsx`, `pathx`, `cpx`, `FsWatcher`, `setupConsola`, `Worker`/`createWorker`). 자세히: [apis/core-node/README.md](./apis/core-node/README.md)
-- **excel** — xlsx 워크북을 열어 셀·시트·스타일·조건부서식·이미지를 읽고 쓰거나, Zod 스키마 기반 레코드 입출력. 자세히: [apis/excel/README.md](./apis/excel/README.md)
-- **lint** — ESLint flat config 작성 시 `@simplysm/lint/eslint-recommended` 프리셋 또는 `@simplysm/lint/eslint-plugin` 개별 규칙 import. 자세히: [apis/lint/README.md](./apis/lint/README.md)
-- **orm-common** — Dialect 독립 ORM 코어. `DbContext` 서브클래싱 + Table/View/Procedure 빌더 + `expr` AST + `Queryable` 체이닝으로 SQL 을 만들고 dialect QueryBuilder 로 렌더. 자세히: [apis/orm-common/README.md](./apis/orm-common/README.md)
-- **orm-node** — Node 환경에서 `DbContext` 를 MSSQL/MySQL/PostgreSQL 실 연결에 붙이는 어댑터(`createOrm`), raw SQL/bulk insert (`createDbConn`). 자세히: [apis/orm-node/README.md](./apis/orm-node/README.md)
-- **sd-claude** — simplysm 표준 Claude 자산(스킬·룰·훅) 동기화 및 Claude 계정 저장/전환 CLI(`sd-claude auth save`/`switch`). 라이브러리 코드 API 없음. 자세히: [apis/sd-claude/README.md](./apis/sd-claude/README.md)
-- **sd-cli** — simplysm 빌드/배포 오케스트레이션 CLI. 서브커맨드(`check`/`watch`/`dev`/`device`/`build`/`publish`/`replace-deps`/`init`), `sd.config.ts` 작성 타입, Vitest 의 Angular AOT plugin(`sdAngularPlugin`), TS 패키지 증분 컴파일 엔진(`SdTsCompiler`). 자세히: [apis/sd-cli/README.md](./apis/sd-cli/README.md)
-- **service-client** — `@simplysm/service-server` 와 WebSocket 으로 통신하는 클라이언트. RPC·이벤트 구독·파일 업/다운로드·원격 ORM 실행을 단일 `ServiceClient` 에서 제공(Node/브라우저 공용). 자세히: [apis/service-client/README.md](./apis/service-client/README.md)
-- **service-common** — 서버/클라이언트가 공유하는 서비스 프로토콜·메시지·서비스 인터페이스·앱 구조·이벤트 정의. 자세히: [apis/service-common/README.md](./apis/service-common/README.md)
-- **service-server** — Fastify + WebSocket 위에 서비스(`defineService`)·JWT 인증(`auth`)·빌트인 ORM/AutoUpdate/AppStructure·V1 레거시 호환을 부트스트랩(`createServiceServer().listen()`). 자세히: [apis/service-server/README.md](./apis/service-server/README.md)
-- **storage** — FTP/FTPS/SFTP 원격 스토리지에 동일 인터페이스(`StorageClient`)로 파일 읽기/쓰기/관리. 자세히: [apis/storage/README.md](./apis/storage/README.md)
+- **angular** — Angular(zoneless·signal) 업무 프론트엔드 컴포넌트·디렉티브·프로바이더 — 앱 부트스트랩(provideSdAngular)·모달/토스트/busy/인쇄·라우팅/메뉴/권한·폼 컨트롤·레이아웃·sd-sheet·공유데이터·CRUD 화면 골격·주소검색/에디터/차트/칸반을 다룰 때. 자세히: [apis/angular/README.md](./apis/angular/README.md)
+- **capacitor-plugin-auto-update** — Capacitor(Android) 앱에서 APK 설치 인텐트 실행·설치 권한 관리, 서버/외부 저장소 기반 최신 APK 자동 감지·다운로드·설치 흐름을 돌릴 때. 자세히: [apis/capacitor-plugin-auto-update/README.md](./apis/capacitor-plugin-auto-update/README.md)
+- **capacitor-plugin-file-system** — Capacitor 파일 시스템 플러그인. 네이티브(Android 외부/앱 저장소)·브라우저(IndexedDB 에뮬레이션)에서 파일 읽기/쓰기, 디렉토리 조회/생성/삭제, 존재 확인, 권한 확인/요청, 저장소 경로·URI 조회를 static FileSystem 클래스로 제공. 자세히: [apis/capacitor-plugin-file-system/README.md](./apis/capacitor-plugin-file-system/README.md)
+- **capacitor-plugin-intent** — Android 인텐트 송수신 Capacitor 플러그인 — 브로드캐스트 구독/전송·실행 인텐트 조회·newIntent 리스너·startActivityForResult 외부 Activity 실행을 정적 클래스 Intent 로 수행(바코드 스캐너·PDA 연동, 웹은 미지원 스텁). 자세히: [apis/capacitor-plugin-intent/README.md](./apis/capacitor-plugin-intent/README.md)
+- **capacitor-plugin-usb-storage** — USB Mass Storage 장치(Android=libaums 실물, web=IndexedDB 가상)의 장치 목록 조회·권한 요청/확인·디렉토리/파일 읽기가 필요할 때 — 정적 클래스 UsbStorage. 자세히: [apis/capacitor-plugin-usb-storage/README.md](./apis/capacitor-plugin-usb-storage/README.md)
+- **core-browser** — 브라우저 전용 유틸 — DOM 요소 확장 메서드(조회·탭이동·가시성·상대좌표·스크롤·클립보드·경계측정), Blob 다운로드/파일선택/진행률 fetch, IndexedDB KV 저장소 및 가상 파일시스템. 자세히: [apis/core-browser/README.md](./apis/core-browser/README.md)
+- **core-common** — 런타임 무관 공통 유틸 — 날짜/시간 값 타입(DateTime/DateOnly/Time), 에러 트리(SdError 등), 비동기 큐/이벤트/캐시, Array/Set/Map 프로토타입 확장, obj/json/transfer/str/num/bytes/path/xml 유틸 네임스페이스가 필요할 때. 자세히: [apis/core-common/README.md](./apis/core-common/README.md)
+- **core-node** — Node 런타임 전용 유틸 — 파일시스템 IO(fsx), 자식 프로세스 실행·인코딩(cpx), POSIX 경로 가공(pathx), 파일 변경 감시(FsWatcher), consola 로깅 셋업, worker_threads 타입 안전 래퍼(worker). 자세히: [apis/core-node/README.md](./apis/core-node/README.md)
+- **excel** — OOXML(.xlsx) 워크북을 ZIP lazy-load 로 읽고 쓰기 — ExcelWorkbook/Worksheet 진입, 셀 값·수식·스타일·병합, 조건부 서식, 이미지, Zod 기반 ExcelWrapper, 주소·날짜·숫자형식 변환 유틸이 필요할 때. 자세히: [apis/excel/README.md](./apis/excel/README.md)
+- **lint** — ESLint 9 flat-config 프리셋(eslint-recommended)과 simplysm 커스텀 규칙 9종(eslint-plugin)을 subpath export 로 제공 — 프로젝트 lint 설정을 잡거나 커스텀 규칙 동작을 검토할 때. 자세히: [apis/lint/README.md](./apis/lint/README.md)
+- **orm-common** — Dialect 독립 ORM 코어 — Table/View/Procedure fluent 빌더로 스키마를 정의하고 DbContext 에 등록해 connect/transaction/DDL 을 돌리며, Queryable 체이닝과 expr 표현식으로 SELECT/CUD/프로시저 쿼리를 JSON AST(QueryDef/Expr)로 조립할 때(실제 SQL 렌더링·결과 파싱은 mysql/mssql/postgresql 빌더·executor 가 담당). 자세히: [apis/orm-common/README.md](./apis/orm-common/README.md)
+- **orm-node** — Node.js 환경에서 @simplysm/orm-common 의 DbContext 를 MSSQL/MySQL/PostgreSQL 실 DB 에 연결해 실행 — createOrm 으로 트랜잭션 단위 ORM 실행을 하거나, 저수준 DbConn 으로 raw SQL·파라미터 쿼리·bulk insert·수동 트랜잭션을 직접 다룰 때. 자세히: [apis/orm-node/README.md](./apis/orm-node/README.md)
+- **sd-cli** — sd.config.ts 설정 타입(빌드 타겟·배포·Capacitor/Electron/PWA), 프로그래밍 방식 TS/Angular AOT 증분 컴파일러(SdTsCompiler), Vitest용 Angular AOT Vite 플러그인(sdAngularPlugin)을 다룰 때. 자세히: [apis/sd-cli/README.md](./apis/sd-cli/README.md)
+- **service-client** — WebSocket 서비스 서버에 접속해 서비스 메서드 RPC 호출·인증·서버 이벤트 구독·파일 업다운로드·ORM 원격 트랜잭션 실행이 필요할 때 (브라우저/Node 공용 클라이언트). 자세히: [apis/service-client/README.md](./apis/service-client/README.md)
+- **service-common** — 서버·클라이언트 공유 통신 계약 — 바이너리 프로토콜(인코딩/청킹/재조립)·메시지 타입, ORM/자동업데이트/업로드 서비스 인터페이스, 타입 안전 이벤트 정의(defineEvent), 앱 메뉴·권한 트리 모델을 다룰 때. 자세히: [apis/service-common/README.md](./apis/service-common/README.md)
+- **service-server** — Fastify 기반 WebSocket/HTTP RPC 서비스 서버 — defineService/auth 로 서비스 정의, JWT 인증, 정적 파일·업로드, 서버→클라이언트 이벤트 브로드캐스트, ORM/자동업데이트 내장 서비스, V1 레거시 호환을 다룰 때. 자세히: [apis/service-server/README.md](./apis/service-server/README.md)
+- **storage** — FTP/FTPS/SFTP 원격 스토리지에 연결해 파일·디렉토리를 업로드·다운로드·조회·삭제할 때. 진입점은 StorageFactory.connect(프로토콜, 접속정보, 콜백)로 연결·종료 자동 관리. 자세히: [apis/storage/README.md](./apis/storage/README.md)

package/claude/references/sd-simplysm14/apis/angular/README.md

@@ -0,0 +1,35 @@
+# @simplysm/angular
+
+Angular 19+ (zoneless, signal 기반) 업무 프론트엔드용 컴포넌트·디렉티브·프로바이더 모음. 모든 컴포넌트는 standalone, `OnPush`, signal input/model/output 사용. 부트스트랩은 `provideSdAngular` 1개로 시작.
+
+## 사용 트리거 인덱스
+
+- **앱 부트스트랩·전역 설정** — 앱 시작 시 `provideSdAngular` 호출, 전역 에러 처리·테마·로컬스토리지·서버연결·시스템설정 프로바이더 주입. 자세히: [infra.md](./infra.md)
+- **모달·토스트·바쁨·인쇄(오버레이)** — 프로그래밍 방식으로 모달/토스트 띄우기, busy 표시, 화면 인쇄/PDF. 자세히: [overlay.md](./overlay.md)
+- **라우팅·앱 구조·메뉴·권한** — 페이지 코드·뷰 타입·뷰 제목 signal, 라우터 링크, 사이드바/탑바 메뉴 트리, 권한 판정. 자세히: [routing-appstructure.md](./routing-appstructure.md)
+- **호스트 디렉티브·setup 훅** — 엘리먼트에 ripple/show-effect/invalid 표시 부착, 리사이즈/교차/명령(ctrl+s 등) 이벤트, 옵션 이벤트(`.capture`/`.passive`), 타입드 템플릿. 자세히: [directives.md](./directives.md)
+- **입력·버튼 컨트롤** — textfield/textarea/numpad/range/checkbox/switch/select/dropdown/form/button 등 폼 컨트롤. 자세히: [controls.md](./controls.md)
+- **레이아웃(사이드바·탑바)** — 화면 골격(사이드바 컨테이너/메뉴/유저, 탑바 컨테이너/메뉴/유저). 자세히: [layout.md](./layout.md)
+- **시트(데이터 그리드)** — `sd-sheet` 와 컬럼 정의, 정렬/선택/페이징/고정/셀편집. 자세히: [sheet.md](./sheet.md)
+- **공유 데이터(shared-data)** — 서버 마스터 데이터 캐시 프로바이더와 그 select/list/button UI. 자세히: [shared-data.md](./shared-data.md)
+- **선택·정렬·확장 매니저(use* 컴포저블)** — 커스텀 리스트에 선택/정렬/트리확장 로직 부착. 자세히: [selection-managers.md](./selection-managers.md)
+- **CRUD 화면 골격·상태프리셋·권한표** — 목록/상세 화면 컨테이너, 상태 프리셋 저장, 권한 편집 테이블. 자세히: [crud.md](./crud.md)
+- **기능 컴포넌트(주소검색·에디터·시각화·칸반)** — 다음 주소검색 모달, tiptap 에디터, 바코드/달력/차트/라벨/노트/진행률, 칸반 보드. 자세히: [features.md](./features.md)
+- **FormatPipe** — 템플릿에서 문자열/날짜 포맷 표시. 아래 인라인 참조.
+- **SelectModalOutputResult / DirectiveInputSignals / UndefToOptional / WithOptional** — 모달 선택 결과·input signal 타입 유틸. 아래 인라인 참조.
+
+## FormatPipe
+
+`{{ value | format: formatStr }}` — 파이프. value 가 `DateTime`/`DateOnly` 면 `toFormatString(formatStr)`, `string` 이면 `X` 마스크 포맷 적용(예: `format: 'XXX-XXXX'`, `|` 로 길이별 다중 패턴 분기 — `X` 개수가 value.length 와 일치하는 패턴 선택). value 가 null/undefined 면 `""` 반환(결측은 빈 문자열로 표시). standalone import 후 사용.
+
+```html
+<span>{{ phone | format: 'XXX-XXXX-XXXX|XXX-XXX-XXXX' }}</span>
+<span>{{ dateOnly | format: 'yyyy-MM-dd' }}</span>
+```
+
+## 타입 유틸
+
+- **SelectModalOutputResult<TKey>** — `{ selectedKeys: TKey[] }`. 선택 모달이 `close.emit` 으로 돌려주는 결과 형태. 선택 모달 컴포넌트 작성 시 close output 타입으로 사용.
+- **DirectiveInputSignals<T>** — 컴포넌트/디렉티브 클래스 T 의 `InputSignal` prop 들만 골라 `{ prop: 값타입 }` 객체 타입으로 추출. `undefined` 포함 필드는 optional 로 변환. 모달/토스트/인쇄에 컴포넌트를 넘길 때 inputs 타입 산출에 내부적으로 쓰임.
+- **UndefToOptional<T>** — `value: T | undefined` 필드를 `value?: T` 로 변환하는 매핑 타입. `DirectiveInputSignals` 가 내부에서 사용.
+- **WithOptional<T, K>** — T 에서 키 K 들만 optional 로 만드는 타입. 모달/인쇄 inputs 에서 일부 input 을 선택 항목으로 표시할 때 사용.

package/claude/references/sd-simplysm14/apis/angular/controls.md

@@ -0,0 +1,51 @@
+# @simplysm/angular — 폼 컨트롤·버튼·선택 컨트롤
+
+폼 화면을 구성하는 입력/버튼/선택 컴포넌트 묶음. 대부분 `value = model()` 양방향 바인딩과 `theme`/`size`/`inline`/`inset`/`disabled` 공통 input 을 가짐. 공통 enum:
+- theme(기본 8색): `"primary"|"secondary"|"info"|"success"|"warning"|"danger"|"gray"|"blue-gray"` — 색상 테마.
+- size: `"sm"|"lg"` — 작게/크게(미지정=기본).
+- inline: boolean — inline-block 으로 배치(폭 자동).
+- inset: boolean — 테두리·라운드 제거(셀/그룹 내부 삽입용).
+- disabled: boolean — 비활성.
+
+## 버튼류
+
+- **SdButton** `<sd-button>` — 버튼. `type`("button"|"submit", 기본 button), `theme`(8색 + `"link"`/`"link-<색>"`/`"link-rev"` 텍스트형), `inline`/`inset`/`size`/`disabled`, `buttonStyle`/`buttonClass`(내부 button 엘리먼트 스타일/클래스). 폼 제출 버튼이면 `type="submit"`.
+- **SdAnchor** `<sd-anchor>` — 텍스트 링크. `theme`(8색, 기본 primary), `disabled`. 인라인 클릭 요소(아이콘 버튼 등)에.
+- **SdAdditionalButton** `<sd-additional-button>` — 내용 + 우측 부속 버튼(`sd-anchor`/`sd-button` 투영) 컨테이너. `size`/`inset`.
+- **SdModalSelectButton** `<sd-modal-select-button>` — 클릭 시 선택 모달을 띄워 값 선택. `modal = input.required<SdSelectModalInfo<...>>()`, `value = model()`, `selectMode`("single"|"multi", 기본 single — single 이면 단일 키, multi 면 키 배열), `required`(미선택 시 검증 오류 + 지우개 숨김), `disabled`/`inset`/`size`, `modalOptions`, `searchIcon`. required 아니고 값 있으면 지우개 표시. 타입: `SdSelectModal<TKey>`(선택모달이 구현, `SdModalContentDef<SelectModalOutputResult<TKey>>` + `selectMode`/`selectedKeys` input), `SdSelectModalInfo<T>`(selectMode/selectedKeys 제외한 모달 정보).
+
+## 텍스트·숫자 입력
+
+- **SdTextfield<K>** `<sd-textfield [type]="...">` — 타입별 단일 입력. `type = input.required<K>()`(K = `SdTextfieldTypes` 키), `value = model<SdTextfieldTypes[K]>()`. 추가 input: `placeholder`/`title`, `min`/`max`(타입에 맞는 값), `minlength`/`maxlength`/`pattern`(문자형 검증), `validatorFn`(커스텀 검증, 메시지 반환), `format`(format 타입의 X 마스크), `step`, `autocomplete`, `useNumberComma`(숫자 천단위 콤마, 기본 true), `minDigits`(숫자 소수 최소 자릿수), `required`, `readonly`, `inline`/`inset`/`size`/`theme`. 검증 실패 시 `setupInvalid` 로 폼 연동.
+- **SdTextfieldTypes / sdTextfieldTypes** — 타입→값 매핑: `number`:number, `text`/`password`/`color`/`email`/`format`:string, `date`/`month`/`year`:DateOnly, `datetime`/`datetime-sec`:DateTime, `time`/`time-sec`:Time. `sdTextfieldTypes` 는 키 배열(예: select 옵션 생성).
+- **SdTextarea** `<sd-textarea>` — 여러 줄 텍스트. `value = model<string>()`, `minRows`(기본 1, 내용 줄 수만큼 자동 확장), `placeholder`/`title`/`required`/`readonly`/`validatorFn`/`inline`/`inset`/`size`/`theme`/`inputStyle`/`inputClass`.
+- **SdNumpad** `<sd-numpad>` — 화면 숫자 키패드. `value = model<number>()`, `placeholder`, `required`, `inputDisabled`(상단 입력칸 직접입력 막기), `useEnterButton`/`useMinusButton`(ENT/− 버튼 표시), `enterButtonClick = output()`.
+- **SdRange<K>** `<sd-range [type]="...">` — 동일 타입 두 값의 범위(`from ~ to`). `type = input.required<K>()`, `from`/`to` = model<SdTextfieldTypes[K]>(), `required`/`disabled`/`inputStyle`. to 의 min 은 from 으로 자동 제한.
+- **SdDateRangePicker** `<sd-date-range-picker>` — 일/월/범위 선택. `periodType = model<"일"|"월"|"범위">("범위")`(일=from=to 동기화, 월=해당 월 1일~말일 자동, 범위=from~to 자유), `from`/`to` = model<DateOnly>(), `required`.
+
+## 체크·스위치
+
+- **SdCheckbox** `<sd-checkbox>` — 체크박스/라디오. `value = model(false)`, `canChangeFn`(변경 가드, boolean|Promise), `icon`(체크 아이콘), `radio`(라디오 모양·해제 불가), `disabled`/`size`/`inline`/`inset`, `theme`(8색 + `"white"`), `contentStyle`.
+- **SdSwitch** `<sd-switch>` — 토글 스위치. `value = model(false)`, `canChangeFn`, `disabled`/`inline`/`inset`/`size`/`theme`(8색).
+- **SdCheckboxGroup<T>** / **SdCheckboxGroupItem<T>** — 그룹 다중선택. group: `value = model<T[]>([])`, `disabled`. item: `value = input.required<T>()`, `inline`. 항목 클릭 시 그룹 value 배열에 추가/제거.
+
+## 선택(드롭다운)
+
+- **SdSelect<M, T>** `<sd-select>` — 드롭다운 선택. `selectMode = input("single" as M)`("single"|"multi" — multi 면 value 가 배열·전체선택 바 표시), `value = model<...>()`, `placeholder`, `required`(미선택 시 검증오류), `disabled`/`inline`/`inset`/`size`, `hideSelectAll`(multi 전체선택 바 숨김), `multiSelectionDisplayDirection`("vertical" 이면 선택 항목 세로 표시), `items`/`trackByFn`/`getChildrenFn`(items 지정 시 `itemOf` 템플릿으로 렌더·트리 지원), `contentClass`/`contentStyle`, `dropdownOpen = model(false)`. 메서드: selectItem/toggleItem/openDropdown/closeDropdown/onSelectAll/onDeselectAll. 키보드 ↑↓ 로 항목 이동. 타입 `SelectModeValue<T> = { multi: T[]; single: T }`.
+- **SdSelectItem<T>** `<sd-select-item [value]="...">` — 선택 항목. `value`, `disabled`, `hidden`(검색 필터 등으로 숨김). multi 모드면 좌측 체크박스 표시. Enter/Space 로 선택·토글.
+- **SdSelectButton** `<sd-select-button>` — sd-select 우측에 붙는 부속 버튼(검색/편집 등 트리거). input 없음, 클릭 이벤트는 투영된 내용에서 처리.
+
+## 드롭다운(저수준)
+
+- **SdDropdown** `<sd-dropdown>` — 트리거 + `sd-dropdown-popup` 팝업. `open = model(false)`, `disabled`. 화면 위치 자동 배치, 모바일(≤520px)에선 하단 시트 + backdrop. 키보드 ↓ 로 열고 ↑/ESC 로 닫음. `popupElRef`(contentChild)로 팝업 엘리먼트 접근.
+- **SdDropdownPopup** `<sd-dropdown-popup>` — 드롭다운 내용. input 없음. 내용 높이 300px 초과 시 자동 스크롤 캡.
+
+## 폼·접기·탭·리스트·여백·페이지
+
+- **SdForm** `<sd-form>` — `(formSubmit)`(검증 통과 시 SubmitEvent), `(formInvalid)`(검증 실패 시, 네이티브 메시지·포커스 자동). `requestSubmit()` 메서드, `formElRef`/`formEl`(폼 엘리먼트 접근). 내부 컨트롤들의 `setupInvalid` 검증을 모아 제출 제어.
+- **SdCollapse** `<sd-collapse [open]="...">` — 높이 애니메이션 접기. `open`(boolean). 내용 높이 자동 측정.
+- **SdCollapseIcon** `<sd-collapse-icon [open]="...">` — 펼침 상태 회전 아이콘. `icon`(기본 chevronDown), `open`, `openRotate`(펼칠 때 회전각도, 기본 90).
+- **SdTab<any>** / **SdTabItem** — 탭. tab: `value = model<any>()`. item: `value = input<any>()`(클릭 시 부모 value 설정, 일치하면 선택 표시).
+- **SdList** / **SdListItem** — 리스트(트리). list: `inset`. item: `layout`("accordion"|"flat", 기본 accordion — accordion 은 클릭 시 자식 접기/펼치기, flat 은 항상 펼침·헤더 비클릭), `open = model(false)`, `selected`(선택 강조), `selectedIcon`(선택 아이콘 표시), `readonly`(클릭 비활성), `contentStyle`/`contentClass`, `toolTpl`(우측 도구 템플릿). 자식 `sd-list` 투영 시 하위 트리.
+- **SdGap** `<sd-gap>` — 여백 스페이서. `height`/`width`("xxs"|"xs"|"sm"|"default"|"lg"|"xl"|"xxl" CSS 변수 단위), `heightPx`/`widthPx`/`widthEm`(숫자, 0 이면 display:none). width 계열 지정 시 inline-block, height 계열이면 block.
+- **SdPagination** `<sd-pagination>` — 페이지 네비게이션. `currentPage = model(0)`(0 기반), `totalPageCount`(전체 페이지 수), `visiblePageCount`(한 그룹 표시 수, 기본 10). 처음/이전그룹/페이지번호/다음그룹/끝 버튼.

package/claude/references/sd-simplysm14/apis/angular/crud.md

@@ -0,0 +1,53 @@
+# @simplysm/angular — CRUD 화면 골격·상태프리셋·권한표
+
+업무 목록/상세 화면의 공통 골격(탑바·busy·권한 제한·도구바)과 보조 컴포넌트. 모두 `viewType = input.required<SdViewType>()` 로 page/modal/control 맥락을 받음(`injectViewTypeSignal()` 결과 전달). 화면 진입 시 공유 데이터 준비를 대기하고 `ready` 로 알림.
+
+## SdBaseContainer
+
+`<sd-base-container [viewType]="...">` — 가장 단순한 화면 컨테이너(탑바 + busy + 권한제한 + 도구바).
+- ready = model(false) — 공유 데이터 대기 완료 시 true. 화면 본문 표시 조건에.
+- initialized: boolean — 데이터 로드 완료 여부(false 면 busy).
+- busyCount = model(0) — busy 카운트(>0 면 오버레이).
+- restricted: boolean — true 면 "사용권한 없음" 안내만 표시.
+- viewType: input.required<SdViewType> — page 면 탑바(제목+topbarTpl) 감싸고, 아니면 본문만.
+- (contentChild) topbarTpl/commandTpl/contentTpl/bottomCommandTpl — 탑바 우측/상단 명령/본문/하단 명령 영역.
+
+## SdCrudDetail
+
+`<sd-crud-detail [viewType]="...">` — 단건 상세/편집 화면(폼 포함).
+- ready/initialized/busyCount/restricted/viewType — 위와 동일.
+- readonly: boolean — 읽기 전용.
+- (viewChild) formCtrl: SdForm — 내부 폼.
+- (output) submit — 폼 제출(검증 통과).
+- (contentChild) commandTpl/contentTpl/bottomCommandTpl.
+
+## SdCrudList<TItem, TKey>
+
+`<sd-crud-list [viewType]="...">` — 목록 화면(필터 폼 + 시트 + 페이징 + 선택/삭제/복원).
+- ready/initialized/busyCount/restricted/viewType/readonly — 위와 동일.
+- selectMode?: "single"|"multi" — 행 선택 모드.
+- key: input.required<string> — 시트 설정 영속 키.
+- (viewChild) formCtrl: SdForm.
+- (output) filterSubmit — 필터 폼 제출. submit — 일반 제출. create — 추가 버튼. delete: TItem[] — 삭제 대상. restore: TItem[] — 복원 대상.
+- items: TItem[] — 목록 데이터.
+- selectedKeys = model<NonNullable<TKey>[]>([]) — 선택 키.
+- currDeletedItems: TItem[] — 현재 삭제표시된 항목(복원 대상 표시).
+- currentPage = model(0) / totalPageCount / itemsPerPage / visiblePageCount(기본 10) — 페이징(시트로 위임).
+- sorts = model<SortingDef[]>([]) — 정렬 상태.
+- trackByFn: input.required<(item) => TKey> — 행 키.
+- (contentChild) commandTpl/filterTpl/toolTpl/bottomCommandTpl, `sd-sheet-column` 들 — 명령/필터/도구/하단 명령 영역과 시트 컬럼.
+
+## SdStatePreset<TState>
+
+`<sd-state-preset [key]="..." [(state)]="...">` — 화면 상태(필터 등) 프리셋 저장/적용 바.
+- key: input.required<string> — 프리셋 영속 키(`SdSystemConfigProvider`).
+- state = model.required<TState> — 현재 상태(저장·적용 대상).
+- size?: "sm"|"lg".
+- ★ 버튼으로 현재 상태를 이름 붙여 저장, 프리셋 클릭 시 상태 적용, 각 프리셋 저장(덮어쓰기)·삭제. 타입 `SdStatePresetDef<TState> = { name: string; state: TState }`.
+
+## SdPermissionTable<TModule>
+
+`<sd-permission-table [items]="...">` — 권한(use/edit) 편집 테이블.
+- value = model<Record<string, boolean>>({}) — `<코드>.<use|edit>` → 허용 맵.
+- items: SdPermission<TModule>[] — 권한 트리(`SdAppStructureProvider.getPermissionsByStructure` 결과).
+- disabled: boolean — 편집 비활성.

package/claude/references/sd-simplysm14/apis/angular/directives.md

@@ -0,0 +1,34 @@
+# @simplysm/angular — 호스트 디렉티브·동작 셋업·템플릿
+
+엘리먼트/컴포넌트에 동작을 부착하는 디렉티브와, 컴포넌트 constructor 에서 호출하는 `setup*` 훅, 타입드 ng-template 묶음. 컴포넌트 동작을 직접 조립할 때 함께 읽힘.
+
+## 이벤트 디렉티브
+
+옵션 이벤트(`.capture`/`.passive`/`.once`)는 `provideSdAngular` 가 등록한 `SdOptionEventPlugin` 으로 동작. 직접 inject 안 함.
+
+- **SdEvents** — 표준 이벤트의 옵션 변형을 output 으로 노출하는 디렉티브. `(click.capture)`, `(scroll.passive)`, `(touchstart.passive)`, `(wheel.capture.passive)`, `(transitionend.once)` 등(셀렉터에 열거된 조합만). 버블링 안 되는 focus/blur 를 capture 로 받거나 성능상 passive 스크롤이 필요할 때 사용.
+- **SdResizeDirective** — `(sdResize)` 출력. ResizeObserver 기반, requestAnimationFrame 디바운스. 이벤트 `SdResizeEvent = { heightChanged; widthChanged; target: HTMLElement; contentRect: DOMRectReadOnly }`. 크기 변화에 반응할 때.
+- **SdIntersectionDirective** — `(sdIntersection)` 출력. IntersectionObserver 기반. 이벤트 `SdIntersectionEvent = { entry: IntersectionObserverEntry }`. 화면 진입 감지(지연 로드 등)에.
+- **SdCommandDirective** — `(sdRefreshCommand)`(Ctrl+Alt+L), `(sdSaveCommand)`(Ctrl+S), `(sdInsertCommand)`(Insert) 출력(`KeyboardEvent`). 최상위로 열린 모달 안에서만 동작(가려진 화면 단축키 차단). 새로고침/저장/추가 단축키 바인딩에.
+
+## 표시 효과 디렉티브 + 셋업 훅
+
+- **SdRipple** / **setupRipple** — `[sdRipple]="enabled"` 디렉티브 또는 `setupRipple(enableFn?: () => boolean)` 훅. 포인터 다운 위치에서 퍼지는 물결 효과. enabled/enableFn false 면 비활성. 버튼류에 부착.
+- **SdShowEffect** / **setupRevealOnShow** — `[sdShowEffect]="enabled"` + `sdShowEffectType`("l2r"|"t2b", 기본 t2b) 디렉티브, 또는 `setupRevealOnShow(optFn?: () => { type?; enabled? })` 훅. 화면 진입 시 페이드+슬라이드로 나타남. type 은 슬라이드 방향(t2b=위→아래, l2r=왼→오). 진입 애니메이션에.
+- **SdInvalid** / **setupInvalid** — `[sdInvalid]="message"` 디렉티브, 또는 `setupInvalid(getInvalidMessage: () => string)` 훅. 메시지가 빈 문자열이 아니면 호스트 좌상단에 빨간 점 표시 + 숨김 input 의 `setCustomValidity` 로 폼 검증 연동(폼 submit 시 메시지 노출). 커스텀 컨트롤의 유효성 표시에. (sd-textfield 등 내장 컨트롤이 이미 사용)
+
+## 기타 셋업 훅·유틸
+
+- **setupModelHook<T>(model, canFn: Signal<(item) => boolean | Promise<boolean>>)** — model 의 set/update 를 가로채 canFn 결과가 false 면 변경 차단(Promise 면 비동기 허용). 체크박스/스위치/리스트 선택의 변경 가드(`canChangeFn`)에 사용.
+- **setupBgTheme(options?: { theme?; lightness? })** — body 배경색 CSS 변수를 테마색으로 설정(컴포넌트 파괴 시 복원). theme = `"primary"|...|"gray"|"blue-gray"`, lightness = `"lightest"|"lighter"`(기본 lightest). 화면 배경 톤 지정에.
+- **setSafeStyle(renderer: Renderer2, el, style: Partial<CSSStyleDeclaration>)** — Renderer2 로 여러 스타일 일괄 적용. 디렉티브에서 DOM 스타일 직접 조작 시.
+- **mark(sig: WritableSignal<any>)** — in-place 변경(배열 push 등) 후 shallow copy 새 참조로 set 하여 signal 소비자에게 변경 통지. 배열/객체를 직접 변형했을 때.
+
+## 타입드 템플릿 디렉티브
+
+- **SdTypedTemplate<T>** — `<ng-template [typed]="typeToken" let-x="...">`. ng-template 컨텍스트에 타입을 부여(타입 가드). 재귀 메뉴 템플릿 등에서 컨텍스트 타입 보장에 사용.
+- **SdItemOfTemplate<TItem>** / **SdItemOfTemplateContext<TItem>** — `<ng-template [itemOf]="items" let-item="item" let-index="index" let-depth="depth">`. 컨텍스트 `{ $implicit; item; index; depth }`. select/shared-data/calendar 등이 항목 렌더 템플릿 규약으로 사용.
+
+## SdOptionEventPlugin
+
+`provideSdAngular` 가 등록하는 `EventManagerPlugin`. `.capture`/`.passive`/`.once` 접미 이벤트를 해석. 직접 사용 안 함.

package/claude/references/sd-simplysm14/apis/angular/features.md

@@ -0,0 +1,40 @@
+# @simplysm/angular — 기능 컴포넌트(주소검색·에디터·시각화·칸반)
+
+특정 도메인 기능을 제공하는 독립 컴포넌트 묶음. 필요한 화면에서 개별적으로 가져다 씀.
+
+## 주소 검색
+
+- **SdAddressSearchModal** — 다음(카카오) 우편번호 검색 모달 컴포넌트. `SdModalContentDef<Address>` 구현이라 `SdModalProvider.showAsync({ type: SdAddressSearchModal, ... })` 로 띄움. 외부 스크립트(daum postcode) 를 동적 로드. `close = output<Address>()`.
+- **Address** — `{ postNumber: string | undefined; address: string | undefined; buildingName: string | undefined }`. 결측은 undefined 보존.
+
+## 에디터
+
+- **SdTiptapEditor** `<sd-tiptap-editor [(value)]="...">` — tiptap 기반 리치텍스트 에디터(HTML 문자열).
+  - value = model<string>() — HTML 본문.
+  - disabled/readonly/required: boolean — 비활성/읽기전용/필수(빈 값 검증).
+  - placeholder?: string.
+  - validatorFn?: (value) => string | undefined — 커스텀 검증 메시지.
+  - extensions?: AnyExtension[] — 추가 tiptap 확장.
+
+## 시각화
+
+- **SdLabel** `<sd-label>` — 작은 배지/태그. `theme`(8색), `color?: string`(임의 배경색), `clickable: boolean`(호버 강조 + 커서).
+- **SdNote** `<sd-note>` — 안내 박스. `theme`(8색), `size`("sm"|"lg"), `inset: boolean`.
+- **SdProgress** `<sd-progress [theme]="..." [value]="...">` — 진행률 막대. `theme: input.required`(8색), `value: input.required<number>`(0~1, 백분율 표시·막대 폭은 0~100% clamp), `size`("sm"|"lg"), `inset: boolean`.
+- **SdCalendar<T>** `<sd-calendar [items]="..." [getItemDateFn]="...">` — 월간 달력에 항목 배치.
+  - items: input.required<T[]>.
+  - getItemDateFn: input.required<(item, index) => DateOnly> — 항목의 날짜.
+  - yearMonth: input(기본 이번 달 1일) — 표시 월.
+  - weekStartDay: number(기본 0=일요일) / minDaysInFirstWeek: number(기본 1) — 주 시작·첫 주 기준.
+  - (contentChild) `itemOf` 템플릿 필수 — 날짜 칸 항목 렌더.
+- **SdBarcode** `<sd-barcode [type]="..." [value]="...">` — bwip-js 로 바코드 SVG 렌더. `type: input.required<BarcodeType>`(qrcode/code128/ean13 등 다수 — `BarcodeType` 유니온 참조), `value?: string`(빈 값이면 미표시).
+- **SdEcharts** `<sd-echarts [option]="...">` — ECharts 차트. `option: input.required<echarts.EChartsOption>`, `notMerge: boolean`(기본 false, true 면 옵션 병합 대신 교체), `loading: boolean`(로딩 오버레이).
+
+## 칸반
+
+- **SdKanbanBoard<L, T>** `<sd-kanban-board>` — 칸반 보드 컨테이너(드래그 앤 드롭 조율).
+  - selectedValues = model<T[]>([]) — 선택된 카드 값(Shift+클릭 다중 선택).
+  - (output) drop: `SdKanbanBoardDropInfo<L,T>` = `{ sourceKanbanValue?; targetLaneValue?; targetKanbanValue? }` — 드롭 시 발생(소스 카드→대상 레인/카드).
+- **SdKanbanLane<L, T>** `<sd-kanban-lane [value]="...">` — 레인(열). `value?: L`(레인 식별), `busy: boolean`, `useCollapse: boolean`(접기 버튼) + `collapse = model(false)`, `toolTpl`/`titleTpl`(도구·제목 템플릿). 전체선택 체크박스(선택가능 카드 있을 때).
+- **SdKanban<L, T>** `<sd-kanban [value]="...">` — 카드. `value?: T`, `selectable: boolean`(Shift+클릭 선택 허용), `draggable: boolean`(드래그 허용), `contentClass?: string`. 드래그 시 다른 카드/레인 위에 드롭 위치 표시.
+- 타입: **SdKanbanBoardDropInfo<L,T>**(위), **SdKanbanDragRef<L,T>**(`{ value(); heightOnDrag() }`), **SdKanbanDropTarget<L,T>**(`{ targetLaneValue(); targetKanbanValue?() }`) — 보드 내부 드래그/드롭 대상 규약.

package/claude/references/sd-simplysm14/apis/angular/infra.md

@@ -0,0 +1,74 @@
+# @simplysm/angular — 부트스트랩·설정·로깅·서비스 인프라
+
+앱 시작 시 1회 설정하는 부트스트랩 함수와 전역 프로바이더 묶음. 앱 부팅 코드(`appConfig`/`main.ts`)·전역 에러·서버 연결·시스템 설정 저장을 다룰 때 함께 읽힘.
+
+## provideSdAngular
+
+`provideSdAngular(opt: { clientName: string }): EnvironmentProviders` — 앱 `providers` 에 1개 추가하면 다음을 일괄 설정. zoneless 변경감지 활성, 전역 에러 핸들러(`SdGlobalErrorHandlerPlugin`) 등록, 옵션 이벤트 플러그인(`SdOptionEventPlugin`) 등록, ng-icons 기본설정(strokeWidth 1.5, size 1.33em), `IMAGE_CONFIG` 경고 비활성, 테마 dark/fontSize 를 로컬스토리지(`sd-theme-dark`/`sd-theme-font-size`)에 자동 영속, service worker 업데이트 폴링(5분~최대1시간 지수 백오프, 갱신 감지 시 새로고침 확인), 라우터 네비게이션 동안 글로벌 busy 카운트 증감.
+
+- opt.clientName: string — 이 클라이언트 식별자. 로컬스토리지 키 prefix·service-client 연결 이름으로 사용. 앱마다 고유 문자열.
+
+```ts
+bootstrapApplication(AppComponent, {
+  providers: [provideRouter(routes), provideSdAngular({ clientName: "my-app" })],
+});
+```
+
+## SdAngularConfigProvider
+
+`@Injectable({providedIn:"root"})`. `clientName: string` 필드 1개. `provideSdAngular` 가 채워줌. 다른 프로바이더가 clientName 을 참조할 때 inject.
+
+## SdSystemLogProvider
+
+전역 로그 기록 프로바이더. 콘솔 로그 + 선택적 서버 전송.
+
+- writeFn?: (severity, ...data) => Promise<void> | void — 외부(서버) 전송 훅. 지정하면 매 로그마다 호출. 서버 로그 적재가 필요하면 앱 초기화 때 할당.
+- writeAsync(severity: "error"|"warn"|"log", ...data): Promise<void> — 로그 기록. 콘솔에 먼저 출력 후 writeFn 호출. writeFn 이 throw 해도 로깅 자체는 실패하지 않음(내부 logger.error 로 기록).
+
+## SdLocalStorageProvider<T>
+
+`clientName.<key>` 형태로 localStorage 에 JSON 저장/조회. T 는 `{ key: 값타입 }` 맵.
+
+- set<K>(key, value) — JSON.stringify 후 저장.
+- get<K>(key): T[K] | undefined — 없거나 파싱 실패 시 undefined(결측 보존).
+- remove(key) — 삭제.
+
+## SdSystemConfigProvider<T>
+
+화면별 설정(시트 컬럼 상태, 모달 위치, 상태 프리셋 등) 영속 프로바이더. `fn` 미지정 시 로컬스토리지로 폴백.
+
+- fn?: { set(key, data): Promise|void; get(key): PromiseLike<unknown> } — 서버 영속 훅. 지정하면 서버에 저장/조회, 미지정이면 `SdLocalStorageProvider` 로 폴백. 서버 동기화가 필요하면 앱 초기화 때 할당.
+- setAsync<K>(key, data) — data 가 null 이면 제거(폴백 시), 아니면 저장.
+- getAsync(key) — 저장된 값 조회.
+
+## injectSdSystemConfigResource<T>
+
+`injectSdSystemConfigResource<T>({ key: Signal<string|undefined> })` — 컴포넌트 내에서 호출. 호스트 엘리먼트 태그명 + key 를 합친 키로 `SdSystemConfigProvider` 에 연동되는 resource 핸들 반환. key 가 undefined 면 로드/저장 안 함.
+
+- key: Signal<string|undefined> — 설정 키 signal. 빈 값이면 비활성.
+- 반환: `{ value, isLoading, status, hasValue(), reload(), set(v), update(fn) }`. set/update 는 즉시 로컬 반영 후 microtask 로 비동기 영속(실패 시 errorHandler 로 전달). 시트/상태프리셋이 내부적으로 사용.
+
+## SdServiceClientFactoryProvider
+
+`@simplysm/service-client` 연결을 key 단위로 관리하는 팩토리. 요청/응답 진행률을 토스트로 표시.
+
+- connectAsync(key: string, options?: Partial<ServiceConnectionOptions>): Promise<void> — 연결 생성. host/port/ssl 미지정 시 현재 location 기준 기본값. 같은 key 재연결·끊긴 key 재사용 시 throw.
+- closeAsync(key): Promise<void> — 연결 종료. 미연결 key 면 throw.
+- get(key): ServiceClient — 연결된 클라이언트 반환. 미연결/끊김이면 throw. 서비스 호출 시 이걸로 ServiceClient 획득.
+
+## SdGlobalErrorHandlerPlugin
+
+`ErrorHandler` 구현. `provideSdAngular` 가 등록하므로 직접 쓸 일은 드묾. 처리되지 않은 에러/Promise 거부를 시스템 로그에 기록하고 전체화면 오류 오버레이를 1회 표시 후 앱을 destroy(클릭 시 새로고침). 직접 inject 하지 말고 `throw` 로 위임.
+
+## SdThemeProvider
+
+`@Injectable({providedIn:"root"})`. 다크모드·폰트크기 전역 상태.
+
+- dark: WritableSignal<boolean> — 다크모드. true 면 body 에 `sd-theme-dark` 클래스 토글.
+- fontSize: WritableSignal<number> — 루트 폰트 크기(px). 변경 시 `documentElement.style.fontSize` 반영.
+- fontSizePresets: readonly number[] — `[12,14,16,20,24,28]`. 증감 단계.
+- increaseFontSize() / decreaseFontSize() — 프리셋 내 다음/이전 단계로 이동.
+
+## SdThemeSelector
+
+`<sd-theme-selector />` — 폰트크기 증감·다크모드 스위치를 드롭다운으로 제공하는 컴포넌트. input 없음. `SdThemeProvider` 를 직접 조작. 탑바 등에 배치.

package/claude/references/sd-simplysm14/apis/angular/layout.md

@@ -0,0 +1,27 @@
+# @simplysm/angular — 레이아웃(사이드바·탑바)
+
+화면 골격을 만드는 사이드바·탑바 컴포넌트 묶음. 메뉴 데이터는 `SdMenu`(routing-appstructure.md 참조) 또는 자체 메뉴 객체를 사용.
+
+## 사이드바
+
+- **SdSidebarContainer** `<sd-sidebar-container>` — 사이드바 + 본문 레이아웃 컨테이너. input 없음. `toggle: WritableSignal<boolean>`(접힘 상태, 모바일은 backdrop 표시). 라우터 네비게이션 시작 시 자동 접힘. 자식으로 `sd-sidebar` 와 본문을 둠.
+- **SdSidebar** `<sd-sidebar>` — 사이드바 패널. input 없음(컨테이너의 toggle 을 따름). 좌측 고정, 모바일에서 오버레이.
+- **SdSidebarMenu** `<sd-sidebar-menu>` — 메뉴 트리 렌더. `menus = input<SdMenu[]>([])`, `layout`("accordion"|"flat" — 미지정 시 최상위 3개 이하면 flat, 아니면 accordion), `getMenuIsSelectedFn`(선택 판정 커스텀). leaf 는 `sdRouterLink` 로 이동, `menu.url` 있으면 새 창.
+- **SdSidebarUser** `<sd-sidebar-user>` — 사용자 영역 + 접이식 메뉴. `userMenu = input<SdSidebarUserMenu>()`. 투영 내용(프로필) + 클릭 시 펼쳐지는 메뉴 목록. 타입 `SdSidebarUserMenu = { title: string; menus: { title; onClick }[] }`.
+
+```html
+<sd-sidebar-container>
+  <sd-sidebar>
+    <sd-sidebar-user [userMenu]="userMenu">{{ userName }}</sd-sidebar-user>
+    <sd-sidebar-menu [menus]="appStructure.usableMenus()" />
+  </sd-sidebar>
+  <router-outlet />
+</sd-sidebar-container>
+```
+
+## 탑바
+
+- **SdTopbarContainer** `<sd-topbar-container>` — 탑바 + 본문 세로 레이아웃. input 없음.
+- **SdTopbar** `<sd-topbar>` — 상단 바. `sidebarContainer = input<SdSidebarContainer>()`(미지정 시 주입된 컨테이너 자동 사용). 사이드바가 있으면 좌측 토글(햄버거) 버튼 표시. 제목·도구는 투영.
+- **SdTopbarMenu** `<sd-topbar-menu>` — 드롭다운형 상단 메뉴 트리. `menus = input<SdMenu[]>([])`, `getMenuIsSelectedFn`. 최상위 메뉴별 드롭다운, leaf 클릭 시 이동·드롭다운 닫힘.
+- **SdTopbarUser** `<sd-topbar-user>` — 사용자 드롭다운 메뉴. `menus = input.required<SdTopbarUserMenu[]>()`. 투영 내용(이름) 클릭 시 메뉴 목록. 타입 `SdTopbarUserMenu = { title: string; onClick: () => void }`.

package/claude/references/sd-simplysm14/apis/angular/overlay.md

@@ -0,0 +1,103 @@
+# @simplysm/angular — 모달·토스트·Busy·인쇄 (오버레이)
+
+화면 위에 띄우는 피드백·오버레이 묶음. 프로그래밍 방식으로 모달/토스트를 띄우거나 작업 진행 표시, 화면 인쇄/PDF 가 필요할 때 함께 읽힘.
+
+## SdModalProvider
+
+`@Injectable({providedIn:"root"})`. 컴포넌트를 모달로 동적 생성.
+
+- showAsync<T>(modal: SdModalInfo<T>, options?: SdModalOptions): Promise<close결과 | undefined> — 모달 표시. 컨텐츠 컴포넌트의 `close.emit(result)` 시 result 로 resolve, 배경클릭/ESC/닫기버튼 시 undefined 로 resolve. 첫 탭 가능 컨트롤에 자동 포커스.
+- modalCount: Signal<number> — 현재 열린 모달 수.
+
+`SdModalInfo<T, X>` = `{ title: string; type: Type<T>; inputs: ... }`. inputs 는 컨텐츠 컴포넌트의 input 중 `initialized`/`close`/`actionTplRef`/`_optionalModalInputs` 와 X 로 지정한 키를 제외한 것. `_optionalModalInputs` 로 선언한 키는 optional.
+
+`SdModalContentDef<O>` — 모달 컨텐츠 컴포넌트가 구현할 인터페이스:
+- initialized: Signal<boolean> — 초기화 완료 신호(인쇄/대기 동기화에 사용).
+- close: OutputEmitterRef<O | undefined> — 결과 emit. O 가 모달 반환 타입.
+- actionTplRef?: TemplateRef — 헤더 우측 액션 영역에 투영할 템플릿(있으면 모달 헤더로 브릿지됨).
+- _optionalModalInputs?: string — optional 로 둘 input 키들의 유니온 타입 표식(런타임 값 아님).
+
+`SdModalOptions`:
+- key?: string — 지정 시 크기·위치를 `SdSystemConfigProvider` 에 영속(`sd-modal.<key>`).
+- hideHeader?: boolean — 헤더(제목·닫기버튼) 숨김.
+- hideCloseButton?: boolean — 우상단 닫기 버튼만 숨김.
+- headerStyle?: string — 헤더 인라인 스타일.
+- useCloseByBackdrop?: boolean — 배경 클릭으로 닫기 허용(기본 true). 입력 확인 모달이면 false.
+- useCloseByEscapeKey?: boolean — ESC 로 닫기 허용(기본 true).
+- float?: boolean — 배경(backdrop) 없이 떠 있는 모달. 비차단 패널이면 true.
+- fill?: boolean — 화면 가득 채움(전체화면 모달).
+- resizable?: boolean — 8방향 리사이즈 핸들 표시.
+- movable?: boolean — 헤더 드래그로 이동.
+- position?: "bottom-right" | "top-right" — 고정 위치(알림형 모달).
+- minHeightPx/minWidthPx/heightPx/widthPx?: number — 최소·초기 크기(px).
+- noFirstControlFocusing?: boolean — 첫 컨트롤 자동 포커스 비활성(다이얼로그 자체에 포커스).
+
+```ts
+const result = await sdModal.showAsync(
+  { title: "사용자 선택", type: UserSelectModal, inputs: { teamId } },
+  { resizable: true, key: "user-select" },
+);
+```
+
+## SdModal
+
+`<sd-modal>` — `SdModalProvider` 가 내부적으로 생성하는 셸 컴포넌트. 직접 템플릿에 쓰기보다 provider 경유 권장. 위 `SdModalOptions` 와 동일한 input 들 + `open = model(false)`, `closeRequest = output<void>()`, `title`/`actionTplRef` input 보유.
+
+## SdActivatedModalProvider
+
+모달 컨텐츠 컴포넌트 내부에서 inject. 현재 모달 제어.
+- modalComponent: Signal<SdModal | undefined> / contentComponent: Signal<T | undefined>.
+- canDeactivateFn: () => boolean — 닫기 차단 판정. `setupCanDeactivate` 가 설정. true 가 아니면 배경/ESC/버튼 닫기 무시.
+
+## SdPromptModal / SdConfirmModal
+
+provider 에 바로 넘길 수 있는 범용 모달 컴포넌트.
+- SdPromptModal: `SdModalContentDef<string>`. `message = input.required<string>()`. 텍스트 입력(필수) 후 확인 시 입력값, 취소 시 undefined emit.
+- SdConfirmModal: `SdModalContentDef<boolean>`. `message = input.required<string>()`. 확인 시 `true`, 취소 시 undefined emit.
+
+```ts
+const name = await sdModal.showAsync({ title: "이름", type: SdPromptModal, inputs: { message: "이름?" } });
+```
+
+## SdToastProvider
+
+`@Injectable({providedIn:"root"})`. 토스트 알림.
+
+- info/success/warning/danger(message: string, useProgress?: boolean) — 심각도별 토스트. useProgress=true 면 진행률 토스트가 되어 `WritableSignal<number>`(0~100) 반환, 100 도달 1초 뒤 자동 해제. useProgress 없거나 false 면 3초 후 자동 해제(호버 중 지연), 반환 void.
+- notify<T>(input: SdToastInput<T>): Promise<close결과 | undefined> — 커스텀 컴포넌트 토스트. `SdToastInput<T>` = `{ type: Type<T>; inputs }`(컨텐츠는 `SdToastContentDef<O>` = `{ close: OutputEmitterRef<O|undefined> }` 구현). 5초 후 자동 해제.
+- try<R>(fn, messageFn?): Promise<R | undefined> — fn 실행 중 Error 발생 시 danger 토스트 + 시스템로그 기록 후 undefined 반환(Error 아닌 throw 는 재throw). 화면 액션 핸들러를 감싸는 표준 패턴.
+- alertThemes: WritableSignal<SdToastSeverity[]> — 이 심각도들은 토스트 대신 `window.alert`.
+- overlap: WritableSignal<boolean> — true 면 새 토스트가 기존 토스트 모두 제거 후 표시(겹침 방지).
+- beforeShowFn?: (theme) => void — 토스트 표시 직전 콜백(예: 사운드).
+
+타입: `SdToastSeverity = "info"|"success"|"warning"|"danger"`, `SdToastTheme = "primary"|"secondary"|SdToastSeverity|"gray"|"blue-gray"`.
+
+```ts
+await sdToast.try(async () => { await save(); sdToast.success("저장됨"); });
+```
+
+## SdToast / SdToastContainer
+
+`SdToastProvider` 가 내부 생성. 직접 쓸 일 드묾. SdToast: `open`/`progress`/`message` model, `useProgress`/`theme` input, severity 에 따라 `role`/`aria-live` 자동(info·success=status/polite, warning·danger=alert/assertive). SdToastContainer: `overlap` input.
+
+## SdBusyProvider
+
+`@Injectable({providedIn:"root"})`. 전역 로딩 표시.
+- globalBusyCount: WritableSignal<number> — >0 이면 전역 busy 오버레이 표시(라우팅·인쇄가 자동 증감). 직접 작업 감쌀 때 update 로 증감.
+- type: WritableSignal<SdBusyType> — 기본 표시 유형. `SdBusyType = "spinner"|"bar"|"cube"`.
+
+## SdBusyContainer
+
+`<sd-busy-container [busy]="..." />` — 영역 단위 busy 오버레이. 내부 컨텐츠 위에 표시.
+- busy: boolean — true 면 오버레이 표시 + 영역 내 키입력 차단.
+- message?: string — 표시 메시지.
+- type?: "spinner"|"bar"|"cube" — 미지정 시 `SdBusyProvider.type` 사용.
+- progressPercent?: number — 지정 시 상단 진행 바 표시(0~100).
+
+## SdPrintProvider
+
+`@Injectable({providedIn:"root"})`. 컴포넌트를 인쇄/PDF 로 렌더.
+- printAsync<T>(template: SdPrintInput<T>, options?: { size?: string; margin?: string }): Promise<void> — 컴포넌트를 body 에 임시 렌더 후 `window.print()`. size 기본 `"A4 auto"`, margin 기본 `"0"`. 인쇄 동안 글로벌 busy.
+- getPdfBufferAsync<T>(template, options?: { orientation?: "portrait"|"landscape"; pageSize?: string }): Promise<Uint8Array> — `.page` 엘리먼트별로 캔버스 변환(jsPDF) 후 PDF 버퍼 반환. pageSize 기본 `"a4"`, orientation 기본 portrait.
+
+`SdPrintInput<T, X>` = `{ type: Type<T>; inputs }`. 컨텐츠는 `SdPrint`(= `{ initialized: Signal<boolean>; _optionalPrintInputs?: string }`) 구현. `initialized()` 가 true 가 되고 이미지 로드 완료까지 대기 후 인쇄.

package/claude/references/sd-simplysm14/apis/angular/routing-appstructure.md

@@ -0,0 +1,69 @@
+# @simplysm/angular — 라우팅 / 앱 구조(메뉴·권한)
+
+현재 페이지 식별·뷰 제목/타입 판정, 라우터 링크, 앱 메뉴/권한 트리 구성을 다룰 때 함께 읽힘. 앱 구조 데이터 원본은 `@simplysm/service-common` 의 `AppStructureItem`.
+
+## injectFullPageCodeSignal
+
+`injectFullPageCodeSignal(): Signal<string>` — 현재 라우터 URL 에서 앞 2 세그먼트(`/home` 등)를 제외한 나머지를 `.` 으로 이은 페이지 코드. 네비게이션 종료마다 갱신. 메뉴 선택 표시·뷰 제목 조회에 사용.
+
+## injectCurrentPageCodeSignal
+
+`injectCurrentPageCodeSignal(): Signal<string> | undefined` — 현재 `ActivatedRoute` 의 pathFromRoot 기준 코드(중첩 outlet/모달 안에서 자기 자신 경로). ActivatedRoute 없으면 undefined. fullPageCode 와 비교해 page/control 판정에 사용.
+
+## injectViewTitleSignal
+
+`injectViewTitleSignal(): Signal<string>` — 모달 안이면 모달 제목, 아니면 앱 구조에서 현재 페이지 코드로 찾은 제목(`[상위 > 상위] 현재`). 못 찾으면 `""`. 화면 컨테이너 제목 표시에 사용.
+
+## injectViewTypeSignal
+
+`injectViewTypeSignal(): Signal<SdViewType>` — 현재 컴포넌트가 어떤 맥락으로 떠 있는지 판정. `SdViewType = "page"|"modal"|"control"`. 모달 안이면 "page"가 아닌 "modal", 라우트의 페이지 컴포넌트로 직접 떠 있고 fullPageCode===currPageCode 면 "page", 그 외 "control"(다른 화면에 박힌 재사용 컴포넌트). CRUD 컨테이너의 `viewType` input 에 그대로 전달.
+
+## setupCanDeactivate
+
+`setupCanDeactivate(fn: () => boolean): void` — 컴포넌트 내 호출. 모달 안이면 `SdActivatedModalProvider.canDeactivateFn` 에, 라우트면 해당 route 의 `canDeactivate` 가드에 fn 을 등록(컴포넌트 파괴 시 해제). fn 이 false 면 이탈/닫기 차단. 미저장 변경 보호에 사용.
+
+```ts
+setupCanDeactivate(() => !this.dirty() || confirm("저장하지 않고 나갈까요?"));
+```
+
+## SdRouterLink
+
+`[sdRouterLink]="option"` 디렉티브. 클릭 시 option 으로 라우터 이동(또는 새 창).
+- option: `{ link: string; params?; window?: {width?;height?}; outletName?: string; queryParams? } | undefined` — undefined 면 동작 없음(커서도 기본). 현재가 window 모드거나 Ctrl/Shift+클릭이면 새 창으로, outletName 있으면 named outlet 으로 이동. Alt+클릭은 무시.
+
+## SdNavigateWindowProvider
+
+`@Injectable({providedIn:"root"})`. 새 창/팝업 네비게이션.
+- isWindow: boolean — 현재 URL 해시에 `window=true` 가 있는지(팝업으로 열린 창인지).
+- open(navigate: string, params?, features?): void — window 모드거나 features 지정 시 `window.open` 팝업(닫힐 때 부모와 함께 정리), 아니면 `_blank` 탭.
+
+## getMenuRouterLinkOption / getIsMenuSelected
+
+- `getMenuRouterLinkOption(menu: SdMenu): { link; queryParams } | undefined` — leaf 메뉴(children/url 없음)면 `/home/<코드체인>` 링크 + 쿼리파라미터 옵션, 그 외 undefined. `SdRouterLink` 에 바로 전달.
+- `getIsMenuSelected(menu, fullPageCode, customFn?): boolean` — customFn 있으면 그 결과, 없으면 `fullPageCode === menu.codeChain.join(".")`. 메뉴 선택 강조에 사용.
+
+## SdAppStructureProvider<TModule>
+
+`@Injectable({providedIn:"root"})`. 앱 메뉴·권한 트리의 단일 소스.
+- usableModules: Signal<TModule[]|undefined> — 활성 모듈 목록. 메뉴/권한 필터에 사용(미설정 시 전체 허용 취급).
+- permRecord: Signal<Record<string,boolean>|undefined> — `<코드>.<권한키>` → 허용 여부 맵.
+- items: Signal<AppStructureItem<TModule>[]> — 구조 원본.
+- initialize(items) — 구조 주입.
+- usableMenus: Signal<SdMenu[]> — 모듈·권한 통과한 메뉴 트리(사이드바/탑바용).
+- usableFlatMenus: Signal<SdFlatMenu<TModule>[]> — 평탄화된 메뉴 목록.
+- getPermissionsByStructure(items, codeChain?) — 권한 편집표용 `SdPermission` 트리 생성.
+- getTitleByFullCode(fullCode) / findTitleByFullCode(fullCode) — 전자는 못 찾으면 throw, 후자는 undefined(결측 보존).
+- getItemChainByFullCode(fullCode) — 코드 체인에 해당하는 항목 배열(없으면 빈 배열).
+- getPermsByFullCode(fullCodes, permKeys) — 해당 코드들에서 보유한 권한 키 목록.
+
+`injectPermsSignal<K>(viewCodes: string[], keys: K[]): Signal<K[]>` — 현재 보유 권한 키를 computed signal 로. 화면에서 편집/사용 권한 분기에 사용.
+
+## SdAppStructureUtils
+
+`abstract class`. `SdAppStructureProvider` 가 내부 사용하는 정적 유틸 모음(직접 호출 가능): `getMenus`/`getFlatMenus`/`getPermissions`/`getFlatPermissions`/`getTitleByFullCode`/`findTitleByFullCode`/`getItemChainByFullCode`/`getPermsByFullCode`. 시그니처는 provider 메서드와 대응(추가로 items/usableModules/permRecord 를 인자로 받음).
+
+## 타입
+
+- **SdMenu** — `{ title; codeChain: string[]; url?; icon?; children?: SdMenu[] }`. 메뉴 트리 노드.
+- **SdFlatMenu<TModule>** — `{ titleChain: string[]; codeChain: string[]; modulesChain: TModule[][] }`. 평탄 메뉴.
+- **SdPermission<TModule>** — `{ title; codeChain; modules; perms: ("use"|"edit")[]|undefined; children }`. 권한 트리 노드(권한표 입력).

package/claude/references/sd-simplysm14/apis/angular/selection-managers.md

@@ -0,0 +1,28 @@
+# @simplysm/angular — 선택·정렬·확장 매니저(use* 컴포저블)
+
+커스텀 리스트/그리드 컴포넌트에 선택·정렬·트리 확장 로직을 붙이는 함수형 컴포저블. signal 바인딩을 넘기면 파생 signal 과 조작 메서드를 돌려줌. `sd-sheet` 가 내부적으로 이들을 조합함.
+
+## useSelectionManager<TItem, TKey>
+
+다중/단일 선택 상태 관리.
+- options: `{ displayItems: Signal<TItem[]>; selectedKeys: WritableSignal<TKey[]>; selectMode: Signal<"single"|"multi"|undefined>; getItemSelectableFn: Signal<((item) => boolean|string)|undefined>; trackByFn: Signal<(item,index) => TKey> }` — selectMode 미지정이면 선택 비활성, getItemSelectableFn 이 string 반환 시 그 사유로 불가, trackByFn 으로 키 비교(`obj.equal` 깊은 비교).
+- 반환: `hasSelectable`/`isAllSelected`(Signal), `getSelectable(item): true|string|undefined`, `getCanChangeFn(item)`, `select`/`deselect`/`toggle`/`toggleAll`/`isSelected`. single 은 1개로 교체, multi 는 누적.
+
+## useSortingManager
+
+헤더 클릭 정렬 상태 + 정렬 실행.
+- options: `{ sorts: WritableSignal<SortingDef[]> }`.
+- 반환: `defMap: Signal<Map<key, { indexText?; desc }>>`(다중 정렬 시 순번 표시), `toggle(key, multiple)`(단일/다중 토글: 없음→오름차순→내림차순→해제 순환), `sort<T>(items): T[]`(null 은 앞, 문자열 localeCompare, 숫자 차이 기준).
+- **SortingDef** — `{ key: string; desc: boolean }`. 정렬 1건.
+
+## useExpandingManager<T>
+
+트리 펼침 상태 + 가시 항목 평탄화.
+- binding: `{ items: Signal<T[]>; expandedItems: WritableSignal<T[]>; getChildrenFn: Signal<((item,index) => T[]|undefined)|undefined>; sort: (items) => T[] }` — getChildrenFn 으로 자식 조회, sort 로 각 레벨 정렬.
+- 반환: `displayItems`/`hasExpandable`/`isAllExpanded`(Signal), `toggle(item)`/`toggleAll()`, `isVisible(item)`(조상이 모두 펼쳐졌는지), `def(item): ExpandItemDef<T>`(못 찾으면 throw).
+- **ExpandItemDef<T>** — `{ item; parentDef: ExpandItemDef<T>|undefined; hasChildren; depth }`. 항목의 트리 위치 정의.
+
+```ts
+const sorting = useSortingManager({ sorts });
+const selection = useSelectionManager({ displayItems, selectedKeys, selectMode, getItemSelectableFn, trackByFn });
+```