@salesforce/ui-design-mode 12.5.2 → 12.5.3

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.
@@ -108,7 +108,22 @@ export interface ImageSourceBindings {
108
108
  export interface DesignPropertyPanelHandle {
109
109
  undo(): void;
110
110
  redo(): void;
111
- clearHistory(): void;
111
+ /**
112
+ * Clear the undo/redo history + pending edit-state. By default also blanks the
113
+ * displayed editor values, which suits mode entry/exit (nothing is selected
114
+ * then, so the blank is invisible).
115
+ *
116
+ * Pass `keepSelectedStyles` for a mid-session clear where an element is still
117
+ * selected and the panel visible (e.g. after a persisted Apply or an agent-turn
118
+ * regen). The editors are then NOT blanked; instead they re-sync to the
119
+ * element's latest host-pushed styles with the just-cleared pending edits
120
+ * dropped — so the panel reflects the element's true (regenerated) state rather
121
+ * than flashing empty or freezing a value the user typed that the agent may have
122
+ * written to source differently.
123
+ */
124
+ clearHistory(options?: {
125
+ keepSelectedStyles?: boolean;
126
+ }): void;
112
127
  getHistoryStack(): unknown[];
113
128
  /**
114
129
  * The net effective change set: the raw history reduced to one entry per
@@ -108,7 +108,22 @@ export interface ImageSourceBindings {
108
108
  export interface DesignPropertyPanelHandle {
109
109
  undo(): void;
110
110
  redo(): void;
111
- clearHistory(): void;
111
+ /**
112
+ * Clear the undo/redo history + pending edit-state. By default also blanks the
113
+ * displayed editor values, which suits mode entry/exit (nothing is selected
114
+ * then, so the blank is invisible).
115
+ *
116
+ * Pass `keepSelectedStyles` for a mid-session clear where an element is still
117
+ * selected and the panel visible (e.g. after a persisted Apply or an agent-turn
118
+ * regen). The editors are then NOT blanked; instead they re-sync to the
119
+ * element's latest host-pushed styles with the just-cleared pending edits
120
+ * dropped — so the panel reflects the element's true (regenerated) state rather
121
+ * than flashing empty or freezing a value the user typed that the agent may have
122
+ * written to source differently.
123
+ */
124
+ clearHistory(options?: {
125
+ keepSelectedStyles?: boolean;
126
+ }): void;
112
127
  getHistoryStack(): unknown[];
113
128
  /**
114
129
  * The net effective change set: the raw history reduced to one entry per
@@ -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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"}
@@ -8,6 +8,10 @@
8
8
  * that already run React on the page. React / react-dom are externalized by the
9
9
  * bundler, so the host provides the single React copy. Non-React hosts should
10
10
  * use `/authoring/web-component` instead.
11
+ *
12
+ * The panel's stylesheet is published separately as the sibling
13
+ * `/authoring/react/styles.css` export; a host imports it once alongside this
14
+ * entry (the `/authoring/web-component` entry instead inlines its CSS internally).
11
15
  */
12
16
  export { DesignPropertyPanel, mountDesignPropertyPanel } from '../core/DesignPropertyPanelRoot.cjs';
13
17
  export type { DesignPropertyPanelProps, DesignPropertyPanelHandle, DesignPanelComponent, StylesEntryMap, SelectedComponentContext, OpenSourceFilePayload, ImageSourceBindings, } from '../core/DesignPropertyPanelRoot.cjs';
@@ -8,6 +8,10 @@
8
8
  * that already run React on the page. React / react-dom are externalized by the
9
9
  * bundler, so the host provides the single React copy. Non-React hosts should
10
10
  * use `/authoring/web-component` instead.
11
+ *
12
+ * The panel's stylesheet is published separately as the sibling
13
+ * `/authoring/react/styles.css` export; a host imports it once alongside this
14
+ * entry (the `/authoring/web-component` entry instead inlines its CSS internally).
11
15
  */
12
16
  export { DesignPropertyPanel, mountDesignPropertyPanel } from '../core/DesignPropertyPanelRoot.js';
13
17
  export type { DesignPropertyPanelProps, DesignPropertyPanelHandle, DesignPanelComponent, StylesEntryMap, SelectedComponentContext, OpenSourceFilePayload, ImageSourceBindings, } from '../core/DesignPropertyPanelRoot.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/authoring/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AAEH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChG,YAAY,EACX,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzF,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,YAAY,EACX,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GAChB,MAAM,6BAA6B,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/authoring/react/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;;;GASG;AAEH,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAChG,YAAY,EACX,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,cAAc,EACd,wBAAwB,EACxB,qBAAqB,EACrB,mBAAmB,GACnB,MAAM,iCAAiC,CAAC;AAMzC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACzF,YAAY,EAAE,WAAW,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,YAAY,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAEhE,YAAY,EACX,QAAQ,EACR,QAAQ,EACR,aAAa,EACb,oBAAoB,EACpB,sBAAsB,EACtB,kBAAkB,EAClB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,GAChB,MAAM,6BAA6B,CAAC"}