@simplysm/sd-claude 14.0.88 → 14.0.89

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

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

@@ -1,43 +1,28 @@
-# @simplysm/angular — 선택·정렬·확장 매니저
+# @simplysm/angular — 선택·정렬·확장 매니저(use* 컴포저블)
 
-리스트/시트류 컴포넌트 내부에서 signal 바인딩으로 선택·다중정렬·트리확장 상태를 다루는 컴포저블 함수. 컴포넌트 클래스 필드 초기화 시 호출하며, signal 입력(items/selectedKeys/sorts 등)과 메서드 묶음을 반환. `sd-sheet` 가 셋 모두 사용.
+커스텀 리스트/그리드 컴포넌트에 선택·정렬·트리 확장 로직을 붙이는 함수형 컴포저블. signal 바인딩을 넘기면 파생 signal 과 조작 메서드를 돌려줌. `sd-sheet` 가 내부적으로 이들을 조합함.
 
-## useSelectionManager
+## useSelectionManager<TItem, TKey>
 
-`useSelectionManager<TItem, TKey>(options): { ... }` — 단일/다중 선택 상태 관리.
+다중/단일 선택 상태 관리.
+- 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 는 누적.
 
-options(모두 Signal/WritableSignal):
-- `displayItems: Signal<TItem[]>` — 현재 표시 항목.
-- `selectedKeys: WritableSignal<TKey[]>` — 선택 키 배열(양방향).
-- `selectMode: Signal<"single"|"multi"|undefined>` — 선택 모드. `undefined` 면 선택 비활성.
-- `getItemSelectableFn: Signal<((item) => boolean | string) | undefined>` — 선택 가능 판정. `string` 이면 비활성 + 사유.
-- `trackByFn: Signal<(item, index) => TKey>` — 키 추출.
+## useSortingManager
 
-반환: `hasSelectable`/`isAllSelected: Signal<boolean>`, `getSelectable(item): true | string | undefined`, `getCanChangeFn(item): () => boolean`, `select`/`deselect`/`toggle`/`toggleAll`/`isSelected(item)`. single 모드 select 는 단일 키로 교체, multi 는 추가/제거.
+헤더 클릭 정렬 상태 + 정렬 실행.
+- 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건.
 
-## useSortingManager
+## 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 }`. 항목의 트리 위치 정의.
 
-`useSortingManager(options: { sorts: WritableSignal<SortingDef[]> }): { ... }` — 다중 정렬 토글·적용.
-
-- `options.sorts` — 정렬 정의 배열(양방향). `SortingDef = { key: string; desc: boolean }`.
-- 반환:
-  - `defMap: Signal<Map<key, { indexText?; desc }>>` — 컬럼별 정렬 상태(다중 시 순번 indexText).
-  - `toggle(key, multiple)` — 정렬 토글. `multiple=true`(Shift) 면 누적, 동일 키 재클릭 시 asc→desc→해제 순환.
-  - `sort<T>(items): T[]` — 현재 정렬 정의로 배열 정렬(null 은 먼저, 문자열은 localeCompare).
-
-## useExpandingManager
-
-`useExpandingManager<T>(binding): { ... }` — 트리 펼침/접힘 상태 관리.
-
-binding:
-- `items: Signal<T[]>` — 루트 항목.
-- `expandedItems: WritableSignal<T[]>` — 펼친 항목(양방향).
-- `getChildrenFn: Signal<((item, index) => T[] | undefined) | undefined>` — 자식 추출.
-- `sort: (items) => T[]` — 각 레벨 정렬 함수.
-- 반환:
-  - `displayItems: Signal<T[]>` — 펼침 반영된 평탄 표시 목록.
-  - `hasExpandable`/`isAllExpanded: Signal<boolean>`.
-  - `toggle(item)`/`toggleAll()` — 펼침 토글.
-  - `isVisible(item): boolean` — 모든 조상이 펼쳐졌는지.
-  - `def(item): ExpandItemDef<T>` — 항목 메타(없으면 throw).
-- `ExpandItemDef<T>` — `{ item; parentDef?; hasChildren; depth }`.
+```ts
+const sorting = useSortingManager({ sorts });
+const selection = useSelectionManager({ displayItems, selectedKeys, selectMode, getItemSelectableFn, trackByFn });
+```

package/claude/references/sd-simplysm14/apis/angular/shared-data.md

@@ -1,70 +1,57 @@
 # @simplysm/angular — 공유 데이터(shared-data)
 
-서버 마스터데이터(코드·분류 등)를 클라이언트에 캐시하고 서버 변경 이벤트로 동기화하며, 선택 UI 로 노출. `SdSharedDataProvider` 를 상속해 데이터셋을 등록하고, 선택 컨트롤(select/select-button/select-list)이 그 핸들의 items 를 소비.
-
-## SdSharedDataProvider
-
-`abstract class SdSharedDataProvider<T extends Record<string, SharedDataBase<...>>>` — 공유 데이터 등록·로드·동기화 추상 프로바이더. 앱별로 상속해 `initialize()` 에서 `register` 호출.
-
-- `loadingCount: WritableSignal<number>` — 로딩 중 데이터 수.
-- `abstract initialize(): void` — 앱이 구현. 보통 여러 `register` 호출.
-- `register<K>(name, info: SharedDataInfo<T[K]>)` — 데이터셋 등록(재호출 시 갱신·리스너 재설정).
-- `getHandle<K>(name): SharedDataHandle<T[K]>` — 핸들 반환. 최초 접근 시 lazy 로드·이벤트 리스너 등록. 미등록이면 throw.
-- `emitAsync<K>(name, changeKeys?)` — 변경 이벤트 발행. `changeKeys` 없으면 전체 리로드 신호, 있으면 해당 키만 부분 갱신.
-- `wait(): Promise<void>` — `loadingCount<=0` 까지 대기(CRUD 기반 컨테이너가 초기 로드 동기화에 사용).
-
-타입:
-- `SharedDataBase<TKey>` — 공유 항목 기본형. `__valueKey`(고유키), `__searchText`(검색대상), `__isHidden`(숨김), `__parentKey?`(트리 부모키).
-- `SharedDataInfo<T>` — 등록 정보. `serviceKey`(서비스 클라이언트 키), `getter: (changeKeys?) => Promise<T[]>`(전체/부분 로더), `filter?`(이벤트 필터), `orderBy?`(부분 갱신 후 정렬 키).
-- `SharedDataHandle<T>` — `{ items: Signal<T[]>; get(key) => T | undefined }`.
-- `SdSharedDataChangeEvent` — 변경 동기화에 쓰는 `defineEvent` 정의(서버↔클라이언트).
-
-## SdSharedDataSelect
-
-`<sd-shared-data-select>` — 공유데이터 드롭다운 선택(검색·트리·모달 연계). 제네릭 `<TItem, TMode, TModal>`.
-
-- `value = model<...>()` — 선택 키(single=단일, multi=배열). 값 타입은 `TItem["__valueKey"] | undefined`.
-- `items = input.required<TItem[]>()` — 공유 항목 배열(핸들의 items).
-- `selectMode: TMode("single"|"multi")` — 선택 모드. 기본 `"single"`.
-- `disabled`/`required`/`inset`/`inline`/`size` — 공통.
-- `useUndefined` — multi 에서도 "미지정" 항목 노출.
-- `filterFn?: (item, index, ...params) => boolean` / `filterFnParams?: any[]` — 추가 필터.
-- `modal?: SdSelectModalInfo<TModal>` — 검색 아이콘 → 선택 모달.
-- `editModal?: SdModalInfo<SdModalContentDef<boolean>>` — 편집 아이콘 → 편집 모달.
-- `selectClass`/`multiSelectionDisplayDirection: "vertical"` — 표시 옵션.
-- `getIsHiddenFn?: (item, index) => boolean` — 숨김 판정(기본 `__isHidden`, 숨김 항목은 취소선).
-- `getSearchTextFn?: (item, index) => string` — 검색 대상 텍스트(기본 `__searchText`).
-- `displayOrderByFn?: (item) => 정렬키` — 표시 정렬.
-- 항목 템플릿은 `<ng-template [itemOf]>`, 미지정 표시는 `#undefinedTpl`. `__parentKey` 있으면 트리.
-
-## SdSharedDataSelectButton
-
-`<sd-shared-data-select-button>` — 모달 선택 버튼 + 선택값 인라인 표시. 제네릭 `<TItem, TMode, TModal>`.
-
-- `value = model<...>()` — 선택 키(single/multi).
-- `items = input<TItem[]>([])` — 표시 라벨 조회용 전체 항목.
-- `modal = input.required<SdSelectModalInfo<TModal>>()` — 선택 모달.
-- `selectMode: TMode` — 기본 `"single"`.
-- `disabled`/`required`/`inset`/`size` — 공통.
-- 선택 항목 라벨은 `<ng-template [itemOf]>`(required)로 렌더.
-
-## SdSharedDataSelectList
-
-`<sd-shared-data-select-list>` — 검색·페이징되는 리스트형 단일 선택(패널 영역용). 제네릭 `<TItem, TModal>`.
-
-- `selectedItem = model<TItem>()` — 선택 항목(객체). `canChangeFn?: (item) => boolean|Promise<boolean>` 로 변경 차단.
-- `items = input.required<TItem[]>()` — 항목 배열. `__isHidden` 항목은 제외.
-- `selectedIcon?` — 선택 표시 아이콘.
-- `useUndefined` — "미지정" 항목 표시.
-- `filterFn?: (item, index) => boolean` — 추가 필터.
-- `modal?: SdSelectModalInfo<TModal>` — 외부 검색 모달 버튼.
-- `header?` — 패널 헤더 텍스트.
-- `pageItemCount?` — 페이지당 항목 수(지정 시 페이지네이션).
-- 슬롯: `#headerTpl`/`#filterTpl`(기본 검색 textfield 대체)/`[itemOf]` 항목/`#undefinedTpl`.
+서버의 마스터 데이터(코드·거래처 등)를 클라이언트 전역에서 캐시·구독하고, 그 데이터를 고른 select/list/button UI 로 노출하는 묶음. 데이터 변경은 서비스 이벤트로 전파되어 자동 갱신됨.
+
+## 데이터 규약 타입
+
+- **SharedDataBase<TKey>** — 공유 데이터 항목의 베이스. `{ __valueKey: TKey; __searchText: string; __isHidden: boolean; __parentKey?: TKey }`. `__searchText` 로 검색, `__isHidden` 으로 목록 숨김, `__parentKey` 있으면 트리 구성. 도메인 타입이 이 인터페이스를 확장.
+- **SharedDataInfo<T>** — 등록 정보. `{ serviceKey: string; getter: (changeKeys?) => Promise<T[]>; filter?: unknown; orderBy?: (item) => 비교키 }`. getter 는 전체/부분(changeKeys) 로드, filter 는 이벤트 매칭, orderBy 는 정렬키.
+- **SharedDataHandle<T>** — `{ items: Signal<T[]>; get(key): T | undefined }`. 화면에서 데이터 소비 핸들.
+
+## SdSharedDataProvider<T>
+
+`@Injectable()` abstract. 앱별로 상속해 `initialize()` 구현. T 는 `{ name: SharedDataBase 파생 }` 맵.
+- loadingCount: WritableSignal<number> — 로딩 중 카운트.
+- abstract initialize(): void — 앱 시작 시 각 데이터 register.
+- register<K>(name, info: SharedDataInfo<T[K]>) — 데이터 등록(재호출 시 generation 증가로 이전 이벤트 무시·재로드).
+- getHandle<K>(name): SharedDataHandle<T[K]> — 핸들 획득(첫 호출 시 lazy 로드 + 이벤트 리스너 등록). 미등록이면 throw.
+- emitAsync<K>(name, changeKeys?) — 변경 이벤트 발행(같은 name·filter 구독자 갱신). changeKeys 지정 시 부분 갱신.
+- wait(): Promise<void> — loadingCount 가 0 이 될 때까지 대기(화면 진입 전 데이터 준비).
+
+**SdSharedDataChangeEvent** — `defineEvent` 로 정의된 서비스 이벤트(`{ name; filter }`, 페이로드 `(string|number)[] | undefined`). provider 가 내부 사용.
+
+## SdSharedDataSelect<TItem, TMode, TModal>
+
+`<sd-shared-data-select [items]="...">` — 공유 데이터 드롭다운 선택(검색·트리·모달 연동).
+- value = model<...>() — 선택값(single=키, multi=키 배열). 키는 `TItem["__valueKey"] | undefined`.
+- items: input.required<TItem[]> — 후보(보통 handle.items()).
+- selectMode: "single"|"multi"(기본 single).
+- disabled/required/inset/inline/size — 컨트롤 공통.
+- useUndefined: boolean — multi 에서도 "미지정" 항목 노출.
+- filterFn?/filterFnParams? — 후보 필터(item,index,...params).
+- modal?: SdSelectModalInfo — 우측 검색 버튼으로 띄울 선택 모달.
+- editModal?: SdModalInfo<SdModalContentDef<boolean>> — 편집 버튼으로 띄울 모달.
+- selectClass?/multiSelectionDisplayDirection?("vertical").
+- getIsHiddenFn?(item,index)/getSearchTextFn?(item,index)/displayOrderByFn?(item) — 기본은 `__isHidden`/`__searchText`/없음. 검색·표시·정렬 재정의.
+- (contentChild) `itemOf` 템플릿 — 항목 렌더. `undefinedTpl` 로 "미지정" 표시 커스텀.
+- `__parentKey` 있으면 자동 트리(자식은 부모 펼침 시 노출).
+
+## SdSharedDataSelectButton<TItem, TMode, TModal>
+
+`<sd-shared-data-select-button [modal]="...">` — 모달 선택 버튼 + 선택 항목 인라인 표시(`SdModalSelectButton` 래퍼).
+- value = model<...>(), items: TItem[](선택값→표시용 매핑), modal: input.required<SdSelectModalInfo>, selectMode(기본 single), disabled/required/inset/size.
+- (contentChild) `itemOf` 템플릿 필수 — 선택된 항목 표시.
+
+## SdSharedDataSelectList<TItem, TModal>
+
+`<sd-shared-data-select-list [items]="...">` — 단일 선택 리스트(검색·페이징·모달 연동).
+- selectedItem = model<TItem>(), canChangeFn?(item) — 선택 변경 가드.
+- items: input.required<TItem[]>, selectedIcon?, useUndefined(미지정 항목), filterFn?(item,index).
+- modal? — 우상단 외부창 버튼으로 띄울 선택 모달.
+- header?: string — 상단 헤더 텍스트.
+- pageItemCount?: number — >0 이면 페이지당 항목 수로 페이징.
+- (contentChild) `itemOf`/`headerTpl`/`filterTpl`/`undefinedTpl` 템플릿.
 
 ## matchesSearchText
 
-`matchesSearchText(itemText: string, searchQuery: string | undefined): boolean` — 공백 분리 AND 부분일치 검색 매처(소문자 비교). 위 선택 컨트롤이 검색에 사용.
-
-- `itemText` — 항목의 검색 대상 텍스트.
-- `searchQuery` — 검색어. 빈/`undefined` 면 모두 매치(true). 각 단어가 모두 포함돼야 매치.
+`matchesSearchText(itemText: string, searchQuery: string | undefined): boolean` — 검색어를 공백으로 나눈 모든 토큰이 itemText(소문자)에 포함되면 true(AND 매칭). 빈 검색어면 true. 위 select/list 가 내부 사용하나 커스텀 검색에도 활용 가능.

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

@@ -1,78 +1,73 @@
 # @simplysm/angular — 시트 (sd-sheet)
 
-선택·다중정렬·트리확장·컬럼 고정/숨김/리사이즈·페이지네이션·셀편집·설정 영속화를 갖춘 데이터 그리드. 컬럼은 `<sd-sheet-column>` 디렉티브 + `<ng-template [cell]>` 셀 템플릿으로 선언. 선택/정렬/확장은 selection-managers 컴포저블을 내부 사용.
-
-## SdSheet
-
-`<sd-sheet>` — 데이터 그리드. 제네릭 `<TItem>`.
-
-inputs:
-- `key = input<string>()` — 설정 영속화 키. 지정 시 설정 버튼·컬럼폭/순서/고정/숨김을 `SdSystemConfigProvider` 에 저장.
-- `items = input<TItem[]>([])` — 표시 데이터.
-- `trackByFn = input<(item, index) => unknown>` — 행 키 추출. 기본 `(item) => item`. 선택키·정렬 추적 기준.
-- `selectMode: "single"|"multi"` — 선택 모드. 미지정 시 선택 비활성. multi 면 헤더 전체선택 체크박스.
-- `autoSelect: "click"|"focus"` — 자동 선택 트리거. `"click"` = 행/셀 클릭 시 선택, `"focus"` = 셀 포커스 시 선택. 키보드 위주 화면이면 `"focus"`.
-- `getItemSelectableFn?: (item) => boolean | string` — 행 선택 가능 여부. `string` 반환 시 비활성 + 그 문자열을 툴팁 사유로 표시.
-- `getChildrenFn?: (item, index) => TItem[] | undefined` — 트리 자식. 지정 시 확장 토글 컬럼 노출.
-- `useAutoSort = input(false)` — 클라이언트 정렬. true 면 `sorts` 변경 시 시트가 직접 `items` 정렬. 서버측 정렬/페이징이면 false 로 두고 외부에서 재조회.
-- `visiblePageCount = input(10)`/`totalPageCount = input(0)`/`itemsPerPage = input(0)` — 페이지네이션. `totalPageCount>0` 면 서버 페이징, `itemsPerPage>0` 면 클라이언트 페이징.
-- `focusMode: "row"|"cell"` — 키보드 포커스 단위. `"row"` = 행 강조만, `"cell"` = 셀 단위 포커스/편집. 기본 `"cell"`.
-- `inset = input(false)` — 테두리 없는 삽입형.
-- `contentStyle` — 스크롤 컨테이너 인라인 스타일.
-- `getItemCellClassFn?: (item, colKey) => string` / `getItemCellStyleFn?: (item, colKey) => string | undefined` — 셀별 동적 클래스/스타일.
-- `hideConfigBar = input(false)` — 상단 설정/페이지 바 숨김.
-- `columnControlsInput = input<readonly SdSheetColumn[]>([])` — 투영 외 추가 컬럼 컨트롤(예: CRUD 목록이 삭제 컬럼 주입).
-
-outputs:
-- `itemKeydown = output<SdSheetItemKeydownEventParam<TItem>>()` — 행에서 키 입력(`{ item, event }`).
-- `cellKeydown = output<SdSheetCellKeydownEventParam<TItem>>()` — 셀에서 키 입력(`{ item, key, event }`, key=컬럼키).
-
-models(양방향):
-- `selectedKeys = model<unknown[]>([])` — 선택 행 키 배열.
-- `expandedItems = model<TItem[]>([])` — 펼친 트리 항목.
-- `sorts = model<SortingDef[]>([])` — 정렬 정의(`{ key, desc }[]`). 헤더 클릭으로 토글(Shift=다중).
-- `currentPage = model(0)` — 현재 페이지(0-base).
-
-## SdSheetColumn
-
-`<sd-sheet-column>` 디렉티브 — 컬럼 정의. 제네릭 `<T>`.
-
-- `key = input.required<string>()` — 컬럼 식별키(설정 저장·정렬·이벤트 기준).
-- `header: string | string[]` — 헤더 텍스트. 배열이면 다단(그룹) 헤더.
-- `headerStyle`/`tooltip` — 헤더 스타일·툴팁.
-- `width` — 컬럼 폭(CSS 값).
-- `fixed = input(false)` — 좌측 고정.
-- `hidden = input(false)` — 숨김.
-- `collapse = input(false)` — 접힘.
-- `disableSorting = input(false)` — 정렬 비활성.
-- `disableResizing = input(false)` — 폭 조절 비활성.
-- `ordering = input(0)` — 컬럼 정렬 순서.
-- 셀 본문은 `<ng-template [cell]="items()" let-item="item" let-edit="edit">`, 헤더 커스텀은 `#headerTpl`, 합계행은 `#summaryTpl`.
-
-`SdSheetCellContext<T>` (셀 템플릿 컨텍스트): `$implicit`/`item`(행 데이터), `index`(행 인덱스), `depth`(트리 깊이), `edit`(현재 셀 편집모드 여부).
-
-## SdSheetColumnCellTemplate
-
-`<ng-template [cell]>` 디렉티브 — 셀 본문 템플릿 마커. `cell = input.required<T[]>()` 로 타입 추론용 items 를 받아 `SdSheetCellContext<T>` 컨텍스트 타입 가드 제공.
-
-## SdSheetConfigModal
-
-`<sd-sheet-config-modal>` — 시트 설정(컬럼 표시/순서/고정/폭) 편집 모달. `sd-sheet` 의 설정 버튼이 내부적으로 띄움. 직접 사용은 드묾.
-
-## 타입
-
-- `SdSheetColumnDef` — 해석된 컬럼 정의(`key`/`header`/`width`/`fixed`/`hidden`/`collapse`/`disableSorting`/`disableResizing`/`ordering`/`headerStyle`/`tooltip`).
-- `SdSheetHeaderDef` — 헤더 셀 메타(`text`/`colspan`/`rowspan`/`isLastRow`/`fixed`/`colDef`/`colIndex`).
-- `SdSheetConfig` — 영속화 형태. `columnRecord: Record<키, { width?; hidden?; fixed?; ordering? }>`.
-- `SdSheetItemKeydownEventParam<T>` — `{ item, event }`.
-- `SdSheetCellKeydownEventParam<T>` — `{ item, key, event }`.
-- `SortingDef`(re-export) — `{ key: string; desc: boolean }`.
+데이터 그리드. 정렬·선택·페이징·컬럼 고정·셀 편집·트리 확장·컬럼 설정 영속을 한 컴포넌트로 다룸. 컬럼은 `sd-sheet-column` 디렉티브로 선언하고 셀은 `ng-template[cell]` 로 그림.
+
+## SdSheet<TItem>
+
+`<sd-sheet [items]="..." [trackByFn]="...">`.
+
+### Inputs
+- key?: string — 지정 시 컬럼 폭/순서/숨김/고정 상태를 `SdSystemConfigProvider` 에 영속하고 설정 버튼(톱니) 노출. 사용자 컬럼 커스터마이즈를 저장하려면 지정.
+- items: TItem[] — 표시 데이터(기본 []).
+- trackByFn: (item, index) => unknown — 행 식별 키. 선택키도 이 값 기준. 기본 `(item) => item`.
+- selectMode?: "single"|"multi" — 행 선택 모드. 미지정 시 선택 비활성. single=단일 행, multi=다중 + 헤더 전체선택 체크박스.
+- autoSelect?: "click"|"focus" — 행 자동 선택 트리거. "click"=행 클릭 시 선택, "focus"=셀 포커스 이동만으로 선택. 키보드 위주면 "focus".
+- getItemSelectableFn?: (item) => boolean | string — 행 선택 가능 여부. string 반환 시 그 사유로 선택 불가.
+- getChildrenFn?: (item, index) => TItem[] | undefined — 트리 자식. 지정 시 확장(▶) 토글 표시.
+- useAutoSort: boolean — 클라이언트 정렬. true 면 sorts 변경 시 sd-sheet 가 items 를 직접 정렬. 서버측 정렬/페이징이면 false 로 두고 외부에서 items 재조회.
+- visiblePageCount: number — 페이지네이션 한 그룹 표시 수(기본 10).
+- totalPageCount: number — 서버측 페이징 시 전체 페이지 수.
+- itemsPerPage: number — >0 이면 클라이언트 페이징(페이지당 행 수).
+- focusMode: "row"|"cell" — 키보드 포커스 단위(기본 cell). "row"=행 전체 이동, "cell"=셀 단위 이동(셀 편집·복사 화면이면 cell).
+- inset: boolean — 테두리 제거(컨테이너 내부 삽입).
+- contentStyle?: string — 스크롤 영역 인라인 스타일.
+- getItemCellClassFn?/getItemCellStyleFn?: (item, colKey) => ... — 셀별 클래스/스타일 동적 지정.
+- hideConfigBar: boolean — 상단 도구 바(설정·페이지네이션) 숨김.
+- columnControlsInput: readonly SdSheetColumn[] — 템플릿이 아닌 코드로 컬럼을 넘길 때(투영 `sd-sheet-column` 과 합쳐짐).
+
+### Outputs / Models
+- (output) itemKeydown: `SdSheetItemKeydownEventParam<TItem>` = `{ item; event: KeyboardEvent }` — 행에서 키 입력.
+- (output) cellKeydown: `SdSheetCellKeydownEventParam<TItem>` = `{ item; key: string; event }` — 셀에서 키 입력(key=컬럼 key).
+- (model) selectedKeys: unknown[] — 선택된 행 키 배열(trackByFn 값).
+- (model) expandedItems: TItem[] — 확장된 트리 행.
+- (model) sorts: SortingDef[] — 정렬 상태(`{ key; desc }[]`, 헤더 클릭으로 토글, selection-managers.md 참조).
+- (model) currentPage: number — 현재 페이지(0 기반).
+
+## SdSheetColumn<T>
+
+`<sd-sheet-column [key]="...">` 디렉티브. 컬럼 1개 정의.
+- key: input.required<string> — 컬럼 식별·정렬/설정 키.
+- header: string | string[] — 헤더 텍스트(배열이면 다단 헤더 그룹).
+- headerStyle?: string — 헤더 셀 스타일.
+- tooltip?: string — 헤더 툴팁.
+- width?: string — 컬럼 폭.
+- fixed: boolean — 좌측 고정 컬럼.
+- hidden: boolean — 숨김.
+- collapse: boolean — 접힘(폭 축소).
+- disableSorting: boolean — 정렬 비활성.
+- disableResizing: boolean — 폭 조절 비활성.
+- ordering: number — 컬럼 정렬 순서(기본 0).
+- (contentChild) cellTplRef: `ng-template[cell]` 필수 — 셀 본문. headerTpl/summaryTpl 템플릿으로 커스텀 헤더·요약 행.
+
+## SdSheetColumnCellTemplate<T>
+
+`<ng-template cell let-item="item" ...>` 디렉티브. 컬럼 셀 본문 템플릿 규약. 컨텍스트 `SdSheetCellContext<T>` = `{ $implicit; item; index; depth; edit }`(edit=현재 셀 편집모드 여부). `cell = input.required<T[]>()` 로 항목 배열 타입 추론.
 
 ```html
-<sd-sheet [items]="rows()" [(selectedKeys)]="sel" [selectMode]="'multi'"
-          [(sorts)]="sorts" [useAutoSort]="true" key="order-sheet">
+<sd-sheet [items]="rows()" [trackByFn]="trackByFn" [(selectedKeys)]="selectedKeys" selectMode="multi">
   <sd-sheet-column key="name" header="이름" [fixed]="true">
-    <ng-template [cell]="rows()" let-item="item">{{ item.name }}</ng-template>
+    <ng-template cell let-item="item">{{ item.name }}</ng-template>
   </sd-sheet-column>
 </sd-sheet>
 ```
+
+## SdSheetConfigModal
+
+컬럼 설정(폭/순서/고정/숨김) 편집 모달 컴포넌트. `SdSheet` 가 설정 버튼 클릭 시 내부적으로 띄움. 직접 사용 드묾.
+
+## 타입(types.ts)
+
+- **SdSheetColumnDef** — 내부 계산된 컬럼 정의(`key; header; headerStyle; tooltip; width; fixed; hidden; collapse; disableSorting; disableResizing; ordering`).
+- **SdSheetHeaderDef** — 헤더 셀 레이아웃 정의(`text; colspan; rowspan; isLastRow; fixed; colDef; colIndex`).
+- **SdSheetConfig** — 영속되는 설정(`columnRecord: Record<key, { width?; hidden?; fixed?; ordering? }>`).
+- **SdSheetItemKeydownEventParam<T>** / **SdSheetCellKeydownEventParam<T>** — 위 output 이벤트 형태.