@simplysm/sd-claude 14.0.81 → 14.0.83

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

@@ -1,97 +0,0 @@
-# @simplysm/angular — toast / busy / print
-
-전역 알림·로딩·인쇄 프로바이더. 컨테이너는 첫 호출 시 body 에 자동 생성.
-
-## SdToastProvider (root)
-
-```ts
-alertThemes: WritableSignal<SdToastSeverity[]>;        // 여기에 포함된 severity 는 window.alert 로 강제
-overlap: WritableSignal<boolean>;                       // true 면 동시 표시 안 함(새 토스트가 기존 제거)
-beforeShowFn?: (theme: SdToastSeverity) => void;
-
-info/success/warning/danger(message: string, useProgress?: false): void;
-info/success/warning/danger(message: string, useProgress: true): WritableSignal<number>;
-notify<T extends SdToastContentDef<O>>(input: SdToastInput<T>): Promise<O|undefined>;
-try<R>(fn: () => Promise<R>|R, messageFn?: (err) => string): Promise<R|undefined>|R|undefined;
-
-type SdToastSeverity = "info"|"success"|"warning"|"danger";
-type SdToastTheme = "primary"|"secondary"|SdToastSeverity|"gray"|"blue-gray";
-interface SdToastContentDef<O> { close: OutputEmitterRef<O|undefined>; }
-interface SdToastInput<T> { type: Type<T>; inputs: <T 의 input prop 들, close 제외>; }
-```
-
-- `info`/`success` 는 `polite` aria-live, `warning`/`danger` 는 `assertive`/`alert` role.
-- `useProgress=true` 면 진행률 토스트. 반환 signal 에 0~100 set. 100 도달 후 1초 뒤 자동 해제. progress 모드가 아니면 3초(호버 중이면 마우스 떠난 뒤 1초) 자동 해제.
-- `alertThemes` 에 severity 포함되면 토스트 대신 `window.alert(message)`. 키오스크/PWA 백그라운드 알림 강제용.
-- `beforeShowFn` — 매 토스트 표시 직전 호출(소리·진동 등 부수효과).
-- `notify` — 커스텀 컴포넌트 컨텐츠로 토스트. 컴포넌트가 `close.emit(result)` 호출 시 Promise resolve, 5초 후 자동 dismiss(undefined resolve).
-- `try` — fn 실행 후 throw 된 Error 의 메시지로 `danger` 토스트 + `SdSystemLogProvider.writeAsync('error', ...)` 호출. 비-Error throw 는 다시 던짐.
-
-```ts
-sdToast.success("저장 완료");
-const sig = sdToast.info("업로드 중...", true); sig.set(50);
-await sdToast.try(async () => await api.save(item));
-```
-
-## SdToast / SdToastContainer
-
-내부 사용 컴포넌트. 직접 쓸 일 거의 없음. `SdToastProvider` 가 첫 호출 시 `<sd-toast-container>` 를 body 에 append.
-
-```ts
-// SdToastContainer
-overlap = input(false);   // true 면 절대배치로 1개만 표시되는 룩
-```
-
-## SdBusyProvider (root)
-
-```ts
-type: WritableSignal<SdBusyType>;            // "spinner"|"bar"|"cube", default "bar"
-globalBusyCount: WritableSignal<number>;     // >0 이면 전역 busy 표시. provideSdAngular 가 navigation 동안 증감
-type SdBusyType = "spinner"|"bar"|"cube";
-```
-
-- `globalBusyCount` 증가/감소로 전역 잠금 화면 토글.
-- `type` — 인디케이터 모양. `spinner` 는 원형 회전, `bar` 는 상단 진행 바(슬림), `cube` 는 4분할 큐브 애니메이션.
-
-## SdBusyContainer — `<sd-busy-container>`
-
-```ts
-busy = input(false); message = input<string|undefined>();
-type = input<SdBusyType|undefined>();        // 미지정이면 SdBusyProvider.type() 사용
-progressPercent = input<number|undefined>(); // 0~100, null 이면 막대 숨김
-```
-
-- 일부 영역만 busy 표시. `busy` true 동안 자식 영역에 오버레이 + 키보드 입력 차단.
-
-```html
-<sd-busy-container [busy]="loading()" [progressPercent]="pct()">...영역 내용...</sd-busy-container>
-```
-
-## SdPrintProvider (root)
-
-```ts
-printAsync<T extends SdPrint>(template: SdPrintInput<T>, options?: { size?: string; margin?: string }): Promise<void>;
-getPdfBufferAsync<T extends SdPrint>(template: SdPrintInput<T>, options?: { orientation?: "portrait"|"landscape"; pageSize?: string }): Promise<Uint8Array>;
-
-interface SdPrint { initialized: Signal<boolean>; readonly _optionalPrintInputs?: string; }
-interface SdPrintInput<T, X = ""> { type: Type<T>; inputs: <T 의 input prop 들>; }
-```
-
-- 인쇄용 컴포넌트를 동적으로 body 에 부착 → `initialized() === true` 대기 → 이미지 로드 완료 대기 → `window.print()` 또는 jsPDF + html-to-image 로 PDF 버퍼 생성.
-- `printAsync.options.size` — `@page size`. 기본 `"A4 auto"`.
-- `printAsync.options.margin` — `@page margin`. 기본 `"0"`.
-- `getPdfBufferAsync.options.pageSize` — jsPDF page 크기. 기본 `"a4"`.
-- `getPdfBufferAsync.options.orientation` — `"portrait"`/`"landscape"`. 기본 `"portrait"`(`"p"`).
-- PDF 생성 시 컴포넌트 안 `.page` 클래스 요소 각각 1페이지로 처리, 없으면 컴포넌트 전체 1페이지.
-- 인쇄 진행 동안 `SdBusyProvider.globalBusyCount` 자동 증감.
-
-```ts
-await sdPrint.printAsync({ type: InvoicePrint, inputs: { order: data } }, { size: "A4 portrait" });
-const buf = await sdPrint.getPdfBufferAsync({ type: InvoicePrint, inputs: { order } });
-```
-
-## 주의
-
-- `SdToastProvider.try` 는 `Error` 가 아닌 throw 는 그대로 re-throw. 일반 함수에서 throw 시 반드시 Error 인스턴스 던질 것.
-- `SdBusyContainer` 의 `min-height: 70px` 가 기본. 빈 컨테이너에서도 인디케이터 보이도록.
-- `SdPrint.initialized` 를 컴포넌트가 true 로 안 set 하면 `wait.until` 이 영원히 대기. 비동기 데이터 로드 후 반드시 set.

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

@@ -1,167 +0,0 @@
-# @simplysm/angular — visual
-
-시각/표시 컴포넌트 (라벨·뱃지·진행률·달력·바코드·차트·에디터·주소검색) + 보조 레이아웃 컨테이너 (collapse·tab·list·gap·pagination·dropdown).
-
-## SdLabel — `<sd-label>`
-
-```ts
-theme = input<"primary"|"secondary"|"info"|"success"|"warning"|"danger"|"gray"|"blue-gray">();
-color = input<string>();      // 직접 색상 hex
-clickable = input(false);
-```
-
-- 작은 텍스트 뱃지. `theme` 또는 `color` 중 하나. `clickable=true` 면 커서 pointer + 호버 효과.
-
-## SdNote — `<sd-note>`
-
-```ts
-theme = input<...8 themes>();
-size = input<"sm"|"lg">();
-inset = input(false);
-```
-
-- 정보 박스(노트). `<ng-content>` 가 본문. 페이지 안내문구.
-
-## SdProgress — `<sd-progress>`
-
-```ts
-inset = input(false); size = input<"sm"|"lg">();
-theme = input.required<...8 themes>();
-value = input.required<number>();   // 0~100
-```
-
-- 가로 진행 바. value/100 만큼 채움.
-
-## SdCalendar — `<sd-calendar>`
-
-```ts
-class SdCalendar<T>
-items = input.required<T[]>();
-getItemDateFn = input.required<(item: T, index: number) => DateOnly>();
-yearMonth = input(new DateOnly().setDay(1));
-weekStartDay = input(0);          // 0=일요일, 1=월요일
-minDaysInFirstWeek = input(1);
-// 자식: <ng-template itemOf>...</ng-template> 로 셀별 아이템 렌더
-```
-
-- 월별 달력 그리드. 각 날짜 셀에 해당하는 items 만 추려 itemOf 템플릿으로 렌더.
-- `weekStartDay` — 0~6.
-- `minDaysInFirstWeek` — 첫 주에 포함될 최소 일수(ISO 주차 규칙).
-
-```html
-<sd-calendar [items]="events()" [getItemDateFn]="getDate" [yearMonth]="ym()">
-  <ng-template itemOf [itemOf]="events()" let-item>{{ item.title }}</ng-template>
-</sd-calendar>
-```
-
-## SdBarcode — `<sd-barcode>`
-
-```ts
-type = input.required<BarcodeType>();
-value = input<string>();
-
-type BarcodeType = "code128"|"qrcode"|"ean13"|"ean8"|"code39"|... (bwip-js bcid 전체)
-```
-
-- bwip-js 로 SVG 바코드 렌더. value 비면 빈 출력. 인식 불가 데이터면 catch 후 빈 출력.
-
-## SdEcharts — `<sd-echarts>`
-
-```ts
-option = input.required<echarts.EChartsOption>();
-notMerge = input(false);    // setOption merge 비활성
-loading = input(false);     // showLoading/hideLoading
-```
-
-- ECharts 래퍼. `option` 변경 시 자동 setOption.
-
-## SdTiptapEditor — `<sd-tiptap-editor>`
-
-```ts
-value = model<string>();              // HTML 문자열
-disabled = input(false); readonly = input(false); required = input(false);
-placeholder = input<string>();
-validatorFn = input<(value) => string|undefined>();
-extensions = input<AnyExtension[]>();  // 추가 tiptap extensions
-```
-
-- WYSIWYG HTML 에디터. tiptap 기반. 기본 extension(헤딩/볼드/리스트 등) 내장.
-
-## SdAddressSearchModal — `<sd-address-search-modal>` (SdModalContentDef<Address>)
-
-```ts
-close = output<Address>();
-initialized = signal(false);
-interface Address { postNumber: string|undefined; address: string|undefined; buildingName: string|undefined; }
-```
-
-- 다음(daum) 우편번호 검색 위젯 모달. `SdModalProvider.showAsync({ type: SdAddressSearchModal, ... })` 로 호출.
-- 다음 postcode 스크립트 로드 실패 시 에러 메시지 표시.
-
-## SdCollapse — `<sd-collapse>`
-
-```ts
-open = input(false);
-```
-
-- 접힘/펼침 컨테이너. transition 으로 height 애니메이션. `<ng-content>` 가 본문.
-
-## SdCollapseIcon — `<sd-collapse-icon>`
-
-```ts
-icon = input(tablerChevronDown);
-open = input(false);
-openRotate = input(90);     // open 일 때 회전 각도
-```
-
-- 펼침/접힘 표시 아이콘. open 토글 시 회전 애니메이션.
-
-## SdTab — `<sd-tab>` / SdTabItem — `<sd-tab-item>`
-
-```ts
-class SdTab { value = model<any>(); }
-class SdTabItem { value = input<any>(); }
-```
-
-- 탭 컨테이너 + 탭 항목. `<sd-tab-item value="a">A</sd-tab-item>` 클릭 시 `SdTab.value` 가 `"a"` 로.
-
-## SdList — `<sd-list>` / SdListItem — `<sd-list-item>`
-
-```ts
-class SdList { inset = input(false); }
-class SdListItem {
-  layout = input<"accordion"|"flat">("accordion");
-  open = model(false);
-  selected = input(false); selectedIcon = input<string>();
-  readonly = input(false);
-  contentStyle = input<string>(); contentClass = input<string>();
-}
-```
-
-- 세로 메뉴/리스트. `layout="accordion"` 이면 자식 리스트 펼침 가능, `flat` 이면 상시 전개.
-- `selected=true` → 강조 + `selectedIcon` 표시.
-
-## SdGap — `<sd-gap>`
-
-```ts
-height = input<"xxs"|"xs"|"sm"|"default"|"lg"|"xl"|"xxl">();
-heightPx = input<number>();
-width = input<"xxs"|...|"xxl">(); widthPx = input<number>(); widthEm = input<number>();
-```
-
-- 빈 공간 채움. 토큰 키워드(디자인 변수) 또는 px/em 직접 지정.
-
-## SdPagination — `<sd-pagination>`
-
-```ts
-currentPage = model(0);
-totalPageCount = input(0);
-visiblePageCount = input(10);
-```
-
-- 페이지 번호 바. 0-based. `<sd-sheet>`/`<sd-crud-list>` 내부에서 사용되지만 단독 사용도 가능.
-
-## 주의
-
-- `SdCalendar` 의 자식 `<ng-template itemOf>` 의 `[itemOf]` 는 `items()` 와 같은 배열 바인딩(type token 용도).
-- `SdBarcode` 는 `bypassSecurityTrustHtml` 사용. value 가 사용자 입력이라도 bwip-js 가 SVG 만 생성하므로 안전(코드 주입 불가).

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

@@ -1,79 +0,0 @@
-# @simplysm/capacitor-plugin-auto-update
-
-Android Capacitor 앱의 APK 자동 업데이트 흐름(버전 비교 → 다운로드 → 권한 확인 → 설치)과 APK 설치 네이티브 플러그인 래퍼.
-
-## 사용 트리거 인덱스
-
-- **`AutoUpdate`** — 앱 부팅 직후 서버 또는 외부 저장소에서 최신 APK 버전을 확인·다운로드·설치하는 전체 흐름을 한 번에 실행할 때.
-- **`ApkInstaller`** — 자체 UI/흐름을 만들면서 APK 설치 권한·설치·현재 앱 버전 조회를 개별로 호출할 때.
-- **`ApkInstallerPlugin`, `VersionInfo`** — Capacitor 플러그인 인터페이스 타입을 참조하거나 모킹할 때.
-
-## `AutoUpdate`
-
-```ts
-abstract class AutoUpdate {
-  static run(opt: { log: (messageHtml: string) => void; serviceClient: ServiceClient }): Promise<void>;
-  static runByExternalStorage(opt: { log: (messageHtml: string) => void; dirPath: string }): Promise<void>;
-}
-```
-
-- `run` — `serviceClient.getService<AutoUpdateService>("AutoUpdate").getLastVersion("android")` 호출 → semver 비교 후 더 큰 버전이면 `serviceClient.hostUrl + downloadPath` 에서 APK 다운로드 → `appCache/latest.apk` 저장 → 설치. 서버 기반 배포용.
-- `runByExternalStorage` — `FileSystem.getStoragePath("external")` 하위 `dirPath` 폴더에서 파일명이 `^[0-9.]*$` 인 `.apk` 들을 후보로 모아 semver 최댓값을 골라 설치. 서버 없이 사이드로드 배포용.
-- `opt.log` — 진행/오류를 HTML 문자열로 받는 콜백. 다운로드 버튼·재시도 버튼 등 HTML 마크업이 포함되므로 호출측이 innerHTML 로 렌더해야 함.
-- `opt.serviceClient` — `@simplysm/service-client` 의 `ServiceClient` 연결 인스턴스. 서버에 `AutoUpdateService` 가 등록되어 있어야 함.
-- `opt.dirPath` — external 저장소 루트 기준 상대 경로.
-
-동작 주의:
-
-- UA 가 android 가 아니면 throw.
-- 현재 또는 비교 대상 버전이 invalid semver 이거나 서버에서 버전 정보를 못 받으면 silent return (로그만 남김).
-- 권한 미부여 시 `ApkInstaller.requestPermissions()` 호출 후 1초 간격 최대 300회(5분) polling.
-- manifest 에 `REQUEST_INSTALL_PACKAGES` 미선언이거나 권한 확인 자체가 실패하면 "APK 재다운로드/재설치" 안내를 throw — `run` 의 경우 다운로드 링크 버튼 HTML 을 메시지에 포함.
-- try/catch 종료 후 항상 `_freezeApp()`(무한 await) — 정상 경로·에러 경로 모두 호출부의 후속 코드는 실행되지 않음 전제로 사용.
-
-사용 예:
-
-```ts
-await AutoUpdate.run({ log: (h) => (document.body.innerHTML = h), serviceClient });
-```
-
-## `ApkInstaller`
-
-```ts
-abstract class ApkInstaller {
-  static checkPermissions(): Promise<{ granted: boolean; manifest: boolean }>;
-  static requestPermissions(): Promise<void>;
-  static install(apkUri: string): Promise<void>;
-  static getVersionInfo(): Promise<VersionInfo>;
-}
-```
-
-- `checkPermissions` — `granted` 는 사용자의 `REQUEST_INSTALL_PACKAGES` 승인 여부, `manifest` 는 AndroidManifest 에 권한이 선언돼 있는지. `manifest=false` 면 APK 자체를 재빌드/재설치 해야 함.
-- `requestPermissions` — 시스템 설정의 "알 수 없는 앱 설치" 화면으로 이동. 결과를 await 하지 않으므로 호출측에서 `checkPermissions` polling 필요.
-- `install` — `apkUri` 는 `content://` FileProvider URI. `@simplysm/capacitor-plugin-file-system` 의 `FileSystem.getUri(path)` 로 변환해 넘김. 설치 인텐트 실행 후 즉시 반환 — 실제 설치 완료를 await 하지 않음.
-- `getVersionInfo` — 현재 설치된 앱 자체의 `versionName`/`versionCode` 반환.
-- 웹(비-android) 환경에서는 `ApkInstallerWeb` 폴백이 알림만 표시하고 정상 반환(no-op).
-
-사용 예:
-
-```ts
-const { granted } = await ApkInstaller.checkPermissions();
-if (!granted) await ApkInstaller.requestPermissions();
-await ApkInstaller.install(await FileSystem.getUri(apkFilePath));
-```
-
-## `ApkInstallerPlugin`, `VersionInfo`
-
-```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` — `build.gradle` 의 versionName 문자열. `AutoUpdate` 가 semver 비교에 사용하므로 semver 형식 권장.
-- `VersionInfo.versionCode` — versionCode 를 문자열로 반환(정수 증가값).
-- `ApkInstallerPlugin` — `registerPlugin<ApkInstallerPlugin>("ApkInstaller", ...)` 의 타입 파라미터. 직접 호출하지 말고 `ApkInstaller` 정적 메서드 사용. 타입 참조/모킹 시에만 import.

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

@@ -1,83 +0,0 @@
-# @simplysm/capacitor-plugin-file-system
-
-Capacitor 기반 파일 시스템 접근 플러그인. Android(11+ MANAGE_EXTERNAL_STORAGE, 10- READ/WRITE_EXTERNAL_STORAGE) 네이티브, Web 은 IndexedDB 에뮬레이션.
-
-## 사용 트리거 인덱스
-
-- **`FileSystem`** — 모바일/웹에서 파일·디렉토리 읽기/쓰기/삭제, 저장소 경로·URI 조회, 권한 처리 필요 시.
-- **`FileInfo`, `StorageType`** — `readdir` 결과 처리, `getStoragePath` 호출 시 타입.
-- **`FileSystemPlugin`** — 저수준 Capacitor 플러그인 인터페이스 직접 호출 필요 시(정상적으론 `FileSystem` 정적 메서드 사용).
-
-## FileSystem
-
-`abstract class` — 정적 메서드만 호출.
-
-```ts
-// 권한
-await FileSystem.checkPermissions(): Promise<boolean>
-await FileSystem.requestPermissions(): Promise<void>   // Android 11+: 설정 화면 이동, 10-: 권한 대화상자
-
-// 경로/URI
-await FileSystem.getStoragePath(type: StorageType): Promise<string>
-await FileSystem.getUri(filePath: string): Promise<string>   // 네이티브: FileProvider URI / Web: Blob URL (사용 후 `URL.revokeObjectURL` 필수)
-
-// 디렉토리
-await FileSystem.readdir(dirPath: string): Promise<FileInfo[]>
-await FileSystem.mkdir(targetPath: string): Promise<void>    // 재귀
-
-// 파일
-await FileSystem.writeFile(filePath: string, data: string | Bytes): Promise<void>
-await FileSystem.readFile(filePath: string): Promise<Bytes>
-await FileSystem.readFile(filePath: string, encoding: "utf8"): Promise<string>
-
-// 공통
-await FileSystem.remove(targetPath: string): Promise<void>   // 파일/디렉토리 재귀 삭제
-await FileSystem.exists(targetPath: string): Promise<boolean>
-```
-
-`writeFile`: `string` 은 utf8, `Bytes`(=`Uint8Array`, `@simplysm/core-common`) 는 base64 로 전달. cross-realm 안전.
-`readFile`: encoding 미지정 시 `Bytes`, `"utf8"` 지정 시 `string`.
-
-사용 예:
-
-```ts
-if (!(await FileSystem.checkPermissions())) await FileSystem.requestPermissions();
-const root = await FileSystem.getStoragePath("externalFiles");
-await FileSystem.mkdir(`${root}/logs`);
-await FileSystem.writeFile(`${root}/logs/a.txt`, "hello");
-const files = await FileSystem.readdir(`${root}/logs`);
-```
-
-## FileInfo / StorageType
-
-```ts
-interface FileInfo { name: string; isDirectory: boolean; }
-
-type StorageType =
-  | "external"        // 외부 저장소 루트 (Environment.getExternalStorageDirectory)
-  | "externalFiles"   // 앱 전용 외부 파일
-  | "externalCache"   // 앱 전용 외부 캐시
-  | "externalMedia"   // 앱 전용 외부 미디어
-  | "appData"         // 앱 데이터
-  | "appFiles"        // 앱 파일
-  | "appCache";       // 앱 캐시
-```
-
-## FileSystemPlugin
-
-저수준 Capacitor 인터페이스. `FileSystem` 의 모든 정적 메서드가 위임 대상. 직접 사용 시 `writeFile`/`readFile` 의 `encoding` 은 `"utf8" | "base64"`, `data` 는 항상 `string`.
-
-```ts
-interface FileSystemPlugin {
-  checkPermissions(): Promise<{ granted: boolean }>;
-  requestPermissions(): Promise<void>;
-  readdir(options: { path: string }): Promise<{ files: FileInfo[] }>;
-  getStoragePath(options: { type: StorageType }): Promise<{ path: string }>;
-  getUri(options: { path: string }): Promise<{ uri: string }>;
-  writeFile(options: { path: string; data: string; encoding?: "utf8" | "base64" }): Promise<void>;
-  readFile(options: { path: string; encoding?: "utf8" | "base64" }): Promise<{ data: string }>;
-  remove(options: { path: string }): Promise<void>;
-  mkdir(options: { path: string }): Promise<void>;
-  exists(options: { path: string }): Promise<{ exists: boolean }>;
-}
-```

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

@@ -1,91 +0,0 @@
-# @simplysm/capacitor-plugin-intent
-
-Android 인텐트 송수신·외부 Activity 실행용 Capacitor 플러그인. 산업용 디바이스 연동(바코드 스캐너·PDA 등). 웹은 stub(경고 로그 + no-op).
-
-## 사용 트리거 인덱스
-
-- **`Intent.subscribe` / `Intent.unsubscribeAll`** — 외부 앱이 보내는 브로드캐스트 액션을 앱에서 수신할 때 (스캐너 RESULT 등).
-- **`Intent.send`** — 외부 앱(DataWedge 등)에 브로드캐스트 명령을 송신할 때.
-- **`Intent.getLaunchIntent`** — 앱을 기동시킨 인텐트의 action/extras 를 읽을 때.
-- **`Intent.addListener("newIntent", …)` / `Intent.removeAllListeners`** — 이미 실행 중인 앱에 들어오는 새 인텐트를 받을 때 (`singleTask`/`singleTop` launchMode 필요).
-- **`Intent.startActivityForResult`** — 외부 Activity 를 실행하고 결과 코드/데이터를 받을 때 (결제·인증 모듈 등).
-
-## `Intent` (abstract class, static only)
-
-`new` 금지, 정적 메서드만 호출.
-
-### `subscribe(filters, callback): Promise<() => Promise<void>>`
-
-- `filters: string[]` — 수신할 Intent action 문자열 배열.
-- `callback: (result: IntentResult) => void` — 매 수신마다 호출. 등록 직후의 빈 resolve(`action == null`)는 내부 필터로 콜백 호출 X.
-- 반환: 해당 구독만 해제하는 함수.
-
-```ts
-const unsub = await Intent.subscribe(
-  ["com.symbol.datawedge.api.RESULT_ACTION"],
-  (r) => console.log(r.extras),
-);
-await unsub();
-```
-
-### `unsubscribeAll(): Promise<void>`
-
-`subscribe` 로 등록된 모든 수신기 해제.
-
-### `send({ action, extras? }): Promise<void>`
-
-- `action: string` — 송신할 브로드캐스트 action.
-- `extras?: Record<string, unknown>` — 함께 보낼 키/값.
-
-```ts
-await Intent.send({
-  action: "com.symbol.datawedge.api.ACTION",
-  extras: { "com.symbol.datawedge.api.SOFT_SCAN_TRIGGER": "TOGGLE_SCANNING" },
-});
-```
-
-### `getLaunchIntent(): Promise<IntentResult>`
-
-앱을 기동시킨 인텐트의 action/extras 반환. 웹은 `{}`.
-
-### `addListener("newIntent", callback): Promise<PluginListenerHandle>`
-
-- `eventName: "newIntent"` — 고정 리터럴. Android `onNewIntent` 수신 시점에 호출.
-- 반환 핸들의 `handle.remove()` 로 개별 해제.
-
-### `removeAllListeners(): Promise<void>`
-
-`addListener` 등록 전체 제거.
-
-### `startActivityForResult(options): Promise<StartActivityForResultResult>`
-
-`StartActivityForResultOptions` (모두 선택, 최소 1개로 대상 결정):
-
-- `action?: string` — Intent action.
-- `uri?: string` — `setData()` URI.
-- `extras?: Record<string, unknown>` — 전달 extras.
-- `type?: string` — MIME type (`setType()`).
-- `packageName?: string` — 대상 앱 패키지 한정.
-- `className?: string` — 대상 Activity FQCN 한정.
-- `flags?: number` — Intent flags 비트마스크 (Android `Intent.FLAG_*`).
-
-반환 `StartActivityForResultResult`:
-
-- `resultCode: number` — Android 결과 코드. `-1` = `RESULT_OK`, `0` = `RESULT_CANCELED`, 그 외 앱 정의 값.
-- `data?: { action?, uri?, extras? }` — 결과 Intent 의 action/uri/extras.
-
-```ts
-const r = await Intent.startActivityForResult({ action: "com.example.PAY", extras: { amount: 1000 } });
-if (r.resultCode === -1) { /* OK */ }
-```
-
-## 타입
-
-- `IntentResult { action?: string; extras?: Record<string, unknown> }` — 수신/조회 결과 공통 형태.
-- `StartActivityForResultOptions` / `StartActivityForResultResult` — 위 메서드 시그니처 참조.
-- `IntentPlugin` — Capacitor `registerPlugin` 용 저수준 인터페이스. 커스텀 래핑이 필요할 때만 참조, 일반 사용은 `Intent` static API.
-
-## 플랫폼 동작
-
-- Android: 네이티브 구현.
-- Web(`IntentWeb`): `subscribe`/`send`/`startActivityForResult` 는 `consola.withTag("capacitor:intent").warn("웹 환경에서는 지원하지 않습니다.")` 후 stub 반환 (`subscribe` → `{ id: "web-stub" }`, `startActivityForResult` → `{ resultCode: 0 }`, `send` → void). `getLaunchIntent` 는 `{}`, `unsubscribe`/`unsubscribeAll` 은 조용히 no-op.

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

@@ -1,49 +0,0 @@
-# @simplysm/capacitor-plugin-usb-storage
-
-USB Mass Storage 접근용 Capacitor 플러그인 (Android: libaums, Browser: IndexedDB 가상 USB 에뮬레이션).
-
-## 사용 트리거 인덱스
-
-- **`UsbStorage`** — 정적 메서드로 장치 목록·권한·디렉토리·파일 읽기. USB 저장 장치에서 데이터를 가져올 때.
-- **`UsbDeviceInfo` / `UsbDeviceFilter` / `UsbFileInfo`** — 인자·반환 타입. 호출부 타입 선언에.
-- **`UsbStoragePlugin`** — 원시 Capacitor 플러그인 인터페이스. `UsbStorage` 래퍼로 충분하면 직접 사용 X.
-
-## UsbStorage
-
-모든 메서드 `static async`. 장치 식별은 `{ vendorId, productId }` (`UsbDeviceFilter`) 로 한다.
-
-```ts
-import { UsbStorage } from "@simplysm/capacitor-plugin-usb-storage";
-
-const devices = await UsbStorage.getDevices();                 // UsbDeviceInfo[]
-const filter = { vendorId: devices[0].vendorId, productId: devices[0].productId };
-
-if (!(await UsbStorage.checkPermissions(filter))) {
-  if (!(await UsbStorage.requestPermissions(filter))) return;  // boolean
-}
-
-const files = await UsbStorage.readdir(filter, "/");           // UsbFileInfo[]
-const data = await UsbStorage.readFile(filter, "/a.txt");      // Bytes | undefined
-```
-
-- `getDevices()` — 연결된 USB 장치 전체 반환.
-- `requestPermissions(filter)` — 해당 장치 접근 권한 요청. `true` = 사용자가 승인, `false` = 거부. 사용자 인터랙션 유발.
-- `checkPermissions(filter)` — 현재 권한 보유 여부 조회. 인터랙션 없음. `true` 면 곧바로 read 호출 가능.
-- `readdir(filter, dirPath)` — 디렉토리 항목 목록 (`UsbFileInfo[]`).
-- `readFile(filter, filePath)` — 파일 바이트. 없으면 `undefined`. 내부에서 base64 → `Bytes`(@simplysm/core-common) 변환.
-
-## 타입
-
-`UsbDeviceInfo` — `getDevices()` 반환 원소.
-- `deviceName` — OS 가 부여한 장치 노드 이름 (예: `/dev/bus/usb/001/002`).
-- `manufacturerName` — 제조사 문자열.
-- `productName` — 제품명 문자열.
-- `vendorId` / `productId` — USB VID/PID 정수. 다른 메서드의 `filter` 로 그대로 사용.
-
-`UsbDeviceFilter` — 장치 식별 인자. `vendorId`, `productId` 두 정수만.
-
-`UsbFileInfo` — `readdir` 반환 원소.
-- `name` — 항목 이름 (디렉토리 내 상대명, 경로 X).
-- `isDirectory` — `true` = 하위 디렉토리(다시 `readdir` 호출 대상), `false` = 파일(`readFile` 호출 대상).
-
-`UsbStoragePlugin` — Capacitor `registerPlugin` 원시 인터페이스. 메서드 반환이 `{ devices }`/`{ granted }`/`{ files }`/`{ data: string | null }` 형태의 base64 raw 응답. `UsbStorage` 가 이를 풀어 `Bytes`·`boolean` 등으로 변환해 노출.