@orangelogic/design-system 2.228.0 → 2.229.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 (116) hide show
  1. package/library/chunks/{asset-link-format.DLYctI8Q.js → asset-link-format.C524ORni.js} +723 -701
  2. package/library/chunks/{button.CrhpoXK8.js → button.ByfW1n1P.js} +1 -1
  3. package/library/chunks/{color-swatch-group.DMpWk1pm.js → color-swatch-group.BsS_WSkX.js} +9 -9
  4. package/library/chunks/{color-swatch.CSsvAlq8.js → color-swatch.BMsBeGVi.js} +1 -1
  5. package/library/chunks/{confirm-popover.CrB-N3KV.js → confirm-popover.sVFj9zPi.js} +3 -3
  6. package/library/chunks/{dialog.DWa11p4j.js → dialog.C1GgF9kf.js} +2 -2
  7. package/library/chunks/{document-viewer.D5885amO.js → document-viewer.BYoPlykW.js} +6 -6
  8. package/library/chunks/{dot-pagination.ry5d0ZtQ.js → dot-pagination.yATbscYF.js} +1 -1
  9. package/library/chunks/{folder-select.BIXyzMCY.js → folder-select.BVvQo_lR.js} +4 -4
  10. package/library/chunks/{header.CIdqF9dY.js → header.BXuOKS0L.js} +1 -1
  11. package/library/chunks/{i18n.CXIpdSSZ.js → i18n.Dv4-j3re.js} +4 -3
  12. package/library/chunks/{icon-button.BBLy-yj3.js → icon-button.N5YNs1qg.js} +1 -1
  13. package/library/chunks/{iframe.FHGbVxm4.js → iframe.b-u-DyQ0.js} +1 -1
  14. package/library/chunks/{image.BYDGEbte.js → image.6LrV-0hE.js} +2 -2
  15. package/library/chunks/{input.B1JamaTE.js → input.ve6RUdJ5.js} +1 -1
  16. package/library/chunks/{markdown.DP1DqzwO.js → markdown.CpZAccJx.js} +2 -2
  17. package/library/chunks/{option.C3DgnL2F.js → option.C7dkuxVF.js} +1 -1
  18. package/library/chunks/{pagination.DSi4odS9.js → pagination.s4rK5EBT.js} +5 -5
  19. package/library/chunks/{tab-group.PQnc285p.js → tab-group.CvUu5LK3.js} +3 -3
  20. package/library/chunks/{toast.GT3J-T2_.js → toast.CR5tYYn3.js} +1 -1
  21. package/library/chunks/transformation.0cnXfwVJ.js +415 -0
  22. package/library/chunks/{tree.BS7eGCf0.js → tree.yJto6M6E.js} +1 -1
  23. package/library/chunks/url.qYS-uQJe.js +89 -0
  24. package/library/components/alert.js +2 -2
  25. package/library/components/asset-link-format.js +4 -4
  26. package/library/components/atoms.js +14 -14
  27. package/library/components/audio.js +9 -5
  28. package/library/components/border-input-group.js +2 -2
  29. package/library/components/breadcrumb.js +1 -1
  30. package/library/components/button.js +2 -2
  31. package/library/components/color-picker.js +3 -3
  32. package/library/components/color-swatch-group.js +5 -5
  33. package/library/components/color-swatch.js +2 -2
  34. package/library/components/confirm-popover.js +4 -4
  35. package/library/components/copy-button.js +1 -1
  36. package/library/components/corner-position-input-group.js +3 -3
  37. package/library/components/date-calendar.js +1 -1
  38. package/library/components/details.js +1 -1
  39. package/library/components/dialog.js +3 -3
  40. package/library/components/document-viewer.js +3 -3
  41. package/library/components/dot-pagination.js +2 -2
  42. package/library/components/drawer.js +2 -2
  43. package/library/components/dropdown.js +32 -23
  44. package/library/components/dynamic-select.js +4 -4
  45. package/library/components/e-chart.js +1 -1
  46. package/library/components/element-clamp.js +2 -2
  47. package/library/components/file-on-demand.js +10 -10
  48. package/library/components/folder-select.js +4 -4
  49. package/library/components/format-bytes.js +1 -1
  50. package/library/components/format-date.js +1 -1
  51. package/library/components/format-number.js +1 -1
  52. package/library/components/format-time.js +1 -1
  53. package/library/components/header.js +2 -2
  54. package/library/components/icon-button.js +2 -2
  55. package/library/components/iframe.js +2 -2
  56. package/library/components/image-comparer.js +1 -1
  57. package/library/components/image.js +3 -3
  58. package/library/components/input.js +2 -2
  59. package/library/components/line-clamp.js +1 -1
  60. package/library/components/markdown.js +3 -3
  61. package/library/components/masonry.js +2 -2
  62. package/library/components/menu-item.js +1 -1
  63. package/library/components/menu.js +1 -1
  64. package/library/components/molecules.js +3 -3
  65. package/library/components/option.js +2 -2
  66. package/library/components/organisms.js +2 -2
  67. package/library/components/padding-input-group.js +1 -1
  68. package/library/components/pagination.js +6 -6
  69. package/library/components/popup.js +1 -1
  70. package/library/components/position-picker.js +1 -1
  71. package/library/components/progress-bar.js +1 -1
  72. package/library/components/progress-ring.js +1 -1
  73. package/library/components/range.js +1 -1
  74. package/library/components/rating.js +1 -1
  75. package/library/components/relative-time.js +1 -1
  76. package/library/components/select.js +2 -2
  77. package/library/components/shadow-input-group.js +1 -1
  78. package/library/components/share-option-list.js +1 -1
  79. package/library/components/sidebar.js +1 -1
  80. package/library/components/size-input-group.js +3 -3
  81. package/library/components/spinner.js +1 -1
  82. package/library/components/split-panel.js +1 -1
  83. package/library/components/tab-group.js +4 -4
  84. package/library/components/tab.js +2 -2
  85. package/library/components/tag.js +2 -2
  86. package/library/components/tooltip.js +1 -1
  87. package/library/components/tree-item.js +2 -2
  88. package/library/components/tree.js +2 -2
  89. package/library/components/typeface.js +2 -2
  90. package/library/components/types.js +19792 -19635
  91. package/library/components/video.js +2 -2
  92. package/library/package.json +1 -1
  93. package/library/packages/atoms/src/components/audio/audio.d.ts +2 -0
  94. package/library/packages/atoms/src/components/dropdown/dropdown.d.ts +6 -0
  95. package/library/packages/events/src/events.d.ts +0 -4
  96. package/library/packages/organisms/src/content-builder/blocks/audio/audio.d.ts +24 -0
  97. package/library/packages/organisms/src/content-builder/blocks/image/image.d.ts +12 -5
  98. package/library/packages/organisms/src/content-builder/blocks/video/video.d.ts +5 -4
  99. package/library/packages/organisms/src/content-builder/components/config-form/config-form-controller.d.ts +5 -0
  100. package/library/packages/organisms/src/content-builder/content-builder.d.ts +17 -1
  101. package/library/packages/organisms/src/content-builder-viewer/content-builder-viewer.d.ts +9 -0
  102. package/library/packages/tools/src/fetch-asset/fetch-asset.d.ts +2 -1
  103. package/library/packages/tools/src/fetch-image/fetch-image.d.ts +27 -0
  104. package/library/packages/utils/src/asset-url-mode/asset-url-mode.d.ts +22 -0
  105. package/library/packages/utils/src/asset-url-mode/index.d.ts +1 -0
  106. package/library/packages/utils/src/custom-element/i18n.d.ts +1 -0
  107. package/library/packages/utils/src/url/url.d.ts +7 -0
  108. package/library/react-web-component.d.ts +13 -1
  109. package/library/utils.js +214 -213
  110. package/package.json +1 -1
  111. package/library/chunks/transformation.Bjs3TBPd.js +0 -376
  112. package/library/chunks/url.CGdWC06g.js +0 -76
  113. package/library/packages/events/src/cx-image-src-resolved.d.ts +0 -9
  114. package/library/packages/events/src/cx-timeline-data-resolved.d.ts +0 -10
  115. package/library/packages/events/src/cx-video-src-resolved.d.ts +0 -8
  116. package/library/packages/events/src/cx-video-thumbnail-resolved.d.ts +0 -8
@@ -1,13 +1,13 @@
1
1
  import { _ as kd, a as Sa, b as Be, c as Je } from "../chunks/inheritsLoose.BuSn_CvZ.js";
2
2
  import { c as ps, a as Bn } from "../chunks/_commonjsHelpers.DQNKXVTB.js";
3
3
  import { r as Sb } from "../chunks/___vite-browser-external_commonjs-proxy.C2tf3HsQ.js";
4
- import { C as Cb } from "../chunks/image.BYDGEbte.js";
4
+ import { C as Cb } from "../chunks/image.6LrV-0hE.js";
5
5
  import Mb from "./resize-observer.js";
6
6
  import { r as Db, R as Pb, a as Rp, b as Lb } from "../chunks/resizable-component.styles.CAfXABBc.js";
7
7
  import { c as Rb } from "../chunks/component.styles.CRO4Odto.js";
8
8
  import { b as Ib } from "../chunks/browser.BHOCIF_A.js";
9
9
  import { c as Ob } from "../chunks/custom-element.L4WJXn1j.js";
10
- import { L as kb } from "../chunks/i18n.CXIpdSSZ.js";
10
+ import { L as kb } from "../chunks/i18n.Dv4-j3re.js";
11
11
  import { w as Ki } from "../chunks/watch.DJF5K-8U.js";
12
12
  import { i as Bb, x as Qc } from "../chunks/lit-element.jLBm65_O.js";
13
13
  import { n as Ri } from "../chunks/lib-cortex-element.CVMmyPMC.js";
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@orangelogic/design-system",
3
3
  "type": "module",
4
- "version": "2.228.0",
4
+ "version": "2.229.0",
5
5
  "license": "UNLICENSED",
6
6
  "types": "library/types.d.ts",
7
7
  "scripts": {
@@ -77,6 +77,8 @@ export default class CxAudio extends ResizableElement {
77
77
  * `--waves-color` and `--background-color`.
78
78
  */
79
79
  waveformSrc: string;
80
+ /** Runtime source hook for wrappers resolving waveform URLs without changing saved attributes. */
81
+ protected get waveformSource(): string;
80
82
  /**
81
83
  * Playback start position in seconds. The UI time counter starts from 0 relative to this point.
82
84
  * `cx-time-update` emits `time` relative to this value.
@@ -84,6 +84,12 @@ export default class CxDropdown extends CortexElement {
84
84
  * actually renders.
85
85
  */
86
86
  private get hoistBoundary();
87
+ /** The flip boundary for the panel. When not set, the document body is used if hoisted. */
88
+ flipBoundary?: Element | Element[];
89
+ /** The shift boundary for the panel. When not set, the document body is used if hoisted. */
90
+ shiftBoundary?: Element | Element[];
91
+ /** The auto-size boundary for the panel. When not set, the document body is used if hoisted. */
92
+ autoSizeBoundary?: Element | Element[];
87
93
  /**
88
94
  * Syncs the popup width or height to that of the trigger element.
89
95
  */
@@ -106,7 +106,6 @@ export * from './cx-hub-connection-disconnected';
106
106
  export * from './cx-hub-connection-reconnected';
107
107
  export * from './cx-hub-connection-reconnecting';
108
108
  export * from './cx-image-click';
109
- export * from './cx-image-src-resolved';
110
109
  export * from './cx-import-settings';
111
110
  export * from './cx-initial-focus';
112
111
  export * from './cx-input';
@@ -220,7 +219,6 @@ export * from './cx-table-switch-change';
220
219
  export * from './cx-table-validation-change';
221
220
  export * from './cx-time-based-change';
222
221
  export * from './cx-time-update';
223
- export * from './cx-timeline-data-resolved';
224
222
  export * from './cx-tiptap-code-block-doc-request';
225
223
  export * from './cx-tiptap-image-doc-request';
226
224
  export * from './cx-tiptap-image-host-feedback';
@@ -239,7 +237,6 @@ export * from './cx-video-comment-mouseleave';
239
237
  export * from './cx-video-comment-mouseover';
240
238
  export * from './cx-video-context-change';
241
239
  export * from './cx-video-editor-track-canvas-ready';
242
- export * from './cx-video-src-resolved';
243
240
  export * from './cx-video-editor-track-click';
244
241
  export * from './cx-video-editor-transition-click';
245
242
  export * from './cx-video-enter-fullscreen';
@@ -252,7 +249,6 @@ export * from './cx-video-prev-frame';
252
249
  export * from './cx-video-seeked';
253
250
  export * from './cx-video-segment-change';
254
251
  export * from './cx-video-time-update';
255
- export * from './cx-video-thumbnail-resolved';
256
252
  export * from './cx-view-logs';
257
253
  export * from './cx-xml-editor-asset-type-change';
258
254
  export * from './cx-xml-editor-change';
@@ -38,13 +38,37 @@ export default class CxSbAudio extends CxAudio {
38
38
  * own asset metadata and maps this data into state instead.
39
39
  */
40
40
  fetchedAssetData: Record<string, unknown>;
41
+ /** Tracks the last waveform URL applied, alongside `#lastAppliedSrc`. */
42
+ private lastAppliedWaveformSrc;
43
+ /** Monotonic token so only the latest source resolution applies its result. */
44
+ private sourceResolveVersion;
45
+ /** Set when the asset identity changed, so stored URLs are re-resolved even if reusable. */
46
+ private forceSourceResolution;
47
+ /** Runtime waveform URL resolved from the record; never written back to `waveform-src`. */
48
+ private resolvedWaveformSrc;
49
+ protected get waveformSource(): string;
41
50
  /**
42
51
  * Support CMS5 edit mode for the audio.
43
52
  */
44
53
  get isInEditMode(): boolean;
54
+ runConnectedCallback(): void;
55
+ disconnectedCallback(): void;
56
+ /**
57
+ * Resolves the playback and waveform URLs (42ASN5). A stored URL is reused only when it
58
+ * matches the page's permanent/expiring URL mode; otherwise it is re-resolved from the
59
+ * record. Resolved URLs are runtime-only and never written back into the saved page.
60
+ */
45
61
  handleSrcChange(): Promise<void>;
62
+ handleSourceIdentityChange(): void;
46
63
  handleRecordIdChange(): Promise<void>;
47
64
  handleFetchedAssetDataChange(): void;
65
+ private resolveWaveformSource;
66
+ /**
67
+ * Re-resolves a stored URL that is not reusable for the page's URL mode, from
68
+ * `record-id` + `format`. Returns the stored URL unchanged when there is nothing to
69
+ * recover from, or when the fresh resolve fails.
70
+ */
71
+ private recoverStoredSrc;
48
72
  private applyAssetData;
49
73
  }
50
74
  declare global {
@@ -292,6 +292,12 @@ export default class CxSbImage extends CxImage {
292
292
  handleClickSpaceChange(): void;
293
293
  handleObjectFitChange(): Promise<void>;
294
294
  handleSrcChange(): void;
295
+ /**
296
+ * The viewer hands out the page token after it has applied the page's URL mode, and an
297
+ * anonymous read-mode page cannot resolve a URL without it, so a recovery that ran earlier
298
+ * is retried here — the same way the other record-id blocks react to the token.
299
+ */
300
+ handleSiteBuilderTokenChange(): void;
295
301
  /**
296
302
  * Drops a cached extension once the asset it described is replaced, so a new record
297
303
  * cannot inherit the previous one's answer about whether it may be resized — nor its
@@ -334,11 +340,12 @@ export default class CxSbImage extends CxImage {
334
340
  */
335
341
  private resolveClickSpace;
336
342
  /**
337
- * When a stored URL has expired, re-resolve a fresh one from the block's
338
- * `record-id` + `format` (light and dark variants independently). Fires on every
339
- * `src` / `srcDarkMode` change and no-ops for non-expired URLs, so working paths
340
- * are untouched. On failure it leaves the stored URL in place and lets the
341
- * existing `@error` / fallback path handle it.
343
+ * When a stored URL has expired, or does not match the page's permanent/expiring URL
344
+ * mode (42ASN5), re-resolve a fresh one from the block's `record-id` + `format` (light
345
+ * and dark variants independently). Fires on every `src` / `srcDarkMode` / token change
346
+ * and no-ops for reusable URLs, so working paths are untouched. Recovery changes runtime
347
+ * delivery only; the saved light/dark URLs stay untouched. On failure it leaves the
348
+ * stored URL in place and lets the existing `@error` / fallback path handle it.
342
349
  */
343
350
  private recoverExpiredSources;
344
351
  private recoverExpiredSource;
@@ -197,13 +197,14 @@ export default class CxSbVideo extends CxVideo {
197
197
  handleFetchedAssetDataChange(): void;
198
198
  handleSrcChange(): Promise<void>;
199
199
  /**
200
- * Returns the URL to hand to the player
200
+ * Returns the URL to hand to the player. A stored URL that has expired, or that does not
201
+ * match the page's permanent/expiring URL mode (42ASN5), is re-resolved from `record-id` +
202
+ * `format`. The fresh URL is runtime-only and is never written back into the saved page.
201
203
  */
202
204
  private recoverExpiredSrc;
203
205
  /**
204
- * Re-resolves a fresh playback URL from `record-id` + `format` when the stored
205
- * `format-src` has expired. Mirrors the pick-time `path_<format>.URI` resolution;
206
- * on failure the caller falls back to the stored URL.
206
+ * Re-resolves a fresh playback URL from `record-id` + `format`. Mirrors the pick-time
207
+ * `path_<format>.URI` resolution; on failure the caller falls back to the stored URL.
207
208
  */
208
209
  private resolveFreshFormatSrc;
209
210
  applySrc(src: string): Promise<void>;
@@ -27,6 +27,11 @@ export declare class ConfigFormController implements ReactiveController {
27
27
  * browser-displayable image format, fall back to the `TR1` transformation proxy, which is
28
28
  * always transcoded to a raster format. Mirrors the same fallback in `FetchImageController`
29
29
  * (used by the gallery/timeline blocks) and `cx-asset-transformation-dialog`.
30
+ *
31
+ * 42ASN5: when the page uses expiring asset URLs the search never asks for permanent paths (on
32
+ * the server that request creates the permanent anonymous link this feature removes). An image
33
+ * (`resolveExpiringImagePath`) then takes its signed `path_TR1` / `path_TRX` unmodified instead of
34
+ * the configured format; other media keep resolving their configured format.
30
35
  */
31
36
  private resolveAssetFormatSrc;
32
37
  private handleStyleChange;
@@ -19,7 +19,9 @@ type TranslatableTextRecordOptions = {
19
19
  *
20
20
  * Set `enable-asset-format-controls` to expose the asset format, transformation,
21
21
  * download-format, and asset-format-picker controls on image, video, gallery,
22
- * carousel, and timeline blocks. Off by default.
22
+ * carousel, and timeline blocks. Off by default. When `use-expiring-asset-urls` is
23
+ * also set, expiring URLs take precedence and the incompatible format and
24
+ * transformation controls stay disabled.
23
25
  *
24
26
  * `default-image-format`, `default-video-poster-format`, `default-timeline-format`,
25
27
  * `default-gallery-format` and `default-carousel-format` are retained for backward
@@ -113,6 +115,13 @@ export default class CxContentBuilder extends CortexElement {
113
115
  * @default false
114
116
  */
115
117
  enableAssetFormatControls: boolean;
118
+ /**
119
+ * Whether the server mints expiring asset URLs for this instance (42ASN5). When set, resolutions stop
120
+ * asking for permanent asset paths, which on the server would create the permanent anonymous link this
121
+ * feature removes. When this and `enable-asset-format-controls` are both true,
122
+ * expiring URLs take precedence and the incompatible controls stay disabled.
123
+ */
124
+ useExpiringAssetUrls: boolean;
116
125
  /**
117
126
  * Whether the content builder emits `ol:ui-metric` events timing each user action,
118
127
  * for collection as browser OpenTelemetry histograms.
@@ -269,6 +278,13 @@ export default class CxContentBuilder extends CortexElement {
269
278
  private get measuredOnRequestDownloadFormat();
270
279
  private get measuredOnConfigureWorkflow();
271
280
  private get measuredOnRequestAssetFormat();
281
+ /** Expiring asset URLs cannot be rewritten by format or transformation controls. */
282
+ private get resolvedEnableAssetFormatControls();
283
+ /**
284
+ * 42ASN5: one mode per page. The template manager reuses the block config sidebar, so the mode is set
285
+ * here once on first update rather than in each consumer — a second read could disagree with the viewer.
286
+ */
287
+ protected willUpdate(): void;
272
288
  get isDesigner(): boolean;
273
289
  get isTemplateEditable(): boolean;
274
290
  get isMultiLanguage(): boolean;
@@ -1,4 +1,5 @@
1
1
  import { default as CortexLightElement } from '../../../base/src/cortex-light-element.ts';
2
+ import { PropertyValues } from 'lit';
2
3
 
3
4
  /**
4
5
  * @summary Wraps content-builder output — read mode and the editor canvas alike —
@@ -25,6 +26,12 @@ export default class CxContentBuilderViewer extends CortexLightElement {
25
26
  * (which consume it as `siteBuilderToken`). Empty on authenticated/preview pages.
26
27
  */
27
28
  securityBypassToken: string;
29
+ /**
30
+ * Whether the server minted expiring asset URLs for this page (42ASN5). When present, resolutions must
31
+ * not ask for permanent asset paths — on the server that request creates the permanent anonymous link
32
+ * this feature removes. Set from the host attribute, same as `security-bypass-token`.
33
+ */
34
+ useExpiringAssetUrls: boolean;
28
35
  /** Blocks already populated by a previous asset-data scan; skipped on re-scans. */
29
36
  private readonly processedFetchableBlocks;
30
37
  /** Blocks already populated by a previous space-list scan; skipped on re-scans. */
@@ -37,6 +44,8 @@ export default class CxContentBuilderViewer extends CortexLightElement {
37
44
  createRenderRoot(): this;
38
45
  connectedCallback(): void;
39
46
  disconnectedCallback(): void;
47
+ protected willUpdate(changedProperties: PropertyValues<this>): void;
48
+ private syncAssetUrlMode;
40
49
  /** Blocks arrive in bursts as the page parses, so scans are collapsed. */
41
50
  private scheduleScan;
42
51
  private scanAndFetch;
@@ -24,9 +24,10 @@ export declare class FetchAssetController implements ReactiveController {
24
24
  * `apiGetAssets` maps a `path_<format>` media field to its `.URI` string, so the
25
25
  * fresh URL is read straight back off the requested field.
26
26
  */
27
- refetchFormatUrl({ format, recordId, securityByPassToken, token, }: {
27
+ refetchFormatUrl({ format, recordId, resolveExpiringImagePath, securityByPassToken, token, }: {
28
28
  format: string;
29
29
  recordId: string;
30
+ resolveExpiringImagePath?: boolean;
30
31
  securityByPassToken?: string;
31
32
  token?: string;
32
33
  }): Promise<string>;
@@ -41,6 +41,33 @@ export declare function isSupportedImageExtension(extension: string): boolean;
41
41
  * Every other format is already transcoded, so this only gates the original.
42
42
  */
43
43
  export declare function canServeOriginalAsImage(docType: string | undefined, extension: string): boolean;
44
+ /**
45
+ * Picks the delivery URL for one item out of the requested `path_*` fields.
46
+ *
47
+ * Under `Auto` the extension decides the proxy; under a manual format an animated source
48
+ * still takes `path_TRX` so it is not flattened. `path_TR1` closes every branch — it is
49
+ * always transcoded, so it works for any source.
50
+ *
51
+ * The chosen URL is the untransformed path from the API, so this is where the `.auto`
52
+ * marker belongs: every branch returns through `pick`, and the caller only adds a `/t/`
53
+ * segment afterwards.
54
+ */
55
+ /** @internal Exported for focused unit coverage of proxy selection. */
56
+ export declare function resolveItemSrc({ autoFormat, buildSrcset, docType, extension, format, item, manualFormat, size, useExpiringAssetUrls, }: {
57
+ autoFormat: boolean;
58
+ buildSrcset: boolean;
59
+ docType: string | undefined;
60
+ extension: string | undefined;
61
+ format: string | undefined;
62
+ item: Record<string, string | undefined>;
63
+ manualFormat: boolean;
64
+ size: string | undefined;
65
+ useExpiringAssetUrls: boolean;
66
+ }): {
67
+ maxWidth?: string;
68
+ src?: string;
69
+ srcset?: string;
70
+ };
44
71
  export declare class FetchImageController implements ReactiveController {
45
72
  private readonly host;
46
73
  private data;
@@ -0,0 +1,22 @@
1
+ export declare const EXPIRING_ASSET_PRIMARY_PATH_FIELD = "path_TR1";
2
+ export declare const EXPIRING_ASSET_FALLBACK_PATH_FIELD = "path_TRX";
3
+ type AssetUrlModeTarget = object | null | undefined;
4
+ /** Only stable, non-expiring asset URLs are safe to serialize into page content. */
5
+ export declare function isPersistableAssetUrl(url: string | null | undefined): boolean;
6
+ /** Whether a stored URL already matches the requested permanent/signed delivery mode. */
7
+ export declare function isAssetUrlReusableForMode(url: string | null | undefined, useExpiringAssetUrls: boolean): boolean;
8
+ /** Manual image formats are irrelevant when signed URL delivery takes precedence. */
9
+ export declare function isAssetFormatRequiredForMode(manualFormat: boolean, useExpiringAssetUrls: boolean): boolean;
10
+ /** Set the mode on the window/realm that will perform asset resolution. */
11
+ export declare function setExpiringAssetUrlMode(enabled: boolean, target?: AssetUrlModeTarget): void;
12
+ /** Whether signed asset URLs must be preserved instead of permanently resolved or transformed. */
13
+ export declare function isExpiringAssetUrlMode(target?: AssetUrlModeTarget): boolean;
14
+ /** The value to pass as `getPermanentAssetsPaths`. */
15
+ export declare function resolveGetPermanentAssetsPaths(target?: AssetUrlModeTarget): boolean;
16
+ /**
17
+ * Pick an unmodified signed image path without applying the configured/automatic format.
18
+ * Animated GIFs prefer their original TRX path; other assets use the safe TR1 raster path.
19
+ * TRX remains the last fallback when TR1 is unavailable and the original can render directly.
20
+ */
21
+ export declare function resolveExpiringAssetPathField(asset: Record<string, unknown>, canUseOriginal: boolean, extension?: string): string | undefined;
22
+ export {};
@@ -0,0 +1 @@
1
+ export * from './asset-url-mode';
@@ -270,6 +270,7 @@ export interface Translation extends DefaultTranslation {
270
270
  control: string;
271
271
  copied: string;
272
272
  copy: string;
273
+ copyHtml: string;
273
274
  createANewPalette: string;
274
275
  createNew: string;
275
276
  createRecord: string;
@@ -42,6 +42,13 @@ export declare function appendQueryParam(url: string, key: string, value: string
42
42
  * carry an expiry marker once they can no longer be served
43
43
  */
44
44
  export declare function isExpiredAssetUrl(url: string | null | undefined): boolean;
45
+ /**
46
+ * Reads the plaintext expiry (Unix seconds) an expiring asset URL carries, or null when it has none.
47
+ *
48
+ * A hint only: the server re-validates the signed token, so a tampered value cannot extend access — the
49
+ * worst a caller achieves is a needless recovery or a stale URL.
50
+ */
51
+ export declare function readAssetTokenExpiry(url: string | null | undefined): number | null;
45
52
  export declare function isValidUrl(urlString: string): boolean;
46
53
  export declare const RELATIVE_URL_REGEX: string;
47
54
  export declare const URL_VALIDATION_REGEX: string;
@@ -9827,7 +9827,7 @@
9827
9827
  preRender?: boolean;
9828
9828
  }
9829
9829
  /**
9830
- * The `cx-content-builder` component is used to create and manage content blocks in a CMS.<br/> Set `enable-asset-format-controls` to expose the asset format, transformation, download-format, and asset-format-picker controls on image, video, gallery, carousel, and timeline blocks. Off by default.<br/> `default-image-format`, `default-video-poster-format`, `default-timeline-format`, `default-gallery-format` and `default-carousel-format` are retained for backward compatibility but no longer do anything: every block type now starts in `Auto` and derives its proxy from the asset's own file extension.
9830
+ * The `cx-content-builder` component is used to create and manage content blocks in a CMS.<br/> Set `enable-asset-format-controls` to expose the asset format, transformation, download-format, and asset-format-picker controls on image, video, gallery, carousel, and timeline blocks. Off by default. When `use-expiring-asset-urls` is also set, expiring URLs take precedence and the incompatible format and transformation controls stay disabled.<br/> `default-image-format`, `default-video-poster-format`, `default-timeline-format`, `default-gallery-format` and `default-carousel-format` are retained for backward compatibility but no longer do anything: every block type now starts in `Auto` and derives its proxy from the asset's own file extension.
9831
9831
  */
9832
9832
  interface CxContentBuilderAttributes extends HTMLAttributes<CxContentBuilder> {
9833
9833
 
@@ -9867,6 +9867,10 @@
9867
9867
  * Whether to expose the asset format / transformation / download-format / asset-format-picker controls in the per-block config sidebar for image, video, gallery, carousel, and timeline blocks. <br/>@default false
9868
9868
  */
9869
9869
  enableAssetFormatControls?: boolean;
9870
+ /**
9871
+ * Whether the server mints expiring asset URLs for this instance (42ASN5). When set, resolutions stop asking for permanent asset paths, which on the server would create the permanent anonymous link this feature removes. When this and `enable-asset-format-controls` are both true, expiring URLs take precedence and the incompatible controls stay disabled.
9872
+ */
9873
+ useExpiringAssetUrls?: boolean;
9870
9874
  /**
9871
9875
  * Whether the content builder emits `ol:ui-metric` events timing each user action, for collection as browser OpenTelemetry histograms. <br/> Off by default: when false no timers are armed and no events are dispatched, so an unmonitored site pays nothing for this being here. <br/>@default false
9872
9876
  */
@@ -9933,6 +9937,10 @@
9933
9937
  * Page-scoped security-bypass token, stamped by the server on this element in read-mode HTML. The viewer uses it for its batched Search call and distributes it to its record-id children (which consume it as `siteBuilderToken`). Empty on authenticated/preview pages.
9934
9938
  */
9935
9939
  securityBypassToken?: string;
9940
+ /**
9941
+ * Whether the server minted expiring asset URLs for this page (42ASN5). When present, resolutions must not ask for permanent asset paths — on the server that request creates the permanent anonymous link this feature removes. Set from the host attribute, same as `security-bypass-token`.
9942
+ */
9943
+ useExpiringAssetUrls?: boolean;
9936
9944
  /**
9937
9945
  * Make localization attributes reactive eslint-disable-next-line lit/no-native-attributes
9938
9946
  */
@@ -10887,6 +10895,10 @@
10887
10895
  * Whether to expose asset format / transformation / download-format / asset-format-picker controls for image, video, gallery, carousel, and timeline blocks. Should match the host `cx-content-builder` setting. <br/>@default false
10888
10896
  */
10889
10897
  enableAssetFormatControls?: boolean;
10898
+ /**
10899
+ * Whether the server mints expiring asset URLs for this instance (42ASN5). When set, resolutions stop asking for permanent asset paths, which on the server would create the permanent anonymous link this feature removes. When this and `enable-asset-format-controls` are both true, expiring URLs take precedence and the incompatible controls stay disabled.
10900
+ */
10901
+ useExpiringAssetUrls?: boolean;
10890
10902
  /**
10891
10903
  * Exposes the font family / style / weight pickers in the block config sidebar. Should match the host `cx-content-builder` setting. <br/>@default false
10892
10904
  */