@sdcorejs/angular 19.2.15 → 19.3.0

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 (365) hide show
  1. package/README.md +7 -5
  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/components/breadcrumb/src/breadcrumb.component.d.ts +2 -1
  22. package/components/data-state/src/data-state.component.d.ts +6 -2
  23. package/components/file-explorer/src/components/preview-panel.component.d.ts +6 -3
  24. package/components/file-explorer/src/file-explorer.utils.d.ts +1 -3
  25. package/components/file-explorer/src/file-explorer.view-model.d.ts +3 -0
  26. package/components/form-generic/index.d.ts +1 -1
  27. package/components/form-generic/src/components/form-builder/canvas/canvas.component.d.ts +86 -0
  28. package/components/form-generic/src/components/form-builder/canvas/drop-feedback.component.d.ts +42 -0
  29. package/components/form-generic/src/components/form-builder/canvas/field-preview.component.d.ts +43 -0
  30. package/components/form-generic/src/components/form-builder/components/attribute-expression/attribute-expression.component.d.ts +34 -17
  31. package/components/form-generic/src/components/form-builder/components/attribute-parameter/attribute-parameter.component.d.ts +12 -31
  32. package/components/form-generic/src/components/form-builder/components/attribute-selection/components/build-queries/build-queries.component.d.ts +64 -30
  33. package/components/form-generic/src/components/form-builder/components/attribute-selection/components/build-variables/build-variables.component.d.ts +46 -36
  34. package/components/form-generic/src/components/form-builder/components/configure-validation/configure-validation.component.d.ts +34 -22
  35. package/components/form-generic/src/components/form-builder/components/html/attribute/components/build-queries/build-queries.component.d.ts +21 -33
  36. package/components/form-generic/src/components/form-builder/components/value-box/mapping-box.component.d.ts +12 -0
  37. package/components/form-generic/src/components/form-builder/components/value-box/mapping-summary.d.ts +17 -0
  38. package/components/form-generic/src/components/form-builder/components/value-box/value-box.component.d.ts +24 -0
  39. package/components/form-generic/src/components/form-builder/form-builder.component.d.ts +89 -160
  40. package/components/form-generic/src/components/form-builder/inspector/inspector.component.d.ts +208 -0
  41. package/components/form-generic/src/components/form-builder/inspector/options-editor.component.d.ts +32 -0
  42. package/components/form-generic/src/components/form-builder/inspector/toggle-row.component.d.ts +17 -0
  43. package/components/form-generic/src/components/form-builder/palette/palette.component.d.ts +50 -0
  44. package/components/form-generic/src/components/form-builder/palette/structure.component.d.ts +36 -0
  45. package/components/form-generic/src/components/form-builder/preview/preview.component.d.ts +38 -0
  46. package/components/form-generic/src/components/form-builder/state/builder-commands.d.ts +61 -0
  47. package/components/form-generic/src/components/form-builder/state/builder-document.d.ts +81 -0
  48. package/components/form-generic/src/components/form-builder/state/builder-drag.d.ts +55 -0
  49. package/components/form-generic/src/components/form-builder/state/builder-history.d.ts +33 -0
  50. package/components/form-generic/src/components/form-builder/state/builder-html.d.ts +6 -0
  51. package/components/form-generic/src/components/form-builder/state/builder-layout.d.ts +132 -0
  52. package/components/form-generic/src/components/form-builder/state/builder-palette.d.ts +39 -0
  53. package/components/form-generic/src/components/form-builder/state/builder-store.d.ts +125 -0
  54. package/components/form-generic/src/components/form-render/components/index.d.ts +0 -1
  55. package/components/form-generic/src/components/form-render/components/item/components/checkbox/checkbox.component.d.ts +10 -29
  56. package/components/form-generic/src/components/form-render/components/item/components/chip-calendar/chip-calendar.component.d.ts +11 -26
  57. package/components/form-generic/src/components/form-render/components/item/components/chip-string/chip-string.component.d.ts +11 -26
  58. package/components/form-generic/src/components/form-render/components/item/components/datetime/datetime.component.d.ts +14 -29
  59. package/components/form-generic/src/components/form-render/components/item/components/html/html.component.d.ts +14 -28
  60. package/components/form-generic/src/components/form-render/components/item/components/index.d.ts +0 -1
  61. package/components/form-generic/src/components/form-render/components/item/components/number/number.component.d.ts +21 -26
  62. package/components/form-generic/src/components/form-render/components/item/components/radio/radio.component.d.ts +15 -32
  63. package/components/form-generic/src/components/form-render/components/item/components/select/select.component.d.ts +17 -37
  64. package/components/form-generic/src/components/form-render/components/item/components/textarea/textarea.component.d.ts +11 -26
  65. package/components/form-generic/src/components/form-render/components/item/components/textfield/textfield.component.d.ts +29 -28
  66. package/components/form-generic/src/components/form-render/components/item/components/upload/upload.component.d.ts +15 -32
  67. package/components/form-generic/src/components/form-render/components/item/item.component.d.ts +16 -27
  68. package/components/form-generic/src/components/form-render/form-render-catalog.d.ts +19 -0
  69. package/components/form-generic/src/components/form-render/form-render.component.d.ts +79 -31
  70. package/components/form-generic/src/components/form-render/form-render.context.d.ts +24 -0
  71. package/components/form-generic/src/components/index.d.ts +0 -1
  72. package/components/form-generic/src/configurations/form-generic-breakpoints.d.ts +15 -0
  73. package/components/form-generic/src/configurations/form-generic-config.token.d.ts +17 -0
  74. package/components/form-generic/src/configurations/form-generic.provider.d.ts +17 -0
  75. package/components/form-generic/src/configurations/index.d.ts +3 -2
  76. package/components/form-generic/src/layout/form-generic-layout.d.ts +29 -0
  77. package/components/form-generic/src/models/form-generic-config.model.d.ts +83 -0
  78. package/components/form-generic/src/models/form-generic-field.model.d.ts +148 -0
  79. package/components/form-generic/src/models/form-generic-schema.d.ts +36 -0
  80. package/components/form-generic/src/models/form-generic-schema.model.d.ts +72 -0
  81. package/components/form-generic/src/models/index.d.ts +4 -9
  82. package/components/form-generic/src/pipes/component-viewed.pipe.d.ts +4 -7
  83. package/components/form-generic/src/pipes/html.pipe.d.ts +3 -5
  84. package/components/form-generic/src/pipes/hyperlink.pipe.d.ts +7 -2
  85. package/components/form-generic/src/pipes/index.d.ts +0 -4
  86. package/components/form-generic/src/presets/form-generic-presets.d.ts +56 -0
  87. package/components/form-generic/src/rules/form-generic-display.d.ts +23 -0
  88. package/components/form-generic/src/rules/form-generic-filter.d.ts +34 -0
  89. package/components/form-generic/src/rules/form-generic-references.d.ts +15 -0
  90. package/components/form-generic/src/rules/form-generic-validation.d.ts +24 -0
  91. package/components/form-generic/src/rules/form-generic-values.d.ts +23 -0
  92. package/components/form-generic/src/services/form-generic.service.d.ts +14 -18
  93. package/components/form-generic/src/services/form-render.service.d.ts +8 -5
  94. package/components/highlight/index.d.ts +1 -0
  95. package/components/highlight/src/highlight.component.d.ts +23 -0
  96. package/components/image-editor/index.d.ts +2 -0
  97. package/components/image-editor/src/image-editor.component.d.ts +194 -0
  98. package/components/image-editor/src/image-editor.export.d.ts +52 -0
  99. package/components/image-editor/src/image-editor.geometry.d.ts +113 -0
  100. package/components/image-editor/src/image-editor.model.d.ts +265 -0
  101. package/components/image-editor/src/image-editor.source.d.ts +58 -0
  102. package/components/image-editor/src/image-editor.state.d.ts +64 -0
  103. package/components/index.d.ts +2 -0
  104. package/components/inform/src/inform.component.d.ts +5 -2
  105. package/components/mini-editor/src/mini-editor.component.d.ts +1 -1
  106. package/components/preview/index.d.ts +1 -0
  107. package/components/preview/src/preview-video/preview-video.component.d.ts +49 -0
  108. package/components/query-builder/src/query-builder.model.d.ts +1 -1
  109. package/components/section/src/section.component.d.ts +5 -1
  110. package/components/table/src/models/table-option-export.model.d.ts +6 -0
  111. package/components/table/src/services/field-value.util.d.ts +14 -0
  112. package/directives/src/sd-tooltip.directive.d.ts +8 -0
  113. package/fesm2022/sdcorejs-angular-components-anchor.mjs +2 -2
  114. package/fesm2022/sdcorejs-angular-components-anchor.mjs.map +1 -1
  115. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs +6 -6
  116. package/fesm2022/sdcorejs-angular-components-api-contract-builder.mjs.map +1 -1
  117. package/fesm2022/sdcorejs-angular-components-audit-diff.mjs +2 -2
  118. package/fesm2022/sdcorejs-angular-components-audit-diff.mjs.map +1 -1
  119. package/fesm2022/sdcorejs-angular-components-autoid-inspector.mjs +2 -2
  120. package/fesm2022/sdcorejs-angular-components-autoid-inspector.mjs.map +1 -1
  121. package/fesm2022/sdcorejs-angular-components-avatar.mjs +34 -27
  122. package/fesm2022/sdcorejs-angular-components-avatar.mjs.map +1 -1
  123. package/fesm2022/sdcorejs-angular-components-badge.mjs +2 -2
  124. package/fesm2022/sdcorejs-angular-components-badge.mjs.map +1 -1
  125. package/fesm2022/sdcorejs-angular-components-breadcrumb.mjs +35 -5
  126. package/fesm2022/sdcorejs-angular-components-breadcrumb.mjs.map +1 -1
  127. package/fesm2022/sdcorejs-angular-components-button.mjs +13 -11
  128. package/fesm2022/sdcorejs-angular-components-button.mjs.map +1 -1
  129. package/fesm2022/sdcorejs-angular-components-card.mjs +2 -2
  130. package/fesm2022/sdcorejs-angular-components-card.mjs.map +1 -1
  131. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs +2 -2
  132. package/fesm2022/sdcorejs-angular-components-ckeditor-styles.mjs.map +1 -1
  133. package/fesm2022/sdcorejs-angular-components-code-editor.mjs +2 -2
  134. package/fesm2022/sdcorejs-angular-components-code-editor.mjs.map +1 -1
  135. package/fesm2022/sdcorejs-angular-components-data-state.mjs +7 -3
  136. package/fesm2022/sdcorejs-angular-components-data-state.mjs.map +1 -1
  137. package/fesm2022/sdcorejs-angular-components-editor.mjs +12 -4
  138. package/fesm2022/sdcorejs-angular-components-editor.mjs.map +1 -1
  139. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs +105 -50
  140. package/fesm2022/sdcorejs-angular-components-file-explorer.mjs.map +1 -1
  141. package/fesm2022/sdcorejs-angular-components-form-generic.mjs +5853 -6511
  142. package/fesm2022/sdcorejs-angular-components-form-generic.mjs.map +1 -1
  143. package/fesm2022/sdcorejs-angular-components-highlight.mjs +63 -0
  144. package/fesm2022/sdcorejs-angular-components-highlight.mjs.map +1 -0
  145. package/fesm2022/sdcorejs-angular-components-history.mjs +2 -2
  146. package/fesm2022/sdcorejs-angular-components-history.mjs.map +1 -1
  147. package/fesm2022/sdcorejs-angular-components-image-editor.mjs +2088 -0
  148. package/fesm2022/sdcorejs-angular-components-image-editor.mjs.map +1 -0
  149. package/fesm2022/sdcorejs-angular-components-import-excel.mjs +2 -2
  150. package/fesm2022/sdcorejs-angular-components-import-excel.mjs.map +1 -1
  151. package/fesm2022/sdcorejs-angular-components-inform.mjs +8 -4
  152. package/fesm2022/sdcorejs-angular-components-inform.mjs.map +1 -1
  153. package/fesm2022/sdcorejs-angular-components-job-progress.mjs +2 -2
  154. package/fesm2022/sdcorejs-angular-components-job-progress.mjs.map +1 -1
  155. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs +40 -22
  156. package/fesm2022/sdcorejs-angular-components-mini-editor.mjs.map +1 -1
  157. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs +2 -2
  158. package/fesm2022/sdcorejs-angular-components-modal-resizable.mjs.map +1 -1
  159. package/fesm2022/sdcorejs-angular-components-modal.mjs +2 -2
  160. package/fesm2022/sdcorejs-angular-components-modal.mjs.map +1 -1
  161. package/fesm2022/sdcorejs-angular-components-operator.mjs +2 -2
  162. package/fesm2022/sdcorejs-angular-components-operator.mjs.map +1 -1
  163. package/fesm2022/sdcorejs-angular-components-org-chart.mjs +2 -2
  164. package/fesm2022/sdcorejs-angular-components-org-chart.mjs.map +1 -1
  165. package/fesm2022/sdcorejs-angular-components-preview.mjs +129 -7
  166. package/fesm2022/sdcorejs-angular-components-preview.mjs.map +1 -1
  167. package/fesm2022/sdcorejs-angular-components-query-bar.mjs +33 -24
  168. package/fesm2022/sdcorejs-angular-components-query-bar.mjs.map +1 -1
  169. package/fesm2022/sdcorejs-angular-components-query-builder.mjs +2 -2
  170. package/fesm2022/sdcorejs-angular-components-query-builder.mjs.map +1 -1
  171. package/fesm2022/sdcorejs-angular-components-quick-action.mjs +2 -2
  172. package/fesm2022/sdcorejs-angular-components-quick-action.mjs.map +1 -1
  173. package/fesm2022/sdcorejs-angular-components-section.mjs +10 -6
  174. package/fesm2022/sdcorejs-angular-components-section.mjs.map +1 -1
  175. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs +28 -4
  176. package/fesm2022/sdcorejs-angular-components-side-drawer.mjs.map +1 -1
  177. package/fesm2022/sdcorejs-angular-components-splitter.mjs +2 -2
  178. package/fesm2022/sdcorejs-angular-components-splitter.mjs.map +1 -1
  179. package/fesm2022/sdcorejs-angular-components-stepper.mjs +2 -2
  180. package/fesm2022/sdcorejs-angular-components-stepper.mjs.map +1 -1
  181. package/fesm2022/sdcorejs-angular-components-tab-router.mjs +4 -4
  182. package/fesm2022/sdcorejs-angular-components-tab-router.mjs.map +1 -1
  183. package/fesm2022/sdcorejs-angular-components-tab.mjs +2 -2
  184. package/fesm2022/sdcorejs-angular-components-tab.mjs.map +1 -1
  185. package/fesm2022/sdcorejs-angular-components-table.mjs +308 -113
  186. package/fesm2022/sdcorejs-angular-components-table.mjs.map +1 -1
  187. package/fesm2022/sdcorejs-angular-components-tree.mjs +2 -2
  188. package/fesm2022/sdcorejs-angular-components-tree.mjs.map +1 -1
  189. package/fesm2022/sdcorejs-angular-components-upload-file.mjs +14 -5
  190. package/fesm2022/sdcorejs-angular-components-upload-file.mjs.map +1 -1
  191. package/fesm2022/sdcorejs-angular-components.mjs +2 -0
  192. package/fesm2022/sdcorejs-angular-components.mjs.map +1 -1
  193. package/fesm2022/sdcorejs-angular-directives.mjs +98 -12
  194. package/fesm2022/sdcorejs-angular-directives.mjs.map +1 -1
  195. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs +148 -5
  196. package/fesm2022/sdcorejs-angular-forms-autocomplete.mjs.map +1 -1
  197. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs +18 -3
  198. package/fesm2022/sdcorejs-angular-forms-chip-calendar.mjs.map +1 -1
  199. package/fesm2022/sdcorejs-angular-forms-chip.mjs +18 -3
  200. package/fesm2022/sdcorejs-angular-forms-chip.mjs.map +1 -1
  201. package/fesm2022/sdcorejs-angular-forms-date-range.mjs +2 -2
  202. package/fesm2022/sdcorejs-angular-forms-date-range.mjs.map +1 -1
  203. package/fesm2022/sdcorejs-angular-forms-date.mjs +16 -6
  204. package/fesm2022/sdcorejs-angular-forms-date.mjs.map +1 -1
  205. package/fesm2022/sdcorejs-angular-forms-datetime.mjs +16 -6
  206. package/fesm2022/sdcorejs-angular-forms-datetime.mjs.map +1 -1
  207. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs +2 -2
  208. package/fesm2022/sdcorejs-angular-forms-entity-picker.mjs.map +1 -1
  209. package/fesm2022/sdcorejs-angular-forms-inline-text.mjs +3 -3
  210. package/fesm2022/sdcorejs-angular-forms-inline-text.mjs.map +1 -1
  211. package/fesm2022/sdcorejs-angular-forms-input-color.mjs +2 -2
  212. package/fesm2022/sdcorejs-angular-forms-input-color.mjs.map +1 -1
  213. package/fesm2022/sdcorejs-angular-forms-input-number.mjs +17 -3
  214. package/fesm2022/sdcorejs-angular-forms-input-number.mjs.map +1 -1
  215. package/fesm2022/sdcorejs-angular-forms-input.mjs +28 -4
  216. package/fesm2022/sdcorejs-angular-forms-input.mjs.map +1 -1
  217. package/fesm2022/sdcorejs-angular-forms-label.mjs +27 -2
  218. package/fesm2022/sdcorejs-angular-forms-label.mjs.map +1 -1
  219. package/fesm2022/sdcorejs-angular-forms-radio.mjs +1 -1
  220. package/fesm2022/sdcorejs-angular-forms-radio.mjs.map +1 -1
  221. package/fesm2022/sdcorejs-angular-forms-select.mjs +497 -6
  222. package/fesm2022/sdcorejs-angular-forms-select.mjs.map +1 -1
  223. package/fesm2022/sdcorejs-angular-forms-switch.mjs +1 -1
  224. package/fesm2022/sdcorejs-angular-forms-switch.mjs.map +1 -1
  225. package/fesm2022/sdcorejs-angular-forms-textarea.mjs +21 -3
  226. package/fesm2022/sdcorejs-angular-forms-textarea.mjs.map +1 -1
  227. package/fesm2022/sdcorejs-angular-forms-time-range.mjs +2 -2
  228. package/fesm2022/sdcorejs-angular-forms-time-range.mjs.map +1 -1
  229. package/fesm2022/sdcorejs-angular-forms-time.mjs +2 -2
  230. package/fesm2022/sdcorejs-angular-forms-time.mjs.map +1 -1
  231. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs +1 -1
  232. package/fesm2022/sdcorejs-angular-forms-tree-select.mjs.map +1 -1
  233. package/fesm2022/sdcorejs-angular-i18n.mjs +1429 -271
  234. package/fesm2022/sdcorejs-angular-i18n.mjs.map +1 -1
  235. package/fesm2022/sdcorejs-angular-modules-auth.mjs +35 -3
  236. package/fesm2022/sdcorejs-angular-modules-auth.mjs.map +1 -1
  237. package/fesm2022/sdcorejs-angular-modules-icon.mjs +19 -0
  238. package/fesm2022/sdcorejs-angular-modules-icon.mjs.map +1 -1
  239. package/fesm2022/sdcorejs-angular-modules-layout.mjs +39 -48
  240. package/fesm2022/sdcorejs-angular-modules-layout.mjs.map +1 -1
  241. package/fesm2022/sdcorejs-angular-modules-permission.mjs.map +1 -1
  242. package/fesm2022/sdcorejs-angular-services-api.mjs +196 -8
  243. package/fesm2022/sdcorejs-angular-services-api.mjs.map +1 -1
  244. package/fesm2022/sdcorejs-angular-services-confirm.mjs +10 -3
  245. package/fesm2022/sdcorejs-angular-services-confirm.mjs.map +1 -1
  246. package/fesm2022/sdcorejs-angular-services-excel.mjs +5 -0
  247. package/fesm2022/sdcorejs-angular-services-excel.mjs.map +1 -1
  248. package/fesm2022/sdcorejs-angular-services-loading.mjs +1 -1
  249. package/fesm2022/sdcorejs-angular-services-loading.mjs.map +1 -1
  250. package/fesm2022/sdcorejs-angular-services-notify.mjs +107 -7
  251. package/fesm2022/sdcorejs-angular-services-notify.mjs.map +1 -1
  252. package/fesm2022/sdcorejs-angular-utilities-extensions.mjs +458 -1
  253. package/fesm2022/sdcorejs-angular-utilities-extensions.mjs.map +1 -1
  254. package/fesm2022/sdcorejs-angular-utilities-theme.mjs +169 -0
  255. package/fesm2022/sdcorejs-angular-utilities-theme.mjs.map +1 -0
  256. package/fesm2022/sdcorejs-angular-utilities.mjs +1 -0
  257. package/fesm2022/sdcorejs-angular-utilities.mjs.map +1 -1
  258. package/forms/autocomplete/src/autocomplete.component.d.ts +19 -1
  259. package/forms/chip/src/chip.component.d.ts +13 -1
  260. package/forms/chip-calendar/src/chip-calendar.component.d.ts +13 -1
  261. package/forms/date/src/date.component.d.ts +7 -1
  262. package/forms/datetime/src/datetime.component.d.ts +7 -1
  263. package/forms/inline-text/src/inline-text.component.d.ts +1 -1
  264. package/forms/input/src/input.component.d.ts +21 -4
  265. package/forms/input-number/src/input-number.component.d.ts +12 -1
  266. package/forms/label/src/label.component.d.ts +16 -1
  267. package/forms/models/index.d.ts +1 -0
  268. package/forms/models/src/sd-label-placement.d.ts +14 -0
  269. package/forms/select/src/select.component.d.ts +66 -3
  270. package/forms/textarea/src/textarea.component.d.ts +9 -1
  271. package/i18n/src/en.d.ts +280 -54
  272. package/i18n/src/i18n.service.d.ts +5 -0
  273. package/modules/auth/configurations/auth.configuration.d.ts +4 -3
  274. package/modules/icon/src/icon.model.d.ts +10 -0
  275. package/modules/layout/configurations/layout.configuration.d.ts +2 -2
  276. package/modules/permission/src/configurations/permission.configuration.d.ts +3 -2
  277. package/package.json +18 -6
  278. package/services/api/index.d.ts +1 -0
  279. package/services/api/src/api-handler-registry.d.ts +49 -0
  280. package/services/api/src/api-host.d.ts +15 -0
  281. package/services/api/src/api-route-configurations.d.ts +20 -0
  282. package/services/confirm/src/lib/components/dialog-confirm/dialog-confirm.component.d.ts +3 -0
  283. package/services/confirm/src/lib/confirm.service.d.ts +13 -0
  284. package/services/notify/src/components/toast/toast.component.d.ts +8 -0
  285. package/services/notify/src/components/toast-container.component.d.ts +11 -2
  286. package/services/notify/src/notify.model.d.ts +8 -0
  287. package/utilities/extensions/index.d.ts +2 -0
  288. package/utilities/extensions/src/editor-html-sanitizer.d.ts +13 -0
  289. package/utilities/extensions/src/text-search.d.ts +34 -0
  290. package/utilities/extensions/src/url-safety.d.ts +17 -0
  291. package/utilities/index.d.ts +1 -0
  292. package/utilities/theme/index.d.ts +1 -0
  293. package/utilities/theme/src/theme-tokens.d.ts +22 -0
  294. package/components/form-generic/src/components/form-builder/components/attribute-expression/form-expression-query-adapter.d.ts +0 -6
  295. package/components/form-generic/src/components/form-builder/components/attribute-input/attribute-input.component.d.ts +0 -16
  296. package/components/form-generic/src/components/form-builder/components/attribute-input-number/attribute-input-number.component.d.ts +0 -13
  297. package/components/form-generic/src/components/form-builder/components/attribute-select/attribute-select.component.d.ts +0 -25
  298. package/components/form-generic/src/components/form-builder/components/attribute-selection/attribute-selection.component.d.ts +0 -27
  299. package/components/form-generic/src/components/form-builder/components/attribute-switch/attribute-switch.component.d.ts +0 -13
  300. package/components/form-generic/src/components/form-builder/components/attribute-table/attribute-table.component.d.ts +0 -33
  301. package/components/form-generic/src/components/form-builder/components/attribute-template/attribute-template.component.d.ts +0 -12
  302. package/components/form-generic/src/components/form-builder/components/attribute-textarea/attribute-textarea.component.d.ts +0 -16
  303. package/components/form-generic/src/components/form-builder/components/checkbox/attribute/checkbox-attribute.component.d.ts +0 -21
  304. package/components/form-generic/src/components/form-builder/components/checkbox/control/checkbox-control.component.d.ts +0 -8
  305. package/components/form-generic/src/components/form-builder/components/checkbox/index.d.ts +0 -2
  306. package/components/form-generic/src/components/form-builder/components/chip-calendar/attribute/chip-calendar-attribute.component.d.ts +0 -22
  307. package/components/form-generic/src/components/form-builder/components/chip-calendar/control/chip-calendar-control.component.d.ts +0 -16
  308. package/components/form-generic/src/components/form-builder/components/chip-calendar/index.d.ts +0 -2
  309. package/components/form-generic/src/components/form-builder/components/chip-string/attribute/chip-string-attribute.component.d.ts +0 -22
  310. package/components/form-generic/src/components/form-builder/components/chip-string/control/chip-string-control.component.d.ts +0 -16
  311. package/components/form-generic/src/components/form-builder/components/chip-string/index.d.ts +0 -2
  312. package/components/form-generic/src/components/form-builder/components/datetime/attribute/datetime-attribute.component.d.ts +0 -21
  313. package/components/form-generic/src/components/form-builder/components/datetime/control/datetime-control.component.d.ts +0 -18
  314. package/components/form-generic/src/components/form-builder/components/datetime/index.d.ts +0 -2
  315. package/components/form-generic/src/components/form-builder/components/expression-builder/expression-builder.component.d.ts +0 -49
  316. package/components/form-generic/src/components/form-builder/components/group/attribute/group-attribute.component.d.ts +0 -24
  317. package/components/form-generic/src/components/form-builder/components/group/index.d.ts +0 -1
  318. package/components/form-generic/src/components/form-builder/components/html/attribute/html-attribute.component.d.ts +0 -29
  319. package/components/form-generic/src/components/form-builder/components/html/control/html-control.component.d.ts +0 -19
  320. package/components/form-generic/src/components/form-builder/components/html/index.d.ts +0 -2
  321. package/components/form-generic/src/components/form-builder/components/index.d.ts +0 -13
  322. package/components/form-generic/src/components/form-builder/components/number/attribute/number-attribute.component.d.ts +0 -22
  323. package/components/form-generic/src/components/form-builder/components/number/control/number-control.component.d.ts +0 -17
  324. package/components/form-generic/src/components/form-builder/components/number/index.d.ts +0 -2
  325. package/components/form-generic/src/components/form-builder/components/radio/attribute/radio-attribute.component.d.ts +0 -22
  326. package/components/form-generic/src/components/form-builder/components/radio/control/radio-control.component.d.ts +0 -16
  327. package/components/form-generic/src/components/form-builder/components/radio/index.d.ts +0 -2
  328. package/components/form-generic/src/components/form-builder/components/select/attribute/select-attribute.component.d.ts +0 -22
  329. package/components/form-generic/src/components/form-builder/components/select/control/select-control.component.d.ts +0 -16
  330. package/components/form-generic/src/components/form-builder/components/select/index.d.ts +0 -2
  331. package/components/form-generic/src/components/form-builder/components/table/attribute/table-attribute.component.d.ts +0 -22
  332. package/components/form-generic/src/components/form-builder/components/table/control/table-control.component.d.ts +0 -19
  333. package/components/form-generic/src/components/form-builder/components/table/index.d.ts +0 -2
  334. package/components/form-generic/src/components/form-builder/components/textarea/attribute/textarea-attribute.component.d.ts +0 -21
  335. package/components/form-generic/src/components/form-builder/components/textarea/control/textarea-control.component.d.ts +0 -16
  336. package/components/form-generic/src/components/form-builder/components/textarea/index.d.ts +0 -2
  337. package/components/form-generic/src/components/form-builder/components/textfield/attribute/textfield-attribute.component.d.ts +0 -21
  338. package/components/form-generic/src/components/form-builder/components/textfield/control/textfield-control.component.d.ts +0 -16
  339. package/components/form-generic/src/components/form-builder/components/textfield/index.d.ts +0 -2
  340. package/components/form-generic/src/components/form-builder/components/upload/attribute/upload-attribute.component.d.ts +0 -27
  341. package/components/form-generic/src/components/form-builder/components/upload/control/upload-control.component.d.ts +0 -16
  342. package/components/form-generic/src/components/form-builder/components/upload/index.d.ts +0 -2
  343. package/components/form-generic/src/components/form-builder/form-builder-layout.d.ts +0 -22
  344. package/components/form-generic/src/components/form-builder/services/builder.service.d.ts +0 -11
  345. package/components/form-generic/src/components/form-builder/services/index.d.ts +0 -1
  346. package/components/form-generic/src/components/form-render/components/item/components/table/table.component.d.ts +0 -56
  347. package/components/form-generic/src/components/form-render/components/variable/variable.component.d.ts +0 -22
  348. package/components/form-generic/src/components/sd-feel-expression/sd-feel-expression.component.d.ts +0 -41
  349. package/components/form-generic/src/configurations/form-generic.configuration.d.ts +0 -6
  350. package/components/form-generic/src/configurations/form.configuration.d.ts +0 -12
  351. package/components/form-generic/src/models/form-generic-component.model.d.ts +0 -319
  352. package/components/form-generic/src/models/form-generic-definition-html.model.d.ts +0 -28
  353. package/components/form-generic/src/models/form-generic-definition-selection.model.d.ts +0 -49
  354. package/components/form-generic/src/models/form-generic-definition-table.model.d.ts +0 -6
  355. package/components/form-generic/src/models/form-generic-expression.model.d.ts +0 -74
  356. package/components/form-generic/src/models/form-generic-template.model.d.ts +0 -6
  357. package/components/form-generic/src/models/form-generic-validation.model.d.ts +0 -30
  358. package/components/form-generic/src/models/form-generic.model.d.ts +0 -7
  359. package/components/form-generic/src/models/form-render/form-render-args.model.d.ts +0 -7
  360. package/components/form-generic/src/models/form-render/form-render-entity.model.d.ts +0 -3
  361. package/components/form-generic/src/models/form-render/index.d.ts +0 -2
  362. package/components/form-generic/src/pipes/expression-feel.pipe.d.ts +0 -10
  363. package/components/form-generic/src/pipes/expression-query.pipe.d.ts +0 -10
  364. package/components/form-generic/src/pipes/expression-view.pipe.d.ts +0 -8
  365. package/components/form-generic/src/pipes/when-expression.pipe.d.ts +0 -13
@@ -0,0 +1,194 @@
1
+ import { ElementRef, Signal, WritableSignal } from '@angular/core';
2
+ import { SdInputNumber } from '@sdcorejs/angular/forms/input-number';
3
+ import { SdImageEditorCropHandle, SdImageEditorOrientationOp, SdImageEditorView } from './image-editor.geometry';
4
+ import type { SdImageEditorEdits, SdImageEditorError, SdImageEditorFormat, SdImageEditorOption, SdImageEditorRect, SdImageEditorResult, SdImageEditorSize, SdImageEditorSourceInfo, SdImageEditorStatus } from './image-editor.model';
5
+ import { SdImageEditorOutputSize } from './image-editor.state';
6
+ import * as i0 from "@angular/core";
7
+ /** Gesture in progress on the stage. */
8
+ type SdImageEditorDragMode = 'move' | 'resize' | 'pan';
9
+ interface RatioChip {
10
+ readonly key: string;
11
+ readonly label: string;
12
+ readonly value: number | null;
13
+ }
14
+ interface FormatChoice {
15
+ readonly format: SdImageEditorFormat;
16
+ readonly label: string;
17
+ readonly disabled: boolean;
18
+ }
19
+ /**
20
+ * Inline image editor: crop (free or fixed ratio), quarter-turn rotation, flips, resize, zoom/pan, undo/redo/reset and
21
+ * the choice of output format and quality. It only edits: the consumer owns the Apply/Cancel buttons and asks for
22
+ * the result with `getResult()`, `getFile()` or `getBlob()`. It never uploads or saves anything.
23
+ *
24
+ * Works inline or inside `sd-modal` / `sd-side-drawer` without extra setup. Pass a `File` or `Blob`: images behind
25
+ * authentication or presigned URLs are fetched by the consumer first.
26
+ *
27
+ * Independent of `sd-upload-file` and `sd-file-explorer` (neither imports it): open it from their keys or `(open)`
28
+ * event, then upload the result as a new file so the original is never overwritten (see `sd-image-editor.md`).
29
+ *
30
+ * @example
31
+ * ```html
32
+ * <sd-image-editor #editor [source]="file" [option]="{ aspectRatio: 1, lockAspectRatio: true, output: { width: 512 } }" />
33
+ * <sd-button type="fill" color="primary" title="Save" [disabled]="editor.status() !== 'ready'" (click)="save(editor)" />
34
+ * ```
35
+ * ```ts
36
+ * async save(editor: SdImageEditor): Promise<void> {
37
+ * const file = await editor.getFile(); // 512 × 512, extension matching the real format
38
+ * await this.api.uploadAvatar(file);
39
+ * }
40
+ * ```
41
+ */
42
+ export declare class SdImageEditor {
43
+ #private;
44
+ /**
45
+ * Image to edit: a `File` or `Blob` holding a still JPEG, PNG or WebP. The editor reads it and never modifies,
46
+ * revokes or re-uploads it. Changing the value discards the current edits; `null` shows the empty state.
47
+ */
48
+ readonly source: import("@angular/core").InputSignal<Blob | null | undefined>;
49
+ /** Ratios, output format/size and limits. See `SdImageEditorOption`. */
50
+ readonly option: import("@angular/core").InputSignal<SdImageEditorOption | null | undefined>;
51
+ /**
52
+ * Emitted when the source cannot be loaded (unsupported, animated, too large, corrupt…), with `stage: 'load'`. The
53
+ * same message is shown in the editor. Export failures reject the promise of `getResult()` instead.
54
+ */
55
+ readonly failed: import("@angular/core").OutputEmitterRef<SdImageEditorError>;
56
+ protected readonly view: WritableSignal<SdImageEditorView>;
57
+ protected readonly dragging: WritableSignal<SdImageEditorDragMode | null>;
58
+ protected readonly format: WritableSignal<SdImageEditorFormat>;
59
+ protected readonly quality: WritableSignal<number>;
60
+ protected readonly background: WritableSignal<string>;
61
+ protected readonly exportError: WritableSignal<SdImageEditorError | null>;
62
+ /** Shown under the size fields when a typed size had to be reduced. */
63
+ protected readonly resizeNotice: WritableSignal<string>;
64
+ protected readonly stage: Signal<ElementRef<HTMLElement> | undefined>;
65
+ protected readonly previewCanvas: Signal<ElementRef<HTMLCanvasElement> | undefined>;
66
+ protected readonly cropBox: Signal<ElementRef<HTMLElement> | undefined>;
67
+ protected readonly instanceId: string;
68
+ protected readonly handles: readonly SdImageEditorCropHandle[];
69
+ /** Current lifecycle state. See `SdImageEditorStatus`. */
70
+ readonly status: Signal<SdImageEditorStatus>;
71
+ /** Current edits (including a drag in progress), or `null` while no image is loaded. */
72
+ readonly edits: Signal<SdImageEditorEdits | null>;
73
+ /** Facts about the loaded source, or `null`. */
74
+ readonly sourceInfo: Signal<SdImageEditorSourceInfo | null>;
75
+ /** Last load or export error, or `null`. */
76
+ readonly error: Signal<SdImageEditorError | null>;
77
+ readonly canUndo: Signal<boolean>;
78
+ readonly canRedo: Signal<boolean>;
79
+ /** The edits differ from the freshly loaded image. */
80
+ readonly dirty: Signal<boolean>;
81
+ readonly autoId: Signal<string | undefined>;
82
+ protected readonly interactive: Signal<boolean>;
83
+ protected readonly busy: Signal<boolean>;
84
+ protected readonly compact: Signal<boolean>;
85
+ protected readonly showRatios: Signal<boolean>;
86
+ /** "Keep ratio" is on: the crop keeps its shape while dragging, typing or rotating. */
87
+ protected readonly ratioLocked: Signal<boolean>;
88
+ /** The ratio is fixed by `option.lockAspectRatio`; the user cannot unlock it. */
89
+ protected readonly ratioFixed: Signal<boolean>;
90
+ protected readonly ratioText: Signal<string>;
91
+ protected readonly ratioChips: Signal<readonly RatioChip[]>;
92
+ protected readonly formatChoices: Signal<FormatChoice[]>;
93
+ protected readonly showFormatPicker: Signal<boolean>;
94
+ protected readonly lossy: Signal<boolean>;
95
+ protected readonly qualityPercent: Signal<number>;
96
+ protected readonly showBackground: Signal<boolean>;
97
+ protected readonly backgroundHex: Signal<string>;
98
+ protected readonly formatLabel: Signal<string>;
99
+ protected readonly formatUnsupported: Signal<boolean>;
100
+ /** CSS transform of the preview canvas: preview pixels → source pixels → oriented image → stage. */
101
+ protected readonly previewTransform: Signal<string>;
102
+ protected readonly previewSize: Signal<SdImageEditorSize>;
103
+ protected readonly imageBox: Signal<SdImageEditorRect | null>;
104
+ protected readonly cropStyle: Signal<SdImageEditorRect | null>;
105
+ protected readonly zoomPercent: Signal<number>;
106
+ protected readonly canZoomIn: Signal<boolean>;
107
+ protected readonly canZoomOut: Signal<boolean>;
108
+ protected readonly isFit: Signal<boolean>;
109
+ protected readonly cropLimits: Signal<{
110
+ maxX: number;
111
+ maxY: number;
112
+ maxWidth: number;
113
+ maxHeight: number;
114
+ } | null>;
115
+ protected readonly cropLabel: Signal<string>;
116
+ protected readonly outputSize: Signal<SdImageEditorOutputSize | null>;
117
+ /** Largest size the user may type for the current crop (no upscaling unless allowed). */
118
+ protected readonly resizeMax: Signal<SdImageEditorSize | null>;
119
+ protected readonly estimateLabel: Signal<string>;
120
+ protected readonly sourceSummary: Signal<string>;
121
+ protected readonly outputSummary: Signal<string>;
122
+ protected readonly statusMessage: Signal<string>;
123
+ constructor();
124
+ /** Steps back one edit. Zoom and pan are not part of the history. */
125
+ undo(): void;
126
+ redo(): void;
127
+ /** Returns to the image as loaded (no crop, rotation, flip or resize). Undoable. */
128
+ reset(): void;
129
+ /** Shows the whole image again. Does not change the edits. */
130
+ fitToView(): void;
131
+ /** Rotates by 90° as the toolbar buttons do. Undoable. */
132
+ rotate(direction: 'left' | 'right'): void;
133
+ /** Mirrors the image as shown, as the toolbar buttons do. Undoable. */
134
+ flip(axis: 'horizontal' | 'vertical'): void;
135
+ /**
136
+ * Encodes the current edits from the full-resolution source and resolves with the image and its facts. Reuses the
137
+ * encoding made for the size preview when nothing changed; concurrent calls share one encoding. While it runs,
138
+ * `status()` is `'exporting'` and the controls are disabled.
139
+ *
140
+ * Rejects with an `SdImageEditorError`: `not-ready` when no image is loaded (or it was replaced meanwhile), or an
141
+ * export code such as `format-unsupported`, `render-failed` or `encode-failed`.
142
+ *
143
+ * @example
144
+ * ```ts
145
+ * try {
146
+ * const result = await this.editor().getResult();
147
+ * await this.api.upload(result.blob, result.fileName);
148
+ * } catch (error) {
149
+ * this.notify.error((error as SdImageEditorError).message);
150
+ * }
151
+ * ```
152
+ */
153
+ getResult(): Promise<SdImageEditorResult>;
154
+ /** `getResult()` then its `blob`. */
155
+ getBlob(): Promise<Blob>;
156
+ /**
157
+ * `getResult()` as a `File`, whatever `output.resultType` says. `fileName` (without extension) overrides
158
+ * `output.fileName`; the extension always matches the encoded format.
159
+ *
160
+ * @example
161
+ * ```ts
162
+ * const file = await this.editor().getFile('receipt-0042'); // receipt-0042.jpg
163
+ * ```
164
+ */
165
+ getFile(fileName?: string): Promise<File>;
166
+ protected operate(op: SdImageEditorOrientationOp): void;
167
+ protected zoomIn(): void;
168
+ protected zoomOut(): void;
169
+ protected selectRatio(value: number | null): void;
170
+ /** Commits a crop field on blur or Enter (not per keystroke, so typing "1280" never passes through "1"). */
171
+ protected onCropField(field: keyof SdImageEditorRect, input: unknown, control?: SdInputNumber): void;
172
+ /** Output width or height, committed on blur or Enter. The other side always follows the crop ratio. */
173
+ protected onResizeField(field: 'width' | 'height', input: unknown, control?: SdInputNumber): void;
174
+ /** "Keep ratio": on locks the current crop shape, off lets the crop be dragged freely. */
175
+ protected toggleKeepRatio(): void;
176
+ /** Output follows the crop again. */
177
+ protected resetResize(): void;
178
+ protected onFormatChange(value: unknown): void;
179
+ protected onQualityInput(value: string): void;
180
+ protected onBackgroundInput(value: string): void;
181
+ protected sameRatio(a: number | null, b: number | null): boolean;
182
+ protected onCropPointerDown(event: PointerEvent, handle: SdImageEditorCropHandle | null): void;
183
+ protected onStagePointerDown(event: PointerEvent): void;
184
+ protected onPointerMove(event: PointerEvent): void;
185
+ protected onPointerUp(event: PointerEvent): void;
186
+ /** The browser took the pointer away (touch interrupted): drop the gesture instead of committing it. */
187
+ protected onPointerCancel(event: PointerEvent): void;
188
+ protected onWheel(event: WheelEvent): void;
189
+ protected onKeydown(event: KeyboardEvent): void;
190
+ protected onCropKeydown(event: KeyboardEvent): void;
191
+ static ɵfac: i0.ɵɵFactoryDeclaration<SdImageEditor, never>;
192
+ static ɵcmp: i0.ɵɵComponentDeclaration<SdImageEditor, "sd-image-editor", never, { "source": { "alias": "source"; "required": false; "isSignal": true; }; "option": { "alias": "option"; "required": false; "isSignal": true; }; }, { "failed": "failed"; }, never, never, true, never>;
193
+ }
194
+ export {};
@@ -0,0 +1,52 @@
1
+ import type { SdImageEditorEdits, SdImageEditorFormat, SdImageEditorSize } from './image-editor.model';
2
+ import { SdImageEditorDecoded } from './image-editor.source';
3
+ export interface SdImageEditorRenderRequest {
4
+ readonly source: Pick<SdImageEditorDecoded, 'image' | 'width' | 'height'>;
5
+ readonly edits: SdImageEditorEdits;
6
+ readonly output: SdImageEditorSize;
7
+ readonly format: SdImageEditorFormat;
8
+ /** 0–1, used for JPEG and WebP only. */
9
+ readonly quality: number;
10
+ /** CSS colour under the image for JPEG. */
11
+ readonly background: string;
12
+ }
13
+ export interface SdImageEditorEncoded {
14
+ readonly blob: Blob;
15
+ /** Format read back from the encoded bytes. */
16
+ readonly format: SdImageEditorFormat;
17
+ }
18
+ /** Draws the edited image at the output size. The caller owns the canvas and must release it. */
19
+ export declare function sdImageEditorRender(doc: Document, request: SdImageEditorRenderRequest): HTMLCanvasElement;
20
+ /**
21
+ * Encodes the canvas and verifies the result: a `null` blob is `encode-failed`, and bytes that are not the
22
+ * requested format (a browser silently falling back to PNG) are `format-unsupported` — never relabelled.
23
+ */
24
+ export declare function sdImageEditorEncode(canvas: HTMLCanvasElement, format: SdImageEditorFormat, quality: number): Promise<SdImageEditorEncoded>;
25
+ /** Renders then encodes, always releasing the output canvas. */
26
+ export declare function sdImageEditorExport(doc: Document, request: SdImageEditorRenderRequest): Promise<SdImageEditorEncoded>;
27
+ export declare function sdImageEditorClampQuality(value: number | undefined): number;
28
+ /**
29
+ * Output formats this browser really encodes, probed once per document with a 1 × 1 canvas. Safari, for example,
30
+ * returns PNG bytes when asked for WebP; such a format is reported as unsupported instead of being faked.
31
+ */
32
+ export declare function sdImageEditorEncodableFormats(doc: Document): Promise<ReadonlySet<SdImageEditorFormat>>;
33
+ /**
34
+ * Draws a downscaled copy of the source (at most `maxPixels`) into `canvas` for the on-screen preview. Returns the
35
+ * preview size. Interaction runs on this copy; the export always reads the full source.
36
+ */
37
+ export declare function sdImageEditorDrawPreview(canvas: HTMLCanvasElement, source: Pick<SdImageEditorDecoded, 'image' | 'width' | 'height'>, maxPixels: number): SdImageEditorSize;
38
+ /**
39
+ * `true` when the canvas holds at least one pixel that is not fully opaque. Used once per load on the preview copy,
40
+ * only when the header declares an alpha channel — encoders often write RGBA even for opaque images.
41
+ */
42
+ export declare function sdImageEditorHasTransparency(canvas: HTMLCanvasElement): boolean;
43
+ export declare function sdImageEditorExtension(format: SdImageEditorFormat): string;
44
+ /** `base` without its image extension, plus the extension of `format`. */
45
+ export declare function sdImageEditorFileName(base: string | undefined, format: SdImageEditorFormat): string;
46
+ /** `1.2 MB`, `245 KB`, `830 B` in the given locale. */
47
+ export declare function sdImageEditorFormatBytes(bytes: number, locale: string): string;
48
+ /**
49
+ * Normalises a CSS colour to `#rrggbb` for `<input type="color">`, using the canvas colour parser. Returns `null`
50
+ * for an invalid colour.
51
+ */
52
+ export declare function sdImageEditorColorToHex(doc: Document, color: string): string | null;
@@ -0,0 +1,113 @@
1
+ import type { SdImageEditorOrientation, SdImageEditorRect, SdImageEditorRotation, SdImageEditorSize } from './image-editor.model';
2
+ /**
3
+ * 2D affine matrix in canvas / CSS order: `x' = a·x + c·y + e`, `y' = b·x + d·y + f`.
4
+ * Same argument order as `CanvasRenderingContext2D.setTransform(a, b, c, d, e, f)` and CSS `matrix(a, b, c, d, e, f)`.
5
+ */
6
+ export type SdImageEditorMatrix = readonly [a: number, b: number, c: number, d: number, e: number, f: number];
7
+ /** Edit applied from the toolbar, expressed in what the user sees on screen. */
8
+ export type SdImageEditorOrientationOp = 'rotate-cw' | 'rotate-ccw' | 'flip-horizontal' | 'flip-vertical';
9
+ /** Crop handle being dragged: an edge (`n`, `e`, `s`, `w`) or a corner. */
10
+ export type SdImageEditorCropHandle = 'n' | 'ne' | 'e' | 'se' | 's' | 'sw' | 'w' | 'nw';
11
+ export declare const SD_IMAGE_EDITOR_IDENTITY: SdImageEditorMatrix;
12
+ /** `m · n`: the returned matrix applies `n` first, then `m`. */
13
+ export declare function sdImageEditorMultiply(m: SdImageEditorMatrix, n: SdImageEditorMatrix): SdImageEditorMatrix;
14
+ /** Product of the matrices, applied right to left (the last one first). */
15
+ export declare function sdImageEditorCompose(...matrices: readonly SdImageEditorMatrix[]): SdImageEditorMatrix;
16
+ export declare function sdImageEditorInvert(m: SdImageEditorMatrix): SdImageEditorMatrix;
17
+ export declare function sdImageEditorApply(m: SdImageEditorMatrix, x: number, y: number): {
18
+ x: number;
19
+ y: number;
20
+ };
21
+ export declare function sdImageEditorTranslate(x: number, y: number): SdImageEditorMatrix;
22
+ export declare function sdImageEditorScale(x: number, y?: number): SdImageEditorMatrix;
23
+ /** Size of the image once rotated: a quarter turn swaps width and height. */
24
+ export declare function sdImageEditorOrientedSize(size: SdImageEditorSize, rotate: SdImageEditorRotation): SdImageEditorSize;
25
+ /**
26
+ * Maps a pixel of the decoded source (width × height, EXIF orientation already applied by the browser) to the
27
+ * oriented image the user edits: mirror horizontally first when `flip`, then rotate clockwise by `rotate`.
28
+ * The result always lies inside `[0, orientedWidth] × [0, orientedHeight]`.
29
+ */
30
+ export declare function sdImageEditorOrientationMatrix(size: SdImageEditorSize, orientation: SdImageEditorOrientation): SdImageEditorMatrix;
31
+ /** Clockwise rotation of a `size` box around its origin, translated back so the result starts at (0, 0). */
32
+ export declare function sdImageEditorRotationMatrix(size: SdImageEditorSize, rotate: SdImageEditorRotation): SdImageEditorMatrix;
33
+ /**
34
+ * Matrix of a toolbar operation applied to the image as currently shown (`orientedSize`). Used to carry the crop
35
+ * rectangle along so it keeps framing the same content after a rotation or a flip.
36
+ */
37
+ export declare function sdImageEditorOperationMatrix(op: SdImageEditorOrientationOp, orientedSize: SdImageEditorSize): SdImageEditorMatrix;
38
+ /**
39
+ * Composes a screen-space operation into the canonical `{ flip, rotate }` pair.
40
+ *
41
+ * With `F` = horizontal mirror and `R(r)` = clockwise rotation, the state stands for `R(r)·F^flip`. Mirroring
42
+ * the displayed image gives `F·R(r) = R(−r)·F`, and a vertical mirror is `R(180)·F`, hence the formulas below.
43
+ */
44
+ export declare function sdImageEditorApplyOperation(orientation: SdImageEditorOrientation, op: SdImageEditorOrientationOp): SdImageEditorOrientation;
45
+ export declare function normalizeRotation(value: number): SdImageEditorRotation;
46
+ /**
47
+ * EXIF orientation (1–8) as the `{ flip, rotate }` pair that displays the stored pixels upright. Only used when
48
+ * the browser did not apply the orientation itself while decoding.
49
+ */
50
+ export declare function sdImageEditorExifOrientation(value: number): SdImageEditorOrientation;
51
+ /** Bounding box of `rect` mapped through `m`, rounded to whole pixels. Exact for quarter turns and mirrors. */
52
+ export declare function sdImageEditorTransformRect(rect: SdImageEditorRect, m: SdImageEditorMatrix): SdImageEditorRect;
53
+ /**
54
+ * Transform used by the export: source pixels → output canvas.
55
+ *
56
+ * `Scale(output / crop) · Translate(−crop) · Orientation`. Reads only the source, never a preview.
57
+ */
58
+ export declare function sdImageEditorExportMatrix(sourceSize: SdImageEditorSize, orientation: SdImageEditorOrientation, crop: SdImageEditorRect, output: SdImageEditorSize): SdImageEditorMatrix;
59
+ /** Zoom and pan of the preview. View-only: never part of the edits or the export. */
60
+ export interface SdImageEditorView {
61
+ /** Zoom relative to "fit": `1` shows the whole oriented image inside the stage. */
62
+ readonly zoom: number;
63
+ /** Offset of the image centre from the stage centre, in CSS pixels. */
64
+ readonly panX: number;
65
+ readonly panY: number;
66
+ }
67
+ export declare const SD_IMAGE_EDITOR_FIT_VIEW: SdImageEditorView;
68
+ /** Scale and top-left position of the oriented image inside the stage. */
69
+ export interface SdImageEditorViewport {
70
+ /** CSS pixels per image pixel. */
71
+ readonly scale: number;
72
+ readonly originX: number;
73
+ readonly originY: number;
74
+ }
75
+ /** Scale at which the oriented image fits the stage minus `padding` on every side. */
76
+ export declare function sdImageEditorFitScale(stage: SdImageEditorSize, image: SdImageEditorSize, padding: number): number;
77
+ export declare function sdImageEditorViewport(stage: SdImageEditorSize, image: SdImageEditorSize, view: SdImageEditorView, padding: number): SdImageEditorViewport;
78
+ /** Oriented image pixels → stage CSS pixels. */
79
+ export declare function sdImageEditorViewMatrix(viewport: SdImageEditorViewport): SdImageEditorMatrix;
80
+ export declare function sdImageEditorImageToStage(viewport: SdImageEditorViewport, rect: SdImageEditorRect): SdImageEditorRect;
81
+ export declare function sdImageEditorStageToImage(viewport: SdImageEditorViewport, x: number, y: number): {
82
+ x: number;
83
+ y: number;
84
+ };
85
+ /**
86
+ * Keeps at least `margin` CSS pixels of the image inside the stage so the user cannot pan it out of reach.
87
+ */
88
+ export declare function sdImageEditorClampPan(stage: SdImageEditorSize, image: SdImageEditorSize, view: SdImageEditorView, padding: number, margin: number): SdImageEditorView;
89
+ /**
90
+ * Zooms by `factor` keeping the image point under (`anchorX`, `anchorY`) — stage CSS pixels — still under it.
91
+ */
92
+ export declare function sdImageEditorZoomAt(stage: SdImageEditorSize, image: SdImageEditorSize, view: SdImageEditorView, padding: number, zoom: number, anchorX: number, anchorY: number): SdImageEditorView;
93
+ /** Whole-pixel rectangle inside `bounds`, at least 1 × 1. */
94
+ export declare function sdImageEditorClampRect(rect: SdImageEditorRect, bounds: SdImageEditorSize): SdImageEditorRect;
95
+ /** Moves the rectangle by (`dx`, `dy`) without resizing it, stopping at the image edges. */
96
+ export declare function sdImageEditorMoveRect(rect: SdImageEditorRect, dx: number, dy: number, bounds: SdImageEditorSize): SdImageEditorRect;
97
+ /** Largest whole-pixel size with `ratio` (width / height) inside `maxWidth × maxHeight`. */
98
+ export declare function sdImageEditorFitRatio(maxWidth: number, maxHeight: number, ratio: number): SdImageEditorSize;
99
+ /** Largest rectangle with `ratio` inside `bounds`, centred. `null` ratio returns the whole image. */
100
+ export declare function sdImageEditorInitialCrop(bounds: SdImageEditorSize, ratio: number | null): SdImageEditorRect;
101
+ /**
102
+ * Re-shapes `rect` to `ratio`, keeping its centre and roughly its area, then fits it inside `bounds`.
103
+ * Used when the user picks another ratio and when a quarter turn breaks a fixed ratio.
104
+ */
105
+ export declare function sdImageEditorReshape(rect: SdImageEditorRect, ratio: number, bounds: SdImageEditorSize): SdImageEditorRect;
106
+ /**
107
+ * Resizes `start` by dragging `handle` by (`dx`, `dy`) image pixels. The opposite edge or corner stays fixed; with
108
+ * a `ratio` the free dimension follows and edge handles grow symmetrically around the centre of the other axis.
109
+ * The result never leaves `bounds` and never gets smaller than `minSize` on either side.
110
+ */
111
+ export declare function sdImageEditorResizeRect(start: SdImageEditorRect, handle: SdImageEditorCropHandle, dx: number, dy: number, bounds: SdImageEditorSize, ratio: number | null, minSize: number): SdImageEditorRect;
112
+ export declare function sdImageEditorSameRect(a: SdImageEditorRect, b: SdImageEditorRect): boolean;
113
+ export declare function clamp(value: number, min: number, max: number): number;
@@ -0,0 +1,265 @@
1
+ /**
2
+ * Clockwise rotation in degrees, always a quarter turn.
3
+ */
4
+ export type SdImageEditorRotation = 0 | 90 | 180 | 270;
5
+ /** Width and height in whole pixels. */
6
+ export interface SdImageEditorSize {
7
+ readonly width: number;
8
+ readonly height: number;
9
+ }
10
+ /**
11
+ * Rectangle in whole pixels of the **oriented** image — the image as shown in the editor, after the EXIF
12
+ * orientation, the flip and the rotation. `x`/`y` is the top-left corner; the origin is the top-left of the image.
13
+ */
14
+ export interface SdImageEditorRect {
15
+ readonly x: number;
16
+ readonly y: number;
17
+ readonly width: number;
18
+ readonly height: number;
19
+ }
20
+ /**
21
+ * Orientation applied to the decoded source, in this order: mirror left ↔ right when `flip` is `true`, then rotate
22
+ * clockwise by `rotate` degrees.
23
+ *
24
+ * Every combination of the toolbar's rotate and flip buttons reduces to this pair. For example "flip vertically"
25
+ * on an unrotated image is stored as `{ flip: true, rotate: 180 }`.
26
+ */
27
+ export interface SdImageEditorOrientation {
28
+ readonly flip: boolean;
29
+ readonly rotate: SdImageEditorRotation;
30
+ }
31
+ /**
32
+ * Complete description of the edits, relative to the decoded source. Plain data: it is what undo/redo stores and
33
+ * what `SdImageEditorResult.edits` returns, so a server can replay the same transform on the original file.
34
+ *
35
+ * Replay order: decode with the EXIF orientation applied → `flip` → `rotate` → `crop` → scale to `resize`
36
+ * (or to the crop size when `resize` is `null`).
37
+ *
38
+ * @example
39
+ * ```ts
40
+ * const edits: SdImageEditorEdits = {
41
+ * flip: false,
42
+ * rotate: 90,
43
+ * crop: { x: 120, y: 0, width: 1080, height: 1080 },
44
+ * aspectRatio: 1,
45
+ * resize: { width: 512, height: 512 },
46
+ * };
47
+ * ```
48
+ */
49
+ export interface SdImageEditorEdits extends SdImageEditorOrientation {
50
+ /** Crop area in pixels of the oriented image. Always inside the image and at least 1 × 1. */
51
+ readonly crop: SdImageEditorRect;
52
+ /** Width / height ratio the crop is constrained to, or `null` for a free crop. */
53
+ readonly aspectRatio: number | null;
54
+ /** Output size chosen by the user, or `null` to follow the crop (see `SdImageEditorOutputOption.width`). */
55
+ readonly resize: SdImageEditorSize | null;
56
+ }
57
+ /** Output formats the editor can encode, when the browser supports them. */
58
+ export type SdImageEditorFormat = 'image/jpeg' | 'image/png' | 'image/webp';
59
+ /**
60
+ * One entry of the crop ratio picker.
61
+ *
62
+ * @example
63
+ * ```ts
64
+ * const square: SdImageEditorAspectRatio = { label: '1:1', value: 1 };
65
+ * const free: SdImageEditorAspectRatio = { label: 'Free', value: null };
66
+ * ```
67
+ */
68
+ export interface SdImageEditorAspectRatio {
69
+ /** Text of the chip. When omitted, `null` shows the translated "Free" and a number shows the ratio. */
70
+ readonly label?: string;
71
+ /** Width / height ratio (`16 / 9`), or `null` for a free crop. */
72
+ readonly value: number | null;
73
+ }
74
+ /**
75
+ * Output settings. The user can change format, quality, background and size in the panel; these values are the
76
+ * starting point.
77
+ *
78
+ * @example
79
+ * ```ts
80
+ * const output: SdImageEditorOutputOption = {
81
+ * format: 'image/webp',
82
+ * quality: 0.85,
83
+ * width: 1600, // scale the crop down to at most 1600 px wide
84
+ * fileName: 'banner',
85
+ * };
86
+ * ```
87
+ */
88
+ export interface SdImageEditorOutputOption {
89
+ /**
90
+ * Initial output format. Defaults to the source format; when the browser cannot encode it, PNG for images with
91
+ * transparency and JPEG otherwise — the panel shows the format that will be produced.
92
+ */
93
+ format?: SdImageEditorFormat;
94
+ /**
95
+ * Formats offered in the panel, in this order. Defaults to JPEG, PNG and WebP. Formats the browser cannot
96
+ * encode stay visible but disabled. Pass a single format to hide the picker.
97
+ */
98
+ formats?: readonly SdImageEditorFormat[];
99
+ /** Initial JPEG/WebP quality between `0` and `1`. Ignored for PNG, which is lossless. @defaultValue `0.92` */
100
+ quality?: number;
101
+ /**
102
+ * CSS colour painted under the image when encoding JPEG, which has no transparency. PNG and WebP keep the alpha
103
+ * channel. @defaultValue `'white'`
104
+ */
105
+ background?: string;
106
+ /**
107
+ * Default output box: while the user has not typed a size, the crop is scaled down to fit inside `width` ×
108
+ * `height` (either may be omitted), keeping its ratio. The user can still type another size.
109
+ */
110
+ width?: number;
111
+ height?: number;
112
+ /** Allow an output larger than the crop. Off by default so the editor never upscales by accident. */
113
+ allowUpscale?: boolean;
114
+ /**
115
+ * File name without extension. The extension always follows the encoded format (`.jpg`, `.png`, `.webp`).
116
+ * Defaults to the source `File` name, or `image`.
117
+ */
118
+ fileName?: string;
119
+ /**
120
+ * `'file'` returns a `File`, `'blob'` a plain `Blob`. `'auto'` (default) returns a `File` when the source is a
121
+ * `File`.
122
+ */
123
+ resultType?: 'auto' | 'blob' | 'file';
124
+ }
125
+ /**
126
+ * Hard limits, checked before any full-resolution canvas is created.
127
+ *
128
+ * Source limits reject the image with an error. Output limits cap the size the user can pick; when the automatic
129
+ * size had to be reduced, the panel says so and `SdImageEditorResult.sizeLimited` is `true`.
130
+ */
131
+ export interface SdImageEditorLimits {
132
+ /** Largest accepted source, in bytes. @defaultValue `41_943_040` (40 MiB) */
133
+ maxSourceSize?: number;
134
+ /** Largest accepted source, in pixels (width × height). @defaultValue `40_000_000` */
135
+ maxSourcePixels?: number;
136
+ /** Largest output, in pixels. The default matches the canvas limit of iOS Safari. @defaultValue `16_777_216` */
137
+ maxOutputPixels?: number;
138
+ /** Longest output side, in pixels. @defaultValue `16_384` */
139
+ maxOutputSide?: number;
140
+ }
141
+ /**
142
+ * Configuration of `<sd-image-editor>`. Every field is optional.
143
+ *
144
+ * @example
145
+ * ```ts
146
+ * readonly avatarOption: SdImageEditorOption = {
147
+ * aspectRatio: 1,
148
+ * lockAspectRatio: true,
149
+ * output: { format: 'image/jpeg', width: 512, height: 512, fileName: 'avatar' },
150
+ * limits: { maxSourceSize: 10 * 1024 * 1024 },
151
+ * };
152
+ * ```
153
+ */
154
+ export interface SdImageEditorOption {
155
+ /** Ratio chips shown above the crop fields. Defaults to Free, 1:1, 4:3, 16:9 and 3:4. */
156
+ aspectRatios?: readonly SdImageEditorAspectRatio[];
157
+ /** Ratio selected when an image loads. `null` (default) starts with a free crop of the whole image. */
158
+ aspectRatio?: number | null;
159
+ /** Keep `aspectRatio` for the whole session and hide the ratio chips — for avatars, thumbnails, banners. */
160
+ lockAspectRatio?: boolean;
161
+ /** Output format, quality, size and file name. */
162
+ output?: SdImageEditorOutputOption;
163
+ /** Source and output limits. */
164
+ limits?: SdImageEditorLimits;
165
+ /** Number of undo steps kept. @defaultValue `50` */
166
+ historyLimit?: number;
167
+ /** E2E scope. Produces `data-autoid="components-image-editor-{autoId}"` and derived child ids. */
168
+ autoId?: string;
169
+ }
170
+ /**
171
+ * Resolved by `SdImageEditor.getResult()`: the encoded image and what produced it.
172
+ *
173
+ * The editor never uploads, downloads or overwrites anything: send `blob` to your API yourself.
174
+ *
175
+ * @example
176
+ * ```ts
177
+ * async save(): Promise<void> {
178
+ * const result = await this.editor().getResult();
179
+ * const form = new FormData();
180
+ * form.append('file', result.blob, result.fileName);
181
+ * await firstValueFrom(this.http.post('/api/avatar', form));
182
+ * }
183
+ * ```
184
+ */
185
+ export interface SdImageEditorResult {
186
+ /** Encoded image. The same object as `file` when a `File` is returned. */
187
+ readonly blob: Blob;
188
+ /** `File` named `fileName`, or `null` when `resultType` resolved to a plain `Blob`. */
189
+ readonly file: File | null;
190
+ /** File name with the extension of the real encoded format. */
191
+ readonly fileName: string;
192
+ /** MIME type read back from the encoded bytes — never just the requested one. */
193
+ readonly mimeType: SdImageEditorFormat;
194
+ readonly width: number;
195
+ readonly height: number;
196
+ /** Encoded size in bytes. */
197
+ readonly size: number;
198
+ /** Quality used for JPEG/WebP; `null` for PNG. */
199
+ readonly quality: number | null;
200
+ /** Edits that produced the image, relative to the decoded source. */
201
+ readonly edits: SdImageEditorEdits;
202
+ /** `true` when the automatic output size was reduced to respect `limits`. */
203
+ readonly sizeLimited: boolean;
204
+ }
205
+ /**
206
+ * Reason of a failure: carried by `(failed)` for the source, and by the rejection of `getResult()` for the export.
207
+ *
208
+ * - `unsupported-format`: the bytes are not JPEG, PNG or WebP (for example GIF, HEIC, AVIF, SVG), whatever the
209
+ * declared MIME type.
210
+ * - `animated`: an animated PNG or WebP. Only still images are supported; the editor never drops frames silently.
211
+ * - `source-too-large`: the source is bigger than `limits.maxSourceSize`.
212
+ * - `source-too-many-pixels`: width × height is above `limits.maxSourcePixels`.
213
+ * - `decode-failed`: the browser could not decode the image (corrupt or truncated file).
214
+ * - `format-unsupported`: the browser cannot encode the chosen output format.
215
+ * - `render-failed`: the browser could not allocate the output canvas (too large for this device).
216
+ * - `encode-failed`: the browser returned no data while encoding.
217
+ * - `not-ready`: `getResult()` was called without a loaded image, or the image was replaced while encoding.
218
+ */
219
+ export type SdImageEditorErrorCode = 'not-ready' | 'unsupported-format' | 'animated' | 'source-too-large' | 'source-too-many-pixels' | 'decode-failed' | 'format-unsupported' | 'render-failed' | 'encode-failed';
220
+ /**
221
+ * Error emitted by `(failed)` (source) or rejected by `getResult()` (export), and shown in the editor.
222
+ *
223
+ * @example
224
+ * ```ts
225
+ * onFailed(error: SdImageEditorError): void {
226
+ * if (error.code === 'source-too-large') this.notify.warning(error.message);
227
+ * }
228
+ * ```
229
+ */
230
+ export interface SdImageEditorError {
231
+ readonly code: SdImageEditorErrorCode;
232
+ /** `'load'` while reading the source, `'export'` while encoding the result. */
233
+ readonly stage: 'load' | 'export';
234
+ /** Translated, user-facing message. */
235
+ readonly message: string;
236
+ /** Underlying error or detected MIME type, for logging. */
237
+ readonly cause?: unknown;
238
+ }
239
+ /**
240
+ * Lifecycle of the editor.
241
+ *
242
+ * - `empty`: no source.
243
+ * - `loading`: the source is being checked and decoded.
244
+ * - `ready`: the image can be edited.
245
+ * - `exporting`: `getResult()` is encoding the result; the controls are disabled.
246
+ * - `error`: the source could not be loaded. Export errors keep the editor `ready`.
247
+ */
248
+ export type SdImageEditorStatus = 'empty' | 'loading' | 'ready' | 'exporting' | 'error';
249
+ /** Facts about the loaded source, exposed through `SdImageEditor.sourceInfo`. */
250
+ export interface SdImageEditorSourceInfo {
251
+ /** Format detected from the bytes. */
252
+ readonly mimeType: SdImageEditorFormat;
253
+ /** Decoded size, EXIF orientation applied. */
254
+ readonly width: number;
255
+ readonly height: number;
256
+ /** Source size in bytes. */
257
+ readonly size: number;
258
+ /**
259
+ * The image has transparent pixels: the header declares an alpha channel and the decoded pixels confirm it
260
+ * (checked once on the preview copy). Always `false` for JPEG.
261
+ */
262
+ readonly hasAlpha: boolean;
263
+ /** EXIF orientation found in a JPEG (1 when absent). The browser applies it while decoding. */
264
+ readonly exifOrientation: number;
265
+ }