@simplysm/angular 14.0.49 → 14.0.52

package/docs/bootstrap.md

@@ -1,38 +0,0 @@
-# Bootstrap
-
-## `provideSdAngular`
-
-모든 기반 설정을 제공하는 환경 프로바이더 팩토리. `bootstrapApplication`의 providers에 추가한다.
-
-```typescript
-function provideSdAngular(opt: { clientName: string }): EnvironmentProviders
-```
-
-제공하는 기능:
-- `provideZonelessChangeDetection()` - Zone 없는 변경 감지
-- `IMAGE_CONFIG` - 이미지 크기/지연 로딩 경고 비활성화
-- `provideNgIconsConfig({ strokeWidth: 1.5, size: "1.33em" })`
-- 6개 커스텀 이벤트 플러그인 등록 (sdSaveCommand, sdRefreshCommand, sdInsertCommand, sdResize, sdIntersection, option)
-- `SdGlobalErrorHandlerPlugin` - 글로벌 에러 핸들러
-- 테마 초기화 (localStorage 동기화, body 클래스 토글)
-- Service Worker 업데이트 폴링 (5분 간격, 실패 시 exponential backoff, 최대 1시간)
-- 라우터 네비게이션 busy 상태 추적
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `opt.clientName` | `string` | 클라이언트 이름 (localStorage 키 접두사 등에 사용) |
-
-## `SdAngularConfigProvider`
-
-`clientName` 설정을 보유하는 프로바이더. `provideSdAngular`에서 자동 설정된다.
-
-```typescript
-@Injectable({ providedIn: "root" })
-class SdAngularConfigProvider {
-  clientName!: string;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `clientName` | `string` | 클라이언트 이름 |

package/docs/directives.md

@@ -1,236 +0,0 @@
-# Directives
-
-## `SdEvents`
-
-`.capture`, `.passive`, `.once` 수식어 및 커스텀 이벤트 바인딩을 지원하는 디렉티브. Angular 템플릿에서 해당 이벤트를 사용할 때 자동 매칭된다.
-
-```typescript
-@Directive({
-  selector: `[click.capture], [scroll.passive], ...`,
-})
-class SdEvents {
-  // 클릭: click.capture, click.once, click.capture.once
-  // 마우스: mousedown.capture, mouseup.capture, mouseover.capture, mouseout.capture
-  // 키보드: keydown.capture, keyup.capture
-  // 포커스: focus.capture, blur.capture
-  // 폼: invalid.capture
-  // 스크롤: scroll.capture, scroll.passive, scroll.capture.passive
-  // 휠: wheel.passive, wheel.capture.passive
-  // 터치: touchstart.passive, touchstart.capture.passive, touchmove.passive, touchmove.capture.passive, touchend.passive
-  // 드래그: dragover.capture, dragenter.capture, dragleave.capture, drop.capture
-  // 애니메이션: transitionend.once, animationend.once
-}
-```
-
-> **NOTE:** `sdResize`, `sdSaveCommand`, `sdRefreshCommand`, `sdInsertCommand`는 `SdEvents`에서 분리되어 각각 `SdResizeDirective`, `SdIntersectionDirective`, `SdCommandDirective`로 독립 디렉티브로 제공된다.
-
-## `SdRipple`
-
-호스트 요소에 리플 효과를 추가하는 디렉티브.
-
-```typescript
-@Directive({ selector: "[sdRipple]" })
-class SdRipple {
-  enabled = input.required({ alias: "sdRipple", transform: booleanAttribute });
-}
-```
-
-사용법: `<div [sdRipple]="true">` 또는 `<div sdRipple>`
-
-## `SdShowEffect`
-
-뷰포트에 진입할 때 reveal 애니메이션을 적용하는 디렉티브. IntersectionObserver 사용.
-
-```typescript
-@Directive({ selector: "[sdShowEffect]" })
-class SdShowEffect {
-  enabled = input.required({ alias: "sdShowEffect", transform: booleanAttribute });
-  sdShowEffectType = input<"l2r" | "t2b">("t2b");
-}
-```
-
-| Input | Type | Default | Description |
-|-------|------|---------|-------------|
-| `sdShowEffect` | `boolean` | required | 효과 활성화 여부 |
-| `sdShowEffectType` | `"l2r" \| "t2b"` | `"t2b"` | 애니메이션 방향 (좌->우 / 위->아래) |
-
-## `SdInvalid`
-
-호스트 요소에 유효성 검증 표시기를 추가하는 디렉티브. 빨간 점 표시기와 숨겨진 input으로 구성.
-
-```typescript
-@Directive({ selector: "[sdInvalid]" })
-class SdInvalid {
-  invalidMessage = input.required<string>({ alias: "sdInvalid" });
-}
-```
-
-사용법: `<div [sdInvalid]="name이 비어있습니다">`. 메시지가 빈 문자열이면 유효, 비어있지 않으면 무효.
-
-## `SdTypedTemplate`
-
-`ng-template`의 컨텍스트 타입을 지정하는 디렉티브. 타입 가드를 통해 템플릿 내부에서 정확한 타입을 사용할 수 있다.
-
-```typescript
-@Directive({ selector: "ng-template[typed]" })
-class SdTypedTemplate<T> {
-  typed = input.required<T>();
-
-  static ngTemplateContextGuard<TypeToken>(
-    _dir: SdTypedTemplate<TypeToken>,
-    _ctx: unknown,
-  ): _ctx is TypeToken;
-}
-```
-
-사용법:
-```html
-<ng-template [typed]="typedVar" let-item>
-  <!-- item의 타입이 typeof typedVar -->
-</ng-template>
-```
-
-## `SdItemOfTemplate`
-
-항목 반복 템플릿의 컨텍스트 타입을 지정하는 디렉티브.
-
-```typescript
-@Directive({ selector: "ng-template[itemOf]" })
-class SdItemOfTemplate<TItem> {
-  itemOf = input.required<TItem[]>();
-
-  static ngTemplateContextGuard<TContextItem>(
-    _dir: SdItemOfTemplate<TContextItem>,
-    _ctx: unknown,
-  ): _ctx is SdItemOfTemplateContext<TContextItem>;
-}
-```
-
-## `SdItemOfTemplateContext`
-
-itemOf 템플릿 컨텍스트.
-
-```typescript
-interface SdItemOfTemplateContext<TItem> {
-  $implicit: TItem;
-  item: TItem;
-  index: number;
-  depth: number;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `$implicit` | `TItem` | 현재 항목 (let-item으로 접근) |
-| `item` | `TItem` | 현재 항목 (명시적 접근) |
-| `index` | `number` | 인덱스 |
-| `depth` | `number` | 깊이 (트리 구조에서 사용) |
-
-사용법:
-```html
-<ng-template [itemOf]="items()" let-item let-index="index">
-  {{ item.name }}
-</ng-template>
-```
-
-## `SdCommandDirective`
-
-키보드 단축키를 output 이벤트로 제공하는 디렉티브. `document` keydown을 감지하며, `shouldProcessCommandEvent()`로 최상위 모달만 이벤트 처리.
-
-```typescript
-@Directive({ selector: "[sdRefreshCommand],[sdSaveCommand],[sdInsertCommand]" })
-class SdCommandDirective {
-  sdRefreshCommand = output<KeyboardEvent>(); // Ctrl+Alt+L
-  sdSaveCommand = output<KeyboardEvent>();    // Ctrl+S
-  sdInsertCommand = output<KeyboardEvent>();  // Ctrl+Insert
-}
-```
-
-사용법: `<div (sdSaveCommand)="onSave($event)" (sdRefreshCommand)="onRefresh($event)">`
-
-## `SdResizeDirective`
-
-ResizeObserver 기반 resize output 이벤트 디렉티브. `requestAnimationFrame`으로 디바운스.
-
-```typescript
-@Directive({ selector: "[sdResize]" })
-class SdResizeDirective {
-  sdResize = output<SdResizeEvent>();
-}
-```
-
-사용법: `<div (sdResize)="onResize($event)">`
-
-## `SdResizeEvent`
-
-```typescript
-interface SdResizeEvent {
-  heightChanged: boolean;
-  widthChanged: boolean;
-  target: HTMLElement;
-  contentRect: DOMRectReadOnly;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `heightChanged` | `boolean` | 높이 변경 여부 |
-| `widthChanged` | `boolean` | 너비 변경 여부 |
-| `target` | `HTMLElement` | 대상 요소 |
-| `contentRect` | `DOMRectReadOnly` | 컨텐츠 영역 크기 |
-
-## `SdIntersectionDirective`
-
-IntersectionObserver 기반 intersection output 이벤트 디렉티브.
-
-```typescript
-@Directive({ selector: "[sdIntersection]" })
-class SdIntersectionDirective {
-  sdIntersection = output<SdIntersectionEvent>();
-}
-```
-
-사용법: `<div (sdIntersection)="onIntersect($event)">`
-
-## `SdIntersectionEvent`
-
-```typescript
-interface SdIntersectionEvent {
-  entry: IntersectionObserverEntry;
-}
-```
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `entry` | `IntersectionObserverEntry` | 마지막 IntersectionObserver 엔트리 |
-
-## `SdRouterLink`
-
-라우터 네비게이션 디렉티브. 일반 클릭은 라우터 네비게이션, Ctrl/Shift+클릭은 새 창, 팝업 윈도우에서는 팝업 형태로 열린다.
-
-```typescript
-@Directive({
-  selector: "[sdRouterLink]",
-  host: {
-    "[style.cursor]": "option() ? 'pointer' : ''",
-    "(click)": "onClick($event)",
-  },
-})
-class SdRouterLink {
-  option = input<{
-    link: string;
-    params?: Record<string, string>;
-    window?: { width?: number; height?: number };
-    outletName?: string;
-    queryParams?: Record<string, string>;
-  } | undefined>(undefined, { alias: "sdRouterLink" });
-}
-```
-
-| Input Field | Type | Description |
-|-------------|------|-------------|
-| `link` | `string` | 네비게이션 경로 |
-| `params` | `Record<string, string> \| undefined` | 라우터 파라미터 |
-| `window` | `{ width?, height? } \| undefined` | 팝업 윈도우 크기 (설정 시 팝업으로 열림) |
-| `outletName` | `string \| undefined` | named outlet |
-| `queryParams` | `Record<string, string> \| undefined` | 쿼리 파라미터 |

package/docs/features.md

@@ -1,154 +0,0 @@
-# Features
-
-## `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 Composition (Recipes)
-
-CRUD 리스트(시트) · 상세 폼 · 모달 선택 버튼은 추상 클래스 대신 **레시피 기반 직접 조립** 방식을 사용한다. `<sd-sheet>` + `<sd-form>` · `<sd-modal-select-button>` 등 표준 컴포넌트를 화면 코드가 직접 결합한다. 조립 레시피:
-
-- 리스트(시트): [recipes/crud-list.md](./recipes/crud-list.md)
-- 상세: [recipes/crud-detail.md](./recipes/crud-detail.md)
-- 선택 버튼: [recipes/data-select-button.md](./recipes/data-select-button.md)
-- 페이지/모달 컨테이너: [recipes/page-modal-container.md](./recipes/page-modal-container.md)
-
-## 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`
-
-공유 데이터 모달 선택 버튼. `<sd-modal-select-button>`을 컴포지션하여 공유 데이터 항목을 표시한다. `value` 또는 `items` 변경 시 내부에서 `items.filter(by __valueKey)`로 표시 항목이 자동 동기화된다.
-
-```typescript
-@Component({ selector: "sd-shared-data-select-button" })
-class SdSharedDataSelectButton<TItem extends SharedDataBase<string | number>, TMode extends keyof SelectModeValue<string | number>, TModal extends SdSelectModal<any>> {
-  value = model<SelectModeValue<string | number>[TMode]>();
-  items = input<TItem[]>([]);
-  modal = input.required<SdSelectModalInfo<TModal>>();
-  selectMode = input<TMode>("single" as TMode);
-  disabled = input(false, { transform: booleanAttribute });
-  required = input(false, { transform: booleanAttribute });
-  inset = input(false, { transform: booleanAttribute });
-  size = input<"sm" | "lg">();
-}
-```
-
-상세 사용 예시: [recipes/data-select-button.md](./recipes/data-select-button.md) "패턴 2" 섹션.
-
-### `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`.

package/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/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 = "/"` 후 리로드)