@simplysm/sd-claude 14.0.82 → 14.0.83

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

@@ -1,115 +0,0 @@
-# @simplysm/angular — modal
-
-`SdModalProvider.showAsync` 로 프로그래밍 호출, 또는 `<sd-modal>` 컴포넌트 직접 배치.
-
-## SdModalProvider (root)
-
-```ts
-modalCount: WritableSignal<number>;
-showAsync<T extends SdModalContentDef<any>>(modal: SdModalInfo<T>, options?: SdModalOptions): Promise<O|undefined>;
-
-interface SdModalContentDef<O> {
-  initialized: Signal<boolean>;
-  close: OutputEmitterRef<O|undefined>;
-  actionTplRef?: TemplateRef<any>;
-  readonly _optionalModalInputs?: string;  // type-level marker, optional inputs 이름 union
-}
-
-interface SdModalInfo<T, X = ""> {
-  title: string;
-  type: Type<T>;
-  inputs: ...;   // T 의 InputSignal prop 들 (close/initialized 등 제외, _optionalModalInputs 마킹 prop 은 optional)
-}
-
-interface SdModalOptions {
-  key?: string; hideHeader?: boolean; hideCloseButton?: boolean;
-  headerStyle?: string;
-  useCloseByBackdrop?: boolean; useCloseByEscapeKey?: boolean;
-  float?: boolean; fill?: boolean;
-  resizable?: boolean; movable?: boolean;
-  position?: "bottom-right"|"top-right";
-  minHeightPx?: number; minWidthPx?: number;
-  heightPx?: number; widthPx?: number;
-  noFirstControlFocusing?: boolean;
-}
-```
-
-- `showAsync` — 컴포넌트 동적 생성·body 부착·열림 애니메이션·포커스 캡처. 컨텐츠 컴포넌트가 `close.emit(result)` 또는 배경/ESC/닫기버튼으로 `closeRequest` 발화하면 close 진행, Promise 가 result 로 resolve(취소는 undefined).
-- `modalCount` — 동시 열린 모달 수. 키보드 이벤트 핸들러 등에서 활용.
-- `SdModalContentDef.initialized` — 모달 컴포넌트가 자기 준비 끝났을 때 `true` 로 set. `SdPrintProvider` 등은 이걸 기다림(`SdModalProvider` 는 직접 사용 안 함).
-- `SdModalContentDef.actionTplRef` — 모달 헤더 우측 추가 액션 영역에 띄울 `TemplateRef`. set 하면 자동으로 `<sd-modal>` 의 `actionTplRef` 로 브릿지.
-- `_optionalModalInputs` — `SdModalInfo.inputs` 의 일부 prop 을 optional 로 만들 때 사용하는 type-level 마커(`= "fieldA" | "fieldB"`). 런타임 값 없음.
-- `SdModalOptions` 필드별:
-  - `key` — 지정 시 `SdSystemConfigProvider` 키 `sd-modal.<key>` 로 width/height/left/top 자동 저장·복원.
-  - `hideHeader`/`hideCloseButton` — 헤더 영역 전체/닫기 버튼만 숨김.
-  - `headerStyle` — 헤더 인라인 style 문자열.
-  - `useCloseByBackdrop`/`useCloseByEscapeKey` — 기본 true. false 면 배경 클릭/ESC 무시.
-  - `float` — true 면 배경 어둡지 않고 그림자만(비차단 플로팅).
-  - `fill` — true 면 전체 화면. 헤더 투명·테두리 없음.
-  - `resizable` — true 면 8방향 리사이즈 핸들.
-  - `movable` — true 면 헤더 드래그로 이동.
-  - `position` — `bottom-right`/`top-right` 절대 배치. 미지정 = 상단 가운데.
-  - `minWidthPx`/`minHeightPx`/`widthPx`/`heightPx` — 사이즈 제약·고정.
-  - `noFirstControlFocusing` — true 면 첫 탭가능 요소가 아니라 dialog 박스 자체에 포커스.
-
-```ts
-const result = await sdModal.showAsync({ title: "직원선택", type: EmpSelectModal, inputs: {} }, { resizable: true, key: "emp-select" });
-```
-
-## SdModal — `<sd-modal>`
-
-`SdModalProvider` 가 내부에서 사용. 직접 템플릿에 두려면:
-
-```ts
-open = model(false); key = input<string|undefined>();
-title = input(""); hideHeader = input(false); hideCloseButton = input(false);
-headerStyle = input<string|undefined>();
-useCloseByBackdrop = input(true); useCloseByEscapeKey = input(true);
-float = input(false); fill = input(false);
-resizable = input(false); movable = input(false);
-position = input<"bottom-right"|"top-right"|undefined>();
-minHeightPx/minWidthPx/heightPx/widthPx = input<number|undefined>();
-actionTplRef = input<TemplateRef<any>|undefined>();
-closeRequest = output<void>();
-```
-
-- 의미는 위 `SdModalOptions` 와 1:1. `closeRequest` 발화 시 부모가 `open.set(false)` 책임.
-
-## SdActivatedModalProvider (inject inside modal content)
-
-```ts
-modalComponent: WritableSignal<SdModal|undefined>;
-contentComponent: WritableSignal<T|undefined>;
-canDeactivateFn: () => boolean;  // 닫기 차단 시 false 반환
-```
-
-- 컨텐츠 컴포넌트 내부에서 `inject(SdActivatedModalProvider)` 로 자기 모달 참조 가져오기. `canDeactivateFn` 을 함수로 덮어쓰면 ESC/배경/닫기버튼이 false 시 닫힘 차단(저장 안된 변경 사항 보호 패턴).
-- `setupCanDeactivate(fn)` 헬퍼가 이걸 set 함 ([routing.md](./routing.md)).
-
-## SdPromptModal / SdConfirmModal (사전 정의 컨텐츠)
-
-```ts
-class SdPromptModal implements SdModalContentDef<string> { message = input.required<string>(); }
-class SdConfirmModal implements SdModalContentDef<boolean> { message = input.required<string>(); }
-```
-
-- 확인 시 prompt 는 입력값, confirm 은 `true` emit. 취소는 둘 다 `undefined`.
-
-```ts
-const input = await sdModal.showAsync({ title: "입력", type: SdPromptModal, inputs: { message: "이름?" } });
-const ok = await sdModal.showAsync({ title: "확인", type: SdConfirmModal, inputs: { message: "삭제할까요?" } });
-```
-
-## SelectModalOutputResult<TKey>
-
-```ts
-interface SelectModalOutputResult<TKey = any> { selectedKeys: TKey[]; }
-```
-
-- `SdModalSelectButton`/`SdSharedDataSelect*` 가 선택 모달을 호출할 때 모달이 emit 할 표준 출력 형태.
-
-## 주의
-
-- 컨텐츠 컴포넌트가 `close.emit(value)` 를 호출해야 Promise 가 resolve. 닫기 버튼/ESC/배경 클릭은 `closeRequest` → `undefined` resolve.
-- 컨텐츠 안에 `<ng-template #actionTpl>...</ng-template>` 두고 컴포넌트 클래스에서 `actionTplRef = viewChild('actionTpl')` 한 뒤 set 하면 헤더 액션 영역 표시됨.
-- `resizable`/`movable`/`key` 조합 시 사용자 조정 사이즈·위치가 `sd-modal.<key>` 키로 `SdSystemConfigProvider` 에 저장됨.

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

@@ -1,107 +0,0 @@
-# @simplysm/angular — routing
-
-Angular Router 위에 페이지 코드(`a.b.c` 점 표기)·뷰 타입·새창 네비게이션 헬퍼.
-
-## SdRouterLink — `[sdRouterLink]` (Directive)
-
-```ts
-option = input<{
-  link: string;
-  params?: Record<string, string>;
-  window?: { width?: number; height?: number };  // 새창 띄울 때 크기
-  outletName?: string;
-  queryParams?: Record<string, string>;
-} | undefined>(undefined, { alias: "sdRouterLink" });
-```
-
-- click 처리. `Alt+click` 무시(브라우저 기본 다운로드 거동 보존). 새창 모드(`SdNavigateWindowProvider.isWindow=true` 또는 `Ctrl/Shift+click`)면 `window.open` 으로 새창 띄움. 일반 모드면 `Router.navigate`.
-- `link` — 라우터 경로. `window` 옵션 지정 시 width/height (기본 800x800) 으로 새창.
-- `outletName` — 보조 outlet 라우팅용. 미지정 시 primary.
-- `params`/`queryParams` — 라우터 매트릭스 파라미터/쿼리 파라미터.
-
-```html
-<sd-anchor [sdRouterLink]="{ link: '/home/sales/invoice', params: { id: '1' } }">송장</sd-anchor>
-```
-
-## SdNavigateWindowProvider (root)
-
-```ts
-get isWindow: boolean;        // 현재 URL hash 의 ;window=true 여부
-open(navigate: string, params?: Record<string, string>, features?: string): void;
-```
-
-- 현재 창이 simplysm 새창 모드인지 판단(`location.hash` 의 `;window=true`).
-- `open` — 새창이거나 `features` 가 주어지면 `window.open(... features)`. 일반 모드면 `_blank` 탭. 부모창 close 시 자식들도 일괄 종료.
-
-## injectCurrentPageCodeSignal
-
-```ts
-function injectCurrentPageCodeSignal(): Signal<string> | undefined
-```
-
-- `ActivatedRoute.pathFromRoot.slice(2)` 의 url segments 를 `.` 으로 join. 라우터 컨텍스트 없으면 undefined.
-- 예: `/home/sales/invoice` → `"sales.invoice"`.
-
-## injectFullPageCodeSignal
-
-```ts
-function injectFullPageCodeSignal(): Signal<string>
-```
-
-- `Router.events` 의 NavigationEnd → URL → segment 2개부터 `.` join. matrix/query 제거.
-- "전체 페이지 코드" 로 메뉴 선택 상태 판정에 사용.
-
-## injectViewTitleSignal
-
-```ts
-function injectViewTitleSignal(): Signal<string>
-```
-
-- 모달 안이면 `SdActivatedModalProvider.modalComponent().title()`.
-- 그 외엔 `SdAppStructureProvider.getTitleByFullCode(currentPageCode ?? fullPageCode)`.
-- 페이지/모달 상단에 표시할 제목.
-
-## injectViewTypeSignal
-
-```ts
-function injectViewTypeSignal(): Signal<SdViewType>;
-type SdViewType = "page" | "modal" | "control";
-```
-
-- `page`: 라우터 진입 페이지 컴포넌트, `modal`: 모달 컨텐츠, `control`: 그 외(다른 컴포넌트의 자식). 컴포넌트가 자기 컨텍스트별로 다르게 그릴 때.
-
-## setupCanDeactivate
-
-```ts
-function setupCanDeactivate(fn: () => boolean): void
-```
-
-- 모달 안: `SdActivatedModalProvider.canDeactivateFn = fn` 으로 ESC/배경/닫기 차단.
-- 라우터 페이지: route config 에 `CanDeactivate` 가드 추가(컴포넌트 파괴 시 자동 제거).
-- 저장 안된 변경 사항 보호용.
-
-```ts
-setupCanDeactivate(() => !isDirty() || confirm("변경 사항이 있습니다. 나가시겠습니까?"));
-```
-
-## getMenuRouterLinkOption
-
-```ts
-function getMenuRouterLinkOption(menu: SdMenu): { link: string; queryParams: Record<string, string>|undefined } | undefined
-```
-
-- leaf 메뉴(`children` 도 `url` 도 없음)만 결과 반환. 그룹/외부URL 메뉴는 undefined.
-- 반환 link 는 `/home/<codeChain join "/">`. 마지막 segment 에 `?key=val` 포함 시 분리해 queryParams 로.
-
-## getIsMenuSelected
-
-```ts
-function getIsMenuSelected(menu: SdMenu, fullPageCode: string|undefined, customFn?: (menu) => boolean): boolean
-```
-
-- 커스텀 함수 있으면 그것 사용. 없으면 `fullPageCode === menu.codeChain.join(".")`.
-
-## 주의
-
-- 페이지 코드는 `/home/` 다음의 segment 들 `.` join. 라우터를 이 컨벤션에 맞춰 설계해야 메뉴 선택 표시·뷰 타이틀 자동 동작.
-- `SdRouterLink` 의 `link` 는 라우터 절대경로 또는 상대경로. `link` 에 `?queryString` 직접 쓰지 말고 `queryParams` 객체로 분리.

package/claude/references/sd-simplysm14/apis/angular/select-dropdown.md

@@ -1,35 +0,0 @@
-# @simplysm/angular — select-dropdown
-
-## `<sd-dropdown>` / `<sd-dropdown-popup>`
-
-```html
-<sd-dropdown [(open)]="open" [disabled]="false">
-  trigger 컨텐츠
-  <sd-dropdown-popup>팝업 컨텐츠</sd-dropdown-popup>
-</sd-dropdown>
-```
-
-- `open` 시 popup을 body로 이동(트리거 위치 기준 배치). 모바일(`max-width:520px`)이면 backdrop+bottom sheet.
-- 트리거 클릭/Enter/ArrowDown 으로 open.
-
-## `<sd-select<M extends "single"|"multi", T>>`
-
-```html
-<sd-select [items]="items" [(value)]="value" [selectMode]="'single'" [trackByFn]="byId">
-  <sd-select-item *ngFor="let it of items" [value]="it.id">{{ it.name }}</sd-select-item>
-</sd-select>
-```
-
-`SelectModeValue<T> = { single: T; multi: T[] }`. value type = `SelectModeValue<T>[M]`.
-
-주요 input: `selectMode`, `value` (model), `placeholder`, `disabled`, `inline`, `inset`, `size`, `required`, `hideSelectAll`, `multiSelectionDisplayDirection: "vertical"`, `items`, `trackByFn`, `getChildrenFn` (트리), `contentClass/Style`, `dropdownOpen` (model).
-
-`<ng-template #headerTpl>`, `<ng-template #beforeTpl>`, `<ng-template itemOf>` (`SdItemOfTemplate`) 으로 커스터마이즈.
-
-## `<sd-select-item<T> [value]>`
-
-projected content 가 옵션 라벨.
-
-## `<sd-select-button>`
-
-검색 트리거 버튼만 노출하는 경량 select (내부 사용용).

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

@@ -1,82 +0,0 @@
-# @simplysm/angular — selection-managers
-
-리스트 컴포넌트 내부에서 쓰는 선택·확장·정렬 로직 함수 훅. signal 바인딩.
-
-## useSelectionManager
-
-```ts
-function useSelectionManager<TItem, TKey>(options: {
-  displayItems: Signal<TItem[]>;
-  selectedKeys: WritableSignal<TKey[]>;
-  selectMode: Signal<"single"|"multi"|undefined>;
-  getItemSelectableFn: Signal<((item: TItem) => boolean|string)|undefined>;
-  trackByFn: Signal<(item, index) => TKey>;
-}): {
-  hasSelectable: Signal<boolean>;
-  isAllSelected: Signal<boolean>;
-  getSelectable(item): true|string|undefined;
-  getCanChangeFn(item): () => boolean;
-  select(item): void;
-  deselect(item): void;
-  toggle(item): void;
-  toggleAll(): void;
-  isSelected(item): boolean;
-};
-```
-
-- `selectMode=single` 이면 `select` 가 기존 키 덮어씀, `multi` 면 추가.
-- `getItemSelectableFn` — true: 선택 가능, false: 불가, string: 불가 + 사유.
-- `getSelectable` 반환 → `true` (선택 가능), `string` (사유), `undefined` (해당 없음).
-- `isAllSelected` — selectable 항목 전체가 선택된 상태.
-- 키 비교는 `obj.equal` (deep equal).
-
-## useExpandingManager
-
-```ts
-function useExpandingManager<T>(binding: {
-  items: Signal<T[]>;
-  expandedItems: WritableSignal<T[]>;
-  getChildrenFn: Signal<((item: T, index: number) => T[]|undefined)|undefined>;
-  sort: (items: T[]) => T[];
-}): {
-  displayItems: Signal<T[]>;     // 트리 평탄화 + 정렬 적용
-  hasExpandable: Signal<boolean>;
-  isAllExpanded: Signal<boolean>;
-  toggle(item): void;
-  toggleAll(): void;
-  isVisible(item): boolean;       // 조상 모두 expanded 인지
-  def(item): ExpandItemDef<T>;
-};
-
-interface ExpandItemDef<T> {
-  item: T;
-  parentDef: ExpandItemDef<T>|undefined;
-  hasChildren: boolean;
-  depth: number;
-}
-```
-
-- `getChildrenFn` 으로 트리 워킹 → 깊이·부모 정보 포함한 def 배열 생성.
-- `sort` — 각 depth 별 자식들에 적용할 정렬 함수(보통 `useSortingManager.sort`).
-- `isVisible` — 항목이 화면에 보일 조건(모든 조상이 expanded).
-
-## useSortingManager
-
-```ts
-function useSortingManager(options: { sorts: WritableSignal<SortingDef[]> }): {
-  defMap: Signal<Map<string, { indexText?: string; desc: boolean }>>;
-  toggle(key: string, multiple: boolean): void;
-  sort<T>(items: T[]): T[];
-};
-
-interface SortingDef { key: string; desc: boolean; }
-```
-
-- 컬럼 클릭 시 `toggle(key, ctrlKey)`. 단일 정렬은 `asc → desc → 없음` 순환, 다중(`multiple=true`)은 같은 키 누적 + 마지막에 제거.
-- `defMap.indexText` — 다중 정렬일 때 컬럼 헤더에 표시할 순번 ("1", "2"…). 단일이면 undefined.
-- `sort` — `key` 별 prop 값 비교. string 은 localeCompare, number 는 산술, 그 외는 String 변환 localeCompare. null/undefined 는 최소값.
-
-## 주의
-
-- 세 훅 모두 컴포넌트의 inject 컨텍스트 없이 호출 가능(순수 함수). 단 signal 바인딩이므로 reactive 컨텍스트에서 사용.
-- `<sd-sheet>` 가 내부적으로 셋 다 사용. 새 리스트 컴포넌트 만들 때 같은 동작 원하면 재사용.

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

@@ -1,134 +0,0 @@
-# @simplysm/angular — shared-data
-
-서버 마스터데이터(부서·거래처·코드 등)를 키 기반으로 등록/구독. 서버 변경 이벤트로 자동 부분 갱신.
-
-## SdSharedDataProvider<T> (abstract, 사용자가 상속해 `initialize()` 안에서 `register` 호출)
-
-```ts
-abstract class SdSharedDataProvider<T extends Record<string, SharedDataBase<string|number>>> {
-  loadingCount: WritableSignal<number>;
-  abstract initialize(): void;
-  register<K extends keyof T & string>(name: K, info: SharedDataInfo<T[K]>): void;
-  getHandle<K extends keyof T & string>(name: K): SharedDataHandle<T[K]>;
-  emitAsync<K extends keyof T & string>(name: K, changeKeys?: (string|number)[]): Promise<void>;
-  wait(): Promise<void>;     // loadingCount 가 0 될 때까지
-}
-
-interface SharedDataBase<TKey> {
-  __valueKey: TKey;
-  __searchText: string;
-  __isHidden: boolean;
-  __parentKey?: TKey;
-}
-interface SharedDataInfo<T> {
-  serviceKey: string;                                    // SdServiceClientFactoryProvider 의 client key
-  getter: (changeKeys?: (string|number)[]) => Promise<T[]>;
-  filter?: unknown;
-  orderBy?: (item: T) => any;
-}
-interface SharedDataHandle<T> {
-  items: Signal<T[]>;
-  get(key: T["__valueKey"]|undefined): T|undefined;
-}
-
-const SdSharedDataChangeEvent = defineEvent<{ name: string; filter: unknown }, (string|number)[]|undefined>("SdSharedDataChange");
-```
-
-- `register` — 데이터 소스 등록. `getHandle` 첫 호출 시 `getter()` lazy 로드 + 서버 이벤트 리스너 등록. 이후 `SdSharedDataChangeEvent` 수신 시 `changeKeys` 기준 부분 갱신(또는 undefined 면 전체 reload).
-- `getHandle.items` — readonly signal. orderBy 적용된 정렬 상태.
-- `getHandle.get(key)` — `__valueKey` 로 O(1) 조회.
-- `emitAsync` — 클라이언트에서 변경 발생 시 같은 `serviceKey` 의 다른 클라이언트에 변경 통지(filter 동일한 등록만 수신).
-- `wait` — 초기 로드/갱신이 완료될 때까지. CRUD 컨테이너의 ready 처리에 사용.
-- `SharedDataBase` 의 `__searchText` — `matchesSearchText` 가 사용할 검색 대상 문자열. `__isHidden` — 보이지 않을 항목 마킹. `__parentKey` — 트리형 데이터의 부모 키.
-- `filter` — 서버 측 필터 식별자. 다른 filter 로 등록된 같은 name 은 별개 인스턴스.
-
-```ts
-@Injectable({ providedIn: "root" })
-class MySharedData extends SdSharedDataProvider<{ depts: Dept }> {
-  initialize() {
-    this.register("depts", {
-      serviceKey: "main",
-      getter: async (keys) => await api.depts.list(keys),
-      orderBy: (d) => d.name,
-    });
-  }
-}
-const depts = mySharedData.getHandle("depts").items();
-```
-
-## SdSharedDataSelect — `<sd-shared-data-select>`
-
-```ts
-class SdSharedDataSelect<TMode, TModal, TItem extends SharedDataBase<...>>
-value = model<SelectModeValue<TItem["__valueKey"]|undefined>[TMode]>();
-items = input.required<TItem[]>();
-disabled/required/useUndefined/inset/inline = input(false); size = input<"sm"|"lg">();
-selectMode = input("single" as TMode);
-filterFn = input<(item, index, ...params) => boolean>();
-filterFnParams = input<any[]>();
-modal = input<SdSelectModalInfo<TModal>>();
-editModal = input<SdModalInfo<SdModalContentDef<boolean>>>();
-selectClass = input<string>();
-multiSelectionDisplayDirection = input<"vertical">();
-getIsHiddenFn = input<(item, index) => boolean>(...);    // 기본 (i)=>i.__isHidden
-getSearchTextFn = input<(item, index) => string>(...);   // 기본 (i)=>i.__searchText
-displayOrderKeyProp = input<string>();
-```
-
-- 공유데이터 전용 셀렉트. `items` 는 보통 `sharedData.getHandle("xx").items()`.
-- `useUndefined` — true 면 "선택 안 함" 옵션 노출. 단일 모드에서 null 가능.
-- `filterFn` + `filterFnParams` — 추가 필터(signal 변경 시 재계산).
-- `modal` — "더보기" 검색 모달. 미지정 시 모달 버튼 안 보임.
-- `editModal` — 항목 편집 모달(연필 아이콘). true emit 시 데이터 reload.
-- `getIsHiddenFn`/`getSearchTextFn` — 기본은 `SharedDataBase` 의 `__isHidden`/`__searchText` 사용. 커스텀 가능.
-- `displayOrderKeyProp` — 트리 표시 시 정렬에 쓸 prop 이름.
-
-## SdSharedDataSelectButton — `<sd-shared-data-select-button>`
-
-```ts
-value = model<SelectModeValue<string|number>[TMode]>();
-items = input<TItem[]>([]);
-modal = input.required<SdSelectModalInfo<TModal>>();
-selectMode = input<TMode>("single" as TMode);
-disabled/required/inset = input(false); size = input<"sm"|"lg">();
-```
-
-- 셀렉트 드롭다운 대신 항상 모달로 검색. `<ng-content>` 가 선택값 표시 슬롯. `modal` 필수.
-
-## SdSharedDataSelectList — `<sd-shared-data-select-list>`
-
-```ts
-class SdSharedDataSelectList<TItem extends SharedDataBase<...>, TModal>
-selectedItem = model<TItem>();
-canChangeFn = input<(item: TItem|undefined) => boolean|Promise<boolean>>(...);
-items = input.required<TItem[]>();
-selectedIcon = input<string>();
-useUndefined = input(false);
-filterFn = input<(item, index) => boolean>();
-modal = input<SdSelectModalInfo<TModal>>();
-header = input<string>();
-pageItemCount = input<number>();
-```
-
-- 사이드 패널형 리스트(단일 선택). 검색 박스 + 페이지네이션 자동.
-- `canChangeFn` — 변경 직전 비동기 확인.
-- `pageItemCount` — 페이지당 항목 수. 미지정 시 페이지 분할 없음.
-
-## matchesSearchText
-
-```ts
-function matchesSearchText(itemText: string, searchQuery: string|undefined): boolean
-```
-
-- 공백 분리 AND 검색. 모든 단어가 `itemText` (대소문자 무시) 안에 포함되면 true. 빈 query 는 true.
-- 커스텀 선택 리스트에서 검색 필터 짤 때 사용.
-
-```ts
-items.filter((it) => matchesSearchText(it.name + " " + it.code, q()))
-```
-
-## 주의
-
-- `SdSharedDataProvider` 상속 후 `initialize()` 안에서만 `register`. 부트스트랩 시 1회 호출.
-- 같은 name 으로 다시 `register` 호출 시 generation 증가 + listener 교체 → 이전 비동기 결과는 무시.
-- 변경 이벤트는 같은 `serviceKey` 의 같은 `name`·동일 `filter` 등록만 수신.

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

@@ -1,127 +0,0 @@
-# @simplysm/angular — sheet
-
-데이터 그리드. 컬럼·셀 템플릿·정렬·페이징·선택·확장 트리·컬럼 설정 모달 내장.
-
-## SdSheet — `<sd-sheet>`
-
-```ts
-class SdSheet<TItem>
-key = input<string>();
-items = input<TItem[]>([]);
-trackByFn = input<(item: TItem, index: number) => unknown>((i) => i);
-selectMode = input<"single"|"multi">();
-autoSelect = input<"click"|"focus">();
-getItemSelectableFn = input<(item) => boolean|string>();
-getChildrenFn = input<(item, index) => TItem[]|undefined>();
-useAutoSort = input(false);
-visiblePageCount = input(10);
-totalPageCount = input(0);
-itemsPerPage = input(0);
-focusMode = input<"row"|"cell">("cell");
-inset = input(false);
-contentStyle = input<string>();
-getItemCellClassFn = input<(item, colKey: string) => string>();
-getItemCellStyleFn = input<(item, colKey: string) => string|undefined>();
-hideConfigBar = input(false);
-
-itemKeydown = output<SdSheetItemKeydownEventParam<TItem>>();
-cellKeydown = output<SdSheetCellKeydownEventParam<TItem>>();
-
-selectedKeys = model<unknown[]>([]);
-expandedItems = model<TItem[]>([]);
-sorts = model<SortingDef[]>([]);
-currentPage = model(0);
-
-columnControlsInput = input<readonly SdSheetColumn[]>([]);  // 동적 컬럼 주입용
-```
-
-- `key` — 지정 시 `SdSystemConfigProvider` 키 `sd-sheet.<key>` 로 컬럼 width/hidden/fixed/ordering 자동 저장·복원. 미지정이면 세션 한정.
-- `items` + `trackByFn` — 데이터와 키 추출. 트리는 `getChildrenFn` 으로 자식 반환(`expandedItems` 양방향 model 로 펼침 상태).
-- `selectMode` — `single`/`multi`. 미지정이면 선택 안 함. `selectedKeys` 는 `trackByFn` 반환값 배열.
-- `autoSelect` — `click`: 행 클릭 시 선택, `focus`: 포커스만 들어가도 선택. 미지정이면 명시적 체크박스만.
-- `getItemSelectableFn` — true 면 선택 가능, false/string 이면 불가(string 은 사유 툴팁).
-- `useAutoSort` — true 면 `sorts` 변경 시 클라이언트 자체 정렬. false 면 서버 사이드 페치 가정.
-- `totalPageCount`/`itemsPerPage`/`visiblePageCount`/`currentPage` — 페이지네이션. `totalPageCount=0` 이면 페이지바 숨김.
-- `focusMode` — `row` 면 행 단위 포커스, `cell` 면 셀 단위(엑셀형).
-- `inset` — 컨테이너 안에 박힌 룩(보더 제거).
-- `getItemCellClassFn`/`getItemCellStyleFn` — 셀별 동적 class/style.
-- `hideConfigBar` — 상단 컬럼 설정 바(컬럼 표시/순서 조작) 숨김.
-- `itemKeydown`/`cellKeydown` — 단축키 처리. focusMode 에 따라 둘 중 1개 활용.
-- 자식: `<sd-sheet-column>` 들을 content projection 으로 배치.
-
-```html
-<sd-sheet [items]="rows()" [trackByFn]="trackById" [(selectedKeys)]="sel" selectMode="multi" key="invoice-list">
-  <sd-sheet-column key="no" header="번호" width="80px" />
-  <sd-sheet-column key="name" header="이름">
-    <ng-template cell [cell]="rows()" let-item>{{ item.name }}</ng-template>
-  </sd-sheet-column>
-</sd-sheet>
-```
-
-## SdSheetColumn — `<sd-sheet-column>` (Directive)
-
-```ts
-class SdSheetColumn<T = unknown>
-key = input.required<string>();
-header = input<string|string[]>("");        // 배열이면 다단 헤더
-headerStyle = input<string>();
-tooltip = input<string>();
-width = input<string>();                     // CSS 값 ("120px"·"1fr")
-fixed = input(false);                        // 좌측 고정 컬럼
-hidden = input(false);
-collapse = input(false);                     // 접힘(헤더만 좁게)
-disableSorting = input(false);
-disableResizing = input(false);
-ordering = input(0);                         // 표시 순서 weight
-
-interface SdSheetCellContext<T = unknown> { ... }   // 셀 템플릿 컨텍스트
-```
-
-- `key` — 정렬·설정 저장 식별자. 시트 내 unique.
-- `header` 배열 — `["상위", "하위"]` 형태로 2단·3단 헤더 그룹화. 인접 컬럼이 같은 상위 헤더면 머지.
-- `fixed` — 좌측 sticky.
-- `ordering` — 사용자가 드래그로 바꾼 순서가 우선. 같은 ordering 끼리는 선언 순서.
-
-## SdSheetColumnCellTemplate — `<ng-template cell>` (Directive)
-
-```ts
-class SdSheetColumnCellTemplate<T> { cell = input.required<T[]>(); }
-```
-
-- `<sd-sheet-column>` 안의 셀 템플릿 마커. `[cell]` 에 items 배열 바인딩(type guard 용도). let-item, let-index, let-depth 사용 가능.
-
-## SdSheetConfigModal — `<sd-sheet-config-modal>` (SdModalContentDef)
-
-```ts
-sheetKey = input.required<string>();
-controls = input.required<readonly SdSheetColumn[]>();
-config = input.required<SdSheetConfig|undefined>();
-close = output<SdSheetConfig|undefined>();
-```
-
-- 컬럼 표시/숨김/순서/너비 설정 모달. `SdSheet` 내부에서 호출. 직접 부를 일은 거의 없음.
-
-## 타입
-
-```ts
-interface SdSheetColumnDef {
-  key, header, headerStyle, tooltip, width, fixed, hidden, collapse,
-  disableSorting, disableResizing, ordering
-}
-interface SdSheetHeaderDef {
-  text, colspan, rowspan, isLastRow, fixed, colDef, colIndex
-}
-interface SdSheetConfig {
-  columnRecord: Record<string, { width?, hidden?, fixed?, ordering? }>;
-}
-interface SdSheetItemKeydownEventParam<T> { item: T; event: KeyboardEvent; }
-interface SdSheetCellKeydownEventParam<T> { item: T; key: string; event: KeyboardEvent; }
-```
-
-- `SdSheetCellContext<T>` 는 셀 템플릿 안에서 노출되는 context 타입(item/index/depth/edit mode 등).
-
-## 주의
-
-- `key` 지정 시 `SdSystemConfigProvider` 가 부착되어 있어야 영구 저장. 미부착이면 `SdLocalStorageProvider` 경유.
-- `selectMode=multi` 일 때 `selectedKeys` 는 `trackByFn` 반환 키. `items` 와 별개 배열.
-- 트리(`getChildrenFn`) + 정렬(`useAutoSort=true`) 동시 사용 시 정렬은 각 depth 안에서만 적용.