idml 0.6.1 → 0.6.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5bb1c7b34977858469e94bb4c827fa29345a7e47bcecf9ccce4d5c23b318b6e4
-  data.tar.gz: d0e08d56d56d65903db2871b7de5ec1c6178e60ed6d2f79aa7370e10bef535de
+  metadata.gz: 46b15814f26a45f5df5c3170df66846ff831727ce3dcf4b7ebe1b1c0377d8c0e
+  data.tar.gz: d4041eacffab33e437330116d3b1268577b6ad8afbc0f2ee4cc1e015c07ec3a4
 SHA512:
-  metadata.gz: 1a89f6c00cf82b3337cb6b4df486276cf27b9d1dceb8faa47ead1942b27ebf2ba758dcb135d75f9e0f6dcb973e8ee15e6483c322efde055707cbc7f6749a1841
-  data.tar.gz: 8cf5bfff805beab37073490eb96788daed1832a756a86a4dfc980f5851cf8a6df941b3751f67aef4da5567f728ef4988b43fb8af08d6109b07ae17fed45bacc2
+  metadata.gz: 45e7dcb9c7bad255b0bc4fbe2e97e741c7a1b1ff52a6bf899ffdffdf838f310780c1e90832b54f9cbd5a0044b7b908f9c3791fd8274b4272fe1f40506b0ce793
+  data.tar.gz: b928db59ed416b59431bb638e1d86630488247dff7a3aaa6361954029920d3cb053095fdba28d7d7a00ec386e1b7f6153c89a7478135ad44523a3cb000cba840

data/.github/workflows/release.yml

@@ -19,9 +19,7 @@ jobs:
     uses: metanorma/ci/.github/workflows/rubygems-release.yml@main
     with:
       next_version: ${{ github.event.inputs.next_version }}
-      release_command: |
-        bundle install
-        bundle exec rake release
     secrets:
       rubygems-api-key: ${{ secrets.METANORMA_CI_RUBYGEMS_API_KEY }}
       pat_token: ${{ secrets.METANORMA_CI_PAT_TOKEN }}
+

data/.gitignore

@@ -11,6 +11,7 @@
 # Bundler
 /.bundle/
 /vendor/bundle/
+/Gemfile.lock
 
 # Ruby build artifacts
 *.gem

data/Gemfile

@@ -4,8 +4,9 @@ source "https://rubygems.org"
 
 gemspec
 
+gem "logger"
 gem "lutaml-model", "~> 0.8.0"
-gem "pdfrb", path: "/Users/mulgogi/src/claricle/pdfrb"
+gem "pdfrb", github: "claricle/pdfrb", ref: "629c72a"
 gem "rake"
 gem "rspec"
 gem "rubocop"

data/TODO.pdf/01-font-metrics.md

@@ -1,5 +1,11 @@
 # TODO PDF 01: Font metrics reader
 
+## Status: DONE — Superseded by `Idml::TextEngine::PdfrbFontMetrics`, which
+delegates glyph metrics to pdfrb's `Fonts` collection. See
+`lib/idml/text_engine/pdfrb_font_metrics.rb`. (Original plan to use
+`ttfunk` directly was dropped when pdfrb 0.4.0+ exposed a typed
+Font/Fonts API.)
+
 ## Goal
 
 Read OpenType/TrueType font files and expose per-glyph advance widths

data/TODO.pdf/02-font-resolver.md

@@ -1,5 +1,10 @@
 # TODO PDF 02: Font resolver
 
+## Status: DONE — `Idml::Render::FontSetup` resolves the document default
+font from `Resources/Fonts.xml`, with `FontReferenceResolver` providing
+the family → PostScriptName lookup. Per-run resolution lives in
+`TextFrameRenderer#font_for_run`. See TODOs 33, 40, 93.
+
 ## Goal
 
 Map IDML font references (family + style) to .ttf/.otf file paths on

data/TODO.pdf/03-text-shaper.md

@@ -1,5 +1,9 @@
 # TODO PDF 03: Text shaper
 
+## Status: DONE — `Idml::TextEngine::Shaper` produces `ShapedGlyph`
+structs (codepoint, width, x/y offsets) consumed by LineBreaker.
+See `lib/idml/text_engine/shaper.rb`.
+
 ## Goal
 
 Convert a text string + font + size into a sequence of positioned

data/TODO.pdf/04-line-breaker-justifier.md

@@ -1,5 +1,9 @@
 # TODO PDF 04: Line breaker + justifier
 
+## Status: DONE — `Idml::TextEngine::LineBreaker` (greedy wrap) and
+`Idml::TextEngine::Justifier` (left/center/right/justified) live in
+`lib/idml/text_engine/{line_breaker,justifier}.rb`.
+
 ## Goal
 
 Break shaped text into lines that fit within a frame width, then

data/TODO.pdf/05-vertical-layout.md

@@ -1,5 +1,9 @@
 # TODO PDF 05: Vertical layout
 
+## Status: DONE — `Idml::TextEngine::VerticalLayout` positions lines
+within frame insets and applies leading + paragraph spacing.
+Drop caps remain a stretch goal. See `lib/idml/text_engine/vertical_layout.rb`.
+
 ## Goal
 
 Position lines vertically within a text frame: leading, paragraph

data/TODO.pdf/06-pdf-color-operators.md

@@ -1,5 +1,10 @@
 # TODO PDF 06: PDF color operators
 
+## Status: DONE — Colors route through pdfrb's Canvas (`fill_color`,
+`stroke_color`) via `Render::ColorResolver`, which converts IDML RGB /
+CMYK / Tint values to pdfrb's color tuples. See
+`lib/idml/render/color_resolver.rb`.
+
 ## Goal
 
 Map IDML color definitions (from Graphic.xml) to PDF color space

data/TODO.pdf/07-pdf-path-operators.md

@@ -1,5 +1,10 @@
 # TODO PDF 07: PDF path operators
 
+## Status: DONE — Path operators are emitted by pdfrb's Canvas
+(`rectangle`, `move_to`, `line_to`, `close_path`, `fill`, `stroke`).
+Renderer classes under `lib/idml/render/renderers/` build the calls
+from typed `PathGeometry` models.
+
 ## Goal
 
 Map IDML geometric page items (Rectangle, Polygon, GraphicLine, etc.)

data/TODO.pdf/08-pdf-text-operators.md

@@ -1,5 +1,10 @@
 # TODO PDF 08: PDF text operators
 
+## Status: DONE — `Render::TextFrameRenderer` emits text via
+`canvas.text_rich` / `canvas.text` (pdfrb wraps BT/Tf/Td/Tj/TJ).
+Per-run font selection through `font_for_run`. See
+`lib/idml/render/renderers/text_frame_renderer.rb`.
+
 ## Goal
 
 Map positioned glyphs from the text engine to PDF text-showing

data/TODO.pdf/09-image-embedding.md

@@ -1,5 +1,10 @@
 # TODO PDF 09: Image embedding
 
+## Status: DONE — `Render::ImageCollector` resolves Link `href`s and
+delegates to `PdfrbWriter#draw_image_matrix` (handles JPEG/PNG/etc.
+via pdfrb's image embedding). Missing files are silently skipped.
+See `lib/idml/render/image_collector.rb`.
+
 ## Goal
 
 Resolve IDML image links and embed them as PDF XObject images.

data/TODO.pdf/10-spread-renderer.md

@@ -1,5 +1,10 @@
 # TODO PDF 10: Spread renderer
 
+## Status: DONE — `Render::SpreadRenderer` walks each Page's items in
+z-order, dispatching via `PageItemRenderer::RENDERER_MAP`. Master items
+rendered first as background. See `lib/idml/render/spread_renderer.rb`
+and TODO 32.
+
 ## Goal
 
 Render an IDML Spread (all its page items) into a single PDF page's

data/TODO.pdf/100-character-level-styling.md

@@ -0,0 +1,61 @@
+# TODO PDF 100: Character-level styling (underline, strikethrough, caps, color)
+
+## Status: OPEN — gap identified in 2026-08-08 audit
+
+## Problem
+
+`Elements::CharacterStyleRange` carries 284 character-level
+attributes from the RNC. `StyleResolver::StyledRun` extracts only:
+`text`, `font_style`, `point_size`, `fill_color`, `fill_tint`,
+`applied_font`, `alignment`.
+
+Untyped into the renderer (but modeled on CSR):
+
+| Attribute         | Visual effect                                  |
+|-------------------|------------------------------------------------|
+| `Underline`       | underline rule under glyphs                    |
+| `UnderlineOffset`, `UnderlineWeight`, `UnderlineTint`, `UnderlineColor` | fine underline control |
+| `StrikeThru`      | strike-through rule through glyphs             |
+| `StrikeThruOffset`, `StrikeThruWeight`, etc. | fine strike control |
+| `Capitalization`  | AllCaps / SmallCaps / Title                    |
+| `Position`        | Superscript / Subscript                        |
+| `HorizontalScale`, `VerticalScale` | glyph scaling                   |
+| `BaselineShift`   | vertical offset from baseline                  |
+| `Skew`            | synthetic italic (glyph shear)                 |
+| `Tracking`        | inter-letter spacing offset                    |
+| `FillColor` / `FillTint` | text color (currently extracted but unused) |
+| `StrokeColor` / `StrokeWeight` | text outline                       |
+| `Ligatures`       | enable OpenType ligatures                      |
+| `KerningMethod`   | metrics vs optical kerning                     |
+
+Today the renderer emits a single `canvas.text` per line with a
+single font + size — no underline, no strike, no color, no scaling.
+
+## What needs to happen
+
+1. Extend `StyledRun` to carry these character-level attributes.
+2. After emitting each line's text, optionally:
+   - Draw underline rule (`canvas.line` from start-x to start-x+width
+     at baseline - underline_offset, with underline_weight).
+   - Draw strike-through rule (similar, at baseline + offset).
+3. Apply capitalization by uppercasing the text (or using SmallCaps
+   OpenType feature when supported by the font).
+4. Apply Position (super/subscript) by scaling the font size and
+   shifting baseline.
+5. Apply HorizontalScale / VerticalScale via canvas text matrix
+   (`canvas.text` may need to be augmented, or emit raw cm + Tm).
+6. Apply text fill color via `canvas.fill_color` before `canvas.text`.
+7. Apply Tracking by inserting extra width per glyph (Shaper level).
+
+## Acceptance criteria
+
+- [ ] CSR with Underline=true draws a rule under each glyph in the run.
+- [ ] CSR with Capitalization="AllCaps" uppercases the text.
+- [ ] CSR with Position="Superscript" raises the baseline and shrinks size.
+- [ ] CSR with FillColor="Color/Red" renders red text.
+- [ ] CSR with HorizontalScale=150 widens glyphs by 50%.
+
+## Dependencies
+
+- TODO 94 (VerticalLayout delegation positions glyphs).
+- pdfrb may need text-matrix helpers for skew/scale.

data/TODO.pdf/101-paragraph-rules-borders.md

@@ -0,0 +1,38 @@
+# TODO PDF 101: Paragraph borders and rules (RuleAbove, RuleBelow, ParagraphBorder)
+
+## Status: OPEN — gap identified in 2026-08-08 audit
+
+## Problem
+
+`ParagraphStyleRange` carries:
+
+- `RuleAbove`, `RuleAboveLineWeight`, `RuleAboveTint`, `RuleAboveOffset`,
+  `RuleAboveLeftIndent`, `RuleAboveRightIndent`, `RuleAboveWidth`
+- `RuleBelow`, `RuleBelowLineWeight`, `RuleBelowTint`, `RuleBelowOffset`,
+  `RuleBelowLeftIndent`, `RuleBelowRightIndent`, `RuleBelowWidth`
+- `ParagraphBorderOn`, `ParagraphBorderTopLineWeight`,
+  `ParagraphBorderLeftLineWeight`, etc.
+- `ParagraphShadingOn`, `ParagraphShadingTint`, `ParagraphShadingColor`
+
+None of these are rendered today. Real-world documents use RuleAbove
+heavily for headings ("section divider line"), and ParagraphShading
+for callouts.
+
+## What needs to happen
+
+1. After laying out a paragraph, emit RuleAbove as a horizontal line
+   above the first line, with the rule's weight/tint/color/offset/indent.
+2. Emit RuleBelow similarly below the last line.
+3. Optionally emit ParagraphBorder as a rectangle around the paragraph.
+4. Optionally emit ParagraphShading as a fill behind the paragraph.
+
+## Acceptance criteria
+
+- [ ] PSR with RuleAbove=true and RuleAboveLineWeight=2 draws a 2pt
+      horizontal line above the paragraph.
+- [ ] PSR with RuleAboveOffset=4 leaves 4pt gap between rule and text.
+- [ ] PSR with ParagraphShadingOn=true and tint fills the paragraph rect.
+
+## Dependencies
+
+- TODO 94 (VerticalLayout knows the paragraph's rect).

data/TODO.pdf/102-anchored-objects.md

@@ -0,0 +1,41 @@
+# TODO PDF 102: Anchored objects (anchored object settings)
+
+## Status: OPEN — gap identified in 2026-08-08 audit
+
+## Problem
+
+`Elements::AnchoredObjectSetting` is modeled with the standard
+attributes (AnchorSpot, AnchorXunit, AnchorYunit, AnchorPoint,
+AnchorSpaceBefore, etc.). The renderer doesn't consult it.
+
+In IDML, an anchored object is a page item (Rectangle, Polygon,
+Group) that's "anchored" to a position within a story's text flow.
+When the text reflows, the anchored object moves with it. Today
+the renderer treats anchored objects as standalone page items in
+the Spread — they appear at their spread coordinates, not their
+anchored position.
+
+## What needs to happen
+
+1. Detect when a page item has an `AnchoredObjectSetting` child
+   with `AnchorType` indicating inline/anchored (vs. inline-only
+   or floating).
+2. For anchored items, suppress standalone rendering in the spread.
+3. When laying out the story that owns the anchored object, reserve
+   space at the anchor point and render the item there.
+
+This is a significant feature — anchored objects are common in
+real-world documents but rare in test fixtures.
+
+## Acceptance criteria
+
+- [ ] Page item with AnchoredObjectSetting AnchorType="Inline" renders
+      at the anchor character's position within the text flow.
+- [ ] Page item with AnchorType="Above Line" renders above the line
+      containing the anchor.
+- [ ] Page item with AnchorType="Anchored" renders at the absolute
+      position derived from AnchorXunit / AnchorYunit.
+
+## Dependencies
+
+- TODO 94 (need to know character positions in the text flow).

data/TODO.pdf/103-drop-caps.md

@@ -0,0 +1,33 @@
+# TODO PDF 103: Drop caps (DropCapLines, DropCapCharacters)
+
+## Status: OPEN — gap identified in 2026-08-08 audit
+
+## Problem
+
+`ParagraphStyleRange` carries:
+
+- `DropCapLines` (integer) — number of lines the drop cap spans
+- `DropCapCharacters` (integer) — number of characters in the drop cap
+- `DropcapDetail` (integer) — bitmap of effects
+
+The renderer ignores these. Documents that use drop caps (very
+common in magazine/book layouts) currently render with no drop cap.
+
+## What needs to happen
+
+1. When `DropCapCharacters > 0` and `DropCapLines > 1`, treat the
+   first `DropCapCharacters` characters as a drop cap:
+   - Increase their font size to `DropCapLines × line_height`.
+   - Wrap subsequent lines around the drop cap's width.
+2. This requires the layout to track the drop-cap region and
+   indent lines 1..DropCapLines on the left.
+
+## Acceptance criteria
+
+- [ ] PSR with DropCapLines=3, DropCapCharacters=1 renders the first
+      character at 3× line height.
+- [ ] Lines 2 and 3 are indented right by the drop cap's width.
+
+## Dependencies
+
+- TODO 94 (VerticalLayout needs to support drop-cap regions).

data/TODO.pdf/104-table-schema-completion.md

@@ -0,0 +1,44 @@
+# TODO PDF 104: Schema-faithful Table model completion
+
+## Status: OPEN — gap identified in 2026-08-08 audit
+
+## Problem
+
+`Elements::Table` was added (TODO 84) as a schema-faithful model,
+but the audit shows several Table-level attributes from
+`Table_Object` in the RNC are missing from the model:
+
+- `TableDirection` (LTR / RTL)
+- `TableDrawingOrder`
+- `TableFlavor`
+- `Spacing` (cell spacing)
+- `StrokeOrder` (row-then-col vs col-then-row)
+- `TopBorderWeight`, `LeftBorderWeight`, etc. (table outer border)
+- `ColumnCount`, `BodyRowCount`, `HeaderRowCount`, `FooterRowCount`
+- `TableStride` (column stride for spanning)
+- `SkipHeader` / `SkipFooter` (alternating-page behavior)
+- `TableLocked` / `TableResizePreference`
+- `AppliedTableStyle`
+
+The renderer can't emit correct outer borders or honor table-level
+direction without these attributes being modeled.
+
+## What needs to happen
+
+1. Generate the missing attributes from `Table_Object` in
+   `reference-docs/schemas/package/Stories/Story.rnc` via
+   `scripts/rnc_to_lutaml.rb`.
+2. Add `column_attributes` child collection.
+3. Add specs asserting the full attribute set against the RNC.
+
+## Acceptance criteria
+
+- [ ] Every attribute listed in `Table_Object` in Story.rnc is
+      declared on `Elements::Table`.
+- [ ] Round-trip: parse fixture Spread, re-serialize, equivalent.
+- [ ] Renderer can read `column_count`, `body_row_count`,
+      `header_row_count`, etc. for layout.
+
+## Dependencies
+
+- TODOs 97, 98, 99 (cell fidelity / spans / column widths).

data/TODO.pdf/105-whole-package-round-trip.md

@@ -0,0 +1,45 @@
+# TODO PDF 105: Whole-package round-trip suite (byte-equivalent)
+
+## Status: OPEN — gap identified in 2026-08-08 audit
+
+## Problem
+
+CLAUDE.md states:
+
+> The gold standard is whole-package round-trip: unzip a fixture
+> `.idml`, rebuild every part, rezipping, and assert byte-equivalence
+> part-by-part (the `mimetype` member must remain stored/uncompressed
+> and first in the archive).
+
+Today there are round-trip specs for individual element classes
+and per-part parse/serialize, but no spec that takes a complete
+`.idml` fixture, rebuilds every part, rezips, and asserts
+byte-equivalence.
+
+The `sample-with-image` fixture is the canonical DOMVersion 21.5
+fixture (validated clean against all 14 part schemas), so it's the
+right target for this spec.
+
+## What needs to happen
+
+1. New spec `spec/idml/package/round_trip_spec.rb`:
+   - Open `spec/fixtures/sample-with-image/sample-with-image.idml`.
+   - For each part in the package, parse via the typed Parts class
+     and re-serialize.
+   - Assert each re-serialized part is XML-equivalent to the original
+     (canonicalize attribute order, whitespace).
+2. Re-zip the package into a temporary file.
+3. Assert: `mimetype` is the first entry and stored uncompressed
+   (`Zip::Entry::STORED`).
+4. Assert: every other entry matches the original byte-for-byte
+   after normalization.
+
+## Acceptance criteria
+
+- [ ] All 14 parts of `sample-with-image.idml` round-trip XML-equivalent.
+- [ ] Re-zipped package has `mimetype` first and stored.
+- [ ] Spec covers both `sample-with-image` and `sample-with-table-more`.
+
+## Dependencies
+
+- None — exercises existing typed parts.

data/TODO.pdf/106-page-item-type-coverage.md

@@ -0,0 +1,62 @@
+# TODO PDF 106: Page-item type coverage — Ellipse, Path, EPS, WMF, PICT, HtmlItem
+
+## Status: OPEN — gap identified in 2026-08-08 audit
+
+## Problem
+
+The IDML Spread schema (`reference-docs/schemas/package/Spreads/Spread.rnc`)
+defines many page-item types. Today the codebase models and renders
+six:
+
+| Modeled & rendered | Notes |
+|---|---|
+| `Rectangle` | full support |
+| `TextFrame` | full support |
+| `Polygon` | full support |
+| `GraphicLine` | full support |
+| `Group` | full support |
+| `Table` | full support (story-embedded) |
+
+Schema types that are NOT modeled or NOT rendered:
+
+| Type | Used for | Status |
+|---|---|---|
+| `Ellipse` | Circular/elliptical shapes | Not modeled in SpreadObject children, no renderer |
+| `Image_Object` | Placed raster images | Handled via `ImageCollector` separately; not in RENDERER_MAP |
+| `EPS_Object` | Placed EPS files | Not modeled, not rendered |
+| `WMF_Object` | Windows Metafile (legacy) | Not modeled, not rendered |
+| `PICT_Object` | Mac PICT (legacy) | Not modeled, not rendered |
+| `Path_Object` | Compound paths (multi-path shapes) | Not modeled |
+| `HtmlItem_Object` | Embedded HTML (InDesign 19+) | Not modeled, not rendered |
+| `Movie_Object`, `Sound_Object` | Media placeholders | Not modeled, not rendered |
+| `FormField_Object`, `SignatureField_Object` | Interactive forms | Not modeled, not rendered |
+
+## What needs to happen (priorities)
+
+1. **Ellipse** — model in `Elements::Ellipse` (very similar to Polygon;
+   just emit a polygon with many vertices, or use pdfrb's circle if it
+   exists). Add to SpreadObject children and RENDERER_MAP.
+2. **Image in RENDERER_MAP** — today images are extracted via
+   `ImageCollector` (regex-free, model-driven) but rendered in a
+   separate code path. Unify so the dispatcher sees Image like any
+   other page item.
+3. **EPS** — model `Elements::EPS`. For rendering, either:
+   - Embed the EPS as a PostScript XObject (PDF supports this), or
+   - Rasterize to PNG and embed (requires external tool).
+4. **Path** — model `Elements::Path` (compound shape). Renderer emits
+   multiple sub-paths within one `m..l..h` sequence.
+5. **HtmlItem** — out of scope for v1 (requires HTML rendering engine).
+6. **Movie/Sound/FormField** — out of scope for v1 (interactive elements).
+
+## Acceptance criteria
+
+- [ ] SpreadObject has `ellipse` collection.
+- [ ] `EllipseRenderer` registered in RENDERER_MAP.
+- [ ] Image page items (when present as Spread children) render via the
+      standard PageItemRenderer dispatch path.
+- [ ] EPS files embedded as PostScript XObjects (or skipped with a warning).
+- [ ] Compound Path objects render with multiple sub-paths.
+
+## Dependencies
+
+- None — independent feature work.

data/TODO.pdf/107-image-rendering-unification.md

@@ -0,0 +1,42 @@
+# TODO PDF 107: Image rendering unification via PageItemRenderer
+
+## Status: OPEN — gap identified in 2026-08-08 audit
+
+## Problem
+
+Today images flow through a separate code path:
+
+1. `Pipeline#render_spread` calls `ImageCollector.new(...).collect(spread)`
+   to gather all image refs *before* rendering.
+2. `SpreadRenderer#render_images` emits each image as a flat layer at
+   the start of the page (before any shapes/text).
+3. `Rectangle` (etc.) renderers don't know about images embedded in
+   them — they just render the shape, and the image falls through
+   separately.
+
+The IDML model has `Image_Object` as a first-class page item that
+can appear:
+- Directly in Spread children
+- As a child of Rectangle (graphic content placed in a frame)
+- As a child of Polygon (graphic content in a non-rectangular frame)
+- As a child of Group
+
+## What needs to happen
+
+1. Register `ImageRenderer` in `PageItemRenderer::RENDERER_MAP`.
+2. Move image rendering from `SpreadRenderer#render_images` to the
+   standard dispatch — images render in z-order with other page items.
+3. When a Rectangle/Polygon/Group has an Image child, render the image
+   *clipped to the parent's PathGeometry* — that's the InDesign behavior.
+4. Deprecate `ImageCollector` once the model-driven path is complete.
+
+## Acceptance criteria
+
+- [ ] Image as a direct Spread child renders via RENDERER_MAP dispatch.
+- [ ] Image inside a Rectangle renders clipped to the Rectangle's bounds.
+- [ ] Z-order preserved — later items render on top of earlier items.
+- [ ] Existing image specs pass via the new code path.
+
+## Dependencies
+
+- TODO 106 (page-item type coverage).

data/TODO.pdf/11-font-embedding.md

@@ -1,5 +1,11 @@
 # TODO PDF 11: Font embedding
 
+## Status: DONE — `FontSetup#register` loads the document font via
+`PdfrbWriter#register_font` (passes `File.open(path, "rb")` as IO).
+Subsetting happens via `PdfrbWriter#subset_fonts!`. See
+`lib/idml/render/font_setup.rb`, `lib/idml/render/pdfrb_writer.rb`,
+and TODOs 52, 62, 65.
+
 ## Goal
 
 Embed font subsets in the output PDF so the rendered text is

data/TODO.pdf/12-idml-to-pdf-pipeline.md

@@ -1,5 +1,11 @@
 # TODO PDF 12: IDML → PDF pipeline
 
+## Status: DONE — `Render::Pipeline` orchestrates Package → PDF:
+metadata, fonts, spreads, hyperlinks, structure, bookmarks, subsetting.
+`Idml::Render.render(package:, to:, ...)` and `idml render` CLI both
+delegate here. See `lib/idml/render/pipeline.rb`, `lib/idml/render.rb`,
+`lib/idml/cli.rb`, and TODOs 25, 64, 83.
+
 ## Goal
 
 Top-level pipeline: `Idml::Package` → `Pdfrb::Document` → PDF file.

data/TODO.pdf/13-cjk-text-layout.md

@@ -1,5 +1,10 @@
 # TODO PDF 13: CJK text layout
 
+## Status: PARTIAL — `Idml::TextEngine::CjkLayout` handles CJK glyph
+measurement and basic horizontal layout. Vertical writing mode,
+kinsoku shori, tate-chu-yoko, and ruby remain stretch goals as
+flagged in the original TODO. See `lib/idml/text_engine/cjk_layout.rb`.
+
 ## Goal
 
 Extend the text engine to handle CJK (Chinese, Japanese, Korean)

data/TODO.pdf/14-page-item-element-models.md

@@ -1,5 +1,10 @@
 # TODO PDF 14: Page-item element models
 
+## Status: DONE — `Idml::Elements::{Page,Rectangle,TextFrame,Image,Link,
+Polygon,Group,GraphicLine}` all carry attributes from the RNC and are
+registered under `Idml::Elements`. Round-trip and attribute-set specs
+live under `spec/idml/elements/`.
+
 ## Goal
 
 Create typed `Lutaml::Model::Serializable` subclasses for every page-item

data/TODO.pdf/15-wire-spread-children.md

@@ -1,5 +1,10 @@
 # TODO PDF 15: Wire SpreadObject child elements
 
+## Status: DONE — `Idml::Elements::SpreadObject` declares typed child
+collections and uses `ordered` mapping. `Idml::Parts::Spread#each_page_item`
+yields every page item in document order. See
+`lib/idml/elements/spread_object.rb`, `lib/idml/parts/spread.rb`.
+
 ## Goal
 
 Extend `Idml::Elements::SpreadObject` to expose its child page items as

data/TODO.pdf/16-typed-model-pipeline.md

@@ -1,5 +1,10 @@
 # TODO PDF 16: Typed-model rendering pipeline
 
+## Status: DONE — Pipeline iterates `package.spreads` (typed
+`Parts::Spread`) and dispatches via `PageItemRenderer::RENDERER_MAP`.
+No raw XML / regex in the render path. See TODOs 26, 83 and
+`lib/idml/render/pipeline.rb`.
+
 ## Goal
 
 Replace the regex-based image extraction and hardcoded page dimensions

data/TODO.pdf/17-shape-rendering.md

@@ -1,5 +1,10 @@
 # TODO PDF 17: Shape rendering
 
+## Status: DONE — `RectangleRenderer`, `PolygonRenderer`,
+`GraphicLineRenderer` register in `PageItemRenderer::RENDERER_MAP`
+and call pdfrb Canvas path operators. Colors via `ColorResolver`.
+See `lib/idml/render/renderers/` and TODOs 26, 30.
+
 ## Goal
 
 Render IDML page-item shapes (Rectangle, Polygon, GraphicLine, Ellipse)

data/TODO.pdf/18-text-rendering.md

@@ -1,5 +1,10 @@
 # TODO PDF 18: Text rendering from stories
 
+## Status: DONE — `TextFrameRenderer` resolves `ParentStory` via
+`Package#story_by_id`, walks PSR → CSR → Content, and renders styled
+runs through the text engine. See
+`lib/idml/render/renderers/text_frame_renderer.rb` and TODOs 27, 67.
+
 ## Goal
 
 Wire the text engine to actual IDML story content. Extract text from

data/TODO.pdf/19-page-dimensions.md

@@ -1,5 +1,9 @@
 # TODO PDF 19: Page dimensions from IDML
 
+## Status: DONE — `Pipeline#page_dimensions_for` reads `Page#width` /
+`Page#height` (falling back to US Letter) and passes them to
+`writer.add_page`. See `lib/idml/render/pipeline.rb`.
+
 ## Goal
 
 Derive PDF page width and height from the IDML document's Page element

data/TODO.pdf/20-png-image-support.md

@@ -1,5 +1,9 @@
 # TODO PDF 20: PNG image support
 
+## Status: DONE — pdfrb's `Canvas#draw_image_matrix` handles JPEG, PNG,
+and other formats natively (image-type detection is internal to pdfrb).
+No format-specific code needed in idml.
+
 ## Goal
 
 Extend image embedding to support PNG files in addition to JPEG.