@salesforce/ui-design-mode 10.5.1 → 10.6.1

package/dist/authoring/web-component/index.d.cts

@@ -1,5 +1,6 @@
 import { DesignPanelComponent, StylesEntryMap } from '../core/DesignPropertyPanelRoot.cjs';
 import { ChangeContext } from '../core/history/historyService.cjs';
+import { PanelLabels } from '../core/labels/labels.cjs';
 /** The `<design-mode-panel>` Custom Element. */
 export declare class DesignModePanelElement extends HTMLElement {
     #private;
@@ -14,6 +15,34 @@ export declare class DesignModePanelElement extends HTMLElement {
      */
     get showAddToChatContext(): boolean;
     set showAddToChatContext(value: boolean);
+    /**
+     * Whether the panel renders the selected component's "jump to source" link.
+     * Defaults to `true`. Settable as a property or the `open-source-file`
+     * attribute (`"false"` hides it). A surface with no source viewer (Codey
+     * Studio) hides the row; VS Code keeps it (opens the file in the editor).
+     */
+    get showOpenSourceFile(): boolean;
+    set showOpenSourceFile(value: boolean);
+    /**
+     * Fully-resolved, localized panel strings. Property-only (a complex object —
+     * no attribute form, the same constraint as `component`/`styles`). Omit it (or
+     * set `undefined`) and the panel renders its English defaults; assign a complete
+     * `PanelLabels` for another locale.
+     *
+     * An incomplete translation degrades to a partly-English panel rather than
+     * breaking, via two mechanisms: (1) on assignment the value is validated with
+     * `validateLabels` and any problems (missing leaf, placeholder-arity mismatch)
+     * are `console.warn`ed — never thrown — so the host gets a clear signal; (2) the
+     * panel deep-merges the supplied object over its English defaults
+     * (`mergeDefaults`), so each missing leaf renders English instead of `undefined`
+     * (which would blank the string, or throw when fed to `interpolate`). The
+     * validator is the developer feedback loop; the merge is what guarantees a safe
+     * render. Validation is the completeness guard for untyped (LWC/JS) hosts that
+     * the all-required `PanelLabels` type cannot reach, and runs once per assignment
+     * (panel init / locale change), not per render.
+     */
+    get labels(): PanelLabels | undefined;
+    set labels(value: PanelLabels | undefined);
     undo(): void;
     redo(): void;
     clearHistory(): void;
@@ -25,4 +54,6 @@ export declare class DesignModePanelElement extends HTMLElement {
     disconnectedCallback(): void;
 }
 export type { DesignPanelComponent, StylesEntryMap, SelectedComponentContext, OpenSourceFilePayload, } from '../core/DesignPropertyPanelRoot.cjs';
+export { interpolate, validateLabels, REQUIRED_LABEL_KEYS } from '../core/labels/labels.cjs';
+export type { PanelLabels, RequiredLabelKey } from '../core/labels/labels.cjs';
 //# sourceMappingURL=index.d.ts.map

package/dist/authoring/web-component/index.d.ts

@@ -1,5 +1,6 @@
 import { DesignPanelComponent, StylesEntryMap } from '../core/DesignPropertyPanelRoot.js';
 import { ChangeContext } from '../core/history/historyService.js';
+import { PanelLabels } from '../core/labels/labels.js';
 /** The `<design-mode-panel>` Custom Element. */
 export declare class DesignModePanelElement extends HTMLElement {
     #private;
@@ -14,6 +15,34 @@ export declare class DesignModePanelElement extends HTMLElement {
      */
     get showAddToChatContext(): boolean;
     set showAddToChatContext(value: boolean);
+    /**
+     * Whether the panel renders the selected component's "jump to source" link.
+     * Defaults to `true`. Settable as a property or the `open-source-file`
+     * attribute (`"false"` hides it). A surface with no source viewer (Codey
+     * Studio) hides the row; VS Code keeps it (opens the file in the editor).
+     */
+    get showOpenSourceFile(): boolean;
+    set showOpenSourceFile(value: boolean);
+    /**
+     * Fully-resolved, localized panel strings. Property-only (a complex object —
+     * no attribute form, the same constraint as `component`/`styles`). Omit it (or
+     * set `undefined`) and the panel renders its English defaults; assign a complete
+     * `PanelLabels` for another locale.
+     *
+     * An incomplete translation degrades to a partly-English panel rather than
+     * breaking, via two mechanisms: (1) on assignment the value is validated with
+     * `validateLabels` and any problems (missing leaf, placeholder-arity mismatch)
+     * are `console.warn`ed — never thrown — so the host gets a clear signal; (2) the
+     * panel deep-merges the supplied object over its English defaults
+     * (`mergeDefaults`), so each missing leaf renders English instead of `undefined`
+     * (which would blank the string, or throw when fed to `interpolate`). The
+     * validator is the developer feedback loop; the merge is what guarantees a safe
+     * render. Validation is the completeness guard for untyped (LWC/JS) hosts that
+     * the all-required `PanelLabels` type cannot reach, and runs once per assignment
+     * (panel init / locale change), not per render.
+     */
+    get labels(): PanelLabels | undefined;
+    set labels(value: PanelLabels | undefined);
     undo(): void;
     redo(): void;
     clearHistory(): void;
@@ -25,4 +54,6 @@ export declare class DesignModePanelElement extends HTMLElement {
     disconnectedCallback(): void;
 }
 export type { DesignPanelComponent, StylesEntryMap, SelectedComponentContext, OpenSourceFilePayload, } from '../core/DesignPropertyPanelRoot.js';
+export { interpolate, validateLabels, REQUIRED_LABEL_KEYS } from '../core/labels/labels.js';
+export type { PanelLabels, RequiredLabelKey } from '../core/labels/labels.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/authoring/web-component/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/authoring/web-component/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAkCH,OAAO,EAEN,KAAK,oBAAoB,EAEzB,KAAK,cAAc,EACnB,MAAM,iCAAiC,CAAC;AAOzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AA2CpE,gDAAgD;AAChD,qBAAa,sBAAuB,SAAQ,WAAW;;IAQtD,IAAI,SAAS,IAAI,oBAAoB,GAAG,IAAI,CAE3C;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAG/C;IAED,IAAI,MAAM,IAAI,cAAc,GAAG,IAAI,CAElC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,EAGtC;IAED;;;;OAIG;IACH,IAAI,oBAAoB,IAAI,OAAO,CAElC;IACD,IAAI,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAGtC;IAGD,IAAI,IAAI,IAAI;IAGZ,IAAI,IAAI,IAAI;IAGZ,YAAY,IAAI,IAAI;IAGpB,eAAe,IAAI,OAAO,EAAE;IAG5B,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAItF,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IAQ/F,iBAAiB,IAAI,IAAI;IAazB,oBAAoB,IAAI,IAAI;CA0B5B;AASD,YAAY,EACX,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,GACrB,MAAM,iCAAiC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/authoring/web-component/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAuCH,OAAO,EAEN,KAAK,oBAAoB,EAEzB,KAAK,cAAc,EACnB,MAAM,iCAAiC,CAAC;AAOzC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAoDzE,gDAAgD;AAChD,qBAAa,sBAAuB,SAAQ,WAAW;;IAUtD,IAAI,SAAS,IAAI,oBAAoB,GAAG,IAAI,CAE3C;IACD,IAAI,SAAS,CAAC,KAAK,EAAE,oBAAoB,GAAG,IAAI,EAG/C;IAED,IAAI,MAAM,IAAI,cAAc,GAAG,IAAI,CAElC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI,EAGtC;IAED;;;;OAIG;IACH,IAAI,oBAAoB,IAAI,OAAO,CAElC;IACD,IAAI,oBAAoB,CAAC,KAAK,EAAE,OAAO,EAGtC;IAED;;;;;OAKG;IACH,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IACD,IAAI,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAGpC;IAED;;;;;;;;;;;;;;;;;OAiBG;IACH,IAAI,MAAM,IAAI,WAAW,GAAG,SAAS,CAEpC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,EAYxC;IAGD,IAAI,IAAI,IAAI;IAGZ,IAAI,IAAI,IAAI;IAGZ,YAAY,IAAI,IAAI;IAGpB,eAAe,IAAI,OAAO,EAAE;IAG5B,gBAAgB,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,IAAI;IAItF,MAAM,KAAK,kBAAkB,IAAI,MAAM,EAAE,CAExC;IAED,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI;IA4B/F,iBAAiB,IAAI,IAAI;IAkBzB,oBAAoB,IAAI,IAAI;CA4B5B;AASD,YAAY,EACX,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,GACrB,MAAM,iCAAiC,CAAC;AAKzC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzF,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}