@salesforce/ui-design-mode 10.2.0

package/dist/runtime/index.cjs

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const node_fs = require("node:fs");
+const node_path = require("node:path");
+const node_url = require("node:url");
+var _documentCurrentScript = typeof document !== "undefined" ? document.currentScript : null;
+const __dirname$1 = node_path.dirname(node_url.fileURLToPath(typeof document === "undefined" ? require("url").pathToFileURL(__filename).href : _documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === "SCRIPT" && _documentCurrentScript.src || new URL("runtime/index.cjs", document.baseURI).href));
+const RUNTIME_IIFE_PATH = node_path.join(__dirname$1, "design-mode-interactions.js");
+function getRuntimeScriptContent() {
+  if (!node_fs.existsSync(RUNTIME_IIFE_PATH)) {
+    return null;
+  }
+  return node_fs.readFileSync(RUNTIME_IIFE_PATH, "utf-8");
+}
+exports.getRuntimeScriptContent = getRuntimeScriptContent;

package/dist/runtime/index.d.cts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Read the bundled iframe-side runtime IIFE for injection into the customer's preview iframe.
+ * @returns The script contents, or null if the bundle has not been built yet.
+ */
+export declare function getRuntimeScriptContent(): string | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Read the bundled iframe-side runtime IIFE for injection into the customer's preview iframe.
+ * @returns The script contents, or null if the bundle has not been built yet.
+ */
+export declare function getRuntimeScriptContent(): string | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/runtime/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH;;;GAGG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,GAAG,IAAI,CAKvD"}

package/dist/runtime/index.js

@@ -0,0 +1,14 @@
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { fileURLToPath } from "node:url";
+const __dirname$1 = dirname(fileURLToPath(import.meta.url));
+const RUNTIME_IIFE_PATH = join(__dirname$1, "design-mode-interactions.js");
+function getRuntimeScriptContent() {
+  if (!existsSync(RUNTIME_IIFE_PATH)) {
+    return null;
+  }
+  return readFileSync(RUNTIME_IIFE_PATH, "utf-8");
+}
+export {
+  getRuntimeScriptContent
+};

package/dist/runtime/interactions/communicationManager.d.cts

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * 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();
+    /**
+     * Notify the extension about a selected component
+     * @param element - The selected element
+     */
+    notifyComponentSelected(element: HTMLElement): void;
+    /**
+     * Notify the extension about a text change
+     * @param element - The element that changed
+     * @param originalText - The original text
+     * @param newText - The new text
+     */
+    notifyTextChange(element: HTMLElement, originalText: string, newText: string): void;
+    /**
+     * Notify the parent window that interactions initialization is complete
+     */
+    notifyInitializationComplete(): void;
+}
+export {};
+//# sourceMappingURL=communicationManager.d.ts.map

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

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * 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();
+    /**
+     * Notify the extension about a selected component
+     * @param element - The selected element
+     */
+    notifyComponentSelected(element: HTMLElement): void;
+    /**
+     * Notify the extension about a text change
+     * @param element - The element that changed
+     * @param originalText - The original text
+     * @param newText - The new text
+     */
+    notifyTextChange(element: HTMLElement, originalText: string, newText: string): void;
+    /**
+     * Notify the parent window that interactions initialization is complete
+     */
+    notifyInitializationComplete(): void;
+}
+export {};
+//# sourceMappingURL=communicationManager.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"communicationManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/interactions/communicationManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsBH;;;;;;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/runtime/interactions/componentMatcher.d.cts

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export interface ComponentMatcherOptions {
+    allowlist?: string[];
+}
+export declare class ComponentMatcher {
+    private allowlist;
+    constructor(options?: ComponentMatcherOptions);
+    /**
+     * Check whether an element contains compile-time source metadata attributes.
+     * @param element - The element to check
+     * @returns True if the data-source-file attribute is present
+     */
+    hasSourceMetadata(element: HTMLElement | null | undefined): boolean;
+    private matchesList;
+    /**
+     * Checks if a label represents a component name (not a fallback like tag name, ID, or text content)
+     * @param label - The label to check
+     * @param tagName - The element's tag name (lowercase)
+     * @returns True if the label is a component name
+     */
+    isComponentNameLabel(label: string, tagName: string): boolean;
+    /**
+     * Check if an element is highlightable.
+     * @param element - The element to check
+     * @returns True if the element should be highlighted
+     */
+    isHighlightableElement(element: HTMLElement | null | undefined): boolean;
+    /**
+     * Find the nearest highlightable element by walking up the DOM tree
+     * @param target - The target element
+     * @returns The highlightable element or null
+     */
+    findHighlightableElement(target: HTMLElement | null | undefined): HTMLElement | null;
+}
+//# sourceMappingURL=componentMatcher.d.ts.map

package/dist/runtime/interactions/componentMatcher.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export interface ComponentMatcherOptions {
+    allowlist?: string[];
+}
+export declare class ComponentMatcher {
+    private allowlist;
+    constructor(options?: ComponentMatcherOptions);
+    /**
+     * Check whether an element contains compile-time source metadata attributes.
+     * @param element - The element to check
+     * @returns True if the data-source-file attribute is present
+     */
+    hasSourceMetadata(element: HTMLElement | null | undefined): boolean;
+    private matchesList;
+    /**
+     * Checks if a label represents a component name (not a fallback like tag name, ID, or text content)
+     * @param label - The label to check
+     * @param tagName - The element's tag name (lowercase)
+     * @returns True if the label is a component name
+     */
+    isComponentNameLabel(label: string, tagName: string): boolean;
+    /**
+     * Check if an element is highlightable.
+     * @param element - The element to check
+     * @returns True if the element should be highlighted
+     */
+    isHighlightableElement(element: HTMLElement | null | undefined): boolean;
+    /**
+     * Find the nearest highlightable element by walking up the DOM tree
+     * @param target - The target element
+     * @returns The highlightable element or null
+     */
+    findHighlightableElement(target: HTMLElement | null | undefined): HTMLElement | null;
+}
+//# sourceMappingURL=componentMatcher.d.ts.map

package/dist/runtime/interactions/componentMatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"componentMatcher.d.ts","sourceRoot":"","sources":["../../../src/runtime/interactions/componentMatcher.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,MAAM,WAAW,uBAAuB;IAEvC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,qBAAa,gBAAgB;IAC5B,OAAO,CAAC,SAAS,CAAW;gBAEhB,OAAO,GAAE,uBAA4B;IAIjD;;;;OAIG;IACH,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAOnE,OAAO,CAAC,WAAW;IAInB;;;;;OAKG;IACH,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAM7D;;;;OAIG;IACH,sBAAsB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO;IAgBxE;;;;OAIG;IACH,wBAAwB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,IAAI;CA+BpF"}

package/dist/runtime/interactions/editableManager.d.cts

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+interface CommunicationManagerLike {
+    notifyTextChange: (element: HTMLElement, originalText: string, newText: string) => void;
+}
+export declare const TEXT_TAGS: string[];
+export declare class EditableManager {
+    private communicationManager?;
+    private boundHandleBlur;
+    private boundHandleKeydown;
+    private boundHandleInput;
+    private editableGroup;
+    constructor(communicationManager?: CommunicationManagerLike);
+    makeEditableIfText(element: HTMLElement): void;
+    removeEditable(element: HTMLElement): void;
+    private _isTextElement;
+    private _handleInput;
+    private _handleBlur;
+    private _handleKeydown;
+}
+export {};
+//# sourceMappingURL=editableManager.d.ts.map

package/dist/runtime/interactions/editableManager.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+interface CommunicationManagerLike {
+    notifyTextChange: (element: HTMLElement, originalText: string, newText: string) => void;
+}
+export declare const TEXT_TAGS: string[];
+export declare class EditableManager {
+    private communicationManager?;
+    private boundHandleBlur;
+    private boundHandleKeydown;
+    private boundHandleInput;
+    private editableGroup;
+    constructor(communicationManager?: CommunicationManagerLike);
+    makeEditableIfText(element: HTMLElement): void;
+    removeEditable(element: HTMLElement): void;
+    private _isTextElement;
+    private _handleInput;
+    private _handleBlur;
+    private _handleKeydown;
+}
+export {};
+//# sourceMappingURL=editableManager.d.ts.map

package/dist/runtime/interactions/editableManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editableManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/interactions/editableManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAUH,UAAU,wBAAwB;IACjC,gBAAgB,EAAE,CAAC,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxF;AAED,eAAO,MAAM,SAAS,UAA4E,CAAC;AAEnG,qBAAa,eAAe;IAC3B,OAAO,CAAC,oBAAoB,CAAC,CAA2B;IACxD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,kBAAkB,CAA6B;IACvD,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,aAAa,CAAgB;gBAEzB,oBAAoB,CAAC,EAAE,wBAAwB;IAQ3D,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAoB9C,cAAc,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;IAe1C,OAAO,CAAC,cAAc;IAQtB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,cAAc;CAiBtB"}

package/dist/runtime/interactions/eventHandlers.d.cts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+interface ComponentMatcherLike {
+    findHighlightableElement: (target: HTMLElement) => HTMLElement | null;
+}
+interface StyleManagerLike {
+    highlightElements: (elements: HTMLElement[]) => void;
+    unhighlightElements: (elements: HTMLElement[]) => void;
+    selectElements: (elements: HTMLElement[]) => void;
+    deselectElements: (elements: HTMLElement[]) => void;
+}
+interface EditableManagerLike {
+    makeEditableIfText: (element: HTMLElement) => void;
+    removeEditable: (element: HTMLElement) => void;
+}
+interface CommunicationManagerLike {
+    notifyComponentSelected: (element: HTMLElement) => void;
+}
+export declare class EventHandlers {
+    private isInteractionsActive;
+    private componentMatcher;
+    private styleManager;
+    private editableManager;
+    private communicationManager;
+    private currentHighlightedElements;
+    private selectedElement;
+    private selectedElements;
+    constructor(isInteractionsActive: () => boolean, componentMatcher: ComponentMatcherLike, styleManager: StyleManagerLike, editableManager: EditableManagerLike, communicationManager: CommunicationManagerLike);
+    private _findHighlightableElement;
+    handleMouseOver(e: MouseEvent): void;
+    handleMouseLeave(): void;
+    handleClick(e: MouseEvent): void;
+    clearAll(): void;
+    getSelectedElement(): HTMLElement | null;
+}
+export {};
+//# sourceMappingURL=eventHandlers.d.ts.map

package/dist/runtime/interactions/eventHandlers.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+interface ComponentMatcherLike {
+    findHighlightableElement: (target: HTMLElement) => HTMLElement | null;
+}
+interface StyleManagerLike {
+    highlightElements: (elements: HTMLElement[]) => void;
+    unhighlightElements: (elements: HTMLElement[]) => void;
+    selectElements: (elements: HTMLElement[]) => void;
+    deselectElements: (elements: HTMLElement[]) => void;
+}
+interface EditableManagerLike {
+    makeEditableIfText: (element: HTMLElement) => void;
+    removeEditable: (element: HTMLElement) => void;
+}
+interface CommunicationManagerLike {
+    notifyComponentSelected: (element: HTMLElement) => void;
+}
+export declare class EventHandlers {
+    private isInteractionsActive;
+    private componentMatcher;
+    private styleManager;
+    private editableManager;
+    private communicationManager;
+    private currentHighlightedElements;
+    private selectedElement;
+    private selectedElements;
+    constructor(isInteractionsActive: () => boolean, componentMatcher: ComponentMatcherLike, styleManager: StyleManagerLike, editableManager: EditableManagerLike, communicationManager: CommunicationManagerLike);
+    private _findHighlightableElement;
+    handleMouseOver(e: MouseEvent): void;
+    handleMouseLeave(): void;
+    handleClick(e: MouseEvent): void;
+    clearAll(): void;
+    getSelectedElement(): HTMLElement | null;
+}
+export {};
+//# sourceMappingURL=eventHandlers.d.ts.map

package/dist/runtime/interactions/eventHandlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventHandlers.d.ts","sourceRoot":"","sources":["../../../src/runtime/interactions/eventHandlers.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,UAAU,oBAAoB;IAC7B,wBAAwB,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,WAAW,GAAG,IAAI,CAAC;CACtE;AAED,UAAU,gBAAgB;IACzB,iBAAiB,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IACrD,mBAAmB,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IACvD,cAAc,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;IAClD,gBAAgB,EAAE,CAAC,QAAQ,EAAE,WAAW,EAAE,KAAK,IAAI,CAAC;CACpD;AAED,UAAU,mBAAmB;IAC5B,kBAAkB,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;IACnD,cAAc,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CAC/C;AAED,UAAU,wBAAwB;IACjC,uBAAuB,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,IAAI,CAAC;CACxD;AAED,qBAAa,aAAa;IACzB,OAAO,CAAC,oBAAoB,CAAgB;IAC5C,OAAO,CAAC,gBAAgB,CAAuB;IAC/C,OAAO,CAAC,YAAY,CAAmB;IACvC,OAAO,CAAC,eAAe,CAAsB;IAC7C,OAAO,CAAC,oBAAoB,CAA2B;IAEvD,OAAO,CAAC,0BAA0B,CAAgB;IAClD,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,gBAAgB,CAAgB;gBAGvC,oBAAoB,EAAE,MAAM,OAAO,EACnC,gBAAgB,EAAE,oBAAoB,EACtC,YAAY,EAAE,gBAAgB,EAC9B,eAAe,EAAE,mBAAmB,EACpC,oBAAoB,EAAE,wBAAwB;IAkB/C,OAAO,CAAC,yBAAyB;IAIjC,eAAe,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI;IAqCpC,gBAAgB,IAAI,IAAI;IAcxB,WAAW,CAAC,CAAC,EAAE,UAAU,GAAG,IAAI;IA+ChC,QAAQ,IAAI,IAAI;IAchB,kBAAkB,IAAI,WAAW,GAAG,IAAI;CAGxC"}

package/dist/runtime/interactions/index.d.cts

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/interactions/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/runtime/interactions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/runtime/interactions/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/runtime/interactions/interactionsController.d.cts

@@ -0,0 +1,53 @@
+import { SourceLocation } from './utils/sourceUtils.cjs';
+export declare class InteractionsController {
+    private enabled;
+    private isActive;
+    private componentMatcher;
+    private styleManager;
+    private communicationManager;
+    private editableManager;
+    private eventHandlers;
+    constructor(enabled?: boolean);
+    /**
+     * Initialize the design mode interactions
+     */
+    initialize(): void;
+    /**
+     * Enable the design mode interactions
+     */
+    enable(): void;
+    /**
+     * Disable the design mode interactions
+     */
+    disable(): void;
+    private resolveTargets;
+    /**
+     * Apply a style change to all elements at the given source location.
+     * When sourceLocation is provided (undo/redo), it is used directly.
+     * Otherwise the source location is read from the currently selected element.
+     */
+    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
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=interactionsController.d.ts.map

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

@@ -0,0 +1,53 @@
+import { SourceLocation } from './utils/sourceUtils.js';
+export declare class InteractionsController {
+    private enabled;
+    private isActive;
+    private componentMatcher;
+    private styleManager;
+    private communicationManager;
+    private editableManager;
+    private eventHandlers;
+    constructor(enabled?: boolean);
+    /**
+     * Initialize the design mode interactions
+     */
+    initialize(): void;
+    /**
+     * Enable the design mode interactions
+     */
+    enable(): void;
+    /**
+     * Disable the design mode interactions
+     */
+    disable(): void;
+    private resolveTargets;
+    /**
+     * Apply a style change to all elements at the given source location.
+     * When sourceLocation is provided (undo/redo), it is used directly.
+     * Otherwise the source location is read from the currently selected element.
+     */
+    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
+     */
+    destroy(): void;
+}
+//# sourceMappingURL=interactionsController.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"interactionsController.d.ts","sourceRoot":"","sources":["../../../src/runtime/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/runtime/interactions/styleManager.d.cts

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Style Manager Module
+ * Handles CSS injection and style management for highlighting
+ */
+export declare class StyleManager {
+    private styleId;
+    private stylesAdded;
+    constructor();
+    /**
+     * Add CSS styles for highlighting to the document
+     */
+    addHighlightStyles(): void;
+    /**
+     * Remove highlight styles from the document
+     */
+    removeHighlightStyles(): void;
+    /**
+     * Get the CSS styles for highlighting
+     * @private
+     * @returns CSS styles
+     */
+    private _getStyles;
+    /**
+     * Apply highlight class to one or more elements
+     * @param elements - The elements to highlight
+     */
+    highlightElements(elements: HTMLElement[]): void;
+    /**
+     * Remove highlight class from one or more elements
+     * @param elements - The elements to unhighlight
+     */
+    unhighlightElements(elements: HTMLElement[]): void;
+    /**
+     * Apply selected class to one or more elements
+     * @param elements - The elements to select
+     */
+    selectElements(elements: HTMLElement[]): void;
+    /**
+     * Remove selected class from one or more elements
+     * @param elements - The elements to deselect
+     */
+    deselectElements(elements: HTMLElement[]): void;
+}
+//# sourceMappingURL=styleManager.d.ts.map

package/dist/runtime/interactions/styleManager.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+/**
+ * Style Manager Module
+ * Handles CSS injection and style management for highlighting
+ */
+export declare class StyleManager {
+    private styleId;
+    private stylesAdded;
+    constructor();
+    /**
+     * Add CSS styles for highlighting to the document
+     */
+    addHighlightStyles(): void;
+    /**
+     * Remove highlight styles from the document
+     */
+    removeHighlightStyles(): void;
+    /**
+     * Get the CSS styles for highlighting
+     * @private
+     * @returns CSS styles
+     */
+    private _getStyles;
+    /**
+     * Apply highlight class to one or more elements
+     * @param elements - The elements to highlight
+     */
+    highlightElements(elements: HTMLElement[]): void;
+    /**
+     * Remove highlight class from one or more elements
+     * @param elements - The elements to unhighlight
+     */
+    unhighlightElements(elements: HTMLElement[]): void;
+    /**
+     * Apply selected class to one or more elements
+     * @param elements - The elements to select
+     */
+    selectElements(elements: HTMLElement[]): void;
+    /**
+     * Remove selected class from one or more elements
+     * @param elements - The elements to deselect
+     */
+    deselectElements(elements: HTMLElement[]): void;
+}
+//# sourceMappingURL=styleManager.d.ts.map

package/dist/runtime/interactions/styleManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"styleManager.d.ts","sourceRoot":"","sources":["../../../src/runtime/interactions/styleManager.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;GAGG;AAEH,qBAAa,YAAY;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAU;;IAO7B;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAY1B;;OAEG;IACH,qBAAqB,IAAI,IAAI;IAQ7B;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAiBlB;;;OAGG;IACH,iBAAiB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAMhD;;;OAGG;IACH,mBAAmB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAMlD;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;IAM7C;;;OAGG;IACH,gBAAgB,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,IAAI;CAK/C"}