idml 0.1.0

data/TODO.pdf/41-graphic-line-rendering.md

@@ -0,0 +1,20 @@
+# TODO PDF 41: GraphicLine rendering
+
+## Goal
+
+Implement `GraphicLineRenderer` to render IDML `<GraphicLine>` elements as
+stroked PDF paths using PathPointArray vertices.
+
+## Acceptance criteria
+
+- [ ] GraphicLineRenderer emits `m` (move) + `l` (line-to) operators.
+- [ ] StrokeColor resolved via ColorResolver.
+- [ ] StrokeWeight applied via `Path.stroke_width`.
+- [ ] ItemTransform applied to path coordinates.
+- [ ] Y-axis flip via `Geometry.bounds_to_pdf_rect`.
+- [ ] Spec: render a GraphicLine with known endpoints, verify `m`/`l`/`S` in PDF.
+
+## Dependencies
+
+- TODO 28 (PathGeometry models).
+- TODO 31 (stroke rendering).

data/TODO.pdf/42-group-transform-application.md

@@ -0,0 +1,17 @@
+# TODO PDF 42: Group transform application
+
+## Goal
+
+Apply a Group's ItemTransform to all child page items during rendering.
+Currently GroupRenderer renders children without the Group's transform.
+
+## Acceptance criteria
+
+- [ ] GroupRenderer applies Group#item_transform via `cm` operator.
+- [ ] Child items rendered within the transformed coordinate space.
+- [ ] Nested groups (Group within Group) handled recursively.
+- [ ] Spec: render a Group with offset transform, verify children shift.
+
+## Dependencies
+
+- TODO 26 (renderer registry).

data/TODO.pdf/43-text-frame-insets.md

@@ -0,0 +1,17 @@
+# TODO PDF 43: Text frame insets
+
+## Goal
+
+Respect `TextFramePreference` inset margins (InsetTop, InsetLeft,
+InsetBottom, InsetRight) when laying out text within a TextFrame.
+
+## Acceptance criteria
+
+- [ ] TextFramePreference model has inset attributes (add if missing).
+- [ ] TextFrame exposes `text_frame_preference` child.
+- [ ] TextFrameRenderer subtracts insets from frame bounds before layout.
+- [ ] Spec: TextFrame with InsetTop=20, verify text starts 20pt below frame top.
+
+## Dependencies
+
+- TODO 27 (text engine integration).

data/TODO.pdf/44-layer-support.md

@@ -0,0 +1,20 @@
+# TODO PDF 44: Layer support
+
+## Goal
+
+Parse Layer definitions from designmap.xml. Each page item's
+`ItemLayer` attribute determines visibility. Items on hidden layers
+are skipped during rendering.
+
+## Acceptance criteria
+
+- [ ] `Idml::Elements::Layer` model with Self, Name, Visible, Locked attrs.
+- [ ] Designmap has `layer` collection attribute.
+- [ ] Pipeline passes layer visibility map to SpreadRenderer.
+- [ ] Page items with `ItemLayer` referencing a hidden layer are skipped.
+- [ ] Items without ItemLayer are always rendered.
+- [ ] Spec: hide a layer, verify its items absent from PDF.
+
+## Dependencies
+
+- TODO 16 (typed-model pipeline).

data/TODO.pdf/45-image-clipping.md

@@ -0,0 +1,17 @@
+# TODO PDF 45: Image clipping
+
+## Goal
+
+Clip placed images to their parent Rectangle's bounds. Currently
+images can overflow the containing frame.
+
+## Acceptance criteria
+
+- [ ] PdfWriter supports clip paths (W/W* operators in content stream).
+- [ ] ImageRenderer emits clip path before drawing image.
+- [ ] Clip path derived from parent Rectangle's PathGeometry.
+- [ ] Spec: image inside a small Rectangle, verify clip operators present.
+
+## Dependencies
+
+- TODO 28 (PathGeometry).

data/TODO.pdf/46-spread-to-page-separation.md

@@ -0,0 +1,19 @@
+# TODO PDF 46: Spread-to-page separation
+
+## Goal
+
+Render each IDML Page as a separate PDF page (currently one PDF page
+per spread). Multi-page spreads produce multiple PDF pages.
+
+## Acceptance criteria
+
+- [ ] Pipeline iterates Pages within each Spread.
+- [ ] Each Page gets its own `writer.add_page` with correct dimensions.
+- [ ] Page items clipped/translated to page-local coordinates.
+- [ ] Master spread items rendered per-page (respecting AppliedMaster).
+- [ ] Spec: 2-page spread produces 2 PDF pages.
+
+## Dependencies
+
+- TODO 19 (page dimensions).
+- TODO 32 (master spread rendering).

data/TODO.pdf/47-pdf-bookmarks.md

@@ -0,0 +1,17 @@
+# TODO PDF 47: PDF bookmarks/outlines
+
+## Goal
+
+Generate PDF outline (bookmark) entries from the document's XML
+structure or heading paragraph styles.
+
+## Acceptance criteria
+
+- [ ] PdfWriter builds an Outlines tree referenced from Catalog.
+- [ ] Outline entries link to page destinations.
+- [ ] Pipeline extracts headings from ParagraphStyleRange with heading styles.
+- [ ] Spec: PDF with 3 chapters, verify 3 outline entries.
+
+## Dependencies
+
+- TODO 35 (PDF metadata).

data/TODO.pdf/48-table-rendering.md

@@ -0,0 +1,20 @@
+# TODO PDF 48: Table rendering
+
+## Goal
+
+Render IDML tables (TableRow, TableCell elements within Stories) as
+PDF table structures with cell borders, backgrounds, and inline text.
+
+## Acceptance criteria
+
+- [ ] Table, TableRow, TableCell element models from RNC.
+- [ ] TableRenderer computes cell positions from column/row definitions.
+- [ ] Cell borders rendered as stroked rectangles.
+- [ ] Cell backgrounds rendered as filled rectangles.
+- [ ] Cell text rendered via TextFrameRenderer logic.
+- [ ] Spec: render a 2x2 table, verify 4 cells with borders.
+
+## Dependencies
+
+- TODO 18 (text rendering).
+- TODO 30 (shape geometry).

data/TODO.pdf/49-gradient-fill-rendering.md

@@ -0,0 +1,20 @@
+# TODO PDF 49: Gradient fill rendering
+
+## Goal
+
+Render gradient fills on page items. IDML supports linear and radial
+gradients via GradientStop entries in Resources/Graphic.xml.
+
+## Acceptance criteria
+
+- [ ] PdfWriter supports shading patterns (Type 2/3).
+- [ ] GradientResolver maps Gradient + GradientStop entries to PDF shading.
+- [ ] RectangleRenderer/PolygonRenderer emit gradient fill when FillColor
+      references a Gradient.
+- [ ] Linear and radial gradient types supported.
+- [ ] Spec: render a Rectangle with linear gradient, verify shading dictionary.
+
+## Dependencies
+
+- TODO 22 (ColorResolver).
+- TODO 30 (shape geometry).

data/TODO.pdf/50-pdf-a-compliance.md

@@ -0,0 +1,21 @@
+# TODO PDF 50: PDF/A compliance mode
+
+## Goal
+
+Add a `--pdf-a` option that produces PDF/A-1a, PDF/A-2a, or PDF/A-3a
+compliant output. Requires: all fonts embedded, ICC profiles, tagged
+content, XMP metadata, no encryption.
+
+## Acceptance criteria
+
+- [ ] Pipeline accepts a `compliance:` option (:pdfa1a, :pdfa2a, :pdfa3a).
+- [ ] All fonts force-embedded (no Type1 base-14 fallback).
+- [ ] ICC color profile embedded (sRGB for screen, FOGRA39 for print).
+- [ ] XMP metadata packet in the PDF.
+- [ ] Tagged content for accessibility (StructTreeRoot).
+- [ ] Spec: produce a PDF/A-2a file, verify structure markers.
+
+## Dependencies
+
+- TODO 11 (font embedding).
+- TODO 35 (PDF metadata).

data/TODO.pdf/51-remove-dead-code.md

@@ -0,0 +1,41 @@
+# TODO PDF 51: Remove dead code from pdfrb migration
+
+## Goal
+
+Remove the old hand-rolled PDF modules that are superseded by pdfrb.
+These modules are dead code — not referenced by any active code path.
+
+## Status: READY FOR CLEANUP
+
+## What to remove
+
+- `lib/idml/render/pdf_writer.rb` — old hand-rolled PDF assembly (350+ lines)
+- `lib/idml/render/font_embedder.rb` — old WinAnsiEncoding Widths builder
+- `lib/idml/render/color.rb` — old PDF color operator string generators
+- `lib/idml/render/path.rb` — old PDF path operator string generators
+- `lib/idml/render/text.rb` — old PDF text operator string generators
+- Dead methods in `image.rb`: `draw_image`, `extract_from_spread`,
+  `enclosing_transform` (regex-based extraction replaced by typed models)
+
+## What to keep
+
+- `lib/idml/render/image.rb` utility functions: `resolve_path`,
+  `detect_format`, `jpeg_dimensions/colorspace`, `png_dimensions/colorspace`,
+  `png_idat_data`, `parse_transform`, `compute_placement`, `combine`,
+  `Transform`, `identity` — all still used by Pipeline
+- `lib/idml/render/color_helper.rb` — converts ColorResolver hashes to
+  pdfrb Canvas color arrays
+- All pdfrb-based code: `pdfrb_writer.rb`, `pdfrb_ext/`, renderers
+
+## Test cleanup
+
+- Remove `spec/idml/render/render_spec.rb` describe blocks for Color,
+  Path, Text, PdfWriter (keep Pipeline describe block)
+- Remove `spec/idml/render/font_embedder_spec.rb` entirely
+- Remove dead-method tests from `spec/idml/render/image_spec.rb`
+  (`extract_from_spread`, `draw_image` tests)
+- Update `render.rb` autoloads to remove old modules
+
+## Dependencies
+
+- pdfrb migration must be complete (DONE).

data/TODO.pdf/52-font-subsetting.md

@@ -0,0 +1,22 @@
+# TODO PDF 52: Font subsetting via pdfrb
+
+## Goal
+
+Subset embedded TrueType fonts to include only the glyphs actually used
+in the document. This dramatically reduces PDF file size (from full font
+~500KB to subset ~5-20KB per font).
+
+## Acceptance criteria
+
+- [ ] Pipeline collects all Unicode codepoints used across all stories.
+- [ ] For each embedded font, only the used glyphs are included.
+- [ ] FontFile2 contains a subsetted font table (not the full font).
+- [ ] PDF file size significantly reduced vs full-font embedding.
+- [ ] Spec: render text with known characters, verify embedded font
+      contains only those glyphs.
+
+## Dependencies
+
+- pdfrb font embedding support (partial — font registration works,
+  FontFile2 embedding may require pdfrb enhancement).
+- TODO 27 (text engine for glyph collection).

data/TODO.pdf/53-tagged-pdf-accessibility.md

@@ -0,0 +1,24 @@
+# TODO PDF 53: Tagged PDF for accessibility
+
+## Goal
+
+Produce tagged PDF (PDF/UA) with a structure tree that maps page items
+to logical structure elements (headings, paragraphs, figures, tables).
+This enables screen readers and assistive technology to navigate the
+document.
+
+## Acceptance criteria
+
+- [ ] PdfWriter (or PdfrbWriter) builds a StructTreeRoot.
+- [ ] Each TextFrame maps to a paragraph or heading structure element.
+- [ ] Each Image maps to a figure structure element.
+- [ ] Each Table maps to a table structure element with TR/TH/TD children.
+- [ ] Structure elements have Alt text (from IDML XMLElement names).
+- [ ] Marked-content sequences (BMC/EMC) wrap content in the content stream.
+- [ ] Catalog references /MarkInfo and /StructTreeRoot.
+- [ ] Spec: produce a tagged PDF, verify StructTreeRoot exists.
+
+## Dependencies
+
+- pdfrb structure tree support.
+- TODO 48 (table rendering).

data/TODO.pdf/54-pdfrb-pipeline-specs.md

@@ -0,0 +1,27 @@
+# TODO PDF 54: pdfrb pipeline comprehensive specs
+
+## Goal
+
+Comprehensive specs covering every aspect of the pdfrb-based rendering
+pipeline: valid PDF structure, image embedding, page dimensions,
+metadata, text rendering, shape rendering, font registration, and
+structural validation (xref, object/endobj balance, trailer).
+
+## Status: DONE
+
+## What was implemented
+
+13 integration specs in `spec/idml/render/pdfrb_pipeline_spec.rb`:
+- Valid PDF with pdfrb (header, trailer, Catalog, Pages, Page)
+- JPEG image embedding (DCTDecode, Do operator)
+- Correct MediaBox per page (612×792 from IDML Page GeometricBounds)
+- Producer metadata ("idml gem v{VERSION}")
+- CreationDate in PDF date format (D:YYYYMMDDHHMMSS)
+- Text content rendering (BT/Tf/Tj/ET operators)
+- Shape rendering (rectangle/fill operators)
+- Font registration from Fonts.xml (/Font, /BaseFont)
+- One PDF page per IDML page count
+- xref section validation
+- Trailer Root reference
+- Object/endobj balance
+- Pages tree kid count

data/TODO.pdf/55-dead-code-deprecation.md

@@ -0,0 +1,30 @@
+# TODO PDF 55: Dead code deprecation markers
+
+## Goal
+
+Mark old hand-rolled modules as deprecated. These modules are
+superseded by pdfrb but cannot be deleted per the project's
+"never delete source files" policy. Add deprecation comments and
+update autoloads to lazy-load only when explicitly referenced.
+
+## Modules to deprecate
+
+- `Idml::Render::PdfWriter` — replaced by `PdfrbWriter`
+- `Idml::Render::FontEmbedder` — replaced by `PdfrbWriter.register_font`
+- `Idml::Render::Color` — replaced by `ColorHelper` + Canvas fill_color
+- `Idml::Render::Path` — replaced by Canvas drawing methods
+- `Idml::Render::Text` — replaced by Canvas text method
+
+## Acceptance criteria
+
+- [ ] Each deprecated module has a `# DEPRECATED` header comment pointing
+      to its pdfrb replacement.
+- [ ] No active code path (Pipeline, SpreadRenderer, renderers) references
+      deprecated modules.
+- [ ] Tests for deprecated modules are tagged with `:deprecated` or
+      moved to a separate spec file.
+- [ ] `render.rb` autoloads keep the old modules for backward compatibility.
+
+## Dependencies
+
+- pdfrb migration (DONE).

data/TODO.pdf/56-text-engine-pdfrb-integration.md

@@ -0,0 +1,33 @@
+# TODO PDF 56: Text engine full integration with pdfrb Canvas
+
+## Goal
+
+Re-integrate the text engine (Shaper → LineBreaker → Justifier →
+VerticalLayout) into TextFrameRenderer using pdfrb Canvas. Each line
+of shaped/broken text is emitted as a separate `canvas.text` call
+at the computed baseline position.
+
+## Status: DONE
+
+## What was implemented
+
+TextFrameRenderer has two rendering paths:
+1. **engine_render** (when FontMetrics available): shapes text via
+   Shaper, breaks lines via LineBreaker at frame width, positions
+   each line at decreasing baseline_y, emits `canvas.text` per line.
+   Lines beyond frame bottom are skipped.
+2. **simple_render** (fallback): one `canvas.text` per styled run at
+   sequential y positions.
+
+The FontMetrics comes from `context.font_resolver.resolve(family_name:)`.
+On systems where the default font is available as .ttf (not .ttc), the
+text engine provides proper word-wrap.
+
+## Acceptance criteria
+
+- [x] TextFrameRenderer tries FontResolver for metrics.
+- [x] When metrics available: Shaper → LineBreaker → per-line canvas.text.
+- [x] When metrics unavailable: simple one-text-per-run fallback.
+- [x] Frame bounds respected (lines beyond frame bottom skipped).
+- [x] Chain head check prevents duplicate text in overflow frames.
+- [x] Text frame insets subtracted from frame box.

data/TODO.pdf/57-image-clipping-pdfrb.md

@@ -0,0 +1,26 @@
+# TODO PDF 57: Image clipping via pdfrb Canvas
+
+## Goal
+
+Clip placed images to their parent Rectangle's bounds using PDF clip
+paths. Prevents image overflow beyond the containing frame.
+
+## Status: DONE
+
+## What was implemented
+
+- `PdfrbExt::Clip` (PDF `W` operator) and `PdfrbExt::EndPath` (PDF `n`
+  operator) registered as pdfrb Content::Operator subclasses.
+- `SpreadRenderer#apply_image_clip` emits a clip path from the parent
+  Rectangle's geometric_bounds before drawing the image.
+- `Pipeline#parent_clip_box` computes the clip rectangle from the
+  parent page item's bounds via Geometry helpers.
+- Image refs now carry a `clip_box` field; when present, the SpreadRenderer
+  clips before drawing.
+
+## Acceptance criteria
+
+- [x] PdfrbExt::Clip and EndPath operators registered.
+- [x] SpreadRenderer applies clip path when clip_box is present.
+- [x] Pipeline computes clip_box from parent geometric_bounds.
+- [x] All tests pass.

data/TODO.pdf/58-bookmarks-pdfrb.md

@@ -0,0 +1,23 @@
+# TODO PDF 58: PDF bookmarks via pdfrb outline API
+
+## Goal
+
+Generate PDF bookmark (outline) entries using pdfrb's outline API.
+Each bookmark links to a page destination.
+
+## Status: DONE
+
+## What was implemented
+
+- `PdfrbWriter#add_bookmark(title, page_index)` delegates to
+  `Pdfrb::Document#outline.add(title, dest: page)`.
+- Available for Pipeline consumers to add bookmarks for headings or
+  sections.
+- `PdfrbExt::Clip` and `PdfrbExt::EndPath` also added for image clipping
+  (TODO 57).
+
+## Acceptance criteria
+
+- [x] PdfrbWriter#add_bookmark delegates to pdfrb outline API.
+- [x] Anti-pattern spec passes (no new violations).
+- [x] All tests pass.

data/TODO.pdf/59-dry-placement-rect.md

@@ -0,0 +1,15 @@
+# TODO PDF 59: DRY — shared placement_rect in Geometry
+
+## Goal
+
+Eliminate duplication between Pipeline#parent_clip_box and
+RectangleRenderer.placement_box. Both compute the same thing:
+transform bounds by ItemTransform, convert to PDF rect with Y-flip.
+
+## Status: DONE
+
+## What was implemented
+
+`Geometry.placement_rect(bounds, item_transform_str, page_height)` —
+single method that parses transform, applies to bounds, and converts
+to PDF rect. Used by both RectangleRenderer and Pipeline.

data/TODO.pdf/60-cli-pdf-a-flag.md

@@ -0,0 +1,16 @@
+# TODO PDF 60: CLI PDF/A flag and compliance passthrough
+
+## Goal
+
+Wire the compliance option from CLI through Render.render to Pipeline.
+Add `--pdf-a` flag to the CLI render command.
+
+## Status: DONE
+
+## What was implemented
+
+- `Render.render(compliance:)` keyword argument passes to Pipeline.
+- `Pipeline.new(package, output, font_search_paths, compliance:)` keyword.
+- `cli.rb render` command accepts `--pdf-a` boolean flag.
+- When set, Pipeline calls `apply_compliance(writer)` which adds XMP
+  metadata and ICC OutputIntent for PDF/A-2a compliance.

data/TODO.pdf/README.md

@@ -0,0 +1,21 @@
+# IDML → PDF Rendering TODOs
+
+This directory tracks the work to render an IDML package to PDF
+without InDesign Server. The pipeline has three layers:
+
+1. **Text engine** (TODOs 01–05): a pure-Ruby text layout engine
+   that takes styled text runs + frame geometry and produces
+   positioned glyphs. Uses font metrics from .ttf/.otf files.
+
+2. **PDF content stream** (TODOs 06–10): maps IDML page items
+   (shapes, text, colors, images) to PDF content-stream operators
+   using pdfrb's Document/Canvas API.
+
+3. **Pipeline** (TODOs 11–13): ties the text engine and PDF
+   output together. IDML Package → typed model → render plan →
+   pdfrb Document → PDF file.
+
+The text engine is intentionally IDML-agnostic: it works on
+styled text runs and frame geometry, not IDML-specific types.
+This makes it reusable (e.g., for generating PDFs from scratch
+or from other layout formats).

data/exe/idml

@@ -0,0 +1,5 @@
+#!/usr/bin/env ruby
+# frozen_string_literal: true
+
+require "idml"
+Idml::CLI.start(ARGV)

data/idml.gemspec

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require_relative "lib/idml/version"
+
+all_files_in_git = Dir.chdir(File.expand_path(__dir__)) do
+  `git ls-files -z`.split("\x0")
+end
+
+Gem::Specification.new do |spec|
+  spec.name = "idml"
+  spec.version = Idml::VERSION
+  spec.authors = ["Ribose"]
+  spec.email = ["open.source@ribose.com"]
+
+  spec.summary = "Parse, manipulate, and round-trip Adobe IDML files."
+  spec.homepage      = "https://github.com/metanorma/idml"
+  spec.license       = "BSD-2-Clause"
+  spec.required_ruby_version = Gem::Requirement.new(">= 3.3.0")
+
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["bug_tracker_uri"] = "#{spec.homepage}/issues"
+
+  spec.files = all_files_in_git
+    .reject { |f| f.match(%r{\A(?:test|spec|features|bin|\.)/}) }
+
+  spec.bindir        = "exe"
+  spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
+  spec.require_paths = ["lib"]
+
+  spec.add_dependency "bigdecimal"
+  spec.add_dependency "fontisan"
+  spec.add_dependency "lutaml-model", "~> 0.8.18"
+  spec.add_dependency "pdfrb"
+  spec.add_dependency "rubyzip"
+  spec.add_dependency "thor"
+
+  spec.metadata["rubygems_mfa_required"] = "true"
+end

data/lib/idml/cli.rb

@@ -0,0 +1,105 @@
+# frozen_string_literal: true
+
+require "thor"
+
+module Idml
+  # Command-line interface. Thin wrapper around the gem's public API —
+  # no business logic lives here. Each subcommand is a Thor method that
+  # delegates to Package, Document, Validation::Validator, or
+  # Composition::Prefix.
+  class CLI < Thor
+    desc "version", "Print the idml gem version"
+    def version
+      puts Idml::VERSION
+    end
+
+    desc "parts PATH", "List every part in the IDML package"
+    def parts(path)
+      package(path).part_names.each { |name| puts name }
+    end
+
+    desc "validate PATH", "Validate every schematized part against RNG"
+    def validate(path)
+      validator = Idml::Validation::Validator.new
+      results = validator.validate_package(package(path))
+      any_failure = print_validation_results(results)
+      exit 1 if any_failure
+    end
+
+    desc "round_trip PATH [-o OUTPUT]", "Extract every part and rezip"
+    method_option :output, aliases: "-o", type: :string, required: true
+    def round_trip(path)
+      pkg = package(path)
+      parts = pkg.each_part.to_a.to_h { |name, content| [name, content] }
+      Idml::Package.write(parts: parts, to: options[:output])
+      puts "Wrote #{options[:output]}"
+    end
+
+    desc "prefix PATH PREFIX [-o OUTPUT]", "Prefix every Self attribute"
+    method_option :output, aliases: "-o", type: :string, required: true
+    def prefix(path, prefix)
+      result = Idml::Composition::Prefix.new(package(path)).call(prefix: prefix)
+      FileUtils.cp(result.path, options[:output])
+      puts "Wrote #{options[:output]}"
+    end
+
+    desc "text PATH [STORY_SELF]",
+         "Print concatenated text of every story, or one"
+    def text(path, story_self = nil)
+      doc = Idml::Document.new(package(path))
+      if story_self
+        puts doc.story_text(story_self)
+      else
+        doc.each_story do |sid, body|
+          puts "[#{sid}]"
+          puts body
+          puts
+        end
+      end
+    end
+
+    desc "render PATH [-o OUTPUT] [--pdf-a] [--font-path DIR]",
+         "Convert IDML to PDF"
+    method_option :output, aliases: "-o", type: :string, required: true
+    method_option :font_path, type: :array, default: [],
+                              desc: "Additional font search directories"
+    method_option :pdf_a, type: :boolean, default: false,
+                          desc: "Produce PDF/A-2a compliant output"
+    def render(path)
+      pkg = package(path)
+      compliance = options[:pdf_a] ? :pdfa2a : nil
+      Idml::Render.render(package: pkg, to: options[:output],
+                          font_search_paths: font_search_paths,
+                          compliance: compliance)
+      puts "Wrote #{options[:output]}"
+    rescue Idml::Errors::PackageNotFound => e
+      warn "Error: #{e.message}"
+      exit 1
+    end
+
+    private
+
+    def package(path)
+      raise Idml::Errors::PackageNotFound, path unless File.exist?(path)
+
+      Idml::Package.new(path)
+    end
+
+    def font_search_paths
+      options[:font_path].empty? ? nil : options[:font_path]
+    end
+
+    def print_validation_results(results)
+      results.partition(&:ok?).then do |ok, failed|
+        ok.each { |r| puts "  OK   #{r.part_name}" }
+        failed.each { |r| print_failure(r) }
+        !failed.empty?
+      end
+    end
+
+    def print_failure(result)
+      puts "  FAIL #{result.part_name}"
+      result.errors.each { |e| puts "       #{e}" }
+    end
+  end
+end