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

dataface/agent_api/docs/yaml-reference.md

@@ -651,14 +651,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 +746,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 +777,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 +809,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 +839,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). |
@@ -1192,10 +1192,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. |
@@ -1425,58 +1425,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
@@ -2039,14 +2073,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 +2263,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 +2274,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 +2287,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 +2310,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 +2406,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 +2795,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 +2813,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
@@ -2981,7 +3116,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. |

dataface/agent_api/init.py

@@ -34,7 +34,7 @@ def init_project(
     Safe to re-run: scaffold files are skipped unless *force* is set.
     Agent markdown is never written; agent onboarding lives in installed skills.
     """
-    root = (project_dir or Path(".")).resolve()
+    root = (project_dir or Path()).resolve()
     dbt_detected = (root / "dbt_project.yml").exists()
 
     result = InitResult(project_dir=root, dbt_detected=dbt_detected)

dataface/agent_api/project_session.py

@@ -50,10 +50,11 @@ from dataface.core.render.board_links import LinkContext
 
 if TYPE_CHECKING:
     from dataface.cli.filesystem_project import FilesystemProject
-    from dataface.core.dashboard import RenderedDashboard, RenderFormat
+    from dataface.core.dashboard import RenderedDashboard
     from dataface.core.execute.file_source_materializer import FileSourceMaterializer
     from dataface.core.execute.source_resolver import SourceResolver
     from dataface.core.inspect.query_validator import RelationshipContext
+    from dataface.core.render_format import RenderFormat
 
 # Probe at module load time — single find_spec call per process.
 _SUPER_SCHEMA_AVAILABLE: bool = (