@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.
- package/dist/data/sheet/sd-sheet.d.ts +9 -12
- package/dist/data/sheet/sd-sheet.d.ts.map +1 -1
- package/dist/data/sheet/sd-sheet.js +150 -168
- package/dist/data/sheet/types.d.ts +1 -0
- package/dist/data/sheet/types.d.ts.map +1 -1
- package/dist/data/sheet/useSheetCellStyling.d.ts +2 -2
- package/dist/data/sheet/useSheetCellStyling.d.ts.map +1 -1
- package/dist/data/sheet/useSheetCellStyling.js +20 -12
- package/dist/data/sheet/useSheetColumnFixing.d.ts +3 -8
- package/dist/data/sheet/useSheetColumnFixing.d.ts.map +1 -1
- package/dist/data/sheet/useSheetColumnFixing.js +19 -27
- package/dist/data/sheet/useSheetLayoutEngine.d.ts.map +1 -1
- package/dist/data/sheet/useSheetLayoutEngine.js +4 -1
- package/dist/layout/dock/sd-dock-container.d.ts.map +1 -1
- package/dist/layout/dock/sd-dock-container.js +3 -3
- package/package.json +7 -8
- package/src/data/sheet/sd-sheet.ts +39 -60
- package/src/data/sheet/types.ts +1 -0
- package/src/data/sheet/useSheetCellStyling.ts +19 -11
- package/src/data/sheet/useSheetColumnFixing.ts +21 -28
- package/src/data/sheet/useSheetLayoutEngine.ts +4 -1
- package/src/layout/dock/sd-dock-container.ts +1 -0
- package/README.md +0 -476
- package/docs/bootstrap/provide-sd-angular.md +0 -37
- package/docs/bootstrap/sd-angular-config-provider.md +0 -16
- package/docs/directives/sd-command-directive.md +0 -30
- package/docs/directives/sd-events.md +0 -25
- package/docs/directives/sd-intersection-directive.md +0 -36
- package/docs/directives/sd-invalid.md +0 -24
- package/docs/directives/sd-resize-directive.md +0 -42
- package/docs/directives/sd-ripple.md +0 -23
- package/docs/directives/sd-router-link.md +0 -38
- package/docs/directives/sd-show-effect.md +0 -18
- package/docs/directives/sd-typed-template.md +0 -69
- package/docs/features/sd-address-search-modal.md +0 -50
- package/docs/features/sd-permission-table.md +0 -20
- package/docs/features/sd-shared-data-components.md +0 -158
- package/docs/features/sd-tiptap-editor.md +0 -26
- package/docs/pipes/format-pipe.md +0 -41
- package/docs/plugins/sd-global-error-handler.md +0 -23
- package/docs/plugins/sd-option-event-plugin.md +0 -34
- package/docs/provider-types/sd-menu.md +0 -65
- package/docs/provider-types/sd-modal-content-def.md +0 -148
- package/docs/provider-types/sd-toast-content-def.md +0 -73
- package/docs/provider-types/shared-data-base.md +0 -59
- package/docs/providers/sd-activated-modal-provider.md +0 -34
- package/docs/providers/sd-app-structure-provider.md +0 -81
- package/docs/providers/sd-busy-provider.md +0 -18
- package/docs/providers/sd-file-dialog-provider.md +0 -40
- package/docs/providers/sd-local-storage-provider.md +0 -20
- package/docs/providers/sd-modal-provider.md +0 -67
- package/docs/providers/sd-navigate-window-provider.md +0 -18
- package/docs/providers/sd-print-provider.md +0 -25
- package/docs/providers/sd-service-client-factory-provider.md +0 -43
- package/docs/providers/sd-shared-data-provider.md +0 -64
- package/docs/providers/sd-system-config-provider.md +0 -46
- package/docs/providers/sd-system-log-provider.md +0 -18
- package/docs/providers/sd-theme-provider.md +0 -38
- package/docs/providers/sd-toast-provider.md +0 -65
- package/docs/recipes/_common-rules.md +0 -244
- package/docs/recipes/crud-detail/extension-a-edit-save.md +0 -230
- package/docs/recipes/crud-detail/extension-b-delete-restore.md +0 -142
- package/docs/recipes/crud-detail/extension-c-modal-view.md +0 -214
- package/docs/recipes/crud-detail/extension-d-control-view.md +0 -103
- package/docs/recipes/crud-detail/extension-e-auxiliary.md +0 -87
- package/docs/recipes/crud-detail/extension-f-complex-detail.md +0 -234
- package/docs/recipes/crud-detail.md +0 -353
- package/docs/recipes/crud-list/extension-a-inline-edit.md +0 -410
- package/docs/recipes/crud-list/extension-b-selection.md +0 -226
- package/docs/recipes/crud-list/extension-c-inline-delete.md +0 -87
- package/docs/recipes/crud-list/extension-d-select-modal.md +0 -207
- package/docs/recipes/crud-list/extension-e-readonly-modal.md +0 -165
- package/docs/recipes/crud-list/extension-f-modal-edit.md +0 -177
- package/docs/recipes/crud-list/extension-g-excel.md +0 -157
- package/docs/recipes/crud-list.md +0 -446
- package/docs/recipes/data-select-button.md +0 -412
- package/docs/recipes/page-modal-container.md +0 -260
- package/docs/styling/classes.md +0 -149
- package/docs/styling/mixins.md +0 -100
- package/docs/styling/themes.md +0 -35
- package/docs/styling/variables.md +0 -147
- package/docs/type-utilities/directive-input-signals.md +0 -232
- package/docs/ui-data/sd-list.md +0 -37
- package/docs/ui-data/sd-sheet.md +0 -227
- package/docs/ui-form/sd-additional-button.md +0 -26
- package/docs/ui-form/sd-anchor.md +0 -31
- package/docs/ui-form/sd-button.md +0 -105
- package/docs/ui-form/sd-checkbox-group.md +0 -39
- package/docs/ui-form/sd-checkbox.md +0 -81
- package/docs/ui-form/sd-date-range-picker.md +0 -27
- package/docs/ui-form/sd-form.md +0 -89
- package/docs/ui-form/sd-modal-select-button.md +0 -54
- package/docs/ui-form/sd-numpad.md +0 -26
- package/docs/ui-form/sd-range.md +0 -26
- package/docs/ui-form/sd-select.md +0 -68
- package/docs/ui-form/sd-shared-data-select.md +0 -52
- package/docs/ui-form/sd-state-preset.md +0 -37
- package/docs/ui-form/sd-switch.md +0 -27
- package/docs/ui-form/sd-textarea.md +0 -33
- package/docs/ui-form/sd-textfield.md +0 -145
- package/docs/ui-layout/sd-dock-container.md +0 -64
- package/docs/ui-layout/sd-dock.md +0 -37
- package/docs/ui-layout/sd-gap.md +0 -26
- package/docs/ui-layout/sd-kanban-board.md +0 -96
- package/docs/ui-layout/sd-kanban-lane.md +0 -34
- package/docs/ui-layout/sd-kanban.md +0 -29
- package/docs/ui-navigation/sd-collapse.md +0 -35
- package/docs/ui-navigation/sd-pagination.md +0 -26
- package/docs/ui-navigation/sd-sidebar-container.md +0 -49
- package/docs/ui-navigation/sd-sidebar-menu.md +0 -22
- package/docs/ui-navigation/sd-sidebar-user.md +0 -43
- package/docs/ui-navigation/sd-tab.md +0 -51
- package/docs/ui-navigation/sd-topbar-container.md +0 -97
- package/docs/ui-navigation/sd-topbar-menu.md +0 -23
- package/docs/ui-navigation/sd-topbar-user.md +0 -38
- package/docs/ui-navigation/sd-topbar.md +0 -30
- package/docs/ui-overlay/sd-busy-container.md +0 -69
- package/docs/ui-overlay/sd-confirm-modal.md +0 -30
- package/docs/ui-overlay/sd-dropdown.md +0 -40
- package/docs/ui-overlay/sd-modal.md +0 -34
- package/docs/ui-overlay/sd-prompt-modal.md +0 -30
- package/docs/ui-overlay/sd-toast.md +0 -35
- package/docs/ui-visual/sd-barcode.md +0 -36
- package/docs/ui-visual/sd-calendar.md +0 -34
- package/docs/ui-visual/sd-echarts.md +0 -32
- package/docs/ui-visual/sd-label.md +0 -24
- package/docs/ui-visual/sd-note.md +0 -23
- package/docs/ui-visual/sd-progress.md +0 -23
- package/docs/utils/inject-routing-signals.md +0 -161
- package/docs/utils/inject-sd-system-config-resource.md +0 -35
- package/docs/utils/mark.md +0 -43
- package/docs/utils/selection-managers.md +0 -96
- package/docs/utils/set-safe-style.md +0 -19
- 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` 클래스 요소 단위로 페이지 분할 |
|