@orangelogic/design-system 2.228.0 → 2.230.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.
- package/library/chunks/{asset-link-format.DLYctI8Q.js → asset-link-format.C524ORni.js} +723 -701
- package/library/chunks/{button.CrhpoXK8.js → button.ByfW1n1P.js} +1 -1
- package/library/chunks/{color-swatch-group.DMpWk1pm.js → color-swatch-group.BsS_WSkX.js} +9 -9
- package/library/chunks/{color-swatch.CSsvAlq8.js → color-swatch.BMsBeGVi.js} +1 -1
- package/library/chunks/{confirm-popover.CrB-N3KV.js → confirm-popover.sVFj9zPi.js} +3 -3
- package/library/chunks/{dialog.DWa11p4j.js → dialog.C1GgF9kf.js} +2 -2
- package/library/chunks/{document-viewer.D5885amO.js → document-viewer.BYoPlykW.js} +6 -6
- package/library/chunks/{dot-pagination.ry5d0ZtQ.js → dot-pagination.yATbscYF.js} +1 -1
- package/library/chunks/{folder-select.BIXyzMCY.js → folder-select.BVvQo_lR.js} +4 -4
- package/library/chunks/{header.CIdqF9dY.js → header.BXuOKS0L.js} +1 -1
- package/library/chunks/{i18n.CXIpdSSZ.js → i18n.Dv4-j3re.js} +4 -3
- package/library/chunks/{icon-button.BBLy-yj3.js → icon-button.N5YNs1qg.js} +1 -1
- package/library/chunks/{iframe.FHGbVxm4.js → iframe.b-u-DyQ0.js} +1 -1
- package/library/chunks/{image.BYDGEbte.js → image.6LrV-0hE.js} +2 -2
- package/library/chunks/{input.B1JamaTE.js → input.ve6RUdJ5.js} +1 -1
- package/library/chunks/{markdown.DP1DqzwO.js → markdown.CpZAccJx.js} +2 -2
- package/library/chunks/{option.C3DgnL2F.js → option.C7dkuxVF.js} +1 -1
- package/library/chunks/{pagination.DSi4odS9.js → pagination.s4rK5EBT.js} +5 -5
- package/library/chunks/{tab-group.PQnc285p.js → tab-group.CvUu5LK3.js} +3 -3
- package/library/chunks/{toast.GT3J-T2_.js → toast.CR5tYYn3.js} +1 -1
- package/library/chunks/transformation.0cnXfwVJ.js +415 -0
- package/library/chunks/{tree.BS7eGCf0.js → tree.yJto6M6E.js} +1 -1
- package/library/chunks/url.qYS-uQJe.js +89 -0
- package/library/components/alert.js +2 -2
- package/library/components/asset-link-format.js +4 -4
- package/library/components/atoms.js +14 -14
- package/library/components/audio.js +9 -5
- package/library/components/border-input-group.js +2 -2
- package/library/components/breadcrumb.js +1 -1
- package/library/components/button.js +2 -2
- package/library/components/color-picker.js +3 -3
- package/library/components/color-swatch-group.js +5 -5
- package/library/components/color-swatch.js +2 -2
- package/library/components/confirm-popover.js +4 -4
- package/library/components/copy-button.js +1 -1
- package/library/components/corner-position-input-group.js +3 -3
- package/library/components/date-calendar.js +1 -1
- package/library/components/details.js +1 -1
- package/library/components/dialog.js +3 -3
- package/library/components/document-viewer.js +3 -3
- package/library/components/dot-pagination.js +2 -2
- package/library/components/drawer.js +2 -2
- package/library/components/dropdown.js +32 -23
- package/library/components/dynamic-select.js +4 -4
- package/library/components/e-chart.js +1 -1
- package/library/components/element-clamp.js +2 -2
- package/library/components/file-on-demand.js +10 -10
- package/library/components/folder-select.js +4 -4
- package/library/components/format-bytes.js +1 -1
- package/library/components/format-date.js +1 -1
- package/library/components/format-number.js +1 -1
- package/library/components/format-time.js +1 -1
- package/library/components/header.js +2 -2
- package/library/components/icon-button.js +2 -2
- package/library/components/iframe.js +2 -2
- package/library/components/image-comparer.js +1 -1
- package/library/components/image.js +3 -3
- package/library/components/input.js +2 -2
- package/library/components/line-clamp.js +1 -1
- package/library/components/markdown.js +3 -3
- package/library/components/masonry.js +2 -2
- package/library/components/menu-item.js +1 -1
- package/library/components/menu.js +1 -1
- package/library/components/molecules.js +3 -3
- package/library/components/option.js +2 -2
- package/library/components/organisms.js +2 -2
- package/library/components/padding-input-group.js +1 -1
- package/library/components/pagination.js +6 -6
- package/library/components/popup.js +1 -1
- package/library/components/position-picker.js +1 -1
- package/library/components/progress-bar.js +1 -1
- package/library/components/progress-ring.js +1 -1
- package/library/components/range.js +1 -1
- package/library/components/rating.js +1 -1
- package/library/components/relative-time.js +1 -1
- package/library/components/select.js +2 -2
- package/library/components/shadow-input-group.js +1 -1
- package/library/components/share-option-list.js +1 -1
- package/library/components/sidebar.js +4 -3
- package/library/components/size-input-group.js +3 -3
- package/library/components/spinner.js +1 -1
- package/library/components/split-panel.js +1 -1
- package/library/components/tab-group.js +4 -4
- package/library/components/tab.js +2 -2
- package/library/components/tag.js +2 -2
- package/library/components/tooltip.js +1 -1
- package/library/components/tree-item.js +2 -2
- package/library/components/tree.js +2 -2
- package/library/components/typeface.js +2 -2
- package/library/components/types.js +19792 -19635
- package/library/components/video.js +2 -2
- package/library/package.json +1 -1
- package/library/packages/atoms/src/components/audio/audio.d.ts +2 -0
- package/library/packages/atoms/src/components/dropdown/dropdown.d.ts +6 -0
- package/library/packages/events/src/events.d.ts +0 -4
- package/library/packages/organisms/src/content-builder/blocks/audio/audio.d.ts +24 -0
- package/library/packages/organisms/src/content-builder/blocks/image/image.d.ts +12 -5
- package/library/packages/organisms/src/content-builder/blocks/video/video.d.ts +5 -4
- package/library/packages/organisms/src/content-builder/components/config-form/config-form-controller.d.ts +5 -0
- package/library/packages/organisms/src/content-builder/content-builder.d.ts +17 -1
- package/library/packages/organisms/src/content-builder-viewer/content-builder-viewer.d.ts +9 -0
- package/library/packages/tools/src/fetch-asset/fetch-asset.d.ts +2 -1
- package/library/packages/tools/src/fetch-image/fetch-image.d.ts +27 -0
- package/library/packages/utils/src/asset-url-mode/asset-url-mode.d.ts +22 -0
- package/library/packages/utils/src/asset-url-mode/index.d.ts +1 -0
- package/library/packages/utils/src/custom-element/i18n.d.ts +1 -0
- package/library/packages/utils/src/url/url.d.ts +7 -0
- package/library/react-web-component.d.ts +13 -1
- package/library/utils.js +214 -213
- package/package.json +1 -1
- package/library/chunks/transformation.Bjs3TBPd.js +0 -376
- package/library/chunks/url.CGdWC06g.js +0 -76
- package/library/packages/events/src/cx-image-src-resolved.d.ts +0 -9
- package/library/packages/events/src/cx-timeline-data-resolved.d.ts +0 -10
- package/library/packages/events/src/cx-video-src-resolved.d.ts +0 -8
- 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.
|
|
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.
|
|
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";
|
package/library/package.json
CHANGED
|
@@ -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,
|
|
338
|
-
* `record-id` + `format` (light
|
|
339
|
-
* `src` / `srcDarkMode`
|
|
340
|
-
*
|
|
341
|
-
*
|
|
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
|
|
205
|
-
* `format
|
|
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';
|
|
@@ -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
|
*/
|