@salesforce/ui-design-mode 12.8.0 → 12.10.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 (37) hide show
  1. package/dist/authoring/core/DesignPropertyPanelRoot.d.cts +7 -1
  2. package/dist/authoring/core/DesignPropertyPanelRoot.d.ts +7 -1
  3. package/dist/authoring/core/DesignPropertyPanelRoot.d.ts.map +1 -1
  4. package/dist/authoring/core/editors/ImageEditor.d.cts +3 -5
  5. package/dist/authoring/core/editors/ImageEditor.d.ts +3 -5
  6. package/dist/authoring/core/editors/ImageEditor.d.ts.map +1 -1
  7. package/dist/authoring/core/labels/labels.d.cts +0 -9
  8. package/dist/authoring/core/labels/labels.d.ts +0 -9
  9. package/dist/authoring/core/labels/labels.d.ts.map +1 -1
  10. package/dist/authoring/core/utils/backgroundImageEdit.d.cts +22 -0
  11. package/dist/authoring/core/utils/backgroundImageEdit.d.ts +22 -0
  12. package/dist/authoring/core/utils/backgroundImageEdit.d.ts.map +1 -0
  13. package/dist/authoring/host/index.cjs +36 -18
  14. package/dist/authoring/host/index.d.cts +46 -36
  15. package/dist/authoring/host/index.d.ts +46 -36
  16. package/dist/authoring/host/index.d.ts.map +1 -1
  17. package/dist/authoring/host/index.js +36 -18
  18. package/dist/authoring/react/index.js +4 -4
  19. package/dist/authoring/web-component/index.js +21 -21
  20. package/dist/protocol/messageTypes.d.cts +11 -7
  21. package/dist/protocol/messageTypes.d.ts +11 -7
  22. package/dist/protocol/messageTypes.d.ts.map +1 -1
  23. package/dist/protocol/version.cjs +1 -1
  24. package/dist/protocol/version.js +1 -1
  25. package/dist/runtime/design-mode-interactions.js +44 -18
  26. package/dist/runtime/interactions/communicationManager.d.cts +10 -8
  27. package/dist/runtime/interactions/communicationManager.d.ts +10 -8
  28. package/dist/runtime/interactions/communicationManager.d.ts.map +1 -1
  29. package/dist/runtime/interactions/interactionsController.d.cts +1 -2
  30. package/dist/runtime/interactions/interactionsController.d.ts +1 -2
  31. package/dist/runtime/interactions/interactionsController.d.ts.map +1 -1
  32. package/dist/shared/cssUrlLayers.cjs +4 -0
  33. package/dist/shared/cssUrlLayers.d.cts +40 -0
  34. package/dist/shared/cssUrlLayers.d.ts +40 -0
  35. package/dist/shared/cssUrlLayers.d.ts.map +1 -0
  36. package/dist/shared/cssUrlLayers.js +4 -0
  37. package/package.json +1 -1
@@ -4,6 +4,7 @@ import { CmsSpace, CmsImage, CmsFolderItemsResult, CmsContentDetailResult, CmsTh
4
4
  import { ChangeSetEntry } from './history/changeSet.cjs';
5
5
  import { ChangeContext } from './history/historyService.cjs';
6
6
  import { PanelLabels } from './labels/labels.cjs';
7
+ export declare const IMAGE_SOURCE_EDITOR_LS_KEY = "designMode.imageSourceEditorEnabled";
7
8
  /** Selected-component subset the panel renders. Mirrors the protocol payload. */
8
9
  export type DesignPanelComponent = Pick<ComponentData, "name" | "tagName" | "debugSource" | "hasNonEditableText" | "media">;
9
10
  /** Per-property inline + computed style values pushed from the host. */
@@ -47,7 +48,7 @@ export interface DesignPropertyPanelProps {
47
48
  /** User clicked the selected component's source-file link. */
48
49
  onOpenSourceFile?: (payload: OpenSourceFilePayload) => void;
49
50
  /**
50
- * Apply a media-element change (e.g. `<img src>`/`alt`/`width`/`height`) to the
51
+ * Apply a media-element change (e.g. `<img src>`/`alt`) to the
51
52
  * surface. The host posts a `media-change` to the preview iframe. Present only
52
53
  * when the selected component is a media element (`component.media`).
53
54
  */
@@ -72,6 +73,11 @@ export interface DesignPropertyPanelProps {
72
73
  * Defaults to `false` — the standard header.
73
74
  */
74
75
  compactHeader?: boolean;
76
+ /**
77
+ * Force the Image Source section on/off for an `<img>` selection. Omitted →
78
+ * the localStorage override, else off (temporary gate, W-23714307).
79
+ */
80
+ imageSourceEditorEnabled?: boolean;
75
81
  /**
76
82
  * Fully-resolved, localized strings for everything the panel renders. Optional:
77
83
  * omit it (VS Code) and the panel renders its English defaults; pass a complete
@@ -4,6 +4,7 @@ import { CmsSpace, CmsImage, CmsFolderItemsResult, CmsContentDetailResult, CmsTh
4
4
  import { ChangeSetEntry } from './history/changeSet.js';
5
5
  import { ChangeContext } from './history/historyService.js';
6
6
  import { PanelLabels } from './labels/labels.js';
7
+ export declare const IMAGE_SOURCE_EDITOR_LS_KEY = "designMode.imageSourceEditorEnabled";
7
8
  /** Selected-component subset the panel renders. Mirrors the protocol payload. */
8
9
  export type DesignPanelComponent = Pick<ComponentData, "name" | "tagName" | "debugSource" | "hasNonEditableText" | "media">;
9
10
  /** Per-property inline + computed style values pushed from the host. */
@@ -47,7 +48,7 @@ export interface DesignPropertyPanelProps {
47
48
  /** User clicked the selected component's source-file link. */
48
49
  onOpenSourceFile?: (payload: OpenSourceFilePayload) => void;
49
50
  /**
50
- * Apply a media-element change (e.g. `<img src>`/`alt`/`width`/`height`) to the
51
+ * Apply a media-element change (e.g. `<img src>`/`alt`) to the
51
52
  * surface. The host posts a `media-change` to the preview iframe. Present only
52
53
  * when the selected component is a media element (`component.media`).
53
54
  */
@@ -72,6 +73,11 @@ export interface DesignPropertyPanelProps {
72
73
  * Defaults to `false` — the standard header.
73
74
  */
74
75
  compactHeader?: boolean;
76
+ /**
77
+ * Force the Image Source section on/off for an `<img>` selection. Omitted →
78
+ * the localStorage override, else off (temporary gate, W-23714307).
79
+ */
80
+ imageSourceEditorEnabled?: boolean;
75
81
  /**
76
82
  * Fully-resolved, localized strings for everything the panel renders. Optional:
77
83
  * omit it (VS Code) and the panel renders its English defaults; pass a complete
@@ -1 +1 @@
1
- {"version":3,"file":"DesignPropertyPanelRoot.d.ts","sourceRoot":"","sources":["../../../src/authoring/core/DesignPropertyPanelRoot.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"DesignPropertyPanelRoot.d.ts","sourceRoot":"","sources":["../../../src/authoring/core/DesignPropertyPanelRoot.tsx"],"names":[],"mappings":"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"}
@@ -23,8 +23,6 @@ export interface CmsImage {
23
23
  /** Editable `<img>` attributes other than `src`, mirroring what the iframe honors. */
24
24
  export interface ImageAttributes {
25
25
  alt: string;
26
- width: string;
27
- height: string;
28
26
  }
29
27
  /**
30
28
  * A page of CMS folder items pushed from the host in response to
@@ -66,9 +64,9 @@ export interface ImageEditorProps {
66
64
  value: string;
67
65
  onChange: (value: string) => void;
68
66
  id?: string;
69
- /** Current alt/width/height values; shown as editable fields below the source tabs. */
67
+ /** Current alt value; shown as an editable field below the source tabs. */
70
68
  attributes?: ImageAttributes;
71
- /** Apply a non-`src` attribute change (alt/width/height). */
69
+ /** Apply a non-`src` attribute change (alt). */
72
70
  onAttributeChange?: (attribute: keyof ImageAttributes, value: string) => void;
73
71
  /** Available CMS workspaces, pushed from the host after {@link onFetchCmsSpaces}. */
74
72
  cmsSpaces?: CmsSpace[];
@@ -101,7 +99,7 @@ export interface ImageEditorProps {
101
99
  }
102
100
  /**
103
101
  * Image-source editor: pick an `<img>` source via CMS browse, local file, or a
104
- * direct URL, plus edit alt/width/height. All host I/O (CMS fetches, local file
102
+ * direct URL, plus edit alt. All host I/O (CMS fetches, local file
105
103
  * picking, importing) is supplied via optional callback + data props so the
106
104
  * shared panel stays host-agnostic; absent callbacks make that action inert.
107
105
  */
@@ -23,8 +23,6 @@ export interface CmsImage {
23
23
  /** Editable `<img>` attributes other than `src`, mirroring what the iframe honors. */
24
24
  export interface ImageAttributes {
25
25
  alt: string;
26
- width: string;
27
- height: string;
28
26
  }
29
27
  /**
30
28
  * A page of CMS folder items pushed from the host in response to
@@ -66,9 +64,9 @@ export interface ImageEditorProps {
66
64
  value: string;
67
65
  onChange: (value: string) => void;
68
66
  id?: string;
69
- /** Current alt/width/height values; shown as editable fields below the source tabs. */
67
+ /** Current alt value; shown as an editable field below the source tabs. */
70
68
  attributes?: ImageAttributes;
71
- /** Apply a non-`src` attribute change (alt/width/height). */
69
+ /** Apply a non-`src` attribute change (alt). */
72
70
  onAttributeChange?: (attribute: keyof ImageAttributes, value: string) => void;
73
71
  /** Available CMS workspaces, pushed from the host after {@link onFetchCmsSpaces}. */
74
72
  cmsSpaces?: CmsSpace[];
@@ -101,7 +99,7 @@ export interface ImageEditorProps {
101
99
  }
102
100
  /**
103
101
  * Image-source editor: pick an `<img>` source via CMS browse, local file, or a
104
- * direct URL, plus edit alt/width/height. All host I/O (CMS fetches, local file
102
+ * direct URL, plus edit alt. All host I/O (CMS fetches, local file
105
103
  * picking, importing) is supplied via optional callback + data props so the
106
104
  * shared panel stays host-agnostic; absent callbacks make that action inert.
107
105
  */
@@ -1 +1 @@
1
- {"version":3,"file":"ImageEditor.d.ts","sourceRoot":"","sources":["../../../../src/authoring/core/editors/ImageEditor.tsx"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"ImageEditor.d.ts","sourceRoot":"","sources":["../../../../src/authoring/core/editors/ImageEditor.tsx"],"names":[],"mappings":"AASA,OAAO,EAA8B,KAAK,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEhF,0FAA0F;AAC1F,KAAK,WAAW,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC;AAmCnD,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAQ;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,sFAAsF;AACtF,MAAM,WAAW,eAAe;IAC/B,GAAG,EAAE,MAAM,CAAC;CACZ;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACpC,KAAK,EAAE,aAAa,EAAE,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,+EAA+E;AAC/E,MAAM,WAAW,sBAAsB;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CACf;AAED,0FAA0F;AAC1F,MAAM,WAAW,kBAAkB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACrB;AAED,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,8EAA8E;AAC9E,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,2EAA2E;IAC3E,UAAU,CAAC,EAAE,eAAe,CAAC;IAC7B,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,eAAe,EAAE,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IAI9E,qFAAqF;IACrF,SAAS,CAAC,EAAE,QAAQ,EAAE,CAAC;IACvB,8CAA8C;IAC9C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,gBAAgB,CAAC,EAAE,MAAM,IAAI,CAAC;IAC9B,yDAAyD;IACzD,oBAAoB,CAAC,EAAE,oBAAoB,CAAC;IAC5C,qDAAqD;IACrD,qBAAqB,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IACnF,4DAA4D;IAC5D,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,wDAAwD;IACxD,uBAAuB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IACvD,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,4DAA4D;IAC5D,mBAAmB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAClF,qGAAqG;IACrG,gBAAgB,CAAC,EAAE,CAAC,GAAG,EAAE,QAAQ,KAAK,IAAI,CAAC;IAC3C,+DAA+D;IAC/D,eAAe,CAAC,EAAE,iBAAiB,CAAC;IAGpC,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,IAAI,CAAC;IAC7B,4EAA4E;IAC5E,YAAY,CAAC,EAAE,gBAAgB,CAAC;IAEhC,qFAAqF;IACrF,WAAW,CAAC,EAAE,WAAW,CAAC;CAC1B;AAsiBD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,EAC3B,KAAK,EACL,KAAK,EACL,QAAQ,EACR,EAAY,EACZ,UAAU,EACV,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,qBAAqB,EACrB,gBAAgB,EAChB,uBAAuB,EACvB,kBAAkB,EAClB,mBAAmB,EACnB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,YAAY,EACZ,WAAW,GACX,EAAE,gBAAgB,2CAyOlB"}
@@ -103,9 +103,6 @@ export interface PanelLabels {
103
103
  previewAlt: string;
104
104
  altText: string;
105
105
  altPlaceholder: string;
106
- width: string;
107
- height: string;
108
- autoPlaceholder: string;
109
106
  workspace: string;
110
107
  selectWorkspace: string;
111
108
  selectImage: string;
@@ -367,12 +364,6 @@ export declare const REQUIRED_LABEL_KEYS: readonly [{
367
364
  readonly path: "editors.image.altText";
368
365
  }, {
369
366
  readonly path: "editors.image.altPlaceholder";
370
- }, {
371
- readonly path: "editors.image.width";
372
- }, {
373
- readonly path: "editors.image.height";
374
- }, {
375
- readonly path: "editors.image.autoPlaceholder";
376
367
  }, {
377
368
  readonly path: "editors.image.workspace";
378
369
  }, {
@@ -103,9 +103,6 @@ export interface PanelLabels {
103
103
  previewAlt: string;
104
104
  altText: string;
105
105
  altPlaceholder: string;
106
- width: string;
107
- height: string;
108
- autoPlaceholder: string;
109
106
  workspace: string;
110
107
  selectWorkspace: string;
111
108
  selectImage: string;
@@ -367,12 +364,6 @@ export declare const REQUIRED_LABEL_KEYS: readonly [{
367
364
  readonly path: "editors.image.altText";
368
365
  }, {
369
366
  readonly path: "editors.image.altPlaceholder";
370
- }, {
371
- readonly path: "editors.image.width";
372
- }, {
373
- readonly path: "editors.image.height";
374
- }, {
375
- readonly path: "editors.image.autoPlaceholder";
376
367
  }, {
377
368
  readonly path: "editors.image.workspace";
378
369
  }, {
@@ -1 +1 @@
1
- {"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../../src/authoring/core/labels/labels.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"labels.d.ts","sourceRoot":"","sources":["../../../../src/authoring/core/labels/labels.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Copyright (c) 2026, Salesforce, Inc.,
3
+ * All rights reserved.
4
+ * For full license text, see the LICENSE.txt file
5
+ */
6
+ /**
7
+ * Replaces the first `url()` layer with `newUrl`, keeping other layers in
8
+ * place. With no existing `url()` layer, adds it as the top (first-listed)
9
+ * layer. `newUrl` is double-quoted to tolerate spaces/parens.
10
+ */
11
+ export declare function replaceFirstUrlLayer(value: string | null | undefined, newUrl: string): string;
12
+ /**
13
+ * Drops the first `url()` layer, keeping the rest. Collapses to `none` when the
14
+ * removal empties the background (so it still wins the cascade over a class).
15
+ */
16
+ export declare function removeFirstUrlLayer(value: string | null | undefined): string;
17
+ /**
18
+ * The `background-image` to write for an edit: an empty `newUrl` (Clear) removes
19
+ * the first `url()` layer; any other value swaps it in.
20
+ */
21
+ export declare function computeBackgroundImageEdit(currentBackgroundImage: string | null | undefined, newUrl: string): string;
22
+ //# sourceMappingURL=backgroundImageEdit.d.ts.map
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Copyright (c) 2026, Salesforce, Inc.,
3
+ * All rights reserved.
4
+ * For full license text, see the LICENSE.txt file
5
+ */
6
+ /**
7
+ * Replaces the first `url()` layer with `newUrl`, keeping other layers in
8
+ * place. With no existing `url()` layer, adds it as the top (first-listed)
9
+ * layer. `newUrl` is double-quoted to tolerate spaces/parens.
10
+ */
11
+ export declare function replaceFirstUrlLayer(value: string | null | undefined, newUrl: string): string;
12
+ /**
13
+ * Drops the first `url()` layer, keeping the rest. Collapses to `none` when the
14
+ * removal empties the background (so it still wins the cascade over a class).
15
+ */
16
+ export declare function removeFirstUrlLayer(value: string | null | undefined): string;
17
+ /**
18
+ * The `background-image` to write for an edit: an empty `newUrl` (Clear) removes
19
+ * the first `url()` layer; any other value swaps it in.
20
+ */
21
+ export declare function computeBackgroundImageEdit(currentBackgroundImage: string | null | undefined, newUrl: string): string;
22
+ //# sourceMappingURL=backgroundImageEdit.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"backgroundImageEdit.d.ts","sourceRoot":"","sources":["../../../../src/authoring/core/utils/backgroundImageEdit.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkBH;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAe7F;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAU5E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACzC,sBAAsB,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACjD,MAAM,EAAE,MAAM,GACZ,MAAM,CAIR"}
@@ -1,23 +1,25 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
3
- const ASSETS_DIR = "src/assets/images";
4
- const DEV_URL_PREFIX = "/src/assets/images";
3
+ const cssUrlLayers = require("../../shared/cssUrlLayers.cjs");
4
+ const ASSETS_ROOT = "src/assets";
5
+ const IMAGE_SUBDIR = "images";
6
+ const ASSETS_DIR = `${ASSETS_ROOT}/${IMAGE_SUBDIR}`;
7
+ const DEV_URL_PREFIX = `/${ASSETS_DIR}`;
5
8
  const MAX_FILENAME_COLLISIONS = 1e3;
6
- const EXT_BY_MIME = {
7
- "image/png": ".png",
8
- "image/jpeg": ".jpg",
9
- "image/gif": ".gif",
10
- "image/webp": ".webp",
11
- "image/svg+xml": ".svg"
12
- };
13
- const MIME_BY_EXT = {
14
- png: "image/png",
15
- jpg: "image/jpeg",
16
- jpeg: "image/jpeg",
17
- gif: "image/gif",
18
- webp: "image/webp",
19
- svg: "image/svg+xml"
20
- };
9
+ const IMAGE_FORMATS = [
10
+ { mime: "image/png", ext: "png" },
11
+ { mime: "image/jpeg", ext: "jpg", aliases: ["jpeg"] },
12
+ { mime: "image/gif", ext: "gif" },
13
+ { mime: "image/webp", ext: "webp" },
14
+ { mime: "image/avif", ext: "avif" },
15
+ { mime: "image/svg+xml", ext: "svg" }
16
+ ];
17
+ const EXT_BY_MIME = Object.fromEntries(
18
+ IMAGE_FORMATS.map((f) => [f.mime, `.${f.ext}`])
19
+ );
20
+ const MIME_BY_EXT = Object.fromEntries(
21
+ IMAGE_FORMATS.flatMap((f) => [f.ext, ...f.aliases ?? []].map((ext) => [ext, f.mime]))
22
+ );
21
23
  const normalizeSeparators = (p) => p.replace(/\\/g, "/");
22
24
  const dirname = (p) => {
23
25
  const normalized = normalizeSeparators(p).replace(/\/+$/, "");
@@ -36,6 +38,19 @@ const extname = (filename) => {
36
38
  return idx <= 0 ? "" : base.slice(idx);
37
39
  };
38
40
  const joinPath = (...segments) => segments.map((s) => normalizeSeparators(s)).join("/").replace(/\/{2,}/g, "/");
41
+ const TRACEABLE_ASSET_EXTENSIONS = new Set(Object.keys(MIME_BY_EXT));
42
+ const KNOWN_EXT_PATTERN = new RegExp(`\\.(${[...TRACEABLE_ASSET_EXTENSIONS].join("|")})$`, "i");
43
+ const resolveAssetRef = (raw) => {
44
+ if (typeof raw !== "string" || raw.length === 0) return null;
45
+ if (raw.startsWith("//") || /^[a-z][a-z0-9+.-]*:/i.test(raw)) return null;
46
+ const withoutQueryHash = raw.split(/[?#]/)[0] ?? "";
47
+ const normalized = normalizeSeparators(withoutQueryHash).replace(/^\/+/, "");
48
+ if (!normalized.startsWith(`${ASSETS_ROOT}/`)) return null;
49
+ if (normalized.split("/").includes("..")) return null;
50
+ const ext = extname(normalized).slice(1).toLowerCase();
51
+ if (!TRACEABLE_ASSET_EXTENSIONS.has(ext)) return null;
52
+ return { assetPath: normalized };
53
+ };
39
54
  const mimeTypeForFilename = (filename) => {
40
55
  const ext = extname(filename).slice(1).toLowerCase();
41
56
  return MIME_BY_EXT[ext] ?? "image/png";
@@ -43,7 +58,7 @@ const mimeTypeForFilename = (filename) => {
43
58
  const sanitizeFilename = (name, contentType) => {
44
59
  const ext = EXT_BY_MIME[contentType] || ".png";
45
60
  const baseOnly = name.split(/[/\\]/).pop() ?? name;
46
- const withoutExt = baseOnly.replace(/\.(png|jpe?g|gif|webp|svg)$/i, "");
61
+ const withoutExt = baseOnly.replace(KNOWN_EXT_PATTERN, "");
47
62
  const safe = withoutExt.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
48
63
  return (safe || "image") + ext;
49
64
  };
@@ -101,11 +116,14 @@ const saveImageToAssets = async (appRoot, filename, bytes, fs) => {
101
116
  return savedName;
102
117
  };
103
118
  const assetDevUrl = (filename) => `${DEV_URL_PREFIX}/${filename}`;
119
+ exports.CSS_URL_TOKEN_SOURCE = cssUrlLayers.CSS_URL_TOKEN_SOURCE;
104
120
  exports.ASSETS_DIR = ASSETS_DIR;
121
+ exports.ASSETS_ROOT = ASSETS_ROOT;
105
122
  exports.DEV_URL_PREFIX = DEV_URL_PREFIX;
106
123
  exports.assetDevUrl = assetDevUrl;
107
124
  exports.dataUriForImage = dataUriForImage;
108
125
  exports.findAppRoot = findAppRoot;
109
126
  exports.mimeTypeForFilename = mimeTypeForFilename;
127
+ exports.resolveAssetRef = resolveAssetRef;
110
128
  exports.sanitizeFilename = sanitizeFilename;
111
129
  exports.saveImageToAssets = saveImageToAssets;
@@ -4,34 +4,19 @@
4
4
  * For full license text, see the LICENSE.txt file
5
5
  */
6
6
  /**
7
- * `/authoring/host` entry: host-neutral, design-only *policy* for importing an
8
- * image into a previewed app — app-root discovery, the `src/assets/images`
9
- * placement convention, content-dedupe, the dev-URL shape, filename
10
- * sanitization, and MIME lookup.
7
+ * `/authoring/host` entry: host-neutral policy for importing an image into a
8
+ * previewed app — app-root discovery, the `src/assets/images` placement
9
+ * convention, content-dedupe, dev-URL shape, filename sanitization, MIME lookup.
11
10
  *
12
- * This is the shared half of the local-file (and, later, CMS) image-import flow.
13
- * Each surface (the VS Code extension, Codey Studio, ...) supplies only the two
14
- * genuinely host-specific pieces:
15
- * 1. a native file picker, and
16
- * 2. a {@link FileSystemAdapter} over its filesystem.
17
- * Everything else lives here so it isn't re-implemented and kept in sync per
18
- * surface.
19
- *
20
- * Environment-neutral by construction: no `vscode`, no `@salesforce/core`, and
21
- * no `node:path` / `node:fs`. Path work is plain string ops (separators are
22
- * normalized at the boundary) and the only I/O seam is the injected
23
- * `FileSystemAdapter`, so the same compiled code runs in a Node host (VS Code)
24
- * and a browser/LWC host (Codey Studio). This matches the `no-host-imports`
25
- * boundary that also guards `authoring/core`.
11
+ * Shared across surfaces (VS Code, Codey Studio, …); each supplies only a native
12
+ * file picker and a {@link FileSystemAdapter}. Environment-neutral by
13
+ * construction (no `vscode`/`@salesforce/core`/`node:*`), so the same compiled
14
+ * code runs in a Node or browser host — matching the `no-host-imports` boundary.
26
15
  */
27
16
  /**
28
- * Minimal filesystem seam each surface implements over its own backend
29
- * (`vscode.workspace.fs`, `node:fs`, an in-memory store, ...). Paths are plain
30
- * strings using `/` separators (see {@link normalizeSeparators}).
31
- *
32
- * `stat` returns whether the path exists (an exists-boolean keeps the surface
33
- * adapter tiny — a thrown "not found" becomes `false`); the other three mirror
34
- * the operations the import pipeline needs.
17
+ * Filesystem seam each surface implements over its own backend
18
+ * (`vscode.workspace.fs`, `node:fs`, an in-memory store, …). Paths use `/`
19
+ * separators. `stat` returns an exists-boolean rather than throwing on "missing".
35
20
  */
36
21
  export interface FileSystemAdapter {
37
22
  /** Resolve to `true` if `path` exists, `false` otherwise (never throws for "missing"). */
@@ -44,16 +29,43 @@ export interface FileSystemAdapter {
44
29
  mkdir(path: string): Promise<void>;
45
30
  }
46
31
  /**
47
- * The app-relative directory imported images are written under. Owned here
48
- * because the convention is invented by this feature — `@salesforce/ui-bundle`
49
- * defines no such constant (its vite config uses the default `assetsDir`; only
50
- * template apps reference `src/assets`, via an `@assets` alias). The runtime
51
- * assumption: this folder sits under the app root so the dev server (vite
52
- * default) serves it at {@link DEV_URL_PREFIX}.
32
+ * The app-relative root every traceable asset ref sits under — broader than
33
+ * {@link ASSETS_DIR}, since a ref may point at any file under `src/assets`. The
34
+ * tracer keys on this prefix; {@link ASSETS_DIR} / {@link DEV_URL_PREFIX} derive
35
+ * from it so they can't drift.
36
+ */
37
+ export declare const ASSETS_ROOT = "src/assets";
38
+ /**
39
+ * The app-relative directory imported images are written under. Sits under the
40
+ * app root so the dev server serves it at {@link DEV_URL_PREFIX}.
53
41
  */
54
42
  export declare const ASSETS_DIR = "src/assets/images";
55
43
  /** Root-relative URL prefix the dev server serves {@link ASSETS_DIR} at. */
56
44
  export declare const DEV_URL_PREFIX = "/src/assets/images";
45
+ /**
46
+ * The url() token source, re-exported from `shared/cssUrlLayers` so the build
47
+ * tracer imports it from its single host entry point (alongside
48
+ * {@link resolveAssetRef} / {@link ASSETS_ROOT}) and shares the runtime's rule.
49
+ */
50
+ export { CSS_URL_TOKEN_SOURCE } from '../../shared/cssUrlLayers.cjs';
51
+ /** A traceable asset reference resolved from a raw attribute string. */
52
+ export interface ResolvedAssetRef {
53
+ /**
54
+ * App-root-relative POSIX path to the source asset, with any leading slash,
55
+ * `?query`, and `#hash` stripped -- e.g. `"src/assets/images/hero.png"`.
56
+ */
57
+ assetPath: string;
58
+ }
59
+ /**
60
+ * Whether an attribute string is a traceable asset ref, and the file it points
61
+ * at. Shared with the build-time tracer plugin so the match rule can't drift.
62
+ *
63
+ * A ref iff, after normalizing separators and stripping `?query`/`#hash` and a
64
+ * single leading slash, it sits under {@link ASSETS_ROOT}`/` and ends in a known
65
+ * image extension. Absolute / protocol-relative / `data:` URLs and `..`
66
+ * traversal are not matched.
67
+ */
68
+ export declare const resolveAssetRef: (raw: string) => ResolvedAssetRef | null;
57
69
  /** Best-effort MIME type for a filename's extension; defaults to image/png. */
58
70
  export declare const mimeTypeForFilename: (filename: string) => string;
59
71
  /**
@@ -67,11 +79,9 @@ export declare const sanitizeFilename: (name: string, contentType: string) => st
67
79
  /** Build a base64 `data:` URI for image bytes — usable as a preview `<img src>` in any host. */
68
80
  export declare const dataUriForImage: (bytes: Uint8Array, contentType: string) => string;
69
81
  /**
70
- * Walk up from a source file to the nearest directory containing a `package.json`
71
- * — the ui-bundle/React app root. This makes asset placement independent of where
72
- * the workspace is rooted or where the dev server was launched: the app root is
73
- * derived from the edited element's own source location. Returns `undefined` if no
74
- * `package.json` is found before reaching the filesystem root.
82
+ * Nearest ancestor of `sourceFilePath` containing a `package.json` — the app
83
+ * root, derived from the edited element's own source rather than the workspace
84
+ * or dev-server cwd. `undefined` if none before the filesystem root.
75
85
  */
76
86
  export declare const findAppRoot: (sourceFilePath: string, fs: FileSystemAdapter) => Promise<string | undefined>;
77
87
  /**
@@ -4,34 +4,19 @@
4
4
  * For full license text, see the LICENSE.txt file
5
5
  */
6
6
  /**
7
- * `/authoring/host` entry: host-neutral, design-only *policy* for importing an
8
- * image into a previewed app — app-root discovery, the `src/assets/images`
9
- * placement convention, content-dedupe, the dev-URL shape, filename
10
- * sanitization, and MIME lookup.
7
+ * `/authoring/host` entry: host-neutral policy for importing an image into a
8
+ * previewed app — app-root discovery, the `src/assets/images` placement
9
+ * convention, content-dedupe, dev-URL shape, filename sanitization, MIME lookup.
11
10
  *
12
- * This is the shared half of the local-file (and, later, CMS) image-import flow.
13
- * Each surface (the VS Code extension, Codey Studio, ...) supplies only the two
14
- * genuinely host-specific pieces:
15
- * 1. a native file picker, and
16
- * 2. a {@link FileSystemAdapter} over its filesystem.
17
- * Everything else lives here so it isn't re-implemented and kept in sync per
18
- * surface.
19
- *
20
- * Environment-neutral by construction: no `vscode`, no `@salesforce/core`, and
21
- * no `node:path` / `node:fs`. Path work is plain string ops (separators are
22
- * normalized at the boundary) and the only I/O seam is the injected
23
- * `FileSystemAdapter`, so the same compiled code runs in a Node host (VS Code)
24
- * and a browser/LWC host (Codey Studio). This matches the `no-host-imports`
25
- * boundary that also guards `authoring/core`.
11
+ * Shared across surfaces (VS Code, Codey Studio, …); each supplies only a native
12
+ * file picker and a {@link FileSystemAdapter}. Environment-neutral by
13
+ * construction (no `vscode`/`@salesforce/core`/`node:*`), so the same compiled
14
+ * code runs in a Node or browser host — matching the `no-host-imports` boundary.
26
15
  */
27
16
  /**
28
- * Minimal filesystem seam each surface implements over its own backend
29
- * (`vscode.workspace.fs`, `node:fs`, an in-memory store, ...). Paths are plain
30
- * strings using `/` separators (see {@link normalizeSeparators}).
31
- *
32
- * `stat` returns whether the path exists (an exists-boolean keeps the surface
33
- * adapter tiny — a thrown "not found" becomes `false`); the other three mirror
34
- * the operations the import pipeline needs.
17
+ * Filesystem seam each surface implements over its own backend
18
+ * (`vscode.workspace.fs`, `node:fs`, an in-memory store, …). Paths use `/`
19
+ * separators. `stat` returns an exists-boolean rather than throwing on "missing".
35
20
  */
36
21
  export interface FileSystemAdapter {
37
22
  /** Resolve to `true` if `path` exists, `false` otherwise (never throws for "missing"). */
@@ -44,16 +29,43 @@ export interface FileSystemAdapter {
44
29
  mkdir(path: string): Promise<void>;
45
30
  }
46
31
  /**
47
- * The app-relative directory imported images are written under. Owned here
48
- * because the convention is invented by this feature — `@salesforce/ui-bundle`
49
- * defines no such constant (its vite config uses the default `assetsDir`; only
50
- * template apps reference `src/assets`, via an `@assets` alias). The runtime
51
- * assumption: this folder sits under the app root so the dev server (vite
52
- * default) serves it at {@link DEV_URL_PREFIX}.
32
+ * The app-relative root every traceable asset ref sits under — broader than
33
+ * {@link ASSETS_DIR}, since a ref may point at any file under `src/assets`. The
34
+ * tracer keys on this prefix; {@link ASSETS_DIR} / {@link DEV_URL_PREFIX} derive
35
+ * from it so they can't drift.
36
+ */
37
+ export declare const ASSETS_ROOT = "src/assets";
38
+ /**
39
+ * The app-relative directory imported images are written under. Sits under the
40
+ * app root so the dev server serves it at {@link DEV_URL_PREFIX}.
53
41
  */
54
42
  export declare const ASSETS_DIR = "src/assets/images";
55
43
  /** Root-relative URL prefix the dev server serves {@link ASSETS_DIR} at. */
56
44
  export declare const DEV_URL_PREFIX = "/src/assets/images";
45
+ /**
46
+ * The url() token source, re-exported from `shared/cssUrlLayers` so the build
47
+ * tracer imports it from its single host entry point (alongside
48
+ * {@link resolveAssetRef} / {@link ASSETS_ROOT}) and shares the runtime's rule.
49
+ */
50
+ export { CSS_URL_TOKEN_SOURCE } from '../../shared/cssUrlLayers.js';
51
+ /** A traceable asset reference resolved from a raw attribute string. */
52
+ export interface ResolvedAssetRef {
53
+ /**
54
+ * App-root-relative POSIX path to the source asset, with any leading slash,
55
+ * `?query`, and `#hash` stripped -- e.g. `"src/assets/images/hero.png"`.
56
+ */
57
+ assetPath: string;
58
+ }
59
+ /**
60
+ * Whether an attribute string is a traceable asset ref, and the file it points
61
+ * at. Shared with the build-time tracer plugin so the match rule can't drift.
62
+ *
63
+ * A ref iff, after normalizing separators and stripping `?query`/`#hash` and a
64
+ * single leading slash, it sits under {@link ASSETS_ROOT}`/` and ends in a known
65
+ * image extension. Absolute / protocol-relative / `data:` URLs and `..`
66
+ * traversal are not matched.
67
+ */
68
+ export declare const resolveAssetRef: (raw: string) => ResolvedAssetRef | null;
57
69
  /** Best-effort MIME type for a filename's extension; defaults to image/png. */
58
70
  export declare const mimeTypeForFilename: (filename: string) => string;
59
71
  /**
@@ -67,11 +79,9 @@ export declare const sanitizeFilename: (name: string, contentType: string) => st
67
79
  /** Build a base64 `data:` URI for image bytes — usable as a preview `<img src>` in any host. */
68
80
  export declare const dataUriForImage: (bytes: Uint8Array, contentType: string) => string;
69
81
  /**
70
- * Walk up from a source file to the nearest directory containing a `package.json`
71
- * — the ui-bundle/React app root. This makes asset placement independent of where
72
- * the workspace is rooted or where the dev server was launched: the app root is
73
- * derived from the edited element's own source location. Returns `undefined` if no
74
- * `package.json` is found before reaching the filesystem root.
82
+ * Nearest ancestor of `sourceFilePath` containing a `package.json` — the app
83
+ * root, derived from the edited element's own source rather than the workspace
84
+ * or dev-server cwd. `undefined` if none before the filesystem root.
75
85
  */
76
86
  export declare const findAppRoot: (sourceFilePath: string, fs: FileSystemAdapter) => Promise<string | undefined>;
77
87
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/authoring/host/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH;;;;;;;;GAQG;AACH,MAAM,WAAW,iBAAiB;IACjC,0FAA0F;IAC1F,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,uDAAuD;IACvD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,kFAAkF;IAClF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,sBAAsB,CAAC;AAE9C,4EAA4E;AAC5E,eAAO,MAAM,cAAc,uBAAuB,CAAC;AA6DnD,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,KAAG,MAGtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,aAAa,MAAM,KAAG,MAUpE,CAAC;AAgBF,gGAAgG;AAChG,eAAO,MAAM,eAAe,GAAI,OAAO,UAAU,EAAE,aAAa,MAAM,KAAG,MACpB,CAAC;AAEtD;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GACvB,gBAAgB,MAAM,EACtB,IAAI,iBAAiB,KACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CAY5B,CAAC;AAWF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC7B,SAAS,MAAM,EACf,UAAU,MAAM,EAChB,OAAO,UAAU,EACjB,IAAI,iBAAiB,KACnB,OAAO,CAAC,MAAM,CA8BhB,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,KAAG,MAAyC,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/authoring/host/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;GASG;AAEH;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IACjC,0FAA0F;IAC1F,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACrC,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IAC5C,uDAAuD;IACvD,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1D,kFAAkF;IAClF,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACnC;AAED;;;;;GAKG;AACH,eAAO,MAAM,WAAW,eAAe,CAAC;AAKxC;;;GAGG;AACH,eAAO,MAAM,UAAU,sBAAmC,CAAC;AAE3D,4EAA4E;AAC5E,eAAO,MAAM,cAAc,uBAAmB,CAAC;AAE/C;;;;GAIG;AACH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AAiFpE,wEAAwE;AACxE,MAAM,WAAW,gBAAgB;IAChC;;;OAGG;IACH,SAAS,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,gBAAgB,GAAG,IAmBhE,CAAC;AAEF,+EAA+E;AAC/E,eAAO,MAAM,mBAAmB,GAAI,UAAU,MAAM,KAAG,MAGtD,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,GAAI,MAAM,MAAM,EAAE,aAAa,MAAM,KAAG,MAUpE,CAAC;AAaF,gGAAgG;AAChG,eAAO,MAAM,eAAe,GAAI,OAAO,UAAU,EAAE,aAAa,MAAM,KAAG,MACpB,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,WAAW,GACvB,gBAAgB,MAAM,EACtB,IAAI,iBAAiB,KACnB,OAAO,CAAC,MAAM,GAAG,SAAS,CAY5B,CAAC;AAWF;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAC7B,SAAS,MAAM,EACf,UAAU,MAAM,EAChB,OAAO,UAAU,EACjB,IAAI,iBAAiB,KACnB,OAAO,CAAC,MAAM,CA8BhB,CAAC;AAEF,wDAAwD;AACxD,eAAO,MAAM,WAAW,GAAI,UAAU,MAAM,KAAG,MAAyC,CAAC"}