@simplysm/sd-claude 14.0.46 → 14.0.48

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

@@ -1,379 +0,0 @@
-# Features
-
-## `SdBaseContainer`
-
-페이지/모달/뷰 공통 레이아웃 컨테이너. `currViewType()`에 따라 page(topbar 포함), modal(bottom 슬롯 포함), control(raw content) 중 하나를 렌더링한다.
-
-```typescript
-@Component({ selector: "sd-base-container" })
-class SdBaseContainer {
-  contentTplRef = contentChild.required("contentTpl", { read: TemplateRef });
-  pageTopbarTplRef = contentChild("pageTopbarTpl", { read: TemplateRef });
-  modalBottomTplRef = contentChild("modalBottomTpl", { read: TemplateRef });
-
-  viewType = input<SdViewType>();
-  currViewType: Signal<SdViewType>; // viewType ?? parentViewType
-  header = input<string>();
-  modalOrPageTitle: Signal<string>; // header ?? 모달 타이틀 ?? 앱 구조 타이틀
-
-  initialized = input<boolean | undefined>(undefined);
-  restricted = input(false, { transform: booleanAttribute });
-  busy = input(false, { transform: booleanAttribute });
-  busyMessage = input<string>();
-}
-```
-
-| Input | Type | Default | Description |
-|-------|------|---------|-------------|
-| `viewType` | `SdViewType \| undefined` | `undefined` | 뷰 타입 오버라이드 |
-| `header` | `string \| undefined` | `undefined` | 헤더 타이틀 오버라이드 |
-| `initialized` | `boolean \| undefined` | `undefined` | `false`면 컨텐츠 숨김, `undefined`면 표시 |
-| `restricted` | `boolean` | `false` | `true`면 권한 없음 메시지 표시 |
-| `busy` | `boolean` | `false` | busy 상태 |
-| `busyMessage` | `string \| undefined` | `undefined` | busy 메시지 |
-
-Content children:
-- `#contentTpl` (required): 메인 컨텐츠 템플릿
-- `#pageTopbarTpl`: 페이지 모드에서 탑바에 추가할 템플릿
-- `#modalBottomTpl`: 모달 모드에서 하단에 추가할 템플릿
-
-## `SdAddressSearchModal`
-
-Daum Postcode API를 사용한 주소 검색 모달. `SdModalContentDef<Address>`를 구현한다.
-
-```typescript
-@Component({ selector: "sd-address-search-modal" })
-class SdAddressSearchModal implements SdModalContentDef<Address>, OnInit {
-  close = output<Address>();
-  initialized = signal(false);
-}
-```
-
-### `Address`
-
-```typescript
-interface Address {
-  postNumber: string | undefined;
-  address: string | undefined;
-  buildingName: string | undefined;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `postNumber` | `string \| undefined` | 우편번호 |
-| `address` | `string \| undefined` | 주소 |
-| `buildingName` | `string \| undefined` | 건물명 |
-
-## `SdPermissionTable`
-
-권한 매트릭스 테이블. `SdPermission` 트리를 테이블로 렌더링하여 use/edit 체크박스를 표시한다.
-
-```typescript
-@Component({ selector: "sd-permission-table" })
-class SdPermissionTable<TModule = unknown> {
-  value = model<Record<string, boolean>>({});
-  items = input<SdPermission<TModule>[]>([]);
-  disabled = input(false, { transform: booleanAttribute });
-}
-```
-
-| Input | Type | Default | Description |
-|-------|------|---------|-------------|
-| `value` | `Record<string, boolean>` | `{}` | 권한 레코드 (two-way). 키는 `codeChain.join(".") + ".use"` 또는 `".edit"` 형태 |
-| `items` | `SdPermission<TModule>[]` | `[]` | 권한 트리 |
-| `disabled` | `boolean` | `false` | 비활성화 |
-
-## Data View Abstractions
-
-### `SdDataSheetBase`
-
-데이터 시트 CRUD 추상 클래스. 소비 프로젝트에서 상속하여 구현한다. `SdSelectModal<TItem>`을 구현하므로 모달 선택에도 사용 가능.
-
-```typescript
-@Directive()
-abstract class SdDataSheetBase<
-  TFilter extends Record<string, any>,
-  TItem,
-  TKey extends string | number | undefined,
-> implements SdSelectModal<TItem> {
-  // 필수 구현
-  abstract canUse: Signal<boolean>;
-  abstract canEdit: Signal<boolean>;
-  abstract editMode: "inline" | "modal" | undefined;
-  abstract selectMode: InputSignal<"single" | "multi" | undefined>;
-  abstract bindFilter(): TFilter;
-  abstract itemPropInfo: SdDataSheetItemPropInfo<TItem>;
-  abstract getItemInfoFn: (item: TItem) => SdDataSheetItemInfo<TKey>;
-  abstract search(usePagination: boolean): Promise<SdDataSheetSearchResult<TItem>> | SdDataSheetSearchResult<TItem>;
-
-  // 선택적 구현
-  hideTool?: Signal<boolean>;
-  diffsExcludes?: string[];
-  prepareRefreshEffect?(): void;
-  editItem?(item?: TItem): Promise<boolean | undefined> | boolean | undefined;
-  toggleDeleteItems?(del: boolean): Promise<boolean>;
-  newItem?(): Promise<TItem> | TItem;
-  submit?(diffs: ArrayOneWayDiffResult<TItem>[]): Promise<boolean> | boolean;
-  downloadExcel?(items: TItem[]): Promise<void> | void;
-  uploadExcel?(file: File): Promise<void> | void;
-}
-```
-
-### `SdDataSheet`
-
-데이터 시트 presentation 컴포넌트. `SdDataSheetBase`의 상속자를 부모로 자동 감지하여 렌더링한다.
-
-```typescript
-@Component({ selector: "sd-data-sheet" })
-class SdDataSheet { }
-```
-
-### `SdDataSheetColumn`
-
-데이터 시트 컬럼. `SdSheetColumn`를 확장하여 `edit` input을 추가한다.
-
-```typescript
-@Directive({ selector: "sd-data-sheet-column" })
-class SdDataSheetColumn extends SdSheetColumn {
-  edit = input(false, { transform: booleanAttribute });
-}
-```
-
-### `SdDataSheetItemPropInfo`
-
-```typescript
-interface SdDataSheetItemPropInfo<I> {
-  isDeleted: (keyof I & string) | undefined;
-  lastModifiedAt: (keyof I & string) | undefined;
-  lastModifiedBy: (keyof I & string) | undefined;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `isDeleted` | `keyof I \| undefined` | 삭제 여부 프로퍼티 키 |
-| `lastModifiedAt` | `keyof I \| undefined` | 최종 수정일시 프로퍼티 키 |
-| `lastModifiedBy` | `keyof I \| undefined` | 최종 수정자 프로퍼티 키 |
-
-### `SdDataSheetItemInfo`
-
-```typescript
-interface SdDataSheetItemInfo<K> {
-  key: K;
-  canSelect: boolean;
-  canEdit: boolean;
-  canDelete: boolean;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `key` | `K` | 항목 키 |
-| `canSelect` | `boolean` | 선택 가능 여부 |
-| `canEdit` | `boolean` | 편집 가능 여부 |
-| `canDelete` | `boolean` | 삭제 가능 여부 |
-
-### `SdDataSheetSearchResult`
-
-```typescript
-interface SdDataSheetSearchResult<I> {
-  items: I[];
-  pageLength?: number;
-  summary?: Partial<I>;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `items` | `I[]` | 조회된 항목 |
-| `pageLength` | `number \| undefined` | 총 페이지 수 |
-| `summary` | `Partial<I> \| undefined` | 요약 행 데이터 |
-
-### `SdDataDetailBase`
-
-상세 폼 추상 클래스. 모달로 표시되며, `SdModalContentDef<R>`을 구현한다.
-
-```typescript
-@Directive()
-abstract class SdDataDetailBase<T extends object, R = boolean> implements SdModalContentDef<R> {
-  // 필수 구현
-  abstract canUse: Signal<boolean>;
-  abstract canEdit: Signal<boolean>;
-  abstract load(): Promise<{ data: T; info: SdDataDetailDataInfo }> | { data: T; info: SdDataDetailDataInfo };
-
-  // 선택적 구현
-  canDelete?: Signal<boolean>;
-  prepareRefreshEffect?(): void;
-  toggleDelete?(del: boolean): Promise<R | undefined> | R | undefined;
-  submit?(data: T): Promise<R | undefined> | R | undefined;
-}
-```
-
-### `SdDataDetail`
-
-상세 폼 presentation 컴포넌트.
-
-```typescript
-@Component({ selector: "sd-data-detail" })
-class SdDataDetail { }
-```
-
-### `SdDataDetailDataInfo`
-
-```typescript
-interface SdDataDetailDataInfo {
-  isNew: boolean;
-  isDeleted: boolean;
-  lastModifiedAt: DateTime | undefined;
-  lastModifiedBy: string | undefined;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `isNew` | `boolean` | 신규 여부 |
-| `isDeleted` | `boolean` | 삭제 여부 |
-| `lastModifiedAt` | `DateTime \| undefined` | 최종 수정일시 |
-| `lastModifiedBy` | `string \| undefined` | 최종 수정자 |
-
-### `SdDataSelectButtonBase`
-
-모달 기반 선택 버튼 추상 클래스.
-
-```typescript
-@Directive()
-abstract class SdDataSelectButtonBase<TItem extends object, TKey, TMode extends keyof SelectModeValue<TKey>> {
-  abstract modal: Signal<SdSelectModalInfo<SdSelectModal<any>>>;
-  abstract load(keys: TKey[]): Promise<TItem[]> | TItem[];
-
-  value = model<SelectModeValue<TKey>[TMode]>();
-  disabled = input(false, { transform: booleanAttribute });
-  required = input(false, { transform: booleanAttribute });
-  inset = input(false, { transform: booleanAttribute });
-  size = input<"sm" | "lg">();
-  selectMode = input<TMode>("single" as TMode);
-}
-```
-
-| Input/Model | Type | Default | Description |
-|-------------|------|---------|-------------|
-| `value` | `SelectModeValue<TKey>[TMode]` | - | 선택된 값 (two-way) |
-| `disabled` | `boolean` | `false` | 비활성화 |
-| `required` | `boolean` | `false` | 필수 |
-| `inset` | `boolean` | `false` | 삽입 스타일 |
-| `size` | `"sm" \| "lg" \| undefined` | `undefined` | 크기 |
-| `selectMode` | `TMode` | `"single"` | 선택 모드 |
-
-### `SdDataSelectButton`
-
-선택 버튼 presentation 컴포넌트.
-
-```typescript
-@Component({ selector: "sd-data-select-button" })
-class SdDataSelectButton { }
-```
-
-## Shared Data Controls
-
-### `SdSharedDataSelect`
-
-공유 데이터 드롭다운 선택 컴포넌트. 검색 기능 포함.
-
-```typescript
-@Component({ selector: "sd-shared-data-select" })
-class SdSharedDataSelect<TItem extends SharedDataBase<string | number>, TMode extends keyof SelectModeValue<...>, TModal extends SdSelectModal<any>> {
-  value = model<SelectModeValue<TItem["__valueKey"] | undefined>[TMode]>();
-  items = input.required<TItem[]>();
-  disabled = input(false, { transform: booleanAttribute });
-  required = input(false, { transform: booleanAttribute });
-  useUndefined = input(false, { transform: booleanAttribute });
-  inset = input(false, { transform: booleanAttribute });
-  inline = input(false, { transform: booleanAttribute });
-  size = input<"sm" | "lg">();
-  selectMode = input("single" as TMode);
-  filterFn = input<(item: TItem, index: number, ...params: any[]) => boolean>();
-  filterFnParams = input<any[]>();
-  modal = input<SdSelectModalInfo<TModal>>();
-  editModal = input<SdModalInfo<SdModalContentDef<boolean>>>();
-  selectClass = input<string>();
-  multiSelectionDisplayDirection = input<"vertical">();
-  getIsHiddenFn = input<(item: TItem, index: number) => boolean>();
-  getSearchTextFn = input<(item: TItem, index: number) => string>();
-  displayOrderKeyProp = input<string>();
-}
-```
-
-### `SdSharedDataSelectButton`
-
-공유 데이터 모달 선택 버튼. `SdDataSelectButton`을 래핑하여 공유 데이터 항목을 표시한다.
-
-```typescript
-@Component({ selector: "sd-shared-data-select-button" })
-class SdSharedDataSelectButton<TItem extends SharedDataBase<...>, TMode extends keyof SelectModeValue<...>, TModal extends SdSelectModal<any>> {
-  items = input<TItem[]>([]);
-  modal = input.required<SdSelectModalInfo<TModal>>();
-}
-```
-
-### `SdSharedDataSelectList`
-
-공유 데이터 목록형 선택 컴포넌트. 검색, 페이지네이션, 외부 링크 기능을 포함한다.
-
-```typescript
-@Component({ selector: "sd-shared-data-select-list" })
-class SdSharedDataSelectList<TItem extends SharedDataBase<string | number>, TModal extends SdSelectModal<any>> {
-  selectedItem = model<TItem>();
-  canChangeFn = input<(item: TItem | undefined) => boolean | Promise<boolean>>(() => true);
-  items = input.required<TItem[]>();
-  selectedIcon = input<string>();
-  useUndefined = input(false, { transform: booleanAttribute });
-  filterFn = input<(item: TItem, index: number) => boolean>();
-  modal = input<SdSelectModalInfo<TModal>>();
-  header = input<string>();
-  pageItemCount = input<number>();
-}
-```
-
-| Input | Type | Default | Description |
-|-------|------|---------|-------------|
-| `selectedItem` | `TItem \| undefined` | - | 선택된 항목 (two-way) |
-| `canChangeFn` | `(item) => boolean \| Promise<boolean>` | `() => true` | 선택 변경 가능 여부 함수 |
-| `items` | `TItem[]` | required | 공유 데이터 항목 |
-| `selectedIcon` | `string \| undefined` | `undefined` | 선택됨 아이콘 |
-| `useUndefined` | `boolean` | `false` | undefined 항목 포함 |
-| `filterFn` | `((item, index) => boolean) \| undefined` | `undefined` | 필터 함수 |
-| `modal` | `SdSelectModalInfo<TModal> \| undefined` | `undefined` | 모달 선택 정보 |
-| `header` | `string \| undefined` | `undefined` | 헤더 텍스트 |
-| `pageItemCount` | `number \| undefined` | `undefined` | 페이지당 항목 수 |
-
-Content children:
-- `#headerTpl`: 헤더 커스텀 템플릿
-- `#filterTpl`: 필터 커스텀 템플릿
-- `SdItemOfTemplate`: 항목 커스텀 템플릿
-- `#undefinedTpl`: undefined 항목 커스텀 템플릿
-
-### `matchesSearchText`
-
-공백 구분 AND 조건 텍스트 검색 매칭 함수.
-
-```typescript
-function matchesSearchText(itemText: string, searchQuery: string | undefined): boolean
-```
-
-모든 검색어(공백으로 분할)가 `itemText`에 포함되면 `true`. `searchQuery`가 undefined이거나 빈 문자열이면 항상 `true`.
-
-## `getOrmDataEditToastErrorMessage`
-
-ORM 편집 에러 메시지를 사용자 친화적인 한국어 메시지로 변환한다. FK 제약 위반 등 DB 에러 메시지를 감지하여 적절한 메시지를 반환한다.
-
-```typescript
-function getOrmDataEditToastErrorMessage(err: unknown): string
-```
-
-| 감지 조건 | 반환 메시지 |
-|-----------|-------------|
-| FK 제약 위반 (`a parent row: a foreign key constraint` 또는 `conflicted with the REFERENCE`) | `"경고! 연결된 작업에 의한 처리 거부. 후속작업 확인 요망"` |
-| 그 외 | `err.message` (또는 `String(err)`) |
-
-`SdDataSheetBase`, `SdDataDetailBase` 내부에서 사용되며, 소비 코드에서 직접 사용할 수도 있다.

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

@@ -1,32 +0,0 @@
-# Pipes
-
-## `FormatPipe`
-
-DateTime, DateOnly, string 값을 포맷팅하는 파이프. 파이프명: `format`
-
-```typescript
-@Pipe({ name: "format" })
-class FormatPipe implements PipeTransform {
-  transform(value: string | DateTime | DateOnly | undefined, format: string): string;
-}
-```
-
-### DateTime / DateOnly
-
-`value.toFormatString(format)`을 호출한다.
-
-```html
-{{ someDateTime | format: "yyyy-MM-dd HH:mm" }}
-{{ someDateOnly | format: "yyyy년 MM월 dd일" }}
-```
-
-### String
-
-format 문자열에서 `X` 문자를 값의 문자로 치환한다. `|`로 구분된 여러 포맷 중 길이가 일치하는 것을 사용한다.
-
-```html
-<!-- "01012345678" → "010-1234-5678" -->
-{{ phone | format: "XXX-XXXX-XXXX|XX-XXX-XXXX|XX-XXXX-XXXX" }}
-```
-
-`undefined` 또는 `null` 입력 시 빈 문자열 반환.

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

@@ -1,37 +0,0 @@
-# Plugins
-
-Angular의 `EventManagerPlugin`을 확장하여 커스텀 이벤트 옵션을 지원한다. `provideSdAngular()`에서 `SdOptionEventPlugin`만 자동 등록된다.
-
-> **NOTE:** 이전 버전의 커맨드 플러그인(`sdSaveCommand`, `sdRefreshCommand`, `sdInsertCommand`)과 옵저버 플러그인(`sdResize`, `sdIntersection`)은 디렉티브로 대체되었다. 자세한 내용은 [directives.md](./directives.md)의 `SdCommandDirective`, `SdResizeDirective`, `SdIntersectionDirective` 항목을 참고한다.
-
-## Option Plugin
-
-### `SdOptionEventPlugin`
-
-`.capture`, `.passive`, `.once` 이벤트 수식어 플러그인. 네이티브 DOM 이벤트에 addEventListener options를 적용한다.
-
-```typescript
-class SdOptionEventPlugin extends EventManagerPlugin {
-  supports(eventName: string): boolean; // /\.(capture|passive|once)/ 매칭
-}
-```
-
-사용법: `(scroll.passive)="onScroll($event)"`, `(click.capture.once)="onClick($event)"`
-
-## Error Handler
-
-### `SdGlobalErrorHandlerPlugin`
-
-글로벌 에러 핸들러. Angular의 `ErrorHandler`를 구현하여 PromiseRejectionEvent, ErrorEvent, Error 등을 처리한다.
-
-```typescript
-class SdGlobalErrorHandlerPlugin implements ErrorHandler {
-  handleError(event: any): false;
-}
-```
-
-에러 발생 시:
-1. `SdSystemLogProvider.writeAsync()`로 로그 기록
-2. 전체 화면 에러 메시지 표시 (검은 배경 + 흰 텍스트)
-3. `ApplicationRef.destroy()` 호출하여 앱 정지
-4. 클릭 시 페이지 리로드 (프로덕션에서는 `location.hash = "/"` 후 리로드)