@simplysm/sd-claude 14.0.47 → 14.0.49

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 (130) hide show
  1. package/{claude/references/sd-simplysm14/sd-claude/usage.md → README.md} +2 -2
  2. package/claude/rules/sd-claude-rules.md +25 -10
  3. package/claude/rules/sd-options.md +11 -6
  4. package/claude/sd-subagent-start.sh +6 -0
  5. package/claude/settings.json +1 -12
  6. package/claude/skills/sd-check/SKILL.md +43 -12
  7. package/claude/skills/sd-claude-docs/SKILL.md +30 -58
  8. package/claude/skills/sd-claude-docs/references/package-claudemd.md +12 -0
  9. package/claude/skills/sd-claude-docs/references/package-doc-gen.md +26 -13
  10. package/claude/skills/sd-commit/SKILL.md +1 -1
  11. package/claude/skills/sd-debug/SKILL.md +5 -3
  12. package/claude/skills/sd-deliverable/SKILL.md +1 -1
  13. package/claude/skills/sd-dev/SKILL.md +14 -9
  14. package/claude/skills/sd-doc-extract/SKILL.md +8 -10
  15. package/claude/skills/sd-doc-extract/_common.py +8 -1
  16. package/claude/skills/sd-doc-extract/_extract_docx.py +74 -34
  17. package/claude/skills/sd-doc-extract/_extract_pdf.py +12 -1
  18. package/claude/skills/sd-doc-extract/_extract_pptx.py +103 -23
  19. package/claude/skills/sd-doc-extract/_extract_xlsb.py +93 -4
  20. package/claude/skills/sd-doc-extract/_extract_xlsx.py +98 -36
  21. package/claude/skills/sd-doc-extract/extract.py +22 -3
  22. package/claude/skills/sd-inner-clarify/SKILL.md +78 -0
  23. package/claude/skills/sd-inner-debug/SKILL.md +1 -1
  24. package/claude/skills/sd-inner-review/SKILL.md +13 -0
  25. package/claude/skills/sd-issue/SKILL.md +1 -1
  26. package/claude/skills/sd-outlook/SKILL.md +1 -1
  27. package/claude/skills/sd-plan/SKILL.md +50 -17
  28. package/claude/skills/sd-prompt/SKILL.md +180 -178
  29. package/claude/skills/sd-prompt/references/eval-runner.md +5 -30
  30. package/claude/skills/sd-prompt/references/sd-eval-env-template.md +23 -0
  31. package/claude/skills/sd-refactor/SKILL.md +2 -2
  32. package/claude/skills/sd-tdd/SKILL.md +45 -16
  33. package/claude/skills/sd-use/SKILL.md +84 -80
  34. package/claude/skills/sd-wbs/SKILL.md +84 -27
  35. package/{claude/references/sd-simplysm14/sd-claude/docs → docs}/assets.md +2 -3
  36. package/{claude/references/sd-simplysm14/sd-claude/docs → docs}/hooks.md +7 -6
  37. package/{claude/references/sd-simplysm14/sd-claude/docs → docs}/scripts.md +1 -9
  38. package/package.json +3 -2
  39. package/scripts/sync.mjs +4 -2
  40. package/claude/references/sd-simplysm14/angular/docs/bootstrap.md +0 -48
  41. package/claude/references/sd-simplysm14/angular/docs/directives.md +0 -236
  42. package/claude/references/sd-simplysm14/angular/docs/features.md +0 -379
  43. package/claude/references/sd-simplysm14/angular/docs/pipes.md +0 -32
  44. package/claude/references/sd-simplysm14/angular/docs/plugins.md +0 -37
  45. package/claude/references/sd-simplysm14/angular/docs/provider-types.md +0 -283
  46. package/claude/references/sd-simplysm14/angular/docs/providers.md +0 -379
  47. package/claude/references/sd-simplysm14/angular/docs/styling.md +0 -222
  48. package/claude/references/sd-simplysm14/angular/docs/type-utilities.md +0 -250
  49. package/claude/references/sd-simplysm14/angular/docs/ui-data.md +0 -275
  50. package/claude/references/sd-simplysm14/angular/docs/ui-form.md +0 -490
  51. package/claude/references/sd-simplysm14/angular/docs/ui-layout.md +0 -140
  52. package/claude/references/sd-simplysm14/angular/docs/ui-navigation.md +0 -273
  53. package/claude/references/sd-simplysm14/angular/docs/ui-overlay.md +0 -157
  54. package/claude/references/sd-simplysm14/angular/docs/ui-visual.md +0 -127
  55. package/claude/references/sd-simplysm14/angular/docs/utils.md +0 -295
  56. package/claude/references/sd-simplysm14/angular/usage.md +0 -489
  57. package/claude/references/sd-simplysm14/capacitor-plugin-auto-update/usage.md +0 -182
  58. package/claude/references/sd-simplysm14/capacitor-plugin-file-system/docs/file-operations.md +0 -154
  59. package/claude/references/sd-simplysm14/capacitor-plugin-file-system/docs/permissions.md +0 -84
  60. package/claude/references/sd-simplysm14/capacitor-plugin-file-system/docs/storage-paths.md +0 -107
  61. package/claude/references/sd-simplysm14/capacitor-plugin-file-system/docs/types.md +0 -83
  62. package/claude/references/sd-simplysm14/capacitor-plugin-file-system/usage.md +0 -133
  63. package/claude/references/sd-simplysm14/capacitor-plugin-intent/usage.md +0 -203
  64. package/claude/references/sd-simplysm14/capacitor-plugin-usb-storage/usage.md +0 -258
  65. package/claude/references/sd-simplysm14/core-browser/usage.md +0 -306
  66. package/claude/references/sd-simplysm14/core-common/docs/errors.md +0 -82
  67. package/claude/references/sd-simplysm14/core-common/docs/extensions.md +0 -167
  68. package/claude/references/sd-simplysm14/core-common/docs/features.md +0 -136
  69. package/claude/references/sd-simplysm14/core-common/docs/types.md +0 -245
  70. package/claude/references/sd-simplysm14/core-common/docs/utils.md +0 -591
  71. package/claude/references/sd-simplysm14/core-common/usage.md +0 -255
  72. package/claude/references/sd-simplysm14/core-node/docs/child-process.md +0 -182
  73. package/claude/references/sd-simplysm14/core-node/docs/features.md +0 -214
  74. package/claude/references/sd-simplysm14/core-node/docs/file-system.md +0 -509
  75. package/claude/references/sd-simplysm14/core-node/docs/file-watching.md +0 -139
  76. package/claude/references/sd-simplysm14/core-node/docs/logging.md +0 -180
  77. package/claude/references/sd-simplysm14/core-node/docs/path.md +0 -176
  78. package/claude/references/sd-simplysm14/core-node/docs/utilities-cpx.md +0 -194
  79. package/claude/references/sd-simplysm14/core-node/docs/utilities-fsx.md +0 -469
  80. package/claude/references/sd-simplysm14/core-node/docs/utilities-pathx.md +0 -151
  81. package/claude/references/sd-simplysm14/core-node/docs/worker-threads.md +0 -334
  82. package/claude/references/sd-simplysm14/core-node/docs/worker.md +0 -205
  83. package/claude/references/sd-simplysm14/core-node/usage.md +0 -259
  84. package/claude/references/sd-simplysm14/excel/docs/core-classes.md +0 -453
  85. package/claude/references/sd-simplysm14/excel/docs/types.md +0 -459
  86. package/claude/references/sd-simplysm14/excel/docs/utilities.md +0 -194
  87. package/claude/references/sd-simplysm14/excel/docs/wrapper.md +0 -73
  88. package/claude/references/sd-simplysm14/excel/usage.md +0 -134
  89. package/claude/references/sd-simplysm14/lint/usage.md +0 -130
  90. package/claude/references/sd-simplysm14/orm-common/docs/core.md +0 -188
  91. package/claude/references/sd-simplysm14/orm-common/docs/expression.md +0 -190
  92. package/claude/references/sd-simplysm14/orm-common/docs/models.md +0 -17
  93. package/claude/references/sd-simplysm14/orm-common/docs/query-builder.md +0 -97
  94. package/claude/references/sd-simplysm14/orm-common/docs/queryable-executable.md +0 -250
  95. package/claude/references/sd-simplysm14/orm-common/docs/schema-builders.md +0 -364
  96. package/claude/references/sd-simplysm14/orm-common/docs/types.md +0 -522
  97. package/claude/references/sd-simplysm14/orm-common/usage.md +0 -229
  98. package/claude/references/sd-simplysm14/orm-node/docs/connections.md +0 -137
  99. package/claude/references/sd-simplysm14/orm-node/docs/core.md +0 -131
  100. package/claude/references/sd-simplysm14/orm-node/docs/types.md +0 -173
  101. package/claude/references/sd-simplysm14/orm-node/usage.md +0 -143
  102. package/claude/references/sd-simplysm14/sd-cli/usage.md +0 -782
  103. package/claude/references/sd-simplysm14/service-client/docs/features.md +0 -217
  104. package/claude/references/sd-simplysm14/service-client/docs/main.md +0 -148
  105. package/claude/references/sd-simplysm14/service-client/docs/protocol.md +0 -53
  106. package/claude/references/sd-simplysm14/service-client/docs/transport.md +0 -131
  107. package/claude/references/sd-simplysm14/service-client/docs/types.md +0 -129
  108. package/claude/references/sd-simplysm14/service-client/usage.md +0 -202
  109. package/claude/references/sd-simplysm14/service-common/docs/app-structure.md +0 -175
  110. package/claude/references/sd-simplysm14/service-common/docs/events.md +0 -64
  111. package/claude/references/sd-simplysm14/service-common/docs/protocol.md +0 -331
  112. package/claude/references/sd-simplysm14/service-common/docs/service-types.md +0 -90
  113. package/claude/references/sd-simplysm14/service-common/docs/types.md +0 -19
  114. package/claude/references/sd-simplysm14/service-common/usage.md +0 -154
  115. package/claude/references/sd-simplysm14/service-server/docs/auth.md +0 -64
  116. package/claude/references/sd-simplysm14/service-server/docs/core.md +0 -174
  117. package/claude/references/sd-simplysm14/service-server/docs/legacy.md +0 -25
  118. package/claude/references/sd-simplysm14/service-server/docs/main.md +0 -88
  119. package/claude/references/sd-simplysm14/service-server/docs/protocol.md +0 -33
  120. package/claude/references/sd-simplysm14/service-server/docs/services.md +0 -94
  121. package/claude/references/sd-simplysm14/service-server/docs/transport-http.md +0 -93
  122. package/claude/references/sd-simplysm14/service-server/docs/transport-socket.md +0 -119
  123. package/claude/references/sd-simplysm14/service-server/docs/types.md +0 -36
  124. package/claude/references/sd-simplysm14/service-server/docs/utils.md +0 -22
  125. package/claude/references/sd-simplysm14/service-server/usage.md +0 -171
  126. package/claude/references/sd-simplysm14/storage/usage.md +0 -301
  127. package/claude/references/sd-simplysm14.md +0 -35
  128. package/claude/rules/sd-clarify.md +0 -23
  129. package/claude/sd-session-start.sh +0 -10
  130. /package/{claude/references/sd-simplysm14/sd-claude/docs → docs}/cli.md +0 -0
@@ -1,236 +0,0 @@
1
- # Directives
2
-
3
- ## `SdEvents`
4
-
5
- `.capture`, `.passive`, `.once` 수식어 및 커스텀 이벤트 바인딩을 지원하는 디렉티브. Angular 템플릿에서 해당 이벤트를 사용할 때 자동 매칭된다.
6
-
7
- ```typescript
8
- @Directive({
9
- selector: `[click.capture], [scroll.passive], ...`,
10
- })
11
- class SdEvents {
12
- // 클릭: click.capture, click.once, click.capture.once
13
- // 마우스: mousedown.capture, mouseup.capture, mouseover.capture, mouseout.capture
14
- // 키보드: keydown.capture, keyup.capture
15
- // 포커스: focus.capture, blur.capture
16
- // 폼: invalid.capture
17
- // 스크롤: scroll.capture, scroll.passive, scroll.capture.passive
18
- // 휠: wheel.passive, wheel.capture.passive
19
- // 터치: touchstart.passive, touchstart.capture.passive, touchmove.passive, touchmove.capture.passive, touchend.passive
20
- // 드래그: dragover.capture, dragenter.capture, dragleave.capture, drop.capture
21
- // 애니메이션: transitionend.once, animationend.once
22
- }
23
- ```
24
-
25
- > **NOTE:** `sdResize`, `sdSaveCommand`, `sdRefreshCommand`, `sdInsertCommand`는 `SdEvents`에서 분리되어 각각 `SdResizeDirective`, `SdIntersectionDirective`, `SdCommandDirective`로 독립 디렉티브로 제공된다.
26
-
27
- ## `SdRipple`
28
-
29
- 호스트 요소에 리플 효과를 추가하는 디렉티브.
30
-
31
- ```typescript
32
- @Directive({ selector: "[sdRipple]" })
33
- class SdRipple {
34
- enabled = input.required({ alias: "sdRipple", transform: booleanAttribute });
35
- }
36
- ```
37
-
38
- 사용법: `<div [sdRipple]="true">` 또는 `<div sdRipple>`
39
-
40
- ## `SdShowEffect`
41
-
42
- 뷰포트에 진입할 때 reveal 애니메이션을 적용하는 디렉티브. IntersectionObserver 사용.
43
-
44
- ```typescript
45
- @Directive({ selector: "[sdShowEffect]" })
46
- class SdShowEffect {
47
- enabled = input.required({ alias: "sdShowEffect", transform: booleanAttribute });
48
- sdShowEffectType = input<"l2r" | "t2b">("t2b");
49
- }
50
- ```
51
-
52
- | Input | Type | Default | Description |
53
- |-------|------|---------|-------------|
54
- | `sdShowEffect` | `boolean` | required | 효과 활성화 여부 |
55
- | `sdShowEffectType` | `"l2r" \| "t2b"` | `"t2b"` | 애니메이션 방향 (좌->우 / 위->아래) |
56
-
57
- ## `SdInvalid`
58
-
59
- 호스트 요소에 유효성 검증 표시기를 추가하는 디렉티브. 빨간 점 표시기와 숨겨진 input으로 구성.
60
-
61
- ```typescript
62
- @Directive({ selector: "[sdInvalid]" })
63
- class SdInvalid {
64
- invalidMessage = input.required<string>({ alias: "sdInvalid" });
65
- }
66
- ```
67
-
68
- 사용법: `<div [sdInvalid]="name이 비어있습니다">`. 메시지가 빈 문자열이면 유효, 비어있지 않으면 무효.
69
-
70
- ## `SdTypedTemplate`
71
-
72
- `ng-template`의 컨텍스트 타입을 지정하는 디렉티브. 타입 가드를 통해 템플릿 내부에서 정확한 타입을 사용할 수 있다.
73
-
74
- ```typescript
75
- @Directive({ selector: "ng-template[typed]" })
76
- class SdTypedTemplate<T> {
77
- typed = input.required<T>();
78
-
79
- static ngTemplateContextGuard<TypeToken>(
80
- _dir: SdTypedTemplate<TypeToken>,
81
- _ctx: unknown,
82
- ): _ctx is TypeToken;
83
- }
84
- ```
85
-
86
- 사용법:
87
- ```html
88
- <ng-template [typed]="typedVar" let-item>
89
- <!-- item의 타입이 typeof typedVar -->
90
- </ng-template>
91
- ```
92
-
93
- ## `SdItemOfTemplate`
94
-
95
- 항목 반복 템플릿의 컨텍스트 타입을 지정하는 디렉티브.
96
-
97
- ```typescript
98
- @Directive({ selector: "ng-template[itemOf]" })
99
- class SdItemOfTemplate<TItem> {
100
- itemOf = input.required<TItem[]>();
101
-
102
- static ngTemplateContextGuard<TContextItem>(
103
- _dir: SdItemOfTemplate<TContextItem>,
104
- _ctx: unknown,
105
- ): _ctx is SdItemOfTemplateContext<TContextItem>;
106
- }
107
- ```
108
-
109
- ## `SdItemOfTemplateContext`
110
-
111
- itemOf 템플릿 컨텍스트.
112
-
113
- ```typescript
114
- interface SdItemOfTemplateContext<TItem> {
115
- $implicit: TItem;
116
- item: TItem;
117
- index: number;
118
- depth: number;
119
- }
120
- ```
121
-
122
- | Field | Type | Description |
123
- |-------|------|-------------|
124
- | `$implicit` | `TItem` | 현재 항목 (let-item으로 접근) |
125
- | `item` | `TItem` | 현재 항목 (명시적 접근) |
126
- | `index` | `number` | 인덱스 |
127
- | `depth` | `number` | 깊이 (트리 구조에서 사용) |
128
-
129
- 사용법:
130
- ```html
131
- <ng-template [itemOf]="items()" let-item let-index="index">
132
- {{ item.name }}
133
- </ng-template>
134
- ```
135
-
136
- ## `SdCommandDirective`
137
-
138
- 키보드 단축키를 output 이벤트로 제공하는 디렉티브. `document` keydown을 감지하며, `shouldProcessCommandEvent()`로 최상위 모달만 이벤트 처리.
139
-
140
- ```typescript
141
- @Directive({ selector: "[sdRefreshCommand],[sdSaveCommand],[sdInsertCommand]" })
142
- class SdCommandDirective {
143
- sdRefreshCommand = output<KeyboardEvent>(); // Ctrl+Alt+L
144
- sdSaveCommand = output<KeyboardEvent>(); // Ctrl+S
145
- sdInsertCommand = output<KeyboardEvent>(); // Ctrl+Insert
146
- }
147
- ```
148
-
149
- 사용법: `<div (sdSaveCommand)="onSave($event)" (sdRefreshCommand)="onRefresh($event)">`
150
-
151
- ## `SdResizeDirective`
152
-
153
- ResizeObserver 기반 resize output 이벤트 디렉티브. `requestAnimationFrame`으로 디바운스.
154
-
155
- ```typescript
156
- @Directive({ selector: "[sdResize]" })
157
- class SdResizeDirective {
158
- sdResize = output<SdResizeEvent>();
159
- }
160
- ```
161
-
162
- 사용법: `<div (sdResize)="onResize($event)">`
163
-
164
- ## `SdResizeEvent`
165
-
166
- ```typescript
167
- interface SdResizeEvent {
168
- heightChanged: boolean;
169
- widthChanged: boolean;
170
- target: HTMLElement;
171
- contentRect: DOMRectReadOnly;
172
- }
173
- ```
174
-
175
- | Field | Type | Description |
176
- |-------|------|-------------|
177
- | `heightChanged` | `boolean` | 높이 변경 여부 |
178
- | `widthChanged` | `boolean` | 너비 변경 여부 |
179
- | `target` | `HTMLElement` | 대상 요소 |
180
- | `contentRect` | `DOMRectReadOnly` | 컨텐츠 영역 크기 |
181
-
182
- ## `SdIntersectionDirective`
183
-
184
- IntersectionObserver 기반 intersection output 이벤트 디렉티브.
185
-
186
- ```typescript
187
- @Directive({ selector: "[sdIntersection]" })
188
- class SdIntersectionDirective {
189
- sdIntersection = output<SdIntersectionEvent>();
190
- }
191
- ```
192
-
193
- 사용법: `<div (sdIntersection)="onIntersect($event)">`
194
-
195
- ## `SdIntersectionEvent`
196
-
197
- ```typescript
198
- interface SdIntersectionEvent {
199
- entry: IntersectionObserverEntry;
200
- }
201
- ```
202
-
203
- | Field | Type | Description |
204
- |-------|------|-------------|
205
- | `entry` | `IntersectionObserverEntry` | 마지막 IntersectionObserver 엔트리 |
206
-
207
- ## `SdRouterLink`
208
-
209
- 라우터 네비게이션 디렉티브. 일반 클릭은 라우터 네비게이션, Ctrl/Shift+클릭은 새 창, 팝업 윈도우에서는 팝업 형태로 열린다.
210
-
211
- ```typescript
212
- @Directive({
213
- selector: "[sdRouterLink]",
214
- host: {
215
- "[style.cursor]": "option() ? 'pointer' : ''",
216
- "(click)": "onClick($event)",
217
- },
218
- })
219
- class SdRouterLink {
220
- option = input<{
221
- link: string;
222
- params?: Record<string, string>;
223
- window?: { width?: number; height?: number };
224
- outletName?: string;
225
- queryParams?: Record<string, string>;
226
- } | undefined>(undefined, { alias: "sdRouterLink" });
227
- }
228
- ```
229
-
230
- | Input Field | Type | Description |
231
- |-------------|------|-------------|
232
- | `link` | `string` | 네비게이션 경로 |
233
- | `params` | `Record<string, string> \| undefined` | 라우터 파라미터 |
234
- | `window` | `{ width?, height? } \| undefined` | 팝업 윈도우 크기 (설정 시 팝업으로 열림) |
235
- | `outletName` | `string \| undefined` | named outlet |
236
- | `queryParams` | `Record<string, string> \| undefined` | 쿼리 파라미터 |
@@ -1,379 +0,0 @@
1
- # Features
2
-
3
- ## `SdBaseContainer`
4
-
5
- 페이지/모달/뷰 공통 레이아웃 컨테이너. `currViewType()`에 따라 page(topbar 포함), modal(bottom 슬롯 포함), control(raw content) 중 하나를 렌더링한다.
6
-
7
- ```typescript
8
- @Component({ selector: "sd-base-container" })
9
- class SdBaseContainer {
10
- contentTplRef = contentChild.required("contentTpl", { read: TemplateRef });
11
- pageTopbarTplRef = contentChild("pageTopbarTpl", { read: TemplateRef });
12
- modalBottomTplRef = contentChild("modalBottomTpl", { read: TemplateRef });
13
-
14
- viewType = input<SdViewType>();
15
- currViewType: Signal<SdViewType>; // viewType ?? parentViewType
16
- header = input<string>();
17
- modalOrPageTitle: Signal<string>; // header ?? 모달 타이틀 ?? 앱 구조 타이틀
18
-
19
- initialized = input<boolean | undefined>(undefined);
20
- restricted = input(false, { transform: booleanAttribute });
21
- busy = input(false, { transform: booleanAttribute });
22
- busyMessage = input<string>();
23
- }
24
- ```
25
-
26
- | Input | Type | Default | Description |
27
- |-------|------|---------|-------------|
28
- | `viewType` | `SdViewType \| undefined` | `undefined` | 뷰 타입 오버라이드 |
29
- | `header` | `string \| undefined` | `undefined` | 헤더 타이틀 오버라이드 |
30
- | `initialized` | `boolean \| undefined` | `undefined` | `false`면 컨텐츠 숨김, `undefined`면 표시 |
31
- | `restricted` | `boolean` | `false` | `true`면 권한 없음 메시지 표시 |
32
- | `busy` | `boolean` | `false` | busy 상태 |
33
- | `busyMessage` | `string \| undefined` | `undefined` | busy 메시지 |
34
-
35
- Content children:
36
- - `#contentTpl` (required): 메인 컨텐츠 템플릿
37
- - `#pageTopbarTpl`: 페이지 모드에서 탑바에 추가할 템플릿
38
- - `#modalBottomTpl`: 모달 모드에서 하단에 추가할 템플릿
39
-
40
- ## `SdAddressSearchModal`
41
-
42
- Daum Postcode API를 사용한 주소 검색 모달. `SdModalContentDef<Address>`를 구현한다.
43
-
44
- ```typescript
45
- @Component({ selector: "sd-address-search-modal" })
46
- class SdAddressSearchModal implements SdModalContentDef<Address>, OnInit {
47
- close = output<Address>();
48
- initialized = signal(false);
49
- }
50
- ```
51
-
52
- ### `Address`
53
-
54
- ```typescript
55
- interface Address {
56
- postNumber: string | undefined;
57
- address: string | undefined;
58
- buildingName: string | undefined;
59
- }
60
- ```
61
-
62
- | Field | Type | Description |
63
- |-------|------|-------------|
64
- | `postNumber` | `string \| undefined` | 우편번호 |
65
- | `address` | `string \| undefined` | 주소 |
66
- | `buildingName` | `string \| undefined` | 건물명 |
67
-
68
- ## `SdPermissionTable`
69
-
70
- 권한 매트릭스 테이블. `SdPermission` 트리를 테이블로 렌더링하여 use/edit 체크박스를 표시한다.
71
-
72
- ```typescript
73
- @Component({ selector: "sd-permission-table" })
74
- class SdPermissionTable<TModule = unknown> {
75
- value = model<Record<string, boolean>>({});
76
- items = input<SdPermission<TModule>[]>([]);
77
- disabled = input(false, { transform: booleanAttribute });
78
- }
79
- ```
80
-
81
- | Input | Type | Default | Description |
82
- |-------|------|---------|-------------|
83
- | `value` | `Record<string, boolean>` | `{}` | 권한 레코드 (two-way). 키는 `codeChain.join(".") + ".use"` 또는 `".edit"` 형태 |
84
- | `items` | `SdPermission<TModule>[]` | `[]` | 권한 트리 |
85
- | `disabled` | `boolean` | `false` | 비활성화 |
86
-
87
- ## Data View Abstractions
88
-
89
- ### `SdDataSheetBase`
90
-
91
- 데이터 시트 CRUD 추상 클래스. 소비 프로젝트에서 상속하여 구현한다. `SdSelectModal<TItem>`을 구현하므로 모달 선택에도 사용 가능.
92
-
93
- ```typescript
94
- @Directive()
95
- abstract class SdDataSheetBase<
96
- TFilter extends Record<string, any>,
97
- TItem,
98
- TKey extends string | number | undefined,
99
- > implements SdSelectModal<TItem> {
100
- // 필수 구현
101
- abstract canUse: Signal<boolean>;
102
- abstract canEdit: Signal<boolean>;
103
- abstract editMode: "inline" | "modal" | undefined;
104
- abstract selectMode: InputSignal<"single" | "multi" | undefined>;
105
- abstract bindFilter(): TFilter;
106
- abstract itemPropInfo: SdDataSheetItemPropInfo<TItem>;
107
- abstract getItemInfoFn: (item: TItem) => SdDataSheetItemInfo<TKey>;
108
- abstract search(usePagination: boolean): Promise<SdDataSheetSearchResult<TItem>> | SdDataSheetSearchResult<TItem>;
109
-
110
- // 선택적 구현
111
- hideTool?: Signal<boolean>;
112
- diffsExcludes?: string[];
113
- prepareRefreshEffect?(): void;
114
- editItem?(item?: TItem): Promise<boolean | undefined> | boolean | undefined;
115
- toggleDeleteItems?(del: boolean): Promise<boolean>;
116
- newItem?(): Promise<TItem> | TItem;
117
- submit?(diffs: ArrayOneWayDiffResult<TItem>[]): Promise<boolean> | boolean;
118
- downloadExcel?(items: TItem[]): Promise<void> | void;
119
- uploadExcel?(file: File): Promise<void> | void;
120
- }
121
- ```
122
-
123
- ### `SdDataSheet`
124
-
125
- 데이터 시트 presentation 컴포넌트. `SdDataSheetBase`의 상속자를 부모로 자동 감지하여 렌더링한다.
126
-
127
- ```typescript
128
- @Component({ selector: "sd-data-sheet" })
129
- class SdDataSheet { }
130
- ```
131
-
132
- ### `SdDataSheetColumn`
133
-
134
- 데이터 시트 컬럼. `SdSheetColumn`를 확장하여 `edit` input을 추가한다.
135
-
136
- ```typescript
137
- @Directive({ selector: "sd-data-sheet-column" })
138
- class SdDataSheetColumn extends SdSheetColumn {
139
- edit = input(false, { transform: booleanAttribute });
140
- }
141
- ```
142
-
143
- ### `SdDataSheetItemPropInfo`
144
-
145
- ```typescript
146
- interface SdDataSheetItemPropInfo<I> {
147
- isDeleted: (keyof I & string) | undefined;
148
- lastModifiedAt: (keyof I & string) | undefined;
149
- lastModifiedBy: (keyof I & string) | undefined;
150
- }
151
- ```
152
-
153
- | Field | Type | Description |
154
- |-------|------|-------------|
155
- | `isDeleted` | `keyof I \| undefined` | 삭제 여부 프로퍼티 키 |
156
- | `lastModifiedAt` | `keyof I \| undefined` | 최종 수정일시 프로퍼티 키 |
157
- | `lastModifiedBy` | `keyof I \| undefined` | 최종 수정자 프로퍼티 키 |
158
-
159
- ### `SdDataSheetItemInfo`
160
-
161
- ```typescript
162
- interface SdDataSheetItemInfo<K> {
163
- key: K;
164
- canSelect: boolean;
165
- canEdit: boolean;
166
- canDelete: boolean;
167
- }
168
- ```
169
-
170
- | Field | Type | Description |
171
- |-------|------|-------------|
172
- | `key` | `K` | 항목 키 |
173
- | `canSelect` | `boolean` | 선택 가능 여부 |
174
- | `canEdit` | `boolean` | 편집 가능 여부 |
175
- | `canDelete` | `boolean` | 삭제 가능 여부 |
176
-
177
- ### `SdDataSheetSearchResult`
178
-
179
- ```typescript
180
- interface SdDataSheetSearchResult<I> {
181
- items: I[];
182
- pageLength?: number;
183
- summary?: Partial<I>;
184
- }
185
- ```
186
-
187
- | Field | Type | Description |
188
- |-------|------|-------------|
189
- | `items` | `I[]` | 조회된 항목 |
190
- | `pageLength` | `number \| undefined` | 총 페이지 수 |
191
- | `summary` | `Partial<I> \| undefined` | 요약 행 데이터 |
192
-
193
- ### `SdDataDetailBase`
194
-
195
- 상세 폼 추상 클래스. 모달로 표시되며, `SdModalContentDef<R>`을 구현한다.
196
-
197
- ```typescript
198
- @Directive()
199
- abstract class SdDataDetailBase<T extends object, R = boolean> implements SdModalContentDef<R> {
200
- // 필수 구현
201
- abstract canUse: Signal<boolean>;
202
- abstract canEdit: Signal<boolean>;
203
- abstract load(): Promise<{ data: T; info: SdDataDetailDataInfo }> | { data: T; info: SdDataDetailDataInfo };
204
-
205
- // 선택적 구현
206
- canDelete?: Signal<boolean>;
207
- prepareRefreshEffect?(): void;
208
- toggleDelete?(del: boolean): Promise<R | undefined> | R | undefined;
209
- submit?(data: T): Promise<R | undefined> | R | undefined;
210
- }
211
- ```
212
-
213
- ### `SdDataDetail`
214
-
215
- 상세 폼 presentation 컴포넌트.
216
-
217
- ```typescript
218
- @Component({ selector: "sd-data-detail" })
219
- class SdDataDetail { }
220
- ```
221
-
222
- ### `SdDataDetailDataInfo`
223
-
224
- ```typescript
225
- interface SdDataDetailDataInfo {
226
- isNew: boolean;
227
- isDeleted: boolean;
228
- lastModifiedAt: DateTime | undefined;
229
- lastModifiedBy: string | undefined;
230
- }
231
- ```
232
-
233
- | Field | Type | Description |
234
- |-------|------|-------------|
235
- | `isNew` | `boolean` | 신규 여부 |
236
- | `isDeleted` | `boolean` | 삭제 여부 |
237
- | `lastModifiedAt` | `DateTime \| undefined` | 최종 수정일시 |
238
- | `lastModifiedBy` | `string \| undefined` | 최종 수정자 |
239
-
240
- ### `SdDataSelectButtonBase`
241
-
242
- 모달 기반 선택 버튼 추상 클래스.
243
-
244
- ```typescript
245
- @Directive()
246
- abstract class SdDataSelectButtonBase<TItem extends object, TKey, TMode extends keyof SelectModeValue<TKey>> {
247
- abstract modal: Signal<SdSelectModalInfo<SdSelectModal<any>>>;
248
- abstract load(keys: TKey[]): Promise<TItem[]> | TItem[];
249
-
250
- value = model<SelectModeValue<TKey>[TMode]>();
251
- disabled = input(false, { transform: booleanAttribute });
252
- required = input(false, { transform: booleanAttribute });
253
- inset = input(false, { transform: booleanAttribute });
254
- size = input<"sm" | "lg">();
255
- selectMode = input<TMode>("single" as TMode);
256
- }
257
- ```
258
-
259
- | Input/Model | Type | Default | Description |
260
- |-------------|------|---------|-------------|
261
- | `value` | `SelectModeValue<TKey>[TMode]` | - | 선택된 값 (two-way) |
262
- | `disabled` | `boolean` | `false` | 비활성화 |
263
- | `required` | `boolean` | `false` | 필수 |
264
- | `inset` | `boolean` | `false` | 삽입 스타일 |
265
- | `size` | `"sm" \| "lg" \| undefined` | `undefined` | 크기 |
266
- | `selectMode` | `TMode` | `"single"` | 선택 모드 |
267
-
268
- ### `SdDataSelectButton`
269
-
270
- 선택 버튼 presentation 컴포넌트.
271
-
272
- ```typescript
273
- @Component({ selector: "sd-data-select-button" })
274
- class SdDataSelectButton { }
275
- ```
276
-
277
- ## Shared Data Controls
278
-
279
- ### `SdSharedDataSelect`
280
-
281
- 공유 데이터 드롭다운 선택 컴포넌트. 검색 기능 포함.
282
-
283
- ```typescript
284
- @Component({ selector: "sd-shared-data-select" })
285
- class SdSharedDataSelect<TItem extends SharedDataBase<string | number>, TMode extends keyof SelectModeValue<...>, TModal extends SdSelectModal<any>> {
286
- value = model<SelectModeValue<TItem["__valueKey"] | undefined>[TMode]>();
287
- items = input.required<TItem[]>();
288
- disabled = input(false, { transform: booleanAttribute });
289
- required = input(false, { transform: booleanAttribute });
290
- useUndefined = input(false, { transform: booleanAttribute });
291
- inset = input(false, { transform: booleanAttribute });
292
- inline = input(false, { transform: booleanAttribute });
293
- size = input<"sm" | "lg">();
294
- selectMode = input("single" as TMode);
295
- filterFn = input<(item: TItem, index: number, ...params: any[]) => boolean>();
296
- filterFnParams = input<any[]>();
297
- modal = input<SdSelectModalInfo<TModal>>();
298
- editModal = input<SdModalInfo<SdModalContentDef<boolean>>>();
299
- selectClass = input<string>();
300
- multiSelectionDisplayDirection = input<"vertical">();
301
- getIsHiddenFn = input<(item: TItem, index: number) => boolean>();
302
- getSearchTextFn = input<(item: TItem, index: number) => string>();
303
- displayOrderKeyProp = input<string>();
304
- }
305
- ```
306
-
307
- ### `SdSharedDataSelectButton`
308
-
309
- 공유 데이터 모달 선택 버튼. `SdDataSelectButton`을 래핑하여 공유 데이터 항목을 표시한다.
310
-
311
- ```typescript
312
- @Component({ selector: "sd-shared-data-select-button" })
313
- class SdSharedDataSelectButton<TItem extends SharedDataBase<...>, TMode extends keyof SelectModeValue<...>, TModal extends SdSelectModal<any>> {
314
- items = input<TItem[]>([]);
315
- modal = input.required<SdSelectModalInfo<TModal>>();
316
- }
317
- ```
318
-
319
- ### `SdSharedDataSelectList`
320
-
321
- 공유 데이터 목록형 선택 컴포넌트. 검색, 페이지네이션, 외부 링크 기능을 포함한다.
322
-
323
- ```typescript
324
- @Component({ selector: "sd-shared-data-select-list" })
325
- class SdSharedDataSelectList<TItem extends SharedDataBase<string | number>, TModal extends SdSelectModal<any>> {
326
- selectedItem = model<TItem>();
327
- canChangeFn = input<(item: TItem | undefined) => boolean | Promise<boolean>>(() => true);
328
- items = input.required<TItem[]>();
329
- selectedIcon = input<string>();
330
- useUndefined = input(false, { transform: booleanAttribute });
331
- filterFn = input<(item: TItem, index: number) => boolean>();
332
- modal = input<SdSelectModalInfo<TModal>>();
333
- header = input<string>();
334
- pageItemCount = input<number>();
335
- }
336
- ```
337
-
338
- | Input | Type | Default | Description |
339
- |-------|------|---------|-------------|
340
- | `selectedItem` | `TItem \| undefined` | - | 선택된 항목 (two-way) |
341
- | `canChangeFn` | `(item) => boolean \| Promise<boolean>` | `() => true` | 선택 변경 가능 여부 함수 |
342
- | `items` | `TItem[]` | required | 공유 데이터 항목 |
343
- | `selectedIcon` | `string \| undefined` | `undefined` | 선택됨 아이콘 |
344
- | `useUndefined` | `boolean` | `false` | undefined 항목 포함 |
345
- | `filterFn` | `((item, index) => boolean) \| undefined` | `undefined` | 필터 함수 |
346
- | `modal` | `SdSelectModalInfo<TModal> \| undefined` | `undefined` | 모달 선택 정보 |
347
- | `header` | `string \| undefined` | `undefined` | 헤더 텍스트 |
348
- | `pageItemCount` | `number \| undefined` | `undefined` | 페이지당 항목 수 |
349
-
350
- Content children:
351
- - `#headerTpl`: 헤더 커스텀 템플릿
352
- - `#filterTpl`: 필터 커스텀 템플릿
353
- - `SdItemOfTemplate`: 항목 커스텀 템플릿
354
- - `#undefinedTpl`: undefined 항목 커스텀 템플릿
355
-
356
- ### `matchesSearchText`
357
-
358
- 공백 구분 AND 조건 텍스트 검색 매칭 함수.
359
-
360
- ```typescript
361
- function matchesSearchText(itemText: string, searchQuery: string | undefined): boolean
362
- ```
363
-
364
- 모든 검색어(공백으로 분할)가 `itemText`에 포함되면 `true`. `searchQuery`가 undefined이거나 빈 문자열이면 항상 `true`.
365
-
366
- ## `getOrmDataEditToastErrorMessage`
367
-
368
- ORM 편집 에러 메시지를 사용자 친화적인 한국어 메시지로 변환한다. FK 제약 위반 등 DB 에러 메시지를 감지하여 적절한 메시지를 반환한다.
369
-
370
- ```typescript
371
- function getOrmDataEditToastErrorMessage(err: unknown): string
372
- ```
373
-
374
- | 감지 조건 | 반환 메시지 |
375
- |-----------|-------------|
376
- | FK 제약 위반 (`a parent row: a foreign key constraint` 또는 `conflicted with the REFERENCE`) | `"경고! 연결된 작업에 의한 처리 거부. 후속작업 확인 요망"` |
377
- | 그 외 | `err.message` (또는 `String(err)`) |
378
-
379
- `SdDataSheetBase`, `SdDataDetailBase` 내부에서 사용되며, 소비 코드에서 직접 사용할 수도 있다.
@@ -1,32 +0,0 @@
1
- # Pipes
2
-
3
- ## `FormatPipe`
4
-
5
- DateTime, DateOnly, string 값을 포맷팅하는 파이프. 파이프명: `format`
6
-
7
- ```typescript
8
- @Pipe({ name: "format" })
9
- class FormatPipe implements PipeTransform {
10
- transform(value: string | DateTime | DateOnly | undefined, format: string): string;
11
- }
12
- ```
13
-
14
- ### DateTime / DateOnly
15
-
16
- `value.toFormatString(format)`을 호출한다.
17
-
18
- ```html
19
- {{ someDateTime | format: "yyyy-MM-dd HH:mm" }}
20
- {{ someDateOnly | format: "yyyy년 MM월 dd일" }}
21
- ```
22
-
23
- ### String
24
-
25
- format 문자열에서 `X` 문자를 값의 문자로 치환한다. `|`로 구분된 여러 포맷 중 길이가 일치하는 것을 사용한다.
26
-
27
- ```html
28
- <!-- "01012345678" → "010-1234-5678" -->
29
- {{ phone | format: "XXX-XXXX-XXXX|XX-XXX-XXXX|XX-XXXX-XXXX" }}
30
- ```
31
-
32
- `undefined` 또는 `null` 입력 시 빈 문자열 반환.
@@ -1,37 +0,0 @@
1
- # Plugins
2
-
3
- Angular의 `EventManagerPlugin`을 확장하여 커스텀 이벤트 옵션을 지원한다. `provideSdAngular()`에서 `SdOptionEventPlugin`만 자동 등록된다.
4
-
5
- > **NOTE:** 이전 버전의 커맨드 플러그인(`sdSaveCommand`, `sdRefreshCommand`, `sdInsertCommand`)과 옵저버 플러그인(`sdResize`, `sdIntersection`)은 디렉티브로 대체되었다. 자세한 내용은 [directives.md](./directives.md)의 `SdCommandDirective`, `SdResizeDirective`, `SdIntersectionDirective` 항목을 참고한다.
6
-
7
- ## Option Plugin
8
-
9
- ### `SdOptionEventPlugin`
10
-
11
- `.capture`, `.passive`, `.once` 이벤트 수식어 플러그인. 네이티브 DOM 이벤트에 addEventListener options를 적용한다.
12
-
13
- ```typescript
14
- class SdOptionEventPlugin extends EventManagerPlugin {
15
- supports(eventName: string): boolean; // /\.(capture|passive|once)/ 매칭
16
- }
17
- ```
18
-
19
- 사용법: `(scroll.passive)="onScroll($event)"`, `(click.capture.once)="onClick($event)"`
20
-
21
- ## Error Handler
22
-
23
- ### `SdGlobalErrorHandlerPlugin`
24
-
25
- 글로벌 에러 핸들러. Angular의 `ErrorHandler`를 구현하여 PromiseRejectionEvent, ErrorEvent, Error 등을 처리한다.
26
-
27
- ```typescript
28
- class SdGlobalErrorHandlerPlugin implements ErrorHandler {
29
- handleError(event: any): false;
30
- }
31
- ```
32
-
33
- 에러 발생 시:
34
- 1. `SdSystemLogProvider.writeAsync()`로 로그 기록
35
- 2. 전체 화면 에러 메시지 표시 (검은 배경 + 흰 텍스트)
36
- 3. `ApplicationRef.destroy()` 호출하여 앱 정지
37
- 4. 클릭 시 페이지 리로드 (프로덕션에서는 `location.hash = "/"` 후 리로드)