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

dataface/DATAFACE_SYNTAX.md

@@ -705,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/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
@@ -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. |

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()
 

dataface/agent_api/{project.py → project_session.py}

@@ -1,4 +1,4 @@
-"""Lifecycle owner of project-scoped resources for Dataface composition roots."""
+"""Session that owns project-scoped resources for Dataface composition roots."""
 
 from __future__ import annotations
 
@@ -15,8 +15,7 @@ else:
     from typing_extensions import Self
 
 # Verb-forwarder imports use SUBMODULES so test monkeypatches on the
-# module attribute affect the call site. Config-loader imports below
-# are by name; tests patch them at `dataface.agent_api.project.<name>`.
+# module attribute affect the call site.
 from dataface.agent_api import (
     dashboards as _dashboards,
     describe as _describe,
@@ -32,8 +31,6 @@ from dataface.agent_api.validate import (
 from dataface.core import dashboard as _core_dashboard
 from dataface.core.compile.config import (
     ProjectSourcesConfig,
-    get_project_warnings_ignore,
-    load_project_sources,
 )
 from dataface.core.execute.adapters.adapter_registry import (
     AdapterRegistry,
@@ -44,6 +41,7 @@ from dataface.core.inspect.query_validator import (
     QueryDiagnostic,
     validate_query as _core_validate_query,
 )
+from dataface.core.project import Project
 from dataface.core.project_roots import discover_render_context
 
 if TYPE_CHECKING:
@@ -59,17 +57,17 @@ _SUPER_SCHEMA_AVAILABLE: bool = (
 
 
 @dataclass(init=False)
-class Project:
+class ProjectSession:
     """Explicit container for project-scoped resources.
 
     Composition roots (CLI, MCP, dft serve, Cloud, A lIe, Playground) construct
-    one Project at their documented boundary and pass it (or its component
-    resources) into core. Verb methods on Project are thin forwarders to
-    agent_api functions — they unpack self.project_root so callers don't
+    one ProjectSession at their documented boundary and pass it (or its component
+    resources) into core. Verb methods on ProjectSession are thin forwarders to
+    agent_api functions — they unpack self.project.root so callers don't
     re-thread it at every call site.
     """
 
-    project_root: Path
+    project: Project
     cache: DuckDBCache | None
     _owns_registry: bool
     _read_only: bool
@@ -80,17 +78,15 @@ class Project:
     _duckdb_config: dict[str, Any] | None
     _allow_external_access_in_readonly: bool
     _resolver: SourceResolver | None
-    _sources: ProjectSourcesConfig
-    _warnings_ignore: frozenset[str]
 
     def __init__(
         self,
-        project_root: Path,
+        project: Project,
         cache: DuckDBCache | None = None,
         adapter_registry: AdapterRegistry | None = None,
         read_only: bool = True,
     ) -> None:
-        self.project_root = project_root
+        self.project = project
         self.cache = cache
         # We own the registry only when we'll lazy-build it ourselves. An injected
         # registry belongs to the caller; we use it but don't close it on their behalf.
@@ -107,8 +103,6 @@ class Project:
         self._duckdb_config = None
         self._allow_external_access_in_readonly = False
         self._resolver = None
-        self._sources = load_project_sources(self.project_root)
-        self._warnings_ignore = get_project_warnings_ignore(self.project_root)
 
     @classmethod
     def open(
@@ -125,7 +119,7 @@ class Project:
         allow_external_access_in_readonly: bool = False,
         resolver: SourceResolver | None = None,
     ) -> Self:
-        """Construct a Project rooted at *project_dir*.
+        """Construct a ProjectSession rooted at *project_dir*.
 
         Cache lifecycle belongs to the caller: pass ``cache=open_cache_from_env()``
         (or another DuckDBCache) when persistent caching is desired, otherwise omit
@@ -136,17 +130,19 @@ class Project:
         Call ``refresh()`` to close the current registry and force a rebuild on the
         next access.
         """
-        project = cls(
-            project_root=Path(project_dir).resolve(), cache=cache, read_only=read_only
+        session = cls(
+            project=Project(Path(project_dir).resolve()),
+            cache=cache,
+            read_only=read_only,
         )
-        project._dbt_project_path = dbt_project_path
-        project._connection_string = connection_string
-        project._dialect = dialect
-        project._target = target
-        project._duckdb_config = duckdb_config
-        project._allow_external_access_in_readonly = allow_external_access_in_readonly
-        project._resolver = resolver
-        return project
+        session._dbt_project_path = dbt_project_path
+        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
     def from_face(
@@ -156,7 +152,7 @@ class Project:
         read_only: bool = True,
         cache: DuckDBCache | None = None,
     ) -> Self:
-        """Open a Project rooted at the project directory discovered upward from face_file."""
+        """Open a ProjectSession rooted at the project directory discovered upward from face_file."""
         resolved = Path(face_file).resolve()
         project_root, dbt_project_path = discover_render_context(resolved.parent, None)
         return cls.open(
@@ -181,8 +177,8 @@ class Project:
         When constructed with an injected registry, returns it directly.
         """
         return build_adapter_registry(
-            self.project_root,
-            project_sources=self._sources,
+            self.project.root,
+            project_sources=self.project.sources,
             read_only=self._read_only,
             dbt_project_path=self._dbt_project_path,
             connection_string=self._connection_string,
@@ -197,19 +193,20 @@ class Project:
         """Policy-free rebuild primitive.
 
         For projects opened via ``open()``: closes the current registry (if built)
-        and clears it so the next access rebuilds from disk. Also re-reads
-        sources and warnings_ignore from disk.
+        and clears it so the next access rebuilds from disk. Also invalidates
+        the sources and warnings_ignore caches so the next access re-reads disk.
 
         For projects constructed with an injected ``adapter_registry``: skips the
-        registry rebuild (build arguments are not available), but still re-reads
-        the config fields.
+        registry rebuild (build arguments are not available), but still invalidates
+        the config caches.
         """
         if self._owns_registry and "adapter_registry" in self.__dict__:
             self.adapter_registry.close()
             del self.__dict__["adapter_registry"]
         self.__dict__.pop("_relationship_context", None)
-        self._sources = load_project_sources(self.project_root)
-        self._warnings_ignore = get_project_warnings_ignore(self.project_root)
+        # Rebuild Project so its cached file probes re-check disk — a
+        # dataface.yml / _sources.yaml created after open() must show up.
+        self.project = Project(self.project.root)
 
     def close(self) -> None:
         """Close the adapter registry iff we own it. The cache is the caller's to close."""
@@ -220,11 +217,11 @@ class Project:
     # Read-only views: project lifecycle owns these; external writers go through refresh().
     @property
     def sources(self) -> ProjectSourcesConfig:
-        return self._sources
+        return self.project.sources
 
     @property
     def warnings_ignore(self) -> frozenset[str]:
-        return self._warnings_ignore
+        return self.project.warnings_ignore
 
     @cached_property
     def _relationship_context(self) -> RelationshipContext | None:
@@ -234,7 +231,7 @@ class Project:
         has no relationship data.
 
         NOTE: load_relationship_context() reads target/super_schema.json relative
-        to cwd, not self.project_root. Tests must chdir to project_root. The
+        to cwd, not self.project.root. Tests must chdir to the project root. The
         follow-up task "load_relationship_context takes project_root (kill cwd
         coupling)" will fix this upstream.
         """
@@ -249,20 +246,20 @@ class Project:
     # ── Verb forwarders ──────────────────────────────────────────────────────
 
     def validate(self, face_path: Path) -> ValidateResult:
-        result = _validate.validate(face_path, project_dir=self.project_root)
-        annotated = _validate.annotate_with_data_lint([result], project=self)
+        result = _validate.validate(face_path, project_dir=self.project.root)
+        annotated = _validate.annotate_with_data_lint([result], project_session=self)
         return annotated[0]
 
     def validate_paths(self, paths: list[Path] | None) -> list[ValidateResult]:
-        results = _validate.validate_paths(paths, project_dir=self.project_root)
-        return _validate.annotate_with_data_lint(results, project=self)
+        results = _validate.validate_paths(paths, project_dir=self.project.root)
+        return _validate.annotate_with_data_lint(results, project_session=self)
 
     def _source_names(self) -> frozenset[str]:
         """Return the configured source names for /data/ alias validation.
 
         Reads from the project config file — no adapter registry or DB connection needed.
         """
-        return frozenset(self._sources.sources.keys())
+        return frozenset(self.sources.sources.keys())
 
     @overload
     def validate_query(
@@ -316,19 +313,19 @@ class Project:
         )
 
     def describe_face(self, path: Path) -> _describe.DescribeFaceResult:
-        return _describe.describe_face(path, project_dir=self.project_root)
+        return _describe.describe_face(path, project_dir=self.project.root)
 
     def describe_paths(self, paths: list[Path]) -> list[_describe.DescribeFaceResult]:
-        return _describe.describe_paths(paths, project_dir=self.project_root)
+        return _describe.describe_paths(paths, project_dir=self.project.root)
 
     def list_dashboards(
         self,
         directory: Path | None = None,
         recursive: bool = True,
     ) -> _dashboards.ListDashboardsResult:
-        """When ``directory`` is None, defaults to ``self.project_root``. When provided, callers are responsible for passing an absolute path; relative paths resolve against the process working directory."""
+        """When ``directory`` is None, defaults to ``self.project.root``. When provided, callers are responsible for passing an absolute path; relative paths resolve against the process working directory."""
         return _dashboards.list_dashboards(
-            directory=directory if directory is not None else self.project_root,
+            directory=directory if directory is not None else self.project.root,
             recursive=recursive,
         )
 
@@ -338,7 +335,7 @@ class Project:
         include_raw: bool = False,
     ) -> _dashboards.CompiledDashboard:
         return _dashboards.get_dashboard(
-            path, include_raw=include_raw, project_dir=self.project_root
+            path, include_raw=include_raw, project_dir=self.project.root
         )
 
     def lookup_face_query_sql(
@@ -347,7 +344,7 @@ class Project:
         path: Path,
     ) -> _query.FaceQueryLookupResult:
         return _query.lookup_face_query_sql(
-            name=name, path=path, project_dir=self.project_root
+            name=name, path=path, project_dir=self.project.root
         )
 
     def query_face(
@@ -360,7 +357,7 @@ class Project:
         return _query.query_face(
             name,
             path,
-            project_dir=self.project_root,
+            project_dir=self.project.root,
             vars=vars,
             limit=limit,
             adapter_registry=self.adapter_registry,
@@ -415,8 +412,8 @@ class Project:
             yaml_content=yaml_content,
             variables=variables,
             adapter_registry=self.adapter_registry,
-            project_dir=self.project_root,
-            project_sources=self.sources,
+            project_dir=self.project.root,
+            project=self.project,
             duckdb_cache=self.cache,
             format=format,
             use_cache=use_cache,