@sdcorejs/angular 21.2.15 → 21.3.1

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