@sdcorejs/angular 22.3.0 → 22.3.2

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 (199) hide show
  1. package/README.md +2 -2
  2. package/assets/STYLE-GUIDE.md +25 -5
  3. package/assets/THEME.md +237 -5
  4. package/assets/licenses/tiptap-oss-NOTICES.txt +332 -0
  5. package/assets/scss/ckeditor5.scss +2 -88
  6. package/assets/scss/core/_control.scss +39 -0
  7. package/assets/scss/core/form.scss +156 -45
  8. package/assets/scss/core/view.scss +24 -0
  9. package/assets/scss/editor-content.scss +173 -0
  10. package/assets/scss/sd-core.scss +1 -0
  11. package/assets/scss/themes/_component-tokens.scss +93 -31
  12. package/assets/scss/themes/_material-tokens.scss +112 -0
  13. package/assets/scss/themes/_presets.scss +25 -0
  14. package/assets/scss/themes/_scales.scss +10 -0
  15. package/assets/scss/themes/_semantic.scss +13 -0
  16. package/assets/scss/themes/default.scss +8 -2
  17. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs +5 -5
  18. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs.map +1 -1
  19. package/fesm2022/sdcorejs-angular-components-avatar.mjs +166 -11
  20. package/fesm2022/sdcorejs-angular-components-avatar.mjs.map +1 -1
  21. package/fesm2022/sdcorejs-angular-components-badge.mjs +590 -24
  22. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  23. package/fesm2022/sdcorejs-angular-components-button.mjs +35 -3
  24. package/fesm2022/sdcorejs-angular-components-button.mjs.map +1 -1
  25. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs +5 -20
  26. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs.map +1 -1
  27. package/fesm2022/sdcorejs-angular-components-data-state.mjs +1 -1
  28. package/fesm2022/sdcorejs-angular-components-data-state.mjs.map +1 -1
  29. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs +1906 -0
  30. package/fesm2022/sdcorejs-angular-components-editor-engine.mjs.map +1 -0
  31. package/fesm2022/sdcorejs-angular-components-editor.mjs +461 -757
  32. package/fesm2022/sdcorejs-angular-components-editor.mjs.map +1 -1
  33. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs +2295 -106
  34. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
  35. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +2686 -1050
  36. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  37. package/fesm2022/sdcorejs-angular-components-history.mjs +5 -2
  38. package/fesm2022/sdcorejs-angular-components-history.mjs.map +1 -1
  39. package/fesm2022/sdcorejs-angular-components-image-editor.mjs +1 -1
  40. package/fesm2022/sdcorejs-angular-components-image-editor.mjs.map +1 -1
  41. package/fesm2022/sdcorejs-angular-components-import-excel.mjs +21 -6
  42. package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
  43. package/fesm2022/sdcorejs-angular-components-inform.mjs +1 -1
  44. package/fesm2022/sdcorejs-angular-components-inform.mjs.map +1 -1
  45. package/fesm2022/sdcorejs-angular-components-kanban.mjs +474 -0
  46. package/fesm2022/sdcorejs-angular-components-kanban.mjs.map +1 -0
  47. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs +182 -284
  48. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs.map +1 -1
  49. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs +1 -316
  50. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs.map +1 -1
  51. package/fesm2022/sdcorejs-angular-components-modal.mjs +2 -2
  52. package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
  53. package/fesm2022/sdcorejs-angular-components-operator.mjs +274 -44
  54. package/fesm2022/sdcorejs-angular-components-operator.mjs.map +1 -1
  55. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +12 -12
  56. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  57. package/fesm2022/sdcorejs-angular-components-query-builder.mjs +1 -1
  58. package/fesm2022/sdcorejs-angular-components-query-builder.mjs.map +1 -1
  59. package/fesm2022/sdcorejs-angular-components-section.mjs +5 -4
  60. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  61. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +2 -2
  62. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  63. package/fesm2022/sdcorejs-angular-components-stepper.mjs +5 -1
  64. package/fesm2022/sdcorejs-angular-components-stepper.mjs.map +1 -1
  65. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +202 -43
  66. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  67. package/fesm2022/sdcorejs-angular-components-tab.mjs +12 -4
  68. package/fesm2022/sdcorejs-angular-components-tab.mjs.map +1 -1
  69. package/fesm2022/sdcorejs-angular-components-table.mjs +581 -110
  70. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  71. package/fesm2022/sdcorejs-angular-components-tree.mjs +1 -1
  72. package/fesm2022/sdcorejs-angular-components-tree.mjs.map +1 -1
  73. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +1 -1
  74. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  75. package/fesm2022/sdcorejs-angular-components-view.mjs +2 -2
  76. package/fesm2022/sdcorejs-angular-components-view.mjs.map +1 -1
  77. package/fesm2022/sdcorejs-angular-components-window.mjs +498 -0
  78. package/fesm2022/sdcorejs-angular-components-window.mjs.map +1 -0
  79. package/fesm2022/sdcorejs-angular-components.mjs +2 -0
  80. package/fesm2022/sdcorejs-angular-components.mjs.map +1 -1
  81. package/fesm2022/sdcorejs-angular-configurations.mjs.map +1 -1
  82. package/fesm2022/sdcorejs-angular-directives.mjs +18 -1
  83. package/fesm2022/sdcorejs-angular-directives.mjs.map +1 -1
  84. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +15 -2
  85. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  86. package/fesm2022/sdcorejs-angular-forms-checkbox.mjs +2 -2
  87. package/fesm2022/sdcorejs-angular-forms-checkbox.mjs.map +1 -1
  88. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +480 -126
  89. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  90. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +82 -13
  91. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  92. package/fesm2022/sdcorejs-angular-forms-date.mjs +77 -18
  93. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  94. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +75 -16
  95. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  96. package/fesm2022/sdcorejs-angular-forms-directives.mjs +90 -2
  97. package/fesm2022/sdcorejs-angular-forms-directives.mjs.map +1 -1
  98. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +2 -2
  99. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
  100. package/fesm2022/sdcorejs-angular-forms-input-color.mjs +1 -1
  101. package/fesm2022/sdcorejs-angular-forms-input-color.mjs.map +1 -1
  102. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +46 -5
  103. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  104. package/fesm2022/sdcorejs-angular-forms-input.mjs +56 -7
  105. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  106. package/fesm2022/sdcorejs-angular-forms-models.mjs +88 -5
  107. package/fesm2022/sdcorejs-angular-forms-models.mjs.map +1 -1
  108. package/fesm2022/sdcorejs-angular-forms-radio.mjs +2 -2
  109. package/fesm2022/sdcorejs-angular-forms-radio.mjs.map +1 -1
  110. package/fesm2022/sdcorejs-angular-forms-segmented.mjs +263 -0
  111. package/fesm2022/sdcorejs-angular-forms-segmented.mjs.map +1 -0
  112. package/fesm2022/sdcorejs-angular-forms-select.mjs +71 -15
  113. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  114. package/fesm2022/sdcorejs-angular-forms-switch.mjs +2 -2
  115. package/fesm2022/sdcorejs-angular-forms-switch.mjs.map +1 -1
  116. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +2 -2
  117. package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
  118. package/fesm2022/sdcorejs-angular-forms-time.mjs +2 -2
  119. package/fesm2022/sdcorejs-angular-forms-time.mjs.map +1 -1
  120. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs +1 -1
  121. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs.map +1 -1
  122. package/fesm2022/sdcorejs-angular-forms.mjs +8 -0
  123. package/fesm2022/sdcorejs-angular-forms.mjs.map +1 -1
  124. package/fesm2022/sdcorejs-angular-i18n.mjs +1830 -17
  125. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  126. package/fesm2022/sdcorejs-angular-interceptors.mjs +1 -1
  127. package/fesm2022/sdcorejs-angular-interceptors.mjs.map +1 -1
  128. package/fesm2022/sdcorejs-angular-modules-generic-generic-configuration.page-BrJfOTWy.mjs +509 -0
  129. package/fesm2022/sdcorejs-angular-modules-generic-generic-configuration.page-BrJfOTWy.mjs.map +1 -0
  130. package/fesm2022/sdcorejs-angular-modules-generic-generic-form-host.page-DQYXx2nr.mjs +232 -0
  131. package/fesm2022/sdcorejs-angular-modules-generic-generic-form-host.page-DQYXx2nr.mjs.map +1 -0
  132. package/fesm2022/sdcorejs-angular-modules-generic-generic-list.page-Cjg3Dfq1.mjs +294 -0
  133. package/fesm2022/sdcorejs-angular-modules-generic-generic-list.page-Cjg3Dfq1.mjs.map +1 -0
  134. package/fesm2022/sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DpXg2yI7.mjs +1556 -0
  135. package/fesm2022/sdcorejs-angular-modules-generic-sdcorejs-angular-modules-generic-DpXg2yI7.mjs.map +1 -0
  136. package/fesm2022/sdcorejs-angular-modules-generic.mjs +2 -0
  137. package/fesm2022/sdcorejs-angular-modules-generic.mjs.map +1 -0
  138. package/fesm2022/sdcorejs-angular-modules-icon.mjs +96 -3
  139. package/fesm2022/sdcorejs-angular-modules-icon.mjs.map +1 -1
  140. package/fesm2022/sdcorejs-angular-modules-layout.mjs +1908 -46
  141. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  142. package/fesm2022/sdcorejs-angular-modules.mjs +1 -0
  143. package/fesm2022/sdcorejs-angular-modules.mjs.map +1 -1
  144. package/fesm2022/sdcorejs-angular-pipes.mjs +27 -7
  145. package/fesm2022/sdcorejs-angular-pipes.mjs.map +1 -1
  146. package/fesm2022/sdcorejs-angular-services-confirm.mjs +2 -2
  147. package/fesm2022/sdcorejs-angular-services-confirm.mjs.map +1 -1
  148. package/fesm2022/sdcorejs-angular-services-date-time.mjs +143 -0
  149. package/fesm2022/sdcorejs-angular-services-date-time.mjs.map +1 -0
  150. package/fesm2022/sdcorejs-angular-services-storage.mjs +44 -8
  151. package/fesm2022/sdcorejs-angular-services-storage.mjs.map +1 -1
  152. package/fesm2022/sdcorejs-angular-services.mjs +1 -0
  153. package/fesm2022/sdcorejs-angular-services.mjs.map +1 -1
  154. package/fesm2022/sdcorejs-angular-utilities-read-state.mjs +4 -0
  155. package/fesm2022/sdcorejs-angular-utilities-read-state.mjs.map +1 -1
  156. package/fesm2022/sdcorejs-angular-utilities-theme.mjs +10 -0
  157. package/fesm2022/sdcorejs-angular-utilities-theme.mjs.map +1 -1
  158. package/package.json +48 -7
  159. package/types/sdcorejs-angular-components-avatar.d.ts +67 -2
  160. package/types/sdcorejs-angular-components-badge.d.ts +188 -6
  161. package/types/sdcorejs-angular-components-button.d.ts +20 -1
  162. package/types/sdcorejs-angular-components-ckeditor-styles.d.ts +3 -18
  163. package/types/sdcorejs-angular-components-editor-engine.d.ts +246 -0
  164. package/types/sdcorejs-angular-components-editor.d.ts +20 -17
  165. package/types/sdcorejs-angular-components-file-explorer.d.ts +449 -57
  166. package/types/sdcorejs-angular-components-form-generic.d.ts +301 -37
  167. package/types/sdcorejs-angular-components-kanban.d.ts +179 -0
  168. package/types/sdcorejs-angular-components-mini-editor.d.ts +33 -70
  169. package/types/sdcorejs-angular-components-modal-resizable.d.ts +1 -124
  170. package/types/sdcorejs-angular-components-operator.d.ts +137 -8
  171. package/types/sdcorejs-angular-components-section.d.ts +2 -1
  172. package/types/sdcorejs-angular-components-tab-router.d.ts +31 -18
  173. package/types/sdcorejs-angular-components-tab.d.ts +3 -1
  174. package/types/sdcorejs-angular-components-table.d.ts +84 -6
  175. package/types/sdcorejs-angular-components-window.d.ts +81 -0
  176. package/types/sdcorejs-angular-components.d.ts +2 -0
  177. package/types/sdcorejs-angular-configurations.d.ts +8 -1
  178. package/types/sdcorejs-angular-forms-autocomplete.d.ts +5 -0
  179. package/types/sdcorejs-angular-forms-chip-calendar.d.ts +163 -18
  180. package/types/sdcorejs-angular-forms-date-range.d.ts +24 -2
  181. package/types/sdcorejs-angular-forms-date.d.ts +23 -2
  182. package/types/sdcorejs-angular-forms-directives.d.ts +47 -2
  183. package/types/sdcorejs-angular-forms-input-number.d.ts +23 -2
  184. package/types/sdcorejs-angular-forms-input.d.ts +23 -2
  185. package/types/sdcorejs-angular-forms-models.d.ts +38 -3
  186. package/types/sdcorejs-angular-forms-segmented.d.ts +90 -0
  187. package/types/sdcorejs-angular-forms-select.d.ts +32 -2
  188. package/types/sdcorejs-angular-forms.d.ts +8 -6
  189. package/types/sdcorejs-angular-i18n.d.ts +360 -1
  190. package/types/sdcorejs-angular-modules-generic.d.ts +316 -0
  191. package/types/sdcorejs-angular-modules-icon.d.ts +37 -6
  192. package/types/sdcorejs-angular-modules-layout.d.ts +536 -86
  193. package/types/sdcorejs-angular-modules.d.ts +1 -0
  194. package/types/sdcorejs-angular-pipes.d.ts +2 -0
  195. package/types/sdcorejs-angular-services-date-time.d.ts +57 -0
  196. package/types/sdcorejs-angular-services-storage.d.ts +8 -1
  197. package/types/sdcorejs-angular-services.d.ts +1 -0
  198. package/types/sdcorejs-angular-utilities-read-state.d.ts +2 -0
  199. package/types/sdcorejs-angular-utilities-theme.d.ts +1 -1
@@ -1,6 +1,8 @@
1
1
  import * as _angular_core from '@angular/core';
2
- import { WritableSignal, Signal, ElementRef } from '@angular/core';
2
+ import { TemplateRef, WritableSignal, Signal, ElementRef } from '@angular/core';
3
3
  import { SdBreadcrumbItem } from '@sdcorejs/angular/components/breadcrumb';
4
+ import { SdButtonColor, SdButtonType } from '@sdcorejs/angular/components/button';
5
+ import { SdIconSet } from '@sdcorejs/angular/modules/icon';
4
6
 
5
7
  /**
6
8
  * Kind of an explorer entry. Folders can be opened and listed; files can be previewed and downloaded.
@@ -9,12 +11,12 @@ type SdFileExplorerItemKind = 'folder' | 'file';
9
11
  /**
10
12
  * One file or folder shown by `<sd-file-explorer>`.
11
13
  *
12
- * The explorer never talks to a storage API itself: every item comes from `SdFileExplorerOption.list`
14
+ * The explorer never talks to a storage API itself: every item comes from `SdFileExplorerOption<T>.list`
13
15
  * (or `search`), so map your own DTO into this shape inside the callback.
14
16
  *
15
17
  * @example
16
18
  * ```ts
17
- * const item: SdFileExplorerItem = {
19
+ * const item: SdFileExplorerItem<T> = {
18
20
  * id: 'f-42',
19
21
  * parentId: 'folder-7', // null = item sits in the root folder
20
22
  * name: 'Contract.pdf',
@@ -25,7 +27,9 @@ type SdFileExplorerItemKind = 'folder' | 'file';
25
27
  * };
26
28
  * ```
27
29
  */
28
- interface SdFileExplorerItem {
30
+ interface SdFileExplorerItem<T = unknown> {
31
+ /** Caller-owned DTO, preserved by identity and never serialized by the explorer. */
32
+ data?: T;
29
33
  /** Stable id, unique across the whole tree. Used for tracking, navigation and `autoId` suffixes. */
30
34
  id: string;
31
35
  /** Id of the containing folder, or `null` when the item sits in the root folder. */
@@ -52,7 +56,7 @@ interface SdFileExplorerItem {
52
56
  /** Image URL shown on the grid card instead of the file-type icon. Caller-owned: the explorer never revokes it. */
53
57
  thumbnailUrl?: string;
54
58
  }
55
- /** Arguments of `SdFileExplorerOption.list`. */
59
+ /** Arguments of `SdFileExplorerOption<T>.list`. */
56
60
  interface SdFileExplorerListArgs {
57
61
  /** Folder whose direct children are requested; `null` is the root folder. */
58
62
  parentId: string | null;
@@ -63,7 +67,7 @@ interface SdFileExplorerListArgs {
63
67
  */
64
68
  signal: AbortSignal;
65
69
  }
66
- /** Arguments of `SdFileExplorerOption.search`. */
70
+ /** Arguments of `SdFileExplorerOption<T>.search`. */
67
71
  interface SdFileExplorerSearchArgs {
68
72
  /** Folder the user is currently viewing; `null` is the root folder. */
69
73
  parentId: string | null;
@@ -72,15 +76,15 @@ interface SdFileExplorerSearchArgs {
72
76
  /** Aborted when a newer keyword supersedes this one, the search is cleared or the user navigates away. */
73
77
  signal: AbortSignal;
74
78
  }
75
- /** Arguments of `SdFileExplorerOption.preview`. */
76
- interface SdFileExplorerPreviewArgs {
79
+ /** Arguments of `SdFileExplorerOption<T>.preview`. */
80
+ interface SdFileExplorerPreviewArgs<T = unknown> {
77
81
  /** File being previewed. */
78
- item: SdFileExplorerItem;
82
+ item: SdFileExplorerItem<T>;
79
83
  /** Aborted when the detail drawer is closed or another file is opened before this one resolves. */
80
84
  signal: AbortSignal;
81
85
  }
82
86
  /**
83
- * Content returned by `SdFileExplorerOption.preview`.
87
+ * Content returned by `SdFileExplorerOption<T>.preview`.
84
88
  *
85
89
  * - `string`: a URL. Caller-owned — the explorer uses it as-is and never revokes it.
86
90
  * - `Blob` / `File`: the explorer creates an object URL when needed and revokes it when the preview closes,
@@ -105,26 +109,26 @@ interface SdFileExplorerTransferArgs {
105
109
  */
106
110
  signal: AbortSignal;
107
111
  }
108
- /** Arguments of `SdFileExplorerOption.upload`. */
112
+ /** Arguments of `SdFileExplorerOption<T>.upload`. */
109
113
  interface SdFileExplorerUploadArgs extends SdFileExplorerTransferArgs {
110
114
  /** File picked through the upload button or dropped onto the explorer. */
111
115
  file: File;
112
116
  /** Destination folder (the folder being viewed when the upload started); `null` is the root folder. */
113
117
  parentId: string | null;
114
118
  }
115
- /** Arguments of `SdFileExplorerOption.download`. */
116
- interface SdFileExplorerDownloadArgs extends SdFileExplorerTransferArgs {
119
+ /** Arguments of `SdFileExplorerOption<T>.download`. */
120
+ interface SdFileExplorerDownloadArgs<T = unknown> extends SdFileExplorerTransferArgs {
117
121
  /** File to download. */
118
- item: SdFileExplorerItem;
122
+ item: SdFileExplorerItem<T>;
119
123
  }
120
- /** Arguments of `SdFileExplorerOption.share`. */
121
- interface SdFileExplorerShareArgs {
124
+ /** Arguments of `SdFileExplorerOption<T>.share`. */
125
+ interface SdFileExplorerShareArgs<T = unknown> {
122
126
  /** File to share. */
123
- item: SdFileExplorerItem;
127
+ item: SdFileExplorerItem<T>;
124
128
  /** Aborted when the user closes the share dialog before the link is ready, or the explorer is destroyed. */
125
129
  signal: AbortSignal;
126
130
  }
127
- /** Arguments of `SdFileExplorerOption.createFolder`. */
131
+ /** Arguments of `SdFileExplorerOption<T>.createFolder`. */
128
132
  interface SdFileExplorerCreateFolderArgs {
129
133
  /** Folder that receives the new folder (the folder being viewed); `null` is the root folder. */
130
134
  parentId: string | null;
@@ -133,6 +137,118 @@ interface SdFileExplorerCreateFolderArgs {
133
137
  }
134
138
  /** Layout of the item area. */
135
139
  type SdFileExplorerView = 'list' | 'grid';
140
+ /**
141
+ * Static or per-context state of an explorer action (`hidden`, `disabled`, `loading`).
142
+ *
143
+ * A function receives the same context as the action's `click`: the selected files for `selector.actions`, the item
144
+ * of the row, card or tree node for `fileCommands` / `folderCommands`. It is evaluated while rendering and again
145
+ * right before `click` runs; read Angular signals inside it so the explorer re-renders when the state changes.
146
+ */
147
+ type SdFileExplorerState<T> = boolean | ((context: T) => boolean);
148
+ /** Appearance and state shared by every explorer action, flat button or group. */
149
+ interface SdFileExplorerActionAppearance<T> {
150
+ /**
151
+ * Label of selector buttons, label-only commands, menu items and drawer entries. File/folder command buttons with
152
+ * icons show their declared icons and use `tooltip ?? title` as their tooltip and accessible name. Without a title, a menu
153
+ * item or drawer entry shows its tooltip. A command without an icon shows `title ?? tooltip`. Every definition
154
+ * needs a `title` or a `tooltip`.
155
+ */
156
+ title?: string;
157
+ /** Tooltip, and the accessible name of an icon-only button. */
158
+ tooltip?: string;
159
+ /** Icon before the label. A group without one shows `more_vert`. */
160
+ prefixIcon?: string;
161
+ /** Icon after the label. */
162
+ suffixIcon?: string;
163
+ /** Icon set of `prefixIcon` / `suffixIcon`. Defaults to the app icon provider. */
164
+ fontSet?: SdIconSet;
165
+ /**
166
+ * Semantic color, as on `sd-button` (`primary`, `secondary`, `info`, `success`, `warning`, `error`, `black`). Use
167
+ * `'error'` for destructive actions. Unset: `primary` in `selector.actions`, `secondary` in commands; menu items stay
168
+ * neutral. In the compact command drawer it colors the icons only, like on menu items, and unset stays neutral.
169
+ */
170
+ color?: SdButtonColor;
171
+ /**
172
+ * `sd-button` variant: `fill`, `light`, `outline` or `text`. Desktop buttons only: ignored for menu items and in the
173
+ * compact command drawer. Unset: `light` for a flat selector action, `text` for a selector group trigger and for
174
+ * every file / folder command.
175
+ */
176
+ type?: SdButtonType;
177
+ /** Removes the action. A group whose children are all hidden is removed too. */
178
+ hidden?: SdFileExplorerState<T>;
179
+ /** Keeps the action visible but blocks it. */
180
+ disabled?: SdFileExplorerState<T>;
181
+ /** Shows a spinner and blocks the action while your own work runs. A loading menu item is also disabled. */
182
+ loading?: SdFileExplorerState<T>;
183
+ }
184
+ /** Legacy callable leaf contract. Consumers may extend this interface and invoke `click` directly. */
185
+ interface SdFileExplorerActionLeaf<T> extends SdFileExplorerActionAppearance<T> {
186
+ click: (context: T) => void;
187
+ onClick?: never;
188
+ children?: never;
189
+ }
190
+ /** A configured leaf accepts the canonical `onClick` callback or the legacy callable `click` contract. */
191
+ type SdFileExplorerActionLeafDefinition<T> = SdFileExplorerActionLeaf<T> | (SdFileExplorerActionAppearance<T> & {
192
+ onClick: (context: T) => void;
193
+ click?: never;
194
+ children?: never;
195
+ });
196
+ /** Button that only opens a menu of leaves. Groups are one level deep. */
197
+ interface SdFileExplorerActionGroup<T> extends SdFileExplorerActionAppearance<T> {
198
+ /** Menu items in display order. Leaves only: a group cannot contain another group. */
199
+ children: readonly SdFileExplorerActionLeaf<T>[];
200
+ click?: never;
201
+ onClick?: never;
202
+ }
203
+ /** Configured one-level menu; both canonical and legacy leaf callbacks are accepted. */
204
+ interface SdFileExplorerActionGroupDefinition<T> extends SdFileExplorerActionAppearance<T> {
205
+ children: readonly SdFileExplorerActionLeafDefinition<T>[];
206
+ click?: never;
207
+ onClick?: never;
208
+ }
209
+ /**
210
+ * One entry of `selector.actions`, `fileCommands` or `folderCommands`: a leaf with `click`, or a group with
211
+ * `children`. Siblings render in the declared order; the explorer never moves them into an overflow menu.
212
+ */
213
+ type SdFileExplorerAction<T> = SdFileExplorerActionLeafDefinition<T> | SdFileExplorerActionGroupDefinition<T>;
214
+ /** Action on the selected files. `click` receives a frozen snapshot of the selection. */
215
+ type SdFileExplorerSelectionAction<T = unknown> = SdFileExplorerAction<readonly SdFileExplorerItem<T>[]>;
216
+ /** Action on one file or folder. `click` receives the item exactly as returned by `list` or `search`. */
217
+ type SdFileExplorerCommand<T = unknown> = SdFileExplorerAction<SdFileExplorerItem<T>>;
218
+ /**
219
+ * Multi-file selection of `<sd-file-explorer>`.
220
+ *
221
+ * Only the files visible in the current folder or search results can be selected — never folders, never items of
222
+ * other folders. The selection survives switching between list and grid and opening a file, and is cleared when the
223
+ * folder, the search keyword or `list` changes, or on `reload()`. A file that a refresh drops or that `disabled`
224
+ * starts locking leaves the selection without a callback and is not selected again when it comes back.
225
+ */
226
+ interface SdFileExplorerSelector<T = unknown> {
227
+ /** Allows selection when useful actions or an explicit picker contract exist. @defaultValue `true` */
228
+ visible?: boolean;
229
+ /**
230
+ * `actions` requires a usable configured selection action; `picker` deliberately allows selection without actions.
231
+ * When omitted, existing `onSelect` / `onSelectAll` callbacks retain picker behavior; other selectors use `actions`.
232
+ */
233
+ mode?: 'actions' | 'picker';
234
+ /**
235
+ * Actions on the selected files, shown in the selection band while at least one file is selected. Without `type`,
236
+ * a flat action is `light` and a group trigger `text`; without `color`, both are `primary`.
237
+ * Omitted in action mode: configured move/share/download callbacks provide the default actions. An explicit `[]`
238
+ * suppresses those defaults. Static hidden actions and empty groups do not enable selection; disabled/loading
239
+ * actions still do. A `hidden` predicate controls the action for the current selection, without removing checkboxes
240
+ * or clearing intermediate selections. Withdraw the action configuration or use `visible: false` to disable selection.
241
+ */
242
+ actions?: readonly SdFileExplorerSelectionAction<T>[];
243
+ /** Files for which it returns `true` show a disabled checkbox and are left out of "select all". */
244
+ disabled?: (item: SdFileExplorerItem<T>) => boolean;
245
+ /** Called after a file checkbox is toggled, with the file and the new selection. */
246
+ onSelect?: (item: SdFileExplorerItem<T>, selectedItems: readonly SdFileExplorerItem<T>[]) => void;
247
+ /** Called once after the select-all checkbox selects every eligible file or deselects them all (`[]`). */
248
+ onSelectAll?: (selectedItems: readonly SdFileExplorerItem<T>[]) => void;
249
+ /** Called once when a non-empty selection is cleared: the band's clear button, or a folder / search / `list` change or `reload()`. */
250
+ onClear?: () => void;
251
+ }
136
252
  /**
137
253
  * Configuration of `<sd-file-explorer>`.
138
254
  *
@@ -146,7 +262,7 @@ type SdFileExplorerView = 'list' | 'grid';
146
262
  *
147
263
  * @example
148
264
  * ```ts
149
- * readonly option: SdFileExplorerOption = {
265
+ * readonly option: SdFileExplorerOption<T> = {
150
266
  * title: 'My files',
151
267
  * list: ({ parentId, signal }) => firstValueFrom(this.api.children(parentId, { signal })),
152
268
  * search: ({ parentId, keyword }) => firstValueFrom(this.api.search(parentId, keyword)),
@@ -158,14 +274,22 @@ type SdFileExplorerView = 'list' | 'grid';
158
274
  * };
159
275
  * ```
160
276
  */
161
- interface SdFileExplorerOption {
277
+ interface SdFileExplorerOption<T = unknown> {
278
+ /** Canonical grouped callbacks; an explicit group wins over its legacy root callback. */
279
+ capabilities?: SdFileExplorerCapabilities<T>;
280
+ /** Opt-in file move; caller performs the storage mutation. */
281
+ move?: {
282
+ movable?: SdFileExplorerState<SdFileExplorerMoveRequest<T>>;
283
+ onMove: (request: SdFileExplorerMoveRequest<T>) => boolean | void | Promise<boolean | void>;
284
+ };
285
+ dataSource?: never;
162
286
  /**
163
287
  * Returns the direct children (files and folders) of a folder. Required.
164
288
  *
165
289
  * Called lazily: once per folder when it is first opened or expanded in the tree, then cached until
166
290
  * `reload()` or a successful upload / folder creation in that folder. `parentId` is `null` for the root.
167
291
  */
168
- list: (args: SdFileExplorerListArgs) => SdFileExplorerItem[] | Promise<SdFileExplorerItem[]>;
292
+ list: (args: SdFileExplorerListArgs) => SdFileExplorerItem<T>[] | Promise<SdFileExplorerItem<T>[]>;
169
293
  /**
170
294
  * Server-side search inside the current folder. Called 300 ms after the user stops typing, and only for a
171
295
  * non-empty keyword; stale requests are aborted and their results ignored.
@@ -173,7 +297,7 @@ interface SdFileExplorerOption {
173
297
  * When omitted, the search box filters the already loaded children of the current folder by name
174
298
  * (case- and Vietnamese-accent-insensitive) without calling any callback.
175
299
  */
176
- search?: (args: SdFileExplorerSearchArgs) => SdFileExplorerItem[] | Promise<SdFileExplorerItem[]>;
300
+ search?: (args: SdFileExplorerSearchArgs) => SdFileExplorerItem<T>[] | Promise<SdFileExplorerItem<T>[]>;
177
301
  /**
178
302
  * Resolves the content shown in the detail drawer when a file is opened.
179
303
  *
@@ -181,7 +305,7 @@ interface SdFileExplorerOption {
181
305
  * preview a PDF do not download PDF.js). Return `null`/`undefined` — or omit the callback — to show the
182
306
  * "no preview" fallback. Other formats always show the fallback with a download button.
183
307
  */
184
- preview?: (args: SdFileExplorerPreviewArgs) => SdFileExplorerPreviewSource | null | undefined | Promise<SdFileExplorerPreviewSource | null | undefined>;
308
+ preview?: (args: SdFileExplorerPreviewArgs<T>) => SdFileExplorerPreviewSource | null | undefined | Promise<SdFileExplorerPreviewSource | null | undefined>;
185
309
  /**
186
310
  * Downloads a file. Enables the download buttons in list, grid and preview.
187
311
  *
@@ -189,7 +313,7 @@ interface SdFileExplorerOption {
189
313
  * - Return nothing: you handed the download to the browser yourself (for example `window.open(url)` or an
190
314
  * anchor with `download`). The transfer is then marked "handed to the browser" without a fake percentage.
191
315
  */
192
- download?: (args: SdFileExplorerDownloadArgs) => Blob | void | Promise<Blob | void>;
316
+ download?: (args: SdFileExplorerDownloadArgs<T>) => Blob | void | Promise<Blob | void>;
193
317
  /**
194
318
  * Creates a shareable link for a file and returns its URL. Enables the "Share" buttons (list rows and
195
319
  * detail drawer).
@@ -198,7 +322,7 @@ interface SdFileExplorerOption {
198
322
  * explicit click, so it works even when the callback takes a while. Throw (or reject) to show the error
199
323
  * `message` with a retry button. Expiry, permissions or audience stay in your API.
200
324
  */
201
- share?: (args: SdFileExplorerShareArgs) => string | Promise<string>;
325
+ share?: (args: SdFileExplorerShareArgs<T>) => string | Promise<string>;
202
326
  /**
203
327
  * Uploads one file into `parentId`. Enables the upload button and drag-and-drop.
204
328
  *
@@ -206,12 +330,12 @@ interface SdFileExplorerOption {
206
330
  * destination folder is listed again. Throw (or reject) to mark the transfer as failed — the error `message`
207
331
  * is shown as the failure reason and the user can retry.
208
332
  */
209
- upload?: (args: SdFileExplorerUploadArgs) => SdFileExplorerItem | void | Promise<SdFileExplorerItem | void>;
333
+ upload?: (args: SdFileExplorerUploadArgs) => SdFileExplorerItem<T> | void | Promise<SdFileExplorerItem<T> | void>;
210
334
  /**
211
335
  * Creates a folder inside the current folder. Enables the "New folder" button.
212
336
  * After success the current folder is listed again. Throw (or reject) to keep the dialog open with the error.
213
337
  */
214
- createFolder?: (args: SdFileExplorerCreateFolderArgs) => SdFileExplorerItem | void | Promise<SdFileExplorerItem | void>;
338
+ createFolder?: (args: SdFileExplorerCreateFolderArgs) => SdFileExplorerItem<T> | void | Promise<SdFileExplorerItem<T> | void>;
215
339
  /** Heading shown in the explorer header. When omitted the header shows only search and upload. */
216
340
  title?: string;
217
341
  /** Secondary line under `title`. Ignored when `title` is omitted. */
@@ -220,6 +344,22 @@ interface SdFileExplorerOption {
220
344
  rootLabel?: string;
221
345
  /** Initial layout of the item area. The user can switch afterwards. @defaultValue `'list'` */
222
346
  defaultView?: SdFileExplorerView;
347
+ /**
348
+ * Multi-file selection: checkboxes on files, a select-all checkbox in the list header (above the grid) and a
349
+ * selection band with `selector.actions`. See `SdFileExplorerSelector<T>`.
350
+ */
351
+ selector?: SdFileExplorerSelector<T>;
352
+ /**
353
+ * Actions on one file, in list rows and grid cards — in the compact layout, in the command drawer each row or card
354
+ * opens. Declaring it — even as `[]` — replaces the row download and share shortcuts, in that drawer too; the detail
355
+ * drawer keeps its own Download and Share buttons.
356
+ */
357
+ fileCommands?: readonly SdFileExplorerCommand<T>[];
358
+ /**
359
+ * Actions on one folder, in list rows, grid cards and the folder tree (never on the root) — in the compact layout,
360
+ * in the command drawer each row, card or tree node opens.
361
+ */
362
+ folderCommands?: readonly SdFileExplorerCommand<T>[];
223
363
  /** E2E scope. Produces `data-autoid="components-file-explorer-{autoId}"` and derived child ids. */
224
364
  autoId?: string;
225
365
  }
@@ -230,11 +370,11 @@ interface SdFileExplorerOption {
230
370
  * grid or search results). Not emitted for folders, which navigate instead, nor when the detail drawer
231
371
  * re-renders or reloads.
232
372
  */
233
- interface SdFileExplorerOpenEvent {
373
+ interface SdFileExplorerOpenEvent<T = unknown> {
234
374
  /** The file that was opened. */
235
- item: SdFileExplorerItem;
375
+ item: SdFileExplorerItem<T>;
236
376
  /** Folders from the root (excluded) down to the folder being viewed when the file was opened. */
237
- path: readonly SdFileExplorerItem[];
377
+ path: readonly SdFileExplorerItem<T>[];
238
378
  }
239
379
  /** Direction of a transfer shown in the transfer panel. */
240
380
  type SdFileExplorerTransferDirection = 'upload' | 'download';
@@ -270,6 +410,67 @@ interface SdFileExplorerTransfer {
270
410
  /** Reason of the failure when `status` is `'error'`. */
271
411
  readonly error?: unknown;
272
412
  }
413
+ /** File-only, consumer-controlled move. Abort is cooperative, not rollback. */
414
+ interface SdFileExplorerMoveRequest<T = unknown> {
415
+ readonly items: readonly SdFileExplorerItem<T>[];
416
+ readonly targetFolder: SdFileExplorerItem<T> | null;
417
+ readonly source: 'drag' | 'menu' | 'keyboard' | 'api';
418
+ readonly signal: AbortSignal;
419
+ }
420
+ interface SdFileExplorerCapabilities<T = unknown> {
421
+ share?: {
422
+ shareable?: SdFileExplorerState<SdFileExplorerItem<T>>;
423
+ onShare: NonNullable<SdFileExplorerOption<T>['share']>;
424
+ };
425
+ download?: {
426
+ downloadable?: SdFileExplorerState<SdFileExplorerItem<T>>;
427
+ onDownload: NonNullable<SdFileExplorerOption<T>['download']>;
428
+ };
429
+ preview?: {
430
+ previewable?: SdFileExplorerState<SdFileExplorerItem<T>>;
431
+ onPreview: NonNullable<SdFileExplorerOption<T>['preview']>;
432
+ };
433
+ upload?: {
434
+ uploadable?: SdFileExplorerState<{
435
+ parentId: string | null;
436
+ }>;
437
+ onUpload: NonNullable<SdFileExplorerOption<T>['upload']>;
438
+ };
439
+ createFolder?: {
440
+ creatable?: SdFileExplorerState<{
441
+ parentId: string | null;
442
+ }>;
443
+ onCreateFolder: NonNullable<SdFileExplorerOption<T>['createFolder']>;
444
+ };
445
+ }
446
+ /** New source-only surface. Legacy source callbacks remain callable on SdFileExplorerOption. */
447
+ interface SdFileExplorerDataSourceOption<T = unknown> extends Omit<SdFileExplorerOption<T>, 'list' | 'search' | 'dataSource'> {
448
+ dataSource: {
449
+ onList: SdFileExplorerOption<T>['list'];
450
+ onSearch?: SdFileExplorerOption<T>['search'];
451
+ };
452
+ list?: never;
453
+ search?: never;
454
+ }
455
+ type SdFileExplorerConfig<T = unknown> = SdFileExplorerOption<T> | SdFileExplorerDataSourceOption<T>;
456
+
457
+ interface SdFileExplorerColumnContext<T = unknown> {
458
+ $implicit: SdFileExplorerItem<T>;
459
+ item: SdFileExplorerItem<T>;
460
+ data: T | undefined;
461
+ index: number;
462
+ }
463
+ /** List-only custom metadata column. Pass the parent option as its required type anchor. */
464
+ declare class SdFileExplorerColumnDef<T = unknown> {
465
+ readonly id: _angular_core.InputSignal<string>;
466
+ readonly for: _angular_core.InputSignal<SdFileExplorerConfig<T>>;
467
+ readonly title: _angular_core.InputSignal<string>;
468
+ readonly width: _angular_core.InputSignal<string>;
469
+ readonly template: TemplateRef<SdFileExplorerColumnContext<T>>;
470
+ static ngTemplateContextGuard<T>(_directive: SdFileExplorerColumnDef<T>, _context: unknown): _context is SdFileExplorerColumnContext<T>;
471
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdFileExplorerColumnDef<any>, never>;
472
+ static ɵdir: _angular_core.ɵɵDirectiveDeclaration<SdFileExplorerColumnDef<any>, "ng-template[sdFileExplorerColumnDef]", never, { "id": { "alias": "sdFileExplorerColumnDef"; "required": true; "isSignal": true; }; "for": { "alias": "sdFileExplorerColumnFor"; "required": true; "isSignal": true; }; "title": { "alias": "title"; "required": true; "isSignal": true; }; "width": { "alias": "width"; "required": false; "isSignal": true; }; }, {}, never, never, true, never>;
473
+ }
273
474
 
274
475
  /** Name of a built-in SdFileExplorer file-type icon. */
275
476
  type SdFileExplorerIconName = 'file-3d' | 'file-7z' | 'file-ai' | 'file-app' | 'file-archive' | 'file-audio' | 'file-book' | 'file-code' | 'file-css' | 'file-csv' | 'file-design' | 'file-document' | 'file-figma' | 'file-font' | 'file-generic' | 'file-gif' | 'file-html' | 'file-image' | 'file-jpg' | 'file-js' | 'file-json' | 'file-markdown' | 'file-mov' | 'file-mp3' | 'file-mp4' | 'file-pdf' | 'file-png' | 'file-presentation' | 'file-psd' | 'file-python' | 'file-rar' | 'file-spreadsheet' | 'file-sql' | 'file-svg' | 'file-tar' | 'file-text' | 'file-ts' | 'file-video' | 'file-wav' | 'file-webp' | 'file-xml' | 'file-yaml' | 'file-zip' | 'folder-closed' | 'folder-open';
@@ -278,13 +479,13 @@ type SdFileExplorerIconName = 'file-3d' | 'file-7z' | 'file-ai' | 'file-app' | '
278
479
  type SdFileExplorerFileType = 'folder' | 'image' | 'pdf' | 'spreadsheet' | 'document' | 'presentation' | 'video' | 'audio' | 'archive' | 'text' | 'other';
279
480
 
280
481
  /** One visible row of the folder tree (the tree is rendered flat, depth carried by `level`). */
281
- interface SdFileExplorerTreeNode {
482
+ interface SdFileExplorerTreeNode<T = unknown> {
282
483
  /** Unique key: `root` for the root folder, `f:<id>` for folders. */
283
484
  readonly key: string;
284
485
  /** Folder id; `null` for the root. */
285
486
  readonly id: string | null;
286
487
  /** Folder item; `null` for the root. */
287
- readonly item: SdFileExplorerItem | null;
488
+ readonly item: SdFileExplorerItem<T> | null;
288
489
  readonly name: string;
289
490
  /** 1-based depth, rendered as `aria-level`. The root is level 1. */
290
491
  readonly level: number;
@@ -296,8 +497,11 @@ interface SdFileExplorerTreeNode {
296
497
  readonly autoId?: string;
297
498
  }
298
499
  /** One item of the list / grid, with every display string already formatted. */
299
- interface SdFileExplorerItemView {
300
- readonly item: SdFileExplorerItem;
500
+ interface SdFileExplorerItemView<T = unknown> {
501
+ readonly downloadDisabled?: boolean;
502
+ readonly shareDisabled?: boolean;
503
+ readonly unavailableReason?: string;
504
+ readonly item: SdFileExplorerItem<T>;
301
505
  readonly type: SdFileExplorerFileType;
302
506
  /** Built-in glyph resolved from the extension / MIME type. */
303
507
  readonly icon: SdFileExplorerIconName;
@@ -307,6 +511,66 @@ interface SdFileExplorerItemView {
307
511
  readonly modifiedTitle: string;
308
512
  readonly downloadLabel: string;
309
513
  readonly shareLabel: string;
514
+ /** Accessible name of the selection checkbox of a file. */
515
+ readonly selectLabel: string;
516
+ /** Accessible name of the compact trigger that opens the item's command drawer. */
517
+ readonly actionsLabel: string;
518
+ readonly autoId?: string;
519
+ }
520
+ /** Command of the compact command drawer, with its states evaluated for the drawer's item. */
521
+ interface SdFileExplorerSheetCommand<T = unknown> {
522
+ readonly kind: 'leaf';
523
+ /** Declared index (`share` / `download` for the row shortcuts): tracks the entry and suffixes its autoId. */
524
+ readonly key: string;
525
+ /** The title, or the tooltip of a definition without title. */
526
+ readonly label: string;
527
+ readonly prefixIcon: string | undefined;
528
+ readonly suffixIcon: string | undefined;
529
+ readonly fontSet: SdIconSet | undefined;
530
+ /** Declared color. It paints the icons only; unset keeps them neutral, like Core menu items. */
531
+ readonly color: SdButtonColor | undefined;
532
+ /** Disabled, loading, or inside a disabled or loading group. */
533
+ readonly disabled: boolean;
534
+ readonly loading: boolean;
535
+ readonly definition: SdFileExplorerActionLeafDefinition<SdFileExplorerItem<T>>;
536
+ }
537
+ /**
538
+ * Group of the compact command drawer: a section listing its visible children under a text-only heading. The heading is
539
+ * not a control, so it carries no icon or color: the group's `prefixIcon` (often the icon of one of its children) and
540
+ * the desktop `more_vert` face stay on the desktop trigger.
541
+ */
542
+ interface SdFileExplorerSheetGroup<T = unknown> {
543
+ readonly kind: 'group';
544
+ readonly key: string;
545
+ readonly label: string;
546
+ readonly disabled: boolean;
547
+ readonly loading: boolean;
548
+ readonly definition: SdFileExplorerActionGroupDefinition<SdFileExplorerItem<T>>;
549
+ /** Never empty. */
550
+ readonly children: readonly SdFileExplorerSheetCommand<T>[];
551
+ }
552
+ type SdFileExplorerSheetEntry<T = unknown> = SdFileExplorerSheetCommand<T> | SdFileExplorerSheetGroup<T>;
553
+ /** Content of the compact command drawer for one item. */
554
+ interface SdFileExplorerCommandSheetView<T = unknown> {
555
+ /** Full item name: the drawer title, wrapped rather than cut. */
556
+ readonly title: string;
557
+ /** Type and size of the item, under the title. */
558
+ readonly context: string;
559
+ readonly icon: SdFileExplorerIconName;
560
+ /** Never empty. */
561
+ readonly entries: readonly SdFileExplorerSheetEntry<T>[];
562
+ }
563
+ /** Selection handed to the item list while the selector is on and the current view holds files. */
564
+ interface SdFileExplorerSelectionView {
565
+ readonly selectedIds: ReadonlySet<string>;
566
+ /** Files whose checkbox `selector.disabled` locks. */
567
+ readonly disabledIds: ReadonlySet<string>;
568
+ /** Select-all checkbox: none (unchecked), some (mixed) or all eligible files are selected. */
569
+ readonly state: 'none' | 'some' | 'all';
570
+ /** Visible files that can be selected. */
571
+ readonly eligibleCount: number;
572
+ /** Accessible name and tooltip of the select-all checkbox. */
573
+ readonly allLabel: string;
310
574
  readonly autoId?: string;
311
575
  }
312
576
  /** One card of the transfer panel. */
@@ -368,26 +632,98 @@ interface SdFileExplorerMetaRow {
368
632
  readonly value: string;
369
633
  }
370
634
 
635
+ /** Entry pressed in the drawer, with the group it belongs to. */
636
+ interface SdFileExplorerSheetActivation<T = unknown> {
637
+ readonly command: SdFileExplorerSheetCommand<T>;
638
+ readonly group: SdFileExplorerSheetGroup<T> | null;
639
+ }
640
+ /**
641
+ * Command drawer of the compact layout (internal): the commands of one item in a Core `<sd-side-drawer>` that covers
642
+ * the viewport — portalled to `<body>`, with its backdrop, `Escape`, close button, focus trap and page scroll lock.
643
+ *
644
+ * The explorer owns the item and decides when the drawer opens and closes: `show()` / `hide()`. The drawer lists the
645
+ * same commands as the desktop buttons, as menu-like entries; a group is a labelled section with its children. A
646
+ * pressed entry is only reported (`activate`): the explorer checks it again, closes the drawer and runs it. `close`
647
+ * reports that the user closed the drawer (close button, `Escape`, backdrop).
648
+ *
649
+ * Content projected into the drawer belongs to this view, so its encapsulated styles still apply in `<body>`; the
650
+ * drawer element itself is styled through the class this component passes as `drawerClass`.
651
+ */
652
+ declare class SdFileExplorerCommandSheet<T = unknown> {
653
+ #private;
654
+ /** Content for the item whose commands are shown; `null` while nothing is open. */
655
+ readonly sheet: _angular_core.InputSignal<SdFileExplorerCommandSheetView<T> | null>;
656
+ /** Touch screen: 48 px entries and a 44 px close button. */
657
+ readonly touch: _angular_core.InputSignal<boolean>;
658
+ /** E2E scope of the content and its entries. */
659
+ readonly autoId: _angular_core.InputSignal<string | undefined>;
660
+ /** An entry was pressed. Nothing has run yet. */
661
+ readonly activate: _angular_core.OutputEmitterRef<SdFileExplorerSheetActivation<T>>;
662
+ /** The user closed the drawer (close button, `Escape` or backdrop). */
663
+ readonly close: _angular_core.OutputEmitterRef<void>;
664
+ private readonly drawer;
665
+ protected readonly width = "min(400px, calc(100vw - 56px))";
666
+ protected readonly sheetId: string;
667
+ protected readonly drawerClass: _angular_core.Signal<{
668
+ 'sd-file-explorer-command-drawer': boolean;
669
+ 'sd-file-explorer-command-drawer--touch': boolean;
670
+ }>;
671
+ protected readonly drawerAutoId: _angular_core.Signal<string | undefined>;
672
+ protected readonly loadingLabel: _angular_core.Signal<string>;
673
+ /** Opens the drawer; its content follows `sheet`. */
674
+ show(): void;
675
+ /** Closes the drawer at once — focus trap, backdrop and page scroll lock included — without reporting `close`. */
676
+ hide(): void;
677
+ protected accent(color: string | undefined): string | null;
678
+ protected onDrawerClosed(): void;
679
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdFileExplorerCommandSheet<any>, never>;
680
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdFileExplorerCommandSheet<any>, "sd-file-explorer-command-sheet", never, { "sheet": { "alias": "sheet"; "required": false; "isSignal": true; }; "touch": { "alias": "touch"; "required": false; "isSignal": true; }; "autoId": { "alias": "autoId"; "required": false; "isSignal": true; }; }, { "activate": "activate"; "close": "close"; }, never, never, true, never>;
681
+ }
682
+
683
+ /** Where a compact command drawer was opened: a list row, a grid card or a tree node. */
684
+ type CommandOrigin = SdFileExplorerView | 'tree';
371
685
  /**
372
686
  * Google-Drive-like file browser: folder tree, breadcrumb, list / grid, search, file detail drawer, uploads with
373
687
  * drag-and-drop, downloads and a transfer queue — all inside one element.
374
688
  *
375
- * Storage-agnostic: every read and write goes through the callbacks of `SdFileExplorerOption`.
689
+ * Storage-agnostic: every read and write goes through the callbacks of `SdFileExplorerOption<T>`.
376
690
  *
377
691
  * @example
378
692
  * ```html
379
693
  * <sd-file-explorer [option]="option" (open)="onOpen($event)" />
380
694
  * ```
381
695
  */
382
- declare class SdFileExplorer {
696
+ declare class SdFileExplorer<T = unknown> {
383
697
  #private;
384
- /** Data callbacks and display settings. See `SdFileExplorerOption`. */
385
- readonly option: _angular_core.InputSignal<SdFileExplorerOption>;
698
+ protected readonly movePending: WritableSignal<boolean>;
699
+ protected readonly moveStatus: WritableSignal<string>;
700
+ protected readonly moveRefreshError: WritableSignal<boolean>;
701
+ protected readonly movePickerItems: WritableSignal<readonly SdFileExplorerItem<T>[] | null>;
702
+ protected readonly moveTarget: WritableSignal<SdFileExplorerItem<T> | null>;
703
+ protected readonly moveDropTarget: WritableSignal<string | null | undefined>;
704
+ protected readonly canMove: Signal<boolean>;
705
+ protected readonly movePickerNodes: Signal<{
706
+ selected: boolean;
707
+ key: string;
708
+ id: string | null;
709
+ item: SdFileExplorerItem<T> | null;
710
+ name: string;
711
+ level: number;
712
+ expandable: boolean;
713
+ expanded: boolean;
714
+ status: "idle" | "loading" | "error";
715
+ autoId?: string;
716
+ }[]>;
717
+ protected readonly canSubmitMove: Signal<boolean>;
718
+ protected readonly columnDefs: Signal<readonly SdFileExplorerColumnDef<T>[]>;
719
+ protected readonly columns: Signal<SdFileExplorerColumnDef<T>[]>;
720
+ /** Data callbacks and display settings. See `SdFileExplorerOption<T>`. */
721
+ readonly option: _angular_core.InputSignal<SdFileExplorerConfig<T>>;
386
722
  /**
387
723
  * Emitted exactly once each time the user opens a file (click, `Enter` or `Space` on a file in the list,
388
724
  * grid or search results), right before the detail drawer starts loading. Never emitted for folders.
389
725
  */
390
- readonly open: _angular_core.OutputEmitterRef<SdFileExplorerOpenEvent>;
726
+ readonly open: _angular_core.OutputEmitterRef<SdFileExplorerOpenEvent<T>>;
391
727
  protected readonly view: WritableSignal<SdFileExplorerView>;
392
728
  protected readonly keyword: WritableSignal<string>;
393
729
  protected readonly previewState: WritableSignal<SdFileExplorerPreviewState>;
@@ -399,7 +735,7 @@ declare class SdFileExplorer {
399
735
  protected readonly folderSubmitting: WritableSignal<boolean>;
400
736
  protected readonly folderError: WritableSignal<string>;
401
737
  /** File whose share dialog is open. */
402
- protected readonly shareItem: WritableSignal<SdFileExplorerItem | null>;
738
+ protected readonly shareItem: WritableSignal<SdFileExplorerItem<T> | null>;
403
739
  protected readonly shareState: WritableSignal<SdFileExplorerShareState>;
404
740
  /** Result of the last copy attempt: copied to the clipboard, or selected for a manual Ctrl+C. */
405
741
  protected readonly shareFeedback: WritableSignal<SdFileExplorerShareFeedback>;
@@ -415,8 +751,10 @@ declare class SdFileExplorer {
415
751
  protected readonly shareInput: Signal<ElementRef<HTMLInputElement> | undefined>;
416
752
  protected readonly shareDialog: Signal<ElementRef<HTMLElement> | undefined>;
417
753
  protected readonly sidebar: Signal<ElementRef<HTMLElement> | undefined>;
754
+ protected readonly commandDrawer: Signal<SdFileExplorerCommandSheet<any> | undefined>;
418
755
  protected readonly instanceId: string;
419
756
  protected readonly compact: Signal<boolean>;
757
+ protected readonly touch: Signal<boolean>;
420
758
  readonly autoId: Signal<string | undefined>;
421
759
  protected readonly locale: Signal<string>;
422
760
  protected readonly rootLabel: Signal<string>;
@@ -424,9 +762,35 @@ declare class SdFileExplorer {
424
762
  protected readonly canDownload: Signal<boolean>;
425
763
  protected readonly canCreateFolder: Signal<boolean>;
426
764
  protected readonly canShare: Signal<boolean>;
765
+ protected readonly uploadDisabled: Signal<boolean>;
766
+ protected readonly createDisabled: Signal<boolean>;
427
767
  protected readonly currentName: Signal<string>;
428
768
  protected readonly searching: Signal<boolean>;
429
- protected readonly itemViews: Signal<readonly SdFileExplorerItemView[]>;
769
+ protected readonly itemViews: Signal<readonly SdFileExplorerItemView<T>[]>;
770
+ /** The row download / share shortcuts stay until the consumer declares `fileCommands` (even `[]`). */
771
+ protected readonly rowShortcuts: Signal<boolean>;
772
+ /** Selection actions remain caller-owned when declared, including an intentional empty array. */
773
+ protected readonly selectionActions: Signal<readonly SdFileExplorerSelectionAction<T>[]>;
774
+ /**
775
+ * Frozen snapshot of the selection handed to callbacks and actions: selected files that are still visible and
776
+ * eligible, in display order. A file that a refresh drops, or that becomes disabled, leaves it.
777
+ */
778
+ protected readonly selectedItems: Signal<readonly SdFileExplorerItem<T>[]>;
779
+ /** Selection state of the item list; `null` (no checkbox, no band) without selector or without files in view. */
780
+ protected readonly selectionView: Signal<SdFileExplorerSelectionView | null>;
781
+ /**
782
+ * Status sentence of the band, split around the number so the template can set it in semibold: "2 tệp đã chọn",
783
+ * "已选择 2 个文件". Nothing selected: `count` is 0 and `before` holds the whole sentence.
784
+ */
785
+ protected readonly selectionSummary: Signal<{
786
+ count: number;
787
+ before: string;
788
+ after: string;
789
+ }>;
790
+ /** Content of the drawer: the item's commands resolved for it now; `null` when nothing is left to show. */
791
+ protected readonly commandSheet: Signal<SdFileExplorerCommandSheetView<T> | null>;
792
+ protected readonly itemsMenuOpenId: Signal<string | null>;
793
+ protected readonly treeMenuOpenId: Signal<string | null>;
430
794
  protected readonly contentState: Signal<SdFileExplorerContentState>;
431
795
  protected readonly refreshing: Signal<boolean>;
432
796
  protected readonly errorMessage: Signal<string>;
@@ -441,30 +805,43 @@ declare class SdFileExplorer {
441
805
  /** Breadcrumb trail plus the folder each entry navigates to. */
442
806
  protected readonly breadcrumb: Signal<{
443
807
  items: SdBreadcrumbItem[];
444
- targets: Map<SdBreadcrumbItem, SdFileExplorerItem | null>;
808
+ targets: Map<SdBreadcrumbItem, SdFileExplorerItem<T> | null>;
445
809
  }>;
446
- protected readonly treeNodes: Signal<readonly SdFileExplorerTreeNode[]>;
447
- protected readonly previewView: Signal<SdFileExplorerItemView | null>;
810
+ protected readonly treeNodes: Signal<readonly SdFileExplorerTreeNode<T>[]>;
811
+ protected readonly previewView: Signal<SdFileExplorerItemView<T> | null>;
448
812
  protected readonly previewMeta: Signal<readonly SdFileExplorerMetaRow[]>;
449
813
  protected readonly transferViews: Signal<readonly SdFileExplorerTransferView[]>;
450
814
  protected readonly transfersTitle: Signal<string>;
451
815
  protected readonly canClearTransfers: Signal<boolean>;
452
816
  constructor();
817
+ /** Moves visible files through the caller's storage callback. False includes cancellation, rejection or refresh failure. */
818
+ moveFiles(items: readonly SdFileExplorerItem<T>[], targetFolder: SdFileExplorerItem<T> | null, source?: SdFileExplorerMoveRequest<T>['source']): Promise<boolean>;
819
+ /** Cooperatively aborts the current mutation. A consumer may already have committed its storage change. */
820
+ cancelMove(): void;
821
+ /** Repeats failed listing only; never calls onMove again. */
822
+ retryMoveRefresh(): Promise<boolean>;
823
+ protected openMovePicker(items: readonly SdFileExplorerItem<T>[], event?: Event): void;
824
+ protected closeMovePicker(): void;
825
+ protected submitMoveFromEvent(event: Event): void;
826
+ protected submitMove(source?: 'menu' | 'keyboard'): Promise<void>;
827
+ protected onMoveDragStart(event: DragEvent): void;
828
+ protected onMoveDragEnd(): void;
453
829
  /**
454
830
  * Lists the current folder again and drops the cached children of folders that are neither open in the
455
- * tree nor on the current path. Re-runs the active search, if any.
831
+ * tree nor on the current path. Re-runs the active search, if any. Clears the file selection and closes the command
832
+ * drawer of the compact layout.
456
833
  */
457
834
  reload(): void;
458
- protected navigate(folder: SdFileExplorerItem | null): void;
835
+ protected navigate(folder: SdFileExplorerItem<T> | null): void;
459
836
  protected onBreadcrumb(entry: SdBreadcrumbItem): void;
460
- protected onTreeSelect(node: SdFileExplorerTreeNode): void;
461
- protected onTreeToggle(node: SdFileExplorerTreeNode): void;
462
- protected onTreeRetry(node: SdFileExplorerTreeNode): void;
837
+ protected onTreeSelect(node: SdFileExplorerTreeNode<T>): void;
838
+ protected onTreeToggle(node: SdFileExplorerTreeNode<T>): void;
839
+ protected onTreeRetry(node: SdFileExplorerTreeNode<T>): void;
463
840
  protected retryContent(): void;
464
841
  protected toggleSidebar(): void;
465
842
  protected setView(view: SdFileExplorerView): void;
466
- protected onActivate(view: SdFileExplorerItemView): void;
467
- protected openFile(item: SdFileExplorerItem): void;
843
+ protected onActivate(view: SdFileExplorerItemView<T>): void;
844
+ protected openFile(item: SdFileExplorerItem<T>): void;
468
845
  /**
469
846
  * Closes the detail drawer. Focus goes back to the row / card that opened it: `sd-side-drawer` restores the
470
847
  * previously focused element when its focus trap closes.
@@ -472,9 +849,24 @@ declare class SdFileExplorer {
472
849
  protected closePreview(): void;
473
850
  protected retryPreview(): void;
474
851
  protected onPreviewImageError(): void;
475
- protected downloadItem(item: SdFileExplorerItem): void;
852
+ protected downloadItem(item: SdFileExplorerItem<T>): void;
476
853
  protected downloadPreview(): void;
477
854
  protected sharePreview(): void;
855
+ protected toggleSelection(item: SdFileExplorerItem<T>): void;
856
+ protected toggleSelectAll(): void;
857
+ protected clearSelection(): void;
858
+ protected openCommands(item: SdFileExplorerItem<T>, origin: CommandOrigin, trigger: HTMLElement): void;
859
+ /** The user closed the drawer (close button, `Escape`, backdrop). */
860
+ protected onCommandsClosed(): void;
861
+ /**
862
+ * Runs a command pressed in the drawer. The press is checked against the current item, definitions and states: a
863
+ * stale entry, a state the consumer changed since the last render or a second press runs nothing.
864
+ *
865
+ * The drawer closes first, at once. The command runs after the next render: by then the drawer's focus trap is gone
866
+ * and has handed focus back, so it cannot pull focus away from a dialog or a preview the command opens. Right before
867
+ * it runs, the same check is made again, and `click` receives the item as listed at that moment.
868
+ */
869
+ protected runCommand({ command, group }: SdFileExplorerSheetActivation): void;
478
870
  protected onKeywordInput(value: string): void;
479
871
  protected clearSearch(): void;
480
872
  protected onFilesPicked(input: HTMLInputElement): void;
@@ -489,15 +881,15 @@ declare class SdFileExplorer {
489
881
  protected clearFinishedTransfers(): void;
490
882
  protected openFolderDialog(): void;
491
883
  protected closeFolderDialog(): void;
492
- protected openShare(item: SdFileExplorerItem): void;
884
+ protected openShare(item: SdFileExplorerItem<T>): void;
493
885
  protected retryShare(): void;
494
886
  protected closeShare(): void;
495
887
  protected copyShareLink(): Promise<void>;
496
888
  protected submitFolder(event: Event): Promise<void>;
497
889
  protected onEscape(event: Event): void;
498
- static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdFileExplorer, never>;
499
- static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdFileExplorer, "sd-file-explorer", never, { "option": { "alias": "option"; "required": true; "isSignal": true; }; }, { "open": "open"; }, never, never, true, never>;
890
+ static ɵfac: _angular_core.ɵɵFactoryDeclaration<SdFileExplorer<any>, never>;
891
+ static ɵcmp: _angular_core.ɵɵComponentDeclaration<SdFileExplorer<any>, "sd-file-explorer", never, { "option": { "alias": "option"; "required": true; "isSignal": true; }; }, { "open": "open"; }, ["columnDefs"], never, true, never>;
500
892
  }
501
893
 
502
- export { SdFileExplorer };
503
- export type { SdFileExplorerCreateFolderArgs, SdFileExplorerDownloadArgs, SdFileExplorerItem, SdFileExplorerItemKind, SdFileExplorerListArgs, SdFileExplorerOpenEvent, SdFileExplorerOption, SdFileExplorerPreviewArgs, SdFileExplorerPreviewSource, SdFileExplorerProgressReporter, SdFileExplorerSearchArgs, SdFileExplorerShareArgs, SdFileExplorerTransfer, SdFileExplorerTransferArgs, SdFileExplorerTransferDirection, SdFileExplorerTransferStatus, SdFileExplorerUploadArgs, SdFileExplorerView };
894
+ export { SdFileExplorer, SdFileExplorerColumnDef };
895
+ export type { SdFileExplorerAction, SdFileExplorerActionAppearance, SdFileExplorerActionGroup, SdFileExplorerActionGroupDefinition, SdFileExplorerActionLeaf, SdFileExplorerActionLeafDefinition, SdFileExplorerCapabilities, SdFileExplorerColumnContext, SdFileExplorerCommand, SdFileExplorerConfig, SdFileExplorerCreateFolderArgs, SdFileExplorerDataSourceOption, SdFileExplorerDownloadArgs, SdFileExplorerItem, SdFileExplorerItemKind, SdFileExplorerListArgs, SdFileExplorerMoveRequest, SdFileExplorerOpenEvent, SdFileExplorerOption, SdFileExplorerPreviewArgs, SdFileExplorerPreviewSource, SdFileExplorerProgressReporter, SdFileExplorerSearchArgs, SdFileExplorerSelectionAction, SdFileExplorerSelector, SdFileExplorerShareArgs, SdFileExplorerState, SdFileExplorerTransfer, SdFileExplorerTransferArgs, SdFileExplorerTransferDirection, SdFileExplorerTransferStatus, SdFileExplorerUploadArgs, SdFileExplorerView };