@simplysm/sd-claude 14.0.97 → 14.0.99

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

@@ -1,54 +1,46 @@
 # @simplysm/angular — 칸반(kanban)
 
-드래그앤드롭으로 카드를 레인 간 이동하고 카드를 다중 선택하는 칸반 보드 군. `sd-kanban-board`(보드) > `sd-kanban-lane`(레인) > `sd-kanban`(카드) 의 3계층으로 구성. `L`=레인 값 타입, `T`=카드 값 타입.
+드래그앤드롭으로 카드를 레인 간 이동하고 카드를 다중 선택하는 칸반 보드 군. `sd-kanban-board`(보드) > `sd-kanban-lane`(레인) > `sd-kanban`(카드) 3계층. `L`=레인 값 타입, `T`=카드 값 타입.
 
-## SdKanbanBoard — `<sd-kanban-board>`
+## `SdKanbanBoard<L, T>` — `<sd-kanban-board>`
 
-```ts
-selectedValues = model<T[]>([]);
-drop = output<SdKanbanBoardDropInfo<L, T>>();
-// SdKanbanBoardDropInfo<L,T> { sourceKanbanValue?: T; targetLaneValue?: L; targetKanbanValue?: T }
-```
+- `selectedValues: model<T[]>([])` — 선택된 카드 값.
+- `drop: output<SdKanbanBoardDropInfo<L, T>>` — 드래그를 레인/카드에 드롭 시 emit.
+- `dragKanban: signal<SdKanbanDragRef<L, T> | undefined>` — 현재 드래그 중인 카드.
 
-- 칸반 전체 보드(레인을 가로 배치). `selectedValues`=선택된 카드 값들(다중선택, model). `drop`=카드를 다른 위치에 떨군 결과(소스 카드값 + 대상 레인값 + 대상 카드값). 호스트가 `drop` 을 받아 데이터 재배치.
+타입:
+- `SdKanbanBoardDropInfo<L, T>` — `{ sourceKanbanValue?: T; targetLaneValue?: L; targetKanbanValue?: T }`. drop 페이로드(이동 처리 시 데이터 갱신에 사용).
+- `SdKanbanDragRef<_L, T>` — `{ value(): T | undefined; heightOnDrag(): number }`.
+- `SdKanbanDropTarget<L, T>` — `{ targetLaneValue(): L | undefined; targetKanbanValue?(): T | undefined }`.
 
-```html
-<sd-kanban-board [(selectedValues)]="selected" (drop)="onDrop($event)">
-  <sd-kanban-lane [value]="'todo'"> ... </sd-kanban-lane>
-</sd-kanban-board>
-```
-
-## SdKanbanLane — `<sd-kanban-lane>`
+## `SdKanbanLane<L, T>` — `<sd-kanban-lane>`
 
-```ts
-busy = input(false); useCollapse = input(false); collapse = model(false);
-value = input<L>();
-// 슬롯: #titleTpl(제목) #toolTpl(도구) , 콘텐츠로 <sd-kanban>
-```
+`SdKanbanDropTarget` 구현.
 
-- 한 레인(열). `value`=레인 식별값(drop 대상 판정·targetLaneValue). `busy`=레인 busy 오버레이, `useCollapse`=접기 토글 버튼(접으면 카드 숨김, `collapse` model).
-- 선택 가능한 카드가 있으면 레인 전체선택 체크박스 자동 노출. `#titleTpl`/`#toolTpl` 로 헤더/도구 영역.
+- `value: L` — 레인 값.
+- `busy: boolean` — true 면 `sd-busy-container` 바 오버레이.
+- `useCollapse: boolean` — true 면 접기 토글(eye/eye-off) 표시.
+- `collapse: model(false)` — 접힘 상태. true 면 레인 콘텐츠 숨김.
+- 콘텐츠: `#toolTpl`(도구) / `#titleTpl`(제목). 자식 `sd-kanban` 들.
+- `isAllSelected: computed` — 레인 내 선택 가능 카드 전부 선택 시 true(없으면 false). 선택 가능 카드 `>0` 이면 전체선택 체크박스 표시.
 
-## SdKanban — `<sd-kanban>`
+## `SdKanban<L, T>` — `<sd-kanban>`
 
-```ts
-value = input<T>(); selectable = input(false); draggable = input(false);
-contentClass = input<string>();
-```
+`SdKanbanDragRef`·`SdKanbanDropTarget` 구현. 카드 1개.
 
-- 한 카드. `value`=카드 식별값. `draggable`=드래그 이동 허용, `selectable`=Shift+클릭 다중선택 허용(`board.selectedValues` 에 토글). 콘텐츠가 카드 본문. 드래그 중 드롭 위치 표시를 내장.
+- `value: T` — 카드 값.
+- `selectable: boolean` — true 면 Shift+Click 으로 보드 `selectedValues` 에 토글.
+- `draggable: boolean` — true 면 드래그 가능(드래그 시작 시 보드 `dragKanban` 등록).
+- `contentClass: string` — 내부 `.card` 클래스.
+- `selected: computed` — `value` 가 보드 `selectedValues` 에 있으면 true.
 
 ```html
-<sd-kanban [value]="item" [draggable]="true" [selectable]="true">
-  <div>{{ item.title }}</div>
-</sd-kanban>
-```
-
-## 드래그/드롭 타입
-
-```ts
-SdKanbanDragRef<_L, T> { value(): T | undefined; heightOnDrag(): number }
-SdKanbanDropTarget<L, T> { targetLaneValue(): L | undefined; targetKanbanValue?(): T | undefined }
+<sd-kanban-board [(selectedValues)]="selected" (drop)="onDrop($event)">
+  <sd-kanban-lane [value]="'todo'">
+    <ng-template #titleTpl>할 일</ng-template>
+    @for (item of todoItems(); track item.id) {
+      <sd-kanban [value]="item" [selectable]="true" [draggable]="true">{{ item.title }}</sd-kanban>
+    }
+  </sd-kanban-lane>
+</sd-kanban-board>
 ```
-
-- `SdKanbanDragRef` — 드래그 중인 카드 참조(보드가 추적). `SdKanbanDropTarget` — 드롭 대상(레인 또는 카드가 구현). 둘 다 컴포넌트가 내부 구현하는 계약으로, 직접 다룰 일은 드묾.

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

@@ -1,77 +1,63 @@
 # @simplysm/angular — 레이아웃(사이드바·탑바)
 
-앱 셸의 좌측 사이드바·상단바와 그 안의 메뉴/사용자 메뉴 컴포넌트 군. 앱 루트 레이아웃(`app.root` 등)에서 한 번 구성. 메뉴 항목 타입(`SdMenu`)·라우터 링크는 [routing-appstructure.md](./routing-appstructure.md) 의 것을 사용.
+앱 셸의 좌측 사이드바·상단바와 그 안의 메뉴/사용자 메뉴 컴포넌트 군. 앱 루트 레이아웃에서 한 번 구성. 메뉴 항목 타입(`SdMenu`)·라우터 링크는 [routing-appstructure.md](./routing-appstructure.md) 의 것을 사용.
 
 ## 사이드바
 
-### SdSidebarContainer — `<sd-sidebar-container>`
+### `SdSidebarContainer` — `<sd-sidebar-container>`
 
-```ts
-toggle: WritableSignal<boolean>;
-```
-
-- 사이드바 + 본문을 감싸는 컨테이너. `toggle` 로 사이드바 접힘 제어(데스크탑은 본문 패딩 토글, 모바일은 backdrop). 네비게이션 시작 시 자동 닫힘. 자식 컴포넌트가 `inject` 해 접근.
+사이드바 + 본문을 감싸는 컨테이너.
 
-### SdSidebar — `<sd-sidebar>`
+- input 없음.
+- `toggle: WritableSignal<boolean>` (초기 false) — true 면 사이드바 접힘(컨테이너 좌패딩 0); 모바일에선 backdrop 표시. 라우터 있으면 `NavigationStart` 마다 `false` 로 리셋(라우트 전환 시 자동 닫힘).
+- `onBackdropClick(): void` — `toggle` 반전.
 
-```ts
-toggle = computed(...); // 부모 컨테이너의 toggle 미러
-```
+### `SdSidebar` — `<sd-sidebar>`
 
-- 좌측 고정 사이드바 영역. `SdSidebarContainer` 안에 두면 toggle 상태에 따라 슬라이드. 콘텐츠로 로고·메뉴·사용자를 투영.
+- input 없음. `toggle: Signal<boolean>` — 부모 컨테이너 `toggle` 미러(슬라이드 transform 구동).
 
-### SdSidebarMenu — `<sd-sidebar-menu>`
+### `SdSidebarMenu` — `<sd-sidebar-menu>`
 
-```ts
-menus = input<SdMenu[]>([]);
-layout = input<"accordion" | "accordion-expanded" | "flat">();
-getMenuIsSelectedFn = input<(menu: SdMenu) => boolean>();
-```
+- `menus: SdMenu[]` (기본 `[]`) — 메뉴 트리.
+- `layout: "accordion"|"accordion-expanded"|"flat"|undefined` — `"flat"` = 최상위 평면; `"accordion"` = 접힌 아코디언; `"accordion-expanded"` = 전체 펼친 아코디언; `undefined` = 자동(`menus.length <= 3` 이면 flat, 아니면 accordion).
+- `getMenuIsSelectedFn: (menu: SdMenu) => boolean` — 커스텀 선택 판정(미지정 시 fullPageCode 비교).
 
-- 메뉴 트리를 사이드바 리스트로 렌더(`SdRouterLink` 연결). `layout` 미지정 시 루트 메뉴 3개 이하면 `flat`, 초과면 `accordion` 자동. `accordion-expanded`=accordion 과 동일한 클릭 토글 구조이되 모든 깊이 항목이 펼친 채로 시작(이후 클릭하면 접힘), 명시 지정 시에만 적용(자동 선택 대상 아님). `getMenuIsSelectedFn`=선택 강조 커스텀(기본은 현재 페이지 코드 매칭). `menus` 는 보통 `SdAppStructureProvider.usableMenus()`.
-
-### SdSidebarUser — `<sd-sidebar-user>`
-
-```ts
-userMenu = input<SdSidebarUserMenu>();
-// SdSidebarUserMenu = { icon?: string; title: string; menus: { title: string; onClick: () => Promise<void>|void }[] }
-```
+### `SdSidebarUser` — `<sd-sidebar-user>`
 
-- 사이드바 하단 사용자 영역. 콘텐츠로 사용자 정보를 투영하고, `userMenu` 지정 시 접이식 메뉴(로그아웃 등) 표시. 각 menu 의 `onClick` 으로 동작.
+- `userMenu: SdSidebarUserMenu | undefined` — 설정 시 투영 콘텐츠 아래에 접이식 사용자 메뉴 버튼.
+- `SdSidebarUserMenu` = `{ icon?: string; title: string; menus: { title: string; onClick: () => Promise<void> | void }[] }`.
 
 ## 탑바
 
-### SdTopbarContainer — `<sd-topbar-container>`
+### `SdTopbarContainer` — `<sd-topbar-container>`
 
-```ts
-// 입력 없음. flex-column 셸.
-```
-
-- 탑바 + 본문 세로 셸. 상단 `<sd-topbar>` + `flex-fill` 본문 구조로 사용(`sd-base-container` 가 page 모드에서 내부 사용).
-
-### SdTopbar — `<sd-topbar>`
+탑바 + 본문 래퍼. input/메서드 없음.
 
-```ts
-sidebarContainer = input<SdSidebarContainer>();
-hasSidebar = computed(...);
-```
+### `SdTopbar` — `<sd-topbar>`
 
-- 상단바. 사이드바가 있으면(주입 또는 `sidebarContainer` 입력) 좌측 토글 버튼 자동 노출. 콘텐츠로 제목·액션을 투영.
+- `sidebarContainer: SdSidebarContainer | undefined` — 토글할 컨테이너(주입된 것 override). 사이드바 있으면 햄버거 토글 버튼(`tablerMenu2`) 표시.
 
-### SdTopbarMenu — `<sd-topbar-menu>`
+### `SdTopbarMenu` — `<sd-topbar-menu>`
 
-```ts
-menus = input<SdMenu[]>([]);
-getMenuIsSelectedFn = input<(menu: SdMenu) => boolean>();
-```
+- `menus: SdMenu[]` (기본 `[]`) — 각 최상위 메뉴를 드롭다운으로, 자식은 팝업 내 중첩 리스트로.
+- `getMenuIsSelectedFn: (menu: SdMenu) => boolean` — 커스텀 선택 판정.
 
-- 탑바에 드롭다운 형태로 메뉴 트리를 렌더. 루트 메뉴마다 드롭다운, 하위는 평면 리스트. 선택 강조는 사이드바 메뉴와 동일 규약.
+### `SdTopbarUser` — `<sd-topbar-user>`
 
-### SdTopbarUser — `<sd-topbar-user>`
+- `menus: input.required<SdTopbarUserMenu[]>` — 드롭다운 안 리스트 항목. 투영 콘텐츠가 트리거 라벨.
+- `SdTopbarUserMenu` = `{ title: string; onClick: () => void }`.
 
-```ts
-menus = input.required<SdTopbarUserMenu[]>();
-// SdTopbarUserMenu = { title: string; onClick: () => void }
+```html
+<sd-sidebar-container>
+  <sd-sidebar>
+    <sd-sidebar-menu [menus]="menus()" />
+    <sd-sidebar-user [userMenu]="userMenu" />
+  </sd-sidebar>
+  <sd-topbar-container>
+    <sd-topbar>
+      <sd-topbar-user [menus]="userMenus">{{ userName() }}</sd-topbar-user>
+    </sd-topbar>
+    <router-outlet />
+  </sd-topbar-container>
+</sd-sidebar-container>
 ```
-
-- 탑바 우측 사용자 드롭다운. 콘텐츠로 사용자 표시명을 투영, `menus` 항목 클릭 시 `onClick` 실행 후 드롭다운 닫힘.

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

@@ -1,163 +1,139 @@
-# @simplysm/angular — 오버레이(모달·토스트·busy·인쇄)
+# @simplysm/angular — 오버레이(모달·토스트·busy·인쇄·파일)
 
-화면에서 프로그래밍 방식으로 모달을 띄우거나, 토스트로 알림·진행률을 표시하거나, busy 인디케이터·인쇄/PDF 출력을 호출할 때 함께 읽히는 군. provider 는 모두 `providedIn: "root"`, 동적으로 body 에 attach 하므로 컴포넌트를 템플릿에 직접 둘 일은 거의 없음.
+화면에서 프로그래밍 방식으로 모달을 띄우거나, 토스트로 알림·진행률을 표시하거나, busy 인디케이터·인쇄/PDF·파일 다이얼로그를 호출할 때 함께 읽히는 군. provider 는 모두 `providedIn: "root"`, 동적으로 body 에 attach 하므로 컴포넌트를 템플릿에 직접 둘 일은 거의 없음. 화면에서의 호출 규약은 [client-component.md](../manuals/client-component.md) 의 '모달 호출' / '에러·토스트' 참조.
 
 ## 모달
 
-### SdModalProvider
+### `SdModalProvider`
 
-```ts
-@Injectable({ providedIn: "root" }) class SdModalProvider {
-  modalCount: WritableSignal<number>;
-  showAsync<T extends SdModalContentDef<any>>(modal: SdModalInfo<T>, options?: SdModalOptions):
-    Promise<Parameters<T["close"]["emit"]>[0] | undefined>;
-}
-```
-
-- `showAsync(modal, options)` — 모달 컴포넌트를 동적 생성·표시하고, 컨텐츠가 `close.emit(value)` 한 값(또는 배경/ESC/닫기 시 undefined)으로 resolve. 첫 탭 가능 요소에 자동 포커스, 닫힘 후 이전 포커스 복귀.
-- `modal.title` — 헤더 제목. `modal.type` — `SdModalContentDef` 구현 컴포넌트. `modal.inputs` — 컴포넌트 input 바인딩(`close`/`initialized`/`actionTplRef` 제외, optional 마킹된 키는 생략 가능).
+`@Injectable({ providedIn: "root" })`. 모달 콘텐츠 컴포넌트를 `SdModal` 셸로 감싸 띄움.
 
 ```ts
-const result = await inject(SdModalProvider).showAsync(
-  { title: "역할 선택", type: RoleListModal, inputs: { selectMode: "single" } },
-  { useCloseByBackdrop: false },
-);
+showAsync<T extends SdModalContentDef<any>>(
+  modal: SdModalInfo<T>, options?: SdModalOptions,
+): Promise<Parameters<T["close"]["emit"]>[0] | undefined>
 ```
 
-### SdModal — `<sd-modal>`
+- `modal.type` 의 컴포넌트를 생성·`modal.inputs` 바인딩·body 에 attach, z-index 부여, 포커스 관리. 콘텐츠가 `close.emit(payload)` 한 값으로 resolve(backdrop/ESC/닫기로 닫으면 `undefined`).
+- `modalCount: signal(0)` — 현재 열린 모달 수.
 
 ```ts
-open = model(false); key = input<string>(); title = input("");
-hideHeader; hideCloseButton; headerStyle = input<string>();
-useCloseByBackdrop = input(true); useCloseByEscapeKey = input(true);
-float; fill; resizable; movable;
-position = input<"bottom-right" | "top-right" | undefined>();
-minHeightPx; minWidthPx; heightPx; widthPx = input<number>();
-actionTplRef = input<TemplateRef<any>>(); closeRequest = output<void>();
+const result = await this._sdModal.showAsync({
+  type: OutboundInstructionHeaderDetail, title: "출고지시 등록", inputs: { /* ... */ },
+});
+if (!result) return;
 ```
 
-- 모달 셸 컴포넌트(보통 `SdModalProvider` 가 생성, 직접 템플릿 사용은 드묾). `key` 지정 시 크기·위치를 `SdSystemConfigProvider` 에 저장/복원.
-- `useCloseByBackdrop`/`useCloseByEscapeKey` — 배경 클릭/ESC 닫기 허용(기본 true). `float`=배경 없는 부유창, `fill`=전체 채움, `resizable`/`movable`=리사이즈/드래그(헤더), `position`=고정 위치.
+`SdModalInfo<T, X>` — `{ title: string; type: Type<T>; inputs: ... }`. `inputs` 는 콘텐츠 컴포넌트의 input 값(프레임워크 키 `initialized`/`close`/`actionTplRef`/`_optionalModalInputs` 와 추가 키 `X` 제외, 컴포넌트가 `_optionalModalInputs` 로 선언한 키는 optional).
 
-### 관련 타입·내장 모달
+`SdModalContentDef<O>` — 모달 콘텐츠 컴포넌트가 구현할 인터페이스:
+- `initialized: Signal<boolean>` — 준비 완료.
+- `close: OutputEmitterRef<O | undefined>` — 결과 `O | undefined` 로 자기 자신을 닫음.
+- `actionTplRef?: TemplateRef<any>` — 헤더 액션 템플릿(선택).
+- `_optionalModalInputs?: string` — optional input 키 마커(타입 전용).
 
-```ts
-SdModalContentDef<O> { initialized: Signal<boolean>; close: OutputEmitterRef<O | undefined>; actionTplRef?; _optionalModalInputs? }
-SdModalInfo<T, X> { title: string; type: Type<T>; inputs: ... }
-SdModalOptions { key?; hideHeader?; hideCloseButton?; headerStyle?; useCloseByBackdrop?; useCloseByEscapeKey?; float?; fill?; resizable?; movable?; position?; minHeightPx?; minWidthPx?; heightPx?; widthPx?; noFirstControlFocusing? }
-```
+`SdModalOptions` (전부 선택): `key`(크기·위치 영속) / `hideHeader` / `hideCloseButton` / `headerStyle` / `useCloseByBackdrop`(기본 true) / `useCloseByEscapeKey`(기본 true) / `float`(배경 없는 플로팅) / `fill`(전체 채움) / `resizable` / `movable` / `position: "bottom-right"|"top-right"` / `minHeightPx` / `minWidthPx` / `heightPx` / `widthPx` / `noFirstControlFocusing`(true 면 첫 컨트롤 대신 다이얼로그에 포커스).
 
-- `SdModalContentDef<O>` — 모달 컨텐츠 컴포넌트 계약(`initialized` 시그널 + `close` 출력). `O` 가 close 페이로드 타입. `_optionalModalInputs` 에 optional input 키를 문자열 리터럴로 선언하면 `showAsync` 호출 시 해당 input 생략 허용.
-- `SdModalOptions.noFirstControlFocusing` — true 면 첫 컨트롤 자동 포커스 안 함(다이얼로그만 포커스).
+### `SdModal` — `<sd-modal>`
 
-### SdActivatedModalProvider
+모달 셸 컴포넌트. `SdModalProvider` 가 내부적으로 사용 — 화면에서 직접 두지 않음(상속 대상도 아님). 위 `SdModalOptions` 키들에 대응하는 input(`open: model`, `title`, `float`, `fill`, `resizable`, `movable`, `position` 등)을 가지며 `closeRequest: output<void>` 발화 전 `SdActivatedModalProvider.canDeactivateFn()` 가드 확인.
 
-```ts
-@Injectable() class SdActivatedModalProvider<T> {
-  modalComponent: WritableSignal<SdModal | undefined>;
-  contentComponent: WritableSignal<T | undefined>;
-  canDeactivateFn: () => boolean; // 기본 () => true
-}
-```
+### `SdActivatedModalProvider<T>`
 
-- 모달 컨텐츠 내부에서 `inject` 해 사용. `canDeactivateFn` 을 세팅하면 닫기 전 가드(미저장 변경 보호). `contentComponent` 로 자기 컴포넌트 참조(crud-list 가 close 호출에 사용).
+`@Injectable()`(모달별 주입). 콘텐츠 컴포넌트가 inject 해 호스트 모달과 상호작용.
 
-### SdPromptModal / SdConfirmModal
+- `modalComponent: signal<SdModal | undefined>` / `contentComponent: signal<T | undefined>` — 호스트 모달·콘텐츠 인스턴스.
+- `canDeactivateFn: () => boolean` (기본 `() => true`) — close 전 가드. `false` 반환 시 닫기 차단. `setupCanDeactivate` 가 모달 컨텍스트에서 이 필드를 설정.
 
-```ts
-// SdPromptModal: SdModalContentDef<string>  — message 입력 + 텍스트 입력 후 확인/취소
-message = input.required<string>();
-// SdConfirmModal: SdModalContentDef<boolean> — message 표시 후 확인(true)/취소(undefined)
-message = input.required<string>();
-```
+### `SdPromptModal` / `SdConfirmModal`
 
-- 범용 입력/확인 모달. `showAsync({ type: SdPromptModal, inputs: { message } })` 로 호출. prompt 는 확인 시 입력 문자열, confirm 은 확인 시 `true`, 취소는 둘 다 undefined.
+표준 입력/확인 모달. `SdModalContentDef<string>` / `SdModalContentDef<boolean>` 구현.
+
+- 둘 다 `message: input.required<string>()`(HTML), `initialized: signal(true)`, `close` output.
+- prompt: 텍스트 입력(필수) → 확인 시 입력 문자열, 취소 시 `undefined`.
+- confirm: 확인 시 `true`, 취소 시 `undefined`.
 
 ## 토스트
 
-### SdToastProvider
+### `SdToastProvider`
 
-```ts
-@Injectable({ providedIn: "root" }) class SdToastProvider {
-  alertThemes: WritableSignal<SdToastSeverity[]>; overlap: WritableSignal<boolean>;
-  beforeShowFn?: (theme: SdToastSeverity) => void;
-  info(msg, useProgress?): WritableSignal<number> | void;   // success/warning/danger 동일 시그니처
-  notify<T>(input: SdToastInput<T>): Promise<...>;
-  try<R>(fn: () => Promise<R> | R, messageFn?: (err: Error) => string): Promise<R | undefined>;
-}
-// SdToastSeverity = "info" | "success" | "warning" | "danger"
-```
+`@Injectable({ providedIn: "root" })`.
 
-- `info`/`success`/`warning`/`danger(msg, useProgress?)` — 토스트 표시. `useProgress=true` 면 진행률 토스트의 `WritableSignal<number>`(0~100) 반환(100 도달 후 자동 해제), 아니면 3초 후(호버 시 지연) 자동 해제.
-- `try(fn, messageFn?)` — fn 실행 중 Error 발생 시 `danger` 토스트 + 시스템로그 적재 후 undefined 반환(Error 외 예외는 rethrow). 화면 핸들러를 감싸 에러를 사용자에게 알림.
-- `alertThemes` — 해당 severity 는 토스트 대신 `window.alert` 사용. `overlap`=새 토스트가 기존을 대체. `notify` 는 커스텀 컴포넌트 토스트.
+- `SdToastSeverity` = `"info" | "success" | "warning" | "danger"` — 심각도. `info`/`success` = polite(aria), `warning`/`danger` = assertive. (심각도 분류 기준은 sd-design-rules.md)
+- `SdToastTheme` = `"primary" | "secondary" | SdToastSeverity | "gray" | "blue-gray"`.
+- 심각도 헬퍼(각 overload): `info`/`success`/`warning`/`danger`. `useProgress=true` 면 `WritableSignal<number>`(진행률 0~100) 반환, 아니면 `void`. 비-progress 토스트는 3초 후 자동 소멸(hover 중 일시정지), progress 토스트는 ≥100 도달 1초 후 소멸.
 
 ```ts
-await inject(SdToastProvider).try(async () => { await save(); this._sdToast.success("저장됨"); });
+this._sdToast.success("저장되었습니다.");
+this._sdToast.danger("...");
 ```
 
-### SdToast / SdToastContainer — `<sd-toast>` / `<sd-toast-container>`
+- `try` (overload):
+  ```ts
+  try<R>(fn: () => Promise<R>, messageFn?: (err: Error) => string): Promise<R | undefined>
+  try<R>(fn: () => R, messageFn?: (err: Error) => string): R | undefined
+  ```
+  `fn` 실행(async 면 await). 성공 시 결과 반환. `Error` throw 시 `danger` 토스트(`messageFn(err)` 또는 `err.message`) + `SdSystemLogProvider.writeAsync("error", ...)` 적재 후 `undefined` 반환. 비-Error throw 는 재throw.
 
-```ts
-// toast
-open = model(false); useProgress = input(false); theme = input<SdToastTheme>("info");
-progress = model(0); message = model<string | undefined>();
-// container
-overlap = input(false);
-// SdToastTheme = "primary"|"secondary"|"info"|"success"|"warning"|"danger"|"gray"|"blue-gray"
-```
+  ```ts
+  this.busyCount.update((v) => v + 1);
+  await this._sdToast.try(async () => { await this._refresh(); });
+  this.busyCount.update((v) => v - 1);
+  ```
 
-- 토스트 표시 단위/컨테이너(provider 가 동적 생성, 직접 사용은 드묾). `theme` info/success 는 aria status·polite, warning/danger 는 alert·assertive 로 접근성 자동 설정.
+- `notify<T extends SdToastContentDef<any>>(input: SdToastInput<T>): Promise<...>` — 커스텀 컴포넌트를 토스트로 렌더(5초 후 자동 소멸), `close` emit 값 또는 `undefined` resolve.
+- 필드: `alertThemes: signal<SdToastSeverity[]>([])`(여기 든 심각도는 토스트 대신 `window.alert`) / `overlap: signal(false)`(겹침 모드, 새 토스트 전 기존 제거) / `beforeShowFn?: (theme) => void`.
 
-### 관련 타입
+`SdToastContentDef<O>` — `{ close: OutputEmitterRef<O | undefined> }`. `SdToastInput<T>` — `{ type: Type<T>; inputs: Omit<DirectiveInputSignals<T>, "close"> }`.
 
-```ts
-SdToastContentDef<O> { close: OutputEmitterRef<O | undefined> }
-SdToastInput<T> { type: Type<T>; inputs: Omit<DirectiveInputSignals<T>, "close"> }
-```
+### `SdToast` / `SdToastContainer`
 
-- 커스텀 컴포넌트 토스트(`notify`)의 계약·입력 타입.
+토스트 셸·컨테이너 컴포넌트. provider 가 내부 사용 — 화면에서 직접 두지 않음. toast: `open: model`, `theme: SdToastTheme`(기본 `"info"`), `useProgress`, `progress: model(0)`, `message: model`. container: `overlap: boolean`.
 
 ## busy
 
-### SdBusyProvider
+### `SdBusyProvider`
 
-```ts
-@Injectable({ providedIn: "root" }) class SdBusyProvider {
-  type: WritableSignal<SdBusyType>;       // 기본 "bar"
-  globalBusyCount: WritableSignal<number>;
-}
-// SdBusyType = "spinner" | "bar" | "cube"
-```
+`@Injectable({ providedIn: "root" })`.
 
-- `globalBusyCount` — 0 초과면 전역 busy 오버레이 표시(라우팅 네비게이션·인쇄가 자동 +1/-1). 화면에서 비동기 작업 동안 직접 증감 가능. `type` 은 전역 인디케이터 모양.
+- `SdBusyType` = `"spinner" | "bar" | "cube"` — 인디케이터 외형. `"spinner"` = 상단에서 내려오는 원형 스피너+메시지; `"bar"` = 상단 얇은 진행 바; `"cube"` = 중앙 회전 큐브.
+- `type: signal<SdBusyType>("bar")` — 전역 기본 인디케이터 타입.
+- `globalBusyCount: signal(0)` — 전역 전체화면 busy 참조 카운트. `>0` 이면 전체화면 오버레이 표시. (`provideSdAngular` 의 라우팅 추적·`SdPrintProvider` 가 증감)
 
-### SdBusyContainer — `<sd-busy-container>`
+### `SdBusyContainer` — `<sd-busy-container>`
+
+콘텐츠 위에 busy 오버레이를 거는 컴포넌트. (화면 busy 표시는 보통 `sd-base-container`/`sd-crud-*` 가 처리하므로 직접 사용은 드묾)
+
+- `busy: boolean` — 오버레이 활성.
+- `message: string` — 오버레이 메시지.
+- `type: SdBusyType | undefined` — 인디케이터 타입(미지정 시 provider 기본).
+- `progressPercent: number | undefined` — 0~100; 설정 시 상단 진행 바.
+
+## 인쇄
+
+### `SdPrintProvider`
+
+`@Injectable({ providedIn: "root" })`. jsPDF·html-to-image 사용. 프린트 템플릿(`<domain>.print-template.ts`)을 대상으로 함.
 
 ```ts
-busy = input(false); message = input<string>(); type = input<SdBusyType>();
-progressPercent = input<number>();
+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>
 ```
 
-- 특정 영역에 busy 오버레이를 씌우는 컨테이너. `busy` true 동안 콘텐츠 위에 인디케이터 + 키보드 차단. `type` 미지정 시 `SdBusyProvider.type`, `progressPercent`=상단 진행바.
+- `printAsync` — 템플릿 컴포넌트 생성·`@page { size; margin }` 주입(기본 `size="A4 auto"`, `margin="0"`), `initialized()`·이미지 로드 대기 후 `window.print()`. `globalBusyCount` 증감.
+- `getPdfBufferAsync` — 같은 템플릿을 off-screen 래스터화해 jsPDF 페이지로(기본 `pageSize="a4"`, `orientation="p"`) `Uint8Array` 반환.
+- `SdPrint` — `{ initialized: Signal<boolean>; _optionalPrintInputs?: string }`. 템플릿 컴포넌트가 구현.
+- `SdPrintInput<T, X>` — `{ type: Type<T>; inputs: ... }`(`_optionalPrintInputs`·추가 키 `X` 제외, optional 키 적용).
 
-```html
-<sd-busy-container [busy]="loading()"> <ng-content /> </sd-busy-container>
-```
+## 파일 다이얼로그
 
-## 인쇄·PDF
+### `SdFileDialogProvider`
 
-### SdPrintProvider
+`@Injectable({ providedIn: "root" })`. (단순 파일 선택은 `@simplysm/core-browser` 의 `openFileDialog` 도 사용 — [client-crud.md](../manuals/client-crud.md) 엑셀 업로드 레시피)
 
 ```ts
-@Injectable({ providedIn: "root" }) class SdPrintProvider {
-  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>;
-}
-// SdPrint { initialized: Signal<boolean>; _optionalPrintInputs? }
-// SdPrintInput<T, X> { type: Type<T>; inputs: ... }
+showAsync(multiple?: false, accept?: string): Promise<File | undefined>
+showAsync(multiple: true, accept?: string): Promise<File[] | undefined>
 ```
 
-- `printAsync(template, options)` — 인쇄용 컴포넌트를 임시 렌더(`initialized` 대기 + 이미지 로드 대기) 후 `window.print()`. `options.size`(예: `"A4 auto"`)/`margin` 은 `@page` 규칙. 동안 globalBusy.
-- `getPdfBufferAsync(template, options)` — 같은 방식으로 렌더 후 `.page` 요소(없으면 전체)를 페이지별 이미지로 PDF 생성, `Uint8Array` 반환. `orientation`/`pageSize`(예: `"a4"`) 지정.
-- `template.type` 는 `SdPrint` 구현 컴포넌트(`initialized` 시그널 필수). `inputs` 로 데이터 주입.
+- 숨김 `<input type="file">` 생성·클릭으로 native 피커 열기. `multiple` 거짓이면 단일 `File`, true 면 `File[]`, 취소 시 `undefined`. `accept` 로 MIME/확장자 필터.