@salesforce/ui-bundle 9.4.1 → 9.6.0

package/dist/design/design-mode-interactions.js

@@ -223,6 +223,22 @@
   }
 
   // src/design/interactions/communicationManager.ts
+  function getMediaInfo(element) {
+    switch (element.tagName) {
+      case "IMG": {
+        const img = element;
+        return {
+          tag: "img",
+          src: img.getAttribute("src") ?? "",
+          alt: img.getAttribute("alt") ?? "",
+          width: img.getAttribute("width") ?? "",
+          height: img.getAttribute("height") ?? ""
+        };
+      }
+      default:
+        return void 0;
+    }
+  }
   var CommunicationManager = class {
     constructor() {
     }
@@ -243,6 +259,7 @@
       const debugSource = getSourceFromDataAttributes(element);
       const textType = element.dataset?.textType ?? "none";
       const hasNonEditableText = TEXT_TAGS.includes(element.tagName) && (textType === "dynamic" || textType === "mixed");
+      const media = getMediaInfo(element);
       try {
         if (window.parent !== window) {
           window.parent.postMessage(
@@ -255,7 +272,8 @@
                   ...styles
                 },
                 debugSource,
-                hasNonEditableText
+                hasNonEditableText,
+                ...media ? { media } : {}
               }
             },
             "*"
@@ -588,6 +606,21 @@
   };
 
   // src/design/interactions/interactionsController.ts
+  var mediaAppliers = {
+    img: (el, attrs) => {
+      const img = el;
+      if (attrs.src !== void 0) img.setAttribute("src", attrs.src);
+      if (attrs.alt !== void 0) img.setAttribute("alt", attrs.alt);
+      if (attrs.width !== void 0) {
+        if (attrs.width === "") img.removeAttribute("width");
+        else img.setAttribute("width", attrs.width);
+      }
+      if (attrs.height !== void 0) {
+        if (attrs.height === "") img.removeAttribute("height");
+        else img.setAttribute("height", attrs.height);
+      }
+    }
+  };
   var InteractionsController = class {
     constructor(enabled = true) {
       __publicField(this, "enabled");
@@ -701,6 +734,31 @@
         el.textContent = text;
       }
     }
+    /**
+     * Apply attribute changes to all elements at the given source location whose
+     * `tagName` matches `tag` (case-insensitive). Per-tag appliers declare which
+     * attributes are valid and how empty-string values are handled (e.g. for
+     * `img`, an empty `width`/`height` clears the attribute).
+     *
+     * No-op if the tag has no registered applier. When `sourceLocation` is
+     * omitted (live edit), the source is read from the currently selected
+     * element; when provided (undo/redo replay), it is used directly.
+     *
+     * To support a new tag, add an entry to {@link mediaAppliers}.
+     *
+     * @param tag - The HTML tag the change targets (e.g. `"img"`).
+     * @param attributes - Sparse map of attribute names to their new string values; `undefined` values are skipped.
+     * @param sourceLocation - Explicit source location for undo/redo; falls back to the selected element when omitted.
+     */
+    applyMediaChange(tag, attributes, sourceLocation) {
+      const applier = mediaAppliers[tag.toLowerCase()];
+      if (!applier) return;
+      const tagNameUpper = tag.toUpperCase();
+      for (const el of this.resolveTargets(sourceLocation)) {
+        if (el.tagName !== tagNameUpper) continue;
+        applier(el, attributes);
+      }
+    }
     /**
      * Cleanup and remove event listeners
      */
@@ -747,6 +805,17 @@
           parseSourceLocation(typed.sourceLocation)
         );
       }
+      if (typed && typed.type === "media-change") {
+        const tag = typeof typed.tag === "string" ? typed.tag : "";
+        const rawAttributes = typed.attributes && typeof typed.attributes === "object" ? typed.attributes : {};
+        const attributes = {};
+        for (const [key, raw] of Object.entries(rawAttributes)) {
+          attributes[key] = raw === void 0 ? void 0 : String(raw);
+        }
+        if (tag) {
+          interactions.applyMediaChange(tag, attributes, parseSourceLocation(typed.sourceLocation));
+        }
+      }
       if (typed && typed.type === "enable-interactions") {
         window.enableInteractions?.();
       }

package/dist/design/interactions/communicationManager.d.ts

@@ -3,6 +3,37 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
+/**
+ * Editable attributes reported for an `<img>` element on selection. Strings
+ * mirror the raw HTML attribute values; missing attributes are reported as `""`.
+ *
+ * - `width` / `height` are unitless integer strings (px); `""` means the
+ *   attribute is absent and the image renders at its intrinsic size.
+ */
+interface ImageMediaInfo {
+    tag: "img";
+    src: string;
+    alt: string;
+    width: string;
+    height: string;
+}
+/**
+ * Discriminated union of media-element metadata, keyed by `tag`. To support a
+ * new media tag in future if required, add a variant here and a matching case
+ * in {@link getMediaInfo}.
+ */
+export type MediaInfo = ImageMediaInfo;
+/**
+ * Extract editable media metadata from a selected element.
+ *
+ * Switches on `element.tagName` and returns the variant matching the tag, or
+ * `undefined` for elements without a registered media tag (the caller then
+ * omits the `media` field from the `component-selected` payload).
+ *
+ * @param element - The selected DOM element.
+ * @returns The media info variant for the element's tag, or `undefined` if the tag is not media.
+ */
+export declare function getMediaInfo(element: HTMLElement): MediaInfo | undefined;
 export declare class CommunicationManager {
     constructor();
     /**
@@ -22,4 +53,5 @@ export declare class CommunicationManager {
      */
     notifyInitializationComplete(): void;
 }
+export {};
 //# sourceMappingURL=communicationManager.d.ts.map

package/dist/design/interactions/communicationManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"communicationManager.d.ts","sourceRoot":"","sources":["../../../src/design/interactions/communicationManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH,qBAAa,oBAAoB;;IAKhC;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAuDnD;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAyBnF;;OAEG;IACH,4BAA4B,IAAI,IAAI;CAepC"}
+{"version":3,"file":"communicationManager.d.ts","sourceRoot":"","sources":["../../../src/design/interactions/communicationManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAiBH;;;;;;GAMG;AACH,UAAU,cAAc;IACvB,GAAG,EAAE,KAAK,CAAC;IACX,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CACf;AAED;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG,cAAc,CAAC;AAEvC;;;;;;;;;GASG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,GAAG,SAAS,CAexE;AAED,qBAAa,oBAAoB;;IAKhC;;;OAGG;IACH,uBAAuB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IA0DnD;;;;;OAKG;IACH,gBAAgB,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAyBnF;;OAEG;IACH,4BAA4B,IAAI,IAAI;CAepC"}

package/dist/design/interactions/interactionsController.d.ts

@@ -28,6 +28,23 @@ export declare class InteractionsController {
      */
     applyStyleChange(property: string, value: string, sourceLocation?: SourceLocation): void;
     applyTextChange(text: string, sourceLocation?: SourceLocation): void;
+    /**
+     * Apply attribute changes to all elements at the given source location whose
+     * `tagName` matches `tag` (case-insensitive). Per-tag appliers declare which
+     * attributes are valid and how empty-string values are handled (e.g. for
+     * `img`, an empty `width`/`height` clears the attribute).
+     *
+     * No-op if the tag has no registered applier. When `sourceLocation` is
+     * omitted (live edit), the source is read from the currently selected
+     * element; when provided (undo/redo replay), it is used directly.
+     *
+     * To support a new tag, add an entry to {@link mediaAppliers}.
+     *
+     * @param tag - The HTML tag the change targets (e.g. `"img"`).
+     * @param attributes - Sparse map of attribute names to their new string values; `undefined` values are skipped.
+     * @param sourceLocation - Explicit source location for undo/redo; falls back to the selected element when omitted.
+     */
+    applyMediaChange(tag: string, attributes: Record<string, string | undefined>, sourceLocation?: SourceLocation): void;
     /**
      * Cleanup and remove event listeners
      */

package/dist/design/interactions/interactionsController.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"interactionsController.d.ts","sourceRoot":"","sources":["../../../src/design/interactions/interactionsController.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,EAGN,KAAK,cAAc,EACnB,MAAM,qBAAqB,CAAC;AAE7B,qBAAa,sBAAsB;IAClC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAU;IAE1B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,UAAO;IAwD1B;;OAEG;IACH,UAAU,IAAI,IAAI;IAiBlB;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI;IAMxF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI;IAMpE;;OAEG;IACH,OAAO,IAAI,IAAI;CAOf"}
+{"version":3,"file":"interactionsController.d.ts","sourceRoot":"","sources":["../../../src/design/interactions/interactionsController.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,EAGN,KAAK,cAAc,EACnB,MAAM,qBAAqB,CAAC;AAmC7B,qBAAa,sBAAsB;IAClC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAU;IAE1B,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,aAAa,CAAgB;gBAEzB,OAAO,UAAO;IAwD1B;;OAEG;IACH,UAAU,IAAI,IAAI;IAiBlB;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf,OAAO,CAAC,cAAc;IAWtB;;;;OAIG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI;IAMxF,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,cAAc,GAAG,IAAI;IAMpE;;;;;;;;;;;;;;;OAeG;IACH,gBAAgB,CACf,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EAC9C,cAAc,CAAC,EAAE,cAAc,GAC7B,IAAI;IAUP;;OAEG;IACH,OAAO,IAAI,IAAI;CAOf"}

package/dist/package.json.js

@@ -1,4 +1,4 @@
-const version = "9.4.1";
+const version = "9.6.0";
 export {
   version
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/ui-bundle",
   "description": "Core package for Salesforce UI Bundles",
-  "version": "9.4.1",
+  "version": "9.6.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,7 +44,7 @@
   },
   "dependencies": {
     "@salesforce/core": "^8.23.4",
-    "@salesforce/platform-sdk": "^9.4.1",
+    "@salesforce/platform-sdk": "^9.6.0",
     "micromatch": "^4.0.8",
     "path-to-regexp": "^8.3.0"
   },