@simplysm/sd-claude 14.0.47 → 14.0.48

package/claude/references/sd-simplysm14/angular/docs/provider-types.md

@@ -1,283 +0,0 @@
-# Provider Types
-
-## `SdMenu`
-
-메뉴 트리 노드.
-
-```typescript
-interface SdMenu {
-  title: string;
-  codeChain: string[];
-  url?: string;
-  icon?: string;
-  children?: SdMenu[];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `title` | `string` | 메뉴 제목 |
-| `codeChain` | `string[]` | 코드 체인 (루트부터 현재까지) |
-| `url` | `string \| undefined` | 외부 URL |
-| `icon` | `string \| undefined` | 아이콘 |
-| `children` | `SdMenu[] \| undefined` | 하위 메뉴 |
-
-## `SdFlatMenu`
-
-플랫 메뉴 항목 (리프만).
-
-```typescript
-interface SdFlatMenu<TModule = unknown> {
-  titleChain: string[];
-  codeChain: string[];
-  modulesChain: TModule[][];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `titleChain` | `string[]` | 타이틀 체인 |
-| `codeChain` | `string[]` | 코드 체인 |
-| `modulesChain` | `TModule[][]` | 모듈 체인 |
-
-## `SdPermission`
-
-권한 트리 노드.
-
-```typescript
-interface SdPermission<TModule = unknown> {
-  title: string;
-  codeChain: string[];
-  modules: TModule[] | undefined;
-  perms: ("use" | "edit")[] | undefined;
-  children: SdPermission<TModule>[] | undefined;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `title` | `string` | 권한 제목 |
-| `codeChain` | `string[]` | 코드 체인 |
-| `modules` | `TModule[] \| undefined` | 모듈 제한 |
-| `perms` | `("use" \| "edit")[] \| undefined` | 권한 목록 |
-| `children` | `SdPermission<TModule>[] \| undefined` | 하위 권한 |
-
-## `SharedDataBase`
-
-공유 데이터 기본 인터페이스. 모든 공유 데이터 항목이 구현해야 한다.
-
-```typescript
-interface SharedDataBase<TKey extends string | number> {
-  __valueKey: TKey;
-  __searchText: string;
-  __isHidden: boolean;
-  __parentKey?: TKey;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `__valueKey` | `TKey` | 고유 키 |
-| `__searchText` | `string` | 검색 대상 텍스트 |
-| `__isHidden` | `boolean` | 숨김 여부 |
-| `__parentKey` | `TKey \| undefined` | 부모 키 (트리 구조용) |
-
-## `SharedDataInfo`
-
-공유 데이터 등록 정보.
-
-```typescript
-interface SharedDataInfo<T extends SharedDataBase<string | number>> {
-  serviceKey: string;
-  getter: (changeKeys?: (string | number)[]) => Promise<T[]>;
-  filter?: unknown;
-  orderBy?: (a: T, b: T) => number;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `serviceKey` | `string` | ServiceClient 연결 키 |
-| `getter` | `(changeKeys?) => Promise<T[]>` | 데이터 조회 함수. changeKeys 전달 시 부분 조회 |
-| `filter` | `unknown` | 이벤트 필터 (같은 이름의 다른 필터 구분용) |
-| `orderBy` | `((a, b) => number) \| undefined` | 정렬 함수 |
-
-## `SharedDataHandle`
-
-공유 데이터 핸들. `getHandle()`이 반환하는 객체.
-
-```typescript
-interface SharedDataHandle<T extends SharedDataBase<string | number>> {
-  items: Signal<T[]>;
-  get(key: T["__valueKey"] | undefined): T | undefined;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `items` | `Signal<T[]>` | 데이터 항목 signal |
-| `get(key)` | `(key) => T \| undefined` | 키로 항목 조회 |
-
-## `SdModalContentDef`
-
-모달 컴포넌트가 구현해야 하는 인터페이스.
-
-```typescript
-interface SdModalContentDef<O> {
-  initialized: Signal<boolean>;
-  close: OutputEmitterRef<O | undefined>;
-  actionTplRef?: TemplateRef<any>;
-  readonly _optionalModalInputs?: string;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `initialized` | `Signal<boolean>` | 초기화 완료 여부 |
-| `close` | `OutputEmitterRef<O \| undefined>` | 닫기 output (결과 전달) |
-| `actionTplRef` | `TemplateRef<any> \| undefined` | 모달 헤더 액션 영역 템플릿 |
-| `_optionalModalInputs` | `string \| undefined` | optional로 취급할 input 키 목록 (리터럴 타입) |
-
-## `SdModalInfo`
-
-모달 생성 시 전달하는 정보.
-
-```typescript
-interface SdModalInfo<T extends SdModalContentDef<any>, X extends keyof any = ""> {
-  title: string;
-  type: Type<T>;
-  inputs: WithOptional<Omit<DirectiveInputSignals<T>, SdModalExcludeKeys | X>, ...>;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `title` | `string` | 모달 제목 |
-| `type` | `Type<T>` | 모달 컴포넌트 타입 |
-| `inputs` | `object` | 컴포넌트 inputs (initialized, close, actionTplRef 제외) |
-
-## `SdModalOptions`
-
-모달 옵션.
-
-```typescript
-interface SdModalOptions {
-  key?: string;
-  hideHeader?: boolean;
-  hideCloseButton?: boolean;
-  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;
-  headerStyle?: string;
-  noFirstControlFocusing?: boolean;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `key` | `string \| undefined` | 동일 키의 모달이 이미 열려 있으면 재사용 |
-| `hideHeader` | `boolean \| undefined` | 헤더 숨김 |
-| `hideCloseButton` | `boolean \| undefined` | 닫기 버튼 숨김 |
-| `useCloseByBackdrop` | `boolean \| undefined` | 배경 클릭으로 닫기 |
-| `useCloseByEscapeKey` | `boolean \| undefined` | ESC 키로 닫기 |
-| `float` | `boolean \| undefined` | 플로팅 모달 |
-| `fill` | `boolean \| undefined` | 전체 화면 채우기 |
-| `resizable` | `boolean \| undefined` | 크기 조절 가능 |
-| `movable` | `boolean \| undefined` | 이동 가능 |
-| `position` | `"bottom-right" \| "top-right" \| undefined` | 위치 프리셋 |
-| `minHeightPx` | `number \| undefined` | 최소 높이 (px) |
-| `minWidthPx` | `number \| undefined` | 최소 너비 (px) |
-| `heightPx` | `number \| undefined` | 높이 (px) |
-| `widthPx` | `number \| undefined` | 너비 (px) |
-| `headerStyle` | `string \| undefined` | 헤더 인라인 스타일 |
-| `noFirstControlFocusing` | `boolean \| undefined` | 첫 번째 컨트롤 자동 포커스 비활성화 |
-
-## `SdToastContentDef`
-
-커스텀 토스트 컴포넌트가 구현해야 하는 인터페이스.
-
-```typescript
-interface SdToastContentDef<O> {
-  close: OutputEmitterRef<O | undefined>;
-}
-```
-
-## `SdToastInput`
-
-커스텀 토스트 생성 입력.
-
-```typescript
-interface SdToastInput<T extends SdToastContentDef<any>> {
-  type: Type<T>;
-  inputs: Omit<DirectiveInputSignals<T>, "close">;
-}
-```
-
-## `SdToastSeverity`
-
-```typescript
-type SdToastSeverity = "info" | "success" | "warning" | "danger";
-```
-
-## `SdToastTheme`
-
-```typescript
-type SdToastTheme = "primary" | "secondary" | SdToastSeverity | "gray" | "blue-gray";
-```
-
-## `SdBusyType`
-
-```typescript
-type SdBusyType = "spinner" | "bar" | "cube";
-```
-
-## `SdPrint`
-
-인쇄 컴포넌트가 구현해야 하는 인터페이스.
-
-```typescript
-interface SdPrint {
-  initialized: Signal<boolean>;
-  readonly _optionalPrintInputs?: string;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `initialized` | `Signal<boolean>` | 초기화 완료 여부 (true 될 때까지 대기 후 인쇄) |
-| `_optionalPrintInputs` | `string \| undefined` | optional로 취급할 input 키 목록 |
-
-## `SdPrintInput`
-
-인쇄 생성 입력.
-
-```typescript
-interface SdPrintInput<T, X extends keyof any = ""> {
-  type: Type<T>;
-  inputs: WithOptional<Omit<DirectiveInputSignals<T>, "_optionalPrintInputs" | X>, ...>;
-}
-```
-
-## `SelectModalOutputResult`
-
-모달 선택 결과.
-
-```typescript
-interface SelectModalOutputResult<T> {
-  selectedItemKeys: any[];
-  selectedItems: T[];
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `selectedItemKeys` | `any[]` | 선택된 항목 키 배열 |
-| `selectedItems` | `T[]` | 선택된 항목 배열 |

package/claude/references/sd-simplysm14/angular/docs/providers.md

@@ -1,379 +0,0 @@
-# Providers
-
-## `SdThemeProvider`
-
-다크모드/폰트 크기 프로바이더. `dark` signal 변경 시 body에 `sd-theme-dark` 클래스를 토글하고, `fontSize` signal 변경 시 `html` 요소의 font-size를 설정한다.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdThemeProvider {
-  dark = signal<boolean>(false);
-  readonly fontSizePresets: readonly number[] = [12, 14, 16, 20, 24, 28];
-  fontSize = signal<number>(12);
-
-  increaseFontSize(): void;
-  decreaseFontSize(): void;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `dark` | `WritableSignal<boolean>` | 다크모드 활성화 여부 |
-| `fontSizePresets` | `readonly number[]` | 사용 가능한 폰트 크기 프리셋 배열 |
-| `fontSize` | `WritableSignal<number>` | 현재 폰트 크기 (px). 기본값 12 |
-
-| Method | Description |
-|--------|-------------|
-| `increaseFontSize()` | `fontSizePresets`에서 현재보다 큰 다음 크기로 변경 |
-| `decreaseFontSize()` | `fontSizePresets`에서 현재보다 작은 이전 크기로 변경 |
-
-## `SdThemeSelector`
-
-테마 설정 드롭다운 컴포넌트. 다크모드 토글과 폰트 크기 증감 버튼을 제공한다. `SdThemeProvider`를 inject하여 사용한다.
-
-```typescript
-@Component({
-  selector: "sd-theme-selector",
-  standalone: true,
-})
-class SdThemeSelector {}
-```
-
-inputs 없음. `SdThemeProvider`의 `dark`, `fontSize`를 직접 조작한다.
-
-## `SdSystemLogProvider`
-
-시스템 로그 기록 프로바이더. console 출력 + 커스텀 `writeFn` 콜백 호출.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdSystemLogProvider {
-  writeFn?: (severity: "error" | "warn" | "log", ...data: any[]) => Promise<void> | void;
-  async writeAsync(severity: "error" | "warn" | "log", ...data: any[]): Promise<void>;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `writeFn` | `((severity, ...data) => Promise<void> \| void) \| undefined` | 커스텀 로그 기록 함수 |
-
-| Method | Description |
-|--------|-------------|
-| `writeAsync(severity, ...data)` | console 출력 후 `writeFn` 호출 |
-
-## `SdAppStructureProvider`
-
-앱 구조(메뉴/권한) 관리 프로바이더. 서브클래스 없이 직접 사용한다.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdAppStructureProvider<TModule = unknown> {
-  readonly usableModules = signal<TModule[] | undefined>(undefined);
-  readonly permRecord = signal<Record<string, boolean> | undefined>(undefined);
-  readonly items = signal<AppStructureItem<TModule>[]>([]);
-
-  usableMenus: Signal<SdMenu[]>;
-  usableFlatMenus: Signal<SdFlatMenu<TModule>[]>;
-
-  async initialize(serviceKey: string): Promise<void>;
-  getPermissionsByStructure(items, codeChain?): SdPermission<TModule>[];
-  getTitleByFullCode(fullCode: string): string;
-  getItemChainByFullCode(fullCode: string): AppStructureItem<TModule>[];
-  getPermsByFullCode<K extends string>(fullCodes: string[], permKeys: K[]): K[];
-}
-```
-
-| WritableSignal Field | Type | Description |
-|----------------------|------|-------------|
-| `usableModules` | `WritableSignal<TModule[] \| undefined>` | 사용 가능한 모듈 목록. 외부에서 `set()`/`update()`로 설정 |
-| `permRecord` | `WritableSignal<Record<string, boolean> \| undefined>` | 권한 레코드. 외부에서 `set()`/`update()`로 설정 |
-| `items` | `WritableSignal<AppStructureItem<TModule>[]>` | 앱 구조 항목 배열 (`initialize()`로 초기화) |
-
-| Computed | Type | Description |
-|----------|------|-------------|
-| `usableMenus` | `Signal<SdMenu[]>` | 사용 가능한 메뉴 트리 |
-| `usableFlatMenus` | `Signal<SdFlatMenu<TModule>[]>` | 사용 가능한 플랫 메뉴 |
-
-## `injectPermsSignal`
-
-현재 뷰의 권한 목록을 signal로 반환하는 함수. 생성자에서 호출한다.
-
-```typescript
-function injectPermsSignal<K extends string>(viewCodes: string[], keys: K[]): Signal<K[]>
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `viewCodes` | `string[]` | 뷰 코드 배열 |
-| `keys` | `K[]` | 확인할 권한 키 배열 |
-
-반환: 활성화된 권한 키 배열의 signal
-
-## `SdAppStructureUtils`
-
-앱 구조 유틸리티. 정적 메서드로 메뉴/권한 조회 로직을 제공한다.
-
-```typescript
-abstract class SdAppStructureUtils {
-  static getTitleByFullCode<TModule>(items, fullCode): string;
-  static getPermsByFullCode<TModule, K extends string>(items, fullCodes, permKeys, permRecord): K[];
-  static getItemChainByFullCode<TModule>(items, fullCode): AppStructureItem<TModule>[];
-  static getMenus<TModule>(items, codeChain, usableModules, permRecord): SdMenu[];
-  static getFlatMenus<TModule>(items, usableModules, permRecord): SdFlatMenu<TModule>[];
-  static getPermissions<TModule>(items, codeChain, usableModules): SdPermission<TModule>[];
-  static getFlatPermissions<TModule>(items, usableModules): FlatPermission<TModule>[];
-}
-```
-
-## `SdFileDialogProvider`
-
-네이티브 파일 선택 대화상자 프로바이더.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdFileDialogProvider {
-  async showAsync(multiple?: false, accept?: string): Promise<File | undefined>;
-  async showAsync(multiple: true, accept?: string): Promise<File[] | undefined>;
-}
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `multiple` | `boolean` | 다중 선택 여부 |
-| `accept` | `string` | 허용 파일 타입 (예: `"image/*"`) |
-
-## `SdLocalStorageProvider`
-
-`clientName` 스코프 localStorage 래퍼. 키가 `{clientName}.{key}` 형태로 저장된다.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdLocalStorageProvider<T> {
-  set<K extends keyof T & string>(key: K, value: T[K]): void;
-  get<K extends keyof T & string>(key: K): T[K] | undefined;
-  remove(key: keyof T & string): void;
-}
-```
-
-## `SdSystemConfigProvider`
-
-비동기 설정 저장/조회 프로바이더. `fn` 필드를 설정하면 서버 저장, 미설정 시 localStorage에 저장.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdSystemConfigProvider<T> {
-  fn?: {
-    set<K extends keyof T & string>(key: K, data: T[K]): Promise<void> | void;
-    get(key: keyof T & string): PromiseLike<any>;
-  };
-
-  async setAsync<K extends keyof T & string>(key: K, data: T[K]): Promise<void>;
-  async getAsync(key: keyof T & string): Promise<any>;
-}
-```
-
-## `SdServiceClientFactoryProvider`
-
-ServiceClient 인스턴스 팩토리/관리. key별로 연결을 관리한다.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdServiceClientFactoryProvider {
-  async connectAsync(key: string, options?: Partial<ServiceConnectionOptions>): Promise<void>;
-  async closeAsync(key: string): Promise<void>;
-  get(key: string): ServiceClient;
-}
-```
-
-| Method | Description |
-|--------|-------------|
-| `connectAsync(key, options?)` | WebSocket 연결. 요청/응답 진행률을 토스트로 표시 |
-| `closeAsync(key)` | 연결 종료 |
-| `get(key)` | 연결된 ServiceClient 인스턴스 반환 |
-
-## `SdSharedDataProvider`
-
-이벤트 기반 공유 데이터 캐시 추상 프로바이더. `@Injectable()`로 제공되며, 소비 프로젝트에서 상속한다.
-
-내부적으로 `client.getEvent()` 프록시를 사용하여 이벤트를 구독/발행한다:
-- `client.getEvent<typeof SdSharedDataChangeEvent>("SdSharedDataChange").addListener(info, cb)`
-- `client.getEvent<typeof SdSharedDataChangeEvent>("SdSharedDataChange").emit(selector, data)`
-
-```typescript
-@Injectable()
-abstract class SdSharedDataProvider<T extends Record<string, SharedDataBase<string | number>>> {
-  readonly loadingCount: WritableSignal<number>;
-
-  abstract initialize(): void;
-  register<K extends string & keyof T>(name: K, info: SharedDataInfo<T[K]>): void;
-  getHandle<K extends string & keyof T>(name: K): SharedDataHandle<T[K]>;
-  async emitAsync<K extends string & keyof T>(name: K, changeKeys?: (string | number)[]): Promise<void>;
-  async wait(): Promise<void>;
-}
-```
-
-| Method | Description |
-|--------|-------------|
-| `register(name, info)` | 공유 데이터 등록 (getter, serviceKey, filter, orderBy) |
-| `getHandle(name)` | 등록된 공유 데이터 핸들 반환 (items signal + get 메서드) |
-| `emitAsync(name, changeKeys?)` | 변경 이벤트 발행. 내부에서 `client.getEvent<typeof SdSharedDataChangeEvent>("SdSharedDataChange").emit(...)` 호출 |
-| `wait()` | 모든 로딩 완료까지 대기 |
-
-### 로딩 전략 (Lazy Loading)
-
-**`register()`는 메타정보만 등록하고 실제 데이터를 가져오지 않는다.** 타입별 데이터는 해당 타입의 `getHandle(name)`이 **처음 호출되는 시점**에 `info.getter()`를 실행하여 로딩된다. 즉 `initialize()`에서 여러 타입을 `register()` 해도 앱 시작 시 전체가 일괄 로딩되지 않으며, 실제로 사용되는 타입만 온디맨드로 로딩된다.
-
-- 첫 `getHandle()` 호출 → `getter()` 실행 + `SdSharedDataChange` 리스너 등록
-- 이후 같은 타입의 `getHandle()` 호출은 캐시된 `itemsSignal`을 재사용
-- 이후 갱신은 서버에서 `emitAsync()`로 발행된 `SdSharedDataChange` 이벤트 수신 시에만 발생 (`changeKeys`가 있으면 부분 업데이트, 없으면 전체 리로드)
-- `register()`를 동일 `name`으로 재호출하면 `generation`이 증가하고 `needsReload=true`로 표시되어, 다음 `getHandle()` 호출 시 재로딩된다
-
-## `SdSharedDataChangeEvent`
-
-공유 데이터 변경 이벤트 정의. `defineEvent`로 생성되며, 이벤트 이름 문자열 `"SdSharedDataChange"`를 인자로 받는다.
-
-```typescript
-const SdSharedDataChangeEvent = defineEvent<
-  { name: string; filter: unknown },
-  (string | number)[] | undefined
->("SdSharedDataChange");
-```
-
-## `SdNavigateWindowProvider`
-
-새 윈도우 네비게이션 + 자동 닫기 프로바이더.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdNavigateWindowProvider {
-  get isWindow(): boolean;
-  open(navigate: string, params?: Record<string, string>, features?: string): void;
-}
-```
-
-| Property/Method | Description |
-|-----------------|-------------|
-| `isWindow` | 현재 페이지가 팝업 윈도우인지 여부 |
-| `open(navigate, params?, features?)` | 새 윈도우 열기. `features` 지정 시 팝업, 미지정 시 새 탭 |
-
-## `SdActivatedModalProvider`
-
-모달 내부에서 inject하여 모달/컨텐츠 컴포넌트 참조를 얻는 프로바이더. `@Injectable()`로 모달별 인스턴스 생성.
-
-```typescript
-@Injectable()
-class SdActivatedModalProvider<T extends SdModalContentDef<any> = SdModalContentDef<any>> {
-  modalComponent = signal<any>(undefined);
-  contentComponent = signal<T | undefined>(undefined);
-  canDeactivateFn: () => boolean;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `modalComponent` | `WritableSignal<any>` | SdModal 인스턴스 |
-| `contentComponent` | `WritableSignal<T \| undefined>` | 컨텐츠 컴포넌트 인스턴스 |
-| `canDeactivateFn` | `() => boolean` | 모달 닫기 가능 여부 판별 함수 (기본: `() => true`) |
-
-## `SdToastProvider`
-
-토스트 알림 프로바이더. 4가지 심각도(info/success/warning/danger) 메시지, 프로그래스 모드, 커스텀 토스트를 지원한다.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdToastProvider {
-  alertThemes = signal<SdToastSeverity[]>([]);
-  overlap = signal(false);
-  beforeShowFn?: (theme: SdToastSeverity) => void;
-
-  info(message: string, useProgress?: true): WritableSignal<number>;
-  info(message: string, useProgress?: false): void;
-  success(message: string, useProgress?: true): WritableSignal<number>;
-  success(message: string, useProgress?: false): void;
-  warning(message: string, useProgress?: true): WritableSignal<number>;
-  warning(message: string, useProgress?: false): void;
-  danger(message: string, useProgress?: true): WritableSignal<number>;
-  danger(message: string, useProgress?: false): void;
-
-  notify<T extends SdToastContentDef<any>>(input: SdToastInput<T>): Promise<...>;
-  async try<R>(fn: () => Promise<R>, messageFn?: (err: Error) => string): Promise<R | undefined>;
-  try<R>(fn: () => R, messageFn?: (err: Error) => string): R | undefined;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `alertThemes` | `WritableSignal<SdToastSeverity[]>` | alert()로 표시할 테마 목록 |
-| `overlap` | `WritableSignal<boolean>` | 오버랩 모드 (새 토스트 시 기존 제거) |
-| `beforeShowFn` | `((theme) => void) \| undefined` | 토스트 표시 전 콜백 |
-
-| Method | Description |
-|--------|-------------|
-| `info/success/warning/danger(message, useProgress?)` | 토스트 표시. `useProgress=true`면 progress signal 반환 |
-| `notify(input)` | 커스텀 토스트 컴포넌트 표시 |
-| `try(fn, messageFn?)` | 에러 catch 시 danger 토스트 표시 후 undefined 반환 |
-
-## `SdBusyProvider`
-
-글로벌 busy 상태 관리 프로바이더.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdBusyProvider {
-  type = signal<SdBusyType>("bar");
-  globalBusyCount = signal(0);
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `type` | `WritableSignal<SdBusyType>` | busy 표시 유형 (`"spinner" \| "bar" \| "cube"`) |
-| `globalBusyCount` | `WritableSignal<number>` | 글로벌 busy 카운트 (0보다 크면 busy 표시) |
-
-## `SdPrintProvider`
-
-인쇄 및 PDF 생성 프로바이더. jsPDF + html-to-image 사용.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdPrintProvider {
-  async printAsync<T extends SdPrint>(
-    template: SdPrintInput<T>,
-    options?: { size?: string; margin?: string },
-  ): Promise<void>;
-
-  async getPdfBufferAsync<T extends SdPrint>(
-    template: SdPrintInput<T>,
-    options?: { orientation?: "portrait" | "landscape"; pageSize?: string },
-  ): Promise<Uint8Array>;
-}
-```
-
-| Method | Description |
-|--------|-------------|
-| `printAsync(template, options?)` | 브라우저 인쇄 대화상자 열기. `size` 기본값 `"A4 auto"`, `margin` 기본값 `"0"` |
-| `getPdfBufferAsync(template, options?)` | PDF 바이너리 생성. `.page` 클래스 요소 단위로 페이지 분할 |
-
-## `SdModalProvider`
-
-프로그래밍 방식으로 모달을 생성하는 프로바이더.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdModalProvider {
-  modalCount = signal(0);
-
-  async showAsync<T extends SdModalContentDef<any>>(
-    modal: SdModalInfo<T>,
-    options?: SdModalOptions,
-  ): Promise<Parameters<T["close"]["emit"]>[0] | undefined>;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `modalCount` | `WritableSignal<number>` | 현재 열린 모달 수 |
-
-| Method | Description |
-|--------|-------------|
-| `showAsync(modal, options?)` | 모달 생성 후 close 결과를 Promise로 반환 |