acttrader-charts 1.2.0-beta.2 → 1.2.0-beta.4

package/README.md

@@ -916,6 +916,7 @@ const chart = new ChartEngine({
     headerLayout:          'advanced',  // 'simple' (default) | 'advanced' | 'compact'
     enableMultipleLayouts: true,        // shows Layout button + 26 preset picker
     enableSnapshot:        true,        // shows Snapshot button + Download/Copy popover
+    layoutSync:            { symbol: false, interval: true }, // optional — seed the popover's sync toggles
 });
 
 chart.on('layoutChange', ({ presetId, preset, sync }) => {
@@ -928,6 +929,27 @@ chart.on('snapshot', ({ dataUrl, action }) => {
 });
 ```
 
+### Seeding & restoring the popover's sync toggles
+
+The layout popover's five sync toggles (`symbol` / `interval` / `crosshair` / `time` / `dateRange`) default to `DEFAULT_LAYOUT_SYNC`. To open the popover in a different state — e.g. restoring a user's saved preference — pass a **partial** `layoutSync` at construction (omitted keys keep their `DEFAULT_LAYOUT_SYNC` value):
+
+```ts
+const chart = new ChartEngine({
+    container,
+    enableMultipleLayouts: true,
+    layoutSync: savedSync ?? { symbol: false, interval: false, crosshair: false, time: false, dateRange: false },
+});
+```
+
+To change the toggles on an **already-mounted** chart (e.g. mirroring a host-owned settings UI), call `setLayoutSync()`:
+
+```ts
+chart.setLayoutSync({ crosshair: true });        // partial — other toggles unchanged
+const current = chart.getLayoutSync();           // read the current state
+```
+
+`setLayoutSync()` updates the popover's toggles in place and — unlike a user click inside the popover — does **not** emit a `layoutChange` event, so a host can call it in response to its own state without re-entrancy. It no-ops when the resolved state is unchanged.
+
 ### `ChartGroup` — cross-pane sync
 
 `ChartGroup` listens to events on the *active* engine and mirrors them to the others:

package/dist/{MACD-BBW1QO3M.d.cts → MACD-dGgN6dtc.d.cts}

@@ -958,7 +958,7 @@ interface ChartConfig {
      * Always render SL/TP bracket lines + price pills, even when the parent
      * trade level is not hovered or selected. Close (×) buttons remain
      * hover-only to keep the chart uncluttered.
-     * Default: `false`.
+     * Default: `true`. Set `false` to only show them on hover/selection.
      */
     showTradeLevelsAlways?: boolean;
     /**
@@ -1045,6 +1045,16 @@ interface ChartConfig {
      * (a one-time `console.warn` is logged at init).
      */
     enableMultipleLayouts?: boolean;
+    /**
+     * Initial state of the cross-pane sync toggles (Symbol / Interval / Crosshair
+     * / Time / Date range) shown in the chart-owned layout popover when
+     * `enableMultipleLayouts: true`. Partial — any omitted key falls back to
+     * {@link DEFAULT_LAYOUT_SYNC}, so existing consumers are unaffected.
+     *
+     * Use this to restore a user's persisted sync preferences on init. To change
+     * the toggles on an already-mounted chart, call {@link ChartEngine.setLayoutSync}.
+     */
+    layoutSync?: Partial<LayoutSyncState>;
     /**
      * Show the Snapshot button and built-in Download/Copy popover.
      * Default `false`. Works in both `'simple'` and `'advanced'` header layouts.

package/dist/{MACD-BBW1QO3M.d.ts → MACD-dGgN6dtc.d.ts}

@@ -958,7 +958,7 @@ interface ChartConfig {
      * Always render SL/TP bracket lines + price pills, even when the parent
      * trade level is not hovered or selected. Close (×) buttons remain
      * hover-only to keep the chart uncluttered.
-     * Default: `false`.
+     * Default: `true`. Set `false` to only show them on hover/selection.
      */
     showTradeLevelsAlways?: boolean;
     /**
@@ -1045,6 +1045,16 @@ interface ChartConfig {
      * (a one-time `console.warn` is logged at init).
      */
     enableMultipleLayouts?: boolean;
+    /**
+     * Initial state of the cross-pane sync toggles (Symbol / Interval / Crosshair
+     * / Time / Date range) shown in the chart-owned layout popover when
+     * `enableMultipleLayouts: true`. Partial — any omitted key falls back to
+     * {@link DEFAULT_LAYOUT_SYNC}, so existing consumers are unaffected.
+     *
+     * Use this to restore a user's persisted sync preferences on init. To change
+     * the toggles on an already-mounted chart, call {@link ChartEngine.setLayoutSync}.
+     */
+    layoutSync?: Partial<LayoutSyncState>;
     /**
      * Show the Snapshot button and built-in Download/Copy popover.
      * Default `false`. Works in both `'simple'` and `'advanced'` header layouts.

package/dist/index.cjs

@@ -22493,7 +22493,7 @@ var _ChartEngine = class _ChartEngine {
     this.tfcActive = this.tfcEnabled;
     this.showCandleCountdown = config.showCandleCountdown ?? true;
     this.candleCountdownTimeframes = config.candleCountdownTimeframes;
-    this.showTradeLevelsAlways = config.showTradeLevelsAlways ?? false;
+    this.showTradeLevelsAlways = config.showTradeLevelsAlways ?? true;
     this.showPriceAxisCountdown = config.showPriceAxisCountdown ?? false;
     try {
       const persistedSlTp = localStorage.getItem(this.SHOW_SLTP_ALWAYS_LS_KEY);
@@ -22543,6 +22543,9 @@ var _ChartEngine = class _ChartEngine {
     const hideHeader = config.hideHeader === true;
     const enableMultipleLayouts = config.enableMultipleLayouts === true;
     const enableSnapshot = config.enableSnapshot === true;
+    if (config.layoutSync) {
+      this.currentSync = { ...DEFAULT_LAYOUT_SYNC, ...config.layoutSync };
+    }
     if (enableMultipleLayouts && typeof config.onLayoutClick === "function") {
       console.warn(
         "[ActCharts] `enableMultipleLayouts: true` owns the Layout button \u2014 the deprecated `onLayoutClick` callback is ignored. Listen to the `layoutChange` event instead."
@@ -25169,6 +25172,23 @@ var _ChartEngine = class _ChartEngine {
   getLayoutSync() {
     return { ...this.currentSync };
   }
+  /**
+   * Programmatically set the cross-pane sync toggles (e.g. restoring saved
+   * state or mirroring a host-owned settings UI). Accepts a partial patch —
+   * omitted keys keep their current value.
+   *
+   * Updates the chart-owned layout popover's toggles in place. Unlike a user
+   * click inside the popover, this does NOT emit a `layoutChange` event, so a
+   * host can safely call it in response to its own state without re-entrancy.
+   * No-ops when the resolved state is unchanged.
+   */
+  setLayoutSync(sync) {
+    const next = { ...this.currentSync, ...sync };
+    const changed = Object.keys(next).some((k) => next[k] !== this.currentSync[k]);
+    if (!changed) return;
+    this.currentSync = next;
+    this.layoutPopover?.setSync(this.currentSync);
+  }
   destroy() {
     this._isDestroyed = true;
     this.panHandler.destroy();