dataface 0.1.5.dev322__py3-none-any.whl → 0.1.6.dev34__py3-none-any.whl

d3_format/format.py

@@ -14,6 +14,7 @@ from __future__ import annotations
 import math
 from collections.abc import Callable
 from decimal import ROUND_HALF_UP, Decimal
+from typing import overload
 
 from d3_format.spec import FormatSpec, parse
 
@@ -520,6 +521,14 @@ def _apply_spec(spec: FormatSpec, v: float | int | Decimal) -> str:
     return _assemble(spec, sign_char, body, suffix)
 
 
+@overload
+def format(spec_str: str) -> Callable[[float | int | Decimal], str]: ...  # noqa: A001
+
+
+@overload
+def format(spec_str: str, value: float | int | Decimal) -> str: ...  # noqa: A001
+
+
 def format(  # noqa: A001
     spec_str: str,
     value: float | int | Decimal | None = None,

dataface/DATAFACE_SYNTAX.md

@@ -427,6 +427,8 @@ WHERE {{ filter('plan', plans) }}
 
 The `filter()` macro handles `select` (single value → `=`) and `multiselect` (list → `IN (...)`) automatically and quotes all string literals correctly.
 
+Select and multiselect controls render only the options the face author provides. Dataface does not add an "All" option; author a real sentinel option and matching SQL/Jinja explicitly if a dashboard needs one.
+
 ### Inline query in a chart
 
 A chart can carry its own one-off query instead of referencing a named one. Three equivalent forms:
@@ -672,6 +674,7 @@ lookup: state
 value: revenue
 
 # map — generic choropleth (alias for geoshape with named source)
+# world-countries/world-50m join on numeric TopoJSON ids such as 840, not ISO alpha codes.
 type: map
 geo_source: us-states
 lookup: state
@@ -702,8 +705,6 @@ message: "Query is disabled in this environment."
 style:
   tone: warning  # optional; defaults to info
 
-# auto — internal; engine picks the chart type from the data shape.
-type: auto
 ```
 
 ### Layered charts

dataface/__init__.py

@@ -23,7 +23,8 @@ Quick Start:
     ...
     ...     # Create executor and render
     ...     from dataface.core.compile.config import load_project_sources
-    ...     registry = build_adapter_registry(Path.cwd(), project_sources=load_project_sources(Path.cwd()))
+    ...     from dataface.core.project import Project
+    ...     registry = build_adapter_registry(Path.cwd(), project_sources=load_project_sources(Project(Path.cwd())))
     ...     executor = Executor(face, registry, query_registry=result.query_registry)
     ...     svg = render(face, executor, format="svg")
 """

dataface/agent_api/__init__.py

@@ -47,7 +47,7 @@ from dataface.agent_api.init import (
     InitResult as InitResult,
     init_project as init_project,
 )
-from dataface.agent_api.project import Project as Project
+from dataface.agent_api.project_session import ProjectSession as ProjectSession
 from dataface.agent_api.query import QueryFaceResult, query_face
 from dataface.agent_api.schema_hints import (
     SchemaHints as SchemaHints,
@@ -76,7 +76,7 @@ __all__ = [
     "DocsSearchHit",
     "InitResult",
     "LinkContext",
-    "Project",
+    "ProjectSession",
     "ProjectSourcesConfig",
     "QueryDiagnostic",
     "QueryFaceResult",

dataface/agent_api/_paths.py

@@ -73,8 +73,8 @@ def no_project_hint(project_dir: Path | None) -> str:
 class FaceRenderContext:
     """Path resolution result from a face path + project root.
 
-    Adapter registry is built by `Project.open`, not by the context — call sites
-    open a `Project` with `project_root` + `dbt_project_path` and read the
+    Adapter registry is built by `ProjectSession.open`, not by the context — call sites
+    open a `ProjectSession` with `project_root` + `dbt_project_path` and read the
     registry off `project.adapter_registry`.
     """
 
@@ -134,7 +134,7 @@ def build_face_render_context(
 class YamlRenderContext:
     """Path resolution result for rendering inline YAML against a project root.
 
-    Adapter registry is built by `Project.open`, not by the context.
+    Adapter registry is built by `ProjectSession.open`, not by the context.
     """
 
     project_root: Path

dataface/agent_api/chat.py

@@ -49,7 +49,7 @@ class ChatSession:
     def close(self) -> None:
         """Flush the session log and release the project's resources."""
         self.writer.close()
-        self.context.project.close()
+        self.context.project_session.close()
 
     def __enter__(self) -> Self:
         return self
@@ -81,13 +81,13 @@ def start_session(
         project_dir: Working directory for the session. Defaults to cwd.
         server_port: Port of the embedded HTTP preview server, if running.
     """
-    from dataface.agent_api.project import Project
+    from dataface.agent_api.project_session import ProjectSession
     from dataface.core.execute.adapters import LOCAL_AUTHORING_REGISTRY_KWARGS
 
     cwd = (project_dir or Path.cwd()).resolve()
     client = create_client(model=model)
     context = DatafaceAIContext(
-        project=Project.open(cwd, **LOCAL_AUTHORING_REGISTRY_KWARGS),
+        project_session=ProjectSession.open(cwd, **LOCAL_AUTHORING_REGISTRY_KWARGS),
         server_port=server_port,
     )
     writer, _ = new_session(cwd, provider=client.provider, model=client.model)
@@ -123,7 +123,7 @@ def resume_session(
     Raises:
         ValueError: If session not found, provider mismatch, or context window exceeded.
     """
-    from dataface.agent_api.project import Project
+    from dataface.agent_api.project_session import ProjectSession
     from dataface.core.execute.adapters import LOCAL_AUTHORING_REGISTRY_KWARGS
 
     cwd = (project_dir or Path.cwd()).resolve()
@@ -143,7 +143,7 @@ def resume_session(
         )
 
     context = DatafaceAIContext(
-        project=Project.open(cwd, **LOCAL_AUTHORING_REGISTRY_KWARGS),
+        project_session=ProjectSession.open(cwd, **LOCAL_AUTHORING_REGISTRY_KWARGS),
         server_port=server_port,
     )
     writer, _ = new_session(cwd, provider=client.provider, model=client.model)

dataface/agent_api/describe.py

@@ -87,7 +87,7 @@ class DescribeFaceArgs(BaseModel):
         default=None,
         description=(
             "Project root for resolving relative paths. Optional on the wire; "
-            "the MCP server injects ctx.project.project_root when omitted."
+            "the MCP server injects the project root when omitted."
         ),
     )
 

dataface/agent_api/docs/_loader.py

@@ -58,7 +58,7 @@ class DocsSearchHit(BaseModel):
 
 
 class DocsArgs(BaseModel):
-    """Input model for agent_api.docs — drives MCP inputSchema."""
+    """Browse the Dataface YAML reference offline. Modes: no args = topic index (slug + one-line description per H2), topic='<slug>' = one section, topic='all' = whole reference unsliced, search='<query>' = substring search across topics. Use this before writing YAML to learn field names, valid values, and examples. Call with no args first to see the available topics."""
 
     topic: str | None = Field(
         None,

dataface/agent_api/docs/yaml-reference.md

@@ -479,7 +479,7 @@ Authored overlay for Style — all fields optional. Adds CSS shorthand coercers.
 | `variables` | [VariablesStyle](#variablesstyle) | ✓ | Variable controls chrome style. |
 | `page` | [PageStyle](#pagestyle) | ✓ | Page-level canvas style (behind the board). |
 | `footer` | [FooterStyle](#footerstyle) | ✓ | Page footer chrome visibility. |
-| `timestamp` | [TimestampStyle](#timestampstyle) | ✓ | Render-timestamp chrome: visibility, format, and font. |
+| `timestamp` | [TimestampStyle](#timestampstyle) | ✓ | Render-timestamp chrome: visibility, placement, format, and font. |
 | `formats` | dict[str, str] | ✓ | Format alias map; None means no aliases at this cascade level. |
 | `palettes` | dict[str, str] | ✓ | Theme palette role assignments: open dict mapping role name to palette file name. Default seed: chrome, info, negative, positive, warning, category, sequence, diverge. |
 | `roles` | dict[str, str] | ✓ | Optional top-level theme role aliases: bare name → role.alias. e.g. ink: chrome.heading |
@@ -575,10 +575,9 @@ Authored overlay for BarChartStyle. Bar chart style: chart-level fields + marks
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -612,10 +611,9 @@ Authored overlay for LineChartStyle. Line chart style: chart-level fields + mark
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -646,10 +644,9 @@ Authored overlay for AreaChartStyle. Area chart style: chart-level fields + mark
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -681,10 +678,9 @@ Authored overlay for ScatterChartStyle. Scatter chart style: chart-level fields
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -714,10 +710,9 @@ Authored overlay for HeatmapChartStyle. Heatmap chart style.
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -758,10 +753,9 @@ Authored overlay for PieChartStyle. Pie/donut chart style: geometry + total (fla
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -787,15 +781,14 @@ Authored overlay for KpiChartStyle. Produced by cascade from theme YAML.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `font` | [FontStyle](#fontstyle) | ✓ | Chart-level font overrides. |
+| `font` | [FontStyle](#fontstyle) | ✓ | KPI chart-level font overrides; cascades from charts.font. |
 | `padding` | [PaddingStyle](#paddingstyle) | ✓ | Chart inner padding in pixels. |
 | `border` | [BorderStyle](#borderstyle) | ✓ | KPI card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -816,15 +809,14 @@ Authored overlay for TableChartStyle. Table chart style overrides layered on top
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `font` | [FontStyle](#fontstyle) | ✓ | Chart-level font overrides. |
+| `font` | [FontStyle](#fontstyle) | ✓ | Table chart-level font overrides; cascades from charts.font. |
 | `padding` | [PaddingStyle](#paddingstyle) | ✓ | Chart inner padding in pixels. |
 | `border` | [BorderStyle](#borderstyle) | ✓ | Table outer border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Table background color; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Table text color override (CSS string) or gradient scale config; None uses the theme default. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -878,10 +870,9 @@ Authored overlay for PointMapChartStyle. Point map chart style.
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -903,10 +894,9 @@ Authored overlay for GeoshapeChartStyle. Geoshape (choropleth) chart style.
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -954,7 +944,6 @@ Flat style patch for layered multi-mark charts.
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style overrides. |
 | `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style overrides. |
@@ -1111,6 +1100,8 @@ Authored overlay for TextStyle. Markdown / plain text content.
 | `line_height` | float | ✓ | Line height multiplier for text content. |
 | `align` | enum: "left", "center", "right" | ✓ | Text alignment for the face body-text block. |
 | `column` | [TextColumnStyle](#textcolumnstyle) | ✓ | Multi-column layout for the face body-text block. |
+| `code` | [TextCodeStyle](#textcodestyle) | ✓ | Inline + fenced code box styling (font, background, border). |
+| `blockquote` | [TextBlockquoteStyle](#textblockquotestyle) | ✓ | Blockquote box styling (font, background, border/left-rule). |
 
 <a id="placeholderstyle"></a>
 ## PlaceholderStyle
@@ -1135,13 +1126,13 @@ Authored overlay for ChartsStyle. Registry of all chart-type styles plus shared
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
 | `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
+| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `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. |
@@ -1223,11 +1214,13 @@ Authored overlay for FooterStyle. Authored visibility toggle for the page footer
 
 <a id="timestampstyle"></a>
 ## TimestampStyle
-Authored overlay for TimestampStyle. Authored timestamp chrome: visibility, strftime format, and font.
+Authored overlay for TimestampStyle. Authored timestamp chrome: visibility, placement, strftime format, and font.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
 | `visible` | bool | ✓ | Show the render-timestamp line. |
+| `position` | enum: "top", "footer" | ✓ | Timestamp row: top page chrome or footer baseline. |
+| `align` | enum: "left", "right" | ✓ | Timestamp horizontal alignment within its row. |
 | `format` | str | ✓ | strftime format string for the render timestamp. |
 | `font` | [FontStyle](#fontstyle) | ✓ | Timestamp font style overrides (size, color, weight, ...). |
 
@@ -1328,7 +1321,6 @@ Authored overlay for InferenceStyle.
 |-------|------|:--------:|-------------|
 | `infer_zero_when_missing` | bool | ✓ | Auto-infer zero-baseline when not authored. |
 | `infer_fields_when_missing` | bool | ✓ | Auto-infer chart fields (x, y, etc.) when not authored. |
-| `infer_type_when_auto` | bool | ✓ | Auto-infer chart type when type is 'auto'. |
 
 <a id="legendstyle"></a>
 ## LegendStyle
@@ -1457,8 +1449,8 @@ Authored overlay for BarChartMarksStyle. Bar-family mark overrides. Only bar and
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `bar` | [BarMarkStyle](#barmarkstyle) | ✓ | Bar mark overrides for bar charts; None inherits global. |
-| `text` | [TextMarkStyle](#textmarkstyle) | ✓ | Text mark overrides for bar endpoint labels; None inherits global. |
+| `bar` | [BarMarkStyle](#barmarkstyle) | ✓ | Bar mark overrides for bar charts; inherits from global. |
+| `text` | [TextMarkStyle](#textmarkstyle) | ✓ | Text mark overrides for bar endpoint labels; inherits from global. |
 
 <a id="linechartmarksstyle"></a>
 ## LineChartMarksStyle
@@ -1466,9 +1458,9 @@ Authored overlay for LineChartMarksStyle. Line-family mark overrides.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `line` | [LineMarkStyle](#linemarkstyle) | ✓ | Line mark overrides; None inherits global. |
-| `point` | [PointMarkStyle](#pointmarkstyle) | ✓ | Point mark overrides; None inherits global. |
-| `text` | [TextMarkStyle](#textmarkstyle) | ✓ | Text mark overrides; None inherits global. |
+| `line` | [LineMarkStyle](#linemarkstyle) | ✓ | Line mark overrides; inherits from global. |
+| `point` | [PointMarkStyle](#pointmarkstyle) | ✓ | Point mark overrides; inherits from global. |
+| `text` | [TextMarkStyle](#textmarkstyle) | ✓ | Text mark overrides; inherits from global. |
 | `rule` | [RuleMarkStyle](#rulemarkstyle) | ✓ | Rule mark overrides; None inherits global. |
 
 <a id="areachartmarksstyle"></a>
@@ -1477,10 +1469,10 @@ Authored overlay for AreaChartMarksStyle. Area-family mark overrides.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `area` | [AreaMarkStyle](#areamarkstyle) | ✓ | Area mark overrides; None inherits global. |
-| `line` | [LineMarkStyle](#linemarkstyle) | ✓ | Top-edge line mark overrides; None inherits global. |
-| `point` | [PointMarkStyle](#pointmarkstyle) | ✓ | Point mark overrides; None inherits global. |
-| `text` | [TextMarkStyle](#textmarkstyle) | ✓ | Text mark overrides; None inherits global. |
+| `area` | [AreaMarkStyle](#areamarkstyle) | ✓ | Area mark overrides; inherits from global. |
+| `line` | [LineMarkStyle](#linemarkstyle) | ✓ | Top-edge line mark overrides; inherits from global. |
+| `point` | [PointMarkStyle](#pointmarkstyle) | ✓ | Point mark overrides; inherits from global. |
+| `text` | [TextMarkStyle](#textmarkstyle) | ✓ | Text mark overrides; inherits from global. |
 
 <a id="scatterchartmarksstyle"></a>
 ## ScatterChartMarksStyle
@@ -1488,8 +1480,8 @@ Authored overlay for ScatterChartMarksStyle. Scatter-family mark overrides.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `point` | [PointMarkStyle](#pointmarkstyle) | ✓ | Point mark overrides; None inherits global. |
-| `text` | [TextMarkStyle](#textmarkstyle) | ✓ | Text mark overrides; None inherits global. |
+| `point` | [PointMarkStyle](#pointmarkstyle) | ✓ | Point mark overrides; inherits from global. |
+| `text` | [TextMarkStyle](#textmarkstyle) | ✓ | Text mark overrides; inherits from global. |
 
 <a id="heatmapchartmarksstyle"></a>
 ## HeatmapChartMarksStyle
@@ -1497,7 +1489,7 @@ Authored overlay for HeatmapChartMarksStyle. Heatmap-family mark overrides.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `rect` | [RectMarkStyle](#rectmarkstyle) | ✓ | Rect mark overrides; None inherits global. |
+| `rect` | [RectMarkStyle](#rectmarkstyle) | ✓ | Rect mark overrides; inherits from global. |
 | `text` | [TextMarkStyle](#textmarkstyle) | ✓ | Text mark overrides; None inherits global. |
 
 <a id="totalstyle"></a>
@@ -1515,7 +1507,7 @@ Authored overlay for PieChartMarksStyle. Pie/donut-family mark overrides.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `slice` | [SliceMarkStyle](#slicemarkstyle) | ✓ | Slice mark overrides; None inherits global. |
+| `slice` | [SliceMarkStyle](#slicemarkstyle) | ✓ | Slice mark overrides; inherits from global. |
 | `text` | [TextMarkStyle](#textmarkstyle) | ✓ | Text mark overrides; None inherits global. |
 
 <a id="kpivaluestyle"></a>
@@ -1720,7 +1712,7 @@ Authored overlay for PointMapChartMarksStyle. Point map-family mark overrides.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `point` | [PointMarkStyle](#pointmarkstyle) | ✓ | Point mark overrides; None inherits global. |
+| `point` | [PointMarkStyle](#pointmarkstyle) | ✓ | Point mark overrides; inherits from global. |
 
 <a id="geoshapechartmarksstyle"></a>
 ## GeoshapeChartMarksStyle
@@ -1728,7 +1720,7 @@ Authored overlay for GeoshapeChartMarksStyle. Geoshape-family mark overrides.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `geoshape` | [GeoshapeMarkStyle](#geoshapemarkstyle) | ✓ | Geoshape mark overrides; None inherits global. |
+| `geoshape` | [GeoshapeMarkStyle](#geoshapemarkstyle) | ✓ | Geoshape mark overrides; inherits from global. |
 
 <a id="layeraxisystyle"></a>
 ## LayerAxisYStyle
@@ -1838,6 +1830,26 @@ Authored overlay for TextColumnStyle. Multi-column layout for face body text (CS
 | `rule` | str | ✓ | CSS column-rule shorthand, e.g. '1px solid #e5e7eb'. None = no rule. |
 | `width` | float | ✓ | Minimum column width in pixels for auto-column-count derivation. |
 
+<a id="textcodestyle"></a>
+## TextCodeStyle
+Authored overlay for TextCodeStyle. Inline and fenced code spans in markdown prose. Box group; mono font by default.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `font` | [FontStyle](#fontstyle) | ✓ | Box text font overrides — full FontStyle (family, color, size, weight, style, decoration, case). |
+| `background` | str | ✓ | Box background fill. |
+| `border` | [BorderStyle](#borderstyle) | ✓ | Box border (width, color, radius). |
+
+<a id="textblockquotestyle"></a>
+## TextBlockquoteStyle
+Authored overlay for TextBlockquoteStyle. Blockquote prose. Box group; border is the left rule.
+
+| Field | Type | Optional | Description |
+|-------|------|:--------:|-------------|
+| `font` | [FontStyle](#fontstyle) | ✓ | Box text font overrides — full FontStyle (family, color, size, weight, style, decoration, case). |
+| `background` | str | ✓ | Box background fill. |
+| `border` | [BorderStyle](#borderstyle) | ✓ | Box border (width, color, radius). |
+
 <a id="placeholderoverlay"></a>
 ## PlaceholderOverlay
 Authored overlay for PlaceholderOverlay.
@@ -1908,10 +1920,9 @@ Authored overlay for HistogramChartStyle. Histogram chart style.
 | `border` | [BorderStyle](#borderstyle) | ✓ | Chart card border style. |
 | `animation_duration` | float | ✓ | Vega-Lite animation duration in milliseconds. |
 | `palette` | list[str] \| str | ✓ | Ordered list of categorical color stops or a palette name; expanded from a palette name at validation time. |
-| `dashes` | list[list[int]] | ✓ | Ordered list of Vega-Lite strokeDash arrays for line-family categorical encoding; None disables dash emission. |
 | `inference` | [InferenceStyle](#inferencestyle) | ✓ | Engine inference behavior flags. |
 | `legend` | [LegendStyle](#legendstyle) | ✓ | Chart legend style. |
-| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Chart tooltip style. |
+| `tooltip` | [TooltipStyle](#tooltipstyle) | ✓ | Per-chart-type tooltip style override; None uses the universal style.charts.tooltip. |
 | `background` | str | ✓ | Chart-local background color override; None inherits from theme. |
 | `color` | str \| [StyleColorConfig](#stylecolorconfig) | ✓ | Chart-local static mark color (CSS string) or gradient scale config; None uses the theme palette. |
 | `title` | [TitleStyle](#titlestyle) | ✓ | Chart-level title style override; None inherits the theme title style. |
@@ -2441,7 +2452,7 @@ Authored overlay for HistogramChartMarksStyle. Histogram-family mark overrides.
 
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
-| `bar` | [BarMarkStyle](#barmarkstyle) | ✓ | Bar mark overrides; None inherits global. |
+| `bar` | [BarMarkStyle](#barmarkstyle) | ✓ | Bar mark overrides; inherits from global. |
 | `rule` | [RuleMarkStyle](#rulemarkstyle) | ✓ | Rule mark overrides; None inherits global. |
 
 <a id="detailsarrowstyle"></a>

dataface/agent_api/mcp_install.py

@@ -126,9 +126,8 @@ def _upsert_mcp_config(
     existing: dict[str, Any] = {}
     if config_path.exists():
         try:
-            existing = json.loads(config_path.read_text(encoding="utf-8"))
-            if not isinstance(existing, dict):
-                existing = {}
+            loaded = json.loads(config_path.read_text(encoding="utf-8"))
+            existing = loaded if isinstance(loaded, dict) else {}
         except (json.JSONDecodeError, OSError):
             existing = {}
 

dataface/agent_api/pack.py

@@ -24,6 +24,7 @@ from dataface.core.inspect.resolver import LayeredSchemaResolver
 from dataface.core.pack.models import PackProposal, ProposedDashboard
 from dataface.core.pack.planner import SourceEntry, plan_pack
 from dataface.core.pack.proposal_store import dump_proposal
+from dataface.core.project import Project
 
 
 class ScaffoldResult(BaseModel):
@@ -168,7 +169,7 @@ def propose_pack(
         raise FileNotFoundError(f"Project directory not found: {project_dir}")
 
     registry = build_adapter_registry(
-        project_dir, project_sources=load_project_sources(project_dir)
+        project_dir, project_sources=load_project_sources(Project(project_dir))
     )
     sql_sources = registry.list_sql_sources()