@kodiak-finance/orderly-layout-core 2.9.1

package/dist/index.d.mts

@@ -0,0 +1,244 @@
+import { ReactNode, ComponentType } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * Base layout model type - each strategy defines its own concrete type
+ * This is a marker type to ensure type safety in serialization
+ */
+type LayoutModel = Record<string, unknown>;
+/**
+ * Panel registry entry: maps panel IDs to React component with optional props
+ */
+type PanelRegistryEntry = {
+    node: ReactNode;
+    props?: Record<string, unknown>;
+};
+/**
+ * Panel registry: maps panel IDs to React components/nodes
+ */
+type PanelRegistry = Map<string, PanelRegistryEntry>;
+/**
+ * Layout change callback (generic version)
+ * @param layout - The new layout model (strategy-specific)
+ */
+type OnLayoutChange<TLayout extends LayoutModel = LayoutModel> = (layout: TLayout) => void;
+/**
+ * Layout persist callback - called when layout should be persisted (e.g., on drag stop)
+ * @param layout - The layout model to persist
+ */
+type OnLayoutPersist<TLayout extends LayoutModel = LayoutModel> = (layout: TLayout) => void;
+/**
+ * Layout strategy interface
+ * Each layout strategy (split, grid, etc.) must implement this interface
+ */
+interface LayoutStrategy<TLayout extends LayoutModel = LayoutModel> {
+    /** Unique identifier for this strategy */
+    id: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Create default layout model for given panel IDs */
+    defaultLayout: (panelIds: string[]) => TLayout;
+    /** Serialize layout model to JSON for persistence */
+    serialize: (layout: TLayout) => string;
+    /** Deserialize JSON string back to layout model */
+    deserialize: (json: string) => TLayout;
+    /** Renderer component that takes layout model and panels and renders them */
+    Renderer: ComponentType<LayoutRendererProps<TLayout>>;
+}
+/**
+ * Props for the strategy renderer component
+ */
+interface LayoutRendererProps<TLayout extends LayoutModel = LayoutModel> {
+    /** Current layout model */
+    layout: TLayout;
+    /** Panel registry containing all available panels */
+    panels: PanelRegistry;
+    /** Callback when layout changes (typed to the specific layout model) */
+    onLayoutChange: OnLayoutChange<TLayout>;
+    /** Callback when layout should be persisted (e.g., on drag stop or resize stop) */
+    onLayoutPersist?: OnLayoutPersist<TLayout>;
+    /** Optional className for the root container */
+    className?: string;
+    /** Optional style for the root container */
+    style?: React.CSSProperties;
+}
+/**
+ * Props for LayoutHost component
+ */
+interface LayoutHostProps<TLayout extends LayoutModel = LayoutModel> {
+    /** The layout strategy to use */
+    strategy: LayoutStrategy<TLayout>;
+    /** Panel registry: map of panel ID to ReactNode or PanelRegistryEntry */
+    panels: PanelRegistry | Record<string, PanelRegistryEntry | ReactNode>;
+    /** Initial layout model (optional, will use defaultLayout if not provided) */
+    initialLayout?: TLayout;
+    /** Callback when layout changes (typed to the specific layout model) */
+    onLayoutChange?: OnLayoutChange<TLayout>;
+    /** Storage key for persistence (optional, if not provided layout won't be persisted) */
+    storageKey?: string;
+    /** Optional className for the root container */
+    className?: string;
+    /** Optional style for the root container */
+    style?: React.CSSProperties;
+}
+/**
+ * Strategy resolver options
+ */
+interface StrategyResolverOptions {
+    /** Preferred strategy ID (may not be available) */
+    preferredId?: string;
+    /** Available strategies to choose from */
+    availableStrategies: LayoutStrategy[];
+    /** Default strategy to use if preferred is not available */
+    defaultStrategy?: LayoutStrategy;
+}
+
+/**
+ * Trading page panel ID constants.
+ * Used across layout strategies (split, grid) to identify trading panels.
+ * Component mapping happens in the trading package.
+ */
+declare const TRADING_PANEL_IDS: {
+    readonly SYMBOL_INFO_BAR: "symbolInfoBar";
+    readonly TRADING_VIEW: "tradingView";
+    readonly ORDERBOOK: "orderbook";
+    readonly DATA_LIST: "dataList";
+    readonly ORDER_ENTRY: "orderEntry";
+    readonly MARGIN: "orderEntryMargin";
+    readonly ASSETS: "orderEntryAssets";
+    readonly MARKETS: "markets";
+    readonly HORIZONTAL_MARKETS: "horizontalMarkets";
+};
+type TradingPanelId = (typeof TRADING_PANEL_IDS)[keyof typeof TRADING_PANEL_IDS];
+/**
+ * Returns all trading panel IDs from layout-core.
+ * Used by layout strategies (split, grid) to derive panel set; component mapping is in trading package.
+ */
+declare function getTradingPanelIds(): readonly string[];
+
+/**
+ * LayoutHost component
+ * Provides a unified interface for rendering layouts using any strategy
+ *
+ * @example
+ * ```tsx
+ * <LayoutHost
+ *   strategy={splitStrategy}
+ *   panels={panelMap}
+ *   storageKey="my_layout_state"
+ *   onLayoutChange={(layout) => console.log('Layout changed', layout)}
+ * />
+ * ```
+ */
+declare function LayoutHost<TLayout extends LayoutModel = LayoutModel>(props: LayoutHostProps<TLayout>): react_jsx_runtime.JSX.Element;
+
+/**
+ * Hook for persisting layout state to localStorage
+ * @param strategy - The layout strategy being used
+ * @param storageKey - localStorage key (optional, if not provided returns undefined)
+ * @param dep - Dependency to trigger re-read from storage when it changes
+ * @returns Tuple of [currentLayout, setLayout]
+ */
+declare function useLayoutPersistence<TLayout extends LayoutModel>(strategy: LayoutStrategy<TLayout>, storageKey?: string, dep?: unknown): [TLayout | undefined, (layout: TLayout) => void];
+
+/**
+ * Generic preset shape: id, name, and strategy-specific rule.
+ */
+interface LayoutPreset<TRule = unknown> {
+    id: string;
+    name: string;
+    rule: TRule;
+}
+/**
+ * Storage key configuration per strategy (split vs grid use different keys).
+ */
+interface LayoutRuleManagerOptions {
+    /** localStorage key for persisting the selected preset id. */
+    presetIdStorageKey: string;
+    /** Base key for layout persistence; actual key is `${layoutStorageKeyPrefix}_${presetId}`. */
+    layoutStorageKeyPrefix: string;
+    /**
+     * When false, no localStorage read/write; preset selection kept in memory only.
+     * Default true for backward compatibility.
+     */
+    persist?: boolean;
+}
+/**
+ * Manages layout presets, selected preset persistence, and reset.
+ * Persistence of the user-selected rule (preset id) is done via presetIdStorageKey.
+ * When persist is false, selection is kept in memory only (no localStorage).
+ */
+declare class LayoutRuleManager<TRule = unknown> {
+    private readonly _presets;
+    private readonly options;
+    /** In-memory selected preset id when persist is false. */
+    private _selectedId?;
+    constructor(presets: LayoutPreset<TRule>[], options: LayoutRuleManagerOptions);
+    /** Whether persistence to localStorage is enabled. */
+    private get persist();
+    /** Read-only preset list. */
+    get presets(): readonly LayoutPreset<TRule>[];
+    /**
+     * Reads selected preset id from localStorage (presetIdStorageKey).
+     * When persist is false, returns in-memory selection or first preset.
+     * Validates against presets; falls back to first preset id when missing or invalid.
+     */
+    getSelectedPresetId(): string;
+    /**
+     * Writes selected preset id to localStorage (presetIdStorageKey).
+     * When persist is false, only updates in-memory selection.
+     * Validates id exists in presets before writing.
+     */
+    setSelectedPresetId(id: string): void;
+    /** Returns the preset for the currently selected id. */
+    getSelectedPreset(): LayoutPreset<TRule> | undefined;
+    /**
+     * Storage key for layout persistence for the current preset.
+     * Used by LayoutHost: `${layoutStorageKeyPrefix}_${selectedPresetId}`.
+     */
+    getLayoutStorageKey(): string;
+    /**
+     * Clears persisted layout data for the current preset (reset to preset rule).
+     * After this, next load will use getInitialLayout() from preset rule.
+     * No-op when persist is false (nothing to clear).
+     */
+    reset(): void;
+    /**
+     * Returns whether the current preset has any persisted layout data.
+     * Useful for UI "custom" badge or "Reset to default" visibility.
+     * Returns false when persist is false.
+     */
+    hasPersistedLayout(): boolean;
+}
+
+interface UseLayoutRuleManagerResult<TRule> {
+    presets: readonly LayoutPreset<TRule>[];
+    selectedPresetId: string;
+    setSelectedPresetId: (id: string) => void;
+    layoutStorageKey: string;
+    reset: () => void;
+    getSelectedPreset: () => LayoutPreset<TRule> | undefined;
+    hasPersistedLayout: () => boolean;
+}
+/**
+ * Binds a LayoutRuleManager to React state so selection and reset trigger re-renders.
+ * setSelectedPresetId updates both the manager (localStorage) and local state.
+ *
+ * @param manager - LayoutRuleManager instance (e.g. from LayoutRuleManager<SplitLayoutRule>)
+ * @returns Presets, selectedPresetId, setSelectedPresetId, layoutStorageKey, reset, getSelectedPreset, hasPersistedLayout
+ */
+declare function useLayoutRuleManager<TRule>(manager: LayoutRuleManager<TRule>): UseLayoutRuleManagerResult<TRule>;
+
+/**
+ * Resolve which strategy to use based on preferred ID and available strategies
+ * Ensures we always return a valid strategy, falling back to default if preferred is not available
+ *
+ * @param options - Resolver options
+ * @returns Resolved strategy and its ID
+ */
+declare function resolveStrategy(options: StrategyResolverOptions): {
+    strategy: LayoutStrategy;
+    id: string;
+};
+
+export { LayoutHost, type LayoutHostProps, type LayoutModel, type LayoutPreset, type LayoutRendererProps, LayoutRuleManager, type LayoutRuleManagerOptions, type LayoutStrategy, type OnLayoutChange, type OnLayoutPersist, type PanelRegistry, type StrategyResolverOptions, TRADING_PANEL_IDS, type TradingPanelId, type UseLayoutRuleManagerResult, getTradingPanelIds, resolveStrategy, useLayoutPersistence, useLayoutRuleManager };

package/dist/index.d.ts

@@ -0,0 +1,244 @@
+import { ReactNode, ComponentType } from 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+/**
+ * Base layout model type - each strategy defines its own concrete type
+ * This is a marker type to ensure type safety in serialization
+ */
+type LayoutModel = Record<string, unknown>;
+/**
+ * Panel registry entry: maps panel IDs to React component with optional props
+ */
+type PanelRegistryEntry = {
+    node: ReactNode;
+    props?: Record<string, unknown>;
+};
+/**
+ * Panel registry: maps panel IDs to React components/nodes
+ */
+type PanelRegistry = Map<string, PanelRegistryEntry>;
+/**
+ * Layout change callback (generic version)
+ * @param layout - The new layout model (strategy-specific)
+ */
+type OnLayoutChange<TLayout extends LayoutModel = LayoutModel> = (layout: TLayout) => void;
+/**
+ * Layout persist callback - called when layout should be persisted (e.g., on drag stop)
+ * @param layout - The layout model to persist
+ */
+type OnLayoutPersist<TLayout extends LayoutModel = LayoutModel> = (layout: TLayout) => void;
+/**
+ * Layout strategy interface
+ * Each layout strategy (split, grid, etc.) must implement this interface
+ */
+interface LayoutStrategy<TLayout extends LayoutModel = LayoutModel> {
+    /** Unique identifier for this strategy */
+    id: string;
+    /** Human-readable display name */
+    displayName: string;
+    /** Create default layout model for given panel IDs */
+    defaultLayout: (panelIds: string[]) => TLayout;
+    /** Serialize layout model to JSON for persistence */
+    serialize: (layout: TLayout) => string;
+    /** Deserialize JSON string back to layout model */
+    deserialize: (json: string) => TLayout;
+    /** Renderer component that takes layout model and panels and renders them */
+    Renderer: ComponentType<LayoutRendererProps<TLayout>>;
+}
+/**
+ * Props for the strategy renderer component
+ */
+interface LayoutRendererProps<TLayout extends LayoutModel = LayoutModel> {
+    /** Current layout model */
+    layout: TLayout;
+    /** Panel registry containing all available panels */
+    panels: PanelRegistry;
+    /** Callback when layout changes (typed to the specific layout model) */
+    onLayoutChange: OnLayoutChange<TLayout>;
+    /** Callback when layout should be persisted (e.g., on drag stop or resize stop) */
+    onLayoutPersist?: OnLayoutPersist<TLayout>;
+    /** Optional className for the root container */
+    className?: string;
+    /** Optional style for the root container */
+    style?: React.CSSProperties;
+}
+/**
+ * Props for LayoutHost component
+ */
+interface LayoutHostProps<TLayout extends LayoutModel = LayoutModel> {
+    /** The layout strategy to use */
+    strategy: LayoutStrategy<TLayout>;
+    /** Panel registry: map of panel ID to ReactNode or PanelRegistryEntry */
+    panels: PanelRegistry | Record<string, PanelRegistryEntry | ReactNode>;
+    /** Initial layout model (optional, will use defaultLayout if not provided) */
+    initialLayout?: TLayout;
+    /** Callback when layout changes (typed to the specific layout model) */
+    onLayoutChange?: OnLayoutChange<TLayout>;
+    /** Storage key for persistence (optional, if not provided layout won't be persisted) */
+    storageKey?: string;
+    /** Optional className for the root container */
+    className?: string;
+    /** Optional style for the root container */
+    style?: React.CSSProperties;
+}
+/**
+ * Strategy resolver options
+ */
+interface StrategyResolverOptions {
+    /** Preferred strategy ID (may not be available) */
+    preferredId?: string;
+    /** Available strategies to choose from */
+    availableStrategies: LayoutStrategy[];
+    /** Default strategy to use if preferred is not available */
+    defaultStrategy?: LayoutStrategy;
+}
+
+/**
+ * Trading page panel ID constants.
+ * Used across layout strategies (split, grid) to identify trading panels.
+ * Component mapping happens in the trading package.
+ */
+declare const TRADING_PANEL_IDS: {
+    readonly SYMBOL_INFO_BAR: "symbolInfoBar";
+    readonly TRADING_VIEW: "tradingView";
+    readonly ORDERBOOK: "orderbook";
+    readonly DATA_LIST: "dataList";
+    readonly ORDER_ENTRY: "orderEntry";
+    readonly MARGIN: "orderEntryMargin";
+    readonly ASSETS: "orderEntryAssets";
+    readonly MARKETS: "markets";
+    readonly HORIZONTAL_MARKETS: "horizontalMarkets";
+};
+type TradingPanelId = (typeof TRADING_PANEL_IDS)[keyof typeof TRADING_PANEL_IDS];
+/**
+ * Returns all trading panel IDs from layout-core.
+ * Used by layout strategies (split, grid) to derive panel set; component mapping is in trading package.
+ */
+declare function getTradingPanelIds(): readonly string[];
+
+/**
+ * LayoutHost component
+ * Provides a unified interface for rendering layouts using any strategy
+ *
+ * @example
+ * ```tsx
+ * <LayoutHost
+ *   strategy={splitStrategy}
+ *   panels={panelMap}
+ *   storageKey="my_layout_state"
+ *   onLayoutChange={(layout) => console.log('Layout changed', layout)}
+ * />
+ * ```
+ */
+declare function LayoutHost<TLayout extends LayoutModel = LayoutModel>(props: LayoutHostProps<TLayout>): react_jsx_runtime.JSX.Element;
+
+/**
+ * Hook for persisting layout state to localStorage
+ * @param strategy - The layout strategy being used
+ * @param storageKey - localStorage key (optional, if not provided returns undefined)
+ * @param dep - Dependency to trigger re-read from storage when it changes
+ * @returns Tuple of [currentLayout, setLayout]
+ */
+declare function useLayoutPersistence<TLayout extends LayoutModel>(strategy: LayoutStrategy<TLayout>, storageKey?: string, dep?: unknown): [TLayout | undefined, (layout: TLayout) => void];
+
+/**
+ * Generic preset shape: id, name, and strategy-specific rule.
+ */
+interface LayoutPreset<TRule = unknown> {
+    id: string;
+    name: string;
+    rule: TRule;
+}
+/**
+ * Storage key configuration per strategy (split vs grid use different keys).
+ */
+interface LayoutRuleManagerOptions {
+    /** localStorage key for persisting the selected preset id. */
+    presetIdStorageKey: string;
+    /** Base key for layout persistence; actual key is `${layoutStorageKeyPrefix}_${presetId}`. */
+    layoutStorageKeyPrefix: string;
+    /**
+     * When false, no localStorage read/write; preset selection kept in memory only.
+     * Default true for backward compatibility.
+     */
+    persist?: boolean;
+}
+/**
+ * Manages layout presets, selected preset persistence, and reset.
+ * Persistence of the user-selected rule (preset id) is done via presetIdStorageKey.
+ * When persist is false, selection is kept in memory only (no localStorage).
+ */
+declare class LayoutRuleManager<TRule = unknown> {
+    private readonly _presets;
+    private readonly options;
+    /** In-memory selected preset id when persist is false. */
+    private _selectedId?;
+    constructor(presets: LayoutPreset<TRule>[], options: LayoutRuleManagerOptions);
+    /** Whether persistence to localStorage is enabled. */
+    private get persist();
+    /** Read-only preset list. */
+    get presets(): readonly LayoutPreset<TRule>[];
+    /**
+     * Reads selected preset id from localStorage (presetIdStorageKey).
+     * When persist is false, returns in-memory selection or first preset.
+     * Validates against presets; falls back to first preset id when missing or invalid.
+     */
+    getSelectedPresetId(): string;
+    /**
+     * Writes selected preset id to localStorage (presetIdStorageKey).
+     * When persist is false, only updates in-memory selection.
+     * Validates id exists in presets before writing.
+     */
+    setSelectedPresetId(id: string): void;
+    /** Returns the preset for the currently selected id. */
+    getSelectedPreset(): LayoutPreset<TRule> | undefined;
+    /**
+     * Storage key for layout persistence for the current preset.
+     * Used by LayoutHost: `${layoutStorageKeyPrefix}_${selectedPresetId}`.
+     */
+    getLayoutStorageKey(): string;
+    /**
+     * Clears persisted layout data for the current preset (reset to preset rule).
+     * After this, next load will use getInitialLayout() from preset rule.
+     * No-op when persist is false (nothing to clear).
+     */
+    reset(): void;
+    /**
+     * Returns whether the current preset has any persisted layout data.
+     * Useful for UI "custom" badge or "Reset to default" visibility.
+     * Returns false when persist is false.
+     */
+    hasPersistedLayout(): boolean;
+}
+
+interface UseLayoutRuleManagerResult<TRule> {
+    presets: readonly LayoutPreset<TRule>[];
+    selectedPresetId: string;
+    setSelectedPresetId: (id: string) => void;
+    layoutStorageKey: string;
+    reset: () => void;
+    getSelectedPreset: () => LayoutPreset<TRule> | undefined;
+    hasPersistedLayout: () => boolean;
+}
+/**
+ * Binds a LayoutRuleManager to React state so selection and reset trigger re-renders.
+ * setSelectedPresetId updates both the manager (localStorage) and local state.
+ *
+ * @param manager - LayoutRuleManager instance (e.g. from LayoutRuleManager<SplitLayoutRule>)
+ * @returns Presets, selectedPresetId, setSelectedPresetId, layoutStorageKey, reset, getSelectedPreset, hasPersistedLayout
+ */
+declare function useLayoutRuleManager<TRule>(manager: LayoutRuleManager<TRule>): UseLayoutRuleManagerResult<TRule>;
+
+/**
+ * Resolve which strategy to use based on preferred ID and available strategies
+ * Ensures we always return a valid strategy, falling back to default if preferred is not available
+ *
+ * @param options - Resolver options
+ * @returns Resolved strategy and its ID
+ */
+declare function resolveStrategy(options: StrategyResolverOptions): {
+    strategy: LayoutStrategy;
+    id: string;
+};
+
+export { LayoutHost, type LayoutHostProps, type LayoutModel, type LayoutPreset, type LayoutRendererProps, LayoutRuleManager, type LayoutRuleManagerOptions, type LayoutStrategy, type OnLayoutChange, type OnLayoutPersist, type PanelRegistry, type StrategyResolverOptions, TRADING_PANEL_IDS, type TradingPanelId, type UseLayoutRuleManagerResult, getTradingPanelIds, resolveStrategy, useLayoutPersistence, useLayoutRuleManager };

package/dist/index.js

@@ -0,0 +1,331 @@
+'use strict';
+
+var react = require('react');
+var jsxRuntime = require('react/jsx-runtime');
+
+// src/tradingPanelIds.ts
+var TRADING_PANEL_IDS = {
+  SYMBOL_INFO_BAR: "symbolInfoBar",
+  TRADING_VIEW: "tradingView",
+  ORDERBOOK: "orderbook",
+  DATA_LIST: "dataList",
+  ORDER_ENTRY: "orderEntry",
+  MARGIN: "orderEntryMargin",
+  ASSETS: "orderEntryAssets",
+  // MAIN: "orderEntryMain",
+  MARKETS: "markets",
+  HORIZONTAL_MARKETS: "horizontalMarkets"
+};
+function getTradingPanelIds() {
+  return Object.values(TRADING_PANEL_IDS);
+}
+function canUseLocalStorage() {
+  try {
+    return typeof window !== "undefined" && typeof window.localStorage !== "undefined";
+  } catch {
+    return false;
+  }
+}
+function useLayoutPersistence(strategy, storageKey, dep) {
+  const debounceTimerRef = react.useRef(null);
+  const layout = react.useMemo(() => {
+    if (!storageKey || !canUseLocalStorage()) {
+      return void 0;
+    }
+    try {
+      const stored = localStorage.getItem(storageKey);
+      if (stored) {
+        return strategy.deserialize(stored);
+      }
+    } catch (error) {
+    }
+    return void 0;
+  }, [strategy, storageKey, dep]);
+  react.useEffect(() => {
+    return () => {
+      if (debounceTimerRef.current) {
+        clearTimeout(debounceTimerRef.current);
+      }
+    };
+  }, []);
+  const setLayout = react.useCallback(
+    (newLayout) => {
+      if (!storageKey || !canUseLocalStorage()) {
+        return;
+      }
+      if (debounceTimerRef.current) {
+        clearTimeout(debounceTimerRef.current);
+      }
+      debounceTimerRef.current = setTimeout(() => {
+        try {
+          const serialized = strategy.serialize(newLayout);
+          localStorage.setItem(storageKey, serialized);
+        } catch (error) {
+        }
+      }, 100);
+    },
+    [strategy, storageKey]
+  );
+  return [layout, setLayout];
+}
+function isMap(value) {
+  return value !== null && typeof value === "object" && typeof value.get === "function" && typeof value.keys === "function";
+}
+function LayoutHost(props) {
+  const {
+    strategy,
+    panels: panelsInput,
+    initialLayout,
+    onLayoutChange,
+    storageKey,
+    className,
+    style
+  } = props;
+  const panels = react.useMemo(() => {
+    if (isMap(panelsInput)) {
+      return panelsInput;
+    }
+    const map = /* @__PURE__ */ new Map();
+    Object.entries(panelsInput).forEach(([id, entry]) => {
+      if (entry && typeof entry === "object" && "node" in entry) {
+        map.set(id, entry);
+      } else {
+        map.set(id, { node: entry, props: {} });
+      }
+    });
+    return map;
+  }, [panelsInput]);
+  const panelIds = react.useMemo(() => Array.from(panels.keys()), [panels]);
+  const [persistedLayout, setPersistedLayout] = useLayoutPersistence(
+    strategy,
+    storageKey,
+    strategy.id
+    // Re-read when strategy changes
+  );
+  const resolvedLayout = react.useMemo(() => {
+    if (persistedLayout) {
+      return persistedLayout;
+    }
+    if (initialLayout) {
+      return initialLayout;
+    }
+    return strategy.defaultLayout(panelIds);
+  }, [persistedLayout, initialLayout, strategy, panelIds]);
+  const [currentLayout, setCurrentLayout] = react.useState(resolvedLayout);
+  react.useEffect(() => {
+    setCurrentLayout(resolvedLayout);
+  }, [resolvedLayout]);
+  const handleLayoutChange = react.useCallback(
+    (newLayout) => {
+      setCurrentLayout(newLayout);
+      onLayoutChange?.(newLayout);
+    },
+    [onLayoutChange]
+  );
+  const handleLayoutPersist = react.useCallback(
+    (newLayout) => {
+      if (storageKey) {
+        setPersistedLayout(newLayout);
+      }
+    },
+    [storageKey, setPersistedLayout]
+  );
+  const Renderer = strategy.Renderer;
+  if (panels.size === 0) {
+    return /* @__PURE__ */ jsxRuntime.jsx("div", { className, style });
+  }
+  return /* @__PURE__ */ jsxRuntime.jsx(
+    Renderer,
+    {
+      layout: currentLayout,
+      panels,
+      onLayoutChange: handleLayoutChange,
+      onLayoutPersist: handleLayoutPersist,
+      className,
+      style
+    }
+  );
+}
+function useLayoutRuleManager(manager) {
+  const [selectedPresetId, setSelectedPresetIdState] = react.useState(
+    () => manager.getSelectedPresetId()
+  );
+  react.useEffect(() => {
+    setSelectedPresetIdState(manager.getSelectedPresetId());
+  }, [manager]);
+  const setSelectedPresetId = react.useCallback(
+    (id) => {
+      manager.setSelectedPresetId(id);
+      setSelectedPresetIdState(id);
+    },
+    [manager]
+  );
+  const reset = react.useCallback(() => {
+    manager.reset();
+    setSelectedPresetIdState((prev) => prev);
+  }, [manager]);
+  const layoutStorageKey = react.useMemo(
+    () => manager.getLayoutStorageKey(),
+    [manager, selectedPresetId]
+  );
+  const getSelectedPreset = react.useCallback(
+    () => manager.getSelectedPreset(),
+    [manager]
+  );
+  const hasPersistedLayout = react.useCallback(
+    () => manager.hasPersistedLayout(),
+    [manager]
+  );
+  return react.useMemo(
+    () => ({
+      presets: manager.presets,
+      selectedPresetId,
+      setSelectedPresetId,
+      layoutStorageKey,
+      reset,
+      getSelectedPreset,
+      hasPersistedLayout
+    }),
+    [
+      manager,
+      selectedPresetId,
+      setSelectedPresetId,
+      layoutStorageKey,
+      reset,
+      getSelectedPreset,
+      hasPersistedLayout
+    ]
+  );
+}
+
+// src/utils/strategyResolver.ts
+function resolveStrategy(options) {
+  const { preferredId, availableStrategies, defaultStrategy } = options;
+  if (preferredId) {
+    const preferred = availableStrategies.find((s) => s.id === preferredId);
+    if (preferred) {
+      return { strategy: preferred, id: preferredId };
+    }
+  }
+  if (defaultStrategy) {
+    return { strategy: defaultStrategy, id: defaultStrategy.id };
+  }
+  if (availableStrategies.length > 0) {
+    const first = availableStrategies[0];
+    return { strategy: first, id: first.id };
+  }
+  throw new Error(
+    "No layout strategy available. Please ensure at least one strategy is provided."
+  );
+}
+
+// src/utils/LayoutRuleManager.ts
+function hasStorage() {
+  return typeof window !== "undefined" && !!window.localStorage;
+}
+var LayoutRuleManager = class {
+  constructor(presets, options) {
+    this._presets = presets.length > 0 ? [...presets] : [];
+    this.options = { ...options };
+  }
+  /** Whether persistence to localStorage is enabled. */
+  get persist() {
+    return this.options.persist !== false;
+  }
+  /** Read-only preset list. */
+  get presets() {
+    return this._presets;
+  }
+  /**
+   * Reads selected preset id from localStorage (presetIdStorageKey).
+   * When persist is false, returns in-memory selection or first preset.
+   * Validates against presets; falls back to first preset id when missing or invalid.
+   */
+  getSelectedPresetId() {
+    if (this._presets.length === 0) {
+      return "";
+    }
+    if (!this.persist) {
+      return this._selectedId ?? this._presets[0]?.id ?? "";
+    }
+    if (!hasStorage()) {
+      return this._presets[0]?.id ?? "";
+    }
+    try {
+      const stored = window.localStorage.getItem(
+        this.options.presetIdStorageKey
+      );
+      const valid = stored && this._presets.some((p) => p.id === stored) ? stored : this._presets[0]?.id ?? "";
+      return valid;
+    } catch {
+      return this._presets[0]?.id ?? "";
+    }
+  }
+  /**
+   * Writes selected preset id to localStorage (presetIdStorageKey).
+   * When persist is false, only updates in-memory selection.
+   * Validates id exists in presets before writing.
+   */
+  setSelectedPresetId(id) {
+    if (!this._presets.some((p) => p.id === id)) return;
+    if (!this.persist) {
+      this._selectedId = id;
+      return;
+    }
+    if (!hasStorage()) return;
+    try {
+      window.localStorage.setItem(this.options.presetIdStorageKey, id);
+    } catch {
+    }
+  }
+  /** Returns the preset for the currently selected id. */
+  getSelectedPreset() {
+    const id = this.getSelectedPresetId();
+    return this._presets.find((p) => p.id === id);
+  }
+  /**
+   * Storage key for layout persistence for the current preset.
+   * Used by LayoutHost: `${layoutStorageKeyPrefix}_${selectedPresetId}`.
+   */
+  getLayoutStorageKey() {
+    const id = this.getSelectedPresetId();
+    return `${this.options.layoutStorageKeyPrefix}_${id}`;
+  }
+  /**
+   * Clears persisted layout data for the current preset (reset to preset rule).
+   * After this, next load will use getInitialLayout() from preset rule.
+   * No-op when persist is false (nothing to clear).
+   */
+  reset() {
+    if (!this.persist || !hasStorage()) return;
+    try {
+      window.localStorage.removeItem(this.getLayoutStorageKey());
+    } catch {
+    }
+  }
+  /**
+   * Returns whether the current preset has any persisted layout data.
+   * Useful for UI "custom" badge or "Reset to default" visibility.
+   * Returns false when persist is false.
+   */
+  hasPersistedLayout() {
+    if (!this.persist || !hasStorage()) return false;
+    try {
+      const key = this.getLayoutStorageKey();
+      const value = window.localStorage.getItem(key);
+      return value != null && value.length > 0;
+    } catch {
+      return false;
+    }
+  }
+};
+
+exports.LayoutHost = LayoutHost;
+exports.LayoutRuleManager = LayoutRuleManager;
+exports.TRADING_PANEL_IDS = TRADING_PANEL_IDS;
+exports.getTradingPanelIds = getTradingPanelIds;
+exports.resolveStrategy = resolveStrategy;
+exports.useLayoutPersistence = useLayoutPersistence;
+exports.useLayoutRuleManager = useLayoutRuleManager;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tradingPanelIds.ts","../src/hooks/useLayoutPersistence.ts","../src/LayoutHost.tsx","../src/hooks/useLayoutRuleManager.ts","../src/utils/strategyResolver.ts","../src/utils/LayoutRuleManager.ts"],"names":["useRef","useMemo","useEffect","useCallback","useState","jsx"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Trading page panel ID constants.\n * Used across layout strategies (split, grid) to identify trading panels.\n * Component mapping happens in the trading package.\n */\nexport const TRADING_PANEL_IDS = {\n  SYMBOL_INFO_BAR: \"symbolInfoBar\",\n  TRADING_VIEW: \"tradingView\",\n  ORDERBOOK: \"orderbook\",\n  DATA_LIST: \"dataList\",\n  ORDER_ENTRY: \"orderEntry\",\n  MARGIN: \"orderEntryMargin\",\n  ASSETS: \"orderEntryAssets\",\n  // MAIN: \"orderEntryMain\",\n  MARKETS: \"markets\",\n  HORIZONTAL_MARKETS: \"horizontalMarkets\",\n} as const;\n\nexport type TradingPanelId =\n  (typeof TRADING_PANEL_IDS)[keyof typeof TRADING_PANEL_IDS];\n\n/**\n * Returns all trading panel IDs from layout-core.\n * Used by layout strategies (split, grid) to derive panel set; component mapping is in trading package.\n */\nexport function getTradingPanelIds(): readonly string[] {\n  return Object.values(TRADING_PANEL_IDS);\n}\n","import { useMemo, useCallback, useRef, useEffect } from \"react\";\nimport type { LayoutModel, LayoutStrategy } from \"../types\";\n\n/**\n * Check if we're in a browser environment with localStorage available\n */\nfunction canUseLocalStorage(): boolean {\n  try {\n    return (\n      typeof window !== \"undefined\" &&\n      typeof window.localStorage !== \"undefined\"\n    );\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Hook for persisting layout state to localStorage\n * @param strategy - The layout strategy being used\n * @param storageKey - localStorage key (optional, if not provided returns undefined)\n * @param dep - Dependency to trigger re-read from storage when it changes\n * @returns Tuple of [currentLayout, setLayout]\n */\nexport function useLayoutPersistence<TLayout extends LayoutModel>(\n  strategy: LayoutStrategy<TLayout>,\n  storageKey?: string,\n  dep?: unknown,\n): [TLayout | undefined, (layout: TLayout) => void] {\n  // Debounce timer ref\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const layout = useMemo(() => {\n    if (!storageKey || !canUseLocalStorage()) {\n      return undefined;\n    }\n\n    try {\n      const stored = localStorage.getItem(storageKey);\n      if (stored) {\n        return strategy.deserialize(stored);\n      }\n    } catch (error) {\n      console.warn(`Failed to deserialize layout from ${storageKey}:`, error);\n    }\n\n    return undefined;\n  }, [strategy, storageKey, dep]);\n\n  // Cleanup debounce timer on unmount\n  useEffect(() => {\n    return () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n    };\n  }, []);\n\n  // Memoized setLayout with debouncing to avoid excessive writes\n  const setLayout = useCallback(\n    (newLayout: TLayout) => {\n      if (!storageKey || !canUseLocalStorage()) {\n        return;\n      }\n\n      // Clear existing debounce timer\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n\n      // Debounce the write operation (100ms)\n      debounceTimerRef.current = setTimeout(() => {\n        try {\n          const serialized = strategy.serialize(newLayout);\n          localStorage.setItem(storageKey, serialized);\n        } catch (error) {\n          console.warn(`Failed to serialize layout to ${storageKey}:`, error);\n        }\n      }, 100);\n    },\n    [strategy, storageKey],\n  );\n\n  return [layout, setLayout];\n}\n","import React, { useMemo, useState, useEffect, useCallback } from \"react\";\nimport { useLayoutPersistence } from \"./hooks/useLayoutPersistence\";\nimport type {\n  LayoutHostProps,\n  LayoutModel,\n  PanelRegistry,\n  PanelRegistryEntry,\n} from \"./types\";\n\n/**\n * Check if a value is a Map instance (handles cross-realm scenarios)\n */\nfunction isMap(value: unknown): value is Map<string, PanelRegistryEntry> {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    typeof (value as Map<string, PanelRegistryEntry>).get === \"function\" &&\n    typeof (value as Map<string, PanelRegistryEntry>).keys === \"function\"\n  );\n}\n\n/**\n * LayoutHost component\n * Provides a unified interface for rendering layouts using any strategy\n *\n * @example\n * ```tsx\n * <LayoutHost\n *   strategy={splitStrategy}\n *   panels={panelMap}\n *   storageKey=\"my_layout_state\"\n *   onLayoutChange={(layout) => console.log('Layout changed', layout)}\n * />\n * ```\n */\nexport function LayoutHost<TLayout extends LayoutModel = LayoutModel>(\n  props: LayoutHostProps<TLayout>,\n) {\n  const {\n    strategy,\n    panels: panelsInput,\n    initialLayout,\n    onLayoutChange,\n    storageKey,\n    className,\n    style,\n  } = props;\n\n  // Convert panels input to PanelRegistry (Map)\n  // Uses duck-typing check for cross-realm compatibility\n  const panels: PanelRegistry = useMemo(() => {\n    if (isMap(panelsInput)) {\n      return panelsInput;\n    }\n    // Convert Record to Map\n    const map = new Map<string, PanelRegistryEntry>();\n    Object.entries(panelsInput).forEach(([id, entry]) => {\n      // Handle both old format (ReactNode) and new format (PanelRegistryEntry)\n      if (entry && typeof entry === \"object\" && \"node\" in entry) {\n        map.set(id, entry as PanelRegistryEntry);\n      } else {\n        map.set(id, { node: entry as React.ReactNode, props: {} });\n      }\n    });\n    return map;\n  }, [panelsInput]);\n\n  // Get panel IDs from registry\n  const panelIds = useMemo(() => Array.from(panels.keys()), [panels]);\n\n  // Initialize layout state from persistence\n  const [persistedLayout, setPersistedLayout] = useLayoutPersistence(\n    strategy,\n    storageKey,\n    strategy.id, // Re-read when strategy changes\n  );\n\n  // Compute the resolved layout: persisted > initial > default\n  const resolvedLayout = useMemo<TLayout>(() => {\n    if (persistedLayout) {\n      return persistedLayout;\n    }\n    if (initialLayout) {\n      return initialLayout;\n    }\n    return strategy.defaultLayout(panelIds) as TLayout;\n  }, [persistedLayout, initialLayout, strategy, panelIds]);\n\n  // Internal layout state - initialized with resolved layout\n  const [currentLayout, setCurrentLayout] = useState<TLayout>(resolvedLayout);\n\n  // Sync when resolved layout changes (strategy switch, initial load, etc.)\n  useEffect(() => {\n    setCurrentLayout(resolvedLayout);\n  }, [resolvedLayout]);\n\n  // Handle layout changes - only updates internal state, no persistence\n  const handleLayoutChange = useCallback(\n    (newLayout: TLayout) => {\n      setCurrentLayout(newLayout);\n      // Notify parent\n      onLayoutChange?.(newLayout);\n    },\n    [onLayoutChange],\n  );\n\n  // Handle layout persist - persists layout to storage\n  const handleLayoutPersist = useCallback(\n    (newLayout: TLayout) => {\n      // Persist if storage key is provided\n      if (storageKey) {\n        setPersistedLayout(newLayout);\n      }\n    },\n    [storageKey, setPersistedLayout],\n  );\n\n  // Get the Renderer component from strategy\n  const Renderer = strategy.Renderer;\n\n  // Handle empty panels case\n  if (panels.size === 0) {\n    return (\n      <div className={className} style={style}>\n        {/* Empty state - no panels registered */}\n      </div>\n    );\n  }\n\n  return (\n    <Renderer\n      layout={currentLayout}\n      panels={panels}\n      onLayoutChange={handleLayoutChange}\n      onLayoutPersist={handleLayoutPersist}\n      className={className}\n      style={style}\n    />\n  );\n}\n","/**\n * @file useLayoutRuleManager.ts\n * @description React hook that syncs LayoutRuleManager with component state for presets, selection, and reset.\n */\nimport { useCallback, useEffect, useMemo, useState } from \"react\";\nimport type {\n  LayoutPreset,\n  LayoutRuleManager,\n} from \"../utils/LayoutRuleManager\";\n\nexport interface UseLayoutRuleManagerResult<TRule> {\n  presets: readonly LayoutPreset<TRule>[];\n  selectedPresetId: string;\n  setSelectedPresetId: (id: string) => void;\n  layoutStorageKey: string;\n  reset: () => void;\n  getSelectedPreset: () => LayoutPreset<TRule> | undefined;\n  hasPersistedLayout: () => boolean;\n}\n\n/**\n * Binds a LayoutRuleManager to React state so selection and reset trigger re-renders.\n * setSelectedPresetId updates both the manager (localStorage) and local state.\n *\n * @param manager - LayoutRuleManager instance (e.g. from LayoutRuleManager<SplitLayoutRule>)\n * @returns Presets, selectedPresetId, setSelectedPresetId, layoutStorageKey, reset, getSelectedPreset, hasPersistedLayout\n */\nexport function useLayoutRuleManager<TRule>(\n  manager: LayoutRuleManager<TRule>,\n): UseLayoutRuleManagerResult<TRule> {\n  const [selectedPresetId, setSelectedPresetIdState] = useState<string>(() =>\n    manager.getSelectedPresetId(),\n  );\n\n  /** Sync state when manager instance changes (e.g. presets changed). */\n  useEffect(() => {\n    setSelectedPresetIdState(manager.getSelectedPresetId());\n  }, [manager]);\n\n  const setSelectedPresetId = useCallback(\n    (id: string) => {\n      manager.setSelectedPresetId(id);\n      setSelectedPresetIdState(id);\n    },\n    [manager],\n  );\n\n  const reset = useCallback(() => {\n    manager.reset();\n    // Optionally force re-read selected id (no change) so consumers can react to reset\n    setSelectedPresetIdState((prev) => prev);\n  }, [manager]);\n\n  const layoutStorageKey = useMemo(\n    () => manager.getLayoutStorageKey(),\n    [manager, selectedPresetId],\n  );\n\n  const getSelectedPreset = useCallback(\n    () => manager.getSelectedPreset(),\n    [manager],\n  );\n\n  const hasPersistedLayout = useCallback(\n    () => manager.hasPersistedLayout(),\n    [manager],\n  );\n\n  return useMemo(\n    () => ({\n      presets: manager.presets,\n      selectedPresetId,\n      setSelectedPresetId,\n      layoutStorageKey,\n      reset,\n      getSelectedPreset,\n      hasPersistedLayout,\n    }),\n    [\n      manager,\n      selectedPresetId,\n      setSelectedPresetId,\n      layoutStorageKey,\n      reset,\n      getSelectedPreset,\n      hasPersistedLayout,\n    ],\n  );\n}\n","import type { LayoutStrategy, StrategyResolverOptions } from \"../types\";\n\n/**\n * Resolve which strategy to use based on preferred ID and available strategies\n * Ensures we always return a valid strategy, falling back to default if preferred is not available\n *\n * @param options - Resolver options\n * @returns Resolved strategy and its ID\n */\nexport function resolveStrategy(options: StrategyResolverOptions): {\n  strategy: LayoutStrategy;\n  id: string;\n} {\n  const { preferredId, availableStrategies, defaultStrategy } = options;\n\n  // If preferred ID is provided, try to find it\n  if (preferredId) {\n    const preferred = availableStrategies.find((s) => s.id === preferredId);\n    if (preferred) {\n      return { strategy: preferred, id: preferredId };\n    }\n  }\n\n  // Fall back to default strategy if provided\n  if (defaultStrategy) {\n    return { strategy: defaultStrategy, id: defaultStrategy.id };\n  }\n\n  // Fall back to first available strategy\n  if (availableStrategies.length > 0) {\n    const first = availableStrategies[0];\n    return { strategy: first, id: first.id };\n  }\n\n  // This should never happen if strategies are properly set up\n  throw new Error(\n    \"No layout strategy available. Please ensure at least one strategy is provided.\",\n  );\n}\n","/** SSR-safe check for localStorage availability. */\nfunction hasStorage(): boolean {\n  return typeof window !== \"undefined\" && !!window.localStorage;\n}\n\n/**\n * Generic preset shape: id, name, and strategy-specific rule.\n */\nexport interface LayoutPreset<TRule = unknown> {\n  id: string;\n  name: string;\n  rule: TRule;\n}\n\n/**\n * Storage key configuration per strategy (split vs grid use different keys).\n */\nexport interface LayoutRuleManagerOptions {\n  /** localStorage key for persisting the selected preset id. */\n  presetIdStorageKey: string;\n  /** Base key for layout persistence; actual key is `${layoutStorageKeyPrefix}_${presetId}`. */\n  layoutStorageKeyPrefix: string;\n  /**\n   * When false, no localStorage read/write; preset selection kept in memory only.\n   * Default true for backward compatibility.\n   */\n  persist?: boolean;\n}\n\n/**\n * Manages layout presets, selected preset persistence, and reset.\n * Persistence of the user-selected rule (preset id) is done via presetIdStorageKey.\n * When persist is false, selection is kept in memory only (no localStorage).\n */\nexport class LayoutRuleManager<TRule = unknown> {\n  private readonly _presets: readonly LayoutPreset<TRule>[];\n  private readonly options: LayoutRuleManagerOptions;\n  /** In-memory selected preset id when persist is false. */\n  private _selectedId?: string;\n\n  constructor(\n    presets: LayoutPreset<TRule>[],\n    options: LayoutRuleManagerOptions,\n  ) {\n    this._presets = presets.length > 0 ? [...presets] : [];\n    this.options = { ...options };\n  }\n\n  /** Whether persistence to localStorage is enabled. */\n  private get persist(): boolean {\n    return this.options.persist !== false;\n  }\n\n  /** Read-only preset list. */\n  get presets(): readonly LayoutPreset<TRule>[] {\n    return this._presets;\n  }\n\n  /**\n   * Reads selected preset id from localStorage (presetIdStorageKey).\n   * When persist is false, returns in-memory selection or first preset.\n   * Validates against presets; falls back to first preset id when missing or invalid.\n   */\n  getSelectedPresetId(): string {\n    if (this._presets.length === 0) {\n      return \"\";\n    }\n    if (!this.persist) {\n      return this._selectedId ?? this._presets[0]?.id ?? \"\";\n    }\n    if (!hasStorage()) {\n      return this._presets[0]?.id ?? \"\";\n    }\n    try {\n      const stored = window.localStorage.getItem(\n        this.options.presetIdStorageKey,\n      );\n      const valid =\n        stored && this._presets.some((p) => p.id === stored)\n          ? stored\n          : (this._presets[0]?.id ?? \"\");\n      return valid;\n    } catch {\n      return this._presets[0]?.id ?? \"\";\n    }\n  }\n\n  /**\n   * Writes selected preset id to localStorage (presetIdStorageKey).\n   * When persist is false, only updates in-memory selection.\n   * Validates id exists in presets before writing.\n   */\n  setSelectedPresetId(id: string): void {\n    if (!this._presets.some((p) => p.id === id)) return;\n    if (!this.persist) {\n      this._selectedId = id;\n      return;\n    }\n    if (!hasStorage()) return;\n    try {\n      window.localStorage.setItem(this.options.presetIdStorageKey, id);\n    } catch {\n      // ignore\n    }\n  }\n\n  /** Returns the preset for the currently selected id. */\n  getSelectedPreset(): LayoutPreset<TRule> | undefined {\n    const id = this.getSelectedPresetId();\n    return this._presets.find((p) => p.id === id);\n  }\n\n  /**\n   * Storage key for layout persistence for the current preset.\n   * Used by LayoutHost: `${layoutStorageKeyPrefix}_${selectedPresetId}`.\n   */\n  getLayoutStorageKey(): string {\n    const id = this.getSelectedPresetId();\n    return `${this.options.layoutStorageKeyPrefix}_${id}`;\n  }\n\n  /**\n   * Clears persisted layout data for the current preset (reset to preset rule).\n   * After this, next load will use getInitialLayout() from preset rule.\n   * No-op when persist is false (nothing to clear).\n   */\n  reset(): void {\n    if (!this.persist || !hasStorage()) return;\n    try {\n      window.localStorage.removeItem(this.getLayoutStorageKey());\n    } catch {\n      // ignore\n    }\n  }\n\n  /**\n   * Returns whether the current preset has any persisted layout data.\n   * Useful for UI \"custom\" badge or \"Reset to default\" visibility.\n   * Returns false when persist is false.\n   */\n  hasPersistedLayout(): boolean {\n    if (!this.persist || !hasStorage()) return false;\n    try {\n      const key = this.getLayoutStorageKey();\n      const value = window.localStorage.getItem(key);\n      return value != null && value.length > 0;\n    } catch {\n      return false;\n    }\n  }\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,323 @@
+import { useRef, useMemo, useEffect, useCallback, useState } from 'react';
+import { jsx } from 'react/jsx-runtime';
+
+// src/tradingPanelIds.ts
+var TRADING_PANEL_IDS = {
+  SYMBOL_INFO_BAR: "symbolInfoBar",
+  TRADING_VIEW: "tradingView",
+  ORDERBOOK: "orderbook",
+  DATA_LIST: "dataList",
+  ORDER_ENTRY: "orderEntry",
+  MARGIN: "orderEntryMargin",
+  ASSETS: "orderEntryAssets",
+  // MAIN: "orderEntryMain",
+  MARKETS: "markets",
+  HORIZONTAL_MARKETS: "horizontalMarkets"
+};
+function getTradingPanelIds() {
+  return Object.values(TRADING_PANEL_IDS);
+}
+function canUseLocalStorage() {
+  try {
+    return typeof window !== "undefined" && typeof window.localStorage !== "undefined";
+  } catch {
+    return false;
+  }
+}
+function useLayoutPersistence(strategy, storageKey, dep) {
+  const debounceTimerRef = useRef(null);
+  const layout = useMemo(() => {
+    if (!storageKey || !canUseLocalStorage()) {
+      return void 0;
+    }
+    try {
+      const stored = localStorage.getItem(storageKey);
+      if (stored) {
+        return strategy.deserialize(stored);
+      }
+    } catch (error) {
+    }
+    return void 0;
+  }, [strategy, storageKey, dep]);
+  useEffect(() => {
+    return () => {
+      if (debounceTimerRef.current) {
+        clearTimeout(debounceTimerRef.current);
+      }
+    };
+  }, []);
+  const setLayout = useCallback(
+    (newLayout) => {
+      if (!storageKey || !canUseLocalStorage()) {
+        return;
+      }
+      if (debounceTimerRef.current) {
+        clearTimeout(debounceTimerRef.current);
+      }
+      debounceTimerRef.current = setTimeout(() => {
+        try {
+          const serialized = strategy.serialize(newLayout);
+          localStorage.setItem(storageKey, serialized);
+        } catch (error) {
+        }
+      }, 100);
+    },
+    [strategy, storageKey]
+  );
+  return [layout, setLayout];
+}
+function isMap(value) {
+  return value !== null && typeof value === "object" && typeof value.get === "function" && typeof value.keys === "function";
+}
+function LayoutHost(props) {
+  const {
+    strategy,
+    panels: panelsInput,
+    initialLayout,
+    onLayoutChange,
+    storageKey,
+    className,
+    style
+  } = props;
+  const panels = useMemo(() => {
+    if (isMap(panelsInput)) {
+      return panelsInput;
+    }
+    const map = /* @__PURE__ */ new Map();
+    Object.entries(panelsInput).forEach(([id, entry]) => {
+      if (entry && typeof entry === "object" && "node" in entry) {
+        map.set(id, entry);
+      } else {
+        map.set(id, { node: entry, props: {} });
+      }
+    });
+    return map;
+  }, [panelsInput]);
+  const panelIds = useMemo(() => Array.from(panels.keys()), [panels]);
+  const [persistedLayout, setPersistedLayout] = useLayoutPersistence(
+    strategy,
+    storageKey,
+    strategy.id
+    // Re-read when strategy changes
+  );
+  const resolvedLayout = useMemo(() => {
+    if (persistedLayout) {
+      return persistedLayout;
+    }
+    if (initialLayout) {
+      return initialLayout;
+    }
+    return strategy.defaultLayout(panelIds);
+  }, [persistedLayout, initialLayout, strategy, panelIds]);
+  const [currentLayout, setCurrentLayout] = useState(resolvedLayout);
+  useEffect(() => {
+    setCurrentLayout(resolvedLayout);
+  }, [resolvedLayout]);
+  const handleLayoutChange = useCallback(
+    (newLayout) => {
+      setCurrentLayout(newLayout);
+      onLayoutChange?.(newLayout);
+    },
+    [onLayoutChange]
+  );
+  const handleLayoutPersist = useCallback(
+    (newLayout) => {
+      if (storageKey) {
+        setPersistedLayout(newLayout);
+      }
+    },
+    [storageKey, setPersistedLayout]
+  );
+  const Renderer = strategy.Renderer;
+  if (panels.size === 0) {
+    return /* @__PURE__ */ jsx("div", { className, style });
+  }
+  return /* @__PURE__ */ jsx(
+    Renderer,
+    {
+      layout: currentLayout,
+      panels,
+      onLayoutChange: handleLayoutChange,
+      onLayoutPersist: handleLayoutPersist,
+      className,
+      style
+    }
+  );
+}
+function useLayoutRuleManager(manager) {
+  const [selectedPresetId, setSelectedPresetIdState] = useState(
+    () => manager.getSelectedPresetId()
+  );
+  useEffect(() => {
+    setSelectedPresetIdState(manager.getSelectedPresetId());
+  }, [manager]);
+  const setSelectedPresetId = useCallback(
+    (id) => {
+      manager.setSelectedPresetId(id);
+      setSelectedPresetIdState(id);
+    },
+    [manager]
+  );
+  const reset = useCallback(() => {
+    manager.reset();
+    setSelectedPresetIdState((prev) => prev);
+  }, [manager]);
+  const layoutStorageKey = useMemo(
+    () => manager.getLayoutStorageKey(),
+    [manager, selectedPresetId]
+  );
+  const getSelectedPreset = useCallback(
+    () => manager.getSelectedPreset(),
+    [manager]
+  );
+  const hasPersistedLayout = useCallback(
+    () => manager.hasPersistedLayout(),
+    [manager]
+  );
+  return useMemo(
+    () => ({
+      presets: manager.presets,
+      selectedPresetId,
+      setSelectedPresetId,
+      layoutStorageKey,
+      reset,
+      getSelectedPreset,
+      hasPersistedLayout
+    }),
+    [
+      manager,
+      selectedPresetId,
+      setSelectedPresetId,
+      layoutStorageKey,
+      reset,
+      getSelectedPreset,
+      hasPersistedLayout
+    ]
+  );
+}
+
+// src/utils/strategyResolver.ts
+function resolveStrategy(options) {
+  const { preferredId, availableStrategies, defaultStrategy } = options;
+  if (preferredId) {
+    const preferred = availableStrategies.find((s) => s.id === preferredId);
+    if (preferred) {
+      return { strategy: preferred, id: preferredId };
+    }
+  }
+  if (defaultStrategy) {
+    return { strategy: defaultStrategy, id: defaultStrategy.id };
+  }
+  if (availableStrategies.length > 0) {
+    const first = availableStrategies[0];
+    return { strategy: first, id: first.id };
+  }
+  throw new Error(
+    "No layout strategy available. Please ensure at least one strategy is provided."
+  );
+}
+
+// src/utils/LayoutRuleManager.ts
+function hasStorage() {
+  return typeof window !== "undefined" && !!window.localStorage;
+}
+var LayoutRuleManager = class {
+  constructor(presets, options) {
+    this._presets = presets.length > 0 ? [...presets] : [];
+    this.options = { ...options };
+  }
+  /** Whether persistence to localStorage is enabled. */
+  get persist() {
+    return this.options.persist !== false;
+  }
+  /** Read-only preset list. */
+  get presets() {
+    return this._presets;
+  }
+  /**
+   * Reads selected preset id from localStorage (presetIdStorageKey).
+   * When persist is false, returns in-memory selection or first preset.
+   * Validates against presets; falls back to first preset id when missing or invalid.
+   */
+  getSelectedPresetId() {
+    if (this._presets.length === 0) {
+      return "";
+    }
+    if (!this.persist) {
+      return this._selectedId ?? this._presets[0]?.id ?? "";
+    }
+    if (!hasStorage()) {
+      return this._presets[0]?.id ?? "";
+    }
+    try {
+      const stored = window.localStorage.getItem(
+        this.options.presetIdStorageKey
+      );
+      const valid = stored && this._presets.some((p) => p.id === stored) ? stored : this._presets[0]?.id ?? "";
+      return valid;
+    } catch {
+      return this._presets[0]?.id ?? "";
+    }
+  }
+  /**
+   * Writes selected preset id to localStorage (presetIdStorageKey).
+   * When persist is false, only updates in-memory selection.
+   * Validates id exists in presets before writing.
+   */
+  setSelectedPresetId(id) {
+    if (!this._presets.some((p) => p.id === id)) return;
+    if (!this.persist) {
+      this._selectedId = id;
+      return;
+    }
+    if (!hasStorage()) return;
+    try {
+      window.localStorage.setItem(this.options.presetIdStorageKey, id);
+    } catch {
+    }
+  }
+  /** Returns the preset for the currently selected id. */
+  getSelectedPreset() {
+    const id = this.getSelectedPresetId();
+    return this._presets.find((p) => p.id === id);
+  }
+  /**
+   * Storage key for layout persistence for the current preset.
+   * Used by LayoutHost: `${layoutStorageKeyPrefix}_${selectedPresetId}`.
+   */
+  getLayoutStorageKey() {
+    const id = this.getSelectedPresetId();
+    return `${this.options.layoutStorageKeyPrefix}_${id}`;
+  }
+  /**
+   * Clears persisted layout data for the current preset (reset to preset rule).
+   * After this, next load will use getInitialLayout() from preset rule.
+   * No-op when persist is false (nothing to clear).
+   */
+  reset() {
+    if (!this.persist || !hasStorage()) return;
+    try {
+      window.localStorage.removeItem(this.getLayoutStorageKey());
+    } catch {
+    }
+  }
+  /**
+   * Returns whether the current preset has any persisted layout data.
+   * Useful for UI "custom" badge or "Reset to default" visibility.
+   * Returns false when persist is false.
+   */
+  hasPersistedLayout() {
+    if (!this.persist || !hasStorage()) return false;
+    try {
+      const key = this.getLayoutStorageKey();
+      const value = window.localStorage.getItem(key);
+      return value != null && value.length > 0;
+    } catch {
+      return false;
+    }
+  }
+};
+
+export { LayoutHost, LayoutRuleManager, TRADING_PANEL_IDS, getTradingPanelIds, resolveStrategy, useLayoutPersistence, useLayoutRuleManager };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tradingPanelIds.ts","../src/hooks/useLayoutPersistence.ts","../src/LayoutHost.tsx","../src/hooks/useLayoutRuleManager.ts","../src/utils/strategyResolver.ts","../src/utils/LayoutRuleManager.ts"],"names":["useMemo","useEffect","useCallback","useState"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Trading page panel ID constants.\n * Used across layout strategies (split, grid) to identify trading panels.\n * Component mapping happens in the trading package.\n */\nexport const TRADING_PANEL_IDS = {\n  SYMBOL_INFO_BAR: \"symbolInfoBar\",\n  TRADING_VIEW: \"tradingView\",\n  ORDERBOOK: \"orderbook\",\n  DATA_LIST: \"dataList\",\n  ORDER_ENTRY: \"orderEntry\",\n  MARGIN: \"orderEntryMargin\",\n  ASSETS: \"orderEntryAssets\",\n  // MAIN: \"orderEntryMain\",\n  MARKETS: \"markets\",\n  HORIZONTAL_MARKETS: \"horizontalMarkets\",\n} as const;\n\nexport type TradingPanelId =\n  (typeof TRADING_PANEL_IDS)[keyof typeof TRADING_PANEL_IDS];\n\n/**\n * Returns all trading panel IDs from layout-core.\n * Used by layout strategies (split, grid) to derive panel set; component mapping is in trading package.\n */\nexport function getTradingPanelIds(): readonly string[] {\n  return Object.values(TRADING_PANEL_IDS);\n}\n","import { useMemo, useCallback, useRef, useEffect } from \"react\";\nimport type { LayoutModel, LayoutStrategy } from \"../types\";\n\n/**\n * Check if we're in a browser environment with localStorage available\n */\nfunction canUseLocalStorage(): boolean {\n  try {\n    return (\n      typeof window !== \"undefined\" &&\n      typeof window.localStorage !== \"undefined\"\n    );\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Hook for persisting layout state to localStorage\n * @param strategy - The layout strategy being used\n * @param storageKey - localStorage key (optional, if not provided returns undefined)\n * @param dep - Dependency to trigger re-read from storage when it changes\n * @returns Tuple of [currentLayout, setLayout]\n */\nexport function useLayoutPersistence<TLayout extends LayoutModel>(\n  strategy: LayoutStrategy<TLayout>,\n  storageKey?: string,\n  dep?: unknown,\n): [TLayout | undefined, (layout: TLayout) => void] {\n  // Debounce timer ref\n  const debounceTimerRef = useRef<ReturnType<typeof setTimeout> | null>(null);\n\n  const layout = useMemo(() => {\n    if (!storageKey || !canUseLocalStorage()) {\n      return undefined;\n    }\n\n    try {\n      const stored = localStorage.getItem(storageKey);\n      if (stored) {\n        return strategy.deserialize(stored);\n      }\n    } catch (error) {\n      console.warn(`Failed to deserialize layout from ${storageKey}:`, error);\n    }\n\n    return undefined;\n  }, [strategy, storageKey, dep]);\n\n  // Cleanup debounce timer on unmount\n  useEffect(() => {\n    return () => {\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n    };\n  }, []);\n\n  // Memoized setLayout with debouncing to avoid excessive writes\n  const setLayout = useCallback(\n    (newLayout: TLayout) => {\n      if (!storageKey || !canUseLocalStorage()) {\n        return;\n      }\n\n      // Clear existing debounce timer\n      if (debounceTimerRef.current) {\n        clearTimeout(debounceTimerRef.current);\n      }\n\n      // Debounce the write operation (100ms)\n      debounceTimerRef.current = setTimeout(() => {\n        try {\n          const serialized = strategy.serialize(newLayout);\n          localStorage.setItem(storageKey, serialized);\n        } catch (error) {\n          console.warn(`Failed to serialize layout to ${storageKey}:`, error);\n        }\n      }, 100);\n    },\n    [strategy, storageKey],\n  );\n\n  return [layout, setLayout];\n}\n","import React, { useMemo, useState, useEffect, useCallback } from \"react\";\nimport { useLayoutPersistence } from \"./hooks/useLayoutPersistence\";\nimport type {\n  LayoutHostProps,\n  LayoutModel,\n  PanelRegistry,\n  PanelRegistryEntry,\n} from \"./types\";\n\n/**\n * Check if a value is a Map instance (handles cross-realm scenarios)\n */\nfunction isMap(value: unknown): value is Map<string, PanelRegistryEntry> {\n  return (\n    value !== null &&\n    typeof value === \"object\" &&\n    typeof (value as Map<string, PanelRegistryEntry>).get === \"function\" &&\n    typeof (value as Map<string, PanelRegistryEntry>).keys === \"function\"\n  );\n}\n\n/**\n * LayoutHost component\n * Provides a unified interface for rendering layouts using any strategy\n *\n * @example\n * ```tsx\n * <LayoutHost\n *   strategy={splitStrategy}\n *   panels={panelMap}\n *   storageKey=\"my_layout_state\"\n *   onLayoutChange={(layout) => console.log('Layout changed', layout)}\n * />\n * ```\n */\nexport function LayoutHost<TLayout extends LayoutModel = LayoutModel>(\n  props: LayoutHostProps<TLayout>,\n) {\n  const {\n    strategy,\n    panels: panelsInput,\n    initialLayout,\n    onLayoutChange,\n    storageKey,\n    className,\n    style,\n  } = props;\n\n  // Convert panels input to PanelRegistry (Map)\n  // Uses duck-typing check for cross-realm compatibility\n  const panels: PanelRegistry = useMemo(() => {\n    if (isMap(panelsInput)) {\n      return panelsInput;\n    }\n    // Convert Record to Map\n    const map = new Map<string, PanelRegistryEntry>();\n    Object.entries(panelsInput).forEach(([id, entry]) => {\n      // Handle both old format (ReactNode) and new format (PanelRegistryEntry)\n      if (entry && typeof entry === \"object\" && \"node\" in entry) {\n        map.set(id, entry as PanelRegistryEntry);\n      } else {\n        map.set(id, { node: entry as React.ReactNode, props: {} });\n      }\n    });\n    return map;\n  }, [panelsInput]);\n\n  // Get panel IDs from registry\n  const panelIds = useMemo(() => Array.from(panels.keys()), [panels]);\n\n  // Initialize layout state from persistence\n  const [persistedLayout, setPersistedLayout] = useLayoutPersistence(\n    strategy,\n    storageKey,\n    strategy.id, // Re-read when strategy changes\n  );\n\n  // Compute the resolved layout: persisted > initial > default\n  const resolvedLayout = useMemo<TLayout>(() => {\n    if (persistedLayout) {\n      return persistedLayout;\n    }\n    if (initialLayout) {\n      return initialLayout;\n    }\n    return strategy.defaultLayout(panelIds) as TLayout;\n  }, [persistedLayout, initialLayout, strategy, panelIds]);\n\n  // Internal layout state - initialized with resolved layout\n  const [currentLayout, setCurrentLayout] = useState<TLayout>(resolvedLayout);\n\n  // Sync when resolved layout changes (strategy switch, initial load, etc.)\n  useEffect(() => {\n    setCurrentLayout(resolvedLayout);\n  }, [resolvedLayout]);\n\n  // Handle layout changes - only updates internal state, no persistence\n  const handleLayoutChange = useCallback(\n    (newLayout: TLayout) => {\n      setCurrentLayout(newLayout);\n      // Notify parent\n      onLayoutChange?.(newLayout);\n    },\n    [onLayoutChange],\n  );\n\n  // Handle layout persist - persists layout to storage\n  const handleLayoutPersist = useCallback(\n    (newLayout: TLayout) => {\n      // Persist if storage key is provided\n      if (storageKey) {\n        setPersistedLayout(newLayout);\n      }\n    },\n    [storageKey, setPersistedLayout],\n  );\n\n  // Get the Renderer component from strategy\n  const Renderer = strategy.Renderer;\n\n  // Handle empty panels case\n  if (panels.size === 0) {\n    return (\n      <div className={className} style={style}>\n        {/* Empty state - no panels registered */}\n      </div>\n    );\n  }\n\n  return (\n    <Renderer\n      layout={currentLayout}\n      panels={panels}\n      onLayoutChange={handleLayoutChange}\n      onLayoutPersist={handleLayoutPersist}\n      className={className}\n      style={style}\n    />\n  );\n}\n","/**\n * @file useLayoutRuleManager.ts\n * @description React hook that syncs LayoutRuleManager with component state for presets, selection, and reset.\n */\nimport { useCallback, useEffect, useMemo, useState } from \"react\";\nimport type {\n  LayoutPreset,\n  LayoutRuleManager,\n} from \"../utils/LayoutRuleManager\";\n\nexport interface UseLayoutRuleManagerResult<TRule> {\n  presets: readonly LayoutPreset<TRule>[];\n  selectedPresetId: string;\n  setSelectedPresetId: (id: string) => void;\n  layoutStorageKey: string;\n  reset: () => void;\n  getSelectedPreset: () => LayoutPreset<TRule> | undefined;\n  hasPersistedLayout: () => boolean;\n}\n\n/**\n * Binds a LayoutRuleManager to React state so selection and reset trigger re-renders.\n * setSelectedPresetId updates both the manager (localStorage) and local state.\n *\n * @param manager - LayoutRuleManager instance (e.g. from LayoutRuleManager<SplitLayoutRule>)\n * @returns Presets, selectedPresetId, setSelectedPresetId, layoutStorageKey, reset, getSelectedPreset, hasPersistedLayout\n */\nexport function useLayoutRuleManager<TRule>(\n  manager: LayoutRuleManager<TRule>,\n): UseLayoutRuleManagerResult<TRule> {\n  const [selectedPresetId, setSelectedPresetIdState] = useState<string>(() =>\n    manager.getSelectedPresetId(),\n  );\n\n  /** Sync state when manager instance changes (e.g. presets changed). */\n  useEffect(() => {\n    setSelectedPresetIdState(manager.getSelectedPresetId());\n  }, [manager]);\n\n  const setSelectedPresetId = useCallback(\n    (id: string) => {\n      manager.setSelectedPresetId(id);\n      setSelectedPresetIdState(id);\n    },\n    [manager],\n  );\n\n  const reset = useCallback(() => {\n    manager.reset();\n    // Optionally force re-read selected id (no change) so consumers can react to reset\n    setSelectedPresetIdState((prev) => prev);\n  }, [manager]);\n\n  const layoutStorageKey = useMemo(\n    () => manager.getLayoutStorageKey(),\n    [manager, selectedPresetId],\n  );\n\n  const getSelectedPreset = useCallback(\n    () => manager.getSelectedPreset(),\n    [manager],\n  );\n\n  const hasPersistedLayout = useCallback(\n    () => manager.hasPersistedLayout(),\n    [manager],\n  );\n\n  return useMemo(\n    () => ({\n      presets: manager.presets,\n      selectedPresetId,\n      setSelectedPresetId,\n      layoutStorageKey,\n      reset,\n      getSelectedPreset,\n      hasPersistedLayout,\n    }),\n    [\n      manager,\n      selectedPresetId,\n      setSelectedPresetId,\n      layoutStorageKey,\n      reset,\n      getSelectedPreset,\n      hasPersistedLayout,\n    ],\n  );\n}\n","import type { LayoutStrategy, StrategyResolverOptions } from \"../types\";\n\n/**\n * Resolve which strategy to use based on preferred ID and available strategies\n * Ensures we always return a valid strategy, falling back to default if preferred is not available\n *\n * @param options - Resolver options\n * @returns Resolved strategy and its ID\n */\nexport function resolveStrategy(options: StrategyResolverOptions): {\n  strategy: LayoutStrategy;\n  id: string;\n} {\n  const { preferredId, availableStrategies, defaultStrategy } = options;\n\n  // If preferred ID is provided, try to find it\n  if (preferredId) {\n    const preferred = availableStrategies.find((s) => s.id === preferredId);\n    if (preferred) {\n      return { strategy: preferred, id: preferredId };\n    }\n  }\n\n  // Fall back to default strategy if provided\n  if (defaultStrategy) {\n    return { strategy: defaultStrategy, id: defaultStrategy.id };\n  }\n\n  // Fall back to first available strategy\n  if (availableStrategies.length > 0) {\n    const first = availableStrategies[0];\n    return { strategy: first, id: first.id };\n  }\n\n  // This should never happen if strategies are properly set up\n  throw new Error(\n    \"No layout strategy available. Please ensure at least one strategy is provided.\",\n  );\n}\n","/** SSR-safe check for localStorage availability. */\nfunction hasStorage(): boolean {\n  return typeof window !== \"undefined\" && !!window.localStorage;\n}\n\n/**\n * Generic preset shape: id, name, and strategy-specific rule.\n */\nexport interface LayoutPreset<TRule = unknown> {\n  id: string;\n  name: string;\n  rule: TRule;\n}\n\n/**\n * Storage key configuration per strategy (split vs grid use different keys).\n */\nexport interface LayoutRuleManagerOptions {\n  /** localStorage key for persisting the selected preset id. */\n  presetIdStorageKey: string;\n  /** Base key for layout persistence; actual key is `${layoutStorageKeyPrefix}_${presetId}`. */\n  layoutStorageKeyPrefix: string;\n  /**\n   * When false, no localStorage read/write; preset selection kept in memory only.\n   * Default true for backward compatibility.\n   */\n  persist?: boolean;\n}\n\n/**\n * Manages layout presets, selected preset persistence, and reset.\n * Persistence of the user-selected rule (preset id) is done via presetIdStorageKey.\n * When persist is false, selection is kept in memory only (no localStorage).\n */\nexport class LayoutRuleManager<TRule = unknown> {\n  private readonly _presets: readonly LayoutPreset<TRule>[];\n  private readonly options: LayoutRuleManagerOptions;\n  /** In-memory selected preset id when persist is false. */\n  private _selectedId?: string;\n\n  constructor(\n    presets: LayoutPreset<TRule>[],\n    options: LayoutRuleManagerOptions,\n  ) {\n    this._presets = presets.length > 0 ? [...presets] : [];\n    this.options = { ...options };\n  }\n\n  /** Whether persistence to localStorage is enabled. */\n  private get persist(): boolean {\n    return this.options.persist !== false;\n  }\n\n  /** Read-only preset list. */\n  get presets(): readonly LayoutPreset<TRule>[] {\n    return this._presets;\n  }\n\n  /**\n   * Reads selected preset id from localStorage (presetIdStorageKey).\n   * When persist is false, returns in-memory selection or first preset.\n   * Validates against presets; falls back to first preset id when missing or invalid.\n   */\n  getSelectedPresetId(): string {\n    if (this._presets.length === 0) {\n      return \"\";\n    }\n    if (!this.persist) {\n      return this._selectedId ?? this._presets[0]?.id ?? \"\";\n    }\n    if (!hasStorage()) {\n      return this._presets[0]?.id ?? \"\";\n    }\n    try {\n      const stored = window.localStorage.getItem(\n        this.options.presetIdStorageKey,\n      );\n      const valid =\n        stored && this._presets.some((p) => p.id === stored)\n          ? stored\n          : (this._presets[0]?.id ?? \"\");\n      return valid;\n    } catch {\n      return this._presets[0]?.id ?? \"\";\n    }\n  }\n\n  /**\n   * Writes selected preset id to localStorage (presetIdStorageKey).\n   * When persist is false, only updates in-memory selection.\n   * Validates id exists in presets before writing.\n   */\n  setSelectedPresetId(id: string): void {\n    if (!this._presets.some((p) => p.id === id)) return;\n    if (!this.persist) {\n      this._selectedId = id;\n      return;\n    }\n    if (!hasStorage()) return;\n    try {\n      window.localStorage.setItem(this.options.presetIdStorageKey, id);\n    } catch {\n      // ignore\n    }\n  }\n\n  /** Returns the preset for the currently selected id. */\n  getSelectedPreset(): LayoutPreset<TRule> | undefined {\n    const id = this.getSelectedPresetId();\n    return this._presets.find((p) => p.id === id);\n  }\n\n  /**\n   * Storage key for layout persistence for the current preset.\n   * Used by LayoutHost: `${layoutStorageKeyPrefix}_${selectedPresetId}`.\n   */\n  getLayoutStorageKey(): string {\n    const id = this.getSelectedPresetId();\n    return `${this.options.layoutStorageKeyPrefix}_${id}`;\n  }\n\n  /**\n   * Clears persisted layout data for the current preset (reset to preset rule).\n   * After this, next load will use getInitialLayout() from preset rule.\n   * No-op when persist is false (nothing to clear).\n   */\n  reset(): void {\n    if (!this.persist || !hasStorage()) return;\n    try {\n      window.localStorage.removeItem(this.getLayoutStorageKey());\n    } catch {\n      // ignore\n    }\n  }\n\n  /**\n   * Returns whether the current preset has any persisted layout data.\n   * Useful for UI \"custom\" badge or \"Reset to default\" visibility.\n   * Returns false when persist is false.\n   */\n  hasPersistedLayout(): boolean {\n    if (!this.persist || !hasStorage()) return false;\n    try {\n      const key = this.getLayoutStorageKey();\n      const value = window.localStorage.getItem(key);\n      return value != null && value.length > 0;\n    } catch {\n      return false;\n    }\n  }\n}\n"]}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@kodiak-finance/orderly-layout-core",
+  "version": "2.9.1",
+  "description": "Core layout strategy protocol and runtime glue for Orderly layout system",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "keywords": [
+    "Orderly",
+    "Layout",
+    "Strategy"
+  ],
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "@types/react": "^18.3.2",
+    "@types/react-dom": "^18.3.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "tsup": "^8.5.1",
+    "typescript": "^5.1.6",
+    "tsconfig": "0.11.34-alpha.0"
+  },
+  "peerDependencies": {
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "tsup",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}