@simplysm/angular 14.0.51 → 14.0.53

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (134) hide show
  1. package/dist/data/sheet/sd-sheet.d.ts +9 -12
  2. package/dist/data/sheet/sd-sheet.d.ts.map +1 -1
  3. package/dist/data/sheet/sd-sheet.js +150 -168
  4. package/dist/data/sheet/types.d.ts +1 -0
  5. package/dist/data/sheet/types.d.ts.map +1 -1
  6. package/dist/data/sheet/useSheetCellStyling.d.ts +2 -2
  7. package/dist/data/sheet/useSheetCellStyling.d.ts.map +1 -1
  8. package/dist/data/sheet/useSheetCellStyling.js +20 -12
  9. package/dist/data/sheet/useSheetColumnFixing.d.ts +3 -8
  10. package/dist/data/sheet/useSheetColumnFixing.d.ts.map +1 -1
  11. package/dist/data/sheet/useSheetColumnFixing.js +19 -27
  12. package/dist/data/sheet/useSheetLayoutEngine.d.ts.map +1 -1
  13. package/dist/data/sheet/useSheetLayoutEngine.js +4 -1
  14. package/dist/layout/dock/sd-dock-container.d.ts.map +1 -1
  15. package/dist/layout/dock/sd-dock-container.js +3 -3
  16. package/package.json +7 -8
  17. package/src/data/sheet/sd-sheet.ts +39 -60
  18. package/src/data/sheet/types.ts +1 -0
  19. package/src/data/sheet/useSheetCellStyling.ts +19 -11
  20. package/src/data/sheet/useSheetColumnFixing.ts +21 -28
  21. package/src/data/sheet/useSheetLayoutEngine.ts +4 -1
  22. package/src/layout/dock/sd-dock-container.ts +1 -0
  23. package/README.md +0 -476
  24. package/docs/bootstrap/provide-sd-angular.md +0 -37
  25. package/docs/bootstrap/sd-angular-config-provider.md +0 -16
  26. package/docs/directives/sd-command-directive.md +0 -30
  27. package/docs/directives/sd-events.md +0 -25
  28. package/docs/directives/sd-intersection-directive.md +0 -36
  29. package/docs/directives/sd-invalid.md +0 -24
  30. package/docs/directives/sd-resize-directive.md +0 -42
  31. package/docs/directives/sd-ripple.md +0 -23
  32. package/docs/directives/sd-router-link.md +0 -38
  33. package/docs/directives/sd-show-effect.md +0 -18
  34. package/docs/directives/sd-typed-template.md +0 -69
  35. package/docs/features/sd-address-search-modal.md +0 -50
  36. package/docs/features/sd-permission-table.md +0 -20
  37. package/docs/features/sd-shared-data-components.md +0 -158
  38. package/docs/features/sd-tiptap-editor.md +0 -26
  39. package/docs/pipes/format-pipe.md +0 -41
  40. package/docs/plugins/sd-global-error-handler.md +0 -23
  41. package/docs/plugins/sd-option-event-plugin.md +0 -34
  42. package/docs/provider-types/sd-menu.md +0 -65
  43. package/docs/provider-types/sd-modal-content-def.md +0 -148
  44. package/docs/provider-types/sd-toast-content-def.md +0 -73
  45. package/docs/provider-types/shared-data-base.md +0 -59
  46. package/docs/providers/sd-activated-modal-provider.md +0 -34
  47. package/docs/providers/sd-app-structure-provider.md +0 -81
  48. package/docs/providers/sd-busy-provider.md +0 -18
  49. package/docs/providers/sd-file-dialog-provider.md +0 -40
  50. package/docs/providers/sd-local-storage-provider.md +0 -20
  51. package/docs/providers/sd-modal-provider.md +0 -67
  52. package/docs/providers/sd-navigate-window-provider.md +0 -18
  53. package/docs/providers/sd-print-provider.md +0 -25
  54. package/docs/providers/sd-service-client-factory-provider.md +0 -43
  55. package/docs/providers/sd-shared-data-provider.md +0 -64
  56. package/docs/providers/sd-system-config-provider.md +0 -46
  57. package/docs/providers/sd-system-log-provider.md +0 -18
  58. package/docs/providers/sd-theme-provider.md +0 -38
  59. package/docs/providers/sd-toast-provider.md +0 -65
  60. package/docs/recipes/_common-rules.md +0 -244
  61. package/docs/recipes/crud-detail/extension-a-edit-save.md +0 -230
  62. package/docs/recipes/crud-detail/extension-b-delete-restore.md +0 -142
  63. package/docs/recipes/crud-detail/extension-c-modal-view.md +0 -214
  64. package/docs/recipes/crud-detail/extension-d-control-view.md +0 -103
  65. package/docs/recipes/crud-detail/extension-e-auxiliary.md +0 -87
  66. package/docs/recipes/crud-detail/extension-f-complex-detail.md +0 -234
  67. package/docs/recipes/crud-detail.md +0 -353
  68. package/docs/recipes/crud-list/extension-a-inline-edit.md +0 -410
  69. package/docs/recipes/crud-list/extension-b-selection.md +0 -226
  70. package/docs/recipes/crud-list/extension-c-inline-delete.md +0 -87
  71. package/docs/recipes/crud-list/extension-d-select-modal.md +0 -207
  72. package/docs/recipes/crud-list/extension-e-readonly-modal.md +0 -165
  73. package/docs/recipes/crud-list/extension-f-modal-edit.md +0 -177
  74. package/docs/recipes/crud-list/extension-g-excel.md +0 -157
  75. package/docs/recipes/crud-list.md +0 -446
  76. package/docs/recipes/data-select-button.md +0 -412
  77. package/docs/recipes/page-modal-container.md +0 -260
  78. package/docs/styling/classes.md +0 -149
  79. package/docs/styling/mixins.md +0 -100
  80. package/docs/styling/themes.md +0 -35
  81. package/docs/styling/variables.md +0 -147
  82. package/docs/type-utilities/directive-input-signals.md +0 -232
  83. package/docs/ui-data/sd-list.md +0 -37
  84. package/docs/ui-data/sd-sheet.md +0 -227
  85. package/docs/ui-form/sd-additional-button.md +0 -26
  86. package/docs/ui-form/sd-anchor.md +0 -31
  87. package/docs/ui-form/sd-button.md +0 -105
  88. package/docs/ui-form/sd-checkbox-group.md +0 -39
  89. package/docs/ui-form/sd-checkbox.md +0 -81
  90. package/docs/ui-form/sd-date-range-picker.md +0 -27
  91. package/docs/ui-form/sd-form.md +0 -89
  92. package/docs/ui-form/sd-modal-select-button.md +0 -54
  93. package/docs/ui-form/sd-numpad.md +0 -26
  94. package/docs/ui-form/sd-range.md +0 -26
  95. package/docs/ui-form/sd-select.md +0 -68
  96. package/docs/ui-form/sd-shared-data-select.md +0 -52
  97. package/docs/ui-form/sd-state-preset.md +0 -37
  98. package/docs/ui-form/sd-switch.md +0 -27
  99. package/docs/ui-form/sd-textarea.md +0 -33
  100. package/docs/ui-form/sd-textfield.md +0 -145
  101. package/docs/ui-layout/sd-dock-container.md +0 -64
  102. package/docs/ui-layout/sd-dock.md +0 -37
  103. package/docs/ui-layout/sd-gap.md +0 -26
  104. package/docs/ui-layout/sd-kanban-board.md +0 -96
  105. package/docs/ui-layout/sd-kanban-lane.md +0 -34
  106. package/docs/ui-layout/sd-kanban.md +0 -29
  107. package/docs/ui-navigation/sd-collapse.md +0 -35
  108. package/docs/ui-navigation/sd-pagination.md +0 -26
  109. package/docs/ui-navigation/sd-sidebar-container.md +0 -49
  110. package/docs/ui-navigation/sd-sidebar-menu.md +0 -22
  111. package/docs/ui-navigation/sd-sidebar-user.md +0 -43
  112. package/docs/ui-navigation/sd-tab.md +0 -51
  113. package/docs/ui-navigation/sd-topbar-container.md +0 -97
  114. package/docs/ui-navigation/sd-topbar-menu.md +0 -23
  115. package/docs/ui-navigation/sd-topbar-user.md +0 -38
  116. package/docs/ui-navigation/sd-topbar.md +0 -30
  117. package/docs/ui-overlay/sd-busy-container.md +0 -69
  118. package/docs/ui-overlay/sd-confirm-modal.md +0 -30
  119. package/docs/ui-overlay/sd-dropdown.md +0 -40
  120. package/docs/ui-overlay/sd-modal.md +0 -34
  121. package/docs/ui-overlay/sd-prompt-modal.md +0 -30
  122. package/docs/ui-overlay/sd-toast.md +0 -35
  123. package/docs/ui-visual/sd-barcode.md +0 -36
  124. package/docs/ui-visual/sd-calendar.md +0 -34
  125. package/docs/ui-visual/sd-echarts.md +0 -32
  126. package/docs/ui-visual/sd-label.md +0 -24
  127. package/docs/ui-visual/sd-note.md +0 -23
  128. package/docs/ui-visual/sd-progress.md +0 -23
  129. package/docs/utils/inject-routing-signals.md +0 -161
  130. package/docs/utils/inject-sd-system-config-resource.md +0 -35
  131. package/docs/utils/mark.md +0 -43
  132. package/docs/utils/selection-managers.md +0 -96
  133. package/docs/utils/set-safe-style.md +0 -19
  134. package/docs/utils/setup-functions.md +0 -93
@@ -1,65 +0,0 @@
1
- # `SdMenu`
2
-
3
- 메뉴 트리 노드.
4
-
5
- ```typescript
6
- interface SdMenu {
7
- title: string;
8
- codeChain: string[];
9
- url?: string;
10
- icon?: string;
11
- children?: SdMenu[];
12
- }
13
- ```
14
-
15
- ## Fields
16
-
17
- | Field | Type | Description |
18
- |-------|------|-------------|
19
- | `title` | `string` | 메뉴 제목 |
20
- | `codeChain` | `string[]` | 코드 체인 (루트부터 현재까지) |
21
- | `url` | `string \| undefined` | 외부 URL |
22
- | `icon` | `string \| undefined` | 아이콘 |
23
- | `children` | `SdMenu[] \| undefined` | 하위 메뉴 |
24
-
25
- ## Related Types
26
-
27
- ### `SdFlatMenu`
28
-
29
- 플랫 메뉴 항목 (리프만).
30
-
31
- ```typescript
32
- interface SdFlatMenu<TModule = unknown> {
33
- titleChain: string[];
34
- codeChain: string[];
35
- modulesChain: TModule[][];
36
- }
37
- ```
38
-
39
- | Field | Type | Description |
40
- |-------|------|-------------|
41
- | `titleChain` | `string[]` | 타이틀 체인 |
42
- | `codeChain` | `string[]` | 코드 체인 |
43
- | `modulesChain` | `TModule[][]` | 모듈 체인 |
44
-
45
- ### `SdPermission`
46
-
47
- 권한 트리 노드.
48
-
49
- ```typescript
50
- interface SdPermission<TModule = unknown> {
51
- title: string;
52
- codeChain: string[];
53
- modules: TModule[] | undefined;
54
- perms: ("use" | "edit")[] | undefined;
55
- children: SdPermission<TModule>[] | undefined;
56
- }
57
- ```
58
-
59
- | Field | Type | Description |
60
- |-------|------|-------------|
61
- | `title` | `string` | 권한 제목 |
62
- | `codeChain` | `string[]` | 코드 체인 |
63
- | `modules` | `TModule[] \| undefined` | 모듈 제한 |
64
- | `perms` | `("use" \| "edit")[] \| undefined` | 권한 목록 |
65
- | `children` | `SdPermission<TModule>[] \| undefined` | 하위 권한 |
@@ -1,148 +0,0 @@
1
- # `SdModalContentDef`
2
-
3
- 모달 컴포넌트가 구현해야 하는 인터페이스.
4
-
5
- ```typescript
6
- interface SdModalContentDef<O> {
7
- initialized: Signal<boolean>;
8
- close: OutputEmitterRef<O | undefined>;
9
- actionTplRef?: TemplateRef<any>;
10
- readonly _optionalModalInputs?: string;
11
- }
12
- ```
13
-
14
- ## Fields
15
-
16
- | Field | Type | Description |
17
- |-------|------|-------------|
18
- | `initialized` | `Signal<boolean>` | 초기화 완료 여부 |
19
- | `close` | `OutputEmitterRef<O \| undefined>` | 닫기 output (결과 전달) |
20
- | `actionTplRef` | `TemplateRef<any> \| undefined` | 모달 헤더 액션 영역 템플릿 |
21
- | `_optionalModalInputs` | `string \| undefined` | optional로 취급할 input 키 목록 (리터럴 타입) |
22
-
23
- ## 구현 패턴
24
-
25
- ```typescript
26
- export class CustomerDetail implements SdModalContentDef<boolean | undefined> {
27
- initialized = signal(false);
28
- close = output<boolean | undefined>();
29
- actionTplRef?: TemplateRef<any>;
30
-
31
- private readonly _modalActionTpl = viewChild("modalActionTpl", { read: TemplateRef });
32
-
33
- constructor() {
34
- effect(() => {
35
- this.actionTplRef = this._modalActionTpl();
36
- });
37
- }
38
-
39
- protected async onSubmit(): Promise<void> {
40
- // ... (ORM upsert)
41
- this.close.emit(true);
42
- }
43
- }
44
- ```
45
-
46
- ## Related Types
47
-
48
- ### `SdModalInfo`
49
-
50
- 모달 생성 시 전달하는 정보.
51
-
52
- ```typescript
53
- interface SdModalInfo<T extends SdModalContentDef<any>, X extends keyof any = ""> {
54
- title: string;
55
- type: Type<T>;
56
- inputs: WithOptional<Omit<DirectiveInputSignals<T>, SdModalExcludeKeys | X>, ...>;
57
- }
58
- ```
59
-
60
- | Field | Type | Description |
61
- |-------|------|-------------|
62
- | `title` | `string` | 모달 제목 |
63
- | `type` | `Type<T>` | 모달 컴포넌트 타입 |
64
- | `inputs` | `object` | 컴포넌트 inputs (initialized, close, actionTplRef 제외) |
65
-
66
- ### `SdModalOptions`
67
-
68
- 모달 옵션.
69
-
70
- ```typescript
71
- interface SdModalOptions {
72
- key?: string;
73
- hideHeader?: boolean;
74
- hideCloseButton?: boolean;
75
- useCloseByBackdrop?: boolean;
76
- useCloseByEscapeKey?: boolean;
77
- float?: boolean;
78
- fill?: boolean;
79
- resizable?: boolean;
80
- movable?: boolean;
81
- position?: "bottom-right" | "top-right";
82
- minHeightPx?: number;
83
- minWidthPx?: number;
84
- heightPx?: number;
85
- widthPx?: number;
86
- headerStyle?: string;
87
- noFirstControlFocusing?: boolean;
88
- }
89
- ```
90
-
91
- | Field | Type | Description |
92
- |-------|------|-------------|
93
- | `key` | `string \| undefined` | 동일 키의 모달이 이미 열려 있으면 재사용 |
94
- | `hideHeader` | `boolean \| undefined` | 헤더 숨김 |
95
- | `hideCloseButton` | `boolean \| undefined` | 닫기 버튼 숨김 |
96
- | `useCloseByBackdrop` | `boolean \| undefined` | 배경 클릭으로 닫기 |
97
- | `useCloseByEscapeKey` | `boolean \| undefined` | ESC 키로 닫기 |
98
- | `float` | `boolean \| undefined` | 플로팅 모달 |
99
- | `fill` | `boolean \| undefined` | 전체 화면 채우기 |
100
- | `resizable` | `boolean \| undefined` | 크기 조절 가능 |
101
- | `movable` | `boolean \| undefined` | 이동 가능 |
102
- | `position` | `"bottom-right" \| "top-right" \| undefined` | 위치 프리셋 |
103
- | `minHeightPx` | `number \| undefined` | 최소 높이 (px) |
104
- | `minWidthPx` | `number \| undefined` | 최소 너비 (px) |
105
- | `heightPx` | `number \| undefined` | 높이 (px) |
106
- | `widthPx` | `number \| undefined` | 너비 (px) |
107
- | `headerStyle` | `string \| undefined` | 헤더 인라인 스타일 |
108
- | `noFirstControlFocusing` | `boolean \| undefined` | 첫 번째 컨트롤 자동 포커스 비활성화 |
109
-
110
- ### `SelectModalOutputResult`
111
-
112
- 모달 선택 결과.
113
-
114
- ```typescript
115
- interface SelectModalOutputResult<T> {
116
- selectedItemKeys: any[];
117
- selectedItems: T[];
118
- }
119
- ```
120
-
121
- | Field | Type | Description |
122
- |-------|------|-------------|
123
- | `selectedItemKeys` | `any[]` | 선택된 항목 키 배열 |
124
- | `selectedItems` | `T[]` | 선택된 항목 배열 |
125
-
126
- ### `SdSelectModal`
127
-
128
- 선택 모달 컴포넌트가 구현해야 하는 인터페이스. `SdModalContentDef<SelectModalOutputResult<T>>`를 확장한다.
129
-
130
- ```typescript
131
- interface SdSelectModal<T> extends SdModalContentDef<SelectModalOutputResult<T>> {
132
- selectMode: InputSignal<"single" | "multi" | undefined>;
133
- selectedItemKeys: InputSignal<any[]>;
134
- }
135
- ```
136
-
137
- | Field | Type | Description |
138
- |-------|------|-------------|
139
- | `selectMode` | `InputSignal<"single" \| "multi" \| undefined>` | 선택 모드 |
140
- | `selectedItemKeys` | `InputSignal<any[]>` | 이미 선택된 항목 키 배열 (복원용) |
141
-
142
- ### `SdSelectModalInfo`
143
-
144
- 모달 선택 정보.
145
-
146
- ```typescript
147
- type SdSelectModalInfo<T extends SdSelectModal<any>> = SdModalInfo<T, "selectMode" | "selectedItemKeys">
148
- ```
@@ -1,73 +0,0 @@
1
- # `SdToastContentDef`
2
-
3
- 커스텀 토스트 컴포넌트가 구현해야 하는 인터페이스.
4
-
5
- ```typescript
6
- interface SdToastContentDef<O> {
7
- close: OutputEmitterRef<O | undefined>;
8
- }
9
- ```
10
-
11
- ## Fields
12
-
13
- | Field | Type | Description |
14
- |-------|------|-------------|
15
- | `close` | `OutputEmitterRef<O \| undefined>` | 닫기 output |
16
-
17
- ## Related Types
18
-
19
- ### `SdToastInput`
20
-
21
- 커스텀 토스트 생성 입력.
22
-
23
- ```typescript
24
- interface SdToastInput<T extends SdToastContentDef<any>> {
25
- type: Type<T>;
26
- inputs: Omit<DirectiveInputSignals<T>, "close">;
27
- }
28
- ```
29
-
30
- ### `SdToastSeverity`
31
-
32
- ```typescript
33
- type SdToastSeverity = "info" | "success" | "warning" | "danger";
34
- ```
35
-
36
- ### `SdToastTheme`
37
-
38
- ```typescript
39
- type SdToastTheme = "primary" | "secondary" | SdToastSeverity | "gray" | "blue-gray";
40
- ```
41
-
42
- ### `SdBusyType`
43
-
44
- ```typescript
45
- type SdBusyType = "spinner" | "bar" | "cube";
46
- ```
47
-
48
- ## Related Types (Print)
49
-
50
- ### `SdPrint`
51
-
52
- 인쇄 컴포넌트가 구현해야 하는 인터페이스.
53
-
54
- ```typescript
55
- interface SdPrint {
56
- initialized: Signal<boolean>;
57
- readonly _optionalPrintInputs?: string;
58
- }
59
- ```
60
-
61
- | Field | Type | Description |
62
- |-------|------|-------------|
63
- | `initialized` | `Signal<boolean>` | 초기화 완료 여부 (true 될 때까지 대기 후 인쇄) |
64
- | `_optionalPrintInputs` | `string \| undefined` | optional로 취급할 input 키 목록 |
65
-
66
- ### `SdPrintInput`
67
-
68
- ```typescript
69
- interface SdPrintInput<T, X extends keyof any = ""> {
70
- type: Type<T>;
71
- inputs: WithOptional<Omit<DirectiveInputSignals<T>, "_optionalPrintInputs" | X>, ...>;
72
- }
73
- ```
@@ -1,59 +0,0 @@
1
- # `SharedDataBase`
2
-
3
- 공유 데이터 기본 인터페이스. 모든 공유 데이터 항목이 구현해야 한다.
4
-
5
- ```typescript
6
- interface SharedDataBase<TKey extends string | number> {
7
- __valueKey: TKey;
8
- __searchText: string;
9
- __isHidden: boolean;
10
- __parentKey?: TKey;
11
- }
12
- ```
13
-
14
- ## Fields
15
-
16
- | Field | Type | Description |
17
- |-------|------|-------------|
18
- | `__valueKey` | `TKey` | 고유 키 |
19
- | `__searchText` | `string` | 검색 대상 텍스트 |
20
- | `__isHidden` | `boolean` | 숨김 여부 |
21
- | `__parentKey` | `TKey \| undefined` | 부모 키 (트리 구조용) |
22
-
23
- ## Related Types
24
-
25
- ### `SharedDataInfo`
26
-
27
- 공유 데이터 등록 정보.
28
-
29
- ```typescript
30
- interface SharedDataInfo<T extends SharedDataBase<string | number>> {
31
- serviceKey: string;
32
- getter: (changeKeys?: (string | number)[]) => Promise<T[]>;
33
- filter?: unknown;
34
- orderBy?: (a: T, b: T) => number;
35
- }
36
- ```
37
-
38
- | Field | Type | Description |
39
- |-------|------|-------------|
40
- | `serviceKey` | `string` | ServiceClient 연결 키 |
41
- | `getter` | `(changeKeys?) => Promise<T[]>` | 데이터 조회 함수. changeKeys 전달 시 부분 조회 |
42
- | `filter` | `unknown` | 이벤트 필터 (같은 이름의 다른 필터 구분용) |
43
- | `orderBy` | `((a, b) => number) \| undefined` | 정렬 함수 |
44
-
45
- ### `SharedDataHandle`
46
-
47
- 공유 데이터 핸들. `SdSharedDataProvider.getHandle()`이 반환하는 객체.
48
-
49
- ```typescript
50
- interface SharedDataHandle<T extends SharedDataBase<string | number>> {
51
- items: Signal<T[]>;
52
- get(key: T["__valueKey"] | undefined): T | undefined;
53
- }
54
- ```
55
-
56
- | Field | Type | Description |
57
- |-------|------|-------------|
58
- | `items` | `Signal<T[]>` | 데이터 항목 signal |
59
- | `get(key)` | `(key) => T \| undefined` | 키로 항목 조회 |
@@ -1,34 +0,0 @@
1
- # `SdActivatedModalProvider`
2
-
3
- 모달 내부에서 inject하여 모달/컨텐츠 컴포넌트 참조를 얻는 프로바이더. `@Injectable()`로 모달별 인스턴스 생성.
4
-
5
- ```typescript
6
- @Injectable()
7
- class SdActivatedModalProvider<T extends SdModalContentDef<any> = SdModalContentDef<any>> {
8
- modalComponent = signal<any>(undefined);
9
- contentComponent = signal<T | undefined>(undefined);
10
- canDeactivateFn: () => boolean;
11
- }
12
- ```
13
-
14
- ## Members
15
-
16
- | Member | Kind | Type | Description |
17
- |--------|------|------|-------------|
18
- | `modalComponent` | property | `WritableSignal<any>` | SdModal 인스턴스 |
19
- | `contentComponent` | property | `WritableSignal<T \| undefined>` | 컨텐츠 컴포넌트 인스턴스 |
20
- | `canDeactivateFn` | property | `() => boolean` | 모달 닫기 가능 여부 판별 함수 (기본: `() => true`) |
21
-
22
- ## Usage
23
-
24
- 모달 내부 컴포넌트에서 `optional: true`로 inject하여 모달 컨텍스트를 확인한다. 타이틀 계산은 `injectViewTitleSignal()`이 내부에서 `SdActivatedModalProvider`를 자동으로 처리하므로 직접 inject할 필요가 없다:
25
-
26
- ```typescript
27
- // 타이틀 — injectViewTitleSignal()이 modal/page 분기를 자동 처리
28
- protected readonly viewTitle = injectViewTitleSignal();
29
-
30
- // canDeactivateFn 등 모달 컨텍스트가 직접 필요한 경우에만 inject
31
- private readonly _sdActivatedModal = inject(SdActivatedModalProvider, { optional: true });
32
- ```
33
-
34
- `optional: true`를 사용하는 이유: 동일 컴포넌트가 page 뷰로도 사용될 수 있으며, page 뷰에서는 `SdActivatedModalProvider`가 제공되지 않는다.
@@ -1,81 +0,0 @@
1
- # `SdAppStructureProvider`
2
-
3
- 앱 구조(메뉴/권한) 관리 프로바이더. 서브클래스 없이 직접 사용한다.
4
-
5
- ```typescript
6
- @Injectable({ providedIn: "root" })
7
- class SdAppStructureProvider<TModule = unknown> {
8
- readonly usableModules = signal<TModule[] | undefined>(undefined);
9
- readonly permRecord = signal<Record<string, boolean> | undefined>(undefined);
10
- readonly items = signal<AppStructureItem<TModule>[]>([]);
11
-
12
- usableMenus: Signal<SdMenu[]>;
13
- usableFlatMenus: Signal<SdFlatMenu<TModule>[]>;
14
-
15
- async initialize(serviceKey: string): Promise<void>;
16
- getPermissionsByStructure(items, codeChain?): SdPermission<TModule>[];
17
- getTitleByFullCode(fullCode: string): string;
18
- getItemChainByFullCode(fullCode: string): AppStructureItem<TModule>[];
19
- getPermsByFullCode<K extends string>(fullCodes: string[], permKeys: K[]): K[];
20
- }
21
- ```
22
-
23
- ## Members
24
-
25
- | Member | Kind | Type | Description |
26
- |--------|------|------|-------------|
27
- | `usableModules` | property | `WritableSignal<TModule[] \| undefined>` | 사용 가능한 모듈 목록. 외부에서 `set()`/`update()`로 설정 |
28
- | `permRecord` | property | `WritableSignal<Record<string, boolean> \| undefined>` | 권한 레코드. 외부에서 `set()`/`update()`로 설정 |
29
- | `items` | property | `WritableSignal<AppStructureItem<TModule>[]>` | 앱 구조 항목 배열 (`initialize()`로 초기화) |
30
- | `usableMenus` | computed | `Signal<SdMenu[]>` | 사용 가능한 메뉴 트리 |
31
- | `usableFlatMenus` | computed | `Signal<SdFlatMenu<TModule>[]>` | 사용 가능한 플랫 메뉴 |
32
- | `initialize(serviceKey)` | method | `(string) => Promise<void>` | 서비스에서 앱 구조 로드 |
33
- | `getTitleByFullCode(fullCode)` | method | `(string) => string` | fullCode로 타이틀 조회 |
34
- | `getItemChainByFullCode(fullCode)` | method | `(string) => AppStructureItem<TModule>[]` | fullCode로 항목 체인 조회 |
35
- | `getPermsByFullCode(fullCodes, permKeys)` | method | `(string[], K[]) => K[]` | fullCode 배열에서 보유 권한 키 반환 |
36
-
37
- ## Related Types
38
-
39
- ### `injectPermsSignal`
40
-
41
- 앱 구조(`SdAppStructureProvider`)에서 지정된 뷰 코드와 키 배열에 대한 권한을 조회하는 signal. 생성자/필드 이니셜라이저에서 호출한다.
42
-
43
- ```typescript
44
- function injectPermsSignal<K extends string>(viewCodes: string[], keys: K[]): Signal<K[]>
45
- ```
46
-
47
- | Parameter | Type | Description |
48
- |-----------|------|-------------|
49
- | `viewCodes` | `string[]` | 조회할 뷰 코드 배열 (예: `["sales.customer"]`) |
50
- | `keys` | `K[]` | 권한 키 배열 (예: `["use", "edit"]`) |
51
-
52
- 반환: 현재 사용자가 보유한 권한 키 배열의 signal
53
-
54
- #### 사용 패턴
55
-
56
- ```typescript
57
- protected readonly perms = injectPermsSignal(["sales.customer"], ["use", "edit"]);
58
- protected readonly canEdit = computed(() => this.perms().includes("edit"));
59
- ```
60
-
61
- ```html
62
- @if (!perms().includes("use")) {
63
- <sd-note theme="warning">이 화면의 사용 권한이 없습니다.</sd-note>
64
- }
65
- ```
66
-
67
- ### `SdAppStructureUtils`
68
-
69
- 앱 구조 유틸리티. 정적 메서드로 메뉴/권한 조회 로직을 제공한다.
70
-
71
- ```typescript
72
- abstract class SdAppStructureUtils {
73
- static getTitleByFullCode<TModule>(items, fullCode): string;
74
- static getPermsByFullCode<TModule, K extends string>(items, fullCodes, permKeys, permRecord): K[];
75
- static getItemChainByFullCode<TModule>(items, fullCode): AppStructureItem<TModule>[];
76
- static getMenus<TModule>(items, codeChain, usableModules, permRecord): SdMenu[];
77
- static getFlatMenus<TModule>(items, usableModules, permRecord): SdFlatMenu<TModule>[];
78
- static getPermissions<TModule>(items, codeChain, usableModules): SdPermission<TModule>[];
79
- static getFlatPermissions<TModule>(items, usableModules): FlatPermission<TModule>[];
80
- }
81
- ```
@@ -1,18 +0,0 @@
1
- # `SdBusyProvider`
2
-
3
- 글로벌 busy 상태 관리 프로바이더.
4
-
5
- ```typescript
6
- @Injectable({ providedIn: "root" })
7
- class SdBusyProvider {
8
- type = signal<SdBusyType>("bar");
9
- globalBusyCount = signal(0);
10
- }
11
- ```
12
-
13
- ## Members
14
-
15
- | Member | Kind | Type | Description |
16
- |--------|------|------|-------------|
17
- | `type` | property | `WritableSignal<SdBusyType>` | busy 표시 유형 (`"spinner" \| "bar" \| "cube"`) |
18
- | `globalBusyCount` | property | `WritableSignal<number>` | 글로벌 busy 카운트 (0보다 크면 busy 표시) |
@@ -1,40 +0,0 @@
1
- # `SdFileDialogProvider`
2
-
3
- 네이티브 파일 선택 대화상자 프로바이더.
4
-
5
- ```typescript
6
- @Injectable({ providedIn: "root" })
7
- class SdFileDialogProvider {
8
- async showAsync(multiple?: false, accept?: string): Promise<File | undefined>;
9
- async showAsync(multiple: true, accept?: string): Promise<File[] | undefined>;
10
- }
11
- ```
12
-
13
- ## Members
14
-
15
- | Member | Kind | Type | Description |
16
- |--------|------|------|-------------|
17
- | `showAsync(multiple?, accept?)` | method | overloaded | 파일 선택 대화상자 열기. `multiple=true`이면 `File[]`, 아니면 `File \| undefined` 반환 |
18
-
19
- ## Parameters
20
-
21
- | Param | Type | Description |
22
- |-------|------|-------------|
23
- | `multiple` | `boolean \| undefined` | 다중 선택 여부 |
24
- | `accept` | `string \| undefined` | 허용 파일 타입 (예: `"image/*"`, `".xlsx"`) |
25
-
26
- ## Usage
27
-
28
- 엑셀 파일 업로드 시 단일 파일을 선택받는 패턴:
29
-
30
- ```typescript
31
- private readonly _sdFileDialog = inject(SdFileDialogProvider);
32
-
33
- async onUploadExcelButtonClick(): Promise<void> {
34
- const file = await this._sdFileDialog.showAsync(false, ".xlsx");
35
- if (file == null) return;
36
- if (Array.isArray(file)) return;
37
-
38
- // file: File 객체
39
- }
40
- ```
@@ -1,20 +0,0 @@
1
- # `SdLocalStorageProvider`
2
-
3
- `clientName` 스코프 localStorage 래퍼. 키가 `{clientName}.{key}` 형태로 저장된다.
4
-
5
- ```typescript
6
- @Injectable({ providedIn: "root" })
7
- class SdLocalStorageProvider<T> {
8
- set<K extends keyof T & string>(key: K, value: T[K]): void;
9
- get<K extends keyof T & string>(key: K): T[K] | undefined;
10
- remove(key: keyof T & string): void;
11
- }
12
- ```
13
-
14
- ## Members
15
-
16
- | Member | Kind | Type | Description |
17
- |--------|------|------|-------------|
18
- | `set(key, value)` | method | `(K, T[K]) => void` | 값 저장 |
19
- | `get(key)` | method | `(K) => T[K] \| undefined` | 값 조회 |
20
- | `remove(key)` | method | `(keyof T & string) => void` | 값 삭제 |
@@ -1,67 +0,0 @@
1
- # `SdModalProvider`
2
-
3
- 프로그래밍 방식으로 모달을 생성하는 프로바이더.
4
-
5
- ```typescript
6
- @Injectable({ providedIn: "root" })
7
- class SdModalProvider {
8
- modalCount = signal(0);
9
-
10
- async showAsync<T extends SdModalContentDef<any>>(
11
- modal: SdModalInfo<T>,
12
- options?: SdModalOptions,
13
- ): Promise<Parameters<T["close"]["emit"]>[0] | undefined>;
14
- }
15
- ```
16
-
17
- ## Members
18
-
19
- | Member | Kind | Type | Description |
20
- |--------|------|------|-------------|
21
- | `modalCount` | property | `WritableSignal<number>` | 현재 열린 모달 수 |
22
- | `showAsync(modal, options?)` | method | `(SdModalInfo<T>, SdModalOptions?) => Promise<...>` | 모달 생성 후 close 결과를 Promise로 반환 |
23
-
24
- ## Usage
25
-
26
- ### 선택 모달 호출
27
-
28
- ```typescript
29
- private readonly _sdModal = inject(SdModalProvider);
30
-
31
- const result = await this._sdModal.showAsync({
32
- title: "고객 선택",
33
- type: CustomerList,
34
- inputs: {
35
- selectMode: "multi",
36
- selectedItemKeys: this.selectedCustomerIds(),
37
- },
38
- });
39
- if (result != null) {
40
- // result.selectedItemKeys: any[]
41
- // result.selectedItems: ICustomer[]
42
- }
43
- ```
44
-
45
- ### 편집 모달 호출
46
-
47
- ```typescript
48
- private async _editItem(item?: ICustomer): Promise<void> {
49
- const r = await this._sdModal.showAsync({
50
- title: item == null ? "고객 등록" : "고객 수정",
51
- type: CustomerEditModal,
52
- inputs: { itemId: item?.id },
53
- });
54
- if (r != null) await this._refresh();
55
- }
56
- ```
57
-
58
- ### 조회 전용 modal 호출
59
-
60
- ```typescript
61
- await this._sdModal.showAsync({
62
- title: "고객 주문 이력",
63
- type: CustomerOrderHistoryModal,
64
- inputs: { customerId: 123 },
65
- });
66
- // 반환값 미사용 — 닫기는 SdModal 기본 "X" 버튼
67
- ```
@@ -1,18 +0,0 @@
1
- # `SdNavigateWindowProvider`
2
-
3
- 새 윈도우 네비게이션 + 자동 닫기 프로바이더.
4
-
5
- ```typescript
6
- @Injectable({ providedIn: "root" })
7
- class SdNavigateWindowProvider {
8
- get isWindow(): boolean;
9
- open(navigate: string, params?: Record<string, string>, features?: string): void;
10
- }
11
- ```
12
-
13
- ## Members
14
-
15
- | Member | Kind | Type | Description |
16
- |--------|------|------|-------------|
17
- | `isWindow` | getter | `boolean` | 현재 페이지가 팝업 윈도우인지 여부 |
18
- | `open(navigate, params?, features?)` | method | `(string, Record<string,string>?, string?) => void` | 새 윈도우 열기. `features` 지정 시 팝업, 미지정 시 새 탭 |
@@ -1,25 +0,0 @@
1
- # `SdPrintProvider`
2
-
3
- 인쇄 및 PDF 생성 프로바이더. jsPDF + html-to-image 사용.
4
-
5
- ```typescript
6
- @Injectable({ providedIn: "root" })
7
- class SdPrintProvider {
8
- async printAsync<T extends SdPrint>(
9
- template: SdPrintInput<T>,
10
- options?: { size?: string; margin?: string },
11
- ): Promise<void>;
12
-
13
- async getPdfBufferAsync<T extends SdPrint>(
14
- template: SdPrintInput<T>,
15
- options?: { orientation?: "portrait" | "landscape"; pageSize?: string },
16
- ): Promise<Uint8Array>;
17
- }
18
- ```
19
-
20
- ## Members
21
-
22
- | Member | Kind | Type | Description |
23
- |--------|------|------|-------------|
24
- | `printAsync(template, options?)` | method | `(...) => Promise<void>` | 브라우저 인쇄 대화상자 열기. `size` 기본값 `"A4 auto"`, `margin` 기본값 `"0"` |
25
- | `getPdfBufferAsync(template, options?)` | method | `(...) => Promise<Uint8Array>` | PDF 바이너리 생성. `.page` 클래스 요소 단위로 페이지 분할 |