idml 0.1.0 → 0.2.1

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

@@ -1,33 +0,0 @@
-# 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

@@ -1,26 +0,0 @@
-# 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

@@ -1,23 +0,0 @@
-# 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/lib/idml/render/color.rb

@@ -1,69 +0,0 @@
-# frozen_string_literal: true
-
-# DEPRECATED: This module is superseded by ColorHelper + Canvas
-# fill_color/stroke_color methods. Kept for backward compatibility.
-
-module Idml
-  module Render
-    # Converts IDML color values to PDF content-stream operators.
-    module Color
-      module_function
-
-      # RGB fill: `r g b rg`. Values 0.0–1.0.
-      def fill_rgb(r, g, b)
-        format("%<r>.4f %<g>.4f %<b>.4f rg", r: r, g: g, b: b)
-      end
-
-      # RGB stroke: `r g b RG`.
-      def stroke_rgb(r, g, b)
-        format("%<r>.4f %<g>.4f %<b>.4f RG", r: r, g: g, b: b)
-      end
-
-      # CMYK fill: `c m y k k`.
-      def fill_cmyk(c, m, y, k)
-        format("%<c>.4f %<m>.4f %<y>.4f %<k>.4f k", c: c, m: m, y: y, k: k)
-      end
-
-      # CMYK stroke: `c m y k K`.
-      def stroke_cmyk(c, m, y, k)
-        format("%<c>.4f %<m>.4f %<y>.4f %<k>.4f K", c: c, m: m, y: y, k: k)
-      end
-
-      # Parse IDML color space value (space-separated 0–255 or 0–100
-      # depending on model) to normalized 0.0–1.0.
-      def normalize_channel(value, max = 255)
-        value.to_f / max
-      end
-
-      # Black fill (common default).
-      def black_fill
-        "0 g"
-      end
-
-      # White fill.
-      def white_fill
-        "1 g"
-      end
-
-      # Dispatch: accepts a color hash ({ model:, r:, g:, b: } or
-      # { model:, c:, m:, y:, k: }) and returns the appropriate
-      # fill operator string.
-      def fill_op(color)
-        case color[:model]
-        when :rgb then fill_rgb(color[:r], color[:g], color[:b])
-        when :cmyk then fill_cmyk(color[:c], color[:m], color[:y], color[:k])
-        end
-      end
-
-      # Dispatch: accepts a color hash and returns the appropriate
-      # stroke operator string.
-      def stroke_op(color)
-        case color[:model]
-        when :rgb then stroke_rgb(color[:r], color[:g], color[:b])
-        when :cmyk then stroke_cmyk(color[:c], color[:m], color[:y],
-                                    color[:k])
-        end
-      end
-    end
-  end
-end

data/lib/idml/render/font_embedder.rb

@@ -1,79 +0,0 @@
-# frozen_string_literal: true
-
-# DEPRECATED: This module is superseded by PdfrbWriter.register_font.
-# Font embedding is now handled by pdfrb (Pdfrb::Document#fonts.add).
-
-module Idml
-  module Render
-    # Generates PDF font structures for embedded TrueType fonts.
-    # Produces the Widths array (WinAnsiEncoding 32–255), FontDescriptor
-    # metadata, and FontFile2 binary embedding.
-    module FontEmbedder
-      FIRST_CHAR = 32
-      LAST_CHAR = 255
-
-      # PDF WinAnsiEncoding = Code Page 1252. Bytes 0x80-0x9F differ
-      # from ISO-8859-1 and map to specific Unicode codepoints.
-      CP1252_SPECIAL = {
-        0x80 => 0x20AC, 0x82 => 0x201A, 0x83 => 0x0192, 0x84 => 0x201E,
-        0x85 => 0x2026, 0x86 => 0x2020, 0x87 => 0x2021, 0x88 => 0x02C6,
-        0x89 => 0x2030, 0x8A => 0x0160, 0x8B => 0x2039, 0x8C => 0x0152,
-        0x8E => 0x017D, 0x91 => 0x2018, 0x92 => 0x2019, 0x93 => 0x201C,
-        0x94 => 0x201D, 0x95 => 0x2022, 0x96 => 0x2013, 0x97 => 0x2014,
-        0x98 => 0x02DC, 0x99 => 0x2122, 0x9A => 0x0161, 0x9B => 0x203A,
-        0x9C => 0x0153, 0x9E => 0x017E, 0x9F => 0x0178
-      }.freeze
-
-      private_constant :CP1252_SPECIAL
-
-      module_function
-
-      # Widths array for WinAnsiEncoding (chars 32–255), in PDF text
-      # units (1000 units per em).
-      def widths_array(font_metrics)
-        (FIRST_CHAR..LAST_CHAR).map do |byte|
-          cp = winansi_to_unicode(byte)
-          raw = font_metrics.glyph_width(cp)
-          scale_to_text_units(raw, font_metrics.units_per_em)
-        end
-      end
-
-      # Map a WinAnsi (CP1252) byte value to its Unicode codepoint.
-      def winansi_to_unicode(byte)
-        CP1252_SPECIAL.fetch(byte, byte)
-      end
-
-      def scale_to_text_units(font_units, upem)
-        (font_units.to_f * 1000 / upem).round
-      end
-
-      # FontDescriptor metadata hash.
-      def descriptor(font_metrics)
-        upem = font_metrics.units_per_em
-        scale = 1000.0 / upem
-        ascent = font_metrics.ascent.to_f
-        descent = font_metrics.descent.to_f
-        {
-          font_name: font_metrics.postscript_name,
-          flags: 32,
-          font_bbox: [
-            (descent * scale).round,
-            0,
-            1000,
-            (ascent * scale).round,
-          ],
-          italic_angle: 0,
-          ascent: (ascent * scale).round,
-          descent: (descent * scale).round,
-          cap_height: (ascent * scale * 0.7).round,
-          stem_v: 80,
-        }
-      end
-
-      # Read raw font binary data from the FontMetrics source path.
-      def raw_font_data(font_metrics)
-        File.binread(font_metrics.path)
-      end
-    end
-  end
-end

data/lib/idml/render/path.rb

@@ -1,80 +0,0 @@
-# frozen_string_literal: true
-
-# DEPRECATED: This module is superseded by Pdfrb::Content::Canvas
-# drawing methods (rectangle, stroke, fill, etc.).
-
-module Idml
-  module Render
-    # Converts IDML geometric page items to PDF path operators.
-    module Path
-      module_function
-
-      # Rectangle → `x y w h re`
-      def rectangle(x:, y:, width:, height:)
-        format("%<x>.2f %<y>.2f %<w>.2f %<h>.2f re", x: x, y: y, w: width,
-                                                     h: height)
-      end
-
-      # Save graphics state
-      def save_state
-        "q"
-      end
-
-      # Restore graphics state
-      def restore_state
-        "Q"
-      end
-
-      # Transformation matrix: `a b c d e f cm`
-      def transform(a:, b:, c:, d:, e:, f:)
-        format("%<a>.4f %<b>.4f %<c>.4f %<d>.4f %<e>.2f %<f>.2f cm",
-               a: a, b: b, c: c, d: d, e: e, f: f)
-      end
-
-      # Fill the current path (nonzero winding).
-      def fill
-        "f"
-      end
-
-      # Set clip path (nonzero winding). Must be followed by `n` (no-op).
-      def clip
-        "W n"
-      end
-
-      # Set clip path (even-odd).
-      def eo_clip
-        "W* n"
-      end
-
-      # Stroke the current path.
-      def stroke
-        "S"
-      end
-
-      # Set stroke line width: `w w`
-      def stroke_width(weight)
-        format("%<w>.2f w", w: weight)
-      end
-
-      # Close, fill, and stroke the current path.
-      def fill_stroke
-        "B"
-      end
-
-      # Close the current path.
-      def close
-        "h"
-      end
-
-      # Move to a point: `x y m`
-      def move_to(x, y)
-        format("%<x>.2f %<y>.2f m", x: x, y: y)
-      end
-
-      # Line to a point: `x y l`
-      def line_to(x, y)
-        format("%<x>.2f %<y>.2f l", x: x, y: y)
-      end
-    end
-  end
-end