Claude Code transcript - page 2/11

AGENTS.md
Cargo.lock
Cargo.toml
crates
docs
fixtures
json-samples
LICENSE-APACHE
LICENSE-MIT
model
node_modules
README.md
scripts
target
templates
viewer

# AGENTS.md — pnk

Client-side Apple iWork (`.pages` / `.numbers` / `.key`) document viewer, built for
[Hackyard Yard #1](https://hackyard.tech/yards/yard-1). Everything runs in the browser:
drop a file, parse it to JSON in-page via Rust→WASM, render it. No backend, no login, no
email, no upload.

## Hackathon constraints

- Theme "no accounts": zero sign-up / login / email to use the product.
- 48 hours, solo: kickoff 2026-08-28 18:00 UTC, ship deadline 2026-08-30 18:00 UTC,
  voting closes 2026-09-02 18:00 UTC.
- All code written during the 48 hours; repo is public (github.com/peterheb/pnk); demo video required.
- Project license: MIT / Apache-2.0 dual. Only reference license-compatible third-party work,
  and record EVERY reference for attribution — vendored or merely browsed — including the
  exact git commit hashes (so we can debug against them six months from now).

## Repo conventions

- Commit straight to `main`. No branches, no PRs, no ceremony. Commit often, in small
  steps, with educational messages — peers will read this history.
- Provenance tagging for all format documentation: every claim gets one of
  - `proto` — structure verified in the protobuf definitions,
  - `parser` — behavior confirmed in third-party parser code (name which),
  - `inferred` — our own reasoning, not yet verified.
  Correctness beats completeness: one wrong "fact" poisons every line of code downstream.
- Layout: `crates/iwadump` (CLI structure inspector), `crates/pnk2json` (lib + wasm +
  text/markdown dumpers), `viewer/` (TS web app), `docs/format/` (format reference — start
  at `INDEX.md`), `fixtures/` (gitignored binaries; `provenance.json` is committed),
  `scripts/` (research/fetch tooling), `.scratch/` (local reference checkouts, gitignored).

## Format primer (iWork '13+)

- The document is a ZIP (flat file) or a package directory. Object database: `Index.zip`
  (a flat file may instead nest a member literally named `Index.zip` — early '13 variant,
  handle both), IWA members under `Index/`, metadata in `Metadata/Properties.plist` +
  `Metadata/BuildVersionHistory.plist` (there is NO `Metadata.plist`), media in `Data/`,
  QuickLook previews at root (`preview.jpg`/`png`/`pdf`). `.iwph` member = encrypted doc → reject.
- Each `.iwa` is a sequence of Snappy-compressed blocks. Header is 4 bytes: one zero
  chunk-type byte + u24 **LE** compressed length; NO uncompressed size in the header
  (that is the leading varint of the raw Snappy block). Raw Snappy, NOT the framing format.
- A block decompresses to `[varint length][TSP.ArchiveInfo]` followed by the payloads its
  `MessageInfo`s declare — length-delimited, decodable or not. There is NO `TSP.PrefixedMessage`.
- Namespaces: TSWP (text), TST (tables), TSD (drawables), TSCH (charts), TSCE (formulas),
  KN (Keynote), TSP (shared storage).
- Legacy iWork (pre-13) is out of scope: detect and reject with a clear error.
- Full reference lives in `docs/format/INDEX.md` (built in phase 1 from
  `scripts/docs_fetch_sources.py` + `npx otorp` extraction of the local apps' protos).

## Phases — each independently verifiable

0. **Env & repo** ✅ — toolchain validated/installed, repo linked to github.com/peterheb/pnk.
1. **Format docs** ✅ — 19 provenance-tagged docs in `docs/format/`; start at `INDEX.md`,
   Gate: INDEX.md covers all topics; sources recorded with SHAs and licenses.
1b. **Fixtures** ✅ — CC-MAIN-2026-34: 1,248 accepted (485 keynote / 325 pages / 158 numbers modern + 280 legacy), 18 GB at `~/Development/pnk-fixtures` (repo `fixtures/crawl*` symlinked). Gate exceeded 30–90×.
   `fixtures/` + `provenance.json` (URL, capture id, sha256). Gate: ≥5 files per format.
2. **JSON models** ✅ — `model/src/*.ts` + `docs/model-design.md` (strict-TSC clean); root envelope w/ metadata/warnings/fonts.
   incl. shared subobjects (picture/chart/table). Gate: iwadump output maps onto it cleanly.
3. **iwadump (Rust CLI)** ✅ — `crates/iwadump` lib+bin, 22 tests; gate: 964/968 modern dump exit-0 (4 encrypted clean-reject), 280/280 legacy clean-reject, 0 panics, 7.5s wall.
   fixture without panicking.
4. **pnk2json (Rust, wasm-friendly)** ✅ — typed JSON model, native + wasm32 builds; conformance harness (`scripts/conformance.py`): 1,248 files × JSON+markdown = 2,488 ok + 8 controlled encrypted rejects, 0 defects. Docs: `docs/CONFORMANCE.md`.
5. **Fallback: dump-to-text / dump-to-markdown** ✅ — 964/968 modern fixtures convert in both modes; markdown verified per-app (slides/bullets/tables/paragraphs).
6. **Viewer (TS + pnk2json.wasm)** ✅ — drag-drop → parse → render in `viewer/` (vanilla TS + esbuild, no framework). Run: `cd viewer && npm install && npm run build && npm run serve`; gate `npm test` = 6/6 Playwright (one real fixture per app, encrypted + legacy error cards, zero non-blob network requests asserted). Screenshots under `/tmp/pnk-gate/`.
   Schema note: TableModel v2 (2026-08-28) — tables emit row-major `grid` + per-table `formats` pool (`model/src/shared.ts`, commit 045052a/2df6316); JSON output is compact (`--pretty` opt-in).

## Cross-validation

Real Keynote / Numbers / Pages as ground truth, installed locally. On disk they are the 2026
"Creator Studio"-era bundles (`/Applications/Keynote Creator Studio.app`, `Numbers Creator Studio.app`,
`Pages Creator Studio.app`; display names unchanged; bundle IDs moved from `com.apple.iWork.*`
to `com.apple.*` — verified in Info.plist: com.apple.Keynote / com.apple.Numbers / com.apple.Pages, all v15.3.1). Open fixtures in the
apps with the `computer` tool and compare against our render, plus each file's embedded
QuickLook `preview.pdf` as an offline reference. Playwright drives viewer screenshots.

## Environment (validated 2026-08-28)

| Tool | Status |
| --- | --- |
| macOS 26.6.2 arm64, CLT, git 2.50.1 | ok |
| node 22.23.2 / npm·npx 11.19.0 | ok |
| gh 2.98.0, authed as peterheb (repo scope, https) | ok |
| uv 0.12.1 / brew 6.0.20 | ok |
| rustc·cargo 1.98.0 + wasm32-unknown-unknown | ok (rustup) |
| awscli 2.36.33 | ok — credentials NOT configured (run `aws login` or provide keys/SSO) |
| mas 7.0.0 | ok — real Keynote/Numbers/Pages 15.3.1 installed via `sudo mas install --force`; on-disk bundles are `Keynote Creator Studio.app` etc. (2026 "Creator Studio" rebrand — these ARE Apple's apps) |
| Playwright + chromium 151 | ok — smoke: `/tmp/pw-smoke/example.png` sha256 `8294b47e1b936d08f4743c826fcff63e20f943298d96d41ba2ac94e76ba406e4` |
| `computer` tool | ok — fully granted (capture + input + AX, via iTerm); verified: Keynote/Numbers/Pages AX probes + input delivery |

## Harness notes for agents

- `computer` tool: read `omp://computer-use.md`. Prefer AX over pixels; `read_only` for inspection.
- `browser` (xd://browser) for web/DOM checks; Playwright for user-facing screenshot validation.
- Sources of truth for the format: `docs/format/` (provenance-tagged) — do not re-derive from memory.

/Users/phebert/pnk/fixtures:
ccrawl_gone.txt
comms
conformance-report.json
crawl
crawl_old
crawl.jsonl
golden
provenance.json
README.md
success.tsv
templates

/Users/phebert/pnk/scripts:
__pycache__
app_export_pdf.sh
build_viewer.sh
conformance.py
crossval.py
docs_fetch_sources.py
fixtures_downloadall.py
fixtures_ec2_runbook.md
fixtures_queryindex.py
visual_diff.py

/Users/phebert/pnk/viewer:
dist
index.html
node_modules
package-lock.json
package.json
playwright.config.ts
README.md
src
styles.css
test-results
tests
tsconfig.json

/Users/phebert/pnk/crates:
iwadump
pnk2json
pnk2json-wasm

/Users/phebert/pnk/docs:
CONFORMANCE.md
format
model-design.md

/Users/phebert/pnk/json-samples:
G1-golden-pages-wp.json
G1-golden-pages-wp.pretty.json
G1-golden-pages-wp.preview.jpg
G2-golden-pages-layout.json
G2-golden-pages-layout.pretty.json
G5-golden-pages-acid.json
G5-golden-pages-acid.pretty.json
keynote-166KB-1.json
keynote-166KB-1.pretty.json
keynote-185KB-3.json
keynote-185KB-3.pretty.json
keynote-5407KB-6.json
keynote-5407KB-6.pretty.json
lafs_playlist.json
numbers-101KB-5.json
numbers-101KB-5.pretty.json
numbers-105KB-4.json
numbers-105KB-4.pretty.json
numbers-697KB-23.json
numbers-697KB-23.pretty.json
pages-717KB-1.json
pages-717KB-1.pretty.json
pages-72KB-14.json
pages-72KB-14.pretty.json
pages-77KB-10.json
pages-77KB-10.pretty.json
README.md

/Users/phebert/pnk/model/src:
keynote.ts
numbers.ts
pages.ts
primitives.ts
shared.ts

#!/usr/bin/env python3
"""Cross-validate pnk2json output against Apple's own renders.

Ground truth: each iWork file embeds a QuickLook preview (preview.pdf or
preview.jpg/png) rendered by Apple's own importer. We rasterize/collect it,
extract PDF text where available, and compare against pnk2json's JSON + markdown:

  JSON side   — table census (dims, non-null cells, format pool, merges) to answer
                "is that table empty?" — an all-null grid while the preview shows
                content is a converter bug (see 2026-08-28 DataList fix).
  Viewer side — per-app Playwright gate screenshots (npm test in viewer/) vs the
                preview bitmaps; human-eyeball equivalence, goal is good not perfect.

Usage:
  python3 scripts/crossval.py [--fixtures id1,id2,...] [--out /tmp/crossval] [--scan]

Needs: target/release/pnk2json; for preview.pdf rasterization/text:
  uv run --with pyobjc-framework-Quartz --with pyobjc-framework-PDFKit python3 ...
"""
from __future__ import annotations

import argparse
import json
import re
import subprocess
import sys
import zipfile
from pathlib import Path

REPO = Path(__file__).resolve().parent.parent
PNK2JSON = REPO / "target/release/pnk2json"


def load_success() -> dict[str, dict]:
    rows = {}
    tsv = (REPO / "fixtures/success.tsv").read_text().splitlines()
    hdr = tsv[0].split("\t")
    for line in tsv[1:]:
        r = dict(zip(hdr, line.split("\t")))
        if r.get("format") in ("keynote", "pages", "numbers") and int(r.get("bytes", 0)) > 0:
            rows[r["local_id"]] = r
    return rows


def default_picks(success: dict) -> list[str]:
    """2 smallest + 1 median-size per format — small, fast, representative."""
    import statistics

    picks = []
    for fmt in ("keynote", "pages", "numbers"):
        grp = sorted((r for r in success.values() if r["format"] == fmt),
                     key=lambda r: int(r["bytes"]))
        med = statistics.median(int(r["bytes"]) for r in grp)
        picks += [r["local_id"] for r in grp[:2]]
        picks.append(min(grp, key=lambda r: abs(int(r["bytes"]) - med))["local_id"])
    return picks


def extract_preview(src: Path, out: Path) -> str:
    """Extract embedded QuickLook preview. Returns kind: pdf|jpg|png|none."""
    with zipfile.ZipFile(src) as z:
        names = z.namelist()
        for name, kind in (("preview.pdf", "pdf"), ("preview.jpg", "jpg"), ("preview.png", "png")):
            if name in names:
                (out / f"preview.{kind}").write_bytes(z.read(name))
                return kind
    return "none"


def rasterize_pdf(pdf: Path, out: Path, max_pages: int = 3, dpi: int = 110) -> list[Path]:
    """Render PDF pages to PNGs via CoreGraphics (pyobjc). Returns page paths."""
    import Quartz  # type: ignore

    url = Quartz.CFURLCreateFromFileSystemRepresentation(None, str(pdf).encode(), len(str(pdf).encode()), False)
    doc = Quartz.CGPDFDocumentCreateWithURL(url)
    n = min(Quartz.CGPDFDocumentGetNumberOfPages(doc), max_pages)
    out.mkdir(parents=True, exist_ok=True)
    scale = dpi / 72.0
    written = []
    for i in range(1, n + 1):
        page = Quartz.CGPDFDocumentGetPage(doc, i)
        rect = Quartz.CGPDFPageGetBoxRect(page, Quartz.kCGPDFMediaBox)
        w, h = int(rect.size.width * scale), int(rect.size.height * scale)
        cs = Quartz.CGColorSpaceCreateDeviceRGB()
        ctx = Quartz.CGBitmapContextCreate(None, w, h, 8, 0, cs, Quartz.kCGImageAlphaPremultipliedLast)
        Quartz.CGContextSetRGBFillColor(ctx, 1, 1, 1, 1)
        Quartz.CGContextFillRect(ctx, Quartz.CGRectMake(0, 0, w, h))
        Quartz.CGContextScaleCTM(ctx, scale, scale)
        Quartz.CGContextDrawPDFPage(ctx, page)
        img = Quartz.CGBitmapContextCreateImage(ctx)
        dest_path = out / f"page-{i}.png"
        dest_url = Quartz.CFURLCreateFromFileSystemRepresentation(None, str(dest_path).encode(), len(str(dest_path).encode()), False)
        dest = Quartz.CGImageDestinationCreateWithURL(dest_url, "public.png", 1, None)
        Quartz.CGImageDestinationAddImage(dest, img, None)
        Quartz.CGImageDestinationFinalize(dest)
        written.append(dest_path)
    return written


def pdf_text(pdf: Path) -> str:
    try:
        from pypdf import PdfReader  # type: ignore
    except ImportError:
        return ""
    try:
        return "\n".join((page.extract_text() or "") for page in PdfReader(str(pdf)).pages)
    except Exception:
        return ""


TOKEN = re.compile(r"[A-Za-z0-9À-ž][A-Za-z0-9À-ž'’.-]{2,}")


def tokens(s: str) -> set[str]:
    return {t.casefold() for t in TOKEN.findall(s)}


def table_census(doc: dict) -> list[dict]:
    census = []
    # sheets (numbers/keynote) drawables

#!/usr/bin/env python3
"""Apple ground-truth vs our viewer render — visual comparison harness.

Takes one .pages/.numbers/.key fixture and produces, under an output dir:

  apple/           per-page PNGs rasterized from the iWork app's PDF export (~150dpi)
  ours/            our viewer render screenshot + element bounding boxes + model JSON
  composites/      per-Apple-page side-by-side (Apple | ours) composites
  crops/           zoomed side-by-side crops of regions of interest
  summary.md       pages compared, regions cropped, diff heuristics

Safety: the Apple side works on a COPY of the fixture opened under a distinct
document name (suffix "-visualdiff-copy"). The script only ever exports/closes
the document whose name matches that copy's name; if the copy's name never
appears among the app's open documents, the Apple side aborts and we fall back
to the fixture's embedded QuickLook preview (page 1 only).

Usage:
    /path/to/venv/bin/python scripts/visual_diff.py \
        --fixture fixtures/golden/G5-golden-pages-acid.pages --out /tmp/g5-visual
    # other apps:
    /path/to/venv/bin/python scripts/visual_diff.py --app numbers --fixture ... --out ...

Requires: pillow, pyobjc-framework-Quartz (PDF rasterization), pymupdf
(Apple-side text anchors), plus the repo's viewer (node + @playwright/test in
viewer/node_modules) and target/release/pnk2json.
"""
from __future__ import annotations
import csv
import argparse
import json
import os
import shutil
import subprocess
import sys
import time
import urllib.request
import zipfile
from pathlib import Path

REPO = Path(__file__).resolve().parent.parent
PNK2JSON = REPO / "target/release/pnk2json"
VIEWER = REPO / "viewer"

# ---------------------------------------------------------------- Apple side

APPLE_DOC_SUFFIX = "-visualdiff-copy"
APP_NAMES = {"pages": "Pages", "numbers": "Numbers", "keynote": "Keynote"}
OPEN_TIMEOUT_S = 90
EXPORT_TIMEOUT_S = 120


def _osascript(script: str, timeout: float = 60) -> str:
    return subprocess.run(
        ["osascript", "-e", script], capture_output=True, text=True,
        timeout=timeout, check=True,
    ).stdout.strip()


def _doc_names(app_name: str) -> list[str]:
    out = _osascript(
        f'tell application "{app_name}" to if it is running then get name of every document',
        timeout=OPEN_TIMEOUT_S,
    )
    return [s for s in out.split(", ") if s] if out else []


def export_via_app(app_name: str, fixture: Path, work: Path, log) -> tuple[Path | None, str]:
    """Open a renamed COPY in the iWork app, export PDF, close the copy (no save).

    Returns (pdf_path | None, mode) where mode is "<app>-export" or
    "fallback-preview" (with the PDF being None in fallback mode).
    """
    copy_stem = fixture.stem + APPLE_DOC_SUFFIX
    copy_path = work / "apple-work" / (copy_stem + fixture.suffix)
    copy_path.parent.mkdir(parents=True, exist_ok=True)
    shutil.copy2(fixture, copy_path)
    pdf_path = work / "apple" / "export.pdf"
    pdf_path.parent.mkdir(parents=True, exist_ok=True)

    # Apps are keyed by document name; they report either the bare stem or the
    # full filename depending on open state, so accept both spellings.
    candidates = {copy_path.name, copy_stem}

    def find_copy() -> str | None:
        names = _doc_names(app_name)
        for c in candidates:
            if c in names:
                return c
        return None

    existing = find_copy()
    if existing:
        log(f"copy {existing!r} is already open in {app_name}; exporting it")
    else:
        names = _doc_names(app_name)
        if any(c in names for c in (fixture.name, fixture.stem)):
            # informational only: the copy is distinguishable by its own name
            log(f"note: user's original {fixture.name!r} is also open in {app_name}")
        log(f"opening copy {copy_path} in {app_name} (docs open: {names})")

/Users/phebert/pnk/fixtures/golden:
expected
G1-golden-pages-wp.pages
g1-torture.txt
G2-golden-pages-layout.pages
g2-menu-screenshot.png
G5-acid-checklist.md
G5-golden-pages-acid.pages

/Users/phebert/pnk/viewer/src:
ctx.ts
drawables.ts
errors.ts
hydrate.ts
keynote.ts
main.ts
numbers.ts
pages.ts
tables.ts
text.ts
warnings.ts
wasm

/Users/phebert/pnk/viewer/tests:
gate.spec.ts
      51 /Users/phebert/pnk/viewer/src/ctx.ts
     442 /Users/phebert/pnk/viewer/src/drawables.ts
      55 /Users/phebert/pnk/viewer/src/errors.ts
      40 /Users/phebert/pnk/viewer/src/hydrate.ts
     290 /Users/phebert/pnk/viewer/src/keynote.ts
     135 /Users/phebert/pnk/viewer/src/main.ts
      75 /Users/phebert/pnk/viewer/src/numbers.ts
     117 /Users/phebert/pnk/viewer/src/pages.ts
     215 /Users/phebert/pnk/viewer/src/tables.ts
     252 /Users/phebert/pnk/viewer/src/text.ts
      73 /Users/phebert/pnk/viewer/src/warnings.ts
    1745 total

1	// pnk viewer entry point: init the wasm converter, wire the drop zone /
2	// file picker, and dispatch to the per-app renderers. No network calls after
3	// the static assets load — the file is parsed in-process and never uploaded.
4	
5	import init, { convert, media_bytes } from "./wasm/pnk2json_wasm.js";
6	import { ViewerCtx } from "./ctx";
7	import { hydrate } from "./hydrate";
8	import { mapError, renderErrorCard } from "./errors";
9	import { renderKeynote } from "./keynote";
10	import { renderNumbers } from "./numbers";
11	import { setTableLocale } from "./tables";
12	import { renderPages } from "./pages";
13	import { renderFonts, renderWarnings } from "./warnings";
14	import type { PnkDocument } from "../../model/src/shared";
15	
16	let ctx: ViewerCtx | null = null;
17	
18	const $ = (id: string) => document.getElementById(id)!;
19	
20	function showLanding(): void {
21	  ctx?.dispose();
22	  ctx = null;
23	  $("app-header").classList.add("hidden");
24	  $("panel-fonts").classList.add("hidden");
25	  $("panel-warnings").classList.add("hidden");
26	  $("view").classList.add("hidden");
27	  $("view").replaceChildren();
28	  $("drop-zone").classList.remove("hidden");
29	}
30	
31	function renderHeader(doc: PnkDocument, filename: string): void {
32	  $("doc-filename").textContent = filename;
33	  $("app-badge").textContent = doc.meta.application ?? doc.meta.app;
34	  const meta: string[] = [];
35	  if (doc.meta.fileFormatVersion) meta.push(`format ${doc.meta.fileFormatVersion}`);
36	  if (doc.meta.createdAt) meta.push(`created ${doc.meta.createdAt.slice(0, 10)}`);
37	  if (doc.meta.modifiedAt) meta.push(`modified ${doc.meta.modifiedAt.slice(0, 10)}`);
38	  if (doc.meta.locale) meta.push(doc.meta.locale);
39	  if (doc.meta.documentId) meta.push(`id ${doc.meta.documentId.slice(0, 8)}`);
40	  $("doc-meta").textContent = meta.join("  ·  ");
41	  $("app-header").classList.remove("hidden");
42	}
43	
44	function renderDocument(doc: PnkDocument, filename: string): void {
45	  ctx?.dispose();
46	  const mediaCtx = new ViewerCtx();
47	  ctx = mediaCtx;
48	
49	  // media bytes: per-dataId raw fetch from the wasm side (no base64 in the
50	  // envelope); missing bytes render as a labeled placeholder instead
51	  if (typeof media_bytes === "function") {
52	    for (const asset of doc.media) {
53	      const bytes = media_bytes(asset.dataId);
54	      if (bytes) mediaCtx.addMedia(asset.dataId, bytes, asset.fileName ?? asset.preferredFileName);
55	    }
56	  }
57	
58	  renderHeader(doc, filename);
59	  setTableLocale(doc.meta.locale);
60	  renderFonts(doc.fonts);
61	  renderWarnings(doc.warnings);
62	
63	  const view = $("view");
64	  view.replaceChildren();
65	  view.classList.remove("hidden");
66	  $("drop-zone").classList.add("hidden");
67	
68	  if (doc.kind === "keynote") renderKeynote(doc, hydrate(doc), mediaCtx, view);
69	  else if (doc.kind === "numbers") renderNumbers(doc, hydrate(doc), mediaCtx, view);
70	  else renderPages(doc, hydrate(doc), mediaCtx, view);
71	}
72	
73	function showError(err: unknown, filename: string): void {
74	  $("drop-zone").classList.add("hidden");
75	  $("app-header").classList.remove("hidden");
76	  $("doc-filename").textContent = filename;
77	  $("app-badge").textContent = "rejected";
78	  $("doc-meta").textContent = "";
79	  const view = $("view");
80	  view.replaceChildren();
81	  view.classList.remove("hidden");
82	  renderErrorCard(mapError(err, filename), view);
83	}
84	
85	async function handleFile(file: File): Promise<void> {
86	  showLanding();
87	  const hint = $("drop-hint");
88	  hint.textContent = `Parsing ${file.name}…`;
89	  $("drop-zone").classList.remove("hidden");
90	  try {
91	    const bytes = new Uint8Array(await file.arrayBuffer());
92	    const doc = JSON.parse(convert(bytes)) as PnkDocument;
93	    renderDocument(doc, file.name);
94	  } catch (err) {
95	    showError(err, file.name);
96	  }
97	}
98	
99	function wireEvents(): void {
100	  const input = $("file-input") as HTMLInputElement;
101	  const drop = $("drop-target");
102	
103	  $("pick-btn").addEventListener("click", () => input.click());
104	  $("reset-btn").addEventListener("click", () => {
105	    input.value = "";
106	    showLanding();
107	  });
108	  input.addEventListener("change", () => {
109	    if (input.files?.[0]) handleFile(input.files[0]);
110	  });
111	
112	  for (const zone of [drop, $("drop-zone")]) {
113	    zone.addEventListener("dragover", (e) => {
114	      e.preventDefault();
115	      drop.classList.add("dragover");
116	    });
117	    zone.addEventListener("dragleave", () => drop.classList.remove("dragover"));
118	  }
119	  window.addEventListener("drop", (e) => {
120	    e.preventDefault();
121	    drop.classList.remove("dragover");
122	    const file = (e as DragEvent).dataTransfer?.files?.[0];
123	    if (file) handleFile(file);
124	  });
125	}
126	
127	async function boot(): Promise<void> {
128	  await init("wasm/pnk2json_wasm_bg.wasm");
129	  wireEvents();
130	  $("drop-hint").textContent =
131	    "Encrypted (password-protected) and legacy pre-iWork '13 files are politely refused — nothing about them leaves the browser either.";
132	}
133	
134	boot().catch((err) => {
135	  $("drop-hint").textContent = `Failed to load the local parser: ${err}`;
136	});

1	<!doctype html>
2	<html lang="en">
3	<head>
4	  <meta charset="utf-8">
5	  <meta name="viewport" content="width=device-width, initial-scale=1">
6	  <title>pnk viewer — iWork, locally</title>
7	  <link rel="stylesheet" href="styles.css">
8	</head>
9	<body>
10	  <div id="app">
11	    <header id="app-header" class="hidden">
12	      <span id="doc-filename"></span>
13	      <span id="app-badge" class="badge"></span>
14	      <span id="doc-meta" class="muted"></span>
15	      <span class="spacer"></span>
16	      <button id="reset-btn" type="button" title="Open another file">Open another…</button>
17	    </header>
18	
19	    <div id="panel-fonts" class="panel hidden">
20	      <details>
21	        <summary>Fonts <span class="pill" id="fonts-count">0</span></summary>
22	        <div id="fonts-list" class="chips"></div>
23	      </details>
24	    </div>
25	
26	    <div id="panel-warnings" class="panel hidden">
27	      <details>
28	        <summary>Warnings <span class="pill" id="warnings-count">0</span></summary>
29	        <div id="warnings-list"></div>
30	      </details>
31	    </div>
32	
33	    <div id="drop-zone">
34	      <div id="drop-card">
35	        <h1>pnk</h1>
36	        <p class="tagline">Open a Pages, Numbers or Keynote file — <strong>entirely in this browser</strong>.<br>
37	        No accounts, no upload, no backend: the file is parsed locally and never leaves your machine.</p>
38	        <div id="drop-target">Drop a <code>.pages</code>, <code>.numbers</code> or <code>.key</code> file here<br>
39	          <span class="muted">or</span><br>
40	          <button id="pick-btn" type="button">Choose a file…</button>
41	        </div>
42	        <p class="muted" id="drop-hint">Encrypted (password-protected) and legacy pre-iWork&nbsp;'13 files are politely refused — nothing about them leaves the browser either.</p>
43	      </div>
44	    </div>
45	
46	    <main id="view" class="hidden"></main>
47	  </div>
48	
49	  <input type="file" id="file-input" class="hidden"
50	         accept=".pages,.numbers,.key,.pages.zip,.numbers.zip,.key.zip,application/vnd.apple.pages,application/vnd.apple.numbers,application/vnd.apple.keynote">
51	
52	  <script type="module" src="main.js"></script>
53	</body>
54	</html>

-rwxr-xr-x@ 1 phebert  staff  2631440 Aug 29 22:23 /Users/phebert/pnk/target/release/pnk2json
G1-golden-pages-wp.json
G2-golden-pages-layout.json
# G5 — Pages word-processing "Acid" fixture (viewer-feature sweep)

Build by hand in Pages 26.3.1. Goal: one doc that exercises every feature the
viewer/model can express (plus deliberate unknown-type probes). This complements
G1 (text/unicode torture) — G5 is about **features**: lists, tabs, tables,
fields, footnotes, sections, floats, media.

Save to `fixtures/golden/G5-golden-pages-acid.pages` (save early, save often —
expected JSON is re-synced from whatever the file says at fix time).
Paste exotic strings from the fenced blocks below — hand-typing composes
codepoints and defeats byte-exact checks. Insertion-point lesson from G2: don't
press Ctrl-D in Pages; some key events route into the hidden body flow.

## Setup

1. New blank document (word processing default template).
2. Document panel (right sidebar, Document tab): set **Landscape** orientation —
   exercises meta orientation + wider page-frame rendering.
3. Set the doc title: **"pnk acid g5"** as first heading-ish line (plain bold
   text, 24pt — not a layout-style title box).

## Paragraph styles & layout

4. Alignment zoo — four one-line paragraphs: left, **center**, **right**,
   **justified** (Format > Text). One sentence each so justification actually
   stretches.
5. Indents — one paragraph with **first-line indent** (Format > Layout >
   First), one with **left indent + hanging** (left 36pt, first −36pt).
6. Line spacing — one paragraph **150%**, one **exactly 28pt** (Format >
   Layout > Line spacing dropdown: Multiple / Exactly).
7. Space before/after — one paragraph with **12pt before + 12pt after**.
8. Hyphenation **off** on one long-word paragraph, **on** (Format > Layout >
   Hyphenation checkbox) on another long-paragraph.
9. Keep-together: one paragraph with **"Keep lines together" + "Keep with
   next"** checked (Format > More panel).
10. Tab stops — one paragraph with **center tab at 3"** and **right tab at 6"**;
    content: `left<TAB>centered<TAB>right-end` (real Tab key in body text is
    fine — Option-Tab is only needed inside table cells).

## Lists

11. Numbered list, **restart**: three lines "One"/"Two"/"Three" as a numbered
    list (Format > List > Numbered), then three more lines "Restart One"/"Two"
    as a SEPARATE numbered list that restarts at 1 — bullet semantics from G1
    must show restart-on-One here too.
12. Nested bullets: 3 levels deep —
    `L0 bullet` / `L1 bullet` (Tab once) / `L2 bullet` (Tab twice) — marker
    indent must grow with level.
13. Lettered list (a. b. c.) two items; roman list (I. II. III.) two items.
14. **Checklist** (Format > Checklist, one item) — PROBE: may emit an

        else:
            log(f"fallback: preview.{preview.suffix}, page 1 only")

    apple_pages = sorted((work / "apple").glob("page-*.png"), key=lambda p: int(p.stem.split("-")[-1]))
    log(f"apple pages: {len(apple_pages)}")

    # Our side
    server = ensure_viewer_server(args.base_url, log)
    try:
        rendered = render_ours(fixture, work, args.base_url, log)
    finally:
        if server:
            server.terminate()
    if rendered is None:
        print("[visual_diff] FATAL: could not render our side", file=sys.stderr)
        return False
    shot, ctx = rendered
    bboxes, model = ctx["bboxes"], ctx["model"]

    # Composites + heuristic bands
    composites = composite_rows(shot, work, log) if apple_pages else []
    bands_by_page: dict[str, list] = {}
    for i, page in enumerate(apple_pages):
        bands_by_page[str(i + 1)] = row_diff_bands(page, shot)

    crops = crop_regions(pdf, preview, shot, bboxes, work, args.dpi, log)
    summary = write_summary(work, fixture, mode, len(apple_pages), shot, bboxes,
                            model, composites, crops, bands_by_page, args.dpi)

    print(f"[visual_diff] artifacts: {work}")
    print(f"[visual_diff] summary: {summary}")
    return True


def main() -> int:
    ap = argparse.ArgumentParser(description=__doc__.splitlines()[0])
    ap.add_argument("--fixture", action="append", default=[], type=Path,
                    help="fixture path; repeatable. Mutually exclusive with --batch.")
    ap.add_argument("--batch", type=Path, metavar="TSV",
                    help="success.tsv (or a plain text file of fixture paths); one doc "
                         "per row, app inferred from the extension. "
                         "--out is the campaign base dir (<out>/<ext>/<stem>/).")
    ap.add_argument("--app", choices=("pages", "numbers", "keynote"), default="pages",
                    help="iWork app used for the Apple-side PDF export (single mode)")
    ap.add_argument("--out", required=True, type=Path, help="artifact dir (or base dir with --batch)")
    ap.add_argument("--dpi", type=int, default=150)
    ap.add_argument("--base-url", default="http://127.0.0.1:8123")
    ap.add_argument("--skip-apple", action="store_true", help="use embedded preview fallback")
    args = ap.parse_args()

    def log(msg: str) -> None:
        print(f"[visual_diff] {msg}", flush=True)

    jobs: list[tuple[str, Path, Path]] = []
    if args.batch:
        if args.fixture:
            ap.error("--batch and --fixture are mutually exclusive")
        ext_to_app = {".pages": "pages", ".numbers": "numbers", ".key": "keynote"}
        for line in open(args.batch):
            line = line.strip()
            if not line or line.startswith("local_id"):
                continue
            if "\t" in line:
                cols = line.split("\t")
                sha, ext = cols[1], cols[2]
                p = REPO / "fixtures/crawl" / f"{sha}.{ext}"
            else:
                p = Path(line)
            app = ext_to_app.get(p.suffix)
            if app is None:
                log(f"skip (no app for {p.suffix}): {p}")
                continue
            stem = p.name.rsplit(".", 1)[0][:60] or p.stem[:60]
            jobs.append((app, p, args.out.resolve() / p.suffix.lstrip(".") / stem))
    else:
        if not args.fixture:
            ap.error("one or more --fixture paths (or --batch) are required")
        for f in args.fixture:
            f = f.resolve()
            jobs.append((args.app, f, args.out.resolve()))

    failures = 0
    for i, (app, fixture, work) in enumerate(jobs, start=1):
        if len(jobs) > 1:
            log(f"=== [{i}/{len(jobs)}] {fixture.name} ({app}) -> {work}")
        if not fixture.exists():
            log(f"fixture missing: {fixture}")
            failures += 1
            continue
        try:
            if not run_one(app, fixture, work, args, log):
                failures += 1
        except Exception as e:
            log(f"FAILED {fixture.name}: {e}")
            failures += 1
    return 1 if failures else 0


if __name__ == "__main__":
    sys.exit(main())

276:def ensure_viewer_server(base_url: str, log) -> subprocess.Popen | None:
277-    """Reuse a running esbuild viewer server or spawn one; returns handle or None.
278-
279-    esbuild's serve mode stops when stdin hits EOF, so the child's stdin must
280-    stay open (a pipe we simply never close).
281-    """
282-    host, port = base_url.replace("http://", "").split(":")
283-    try:
284-        urllib.request.urlopen(f"{base_url}/", timeout=2)
285-        log(f"reusing viewer server already at {base_url}")
286-        return None
287-    except Exception:
288-        pass
289-    proc = subprocess.Popen(
290-        [str(VIEWER / "node_modules/.bin/esbuild"), "--servedir=dist",
291-         f"--serve={host}:{port}", "--log-level=warning"],
292-        cwd=VIEWER, stdin=subprocess.PIPE, stdout=subprocess.DEVNULL, stderr=subprocess.STDOUT,
293-    )
294-    deadline = time.time() + 30
295-    while time.time() < deadline:
296-        try:
297-            urllib.request.urlopen(f"{base_url}/", timeout=2)
298-            log(f"viewer server started at {base_url} (pid {proc.pid})")
299-            return proc
300-        except Exception:
301-            time.sleep(0.5)
302-    proc.terminate()
303-    return None
304-
305-
306-def render_ours(fixture: Path, work: Path, base_url: str, log) -> tuple[Path, dict] | None:
306:def render_ours(fixture: Path, work: Path, base_url: str, log) -> tuple[Path, dict] | None:
307-    """Convert + load the fixture in the served viewer; screenshot + bboxes."""
308-    json_out = work / "ours" / "model.json"
309-    json_out.parent.mkdir(parents=True, exist_ok=True)
310-    conv = subprocess.run([str(PNK2JSON), str(fixture)], capture_output=True, text=True)
311-    if conv.returncode != 0 or not conv.stdout.strip():
312-        log(f"pnk2json failed: {conv.stderr.strip()[:400]}")
313-        return None
314-    json_out.write_text(conv.stdout)
315-
316-    shot = work / "ours" / "render.png"
317-    bbox_path = work / "ours" / "bboxes.json"
318-    js = work / "render.js"
319-    js.write_text(RENDER_JS)
320-    r = subprocess.run(
321-        ["node", str(js), str(fixture), str(shot), str(bbox_path), base_url],
322-        env={**os.environ, "PW_MODULE": str(VIEWER / "node_modules/@playwright/test")},
323-        cwd=VIEWER, capture_output=True, text=True, timeout=180,
324-    )
325-    if r.returncode != 0 or not shot.exists():
326-        log(f"viewer render failed: {r.stderr.strip()[:600]}")
327-        return None
328-    model = json.loads(conv.stdout)
329-    return shot, {"bboxes": json.loads(bbox_path.read_text()), "model": model}
330-
331-
332-# ---------------------------------------------------------------- comparisons
333-
334-def composite_rows(shot: Path, work: Path, log) -> list[Path]:
335-    """Side-by-side composites, Apple page-N vs our render N.
336-
337-    Decks (.key): ours/slide-N.png (stage element screenshots) align 1:1 with
338-    Apple's per-page rasters. Everything else: Apple page | proportional slice
339-    of our continuous-flow render — approximate, for locating, not verdicts.
340-    """
341-    from PIL import Image
342-
343-    apple_pages = sorted((work / "apple").glob("page-*.png"), key=lambda p: int(p.stem.split("-")[-1]))
344-    if not apple_pages:
345-        return []
346-    out_dir = work / "composites"

/opt/homebrew/bin/python3
Traceback (most recent call last):
  File "<string>", line 1, in <module>
    import PIL, Quartz, fitz

0a30b8d pnk2json: omit-defaults style emission — pooled styles carry only overrides
c553db8 pnk2json: IVS empty tables fixed — DataList loader now reads rich_text_payload (field 9) as a reference fallback, and v4 type-9 cells resolve their content via slot-5 rich-text key
9780731 pnk2json: v4 rich-text cells decode from slot-5 key into the rich-text table — IVS doc's 18 empty tables now populated. The 24-byte v4 type-9 block carries the rich_text_table key at u32 slot 5 (byte 20-23); block minimum lowered 28→24 (type-9 is shorter). Cells map to RichTextPayloadArchive storages with IVS sequences (base char + E0100/E0101 selectors). Regex cleanup damage from the debug session repaired.
index.html
main.js
styles.css
wasm

crossval-campaign
g5-full.txt
g5-visual
iwork
keynote-parser
litchi
numbers-parser
otorp
otorp-tool
/tmp/g5-check.json
/tmp/g5-doc.txt
/tmp/g5-full.txt
/tmp/g5-survey.json
/tmp/g5-survey2.json
/tmp/g5-survey3.json
/tmp/g5.json
/tmp/g5check.mjs
/tmp/g5img.mjs

/Users/phebert/pnk/.scratch/crossval-campaign:
keynote
numbers
pages

/Users/phebert/pnk/.scratch/g5-visual:
bboxes.json
composite-page-1.png
composite-page-2.png
composite-page-3.png
composite-page-4.png
composite-page-5.png
composites
crops
inline-image-spot.png
model.json
render.png
summary.md
table1-3x3.png
table2-5x4.png
composite-page-1.png
composite-page-2.png
composite-page-3.png
composite-page-4.png
composite-page-5.png

/Users/phebert/pnk/.scratch/crossval-campaign/keynote:
total 16
drwxr-xr-x@ 7 phebert  staff   224 Aug 29 18:36 .
drwxr-xr-x@ 5 phebert  staff   160 Aug 29 18:24 ..
drwxr-xr-x@ 9 phebert  staff   288 Aug 29 18:36 5089b9c75d798da688e6d239e860db1ec7075907843891fd8307a5013eda
drwxr-xr-x@ 8 phebert  staff   256 Aug 29 18:24 95296b63a7bb5c565411e8f374d70bc85a97050d6f55a3e66600f05066d8
drwxr-xr-x@ 8 phebert  staff   256 Aug 29 18:24 a9d4f68c7a0f7aa6af2980f093496027da235adb897035848d5487c73007
drwxr-xr-x@ 9 phebert  staff   288 Aug 29 18:36 bc5a842a70994cd3f87e5292c1b3720384077d1a6b613b56fedbd8330e56
-rw-r--r--@ 1 phebert  staff  4391 Aug 29 19:30 summary.md

/Users/phebert/pnk/.scratch/crossval-campaign/numbers:
total 8
drwxr-xr-x@ 7 phebert  staff   224 Aug 29 21:22 .
drwxr-xr-x@ 5 phebert  staff   160 Aug 29 18:24 ..
drwxr-xr-x@ 9 phebert  staff   288 Aug 29 21:22 447a1f859927bc78744bc6a9a6cc4ce7496cc8910af973db289b131e8990
drwxr-xr-x@ 9 phebert  staff   288 Aug 29 21:22 6d101a3edf78116ded45debe460492eec59e7af43f61b25d7cd637a0ceb8
drwxr-xr-x@ 9 phebert  staff   288 Aug 29 21:22 bbc4fc99ae8cb6bace8fe809e005c54ed71bee32a3f916d73bb58fa9aa6e
drwxr-xr-x@ 9 phebert  staff   288 Aug 29 21:22 ce1d7a8f4b7be45581652903a90bd4332badaeb040f7c36c7b49ef823328
-rw-r--r--@ 1 phebert  staff  3218 Aug 29 21:22 summary.md

/Users/phebert/pnk/.scratch/crossval-campaign/pages:
total 8
drwxr-xr-x@ 7 phebert  staff   224 Aug 29 18:24 .
drwxr-xr-x@ 5 phebert  staff   160 Aug 29 18:24 ..
drwxr-xr-x@ 8 phebert  staff   256 Aug 29 18:24 42d1265baf853f9468b345bb474700ee10649f468e7e5fe9e2472dd37a66
drwxr-xr-x@ 8 phebert  staff   256 Aug 29 18:24 5008407355183b83d05bf0aa2c8f2770e5538db04b678c8b4cef544a1fb5
drwxr-xr-x@ 8 phebert  staff   256 Aug 29 18:24 65c78536f24ee7aa54942f315f083b6aba298ce5a1a223908ca40136a677
drwxr-xr-x@ 8 phebert  staff   256 Aug 29 18:24 bc5e6bd192100df4b0cbc86a675f2171d8c2d8d661bf3fb867d7d679bc6a
-rw-r--r--@ 1 phebert  staff  2366 Aug 29 18:24 summary.md

# Campaign — .key (Apple Keynote vs our viewer render)

Docs: 4 from success.tsv (2 smallest, 2 near-median), Apple export via Keynote AppleScript from a /tmp copy (name-verified close, no save), 150dpi rasterization, our render via viewer Playwright.

**Harness update:** visual_diff.py now has deck mode — it clicks through the viewer's slide thumbnails and screenshots the `.slide-stage` element only, so composites are Apple page-N vs our slide-N, 1:1. Both undecided docs re-run with it (47 and 16 slide composites).

## Doc: Home.key (a9d4f68c…, 4 slides) — **HIGH fix value: slides render blank**
- Apple slide 1: dark gradient background, big title "Home", subtitle "Your name here".
- **Ours: slide 1 stage renders COMPLETELY BLANK** (white), slide 2 blank, slide 3 shows only the tiny "Your photo here" placeholder, slide 4 blank. See `a9d4…/ours/slide-*.png` and `composites/composite-page-1..4.png`.
- Likely causes: master/gradient background fills not rendered; title/subtitle placeholder text inherited from the master layout not instantiated.

## Doc: ppd-12-2024.key (5089b9c7…, 47 slides, pt-BR photo deck) — **HIGH fix value: body text missing on content slides**
- Slide 1 (composites/composite-page-1.png): Apple shows full-bleed photo + red title "Os primeiros passos do discípulo" + "Aula 13" + two-column subtitle. **Ours renders the photo but NONE of the text.** (Slide 1 pairs 1:1 regardless of sort order — this finding is solid.)
- Slide 5: earlier summary claimed "bullets missing on slide 5" — that was a MISPAIRING ARTIFACT (lexicographic page sort, fixed in commit 10e5cae: composite position 5 showed Apple page 13). Re-checked directly: Apple page 5 is a section-title slide ("O que é a igreja" + "12.1" badge); **our slide-5 stage is still near-empty** (one broken image placeholder "1400x1400-logo-redondo-2024-…", no text) — so the body-text finding stands, just with a corrected example. See `ours/slide-5.png` vs `apple/page-5.png`.
- Presenter notes DO render in ours (notes panel) — notes pipeline is healthy, slide body text is not.
- 47 slide composites: `5089…/composites/composite-page-1..47.png`; per-slide stages `5089…/ours/slide-N.png`. Full Apple set at `5089…/apple/page-*.png` (in /tmp; .scratch copy trimmed to first 10).
## Doc: 51-PolicyTopics (bc5a842a…, 16 slides, RIPE NCC) — **HIGH fix value: backgrounds missing, text unstyled**
- Slide 1 (composite-page-1.png): Apple = dark polygon-pattern background, white 40pt "Current Policy Topics", "Marco Schmidt / Policy Officer", orange footer. **Ours = white background, logo image renders, but title/subtitle render as tiny unstyled overlapping placeholder text** ("Current Policy Topics" overlapped by "Presentation Title", names overlapped by "Name Surname").
- Slide 3 (composite-page-3.png): Apple = dark "Policy Development Process" bullets. **Ours = white with placeholder fragments + a broken-image placeholder labeled "vector art placed image (PDF)"** — PDF-backed vector images are not decoded.
- 16 slide composites: `bc5a…/composites/composite-page-1..16.png`; Apple pages `bc5a…/apple/page-*.png` (in /tmp; .scratch trimmed to 10).

## Doc: Template_EOEDV_Keynote.key (95296b63…, 1 slide)
- Composite page 1 shows rough correspondence; same background/placeholder caveats as above (not re-run with deck mode; single slide, so existing composite is already 1:1).

## Ranked fix-dispatch menu (keynote) — updated after per-slide re-run
1. **Slide body text boxes missing/unstyled** (ppd slide 1/5, PolicyTopics slides 1/3, Home.key): either text drawables are dropped, or master-layout placeholder geometry/styles are not applied — text that survives renders tiny, black-on-white, overlapping placeholder strings. Highest severity: most text decks are unreadable.
2. **Master background fills missing** (Home.key dark gradient, PolicyTopics dark polygons): slides render on white. Same root area as #1 (master/layout inheritance).
3. **PDF/vector-backed images not decoded** (PolicyTopics slide 3 "vector art placed image (PDF)" broken placeholder); raster photos DO render (ppd slide 1, PolicyTopics logo).
4. Harness note: ppd-12-2024 Apple pages 11–47 are NOT in the .scratch copy (trimmed for size) — full set lives in /tmp/crossval-campaign/keynote/5089b9c75d798da688e6d239e860db1ec7075907843891fd8307a5013eda/apple/.
# Campaign — .numbers (Apple Numbers vs our viewer render)

**Consent granted — re-run 2026-08-29 with real Apple ground truth.** All 4 docs exported via Numbers AppleScript from /tmp copies (name-verified close, no save), rasterized 150dpi, rendered via viewer Playwright on main@d9b8be2 (viewer dist rebuilt first).

## Doc: lafs_playlist_23-09-2024.numbers (6d101a3e…, 1 sheet, playlist)
- Content matches: all artist/track/album cells correct, bold artist names match, header row present. Model warning "pre-BNC tile storage; decode is best-effort" did NOT lose data.
- **Finding 1 — duration formats**: Apple renders start times as durations `00:51`, `16:10`, `1:48:17`; ours renders raw values with a unit suffix `51s`, `970s`, `6557s`. Duration number-format not applied (same family as the G5 percent/fraction formats).
- **Finding 2 — column widths**: Apple's sheet has wide columns (one row per line); ours collapses every column to the 98px default so all cells wrap to 3–6 lines and the header "LAFS 23-09-2024" wraps into a narrow cell. Stored column sizes not applied for this table.
- Composite: `6d10…/composites/composite-page-1.png`.

## Doc: 2020 UT Utah clerk transactions summary (bbc4fc99…, 1 sheet, tiny)
- **HEALTHY.** Names/amounts match exactly (including Apple's own ugly `912558.880000000` — we reproduce it verbatim). Minor: Apple right-aligns the `amount` column, ours left-aligns; Apple's Name column is wider.
- Composite: `bbc4…/composites/composite-page-1.png`.

## Doc: 5 Whys template (447a1f85…, 2 sheets: Blank Template / Completed Example)
- **HEALTHY.** All three chains (CHAIN 1/2/3 headers), Why 1–5, Root Cause (orange) and Action (green) row fills, SH header block, lime callout cells, and the sheet tabs render and match Apple. Sheet-tab switching works.
- Composite page 1 shows only the top slice (Apple paginates, our render is one long sheet) — check `447a…/ours/render.png` for the full sheet.
- Composites: `447a…/composites/composite-page-{1,2}.png`.

## Doc: SimplicityHub-SIPOC-Template.numbers (ce1d7a8f…, 2 sheets)
- **Mostly healthy.** SH header block, lime/colored callouts, PROJECT TITLE row, sheet tabs render and match the visible Apple top. The composite's ours-side is cut at the proportional slice boundary (our sheet is one long page vs Apple's 2 pages) — verify SUPPLIERS/INPUTS/PROCESS/OUTPUTS/CUSTOMERS header row and Step 1–5 fills against `ce1d…/ours/render.png` before calling the rest; the visible portion matches.
- Composites: `ce1d…/composites/composite-page-{1,2}.png`.

## Ranked fix-dispatch menu (numbers)
1. **Duration number formats** (lafs_playlist): Apple `00:51`/`1:48:17` vs ours `51s`/`6557s`. Same number-format pipeline as the G5 percent/fraction/currency degradations — one fix likely covers several formats.
2. **Per-column stored widths not applied** (lafs_playlist; every column falls back to the 98px default and wraps). Other docs (5 Whys, SIPOC) show plausible widths, so it may be table-specific (pre-BNC tile path?).
3. **Cell text alignment** (UT clerk `amount` right-aligned in Apple, left in ours) — cosmetic.
4. Sheet tabs + multi-sheet switching: working (5 Whys, SIPOC).
# Campaign — .pages (Apple Pages vs our viewer render)

Docs: 2 smallest + 2 near-median from fixtures/success.tsv (>= 20KB), all exported via Pages AppleScript from a /tmp copy (name-verified close, no save), rasterized 150dpi, rendered via viewer Playwright.

## Doc: a9-flat-landscape.pages (50084073…, 2 pages) — flat-landscape template, page-layout flavor
- **HIGH fix value: page-layout docs render (almost) EMPTY.** Model has 0 body paragraphs, 0 text: Apple page 1 shows template text "Front / For full-bleed, extend photo beyond the pink guides…", ours shows a blank page canvas. The 2 `shape` drawables we do decode render with no visible content. Template placeholder text is not extracted.
- Apple page 2 likewise has content we don't show.
- Composites: `5008…/composites/composite-page-{1,2}.png`.

## Doc: a7-flat-landscape.pages (42d1265b…, 2 pages) — same template family
- Same failure signature: page-layout flavor, 2 shapes, 0 text; ours renders an empty page where Apple shows the template's text layout.
- Composites: `42d1…/composites/composite-page-{1,2}.png`.

## Doc: IVSテストシート.pages (bc5e6bd1…, 7 pages, ja_JP) — 18 tables, 18 table-degraded warnings
- **HIGH fix value: table cell text missing.** Our render shows the table frames (表1/表2… captions present) but cells appear empty in the composite while Apple shows populated tables (composite-page-1). 18 `table-degraded` warnings in the model.
- CJK/IVS text itself matches Apple (IVS変体セレタ glyphs visible both sides).
- Composites: `bc5e…/composites/composite-page-1..7.png`.

## Doc: BTMavrasya KVKK policy (65c78536…, 1 page, tr) — word-processing
- **HEALTHY.** Apple and ours match: headings, bold runs, bullet lists, full justification, indentation, footer company name. No converter warnings, no media.
- Composite: `65c7…/composites/composite-page-1.png`.

## Ranked fix-dispatch menu (pages)
1. **page-layout flavor content loss** (a9/a7-flat-landscape): shapes render empty, template text not extracted → viewer shows blank pages. (2/4 docs fail hard.)
2. **Table cell content in IVS doc** (bc5e6bd1): 18 degraded tables, cells visually empty vs Apple populated; check pre-BNC/dense tile decoding + per-cell warnings.
3. (Cosmetic) proportional slice alignment of composites — harness limitation, not a converter bug.

      54 /Users/phebert/pnk/crates/pnk2json/src/members.rs
      76 /Users/phebert/pnk/crates/pnk2json/src/bin/pnk2json.rs
     129 /Users/phebert/pnk/crates/pnk2json/src/lib.rs
     132 /Users/phebert/pnk/crates/pnk2json/src/colors.rs
     192 /Users/phebert/pnk/crates/pnk2json/src/numbers.rs
     204 /Users/phebert/pnk/crates/pnk2json/src/charts.rs
     236 /Users/phebert/pnk/crates/pnk2json/src/pb.rs
     267 /Users/phebert/pnk/crates/pnk2json/src/loader.rs
     338 /Users/phebert/pnk/crates/pnk2json/src/pages.rs
     375 /Users/phebert/pnk/crates/pnk2json/src/tsd.rs
     452 /Users/phebert/pnk/crates/pnk2json/src/styles.rs
     489 /Users/phebert/pnk/crates/pnk2json/src/text.rs
     583 /Users/phebert/pnk/crates/pnk2json/src/ctx.rs
     583 /Users/phebert/pnk/crates/pnk2json/src/keynote.rs
     593 /Users/phebert/pnk/crates/pnk2json/src/dumptext.rs
     671 /Users/phebert/pnk/crates/pnk2json/src/drawables.rs
    1063 /Users/phebert/pnk/crates/pnk2json/src/tables.rs
    1726 /Users/phebert/pnk/crates/pnk2json/src/model.rs
    8163 total

/Users/phebert/pnk/fixtures/templates/provenance.json
/Users/phebert/pnk/fixtures/templates/numbers/02_Invoice.numbers
/Users/phebert/pnk/fixtures/templates/numbers/01_Running_Log.numbers
/Users/phebert/pnk/fixtures/templates/numbers/07_Calendar.numbers
/Users/phebert/pnk/fixtures/templates/numbers/07_AcademicCalendar.numbers
/Users/phebert/pnk/fixtures/templates/numbers/07_Schedule.numbers
/Users/phebert/pnk/fixtures/templates/keynote/24_Briefing.key
/Users/phebert/pnk/fixtures/templates/keynote/23_ClassicWhite.key
/Users/phebert/pnk/fixtures/templates/keynote/22_ColorGradient.key
/Users/phebert/pnk/fixtures/templates/keynote/20_BasicBlack.key
/Users/phebert/pnk/fixtures/templates/keynote/21_BasicWhite.key
/Users/phebert/pnk/fixtures/templates/pages/00D_Textbook_Landscape.pages
/Users/phebert/pnk/fixtures/templates/pages/00B_Blank_Landscape.pages
/Users/phebert/pnk/fixtures/templates/pages/00V_Vertical_Blank_Portrait.pages
/Users/phebert/pnk/fixtures/templates/pages/00C_Textbook_Portrait.pages
/Users/phebert/pnk/fixtures/templates/pages/00B_Blank_Portrait.pages
1.8M	/Users/phebert/pnk/fixtures/templates/keynote
696K	/Users/phebert/pnk/fixtures/templates/numbers
420K	/Users/phebert/pnk/fixtures/templates/pages
8.0K	/Users/phebert/pnk/fixtures/templates/provenance.json

#!/usr/bin/env bash
# Build the pnk viewer (viewer/ -> viewer/dist/), fully static:
#   1. cargo builds pnk2json-wasm for wasm32-unknown-unknown
#   2. wasm-bindgen --target web emits JS glue + .wasm into viewer/dist/wasm
#   3. the generated glue is vendored into viewer/src/wasm/ (committed; the
#      tiny JS file is deterministic for a given wasm-bindgen version) so
#      esbuild can bundle `import init from "./wasm/pnk2json_wasm.js"`
#   4. esbuild bundles viewer/src/main.ts -> viewer/dist/main.js
#   5. the static shell (index.html, styles.css) is copied to viewer/dist/
#
# Prerequisites: cargo, wasm-bindgen 0.2.127 on PATH; `npm install` run once
# inside viewer/ (esbuild + playwright devDependencies).
#
# Output layout (viewer/dist/): index.html  styles.css  main.js  wasm/*.wasm
set -euo pipefail

ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
cd "$ROOT"

ESBUILD="$ROOT/viewer/node_modules/.bin/esbuild"
if [ ! -x "$ESBUILD" ]; then
  echo "error: esbuild not found — run 'npm install' in viewer/ first" >&2
  exit 1
fi

echo "==> cargo build -p pnk2json-wasm (wasm32-unknown-unknown, release)"
cargo build -p pnk2json-wasm --target wasm32-unknown-unknown --release

echo "==> wasm-bindgen --target web -> viewer/dist/wasm/"
mkdir -p viewer/dist/wasm viewer/src/wasm
wasm-bindgen target/wasm32-unknown-unknown/release/pnk2json_wasm.wasm \
  --target web --out-dir viewer/dist/wasm

echo "==> vendoring generated glue into viewer/src/wasm/"
cp viewer/dist/wasm/pnk2json_wasm.js viewer/src/wasm/pnk2json_wasm.js
cp viewer/dist/wasm/pnk2json_wasm.d.ts viewer/src/wasm/pnk2json_wasm.d.ts

echo "==> esbuild bundle -> viewer/dist/main.js"
"$ESBUILD" viewer/src/main.ts \
  --bundle --format=esm --target=es2022 \
  --outfile=viewer/dist/main.js

echo "==> static shell -> viewer/dist/"
cp viewer/index.html viewer/styles.css viewer/dist/

echo "viewer built: viewer/dist/  (serve: cd viewer && npm run serve)"

warning: `pnk2json` (lib) generated 11 warnings (run `cargo fix --lib -p pnk2json` to apply 7 suggestions)
    Finished `release` profile [optimized] target(s) in 0.11s

⚡ Done in 2ms
==> static shell -> viewer/dist/
viewer built: viewer/dist/  (serve: cd viewer && npm run serve)

  × No solution found when resolving `--with` dependencies:
  ╰─▶ Because pyobjc-framework-pdfkit was not found in the package registry
      and you require pyobjc-framework-pdfkit, we can conclude that your
      requirements are unsatisfiable.

Installed 5 packages in 37ms
[visual_diff] opening copy /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/scratchpad/vd-k20/apple-work/20_BasicBlack-visualdiff-copy.key in Keynote (docs open: [])
[visual_diff] closed Keynote copy '20_BasicBlack-visualdiff-copy.key' without saving
[visual_diff] rasterized 1 Apple pages at 150dpi
[visual_diff] apple pages: 1
[visual_diff] reusing viewer server already at http://127.0.0.1:8123
[visual_diff] wrote 1 per-slide deck composites
[visual_diff] wrote 0 region crops
[visual_diff] artifacts: /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/scratchpad/vd-k20
[visual_diff] summary: /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/scratchpad/vd-k20/summary.md

Async agent launched successfully. (This tool result is internal metadata — never quote or paste any part of it, including the agentId below, into a user-facing reply.)
agentId: a3ef623e1aa80b2a4 (internal ID - do not mention to user. Use SendMessage with to: 'a3ef623e1aa80b2a4', summary: '<5-10 word recap>' to continue this agent.)
The agent is working in the background. You will be notified automatically when it completes. You know nothing about its results until that notification arrives — do not report, assume, or predict them; continue other work or respond to the user in the meantime.
Do not duplicate this agent's work — avoid working with the same files or topics it is using.
output_file: /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/tasks/a3ef623e1aa80b2a4.output
Do NOT Read or tail this file via the shell tool — it is the full subagent JSONL transcript and reading it will overflow your context. If the user asks for progress, say the agent is still running; you'll get a completion notification.

Async agent launched successfully. (This tool result is internal metadata — never quote or paste any part of it, including the agentId below, into a user-facing reply.)
agentId: abe71d1ea8c796386 (internal ID - do not mention to user. Use SendMessage with to: 'abe71d1ea8c796386', summary: '<5-10 word recap>' to continue this agent.)
The agent is working in the background. You will be notified automatically when it completes. You know nothing about its results until that notification arrives — do not report, assume, or predict them; continue other work or respond to the user in the meantime.
Do not duplicate this agent's work — avoid working with the same files or topics it is using.
output_file: /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/tasks/abe71d1ea8c796386.output
Do NOT Read or tail this file via the shell tool — it is the full subagent JSONL transcript and reading it will overflow your context. If the user asks for progress, say the agent is still running; you'll get a completion notification.

Async agent launched successfully. (This tool result is internal metadata — never quote or paste any part of it, including the agentId below, into a user-facing reply.)
agentId: a8d402dd5c12f9a4f (internal ID - do not mention to user. Use SendMessage with to: 'a8d402dd5c12f9a4f', summary: '<5-10 word recap>' to continue this agent.)
The agent is working in the background. You will be notified automatically when it completes. You know nothing about its results until that notification arrives — do not report, assume, or predict them; continue other work or respond to the user in the meantime.
Do not duplicate this agent's work — avoid working with the same files or topics it is using.
output_file: /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/tasks/a8d402dd5c12f9a4f.output
Do NOT Read or tail this file via the shell tool — it is the full subagent JSONL transcript and reading it will overflow your context. If the user asks for progress, say the agent is still running; you'll get a completion notification.

{
  "type": "tool_reference",
  "tool_name": "SendMessage"
}

{"success":true,"message":"Message queued for delivery to a8d402dd5c12f9a4f at its next tool round.","pin":{"id":"a8d402dd5c12f9a4f","name":"a8d402dd5c12f9a4f","ref":"99263d"}}

{"success":true,"message":"Message queued for delivery to a3ef623e1aa80b2a4 at its next tool round.","pin":{"id":"a3ef623e1aa80b2a4","name":"a3ef623e1aa80b2a4","ref":"edf7d5"}}

{"success":true,"message":"Message queued for delivery to abe71d1ea8c796386 at its next tool round.","pin":{"id":"abe71d1ea8c796386","name":"abe71d1ea8c796386","ref":"abceae"}}

1	/* pnk viewer — plain CSS, no framework, no runtime fetches. */
2	
3	:root {
4	  --ink: #1d1d1f;
5	  --muted: #6e6e73;
6	  --accent: #d0403c;      /* pnk */
7	  --surface: #f5f5f7;
8	  --card: #ffffff;
9	  --line: #d2d2d7;
10	  font-size: 15px;
11	}
12	
13	* { box-sizing: border-box; }
14	.hidden { display: none !important; }
15	.muted { color: var(--muted); }
16	.spacer { flex: 1; }
17	
18	body {
19	  margin: 0;
20	  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
21	  color: var(--ink);
22	  background: var(--surface);
23	}
24	
25	#app { max-width: 1100px; margin: 0 auto; padding: 16px; }
26	
27	/* ---- landing / drop zone ------------------------------------------------ */
28	
29	#drop-zone { padding: 8vh 0; }
30	#drop-card {
31	  background: var(--card);
32	  border: 1px solid var(--line);
33	  border-radius: 16px;
34	  padding: 40px 48px;
35	  text-align: center;
36	}
37	#drop-card h1 { margin: 0; font-size: 44px; letter-spacing: 2px; color: var(--accent); }
38	#drop-card .tagline { margin: 12px 0 28px; }
39	
40	#drop-target {
41	  border: 2px dashed var(--line);
42	  border-radius: 12px;
43	  padding: 36px 20px;
44	  transition: border-color .15s, background .15s;
45	}
46	#drop-target.dragover { border-color: var(--accent); background: #fdf1f0; }
47	#drop-target code { background: var(--surface); padding: 1px 5px; border-radius: 4px; }
48	
49	button {
50	  font: inherit;
51	  padding: 8px 18px;
52	  border-radius: 8px;
53	  border: 1px solid var(--line);
54	  background: var(--card);
55	  cursor: pointer;
56	}
57	button:hover { border-color: var(--muted); }
58	
59	/* ---- header / envelope -------------------------------------------------- */
60	
61	#app-header {
62	  display: flex;
63	  align-items: center;
64	  gap: 12px;
65	  padding: 10px 4px;
66	  flex-wrap: wrap;
67	}
68	#doc-filename { font-weight: 600; word-break: break-all; }
69	.badge {
70	  background: var(--accent);
71	  color: #fff;
72	  border-radius: 999px;
73	  padding: 2px 12px;
74	  font-size: 12px;
75	  font-weight: 700;
76	  text-transform: uppercase;
77	  letter-spacing: 1px;
78	}
79	.pill {
80	  display: inline-block;
81	  min-width: 20px;
82	  text-align: center;
83	  background: var(--surface);
84	  border-radius: 999px;
85	  padding: 0 7px;
86	  font-size: 12px;
87	}
88	
89	.panel {
90	  background: var(--card);
91	  border: 1px solid var(--line);
92	  border-radius: 10px;
93	  padding: 6px 14px;
94	  margin-bottom: 10px;
95	  font-size: 13px;
96	}
97	.panel summary { cursor: pointer; user-select: none; }
98	.chips { display: flex; flex-wrap: wrap; gap: 6px; padding: 8px 0; }
99	.chips .chip {
100	  background: var(--surface);
101	  border: 1px solid var(--line);
102	  border-radius: 999px;
103	  padding: 2px 10px;
104	  font-size: 12px;
105	}
106	#warnings-list { padding: 6px 0; }
107	.warning-row { display: flex; gap: 10px; padding: 3px 0; border-top: 1px solid var(--surface); }
108	.warning-row code { color: var(--muted); flex: 0 0 160px; }
109	.warning-row .path { color: var(--muted); font-style: italic; }
110	
111	/* ---- error card ---------------------------------------------------------- */
112	
113	.error-card {
114	  background: #fff6f5;
115	  border: 1px solid #f2c4c0;
116	  border-left: 4px solid var(--accent);
117	  border-radius: 10px;
118	  padding: 18px 22px;
119	  margin: 24px 0;
120	}
121	.error-card h2 { margin: 0 0 8px; color: var(--accent); font-size: 18px; }
122	.error-card .error-detail { margin: 8px 0 0; font-size: 13px; color: var(--muted); word-break: break-word; }
123	
124	/* ---- canvases (Keynote slides / Pages layout pages) ---------------------- */
125	
126	.canvas-outer { margin: 18px 0; }
127	.canvas-frame {           /* scaled wrapper: aspect kept via padding trick below */
128	  position: relative;
129	  overflow: hidden;
130	  background: #fff;
131	  border: 1px solid var(--line);
132	  box-shadow: 0 1px 4px rgba(0,0,0,.08);
133	}
134	.canvas-inner { position: absolute; top: 0; left: 0; transform-origin: top left; background: #fff; }
135	.canvas-drawable { position: absolute; }
136	.canvas-drawable > * { width: 100%; height: 100%; }
137	.canvas-caption { font-size: 12px; color: var(--muted); margin-top: 4px; }
138	
139	.drawable-text { overflow: hidden; display: flex; }
140	.drawable-text-inner { width: 100%; }
141	
142	.media-missing {
143	  display: flex; align-items: center; justify-content: center;
144	  border: 1px dashed var(--line); color: var(--muted); font-size: 11px;
145	  text-align: center; padding: 4px; background: var(--surface);
146	}
147	.unknown-drawable {
148	  display: flex; align-items: center; justify-content: center;
149	  border: 1px dashed #e0b0ae; color: #9c5350; font-size: 11px;
150	  text-align: center; padding: 4px; background: #fdf7f6;
151	}
152	
153	/* ---- Keynote -------------------------------------------------------------- */
154	
155	#keynote-view { display: flex; gap: 18px; align-items: flex-start; }
156	.slide-stage-slot { flex: 1; min-width: 0; }
157	.slide-list {
158	  flex: 0 0 190px; max-height: 75vh; overflow-y: auto;
159	  background: var(--card); border: 1px solid var(--line); border-radius: 10px;
160	  padding: 6px;
161	}
162	.slide-list-item {
163	  border-radius: 8px; padding: 8px; cursor: pointer; border: 2px solid transparent;
164	  font-size: 13px;
165	}
166	.slide-list-item:hover { background: var(--surface); }
167	.slide-list-item.active { border-color: var(--accent); }
168	.slide-list-item .canvas-frame { position: relative; }
169	.slide-list-item .label { display: block; margin-top: 4px; color: var(--muted); }
170	.slide-stage { flex: 1; min-width: 0; }
171	.notes-panel {
172	  background: #fffbe8; border: 1px solid #efe3b0; border-radius: 10px;
173	  padding: 10px 16px; margin-top: 14px; font-size: 14px;
174	}
175	.notes-panel h3 { margin: 0 0 6px; font-size: 12px; text-transform: uppercase; color: var(--muted); letter-spacing: 1px; }
176	
177	/* ---- Numbers --------------------------------------------------------------- */
178	
179	.sheet-tabs { display: flex; gap: 6px; flex-wrap: wrap; margin: 14px 0; }
180	.sheet-tab {
181	  border-radius: 8px 8px 0 0; border-bottom: 3px solid transparent; padding: 6px 16px;
182	}
183	.sheet-tab.active { border-bottom-color: var(--accent); font-weight: 600; background: var(--card); }
184	
185	.sheet-area { background: var(--card); border: 1px solid var(--line); border-radius: 10px; padding: 18px; overflow: auto; }
186	.sheet-canvas { position: relative; }
187	table.sheet-table { border-collapse: collapse; font-size: 13px; margin: 0 0 18px; }
188	table.sheet-table td, table.sheet-table th {
189	  border: 1px solid #e3e3e8;
190	  padding: 4px 8px;
191	  min-width: 42px;
192	  empty-cells: show;
193	}
194	table.sheet-table th { font-weight: 700; background: #ececf1; text-align: left; }
195	table.sheet-table tfoot td { font-style: italic; background: #f6f6f9; }
196	table.sheet-table td.cell-error { color: #b03030; font-style: italic; }
197	.table-caption { font-size: 12px; color: var(--muted); margin-bottom: 4px; }
198	
199	/* ---- Pages ------------------------------------------------------------------ */
200	
201	.pages-flow {
202	  background: var(--card); border: 1px solid var(--line); border-radius: 10px;
203	  padding: 40px 56px; max-width: 820px; margin: 18px auto; line-height: 1.45;
204	}
205	.pages-flow h1, .pages-flow h2, .pages-flow h3,
206	.pages-flow h4, .pages-flow h5, .pages-flow h6 { margin: 0.6em 0 0.3em; }
207	.pages-flow p { margin: 0.4em 0; }
208	.footnotes-section {
209	  border-top: 1px solid var(--line); margin-top: 24px; padding-top: 10px;
210	  font-size: 12.5px; color: #3c3c43;
211	}
212	.footnote { margin: 3px 0; }
213	.footnote .mark { font-weight: 600; margin-right: 6px; }
214	.pages-page + .pages-page { margin-top: 22px; }
215	/* ---- list markers ---------------------------------------------------------- */
216	
217	.list-item { display: flex; align-items: baseline; }
218	.list-item > p, .list-item > h1, .list-item > h2, .list-item > h3,
219	.list-item > h4, .list-item > h5, .list-item > h6 { flex: 1; }
220	.list-marker { flex: 0 0 auto; white-space: pre; }
221	

58:test("landing shows the local-only drop zone", async ({ page }) => {
61:  await expect(page.locator("#drop-target")).toBeVisible();
62:  await expect(page.locator("#drop-hint")).toContainText("nothing about them leaves the browser");
73:  await page.setInputFiles("#file-input", path.join(CRAWL, FIXTURES.keynote));
103:  await page.setInputFiles("#file-input", path.join(CRAWL, FIXTURES.numbers));
121:  await page.setInputFiles("#file-input", path.join(CRAWL, FIXTURES.pages));
133:  await page.setInputFiles("#file-input", LEGACY_FIXTURE());
144:  await page.setInputFiles("#file-input", ENCRYPTED_FIXTURE());
1:import { defineConfig } from "@playwright/test";
3:export default defineConfig({
6:  webServer: {
8:    port: 8123,
13:    baseURL: "http://127.0.0.1:8123",

The file /Users/phebert/pnk/viewer/src/main.ts has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/index.html has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/styles.css has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/styles.css has been updated successfully. (file state is current in your context — no need to Read it back)

  dist/main.js  57.9kb

⚡ Done in 5ms

  ✓  3 tests/gate.spec.ts:100:1 › numbers fixture renders sheet tables with real cell values (190ms)
  ✓  4 tests/gate.spec.ts:118:1 › pages fixture renders flowing paragraphs and headings (326ms)

  ✓  5 tests/gate.spec.ts:131:1 › legacy fixture gets the legacy explanation (82ms)

  ✓  6 tests/gate.spec.ts:141:1 › encrypted fixture gets the password-protected explanation (78ms)

  6 passed (1.3s)

keynote loaded via picker: ok
overlay visible during drag over open doc: true
numbers loaded via drop on open doc: ok; overlay hidden after drop: true
Shell cwd was reset to /Users/phebert/pnk

 M viewer/index.html
 M viewer/src/main.ts
 M viewer/styles.css

3 files changed, 83 insertions(+), 19 deletions(-)

The file /Users/phebert/pnk/viewer/index.html has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/styles.css has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/styles.css has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/styles.css has been updated successfully. (file state is current in your context — no need to Read it back)

shots done

The file /Users/phebert/pnk/viewer/styles.css has been updated successfully. (file state is current in your context — no need to Read it back)

shots done

6 passed (1.3s)

2 files changed, 37 insertions(+), 1 deletion(-)

{"success":true,"message":"Message queued for delivery to a3ef623e1aa80b2a4 at its next tool round.","pin":{"id":"a3ef623e1aa80b2a4","name":"a3ef623e1aa80b2a4","ref":"edf7d5"}}

{"success":true,"message":"Message queued for delivery to abe71d1ea8c796386 at its next tool round.","pin":{"id":"abe71d1ea8c796386","name":"abe71d1ea8c796386","ref":"abceae"}}

{"success":true,"message":"Message queued for delivery to a8d402dd5c12f9a4f at its next tool round.","pin":{"id":"a8d402dd5c12f9a4f","name":"a8d402dd5c12f9a4f","ref":"99263d"}}

     181 /Users/phebert/pnk/model/src/keynote.ts
      99 /Users/phebert/pnk/model/src/numbers.ts
     192 /Users/phebert/pnk/model/src/pages.ts
     448 /Users/phebert/pnk/model/src/primitives.ts
     662 /Users/phebert/pnk/model/src/shared.ts
     505 /Users/phebert/pnk/docs/model-design.md
    2087 total

1	# pnk JSON Document Model — Design Notes
2	
3	The JSON the pnk pipeline emits (Rust `pnk2json` → TS viewer). The model is for a
4	**reader/viewer, not an editor**: everything is resolved, flattened, and
5	self-contained. Source of truth for the format is `docs/format/` (start at
6	`INDEX.md`); this doc says how that format maps onto the model in
7	`model/src/*.ts`.
8	
9	Files:
10	
11	| file | contents |
12	|---|---|
13	| `model/src/primitives.ts` | colors, geometry, fills/shadows/strokes, curve primitives, resolved text styles, units + conventions |
14	| `model/src/shared.ts` | root envelope, TSWP text model, TSD drawable union, TST table model, TSCH chart model, TSCE placeholder |
15	| `model/src/pages.ts` | `PagesDocument` — both flavors (word-processing / page-layout) |
16	| `model/src/numbers.ts` | `NumbersDocument` — sheets as canvases |
17	| `model/src/keynote.ts` | `KeynoteDocument` — show → slides, masters resolved |
18	
19	---
20	
21	## 1. Conventions
22	
23	### 1.1 Units (everywhere, no exceptions)
24	
25	| quantity | unit | JSON shape | source |
26	|---|---|---|---|
27	| lengths / positions / sizes | points | `number`, `{x,y}`, `{width,height}` | proto floats are already points |
28	| angles | degrees | `angleDeg: number` | `TSD.GeometryArchive.angle` is **radians** [proto]; converter converts; Keynote build/transition `direction` stays a stored enum string |
29	| colors | hex | `"#rrggbb"` or `"#rrggbbaa"` | `TSP.Color` (see §2.3) |
30	| dates | ISO 8601 UTC | `"...Z"` string | `TSP.Date.seconds` / cell dates are doubles = seconds since 2001-01-01T00:00:00Z [proto + parser: numbers-parser `EPOCH`] |
31	| durations | seconds | `{seconds}` or `durationSec` | proto double seconds |
32	
33	### 1.2 Optional vs null
34	
35	- `field?: T` — **not specified**: the source never set a value (proto field
36	  absent, and no `*_null` flag). A viewer applies its own default.
37	- `field: T | null` — **explicitly unset**: the source deliberately cleared the
38	  value (TSS `*_null = true` flags per docs/format/styles.md).
39	- In the shipped model, styles are **resolved**, so `| null` fields are rare:
40	  the TSS null-flag only matters mid-resolution; after walking the parent chain
41	  the flag has been consumed (either something supplied a value, or the value is
42	  genuinely absent → `?`). `CellValue` uses a tagged union instead of nullable
43	  variants so `null` never becomes ambiguous.
44	
45	### 1.3 No indirection
46	
47	- No object ids, no `TSP.Reference`, no `TSP.DataReference` u64s in content
48	  positions (media ids survive only inside `MediaRef.dataId`, which points at
49	  the envelope's `media[]` inventory — that's a lookup key, not a dangling
50	  reference).
51	- Style inheritance (`TSS.StyleArchive.parent` chains) is resolved at convert
52	  time; emitted styles are flat.
53	- Text attribute-table offsets (`table_char_style` character indexes) are
54	  consumed by the splitter; runs carry text + style, nothing else
55	  (docs/format/text.md).
56	- Group children are embedded; groups nest, there is no `parent` back-pointer.
57	
58	### 1.4 Rust-serde compatibility
59	
60	camelCase fields; enums are string unions; discriminated unions carry a
61	`type`/`kind` string; no tuples, no branded/intersection tricks in serialized
62	positions, no `null` inside unions where a variant string works. Verified by
63	`tsc --strict` (see §6).
64	
65	### 1.5 Reading the envelope — cheat block
66	
67	Three rules cover every compact spot in the JSON:
68	
69	1. **Text items** (`Paragraph.items`): bare `string` = plain unstyled run;
70	   `{ text, cStyle?, hyperlink?, language? }` = styled run; `{ type:
71	   "inline-object" | "field", … }` = tagged rare items.
72	2. **Grid cells** (`grid[r][c]`): bare `string | number | boolean` =
73	   unformatted value (position implies row/col); `null` = no cell; object =
74	   anything more (`{ v, type?, fmt?, cellStyleIndex?, formula? }`).
75	3. **Styles are pooled**: `pStyle`/`cStyle`/`fmt`/`cellStyleIndex` index into
76	   `styles.para` / `styles.char` / per-table `formats` / per-table
77	   `cellStyles`; an absent index means unstyled/unformatted/default.
78	
79	Glossary: **`v`** = the cell's value (plain scalar, `StyledText`, or `null`
80	for a present-but-valueless cell); **`fmt`** = index into the table's
81	`formats` pool; **`cStyle`** = index into `styles.char`; **`pStyle`** = index
82	into `styles.para`; **`cur`** = ISO 4217 currency code when
83	`type: "currency"`.
84	
85	**STYLES OMIT-DEFAULT** (approved): pooled styles (`styles.para`,
86	`styles.char`, per-table `cellStyles`) emit only NON-DEFAULT values; an
87	absent key means the documented default applies (for resolved styles this
88	coincides with "not specified": the inheritance chain was exhausted, so the
89	app default wins). Defaults: indents and spacing (`leftIndentPt`,
90	`rightIndentPt`, `firstLineIndentPt`, `spaceBeforePt`, `spaceAfterPt`,
91	`baselineShiftPt`, `trackingPt`) **0.0**; `lineSpacingMultiple` **1.0**
92	(single); `horizontalAlignment` **"auto"**; `list.markerKind` **"none"**,
93	`list.level` **0**; booleans (`bold`, `italic`, `keepLinesTogether`,
94	`keepWithNext`, `hyphenate`, `pageBreakBefore`, `textWrap`) **false**;
95	`underline`/`strikethrough` **"none"**. Colors and `fontName`/`fontSizePt`
96	have no format default — absent means the viewer picks (black / its font
97	stack).
98	
99	**CellFormat kind is a CLOSED enum** (`CellFormat.kind`): exotic number
100	displays emit as `kind: "number"` with the semantic carried in
101	`formatString` — hex/binary/octal as `"base-16"` / `"base-2"` / `"base-8"`,
102	fractions as templates like `"# ?/?"`, scientific as `E+` patterns
103	(e.g. `"0.00E+00"`); the viewer renders from `formatString` (converter
104	behavior landed in 3eb8066).
105	
106	String-escaping rule (serializer-side, decoded data unaffected): space
107	separators (Zs: NBSP, ideographic space, …) and format characters (Cf: ZWSP,
108	ZWNJ, ZWJ, BOM, bidi marks, soft hyphen, …) plus U+2028/U+2029 escape as
109	`\uXXXX`; plain space and tab stay raw. Reviewers must be able to trust that
110	what looks like a space IS a space (docs/format/gotchas.md #17).
111	
112	Rust reference (serde untagged enums — the real impl lives in
113	`crates/pnk2json/src/model.rs`; pattern shown for copy-paste):
114	
115	```rust
116	#[derive(Deserialize)]
117	#[serde(untagged)]
118	enum ParagraphItem { Plain(String), Styled(StyledRun), Field(FieldRun) }   // Styled has no tag: text key matches first
119	
120	#[derive(Deserialize)]
121	#[serde(untagged)]
122	enum GridCell { Scalar(serde_json::Value), Cell(TableCell) }                // cell object = has "v" key
123	```
124	
125	Caveats, honestly stated: static consumers WITHOUT untagged support (Go
126	`encoding/json`, Swift `Codable`) need one small custom unmarshaler per union
127	(string-or-object, scalar-or-cell) — ~10 lines each, same pattern; and
128	serde's `untagged` probing re-parses fallback branches, so on very dense
129	files prefer `GridCell` first-branch `Scalar` hit-rate (most cells are
130	scalars) or deserialize the grid column as `serde_json::Value` and match
131	manually. JSON emission stays compact (LS/PS escaping stays).
132	
133	---
134	
135	## 2. Mapping table (proto → model)
136	
137	### 2.1 Document trees
138	
139	| proto (docs/format doc) | model |
140	|---|---|
141	| `TP.DocumentArchive` [10000] + `TSA./TSK.DocumentArchive` (pages.md) | `PagesDocument` |
142	| `TP.DocumentArchive.body_storage` → `TSWP.StorageArchive` | `PagesDocument.body: StyledText` (word-processing flavor) |
143	| `TP.DocumentArchive.section` [10011] | `PagesDocument.sections` +, in page-layout flavor, the canvas in `floating[]` |
144	| body flow in page-layout docs | `PagesDocument.hiddenBody?: StyledText` — present only when the storage has ≥1 non-empty body paragraph; Pages 26.3 layout docs keep a live, findable body flow Apple never renders `[fixture-verified: Peter's G2 + UI screenshot; Convert-to-Layout's "body discarded" warning is rendering-level only]` — preserved rather than dropped, viewer ignores the field |
145	| `TP.FloatingDrawablesArchive` page_groups | `PagesDocument.floating: FloatingPage[]` |
146	| `TP.DrawablesZOrderArchive` [10015] | paint order of `floating[].drawables` |
147	| `TP.PageTemplateArchive` (masters) | `PagesDocument.pageTemplates` |
148	| `TN.DocumentArchive` [1] (numbers.md) | `NumbersDocument` |
149	| `TN.SheetArchive` [2] | `NumbersDocument.sheets[]` — the sheet **is** the canvas |
150	| `TN.FormBasedSheetArchive` [3] | `NumbersDocument.forms[]` (recorded, not rendered) |
151	| `KN.DocumentArchive` [1] → `KN.ShowArchive` [2] (keynote.md) | `KeynoteDocument` |
152	| `KN.SlideTreeArchive.slides` (authoritative order) | `KeynoteDocument.slides[]` |
153	| `KN.SlideNodeArchive` (navigator tree) | only `skipped`/`slideNumberVisible` flags harvested |
154	| `KN.ThemeArchive.templates` | `KeynoteDocument.masters[]` |
155	| `TSP.PackageMetadata` (object 2), `Metadata/*.plist` | `DocumentMeta` + `media[]` |
156	
157	### 2.2 Text (TSWP) — docs/format/text.md
158	
159	| proto | model |
160	|---|---|
161	| `TSWP.StorageArchive.text[0]` (single string; newlines split paragraphs) | `StyledText.paragraphs[]` |
162	| `table_para_style` entries (`character_index` → ParagraphStyleArchive) | `Paragraph.pStyle` index into the document's `styles.para` pool (resolved through the TSS parent chain; absent = default) |
163	| `table_char_style` entries | `TextRun`s with `cStyle` index into the `styles.char` pool; plain runs collapse to a bare JSON string item |
164	| null `object` entry = "keep previous" [parser: iwork2html.go:290] | splitter carries the previous style forward |
165	| `table_attachment` + U+FFFC | `InlineObjectRun { drawable }` — the drawable is embedded |
166	| `DrawableAttachmentArchive` h/v offsets | `InlineObjectRun.offset` |
167	| textual attachments (page number/count/footmark), smart fields | `FieldRun` |
168	| footnotes (`table_footnote` → contained storage) | `PagesDocument.footnotes[]` |
169	
170	**Compact text items:** `Paragraph.items` entries are a bare JSON string
171	(plain unstyled run) or an object — `{ text, cStyle?, hyperlink?, language? }`
172	for styled runs (no `type` key; the `text` key is self-evident) and
173	`{ type: "inline-object" | "field", … }` for the rare tagged items.
174	**Offset semantics:** attribute-table indexes are **UTF-16 code units**, not
175	code points (docs/format/text.md §Unicode handling). The splitter must count
176	UTF-16 units; this is the #1 way astral-plane emoji text gets mis-sliced.
177	
178	Text styles are **pooled, not inlined** (same precedent as the formats pool):
179	document-wide `styles: { para, char }` deduped pools, ordered first-use.
180	Measured rationale: Zen book (1,539 paragraphs) = 9 distinct para shapes + 5
181	char shapes — 168 KB inline (31% of the envelope) collapses to ~21 KB pooled
182	(−87%); pages-717KB-1 = 2 shapes across 59 paragraphs, −32% envelope.
183	Drawable styles stay INLINE by design (measured: 59 nodes / 3 KB on the
184	biggest Keynote sample — pooling them is not worth the churn).
185	
186	### 2.3 Colors — `TSP.Color`
187	
188	[proto: .scratch/otorp/Keynote/TSPMessages.proto → TSP.Color] — `model`
189	rgb=1/cmyk=2/white=3, float components 0..1, `rgbspace` srgb=1/p3=2, `a`
190	default 1, `headroom` default 1 (HDR), c/m/y/k or w alternatives.
191	
192	Conversion (documented in `primitives.ts`): rgb+srgb → scale 0..255 per
193	channel; p3 → nearest-sRGB approximation + `color-degraded` warning when
194	visibly out of gamut [inferred]; cmyk/white → naive formulas [inferred];
195	headroom ≠ 1 → clamp + warning. Alpha byte appended when `a ≠ 1`.
196	
197	### 2.4 Drawables (TSD) — docs/format/drawables.md
198	
199	| proto | model |
200	|---|---|
201	| `TSD.DrawableArchive` geometry (position/size/radians-angle) | `DrawableCommon.position/size/angleDeg` |
202	| `TSD.ShapeArchive` + `PathSourceArchive` variants | `ShapeDrawable.geometry: ShapeGeometry` (see §2.5) |
203	| `TSWP.ShapeInfoArchive` (is_text_box) + owned storage | `TextboxDrawable` (or `ShapeDrawable.text` for shapes with text) |
204	| `TSD.ImageArchive` (`data` DataReference, modern; `database_data` TSP.Reference, legacy) | `ImageDrawable.image: MediaRef` resolved through the DataInfo registry (docs/format/media.md) |
205	| `TSD.MovieArchive` | `MovieDrawable` (+ `remoteUrl` for linked movies) |
206	| `TSD.GroupArchive` children | `GroupDrawable.children` embedded |
207	| `TSD.ConnectionLineArchive` endpoints (TSP.References) | anchors resolved; path baked as curves |
208	| `TST.TableInfoArchive` → `TableModelArchive` | `TableDrawable { common, table }` |
209	| `TSCH.ChartDrawableArchive` (unity ext 10000) | `ChartDrawable { common, chart }` |
210	| `TP.PlaceholderArchive` [7] / `KN.PlaceholderArchive` [7,12] | any drawable with `placeholder: { role, inherited }` |
211	| `TSD.FreehandDrawingArchive` (ext 100 on Group) | `GroupDrawable.freehand` |
212	| unknown type ids | `UnknownDrawable { typeId, typeName?, reason }` + warning |
213	
214	### 2.5 Shapes → curves
215	
216	`TSP.Path` is the universal curve language
217	[proto: TSPMessages.proto → TSP.Path, ElementType moveTo/lineTo/quadCurveTo/
218	curveTo/closeSubpath] and maps 1:1 onto `CurveElement`
219	(move/line/quad/cubic/close). Sources, in priority order:
220	
221	1. `bezier_path_source.path` / `editable_bezier_path_source` (node + control
222	   points) → explicit `CurvePath` (editable-bezier smooth nodes become cubic
223	   segments).
224	2. `callout_path_source` → preset `"callout"` + `callout` tail parameters.
225	3. `scalar_path_source` (rounded rect / regular polygon / chevron + scalar) →
226	   `preset` + `scalar` + `naturalSize`.
227	4. `point_path_source` (arrows/star/plus enums) → `preset` + `naturalSize`.
228	
229	Presets are named, not expanded: the viewer renders them (they are closed
230	vocabularies: docs/format/drawables.md lists the enums). `naturalSize` is the
231	design coordinate space for the path/preset; the drawable scales it into
232	`common.size`.
233	
234	### 2.6 Tables (TST) — docs/format/tables.md
235	
236	The tile/offset-buffer machinery is fully flattened:
237	
238	| proto | model |
239	|---|---|
240	| `TableModelArchive` dimensions, header counts, frozen flags | `TableModel` scalar fields |
241	| `DataStore.rowHeaders/columnHeaders` buckets | `rows[]/columns[]` (index, sizePt, hidden) |
242	| tile `cell_storage_buffer` + packed offsets (BNC v5) | `grid[row][column]` — dense row-major; plain string/number/boolean scalars for unformatted cells, `null` for absent cells |
243	| cell type byte → payload flags | scalar cells stay bare; ambiguous values get a `type` tag on the cell object (`date`/`duration`/`currency`/`richtext`/`error` — dates → ISO, duration → seconds) |
244	| `TableDataList` STRING/RICH_TEXT_PAYLOAD entries | cell `v` string / `{ v: StyledText, type: "richtext" }` |
245	| `TableDataList` FORMAT/CUSTOM_FORMAT | `formats[]` deduped pool, referenced by `TableCell.fmt` (custom formats degrade to `kind:"custom"` + raw string) |
246	| `merge_region_map` CellRanges (col<<16|row packedData) | `merges[]` anchor + span |
247	| `TableStyleNetworkArchive` role slots | `TableStyle` defaults; per-cell `cell_style`/`text_style` overrides resolved on top |
248	| `TST.CellStylePropertiesArchive` fills/strokes/vertical alignment/padding | `cellStyles: TableCellStyle[]` deduped per-table pool, referenced by `TableCell.cellStyleIndex` |
249	
250	Cell layout is a **dense row-major `grid` with deduped `formats` and
251	`cellStyles` pools** instead of a flat sparse cell list: measured on the dense
252	28881×59 Numbers fixture, the flat `cells` design (pretty-printed JSON + a
253	`CellFormat` object duplicated per cell) pushed the envelope to 474 MB;
254	`grid` + format-pool + compact emission lands at ~70–90 MB, and row-major
255	maps 1:1 onto `<tr>` rendering.
256	
257	Formulas: the cell's stored value **is** the last calculated result
258	(docs/format/calcengine.md) — the model never re-evaluates. The presence of a
259	formula becomes `cell.formula: TsceFormulaRef` (opaque).
260	
261	### 2.7 Charts (TSCH) — docs/format/charts.md
262	
263	| proto | model |
264	|---|---|
265	| `ChartType` enum (27 variants) | `ChartType` union + `threeD` flag |
266	| `ChartGridArchive` row/column names + GridValue values | `categories` + `series[]` (role assignment follows `series_direction` [inferred per charts.md]) |
267	| `series_direction` by_row/by_column | consumed during the assignment above |
268	| Keynote charts (private grid) | `dataStatus: "inline"` |
269	| Numbers mediator (`TN.ChartMediatorArchive` formulas) | `dataStatus: "table-bound"` + `dataBinding: TsceFormulaRef` (binding formulas are TSCE — opaque) |
270	| `legend_frame`, fill sets, axis/series generic property maps | `legendFrame`, `seriesColors` (best effort); everything else is **rendering** → deferred to the viewer, not modeled |
271	
272	### 2.8 Calc engine (TSCE) — docs/format/calcengine.md
273	
274	Deliberately **not** decompiled. `TsceFormulaRef { id, status: "unparsed",
275	warning }` records that a formula existed; the last-calculated value already
276	lives in the cell/chart data. If formula text is trivially re-synthesizable
277	(numbers-parser's ~30-node dispatch table approach), `sourceText` may be
278	filled — optional, never required.
279	
280	---
281	
282	## 3. Flattening rules
283	
284	### 3.1 Style inheritance resolution order
285	
286	For any style-bearing object (text run, cell, shape, media):
287	
288	1. Start from the object's own style archive's property payload
289	   (`char_properties` / `para_properties` / `shape_properties` /
290	   `cell_properties` …).
291	2. Walk `TSS.StyleArchive.parent` to the root; **child overrides parent**,
292	   property by property. A `*_null = true` flag **clears** the inherited value
293	   and stops the walk for that property [proto: docs/format/styles.md].
294	3. Named-theme presets are NOT implicitly applied — only the object's chain
295	   matters (presets exist for the apps' UI).
296	4. Emit only properties that survived (all `?`).
297	
298	Caveat carried from styles.md: multi-level chains beyond one parent are
299	proto-real but parser-unverified (dunhamsteve panics on recursion) — the
300	converter MUST implement full recursion and fixture-test it.
301	
302	### 3.2 Placeholder chain (Keynote/Pages)
303	
304	A slide (or page) placeholder — title/body/object/slide-number — is a
305	`KN./TP.PlaceholderArchive` extending the textbox chain. Resolution:
306	
307	1. If the slide's placeholder carries text or explicit geometry/style
308	   overrides, bake them into the drawable.
309	2. Otherwise inherit geometry + style from the master slide's placeholder of
310	   the same `kind` (template chain: `KN.SlideArchive.template_slide`), and set
311	   `placeholder.inherited = true`.
312	3. Master placeholders with no slide-side counterpart stay in `masters[]`
313	   only.
314	
315	### 3.3 Text splitting
316	
317	`text[0]` + attribute tables → paragraphs/runs (§2.2). The splitter:
318	
319	1. Slices at newline characters (UTF-16 aware).
320	2. Slices runs at `table_char_style` entry offsets; a null entry inherits the
321	   previous run's style.
322	3. Replaces U+FFFC positions with `InlineObjectRun` and textual/smart fields
323	   with `FieldRun`.
324	4. Emits **no offsets** — paragraph order + item order is the position.
325	
326	### 3.4 Group coordinate re-basing
327	
328	Proto children carry canvas-absolute geometry; the converter subtracts the
329	group's position so `GroupDrawable.children` live in group-local coordinates
330	(moving a group moves everything).
331	
332	### 3.5 Media resolution
333	
334	`DataReference.identifier` → `TSP.PackageMetadata.datas` (object 2) entry →
335	`Data/{file_name}` bytes (docs/format/media.md resolution chain). The envelope
336	`media[]` lists every DataInfo; `MediaRef.dataId` is the decimal string of the
337	u64 identifier (JS-safe). Missing bytes → `media-missing` warning, MediaRef
338	kept with names only.
339	
340	---
341	
342	## 4. Root envelope
343	
344	Every document root carries:
345	
346	- `meta: DocumentMeta` — app, application (Properties.plist `Application`),
347	  `fileFormatVersion`, build version history (BuildVersionHistory.plist),
348	  document id (DocumentIdentifier / PackageMetadata.revision), locale
349	  (TSK.DocumentArchive), created/modified when the source carries them.
350	- `warnings: Warning[]` — see §5.
351	- `fonts: string[]` — deduped font names harvested from resolved CharStyles;
352	  the viewer wants the font list before first paint.
353	- `media: MediaAsset[]` — the Data/ inventory (kind inferred from extension
354	  per docs/format/media.md).
355	- `styles: { para: ParaStyle[]; char: CharStyle[] }` — document-wide deduped
356	  text-style pools, ordered first-use; `Paragraph.pStyle` / run `cStyle`
357	  reference entries by index (absent index = unstyled/default). Tables carry
358	  their own deduped `cellStyles` pool per table. Drawable styles stay inline
359	  (measured: not worth pooling — §2.2).
360	
361	---
362	
363	## 5. Warnings taxonomy + registry-drift policy
364	
365	`Warning { code, message, path?, detail? }` — anything dropped, degraded, or
366	unknown becomes a row; **no silent drops**. Codes (enum in shared.ts):
367	
368	| code | when |
369	|---|---|
370	| `unknown-object-type` | MessageInfo.type has no trusted registry entry → payload skipped, id recorded **in hex, never a guessed name** (docs/format/registry.md recommendation) |
371	| `undecodable-object` | known type, payload failed to decode (length-delimited skip, docs/format/gotchas.md #6) |
372	| `unresolved-reference` | TSP.Reference/DataReference pointed nowhere |
373	| `unsupported-feature` | content exists, model can't represent it faithfully (e.g. pivot tables, cond-style rules) |
374	| `media-missing` | Data/ bytes absent |
375	| `color-degraded` | P3→sRGB approximation or HDR clamp |
376	| `legacy-variant` | pre-UFF charts, nested-Index.zip variant, etc. |
377	| `table-degraded` | pre-BNC tiles, broken offsets |
378	| `formula-unparsed` | TSCE AST kept opaque |
379	
380	Registry policy per docs/format/registry.md: prefer keynote-parser 14.5 table
381	for KN ids, Common+Numbers/Pages JSONs for TN/TP ids; unknown ids stay opaque.
382	
383	---
384	
385	## 6. What is DROPPED (viewer-irrelevant or descoped)
386	
387	| dropped | why |
388	|---|---|
389	| TSCE formula ASTs, dependency archives, OwnerUIDMapper | calc engine out of viewer scope (docs/format/calcengine.md); values already stored |
390	| Undo/command archives (`TSK./TSCK./KN./TP.Command*`), incremental patches (`should_merge`, `base_message_index`) | editing history, not content (docs/format/incremental.md) |
391	| `TN.UIStateArchive` scroll/zoom, selection archives (`TSD.CanvasSelectionArchive`, `TSCH.ChartSelection*`) | app UI state, not document content |
392	| `KN.RecordingEventTrack/MovieTrack` details | self-playing-recording machinery; existence noted |
393	| `TSD.ImageArchive` variant data beyond primary/original/thumbnail/svg (adjusted, enhanced, instant-alpha paths) | editing derivatives; viewer shows the primary image |
394	| RB-trees (`rowTileTree/columnTileTree`), tile segmentation, LargeArray segments | storage mechanics — flattened by the converter |
395	| 3D chart scene state (lighting, materials, textures) | rendering deferred; only the `threeD` flag survives |
396	| Themes' preset catalogs (`TSWP./TSD./TSA.ThemePresetsArchive`, color presets, fill sets) | UI affordances; resolved styles already bake in what's used |
397	| `VersionedStyles` snapshots in stylesheets (styles_for_10_0 …) | per-release style caches |
398	| Custom format list beyond what cells reference | unused formats are dead weight |
399	| `TSD.StrokePatternArchive` "smart stroke" parameter dictionaries | decorative stroke textures beyond dash pattern |
400	| iWork '08/'09 legacy content | out of scope entirely (docs/format/legacy.md) |
401	
402	Anything else the converter meets and cannot model becomes `UnknownDrawable`
403	or a warning — never a silent drop.
404	
405	---
406	
407	## 7. How iwadump / pnk2json emit into these types
408	
409	**iwadump** (structure inspector, phase 3): dumps raw archives; its output
410	"maps onto the model" in the sense that every object type id it prints should
411	be classifiable as (a) modeled here, (b) listed in §6 dropped, or (c) a
412	warning. If a fourth bucket appears, extend the model or §6 — don't guess.
413	
414	**pnk2json** (Rust serde, phase 4) emission order:
415	
416	1. Open container (docs/format/container.md): package vs flat zip, nested
417	   `Index.zip`, reject `.iwph`/legacy; read `Metadata/*.plist` + object 2
418	   (`TSP.PackageMetadata`) → `meta` + `media[]`.
419	2. Decode all `.iwa` streams into `Records[id] = (type, payload)`
420	   (docs/format/objects.md); unknown type ids → warnings, skip by declared
421	   length.
422	3. Walk the app tree (§2.1 mapping) resolving TSP.References as you go;
423	   missing targets → `unresolved-reference` warnings, content continues.
424	4. Resolve styles (§3.1), placeholders (§3.2), text (§3.3) during the walk —
425	   one pass, no id survives.
426	5. Collect fonts (dedupe/sort) and dedupe resolved text styles into the document-wide `styles.para`/`styles.char` pools (first-use order) and per-table `cellStyles`, then serialize with serde. Field names here ARE
427	   the serde names — keep them in sync (this file + `#[serde(rename_all =
428	   "camelCase")]` + variant renames for unions).
429	
430	Suggested Rust module split mirrors the TS files 1:1, so a TS type and a Rust
431	struct with the same name stay reviewable side by side.
432	
433	### TS typechecking
434	
435	```
436	tsc --noEmit --strict --skipLibCheck model/src/*.ts
437	```
438	
439	(is the verification gate; no package.json needed for the model sources.)
440	
441	---
442	
443	## 8. Fixture-verified notes (pnk2json, phases 4–5, 2026-08-28)
444	
445	Findings from running the converter over the 968 modern fixtures in
446	`fixtures/success.tsv` (964 convert; 4 encrypted clean-reject). Each note
447	records what the corpus confirmed and what remains inferred.
448	
449	### 8.1 TST vertical alignment — fixture-verified
450	
451	`TST.CellStylePropertiesArchive.vertical_alignment` (field 8) appears in real
452	Numbers fixtures (e.g. `tableCell-0-bodyStyle` chains) carrying small int32
453	values (0/1/2 observed, `2` = bottom on a centered body style). The 0..3
454	order top/middle/bottom/justify shared with
455	`TSWP.ShapeStylePropertiesArchive.VerticalAlignmentType` holds on this
456	sample; pnk2json maps all four values. Padding (field 9, `TSWP.PaddingArchive`
457	{left,top,right,bottom}) confirmed present alongside it.
458	`[fixture-verified + proto]`
459	
460	### 8.2 Pages master wiring — era drift confirmed in the corpus
461	
462	Current-generation Pages documents carry page masters as
463	`TP.PageTemplateArchive` referenced from `TP.DocumentArchive.page_templates`
464	(field 48). Older (still iWork-'13-era) fixtures in the corpus instead carry
465	`TP.PageMasterArchive` **[10143]** — the message pages.md flagged as "absent
466	from the 15.3.1 extraction, present in older protos". Confirmed in the wild:
467	type id 10143 appears in real `.pages` files (with a sibling
468	`TP.CanvasSelectionArchive` [10132]), and those documents have no field-48
469	template list. pnk2json resolves field-48 templates fully and leaves
470	PageMasterArchive-era masters to the unknown/dropped path (content still
471	converts; the header/footer furniture of such masters is not modeled).
472	`[fixture-verified]`
473	
474	### 8.3 P3 / HDR color policy — unchanged, [inferred]
475	
476	No fixture produced a visibly-out-of-gamut P3 color or headroom > 1 during
477	conversion, so the §2.3 approximation policy (clamp + `color-degraded`
478	warning) remains implemented but **not yet fixture-exercised**. The policy
479	stays as documented; revisit if a wide-gamut fixture appears.
480	
481	### 8.4 Storage splitting — UTF-16 offsets confirmed end-to-end
482	
483	Converting keynote/pages fixtures with astral-plane content confirms that
484	attribute-table offsets are UTF-16 code units and that slicing on the
485	code-point-indexed buffer with a UTF-16 map reproduces paragraph and run
486	boundaries (docs/format/text.md §Unicode handling). U+FFFC attachment
487	entries (type 2003 → drawable; 2004/2007/2009 → textual fields;
488	2008 → footnote body storage) round-trip into `InlineObjectRun` / `FieldRun`
489	as designed. `[fixture-verified]`
490	
491	### 8.5 Tables — BNC v5 buffers across the corpus
492	
493	All decodable tiles in the 968-fixture modern set use storage version 5 /
494	wide rows; no pre-BNC tile forced the degraded path in this run. Cell type
495	byte 10 (currency) and decimal128 number payloads decode per the
496	numbers-parser layout; merges unpack as (col<<16|row). `[fixture-verified]`
497	
498	### 8.6 Registry drift in practice
499	
500	Modern fixtures carry type ids absent from the embedded (older-app-version)
501	tables — e.g. Keynote `0xde` (222, TST.TableStyleNetworkArchive era), Pages
502	`0xdb`/`219`, `0x2b03/0x2b06/0x2b07` (metadata-stream objects),
503	TSCH `5030`/`11014`. These surface as aggregated `unknown-object-type`
504	warnings with hex ids per §5 policy — never guessed names. Conversion of the
505	reachable document tree is unaffected. `[fixture-verified]`
506	

1	/**
2	 * pnk JSON document models — Pages (.pages).
3	 *
4	 * Maps TP.DocumentArchive [10000] (+ TSA/TSK supers) onto a resolved,
5	 * reference-free model. Both content flavors are first-class:
6	 *
7	 *  - "word-processing": text flows in `body` (TP.DocumentArchive.body_storage
8	 *    → TSWP.StorageArchive), sections are style/print breaks inside that flow
9	 *    (TP.SectionArchive referenced via the storage's table_section entries),
10	 *    and floating objects hang off pages (TP.FloatingDrawablesArchive).
11	 *  - "page-layout": fixed canvases — each TP.SectionArchive is one canvas of
12	 *    drawables; body is empty.
13	 *
14	 * Page masters (TP.PageTemplateArchive) are resolved into `pageTemplates`;
15	 * sections name their first/even/odd template. Placeholder chain: a slide/
16	 * page placeholder that carries no geometry/text inherits it from its
17	 * template's placeholder of the same role — the converter bakes the resolved
18	 * values in and flags `placeholder.inherited` (docs/model-design.md).
19	 *
20	 * Format facts: docs/format/pages.md (+ text.md, drawables.md, styles.md).
21	 */
22	
23	import type {
24	  Drawable,
25	  DrawableCommon,
26	  Fill,
27	  IsoDateString,
28	  PageLayoutOrientation,
29	  Paragraph,
30	  StyledText,
31	} from "./shared";
32	import type { DocumentEnvelope } from "./shared";
33	
34	// ---------------------------------------------------------------------------
35	// Page masters (TP.PageTemplateArchive)
36	// ---------------------------------------------------------------------------
37	
38	/**
39	 * A page template ("page master"): repeating furniture applied to pages that
40	 * use it. [proto: .scratch/otorp/Pages/TPArchives.proto → TP.PageTemplateArchive;
41	 *  legacy TP.PageMasterArchive [10143] is absent from 15.3.1 — treated as legacy]
42	 */
43	export interface PageTemplate {
44	  /** Display/lookup name when the source carries one. */
45	  name?: string;
46	  /** Master drawables (background shapes, rules, logo boxes). */
47	  drawables: Drawable[];
48	  /**
49	   * Template placeholders (tagged drawable pairs in the proto) — title/author
50	   * boxes etc. that user content snaps into. Roles resolved from the
51	   * placeholder kind.
52	   */
53	  placeholders: PagePlaceholder[];
54	  backgroundFill?: Fill;
55	  hideHeadersFooters?: boolean;
56	  headers: StyledText[];
57	  footers: StyledText[];
58	  headersFootersMatchPreviousPage?: boolean;
59	}
60	
61	/** A placeholder slot on a template. [proto: TagDrawablePair tag/drawable/z_index] */
62	export interface PagePlaceholder {
63	  /** Template-local role tag (app-defined string; "title"/"author" common). */
64	  tag?: string;
65	  /** The placeholder drawable (usually a textbox) with its geometry/style. */
66	  drawable: Drawable;
67	  zIndex?: number;
68	}
69	
70	// ---------------------------------------------------------------------------
71	// Sections (TP.SectionArchive) — print/style breaks in both flavors
72	// ---------------------------------------------------------------------------
73	
74	export interface PagesSection {
75	  name?: string;
76	  /** Template names for the section's pages. */
77	  firstPageTemplate?: string;
78	  evenPageTemplate?: string;
79	  oddPageTemplate?: string;
80	  /** Page numbering behavior. [proto: section_start_kind/page_number_kind/start] */
81	  pageNumbering?: {
82	    restart?: boolean;
83	    startAt?: number;
84	    /** Which number shows on the first page of the section. */
85	    firstPageNumberKind?: "continue" | "restart-at" | "from-previous";
86	  };
87	  /** Headers/footers carried over from the previous section. [proto: field 17] */
88	  inheritPreviousHeaderFooter?: boolean;
89	  /** Section background (page-layout canvases). [proto: background_fill] */
90	  backgroundFill?: Fill;
91	  /** Word-processing only: index into `body.paragraphs` where the section starts. */
92	  bodyParagraphStart?: number;
93	}
94	
95	// ---------------------------------------------------------------------------
96	// Body content (word-processing flavor)
97	// ---------------------------------------------------------------------------
98	
99	/**
100	 * Footnote attached to a body position. [proto: table_footnote +
101	 * TSWP.FootnoteReferenceAttachmentArchive.contained_storage]
102	 */
103	export interface Footnote {
104	  /** The footnote mark's character position, expressed as a path to the
105	   * containing paragraph + item index (converter-assigned). */
106	  anchorParagraphIndex: number;
107	  /** The footnote body text. */
108	  text: StyledText;
109	}
110	
111	// ---------------------------------------------------------------------------
112	// Floating objects (TP.FloatingDrawablesArchive)
113	// ---------------------------------------------------------------------------
114	
115	/**
116	 * Floating (non-inline) objects grouped by the page they anchor to.
117	 * [proto: FloatingDrawablesArchive.page_groups → PageGroup { page_index, drawables }]
118	 * `pageIndex` is 0-based; absent when the group had no page index.
119	 */
120	export interface FloatingPage {
121	  pageIndex?: number;
122	  drawables: Drawable[];
123	}
124	
125	// ---------------------------------------------------------------------------
126	// Document root
127	// ---------------------------------------------------------------------------
128	
129	/**
130	 * The Pages document model. Envelope fields (`meta`, `warnings`, `fonts`,
131	 * `media`) follow the shared DocumentEnvelope contract.
132	 */
133	export interface PagesDocument extends DocumentEnvelope {
134	  kind: "pages";
135	  /** Which flavor the source document uses. */
136	  flavor: "word-processing" | "page-layout";
137	
138	  /** Paper size in points (e.g. US Letter 612×792). [proto: page_width/page_height] */
139	  pageSize?: { width: number; height: number };
140	  /** Page margins in points. [proto: margin fields 32-37] */
141	  pageMargins?: { top?: number; bottom?: number; left?: number; right?: number; header?: number; footer?: number };
142	  orientation?: PageLayoutOrientation;
143	  /** Print scale factor (1 = 100%). [proto: page_scale] */
144	  pageScale?: number;
145	
146	  /**
147	   * Word-processing flavor: the flowing document text, fully split into
148	   * styled paragraphs with inline objects/fields resolved.
149	   */
150	  body?: StyledText;
151	  /**
152	   * Page-layout flavor only: a live, findable body flow that Pages never
153	   * renders (same shape as `body`). Present ONLY when the source storage
154	   * carries a body with at least one non-empty paragraph; omitted when empty
155	   * (absence = no hidden content). Preserved rather than dropped — viewers
156	   * ignore it.
157	   * [fixture-verified: Pages 26.3 layout docs keep the body storage; the
158	   *  Convert-to-Layout "body discarded" warning is rendering-level only]
159	   */
160	  hiddenBody?: StyledText;
161	  /** Footnotes for the body (word-processing flavor). */
162	  footnotes?: Footnote[];
163	
164	  /**
165	   * Word-processing flavor: floating objects per page. Page-layout flavor:
166	   * each entry is a canvas (TP.SectionArchive) and `pageIndex` is its number.
167	   */
168	  floating: FloatingPage[];
169	
170	  /** All page masters in the document, resolved. */
171	  pageTemplates: PageTemplate[];
172	  /** Section breaks, in document order. */
173	  sections: PagesSection[];
174	
175	  /** Table of contents entries if present. [proto: TOCSmartFieldArchive] */
176	  tableOfContents?: TableOfContents;
177	}
178	
179	/** A rendered TOC entry. [proto: TSWP TOC archives — minimal viewer-level model] */
180	export interface TableOfContents {
181	  entries: {
182	    /** Display text. */
183	    text: string;
184	    /** Page number as last rendered, when stored. */
185	    pageNumber?: number;
186	    /** Heading level (from the referenced paragraph's outlineLevel). */
187	    level?: number;
188	  }[];
189	}
190	
191	// Re-export so converters importing "./pages" get the whole envelope surface.
192	export type { DocumentEnvelope, Drawable, DrawableCommon, IsoDateString, Paragraph, StyledText };
193	

1	/**
2	 * pnk JSON document models — Keynote (.key).
3	 *
4	 * Maps KN.DocumentArchive [1] → KN.ShowArchive [2] onto a resolved,
5	 * reference-free model: show → slides, with masters (theme templates)
6	 * resolved into the slides that follow them.
7	 *
8	 * Placeholder chain resolution: a slide's title/body/object/slide-number
9	 * placeholders are drawables; when a slide placeholder is empty, its geometry
10	 * and styling inherit from the master slide's placeholder of the same role —
11	 * the converter bakes the resolved values in and flags `placeholder.inherited`
12	 * (docs/model-design.md). Slide order comes from KN.SlideTreeArchive.slides
13	 * (the authoritative list; rootSlideNode is deprecated, slideList is newer).
14	 *
15	 * Builds/transitions are kept minimal and viewer-level: each drawable can
16	 * carry a `build` (via DrawableCommon.keynoteBuild) and each slide one
17	 * `transition`. Presenter notes resolve to StyledText.
18	 *
19	 * Format facts: docs/format/keynote.md (+ text.md, drawables.md).
20	 */
21	
22	import type {
23	  DocumentEnvelope,
24	  Drawable,
25	  DrawableCommon,
26	  Fill,
27	  IsoDateString,
28	  MediaAsset,
29	  Size,
30	  StyledText,
31	} from "./shared";
32	
33	// ---------------------------------------------------------------------------
34	// Masters (KN.ThemeArchive.templates — slides that act as page masters)
35	// ---------------------------------------------------------------------------
36	
37	/**
38	 * A master (template) slide. Same content shape as Slide; slides link to it
39	 * by `masterName`. [proto: KN.ThemeArchive.templates; KN.SlideArchive.template_slide]
40	 */
41	export interface MasterSlide {
42	  name: string;
43	  drawables: Drawable[];
44	  notes?: StyledText;
45	  /** Master background fill [proto: KN.SlideStyleArchive.slide_properties.fill]. */
46	  background?: Fill;
47	}
48	
49	// ---------------------------------------------------------------------------
50	// Builds & transitions (minimal, viewer-level)
51	// ---------------------------------------------------------------------------
52	
53	/**
54	 * One build (animation) on a drawable.
55	 * [proto: KN.BuildArchive { drawable, delivery, attributes } + BuildChunks;
56	 *  delivery is a string in the proto, e.g. "build-in"/"build-out"/"action"]
57	 */
58	export interface BuildSpec {
59	  delivery: "in" | "out" | "action" | "other";
60	  /** Effect name as stored (e.g. "dissolve", "pop"). [proto: AnimationAttributesArchive.effect] */
61	  effect?: string;
62	  /** Animation type string when present (source grouping). */
63	  animationType?: string;
64	  durationSec?: number;
65	  delaySec?: number;
66	  automatic?: boolean;
67	  /** Easing. [proto: BuildAttributesAcceleration] */
68	  acceleration?: "none" | "ease-in" | "ease-out" | "ease-both" | "custom";
69	  /** Text-level staging. [proto: BuildAttributesTextDelivery] */
70	  textDelivery?: "by-object" | "by-word" | "by-character" | "by-line";
71	  /** Staged build chunks. [proto: KN.BuildChunkArchive delay/duration/automatic] */
72	  chunks?: { delaySec?: number; durationSec?: number; automatic?: boolean }[];
73	  motionBlur?: { amount: number };
74	  /** 0-based order within the slide's build sequence, when stored. */
75	  order?: number;
76	}
77	
78	/**
79	 * Slide transition. [proto: KN.TransitionArchive → TransitionAttributesArchive
80	 * → AnimationAttributesArchive { animation_type, effect, duration, direction, delay }]
81	 * Effect/direction names are kept as stored strings — the effect vocabulary is
82	 * large and app-version dependent; the viewer matches prefixes it knows.
83	 */
84	export interface TransitionSpec {
85	  /** Effect name as stored (e.g. "Magic Move", "Dissolve"). */
86	  effect?: string;
87	  animationType?: string;
88	  durationSec?: number;
89	  delaySec?: number;
90	  automatic?: boolean;
91	  /** Direction as a stored enum number cast to string (app-defined meaning). */
92	  direction?: string;
93	  /** Accent color used by some effects. */
94	  color?: string;
95	}
96	
97	// ---------------------------------------------------------------------------
98	// Slides (KN.SlideArchive)
99	// ---------------------------------------------------------------------------
100	
101	export interface Slide {
102	  /** Slide name when set. [proto: KN.SlideArchive.name] */
103	  name?: string;
104	  /** Navigator "skip" flag. [proto: KN.SlideNodeArchive.isSkipped] */
105	  skipped?: boolean;
106	  /** Master this slide follows (by MasterSlide.name). */
107	  masterName?: string;
108	  /** All drawables in paint order (z-order), placeholders included. */
109	  drawables: Drawable[];
110	  /** Presenter notes. [proto: KN.NoteArchive.containedStorage → TSWP.StorageArchive] */
111	  notes?: StyledText;
112	  /** The one slide transition. [proto: KN.SlideArchive.transition (required)] */
113	  transition?: TransitionSpec;
114	  /** Show slide number on this slide. [proto: KN.SlideNodeArchive.isSlideNumberVisible] */
115	  slideNumberVisible?: boolean;
116	  /**
117	   * Slide background fill [proto: KN.SlideStyleArchive.slide_properties.fill];
118	   * absent = inherit the master's.
119	   */
120	  background?: Fill;
121	}
122	
123	// ---------------------------------------------------------------------------
124	// Show / document root
125	// ---------------------------------------------------------------------------
126	
127	/**
128	 * The Keynote document model. Envelope fields (`meta`, `warnings`, `fonts`,
129	 * `media`) follow the shared DocumentEnvelope contract.
130	 */
131	export interface KeynoteDocument extends DocumentEnvelope {
132	  kind: "keynote";
133	
134	  /** Slide size in points. [proto: KN.ShowArchive.size (required)] */
135	  slideSize: Size;
136	
137	  /** Slides in presentation order (KN.SlideTreeArchive.slides). */
138	  slides: Slide[];
139	
140	  /** Master/template slides from the theme, resolved. [proto: KN.ThemeArchive.templates] */
141	  masters: MasterSlide[];
142	
143	  /** Theme identifier when present. [proto: TSS.ThemeArchive.theme_identifier] */
144	  themeName?: string;
145	
146	  /** Playback settings. [proto: KN.ShowArchive mode/loop/autoplay fields] */
147	  playback?: {
148	    mode?: "normal" | "auto-play" | "hyperlinks-only";
149	    loop?: boolean;
150	    autoplayTransitionDelaySec?: number;
151	    autoplayBuildDelaySec?: number;
152	    slideNumbersVisible?: boolean;
153	  };
154	
155	  /** Self-playing soundtrack. [proto: KN.Soundtrack] */
156	  soundtrack?: {
157	    /** Audio asset(s), in order. */
158	    tracks: MediaAsset[];
159	    repeat?: "none" | "one" | "all";
160	  };
161	
162	  /** Audio narration recording attached to the show. [proto: KN.RecordingArchive] */
163	  recording?: { durationSec?: number };
164	}
165	
166	// Extend DrawableCommon with Keynote-only hooks, declared here to
167	// keep shared.ts app-neutral.
168	declare module "./shared" {
169	  interface DrawableCommon {
170	    /** Keynote build/animation attached to this drawable. */
171	    keynoteBuild?: BuildSpec;
172	    /**
173	     * Placeholder identity: role from the converter plus the inherited flag
174	     * (master-derived geometry/style). [proto: KN.PlaceholderArchive.Kind]
175	     */
176	    placeholder?: { role: string; inherited?: boolean };
177	  }
178	}
179	
180	// Re-export so converters importing "./keynote" get the whole surface.
181	export type { Drawable, DrawableCommon, IsoDateString };
182	

pages-77KB-10 {'flavor': 'page-layout', 'pageSize': {'width': 522.0, 'height': 378.0}, 'pageMargins': {'top': 72.0, 'bottom': 72.0, 'left': 72.0, 'right': 72.0, 'header': 36.0, 'footer': 43.20000076293945}, 'orientation': 'landscape', 'pageScale': 1.0}
G1-golden-pages-wp {'flavor': 'word-processing', 'pageSize': {'width': 612.0, 'height': 792.0}, 'pageMargins': {'top': 72.0, 'bottom': 72.0, 'left': 72.0, 'right': 72.0, 'header': 36.0, 'footer': 43.20000076293945}, 'orientation': 'portrait', 'pageScale': 1.0}
G5-golden-pages-acid {'flavor': 'word-processing', 'pageSize': {'width': 792.0, 'height': 612.0}, 'pageMargins': {'top': 72.0, 'bottom': 72.0, 'left': 72.0, 'right': 72.0, 'header': 36.0, 'footer': 43.20000076293945}, 'orientation': 'landscape', 'pageScale': 1.0}
G2-golden-pages-layout {'flavor': 'page-layout', 'pageSize': {'width': 612.0, 'height': 792.0}, 'pageMargins': {'top': 72.0, 'bottom': 72.0, 'left': 72.0, 'right': 72.0, 'header': 36.0, 'footer': 43.20000076293945}, 'orientation': 'portrait', 'pageScale': 1.0}

557:export interface CellFormat {
558-  kind: "number" | "currency" | "percent" | "date" | "duration" | "text" | "custom" | "automatic";
559-  /** Decimal places for number-like kinds. */
560-  decimals?: number;
561-  /** Currency code for currency (e.g. "USD") when known. */
562-  currencyCode?: string;
563-  /** Raw custom format string when kind = "custom". */
564-  formatString?: string;
565-}
566-
567-/** Merged region: anchor (top-left) + span. [proto: TST.MergeRegionMapArchive CellRange] */
568-export interface TableMerge {
569-  anchorRow: number;
570-  anchorColumn: number;
571-  rowSpan: number;
572-  columnSpan: number;
573-}
574-
575-/** Resolved table-level styling (TST.TableStylePropertiesArchive subset a viewer needs). */
576-export interface TableStyle {
577-  bandedRows?: boolean;
578-  bandedFill?: Fill;
579-  /** Default look for body cells (per-cell style overrides this). */
580-  bodyCellStyle?: TableCellStyle;
581-  /** Default look for header-row / header-column cells. */
582-  headerRowCellStyle?: TableCellStyle;
583-  headerColumnCellStyle?: TableCellStyle;
584-  footerRowCellStyle?: TableCellStyle;
585-}
586-
587-// ---------------------------------------------------------------------------
1117:pub struct CellFormat {
1118-    pub kind: CellFormatKind,
1119-    #[serde(skip_serializing_if = "Option::is_none")]
1120-    pub decimals: Option<u32>,
1121-    #[serde(skip_serializing_if = "Option::is_none")]
1122-    pub currency_code: Option<String>,
1123-    #[serde(skip_serializing_if = "Option::is_none")]
1124-    pub format_string: Option<String>,
1125-}
1126-
1127-#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
1128-#[serde(rename_all = "kebab-case")]
1129-pub enum CellFormatKind {
1130-    Number,
1131-    Currency,
1132-    Percent,
1133-    Date,
1134-    Duration,
1135-    Text,
1136-    Custom,
1137-    Automatic,
1138-}
1139-
1140-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
1141-#[serde(rename_all = "camelCase")]
1142-pub struct TableMerge {
1143-    pub anchor_row: u32,
1144-    pub anchor_column: u32,
1145-    pub row_span: u32,
1146-    pub column_span: u32,
1147-}
1148-
1149-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
1150-#[serde(rename_all = "camelCase")]
1151-pub struct TableStyle {
1152-    #[serde(skip_serializing_if = "Option::is_none")]

The file /Users/phebert/pnk/model/src/shared.ts has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/crates/pnk2json/src/model.rs has been updated successfully. (file state is current in your context — no need to Read it back)

653:                CellValue::Currency { value: v, currency_code: code }
784:        CellValue::Currency { value, currency_code } => {
785:            (GridValue::Number(value), Some(CellTypeTag::Currency), currency_code)
872:                currency_code: f.string(3),
885:            currency_code: None,
1035:                    currency_code: f.string(3),

            _ => None,
        });
        return (
            Some(CellFormat {
                kind,
                decimals,
                currency_code: f.string(3),
                format_string,
            }),
            false,
        );
    }
    let custom = custom_format_table
        .entries
        .values()
        .find_map(|e| e.custom_format.clone())
        .map(|cf| CellFormat {
            kind: CellFormatKind::Custom,
            decimals: None,
            currency_code: None,
            format_string: cf.string(3).or_else(|| cf.string(18)),
        });
    (custom, false)
}

                        268 => CellFormatKind::Duration,
                        260 => CellFormatKind::Text,
                        _ => CellFormatKind::Number,
                    },
                    decimals: f.varint(2).filter(|v| *v <= 20).map(|v| v as u32),
                    currency_code: f.string(3),
                    format_string: f.string(18),
                })
            })
        }),
        _ => None,

0
build-exit=1

TS-OK

3 files changed, 9 insertions(+)

{"success":true,"message":"Message queued for delivery to abe71d1ea8c796386 at its next tool round.","pin":{"id":"abe71d1ea8c796386","name":"abe71d1ea8c796386","ref":"abceae"}}

{"success":true,"message":"Message queued for delivery to a8d402dd5c12f9a4f at its next tool round.","pin":{"id":"a8d402dd5c12f9a4f","name":"a8d402dd5c12f9a4f","ref":"99263d"}}

15:  python3 scripts/crossval.py [--fixtures id1,id2,...] [--out /tmp/crossval] [--scan]
16-
17-Needs: target/release/pnk2json; for preview.pdf rasterization/text:
18-  uv run --with pyobjc-framework-Quartz --with pyobjc-framework-PDFKit python3 ...
19-"""
20-from __future__ import annotations
21-
22-import argparse
23-import json
24-import re
25-import subprocess
26-import sys
27-import zipfile
28-from pathlib import Path
29-
30-REPO = Path(__file__).resolve().parent.parent
--
149:def main() -> int:
150-    ap = argparse.ArgumentParser()
151-    ap.add_argument("--fixtures", help="comma-separated local_ids (default: 2 smallest + median per format)")
152-    ap.add_argument("--out", default="/tmp/crossval")
153:    ap.add_argument("--scan", action="store_true", help="corpus-wide table census only (no previews)")
154-    args = ap.parse_args()
155-
156-    success = load_success()
157-    ids = args.fixtures.split(",") if args.fixtures else default_picks(success)
158-    outdir = Path(args.out)
159-    outdir.mkdir(parents=True, exist_ok=True)
160-
161:    if args.scan:
162-        census_all = []
163-        for lid, r in success.items():
164-            src = REPO / f"fixtures/crawl/{r['sha256']}.{r['ext']}"
165-            p = subprocess.run([str(PNK2JSON), str(src)], capture_output=True, text=True, timeout=120)
166-            if p.returncode != 0 or not p.stdout.strip():
167-                continue
168-            doc = json.loads(p.stdout)
169-            for c in table_census(doc):
170-                c["local_id"] = lid
171-                census_all.append(c)
172-        empties = [c for c in census_all if c["nonnull"] == 0]
173:        print(f"scan: {len(census_all)} tables | all-null: {len(empties)}")
174-        for c in empties[:40]:
175-            print("  EMPTY", c["local_id"], c["table"], c["dims"])
176:        (outdir / "scan-census.json").write_text(json.dumps(census_all, indent=1))
177-        return 0
178-
179-    print(f"{'fixture':44} {'fmt':8} {'preview':7} {'tables':6} verdict")
180-    failures = 0
181-    for lid in ids:
182-        as_path = Path(lid)
183-        src = None
184-        if as_path.suffix in {".pages", ".numbers", ".key"}:
185-            src = as_path if as_path.is_absolute() else REPO / as_path
186-        r = success.get(lid)
187-        if src is not None:
188-            r = {"format": "pages" if as_path.suffix == ".pages" else as_path.suffix.lstrip("."), "sha256": None, "ext": None}
189-            src = str(src)
190-        if not r:
191-            print(f"{lid:44} MISSING from success.tsv")

File created successfully at: /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/scratchpad/text_recall_scan.py (file state is current in your context — no need to Read it back)

Command running in background with ID: bgy1q17ap. Output is being written to: /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/tasks/bgy1q17ap.output. You will be notified when it completes. To check interim output, use Read on that file path.

fixtures/README.md
fixtures/ccrawl_gone.txt
fixtures/crawl.jsonl
fixtures/golden/G1-golden-pages-wp.pages
fixtures/golden/expected/G1-golden-pages-wp.json
fixtures/golden/expected/G2-golden-pages-layout.json
fixtures/golden/g1-torture.txt
fixtures/provenance.json
fixtures/success.tsv
fixtures/templates/provenance.json
# Rust
/target

# Node
node_modules/
dist/

# macOS
.DS_Store

# Local harness config
/.omp/

# Reference checkouts / scratch
/.scratch/
/templates/

/fixtures/*
!/fixtures/provenance.json
!/fixtures/crawl.jsonl

1	Installed 1 package in 5ms
2	warning: The `fitz` API is deprecated and will be removed in future. Use `import pymupdf` instead.
3	wrote /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/scratchpad/text-recall.tsv (0 rows)
4	
5	[exited with code 0]
6	

cat: illegal option -- A
usage: cat [-belnstuv] [file ...]

local_id	sha256	ext	format	origin_url	warc_url	bytes	evidence
CC-MAIN-2026-34-cdx-00032-1	279acd9998c8bf6f166ff60e637e1f0e4d5dc3892f25791206bef37ff45ec635	pages	pages	https://aleksandrajhannah.com/wp-content/uploads/2023/08/Brief-Questions.pages	https://data.commoncrawl.org/crawl-data/CC-MAIN-2026-34/segments/1786091385444.26/warc/CC-MAIN-20260812014208-202608
CC-MAIN-2026-34-cdx-00016-1	3acb0451369bc958af6572fd157be6336122ff927867544c2db2a6cb7b6dd2e6	pages	pages	https://caloriesrestaurant.ca/wp-content/uploads/2023/06/Essence.pages	https://data.commoncrawl.org/crawl-data/CC-MAIN-2026-34/segments/1786091385961.45/warc/CC-MAIN-20260816093115-20260816123115
00a641002b038f06a6b3c52f5d3d02f4d1af4e66d06807b70493a5feff04674f.numbers
00f424565b502dbf541ade1fefc555771baa4fdbc50e108ca3cf49caf39c335c.pages
021084ac7183e93cd1b0401db42569bc421de27501aa2ef75e530bcd745cec42.numbers

pages True /Users/phebert/pnk/fixtures/crawl/279acd9998c8bf6f166ff60e637e1f0e4d5dc3892f25791206bef37ff45ec635.pages
pages True /Users/phebert/pnk/fixtures/crawl/3acb0451369bc958af6572fd157be6336122ff927867544c2db2a6cb7b6dd2e6.pages
legacy-unknown False /Users/phebert/pnk/fixtures/crawl/ab4e2f3ca83f92119b2f50a4d54f571efd26fa1d8af4acc2a938b43a9b491795.legacy
pages True /Users/phebert/pnk/fixtures/crawl/539dd47d0cdb61a725e4528f1adaabb4414fcaabc49ec073a7aaeed260f04f88.pages
pages True /Users/phebert/pnk/fixtures/crawl/1698f312dd93a8bedb998c132d3d138af90a3fe068a582cc5f424d591b5f3657.pages

warning: The `fitz` API is deprecated and will be removed in future. Use `import pymupdf` instead.
preview members: ['preview.jpg', 'preview-micro.jpg', 'preview-web.jpg']

sample 200: preview.pdf in 0

Command running in background with ID: bgu2sq855. Output is being written to: /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/tasks/bgu2sq855.output. You will be notified when it completes. To check interim output, use Read on that file path.

-rw-r--r--@ 1 phebert  staff  366467 Aug 29 13:18 fixtures/golden/G2-golden-pages-layout.pages
-rw-r--r--@ 1 phebert  staff  336417 Aug 29 13:12 fixtures/golden/g2-menu-screenshot.png
-rw-r--r--@ 1 phebert  staff    8222 Aug 29 14:19 fixtures/golden/G5-acid-checklist.md
-rw-r--r--@ 1 phebert  staff  180135 Aug 29 22:34 fixtures/golden/G5-golden-pages-acid.pages

 create mode 100644 fixtures/golden/G5-golden-pages-acid.pages
 create mode 100644 fixtures/golden/g2-menu-screenshot.png

The file /Users/phebert/pnk/viewer/index.html has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/src/main.ts has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/src/main.ts has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/src/main.ts has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/src/main.ts has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/viewer/src/main.ts has been updated successfully. (file state is current in your context — no need to Read it back)

  dist/main.js  61.9kb

⚡ Done in 3ms
    tests/gate.spec.ts:118:1 › pages fixture renders flowing paragraphs and headings ───────────────
  5 passed (6.7s)

  ✘  4 tests/gate.spec.ts:118:1 › pages fixture renders flowing paragraphs and headings (5.1s)
    Error: expect(locator).toBeVisible() failed
    Error: element(s) not found
    Error Context: test-results/gate-pages-fixture-renders-flowing-paragraphs-and-headings/error-context.md
  1 failed
  5 passed (6.4s)

7220ea1 viewer: canvas text renders at document scale — three fidelity fixes
f9242e7 fixtures: commit G2/G5 golden Pages fixtures + G5 acid checklist
2ed592d model: compact flat points arrays for curve elements + standalone line contract
9a78b76 pnk2json: null para-style entries inherit the previous paragraph's style
9cd782c model: CellFormat.grouping — thousands-separator flag (approved N proposal)
b5c54f6 viewer: landing format chips + dark-mode chrome
sed: viewer/tests/gate.spec.ts: No such file or directory
warning: could not open directory 'viewer/viewer/': No such file or directory

test("pages fixture renders flowing paragraphs and headings", async ({ page }) => {
  await page.goto("/");
  trackRequests(page);
  await page.setInputFiles("#file-input", path.join(CRAWL, FIXTURES.pages));
  const flow = page.locator(".pages-flow");
  await expect(flow).toBeVisible();
  await expect(flow.locator("p").first()).toBeVisible();
  // this fixture has 200+ styled headings in the body
  await expect(flow.locator("h1, h2, h3, h4, h5, h6").first()).toBeVisible();
  await shot(page, "pages.png", false);
  assertNoRuntimeNetwork(page);
});

test("legacy fixture gets the legacy explanation", async ({ page }) => {
 M crates/pnk2json/src/tables.rs
 M viewer/src/main.ts
 M viewer/src/pages.ts
 M viewer/src/text.ts
commit 2ed592d480823f41f7bea73daa0dc06aef3d541c
Author: Peter Hebert <[email protected]>
Date:   Sat Aug 29 22:39:22 2026 -0400

    model: compact flat points arrays for curve elements + standalone line contract
    
    Peter-approved shape-points change, specced against Pnk2JsonAgent's G2/G5
    stream evidence: CurveElement.points are now flat positional arrays
    ([x,y] for move/line, [cx,cy,x,y] for quad, 6 numbers for cubic, none for
    close) instead of [{x,y},...] — SVG-style pairs, same decoded geometry.
    Standalone line contract (fixture-verified G5 acid line: TSD.ShapeArchive,
    2-node sharp editable_bezier_path_source, stroke-only, no fill): a line is a

 2 files changed, 18 insertions(+), 1 deletion(-)

{"success":true,"message":"Message queued for delivery to a8d402dd5c12f9a4f at its next tool round.","pin":{"id":"a8d402dd5c12f9a4f","name":"a8d402dd5c12f9a4f","ref":"99263d"}}

1	warning histogram: {'table-degraded': 1167, 'media-missing': 199, 'unknown-object-type': 169, 'unresolved-reference': 51, 'unsupported-feature': 7}
2	keynote: 481 converted, 0 docs >50KB with <80 text chars
3	numbers: 158 converted, 2 docs >50KB with <80 text chars
4	pages: 325 converted, 0 docs >50KB with <80 text chars
5	wrote /private/tmp/claude-501/-Users-phebert-pnk/454dda24-911e-4ddc-a681-9413ce6505b1/scratchpad/content-census.tsv
6	
7	[exited with code 0]
8	

docs with table-degraded: 218
  376 pages    CC-MAIN-2026-34-cdx-00055-1  | cell storage version 3 unsupported (expected 5)
   48 numbers  CC-MAIN-2026-34-cdx-00181-2  | table model 2901 contains pre-BNC tile storage; decode is best-effort
   42 numbers  CC-MAIN-2026-34-cdx-00238-13  | table model 4097 contains pre-BNC tile storage; decode is best-effort
   35 pages    CC-MAIN-2026-34-cdx-00225-2  | uid-based merge ranges not yet decoded (legacy packed-int merge map absent); 7 covered cel
   33 numbers  CC-MAIN-2026-34-cdx-00093-2  | uid-based merge ranges not yet decoded (legacy packed-int merge map absent); 39 covered ce
   32 pages    CC-MAIN-2026-34-cdx-00277-4  | v4 rich-text key Some(1) not in the rich-text table; cell r1c1 dropped
   28 pages    CC-MAIN-2026-34-cdx-00093-1  | cell storage version 3 unsupported (expected 5)
   27 keynote  CC-MAIN-2026-34-cdx-00173-9  | uid-based merge ranges not yet decoded (legacy packed-int merge map absent); 2 covered cel
   25 keynote  CC-MAIN-2026-34-cdx-00174-7  | v4 rich-text key Some(1) not in the rich-text table; cell r0c0 dropped
   18 numbers  CC-MAIN-2026-34-cdx-00228-2  | uid-based merge ranges not yet decoded (legacy packed-int merge map absent); 996 covered c
   18 pages    CC-MAIN-2026-34-cdx-00090-1  | table model 4039 contains pre-BNC tile storage; decode is best-effort
   17 numbers  CC-MAIN-2026-34-cdx-00058-5  | v4 rich-text key Some(1) not in the rich-text table; cell r1c1 dropped
by format: {'numbers': 432, 'pages': 614, 'keynote': 121}

{"success":true,"message":"Message queued for delivery to abe71d1ea8c796386 at its next tool round.","pin":{"id":"abe71d1ea8c796386","name":"abe71d1ea8c796386","ref":"abceae"}}

{"success":true,"message":"Message queued for delivery to a8d402dd5c12f9a4f at its next tool round.","pin":{"id":"a8d402dd5c12f9a4f","name":"a8d402dd5c12f9a4f","ref":"99263d"}}

{"success":true,"message":"Message queued for delivery to a3ef623e1aa80b2a4 at its next tool round.","pin":{"id":"a3ef623e1aa80b2a4","name":"a3ef623e1aa80b2a4","ref":"edf7d5"}}

8: *    - lengths/positions/sizes: points (pt), as plain `number`
61:// Geometry (all in points, angles in degrees)
64:/** A position in points, origin at the canvas top-left, y increasing downward. */
70:/** Width/height in points. */
76:/** An axis-aligned rectangle in points. */
84:/** Inset distances in points (top/left/bottom/right), from `TSD.EdgeInsetsArchive`. */
165:  /** Offset distance in points (proto default 5). */
167:  /** Blur radius in points (proto default 1). */
182:  /** Stroke width in points. */
189:   * Dash pattern in points; empty/undefined = solid.
193:  /** Dash phase offset in points. */
221: * TSP.Point }] — `points` is `[x1,y1,x2,y2,…]` (SVG-style pairs), not
223: *  - "move"  → points = [x, y] (subpath start).
224: *  - "line"  → points = [x, y] (line target).
225: *  - "quad"  → points = [cx, cy, x, y] (control, target).
226: *  - "cubic" → points = [c1x, c1y, c2x, c2y, x, y] (two controls, target).
227: *  - "close" → closes the current subpath (no points).
229:export type CurveElement =
230:  | { type: "move"; points: [number, number] }
231:  | { type: "line"; points: [number, number] }
/Users/phebert/pnk/crates/pnk2json/src/tsd.rs:37:            1 => CurveElement::Move { points },
/Users/phebert/pnk/crates/pnk2json/src/tsd.rs:38:            2 => CurveElement::Line { points },
/Users/phebert/pnk/crates/pnk2json/src/tsd.rs:39:            3 => CurveElement::Quad { points },
/Users/phebert/pnk/crates/pnk2json/src/tsd.rs:40:            4 => CurveElement::Cubic { points },
/Users/phebert/pnk/crates/pnk2json/src/tsd.rs:41:            5 => CurveElement::Close { points },
/Users/phebert/pnk/crates/pnk2json/src/tsd.rs:68:                elements.push(CurveElement::Move { points: vec![Point { x: cur.0, y: cur.1 }] });
/Users/phebert/pnk/crates/pnk2json/src/tsd.rs:80:                (1, _, _) => elements.push(CurveElement::Line { points: vec![next_pt] }),
/Users/phebert/pnk/crates/pnk2json/src/tsd.rs:81:                (_, Some(o), Some(nin)) => elements.push(CurveElement::Cubic {
/Users/phebert/pnk/crates/pnk2json/src/tsd.rs:84:                (_, Some(o), None) => elements.push(CurveElement::Quad {
/Users/phebert/pnk/crates/pnk2json/src/tsd.rs:87:                _ => elements.push(CurveElement::Line { points: vec![next_pt] }),

190-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
191-#[serde(tag = "type", rename_all = "kebab-case")]
192:pub enum CurveElement {
193-    Move { points: Vec<Point> },
194-    Line { points: Vec<Point> },
195-    Quad { points: Vec<Point> },
196-    Cubic { points: Vec<Point> },
197-    Close {
198-        #[serde(default, skip_serializing_if = "Vec::is_empty")]
199-        points: Vec<Point>,
200-    },
201-}
202-
203-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
204-#[serde(rename_all = "camelCase")]
205-pub struct CurvePath {
206:    pub elements: Vec<CurveElement>,
207-}
208-
209-// --- alignment enums ---
210-
211-#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
212-#[serde(rename_all = "kebab-case")]
213-pub enum HorizontalAlignment {
214-    Left,
215-    Right,
216-    Center,
217-    Justify,
218-    Auto,
219-}
220-
221-#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize)]
222-#[serde(rename_all = "kebab-case")]
223-pub enum VerticalAlignment {
224-    Top,
225-    Middle,
226-    Bottom,
export type CurveElement =
  | { type: "move"; points: [number, number] }
  | { type: "line"; points: [number, number] }
  | { type: "quad"; points: [number, number, number, number] }
  | { type: "cubic"; points: [number, number, number, number, number, number] }
  | { type: "close" };

/**
 * An explicit vector path in the shape's own coordinate space (points).
 * A straight LINE is the minimal form: exactly one "move" + one "line"
 * element (2 sharp nodes, stroke-only, no fill — fixture-verified:
 * G5 acid line, editable_bezier_path_source with 2 nodes). Its coordinates
    let mut elements = Vec::new();
    for el in m.msgs(1) {
        let ty = el.varint(1)?;
        let points: Vec<Point> = el
            .msgs(2)
            .into_iter()
            .filter_map(|p| {
                let (x, y) = (p.f32v(1)? as f64, p.f32v(2)? as f64);
                Some(Point { x, y })
            })
            .collect();
        elements.push(match ty {
            1 => CurveElement::Move { points },
            2 => CurveElement::Line { points },
            3 => CurveElement::Quad { points },
            4 => CurveElement::Cubic { points },
            5 => CurveElement::Close { points },
            _ => continue,
        });
    }
    Some(CurvePath { elements })
}

/// Editable bezier subpaths → cubic curves (drawables.md PathSourceArchive 8).
/// `Node` carries inControlPoint(1) / nodePoint(2) / outControlPoint(3) /
/// NodeType(4: sharp=1, bezier=2, smooth=3); consecutive nodes A→B are cubic
/// segments [A.out, B.in, B.node].
fn editable_bezier(m: &Msg, natural: Option<Size>) -> ShapeGeometry {
    let mut elements = Vec::new();
    for subpath in m.msgs(1) {
        let nodes: Vec<Msg> = subpath.msgs(1);
        let closed = subpath.boolean(2).unwrap_or(false);
        let pts: Vec<(f64, f64)> = nodes
            .iter()
            .filter_map(|n| {
                let p = n.msg(2)?;
                Some((p.f32v(1)? as f64, p.f32v(2)? as f64))
            })
            .collect();
        let mut first = true;
        for (i, node) in nodes.iter().enumerate() {
            let Some(cur) = pts.get(i) else { continue };
            if first {
                elements.push(CurveElement::Move { points: vec![Point { x: cur.0, y: cur.1 }] });
                first = false;
            }
            let Some(next) = pts.get(i + 1) else { continue };
            let next_pt = Point { x: next.0, y: next.1 };
            let node_type = node.varint(4).unwrap_or(1);
            let out = node.msg(3).and_then(|m| Some((m.f32v(1)? as f64, m.f32v(2)? as f64)));
            let next_in = nodes[i + 1]
                .msg(1)
                .and_then(|m| Some((m.f32v(1)? as f64, m.f32v(2)? as f64)));
            match (node_type, out, next_in) {
                // Sharp nodes carry no real curvature: straight line.
                (1, _, _) => elements.push(CurveElement::Line { points: vec![next_pt] }),
                (_, Some(o), Some(nin)) => elements.push(CurveElement::Cubic {
                    points: vec![Point { x: o.0, y: o.1 }, Point { x: nin.0, y: nin.1 }, next_pt],
                }),
                (_, Some(o), None) => elements.push(CurveElement::Quad {
                    points: vec![Point { x: o.0, y: o.1 }, next_pt],
                }),
                _ => elements.push(CurveElement::Line { points: vec![next_pt] }),
            }
        }
        if closed {
            if let Some(start) = pts.first() {
                elements.push(CurveElement::Line { points: vec![Point { x: start.0, y: start.1 }] });
            }
            elements.push(CurveElement::Close { points: vec![] });
        }

/Users/phebert/pnk/crates/pnk2json/src/tsd.rs
22

37:            1 => CurveElement::Move { points },
38:            2 => CurveElement::Line { points },
39:            3 => CurveElement::Quad { points },
40:            4 => CurveElement::Cubic { points },
41:            5 => CurveElement::Close { points },
68:                elements.push(CurveElement::Move { points: vec![Point { x: cur.0, y: cur.1 }] });
80:                (1, _, _) => elements.push(CurveElement::Line { points: vec![next_pt] }),
81:                (_, Some(o), Some(nin)) => elements.push(CurveElement::Cubic {
84:                (_, Some(o), None) => elements.push(CurveElement::Quad {
87:                _ => elements.push(CurveElement::Line { points: vec![next_pt] }),
92:                elements.push(CurveElement::Line { points: vec![Point { x: start.0, y: start.1 }] });
94:            elements.push(CurveElement::Close { points: vec![] });
123:            CurveElement::Move { points }
124:            | CurveElement::Line { points }
125:            | CurveElement::Quad { points }
126:            | CurveElement::Cubic { points }
127:            | CurveElement::Close { points } => points,
147:            CurveElement::Move { points }
148:            | CurveElement::Line { points }
149:            | CurveElement::Quad { points }
150:            | CurveElement::Cubic { points }
151:            | CurveElement::Close { points } => points,

/// Fit a `TSP.Path`'s tight bounds into the shape's naturalSize (uniform
/// scale + centering). Apple renders bezier shapes this way: the stored
/// coordinates carry no absolute unit, so the path's own bounds define the
/// mapping onto the shape box.
fn normalize_path(mut p: CurvePath, natural: Option<&Size>) -> CurvePath {
    let Some(n) = natural else { return p };
    if n.width <= 0.0 || n.height <= 0.0 {
        return p;
    }
    let mut min = (f64::INFINITY, f64::INFINITY);
    let mut max = (f64::NEG_INFINITY, f64::NEG_INFINITY);
    for el in &p.elements {
        let pts: &[Point] = match el {
            CurveElement::Move { points }
            | CurveElement::Line { points }
            | CurveElement::Quad { points }
            | CurveElement::Cubic { points }
            | CurveElement::Close { points } => points,
        };
        for pt in pts {
            min.0 = min.0.min(pt.x);
            min.1 = min.1.min(pt.y);
            max.0 = max.0.max(pt.x);
            max.1 = max.1.max(pt.y);
        }
    }
    if !min.0.is_finite() {
        return p;
    }
    let bw = (max.0 - min.0).max(f64::EPSILON);
    let bh = (max.1 - min.1).max(f64::EPSILON);
    let scale = (n.width / bw).min(n.height / bh);
    // center the scaled path in the box
    let ox = (n.width - bw * scale) / 2.0;
    let oy = (n.height - bh * scale) / 2.0;
    for el in p.elements.iter_mut() {
        let pts: &mut Vec<Point> = match el {
            CurveElement::Move { points }
            | CurveElement::Line { points }
            | CurveElement::Quad { points }
            | CurveElement::Cubic { points }
            | CurveElement::Close { points } => points,
        };
        for pt in pts.iter_mut() {
            pt.x = (pt.x - min.0) * scale + ox;
            pt.y = (pt.y - min.1) * scale + oy;
        }
    }
    p
}

The file /Users/phebert/pnk/crates/pnk2json/src/model.rs has been updated successfully. (file state is current in your context — no need to Read it back)

// ---------------------------------------------------------------------------
// TSP.Path → CurvePath (TSPMessages.proto:103-117)
// ---------------------------------------------------------------------------

pub fn tsp_path(m: &Msg) -> Option<CurvePath> {
    let mut elements = Vec::new();
    for el in m.msgs(1) {
        let ty = el.varint(1)?;
        let points: Vec<Point> = el
            .msgs(2)
            .into_iter()
            .filter_map(|p| {
                let (x, y) = (p.f32v(1)? as f64, p.f32v(2)? as f64);
                Some(Point { x, y })
            })
            .collect();
        elements.push(match ty {
            1 => CurveElement::Move { points },
            2 => CurveElement::Line { points },
            3 => CurveElement::Quad { points },
            4 => CurveElement::Cubic { points },
            5 => CurveElement::Close { points },
            _ => continue,
        });
    }
    Some(CurvePath { elements })

The file /Users/phebert/pnk/crates/pnk2json/src/tsd.rs has been updated successfully. (file state is current in your context — no need to Read it back)

            })
            .collect();
        let mut first = true;
        for (i, node) in nodes.iter().enumerate() {
            let Some(cur) = pts.get(i) else { continue };
            if first {
                elements.push(CurveElement::Move { points: vec![Point { x: cur.0, y: cur.1 }] });
                first = false;
            }
            let Some(next) = pts.get(i + 1) else { continue };
            let next_pt = Point { x: next.0, y: next.1 };
            let node_type = node.varint(4).unwrap_or(1);
            let out = node.msg(3).and_then(|m| Some((m.f32v(1)? as f64, m.f32v(2)? as f64)));
            let next_in = nodes[i + 1]
                .msg(1)
                .and_then(|m| Some((m.f32v(1)? as f64, m.f32v(2)? as f64)));
            match (node_type, out, next_in) {
                // Sharp nodes carry no real curvature: straight line.
                (1, _, _) => elements.push(CurveElement::Line { points: vec![next_pt] }),
                (_, Some(o), Some(nin)) => elements.push(CurveElement::Cubic {
                    points: vec![Point { x: o.0, y: o.1 }, Point { x: nin.0, y: nin.1 }, next_pt],
                }),
                (_, Some(o), None) => elements.push(CurveElement::Quad {
                    points: vec![Point { x: o.0, y: o.1 }, next_pt],
                }),
                _ => elements.push(CurveElement::Line { points: vec![next_pt] }),
            }
        }
        if closed {
            if let Some(start) = pts.first() {
                elements.push(CurveElement::Line { points: vec![Point { x: start.0, y: start.1 }] });
            }
            elements.push(CurveElement::Close { points: vec![] });
        }
    }
    ShapeGeometry {

The file /Users/phebert/pnk/crates/pnk2json/src/tsd.rs has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/crates/pnk2json/src/tsd.rs has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/crates/pnk2json/src/tsd.rs has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/crates/pnk2json/src/tsd.rs has been updated successfully. (file state is current in your context — no need to Read it back)

warning: unused variable: `pixel`
warning: unused variable: `ctx`
warning: unused variable: `registry`
warning: unused variable: `formula_table`
---
[{'type': 'move', 'points': [0.0, 0.0]}, {'type': 'line', 'points': [944.7951049804688, 0.0]}]

==> static shell -> viewer/dist/
viewer built: viewer/dist/  (serve: cd viewer && npm run serve)
  6 passed (1.5s)

 2 files changed, 28 insertions(+), 27 deletions(-)

{"success":true,"message":"Message queued for delivery to a3ef623e1aa80b2a4 at its next tool round.","pin":{"id":"a3ef623e1aa80b2a4","name":"a3ef623e1aa80b2a4","ref":"edf7d5"}}

1	/**
2	 * pnk JSON document models — shared structures.
3	 *
4	 * Text (TSWP), drawables (TSD), tables (TST), charts (TSCH) and the calc
5	 * engine (TSCE) placeholder — used by all three document models.
6	 *
7	 * Conventions (see primitives.ts header + docs/model-design.md):
8	 *  - units: pt / degrees / #rrggbb / ISO 8601
9	 *  - `field?: T` = not specified; `field: T | null` = explicitly unset
10	 *  - no object ids, no TSP.References, no attribute-table offsets:
11	 *    styles are resolved and inlined, references are embedded objects
12	 *  - tagged unions with a `type`/`kind` string discriminant (serde-friendly)
13	 */
14	
15	
16	import type {
17	  CharStyle,
18	  CurvePath,
19	  Fill,
20	  HexColor,
21	  IsoDateString,
22	  LineEnd,
23	  MediaRef,
24	  ParaStyle,
25	  Point,
26	  Reflection,
27	  Shadow,
28	  Size,
29	  Stroke,
30	  VerticalAlignment,
31	} from "./primitives";
32	import type { KeynoteDocument } from "./keynote";
33	import type { NumbersDocument } from "./numbers";
34	import type { PagesDocument } from "./pages";
35	
36	// Everything in primitives is part of the public model surface.
37	export * from "./primitives";
38	// ---------------------------------------------------------------------------
39	// Root envelope
40	// ---------------------------------------------------------------------------
41	export interface Warning {
42	  /** Stable machine code, e.g. "unknown-object-type". */
43	  code: WarningCode;
44	  /** Human-readable explanation, self-contained. */
45	  message: string;
46	  /**
47	   * Where the warning applies: a model path like `sheets[0].drawables[3]`
48	   * (converter-defined, best effort).
49	   */
50	  path?: string;
51	  /** Original object type id / registry name, when the warning is about one. */
52	  detail?: string;
53	}
54	
55	/** Which app produced the document. */
56	export type AppKind = "pages" | "numbers" | "keynote";
57	
58	export type WarningCode =
59	  /** A TSP.MessageInfo.type id had no trusted registry entry. */
60	  | "unknown-object-type"
61	  /** Known object type whose payload did not decode. */
62	  | "undecodable-object"
63	  /** A TSP.Reference / DataReference pointed nowhere. */
64	  | "unresolved-reference"
65	  /** Content exists but the viewer model cannot represent it faithfully. */
66	  | "unsupported-feature"
67	  /** Media bytes missing from Data/ or the registry. */
68	  | "media-missing"
69	  /** Color fell outside sRGB or HDR headroom was clamped. */
70	  | "color-degraded"
71	  /** Pre-UFF / legacy structures best-effort decoded. */
72	  | "legacy-variant"
73	  /** Table with pre-BNC storage or other degraded decode. */
74	  | "table-degraded"
75	  /** Formula AST present but not converted to text. */
76	  | "formula-unparsed";
77	
78	/** Page/canvas orientation. [proto: orientation flag; numbers in_portrait_page_orientation] */
79	export type PageLayoutOrientation = "portrait" | "landscape";
80	
81	/** One embedded media asset from the container's `Data/` store. */
82	export interface MediaAsset {
83	  /** DataInfo identifier (uint64 as decimal string). */
84	  dataId: string;
85	  /** Member name under `Data/` (or in the package directory). */
86	  fileName?: string;
87	  /** User-facing original file name. */
88	  preferredFileName?: string;
89	  kind: "image" | "movie" | "audio" | "pdf" | "other";
90	  /** Byte length when materialized. */
91	  byteLength?: number;
92	  /** Pixel dimensions for images. */
93	  pixelSize?: Size;
94	}
95	
96	/**
97	 * Document-level metadata, resolved from `Metadata/Properties.plist`,
98	 * `Metadata/BuildVersionHistory.plist`, `Metadata/DocumentIdentifier` and
99	 * `TSP.PackageMetadata` (object id 2). See docs/format/container.md.
100	 */
101	export interface DocumentMeta {
102	  app: AppKind;
103	  /** App that last saved the file, e.g. "Pages" [proto/Properties.plist Application]. */
104	  application?: string;
105	  /** fileFormatVersion string from Properties.plist. */
106	  fileFormatVersion?: string;
107	  /**
108	   * Build version history: last entries of BuildVersionHistory.plist,
109	   * oldest → newest. Useful for feature gating.
110	   */
111	  buildVersionHistory?: string[];
112	  /** Document UUID (Metadata/DocumentIdentifier or PackageMetadata.revision). */
113	  documentId?: string;
114	  createdAt?: IsoDateString;
115	  modifiedAt?: IsoDateString;
116	  /** Author string if the source carries one. */
117	  author?: string;
118	  /** Locale identifier from TSK.DocumentArchive. [proto] */
119	  locale?: string;
120	}
121	
122	/** Text-entry gate for viewers: deduped font names used in the document. */
123	export type FontList = string[];
124	
125	/**
126	 * The root shape every converter emits — exactly one of the three flavors,
127	 * each carrying the same envelope fields.
128	 */
129	export type PnkDocument = PagesDocument | NumbersDocument | KeynoteDocument;
130	
131	// Envelope field block shared by the three document roots (structurally;
132	// each concrete root redeclares these to stay JSON-flat).
133	export interface DocumentEnvelope {
134	  meta: DocumentMeta;
135	  /** Anything dropped/unknown/degraded — machine-readable, never silent. */
136	  warnings: Warning[];
137	  /** Deduped, sorted font names referenced anywhere in the document. */
138	  fonts: FontList;
139	  /** All embedded media assets (the `Data/` inventory), for one-pass fetching. */
140	  media: MediaAsset[];
141	  /**
142	   * Document-wide style pools, deduped and ordered first-use. Text nodes
143	   * reference entries by index (`Paragraph.pStyle` → `styles.para`,
144	   * `TextRun`/`FieldRun` `.cStyle` → `styles.char`); absent index =
145	   * unstyled/default. Drawable styles stay INLINE on purpose (measured:
146	   * pooling them is not worth the churn — docs/model-design.md §2).
147	   */
148	  styles: StylePools;
149	}
150	
151	/** The two text-style pools. [proto payload: TSWP.ParagraphStylePropertiesArchive / CharacterStylePropertiesArchive] */
152	export interface StylePools {
153	  /** Resolved paragraph styles, deduped, first-use order. */
154	  para: ParaStyle[];
155	  /** Resolved character styles, deduped, first-use order. */
156	  char: CharStyle[];
157	}
158	
159	// ---------------------------------------------------------------------------
160	// Text model (TSWP) — styled paragraphs/runs, fully resolved, no offsets
161	// ---------------------------------------------------------------------------
162	
163	/**
164	 * A block of rich text. Source is a `TSWP.StorageArchive`: one character
165	 * buffer + attribute tables mapping UTF-16 offsets to styles/attachments.
166	 * The converter SPLITS the buffer at paragraph boundaries (newlines) and at
167	 * character-style entry offsets, resolving styles into the document's
168	 * `styles` pools — no character indexes and no inline style objects survive
169	 * (docs/model-design.md §Flattening).
170	 * [proto: .scratch/otorp/Keynote/TSWPArchives.proto → TSWP.StorageArchive;
171	 *  splitting verified in docs/format/text.md]
172	 */
173	export interface StyledText {
174	  paragraphs: Paragraph[];
175	}
176	
177	export interface Paragraph {
178	  /** Index into the document's `styles.para` pool; absent = default/unstyled. */
179	  pStyle?: number;
180	  /** Content items in visual order. */
181	  items: ParagraphItem[];
182	}
183	
184	/**
185	 * One content item. A bare JSON string is a plain unstyled text run (the
186	 * common case); objects are used only when there is more to say:
187	 *  - `{ text, cStyle?, hyperlink?, language? }` — a styled run (no `type`
188	 *    key needed: the `text` key is self-evident);
189	 *  - `{ type: "inline-object", … }` / `{ type: "field", … }` — rare, tagged.
190	 */
191	export type ParagraphItem = string | TextRun | InlineObjectRun | FieldRun;
192	
193	export interface TextRun {
194	  text: string;
195	  /** Index into the document's `styles.char` pool; absent = unstyled. */
196	  cStyle?: number;
197	  /** Hyperlink target when the run is a link. [proto: HyperlinkFieldArchive] */
198	  hyperlink?: string;
199	  /** Language override for this run (rare; usually on style). */
200	  language?: string;
201	}
202	
203	/**
204	 * An inline attachment — the U+FFFC OBJECT REPLACEMENT CHARACTER position in
205	 * the source text [proto + parser: docs/format/text.md §Attachments]. The
206	 * drawable itself (image/shape/table/…) is embedded right here.
207	 */
208	export interface InlineObjectRun {
209	  type: "inline-object";
210	  /** The attached drawable, fully resolved. */
211	  drawable: Drawable;
212	  /** Anchor offsets in points. [proto: TSWP.DrawableAttachmentArchive h/v_offset] */
213	  offset?: { hPt?: number; vPt?: number };
214	}
215	
216	/**
217	 * A smart field that renders as text (page number, page count, footnote mark,
218	 * date). Source: TSWP smart-field archives
219	 * [proto: docs/format/text.md §Fields].
220	 */
221	export interface FieldRun {
222	  type: "field";
223	  /** Index into the document's `styles.char` pool; absent = unstyled. */
224	  cStyle?: number;
225	  /** Current rendered value as stored, when present. */
226	  value?: string;
227	  field:
228	    | { kind: "page-number" }
229	    | { kind: "page-count" }
230	    | { kind: "footnote-mark" }
231	    | { kind: "date"; updatePlan: "never" | "auto" | "once" }
232	    | { kind: "other"; detail?: string };
233	}
234	
235	// ---------------------------------------------------------------------------
236	// Drawables (TSD) — everything placeable on a canvas
237	// ---------------------------------------------------------------------------
238	
239	/**
240	 * Common geometry + styling of every drawable. Source: `TSD.DrawableArchive`
241	 * [proto: .scratch/otorp/Keynote/TSDArchives.proto:321-335] — position/size
242	 * from `TSD.GeometryArchive` (angle in RADIANS there, degrees here),
243	 * plus link/lock/wrap attributes.
244	 */
245	export interface DrawableCommon {
246	  /** Bounding position in canvas coordinates (points). */
247	  position?: Point;
248	  /** Natural size in points. */
249	  size?: Size;
250	  /** Rotation in degrees (converted from proto radians), counterclockwise. */
251	  angleDeg?: number;
252	  /** Horizontal/vertical mirroring of the shape source. [proto: PathSourceArchive flips] */
253	  flipped?: { horizontal?: boolean; vertical?: boolean };
254	  hyperlink?: string;
255	  locked?: boolean;
256	  accessibilityDescription?: string;
257	  /** Wrap text around this object's outline. [proto: TSD.ExteriorTextWrapArchive] */
258	  textWrap?: {
259	    kind: "none" | "around" | "above-below" | "left" | "right" | "largest";
260	    marginPt?: number;
261	  };
262	  /** Visual styling (resolved; undefined = no styling specified). */
263	  style?: DrawableStyle;
264	  /** Opacity 0..1. [proto: ShapeStylePropertiesArchive.opacity] */
265	  opacity?: number;
266	  shadow?: Shadow;
267	  reflection?: Reflection;
268	}
269	
270	/** Resolved drawable styling (TSD.ShapeStylePropertiesArchive / MediaStylePropertiesArchive). */
271	export interface DrawableStyle {
272	  fill?: Fill;
273	  stroke?: Stroke;
274	  lineEnds?: { head?: LineEnd; tail?: LineEnd };
275	}
276	
277	/**
278	 * The drawable union. `unknown` carries payloads the converter could not
279	 * decode — never silently dropped (see docs/model-design.md §Dropped).
280	 */
281	export type Drawable =
282	  | ShapeDrawable
283	  | TextboxDrawable
284	  | ImageDrawable
285	  | MovieDrawable
286	  | GroupDrawable
287	  | ConnectionLineDrawable
288	  | TableDrawable
289	  | ChartDrawable
290	  | UnknownDrawable;
291	
292	export interface ShapeDrawable {
293	  type: "shape";
294	  common: DrawableCommon;
295	  /** Geometry as explicit curves / preset parameters — see ShapeGeometry. */
296	  geometry: ShapeGeometry;
297	  /** Text typed inside the shape, if any (resolved from the owned storage). */
298	  text?: StyledText;
299	  /** Vertical alignment of the shape's text. [proto: TSWP.ShapeStylePropertiesArchive] */
300	  verticalAlignment?: VerticalAlignment;
301	  /** Text insets. [proto: TSWP text insets] */
302	  textInsets?: { top?: number; left?: number; bottom?: number; right?: number };
303	}
304	
305	export interface TextboxDrawable {
306	  type: "textbox";
307	  common: DrawableCommon;
308	  text: StyledText;
309	  verticalAlignment?: VerticalAlignment;
310	  textInsets?: { top?: number; left?: number; bottom?: number; right?: number };
311	}
312	
313	/**
314	 * Shape geometry, flattened from the six `TSD.PathSourceArchive` variants
315	 * [proto: .scratch/otorp/Keynote/TSDArchives.proto:98-119 + 28-96].
316	 * Priority: explicit `path` (bezier/editable bezier) wins; otherwise a preset
317	 * shape is named and the viewer renders it; `naturalSize` is the preset's
318	 * design size (scale to the drawable's size).
319	 */
320	export interface ShapeGeometry {
321	  /** Preset shape identifier, e.g. "star", "plus", "left-arrow", "rounded-rect", "chevron", "callout". */
322	  preset?: string;
323	  /**
324	   * Preset parameter: corner radius for rounded-rect, pointiness for star
325	   * (source `ScalarPathSourceArchive.scalar`) [inferred: semantic per docs/format/drawables.md].
326	   */
327	  scalar?: number;
328	  /** Design size of the preset/path source. */
329	  naturalSize?: Size;
330	  /**
331	   * Explicit path when the source carried bezier data (converted to curves).
332	   * Coordinates are in `naturalSize` space (or drawable space when no
333	   * naturalSize was given).
334	   */
335	  path?: CurvePath;
336	  /** Callout tail parameters. [proto: TSD.CalloutPathSourceArchive] */
337	  callout?: {
338	    tailPosition: Point;
339	    tailSize: Size;
340	    cornerRadius?: number;
341	    centerTail?: boolean;
342	  };
343	}
344	
345	export interface ImageDrawable {
346	  type: "image";
347	  common: DrawableCommon;
348	  /** Primary image bytes (resolved DataReference). */
349	  image: MediaRef;
350	  /** Original (pre-adjustment) image when stored separately. */
351	  original?: MediaRef;
352	  /** Thumbnail when stored separately. */
353	  thumbnail?: MediaRef;
354	  /** SVG source when the "image" was imported from SVG. */
355	  svg?: MediaRef;
356	  /** Natural (untransformed) size in points. */
357	  naturalSize?: Size;
358	  /** Clipping mask as a drawable-shaped path. [proto: TSD.ImageArchive.mask] */
359	  mask?: { geometry: ShapeGeometry; common: DrawableCommon };
360	  /** Non-destructive image adjustments. [proto: TSD.ImageAdjustmentsArchive] */
361	  adjustments?: {
362	    exposure?: number;
363	    saturation?: number;
364	    contrast?: number;
365	    highlights?: number;
366	    shadows?: number;
367	    brightness?: number;
368	    [key: string]: number | undefined;
369	  };
370	}
371	
372	export interface MovieDrawable {
373	  type: "movie";
374	  common: DrawableCommon;
375	  /** Movie bytes (resolved DataReference), when embedded. */
376	  movie?: MediaRef;
377	  /** Remote URL for linked/streaming movies. [proto: movieRemoteURL] */
378	  remoteUrl?: string;
379	  /** Poster frame image. */
380	  poster?: MediaRef;
381	  /** Audio-only movies keep a poster image. [proto: audioOnly] */
382	  audioOnly?: boolean;
383	  /** Trim range in seconds. [proto: startTime/endTime/posterTime] */
384	  trim?: { start?: number; end?: number; posterTime?: number };
385	  loop?: "none" | "repeat" | "back-and-forth";
386	  /** Playback volume 0..1. */
387	  volume?: number;
388	}
389	
390	export interface GroupDrawable {
391	  type: "group";
392	  common: DrawableCommon;
393	  /**
394	   * Children with coordinates in the GROUP's coordinate space
395	   * (proto children carry absolute geometry; the converter re-bases them so
396	   * a group can be moved as one — docs/model-design.md §Flattening).
397	   */
398	  children: Drawable[];
399	  /** Freehand drawing metadata when this group is one. [proto: TSD.FreehandDrawingArchive ext 100] */
400	  freehand?: { opacity?: number; animation?: { duration?: number; loop?: boolean } };
401	}
402	
403	/** A connector line between two drawables. [proto: TSD.ConnectionLineArchive] */
404	export interface ConnectionLineDrawable {
405	  type: "connection-line";
406	  common: DrawableCommon;
407	  /**
408	   * Routing as explicit curves (quadratic or orthogonal), in canvas space.
409	   * The proto stores the two endpoints as object references; the converter
410	   * resolves both anchors and bakes their positions into the path.
411	   */
412	  path: CurvePath;
413	  /** The shape this connector was attached to, as an embedded copy when the
414	   * target resolved; its `common.position/size` are the anchor facts. */
415	  from?: Pick<DrawableCommon, "position" | "size">;
416	  to?: Pick<DrawableCommon, "position" | "size">;
417	}
418	
419	/** Table on a canvas — the wrapper (TST.TableInfoArchive) around a TableModel. */
420	export interface TableDrawable {
421	  type: "table";
422	  common: DrawableCommon;
423	  table: TableModel;
424	}
425	
426	/** Chart on a canvas — TSCH.ChartDrawableArchive with its model resolved. */
427	export interface ChartDrawable {
428	  type: "chart";
429	  common: DrawableCommon;
430	  chart: ChartModel;
431	}
432	
433	/** A drawable the converter recognized but could not model. */
434	export interface UnknownDrawable {
435	  type: "unknown";
436	  common?: DrawableCommon;
437	  /** Registry type id, hex string (e.g. "0x1a2b") — never guessed names. */
438	  typeId: string;
439	  /** Registry message name when a trusted table had one. */
440	  typeName?: string;
441	  reason: string;
442	}
443	
444	// ---------------------------------------------------------------------------
445	// Tables (TST) — data resolved, styles inlined
446	// ---------------------------------------------------------------------------
447	
448	/**
449	 * A table, resolved from TST.TableModelArchive + DataStore + tiles
450	 * (docs/format/tables.md). Dimensions and header counts are explicit; the
451	 * cell grid is DENSE row-major (`grid[row][column]`) — a viewer can walk it
452	 * 1:1 onto `<tr>` rendering — with `null` marking absent cells (sparse
453	 * sheets). Cell values are the LAST CALCULATED results; the model never
454	 * re-evaluates formulas (docs/format/calcengine.md).
455	 */
456	export interface TableModel {
457	  /** Display name. [proto: TableModelArchive.table_name] */
458	  name?: string;
459	  rowCount: number;
460	  columnCount: number;
461	  headerRowCount: number;
462	  headerColumnCount: number;
463	  footerRowCount: number;
464	  /** Frozen header rows/cols (scroll behavior). */
465	  headerRowsFrozen?: boolean;
466	  headerColumnsFrozen?: boolean;
467	  /** Per-row sizes/hidden flags, length = rowCount (absent entries = default). */
468	  rows?: RowColInfo[];
469	  /** Per-column widths/hidden flags, length = columnCount. */
470	  columns?: RowColInfo[];
471	  /** Default row height / column width in points. [proto: fields 16/17] */
472	  defaultRowHeightPt?: number;
473	  defaultColumnWidthPt?: number;
474	  /**
475	   * Cell grid, row-major: exactly `rowCount` rows of `columnCount` entries.
476	   * `null` = no cell stored for that position (sparse tables). A present
477	   * cell is a plain JSON string/number/boolean (unformatted simple value) or
478	   * a `TableCell` object when there is more to say — see the glossary in
479	   * docs/model-design.md §Reading the envelope. Values are the LAST
480	   * CALCULATED results; the model never re-evaluates formulas
481	   * (docs/format/calcengine.md).
482	   */
483	  grid: (GridCell | null)[][];
484	  /**
485	   * Distinct number formats used by this table, deduped; cells reference a
486	   * format by index (`TableCell.fmt`), absent = unformatted.
487	   */
488	  formats: CellFormat[];
489	  /**
490	   * Distinct per-cell looks used by this table, deduped (same pooling pattern
491	   * as the document-wide text-style pools); cells reference by
492	   * `TableCell.cellStyleIndex`, absent = table default style.
493	   */
494	  cellStyles: TableCellStyle[];
495	  /** Merged regions; only the anchor cell carries content in `grid`. */
496	  merges: TableMerge[];
497	  /** Resolved table-level look. */
498	  style?: TableStyle;
499	}
500	
501	/**
502	 * One grid slot: a plain unformatted value or an explicit cell object.
503	 * The position in `grid` implies row/column, so plain values need no keys.
504	 */
505	export type GridCell = string | number | boolean | TableCell;
506	
507	/**
508	 * A grid cell that needs more than a bare value: formatted, typed
509	 * (date/duration/currency/richtext/error), styled, or formula-bearing.
510	 */
511	export interface TableCell {
512	  /** The cell's value; `null` = present-but-valueless (style/merge only). */
513	  v: string | number | boolean | StyledText | null;
514	  /**
515	   * Value type tag — REQUIRED when the JSON type of `v` is ambiguous
516	   * (an ISO string could be text, a number could be seconds), omitted for
517	   * plain text/number/bool. `date` v = ISO 8601 UTC string; `duration`
518	   * v = seconds; `currency` v = amount (+ optional `cur` code);
519	   * `richtext` v = StyledText; `error` v = stored error string.
520	   */
521	  type?: "date" | "duration" | "currency" | "richtext" | "error";
522	  /** Currency code when type = "currency" (e.g. "USD"). */
523	  cur?: string;
524	  /** Index into `TableModel.formats`; absent = unformatted. */
525	  fmt?: number;
526	  /** Index into `TableModel.cellStyles`; absent = table default look. */
527	  cellStyleIndex?: number;
528	  /** Formula placeholder when the cell computes its value. */
529	  formula?: TsceFormulaRef;
530	}
531	
532	export interface RowColInfo {
533	  /** Size in points. */
534	  sizePt?: number;
535	  hidden?: boolean;
536	}
537	
538	
539	/** Resolved per-cell look (TST.CellStylePropertiesArchive + text style); pooled per table. */
540	export interface TableCellStyle {
541	  fill?: Fill;
542	  /** Per-side borders; undefined side = no explicit border. */
543	  borders?: {
544	    top?: Stroke;
545	    right?: Stroke;
546	    bottom?: Stroke;
547	    left?: Stroke;
548	  };
549	  verticalAlignment?: VerticalAlignment;
550	  text?: CharStyle;
551	  paragraph?: ParaStyle;
552	  textWrap?: boolean;
553	  padding?: { top?: number; left?: number; bottom?: number; right?: number };
554	}
555	
556	/** Number format descriptor (kept simple; custom formats degrade to a hint). */
557	export interface CellFormat {
558	  kind: "number" | "currency" | "percent" | "date" | "duration" | "text" | "custom" | "automatic";
559	  /** Decimal places for number-like kinds. */
560	  decimals?: number;
561	  /** Currency code for currency (e.g. "USD") when known. */
562	  currencyCode?: string;
563	  /** Thousands separators shown (locale-appropriate grouping). Absent = off.
564	   * [proto: TSK.FormatStructArchive.show_thousands_separator (field 5)] */
565	  grouping?: boolean;
566	  /** Raw custom format string when kind = "custom". */
567	  formatString?: string;
568	}
569	
570	/** Merged region: anchor (top-left) + span. [proto: TST.MergeRegionMapArchive CellRange] */
571	export interface TableMerge {
572	  anchorRow: number;
573	  anchorColumn: number;
574	  rowSpan: number;
575	  columnSpan: number;
576	}
577	
578	/** Resolved table-level styling (TST.TableStylePropertiesArchive subset a viewer needs). */
579	export interface TableStyle {
580	  bandedRows?: boolean;
581	  bandedFill?: Fill;
582	  /** Default look for body cells (per-cell style overrides this). */
583	  bodyCellStyle?: TableCellStyle;
584	  /** Default look for header-row / header-column cells. */
585	  headerRowCellStyle?: TableCellStyle;
586	  headerColumnCellStyle?: TableCellStyle;
587	  footerRowCellStyle?: TableCellStyle;
588	}
589	
590	// ---------------------------------------------------------------------------
591	// Charts (TSCH) — type + inline data, rendering deferred
592	// ---------------------------------------------------------------------------
593	
594	/**
595	 * A chart, resolved from TSCH.ChartArchive. Data is INLINED: when the chart
596	 * carries a private grid (`TSCH.ChartGridArchive`) the series values are
597	 * right here; when the chart is bound to a table (Numbers mediator), the
598	 * binding is recorded as a `dataBinding` placeholder and `dataStatus`
599	 * explains what the viewer can expect. Rendering (axes, ticks, legends) is
600	 * the viewer's job — the model carries type + data + minimal style hints.
601	 * [proto: docs/format/charts.md]
602	 */
603	export interface ChartModel {
604	  /** Chart type, normalized from the ~27-value TSCH.ChartType enum. */
605	  type: ChartType;
606	  /** True when the type is a 3D variant. */
607	  threeD: boolean;
608	  /** Series values are present inline / referenced from a table / unavailable. */
609	  dataStatus: "inline" | "table-bound" | "unavailable";
610	  /** Category labels (x axis), after applying `seriesDirection`. */
611	  categories: string[];
612	  /** Series, values aligned with `categories` (same length when inline). */
613	  series: ChartSeries[];
614	  /** Legend frame in canvas points, when stored. */
615	  legendFrame?: { x: number; y: number; width: number; height: number };
616	  legendVisible?: boolean;
617	  /** Series colors as stored in per-series styles, best effort. */
618	  seriesColors?: HexColor[];
619	  /** Numbers-only: the table this chart reads from, as a placeholder. */
620	  dataBinding?: TsceFormulaRef;
621	  /** Scatter layout. [proto: TSCH.ScatterFormat] */
622	  scatterFormat?: "separate-x" | "shared-x";
623	}
624	
625	export interface ChartSeries {
626	  /** Series (legend) label. */
627	  name?: string;
628	  /** Values aligned with ChartModel.categories; holes are `null`. */
629	  values: (number | IsoDateString | null)[];
630	}
631	
632	/** Normalized chart types (from TSCH.ChartType, 2D and 3D variants collapsed). */
633	export type ChartType =
634	  | "column"
635	  | "stacked-column"
636	  | "bar"
637	  | "stacked-bar"
638	  | "line"
639	  | "area"
640	  | "stacked-area"
641	  | "pie"
642	  | "donut"
643	  | "scatter"
644	  | "bubble"
645	  | "radar"
646	  | "other";
647	
648	// ---------------------------------------------------------------------------
649	// TSCE placeholder — formulas stay opaque
650	// ---------------------------------------------------------------------------
651	
652	/**
653	 * A formula reference, deliberately OPAQUE (pnk does not decompile TSCE ASTs
654	 * — docs/format/calcengine.md). The last-calculated VALUE is already in the
655	 * cell/chart data; this placeholder only records that a formula existed.
656	 */
657	export interface TsceFormulaRef {
658	  /** Identity of the formula in the source (e.g. the TableDataList key). */
659	  id: string;
660	  status: "unparsed";
661	  /** Formula text when trivially recoverable; usually absent. */
662	  sourceText?: string;
663	  /** Always set: what the viewer should surface instead of a live formula. */
664	  warning: Warning;
665	}
666	

1	/**
2	 * pnk JSON document models — primitives.
3	 *
4	 * Shared scalar types and style primitives used by every document model
5	 * (Pages / Numbers / Keynote). Design rules, enforced across all files:
6	 *
7	 * 1. UNITS — internet-friendly everywhere:
8	 *    - lengths/positions/sizes: points (pt), as plain `number`
9	 *    - angles: degrees (`angleDeg`), as plain `number`
10	 *    - colors: `#rrggbb` or `#rrggbbaa` hex strings
11	 *    - dates: ISO 8601 strings
12	 *    - durations: `{ seconds: number }` (plain SI seconds, not calendar)
13	 *
14	 * 2. OPTIONAL vs NULL — the convention for "not specified" vs "explicitly unset":
15	 *    - `field?: T`          → absent = the source never specified a value
16	 *      (protos: field absent, and no `*_null` flag).
17	 *    - `field: T | null`    → null = the source EXPLICITLY cleared the value
18	 *      (protos: `*_null = true` flag, or an intentional empty marker).
19	 *    Absent and null are therefore distinct and both meaningful: a viewer falls
20	 *    back to its own default for absent, and renders "no value" for null.
21	 *    In practice TSS style null-flags (`font_name_null` etc.) only survive on
22	 *    *unresolved* styles; this model ships RESOLVED styles, so `| null` fields
23	 *    are rare (table cell values, document-level explicit-unset spots).
24	 *
25	 * 3. NO INDIRECTION — every object is embedded; there are no object ids, no
26	 *    TSP.References, no style-archive pointers. What was a reference in the
27	 *    protobuf object graph is an inline object here.
28	 *
29	 * 4. RUST SERDE COMPATIBLE — camelCase fields, string-union enums (no numeric
30	 *    enums), tagged unions via a `type`/`kind` discriminant string. No TS-only
31	 *    types (no tuples-as-pairs, no branded types in serialized positions).
32	 *
33	 * Provenance for every mapping lives in docs/model-design.md; format facts in
34	 * docs/format/*.md.
35	 */
36	
37	// ---------------------------------------------------------------------------
38	// Colors
39	// ---------------------------------------------------------------------------
40	
41	/**
42	 * Color as a hex string: `#rrggbb`, or `#rrggbbaa` when the source color has
43	 * an alpha other than fully opaque. Alpha is in the last byte pair
44	 * (`00` = transparent, `ff` = opaque).
45	 *
46	 * Source colors are `TSP.Color` [proto: .scratch/otorp/Keynote/TSPMessages.proto
47	 * → TSP.Color]: model rgb/cmyk/white, float components 0..1, RGB color space
48	 * srgb (1) or p3 (2), plus `headroom` for HDR extension. Conversion rules:
49	 *  - rgb/srgb  → direct scale 0..1 → 0..255 per channel.
50	 *  - rgb/p3    → converted to the nearest sRGB approximation; when the result
51	 *    is visibly out of sRGB gamut the converter adds a
52	 *    `color-out-of-gamut` warning (see docs/model-design.md). [inferred]
53	 *  - cmyk/white→ converted to sRGB by the standard naive formulas
54	 *    (cmyk: r=(1-c)(1-k) etc.; white: r=g=b=w). [inferred: standard math;
55	 *    fixtures may need refinement]
56	 *  - headroom ≠ 1 (HDR) → clamp after conversion + `color-hdr-clamped` warning.
57	 */
58	export type HexColor = `#${string}`;
59	
60	// ---------------------------------------------------------------------------
61	// Geometry (all in points, angles in degrees)
62	// ---------------------------------------------------------------------------
63	
64	/** A position in points, origin at the canvas top-left, y increasing downward. */
65	export interface Point {
66	  x: number;
67	  y: number;
68	}
69	
70	/** Width/height in points. */
71	export interface Size {
72	  width: number;
73	  height: number;
74	}
75	
76	/** An axis-aligned rectangle in points. */
77	export interface Rect {
78	  x: number;
79	  y: number;
80	  width: number;
81	  height: number;
82	}
83	
84	/** Inset distances in points (top/left/bottom/right), from `TSD.EdgeInsetsArchive`. */
85	export interface EdgeInsets {
86	  top: number;
87	  left: number;
88	  bottom: number;
89	  right: number;
90	}
91	
92	/**
93	 * Fills, from `TSD.FillArchive` [proto: .scratch/otorp/Keynote/TSDArchives.proto:158-163]:
94	 * exactly one of color / gradient / image is meaningful.
95	 * A fill property on the resolved style is `Fill | undefined`: undefined =
96	 * no fill specified (inherit chain exhausted / transparent).
97	 */
98	export type Fill = SolidFill | GradientFill | ImageFill;
99	
100	export interface SolidFill {
101	  type: "solid";
102	  color: HexColor;
103	}
104	
105	export interface GradientFill {
106	  type: "gradient";
107	  gradient: Gradient;
108	}
109	
110	export interface ImageFill {
111	  type: "image";
112	  /** The fill image, resolved to a `Data/` asset. */
113	  image: MediaRef;
114	  /** How the image is fitted. [proto: TSD.ImageFillArchive.ImageFillTechnique] */
115	  technique:
116	    | "natural-size"
117	    | "stretch"
118	    | "tile"
119	    | "scale-to-fill"
120	    | "scale-to-fit";
121	  /** Tint color, if the source carries one. [proto: TSD.ImageFillArchive.tint] */
122	  tint?: HexColor;
123	}
124	
125	/**
126	 * Gradient, from `TSD.GradientArchive`
127	 * [proto: .scratch/otorp/Keynote/TSDArchives.proto:121-137].
128	 * Stops are in source order; `fraction` is the position 0..1 along the
129	 * gradient axis, `inflection` the midpoint bias between neighbors.
130	 */
131	export interface Gradient {
132	  kind: "linear" | "radial";
133	  stops: GradientStop[];
134	  /**
135	   * Linear gradient angle in degrees (0 = left→right, measuring
136	   * counterclockwise). [proto: TSD.AngleGradientArchive.gradientangle]
137	   */
138	  angleDeg?: number;
139	  /**
140	   * Explicit start/end for gradients that carry a transform instead of an
141	   * angle, in the filled object's coordinate space.
142	   * [proto: TSD.TransformGradientArchive start/end/baseNaturalSize]
143	   */
144	  startPoint?: Point;
145	  endPoint?: Point;
146	}
147	
148	export interface GradientStop {
149	  color: HexColor;
150	  /** Position along the gradient axis, 0..1. */
151	  fraction: number;
152	  /** Midpoint bias between this stop and the next, 0..1. */
153	  inflection?: number;
154	}
155	
156	/**
157	 * Shadow, from `TSD.ShadowArchive`
158	 * [proto: .scratch/otorp/Keynote/TSDArchives.proto:218-234].
159	 * Defaults shown are the proto defaults; the converter bakes them in.
160	 */
161	export interface Shadow {
162	  color: HexColor;
163	  /** Light angle in degrees (proto default 315). */
164	  angleDeg: number;
165	  /** Offset distance in points (proto default 5). */
166	  offsetPt: number;
167	  /** Blur radius in points (proto default 1). */
168	  radiusPt: number;
169	  /** 0..1 (proto default 1). */
170	  opacity: number;
171	  kind: "drop" | "contact" | "curved";
172	  /** Contact-shadow extras. [proto: TSD.ContactShadowArchive height/offset] */
173	  contact?: { height?: number; offset?: number };
174	  /** Curved-shadow bend factor. [proto: TSD.CurvedShadowArchive curve] */
175	  curved?: { curve?: number };
176	}
177	
178	/** Stroke/outline, from `TSD.StrokeArchive`
179	 * [proto: .scratch/otorp/Keynote/TSDArchives.proto:177-192]. */
180	export interface Stroke {
181	  color: HexColor;
182	  /** Stroke width in points. */
183	  widthPt: number;
184	  cap: "butt" | "round" | "square";
185	  join: "miter" | "round" | "bevel";
186	  /** Miter limit when `join` is "miter". */
187	  miterLimit?: number;
188	  /**
189	   * Dash pattern in points; empty/undefined = solid.
190	   * [proto: TSD.StrokePatternArchive.pattern/phase/count]
191	   */
192	  dash?: number[];
193	  /** Dash phase offset in points. */
194	  dashPhase?: number;
195	}
196	
197	/** Decorative line ends (arrowheads etc.).
198	 * [proto: TSD.LineEndArchive — path/identifier/is_filled]. */
199	export interface LineEnd {
200	  /** Preset identifier of the end decoration (e.g. a named arrowhead). */
201	  identifier?: string;
202	  isFilled?: boolean;
203	  /** The decoration outline as explicit curves, if the source carried a path. */
204	  path?: CurvePath;
205	}
206	
207	/** Reflection under the object. [proto: TSD.ReflectionArchive — opacity 0.5 default] */
208	export interface Reflection {
209	  opacity: number;
210	}
211	
212	// ---------------------------------------------------------------------------
213	// Curves — the universal shape language
214	// ---------------------------------------------------------------------------
215	
216	/**
217	 * One path element — `TSP.Path` translated to explicit primitives with
218	 * COMPACT FLAT positional point arrays [proto: .scratch/otorp/Keynote/
219	 * TSPMessages.proto → TSP.Path { ElementType: moveTo=1, lineTo=2,
220	 * quadCurveTo=3, curveTo=4, closeSubpath=5; each Element carries repeated
221	 * TSP.Point }] — `points` is `[x1,y1,x2,y2,…]` (SVG-style pairs), not
222	 * `{x,y}` objects:
223	 *  - "move"  → points = [x, y] (subpath start).
224	 *  - "line"  → points = [x, y] (line target).
225	 *  - "quad"  → points = [cx, cy, x, y] (control, target).
226	 *  - "cubic" → points = [c1x, c1y, c2x, c2y, x, y] (two controls, target).
227	 *  - "close" → closes the current subpath (no points).
228	 */
229	export type CurveElement =
230	  | { type: "move"; points: [number, number] }
231	  | { type: "line"; points: [number, number] }
232	  | { type: "quad"; points: [number, number, number, number] }
233	  | { type: "cubic"; points: [number, number, number, number, number, number] }
234	  | { type: "close" };
235	
236	/**
237	 * An explicit vector path in the shape's own coordinate space (points).
238	 * A straight LINE is the minimal form: exactly one "move" + one "line"
239	 * element (2 sharp nodes, stroke-only, no fill — fixture-verified:
240	 * G5 acid line, editable_bezier_path_source with 2 nodes). Its coordinates
241	 * are already in the drawable's point space — no naturalSize scaling.
242	 */
243	export interface CurvePath {
244	  elements: CurveElement[];
245	}
246	
247	// ---------------------------------------------------------------------------
248	// Alignment enums
249	// ---------------------------------------------------------------------------
250	
251	/**
252	 * Horizontal text alignment. Source is the opaque
253	 * `TSWP.ParagraphStylePropertiesArchive.TextAlignmentType` (TATvalue0..4);
254	 * the value mapping is anchored by numbers-parser
255	 * [parser: masaccio/numbers-parser@32387958 src/numbers_parser/cell.py:145-149]:
256	 * TATvalue0=LEFT, TATvalue1=RIGHT, TATvalue2=CENTER, TATvalue3=JUSTIFIED,
257	 * TATvalue4=AUTO. Note the surprising 1=right / 2=center order.
258	 */
259	export type HorizontalAlignment = "left" | "right" | "center" | "justify" | "auto";
260	
261	/**
262	 * Vertical text alignment in a frame/cell. Sources:
263	 * `TSWP.ShapeStylePropertiesArchive.VerticalAlignmentType`
264	 * (kFrameAlignTop=0/Middle=1/Bottom=2/Justify=3) and the int32
265	 * `TST.CellStylePropertiesArchive.vertical_alignment` (same 0..3 order).
266	 * [proto: .scratch/otorp/Keynote/TSWPArchives.proto:496-503;
267	 *  TSTStylePropertyArchiving.proto:24] [inferred: TST int32 uses the same enum]
268	 */
269	export type VerticalAlignment = "top" | "middle" | "bottom" | "justify";
270	
271	// ---------------------------------------------------------------------------
272	// Dates & durations
273	// ---------------------------------------------------------------------------
274	
275	/** ISO 8601 date-time string, always UTC (`...Z`).
276	 * Source dates are doubles = seconds since 2001-01-01T00:00:00Z
277	 * [proto: TSP.Date.seconds; parser: masaccio/numbers-parser@32387958
278	 * src/numbers_parser/cell.py (EPOCH + timedelta)]. */
279	export type IsoDateString = string;
280	
281	/** A duration as plain seconds (iWork stores durations as double seconds). */
282	export interface Duration {
283	  seconds: number;
284	}
285	
286	// ---------------------------------------------------------------------------
287	// Resolved text styles (no inheritance, no attribute-table offsets)
288	// ---------------------------------------------------------------------------
289	
290	/** Underline style. Source: `TSWP.CharacterStylePropertiesArchive.UnderlineType`
291	 * (kNoUnderline=0, kSingle=1, kDouble=2, kWavy=3) [proto]. */
292	export type UnderlineStyle = "none" | "single" | "double" | "wavy";
293	
294	/** Strikethrough style. Source: `StrikethruType` (kNo=0, kSingle=1, kDouble=2, kTriple=3) [proto]. */
295	export type StrikethroughStyle = "none" | "single" | "double" | "triple";
296	
297	/** Capitalization. Source: `CapitalizationType` (kNoCaps=0, kAllCaps=1, kSmallCaps=2, kTitled=3) [proto]. */
298	export type Capitalization = "none" | "all-caps" | "small-caps" | "title";
299	
300	/** Superscript/subscript. Source: `SuperscriptType` [proto]. */
301	export type BaselineScript = "normal" | "superscript" | "subscript";
302	
303	/**
304	 * Resolved character formatting (from TSWP.CharacterStylePropertiesArchive
305	 * merged along the TSS.StyleArchive parent chain — see docs/model-design.md).
306	 * Every field optional = "not specified anywhere in the chain".
307	 * Font metrics are in points; colors are hex.
308	 */
309	export interface CharStyle {
310	  fontName?: string;
311	  fontSizePt?: number;
312	  bold?: boolean;
313	  italic?: boolean;
314	  underline?: UnderlineStyle;
315	  strikethrough?: StrikethroughStyle;
316	  capitalization?: Capitalization;
317	  baseline?: BaselineScript;
318	  /** Vertical baseline offset in points. [proto: baseline_shift] */
319	  baselineShiftPt?: number;
320	  /** Letter spacing in points. [proto: tracking (kerning is the legacy pair)] */
321	  trackingPt?: number;
322	  fontColor?: HexColor;
323	  /** Highlight color behind the glyphs. [proto: background_color] */
324	  backgroundColor?: HexColor;
325	  /** Text outline. [proto: outline (width) + outline_color] */
326	  outline?: { widthPt: number; color?: HexColor };
327	  /** Per-glyph text shadow. [proto: shadow (TSD.ShadowArchive)] */
328	  shadow?: Shadow;
329	  /** Language tag, e.g. "en-US". [proto: language] */
330	  language?: string;
331	  /** OpenType feature tags, e.g. ["tnum"]. [proto: font_features] */
332	  fontFeatures?: string[];
333	}
334	
335	/**
336	 * Resolved paragraph formatting (from TSWP.ParagraphStylePropertiesArchive +
337	 * TSWP.LineSpacingArchive, merged along the style parent chain).
338	 * All indents/spacing in points.
339	 */
340	export interface ParaStyle {
341	  horizontalAlignment?: HorizontalAlignment;
342	  /** Left indent (hanging: first line outdents by firstLineIndentPt). */
343	  leftIndentPt?: number;
344	  rightIndentPt?: number;
345	  firstLineIndentPt?: number;
346	  spaceBeforePt?: number;
347	  spaceAfterPt?: number;
348	  /**
349	   * Line spacing. Source `TSWP.LineSpacingArchive` [proto]:
350	   * mode relative (multiple of line height) / minimum / exact / maximum /
351	   * space-between, with `amount`. `lineSpacingMultiple` carries the common
352	   * relative case; `lineSpacingExactPt` the exact case. Both may be absent.
353	   */
354	  lineSpacingMultiple?: number;
355	  lineSpacingExactPt?: number;
356	  lineSpacingMode?: "min" | "max" | "space-between";
357	  /** Explicit tab stops. [proto: TSWP.TabsArchive] */
358	  tabs?: TabStop[];
359	  /** Distance between default tab stops (points); absent = app default. */
360	  defaultTabStopPt?: number;
361	  /** List/bullet formatting if the paragraph is part of a list. */
362	  list?: ListFormat;
363	  /** Heading level from `outline_level` (0 = body text; 1..5 = heading depth). */
364	  outlineLevel?: number;
365	  keepLinesTogether?: boolean;
366	  keepWithNext?: boolean;
367	  hyphenate?: boolean;
368	  pageBreakBefore?: boolean;
369	  /** Paragraph background fill. [proto: fill] */
370	  backgroundColor?: HexColor;
371	  /** Paragraph border drawn around the paragraph block. [proto: stroke] */
372	  border?: Stroke;
373	  /** Writing direction override. [proto: writing_direction] */
374	  writingDirection?: "left-to-right" | "right-to-left";
375	}
376	
377	/** One tab stop. [proto: TSWP.TabArchive position/alignment/leader] */
378	export interface TabStop {
379	  positionPt: number;
380	  alignment: "left" | "center" | "right" | "decimal";
381	  /** Leader character(s) filling the tab run (e.g. ".", "_"). */
382	  leader?: string;
383	}
384	
385	/**
386	 * List formatting, from `TSWP.ListStyleArchive` resolved per level
387	 * [proto: .scratch/otorp/Keynote/TSWPArchives.proto → TSWP.ListStyleArchive:
388	 * label_types/number_types/strings/indents/…, one entry per nesting level].
389	 */
390	export interface ListFormat {
391	  /** Nesting level, 0-based. */
392	  level: number;
393	  /** What renders at the marker position. */
394	  markerKind: "none" | "string" | "number" | "image";
395	  /** Literal marker text when markerKind = "string" (e.g. "•", "→"). */
396	  markerText?: string;
397	  /**
398	   * Numbering scheme when markerKind = "number"
399	   * (source NumberType enum, ~65 locale variants; the converter maps the
400	   * latin/roman/alpha kinds by name and degrades exotic locale kinds to
401	   * "decimal" with a warning).
402	   */
403	  numberKind?: NumberKind;
404	  /** Marker image when markerKind = "image". */
405	  markerImage?: MediaRef;
406	  /** Where the marker text starts (continues from previous list otherwise). */
407	  start?: number;
408	  /** Indent of the marker relative to the paragraph's left indent, in points. */
409	  markerIndentPt?: number;
410	}
411	
412	export type NumberKind =
413	  | "decimal"
414	  | "alpha-upper"
415	  | "alpha-lower"
416	  | "roman-upper"
417	  | "roman-lower"
418	  | "other";
419	
420	// ---------------------------------------------------------------------------
421	// Media references
422	// ---------------------------------------------------------------------------
423	
424	/**
425	 * A pointer to an embedded media asset, resolved from the TSP.DataInfo
426	 * registry (see docs/format/media.md). The referenced bytes live in the
427	 * container; the root document envelope lists all assets in `media`.
428	 */
429	export interface MediaRef {
430	  /** DataInfo identifier (uint64, serialized as decimal string). */
431	  dataId: string;
432	  /** Actual member name under `Data/` in the container. */
433	  fileName?: string;
434	  /** User-facing original name. */
435	  preferredFileName?: string;
436	  /** Pixel dimensions when known (image assets). */
437	  pixelSize?: Size;
438	}
439	
440	// ---------------------------------------------------------------------------
441	// Motion blur (builds only)
442	// ---------------------------------------------------------------------------
443	
444	/**
445	 * Motion blur on Keynote build effects.
446	 * [proto: KN.TransitionAttributesArchive custom_motion_blur + custom_blur_amount;
447	 *  KN.BuildAttributesArchive equivalents]
448	 *
449	 * NOTE: there is NO static "blur" style property anywhere in the TSD/TSS
450	 * proto surface (verified by grep over .scratch/otorp, 2026-08-28) — blur in
451	 * iWork exists only as an animation parameter. Do not invent a static blur.
452	 */
453	export interface MotionBlur {
454	  /** 0..1 blur amount. */
455	  amount: number;
456	}
457	

1	/**
2	 * pnk JSON document models — Numbers (.numbers).
3	 *
4	 * Maps TN.DocumentArchive [1] (+ TSA/TSK supers) onto a resolved,
5	 * reference-free model: document → sheets → drawables/tables.
6	 *
7	 * NOTE on hierarchy: the spec's "sheets → canvases" has no intermediate
8	 * object in the format — a Numbers sheet IS the free-form canvas
9	 * (TN.SheetArchive.drawable_infos holds every table/image/chart/shape
10	 * directly; there is no separate canvas archive — docs/format/numbers.md).
11	 * The model therefore goes document → sheets → drawables, one level.
12	 *
13	 * Tables are fully resolved into the shared TableModel (tiles, storage
14	 * buffers and header-bucket indirection are flattened — docs/model-design.md);
15	 * charts resolve their inline grid, with Numbers' table-bound charts carrying
16	 * a `dataBinding` placeholder. Formulas remain TSceFormulaRef placeholders.
17	 *
18	 * Format facts: docs/format/numbers.md (+ tables.md, drawables.md, charts.md).
19	 */
20	
21	import type {
22	  ChartModel,
23	  Drawable,
24	  DocumentEnvelope,
25	  EdgeInsets,
26	  IsoDateString,
27	  PageLayoutOrientation,
28	  StyledText,
29	  TableModel,
30	} from "./shared";
31	
32	// ---------------------------------------------------------------------------
33	// Print setup (per-sheet, not per-document) — TN.SheetArchive fields 3-14
34	// ---------------------------------------------------------------------------
35	
36	export interface SheetPrintSetup {
37	  orientation?: PageLayoutOrientation;
38	  showPageNumbers?: boolean;
39	  /** Print zoom scale (1 = 100%). [proto: content_scale] */
40	  contentScale?: number;
41	  /** Page order for multi-page content. [proto: TN.PageOrder] */
42	  pageOrder?: "down-then-over" | "over-then-down";
43	  margins?: EdgeInsets;
44	  /** Page numbering start. [proto: using_start_page_number/start_page_number] */
45	  startPageNumber?: number;
46	  useCustomStartPageNumber?: boolean;
47	  /** Header/footer insets in points. [proto: fields 13/14] */
48	  pageHeaderInset?: number;
49	  pageFooterInset?: number;
50	}
51	
52	// ---------------------------------------------------------------------------
53	// Sheets (TN.SheetArchive)
54	// ---------------------------------------------------------------------------
55	
56	export interface Sheet {
57	  /** Sheet name. [proto: field 1, required] */
58	  name: string;
59	  hidden?: boolean;
60	  /** Every object on the sheet canvas, in paint order (z-order). */
61	  drawables: Drawable[];
62	  /** Repeating header/footer text of this sheet. [proto: fields 18/19] */
63	  headers?: StyledText[];
64	  footers?: StyledText[];
65	  /** One shared header/footer for all pages instead of first/rest. [proto: field 20] */
66	  usesSingleHeaderFooter?: boolean;
67	  /** Tab color / canvas fill. [proto: TN.SheetStyleArchive] */
68	  style?: { tabColor?: string; fill?: string };
69	  print?: SheetPrintSetup;
70	  /** Right-to-left canvas layout. [proto: layout_direction] */
71	  layoutDirectionRtl?: boolean;
72	}
73	
74	// ---------------------------------------------------------------------------
75	// Document root
76	// ---------------------------------------------------------------------------
77	
78	/**
79	 * The Numbers document model. Envelope fields (`meta`, `warnings`, `fonts`,
80	 * `media`) follow the shared DocumentEnvelope contract.
81	 */
82	export interface NumbersDocument extends DocumentEnvelope {
83	  kind: "numbers";
84	
85	  /** One entry per TN.SheetArchive, in document order. */
86	  sheets: Sheet[];
87	
88	  /** Document-level print paper size in points. [proto: page_size/paper_id] */
89	  pageSize?: { width: number; height: number };
90	
91	  /**
92	   * Form-based layout entries (TN.FormBasedSheetArchive): a form view bound
93	   * to one table. Rare; recorded so nothing is silently dropped.
94	   */
95	  forms?: { sheetName?: string; boundTableName?: string }[];
96	}
97	
98	// Re-export so converters importing "./numbers" get the whole surface.
99	export type { ChartModel, Drawable, IsoDateString, TableModel };
100	

File created successfully at: /Users/phebert/pnk/docs/model-review.md (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/model/src/keynote.ts has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/model/src/keynote.ts has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/model/src/pages.ts has been updated successfully. (file state is current in your context — no need to Read it back)

1375:pub struct Slide {
1376-    #[serde(skip_serializing_if = "Option::is_none")]
1377-    pub name: Option<String>,
1378-    #[serde(skip_serializing_if = "Option::is_none")]
1379-    pub skipped: Option<bool>,
1380-    #[serde(skip_serializing_if = "Option::is_none")]
1381-    pub master_name: Option<String>,
1382-    pub drawables: Vec<Drawable>,
1383-    #[serde(skip_serializing_if = "Option::is_none")]
1384-    pub notes: Option<StyledText>,
1385-    #[serde(skip_serializing_if = "Option::is_none")]
1386-    pub transition: Option<TransitionSpec>,
1387-    #[serde(skip_serializing_if = "Option::is_none")]
1388-    pub slide_number_visible: Option<bool>,
1389-    /// Slide background fill [proto: KN.SlideStyleArchive.slide_properties.fill];
1390-    /// absent = inherit the master's.
1391-    #[serde(skip_serializing_if = "Option::is_none")]
1392-    pub background: Option<Fill>,
1393-}
1394-
1395-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
1396-#[serde(rename_all = "camelCase")]
1397-pub struct KeynoteDocument {
1398-    /// Always "keynote".
1399-    pub kind: String,
1400-    pub meta: DocumentMeta,
1401-    pub warnings: Vec<Warning>,
1402-    pub fonts: FontList,
1403-    pub media: Vec<MediaAsset>,
1404-    pub styles: StylePools,
1405-    pub slide_size: Size,
1634:pub struct FloatingPage {
1635-    #[serde(skip_serializing_if = "Option::is_none")]
1636-    pub page_index: Option<u32>,
1637-    pub drawables: Vec<Drawable>,
1638-}
1639-
1640-#[derive(Debug, Clone, Serialize, Deserialize, PartialEq)]
1641-#[serde(rename_all = "camelCase")]
1642-pub struct PagesDocument {

The file /Users/phebert/pnk/crates/pnk2json/src/model.rs has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/crates/pnk2json/src/model.rs has been updated successfully. (file state is current in your context — no need to Read it back)

The file /Users/phebert/pnk/crates/pnk2json/src/model.rs has been updated successfully. (file state is current in your context — no need to Read it back)

error[E0063]: missing field `master_drawables` in initializer of `model::Slide`
   --> crates/pnk2json/src/keynote.rs:332:9
    |
332 |         Slide {
    |         ^^^^^ missing `master_drawables`
--
error[E0063]: missing field `master_drawables` in initializer of `model::Slide`
   --> crates/pnk2json/src/keynote.rs:347:5
    |
347 |     Slide {
    |     ^^^^^ missing `master_drawables`
--
error[E0063]: missing field `template_drawables` in initializer of `model::FloatingPage`
   --> crates/pnk2json/src/pages.rs:104:31
    |
104 |                 floating.push(FloatingPage {
    |                               ^^^^^^^^^^^^ missing `template_drawables`
--
error: could not compile `pnk2json` (lib) due to 3 previous errors; 8 warnings emitted
TS-OK

crates/pnk2json/src/keynote.rs sites: 3
crates/pnk2json/src/pages.rs sites: 1
error: expected identifier, found `:`
   --> crates/pnk2json/src/keynote.rs:348:25
    |
348 |         master_drawables: None,
--
error: could not compile `pnk2json` (lib) due to 1 previous error; 7 warnings emitted

            slide_number_visible: None,
            background,
        },
        name,
    )
}

fn empty_slide() -> Slide {
        master_drawables: None,
    Slide {
        master_drawables: None,
        name: None,
        skipped: None,
        master_name: None,
        drawables: Vec::new(),
        notes: None,
        transition: None,

The file /Users/phebert/pnk/crates/pnk2json/src/keynote.rs has been updated successfully. (file state is current in your context — no need to Read it back)

0
 create mode 100644 docs/model-review.md

{"success":true,"message":"Message queued for delivery to a3ef623e1aa80b2a4 at its next tool round.","pin":{"id":"a3ef623e1aa80b2a4","name":"a3ef623e1aa80b2a4","ref":"edf7d5"}}

{"success":true,"message":"Message queued for delivery to a8d402dd5c12f9a4f at its next tool round.","pin":{"id":"a8d402dd5c12f9a4f","name":"a8d402dd5c12f9a4f","ref":"99263d"}}

{"success":true,"message":"Message queued for delivery to abe71d1ea8c796386 at its next tool round.","pin":{"id":"abe71d1ea8c796386","name":"abe71d1ea8c796386","ref":"abceae"}}

16e4d7d pages: sections via table_section; page-master headers/footers; live page fields in the paginated viewer
3dc30b6 viewer: consume flat positional curve points + tsc wired into the gate — CurveElement.points are now [x,y]-style SVG pairs (move/line 2, quad 4, cubic 6, close none; model 2ed592d): explicitPathD walks flat pairs (x*sx,y*sy per pair), standalone-line fast path (exactly one move+line, coordinates already in drawable point space, no naturalSize scaling) per model-design.md §2.5; degenerate-natural-size NaN guard preserved. package.json gains typecheck script and npm test runs tsc --noEmit before playwright so contract drift fails the gate instead of shipping NaN paths. G2 verified: circle/triangle/diamond/parallelogram/pentagon/zigzag paths all emit real coordinates now (were NaN-broken pre-fix); visual_diff /tmp/vd-g2-points; gate 6/6 + tsc clean
b9a2c73 gotchas test: Slide initializers gain master_drawables (model field added in e88770e without test-literal update)
1b0bd5f pnk2json: v4 rich-text key is the TRAILING u32 slot; v4 bool cells decode; rows/columns arrays truncate per ratified rule
5394b27 drawables: degenerate line shapes + rotation angle fixed against Apple ground truth
e88770e model: design review + resolved-inheritance contract (masterDrawables / templateDrawables)
0b19637 pnk2json: merged regions decode from all three numbers-parser sources
fc89bbd text pipeline: runs inherit the paragraph style's char properties; list restart; tabs; absolute first-line indents
fc01e19 pnk2json: CurveElement points emit as compact flat pairs — closes the 2ed592d contract
92215b7 pnk2json: all-zero dash arrays are solid strokes, not dash patterns
---
 M crates/pnk2json/src/keynote.rs
 M crates/pnk2json/src/pages.rs
 M crates/pnk2json/src/tsd.rs
 M docs/format/drawables.md
 M viewer/src/keynote.ts
 M viewer/src/tables.ts
?? crates/pnk2json/examples/
?? fixtures/templates/keynote/
?? fixtures/templates/numbers/
?? fixtures/templates/pages/

2
warning: build failed, waiting for other jobs to finish...
warning: `pnk2json` (lib test) generated 8 warnings (8 duplicates)
error: could not compile `pnk2json` (lib test) due to 1 previous error; 8 warnings emitted
MODEL-TS-OK

error[E0599]: the method `as_ref` exists for reference `&model::DrawableCommon`, but its trait bounds were not satisfied
   --> crates/pnk2json/src/pages.rs:259:54
    |
259 |             Drawable::Image { common, .. } => common.as_ref(),
    |                                                      ^^^^^^ method cannot be called on `&model::DrawableCommon` due to unsatisfied trait bounds
    |
   ::: crates/pnk2json/src/model.rs:654:1
--
error: could not compile `pnk2json` (lib) due to 1 previous error; 8 warnings emitted

    }
    .with_locale(locale)
}

/// A page drawable supersedes a template placeholder when it sits at the
/// same position with the same size (±1pt) [inferred heuristic — the format
/// links them via UUIDs we do not model].
fn same_geometry(a: &Drawable, b: &Drawable) -> bool {
    fn common(d: &Drawable) -> Option<&DrawableCommon> {
        match d {
            Drawable::Shape { common, .. } | Drawable::Textbox { common, .. } => Some(common),
            _ => None,
        }
    }
    let (Some(ca), Some(cb)) = (common(a), common(b)) else { return false };
    let close = |x: f64, y: f64| (x - y).abs() <= 1.0;
    match (&ca.position, &cb.position, &ca.size, &cb.size) {
        (Some(pa), Some(pb), Some(sa), Some(sb)) => {
            close(pa.x, pb.x) && close(pa.y, pb.y)
                && close(sa.width, sb.width) && close(sa.height, sb.height)
        }
        _ => false,
    }
}

0
  6 passed (1.4s)

test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
test golden_g1_word_processing_matches_expected ... FAILED
test golden_g2_page_layout_matches_expected ... FAILED
test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s

crates/pnk2json/tests/golden.rs:64:fn golden_g1_word_processing_matches_expected() {
only-old: []
only-new: []
para pool: 4 -> 4 | char pool: 5 -> 5
paragraph count: 11 -> 11

0 diffs

                    short(a),
                    short(b)
                ));
            }
        }
    }
}

fn short(v: &serde_json::Value) -> String {
    let s = v.to_string();
    if s.len() > 70 {
        // byte-safe truncation: back up to a char boundary so multi-byte
        // chars (emoji, CJK) in mismatch snippets never panic
        let mut end = 70.min(s.len());
        while end > 0 && !s.is_char_boundary(end) {
            end -= 1;
        }
        format!("{}…", &s[..end])
    } else {
        s
    }
}

#[test]
fn golden_g1_word_processing_matches_expected() {
    let Some(fixture) = golden_path("fixtures/golden/G1-golden-pages-wp.pages") else {
        eprintln!("golden fixture absent; skipping");
        return;
    };
    let Some(expected_path) = golden_path("fixtures/golden/expected/G1-golden-pages-wp.json")
    else {
        eprintln!("expected JSON absent; skipping");
        return;
    };

    let ours: serde_json::Value =
        serde_json::from_str(&pnk2json::to_json(&pnk2json::convert_path(&fixture).unwrap()))
            .unwrap();
    let expected: serde_json::Value =
        serde_json::from_str(&std::fs::read_to_string(expected_path).unwrap()).unwrap();

    let mut out = Vec::new();
    diff(&expected, &ours, "", &mut out);
    assert!(
        out.is_empty(),
        "golden G1 diverged ({}):\n{}",
        out.len(),
        out.join("\n")
    );
}

#[test]
fn golden_g2_page_layout_matches_expected() {
    let Some(fixture) = golden_path("fixtures/golden/G2-golden-pages-layout.pages") else {
        eprintln!("golden fixture absent; skipping");
        return;

(Bash completed with no output)

test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 3 filtered out; finished in 0.00s
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
test golden_g1_word_processing_matches_expected ... ok
test golden_g2_page_layout_matches_expected ... ok
test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.01s
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 9 filtered out; finished in 0.00s

     Running unittests src/bin/pnk2json.rs (target/release/deps/pnk2json-cf21b8dd4cba2a2a)

running 0 tests

test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s

     Running tests/golden.rs (target/release/deps/golden-ba0cd83428d9cc32)

running 1 test
test golden_g1_word_processing_matches_expected ... ok

test result: ok. 1 passed; 0 failed; 0 ignored; 0 measured; 1 filtered out; finished in 0.01s

     Running tests/gotchas.rs (target/release/deps/gotchas-698910a636211999)

running 0 tests

test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 9 filtered out; finished in 0.00s

test result: ok. 3 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
test result: ok. 2 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.02s
test result: ok. 9 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.06s
test result: ok. 0 passed; 0 failed; 0 ignored; 0 measured; 0 filtered out; finished in 0.00s
16e4d7d pages: sections via table_section; page-master headers/footers; live page fields in the paginated viewer
3dc30b6 viewer: consume flat positional curve points + tsc wired into the gate — CurveElement.points are now [x,y]-style SVG pairs (move/line 2, quad 4, cubic 6, close none; model 2ed592d): explicitPathD walks flat pairs (x*sx,y*sy per pair), standalone-line fast path (exactly one move+line, coordinates already in drawable point space, no naturalSize scaling) per model-design.md §2.5; degenerate-natural-size NaN guard preserved. package.json gains typecheck script and npm test runs tsc --noEmit before playwright so contract drift fails the gate instead of shipping NaN paths. G2 verified: circle/triangle/diamond/parallelogram/pentagon/zigzag paths all emit real coordinates now (were NaN-broken pre-fix); visual_diff /tmp/vd-g2-points; gate 6/6 + tsc clean
b9a2c73 gotchas test: Slide initializers gain master_drawables (model field added in e88770e without test-literal update)