dataface 0.3.2.dev22__py3-none-any.whl → 0.3.2.dev150__py3-none-any.whl

dataface/agent_api/docs/yaml-reference.md

@@ -15,10 +15,10 @@ AuthoredFace (dataface) definition from YAML.
 | `source` | str | ✓ | Default source name for all queries in this face. Inheritable via meta.yaml cascade. |
 | `cache` | [Cache](#cache) | ✓ | Cache policy for every query in this dashboard, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts the whole dashboard out. Inheritable via the meta.yaml cascade. |
 | `variables` | dict[str, [Variable](#variable) \| VariableRef] | ✓ | Variable definitions for dynamic filtering and UI controls. |
-| `queries` | dict[str, [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef] | ✓ | Named query definitions (SQL, CSV, MetricFlow, HTTP, etc.). |
+| `queries` | dict[str, [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef] | ✓ | Named query definitions (SQL, CSV, MetricFlow, HTTP, etc.). |
 | `charts` | dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| ChartRef] | ✓ | Named chart definitions. When no explicit layout is present, charts render as an implicit row layout in authored order. |
-| `rows` | list[str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| [ForeachItem](#foreachitem) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)]] | ✓ | Vertical stack layout: list of chart names or inline chart/face definitions. |
-| `cols` | list[str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| [ForeachItem](#foreachitem) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)]] | ✓ | Horizontal layout: list of chart names or inline chart/face definitions. |
+| `rows` | list[str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)]] | ✓ | Vertical stack layout: list of chart names or inline chart/face definitions. |
+| `cols` | list[str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)]] | ✓ | Horizontal layout: list of chart names or inline chart/face definitions. |
 | `grid` | [GridLayout](#gridlayout) | ✓ | CSS-grid style layout with explicit row/column placement. |
 | `tabs` | [TabLayout](#tablayout) | ✓ | Tabbed navigation layout where each tab contains its own layout. |
 | `card_gap` | bool | ✓ | When True, adds gap between cards. Default: cards are edge-to-edge (0 gap). |
@@ -55,7 +55,7 @@ Variable definition from YAML.
 | `visible` | bool | ✓ | When False, the variable is not rendered in the UI but can still be set via URL params. |
 | `enabled` | bool \| str \| [SingleRowBoolProbe](#singlerowboolprobe) | ✓ | Enable this control. Accepts: static bool; a variable name or Jinja boolean expression string (no {{ }} required — bare names auto-wrap); or a {query, column} form that reads a single boolean cell from a named query. None = enabled. Absent variable in a string expression raises (use a default). |
 | `column` | str | ✓ | Column name in the query result to use as option values. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) | ✓ | Query name or inline query definition for populating options. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) | ✓ | Query name or inline query definition for populating options. |
 | `dimension` | str | ✓ | MetricFlow dimension name for populating options. |
 | `measure` | str | ✓ | MetricFlow measure name for populating options. |
 | `model` | str | ✓ | dbt model name for populating options. |
@@ -159,54 +159,6 @@ dbt source schema query.
 | `table` | str | ✓ | Table name for schema queries. |
 | `column` | str | ✓ | Column name for schema queries. |
 
-<a id="lookmlquery"></a>
-## LookmlQuery
-LookML query rooted at one explore.
-
-| Field | Type | Optional | Description |
-|-------|------|:--------:|-------------|
-| `explore` | str |  | LookML explore name. Presence of this key infers type: lookml. Use a merge query instead to combine multiple sources. |
-| `source` | str \| dict[str, Any] | ✓ | Source name reference, or an inline file path (e.g. `./data/sales.csv`). File paths are detected by `/` or data file extension. An inline connection-bearing dict (`{type: postgres, ...}`) is rejected at compile time — reference a named source instead. |
-| `description` | str | ✓ | Human-readable description of the query. Used by AI search and tooling. |
-| `ignore` | list[str] | ✓ | Diagnostic codes to suppress for this query (e.g., ['WARN-FANOUT-RISK', 'WARN-REAGGREGATION']). |
-| `cache` | [Cache](#cache) | ✓ | Cache policy override for this query, e.g. cache: 5m — refines the policy inherited from the source and project scopes; cache: false opts out of result caching entirely. Queries with cache: false cannot be used as {{ queries.X.cache }} upstream references. |
-| `type` | enum: "lookml" | ✓ | Query adapter type. |
-| `fields` | list[str] | ✓ | Qualified 'view.field' refs to select. Optional at authoring time: collected from chart channels when absent. |
-| `sorts` | list[str] | ✓ | Looker sort clauses, e.g. ['view.field', 'view.other desc']. Lowered to ORDER BY via likeml. |
-| `pivots` | list[str] | ✓ | Qualified 'view.field' refs to pivot on. |
-| `pivots_unwrapped` | bool | ✓ | Which of Looker's two pivot SQL shapes to emit: False/None = wrapped (5-layer DENSE_RANK), True = plain GROUP BY. |
-| `total` | bool | ✓ | Looker grand-totals flag. |
-| `subtotals` | list[str] | ✓ | Dimension refs to subtotal via GROUP BY ROLLUP. |
-| `filter_expression` | str | ✓ | Looker query-level free-form boolean filter over ${view.field} refs. |
-| `dynamic_fields` | list[dict[str, Any]] | ✓ | Looker dynamic fields: custom measures / custom dimensions synthesized into SQL. Table calculations compose as a derived wrapper query, not here. |
-| `limit` | int | ✓ | Maximum number of rows returned. |
-| `column_limit` | int | ✓ | Looker column_limit — caps wrapped-pivot columns. |
-| `filters` | dict[str, Any] | ✓ | RAW Looker filter expressions keyed by 'view.field' (e.g. "13 months", "gold") — translated to SQL predicates by likeml. |
-
-<a id="lookmlmergequery"></a>
-## LookmlMergeQuery
-LookML query that merges multiple sources.
-
-| Field | Type | Optional | Description |
-|-------|------|:--------:|-------------|
-| `merge` | list[dict[str, Any]] |  | LookML merge sources — a list of source specs. Each is either an explore spec ({explore, fields, filters?, merge_on?}) or a query reference ({query, columns, merge_on?}) for a derived source such as a table-calc wrapper. First is the primary; each secondary's `merge_on` maps its key to the primary's. Presence of this key infers type: lookml. Compiled to a FULL OUTER JOIN via likeml. |
-| `source` | str \| dict[str, Any] | ✓ | Source name reference, or an inline file path (e.g. `./data/sales.csv`). File paths are detected by `/` or data file extension. An inline connection-bearing dict (`{type: postgres, ...}`) is rejected at compile time — reference a named source instead. |
-| `description` | str | ✓ | Human-readable description of the query. Used by AI search and tooling. |
-| `ignore` | list[str] | ✓ | Diagnostic codes to suppress for this query (e.g., ['WARN-FANOUT-RISK', 'WARN-REAGGREGATION']). |
-| `cache` | [Cache](#cache) | ✓ | Cache policy override for this query, e.g. cache: 5m — refines the policy inherited from the source and project scopes; cache: false opts out of result caching entirely. Queries with cache: false cannot be used as {{ queries.X.cache }} upstream references. |
-| `type` | enum: "lookml" | ✓ | Query adapter type. |
-| `fields` | list[str] | ✓ | Qualified 'view.field' refs to select. Optional at authoring time: collected from chart channels when absent. |
-| `sorts` | list[str] | ✓ | Looker sort clauses, e.g. ['view.field', 'view.other desc']. Lowered to ORDER BY via likeml. |
-| `pivots` | list[str] | ✓ | Qualified 'view.field' refs to pivot on. |
-| `pivots_unwrapped` | bool | ✓ | Which of Looker's two pivot SQL shapes to emit: False/None = wrapped (5-layer DENSE_RANK), True = plain GROUP BY. |
-| `total` | bool | ✓ | Looker grand-totals flag. |
-| `subtotals` | list[str] | ✓ | Dimension refs to subtotal via GROUP BY ROLLUP. |
-| `filter_expression` | str | ✓ | Looker query-level free-form boolean filter over ${view.field} refs. |
-| `dynamic_fields` | list[dict[str, Any]] | ✓ | Looker dynamic fields: custom measures / custom dimensions synthesized into SQL. Table calculations compose as a derived wrapper query, not here. |
-| `limit` | int | ✓ | Maximum number of rows returned. |
-| `column_limit` | int | ✓ | Looker column_limit — caps wrapped-pivot columns. |
-| `filters` | dict[str, Any] | ✓ | RAW Looker filter expressions keyed by 'view.field' (e.g. "13 months", "gold") — translated to SQL predicates by likeml. |
-
 <a id="barchart"></a>
 ## BarChart
 Authored patch for bar and histogram charts.
@@ -217,9 +169,9 @@ Authored patch for bar and histogram charts.
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
 | `subtitle` | str | ✓ | Chart subtitle displayed below the title. |
@@ -246,9 +198,9 @@ Authored patch for line charts.
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
 | `subtitle` | str | ✓ | Chart subtitle displayed below the title. |
@@ -275,9 +227,9 @@ Authored patch for area charts.
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
 | `subtitle` | str | ✓ | Chart subtitle displayed below the title. |
@@ -304,9 +256,9 @@ Authored patch for scatter charts.
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
 | `subtitle` | str | ✓ | Chart subtitle displayed below the title. |
@@ -334,9 +286,9 @@ Authored patch for heatmap charts.
 | `type` | enum: "heatmap" |  | Heatmap chart type. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
 | `subtitle` | str | ✓ | Chart subtitle displayed below the title. |
@@ -363,9 +315,9 @@ Authored patch for pie and donut charts.
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
 | `subtitle` | str | ✓ | Chart subtitle displayed below the title. |
@@ -386,9 +338,9 @@ Authored patch for KPI (key performance indicator) charts.
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `label` | str | ✓ | KPI label rendered above the headline value. |
 | `variant` | enum: "stacked", "inline", "compact" | ✓ | Layout variant. 'stacked' (default) shows value, label, and support on three vertical lines. 'inline' lays value, label, and support out on a single baseline-aligned row. 'compact' is 2-column — big value on the left, up to two stacked lines on the right with the bottom line sharing baseline with the value; a lone `support` block splits across the two right-column lines. |
@@ -406,9 +358,9 @@ Authored patch for table charts.
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
 | `subtitle` | str | ✓ | Chart subtitle displayed below the title. |
@@ -427,9 +379,9 @@ Authored patch for point_map and bubble_map charts.
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
 | `subtitle` | str | ✓ | Chart subtitle displayed below the title. |
@@ -457,9 +409,9 @@ Authored patch for map and geoshape charts.
 | `conditional_formatting` | dict[str, [FieldConditionalFormatting](#fieldconditionalformatting)] | ✓ | Discrete rule-driven style overrides indexed by column name. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
 | `subtitle` | str | ✓ | Chart subtitle displayed below the title. |
@@ -494,9 +446,9 @@ Authored patch for spark_bar charts (compact horizontal bars).
 | `type` | enum: "spark_bar" |  | SparkBar chart type. |
 | `id` | str | ✓ | Explicit chart ID (auto-generated from the chart's YAML key if omitted). |
 | `description` | str | ✓ | Human-readable description used by AI search and context tooltips. |
-| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| [LookmlQuery](#lookmlquery) \| [LookmlMergeQuery](#lookmlmergequery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
+| `query` | str \| [SqlQuery](#sqlquery) \| [MetricflowQuery](#metricflowquery) \| [HttpQuery](#httpquery) \| [ValuesQuery](#valuesquery) \| [CompactValuesQuery](#compactvaluesquery) \| [SchemaQuery](#schemaquery) \| QueryRef | ✓ | Named query reference, inline AuthoredQuery, or SQL string shorthand. |
 | `link` | str | ✓ | Click-through URL template for drill-down links. |
-| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'model.explore' for a LookML source, or 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the LookML catalog / dbt semantic manifest. Mutually exclusive with `query:`. |
+| `model` | str | ✓ | Semantic-layer entry point, two dot-joined names: 'source.semantic_model' for a dbt_profile (MetricFlow) source. Channel fields name the model's fields directly; roles are inferred from the dbt semantic manifest. Mutually exclusive with `query:`. |
 | `warnings_ignore` | list[str] | ✓ | Codes of render warnings to suppress for this chart. |
 | `title` | str | ✓ | Chart title displayed above the chart (not used on type: kpi). |
 | `subtitle` | str | ✓ | Chart subtitle displayed below the title. |
@@ -504,14 +456,6 @@ Authored patch for spark_bar charts (compact horizontal bars).
 | `y` | str \| list[str] | ✓ | Y-axis (value) column name(s). |
 | `style` | [SparkBarChartStyle](#sparkbarchartstyle) | ✓ | Chart-local style overrides. |
 
-<a id="foreachitem"></a>
-## ForeachItem
-Top-level foreach construct in a layout list.
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `foreach` | [ForeachConfig](#foreachconfig) | foreach loop configuration with query, as, and items. |
-
 <a id="gridlayout"></a>
 ## GridLayout
 Grid layout configuration.
@@ -651,14 +595,14 @@ Authored overlay for BarChartStyle. Bar chart style: chart-level fields + marks
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | [ColorStyle](#colorstyle) | ✓ | Chart color: static mark paint, categorical palette, and/or gradient scale. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
-| `axis` | [AxisStyle](#axisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
-| `axis_x` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
-| `axis_y` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
-| `axis_quantitative` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
-| `axis_band` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
+| `axis` | [BaseAxisStyle](#baseaxisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
+| `axis_x` | [AxisXStyle](#axisxstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
+| `axis_y` | [AxisYStyle](#axisystyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
+| `axis_quantitative` | [QuantitativeAxisStyle](#quantitativeaxisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
+| `axis_band` | [BandAxisStyle](#bandaxisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
 | `number_format` | str | ✓ | Default number format for axes and tooltips (D3 format string); None inherits from theme. |
 | `time_format` | str | ✓ | Default time format for temporal axes (D3 time format string); None inherits from theme. |
-| `scale` | [ScaleStyle](#scalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
+| `scale` | [BaseScaleStyle](#basescalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
 | `data_table` | [DataTableStyle](#datatablestyle) | ✓ | Per-chart-type data_table style override. Unset fields fall back to [`style.charts.data_table`](#chartsstyle). |
 | `orientation` | enum: "horizontal", "vertical", "auto" | ✓ | Preferred bar orientation; None uses the renderer default (vertical). |
 | `stack` | enum: "none", "zero", "normalize", "center" | ✓ | Default stack mode for bar charts; none renders side-by-side columns. |
@@ -746,14 +690,14 @@ Authored overlay for LineChartStyle. Line chart style: chart-level fields + mark
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | [ColorStyle](#colorstyle) | ✓ | Chart color: static mark paint, categorical palette, and/or gradient scale. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
-| `axis` | [AxisStyle](#axisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
-| `axis_x` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
-| `axis_y` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
-| `axis_quantitative` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
-| `axis_band` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
+| `axis` | [BaseAxisStyle](#baseaxisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
+| `axis_x` | [AxisXStyle](#axisxstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
+| `axis_y` | [AxisYStyle](#axisystyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
+| `axis_quantitative` | [QuantitativeAxisStyle](#quantitativeaxisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
+| `axis_band` | [BandAxisStyle](#bandaxisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
 | `number_format` | str | ✓ | Default number format for axes and tooltips (D3 format string); None inherits from theme. |
 | `time_format` | str | ✓ | Default time format for temporal axes (D3 time format string); None inherits from theme. |
-| `scale` | [ScaleStyle](#scalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
+| `scale` | [BaseScaleStyle](#basescalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
 | `data_table` | [DataTableStyle](#datatablestyle) | ✓ | Per-chart-type data_table style override. Unset fields fall back to [`style.charts.data_table`](#chartsstyle). |
 | `endpoint_labels` | [EndpointLabelsConfig](#endpointlabelsconfig) | ✓ | Endpoint label pane configuration for line charts. |
 | `marks` | [LineChartMarksStyle](#linechartmarksstyle) | ✓ | Line-family mark overrides. Unset fields fall back to [`style.charts.marks`](#chartsstyle). |
@@ -777,14 +721,14 @@ Authored overlay for AreaChartStyle. Area chart style: chart-level fields + mark
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | [ColorStyle](#colorstyle) | ✓ | Chart color: static mark paint, categorical palette, and/or gradient scale. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
-| `axis` | [AxisStyle](#axisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
-| `axis_x` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
-| `axis_y` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
-| `axis_quantitative` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
-| `axis_band` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
+| `axis` | [BaseAxisStyle](#baseaxisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
+| `axis_x` | [AxisXStyle](#axisxstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
+| `axis_y` | [AxisYStyle](#axisystyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
+| `axis_quantitative` | [QuantitativeAxisStyle](#quantitativeaxisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
+| `axis_band` | [BandAxisStyle](#bandaxisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
 | `number_format` | str | ✓ | Default number format for axes and tooltips (D3 format string); None inherits from theme. |
 | `time_format` | str | ✓ | Default time format for temporal axes (D3 time format string); None inherits from theme. |
-| `scale` | [ScaleStyle](#scalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
+| `scale` | [BaseScaleStyle](#basescalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
 | `data_table` | [DataTableStyle](#datatablestyle) | ✓ | Per-chart-type data_table style override. Unset fields fall back to [`style.charts.data_table`](#chartsstyle). |
 | `stack` | enum: "none", "zero", "normalize", "center" | ✓ | Default stack mode for area charts: 'none', 'zero', 'normalize', or 'center'. |
 | `endpoint_labels` | [EndpointLabelsConfig](#endpointlabelsconfig) | ✓ | Endpoint label pane configuration for area charts. |
@@ -809,14 +753,14 @@ Authored overlay for ScatterChartStyle. Scatter chart style: chart-level fields
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | [ColorStyle](#colorstyle) | ✓ | Chart color: static mark paint, categorical palette, and/or gradient scale. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
-| `axis` | [AxisStyle](#axisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
-| `axis_x` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
-| `axis_y` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
-| `axis_quantitative` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
-| `axis_band` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
+| `axis` | [BaseAxisStyle](#baseaxisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
+| `axis_x` | [AxisXStyle](#axisxstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
+| `axis_y` | [AxisYStyle](#axisystyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
+| `axis_quantitative` | [QuantitativeAxisStyle](#quantitativeaxisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
+| `axis_band` | [BandAxisStyle](#bandaxisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
 | `number_format` | str | ✓ | Default number format for axes and tooltips (D3 format string); None inherits from theme. |
 | `time_format` | str | ✓ | Default time format for temporal axes (D3 time format string); None inherits from theme. |
-| `scale` | [ScaleStyle](#scalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
+| `scale` | [BaseScaleStyle](#basescalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
 | `data_table` | [DataTableStyle](#datatablestyle) | ✓ | Per-chart-type data_table style override. Unset fields fall back to [`style.charts.data_table`](#chartsstyle). |
 | `marks` | [ScatterChartMarksStyle](#scatterchartmarksstyle) | ✓ | Scatter-family mark overrides. Unset fields fall back to [`style.charts.marks`](#chartsstyle). |
 
@@ -839,14 +783,14 @@ Authored overlay for HeatmapChartStyle. Heatmap chart style.
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | [ColorStyle](#colorstyle) | ✓ | Chart color: static mark paint, categorical palette, and/or gradient scale. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
-| `axis` | [AxisStyle](#axisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
-| `axis_x` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
-| `axis_y` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
-| `axis_quantitative` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
-| `axis_band` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
+| `axis` | [BaseAxisStyle](#baseaxisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
+| `axis_x` | [AxisXStyle](#axisxstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
+| `axis_y` | [AxisYStyle](#axisystyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
+| `axis_quantitative` | [QuantitativeAxisStyle](#quantitativeaxisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
+| `axis_band` | [BandAxisStyle](#bandaxisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
 | `number_format` | str | ✓ | Default number format for axes and tooltips (D3 format string); None inherits from theme. |
 | `time_format` | str | ✓ | Default time format for temporal axes (D3 time format string); None inherits from theme. |
-| `scale` | [ScaleStyle](#scalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
+| `scale` | [BaseScaleStyle](#basescalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
 | `data_table` | [DataTableStyle](#datatablestyle) | ✓ | Per-chart-type data_table style override. Unset fields fall back to [`style.charts.data_table`](#chartsstyle). |
 | `cell_padding` | float | ✓ | Padding between heatmap cells in pixels. |
 | `marks` | [HeatmapChartMarksStyle](#heatmapchartmarksstyle) | ✓ | Heatmap-family mark overrides. Unset fields fall back to [`style.charts.marks`](#chartsstyle). |
@@ -1050,23 +994,13 @@ Authored overlay for SparkBarChartStyle. Produced by cascade from theme YAML.
 | `border` | [BorderStyle](#borderstyle) | ✓ | Spark_bar outer border style. |
 | `subtitle` | [SubtitleStyle](#subtitlestyle) | ✓ | Spark_bar subtitle font-sizing constants. |
 
-<a id="foreachconfig"></a>
-## ForeachConfig
-foreach loop configuration.
-
-| Field | Type | Description |
-|-------|------|-------------|
-| `query` | [ForeachQuery](#foreachquery) | Inline data source providing the rows to iterate over. |
-| `as` | str | Variable name bound to each row (accessible as {{ as.field }}). |
-| `items` | list[str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| [ForeachItem](#foreachitem) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)]] | Layout item templates resolved once per data row. |
-
 <a id="griditem"></a>
 ## GridItem
 Grid layout item with position and span.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `item` | str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| [ForeachItem](#foreachitem) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)] |  | Chart name or inline chart/face definition to place in this grid cell. |
+| `item` | str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)] |  | Chart name or inline chart/face definition to place in this grid cell. |
 | `col` | int | ✓ | Column position (0-indexed). Auto-placed if omitted. |
 | `row` | int | ✓ | Row position (0-indexed). Auto-placed if omitted. |
 | `col_span` | int | ✓ | Number of columns to span (width in grid units). |
@@ -1086,8 +1020,8 @@ Tab layout item.
 | `description` | str | ✓ | Optional metadata for AI search and context tooltips. |
 | `text` | str | ✓ | Markdown text content shown in this tab. |
 | `style` | [Style](#style) | ✓ | Style patch for this tab's content area. |
-| `rows` | list[str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| [ForeachItem](#foreachitem) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)]] | ✓ | Vertical stack layout for this tab's content. |
-| `cols` | list[str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| [ForeachItem](#foreachitem) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)]] | ✓ | Horizontal layout for this tab's content. |
+| `rows` | list[str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)]] | ✓ | Vertical stack layout for this tab's content. |
+| `cols` | list[str \| [Face](#face) \| [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart) \| dict[str, [BarChart](#barchart) \| [LineChart](#linechart) \| [AreaChart](#areachart) \| [ScatterChart](#scatterchart) \| [HeatmapChart](#heatmapchart) \| [PieChart](#piechart) \| [KpiChart](#kpichart) \| [TableChart](#tablechart) \| [PointMapChart](#pointmapchart) \| [GeoshapeChart](#geoshapechart) \| [CalloutChart](#calloutchart) \| [SparkBarChart](#sparkbarchart)]] | ✓ | Horizontal layout for this tab's content. |
 | `grid` | [GridLayout](#gridlayout) | ✓ | CSS-grid layout for this tab's content. |
 | `tabs` | [TabLayout](#tablayout) | ✓ | Nested tab layout (tabs within tabs). |
 
@@ -1192,10 +1126,10 @@ Authored overlay for ChartsStyle. Registry of all chart-type styles plus shared
 | `default_chart_height` | float | ✓ | Fallback chart height in pixels when aspect-ratio sizing is unavailable. |
 | `default_table_height` | float | ✓ | Placeholder table height in pixels; replaced by data-aware row-count sizing at render time. |
 | `label_usable_ratio` | float | ✓ | Fraction of chart width usable for axis labels (0–1); labels are tilted when full labels exceed this width. |
-| `axis` | [AxisStyle](#axisstyle) | ✓ | Shared axis style applied to all axes before per-axis overrides. |
-| `axis_x` | [AxisStyle](#axisstyle) | ✓ | X-axis style overrides applied after the shared axis. Unset fields fall back to style.charts.axis. |
-| `axis_y` | [AxisStyle](#axisstyle) | ✓ | Y-axis style overrides applied after the shared axis. Unset fields fall back to style.charts.axis. |
-| `axis_quantitative` | [AxisStyle](#axisstyle) | ✓ | Quantitative axis style overrides applied after axis_x/axis_y. Unset fields fall back to style.charts.axis. |
+| `axis` | [BaseAxisStyle](#baseaxisstyle) | ✓ | Shared axis style applied to all axes before per-axis overrides. |
+| `axis_x` | [AxisXStyle](#axisxstyle) | ✓ | X-axis style overrides applied after the shared axis. Unset fields fall back to style.charts.axis. |
+| `axis_y` | [AxisYStyle](#axisystyle) | ✓ | Y-axis style overrides applied after the shared axis. Unset fields fall back to style.charts.axis. |
+| `axis_quantitative` | [QuantitativeAxisStyle](#quantitativeaxisstyle) | ✓ | Quantitative axis style overrides applied after axis_x/axis_y. Unset fields fall back to style.charts.axis. |
 | `view` | [ViewStyle](#viewstyle) | ✓ | Vega-Lite view dimensions and border. |
 | `marks` | [GlobalMarksStyle](#globalmarksstyle) | ✓ | Global mark defaults (tier-1 of the marks cascade). |
 | `bar` | [BarChartStyle](#barchartstyle) | ✓ | Bar chart style. |
@@ -1242,7 +1176,6 @@ Authored overlay for VariablesStyle. Variable controls chrome styling.
 | `label` | [VariablesLabelStyle](#variableslabelstyle) | ✓ | Variable label typography. |
 | `value` | [VariablesValueStyle](#variablesvaluestyle) | ✓ | Variable value typography. |
 | `placeholder` | [VariablesPlaceholderStyle](#variablesplaceholderstyle) | ✓ | Style for unselected/hint text in variable inputs. |
-| `line_height` | float | ✓ | Line height for variable control text in pixels. |
 | `padding` | float | ✓ | Outer padding around the variables panel in pixels. |
 | `container_height` | float | ✓ | Height of the variables panel container in pixels. |
 | `container_padding` | float | ✓ | Inner padding of the variables panel container in pixels. |
@@ -1425,58 +1358,92 @@ Authored overlay for ColorStyle. Unified chart color config: static paint, categ
 | `gradient` | [ScaleTargetConfig](#scaletargetconfig) | ✓ | Continuous gradient scale for the color encoding. |
 | `categorical` | [CategoricalColorStyle](#categoricalcolorstyle) | ✓ | Categorical color and single-series palette config. |
 
-<a id="axisstyle"></a>
-## AxisStyle
-Authored overlay for AxisStyle.
+<a id="baseaxisstyle"></a>
+## BaseAxisStyle
+Authored overlay for BaseAxisStyle. Universal axis surface — grid/line/ticks/labels/title/scale.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `grid` | [AxisGridStyle](#axisgridstyle) | ✓ | Grid line style for this axis. |
-| `domain` | [AxisDomainStyle](#axisdomainstyle) | ✓ | Domain line style for this axis. |
+| `grid` | [BaseAxisGridStyle](#baseaxisgridstyle) | ✓ | Grid line style for this axis. |
+| `line` | [AxisLineStyle](#axislinestyle) | ✓ | Domain line style for this axis. |
 | `ticks` | [AxisTicksStyle](#axisticksstyle) | ✓ | Tick mark style for this axis. |
-| `label` | [AxisElementStyle](#axiselementstyle) | ✓ | Axis label style. |
-| `title` | [AxisElementStyle](#axiselementstyle) | ✓ | Axis title style. |
-| `position` | enum: "left", "right", "top", "bottom", "auto" | ✓ | Axis position; auto flips y-axis when endpoint labels are present. |
-| `categorical_orient` | str | ✓ | Orientation for categorical y-axis (e.g. 'left'); None skips this VL property. |
-| `mirror` | bool \| [AxisMirrorStyle](#axismirrorstyle) | ✓ | Draw the y-scale on both left and right edges (wide charts). true mirrors the primary axis's label verbatim; an object (format/expr) relabels only the mirrored edge — e.g. a percent-of-total right axis next to an absolute-value left axis — while ticks stay aligned to the single shared scale. Only meaningful on axis_y. |
-| `band_position` | float | ✓ | Band position within the step (0–1); None uses Vega-Lite's default. |
-| `offset` | float | ✓ | Pixel offset of the axis from its default position; None means no offset. |
-| `format` | str | ✓ | Tick value format string; None uses auto-format. |
-| `values` | list[Any] | ✓ | Explicit tick values; None uses Vega-Lite's auto tick values. |
+| `labels` | [AxisLabelStyle](#axislabelstyle) | ✓ | Axis label style. |
+| `title` | [AxisTitleStyle](#axistitlestyle) | ✓ | Axis title style. |
+| `scale` | [BaseScaleStyle](#basescalestyle) | ✓ | Per-axis scale overrides; None means no override. |
+
+<a id="axisxstyle"></a>
+## AxisXStyle
+Authored overlay for AxisXStyle. Dimension/category-time axis style. Theme slot: axis_x.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `grid` | [BaseAxisGridStyle](#baseaxisgridstyle) | ✓ | Grid line style for this axis. |
+| `line` | [AxisLineStyle](#axislinestyle) | ✓ | Domain line style for this axis. |
+| `ticks` | [DimensionTicksStyle](#dimensionticksstyle) | ✓ | Dimension axis tick style. |
+| `labels` | [DimensionLabelStyle](#dimensionlabelstyle) | ✓ | Dimension axis label style. |
+| `title` | [AxisTitleStyle](#axistitlestyle) | ✓ | Axis title style. |
+| `scale` | [XScaleStyle](#xscalestyle) | ✓ | X-axis scale overrides including x_reverse; None means no override. |
+| `position` | enum: "top", "bottom" | ✓ | X-axis position; None uses Vega-Lite's default (bottom). |
 | `time_unit` | enum: "auto", "year", "yearquarter", "yearmonth", "yearweek", "yearmonthdate", "monthofyear", "dayofweek", "dayofmonth", "dayofyear", "hourofday", "none" | ✓ | Time-unit bucketing for temporal x-axes; None or 'auto' auto-detects from data. |
-| `scale` | [ScaleStyle](#scalestyle) | ✓ | Per-axis scale overrides; None means no override. |
 | `type` | enum: "auto", "ordinal", "temporal" | ✓ | Scale type for bucketed-time x-axes; None/'auto' infers from time_unit grain. |
 | `fill` | enum: "null", "zero", "linear", "step-after", "step-before", "step-center", "curve" | ✓ | Fill for synthesized missing-bucket rows: null, zero, linear, step-after / step-before / step-center (Looker step), or curve (smoothstep). |
 | `fiscal_year_start_month` | int | ✓ | Calendar month (1=Jan..12=Dec) that opens a fiscal year/quarter for year/yearquarter bucketing; theme default 1 is the calendar convention (Q1=Jan-Mar). A non-default value always wins over axis_x.type: temporal for year/yearquarter grains - Vega-Lite's native timeUnit transform has no fiscal-offset concept and would otherwise silently discard the offset. |
 
-<a id="scalestyle"></a>
-## ScaleStyle
-Authored overlay for ScaleStyle. Scale configuration primitive.
+<a id="axisystyle"></a>
+## AxisYStyle
+Authored overlay for AxisYStyle. Measure axis style. Theme slot: axis_y.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `grid` | [MeasureGridStyle](#measuregridstyle) | ✓ | Measure axis grid style (includes zero-baseline override). |
+| `line` | [AxisLineStyle](#axislinestyle) | ✓ | Domain line style for this axis. |
+| `ticks` | [AxisTicksStyle](#axisticksstyle) | ✓ | Tick mark style for this axis. |
+| `labels` | [AxisLabelStyle](#axislabelstyle) | ✓ | Axis label style. |
+| `title` | [AxisTitleStyle](#axistitlestyle) | ✓ | Axis title style. |
+| `scale` | [BaseScaleStyle](#basescalestyle) | ✓ | Per-axis scale overrides; None means no override. |
+| `position` | enum: "left", "right", "auto" | ✓ | Y-axis position; auto flips when endpoint labels are on the right. |
+| `mirror` | bool \| [AxisMirrorStyle](#axismirrorstyle) | ✓ | Draw the y-scale on both left and right edges (wide charts). true mirrors the primary axis's label verbatim; an object (format/expr) relabels only the mirrored edge — e.g. a percent-of-total right axis next to an absolute-value left axis — while ticks stay aligned to the single shared scale. Only meaningful on axis_y. |
+
+<a id="quantitativeaxisstyle"></a>
+## QuantitativeAxisStyle
+Authored overlay for QuantitativeAxisStyle. Scale-type overlay for quantitative axes. Theme slot: axis_quantitative.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `grid` | [BaseAxisGridStyle](#baseaxisgridstyle) | ✓ | Grid line style for this axis. |
+| `line` | [AxisLineStyle](#axislinestyle) | ✓ | Domain line style for this axis. |
+| `ticks` | [AxisTicksStyle](#axisticksstyle) | ✓ | Tick mark style for this axis. |
+| `labels` | [AxisLabelStyle](#axislabelstyle) | ✓ | Axis label style. |
+| `title` | [AxisTitleStyle](#axistitlestyle) | ✓ | Axis title style. |
+| `scale` | [BaseScaleStyle](#basescalestyle) | ✓ | Per-axis scale overrides; None means no override. |
+
+<a id="bandaxisstyle"></a>
+## BandAxisStyle
+Authored overlay for BandAxisStyle. Scale-type overlay for band (categorical) axes. Theme slot: axis_band.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `grid` | [BaseAxisGridStyle](#baseaxisgridstyle) | ✓ | Grid line style for this axis. |
+| `line` | [AxisLineStyle](#axislinestyle) | ✓ | Domain line style for this axis. |
+| `ticks` | [AxisTicksStyle](#axisticksstyle) | ✓ | Tick mark style for this axis. |
+| `labels` | [AxisLabelStyle](#axislabelstyle) | ✓ | Axis label style. |
+| `title` | [AxisTitleStyle](#axistitlestyle) | ✓ | Axis title style. |
+| `scale` | [BaseScaleStyle](#basescalestyle) | ✓ | Per-axis scale overrides; None means no override. |
+| `band_position` | float | ✓ | Band position within the step (0–1); None uses Vega-Lite's default. |
+
+<a id="basescalestyle"></a>
+## BaseScaleStyle
+Authored overlay for BaseScaleStyle. Universal + continuous-only scale config.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `band_padding_inner` | float | ✓ | Inner padding fraction for band scales; None uses Vega-Lite's default. |
-| `band_padding_outer` | float | ✓ | Outer padding fraction for band scales; None uses Vega-Lite's default. |
-| `point_padding` | float | ✓ | Padding fraction for point scales; None uses Vega-Lite's default. |
-| `rect_band_padding_inner` | float | ✓ | Inner padding fraction for rect band scales; None uses Vega-Lite's default. |
 | `round` | bool | ✓ | Round scale outputs to nearest integer; None uses Vega-Lite's default (no rounding). |
-| `zero` | bool \| enum: "auto" | ✓ | Force scale zero-baseline: True/False pins it; "auto" runs the Dataface smart-zero heuristic; None passes through to Vega-Lite. |
 | `clamp` | bool | ✓ | Clamp values to scale domain; None uses Vega-Lite's default (no clamping). |
-| `continuous_padding` | float | ✓ | Padding in pixels for continuous scales; None uses Vega-Lite's default. |
-| `band` | [ScaleBandStyle](#scalebandstyle) | ✓ | Band mark size constraints; None uses Vega-Lite's defaults. |
-| `quantile_count` | int | ✓ | Number of quantile buckets; None uses Vega-Lite's default. |
-| `quantize_count` | int | ✓ | Number of quantize buckets; None uses Vega-Lite's default. |
-| `use_unaggregated_domain` | bool | ✓ | Use unaggregated domain for scale extent; None uses Vega-Lite's default. |
-| `x_reverse` | bool | ✓ | Reverse the x-axis scale direction; None means no reversal. |
-| `type` | enum: "linear", "log", "pow", "sqrt", "symlog", "temporal" | ✓ | Scale type override. 'linear'/'log'/'pow'/'sqrt'/'symlog' pass straight through to Vega-Lite's quantitative scale.type. 'temporal' is a Dataface escape hatch for a cartesian x-axis: it forces a continuous temporal scale instead of the auto-inferred ordinal/nominal bucketed type, which is required before an authored ``domain`` of ISO dates can extend the visible range past the data extent. None lets Dataface/Vega-Lite infer from the field type. |
-| `domain` | list[Any] | ✓ | Explicit [low, high] scale domain; None lets Vega-Lite auto-determine from data. Must have exactly 2 elements — Dataface only wires a continuous range override through to Vega-Lite, not an explicit category enumeration. When ``type: temporal`` is set, both elements must be ISO-8601 date/datetime strings. |
-| `base` | float | ✓ | Log base; only meaningful with type: log. None lets Vega-Lite apply its own default (10). |
-| `exponent` | float | ✓ | Power exponent; only meaningful with type: pow. None uses Vega-Lite's default. |
-| `constant` | float | ✓ | Symlog constant; only meaningful with type: symlog. None uses Vega-Lite's default. |
-| `domain_strategy` | enum: "stable", "auto" | ✓ | How the numeric domain responds to filter-variable changes when no explicit `domain` is authored. 'stable' (the default when None) pins the domain to the chart query's full unfiltered extent — the same value lands at the same pixel across variable changes. 'auto' rescales the domain to the current filtered subset on every variable change. An explicit `domain` always wins over either strategy. |
 | `nice` | bool | ✓ | Round scale domain to nice values; None uses Vega-Lite's default. |
 | `padding` | float | ✓ | Unified scale padding shortcut; dispatches to band, point, or continuous padding per scale type. |
 | `headroom` | float | ✓ | Fractional breathing room at measure-axis edges, exact (never nice-rounded). Zero-anchored axes (bar; line/area/scatter near zero): domain_max = data_max * (1 + headroom). Zoomed axes (line/area/scatter far from zero): both edges expand — domain_max = data_max + headroom * span; domain_min = data_min - headroom * span. None inherits the theme default; 0 disables headroom. Ignored with an explicit `domain` or `stack: normalize`. |
+| `values` | list[Any] | ✓ | Explicit tick values; None uses Vega-Lite's auto tick values. |
+| `continuous` | [ScaleContinuousStyle](#scalecontinuousstyle) | ✓ | Continuous-scale overrides (type, domain, zero, log/pow/symlog params); None means no override. |
 
 <a id="datatablestyle"></a>
 ## DataTableStyle
@@ -1887,16 +1854,6 @@ Authored overlay for SparkBarCountStyle. Count-value sub-block for SparkBarChart
 | `visible` | bool | ✓ | Show count/value text next to bars. |
 | `width` | float | ✓ | Reserved width for bar count text in pixels. |
 
-<a id="foreachquery"></a>
-## ForeachQuery
-Inline data source for compile-time foreach loops.
-
-| Field | Type | Optional | Description |
-|-------|------|:--------:|-------------|
-| `data` | list[dict[str, Any]] | ✓ | Inline row data for compile-time iteration. |
-| `static_data` | list[dict[str, Any]] | ✓ | Alias for data; inline row data for compile-time iteration. |
-| `palette` | str | ✓ | Palette name to iterate its live stops from the palette YAML source of truth (one row per stop: {n: 1-indexed position, hex: sRGB hex}). Accepts the same 'name:steps' / 'name_r' shorthand as palette(). |
-
 <a id="titlewidthoffsetsstyle"></a>
 ## TitleWidthOffsetsStyle
 Authored overlay for TitleWidthOffsetsStyle. Additive level offsets applied to a face/chart title's heading level, by card pixel width.
@@ -2039,14 +1996,14 @@ Authored overlay for HistogramChartStyle. Histogram chart style.
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | [ColorStyle](#colorstyle) | ✓ | Chart color: static mark paint, categorical palette, and/or gradient scale. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
-| `axis` | [AxisStyle](#axisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
-| `axis_x` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
-| `axis_y` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
-| `axis_quantitative` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
-| `axis_band` | [AxisStyle](#axisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
+| `axis` | [BaseAxisStyle](#baseaxisstyle) | ✓ | Override applied to both x and y axes; None inherits the global axis at render. |
+| `axis_x` | [AxisXStyle](#axisxstyle) | ✓ | Per-chart-type x-axis style overrides; None inherits the global axis_x at render. |
+| `axis_y` | [AxisYStyle](#axisystyle) | ✓ | Per-chart-type y-axis style overrides; None inherits the global axis_y at render. |
+| `axis_quantitative` | [QuantitativeAxisStyle](#quantitativeaxisstyle) | ✓ | Per-chart-type quantitative-axis overrides; None inherits the global axis_quantitative at render. |
+| `axis_band` | [BandAxisStyle](#bandaxisstyle) | ✓ | Per-chart-type categorical (band) axis overrides; None inherits the global band axis at render. |
 | `number_format` | str | ✓ | Default number format for axes and tooltips (D3 format string); None inherits from theme. |
 | `time_format` | str | ✓ | Default time format for temporal axes (D3 time format string); None inherits from theme. |
-| `scale` | [ScaleStyle](#scalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
+| `scale` | [BaseScaleStyle](#basescalestyle) | ✓ | Chart-type encoding scale overrides applied to both x and y; None means no override. |
 | `data_table` | [DataTableStyle](#datatablestyle) | ✓ | Per-chart-type data_table style override. Unset fields fall back to [`style.charts.data_table`](#chartsstyle). |
 | `bin_maxbins` | int | ✓ | Maximum number of bins for auto-binning. |
 | `marks` | [HistogramChartMarksStyle](#histogramchartmarksstyle) | ✓ | Histogram-family mark overrides. Unset fields fall back to [`style.charts.marks`](#chartsstyle). |
@@ -2229,9 +2186,9 @@ Authored overlay for CategoricalColorStyle. Categorical palette config: per-seri
 | `palette` | list[str] \| str | ✓ | Categorical color palette: list of stops or a named palette. Expanded to list[str] at validation time. |
 | `single_series_palette` | list[str] \| str | ✓ | Ordered list of single-series mark inks (must be non-empty when set), or a palette name. |
 
-<a id="axisgridstyle"></a>
-## AxisGridStyle
-Authored overlay for AxisGridStyle.
+<a id="baseaxisgridstyle"></a>
+## BaseAxisGridStyle
+Authored overlay for BaseAxisGridStyle. Grid line style for all axis variants.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
@@ -2240,11 +2197,10 @@ Authored overlay for AxisGridStyle.
 | `width` | float | ✓ | Grid line width in pixels; None uses Vega-Lite's default. |
 | `color` | str | ✓ | Grid line color; None uses Vega-Lite's default. |
 | `dash` | list[float] | ✓ | Dash pattern for grid lines; None renders a solid line. |
-| `zero` | [AxisGridZeroStyle](#axisgridzerostyle) | ✓ | Zero-baseline gridline style; None inherits from parent axis. |
 
-<a id="axisdomainstyle"></a>
-## AxisDomainStyle
-Authored overlay for AxisDomainStyle.
+<a id="axislinestyle"></a>
+## AxisLineStyle
+Authored overlay for AxisLineStyle. Axis domain/baseline line style. Renamed from ``AxisDomainStyle`` —
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
@@ -2254,21 +2210,21 @@ Authored overlay for AxisDomainStyle.
 
 <a id="axisticksstyle"></a>
 ## AxisTicksStyle
-Authored overlay for AxisTicksStyle.
+Authored overlay for AxisTicksStyle. Universal tick config. ``step``-anchored cadence needs a named time
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
 | `visible` | bool | ✓ | Show axis ticks; None inherits from parent axis. |
 | `color` | str | ✓ | Tick color; None uses Vega-Lite's default. |
-| `size` | float | ✓ | Tick length in pixels; None uses Vega-Lite's default. |
+| `length` | float | ✓ | Tick length in pixels; None uses Vega-Lite's default. |
 | `width` | float | ✓ | Tick stroke width in pixels; None uses Vega-Lite's default. |
+| `offset` | float | ✓ | Pixel offset of ticks from their default position; None means no offset. |
 | `count` | int | ✓ | Target number of axis ticks. On a quantitative axis the renderer computes explicit tickValues so VL emits exactly this many ticks — VL's tickCount is advisory and frequently ignored there. On a temporal axis_x, count is passed through as VL's axis.tickCount, which VL's time-scale tick logic honours as a target. |
-| `interval` | enum: "year", "quarter", "month" | ✓ | Step-anchored tick cadence unit — 'ticks every N &lt;interval&gt;, anchored on multiples of N'. Mutually exclusive with count. Meaningful on a continuous-temporal axis_x only — raises at compile on axis_y, and at render if the x-axis resolves to a non-temporal (ordinal) scale. |
-| `step` | int | ✓ | Step multiple for the interval cadence (e.g. interval: year, step: 5 -&gt; ticks every 5 years). Requires interval to also be set — step alone doesn't name a unit. |
+| `step` | int | ✓ | Step multiple for a step-anchored tick cadence (e.g. on DimensionTicksStyle: time_unit: year, step: 5 -&gt; ticks every 5 years). Inert on this base class alone — a channel that wants step-anchored cadence adds the unit field (DimensionTicksStyle.time_unit). |
 
-<a id="axiselementstyle"></a>
-## AxisElementStyle
-Authored overlay for AxisElementStyle. Axis label or title: font + padding + VL-passthrough.
+<a id="axislabelstyle"></a>
+## AxisLabelStyle
+Authored overlay for AxisLabelStyle. Axis label: font + padding + VL-passthrough.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
@@ -2277,19 +2233,92 @@ Authored overlay for AxisElementStyle. Axis label or title: font + padding + VL-
 | `max_width` | float | ✓ | Maximum label width in pixels; None uses Vega-Lite's default (180px). |
 | `angle` | float | ✓ | Label rotation angle in degrees; None uses Vega-Lite's default. |
 | `align` | enum: "left", "right", "center", "inward", "outward" | ✓ | Horizontal text alignment of labels. 'left'/'right'/'center' are absolute. 'inward' hugs the plot (own-side: left on a left axis, right on a right axis); 'outward' hugs away from the plot (Vega-Lite's default growth direction). inward/outward are a no-op on an axis with no left/right edge. None uses Vega-Lite's default. |
-| `baseline` | str | ✓ | Vertical text baseline of labels; None uses Vega-Lite's default. |
 | `overlap` | [AxisLabelOverlapConfig](#axislabeloverlapconfig) | ✓ | Label overlap strategy enablement. None inherits from the theme cascade. Set individual bools to enable/disable; the resolver applies them in fixed order skip→tilt. On bucketed temporal axes, skip thins label visibility to a coarser calendar period without changing the axis or label time unit. |
-| `separation` | float | ✓ | Minimum pixel separation between labels; None uses Vega-Lite's default (0px). |
+| `min_gap` | float | ✓ | Minimum pixel gap between labels; None uses Vega-Lite's default (0px). |
+| `visible` | bool | ✓ | Show axis labels; None uses Vega-Lite's default (labels shown). |
+| `expr` | str | ✓ | Custom Vega expression for label text; None uses smart temporal defaults when applicable. |
+| `bound` | bool \| float | ✓ | Hide labels that overflow the axis range; None uses Vega-Lite's default. |
+| `flush` | bool \| float | ✓ | Align first/last label flush with the scale range; None uses Vega-Lite's default. |
+| `offset` | float | ✓ | Pixel offset of the label from its tick anchor; None uses Vega-Lite's default. |
+| `format` | str | ✓ | Tick value format string; None uses auto-format. |
+
+<a id="axistitlestyle"></a>
+## AxisTitleStyle
+Authored overlay for AxisTitleStyle. Axis title typography — deliberately thin. A title is one short static
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `font` | [FontStyle](#fontstyle) | ✓ | Axis title font style overrides. Unset fields fall back to [`style.charts.font`](#chartsstyle). |
+| `padding` | float | ✓ | Padding between axis title and labels in pixels; None uses Vega-Lite's default. |
+| `angle` | float | ✓ | Title rotation angle in degrees; None uses Vega-Lite's default. |
+| `align` | enum: "left", "right", "center", "inward", "outward" | ✓ | Horizontal text alignment of the title. 'left'/'right'/'center' are absolute. 'inward'/'outward' resolve against the axis's own left/right edge, same as label.align; a no-op on an axis with no left/right edge. None uses Vega-Lite's default. |
+| `visible` | bool | ✓ | Show the axis title; None uses Vega-Lite's default (title shown). |
+
+<a id="dimensionticksstyle"></a>
+## DimensionTicksStyle
+Authored overlay for DimensionTicksStyle. axis_x-only: step-anchored tick cadence needs a named time unit.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `visible` | bool | ✓ | Show axis ticks; None inherits from parent axis. |
+| `color` | str | ✓ | Tick color; None uses Vega-Lite's default. |
+| `length` | float | ✓ | Tick length in pixels; None uses Vega-Lite's default. |
+| `width` | float | ✓ | Tick stroke width in pixels; None uses Vega-Lite's default. |
+| `offset` | float | ✓ | Pixel offset of ticks from their default position; None means no offset. |
+| `count` | int | ✓ | Target number of axis ticks. On a quantitative axis the renderer computes explicit tickValues so VL emits exactly this many ticks — VL's tickCount is advisory and frequently ignored there. On a temporal axis_x, count is passed through as VL's axis.tickCount, which VL's time-scale tick logic honours as a target. |
+| `step` | int | ✓ | Step multiple for a step-anchored tick cadence (e.g. on DimensionTicksStyle: time_unit: year, step: 5 -&gt; ticks every 5 years). Inert on this base class alone — a channel that wants step-anchored cadence adds the unit field (DimensionTicksStyle.time_unit). |
+| `time_unit` | enum: "auto", "year", "yearquarter", "yearmonth", "yearweek", "yearmonthdate", "monthofyear", "dayofweek", "dayofmonth", "dayofyear", "hourofday", "none" | ✓ | Step-anchored tick cadence unit; None disables step-anchored ticks. |
+
+<a id="dimensionlabelstyle"></a>
+## DimensionLabelStyle
+Authored overlay for DimensionLabelStyle. AxisLabelStyle + dimension-axis-only label fields.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `font` | [FontStyle](#fontstyle) | ✓ | Axis element font style overrides. Unset fields fall back to [`style.charts.font`](#chartsstyle). |
+| `padding` | float | ✓ | Padding between axis labels and ticks in pixels; None inherits from parent axis. |
+| `max_width` | float | ✓ | Maximum label width in pixels; None uses Vega-Lite's default (180px). |
+| `angle` | float | ✓ | Label rotation angle in degrees; None uses Vega-Lite's default. |
+| `align` | enum: "left", "right", "center", "inward", "outward" | ✓ | Horizontal text alignment of labels. 'left'/'right'/'center' are absolute. 'inward' hugs the plot (own-side: left on a left axis, right on a right axis); 'outward' hugs away from the plot (Vega-Lite's default growth direction). inward/outward are a no-op on an axis with no left/right edge. None uses Vega-Lite's default. |
+| `overlap` | [AxisLabelOverlapConfig](#axislabeloverlapconfig) | ✓ | Label overlap strategy enablement. None inherits from the theme cascade. Set individual bools to enable/disable; the resolver applies them in fixed order skip→tilt. On bucketed temporal axes, skip thins label visibility to a coarser calendar period without changing the axis or label time unit. |
+| `min_gap` | float | ✓ | Minimum pixel gap between labels; None uses Vega-Lite's default (0px). |
 | `visible` | bool | ✓ | Show axis labels; None uses Vega-Lite's default (labels shown). |
-| `time_unit` | enum: "auto", "year", "yearquarter", "yearmonth", "yearweek", "yearmonthdate", "monthofyear", "dayofweek", "dayofmonth", "dayofyear", "hourofday", "none" | ✓ | Label cadence for temporal axes; None inherits from the parent axis time_unit. |
 | `expr` | str | ✓ | Custom Vega expression for label text; None uses smart temporal defaults when applicable. |
 | `bound` | bool \| float | ✓ | Hide labels that overflow the axis range; None uses Vega-Lite's default. |
 | `flush` | bool \| float | ✓ | Align first/last label flush with the scale range; None uses Vega-Lite's default. |
 | `offset` | float | ✓ | Pixel offset of the label from its tick anchor; None uses Vega-Lite's default. |
-| `line_height` | float | ✓ | Line height for multi-line labels in pixels; None uses Vega-Lite's default. |
-| `anchor` | enum: "start", "middle", "end" | ✓ | Label anchor position; None uses Vega-Lite's default. |
+| `format` | str | ✓ | Tick value format string; None uses auto-format. |
+| `time_unit` | enum: "auto", "year", "yearquarter", "yearmonth", "yearweek", "yearmonthdate", "monthofyear", "dayofweek", "dayofmonth", "dayofyear", "hourofday", "none" | ✓ | Label cadence for temporal axes; None inherits from the parent axis time_unit. |
 | `tilt_increments` | list[float] | ✓ | Descending tilt angles for label overlap resolution on discrete x-axes; None disables tilt. |
-| `values` | list[Any] | ✓ | Dates to keep label text on, chosen from among the axis's ticks (whatever axis_x.values or the auto-fill cadence already produced) — this filters which ticks show text, it does not add or remove ticks. Every tick not in this list keeps its position and gridline but has its label blanked. Set axis_x.values separately to change tick/grid density itself. Temporal x-axes only; None labels every tick as usual. |
+| `values` | list[Any] | ✓ | Dates to keep label text on, chosen from among the axis's ticks (whatever axis_x.values or the auto-fill cadence already produced) — this filters which ticks show text, it does not add or remove ticks. Every tick not in this list keeps its position and gridline but has its label blanked. Set axis_x.values separately to change tick/grid density itself. Temporal x-axes only; not supported on a horizontal bar's categorical axis. None labels every tick as usual. |
+
+<a id="xscalestyle"></a>
+## XScaleStyle
+Authored overlay for XScaleStyle. Scale config for axis_x.scale only.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `round` | bool | ✓ | Round scale outputs to nearest integer; None uses Vega-Lite's default (no rounding). |
+| `clamp` | bool | ✓ | Clamp values to scale domain; None uses Vega-Lite's default (no clamping). |
+| `nice` | bool | ✓ | Round scale domain to nice values; None uses Vega-Lite's default. |
+| `padding` | float | ✓ | Unified scale padding shortcut; dispatches to band, point, or continuous padding per scale type. |
+| `headroom` | float | ✓ | Fractional breathing room at measure-axis edges, exact (never nice-rounded). Zero-anchored axes (bar; line/area/scatter near zero): domain_max = data_max * (1 + headroom). Zoomed axes (line/area/scatter far from zero): both edges expand — domain_max = data_max + headroom * span; domain_min = data_min - headroom * span. None inherits the theme default; 0 disables headroom. Ignored with an explicit `domain` or `stack: normalize`. |
+| `values` | list[Any] | ✓ | Explicit tick values; None uses Vega-Lite's auto tick values. |
+| `continuous` | [ScaleContinuousStyle](#scalecontinuousstyle) | ✓ | Continuous-scale overrides (type, domain, zero, log/pow/symlog params); None means no override. |
+| `x_reverse` | bool | ✓ | Reverse the x-axis scale direction; None means no reversal. |
+
+<a id="measuregridstyle"></a>
+## MeasureGridStyle
+Authored overlay for MeasureGridStyle. BaseAxisGridStyle + zero-baseline override for the measure (y) axis.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `visible` | bool | ✓ | Show grid lines; None inherits from parent axis. |
+| `opacity` | float | ✓ | Grid line opacity; None uses Vega-Lite's default. |
+| `width` | float | ✓ | Grid line width in pixels; None uses Vega-Lite's default. |
+| `color` | str | ✓ | Grid line color; None uses Vega-Lite's default. |
+| `dash` | list[float] | ✓ | Dash pattern for grid lines; None renders a solid line. |
+| `zero` | [AxisGridZeroStyle](#axisgridzerostyle) | ✓ | Zero-baseline gridline style; None inherits from parent axis. |
 
 <a id="axismirrorstyle"></a>
 ## AxisMirrorStyle
@@ -2300,14 +2329,19 @@ Per-edge label override for the mirrored ``axis_y.mirror`` ghost axis.
 | `format` | str | ✓ | Tick value format string for the mirrored edge; None reuses the primary axis's format. |
 | `expr` | str | ✓ | Custom Vega expression for the mirrored edge's label text; None reuses the primary axis's label expression. |
 
-<a id="scalebandstyle"></a>
-## ScaleBandStyle
-Authored overlay for ScaleBandStyle. Band mark size constraints (min/max pixel width for band-scale marks).
+<a id="scalecontinuousstyle"></a>
+## ScaleContinuousStyle
+Authored overlay for ScaleContinuousStyle. Continuous-scale-only config: type, domain, zero-baseline, log/pow/symlog params.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `min_size` | float | ✓ | Minimum band mark width in pixels; None uses Vega-Lite's default. |
-| `max_size` | float | ✓ | Maximum band mark width in pixels; None uses Vega-Lite's default. |
+| `zero` | bool \| enum: "auto" | ✓ | Force scale zero-baseline: True/False pins it; "auto" runs the Dataface smart-zero heuristic; None passes through to Vega-Lite. |
+| `type` | enum: "linear", "log", "pow", "sqrt", "symlog", "temporal" | ✓ | Scale type override. 'linear'/'log'/'pow'/'sqrt'/'symlog' pass straight through to Vega-Lite's quantitative scale.type. 'temporal' is a Dataface escape hatch for a cartesian x-axis: it forces a continuous temporal scale instead of the auto-inferred ordinal/nominal bucketed type, which is required before an authored ``domain`` of ISO dates can extend the visible range past the data extent. None lets Dataface/Vega-Lite infer from the field type. |
+| `domain` | list[Any] | ✓ | Explicit [low, high] scale domain; None lets Vega-Lite auto-determine from data. Must have exactly 2 elements — Dataface only wires a continuous range override through to Vega-Lite, not an explicit category enumeration. When ``type: temporal`` is set, both elements must be ISO-8601 date/datetime strings. |
+| `domain_strategy` | enum: "stable", "auto" | ✓ | How the numeric domain responds to filter-variable changes when no explicit `domain` is authored. 'stable' (the default when None) pins the domain to the chart query's full unfiltered extent — the same value lands at the same pixel across variable changes. 'auto' rescales the domain to the current filtered subset on every variable change. An explicit `domain` always wins over either strategy. |
+| `log` | [ScaleLogStyle](#scalelogstyle) | ✓ | Log-scale param (base); only meaningful with type: log. |
+| `pow` | [ScalePowStyle](#scalepowstyle) | ✓ | Power-scale param (exponent); only meaningful with type: pow. |
+| `symlog` | [ScaleSymlogStyle](#scalesymlogstyle) | ✓ | Symlog-scale param (constant); only meaningful with type: symlog. |
 
 <a id="rulestyle"></a>
 ## RuleStyle
@@ -2684,6 +2718,15 @@ Authored overlay for RangeDefaults.
 | `default_max` | float | ✓ | Default maximum value for range inputs. |
 | `default_step` | float | ✓ | Default step size for range inputs. |
 
+<a id="axislabeloverlapconfig"></a>
+## AxisLabelOverlapConfig
+Authored overlay for AxisLabelOverlapConfig. Two-bool overlap strategy enablement for x-axis labels.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `tilt` | bool | ✓ | Enable label tilt strategy; None inherits from parent axis. |
+| `skip` | bool | ✓ | Enable temporal label thinning; ignored on categorical axes; None inherits from parent axis. |
+
 <a id="axisgridzerostyle"></a>
 ## AxisGridZeroStyle
 Authored overlay for AxisGridZeroStyle. Zero-baseline gridline color and width overrides.
@@ -2693,14 +2736,29 @@ Authored overlay for AxisGridZeroStyle. Zero-baseline gridline color and width o
 | `color` | str | ✓ | Color of the zero-baseline grid line; None inherits from parent axis. |
 | `width` | float | ✓ | Width of the zero-baseline grid line in pixels; None inherits from parent axis. |
 
-<a id="axislabeloverlapconfig"></a>
-## AxisLabelOverlapConfig
-Authored overlay for AxisLabelOverlapConfig. Two-bool overlap strategy enablement for x-axis labels.
+<a id="scalelogstyle"></a>
+## ScaleLogStyle
+Authored overlay for ScaleLogStyle. Log-scale-only param.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `tilt` | bool | ✓ | Enable label tilt strategy; None inherits from parent axis. |
-| `skip` | bool | ✓ | Enable temporal label thinning; ignored on categorical axes; None inherits from parent axis. |
+| `base` | float | ✓ | Log base; only meaningful with type: log. None lets Vega-Lite apply its own default (10). |
+
+<a id="scalepowstyle"></a>
+## ScalePowStyle
+Authored overlay for ScalePowStyle. Power-scale-only param.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `exponent` | float | ✓ | Power exponent; only meaningful with type: pow. None uses Vega-Lite's default. |
+
+<a id="scalesymlogstyle"></a>
+## ScaleSymlogStyle
+Authored overlay for ScaleSymlogStyle. Symlog-scale-only param.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `constant` | float | ✓ | Symlog constant; only meaningful with type: symlog. None uses Vega-Lite's default. |
 
 <a id="datatablerowpaddingstyle"></a>
 ## DataTableRowPaddingStyle
@@ -2850,8 +2908,6 @@ Postgres source configuration.
 | `password` | str |  | Database password (dbt accepts pass as an input alias). |
 | `cache` | [Cache](#cache) | ✓ | Cache policy default for every query against this source, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts them out. |
 | `max_query_duration_seconds` | int | ✓ | Maximum execution time for one query in seconds. Overrides execution.max_query_duration_seconds for this source. |
-| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
-| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `attribution` | dict[str, str] | ✓ | Cost-attribution pairs sent with every query against this source, e.g. attribution: {team: analytics}. Emitted as BigQuery job labels and as a query comment elsewhere. Keys and values must match BigQuery's label rules ([a-z][a-z0-9_-]{0,62} / [a-z0-9_-]{0,63}). The dft_ prefix and the app key are reserved for the engine's own identity. |
 | `port` | int | ✓ | Database port number. |
 | `schema` | str | ✓ | Default schema for queries. |
@@ -2877,8 +2933,6 @@ Snowflake source configuration.
 | `database` | str |  | Snowflake database name. |
 | `cache` | [Cache](#cache) | ✓ | Cache policy default for every query against this source, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts them out. |
 | `max_query_duration_seconds` | int | ✓ | Maximum execution time for one query in seconds. Overrides execution.max_query_duration_seconds for this source. |
-| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
-| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `attribution` | dict[str, str] | ✓ | Cost-attribution pairs sent with every query against this source, e.g. attribution: {team: analytics}. Emitted as BigQuery job labels and as a query comment elsewhere. Keys and values must match BigQuery's label rules ([a-z][a-z0-9_-]{0,62} / [a-z0-9_-]{0,63}). The dft_ prefix and the app key are reserved for the engine's own identity. |
 | `user` | str | ✓ | Snowflake user name. Omit for token-based authentication when supported. |
 | `password` | str | ✓ | Snowflake password. Omit when using OAuth or key-pair auth. |
@@ -2919,8 +2973,6 @@ BigQuery source configuration.
 | `dataset` | str |  | BigQuery dataset name (equivalent to schema). |
 | `cache` | [Cache](#cache) | ✓ | Cache policy default for every query against this source, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts them out. |
 | `max_query_duration_seconds` | int | ✓ | Maximum execution time for one query in seconds. Overrides execution.max_query_duration_seconds for this source. |
-| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
-| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `attribution` | dict[str, str] | ✓ | Cost-attribution pairs sent with every query against this source, e.g. attribution: {team: analytics}. Emitted as BigQuery job labels and as a query comment elsewhere. Keys and values must match BigQuery's label rules ([a-z][a-z0-9_-]{0,62} / [a-z0-9_-]{0,63}). The dft_ prefix and the app key are reserved for the engine's own identity. |
 | `keyfile` | str | ✓ | Path to service account JSON key file. |
 | `keyfile_json` | dict[str, str \| int \| float \| bool] | ✓ | Inline service account JSON dict. |
@@ -2962,8 +3014,6 @@ Redshift source configuration.
 | `dbname` | str |  | Redshift database name (dbt accepts database as an input alias). |
 | `cache` | [Cache](#cache) | ✓ | Cache policy default for every query against this source, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts them out. |
 | `max_query_duration_seconds` | int | ✓ | Maximum execution time for one query in seconds. Overrides execution.max_query_duration_seconds for this source. |
-| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
-| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `attribution` | dict[str, str] | ✓ | Cost-attribution pairs sent with every query against this source, e.g. attribution: {team: analytics}. Emitted as BigQuery job labels and as a query comment elsewhere. Keys and values must match BigQuery's label rules ([a-z][a-z0-9_-]{0,62} / [a-z0-9_-]{0,63}). The dft_ prefix and the app key are reserved for the engine's own identity. |
 | `port` | int | ✓ | Redshift port number. |
 | `schema` | str | ✓ | Default schema for queries. |
@@ -2981,7 +3031,6 @@ Redshift source configuration.
 | `retries` | int | ✓ | Number of Redshift connection retry attempts. |
 | `retry_all` | bool | ✓ | Whether all connection errors are retried. |
 | `region` | str | ✓ | AWS region containing the Redshift target. |
-| `autocommit` | bool | ✓ | Whether Redshift statements autocommit. |
 | `access_key_id` | str | ✓ | AWS access key identifier. |
 | `secret_access_key` | str | ✓ | AWS secret access key. |
 | `idc_region` | str | ✓ | AWS IAM Identity Center region. |
@@ -3011,8 +3060,6 @@ MySQL source configuration.
 | `password` | str |  | MySQL password. |
 | `cache` | [Cache](#cache) | ✓ | Cache policy default for every query against this source, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts them out. |
 | `max_query_duration_seconds` | int | ✓ | Maximum execution time for one query in seconds. Overrides execution.max_query_duration_seconds for this source. |
-| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
-| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `attribution` | dict[str, str] | ✓ | Cost-attribution pairs sent with every query against this source, e.g. attribution: {team: analytics}. Emitted as BigQuery job labels and as a query comment elsewhere. Keys and values must match BigQuery's label rules ([a-z][a-z0-9_-]{0,62} / [a-z0-9_-]{0,63}). The dft_ prefix and the app key are reserved for the engine's own identity. |
 | `port` | int | ✓ | MySQL port number. |
 | `schema` | str | ✓ | Default schema for queries. |
@@ -3026,8 +3073,6 @@ DuckDB source configuration.
 | `type` | enum: "duckdb" |  | Source type identifier. |
 | `cache` | [Cache](#cache) | ✓ | Cache policy default for every query against this source, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts them out. |
 | `max_query_duration_seconds` | int | ✓ | Maximum execution time for one query in seconds. Overrides execution.max_query_duration_seconds for this source. |
-| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
-| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `path` | str | ✓ | DuckDB file path or ':memory:' for an in-memory database. |
 | `schema` | str | ✓ | Default schema for unqualified table names (sets search_path). |
 | `duckdb_config` | dict[str, str \| int \| float \| bool] | ✓ | DuckDB connection configuration values, such as enable_external_access. |
@@ -3054,8 +3099,6 @@ SQLite source configuration.
 |-------|------|:--------:|-------------|
 | `type` | enum: "sqlite" |  | Source type identifier. |
 | `path` | str |  | Path to the SQLite database file. |
-| `lookml_path` | str | ✓ | Relative path to the directory of .lkml files backing this source's models. |
-| `models` | dict[str, [LookMLModelConfig](#lookmlmodelconfig)] | ✓ | Named LookML model collections nested under this source. |
 | `cache` | [Cache](#cache) | ✓ | Cache policy default for every query against this source, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts them out. |
 
 <a id="csvsourceconfig"></a>
@@ -3065,7 +3108,7 @@ CSV file source configuration.
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
 | `type` | enum: "csv" |  | Source type identifier. |
-| `files` | dict[str, str] |  | Mapping of table_name → file path. Each key is the SQL table name; the value is the path relative to the project root. Required and must not be empty. |
+| `files` | dict[str, str] |  | Mapping of table_name → relative path or glob pattern. Each key is the SQL table name. The value is a path relative to the project root, or a glob pattern using ``*`` (matches within a directory) and ``?`` (matches one character). A glob must match at least one file; all matched files must share the same column schema and are concatenated into one table. The fan-out limit is ``execution.max_glob_file_count`` in ``dataface.yml`` (default 1000). Required and must not be empty. |
 | `cache` | [Cache](#cache) | ✓ | Cache policy default for every query against this source, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts them out. |
 | `delimiter` | str | ✓ | Field delimiter character. |
 | `encoding` | str | ✓ | File encoding. |
@@ -3077,7 +3120,7 @@ Parquet file source configuration.
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
 | `type` | enum: "parquet" |  | Source type identifier. |
-| `files` | dict[str, str] |  | Mapping of table_name → file path. Each key is the SQL table name; the value is the path relative to the project root. Required and must not be empty. |
+| `files` | dict[str, str] |  | Mapping of table_name → relative path or glob pattern. Each key is the SQL table name. The value is a path relative to the project root, or a glob pattern using ``*`` (matches within a directory) and ``?`` (matches one character). A glob must match at least one file; all matched files must share the same column schema and are concatenated into one table. The fan-out limit is ``execution.max_glob_file_count`` in ``dataface.yml`` (default 1000). Required and must not be empty. |
 | `cache` | [Cache](#cache) | ✓ | Cache policy default for every query against this source, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts them out. |
 
 <a id="jsonsourceconfig"></a>
@@ -3087,8 +3130,9 @@ JSON file source configuration.
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
 | `type` | enum: "json" |  | Source type identifier. |
-| `files` | dict[str, str] |  | Mapping of table_name → file path. Each key is the SQL table name; the value is the path relative to the project root. Required and must not be empty. |
+| `files` | dict[str, str] |  | Mapping of table_name → relative path or glob pattern. Each key is the SQL table name. The value is a path relative to the project root, or a glob pattern using ``*`` (matches within a directory) and ``?`` (matches one character). A glob must match at least one file and all matched files are concatenated into one table. The fan-out limit is ``execution.max_glob_file_count`` in ``dataface.yml`` (default 1000). Required and must not be empty. |
 | `cache` | [Cache](#cache) | ✓ | Cache policy default for every query against this source, e.g. cache: 1h — queries inherit it and may refine it; cache: false opts them out. |
+| `union_by_name` | bool | ✓ | When True, rows from different files in a glob set are unified by column name: columns absent in a particular file are filled with NULL.  When False (default), all files in a glob set must share the same column schema — a mismatch raises an error. |
 
 <a id="httpsourceconfig"></a>
 ## HttpSourceConfig
@@ -3137,13 +3181,3 @@ Cross-file chart reference. Bare string is coerced automatically.
 | Field | Type | Description |
 |-------|------|-------------|
 | `ref` | str | Reference path: '&lt;file&gt;.charts.&lt;name&gt;'. May start with one or more '../' segments to reach a sibling directory. A bare string value is coerced automatically. |
-
-<a id="lookmlmodelconfig"></a>
-## LookMLModelConfig
-One LookML model: a named collection of explores under a warehouse source.
-
-| Field | Type | Optional | Description |
-|-------|------|:--------:|-------------|
-| `lkml` | str | ✓ | Path to a specific .lkml model file, relative to the project root. |
-| `group_label` | str | ✓ | LookML group_label selecting this model's explores. Not yet enforced at compile time. |
-| `explores` | list[str] | ✓ | Explicit list of explore names in this model. |