@simplysm/sd-claude 14.0.87 → 14.0.88

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

@@ -0,0 +1,115 @@
+# @simplysm/angular — 모달·토스트·Busy·인쇄 (오버레이)
+
+프로그래밍 방식으로 동적 컴포넌트를 body 에 부착하는 루트 프로바이더 4종(모달/토스트/Busy/인쇄)과 콘텐츠 컴포넌트가 구현할 인터페이스. 모두 `createComponent` + `ApplicationRef.attachView` 로 동작.
+
+## SdModalProvider
+
+`class SdModalProvider` — 모달을 프로그래밍 방식으로 띄우는 루트 프로바이더.
+
+- `modalCount: Signal<number>` — 현재 열린 모달 수.
+- `showAsync<T>(modal: SdModalInfo<T>, options?: SdModalOptions): Promise<결과 | undefined>` — 모달 표시. 콘텐츠 컴포넌트의 `close` emit 값으로 resolve, 배경/ESC/닫기버튼이면 `undefined`. 닫힘 애니메이션·포커스 복원·z-index 스택 처리.
+
+`SdModalInfo<T, X>`:
+- `title: string` — 모달 헤더 제목.
+- `type: Type<T>` — 콘텐츠 컴포넌트 클래스(`SdModalContentDef` 구현).
+- `inputs` — 콘텐츠 컴포넌트의 input 값 객체(`initialized`/`close`/`actionTplRef` 제외, `_optionalModalInputs` 로 지정된 키는 optional).
+
+`SdModalOptions`(모두 optional):
+- `key` — 설정 키. 지정 시 크기·위치를 `SdSystemConfigProvider` 에 영속화.
+- `hideHeader` — 헤더 전체 숨김.
+- `hideCloseButton` — 닫기(X) 버튼만 숨김.
+- `headerStyle` — 헤더 인라인 스타일.
+- `useCloseByBackdrop` — 배경 클릭으로 닫기 허용. 기본 true.
+- `useCloseByEscapeKey` — ESC 로 닫기 허용. 기본 true.
+- `float` — 배경 없는 플로팅 모달(다른 조작 가능).
+- `fill` — 전체화면 채움.
+- `resizable` — 모서리/변 드래그 리사이즈.
+- `movable` — 헤더 드래그 이동.
+- `position` — `"bottom-right"|"top-right"`. 고정 위치.
+- `minHeightPx`/`minWidthPx`/`heightPx`/`widthPx` — 크기 px.
+- `noFirstControlFocusing` — 첫 입력요소 자동 포커스 끔(true 면 dialog 자체 포커스).
+
+`SdModalContentDef<O>`(콘텐츠 컴포넌트 구현 인터페이스):
+- `initialized: Signal<boolean>` — 초기화 완료 신호.
+- `close: OutputEmitterRef<O | undefined>` — 결과 emit 시 모달 닫힘.
+- `actionTplRef?: TemplateRef<any>` — 헤더 우측 액션 영역 템플릿.
+- `_optionalModalInputs?: string` — optional 처리할 input 키(타입 마커).
+
+```typescript
+const result = await sdModal.showAsync(
+  { title: "사용자 선택", type: UserSelectModal, inputs: { deptId } },
+  { resizable: true, key: "user-select" },
+);
+```
+
+## SdModal
+
+`<sd-modal>` — 모달 셸 컴포넌트. 보통 `SdModalProvider` 가 내부 생성하지만 선언적으로도 사용 가능.
+
+- `open = model(false)` — 열림 여부 양방향.
+- `title`/`hideHeader`/`hideCloseButton`/`headerStyle`/`useCloseByBackdrop`/`useCloseByEscapeKey`/`float`/`fill`/`resizable`/`movable`/`position`/`minHeightPx`/`minWidthPx`/`heightPx`/`widthPx`/`actionTplRef` — `SdModalOptions` 와 동일 의미의 input.
+- `key` — 크기·위치 영속화 키.
+- `closeRequest = output<void>()` — 배경/ESC/닫기버튼으로 닫기 요청 시 emit.
+
+## SdActivatedModalProvider
+
+`class SdActivatedModalProvider<T>` — 모달 콘텐츠 내부에서 inject 해 모달 컨텍스트에 접근.
+
+- `modalComponent: Signal<SdModal | undefined>` — 부모 `SdModal` 인스턴스.
+- `contentComponent: Signal<T | undefined>` — 콘텐츠 컴포넌트 인스턴스.
+- `canDeactivateFn: () => boolean` — 닫기 차단 함수(true 면 닫힘 허용). `setupCanDeactivate` 가 설정.
+
+## SdPromptModal / SdConfirmModal
+
+내장 범용 모달 콘텐츠. `SdModalProvider.showAsync` 의 `type` 으로 사용.
+
+- `SdPromptModal` — `SdModalContentDef<string>`. `message: input.required<string>()` 표시 후 텍스트 입력. 확인 시 입력값 emit(필수 검증), 취소 시 `undefined`.
+- `SdConfirmModal` — `SdModalContentDef<boolean>`. `message` 표시 후 확인 시 `true`, 취소 시 `undefined` emit.
+
+## SdToastProvider
+
+`class SdToastProvider` — 토스트 알림 루트 프로바이더.
+
+- `alertThemes: WritableSignal<SdToastSeverity[]>` — 이 심각도는 토스트 대신 `window.alert` 로 표시.
+- `overlap: WritableSignal<boolean>` — true 면 새 토스트가 기존 토스트를 모두 치우고 겹쳐 표시.
+- `beforeShowFn?: (theme) => void` — 토스트 표시 직전 콜백.
+- `info/success/warning/danger(message, useProgress?)` — 심각도별 토스트. `useProgress: true` 면 `WritableSignal<number>`(0~100) 반환(100 도달 1초 후 자동 해제), 아니면 3초 후 자동 해제(호버 시 지연).
+- `notify<T>(input: SdToastInput<T>): Promise<결과|undefined>` — 커스텀 컴포넌트 토스트. `close` emit 값으로 resolve, 5초 후 자동 `undefined`.
+- `try<R>(fn, messageFn?): Promise<R|undefined>` — `fn` 실행, `Error` 발생 시 `danger` 토스트 + 시스템로그 후 `undefined` 반환(비-Error 는 rethrow). `messageFn` 으로 메시지 커스터마이즈.
+
+타입:
+- `SdToastSeverity` — `"info"|"success"|"warning"|"danger"`.
+- `SdToastTheme` — `"primary"|"secondary"|SdToastSeverity|"gray"|"blue-gray"`.
+- `SdToastContentDef<O>` — `{ close: OutputEmitterRef<O|undefined> }`. notify 콘텐츠 구현.
+- `SdToastInput<T>` — `{ type: Type<T>; inputs }`(`close` 제외 input).
+
+```typescript
+sdToast.danger("저장 실패");
+const progress = sdToast.info("업로드 중", true);
+progress.set(50);
+await sdToast.try(() => api.saveAsync());
+```
+
+## SdToast / SdToastContainer
+
+- `<sd-toast>` — 개별 토스트. `open`/`progress`/`message` 는 `model`, `useProgress`/`theme` 는 input. theme 에 따라 `role`/`aria-live`(info·success=polite/status, warning·danger=assertive/alert) 자동.
+- `<sd-toast-container>` — 토스트 컨테이너. `overlap = input(false)` — 겹침 모드.
+
+## SdBusyProvider / SdBusyContainer
+
+전역·지역 로딩 표시.
+
+- `SdBusyProvider` — `type: WritableSignal<SdBusyType>` 기본 스피너 종류, `globalBusyCount: WritableSignal<number>` 0 초과 시 전역 busy 오버레이 표시. 라우팅·인쇄가 자동 증감.
+- `SdBusyType` — `"spinner"|"bar"|"cube"`. 인디케이터 모양.
+- `<sd-busy-container>` — 지역 busy 래퍼. `busy = input(false)` 표시 여부, `message`/`type`(미지정 시 프로바이더 type 따름)/`progressPercent`(0~100 막대) input. busy 중 키입력 차단.
+
+## SdPrintProvider
+
+`class SdPrintProvider` — 컴포넌트를 인쇄하거나 PDF 버퍼로 만드는 루트 프로바이더. 진행 중 전역 busy 증가.
+
+- `printAsync<T>(template: SdPrintInput<T>, options?: { size?: string; margin?: string }): Promise<void>` — 템플릿 컴포넌트를 body 에 부착·`@page` 스타일 주입 후 `window.print()`. 이미지 로드 대기.
+- `getPdfBufferAsync<T>(template, options?: { orientation?: "portrait"|"landscape"; pageSize?: string }): Promise<Uint8Array>` — `.page` 요소(없으면 전체)를 캔버스화해 jsPDF 로 PDF 버퍼 생성.
+
+타입:
+- `SdPrint` — `{ initialized: Signal<boolean>; _optionalPrintInputs?: string }`. 인쇄 콘텐츠 구현.
+- `SdPrintInput<T, X>` — `{ type: Type<T>; inputs }`(`_optionalPrintInputs` 키는 optional).

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

@@ -0,0 +1,64 @@
+# @simplysm/angular — 라우팅 / 앱 구조(메뉴·권한)
+
+해시 기반 SPA 내비게이션, 현재 페이지 코드·뷰타입·제목 신호, 앱 구조(AppStructureItem 트리)→메뉴/권한 변환, 권한 테이블 UI. 메뉴 컴포넌트(layout 군)·CRUD 컨테이너(crud 군)가 이 신호·타입을 소비.
+
+## SdNavigateWindowProvider
+
+`class SdNavigateWindowProvider` — 해시 라우트를 새 창/탭으로 여는 루트 프로바이더.
+
+- `isWindow: boolean` — 현재가 별도 창 모드인지(해시 쿼리 `window=true`).
+- `open(navigate, params?, features?)` — 라우트 열기. 창 모드이거나 `features` 있으면 `window.open` 으로 새 창(부모 unload 시 자동 닫힘), 아니면 새 탭(`_blank`).
+
+## SdRouterLink
+
+`[sdRouterLink]` 디렉티브 — 클릭 시 라우팅. Ctrl/Shift 클릭은 새 창, 창 모드는 팝업으로 분기.
+
+- `option = input<{ link; params?; window?: { width?; height? }; outletName?; queryParams? } | undefined>()`(alias `sdRouterLink`) — 이동 정보. `link`(경로), `params`(matrix 파라미터), `queryParams`, `outletName`(보조 outlet), `window`(팝업 크기). `undefined` 면 비활성.
+
+## 페이지 코드·타이틀·뷰타입 신호
+
+컴포넌트 생성자/필드에서 호출하는 inject 함수. 라우터·활성모달 컨텍스트에서 값 도출.
+
+- `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 면 닫기/이탈 차단.
+
+## 메뉴 유틸
+
+`SdMenu` 를 라우터링크/선택판정으로 변환(layout 메뉴 컴포넌트가 사용).
+
+- `getMenuRouterLinkOption(menu: SdMenu): { link; queryParams } | undefined` — 리프 메뉴면 `/home/{codeChain}` 링크 + 쿼리파라미터, 그룹/외부url 메뉴면 `undefined`.
+- `getIsMenuSelected(menu, fullPageCode, customFn?): boolean` — 선택 여부. `customFn` 있으면 그 결과, 없으면 `fullPageCode === codeChain.join(".")`.
+
+## SdAppStructureProvider
+
+`class SdAppStructureProvider<TModule>` — 앱 구조(메뉴·권한) 트리 보관·계산 루트 프로바이더.
+
+- `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)`.
+
+`injectPermsSignal<K>(viewCodes: string[], keys: K[]): Signal<K[]>` — 특정 화면코드들의 권한 중 보유 키만 반환하는 computed.
+
+## SdAppStructureUtils
+
+`abstract class SdAppStructureUtils` — 앱 구조 변환 정적 유틸(프로바이더가 위임). `getMenus`/`getFlatMenus`/`getPermissions`/`getFlatPermissions`/`getTitleByFullCode`/`findTitleByFullCode`/`getItemChainByFullCode`/`getPermsByFullCode` 정적 메서드 제공. 모듈 활성/권한 use 여부로 필터링.
+
+## 타입
+
+- `SdMenu` — 메뉴 노드. `title`/`codeChain: string[]`/`url?`/`icon?`/`children?`.
+- `SdFlatMenu<TModule>` — 평탄 메뉴. `titleChain`/`codeChain`/`modulesChain`.
+- `SdPermission<TModule>` — 권한 노드. `title`/`codeChain`/`modules`/`perms: ("use"|"edit")[] | undefined`/`children`.
+
+## SdPermissionTable
+
+`<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)` — 전체 비활성.

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

@@ -0,0 +1,43 @@
+# @simplysm/angular — 선택·정렬·확장 매니저
+
+리스트/시트류 컴포넌트 내부에서 signal 바인딩으로 선택·다중정렬·트리확장 상태를 다루는 컴포저블 함수. 컴포넌트 클래스 필드 초기화 시 호출하며, signal 입력(items/selectedKeys/sorts 등)과 메서드 묶음을 반환. `sd-sheet` 가 셋 모두 사용.
+
+## useSelectionManager
+
+`useSelectionManager<TItem, TKey>(options): { ... }` — 단일/다중 선택 상태 관리.
+
+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>` — 키 추출.
+
+반환: `hasSelectable`/`isAllSelected: Signal<boolean>`, `getSelectable(item): true | string | undefined`, `getCanChangeFn(item): () => boolean`, `select`/`deselect`/`toggle`/`toggleAll`/`isSelected(item)`. single 모드 select 는 단일 키로 교체, multi 는 추가/제거.
+
+## useSortingManager
+
+`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 }`.

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

@@ -0,0 +1,70 @@
+# @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`.
+
+## matchesSearchText
+
+`matchesSearchText(itemText: string, searchQuery: string | undefined): boolean` — 공백 분리 AND 부분일치 검색 매처(소문자 비교). 위 선택 컨트롤이 검색에 사용.
+
+- `itemText` — 항목의 검색 대상 텍스트.
+- `searchQuery` — 검색어. 빈/`undefined` 면 모두 매치(true). 각 단어가 모두 포함돼야 매치.

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

@@ -0,0 +1,78 @@
+# @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 }`.
+
+```html
+<sd-sheet [items]="rows()" [(selectedKeys)]="sel" [selectMode]="'multi'"
+          [(sorts)]="sorts" [useAutoSort]="true" key="order-sheet">
+  <sd-sheet-column key="name" header="이름" [fixed]="true">
+    <ng-template [cell]="rows()" let-item="item">{{ item.name }}</ng-template>
+  </sd-sheet-column>
+</sd-sheet>
+```

package/claude/references/sd-simplysm14/apis/capacitor-plugin-auto-update/README.md

@@ -0,0 +1,80 @@
+# @simplysm/capacitor-plugin-auto-update
+
+Android 앱(Capacitor)에서 APK 설치 및 자동 업데이트를 수행하는 플러그인. APK 설치 인텐트 실행·설치 권한 관리·서버/외부저장소 기반 최신 버전 감지 후 다운로드·설치 흐름을 제공. 모든 공개 심볼은 `static` 멤버만 가진 abstract 클래스이거나 타입이므로 인스턴스 생성 없이 클래스명으로 직접 호출.
+
+## 사용 트리거 인덱스
+
+- **AutoUpdate** — 앱 시작 시 최신 버전을 감지해 APK 를 받아 설치하는 전체 자동 업데이트 흐름을 돌릴 때. 서버 조회 방식(`run`)과 외부 저장소 디렉토리 방식(`runByExternalStorage`).
+- **ApkInstaller** — 자동 업데이트 흐름을 직접 구성할 때 쓰는 저수준 API. 설치 권한 확인·요청, APK 설치 인텐트 실행, 현재 앱 버전 조회.
+- **ApkInstallerPlugin / VersionInfo** — Capacitor 네이티브 브리지 인터페이스 타입과 버전 정보 형태. 플러그인을 직접 등록·구현하거나 반환 타입을 참조할 때.
+
+## AutoUpdate
+
+`abstract class AutoUpdate` — 정적 메서드만 가진 고수준 오케스트레이터. 두 진입점 모두 내부에서 Android 여부 확인 → 설치 권한 확인/요청 → 버전 비교 → 다운로드/설치 → 무한 freeze 까지 일괄 처리. 도중 발생한 모든 예외를 잡아 `log` 로 표시한 뒤 `_freezeApp()`(영원히 resolve 되지 않는 무한 대기)으로 진입함. Android 가 아니면(`navigator.userAgent` 에 "android" 없음) `"Android만 지원됩니다."` throw. 버전 비교는 `semver.gt` 로 대상 버전이 현재보다 클 때만 진행.
+
+```ts
+static run(opt: { log: (messageHtml: string) => void; serviceClient: ServiceClient }): Promise<void>
+static runByExternalStorage(opt: { log: (messageHtml: string) => void; dirPath: string }): Promise<void>
+```
+
+- `run` — 서버 `AutoUpdate` 서비스에서 최신 버전을 조회해 업데이트. 서버 연동 배포일 때 사용.
+  - `log: (messageHtml: string) => void` — 진행/오류 상태를 HTML 문자열로 전달받는 콜백. "최신 버전 확인 중...", "권한 확인 중...", 다운로드 진행률 `(NN.NN%)`, 권한 활성화/재시도 버튼 HTML, 오류 메시지 등이 인자로 들어옴. 화면에 그대로 innerHTML 로 렌더하는 용도.
+  - `serviceClient: ServiceClient` — `@simplysm/service-client` 의 서비스 클라이언트. 내부에서 `getService<AutoUpdateService>("AutoUpdate").getLastVersion("android")` 로 최신 버전·다운로드 경로를 조회하고, `serviceClient.hostUrl + downloadPath` 로 `fetchUrlBytes` 다운로드. 받은 바이트는 `appCache` 저장소의 `latest.apk` 로 써서 설치. 서버 버전 정보 없으면 무동작 반환.
+- `runByExternalStorage` — 외부 저장소의 지정 디렉토리에서 APK 파일들을 스캔해 업데이트. 서버 없이 외부 저장소로 사이드로딩 배포할 때 사용.
+  - `log: (messageHtml: string) => void` — `run` 과 동일한 진행/오류 상태 콜백.
+  - `dirPath: string` — 외부 저장소(`FileSystem.getStoragePath("external")`) 기준 상대 디렉토리 경로. 이 폴더의 비-디렉토리 항목 중 확장자가 `.apk` 이고 파일명(확장자 제외)이 `[0-9.]` 로만 이뤄진 것을 버전으로 보고 `semver.maxSatisfying(..., "*")` 로 최신을 선정. 파일 없거나 유효 semver 없으면 반환. 설치 파일은 `<dirPath>/<version>.apk`.
+
+```ts
+// 앱 부트스트랩에서
+await AutoUpdate.run({ log: (h) => (statusEl.innerHTML = h), serviceClient });
+await AutoUpdate.runByExternalStorage({ log: (h) => (statusEl.innerHTML = h), dirPath: "myapp-apks" });
+```
+
+주의: 업데이트가 없으면 그냥 반환하지만, 업데이트를 진행하거나 오류가 나면 `_freezeApp()` 으로 영원히 resolve 되지 않음 — 호출 후속 코드에 의존하지 말 것. 권한 미승인 시 설정 화면으로 보낸 뒤 최대 5분(1초 간격 폴링) 동안 권한 부여를 대기. APK manifest 에 `REQUEST_INSTALL_PACKAGES` 가 없거나(`manifest:false`) 권한 확인 자체가 실패하면 "APK 파일을 다시 다운로드하여 설치해야 합니다(코드)" 안내(다운로드 링크 버튼 포함)와 함께 throw.
+
+## ApkInstaller
+
+`abstract class ApkInstaller` — 정적 메서드만 가진 저수준 설치 래퍼. Android 는 네이티브 인텐트/권한을 다루고, 브라우저(web)는 `ApkInstallerWeb` 가 대체 구현(설치 시 알림 표시 후 정상 반환, 권한은 항상 `granted:true`/`manifest:true`). `AutoUpdate` 가 내부적으로 사용하며, 자동 업데이트 UX 를 직접 구성할 때 사용.
+
+```ts
+static checkPermissions(): Promise<{ granted: boolean; manifest: boolean }>
+static requestPermissions(): Promise<void>
+static install(apkUri: string): Promise<void>
+static getVersionInfo(): Promise<VersionInfo>
+```
+
+- `checkPermissions()` — 설치 권한 상태 조회. 설치 시도 전 사전 점검에 사용.
+  - `granted: boolean` — `REQUEST_INSTALL_PACKAGES` 설치 권한이 사용자에게 승인되었는지. false 면 `requestPermissions` 로 유도해야 함.
+  - `manifest: boolean` — 해당 권한이 앱 manifest 에 선언되어 있는지. false 면 권한 요청 자체가 불가하므로 APK 재설치가 필요한 상황.
+- `requestPermissions()` — 권한 미승인 시 호출. 시스템 설정 화면으로 이동시키며 즉시 부여되진 않으므로 이후 `checkPermissions` 폴링이 필요.
+- `install(apkUri)` — APK 설치 인텐트 실행.
+  - `apkUri: string` — `content://` 형태의 FileProvider URI. 로컬 파일 경로가 아니라 `@simplysm/capacitor-plugin-file-system` 의 `FileSystem.getUri(filePath)` 로 변환한 content URI 를 넘겨야 함.
+- `getVersionInfo()` — 현재 설치된 앱의 버전 정보(`VersionInfo`) 조회. 서버/외부 버전과 비교할 현재 버전 기준값. (web 구현은 `env("__VER__") ?? "0.0.0"` / `versionCode "0"` 반환.)
+
+```ts
+const { granted, manifest } = await ApkInstaller.checkPermissions();
+if (!granted) await ApkInstaller.requestPermissions();
+const uri = await FileSystem.getUri(apkFilePath);
+await ApkInstaller.install(uri);
+```
+
+## ApkInstallerPlugin / VersionInfo
+
+Capacitor 네이티브 브리지 타입. `ApkInstaller` 의 정적 메서드는 `registerPlugin("ApkInstaller")` 로 등록된 이 인터페이스 구현체(네이티브 또는 `ApkInstallerWeb`)에 위임함. 일반적으로 직접 쓰지 않고 `ApkInstaller` 를 통해 접근하며, 타입 참조·웹 구현체 작성 시에만 사용.
+
+```ts
+interface VersionInfo { versionName: string; versionCode: string; }
+interface ApkInstallerPlugin {
+  install(options: { uri: string }): Promise<void>;
+  checkPermissions(): Promise<{ granted: boolean; manifest: boolean }>;
+  requestPermissions(): Promise<void>;
+  getVersionInfo(): Promise<VersionInfo>;
+}
+```
+
+- `VersionInfo.versionName: string` — 사람이 읽는 표시 버전(semver, 예 `"1.2.3"`). `AutoUpdate` 의 버전 비교(`semver.gt`)는 이 값을 semver 로 사용.
+- `VersionInfo.versionCode: string` — Android 빌드 버전 코드의 문자열 표현. 표시·식별용.
+- `ApkInstallerPlugin.install(options: { uri: string })` — content URI APK 설치. `uri` 는 `content://` FileProvider URI.
+- `ApkInstallerPlugin.checkPermissions()` — 설치 권한 승인 여부(`granted`)와 manifest 선언 여부(`manifest`) 조회.
+- `ApkInstallerPlugin.requestPermissions()` — 설치 권한 요청(설정 화면 이동).
+- `ApkInstallerPlugin.getVersionInfo()` — 현재 앱 버전 정보(`VersionInfo`) 조회.

package/claude/references/sd-simplysm14/apis/capacitor-plugin-file-system/README.md

@@ -0,0 +1,66 @@
+# @simplysm/capacitor-plugin-file-system
+
+Capacitor 기반 네이티브 파일 시스템 접근 플러그인. Android 는 외부/앱 저장소 직접 접근(11+ 는 `MANAGE_EXTERNAL_STORAGE`, 10- 는 `READ/WRITE_EXTERNAL_STORAGE` 권한), Browser 는 IndexedDB 기반 에뮬레이션으로 동작.
+
+## 사용 트리거 인덱스
+
+- **FileSystem** — 파일 읽기/쓰기, 디렉토리 조회/생성, 삭제, 권한 확인/요청, 저장소 경로 조회가 필요할 때 쓰는 정적(static) 진입점 클래스(주 사용처).
+- **StorageType** — `FileSystem.getStoragePath` 인자로 넘기는 저장소 위치 유형 리터럴을 고를 때.
+- **FileInfo** — `FileSystem.readdir` 가 반환하는 항목 정보(이름 + 디렉토리 여부). 디렉토리 순회 시.
+- **FileSystemPlugin** — Capacitor 네이티브 브릿지 원형 인터페이스 타입. 보통 `FileSystem` 가 래핑하므로 직접 호출 불필요. 커스텀 web 구현 작성이나 타입 참조 시에만.
+
+## FileSystem (static 클래스)
+
+모든 메서드 `static async`. 인스턴스 생성 없이 `FileSystem.xxx()` 호출. 내부적으로 `registerPlugin<FileSystemPlugin>("FileSystem")` 으로 얻은 네이티브/web 구현에 위임하고, 플러그인의 `{ ... }` 래퍼 결과를 평탄화해 반환.
+
+- `checkPermissions(): Promise<boolean>` — 파일 접근 권한 보유 여부. true 면 권한 있음. 읽기/쓰기 전 사전 확인용. 플러그인의 `{ granted }` 를 boolean 으로 풀어 반환.
+- `requestPermissions(): Promise<void>` — 권한 요청. Android 11+ 는 설정 화면으로 이동, Android 10- 는 권한 대화상자 표시. `checkPermissions()` 가 false 일 때 호출.
+- `readdir(dirPath: string): Promise<FileInfo[]>` — 디렉토리 하위 항목 목록 조회. `dirPath` = 조회할 디렉토리 경로. 각 항목은 `FileInfo`(이름·디렉토리 여부).
+- `getStoragePath(type: StorageType): Promise<string>` — 지정 유형 저장소의 절대 경로 조회. 경로를 직접 조립하지 말고 이 메서드로 베이스 경로를 얻어 join. `type` 풀이는 아래 StorageType 참조.
+- `getUri(filePath: string): Promise<string>` — 파일을 FileProvider 기반 content URI 로 변환. 다른 앱(공유·열기 인텐트)에 파일을 넘길 때. `filePath` = 대상 파일 경로.
+- `writeFile(filePath: string, data: string | Bytes): Promise<void>` — 파일 쓰기. `data` 가 `string` 이면 utf8 인코딩으로, `Bytes`(Uint8Array)면 base64 로 인코딩해(`bytes.toBase64`, cross-realm 안전) 저장. 텍스트면 string, 바이너리면 Bytes 를 넘김.
+- `readFile(filePath: string): Promise<Bytes>` / `readFile(filePath: string, encoding: "utf8"): Promise<string>` — 파일 읽기 오버로드. `encoding` 생략 시 base64 로 읽어 `Bytes`(`bytes.fromBase64`) 반환(바이너리용), `"utf8"` 지정 시 텍스트 `string` 반환. 반환 타입이 오버로드로 갈리므로 바이너리는 인자 없이, 텍스트는 `"utf8"` 명시.
+- `remove(targetPath: string): Promise<void>` — 파일 또는 디렉토리 삭제(재귀). `targetPath` = 삭제 대상 경로. 디렉토리면 하위까지 모두 제거.
+- `mkdir(targetPath: string): Promise<void>` — 디렉토리 생성(재귀). `targetPath` = 생성할 경로. 중간 상위 디렉토리가 없으면 함께 생성.
+- `exists(targetPath: string): Promise<boolean>` — 경로 존재 여부 확인. true 면 존재. 쓰기 전 충돌 확인이나 읽기 전 가드용.
+
+```ts
+import { FileSystem } from "@simplysm/capacitor-plugin-file-system";
+
+if (!(await FileSystem.checkPermissions())) await FileSystem.requestPermissions();
+
+const base = await FileSystem.getStoragePath("externalFiles");
+await FileSystem.mkdir(`${base}/notes`);
+await FileSystem.writeFile(`${base}/notes/memo.txt`, "hello"); // utf8
+const text = await FileSystem.readFile(`${base}/notes/memo.txt`, "utf8"); // string
+const raw = await FileSystem.readFile(`${base}/notes/memo.txt`); // Bytes
+for (const f of await FileSystem.readdir(`${base}/notes`)) {
+  console.log(f.name, f.isDirectory);
+}
+```
+
+## StorageType / FileInfo / FileSystemPlugin
+
+- `StorageType` — `getStoragePath(type)` 의 저장소 위치 선택 유니온. 값별 디렉토리 매핑:
+  - `"external"` — 외부 저장소 루트(`Environment.getExternalStorageDirectory`). 사용자에게 노출되는 공용 영역 전체 접근 시. MANAGE_EXTERNAL_STORAGE 권한 필요.
+  - `"externalFiles"` — 앱 전용 외부 파일 디렉토리. 앱이 소유하는 외부 영속 파일용(앱 제거 시 함께 삭제).
+  - `"externalCache"` — 앱 전용 외부 캐시 디렉토리. 시스템이 공간 부족 시 회수할 수 있는 임시 캐시용.
+  - `"externalMedia"` — 앱 전용 외부 미디어 디렉토리. 이미지·동영상 등 미디어 산출물용.
+  - `"appData"` — 앱 데이터 디렉토리(내부 저장소). 앱 비공개 데이터용.
+  - `"appFiles"` — 앱 파일 디렉토리(내부 저장소). 앱 비공개 영속 파일용.
+  - `"appCache"` — 앱 캐시 디렉토리(내부 저장소). 앱 비공개 임시 캐시용.
+- `FileInfo` — `readdir` 결과 배열의 각 항목.
+  - `name: string` — 항목(파일·디렉토리) 이름.
+  - `isDirectory: boolean` — 디렉토리 여부. true 면 디렉토리, false 면 파일. 재귀 순회 시 분기 기준.
+- `FileSystemPlugin` — `registerPlugin` 에 넘기는 네이티브 브릿지 인터페이스. 메서드는 `FileSystem` 정적 메서드의 저수준 원형으로, 옵션 객체를 받고 래핑 전 결과를 `{ ... }` 로 반환:
+  - `checkPermissions(): Promise<{ granted: boolean }>` — 권한 보유 여부를 `granted` 로 반환.
+  - `requestPermissions(): Promise<void>` — 권한 요청.
+  - `readdir(options: { path: string }): Promise<{ files: FileInfo[] }>` — `path` 디렉토리 항목 목록을 `files` 로 반환.
+  - `getStoragePath(options: { type: StorageType }): Promise<{ path: string }>` — `type` 저장소의 실제 경로를 `path` 로 반환.
+  - `getUri(options: { path: string }): Promise<{ uri: string }>` — `path` 파일의 FileProvider URI 를 `uri` 로 반환.
+  - `writeFile(options: { path: string; data: string; encoding?: "utf8" | "base64" }): Promise<void>` — `data`(문자열)를 `encoding`(`"utf8"`=텍스트, `"base64"`=바이너리 디코드, 생략 시 구현 기본)으로 `path` 에 기록.
+  - `readFile(options: { path: string; encoding?: "utf8" | "base64" }): Promise<{ data: string }>` — `path` 내용을 `encoding`(`"utf8"`=텍스트, `"base64"`=바이너리 인코딩 문자열)으로 읽어 `data` 로 반환.
+  - `remove(options: { path: string }): Promise<void>` — `path` 파일/디렉토리 재귀 삭제.
+  - `mkdir(options: { path: string }): Promise<void>` — `path` 디렉토리 재귀 생성.
+  - `exists(options: { path: string }): Promise<{ exists: boolean }>` — `path` 존재 여부를 `exists` 로 반환.
+  - 직접 호출 대신 `FileSystem` 사용 권장. 커스텀 web 구현 작성 시 이 인터페이스를 구현.

package/claude/references/sd-simplysm14/apis/capacitor-plugin-intent/README.md

@@ -0,0 +1,71 @@
+# @simplysm/capacitor-plugin-intent
+
+Android 인텐트 송수신 Capacitor 플러그인. 브로드캐스트 구독/전송, 실행 인텐트 조회, `startActivityForResult` 외부 Activity 실행을 제공하며 바코드 스캐너·PDA 등 산업용 디바이스 연동에 사용. 웹 환경은 미지원 스텁(경고 로그 후 빈/스텁 결과)으로 동작.
+
+## 사용 트리거 인덱스
+
+- **Intent** — 모든 인텐트 작업의 정적 진입점. 브로드캐스트 구독/전송, 실행 인텐트 조회, newIntent 리스너, 외부 Activity 실행 시 사용. 아래 인라인 섹션 참조.
+- **IntentResult / StartActivityForResultOptions / StartActivityForResultResult** — `Intent` 메서드의 입출력 타입. 콜백 결과·옵션·반환값을 타입 처리할 때 참조. 아래 인라인 섹션 참조.
+- **IntentPlugin** — Capacitor 네이티브 플러그인 인터페이스 원형. 보통 직접 호출하지 않고 `Intent` 정적 메서드를 통해 사용. 웹 스텁/네이티브 구현의 계약 정의용. 아래 인라인 섹션 참조.
+
+## Intent (정적 클래스)
+
+`abstract class Intent` — 정적 메서드만 가진 진입점. 인스턴스화 불가, `Intent.xxx()` 형태로 호출. 모든 메서드는 비동기(`Promise`).
+
+- `Intent.subscribe(filters: string[], callback: (result: IntentResult) => void): Promise<() => Promise<void>>` — 브로드캐스트 수신기 등록. `filters` = 수신할 인텐트 액션 문자열 배열(예: DataWedge RESULT_ACTION). `callback` = 매칭 브로드캐스트 도착 시 호출(`result.action == null` 인 초기 등록 resolve 이벤트는 내부에서 걸러져 호출 안 됨). 반환값은 구독 해제 함수이며 호출 시 내부 `id` 로 해당 수신기만 해제. 스캐너 등 지속 수신 화면 진입 시 등록하고 이탈 시 반환 함수로 해제.
+- `Intent.unsubscribeAll(): Promise<void>` — 등록된 모든 브로드캐스트 수신기를 한 번에 해제. 개별 해제 함수를 보관하지 않았거나 전체 정리가 필요할 때 사용.
+- `Intent.send(options: { action: string; extras?: Record<string, unknown> }): Promise<void>` — 브로드캐스트 전송. `action`(필수) = 전송할 인텐트 액션 문자열, `extras`(선택) = 함께 보낼 추가 키-값 데이터. 스캐너 트리거 토글 등 디바이스에 명령을 보낼 때 사용.
+- `Intent.getLaunchIntent(): Promise<IntentResult>` — 앱을 실행시킨 인텐트를 조회. 외부 인텐트로 앱이 기동됐는지·그 extras 를 앱 시작 시점에 읽을 때 사용. 웹에서는 항상 빈 객체 `{}` 반환.
+- `Intent.addListener(eventName: "newIntent", callback: (result: IntentResult) => void): Promise<PluginListenerHandle>` — 앱 실행 중 새로 들어오는 인텐트 리스너 등록. `eventName` 은 `"newIntent"` 리터럴 고정. 반환된 핸들의 `handle.remove()` 로 개별 해제. 이미 떠 있는 앱에 인텐트가 재전달되는 경우(singleTop 등)를 처리할 때 사용.
+- `Intent.removeAllListeners(): Promise<void>` — `addListener` 로 등록한 모든 이벤트 리스너를 일괄 제거. 화면 정리 시 newIntent 리스너를 한 번에 해제할 때 사용.
+- `Intent.startActivityForResult(options: StartActivityForResultOptions): Promise<StartActivityForResultResult>` — 외부 Activity 를 실행하고 결과를 수신. 결제·서명 등 외부 앱에 작업을 위임하고 결과를 받아야 할 때 사용. 반환 `resultCode` 로 성공 판정(Android 관례상 `-1` = RESULT_OK, `0` = RESULT_CANCELED).
+
+사용 예:
+
+```ts
+const unsub = await Intent.subscribe(
+  ["com.symbol.datawedge.api.RESULT_ACTION"],
+  (result) => console.log(result.action, result.extras),
+);
+await Intent.send({
+  action: "com.symbol.datawedge.api.ACTION",
+  extras: { "com.symbol.datawedge.api.SOFT_SCAN_TRIGGER": "TOGGLE_SCANNING" },
+});
+const res = await Intent.startActivityForResult({ action: "com.example.PAY", extras: { amount: 1000 } });
+if (res.resultCode === -1) { /* RESULT_OK */ }
+await unsub(); // 개별 해제
+```
+
+주의: 웹 플랫폼에서는 `subscribe`/`send`/`startActivityForResult` 가 실제 동작 없이 경고 로그(`createLogger("capacitor:intent")` → "웹 환경에서는 지원하지 않습니다.")만 남기고, `subscribe` 는 `{ id: "web-stub" }`, `getLaunchIntent` 는 `{}`, `startActivityForResult` 는 `{ resultCode: 0 }` 을 반환한다. 실제 인텐트 처리는 Android 디바이스에서만 일어난다.
+
+## 입출력 타입
+
+`Intent` 메서드의 결과·옵션을 타입 처리할 때 참조하는 인터페이스들.
+
+- `IntentResult` — `subscribe`/`addListener` 콜백 인자 및 `getLaunchIntent` 반환 타입.
+  - `action?: string` — 인텐트(브로드캐스트) 액션 문자열. 미수신/미설정일 수 있어 선택. `subscribe` 콜백에는 이 값이 채워진 실제 이벤트만 전달됨.
+  - `extras?: Record<string, unknown>` — 인텐트에 담긴 추가 키-값 데이터(스캔된 바코드 값 등).
+- `StartActivityForResultOptions` — `startActivityForResult` 입력. 모든 필드 선택이며 실행할 인텐트를 명시적/암시적으로 구성.
+  - `action?: string` — 인텐트 액션(암시적 인텐트 지정용).
+  - `uri?: string` — 인텐트 data URI.
+  - `extras?: Record<string, unknown>` — 대상 Activity 로 전달할 추가 데이터.
+  - `type?: string` — MIME 타입. data 와 함께 처리 대상 필터링에 사용.
+  - `packageName?: string` — 실행할 특정 앱 패키지명 지정(명시적 인텐트화).
+  - `className?: string` — 실행할 특정 Activity 클래스명 지정.
+  - `flags?: number` — Android Intent flags 비트값(예: 새 태스크 시작 등).
+- `StartActivityForResultResult` — `startActivityForResult` 반환.
+  - `resultCode: number` — Activity 결과 코드. Android 규약상 `-1` = RESULT_OK, `0` = RESULT_CANCELED. 웹 스텁은 `0` 반환.
+  - `data?: { action?: string; uri?: string; extras?: Record<string, unknown> }` — 결과 인텐트 데이터. `action` = 결과 인텐트 액션, `uri` = 결과 data URI, `extras` = 결과 추가 데이터. 취소 등으로 데이터가 없으면 부재.
+
+## IntentPlugin
+
+`interface IntentPlugin` — `registerPlugin<IntentPlugin>("Intent")` 에 쓰이는 Capacitor 네이티브 플러그인 계약. 웹 구현(`IntentWeb`)과 Android 네이티브가 이를 구현. 일반 사용 코드는 `Intent` 정적 메서드를 쓰고 이 인터페이스를 직접 호출하지 않음(저수준 계약 참조용).
+
+- `subscribe(options: { filters: string[] }, callback: (result: IntentResult) => void): Promise<{ id: string }>` — 수신기 등록 후 해제용 `id` 반환. `Intent.subscribe` 가 이 `id` 를 보관해 반환 함수에서 `unsubscribe` 에 넘김.
+- `unsubscribe(options: { id: string }): Promise<void>` — 주어진 `id` 의 수신기만 해제.
+- `unsubscribeAll(): Promise<void>` — 모든 수신기 해제.
+- `send(options: { action: string; extras?: Record<string, unknown> }): Promise<void>` — 브로드캐스트 전송.
+- `getLaunchIntent(): Promise<IntentResult>` — 실행 인텐트 조회.
+- `addListener(eventName: "newIntent", listenerFunc: (data: IntentResult) => void): Promise<PluginListenerHandle>` — newIntent 이벤트 리스너 등록, 해제용 핸들 반환.
+- `removeAllListeners(): Promise<void>` — 모든 리스너 제거.
+- `startActivityForResult(options: StartActivityForResultOptions): Promise<StartActivityForResultResult>` — 외부 Activity 실행 및 결과 수신.