@luxalgo/vela 0.5.1 → 0.5.2

package/dist/{plugin-TN3n-9YN.d.ts → plugin-CnNd7cuF.d.ts}

@@ -1,9 +1,9 @@
-import { u as DrawingTypeKey, a3 as DrawingStyle, S as SerializedDrawing, D as Drawing, av as SeriesKind, O as OHLCV, c as VelaTheme } from './options-DbQholFV.js';
-import { b as DataControl } from './contributions-6N0rbrPC.js';
+import { u as DrawingTypeKey, a4 as DrawingStyle, S as SerializedDrawing, D as Drawing, aw as SeriesKind, O as OHLCV, c as VelaTheme } from './options-XTBpbx0s.js';
+import { b as DataControl } from './contributions-b6AVrqqG.js';
 import './side-panel-CT9ZwIGz.js';
 import './icons-BZYbJXSV.js';
 import './keymap-CGOz5F5f.js';
-import './DataProvider-DGesjOJT.js';
+import './DataProvider-DTOEXKTI.js';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {
@@ -208,7 +208,11 @@ interface SeriesDataEngine {
         from: number;
         to: number;
     }): void;
-    /** New settings values from the chart-settings dialog (the type's SDK section). */
+    /** New settings values from the chart-settings dialog (the type's SDK section).
+     *  Also delivered once just BEFORE `start()` whenever stored values exist (a
+     *  persisted config, a market switch recreating the engine) — an engine must
+     *  accept a pre-start call as pure configuration, so it never fetches on
+     *  schema defaults the user has edited away. */
     onSettings?(values: Record<string, unknown>): void;
 }
 /** One registered chart type. */
@@ -265,32 +269,126 @@ interface SettingsRowSwatch {
     /** Names the color for the swatch's tooltip (`'Highlight color'`). */
     label: string;
     defval: string;
+    /**
+     * Optional visibility gate, evaluated live against the values bag exactly like a
+     * row's own `when` — lets one toggle row swap its swatch set as another value
+     * changes (a mode's two colors while it is on, its one alternative while off).
+     * A gated swatch is EXEMPT from the toggle-off dim: its gate already says when
+     * it matters, and it may exist specifically for the off state.
+     */
+    when?: SettingsRowWhen;
+}
+/**
+ * An inline LINE-WIDTH dropdown on a toggle row — sits beside the row's color
+ * swatches (dimmed with them while the toggle is off) and stores a px number under
+ * its own bag key. The control offers the classic drawing-bar weights (1–5 px),
+ * each option previewed as a line at that weight.
+ */
+interface SettingsRowWidth {
+    key: string;
+    /** Names the control for its tooltip (`'Line width'`). */
+    label: string;
+    defval: number;
+}
+/**
+ * An inline NUMBER input on a toggle row — sits AHEAD of the row's color swatches
+ * (dimmed with them while the toggle is off) and stores a number under its own bag
+ * key. For the one value the toggle governs (a percent, a count) — the declarative
+ * alternative to a separate `number` row gated on the toggle.
+ */
+interface SettingsRowInlineNumber {
+    key: string;
+    /** Names the input for its tooltip (`'Value area (%)'`). */
+    label: string;
+    defval: number;
+    min?: number;
+    max?: number;
+    step?: number;
 }
 /**
- * One declarative settings row. To add a NEW kind, see docs/architecture/settings-rows.md.
+ * A select option: a bare string (value = label) or a `[value, label]` pair when the
+ * stored id differs from the human-readable text (`['bidAskProfile', 'Bid × Ask Profile']`).
+ */
+type SettingsSelectOption = string | readonly [value: string, label: string];
+/**
+ * One INLINE CONTROL on a composite `row` — the composable unit every value row is
+ * made of. Each keyed control stores under its own bag key; `label` names it for the
+ * control's tooltip. A control may carry its own `when` gate (same shape as a row's),
+ * evaluated live against the values bag: a gated control appears/disappears as other
+ * values change, and is EXEMPT from the row's toggle-off dim — its gate already says
+ * when it matters, and it may exist specifically for the off state.
+ *
+ * - `number` — a compact number input. With `placeholder`, an input at the default
+ *   value renders EMPTY showing it, and clearing the input stores the default back —
+ *   the placeholder names the "unset" state (`'Off'` for a 0-disables bound).
+ * - `color` — a color swatch opening the shared color picker.
+ * - `width` — a line-width dropdown (the classic drawing-bar 1–5 px weights, each
+ *   option previewed as a line at that weight), storing a px number.
+ * - `select` — a dropdown over {@link SettingsSelectOption}s.
+ * - `hint` — display-only dimmed text between controls (the `–` of a min–max pair,
+ *   a unit); stores nothing.
+ */
+type SettingsInlineControl = {
+    kind: 'number';
+    key: string;
+    label: string;
+    defval: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    placeholder?: string;
+    when?: SettingsRowWhen;
+} | {
+    kind: 'color';
+    key: string;
+    label: string;
+    defval: string;
+    when?: SettingsRowWhen;
+} | {
+    kind: 'width';
+    key: string;
+    label: string;
+    defval: number;
+    when?: SettingsRowWhen;
+} | {
+    kind: 'select';
+    key: string;
+    label: string;
+    options: readonly SettingsSelectOption[];
+    defval: string;
+    when?: SettingsRowWhen;
+} | {
+    kind: 'hint';
+    text: string;
+};
+/**
+ * One declarative settings row. To add a NEW inline control kind, see
+ * docs/architecture/settings-rows.md.
  *
  * `heading` titles a GROUP of rows: the heading plus everything after it up to the next
  * heading. In a flat `rows` section headings render as inline group titles; inside
- * `instances`/`subsections` they become entries of the pane's group TOC (see
- * {@link ChartTypeSettingsSection}).
+ * `instances`/`subsections` (or a `layout: 'grouped'` section) they become entries of
+ * the pane's group TOC (see {@link ChartTypeSettingsSection}).
  *
  * `header` is an in-pane subgroup title: same visual as a flat heading, but inside a
  * structured pane it stays in the rows column (does NOT become a TOC entry). Use it to
  * cluster rows inside a TOC group (e.g. Colors / Values under Display).
  *
- * Any row may carry `when` — it is shown only while the condition holds.
+ * `row` is the COMPOSITE form every value row reduces to: a label, an optional leading
+ * `toggle` (a checkbox storing a boolean under `toggle.key`; while off, the row's
+ * controls dim and ignore input), and an ordered list of {@link SettingsInlineControl}s
+ * in the control column. Any mix of control kinds in any order — no per-combination
+ * SDK surface.
  *
- * `range` is a min–max pair on one row (two number inputs storing under `minKey` /
- * `maxKey`, both seeded from the shared `defval`). When `placeholder` is given, an
- * input holding the default value renders EMPTY showing the placeholder, and clearing
- * an input stores the default back — so the placeholder names the "unset" state
- * (`'Off'` for a 0-disables filter bound).
- */
-/**
- * A select option: a bare string (value = label) or a `[value, label]` pair when the
- * stored id differs from the human-readable text (`['bidAskProfile', 'Bid × Ask Profile']`).
+ * The remaining kinds are SUGAR over `row` (see {@link normalizeSettingsRow}):
+ * - `toggle` — a checkbox row; optional inline `number`, color `colors`, and `width`
+ *   attachments render in that order.
+ * - `number` / `color` / `select` — one control on its own row.
+ * - `range` — a min–max pair (two number inputs under `minKey`/`maxKey`, both seeded
+ *   from the shared `defval`, with `placeholder` naming the unset state).
+ *
+ * Any row may carry `when` — it is shown only while the condition holds.
  */
-type SettingsSelectOption = string | readonly [value: string, label: string];
 type SettingsRowDescriptor = {
     kind: 'heading';
     label: string;
@@ -299,12 +397,23 @@ type SettingsRowDescriptor = {
     kind: 'header';
     label: string;
     when?: SettingsRowWhen;
+} | {
+    kind: 'row';
+    label: string;
+    toggle?: {
+        key: string;
+        defval: boolean;
+    };
+    controls: readonly SettingsInlineControl[];
+    when?: SettingsRowWhen;
 } | {
     kind: 'toggle';
     key: string;
     label: string;
     defval: boolean;
+    number?: SettingsRowInlineNumber;
     colors?: readonly SettingsRowSwatch[];
+    width?: SettingsRowWidth;
     when?: SettingsRowWhen;
 } | {
     kind: 'number';
@@ -340,6 +449,39 @@ type SettingsRowDescriptor = {
     placeholder?: string;
     when?: SettingsRowWhen;
 };
+/** A value-carrying row (everything except the key-less `heading`/`header` titles). */
+type SettingsValueRow = Exclude<SettingsRowDescriptor, {
+    kind: 'heading' | 'header';
+}>;
+/** The canonical row shape every {@link SettingsValueRow} reduces to (the `row` kind's fields). */
+interface NormalizedSettingsRow {
+    label: string;
+    toggle?: {
+        key: string;
+        defval: boolean;
+    };
+    controls: readonly SettingsInlineControl[];
+    when?: SettingsRowWhen;
+}
+/**
+ * Reduce a value row to the canonical composite shape — the ONE contract view layers
+ * render and the persistence layer enumerates. The sugar kinds map exactly onto their
+ * historical rendering: `toggle` attachments in number → colors → width order, `range`
+ * as two number controls around a `–` hint (placeholder semantics preserved).
+ */
+declare function normalizeSettingsRow(r: SettingsValueRow): NormalizedSettingsRow;
+/** One value a settings row stores: its bag key, runtime type, and registry default. */
+interface SettingsRowValueKey {
+    key: string;
+    type: 'boolean' | 'number' | 'string';
+    defval: boolean | number | string;
+}
+/**
+ * EVERY key a row stores (toggle key + each keyed inline control), with its expected
+ * type and default — the single enumeration the dialog seeds from and the factory
+ * reset restores, so no key can fall through a kind-specific walk.
+ */
+declare function settingsRowValueKeys(r: SettingsRowDescriptor): SettingsRowValueKey[];
 /**
  * One tab of a section's INSTANCE STRIP — a repeated block of settings (e.g. one of
  * several overlays a style can paint). The dialog shows a tab per PRESENT instance,
@@ -370,14 +512,15 @@ interface ChartTypeSettingsSubsection {
  * A chart type's settings tab. Two forms:
  *
  * - **Flat**: `rows` only — rendered as one scrollable pane, `heading` rows as inline
- *   group titles (the historical form).
+ *   group titles (the historical form). `layout: 'grouped'` upgrades the same rows to
+ *   the GROUP TOC presentation (below) without declaring an instance strip.
  * - **Structured**: `instances` (and optionally `subsections`) — the pane opens with an
  *   instance TAB STRIP, and each instance's rows are organized by a GROUP TOC on the
- *   left built from its `heading` rows (rows before the first heading always show above
- *   the groups; selecting a TOC entry shows only that group's rows). `subsections` add
- *   indented rail entries under the section's tab, each a pane with the same TOC
- *   treatment. A TOC entry hides itself while every row of its group is hidden by
- *   `when` gates.
+ *   left of the pane (right of the dialog's tab rail) built from its `heading` rows
+ *   (rows before the first heading always show above the groups; selecting a TOC entry
+ *   shows only that group's rows). `subsections` add indented rail entries under the
+ *   section's tab, each a pane with the same TOC treatment. A TOC entry hides itself
+ *   while every row of its group is hidden by `when` gates.
  *
  * All values — every instance and subsection included — live in the ONE per-type bag
  * (`config.chartTypes[<id>]`), so consumers keep receiving a single flat object.
@@ -387,6 +530,10 @@ interface ChartTypeSettingsSection {
     title: string;
     /** Flat form. Ignored when `instances` is declared. */
     rows?: readonly SettingsRowDescriptor[];
+    /** How `rows` are presented: `'flat'` (default) renders headings as inline group
+     *  titles; `'grouped'` promotes them to a group TOC beside the rows (the structured
+     *  pane's presentation, without an instance strip). Ignored with `instances`. */
+    layout?: 'flat' | 'grouped';
     /** Structured form: the pane's instance tab strip. */
     instances?: readonly ChartTypeSettingsInstance[];
     /** Indented sub-entries under this section's rail tab. */
@@ -552,4 +699,4 @@ declare const CATEGORICAL: readonly string[];
 /** Pick a stable categorical color for a string key (same key ⇒ same color). */
 declare function categoricalColor(key: string): string;
 
-export { stableSeriesId as $, ACCENT as A, BEARISH as B, CATEGORICAL as C, type DrawingTypeMeta as D, TRADE_SHORT as E, categoricalColor as F, chartType as G, HIGHLIGHT as H, INFO as I, chartTypes as J, createDrawing as K, deserializeDrawing as L, MARKER as M, NEUTRAL as N, drawingTypes as O, getDrawingType as P, registerChartType as Q, type RendererLayerArgs as R, SERIES_LINE as S, TRADE_EXIT as T, registerDrawingType as U, VALID as V, WARNING as W, registerRendererDefaults as X, registerRendererLayer as Y, rendererDefaults as Z, rendererLayers as _, ACCENT_BRIGHT as a, tickerModifierIds as a0, unregisterChartType as a1, unregisterRendererDefaults as a2, unregisterRendererLayer as a3, BULLISH as b, type BarTransform as c, type BasePaintingModulation as d, CROSSHAIR as e, type ChartTypeDefinition as f, type ChartTypeSettingsInstance as g, type ChartTypeSettingsSection as h, type ChartTypeSettingsSubsection as i, INVALID as j, type IdentifiableKind as k, type RendererLayerDefinition as l, type RendererLayerInstance as m, SESSION_OFF as n, SESSION_POST as o, SESSION_PRE as p, SLATE as q, SLATE_DEEP as r, type SeriesDataEngine as s, type SeriesDataEngineHost as t, type SettingsRowCondition as u, type SettingsRowDescriptor as v, type SettingsRowSwatch as w, type SettingsRowWhen as x, type SettingsSelectOption as y, TRADE_LONG as z };
+export { normalizeSettingsRow as $, ACCENT as A, BEARISH as B, CATEGORICAL as C, type DrawingTypeMeta as D, type SettingsRowValueKey as E, type SettingsRowWhen as F, type SettingsRowWidth as G, HIGHLIGHT as H, INFO as I, type SettingsSelectOption as J, type SettingsValueRow as K, TRADE_LONG as L, MARKER as M, NEUTRAL as N, TRADE_SHORT as O, categoricalColor as P, chartType as Q, type RendererLayerArgs as R, SERIES_LINE as S, TRADE_EXIT as T, chartTypes as U, VALID as V, WARNING as W, createDrawing as X, deserializeDrawing as Y, drawingTypes as Z, getDrawingType as _, ACCENT_BRIGHT as a, registerChartType as a0, registerDrawingType as a1, registerRendererDefaults as a2, registerRendererLayer as a3, rendererDefaults as a4, rendererLayers as a5, settingsRowValueKeys as a6, stableSeriesId as a7, tickerModifierIds as a8, unregisterChartType as a9, unregisterRendererDefaults as aa, unregisterRendererLayer as ab, BULLISH as b, type BarTransform as c, type BasePaintingModulation as d, CROSSHAIR as e, type ChartTypeDefinition as f, type ChartTypeSettingsInstance as g, type ChartTypeSettingsSection as h, type ChartTypeSettingsSubsection as i, INVALID as j, type IdentifiableKind as k, type NormalizedSettingsRow as l, type RendererLayerDefinition as m, type RendererLayerInstance as n, SESSION_OFF as o, SESSION_POST as p, SESSION_PRE as q, SLATE as r, SLATE_DEEP as s, type SeriesDataEngine as t, type SeriesDataEngineHost as u, type SettingsInlineControl as v, type SettingsRowCondition as w, type SettingsRowDescriptor as x, type SettingsRowInlineNumber as y, type SettingsRowSwatch as z };

package/dist/{plugin-O34MbXf-.d.cts → plugin-DfH4Y-Om.d.cts}

@@ -1,9 +1,9 @@
-import { u as DrawingTypeKey, a3 as DrawingStyle, S as SerializedDrawing, D as Drawing, av as SeriesKind, O as OHLCV, c as VelaTheme } from './options-DbQholFV.cjs';
-import { b as DataControl } from './contributions-BlV3kb0O.cjs';
+import { u as DrawingTypeKey, a4 as DrawingStyle, S as SerializedDrawing, D as Drawing, aw as SeriesKind, O as OHLCV, c as VelaTheme } from './options-XTBpbx0s.cjs';
+import { b as DataControl } from './contributions-Ci_i3IN2.cjs';
 import './side-panel-CT9ZwIGz.cjs';
 import './icons-BZYbJXSV.cjs';
 import './keymap-CGOz5F5f.cjs';
-import './DataProvider-BBQ3Hr21.cjs';
+import './DataProvider-gnzv-dgc.cjs';
 
 /** What a drawing type contributes to the toolbar + factory (renderer-neutral). */
 interface DrawingTypeMeta {
@@ -208,7 +208,11 @@ interface SeriesDataEngine {
         from: number;
         to: number;
     }): void;
-    /** New settings values from the chart-settings dialog (the type's SDK section). */
+    /** New settings values from the chart-settings dialog (the type's SDK section).
+     *  Also delivered once just BEFORE `start()` whenever stored values exist (a
+     *  persisted config, a market switch recreating the engine) — an engine must
+     *  accept a pre-start call as pure configuration, so it never fetches on
+     *  schema defaults the user has edited away. */
     onSettings?(values: Record<string, unknown>): void;
 }
 /** One registered chart type. */
@@ -265,32 +269,126 @@ interface SettingsRowSwatch {
     /** Names the color for the swatch's tooltip (`'Highlight color'`). */
     label: string;
     defval: string;
+    /**
+     * Optional visibility gate, evaluated live against the values bag exactly like a
+     * row's own `when` — lets one toggle row swap its swatch set as another value
+     * changes (a mode's two colors while it is on, its one alternative while off).
+     * A gated swatch is EXEMPT from the toggle-off dim: its gate already says when
+     * it matters, and it may exist specifically for the off state.
+     */
+    when?: SettingsRowWhen;
+}
+/**
+ * An inline LINE-WIDTH dropdown on a toggle row — sits beside the row's color
+ * swatches (dimmed with them while the toggle is off) and stores a px number under
+ * its own bag key. The control offers the classic drawing-bar weights (1–5 px),
+ * each option previewed as a line at that weight.
+ */
+interface SettingsRowWidth {
+    key: string;
+    /** Names the control for its tooltip (`'Line width'`). */
+    label: string;
+    defval: number;
+}
+/**
+ * An inline NUMBER input on a toggle row — sits AHEAD of the row's color swatches
+ * (dimmed with them while the toggle is off) and stores a number under its own bag
+ * key. For the one value the toggle governs (a percent, a count) — the declarative
+ * alternative to a separate `number` row gated on the toggle.
+ */
+interface SettingsRowInlineNumber {
+    key: string;
+    /** Names the input for its tooltip (`'Value area (%)'`). */
+    label: string;
+    defval: number;
+    min?: number;
+    max?: number;
+    step?: number;
 }
 /**
- * One declarative settings row. To add a NEW kind, see docs/architecture/settings-rows.md.
+ * A select option: a bare string (value = label) or a `[value, label]` pair when the
+ * stored id differs from the human-readable text (`['bidAskProfile', 'Bid × Ask Profile']`).
+ */
+type SettingsSelectOption = string | readonly [value: string, label: string];
+/**
+ * One INLINE CONTROL on a composite `row` — the composable unit every value row is
+ * made of. Each keyed control stores under its own bag key; `label` names it for the
+ * control's tooltip. A control may carry its own `when` gate (same shape as a row's),
+ * evaluated live against the values bag: a gated control appears/disappears as other
+ * values change, and is EXEMPT from the row's toggle-off dim — its gate already says
+ * when it matters, and it may exist specifically for the off state.
+ *
+ * - `number` — a compact number input. With `placeholder`, an input at the default
+ *   value renders EMPTY showing it, and clearing the input stores the default back —
+ *   the placeholder names the "unset" state (`'Off'` for a 0-disables bound).
+ * - `color` — a color swatch opening the shared color picker.
+ * - `width` — a line-width dropdown (the classic drawing-bar 1–5 px weights, each
+ *   option previewed as a line at that weight), storing a px number.
+ * - `select` — a dropdown over {@link SettingsSelectOption}s.
+ * - `hint` — display-only dimmed text between controls (the `–` of a min–max pair,
+ *   a unit); stores nothing.
+ */
+type SettingsInlineControl = {
+    kind: 'number';
+    key: string;
+    label: string;
+    defval: number;
+    min?: number;
+    max?: number;
+    step?: number;
+    placeholder?: string;
+    when?: SettingsRowWhen;
+} | {
+    kind: 'color';
+    key: string;
+    label: string;
+    defval: string;
+    when?: SettingsRowWhen;
+} | {
+    kind: 'width';
+    key: string;
+    label: string;
+    defval: number;
+    when?: SettingsRowWhen;
+} | {
+    kind: 'select';
+    key: string;
+    label: string;
+    options: readonly SettingsSelectOption[];
+    defval: string;
+    when?: SettingsRowWhen;
+} | {
+    kind: 'hint';
+    text: string;
+};
+/**
+ * One declarative settings row. To add a NEW inline control kind, see
+ * docs/architecture/settings-rows.md.
  *
  * `heading` titles a GROUP of rows: the heading plus everything after it up to the next
  * heading. In a flat `rows` section headings render as inline group titles; inside
- * `instances`/`subsections` they become entries of the pane's group TOC (see
- * {@link ChartTypeSettingsSection}).
+ * `instances`/`subsections` (or a `layout: 'grouped'` section) they become entries of
+ * the pane's group TOC (see {@link ChartTypeSettingsSection}).
  *
  * `header` is an in-pane subgroup title: same visual as a flat heading, but inside a
  * structured pane it stays in the rows column (does NOT become a TOC entry). Use it to
  * cluster rows inside a TOC group (e.g. Colors / Values under Display).
  *
- * Any row may carry `when` — it is shown only while the condition holds.
+ * `row` is the COMPOSITE form every value row reduces to: a label, an optional leading
+ * `toggle` (a checkbox storing a boolean under `toggle.key`; while off, the row's
+ * controls dim and ignore input), and an ordered list of {@link SettingsInlineControl}s
+ * in the control column. Any mix of control kinds in any order — no per-combination
+ * SDK surface.
  *
- * `range` is a min–max pair on one row (two number inputs storing under `minKey` /
- * `maxKey`, both seeded from the shared `defval`). When `placeholder` is given, an
- * input holding the default value renders EMPTY showing the placeholder, and clearing
- * an input stores the default back — so the placeholder names the "unset" state
- * (`'Off'` for a 0-disables filter bound).
- */
-/**
- * A select option: a bare string (value = label) or a `[value, label]` pair when the
- * stored id differs from the human-readable text (`['bidAskProfile', 'Bid × Ask Profile']`).
+ * The remaining kinds are SUGAR over `row` (see {@link normalizeSettingsRow}):
+ * - `toggle` — a checkbox row; optional inline `number`, color `colors`, and `width`
+ *   attachments render in that order.
+ * - `number` / `color` / `select` — one control on its own row.
+ * - `range` — a min–max pair (two number inputs under `minKey`/`maxKey`, both seeded
+ *   from the shared `defval`, with `placeholder` naming the unset state).
+ *
+ * Any row may carry `when` — it is shown only while the condition holds.
  */
-type SettingsSelectOption = string | readonly [value: string, label: string];
 type SettingsRowDescriptor = {
     kind: 'heading';
     label: string;
@@ -299,12 +397,23 @@ type SettingsRowDescriptor = {
     kind: 'header';
     label: string;
     when?: SettingsRowWhen;
+} | {
+    kind: 'row';
+    label: string;
+    toggle?: {
+        key: string;
+        defval: boolean;
+    };
+    controls: readonly SettingsInlineControl[];
+    when?: SettingsRowWhen;
 } | {
     kind: 'toggle';
     key: string;
     label: string;
     defval: boolean;
+    number?: SettingsRowInlineNumber;
     colors?: readonly SettingsRowSwatch[];
+    width?: SettingsRowWidth;
     when?: SettingsRowWhen;
 } | {
     kind: 'number';
@@ -340,6 +449,39 @@ type SettingsRowDescriptor = {
     placeholder?: string;
     when?: SettingsRowWhen;
 };
+/** A value-carrying row (everything except the key-less `heading`/`header` titles). */
+type SettingsValueRow = Exclude<SettingsRowDescriptor, {
+    kind: 'heading' | 'header';
+}>;
+/** The canonical row shape every {@link SettingsValueRow} reduces to (the `row` kind's fields). */
+interface NormalizedSettingsRow {
+    label: string;
+    toggle?: {
+        key: string;
+        defval: boolean;
+    };
+    controls: readonly SettingsInlineControl[];
+    when?: SettingsRowWhen;
+}
+/**
+ * Reduce a value row to the canonical composite shape — the ONE contract view layers
+ * render and the persistence layer enumerates. The sugar kinds map exactly onto their
+ * historical rendering: `toggle` attachments in number → colors → width order, `range`
+ * as two number controls around a `–` hint (placeholder semantics preserved).
+ */
+declare function normalizeSettingsRow(r: SettingsValueRow): NormalizedSettingsRow;
+/** One value a settings row stores: its bag key, runtime type, and registry default. */
+interface SettingsRowValueKey {
+    key: string;
+    type: 'boolean' | 'number' | 'string';
+    defval: boolean | number | string;
+}
+/**
+ * EVERY key a row stores (toggle key + each keyed inline control), with its expected
+ * type and default — the single enumeration the dialog seeds from and the factory
+ * reset restores, so no key can fall through a kind-specific walk.
+ */
+declare function settingsRowValueKeys(r: SettingsRowDescriptor): SettingsRowValueKey[];
 /**
  * One tab of a section's INSTANCE STRIP — a repeated block of settings (e.g. one of
  * several overlays a style can paint). The dialog shows a tab per PRESENT instance,
@@ -370,14 +512,15 @@ interface ChartTypeSettingsSubsection {
  * A chart type's settings tab. Two forms:
  *
  * - **Flat**: `rows` only — rendered as one scrollable pane, `heading` rows as inline
- *   group titles (the historical form).
+ *   group titles (the historical form). `layout: 'grouped'` upgrades the same rows to
+ *   the GROUP TOC presentation (below) without declaring an instance strip.
  * - **Structured**: `instances` (and optionally `subsections`) — the pane opens with an
  *   instance TAB STRIP, and each instance's rows are organized by a GROUP TOC on the
- *   left built from its `heading` rows (rows before the first heading always show above
- *   the groups; selecting a TOC entry shows only that group's rows). `subsections` add
- *   indented rail entries under the section's tab, each a pane with the same TOC
- *   treatment. A TOC entry hides itself while every row of its group is hidden by
- *   `when` gates.
+ *   left of the pane (right of the dialog's tab rail) built from its `heading` rows
+ *   (rows before the first heading always show above the groups; selecting a TOC entry
+ *   shows only that group's rows). `subsections` add indented rail entries under the
+ *   section's tab, each a pane with the same TOC treatment. A TOC entry hides itself
+ *   while every row of its group is hidden by `when` gates.
  *
  * All values — every instance and subsection included — live in the ONE per-type bag
  * (`config.chartTypes[<id>]`), so consumers keep receiving a single flat object.
@@ -387,6 +530,10 @@ interface ChartTypeSettingsSection {
     title: string;
     /** Flat form. Ignored when `instances` is declared. */
     rows?: readonly SettingsRowDescriptor[];
+    /** How `rows` are presented: `'flat'` (default) renders headings as inline group
+     *  titles; `'grouped'` promotes them to a group TOC beside the rows (the structured
+     *  pane's presentation, without an instance strip). Ignored with `instances`. */
+    layout?: 'flat' | 'grouped';
     /** Structured form: the pane's instance tab strip. */
     instances?: readonly ChartTypeSettingsInstance[];
     /** Indented sub-entries under this section's rail tab. */
@@ -552,4 +699,4 @@ declare const CATEGORICAL: readonly string[];
 /** Pick a stable categorical color for a string key (same key ⇒ same color). */
 declare function categoricalColor(key: string): string;
 
-export { stableSeriesId as $, ACCENT as A, BEARISH as B, CATEGORICAL as C, type DrawingTypeMeta as D, TRADE_SHORT as E, categoricalColor as F, chartType as G, HIGHLIGHT as H, INFO as I, chartTypes as J, createDrawing as K, deserializeDrawing as L, MARKER as M, NEUTRAL as N, drawingTypes as O, getDrawingType as P, registerChartType as Q, type RendererLayerArgs as R, SERIES_LINE as S, TRADE_EXIT as T, registerDrawingType as U, VALID as V, WARNING as W, registerRendererDefaults as X, registerRendererLayer as Y, rendererDefaults as Z, rendererLayers as _, ACCENT_BRIGHT as a, tickerModifierIds as a0, unregisterChartType as a1, unregisterRendererDefaults as a2, unregisterRendererLayer as a3, BULLISH as b, type BarTransform as c, type BasePaintingModulation as d, CROSSHAIR as e, type ChartTypeDefinition as f, type ChartTypeSettingsInstance as g, type ChartTypeSettingsSection as h, type ChartTypeSettingsSubsection as i, INVALID as j, type IdentifiableKind as k, type RendererLayerDefinition as l, type RendererLayerInstance as m, SESSION_OFF as n, SESSION_POST as o, SESSION_PRE as p, SLATE as q, SLATE_DEEP as r, type SeriesDataEngine as s, type SeriesDataEngineHost as t, type SettingsRowCondition as u, type SettingsRowDescriptor as v, type SettingsRowSwatch as w, type SettingsRowWhen as x, type SettingsSelectOption as y, TRADE_LONG as z };
+export { normalizeSettingsRow as $, ACCENT as A, BEARISH as B, CATEGORICAL as C, type DrawingTypeMeta as D, type SettingsRowValueKey as E, type SettingsRowWhen as F, type SettingsRowWidth as G, HIGHLIGHT as H, INFO as I, type SettingsSelectOption as J, type SettingsValueRow as K, TRADE_LONG as L, MARKER as M, NEUTRAL as N, TRADE_SHORT as O, categoricalColor as P, chartType as Q, type RendererLayerArgs as R, SERIES_LINE as S, TRADE_EXIT as T, chartTypes as U, VALID as V, WARNING as W, createDrawing as X, deserializeDrawing as Y, drawingTypes as Z, getDrawingType as _, ACCENT_BRIGHT as a, registerChartType as a0, registerDrawingType as a1, registerRendererDefaults as a2, registerRendererLayer as a3, rendererDefaults as a4, rendererLayers as a5, settingsRowValueKeys as a6, stableSeriesId as a7, tickerModifierIds as a8, unregisterChartType as a9, unregisterRendererDefaults as aa, unregisterRendererLayer as ab, BULLISH as b, type BarTransform as c, type BasePaintingModulation as d, CROSSHAIR as e, type ChartTypeDefinition as f, type ChartTypeSettingsInstance as g, type ChartTypeSettingsSection as h, type ChartTypeSettingsSubsection as i, INVALID as j, type IdentifiableKind as k, type NormalizedSettingsRow as l, type RendererLayerDefinition as m, type RendererLayerInstance as n, SESSION_OFF as o, SESSION_POST as p, SESSION_PRE as q, SLATE as r, SLATE_DEEP as s, type SeriesDataEngine as t, type SeriesDataEngineHost as u, type SettingsInlineControl as v, type SettingsRowCondition as w, type SettingsRowDescriptor as x, type SettingsRowInlineNumber as y, type SettingsRowSwatch as z };