dataface 0.1.5.dev384__py3-none-any.whl → 0.1.6.dev62__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

@@ -22,8 +22,8 @@ Quick Start:
     ...     face = result.face
     ...
     ...     # 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(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

@@ -11,7 +11,7 @@ from dataface.core.project_roots import (
     find_dft_root as find_dft_root,
 )
 from dataface.core.scoped_paths import (
-    resolve_scoped_path as _core_resolve_scoped_path,
+    resolve_scoped_path as resolve_scoped_path,
 )
 
 
@@ -45,26 +45,12 @@ def resolve_project_dir_from_paths(
     return resolve_project_dir(None)
 
 
-def resolve_scoped_path(path: Path, project_dir: Path | None = None) -> Path:
-    """agent_api wrapper: resolves `None → cwd-walked root` at the boundary,
-    then delegates to `core.scoped_paths.resolve_scoped_path`.
-
-    Absolute paths with no explicit `project_dir` resolve directly (no
-    containment check) — the caller supplied the path, so no project context is
-    needed to validate containment.
-    """
-    if path.is_absolute() and project_dir is None:
-        return path.resolve()
-    return _core_resolve_scoped_path(path, resolve_project_dir(project_dir))
-
-
-def no_project_hint(project_dir: Path | None) -> str:
+def no_project_hint(project_root: Path) -> str:
     """Return a hint string when no project marker is found, else empty string."""
-    check = project_dir if project_dir is not None else Path.cwd()
-    if find_dft_root(check) is not None:
+    if find_dft_root(project_root) is not None:
         return ""
     return (
-        f" No Dataface project marker found at or above {check}."
+        f" No Dataface project marker found at or above {project_root}."
         f" Run from inside a Dataface project, or set project_dir."
     )
 
@@ -73,8 +59,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 +120,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

@@ -24,6 +24,7 @@ from dataface.ai.agent import run_agent
 from dataface.ai.context import DatafaceAIContext
 from dataface.ai.events import AgentEvent
 from dataface.ai.llm import create_client
+from dataface.core.project import Project
 
 if TYPE_CHECKING:
     from dataface.ai.external_mcp import ExternalMCPManager
@@ -49,7 +50,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
@@ -71,26 +72,27 @@ class ChatSessionSummary:
 def start_session(
     *,
     model: str | None = None,
-    project_dir: Path | None = None,
+    project: Project,
     server_port: int | None = None,
 ) -> ChatSession:
     """Create a new chat session.
 
     Args:
         model: LLM model name, optionally provider-prefixed.
-        project_dir: Working directory for the session. Defaults to cwd.
+        project: The Dataface project for this session.
         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.from_project(
+            project, **LOCAL_AUTHORING_REGISTRY_KWARGS
+        ),
         server_port=server_port,
     )
-    writer, _ = new_session(cwd, provider=client.provider, model=client.model)
+    writer, _ = new_session(project.root, provider=client.provider, model=client.model)
     return ChatSession(
         session_id=writer.session_id,
         messages=[],
@@ -106,7 +108,7 @@ def start_session(
 def resume_session(
     session_id: str,
     *,
-    project_dir: Path | None = None,
+    project: Project,
     server_port: int | None = None,
     model: str | None = None,
     max_tokens: int = 32_000,
@@ -115,7 +117,7 @@ def resume_session(
 
     Args:
         session_id: The session id to resume.
-        project_dir: Working directory for the resumed session. Defaults to cwd.
+        project: The Dataface project for the resumed session.
         server_port: Port of the embedded HTTP preview server, if running.
         model: LLM model to use. Defaults to the same provider as the session.
         max_tokens: Token budget for trimming old messages. 0 disables trimming.
@@ -123,10 +125,9 @@ 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()
     client = create_client(model=model)
 
     messages, meta, _ = load_session_for_resume(
@@ -143,10 +144,12 @@ def resume_session(
         )
 
     context = DatafaceAIContext(
-        project=Project.open(cwd, **LOCAL_AUTHORING_REGISTRY_KWARGS),
+        project_session=ProjectSession.from_project(
+            project, **LOCAL_AUTHORING_REGISTRY_KWARGS
+        ),
         server_port=server_port,
     )
-    writer, _ = new_session(cwd, provider=client.provider, model=client.model)
+    writer, _ = new_session(project.root, provider=client.provider, model=client.model)
     return ChatSession(
         session_id=session_id,
         messages=messages,

dataface/agent_api/dashboards.py

@@ -18,6 +18,7 @@ from dataface.core.compile import Face, compile_file
 from dataface.core.compile.errors import DatafaceError
 from dataface.core.dashboard import RenderedDashboard as RenderedDashboard
 from dataface.core.errors import DF_UNKNOWN_INTERNAL, StructuredError
+from dataface.core.project import Project
 from dataface.core.render.warnings.base import RenderWarning
 
 # ---------------------------------------------------------------------------
@@ -193,12 +194,12 @@ def list_dashboards(
 def get_dashboard(
     path: Path,
     *,
-    project_dir: Path,
+    project: Project,
     include_raw: bool = False,
 ) -> CompiledDashboard:
     """Get the compiled structure of a dashboard."""
     try:
-        file_path = resolve_scoped_path(path, project_dir)
+        file_path = resolve_scoped_path(path, project.root)
     except ValueError as exc:
         return CompiledDashboard(
             success=False,
@@ -243,7 +244,7 @@ def get_dashboard(
             ],
         )
 
-    result = compile_file(file_path)
+    result = compile_file(file_path, project=project)
     return CompiledDashboard(
         success=result.success,
         dashboard=result.face if result.success else None,

dataface/agent_api/describe.py

@@ -21,6 +21,7 @@ from dataface.core.compile.models.query.normalized import (
     ValuesQuery,
 )
 from dataface.core.errors import DF_UNKNOWN_INTERNAL, StructuredError
+from dataface.core.project import Project
 
 # Chart-encoding fields surfaced to agents. Covers the stable channel fields
 # across chart families. `label` is excluded — it's a KPI-specific render hint,
@@ -87,7 +88,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."
         ),
     )
 
@@ -190,14 +191,14 @@ def _encoding_for_chart(chart: Chart) -> dict[str, Any]:
 # ---------------------------------------------------------------------------
 
 
-def describe_face(path: Path, *, project_dir: Path) -> DescribeFaceResult:
+def describe_face(path: Path, *, project: Project) -> DescribeFaceResult:
     """Describe the structure of a face: queries, charts, variables, layout."""
     from dataface.agent_api._paths import no_project_hint, resolve_scoped_path
     from dataface.core.compile.compiler import compile_file
     from dataface.core.compile.errors import DatafaceError
 
     try:
-        resolved = resolve_scoped_path(path, project_dir)
+        resolved = resolve_scoped_path(path, project.root)
     except ValueError as exc:
         return DescribeFaceResult(
             success=False,
@@ -210,7 +211,7 @@ def describe_face(path: Path, *, project_dir: Path) -> DescribeFaceResult:
         )
 
     if not resolved.exists():
-        hint = no_project_hint(project_dir)
+        hint = no_project_hint(project.root)
         return DescribeFaceResult(
             success=False,
             path=path,
@@ -223,7 +224,7 @@ def describe_face(path: Path, *, project_dir: Path) -> DescribeFaceResult:
         )
 
     try:
-        result = compile_file(resolved)
+        result = compile_file(resolved, project=project)
     except OSError as exc:
         return DescribeFaceResult(
             success=False,
@@ -305,7 +306,7 @@ def describe_face(path: Path, *, project_dir: Path) -> DescribeFaceResult:
 def describe_paths(
     paths: list[Path],
     *,
-    project_dir: Path,
+    project: Project,
 ) -> list[DescribeFaceResult]:
     """Describe N face files / directories.
 
@@ -315,13 +316,13 @@ def describe_paths(
     """
     out: list[DescribeFaceResult] = []
     for p in paths:
-        out.extend(_describe_one_path(p, project_dir))
+        out.extend(_describe_one_path(p, project))
     return out
 
 
 def _describe_one_path(
     path: Path,
-    project_dir: Path,
+    project: Project,
 ) -> list[DescribeFaceResult]:
     """Per-argv expansion: file → [one], dir → walk."""
     # WHY: dataface.core.inspect.manifest_utils triggers the inspect package
@@ -332,7 +333,7 @@ def _describe_one_path(
     from dataface.core.inspect.manifest_utils import INSPECT_TEMPLATE_MANIFEST
 
     try:
-        resolved = resolve_scoped_path(path, project_dir)
+        resolved = resolve_scoped_path(path, project.root)
     except ValueError as exc:
         return [
             DescribeFaceResult(
@@ -347,7 +348,7 @@ def _describe_one_path(
         ]
 
     if not resolved.is_dir():
-        return [describe_face(resolved, project_dir=project_dir)]
+        return [describe_face(resolved, project=project)]
 
     template_dirs = {m.parent for m in resolved.glob(f"**/{INSPECT_TEMPLATE_MANIFEST}")}
     yaml_files = sorted(
@@ -368,4 +369,4 @@ def _describe_one_path(
                 ],
             )
         ]
-    return [describe_face(f, project_dir=project_dir) for f in yaml_files]
+    return [describe_face(f, project=project) for f in yaml_files]

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. |