pptx-cli 1.1.0__tar.gz → 1.2.0__tar.gz

{pptx_cli-1.1.0 → pptx_cli-1.2.0}/.github/skills/pptx-deck-builder/SKILL.md

@@ -66,10 +66,6 @@ Then run the doctor to verify compatibility:
 pptx doctor --manifest ./corp-template --format json
 ```
 
-**Important:** After init, picture-type placeholders are missing `image` in
-their `supported_content_types`. Fix this before using images — see the
-image handling section below.
-
 ### Step 2 — Discover layouts and placeholders
 
 List available layouts, then inspect placeholders for the ones you plan to use:
@@ -87,7 +83,29 @@ placeholder:
 - `supported_content_types` — What it accepts (`text`, `markdown-text`,
   `image`, `table`, `chart`)
 - `required` — Whether it must be filled
-- `text_defaults` — Suggested font size, max lines
+- `estimated_text_capacity` — Preferred normalized guidance for text-capable
+  placeholders. Read `max_lines` first, then check `confidence`, `source`,
+  and `font_size_pt`.
+- `text_defaults` — Raw extracted placeholder hints such as suggested font
+  size or explicit `max_lines` from the template text
+- `left_emu`, `top_emu`, `width_emu`, `height_emu` — The actual geometry.
+  Treat `width_emu` and `height_emu` as hard constraints for how much content
+  the placeholder can realistically hold.
+
+For slide drafting, prefer `estimated_text_capacity.max_lines` over parsing
+`text_defaults.max_lines` directly. Treat it as guidance, not a hard rule:
+stay at or below the line estimate when possible, and be more conservative
+when `confidence` is `low`.
+
+Respect placeholder size in every content decision:
+
+- Text: do not write beyond the likely line budget for the box. If the message
+  does not fit, tighten the wording or choose a layout with a larger text area.
+- Images and diagrams: match the placeholder aspect ratio and expected visual
+  density to the available width and height.
+- Tables and charts: reduce rows, columns, labels, or series when the
+  placeholder is small. Prefer a larger layout over forcing dense content into
+  a small box.
 
 Also inspect theme colors and assets if you need to match the visual identity:
 
@@ -112,11 +130,14 @@ letterboxing.
 ```bash
 # Create the .excalidraw file, then:
 excal validate diagrams/my-diagram.excalidraw
-excal render diagrams/my-diagram.excalidraw --outDir ./out/diagrams --png --scale 2 --no-background
+excal render diagrams/my-diagram.excalidraw --outDir ./out/diagrams --png --scale 4 --no-background
 ```
 
 Use `--no-background` for transparent backgrounds that blend with slide
-backgrounds. Use `--scale 2` for crisp output.
+backgrounds. Use `--scale 4` for crisp output — scale 2 looks blurry on
+large slide placeholders because the pixel density is too low for the
+physical size. Scale 4 ensures diagrams stay sharp even on high-DPI
+displays and when projected.
 
 **Match the template's visual identity.** Diagrams should feel like they belong
 on the slide, not like foreign objects pasted in. Two things matter most:
@@ -190,59 +211,29 @@ Use `--dry-run` on build to preview without writing files.
 
 ---
 
-## Image handling — known issues and fixes
-
-### Picture placeholders need `image` added to supported_content_types
-
-After `pptx init`, picture-type placeholders only list `["text",
-"markdown-text"]`. You must edit `manifest.yaml` to add `- image`:
+## Image handling
 
-```yaml
-# Find all placeholder_type: picture entries and add image:
-    placeholder_type: picture
-    guidance_lines: []
-    supported_content_types:
-    - text
-    - markdown-text
-    - image          # ← add this line
-```
+### Image scaling — fit vs crop
 
-Use a replace-all to fix every occurrence at once.
+Picture placeholders should already advertise `image` in
+`supported_content_types`. Do not patch `manifest.yaml` unless inspection
+output proves the template contract is actually wrong.
 
-### Image scaling — fit vs crop
+The current build behavior defaults to `image_fit: fit`, which preserves the
+full image inside the placeholder. Use `image_fit: cover` when you explicitly
+want crop-to-fill behavior.
 
-The default `insert_picture` behavior crops to fill, which clips content when
-aspect ratios differ. The composition code should be patched to scale images to
-fit within placeholder bounds instead. The fix in
-`pptx_cli/core/composition.py` replaces the image insertion block:
-
-```python
-# After insert_picture, reset crops and scale to fit:
-ph_left, ph_top = shape.left, shape.top
-ph_width, ph_height = shape.width, shape.height
-pic = shape.insert_picture(str(image_path))
-pic.crop_left = pic.crop_right = pic.crop_top = pic.crop_bottom = 0
-img = pic.image
-img_w, img_h = img.size
-img_aspect = img_w / img_h
-ph_aspect = ph_width / ph_height
-if img_aspect > ph_aspect:
-    new_width = ph_width
-    new_height = int(ph_width / img_aspect)
-else:
-    new_height = ph_height
-    new_width = int(ph_height * img_aspect)
-pic.left = ph_left + (ph_width - new_width) // 2
-pic.top = ph_top + (ph_height - new_height) // 2
-pic.width = new_width
-pic.height = new_height
+```yaml
+slides:
+  - layout: picture-layout-id
+    content:
+      title: Workflow
+      picture:
+        kind: image
+        path: out/diagrams/workflow.png
+        image_fit: fit
 ```
 
-Check whether this patch is already applied before applying it. Read the
-`_apply_content_value` function in `composition.py` — if it only has
-`shape.insert_picture(str(image_path))` with no scaling logic, the patch
-is needed.
-
 ---
 
 ## Slide writing principles
@@ -262,6 +253,17 @@ conclude — not just name the topic.
 If a slide has two insights, split it into two slides. The body must prove
 the headline.
 
+### Respect placeholder geometry
+
+Never treat placeholder size as flexible. The template geometry is part of the
+contract.
+
+- If text exceeds the placeholder's likely capacity, shorten it or split it.
+- If a table or chart needs more room, switch to a layout with a larger object
+  placeholder.
+- If a diagram becomes unreadable at the placeholder's size, simplify the
+  diagram rather than shrinking text and shapes until they are illegible.
+
 ### Source attribution
 
 Data-driven slides need source lines. Use the `source` placeholder when
@@ -285,7 +287,7 @@ Match content to the right layout:
 | Content type | Suggested layout patterns |
 |---|---|
 | Opening / title | front-page layouts (with pattern or picture) |
-| Agenda / TOC | agenda layouts |
+| Agenda / TOC | agenda layouts (use plain text items without numbered prefixes — the layout often auto-numbers) |
 | Section divider | breaker layouts |
 | Single topic with bullets | title-and-content |
 | Side-by-side comparison | two-contents |
@@ -323,7 +325,7 @@ pptx validate --manifest ./manifest-dir --deck deck.pptx --strict --format json
 
 # Diagrams
 excal validate diagram.excalidraw
-excal render diagram.excalidraw --outDir ./out --png --scale 2 --no-background
+excal render diagram.excalidraw --outDir ./out --png --scale 4 --no-background
 
 # Template versioning
 pptx manifest diff ./v1-manifest ./v2-manifest --format json

{pptx_cli-1.1.0 → pptx_cli-1.2.0}/.github/skills/pptx-deck-builder/references/excal-diagrams.md

@@ -18,7 +18,7 @@ excal validate diagram.excalidraw --check-assets
 ### excal render <file|->
 Render to SVG, PNG, or PDF. PNG/PDF require Playwright.
 ```bash
-excal render diagram.excalidraw --outDir ./out --png --scale 2 --no-background
+excal render diagram.excalidraw --outDir ./out --png --scale 4 --no-background
 excal render diagram.excalidraw --outDir ./out --svg
 excal render diagram.excalidraw --outDir ./out --png --dark-mode
 excal render diagram.excalidraw --outDir ./out --png --frame "Frame Name"
@@ -31,7 +31,7 @@ Flags:
 - `--pdf` — Export PDF (requires Playwright)
 - `--dark-mode` — Dark theme
 - `--no-background` — Transparent background
-- `--scale <n>` — Scale factor for PNG (default: 2)
+- `--scale <n>` — Scale factor for PNG (default: 2, use 4 for slide-quality output)
 - `--padding <n>` — Padding in pixels (default: 20)
 - `--frame <id|name>` — Export specific frame only
 - `--element <id>` — Export specific element only

{pptx_cli-1.1.0 → pptx_cli-1.2.0}/.github/skills/pptx-deck-builder/references/pptx-workflow.md

@@ -58,9 +58,18 @@ Key fields per placeholder:
 - `supported_content_types` — Array of: text, markdown-text, image, table, chart
 - `required` — Boolean
 - `overflow_policy` — fit, warn, or truncate
-- `text_defaults` — Object with suggested_font_size_pt, max_lines, alignment
+- `estimated_text_capacity` — Preferred agent guidance with `max_lines`,
+  `confidence`, `source`, and inferred typography metadata
+- `text_defaults` — Raw extracted placeholder hints with fields such as
+  `suggested_font_size_pt`, `max_lines`, and `alignment`
 - `left_emu`, `top_emu`, `width_emu`, `height_emu` — Position/size in EMUs
 
+Treat placeholder geometry as a hard layout constraint:
+- Text should stay within the likely line budget for the box.
+- Images and diagrams should match the placeholder aspect ratio.
+- Tables and charts should be simplified or moved to a larger layout when the
+  placeholder is too small for legible output.
+
 ### pptx theme show --manifest <dir>
 Show theme metadata: colors, fonts, effects.
 ```bash

{pptx_cli-1.1.0 → pptx_cli-1.2.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: pptx-cli
-Version: 1.1.0
+Version: 1.2.0
 Summary: Template-bound PowerPoint generation for enterprise decks
 Author: Thomas Rohde
 License: MIT License
@@ -81,6 +81,7 @@ The result is a CLI that behaves more like a compiler toolchain than a drawing t
 
 - Initialize a manifest package from a real enterprise `.pptx`
 - Inspect layouts, placeholders, themes, assets, and compatibility warnings
+- Estimate text placeholder line capacity for agent guidance during inspection
 - Build slides from approved layouts only
 - Build full decks from JSON/YAML specs
 - Preserve template-bound masters, themes, geometry, and protected elements
@@ -139,6 +140,10 @@ pptx layouts show title-only --manifest ./corp-template
 pptx placeholders list 1-title-and-content --manifest ./corp-template
 ```
 
+`pptx placeholders list --format json` includes both explicit placeholder guidance and
+an `estimated_text_capacity` block for text-capable placeholders so agents can stay
+inside likely line limits when drafting slide content.
+
 Create a single slide:
 
 ```bash

{pptx_cli-1.1.0 → pptx_cli-1.2.0}/README.md

@@ -35,6 +35,7 @@ The result is a CLI that behaves more like a compiler toolchain than a drawing t
 
 - Initialize a manifest package from a real enterprise `.pptx`
 - Inspect layouts, placeholders, themes, assets, and compatibility warnings
+- Estimate text placeholder line capacity for agent guidance during inspection
 - Build slides from approved layouts only
 - Build full decks from JSON/YAML specs
 - Preserve template-bound masters, themes, geometry, and protected elements
@@ -93,6 +94,10 @@ pptx layouts show title-only --manifest ./corp-template
 pptx placeholders list 1-title-and-content --manifest ./corp-template
 ```
 
+`pptx placeholders list --format json` includes both explicit placeholder guidance and
+an `estimated_text_capacity` block for text-capable placeholders so agents can stay
+inside likely line limits when drafting slide content.
+
 Create a single slide:
 
 ```bash

{pptx_cli-1.1.0 → pptx_cli-1.2.0}/src/pptx_cli/__init__.py

@@ -2,4 +2,4 @@
 
 __all__ = ["__version__"]
 
-__version__ = "1.1.0"
+__version__ = "1.2.0"

{pptx_cli-1.1.0 → pptx_cli-1.2.0}/src/pptx_cli/core/template.py

@@ -1,6 +1,7 @@
 from __future__ import annotations
 
 import hashlib
+import math
 import re
 import shutil
 import zipfile
@@ -29,13 +30,18 @@ from pptx_cli.models.manifest import (
     PlaceholderContract,
     ProtectedElement,
     TemplateInfo,
+    TextCapacityGuidance,
     ThemeModel,
 )
 
 _DRAWINGML_NS = {"a": "http://schemas.openxmlformats.org/drawingml/2006/main"}
+_PRESENTATIONML_NS = {"p": "http://schemas.openxmlformats.org/presentationml/2006/main"}
+_PPTX_NS = {**_DRAWINGML_NS, **_PRESENTATIONML_NS}
 _PLACEHOLDER_TYPE_NAMES = {item.value: item.name.lower() for item in PP_PLACEHOLDER}
 _IMAGE_SUFFIXES = {".png", ".jpg", ".jpeg", ".gif", ".bmp", ".svg", ".tif", ".tiff"}
 _MEDIA_SUFFIXES = {".mp4", ".wmv", ".avi", ".mov", ".mp3", ".wav", ".m4v"}
+_EMU_PER_POINT = 12700
+_DEFAULT_LINE_HEIGHT_MULTIPLIER = 1.2
 _NUMBER_WORDS = {
     "one": 1,
     "two": 2,
@@ -172,6 +178,188 @@ def _extract_text_defaults(shape: Any) -> dict[str, Any]:
     return {key: value for key, value in defaults.items() if value not in (None, [], "")}
 
 
+def _emu_to_points(value: int) -> float:
+    return round(value / _EMU_PER_POINT, 2)
+
+
+def _placeholder_text_style_bucket(placeholder_type: str) -> str:
+    if placeholder_type in {"title", "center_title", "vertical_title"}:
+        return "title"
+    if placeholder_type in {"body", "object", "content", "text", "subtitle"}:
+        return "body"
+    return "other"
+
+
+def _extract_master_text_styles(master: Any) -> dict[str, dict[int, float]]:
+    styles: dict[str, dict[int, float]] = {}
+    for bucket, tag_name in {
+        "title": "titleStyle",
+        "body": "bodyStyle",
+        "other": "otherStyle",
+    }.items():
+        style_root = master.element.find(f".//p:{tag_name}", namespaces=_PPTX_NS)
+        if style_root is None:
+            styles[bucket] = {}
+            continue
+
+        level_sizes: dict[int, float] = {}
+        default_size_pt: float | None = None
+        default_paragraph = style_root.find("./a:defPPr", namespaces=_PPTX_NS)
+        if default_paragraph is not None:
+            default_run = default_paragraph.find("./a:defRPr", namespaces=_PPTX_NS)
+            default_size_pt = _font_size_from_xml(default_run)
+
+        for level in range(1, 10):
+            paragraph_style = style_root.find(f"./a:lvl{level}pPr", namespaces=_PPTX_NS)
+            if paragraph_style is None:
+                continue
+            default_run = paragraph_style.find("./a:defRPr", namespaces=_PPTX_NS)
+            font_size_pt = _font_size_from_xml(default_run)
+            if font_size_pt is not None:
+                level_sizes[level - 1] = font_size_pt
+
+        if default_size_pt is not None:
+            level_sizes.setdefault(0, default_size_pt)
+        styles[bucket] = level_sizes
+
+    return styles
+
+
+def _font_size_from_xml(element: Any) -> float | None:
+    if element is None:
+        return None
+    size = element.get("sz")
+    if size is None:
+        return None
+    try:
+        return int(size) / 100
+    except ValueError:
+        return None
+
+
+def _resolve_font_size_pt(
+    shape: Any,
+    placeholder_type: str,
+    text_defaults: dict[str, Any],
+    master_text_styles: dict[str, dict[int, float]],
+) -> tuple[float | None, str | None]:
+    suggested_size = text_defaults.get("suggested_font_size_pt")
+    if suggested_size is not None:
+        return float(suggested_size), "guidance_text"
+
+    text_frame = getattr(shape, "text_frame", None)
+    if text_frame is not None:
+        for paragraph in text_frame.paragraphs:
+            if paragraph.font.size is not None:
+                return float(paragraph.font.size.pt), "paragraph_font"
+            for run in paragraph.runs:
+                if run.font.size is not None:
+                    return float(run.font.size.pt), "run_font"
+
+    bucket = _placeholder_text_style_bucket(placeholder_type)
+    text_level = 0
+    if text_frame is not None and text_frame.paragraphs:
+        text_level = int(text_frame.paragraphs[0].level or 0)
+    bucket_styles = master_text_styles.get(bucket, {})
+    font_size_pt = bucket_styles.get(text_level)
+    if font_size_pt is not None:
+        return float(font_size_pt), "master_text_style"
+    if bucket != "other":
+        font_size_pt = master_text_styles.get("other", {}).get(text_level)
+        if font_size_pt is not None:
+            return float(font_size_pt), "master_text_style"
+    return None, None
+
+
+def _resolve_font_family(
+    shape: Any,
+    placeholder_type: str,
+    text_defaults: dict[str, Any],
+    theme: ThemeModel,
+) -> tuple[str | None, str | None]:
+    suggested_family = text_defaults.get("suggested_font_family")
+    if suggested_family is not None:
+        return str(suggested_family), "guidance_text"
+
+    text_frame = getattr(shape, "text_frame", None)
+    if text_frame is not None:
+        for paragraph in text_frame.paragraphs:
+            if paragraph.font.name:
+                return str(paragraph.font.name), "paragraph_font"
+            for run in paragraph.runs:
+                if run.font.name:
+                    return str(run.font.name), "run_font"
+
+    bucket = _placeholder_text_style_bucket(placeholder_type)
+    if bucket == "title":
+        theme_family = theme.fonts.get("major") or theme.fonts.get("major_latin")
+    else:
+        theme_family = theme.fonts.get("minor") or theme.fonts.get("minor_latin")
+    if theme_family is None:
+        theme_family = theme.fonts.get("major") or theme.fonts.get("minor")
+    if theme_family is None:
+        return None, None
+    return theme_family, "theme"
+
+
+def _estimate_text_capacity(
+    shape: Any,
+    placeholder_type: str,
+    supported_content_types: list[str],
+    text_defaults: dict[str, Any],
+    master_text_styles: dict[str, dict[int, float]],
+    theme: ThemeModel,
+) -> TextCapacityGuidance | None:
+    if "text" not in supported_content_types and "markdown-text" not in supported_content_types:
+        return None
+
+    text_frame = getattr(shape, "text_frame", None)
+    if text_frame is None:
+        return None
+
+    font_size_pt, font_size_source = _resolve_font_size_pt(
+        shape,
+        placeholder_type,
+        text_defaults,
+        master_text_styles,
+    )
+    if font_size_pt is None:
+        return None
+
+    font_family, _ = _resolve_font_family(shape, placeholder_type, text_defaults, theme)
+    margin_top = int(text_frame.margin_top or 0)
+    margin_bottom = int(text_frame.margin_bottom or 0)
+    usable_height_emu = max(int(shape.height) - margin_top - margin_bottom, 0)
+    usable_height_pt = _emu_to_points(usable_height_emu)
+    if usable_height_pt <= 0:
+        return None
+
+    line_height_pt = round(font_size_pt * _DEFAULT_LINE_HEIGHT_MULTIPLIER, 2)
+    explicit_max_lines = text_defaults.get("max_lines")
+    if explicit_max_lines is not None:
+        return TextCapacityGuidance(
+            max_lines=int(explicit_max_lines),
+            source="explicit_guidance",
+            confidence="high",
+            font_size_pt=round(font_size_pt, 2),
+            font_family=font_family,
+            usable_height_pt=usable_height_pt,
+            line_height_pt=line_height_pt,
+        )
+
+    inferred_lines = max(1, math.floor(usable_height_pt / line_height_pt))
+    confidence = "medium" if font_size_source is not None else "low"
+    return TextCapacityGuidance(
+        max_lines=inferred_lines,
+        source="inferred",
+        confidence=confidence,
+        font_size_pt=round(font_size_pt, 2),
+        font_family=font_family,
+        usable_height_pt=usable_height_pt,
+        line_height_pt=line_height_pt,
+    )
+
+
 def _extract_theme(zip_file: zipfile.ZipFile) -> ThemeModel:
     theme_candidates = [
         name
@@ -237,6 +425,7 @@ def _is_protected_placeholder(shape_name: str) -> bool:
 
 def _build_layouts(
     prs: Any,
+    theme: ThemeModel,
 ) -> tuple[list[MasterContract], list[LayoutContract], list[LayoutAnnotation]]:
     master_ids: list[MasterContract] = []
     layouts: list[LayoutContract] = []
@@ -244,9 +433,11 @@ def _build_layouts(
     layout_ids_seen: set[str] = set()
 
     master_id_map: dict[int, str] = {}
+    master_style_map: dict[int, dict[str, dict[int, float]]] = {}
     for master_index, master in enumerate(prs.slide_masters):
         master_id = f"master-{master_index + 1}"
         master_id_map[id(master)] = master_id
+        master_style_map[id(master)] = _extract_master_text_styles(master)
         master_ids.append(
             MasterContract(
                 id=master_id,
@@ -286,6 +477,15 @@ def _build_layouts(
                     logical_names_seen,
                 )
                 supported_content_types = _supports_content_types(placeholder_type, shape.name)
+                text_defaults = _extract_text_defaults(shape)
+                estimated_text_capacity = _estimate_text_capacity(
+                    shape,
+                    placeholder_type,
+                    supported_content_types,
+                    text_defaults,
+                    master_style_map.get(id(layout.slide_master), {}),
+                    theme,
+                )
                 placeholders.append(
                     PlaceholderContract(
                         logical_name=logical_name,
@@ -300,7 +500,8 @@ def _build_layouts(
                         width_emu=int(shape.width),
                         height_emu=int(shape.height),
                         required=logical_name == "title",
-                        text_defaults=_extract_text_defaults(shape),
+                        text_defaults=text_defaults,
+                        estimated_text_capacity=estimated_text_capacity,
                         inheritance_chain=[master_id, layout_id],
                     )
                 )
@@ -511,7 +712,7 @@ def build_manifest_package(
     prs = Presentation(str(template))
     with zipfile.ZipFile(template) as zip_file:
         theme = _extract_theme(zip_file)
-    masters, layouts, annotations = _build_layouts(prs)
+    masters, layouts, annotations = _build_layouts(prs, theme)
     assets = _copy_template_and_assets(template, output_dir)
     findings = _compatibility_findings(template)
     has_errors = any(item.severity == "error" for item in findings)

{pptx_cli-1.1.0 → pptx_cli-1.2.0}/src/pptx_cli/models/manifest.py

@@ -40,6 +40,16 @@ class ProtectedElement(BaseModel):
     fingerprint: str
 
 
+class TextCapacityGuidance(BaseModel):
+    max_lines: int
+    source: Literal["explicit_guidance", "inferred"] = "inferred"
+    confidence: Literal["high", "medium", "low"] = "medium"
+    font_size_pt: float | None = None
+    font_family: str | None = None
+    usable_height_pt: float | None = None
+    line_height_pt: float | None = None
+
+
 class PlaceholderContract(BaseModel):
     logical_name: str
     source_name: str
@@ -55,6 +65,7 @@ class PlaceholderContract(BaseModel):
     required: bool = False
     overflow_policy: Literal["fit", "warn", "truncate"] = "warn"
     text_defaults: dict[str, Any] = Field(default_factory=dict)
+    estimated_text_capacity: TextCapacityGuidance | None = None
     inheritance_chain: list[str] = Field(default_factory=list)
     allowed_formatting_overrides: list[str] = Field(default_factory=list)
 

{pptx_cli-1.1.0 → pptx_cli-1.2.0}/tests/test_cli.py

@@ -164,6 +164,29 @@ def test_inspection_commands_use_manifest_contract(
     assert title_placeholder["text_defaults"]["max_lines"] == 2
     assert title_placeholder["text_defaults"]["suggested_font_size_pt"] == 24.0
     assert title_placeholder["text_defaults"]["suggested_font_family"] == "DB Regular"
+    assert title_placeholder["estimated_text_capacity"]["max_lines"] == 2
+    assert title_placeholder["estimated_text_capacity"]["source"] == "explicit_guidance"
+    assert title_placeholder["estimated_text_capacity"]["confidence"] == "high"
+    assert title_placeholder["estimated_text_capacity"]["font_size_pt"] == 24.0
+
+    subtitle_placeholder = next(
+        placeholder for placeholder in placeholders if placeholder["logical_name"] == "subtitle"
+    )
+    assert subtitle_placeholder["estimated_text_capacity"]["max_lines"] == 1
+    assert subtitle_placeholder["estimated_text_capacity"]["source"] == "inferred"
+    assert subtitle_placeholder["estimated_text_capacity"]["confidence"] == "medium"
+
+    content_layout_payload = _invoke_json(
+        ["placeholders", "list", "1-title-and-content", "--manifest", str(manifest_dir)]
+    )
+    content_placeholder = next(
+        placeholder
+        for placeholder in content_layout_payload["result"]["placeholders"]
+        if placeholder["logical_name"] == "content_1"
+    )
+    assert content_placeholder["estimated_text_capacity"]["max_lines"] == 20
+    assert content_placeholder["estimated_text_capacity"]["source"] == "inferred"
+    assert content_placeholder["estimated_text_capacity"]["font_size_pt"] == 14.0
 
     theme_payload = _invoke_json(["theme", "show", "--manifest", str(manifest_dir)])
     assert "fonts" in theme_payload["result"]
@@ -567,6 +590,10 @@ def test_deck_build_validate_schema_and_diff(
     schema_payload = _invoke_json(["manifest", "schema"])
     assert "template" in schema_payload["result"]["properties"]
     assert "$defs" in schema_payload["result"]
+    assert (
+        "estimated_text_capacity"
+        in schema_payload["result"]["$defs"]["PlaceholderContract"]["properties"]
+    )
 
     diff_payload = _invoke_json(["manifest", "diff", str(manifest_dir), str(manifest_dir)])
     assert diff_payload["result"]["breaking_changes"] == []