@orangelogic/design-system 5.0.0 → 5.1.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 (221) hide show
  1. package/library/chunks/{alert.2Esbser8.js → alert.DcLDhp3k.js} +2 -2
  2. package/library/chunks/{array-line-clamp.C0Vo0Zzg.js → array-line-clamp.DXOk4Q3x.js} +2 -2
  3. package/library/chunks/{asset-link-format.COPyGdND.js → asset-link-format.D6L-qc3X.js} +8 -8
  4. package/library/chunks/{asset-link-format.Ce_3Qz6_.js → asset-link-format.DqMFH-AV.js} +387 -382
  5. package/library/chunks/{audio.B0VfXBIx.js → audio.DhBjwOl_.js} +2 -2
  6. package/library/chunks/{bicolor-picker.DS9Uut25.js → bicolor-picker.COIlx1gv.js} +1 -1
  7. package/library/chunks/{block-width.ClbkbtKA.js → block-width.BOCYHUDs.js} +39 -39
  8. package/library/chunks/{border-input-group.B6fqiG6F.js → border-input-group.QyWhH0yj.js} +3 -3
  9. package/library/chunks/{breadcrumb.DkINVxcJ.js → breadcrumb.SMzaqsuX.js} +1 -1
  10. package/library/chunks/{button.DKkHqsUz.js → button.DHmArHfu.js} +2 -2
  11. package/library/chunks/{checkbox.BdSpQlwf.js → checkbox.CA7imbiT.js} +1 -1
  12. package/library/chunks/{color-picker.DZUudAAS.js → color-picker.BERL3UOq.js} +10 -10
  13. package/library/chunks/{color-swatch-group.CuMJc6m8.js → color-swatch-group.C0n7SaJl.js} +22 -22
  14. package/library/chunks/{color-swatch.DXAr2gBg.js → color-swatch.CTbZYqbp.js} +3 -3
  15. package/library/chunks/{config-manager.B6c9XW1s.js → config-manager.C2GBBqS5.js} +29 -29
  16. package/library/chunks/{configs-controller.TQDPq63n.js → configs-controller.BcOmixH6.js} +8 -8
  17. package/library/chunks/{confirm-popover.sZVNhFPh.js → confirm-popover.BiPCxJfb.js} +4 -4
  18. package/library/chunks/{copy-button.CqqKJEh3.js → copy-button.muB45Tao.js} +2 -2
  19. package/library/chunks/{corner-position-input-group.nTlFes0_.js → corner-position-input-group.BKESUGfi.js} +4 -4
  20. package/library/chunks/{cropper.BF32WRyP.js → cropper.D8Uu43xy.js} +1 -1
  21. package/library/chunks/date-calendar.CSrG_jgw.js +188 -0
  22. package/library/chunks/date.kywrEgxd.js +363 -0
  23. package/library/chunks/{details.DSgp6VAD.js → details.BQjEDJPA.js} +1 -1
  24. package/library/chunks/{dialog.D0oTJWFf.js → dialog.BY2wT_Yq.js} +3 -3
  25. package/library/chunks/{document-viewer.L77oYyOp.js → document-viewer.DviPbYQs.js} +14 -14
  26. package/library/chunks/{dot-pagination.C1C6NG8d.js → dot-pagination.Bc4kqtcF.js} +2 -2
  27. package/library/chunks/{drawer.BsKzYqKe.js → drawer.UPV3DrmP.js} +2 -2
  28. package/library/chunks/{dropdown.CKhoP9Cr.js → dropdown.D6MQirjI.js} +15 -6
  29. package/library/chunks/{dynamic-select.Cb3L0dIB.js → dynamic-select.CsuWTgdl.js} +5 -5
  30. package/library/chunks/{e-chart.DKFAToIc.js → e-chart.iJAWfcbZ.js} +2 -2
  31. package/library/chunks/{element-clamp.CGq-62gg.js → element-clamp.fo2t5tv8.js} +2 -2
  32. package/library/chunks/{file-on-demand.BjUW2Ydt.js → file-on-demand.CtYHSqZ8.js} +16 -16
  33. package/library/chunks/{folder-select.DJ5EEod3.js → folder-select.BHMjbJpa.js} +8 -8
  34. package/library/chunks/{format-time.QkJcKYrT.js → format-time.CJc4crvX.js} +1 -1
  35. package/library/chunks/{header.CowQINf-.js → header.BMzrFqrX.js} +2 -2
  36. package/library/chunks/{i18n.Bjg2ubA4.js → i18n.tAD84KB3.js} +39 -0
  37. package/library/chunks/{icon-button.qJd_az6T.js → icon-button.hZj_g6Bt.js} +2 -2
  38. package/library/chunks/{iframe.sl2wnUcC.js → iframe.DESEj5FX.js} +1 -1
  39. package/library/chunks/{image-comparer.BCD6kzLm.js → image-comparer.zps8IR5_.js} +1 -1
  40. package/library/chunks/{image.-lgb634-.js → image.CSmzcQJh.js} +2 -2
  41. package/library/chunks/{input.DZRed6yo.js → input.is3tnNFr.js} +18 -5
  42. package/library/chunks/{line-clamp.Dl3_JdHX.js → line-clamp.iGRr7-Xj.js} +47 -28
  43. package/library/chunks/{markdown.BzDRvv-f.js → markdown.BXDKzr2h.js} +2 -2
  44. package/library/chunks/{masonry.BxNeClR6.js → masonry.DANqZg1j.js} +3 -3
  45. package/library/chunks/{menu-item.au-gTg1F.js → menu-item.DL81yBgV.js} +3 -3
  46. package/library/chunks/{menu.BxBtGPsg.js → menu.CVJpMzSd.js} +2 -2
  47. package/library/chunks/{option.DWE0tark.js → option.y4dln0Vc.js} +1 -1
  48. package/library/chunks/{padding-input-group.D2Qx15Yj.js → padding-input-group.DxO3Jpy_.js} +1 -1
  49. package/library/chunks/{pagination.ByLuPMyE.js → pagination.BNxyfajb.js} +7 -7
  50. package/library/chunks/{popup.w4ZU3jI-.js → popup.CDY1A9dW.js} +2 -2
  51. package/library/chunks/{position-picker.X2hhfGx7.js → position-picker.DTyM69dy.js} +2 -2
  52. package/library/chunks/{progress-bar.CynVLLnY.js → progress-bar.DCx1bJbA.js} +1 -1
  53. package/library/chunks/{progress-ring.Bfdj3-uB.js → progress-ring.CLF04Ukk.js} +1 -1
  54. package/library/chunks/{radio-card.VEsyM8ue.js → radio-card.Z4lQJH5n.js} +2 -2
  55. package/library/chunks/{radio.DhPbmKbQ.js → radio.BmN7pFIX.js} +1 -1
  56. package/library/chunks/{range.ObEMbygm.js → range.9siIIf5L.js} +2 -2
  57. package/library/chunks/{rating.CNeNn996.js → rating.oryYIw6x.js} +1 -1
  58. package/library/chunks/{relative-time.BfE3UOhF.js → relative-time.U8veN742.js} +1 -1
  59. package/library/chunks/{select.BV0Necz7.js → select.Bd8WvUMZ.js} +113 -109
  60. package/library/chunks/{shadow-input-group.Xxuzm8Qe.js → shadow-input-group.CoOi3L__.js} +2 -2
  61. package/library/chunks/{share-option-list.DOaEypfQ.js → share-option-list.DM5dfW9M.js} +2 -2
  62. package/library/chunks/{sidebar.CiZOJ49X.js → sidebar.DfNm5C-n.js} +30 -20
  63. package/library/chunks/{size-input-group.wXuG0-RB.js → size-input-group.BdYSDpsy.js} +5 -5
  64. package/library/chunks/{spinner.Bv06U7NJ.js → spinner.DPl3rjQY.js} +1 -1
  65. package/library/chunks/{split-panel.Cag0lAvv.js → split-panel.D4Hn_Esh.js} +1 -1
  66. package/library/chunks/{src.-wSEUjRV.js → src.BGRU1qh5.js} +49 -49
  67. package/library/chunks/{src.Dia365C9.js → src.DwbXw2Wv.js} +23 -23
  68. package/library/chunks/{step.D93ReCO1.js → step.CmqaPVg_.js} +3 -3
  69. package/library/chunks/{stepper-wizard.CPZ2mSze.js → stepper-wizard.H45UqSLe.js} +2 -2
  70. package/library/chunks/{stepper.D0JB_GVh.js → stepper.CDWfFmPh.js} +1 -1
  71. package/library/chunks/{tab-group.dnnT9Mk6.js → tab-group.6FT_XQDH.js} +7 -7
  72. package/library/chunks/{tab.CYYAua8Y.js → tab.q5aFhnHA.js} +3 -3
  73. package/library/chunks/{tag.DQLauctm.js → tag.BSBIN-rz.js} +3 -3
  74. package/library/chunks/{tooltip.Cc02vm6M.js → tooltip.DurE2LL4.js} +17 -21
  75. package/library/chunks/{tree.BI7r-WnZ.js → tree.C0imvgIg.js} +4 -4
  76. package/library/chunks/{typeface.DTLrIP0B.js → typeface.DPVH5wzi.js} +3 -3
  77. package/library/chunks/{video.DWmHPbXO.js → video.CYO0jBx9.js} +6 -6
  78. package/library/components/alert.js +1 -1
  79. package/library/components/array-line-clamp.js +1 -1
  80. package/library/components/asset-link-format.js +1 -1
  81. package/library/components/atoms.js +50 -50
  82. package/library/components/audio.js +1 -1
  83. package/library/components/bicolor-picker.js +1 -1
  84. package/library/components/border-input-group.js +1 -1
  85. package/library/components/breadcrumb.js +1 -1
  86. package/library/components/button.js +1 -1
  87. package/library/components/checkbox.js +1 -1
  88. package/library/components/color-picker.js +1 -1
  89. package/library/components/color-swatch-group.js +1 -1
  90. package/library/components/color-swatch.js +1 -1
  91. package/library/components/confirm-popover.js +1 -1
  92. package/library/components/copy-button.js +1 -1
  93. package/library/components/corner-position-input-group.js +1 -1
  94. package/library/components/cropper.js +1 -1
  95. package/library/components/date-calendar.js +1 -1
  96. package/library/components/details.js +1 -1
  97. package/library/components/dialog.js +1 -1
  98. package/library/components/document-viewer.js +1 -1
  99. package/library/components/dot-pagination.js +1 -1
  100. package/library/components/drawer.js +1 -1
  101. package/library/components/dropdown.js +1 -1
  102. package/library/components/dynamic-select.js +1 -1
  103. package/library/components/e-chart.js +1 -1
  104. package/library/components/element-clamp.js +1 -1
  105. package/library/components/file-on-demand.js +1 -1
  106. package/library/components/folder-select.js +1 -1
  107. package/library/components/format-bytes.js +1 -1
  108. package/library/components/format-date.js +1 -1
  109. package/library/components/format-number.js +1 -1
  110. package/library/components/format-time.js +1 -1
  111. package/library/components/header.js +1 -1
  112. package/library/components/icon-button.js +1 -1
  113. package/library/components/iframe.js +1 -1
  114. package/library/components/image-comparer.js +1 -1
  115. package/library/components/image.js +1 -1
  116. package/library/components/input.js +1 -1
  117. package/library/components/line-clamp.js +1 -1
  118. package/library/components/markdown.js +1 -1
  119. package/library/components/masonry.js +1 -1
  120. package/library/components/menu-item.js +1 -1
  121. package/library/components/menu.js +1 -1
  122. package/library/components/molecules.js +17 -17
  123. package/library/components/option.js +1 -1
  124. package/library/components/organisms.js +3 -3
  125. package/library/components/padding-input-group.js +1 -1
  126. package/library/components/pagination.js +1 -1
  127. package/library/components/popup.js +1 -1
  128. package/library/components/position-picker.js +1 -1
  129. package/library/components/progress-bar.js +1 -1
  130. package/library/components/progress-ring.js +1 -1
  131. package/library/components/radio-card.js +1 -1
  132. package/library/components/radio.js +1 -1
  133. package/library/components/range.js +1 -1
  134. package/library/components/rating.js +1 -1
  135. package/library/components/relative-time.js +1 -1
  136. package/library/components/select.js +1 -1
  137. package/library/components/shadow-input-group.js +1 -1
  138. package/library/components/share-option-list.js +1 -1
  139. package/library/components/sidebar.js +1 -1
  140. package/library/components/size-input-group.js +1 -1
  141. package/library/components/spinner.js +1 -1
  142. package/library/components/split-panel.js +1 -1
  143. package/library/components/step.js +1 -1
  144. package/library/components/stepper-wizard.js +1 -1
  145. package/library/components/stepper.js +1 -1
  146. package/library/components/tab-group.js +1 -1
  147. package/library/components/tab.js +1 -1
  148. package/library/components/tag.js +1 -1
  149. package/library/components/tooltip.js +1 -1
  150. package/library/components/tree-item.js +1 -1
  151. package/library/components/tree.js +1 -1
  152. package/library/components/typeface.js +1 -1
  153. package/library/components/types.js +21886 -19119
  154. package/library/components/video.js +1 -1
  155. package/library/package.json +1 -1
  156. package/library/packages/atoms/src/components/checkbox/checkbox.d.ts +2 -2
  157. package/library/packages/atoms/src/components/date-calendar/date-calendar.d.ts +62 -9
  158. package/library/packages/atoms/src/components/dropdown/dropdown.d.ts +6 -0
  159. package/library/packages/atoms/src/components/input/input.d.ts +20 -1
  160. package/library/packages/atoms/src/components/line-clamp/line-clamp.d.ts +3 -0
  161. package/library/packages/atoms/src/components/radio/radio.d.ts +3 -0
  162. package/library/packages/atoms/src/components/select/select.d.ts +0 -4
  163. package/library/packages/atoms/src/components/tooltip/tooltip.d.ts +4 -1
  164. package/library/packages/events/src/cx-search-facet-date-change.d.ts +11 -0
  165. package/library/packages/events/src/cx-search-facet-focus-title.d.ts +10 -0
  166. package/library/packages/events/src/cx-search-facet-reset.d.ts +12 -0
  167. package/library/packages/events/src/cx-search-facet-select-all.d.ts +13 -0
  168. package/library/packages/events/src/cx-search-facet-show-more.d.ts +12 -0
  169. package/library/packages/events/src/cx-search-facet-toggle.d.ts +11 -0
  170. package/library/packages/events/src/cx-search-facets-apply.d.ts +17 -0
  171. package/library/packages/events/src/cx-search-facets-change-filters.d.ts +6 -0
  172. package/library/packages/events/src/cx-search-facets-clear-all.d.ts +10 -0
  173. package/library/packages/events/src/cx-search-facets-custom.d.ts +10 -0
  174. package/library/packages/events/src/cx-search-facets-facet-expand.d.ts +9 -0
  175. package/library/packages/events/src/cx-search-facets-node-expand.d.ts +11 -0
  176. package/library/packages/events/src/cx-search-facets-refresh.d.ts +6 -0
  177. package/library/packages/events/src/cx-search-facets-show-more.d.ts +8 -0
  178. package/library/packages/events/src/cx-search-facets-summary-expand.d.ts +9 -0
  179. package/library/packages/events/src/cx-search-facets-summary-remove.d.ts +12 -0
  180. package/library/packages/events/src/events.d.ts +16 -0
  181. package/library/packages/molecules/src/input-date-picker/input-date-picker.d.ts +116 -0
  182. package/library/packages/molecules/src/sidebar/sidebar.d.ts +1 -0
  183. package/library/packages/organisms/src/asset-link-format/components/asset-link-format-crop/asset-link-format-crop.d.ts +7 -2
  184. package/library/packages/organisms/src/index.d.ts +1 -0
  185. package/library/packages/organisms/src/search-facets/components/search-facet/search-facet.d.ts +95 -0
  186. package/library/packages/organisms/src/search-facets/components/search-facet/search-facet.styles.d.ts +2 -0
  187. package/library/packages/organisms/src/search-facets/components/search-facet-advanced-date/advanced-date-reading.d.ts +90 -0
  188. package/library/packages/organisms/src/search-facets/components/search-facet-advanced-date/search-facet-advanced-date.d.ts +85 -0
  189. package/library/packages/organisms/src/search-facets/components/search-facet-advanced-date/search-facet-advanced-date.styles.d.ts +2 -0
  190. package/library/packages/organisms/src/search-facets/components/search-facet-color/search-facet-color.d.ts +47 -0
  191. package/library/packages/organisms/src/search-facets/components/search-facet-color/search-facet-color.styles.d.ts +2 -0
  192. package/library/packages/organisms/src/search-facets/components/search-facet-date/date-range-validation.d.ts +67 -0
  193. package/library/packages/organisms/src/search-facets/components/search-facet-date/search-facet-date.d.ts +120 -0
  194. package/library/packages/organisms/src/search-facets/components/search-facet-date/search-facet-date.styles.d.ts +2 -0
  195. package/library/packages/organisms/src/search-facets/components/search-facet-similar/search-facet-similar.d.ts +44 -0
  196. package/library/packages/organisms/src/search-facets/components/search-facet-similar/search-facet-similar.styles.d.ts +2 -0
  197. package/library/packages/organisms/src/search-facets/components/search-facet-tree/search-facet-tree.d.ts +104 -0
  198. package/library/packages/organisms/src/search-facets/components/search-facet-tree/search-facet-tree.styles.d.ts +2 -0
  199. package/library/packages/organisms/src/search-facets/components/search-facet-tree/visible-nodes.d.ts +36 -0
  200. package/library/packages/organisms/src/search-facets/components/search-facets-summary/search-facets-summary.d.ts +67 -0
  201. package/library/packages/organisms/src/search-facets/components/search-facets-summary/search-facets-summary.styles.d.ts +2 -0
  202. package/library/packages/organisms/src/search-facets/search-facets.d.ts +198 -0
  203. package/library/packages/organisms/src/search-facets/search-facets.fixtures.d.ts +141 -0
  204. package/library/packages/organisms/src/search-facets/search-facets.styles.d.ts +2 -0
  205. package/library/packages/organisms/src/search-facets/state/date-drafts.d.ts +11 -0
  206. package/library/packages/organisms/src/search-facets/state/long-panel.d.ts +7 -0
  207. package/library/packages/organisms/src/search-facets/state/preview-summary.d.ts +17 -0
  208. package/library/packages/organisms/src/search-facets/state/preview-waiting-changes.d.ts +12 -0
  209. package/library/packages/organisms/src/search-facets/state/response-correlation.d.ts +9 -0
  210. package/library/packages/organisms/src/search-facets/state/waiting-changes.d.ts +179 -0
  211. package/library/packages/organisms/src/search-facets/types.d.ts +347 -0
  212. package/library/packages/types/src/asset-link-format.d.ts +6 -0
  213. package/library/packages/types/src/search-facets.d.ts +104 -0
  214. package/library/packages/utils/src/custom-element/i18n.d.ts +39 -0
  215. package/library/packages/utils/src/date/calendar-grid.d.ts +5 -6
  216. package/library/packages/utils/src/date/date.d.ts +7 -1
  217. package/library/react-web-component.d.ts +87 -5
  218. package/library/utils.js +10 -10
  219. package/package.json +1 -1
  220. package/library/chunks/date-calendar.B7e6WBzh.js +0 -78
  221. package/library/chunks/date.BL4L64Hx.js +0 -358
@@ -0,0 +1,347 @@
1
+ import { FacetChange, FacetDateMessages, FacetDateSide, FacetDateTimeUnit } from '../../../types/src/search-facets';
2
+ export type { FacetChange, FacetDateMessageKey, FacetDateMessages, FacetDateSide, FacetDateTimeUnit, SearchFacetDateChangeDetail, SearchFacetDateDraft, SearchFacetToggleDetail, TogglePickMode, ToggleVia, } from '../../../types/src/search-facets';
3
+ /** The two clears the panel queues: Clear All (every condition) and Clear all filters (the panel's filters only). */
4
+ export type ClearKind = Extract<FacetChange['type'], 'clearAll' | 'clearFilters'>;
5
+ /** Whether a facet is open, closed, or closed and not yet queried. */
6
+ export type FacetState = 'collapsed' | 'collapsedUnloaded' | 'expanded';
7
+ /** Server-authoritative selection state for a facet value. */
8
+ export type FacetCheck = 'checked' | 'mixed' | 'unchecked';
9
+ /** The body renderer selected for a filter. E0 implements the standard flat facet body. */
10
+ export type FacetKind = 'color' | 'date' | 'facet' | 'similar';
11
+ /** A host action described by the payload. */
12
+ export interface ActionDescriptor {
13
+ event?: string;
14
+ icon?: string;
15
+ id: string;
16
+ label: string;
17
+ }
18
+ /** The body of a `kind: 'color'` facet ("Similar tones"). The server writes an unset field as `null`. */
19
+ export interface FacetColor {
20
+ /** The select-all checkbox's visible label, already translated (COR "Similar tones: "). Omitted: `facet.label`. */
21
+ selectAllLabel?: string;
22
+ }
23
+ /**
24
+ * The body of a `kind: 'date'` facet. The server writes every unset field as `null`: read it as omitted. Days are
25
+ * `YYYY-MM-DD`, the user's calendar days, never with `Z`: never parse them with `new Date(iso)`. Only an advanced date
26
+ * filter with `timeUnits` carries a time, `YYYY-MM-DD HH:mm:ss`, already in the user's time zone.
27
+ */
28
+ export interface FacetDate {
29
+ /** Today's Clear text, already translated. Omitted: the `clear` term. */
30
+ clearLabel?: string;
31
+ /** The user's own date format: `MM/DD/YYYY` (COR default), `DD/MM/YYYY` or `YYYY/MM/DD`. Anything else reads as `MM/DD/YYYY`. */
32
+ displayFormat?: string;
33
+ /** The calendar's first day, 0 = Sunday … 6 = Saturday. Omitted: Sunday. */
34
+ firstDayOfWeek?: number;
35
+ /** The applied first day. Omitted: open at that end. With a period: the period's first day today. */
36
+ from?: string;
37
+ /** The From field's label, already translated. Omitted: the `fromLabel` term. */
38
+ fromLabel?: string;
39
+ /** Advanced date filter with a time only: the hour options in the site's order. Omitted or empty: `HOUR_OPTIONS`. */
40
+ hours?: FacetDateHour[];
41
+ /** Today's validation texts, already translated; a text left out falls back to the panel's term. */
42
+ messages?: FacetDateMessages;
43
+ /** Advanced date filter only: the applied mode, one of `modes[].value`. Omitted: nothing applied. */
44
+ mode?: string;
45
+ /**
46
+ * Advanced date filter only: the modes in the site's order. Omitted, null or empty: a plain date range.
47
+ * When set, `from` and `until` are 'YYYY' | 'YYYY-MM' | 'YYYY-MM-DD' (or 'YYYY-MM-DD HH:mm:ss' when `timeUnits` is
48
+ * set) and `periods` is empty.
49
+ */
50
+ modes?: FacetDateMode[];
51
+ /** The applied period's code, one of `periods[].value`. Omitted for typed days or no range. */
52
+ period?: string;
53
+ /** The filter's periods in the site's order, each with its days today. Empty or omitted: no period select. */
54
+ periods?: FacetDatePeriod[];
55
+ /**
56
+ * The site's `ShowInvalidDateWarning`. `false` (COR): a day or month that does not exist is corrected as today's
57
+ * control corrects it, with no message. Omitted or `true`: it shows `messages.invalidDate` and queues nothing.
58
+ */
59
+ showInvalidDateWarning?: boolean;
60
+ /** Advanced date filter only: the time selects each date shows, in order. Omitted or empty: no time. */
61
+ timeUnits?: FacetDateTimeUnit[];
62
+ /** The applied last day, inclusive. Omitted: open at that end. With a period: the period's last day today. */
63
+ until?: string;
64
+ /** The To field's label, already translated. Omitted: the `toLabel` term. */
65
+ untilLabel?: string;
66
+ /**
67
+ * The site's `FormatYearShortcutActivated`. `true` (COR): a 1-, 2- or 3-digit year becomes 200X, 20XX or 1XXX.
68
+ * Omitted or `false`: the year as typed, padded with zeros (26 → 0026).
69
+ */
70
+ yearShortcut?: boolean;
71
+ }
72
+ /** One option of an advanced date filter's hour select. */
73
+ export interface FacetDateHour {
74
+ /** As the site writes it, e.g. `10am`. */
75
+ label: string;
76
+ /** 24-hour `00` to `23`, written as `HH`. */
77
+ value: string;
78
+ }
79
+ /** One mode of an advanced date filter. */
80
+ export interface FacetDateMode {
81
+ /** Translated label. */
82
+ label: string;
83
+ /** The dates the mode shows and sends, in order; `[]` for Indefinite. */
84
+ sides: FacetDateSide[];
85
+ /** Opaque, sent back unchanged as the change's `mode`. */
86
+ value: string;
87
+ }
88
+ /** One period of a date filter, computed by the server. */
89
+ export interface FacetDatePeriod {
90
+ /** The period's first day today, `YYYY-MM-DD`. Omitted: open. */
91
+ from?: string;
92
+ /** Translated label. */
93
+ label: string;
94
+ /** The period's last day today, `YYYY-MM-DD`. Omitted: open. */
95
+ until?: string;
96
+ /** Opaque code sent back unchanged in the `date` change. */
97
+ value: string;
98
+ }
99
+ /** Presentation settings shared by the panel and individual facets. */
100
+ export interface FacetPresentation {
101
+ collapseIcon?: string;
102
+ dense?: boolean;
103
+ expandIcon?: string;
104
+ showCounts?: boolean;
105
+ }
106
+ /** Server-supplied status shown while a facet's field is still being indexed. */
107
+ export interface FacetIndexingStatus {
108
+ /** Optional estimate formatted and localized by the host/server. */
109
+ estimate?: string;
110
+ /** Primary status text formatted and localized by the host/server. */
111
+ label: string;
112
+ }
113
+ /** Panel-level configuration resolved by the host. The server writes an unset field as `null`: read it as omitted. */
114
+ export interface PanelConfig extends FacetPresentation {
115
+ /** Text for a panel with no facet. `''` draws nothing, as today's Cortex panel; omitted or null: the `noFilters` term. */
116
+ emptyText?: string;
117
+ headingLevel?: number;
118
+ label?: string;
119
+ /**
120
+ * From this many facets on, the panel skips painting the facets far out of view, as today's Cortex panel stops
121
+ * drawing them (PNL-09). Counts the facets whose `kind` is not `'color'` or `'similar'`: today those two sit outside
122
+ * the filter list that counts and hides filters. Every facet stays in the DOM, the tab order, find-in-page and the
123
+ * accessibility tree. Omitted or null: every facet is painted. `0`: always on. `virtualizeThreshold` counts one
124
+ * facet's values.
125
+ */
126
+ longPanelThreshold?: number;
127
+ showResultCount?: boolean;
128
+ /** Whether the "Applied filters" block shows. `false` moves Clear all filters to the panel header (PNL-04). */
129
+ showSummary?: boolean;
130
+ summaryActions?: ActionDescriptor[];
131
+ summaryPlacement?: 'bottom' | 'top';
132
+ virtualizeThreshold?: number;
133
+ }
134
+ /**
135
+ * One value supplied by the server. `value` is opaque and is never derived from `label`.
136
+ * In a tree (`Facet.hierarchical`) a value with `children` is a branch. The server sends the whole tree and decides what
137
+ * a tick on a branch writes, so the panel sends one toggle per ticked value.
138
+ */
139
+ export interface FacetNode {
140
+ /** `mixed` on a branch while only part of it is picked. */
141
+ checked: FacetCheck;
142
+ /** The values nested below this one, in the server's order. Omitted or empty on a leaf. */
143
+ children?: FacetNode[];
144
+ /** A pre-formatted count such as `2,223` or `~1.2k`. Omitted on a branch that does not add up its children's counts. */
145
+ count?: string;
146
+ /**
147
+ * The state the site's defaults give the value, as today's default types: a waiting reset, clear or removal of the
148
+ * facet's chip shows it, and the server returns to it once nothing is picked. On a branch: true when every value
149
+ * below it defaults to ticked; at the defaults the preview derives a branch from its children, also when only they
150
+ * carry the field. Omitted or null: unticked, as on any other filter.
151
+ */
152
+ defaultChecked?: boolean;
153
+ description?: string;
154
+ /** Shown in its state but not operable, and kept in that state by every preview (a locked "Conceptually similar to"). */
155
+ disabled?: boolean;
156
+ /**
157
+ * Whether a branch starts open: the levels the site forces open, else the fold the user left, else the site default.
158
+ * `null` or omitted on a leaf. The user's choice then holds for the life of the panel.
159
+ */
160
+ expanded?: boolean | null;
161
+ /** Opaque key the host stores a branch's fold under; sent back unchanged in `cx-search-facets-node-expand`. */
162
+ foldKey?: string;
163
+ /** `kind: 'similar'`: the preview's alternative text, the asset's title. */
164
+ imageAlt?: string;
165
+ /** `kind: 'similar'`: the asset's small preview. Omitted when the user may not see it. */
166
+ imageUrl?: string;
167
+ label: string;
168
+ /** Depth in the tree, 1 at the top. */
169
+ level: number;
170
+ /** Position among its siblings, 1-based. */
171
+ posInSet: number;
172
+ /** Number of siblings, the value included. */
173
+ setSize: number;
174
+ /** `kind: 'color'`: the colour as `#RRGGBB`. */
175
+ swatch?: string;
176
+ /** `kind: 'color'`: the tick's tone, picked by the server as today's control picks it. Never computed by the panel. */
177
+ swatchTick?: 'dark' | 'light';
178
+ synthetic?: boolean;
179
+ value: string;
180
+ }
181
+ /** The facet header's select-all checkbox. Its presence shows it, also on a closed facet (FAC-04). */
182
+ export interface FacetSelectAll {
183
+ /** Current state, computed by the server from the facet's values. */
184
+ checked: FacetCheck;
185
+ /**
186
+ * The state at the site's defaults across every applicable value, values behind More included (Types: `checked`, or
187
+ * `mixed` when the defaults leave a type out).
188
+ * The preview shows it while a reset, a clear or a removal of the facet's chip waits. Omitted or null: the values
189
+ * behind More read as unticked there.
190
+ */
191
+ defaultChecked?: FacetCheck;
192
+ /** Shown but not operable. */
193
+ disabled?: boolean;
194
+ /**
195
+ * Hides the checkbox while the facet is closed (`ShowSelectAllOnCollapsedFacets` off). Omitted shows it on a closed
196
+ * facet too, as the standard site does. The panel applies it because only the panel knows whether the facet is open.
197
+ */
198
+ hideWhenCollapsed?: boolean;
199
+ /** Accessible name, already translated. Omitted means the panel's own term with the facet name. */
200
+ label?: string;
201
+ /**
202
+ * The site's "Display All Checked If None Selected": the checkbox is locked while every value shows ticked, in the
203
+ * preview too, and unlocks once one is unticked; unselect all is never sent, and a name click always sends its pick.
204
+ * `disabled` then states only the payload's lock. Omitted or null: `disabled` alone decides.
205
+ */
206
+ lockWhenChecked?: boolean;
207
+ /**
208
+ * Tooltip while everything is ticked. With `lockWhenChecked` the checkbox is then locked, so this is the locked
209
+ * tooltip (today's SelectAllChk DisabledTooltip); otherwise it offers to untick all (today's UnselectAllTooltip).
210
+ */
211
+ unselectLabel?: string;
212
+ /** Opaque argument sent back unchanged in the `selectAll` change. */
213
+ value?: string;
214
+ }
215
+ /** One filter in the panel. */
216
+ export interface Facet {
217
+ /**
218
+ * The site's "Display All Checked If None Selected": with nothing picked every value shows ticked, and the server
219
+ * fills the picks on the first untick, values the panel does not show included (Types). A name click then always
220
+ * sends its pick, because only the pick drops those hidden picks again. Independent of `selectAll`: a filter
221
+ * without a select-all checkbox (the Configure filters popup's Types) needs it as well. Omitted: any other filter.
222
+ */
223
+ allCheckedWhenEmpty?: boolean;
224
+ approximate?: boolean;
225
+ /** Whether the heading can fold the body. Independent of the decorative arrow; false keeps the body open. */
226
+ canCollapse: boolean;
227
+ /**
228
+ * Whether the header offers reset: the server sets it while the facet has picks, also when it is closed (FAC-03).
229
+ * Once the user changes the facet before Apply, the panel's preview recomputes it from the picks the user sees, or,
230
+ * for values with a `defaultChecked`, from the values that differ from it, keeping the server's reset while the saved
231
+ * choice stands.
232
+ */
233
+ canReset: boolean;
234
+ /** `kind: 'color'` settings. */
235
+ color?: FacetColor;
236
+ /** `kind: 'date'`: the applied range, the periods, the format and the texts. */
237
+ date?: FacetDate;
238
+ description?: string;
239
+ /**
240
+ * Text shown in place of the values when the facet has none, already translated (Types on a page with no result:
241
+ * today's "No results found" under the filter's header). Omitted, null or `''`: an empty facet shows no text.
242
+ */
243
+ emptyText?: string;
244
+ fullTextOnHover: boolean;
245
+ /**
246
+ * Whether More would reveal at least one more value. The server sends `false` once the facet is expanded, when the
247
+ * site sets no first limit, or when More would add nothing because every value kept back is already shown selected.
248
+ */
249
+ hasMore: boolean;
250
+ headerActions?: ActionDescriptor[];
251
+ hierarchical: boolean;
252
+ id: string;
253
+ /** Omitted once indexing completes and the facet can render its values normally. */
254
+ indexing?: FacetIndexingStatus;
255
+ /** Omitted means the standard `facet` body. */
256
+ kind?: FacetKind;
257
+ label: string;
258
+ labelClickTarget: 'combined' | 'separate';
259
+ /**
260
+ * In a tree: every branch is open and stays open (the site's "Force expanded filter"). No branch draws an arrow, and
261
+ * none can be opened or closed by click or key; each parent still states `aria-expanded="true"`. Omitted or null:
262
+ * branches fold.
263
+ */
264
+ lockBranchesOpen?: boolean;
265
+ /** The site's own More text, already translated. Omitted means the panel's localized `more` term. */
266
+ moreLabel?: string;
267
+ /** How many values More adds, excluding selected values already shown. Sent only with `hasMore`; not rendered. */
268
+ nextPageSize?: number;
269
+ presentation?: FacetPresentation;
270
+ /** The reset button's accessible name, already translated (e.g. "Reset to default types"). Omitted means the term. */
271
+ resetLabel?: string;
272
+ /** Omitted hides the select-all checkbox. */
273
+ selectAll?: FacetSelectAll;
274
+ selectionMode: 'multiple' | 'single';
275
+ showCounts: boolean;
276
+ /** Whether the foldable heading shows an arrow. Hiding it does not disable the heading button. */
277
+ showExpandArrow: boolean;
278
+ state: FacetState;
279
+ /** Number of values on the server, hidden ones included. Sent only with `hasMore`; not rendered. */
280
+ totalCount?: number;
281
+ /**
282
+ * Values already ordered and limited by the server; the panel renders them as supplied, without sorting or cutting.
283
+ * A selected value past the limit is sent in its normal position.
284
+ */
285
+ values: FacetNode[];
286
+ }
287
+ /** One chip of the "Applied filters" block: one condition of the search, built by the server. */
288
+ export interface SummaryCriterion {
289
+ /** Set when the chip is one of the panel's filters. */
290
+ facetId?: string;
291
+ /**
292
+ * That filter's picked values, as the exact `FacetNode.value` strings of the same payload. Opaque: compared as
293
+ * strings, never parsed. While the chip's removal waits for Apply they show at their default (unticked unless the
294
+ * value has `defaultChecked`), and so does every other value of the facet that has a `defaultChecked`.
295
+ */
296
+ facetValues?: string[];
297
+ /** Opaque; sent back unchanged in `removeCriterion`. */
298
+ id: string;
299
+ /** Thumbnail of a reverse image search. */
300
+ imageUrl?: string;
301
+ /** Clear all filters removes only `facet` chips; Clear All removes every removable chip. */
302
+ kind: 'facet' | 'other' | 'seeThru' | 'text';
303
+ /** The filter name. Empty for the see-thru chip and a forced display value: the chip shows its text alone. */
304
+ label: string;
305
+ removable: boolean;
306
+ /** "Similar tones" only: one `#RRGGBB` per entry of `values`, in the same order. The chip draws a dot per entry. */
307
+ swatches?: string[];
308
+ /** The chip text already shaped by the site's rules. Omitted means `values` joined with ", ". */
309
+ text?: string;
310
+ /** The full text for hover; sent only when the text was cut or the chip has several values. */
311
+ tooltip?: string;
312
+ values: string[];
313
+ }
314
+ /** Applied-filter summary data. */
315
+ export interface SearchFacetsSummary {
316
+ canChangeFilters: boolean;
317
+ canRefresh: boolean;
318
+ /** Whether Clear All is offered. Authoritative: the preview never recomputes it. */
319
+ canReset: boolean;
320
+ /** Whether the block starts closed. Read once per panel instance; omitted means it starts open. */
321
+ collapsed?: boolean;
322
+ /** One chip per condition, in the search's order. */
323
+ criteria: SummaryCriterion[];
324
+ /** The translated heading with the count filled in. Omitted means the panel's own counted term. */
325
+ title?: string;
326
+ }
327
+ /** A terminal failure without a payload. The ID must match the active Apply or host recount. */
328
+ export interface SearchFacetsRequestResult {
329
+ requestId: string;
330
+ status: 'cancelled' | 'error';
331
+ }
332
+ /** Contract v0 payload supplied by the host. */
333
+ export interface SearchFacetsData {
334
+ facets: Facet[];
335
+ panel?: PanelConfig;
336
+ /**
337
+ * `requestId` of the Apply this payload answers, echoed unchanged by the server. `null` means the payload answers
338
+ * no Apply, for example a More response. When omitted, the next payload after Apply resolves it.
339
+ */
340
+ responseTo?: string | null;
341
+ searchKey?: string;
342
+ /** Omitted when the host supplies no "Applied filters" block. */
343
+ summary?: SearchFacetsSummary;
344
+ totalCount: number;
345
+ }
346
+ /** Stable render key scoped by facet because values may repeat across facets. */
347
+ export declare const nodeKey: (facetId: string, value: string) => string;
@@ -24,6 +24,12 @@ export declare const cropModes: {
24
24
  value: string;
25
25
  }[];
26
26
  export declare const INPUT_DEBOUNCE_DELAY = 1000;
27
+ /**
28
+ * The largest width or height a size input takes, in pixels or as a ratio term: the Int32 max. The server
29
+ * reads crop sides as UInt32 and keeps some sizes as int, so a larger one saves, but the format can no
30
+ * longer be parsed and its transformation panel fails to open.
31
+ */
32
+ export declare const MAX_TRANSFORMATION_SIDE = 2147483647;
27
33
  export type Proxy = {
28
34
  cdnName: string | null;
29
35
  extension: string | null;
@@ -0,0 +1,104 @@
1
+ /** Which control initiated a selection change. Purely presentational: it never reaches the Apply batch. */
2
+ export type ToggleVia = 'checkbox' | 'label';
3
+ /**
4
+ * What a ticking change does to the facet's other picks (contract r4). `'add'` keeps them, as a checkbox tick;
5
+ * `'replace'` clears them first, as a click whose meaning is "pick only this value" (a name click on a facet whose
6
+ * `labelClickTarget` is `'separate'`). Omitted means `'add'`, so payloads from before r4 behave as before. The
7
+ * component states the intent where it already knows the click's meaning; the server applies it whatever its own
8
+ * facet settings are. `via` rides along on the wire change but stays presentational — the server never reads it.
9
+ */
10
+ export type TogglePickMode = 'add' | 'replace';
11
+ /** One value the user ticked or unticked in a facet body, before Apply. `pickMode` states the intent (contract r4). */
12
+ export interface SearchFacetToggleDetail {
13
+ checked: boolean;
14
+ facetId: string;
15
+ pickMode?: TogglePickMode;
16
+ value: string;
17
+ via: ToggleVia;
18
+ }
19
+ /**
20
+ * A date filter's validation texts, already translated by the server, keyed as today's
21
+ * `Interface_BO.Data.Controls.Date.InvalidDateWarningMessage`. A text left out falls back to the panel's term.
22
+ */
23
+ export interface FacetDateMessages {
24
+ dateIsNotCompletelyFilled?: string;
25
+ invalidDate?: string;
26
+ invalidInterval?: string;
27
+ maxDateViolated?: string;
28
+ minDateViolated?: string;
29
+ /** Advanced date filter: a one-date mode with no date (COR "Missing Date field"). */
30
+ missingDate?: string;
31
+ /** Advanced date filter: Interval Dates missing one or both dates (COR "Missing From Date and/or Until Date field"). */
32
+ missingIntervalDate?: string;
33
+ }
34
+ /** Which validation text a date filter shows. */
35
+ export type FacetDateMessageKey = keyof FacetDateMessages;
36
+ /** A side of a date filter: the one a message is about, or a date a mode takes. */
37
+ export type FacetDateSide = 'from' | 'until';
38
+ /** A time select of an advanced date filter, in the order a date shows them. */
39
+ export type FacetDateTimeUnit = 'hour' | 'minute' | 'second';
40
+ /**
41
+ * What a date filter shows while a validation message holds Apply: both fields' text, the period, and the message.
42
+ * The panel keeps it so the blocked day survives a fold; it never reaches the Apply batch. On an advanced date filter
43
+ * `mode` is the shown mode and each text is that date's boxes in display order joined with `/` (`/11/2021`); with time
44
+ * selects, a space and their values joined with `:` follow, an empty unit left empty (`29/11/2021 10::`).
45
+ */
46
+ export interface SearchFacetDateDraft {
47
+ error: FacetDateMessageKey;
48
+ field: FacetDateSide;
49
+ fromText: string;
50
+ mode?: string;
51
+ period?: string;
52
+ /** Holds Apply without showing the message yet: an advanced mode just picked, its dates still empty. */
53
+ quiet?: boolean;
54
+ untilText: string;
55
+ }
56
+ /**
57
+ * A date body's edit, sent to `cx-search-facets` (internal). Days are `YYYY-MM-DD`; a side left out is open. `invalid`:
58
+ * the fields hold something that is not a day, so nothing is queued and Apply waits; `draft` is what they show. On an
59
+ * advanced date filter `mode` is the picked mode and the dates are `YYYY`, `YYYY-MM` or `YYYY-MM-DD`, or, on a field
60
+ * that shows a time, a full day with a time `YYYY-MM-DD HH:mm:ss`.
61
+ */
62
+ export interface SearchFacetDateChangeDetail {
63
+ draft?: SearchFacetDateDraft;
64
+ facetId: string;
65
+ from?: string;
66
+ invalid?: boolean;
67
+ mode?: string;
68
+ period?: string;
69
+ until?: string;
70
+ }
71
+ /**
72
+ * One normalized operation in a `cx-search-facets-apply` batch (contract r4).
73
+ * Facet IDs, values, and criterion IDs are opaque server strings and are sent unchanged.
74
+ */
75
+ export type FacetChange = {
76
+ checked: boolean;
77
+ facetId: string;
78
+ pickMode?: TogglePickMode;
79
+ type: 'toggle';
80
+ value: string;
81
+ via?: ToggleVia;
82
+ } | {
83
+ checked: boolean;
84
+ facetId: string;
85
+ type: 'selectAll';
86
+ value?: string;
87
+ } | {
88
+ criterionId: string;
89
+ type: 'removeCriterion';
90
+ } | {
91
+ facetId: string;
92
+ from?: string;
93
+ mode?: string;
94
+ period?: string;
95
+ type: 'date';
96
+ until?: string;
97
+ } | {
98
+ facetId: string;
99
+ type: 'reset';
100
+ } | {
101
+ type: 'clearAll';
102
+ } | {
103
+ type: 'clearFilters';
104
+ };
@@ -92,6 +92,7 @@ export interface Translation extends DefaultTranslation {
92
92
  appearance: string;
93
93
  appearanceOptions: string;
94
94
  appliedFilters: string;
95
+ appliedFiltersCount: (count: number) => string;
95
96
  apply: string;
96
97
  applyFilters: string;
97
98
  applyToPanels: string;
@@ -231,6 +232,7 @@ export interface Translation extends DefaultTranslation {
231
232
  class: string;
232
233
  clear: string;
233
234
  clearAll: string;
235
+ clearAllFilters: string;
234
236
  clearCache: string;
235
237
  clearEntry: string;
236
238
  clearSearch: string;
@@ -289,6 +291,7 @@ export interface Translation extends DefaultTranslation {
289
291
  control: string;
290
292
  copied: string;
291
293
  copy: string;
294
+ copyHtml: string;
292
295
  createANewPalette: string;
293
296
  createNew: string;
294
297
  createRecord: string;
@@ -489,6 +492,7 @@ export interface Translation extends DefaultTranslation {
489
492
  filledBodySecondaryColorAsBackground: string;
490
493
  filter: string;
491
494
  filterButtonOpens: string;
495
+ filterRegion: (name: string) => string;
492
496
  filters: string;
493
497
  find: string;
494
498
  findAndReplace: string;
@@ -737,6 +741,7 @@ export interface Translation extends DefaultTranslation {
737
741
  next: string;
738
742
  nextMatch: string;
739
743
  nextMatchEnter: string;
744
+ nextMonth: string;
740
745
  nextOccurrence: string;
741
746
  nextPage: string;
742
747
  nextSlide: string;
@@ -748,6 +753,7 @@ export interface Translation extends DefaultTranslation {
748
753
  noDataAvailable: string;
749
754
  noDownloads: string;
750
755
  noDownloadsMessage: string;
756
+ noFilters: string;
751
757
  noItemsAddedYet: (dialog: string) => string;
752
758
  noPalette: string;
753
759
  noPreviewAvailable: string;
@@ -875,6 +881,7 @@ export interface Translation extends DefaultTranslation {
875
881
  previousJobUnfinished: string;
876
882
  previousMatch: string;
877
883
  previousMatchShiftEnter: string;
884
+ previousMonth: string;
878
885
  previousOccurrence: string;
879
886
  previousPage: string;
880
887
  previousSlide: string;
@@ -901,6 +908,8 @@ export interface Translation extends DefaultTranslation {
901
908
  rememberCollapsedState: string;
902
909
  remove: string;
903
910
  removeBlock: string;
911
+ removeFilter: (name: string) => string;
912
+ removeFilterValues: (name: string, values: string) => string;
904
913
  removeFolder: (num: number) => string;
905
914
  removeGradientStop: string;
906
915
  renderAudio: string;
@@ -911,6 +920,7 @@ export interface Translation extends DefaultTranslation {
911
920
  representativeImage: string;
912
921
  requestInProgress: string;
913
922
  reset: string;
923
+ resetFilter: (name: string) => string;
914
924
  resetPosition: string;
915
925
  resize: string;
916
926
  resources: string;
@@ -961,6 +971,28 @@ export interface Translation extends DefaultTranslation {
961
971
  searchApiQuery: string;
962
972
  searchBox: string;
963
973
  searchDownloads: string;
974
+ searchFacetsChangesDropped: string;
975
+ searchFacetsChangesPending: (count: number) => string;
976
+ searchFacetsClearDate: (name: string) => string;
977
+ searchFacetsDateAfterRange: string;
978
+ searchFacetsDateBeforeRange: string;
979
+ searchFacetsDateIncomplete: string;
980
+ searchFacetsDateInvalid: string;
981
+ searchFacetsDateInvalidInterval: string;
982
+ searchFacetsDateMissing: string;
983
+ searchFacetsDateMissingInterval: string;
984
+ searchFacetsDateMode: string;
985
+ searchFacetsDatePeriod: string;
986
+ searchFacetsOnlySelected: (label: string) => string;
987
+ searchFacetsRequestCancelled: string;
988
+ searchFacetsRequestError: string;
989
+ searchFacetsResults: (count: number) => string;
990
+ searchFacetsSelectDate: (name: string) => string;
991
+ searchFacetsSelectEndDate: (name: string) => string;
992
+ searchFacetsSelectOnly: (label: string) => string;
993
+ searchFacetsSelectStartDate: (name: string) => string;
994
+ searchFacetsUpdating: string;
995
+ searchFacetsValueWithCount: (label: string, count: string) => string;
964
996
  searchFolders: string;
965
997
  searchOptions: string;
966
998
  searchPlaceholder: string;
@@ -973,6 +1005,7 @@ export interface Translation extends DefaultTranslation {
973
1005
  sectionStyle: string;
974
1006
  sectionTitles: string;
975
1007
  securityPoint: string;
1008
+ seeMoreFilters: (name: string) => string;
976
1009
  seeThru: string;
977
1010
  seeThruOnRealFolderOnly: string;
978
1011
  seeThruOnVirtualFolder: string;
@@ -980,6 +1013,7 @@ export interface Translation extends DefaultTranslation {
980
1013
  selectAColorFromTheScreen: string;
981
1014
  selectARelationship: string;
982
1015
  selectAll: string;
1016
+ selectAllFilter: (name: string) => string;
983
1017
  selectFolder: string;
984
1018
  selectFolders: string;
985
1019
  selected: string;
@@ -1163,6 +1197,11 @@ export interface Translation extends DefaultTranslation {
1163
1197
  unauthorized: string;
1164
1198
  underline: string;
1165
1199
  undo: string;
1200
+ undoClearAll: string;
1201
+ undoClearAllFilters: string;
1202
+ undoRemoveFilter: (name: string) => string;
1203
+ undoRemoveFilterValues: (name: string, values: string) => string;
1204
+ undoResetFilter: (name: string) => string;
1166
1205
  unfavorite: string;
1167
1206
  uniqueIdentifier: string;
1168
1207
  unit: string;
@@ -14,6 +14,8 @@ export interface CalendarCell {
14
14
  year: number;
15
15
  }
16
16
  export interface CalendarGridParams {
17
+ /** First day of the week, 0 = Sunday … 6 = Saturday. Omitted: Sunday. */
18
+ firstDayOfWeek?: number;
17
19
  /** Maximum selectable date. Empty string means no maximum. */
18
20
  maxDate: CalendarDate;
19
21
  /** Minimum selectable date. Empty string means no minimum. */
@@ -28,12 +30,9 @@ export interface CalendarGridParams {
28
30
  }
29
31
  export declare class CalendarGrid {
30
32
  /**
31
- * Generates a fixed 35-cell (5 weeks × 7 days) grid for the given month.
32
- * The grid always starts on Sunday. Days before the 1st and after the last
33
- * day of viewMonth are marked isOutside = true but remain selectable.
34
- *
35
- * Note: months that span more than 5 weeks (start on Fri/Sat with 30/31 days)
36
- * will have their last 1-2 days truncated. This matches the fixed-height design.
33
+ * Generates the whole weeks that hold every day of the given month: 35 cells (5 weeks), or 42 (6 weeks) when the
34
+ * month needs them, so no day is dropped. The grid starts on `firstDayOfWeek` (Sunday by default). Days before the
35
+ * 1st and after the last day of viewMonth are marked isOutside = true but remain selectable.
37
36
  */
38
37
  static generate(params: CalendarGridParams): CalendarCell[];
39
38
  }
@@ -1,6 +1,12 @@
1
1
  /** Strict date-only string in YYYY-MM-DD format. No time, no timezone. */
2
2
  export type CalendarDate = string;
3
- /** Returns true only for well-formed, calendar-valid YYYY-MM-DD strings. */
3
+ /**
4
+ * Builds a local date for any year. `new Date(year, monthIndex, day)` reads a year from 0 to 99 as 1900-1999, so a
5
+ * calendar day in 0001-0099 would land in the wrong century; `setFullYear` takes the year as given. Month and day may
6
+ * overflow, as with `new Date` (month 13 is January of the next year, day 0 the last day of the month before).
7
+ */
8
+ export declare function buildLocalDate(year: number, monthIndex: number, day: number): Date;
9
+ /** Returns true only for well-formed, calendar-valid YYYY-MM-DD strings, years 0001-9999. */
4
10
  export declare function isValidIsoDate(value: string): value is CalendarDate;
5
11
  /** Builds a CalendarDate from numeric parts. Month is 1-based. */
6
12
  export declare function toIsoDate(year: number, month: number, day: number): CalendarDate;