dataface 0.1.6.dev76__py3-none-any.whl → 0.1.6.dev82__py3-none-any.whl

dataface/agent_api/data_paths.py

@@ -25,6 +25,7 @@ from dataface.core.registered_views.data_urls import (
 
 if TYPE_CHECKING:
     from dataface.agent_api.schema import SchemaResponse
+    from dataface.core.project import Project
     from dataface.core.serve.alias_index import AliasIndex
 
 
@@ -186,22 +187,15 @@ def data_paths_list(
     return result
 
 
-def build_alias_index_for_project(project_dir: Path) -> AliasIndex:
-    """Build an AliasIndex from a project directory.
+def build_alias_index_for_project(project: Project) -> AliasIndex:
+    """Build an AliasIndex from a project.
 
-    Uses the same faces_at_root detection logic as the server. Intended for
-    CLI commands (dft schema --data-paths) that need alias lookup without
-    starting a server.
+    Intended for CLI commands (dft schema --data-paths) that need alias lookup
+    without starting a server.
     """
     from dataface.core.serve.alias_index import AliasIndex
 
-    faces_dir = project_dir / "faces"
-    faces_at_root = faces_dir.is_dir()
-    return AliasIndex.build(
-        project_dir=project_dir,
-        faces_dir=faces_dir,
-        faces_at_root=faces_at_root,
-    )
+    return AliasIndex.build(project, faces_at_root=project.faces_dir.is_dir())
 
 
 def data_alias_errors_for_file(

dataface/agent_api/docs/yaml-reference.md

@@ -1081,7 +1081,7 @@ Authored overlay for TitleStyle. Board and face titles.
 | Field | Type | Optional | Description |
 |-------|------|:--------:|-------------|
 | `font` | [FontStyle](#fontstyle) | ✓ | Title font style overrides. |
-| `line_height` | float | ✓ | Line height multiplier for titles and markdown headings. Headings typically want a tighter multiplier than body prose (~1.1-1.25 vs the body 1.5-1.6). |
+| `line_height` | float | ✓ | Line height multiplier for titles and markdown headings. Headings typically want a tighter multiplier than body prose. |
 | `sizes` | list[float] | ✓ | Font sizes for the H1–H6 heading ramp, indexed by ``face.level - 1``. Combined with ``width_offsets`` at render time to size titles responsively by card width. |
 | `width_offsets` | [TitleWidthOffsetsStyle](#titlewidthoffsetsstyle) | ✓ | Additive level offsets by card width (tiny/narrow/medium/wide). Added to the title's base level before indexing ``sizes``. Consumed by chart_title_spec / face_title_spec. |
 | `min_height` | float | ✓ | Minimum title row height in pixels. |

dataface/agent_api/files.py

@@ -16,6 +16,8 @@ from pathlib import Path
 
 from pydantic import BaseModel, Field
 
+from dataface.core.project import Project
+
 # Cap grep/glob payloads — read_file returns full content (model must handle size).
 _MAX_GREP_MATCHES = 200
 _MAX_GLOB_MATCHES = 500
@@ -146,9 +148,9 @@ def _walk_project(root: Path) -> list[Path]:
     return result
 
 
-def read_file(path: str, project_dir: Path) -> ReadFileResult:
+def read_file(path: str, project: Project) -> ReadFileResult:
     try:
-        target = _resolve_within(project_dir, path)
+        target = _resolve_within(project.root, path)
     except ValueError as exc:
         return ReadFileResult(success=False, path=path, error=str(exc))
     if not target.is_file():
@@ -157,12 +159,14 @@ def read_file(path: str, project_dir: Path) -> ReadFileResult:
         content = target.read_text(encoding="utf-8")
     except (OSError, UnicodeDecodeError) as exc:
         return ReadFileResult(success=False, path=path, error=str(exc))
-    return ReadFileResult(success=True, path=_rel(project_dir, target), content=content)
+    return ReadFileResult(
+        success=True, path=_rel(project.root, target), content=content
+    )
 
 
-def write_file(path: str, content: str, project_dir: Path) -> WriteFileResult:
+def write_file(path: str, content: str, project: Project) -> WriteFileResult:
     try:
-        target = _resolve_within(project_dir, path)
+        target = _resolve_within(project.root, path)
     except ValueError as exc:
         return WriteFileResult(success=False, path=path, error=str(exc))
     try:
@@ -172,16 +176,16 @@ def write_file(path: str, content: str, project_dir: Path) -> WriteFileResult:
         return WriteFileResult(success=False, path=path, error=str(exc))
     return WriteFileResult(
         success=True,
-        path=_rel(project_dir, target),
+        path=_rel(project.root, target),
         bytes_written=len(content.encode("utf-8")),
     )
 
 
 def edit_file(
-    path: str, old_string: str, new_string: str, project_dir: Path
+    path: str, old_string: str, new_string: str, project: Project
 ) -> EditFileResult:
     try:
-        target = _resolve_within(project_dir, path)
+        target = _resolve_within(project.root, path)
     except ValueError as exc:
         return EditFileResult(success=False, path=path, error=str(exc))
     if not target.is_file():
@@ -205,11 +209,11 @@ def edit_file(
         target.write_text(original.replace(old_string, new_string), encoding="utf-8")
     except OSError as exc:
         return EditFileResult(success=False, path=path, error=str(exc))
-    return EditFileResult(success=True, path=_rel(project_dir, target), replacements=1)
+    return EditFileResult(success=True, path=_rel(project.root, target), replacements=1)
 
 
-def glob_files(pattern: str, project_dir: Path) -> GlobResult:
-    root = project_dir.resolve()
+def glob_files(pattern: str, project: Project) -> GlobResult:
+    root = project.root.resolve()
     matches: list[str] = []
     try:
         candidates = root.glob(pattern)
@@ -228,8 +232,8 @@ def glob_files(pattern: str, project_dir: Path) -> GlobResult:
     return GlobResult(success=True, matches=matches)
 
 
-def grep_files(pattern: str, project_dir: Path, glob: str | None = None) -> GrepResult:
-    root = project_dir.resolve()
+def grep_files(pattern: str, project: Project, glob: str | None = None) -> GrepResult:
+    root = project.root.resolve()
     matches: list[GrepMatch] = []
     try:
         candidates: list[Path] = (

dataface/agent_api/pack.py

@@ -446,8 +446,8 @@ def apply_proposal(
     )
 
     # Ensure base dirs exist
-    (project.root / "faces").mkdir(exist_ok=True)
-    (project.root / "faces" / "partials").mkdir(exist_ok=True)
+    project.faces_dir.mkdir(exist_ok=True)
+    (project.faces_dir / "partials").mkdir(exist_ok=True)
 
     # Write partials — skipped by validate_paths (_*.yml convention)
     for partial_filename, partial_path, rel in partial_targets:

dataface/agent_api/project_session.py

@@ -253,6 +253,10 @@ class ProjectSession:
     def warnings_ignore(self) -> frozenset[str]:
         return self.project.warnings_ignore
 
+    @property
+    def faces_dir(self) -> Path:
+        return self.project.faces_dir
+
     @cached_property
     def _relationship_context(self) -> RelationshipContext | None:
         """Load relationship context from the super-schema cache (lazy, per-instance).

dataface/agent_api/validate.py

@@ -90,7 +90,7 @@ def _validate_one_path(
     # detectors. Keep this lazy so `dft --help` doesn't pay that startup cost.
     from dataface.core.inspect.manifest_utils import INSPECT_TEMPLATE_MANIFEST
 
-    raw_path = path if path is not None else project.root / "faces"
+    raw_path = path if path is not None else project.faces_dir
 
     try:
         resolved = resolve_scoped_path(raw_path, project.root)

dataface/ai/context.py

@@ -31,7 +31,7 @@ class DatafaceAIContext:
         if path.is_absolute():
             raise ValueError(f"Dashboard path must be relative: {path}")
         if self.dashboards_directory is None:
-            base_dir = (self.project_session.project.root / "faces").resolve()
+            base_dir = self.project_session.faces_dir.resolve()
         else:
             base_dir = self.dashboards_directory.resolve()
         resolved = (base_dir / path).resolve()

dataface/ai/tools/__init__.py

@@ -293,14 +293,14 @@ def _handle_get_warning_code(
 def _handle_read_file(args: dict[str, Any], ctx: DatafaceAIContext) -> dict[str, Any]:
     parsed = _files.ReadFileArgs.model_validate(args)
     return _files.read_file(
-        parsed.path, project_dir=_render_project_dir(args, ctx)
+        parsed.path, project=Project(_render_project_dir(args, ctx))
     ).model_dump(mode="json", exclude_none=True)
 
 
 def _handle_write_file(args: dict[str, Any], ctx: DatafaceAIContext) -> dict[str, Any]:
     parsed = _files.WriteFileArgs.model_validate(args)
     return _files.write_file(
-        parsed.path, parsed.content, project_dir=_render_project_dir(args, ctx)
+        parsed.path, parsed.content, project=Project(_render_project_dir(args, ctx))
     ).model_dump(mode="json", exclude_none=True)
 
 
@@ -310,14 +310,14 @@ def _handle_edit_file(args: dict[str, Any], ctx: DatafaceAIContext) -> dict[str,
         parsed.path,
         parsed.old_string,
         parsed.new_string,
-        project_dir=_render_project_dir(args, ctx),
+        project=Project(_render_project_dir(args, ctx)),
     ).model_dump(mode="json", exclude_none=True)
 
 
 def _handle_glob_files(args: dict[str, Any], ctx: DatafaceAIContext) -> dict[str, Any]:
     parsed = _files.GlobFilesArgs.model_validate(args)
     return _files.glob_files(
-        parsed.pattern, project_dir=_render_project_dir(args, ctx)
+        parsed.pattern, project=Project(_render_project_dir(args, ctx))
     ).model_dump(mode="json", exclude_none=True)
 
 
@@ -325,7 +325,7 @@ def _handle_grep_files(args: dict[str, Any], ctx: DatafaceAIContext) -> dict[str
     parsed = _files.GrepFilesArgs.model_validate(args)
     return _files.grep_files(
         parsed.pattern,
-        project_dir=_render_project_dir(args, ctx),
+        project=Project(_render_project_dir(args, ctx)),
         glob=parsed.glob,
     ).model_dump(mode="json", exclude_none=True)
 

dataface/cli/commands/schema.py

@@ -193,32 +193,31 @@ def schema_command(
             lineage_depth=lineage_depth,
             surface="cli",
         )
-
-    if data_paths:
-        if not drill_result.success:
-            print_structured_errors(
-                drill_result.structured_errors
-                or [
-                    StructuredError(
-                        code=DF_UNKNOWN_INTERNAL.code,
-                        domain=DF_UNKNOWN_INTERNAL.domain,
-                        doc_url=DF_UNKNOWN_INTERNAL.doc_url,
-                        docs_topic=DF_UNKNOWN_INTERNAL.docs_topic,
-                        message="; ".join(drill_result.errors),
-                    )
-                ]
+        if data_paths:
+            if not drill_result.success:
+                print_structured_errors(
+                    drill_result.structured_errors
+                    or [
+                        StructuredError(
+                            code=DF_UNKNOWN_INTERNAL.code,
+                            domain=DF_UNKNOWN_INTERNAL.domain,
+                            doc_url=DF_UNKNOWN_INTERNAL.doc_url,
+                            docs_topic=DF_UNKNOWN_INTERNAL.docs_topic,
+                            message="; ".join(drill_result.errors),
+                        )
+                    ]
+                )
+                raise typer.Exit(1)
+            from dataface.agent_api.data_paths import (
+                build_alias_index_for_project,
+                data_paths_list,
             )
-            raise typer.Exit(1)
-        from dataface.agent_api.data_paths import (
-            build_alias_index_for_project,
-            data_paths_list,
-        )
 
-        alias_index = build_alias_index_for_project(project_root)
-        ep_list = data_paths_list(drill_result, alias_index=alias_index)
-        wire = [p.to_dict() for p in ep_list]
-        typer.echo(json.dumps(wire, indent=2))
-        return
+            alias_index = build_alias_index_for_project(project_session.project)
+            ep_list = data_paths_list(drill_result, alias_index=alias_index)
+            wire = [p.to_dict() for p in ep_list]
+            typer.echo(json.dumps(wire, indent=2))
+            return
 
     if json_output:
         typer.echo(

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

@@ -332,8 +332,7 @@ class TitleStyle(BaseModel):
     line_height: float = Field(
         description=(
             "Line height multiplier for titles and markdown headings. Headings "
-            "typically want a tighter multiplier than body prose (~1.1-1.25 vs "
-            "the body 1.5-1.6)."
+            "typically want a tighter multiplier than body prose."
         )
     )
     sizes: list[float] = Field(

dataface/core/compile/sizing.py

@@ -77,6 +77,8 @@ from typing import TYPE_CHECKING, Any, Literal, Protocol
 
 from PIL import ImageFont
 
+from dataface.core.compile.typography import face_is_prose
+
 if TYPE_CHECKING:
     from dataface.core.compile.models.face.resolved import (
         ResolvedLayoutItem,
@@ -391,14 +393,15 @@ def compact_style_kwargs(
     color comes from ``style.title.font.color``.
 
     All prose colors derive from resolved theme tokens — no hardcoded table.
+    Paragraph spacing is derived from the body rhythm:
+    ``font_size * line_height * 0.5``.
 
     Args:
         resolved_style: Optional ResolvedStyle for color resolution. Falls back to
             the global config default when None.
         heading_font_weight: Override the heading font weight. Face titles pass
             the tier-specific weight (600 narrow, 500 medium/wide).
-        font_family: Override the body font family. Pass
-            ``config.style.title.font.family`` to render prose in serif.
+        font_family: Override the body font family used by mdsvg.
         h1_size: Override the h1 pixel size. Face titles pass the
             width-resolved pixel size from ``face_title_spec`` so the rendered
             h1 lands exactly on the responsive target. When ``None``, h1 uses
@@ -419,9 +422,9 @@ def compact_style_kwargs(
     _text_font_weight = _rs.text.font.weight
     assert _text_font_weight is not None, "style.text.font.weight must be configured"
 
-    _root_family = config.style.font.family
-    assert _root_family is not None, "style.font.family must be configured"
-    _default_family = apply_emoji_to_family(_root_family, config.style.font.emoji)
+    _text_font_family = _rs.text.font.family
+    assert _text_font_family is not None, "style.text.font.family must be configured"
+    _default_family = apply_emoji_to_family(_text_font_family, _rs.emoji_mode)
 
     title_sizes = _rs.title.sizes
     if len(title_sizes) != 6:
@@ -454,7 +457,7 @@ def compact_style_kwargs(
         "line_height": float(_rs.text.line_height),
         "heading_margin_top": 0.3,
         "heading_margin_bottom": 0.2,
-        "paragraph_spacing": 8.0,
+        "paragraph_spacing": float(_text_font_size) * float(_rs.text.line_height) * 0.5,
         "text_color": _rs.font.color,
         "heading_color": _rs.title.font.color,
         "link_color": _rs.accent,
@@ -511,6 +514,13 @@ def compact_style_kwargs(
     return kwargs
 
 
+def body_text_font_family(resolved_style: ResolvedStyle) -> str:
+    """Return the resolved body markdown family."""
+    family = resolved_style.text.font.family
+    assert family is not None, "style.text.font.family must be configured"
+    return family
+
+
 def greedy_column_fill(
     block_heights: list[float],
     n_cols: int,
@@ -631,15 +641,18 @@ def get_markdown_text_height(
         return 0.0
 
     from dataface.core.compile.jinja import resolve_jinja_template
-    from dataface.core.fonts import get_inter_font_path, get_mono_font_path
+    from dataface.core.fonts import get_font_path, get_mono_font_path
     from mdsvg import measure as measure_markdown
 
     resolved_content = resolve_jinja_template(
         text, variable_defaults or {}, strict=False
     )
 
-    font_path = str(get_inter_font_path())
-    style = get_compact_style(resolved_style)
+    _rs = resolved_style or resolve_style(get_config().style)
+    font_family = body_text_font_family(_rs)
+
+    font_path = get_font_path(font_family)
+    style = get_compact_style(_rs)
 
     if text_style is not None and text_style.column.has_overrides:
         return columned_text_height_estimate(
@@ -667,6 +680,7 @@ def get_title_height(
     level: int = 1,
     *,
     resolved_style: ResolvedStyle | None = None,
+    prose: bool = False,
 ) -> float:
     """Get the actual height needed for a title by measuring it.
 
@@ -679,6 +693,7 @@ def get_title_height(
         width: Available width for the title (drives tier selection)
         variable_defaults: Optional variable defaults for Jinja resolution
         resolved_style: Optional resolved face style for title typography measurement
+        prose: When True, measure with the theme's prose-title family.
 
     Returns:
         Actual height in pixels for the rendered title
@@ -687,7 +702,7 @@ def get_title_height(
         return 0.0
 
     from dataface.core.compile.jinja import resolve_jinja_template
-    from dataface.core.fonts import get_inter_font_path, get_mono_font_path
+    from dataface.core.fonts import get_font_path, get_mono_font_path
     from mdsvg import measure as measure_markdown
 
     # Resolve any Jinja templates using variable defaults
@@ -704,15 +719,23 @@ def get_title_height(
     # Measure the markdown to get actual dimensions (using compact style).
     # text_align is intentionally omitted: mdsvg measure() only computes
     # line-wrapped height, which is independent of horizontal alignment.
-    font_path = str(get_inter_font_path())
+    _rs = resolved_style or resolve_style(get_config().style)
+    if prose:
+        font_family = _rs.title.font.family
+        assert font_family is not None, "style.title.font.family must be configured"
+    else:
+        font_family = body_text_font_family(_rs)
+
+    font_path = get_font_path(font_family)
     size = measure_markdown(
         markdown_title,
         width=width,
         padding=0.0,
         style=get_compact_style(
-            resolved_style,
+            _rs,
             h1_size=h1_size,
             heading_font_weight=heading_weight,
+            font_family=font_family if prose else None,
         ),
         font_path=font_path,
         mono_font_path=str(get_mono_font_path()),
@@ -1008,12 +1031,14 @@ def compute_title_variables_inline_band_height(
     )
     if not face.title:
         return 0.0
+    prose = face_is_prose(face.text)
     title_h = max(
         get_title_height(
             face.title,
             title_w,
             variable_defaults,
             resolved_style=face.resolved_style,
+            prose=prose,
         ),
         float(face.resolved_style.title.min_height),
     )
@@ -1134,11 +1159,13 @@ def calculate_layout(face: Face) -> Face:
     elif face.title:
         card_pad = float(config.style.board.card_padding)
         title_measure_width = max(content_width - 2 * card_pad, 0.0)
+        prose = face_is_prose(face.text)
         title_height = get_title_height(
             face.title,
             title_measure_width,
             variable_defaults,
             resolved_style=face.resolved_style,
+            prose=prose,
         )
         container_height += title_height + effective_gap
 
@@ -1675,12 +1702,14 @@ def nested_face_sizing_context(
             nested_face, content_width, variable_defaults
         )
     elif nested_face.title:
+        prose = face_is_prose(nested_face.text)
         title_height = max(
             get_title_height(
                 nested_face.title,
                 inner,
                 variable_defaults,
                 resolved_style=nrs,
+                prose=prose,
             ),
             float(nested_face.resolved_style.title.min_height),
         )

dataface/core/compile/typography.py

@@ -29,14 +29,15 @@ Font family rules (theme-driven; values below are per-theme):
   every width. On the shipped ``default`` (and ``cream``) the title-slot
   family is serif (Source Serif 4), so medium/wide chart titles render serif
   while smaller cards stay sans for legibility.
-- Prose content and their titles: serif at any width, regardless of theme.
-  Prose is detected via ``is_prose(text)`` — true when word count ≥ 100.
+- Prose content uses the theme's text stack. Prose titles use the theme's
+  title stack at any width instead of the chart-title narrow-card fallback.
+  Prose is detected via ``is_prose(text)`` - true when word count >= 100.
 
-Page and section titles (face/board headers) always resolve to
-``style.font.family`` (sans on every shipped theme) at every width unless the
-face contains prose content.  Face titles clamp the width used for offset
-computation to the narrow boundary (≥ 360px) — a face header should never
-shrink below the narrow tier even on a narrow nested container.
+Page and section titles (face/board headers) use ``style.text.font.family`` in
+normal faces and ``style.title.font.family`` in prose faces. Face titles clamp
+the width used for offset computation to the narrow boundary (≥ 360px) — a face
+header should never shrink below the narrow tier even on a narrow nested
+container.
 
 Chart labels (axis, legend, tick) are separately themed — not controlled here.
 
@@ -47,7 +48,7 @@ Usage::
     font_size, weight, family = chart_title_spec(
         width, level=face_level + 1, resolved_chart_style=resolved_style.charts
     )
-    font_size, weight, family = face_title_spec(width, level=face_level)
+    font_size, weight = face_title_spec(width, level=face_level)
 """
 
 from __future__ import annotations
@@ -143,7 +144,8 @@ def is_prose(text: str) -> bool:
     """Return True if *text* qualifies as prose.
 
     Prose is defined as body text with at least ``_PROSE_WORD_THRESHOLD`` words.
-    Prose content and its surrounding title render in serif at any card width.
+    Prose content uses ``style.text.font.family``. Its surrounding title uses
+    ``style.title.font.family`` at any card width.
 
     Args:
         text: Raw text content (Markdown or plain).
@@ -154,6 +156,11 @@ def is_prose(text: str) -> bool:
     return len(text.split()) >= _PROSE_WORD_THRESHOLD
 
 
+def face_is_prose(text: str | None) -> bool:
+    """Return whether optional face text qualifies for prose title treatment."""
+    return is_prose(text) if text else False
+
+
 def chart_title_spec(
     width: float,
     *,
@@ -198,8 +205,8 @@ def chart_title_spec(
                 ``build_resolved_style(...).charts`` so face-local and
                 chart-local style patches are already merged in.
         use_title_family:  ``True`` forces the title-slot family even on
-                narrow/tiny cards (so prose-tagged titles use serif at every
-                width on themes that define a serif title slot). ``False``
+                narrow/tiny cards (so prose-tagged titles use the theme's
+                title family at every width). ``False``
                 forces the body family at every width. ``None`` uses the
                 width default (title-slot family at medium/wide, body family
                 at narrow/tiny).
@@ -233,19 +240,12 @@ def face_title_spec(
     *,
     level: int,
     resolved_style: ResolvedStyle | None = None,
-) -> tuple[int, int | str, str]:
-    """Return ``(font_size, font_weight, font_family)`` for a face/page title.
+) -> tuple[int, int | str]:
+    """Return ``(font_size, font_weight)`` for a face/page title.
 
     Same logic as ``chart_title_spec`` but:
     - The width used for offset computation is clamped to ``_TINY_MAX`` — a page
       header should not shrink below the narrow tier even on a narrow container.
-    - Always returns sans (Inter) regardless of width.
-
-    Note: callers that render prose faces override the returned family to serif
-    by passing ``font_family=config.style.title.font.family`` to
-    ``get_compact_style``. The function itself is family-agnostic; the prose
-    exception lives in the render layer (see ``render_title`` in
-    ``render/svg_utils.py``).
 
     Args:
         width: Pixel width of the face/board.
@@ -254,12 +254,9 @@ def face_title_spec(
             should override global config.
 
     Returns:
-        ``(font_size_px, css_font_weight, css_font_family_string)``
+        ``(font_size_px, css_font_weight)``
     """
     from dataface.core.compile.config import get_config
-    from dataface.core.compile.models.style.resolved import (
-        apply_emoji_to_family,
-    )
 
     cfg = get_config()
     title_style = (
@@ -279,10 +276,7 @@ def face_title_spec(
     font_size = int(sizes[effective_level - 1])
 
     weight = _coerce_weight(title_style.font.weight or 500)
-    _root = cfg.style.font.family
-    assert _root is not None, "style.font.family must be configured"
-    _family = apply_emoji_to_family(_root, cfg.style.font.emoji)
-    return font_size, weight, _family
+    return font_size, weight
 
 
 def face_title_markdown(
@@ -310,7 +304,7 @@ def face_title_markdown(
         ``(markdown_string, h1_size, font_weight)`` — pass to
         ``get_compact_style(h1_size=…, heading_font_weight=…)``.
     """
-    font_size, weight, _family = face_title_spec(
+    font_size, weight = face_title_spec(
         width, level=level, resolved_style=resolved_style
     )
     return f"# {title}", float(font_size), weight

dataface/core/defaults/themes/_base.yaml

@@ -74,9 +74,9 @@ style:
       size: 18
       weight: 500
       case: title
-    # Tight headline leading. Convention: larger type wants tighter line-height
-    # (Bringhurst, Butterick). At ~24px the body 1.5 multiplier reads too airy
-    # between wrapped lines; 1.1 sits in the standard 1.05-1.15 display range.
+    # Tight headline leading. Convention: larger type wants tighter line-height.
+    # At ~24px the body 1.25 multiplier reads loose between wrapped title lines;
+    # 1.1 sits in the standard display-headline range.
     line_height: 1.1
     # H1–H6 font-size ramp, indexed by face.level - 1.
     # Paired with width_offsets below — chart_title_spec computes
@@ -704,9 +704,9 @@ style:
   text:
     font:
       size:   *size_body
-    # Body leading. Convention: 1.4-1.55 for screen reading (Bringhurst ~1.5,
-    # NYT ~1.5, Medium ~1.58). 1.5 sits at the editorial standard.
-    line_height: 1.5
+    # Body leading for dense report prose. Paragraph spacing is derived from
+    # this rhythm in the mdsvg mapper, so the vertical system stays proportional.
+    line_height: 1.25
     align: left
 
   layout:

dataface/core/defaults/themes/cream.yaml

@@ -28,6 +28,15 @@ style:
   text:
     font:
       color: dft-creams.ink
+    code:
+      background: dft-creams.surface-subtle
+      border:
+        color: dft-creams.border
+    blockquote:
+      font:
+        color: dft-creams.muted
+      border:
+        color: dft-creams.border
   charts:
     # bar.border.color now tracks theme.background via self-reference at the
     # default-theme level (see stark.yaml), so the cream knockout

dataface/core/defaults/themes/stark.yaml

@@ -132,20 +132,21 @@ style:
       font:
         family: '''ui-monospace'', ''SFMono-Regular'', Menlo, Consolas, monospace'
         color: *color_ink
-      background: '#f3f4f6'
+        size: 10
+      background: dft-grays.surface-subtle
       border:
-        color: '#e5e7eb'
+        color: dft-grays.border
         width: 1
         radius: 4
 
     blockquote:
       font:
-        color: '#5f6b7a'
+        color: dft-grays.muted
         style: italic
-      background: '#f9fafb'
+      background: ''
       border:
-        color: *color_accent
-        width: 3
+        color: dft-grays.border
+        width: 2
         radius: 0
 
   variables: