dataface 0.2.1.dev490__py3-none-any.whl → 0.2.1.dev516__py3-none-any.whl

dataface/agent_api/docs/yaml-reference.md

@@ -1077,7 +1077,6 @@ Authored overlay for RootFontStyle. Root-level font configuration: FontStyle fie
 | `decoration` | enum: "none", "line-through", "underline" | ✓ | Text decoration (underline, line-through, or none). |
 | `case` | enum: "none", "sentence", "title", "upper", "lower", "slug", "camel" | ✓ | Letter-case transform applied at render time. 'title' uses Chicago/Gruber rules and preserves tokens with internal capitals (ARR, iPhone). 'sentence' uppercases only the first character. 'none' (default) emits the string without any letter-case change. |
 | `line_height` | float | ✓ | Line height as a unitless multiple of font size. Cascades through Style.font to all text roles that carry a FontStyle slot. Body prose defaults to 1.25; titles override tighter via their font patch in theme YAML. |
-| `min_size` | float | ✓ | Minimum font size in pixels; used by the axis label shrink strategy. |
 | `emoji` | enum: "monochrome", "color", "system-default", "disabled" | ✓ | Emoji rendering mode for the dashboard font stack. |
 
 <a id="borderstyle"></a>
@@ -1097,6 +1096,7 @@ Authored overlay for TitleStyle. Board and face titles.
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
 | `font` | [FontStyle](#fontstyle) | ✓ | Title font style overrides. Unset fields fall back to [`style.font`](#style). |
+| `compact_weight` | str \| float | ✓ | Object-title font weight on tiny cards. |
 | `sizes` | list[float] | ✓ | Font sizes for the H1–H6 heading ramp, indexed by ``face.level - 1``. Face/prose titles index this ramp directly (no width input). Object titles (chart/table/spark) combine ``width_offsets`` with a fixed object-title anchor to pick a slot. |
 | `width_offsets` | [TitleWidthOffsetsStyle](#titlewidthoffsetsstyle) | ✓ | Additive level offsets by card width (tiny/narrow/medium/wide). Consumed by ``chart_title_spec`` only — object titles add the tier offset to a fixed anchor to pick an H slot from ``sizes``. Face/prose titles are level-only and do not consult these. |
 | `min_height` | float | ✓ | Minimum title row height in pixels. |
@@ -1166,7 +1166,7 @@ Authored overlay for ChartsStyle. Registry of all chart-type styles plus shared
 | `geoshape` | [GeoshapeChartStyle](#geoshapechartstyle) | ✓ | Geoshape (choropleth) chart style. |
 | `point_map` | [PointMapChartStyle](#pointmapchartstyle) | ✓ | Point map chart style. |
 | `pie` | [PieChartStyle](#piechartstyle) | ✓ | Pie/donut chart style. |
-| `series_label` | [SeriesLabelStyle](#serieslabelstyle) | ✓ | Shared series-label typography for endpoint labels, stack labels, and slice callouts. |
+| `series_label` | [SeriesLabelStyle](#serieslabelstyle) | ✓ | Shared series-label typography for endpoint and stack labels. |
 | `kpi` | [KpiChartStyle](#kpichartstyle) | ✓ | KPI card chart style. |
 | `table` | [TableChartStyle](#tablechartstyle) | ✓ | Table chart style. |
 | `spark_bar` | [SparkBarChartStyle](#sparkbarchartstyle) | ✓ | Spark_bar (full-chart horizontal bar) style. |
@@ -1323,7 +1323,6 @@ Text appearance. Merged as a unit.
 | `decoration` | enum: "none", "line-through", "underline" | ✓ | Text decoration (underline, line-through, or none). |
 | `case` | enum: "none", "sentence", "title", "upper", "lower", "slug", "camel" | ✓ | Letter-case transform applied at render time. 'title' uses Chicago/Gruber rules and preserves tokens with internal capitals (ARR, iPhone). 'sentence' uppercases only the first character. 'none' (default) emits the string without any letter-case change. |
 | `line_height` | float | ✓ | Line height as a unitless multiple of font size. Cascades through Style.font to all text roles that carry a FontStyle slot. Body prose defaults to 1.25; titles override tighter via their font patch in theme YAML. |
-| `min_size` | float | ✓ | Minimum font size in pixels; used by the axis label shrink strategy. |
 
 <a id="paddingstyle"></a>
 ## PaddingStyle
@@ -1344,6 +1343,8 @@ Authored overlay for LegendStyle.
 |-------|------|:--------:|-------------|
 | `position` | str | ✓ | Legend position (e.g. 'right', 'bottom'). |
 | `direction` | str | ✓ | Legend layout direction ('vertical' or 'horizontal'). |
+| `columns` | int | ✓ | Legend entry columns. Zero keeps the renderer default; positive values set Vega-Lite legend columns. |
+| `compact_columns` | int | ✓ | Entry columns for an automatic compact top-horizontal legend. |
 | `label` | [LegendLabelStyle](#legendlabelstyle) | ✓ | Legend label style. |
 | `title` | [LegendTitleStyle](#legendtitlestyle) | ✓ | Legend title style. |
 | `visible` | bool | ✓ | Show the legend. None = legend visible; False = explicitly suppressed. |
@@ -2006,7 +2007,7 @@ Authored overlay for SeriesLabelStyle. Series-label primitive — typography for
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `font` | [FontStyle](#fontstyle) | ✓ | Series label font style overrides; cascade fills missing fields from charts.font. Unset fields fall back to [`style.charts.font`](#chartsstyle). |
+| `font` | [SeriesLabelFontStyle](#serieslabelfontstyle) | ✓ | Series label font style overrides; cascade fills missing fields from charts.font. Unset fields fall back to [`style.charts.font`](#chartsstyle). |
 
 <a id="layoutgapstyle"></a>
 ## LayoutGapStyle
@@ -2227,7 +2228,7 @@ Authored overlay for AxisElementStyle. Axis label or title: font + padding + VL-
 | `angle` | float | ✓ | Label rotation angle in degrees; None uses Vega-Lite's default. |
 | `align` | str | ✓ | Horizontal text alignment of labels; 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 shrink→tilt→skip. |
+| `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 tilt→skip. Temporal-bucketed axes ignore this and step the label cadence instead. |
 | `separation` | float | ✓ | Minimum pixel separation 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. |
@@ -2584,6 +2585,23 @@ Authored overlay for HistogramChartMarksStyle. Histogram-family mark overrides.
 | `bar` | [BarMarkStyle](#barmarkstyle) | ✓ | Bar mark overrides; inherits from global. |
 | `rule` | [RuleMarkStyle](#rulemarkstyle) | ✓ | Rule mark overrides; None inherits global. |
 
+<a id="serieslabelfontstyle"></a>
+## SeriesLabelFontStyle
+Authored overlay for SeriesLabelFontStyle. Series-label typography with a compact width-tier size.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `family` | str | ✓ | Font family name (e.g., 'sans-serif', 'Roboto'). |
+| `color` | str | ✓ | Text color as a CSS color string. |
+| `size` | float | ✓ | Font size in pixels. |
+| `weight` | str \| float | ✓ | Font weight (e.g., 'bold', 400, 700). |
+| `style` | enum: "normal", "italic" | ✓ | Font style (normal or italic). |
+| `decoration` | enum: "none", "line-through", "underline" | ✓ | Text decoration (underline, line-through, or none). |
+| `case` | enum: "none", "sentence", "title", "upper", "lower", "slug", "camel" | ✓ | Letter-case transform applied at render time. 'title' uses Chicago/Gruber rules and preserves tokens with internal capitals (ARR, iPhone). 'sentence' uppercases only the first character. 'none' (default) emits the string without any letter-case change. |
+| `line_height` | float | ✓ | Line height as a unitless multiple of font size. Cascades through Style.font to all text roles that carry a FontStyle slot. Body prose defaults to 1.25; titles override tighter via their font patch in theme YAML. |
+| `compact_size` | float | ✓ | Series-label font size in pixels on tiny and narrow cards. |
+| `compact_weight` | str \| float | ✓ | Series-label font weight on tiny and narrow cards. |
+
 <a id="detailsarrowstyle"></a>
 ## DetailsArrowStyle
 Authored overlay for DetailsArrowStyle. Layout and font style for the expand/collapse arrow chevron.
@@ -2627,11 +2645,10 @@ Authored overlay for AxisGridZeroStyle. Zero-baseline gridline color and width o
 
 <a id="axislabeloverlapconfig"></a>
 ## AxisLabelOverlapConfig
-Authored overlay for AxisLabelOverlapConfig. Three-bool overlap strategy enablement for axis labels.
+Authored overlay for AxisLabelOverlapConfig. Two-bool overlap strategy enablement for CATEGORICAL axis labels.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `shrink` | bool | ✓ | Enable font-size shrink strategy; None inherits from parent axis. |
 | `tilt` | bool | ✓ | Enable label tilt strategy; None inherits from parent axis. |
 | `skip` | bool | ✓ | Enable parity-skip strategy (drops every other label); None inherits from parent axis. |
 

dataface/agent_api/project_session.py

@@ -36,7 +36,6 @@ from dataface.core.execute.adapters.adapter_registry import (
     build_adapter_registry,
 )
 from dataface.core.execute.cache_backend import QueryResultCache
-from dataface.core.execute.observability import WarehouseObserver
 from dataface.core.inspect.query_validator import (
     QueryDiagnostic,
     validate_query as _core_validate_query,
@@ -75,11 +74,9 @@ class ProjectSession:
     _read_only: bool
     _connection_string: str | None
     _dialect: str
-    _target: str
     _duckdb_config: dict[str, Any] | None
     _allow_external_access_in_readonly: bool
     _resolver: SourceResolver | None
-    _observers: list[WarehouseObserver]
     _file_materializer: FileSourceMaterializer | None
 
     def __init__(
@@ -88,7 +85,6 @@ class ProjectSession:
         cache: QueryResultCache | None = None,
         adapter_registry: AdapterRegistry | None = None,
         read_only: bool = True,
-        observers: list[WarehouseObserver] | None = None,
         file_materializer: FileSourceMaterializer | None = None,
     ) -> None:
         self.project = project
@@ -103,11 +99,9 @@ class ProjectSession:
         self._read_only = read_only
         self._connection_string = None
         self._dialect = "duckdb"
-        self._target = "dev"
         self._duckdb_config = None
         self._allow_external_access_in_readonly = False
         self._resolver = None
-        self._observers = list(observers) if observers else []
         self._file_materializer = file_materializer
 
     @classmethod
@@ -119,11 +113,9 @@ class ProjectSession:
         read_only: bool = True,
         connection_string: str | None = None,
         dialect: str = "duckdb",
-        target: str = "dev",
         duckdb_config: dict[str, Any] | None = None,
         allow_external_access_in_readonly: bool = False,
         resolver: SourceResolver | None = None,
-        observers: list[WarehouseObserver] | None = None,
     ) -> Self:
         """Construct a ProjectSession rooted at *project_dir*.
 
@@ -142,11 +134,9 @@ class ProjectSession:
             project=FilesystemProject(Path(project_dir).resolve()),
             cache=cache,
             read_only=read_only,
-            observers=observers,
         )
         session._connection_string = connection_string
         session._dialect = dialect
-        session._target = target
         session._duckdb_config = duckdb_config
         session._allow_external_access_in_readonly = allow_external_access_in_readonly
         session._resolver = resolver
@@ -160,13 +150,8 @@ class ProjectSession:
         cache: QueryResultCache | None = None,
         adapter_registry: AdapterRegistry | None = None,
         read_only: bool = True,
-        connection_string: str | None = None,
-        dialect: str = "duckdb",
-        target: str = "dev",
         duckdb_config: dict[str, Any] | None = None,
         allow_external_access_in_readonly: bool = False,
-        resolver: SourceResolver | None = None,
-        observers: list[WarehouseObserver] | None = None,
         file_materializer: FileSourceMaterializer | None = None,
     ) -> Self:
         """Construct a ProjectSession from a pre-built Project.
@@ -185,15 +170,10 @@ class ProjectSession:
             cache=cache,
             adapter_registry=adapter_registry,
             read_only=read_only,
-            observers=observers,
             file_materializer=file_materializer,
         )
-        session._connection_string = connection_string
-        session._dialect = dialect
-        session._target = target
         session._duckdb_config = duckdb_config
         session._allow_external_access_in_readonly = allow_external_access_in_readonly
-        session._resolver = resolver
         return session
 
     @classmethod
@@ -201,13 +181,12 @@ class ProjectSession:
         cls,
         face_file: Path | str,
         *,
-        read_only: bool = True,
         cache: QueryResultCache | None = None,
     ) -> Self:
         """Open a ProjectSession rooted at the project directory discovered upward from face_file."""
         resolved = Path(face_file).resolve()
         project_root = find_project_root(resolved.parent, boundary=None)
-        return cls.open(project_root, read_only=read_only, cache=cache)
+        return cls.open(project_root, cache=cache)
 
     def __enter__(self) -> Self:
         return self
@@ -241,11 +220,9 @@ class ProjectSession:
             read_only=self._read_only,
             connection_string=self._connection_string,
             profile_type=self._dialect,
-            target=self._target,
             duckdb_config=self._duckdb_config,
             allow_external_access_in_readonly=self._allow_external_access_in_readonly,
             resolver=self._resolver,
-            observers=self._observers,
         )
 
     def refresh(self) -> None:

dataface/core/compile/compiler.py

@@ -82,8 +82,10 @@ from dataface.core.compile.parser import (
 )
 from dataface.core.compile.validator import validate_face
 from dataface.core.compile.yaml_error_formatter import (
+    find_yaml_line_number,
     format_validation_errors_structured,
 )
+from dataface.core.errors.codes_compile import DF_COMPILE_UNKNOWN_QUERY
 from dataface.core.errors.structured import StructuredError
 from dataface.core.warnings import unreferenced_chart
 from dataface.core.warnings.base import RenderWarning
@@ -187,6 +189,18 @@ def compile_authored_face(
     # ════════════════════════════════════════════════════════════════════
     validation_errors = validate_face(authored)
     if validation_errors:
+        for error in validation_errors:
+            if error.code is not DF_COMPILE_UNKNOWN_QUERY:
+                continue
+            chart_name = error.fields["chart_name"]
+            if authored.charts is None or chart_name not in authored.charts:
+                continue
+            ref_path = ["charts", chart_name, "query"]
+            line = find_yaml_line_number(_yaml_content, ref_path)
+            if line is None:
+                continue
+            error.line = line
+            error.field_path = ".".join(ref_path)
         return CompileResult(errors=[e.to_structured() for e in validation_errors])
 
     # ════════════════════════════════════════════════════════════════════
@@ -362,6 +376,17 @@ def compile_authored_face(
         errors.extend(e.structured_errors)
         return CompileResult(errors=errors)
     except ReferenceError as e:
+        if (
+            e.ref_path
+            and len(e.ref_path) >= 2
+            and e.ref_path[0] == "charts"
+            and authored.charts is not None
+            and e.ref_path[1] in authored.charts
+        ):
+            line = find_yaml_line_number(_yaml_content, list(e.ref_path))
+            if line is not None:
+                e.line = line
+                e.field_path = ".".join(e.ref_path)
         return CompileResult(errors=[e.to_structured()])
     except CompilationError as e:
         return CompileResult(errors=[e.to_structured()])

dataface/core/compile/errors.py

@@ -21,6 +21,7 @@ Refs #94
 
 from __future__ import annotations
 
+from collections.abc import Sequence
 from typing import Any
 
 from dataface.core.errors.base import DatafaceError
@@ -37,6 +38,7 @@ class CompilationError(DatafaceError):
         location: Optional location in source (line number, path, etc.)
         line: Optional line number in the YAML file
         column: Optional column number in the YAML file
+        field_path: Optional dotted path to the field that failed
         context: Optional YAML snippet showing the error location
         suggestion: Optional helpful suggestion for fixing the error
     """
@@ -48,6 +50,7 @@ class CompilationError(DatafaceError):
     location: str | None = None
     line: int | None = None
     column: int | None = None
+    field_path: str = ""
     context: str | None = None
     suggestion: str | None = None
 
@@ -57,6 +60,7 @@ class CompilationError(DatafaceError):
         location: str | None = None,
         line: int | None = None,
         column: int | None = None,
+        field_path: str = "",
         context: str | None = None,
         suggestion: str | None = None,
     ):
@@ -64,6 +68,7 @@ class CompilationError(DatafaceError):
         self.location = location
         self.line = line
         self.column = column
+        self.field_path = field_path
         self.context = context
         self.suggestion = suggestion
         self.fields: dict[str, Any] = {}
@@ -132,7 +137,7 @@ class ValidationError(CompilationError):
         ...     print(f"Validation failed at line {e.line}: {e}")
     """
 
-    field_path: str | None = None
+    field_path: str = ""
     invalid_value: str | None = None
     valid_values: list[str] | None = None
 
@@ -147,7 +152,7 @@ class ValidationError(CompilationError):
         invalid_value: str | None = None,
         valid_values: list[str] | None = None,
     ):
-        self.field_path = field_path
+        self.field_path = field_path if field_path is not None else ""
         self.invalid_value = invalid_value
         self.valid_values = valid_values
 
@@ -155,6 +160,7 @@ class ValidationError(CompilationError):
             message,
             location=location if not context else None,
             line=line,
+            field_path=field_path if field_path is not None else "",
             context=context,
             suggestion=suggestion,
         )
@@ -181,11 +187,18 @@ class ReferenceError(CompilationError):
     """
 
     ref: str | None = None
+    ref_path: tuple[str, ...] = ()
 
-    def __init__(self, ref: str, context: str | None = None):
+    def __init__(
+        self,
+        ref: str,
+        context: str | None = None,
+        ref_path: Sequence[str] = (),
+    ):
         from dataface.core.errors.codes_compile import DF_COMPILE_UNRESOLVED_REFERENCE
 
         self.ref = ref
+        self.ref_path = tuple(ref_path)
         ctx_suffix = f" in {context}" if context else ""
         message = DF_COMPILE_UNRESOLVED_REFERENCE.message_template.format(
             ref=ref, context=ctx_suffix

dataface/core/compile/models/chart/normalized/_base.py

@@ -51,8 +51,8 @@ class _BaseChartFields(BaseModel):
         default_factory=set,
         description="Variable names this chart depends on.",
     )
-    source_path: str | None = Field(
-        default=None,
+    source_path: str = Field(
+        default="",
         description="YAML path for edit-back support (e.g. 'charts.revenue').",
     )
     query_is_inline: bool = Field(

dataface/core/compile/models/chart/normalized/callout.py

@@ -31,8 +31,8 @@ class CalloutChart(BaseModel):
     style: CalloutChartStylePatch | None = Field(
         default=None, description="Chart-local style overrides."
     )
-    source_path: str | None = Field(
-        default=None,
+    source_path: str = Field(
+        default="",
         description="YAML path for edit-back support.",
     )
     variable_dependencies: set[str] = Field(

dataface/core/compile/models/face/normalized.py

@@ -66,6 +66,10 @@ class LayoutItem(BaseModel):
     face: "Face | None" = Field(
         default=None, description="Compiled face, present when type == 'face'."
     )
+    source_path: str = Field(
+        default="",
+        description="YAML path to this layout item, e.g. rows[0] or cols[1].",
+    )
 
     # Grid positioning (optional) - 0-based, in grid units
     row: int | None = Field(

dataface/core/compile/models/face/resolved.py

@@ -27,6 +27,7 @@ class ResolvedLayoutItem:
     y: float
     width: float
     height: float
+    source_path: str = ""
     # Carry-through optional fields from LayoutItem
     details_variable: str | None = None
     details_summary: str | None = None

dataface/core/compile/models/primitives.py

@@ -213,13 +213,6 @@ class FontStyle(_PatchBase):
             "defaults to 1.25; titles override tighter via their font patch in theme YAML."
         ),
     )
-    # None on most font slots; set only on axis label fonts via theme YAML.
-    # Bounds how far the shrink strategy may reduce the font before falling
-    # through to tilt or skip.
-    min_size: float | None = Field(
-        default=None,
-        description="Minimum font size in pixels; used by the axis label shrink strategy.",
-    )
 
 
 _CSS_NAMED_COLORS = frozenset(
@@ -263,9 +256,6 @@ class ResolvedFontStyle(BaseModel):
     decoration: Literal["none", "line-through", "underline"]
     case: Literal["none", "sentence", "title", "upper", "lower", "slug", "camel"]
     line_height: float
-    # None on most resolved fonts; populated only when the cascaded FontStyle
-    # carries a min_size (axis label fonts via theme YAML).
-    min_size: float | None = None
 
 
 class RuleStyle(BaseModel):

dataface/core/compile/models/style/resolved/_base.py

@@ -79,10 +79,10 @@ class ResolvedAxisLabelOverlapConfig:
     """Resolved axis label overlap strategy enablement — all fields required.
 
     True = strategy enabled; False = disabled. Fixed application order in the
-    resolver: shrink → tilt → skip.
+    resolver: tilt → skip. Categorical axes only — temporal-bucketed axes
+    step the label cadence instead (see emitters/_label_overlap.py).
     """
 
-    shrink: bool
     tilt: bool
     skip: bool
 
@@ -238,6 +238,8 @@ class ResolvedLegendStyle(BaseModel):
 
     position: str
     direction: str
+    columns: int
+    compact_columns: int
     label: ResolvedLegendElementStyle
     title: ResolvedLegendElementStyle
     interactive_legend: bool
@@ -307,8 +309,7 @@ class ResolvedChartsStyle:
     area: AreaChartStyle
     scatter: ScatterChartStyle
     view: ViewStyle
-    # Series-label primitive — shared typography for endpoint labels,
-    # direct stack labels, and slice callouts.
+    # Series-label primitive — shared typography for endpoint and stack labels.
     series_label: SeriesLabelStyle
     pie: PieChartStyle
     geoshape: GeoshapeChartStyle

dataface/core/compile/models/style/resolved/_cascade.py

@@ -101,7 +101,6 @@ def resolve_cascaded_font(font: FontStyle, path: str = "") -> ResolvedFontStyle:
         decoration=font.decoration,
         case=font.case,
         line_height=font.line_height,
-        min_size=font.min_size,
     )
 
 
@@ -469,20 +468,18 @@ def _resolve_overlap_config(
 
     Returns None when the cascade did not populate overlap (resolver will skip).
     Raises if the cascade yielded a partial struct with any None fields — the
-    theme must supply all three bools via _base.yaml so this never fires in normal
+    theme must supply both bools via _base.yaml so this never fires in normal
     operation; it fires only when overlap is present but incomplete, which signals
     a broken theme.
     """
     if overlap is None:
         return None
-    if overlap.shrink is None or overlap.tilt is None or overlap.skip is None:
+    if overlap.tilt is None or overlap.skip is None:
         raise ValueError(
             f"axis.label.overlap has None fields after cascade: {overlap!r}; "
-            "theme must supply all three bools (shrink, tilt, skip) via _base.yaml"
+            "theme must supply both bools (tilt, skip) via _base.yaml"
         )
-    return ResolvedAxisLabelOverlapConfig(
-        shrink=overlap.shrink, tilt=overlap.tilt, skip=overlap.skip
-    )
+    return ResolvedAxisLabelOverlapConfig(tilt=overlap.tilt, skip=overlap.skip)
 
 
 def build_resolved_axis(axis: AxisStyle) -> ResolvedAxisStyle:
@@ -556,6 +553,8 @@ def _build_resolved_legend(legend: LegendStyle) -> ResolvedLegendStyle:
     return ResolvedLegendStyle(
         position=legend.position,
         direction=legend.direction,
+        columns=legend.columns,
+        compact_columns=legend.compact_columns,
         visible=legend.visible,
         interactive_legend=legend.interactive_legend,
         symbol_limit=legend.symbol_limit,

dataface/core/compile/models/style/theme/__init__.py

@@ -158,6 +158,7 @@ from dataface.core.compile.models.style.theme.marks import (
     ProjectionStyle,
     RectMarkStyle,
     RuleMarkStyle,
+    SeriesLabelFontStyle,
     SeriesLabelStyle,
     SliceLabelsStyle,
     SliceMarkStyle,
@@ -321,6 +322,7 @@ __all__ = [
     "ScatterChartMarksStyle",
     "ScatterChartStyle",
     "ScatterLayerStyle",
+    "SeriesLabelFontStyle",
     "SeriesLabelStyle",
     "SliceLabelsStyle",
     "SliceMarkStyle",

dataface/core/compile/models/style/theme/axis.py

@@ -16,30 +16,27 @@ from dataface.core.compile.models.markers import (
 
 
 class AxisLabelOverlapConfig(BaseModel):
-    """Three-bool overlap strategy enablement for axis labels.
+    """Two-bool overlap strategy enablement for CATEGORICAL axis labels.
 
     Each bool enables (True) or disables (False) a strategy step.
     None means "not authored — inherit from the theme cascade."
-    The resolver applies enabled strategies in fixed order: shrink → tilt → skip.
+    The resolver applies enabled strategies in fixed order: tilt → skip.
+    Temporal-bucketed axes don't use this walk at all — they step the label
+    cadence instead (coarsen month → quarter → year at a constant font size
+    and angle=0); see resolve_axis_x_overlap in emitters/_label_overlap.py.
 
     Attributes:
-        shrink: Reduce font size to the type-stack floor (min_size) if needed.
         tilt: Walk tilt_increments and apply the first angle that fits.
         skip: Emit labelOverlap:parity (every other label dropped).
 
     Example YAML:
         overlap:
-          shrink: true
           tilt: true
           skip: true
     """
 
     model_config = ConfigDict(extra="forbid", frozen=True)
 
-    shrink: bool | None = Field(
-        default=None,
-        description="Enable font-size shrink strategy; None inherits from parent axis.",
-    )
     tilt: bool | None = Field(
         default=None,
         description="Enable label tilt strategy; None inherits from parent axis.",
@@ -261,12 +258,13 @@ class AxisElementStyle(BaseModel):
         default=None,
         description="Vertical text baseline of labels; None uses Vega-Lite's default.",
     )
-    # Three-bool struct enabling/disabling each overlap strategy.
+    # Two-bool struct enabling/disabling each overlap strategy (categorical axes
+    # only — temporal-bucketed axes step the label cadence instead).
     # None = not authored — inherit the parent axis's setting from the cascade.
     # SkipInheritSlots(cascade=True): if overlap is None on the child axis,
     # the whole struct is copied from the parent; if present, individual None
     # fields are filled from the parent (enabling partial authoring like
-    # `overlap: { tilt: false }` while inheriting shrink and skip).
+    # `overlap: { tilt: false }` while inheriting skip).
     overlap: Annotated[
         AxisLabelOverlapConfig | None,
         SkipInheritSlots(cascade=True),
@@ -275,7 +273,8 @@ class AxisElementStyle(BaseModel):
         description=(
             "Label overlap strategy enablement. None inherits from the theme cascade. "
             "Set individual bools to enable/disable; the resolver applies them in fixed "
-            "order shrink→tilt→skip."
+            "order tilt→skip. Temporal-bucketed axes ignore this and step the label "
+            "cadence instead."
         ),
     )
     separation: float | None = Field(
@@ -892,7 +891,7 @@ class AxisStyle(BaseModel):
     # Fiscal-year-start month for year/yearquarter bucket anchoring on axis_x.
     # 1 (January) is the calendar-quarter convention; any other value shifts
     # both the bucket boundaries (_enumerate_buckets) and the Q1..Q4 numbering
-    # / year-boundary detection (_is_label_opener, opens_label_period,
+    # / year-boundary detection (is_label_opener, opens_label_period,
     # _quarter_label) by the same offset. Required (like fill) since the model
     # enforces it on every axis variant; semantically only active on axis_x
     # for the year/yearquarter grains — yearmonth/yearweek/yearmonthdate

dataface/core/compile/models/style/theme/board.py

@@ -10,6 +10,7 @@ from pydantic import BaseModel, ConfigDict, Field, field_validator, model_valida
 from dataface.core.compile.models.markers import (
     InheritSlot,
     Merge,
+    SkipInheritSlots,
     Strategy,
 )
 from dataface.core.compile.models.primitives import (
@@ -312,6 +313,9 @@ class TitleStyle(BaseModel):
     font: Annotated[FontStyle, InheritSlot(from_path="Style.font")] = Field(
         default_factory=FontStyle, description="Title font style overrides."
     )
+    compact_weight: Annotated[str | float, SkipInheritSlots()] = Field(
+        description="Object-title font weight on tiny cards."
+    )
     sizes: Annotated[list[float], Merge(Strategy.OVERRIDE)] = Field(
         description=(
             "Font sizes for the H1–H6 heading ramp, indexed by ``face.level - 1``. "

dataface/core/compile/models/style/theme/charts.py

@@ -204,10 +204,10 @@ class ChartsStyle(_ChartStyleBase):
     point_map: PointMapChartStyle = Field(description="Point map chart style.")
     pie: PieChartStyle = Field(description="Pie/donut chart style.")
 
-    # Series-label primitive — typography for series-naming text marks
-    # (endpoint labels, direct stack labels, slice callouts).
+    # Series-label primitive — typography for Cartesian series-naming text marks
+    # (endpoint labels and direct stack labels).
     series_label: SeriesLabelStyle = Field(
-        description="Shared series-label typography for endpoint labels, stack labels, and slice callouts."
+        description="Shared series-label typography for endpoint and stack labels."
     )
 
     # Non-Vega chart types (required — theme pipeline always populates)

dataface/core/compile/models/style/theme/legend.py

@@ -49,6 +49,17 @@ class LegendStyle(BaseModel):
     direction: str = Field(
         description="Legend layout direction ('vertical' or 'horizontal')."
     )
+    columns: int = Field(
+        ge=0,
+        description=(
+            "Legend entry columns. Zero keeps the renderer default; positive values "
+            "set Vega-Lite legend columns."
+        ),
+    )
+    compact_columns: int = Field(
+        ge=1,
+        description="Entry columns for an automatic compact top-horizontal legend.",
+    )
     label: LegendLabelStyle = Field(description="Legend label style.")
     title: LegendTitleStyle = Field(description="Legend title style.")
     visible: bool | None = Field(