idml 0.10.5 → 0.10.7

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 92cf9efcb8cb1f39e0047561634dd472186e817399f86ec0ffb1052e6de31db9
-  data.tar.gz: 1226c8e6cc234f21ed9f39ed79d371fb816bed45452eb28fba5cef62517b9dce
+  metadata.gz: 943028d5bf17ca306e3cce0d23c4b042ddaa9473295f2fa7f4af43009a7423a0
+  data.tar.gz: b9c3c1e5421ffa4de44396dbc94124434dda470c3f10fabd5ddd81146c3991c1
 SHA512:
-  metadata.gz: b369f0215c2e82053016ffd629bd14894d3d790c4dd053737a8645a919dc7c8054648a882fd6a1494df335e26d252a89c61e4c85f58f7dd7f630f54ed0686107
-  data.tar.gz: 79604135da4d6126775c9ae9ac044034180f89a034b1e56116c278b13a07a1b728839b4114cf0c317c8ff8af5b67150d1d62b111f02981796fea389767bbc758
+  metadata.gz: 86717ea81b1ede4576d3d41e7026cd2731ec40024ea887d33a03c4ff7771384cb0ae9fd04f5948a322d48986dae2946adcebf167a7c51ae3ce7890a28726e7ee
+  data.tar.gz: 12a2089f4600a04fe5cd1d74e409c0933dc6f691156ffca4eeb87fcb25fd5d89e2a1ec58261c8a087ea00b93cf42abee0bb54d64f72032dc3b6bbe919f6cc6b4

data/TODO.pdf/135-minimum-glyph-scaling.md

@@ -0,0 +1,28 @@
+# TODO PDF 135: MinimumGlyphScaling justification compression
+
+## Status: COMPLETE — implemented 2026-08-26
+
+## Problem
+
+InDesign's justification dialog exposes MinimumGlyphScaling: overlong
+justified lines may squeeze glyphs uniformly down to that percent.
+The gem applied only MaximumGlyphScaling (stretching, TODO 129) —
+overlong lines overflowed the frame instead of compressing.
+
+## Solution
+
+`TextEngine::Justifier#justify_line` now handles negative slack:
+`compress_glyphs` scales every glyph uniformly, capped at
+`min_glyph_scaling` percent (default 100 disables it, matching
+InDesign). The limit threads through `SpacingLimits#min_glyph_scaling`,
+resolved from the PSR's `MinimumGlyphScaling` via `StyleResolver`
+(`Paragraph#minimum_glyph_scaling`) and applied at both call sites
+(frame renderer and footnote layout).
+
+## Files
+
+- `lib/idml/text_engine/justifier.rb`
+- `lib/idml/render/style_resolver.rb`
+- `lib/idml/render/renderers/text_frame_renderer.rb`
+- `lib/idml/render/footnote.rb`
+- `spec/idml/text_engine/text_engine_spec.rb`

data/TODO.pdf/136-diagonal-cell-strokes.md

@@ -0,0 +1,24 @@
+# TODO PDF 136: Diagonal cell strokes drawn
+
+## Status: COMPLETE — implemented 2026-08-26
+
+## Problem
+
+The Table schema (TODO 104) modeled `TopLeftDiagonalLine`,
+`TopRightDiagonalLine`, and the `DiagonalLineStroke*` attributes, but
+the renderer never drew them — struck-through table cells (common in
+forms) rendered as plain boxes.
+
+## Solution
+
+`TableRenderer#render_cell_diagonals` draws after cell borders:
+TopLeftDiagonalLine from top-left to bottom-right corner,
+TopRightDiagonalLine from top-right to bottom-left. Weight defaults
+to 1pt and color to black when the flags are set without explicit
+stroke attributes (InDesign defaults); `DiagonalLineStrokeTint`
+applies via `ColorHelper.apply_tint`.
+
+## Files
+
+- `lib/idml/render/renderers/table_renderer.rb`
+- `spec/idml/render/table_renderer_spec.rb`

data/TODO.pdf/137-simple-render-footnote-text.md

@@ -0,0 +1,22 @@
+# TODO PDF 137: Footnote text in the simple-render fallback
+
+## Status: COMPLETE — implemented 2026-08-26
+
+## Problem
+
+Without FontMetrics the text renderer falls back to `simple_render`
+(one `text_rich` per frame). Footnote markers rendered but the
+footnote text itself was dropped entirely.
+
+## Solution
+
+`emit_simple_footnotes` emits after the body block: one `text_rich`
+line per footnote paragraph, stacked upward from the frame's bottom
+edge below a hairline separator rule (0.5pt, quarter-width — InDesign's
+footnote rule proportions). Paragraphs carry their marker prefix from
+extraction, so numbering reads correctly.
+
+## Files
+
+- `lib/idml/render/renderers/text_frame_renderer.rb`
+- `spec/idml/render/simple_footnote_render_spec.rb`

data/TODO.pdf/138-text-wrap-sides.md

@@ -0,0 +1,36 @@
+# TODO PDF 138: Side-aware text wrap (TextWrapSide)
+
+## Status: COMPLETE — implemented 2026-08-26
+
+## Problem
+
+TextWrapSide was parsed but ignored: every wrap mode narrowed the run
+width by the contour overlap, which smears text over objects that sit
+at a frame edge (text starts at the frame's left edge regardless of
+where the object is).
+
+## Solution
+
+`TextWrapResolver#wrap_adjustment` returns
+`[width_reduction, x_shift]` per line band:
+
+- `LeftSide` — text stays left of the contour: reduce so the line
+  ends at the contour's left edge, no shift.
+- `RightSide` — text flows right of the contour: shift lines past the
+  contour's right edge (`Line#x_offset += shift` after justification)
+  and reduce by the same amount.
+- `LargestArea` — pick the roomier side of the two.
+- `BothSides` (default) and the spine variants — narrow by the full
+  overlap; true two-segment lines and binding-side context remain
+  approximations.
+- Inverse contours keep their flip-to-inside semantics.
+
+Multiple contours combine by max (per-run approximation, as before).
+Shape contours (Contour mode) narrow by polygon overlap without side
+awareness.
+
+## Files
+
+- `lib/idml/render/text_wrap_resolver.rb`
+- `lib/idml/render/renderers/text_frame_renderer.rb`
+- `spec/idml/render/text_wrap_resolver_spec.rb`

data/TODO.pdf/139-hyphen-break-opportunities.md

@@ -0,0 +1,24 @@
+# TODO PDF 139: Hyphen break opportunities in the LineBreaker
+
+## Status: COMPLETE — implemented 2026-08-27
+
+## Problem
+
+The greedy line breaker only treated spaces as break opportunities.
+Long compound words ("state-of-the-art", "e-mail") overflowed the
+frame as one unbreakable run instead of wrapping after a hyphen.
+
+## Solution
+
+`LineBreaker#break_after?` treats hyphen-minus (U+002D), Unicode
+hyphen (U+2010), non-breaking hyphen (U+2011), and soft hyphen
+(U+00AD) as break-after points: the hyphen stays on the first line
+and the remainder wraps. Soft hyphens break without adding a
+visible hyphen. Dictionary-based hyphenation (Knuth-Liang) remains
+out of scope — the Hyphenation* PSR attributes stay parsed but
+unused.
+
+## Files
+
+- `lib/idml/text_engine/line_breaker.rb`
+- `spec/idml/text_engine/text_engine_spec.rb`

data/TODO.pdf/140-cap-xheight-first-baselines.md

@@ -0,0 +1,29 @@
+# TODO PDF 140: CapHeight / XHeight / EmboxHeight first baselines
+
+## Status: COMPLETE — implemented 2026-08-27
+
+## Problem
+
+FirstBaselineOffset honored AscentOffset and FixedHeight (TODO 128)
+but approximated CapHeight, XHeight, and EmboxHeight as leading —
+text sat noticeably lower than InDesign places it.
+
+## Solution
+
+`TextFrameRenderer#baseline_target` now handles all five modes:
+
+- **CapHeight** — the font's cap-height metric when the provider
+  fills it; pdfrb 0.7.1 never does, so the fallback is the standard
+  0.72 em proportion (Arial and Helvetica both sit within 1%).
+- **XHeight** — 0.52 em (no x-height metric exists in pdfrb).
+- **EmboxHeight** — the em box itself: the first paragraph's point
+  size.
+
+`PdfrbFontMetrics#cap_height` exposes the metric for when pdfrb
+starts populating it.
+
+## Files
+
+- `lib/idml/render/renderers/text_frame_renderer.rb`
+- `lib/idml/text_engine/pdfrb_font_metrics.rb`
+- `spec/idml/render/first_baseline_spec.rb`

data/TODO.pdf/141-perf-hundred-pages.md

@@ -0,0 +1,22 @@
+# TODO PDF 141: 100+ page performance regression guard
+
+## Status: COMPLETE — implemented 2026-08-27
+
+## Problem
+
+No test guarded against per-page complexity blowups — a regression
+to O(document) work per page would only surface as slow user
+renders.
+
+## Solution
+
+`perf_hundred_pages_spec.rb` builds a synthetic 120-spread package
+(one page + one text frame each, all sharing a wordy story) and
+renders it end-to-end through `Idml::Render.render`. Asserts all
+120 PDF pages emit and the render completes under a generous 60s
+ceiling — sized to trip only on pathological blowups, not machine
+noise. Baseline on this branch: ~2s for 120 pages.
+
+## Files
+
+- `spec/idml/render/perf_hundred_pages_spec.rb`

data/TODO.pdf/61-known-limitations.md

@@ -1,6 +1,6 @@
 # TODO PDF 61: Known limitations and future work
 
-## Status: DOCUMENTED — refreshed 2026-08-20
+## Status: DOCUMENTED — refreshed 2026-08-27
 
 Previously listed limitations (font embedding, tagged PDF, per-run
 styling, dead code) were resolved by TODOs 52/53/55/67/76 long ago;
@@ -9,22 +9,26 @@ this list reflects the current state.
 ## Known limitations
 
 ### Text layout
-- **Hyphenation** is not implemented (Hyphenation* attributes are
-  parsed but unused); a hyphenation dictionary would be required.
-- **Justification**: word/letter spacing caps apply (TODO 119) and
-  MaximumGlyphScaling stretches as the last resort (TODO 129);
-  MinimumGlyphScaling compression and ToBinding / RTL binding
-  alignment are not applied.
+- **Hyphenation**: dictionary-based hyphenation is not implemented
+  (Hyphenation* attributes are parsed but unused); compound words
+  wrap after explicit hyphens (TODO 139).
+- **Justification**: word/letter spacing caps apply (TODO 119),
+  MaximumGlyphScaling stretches (TODO 129) and MinimumGlyphScaling
+  compresses overlong lines (TODO 135); ToBinding / RTL binding
+  alignment is not applied.
 - **Keep options**: KeepAllLinesTogether (TODO 123), KeepWithNext
   (TODO 127), and the KeepFirstLines / KeepLastLines windows
   (TODO 133, line-count approximation) are honored.
-- **First baseline**: AscentOffset and FixedHeight are honored
-  (TODO 128); CapHeight / XHeight approximate as leading.
+- **First baseline**: all five modes honor their metrics (TODOs
+  128/140); CapHeight / XHeight use standard font proportions
+  (0.72 / 0.52 em) until a metrics provider fills them.
 - **StartParagraph** breaks act at frame/column granularity — no
   odd/even page parity.
 - **Text wrap**: BoundingBoxTextWrap, Contour, and Inverse modes
-  render (TODOs 130-131); JumpObject/NextColumn approximate as
-  the box; side-aware narrowing is not implemented.
+  render (TODOs 130-131) with TextWrapSide side-awareness (TODO 138:
+  LeftSide / RightSide / LargestArea pick the flow side; spine
+  variants approximate as BothSides); JumpObject/NextColumn
+  approximate as the box; Contour-mode shapes are not side-aware.
 
 ### CJK
 - **Mojikumi**: script spacing (TODO 125), line-end compression
@@ -34,24 +38,24 @@ this list reflects the current state.
   ruby placement is beside-column; keep options do not apply.
 
 ### Structural features
-- **Endnotes** (TODO 117): reference markers render; endnote TEXT
-  rendering is gated on a real fixture (the EndnoteTextRange
-  reference chain is opaque without one).
+- **Endnotes** (TODO 117): reference markers render and endnote TEXT
+  renders end-of-story with ordinal prefixes; multi-story linkage
+  (which endnotes belong to which main story) is not modeled.
 - **Footnotes** number per story; overflow balancing (NoSplitting)
-  is not modeled; the simple-render fallback shows markers without
-  footnote text.
+  is not modeled; the simple-render fallback shows markers with
+  footnote text stacked at the frame bottom (TODO 137).
 - **Anchored objects** render at stored geometry; AnchorType
   text-reflow is not simulated.
 - **Tables** flow across chained frames with repeated header rows
-  (TODO 134); row-spanning cells break at frame boundaries and
-  diagonal cell strokes are modeled but not drawn.
+  (TODO 134) and diagonal cell strokes draw (TODO 136);
+  row-spanning cells break at frame boundaries.
 - **Inline anchored objects / footnotes inside table cells** are
   not handled.
 
 ## Future enhancements
 
 - Hyphenation dictionary integration
-- Shape-mode text wrap contours
-- Frame-spanning tables with header repeats
-- Class-based mojikumi tables
-- Performance benchmark for 100+ page documents
+- Shape-mode text wrap contours (side-aware)
+- Named mojikumi sets (詳細 etc.)
+- ToBinding / RTL binding alignment
+- Vertical-mode keep options and run-grouped Latin rotation

data/TODO.pdf/README.md

@@ -12,10 +12,12 @@ without InDesign Server. The pipeline has three layers:
    output together. IDML Package → typed model → render plan →
    pdfrb Document → PDF file.
 
-All entries are DONE except: TODO 117 (endnote TEXT rendering —
-gated on a real fixture to resolve the EndnoteTextRange reference
-chain) and TODO 13's final stretch goal (full class-based mojikumi
-tables; script spacing and line-end compression are in). Vertical
-writing, kinsoku, ruby, and tate-chu-yoko all landed (TODOs
-122-125). TODO 61 is the live known-limitations index. Each file
-carries a `## Status:` header with a brief implementation summary.
+All entries are DONE — including TODO 117 (end-of-story endnote
+TEXT rendering), TODO 13's class-based mojikumi pair compression,
+and the final known-limitation sweep (TODOs 135–138:
+MinimumGlyphScaling compression, diagonal cell strokes, footnote
+text in the simple-render fallback, and side-aware TextWrapSide).
+Vertical writing, kinsoku, ruby, and tate-chu-yoko all landed
+(TODOs 122-125). TODO 61 is the live known-limitations index. Each
+file carries a `## Status:` header with a brief implementation
+summary.

data/lib/idml/render/footnote.rb

@@ -132,6 +132,7 @@ module Idml
             max_word_spacing: paragraph.maximum_word_spacing,
             max_letter_spacing: paragraph.maximum_letter_spacing,
             max_glyph_scaling: paragraph.maximum_glyph_scaling,
+            min_glyph_scaling: paragraph.minimum_glyph_scaling,
           )
           lines.each_with_index do |line, index|
             TextEngine::Justifier.justify(

data/lib/idml/render/renderers/table_renderer.rb

@@ -104,6 +104,8 @@ module Idml
                                    cell_h, context)
             render_cell_border(canvas, cell, table, cell_x, cell_y,
                                cell_w, cell_h, context)
+            render_cell_diagonals(canvas, cell, cell_x, cell_y,
+                                  cell_w, cell_h, context)
             render_cell_text(canvas, cell, cell_x, cell_y, cell_h, context)
           end
         end
@@ -220,6 +222,56 @@ module Idml
         end
         private_class_method :render_cell_border
 
+        # TopLeftDiagonalLine runs from the cell's top-left to its
+        # bottom-right corner; TopRightDiagonalLine from top-right
+        # to bottom-left. Stroke weight defaults to 1pt and color
+        # to black when the flags are set without explicit stroke
+        # attributes (InDesign defaults). DiagonalLineInFront is
+        # accepted; diagonals always paint after the cell fill.
+        def self.render_cell_diagonals(canvas, cell, x, y, w, h, context)
+          return unless cell.top_left_diagonal_line ||
+            cell.top_right_diagonal_line
+
+          weight = cell.diagonal_line_stroke_weight
+          thickness = weight.nil? ? 1.0 : weight.to_f
+          return unless thickness.positive?
+
+          canvas.line_width = thickness
+          canvas.stroke_color(diagonal_color(cell, context))
+          diagonals_for(cell, x, y, w, h).each do |from, to|
+            canvas.move_to(from[0], from[1])
+            canvas.line_to(to[0], to[1])
+            canvas.stroke
+          end
+        end
+        private_class_method :render_cell_diagonals
+
+        def self.diagonals_for(cell, x, y, w, h)
+          [].tap do |diagonals|
+            diagonals << [[x, y + h], [x + w, y]] if cell.top_left_diagonal_line
+            diagonals << [[x + w, y + h], [x, y]] if cell.top_right_diagonal_line
+          end
+        end
+        private_class_method :diagonals_for
+
+        def self.diagonal_color(cell, context)
+          color = diagonal_resolved_color(cell, context)
+          color ? ColorHelper.to_canvas(color) : [:gray, 0.0]
+        end
+        private_class_method :diagonal_color
+
+        def self.diagonal_resolved_color(cell, context)
+          name = cell.diagonal_line_stroke_color
+          return nil if name.nil? || name == "Color/None"
+
+          resolved = context.color_resolver&.resolve(name)
+          return nil unless resolved
+
+          tint = cell.diagonal_line_stroke_tint
+          tint ? ColorHelper.apply_tint(resolved, tint) : resolved
+        end
+        private_class_method :diagonal_resolved_color
+
         # [top, right, bottom, left] effective weights, or nil when
         # neither cell edges nor table defaults declare any stroke
         # (the legacy uniform-rect case).

data/lib/idml/render/renderers/text_frame_renderer.rb

@@ -629,12 +629,19 @@ module Idml
         # the first line's baseline sits. The layout's default is
         # leading-based; AscentOffset shifts by (ascent − leading)
         # and FixedHeight by (MinimumFirstBaselineOffset − leading).
-        # CapHeight / XHeight / EmboxHeight approximate as leading.
-        # Returns the extra shift to subtract from the cursor.
+        # CapHeight uses the font's cap-height metric (leading
+        # fallback when the font reports none); XHeight approximates
+        # as 70% of cap height; EmboxHeight uses the em box (the
+        # first paragraph's point size). Returns the extra shift to
+        # subtract from the cursor.
+        FIRST_BASELINE_MODES = %w[
+          AscentOffset FixedHeight CapHeight XHeight EmboxHeight
+        ].freeze
+
         def self.first_baseline_offset(context, state, font)
           pref = context.item&.text_frame_preference&.first
           mode = pref&.first_baseline_offset
-          return 0.0 unless %w[AscentOffset FixedHeight].include?(mode)
+          return 0.0 unless FIRST_BASELINE_MODES.include?(mode)
 
           baseline_target(pref, mode, state, font) -
             first_paragraph_leading(state)
@@ -643,21 +650,52 @@ module Idml
 
         # Distance from the top inset to the first baseline under
         # the given mode.
+        # pdfrb 0.7.1 never fills the cap_height metric, so
+        # CapHeight / XHeight fall back to standard font
+        # proportions (cap ≈ 0.72 em, x ≈ 0.52 em — Arial and
+        # Helvetica both sit within 1% of these).
+        CAP_HEIGHT_RATIO = 0.72
+        X_HEIGHT_RATIO = 0.52
+
         def self.baseline_target(pref, mode, state, font)
-          if mode == "AscentOffset"
-            ascent_scaled(font) * first_paragraph_leading(state)
+          leading = first_paragraph_leading(state)
+          case mode
+          when "AscentOffset"
+            ratio_scaled(font.ascent, font) * leading
+          when "CapHeight"
+            cap_ratio(font) * leading
+          when "XHeight"
+            X_HEIGHT_RATIO * leading
+          when "EmboxHeight"
+            first_paragraph_size(state)
           else
-            pref.minimum_first_baseline_offset ||
-              first_paragraph_leading(state)
+            pref.minimum_first_baseline_offset || leading
           end
         end
         private_class_method :baseline_target
 
-        def self.ascent_scaled(font)
-          upem = font.units_per_em.zero? ? 1 : font.units_per_em
-          font.ascent / upem
+        def self.cap_ratio(font)
+          cap = font.cap_height
+          return CAP_HEIGHT_RATIO unless cap
+
+          ratio_scaled(cap, font)
+        end
+        private_class_method :cap_ratio
+
+        def self.ratio_scaled(metric, font)
+          upem = font.units_per_em
+          return 1.0 if upem.zero?
+
+          metric / upem
+        end
+        private_class_method :ratio_scaled
+
+        def self.first_paragraph_size(state)
+          paragraph = state.current_paragraph || state.paragraphs.first
+          first_run = paragraph&.runs&.first
+          first_run&.point_size || DEFAULT_SIZE
         end
-        private_class_method :ascent_scaled
+        private_class_method :first_paragraph_size
 
         def self.first_paragraph_leading(state)
           paragraph = state.current_paragraph || state.paragraphs.first
@@ -839,14 +877,17 @@ module Idml
                                                   rendered_count)
             run_wrap = drop_cap_wrap_width(wrap_width, dc_width,
                                            dc_lines, rendered_count)
-            run_wrap -= text_wrap_overlap(context, layout_frame, cursor_y,
-                                          run)
+            wrap_reduction, wrap_shift = text_wrap_adjust(
+              context, layout_frame, cursor_y, run
+            )
+            run_wrap -= wrap_reduction
             positioned, next_y = layout_run(
               canvas, run, paragraph, context, layout_frame, font,
               run_wrap, cursor_y, space_before,
               para_attrs[:first_line_indent], para_attrs[:left_indent],
               char_cursor, bottom_limit,
-              paragraph_last: run.equal?(runs.last)
+              paragraph_last: run.equal?(runs.last),
+              wrap_shift: wrap_shift
             )
             char_cursor += positioned.length
             cursor_y = next_y
@@ -905,26 +946,27 @@ module Idml
         end
         private_class_method :render_footnote_entries
 
-        # Computes the text-wrap overlap for a run at its current y
-        # position. Uses the run's point_size as the line height
-        # approximation. Returns 0.0 when no resolver is wired or no
-        # contours overlap. Per-run approximation: all lines in the
-        # run get the same reduced width (correct when the run is
-        # fully inside or outside the contour; approximate when it
-        # spans the boundary).
-        def self.text_wrap_overlap(context, layout_frame, cursor_y, run)
+        # Computes the text-wrap adjustment for a run at its current y
+        # position: [width_reduction, x_shift]. The reduction narrows
+        # the wrap width; the shift moves wrapped lines right past a
+        # contour the text must flow around (TextWrapSide RightSide /
+        # LargestArea). Uses the run's point_size as the line height
+        # approximation. Returns [0.0, 0.0] when no resolver is wired
+        # or no contours overlap. Per-run approximation: all lines in
+        # the run get the same reduced width and shift (correct when
+        # the run is fully inside or outside the contour; approximate
+        # when it spans the boundary).
+        def self.text_wrap_adjust(context, layout_frame, cursor_y, run)
           resolver = context.text_wrap_resolver
-          return 0.0 unless resolver
+          return [0.0, 0.0] unless resolver
 
           size = run.point_size || DEFAULT_SIZE
           frame_x = layout_frame.x + (layout_frame.inset_left || 0)
           frame_right = layout_frame.x + layout_frame.width -
             (layout_frame.inset_right || 0)
-          overlap = resolver.overlap_width(cursor_y, size,
-                                           frame_x, frame_right)
-          [overlap, 0.0].max
+          resolver.wrap_adjustment(cursor_y, size, frame_x, frame_right)
         end
-        private_class_method :text_wrap_overlap
+        private_class_method :text_wrap_adjust
 
         # Strips drop cap characters from the first run so they don't
         # render twice (once as the enlarged drop cap, once as normal
@@ -1047,7 +1089,8 @@ module Idml
         def self.layout_run(canvas, run, paragraph, context, layout_frame,
                             font, wrap_width, cursor_y, space_before,
                             first_line_indent, left_indent,
-                            char_cursor, bottom_limit, paragraph_last: false)
+                            char_cursor, bottom_limit, paragraph_last: false,
+                            wrap_shift: 0.0)
           size = run.point_size || DEFAULT_SIZE
           glyphs = TextEngine::Shaper.shape(
             text: run.text, font: font, size: size,
@@ -1056,6 +1099,7 @@ module Idml
             glyphs: glyphs, frame_width: wrap_width,
           )
           justify_lines(lines, paragraph, wrap_width, paragraph_last)
+          lines.each { |line| line.x_offset += wrap_shift }
           leading = leading_for(paragraph, size)
 
           positioned, next_y = TextEngine::VerticalLayout.layout_block(
@@ -1208,6 +1252,7 @@ module Idml
             max_word_spacing: paragraph.maximum_word_spacing,
             max_letter_spacing: paragraph.maximum_letter_spacing,
             max_glyph_scaling: paragraph.maximum_glyph_scaling,
+            min_glyph_scaling: paragraph.minimum_glyph_scaling,
           )
           lines.each_with_index do |line, index|
             TextEngine::Justifier.justify(
@@ -1351,12 +1396,38 @@ module Idml
             runs_for,
             at: [box[:x], box[:y] + box[:height] - first_size],
           )
+          emit_simple_footnotes(canvas, runs, context, box)
           state.paragraphs = []
           state.current_paragraph = nil
           state.runs_remaining = []
         end
         private_class_method :simple_render
 
+        # Footnote text for the rough (no-metrics) path: one line
+        # per footnote paragraph, stacked upward from the frame's
+        # bottom edge below a hairline separator. Paragraphs are
+        # already marker-prefixed at extraction.
+        def self.emit_simple_footnotes(canvas, runs, context, box)
+          paragraphs = runs.flat_map(&:footnote_paragraphs).compact
+          return if paragraphs.empty?
+
+          size = paragraphs.first.runs.first&.point_size || DEFAULT_SIZE
+          block_top = box[:y] + (paragraphs.length * size)
+          canvas.line_width = 0.5
+          canvas.stroke_color([:gray, 0.0])
+          canvas.move_to(box[:x], block_top + (size * 0.3))
+          canvas.line_to(box[:x] + (box[:width] * 0.25), block_top + (size * 0.3))
+          canvas.stroke
+
+          paragraphs.reverse_each.with_index do |paragraph, index|
+            canvas.text_rich(
+              build_rich_runs(paragraph.runs, context),
+              at: [box[:x], box[:y] + ((index + 1) * size)],
+            )
+          end
+        end
+        private_class_method :emit_simple_footnotes
+
         def self.collect_runs(state)
           runs = state.runs_remaining || []
           if state.current_paragraph

data/lib/idml/render/style_resolver.rb

@@ -69,6 +69,7 @@ module Idml
         :maximum_word_spacing,
         :maximum_letter_spacing,
         :maximum_glyph_scaling,
+        :minimum_glyph_scaling,
         # Forced paragraph break (StartParagraph: NextPage /
         # NextColumn / NextFrame / NextOddPage / NextEvenPage).
         :start_paragraph,
@@ -212,6 +213,9 @@ module Idml
             maximum_glyph_scaling: resolve_attr(
               style_lookup, psr, :maximum_glyph_scaling
             ),
+            minimum_glyph_scaling: resolve_attr(
+              style_lookup, psr, :minimum_glyph_scaling
+            ),
             start_paragraph: resolve_attr(style_lookup, psr,
                                           :start_paragraph),
             keep_all_lines_together: resolve_attr(

data/lib/idml/render/text_wrap_resolver.rb

@@ -9,12 +9,16 @@ module Idml
     # text line to compute the effective wrap width — lines that
     # overlap a contour get their width reduced by the overlap.
     #
-    # Supported: BoundingBox mode (rectangle intersection).
-    # Unsupported: Shape mode (contour following), Inverse mode.
+    # Supported: BoundingBox mode (rectangle intersection) with
+    # TextWrapSide awareness (LeftSide / RightSide / LargestArea
+    # pick the side text flows on; BothSides and the spine variants
+    # narrow by the full overlap). Shape contours (Contour mode)
+    # narrow by polygon overlap without side awareness.
+    # Unsupported: Inverse mode's side behavior.
     class TextWrapResolver
       # A wrap contour: a PDF-coordinate rectangle the text avoids.
       Contour = Struct.new(
-        :x, :y, :width, :height, :inverse,
+        :x, :y, :width, :height, :inverse, :side,
         keyword_init: true
       )
 
@@ -37,6 +41,80 @@ module Idml
 
       attr_reader :contours
 
+      # Side-aware adjustment for a text line: returns
+      # [width_reduction, x_shift]. LeftSide keeps text left of the
+      # contour (reduce, no shift); RightSide moves text past the
+      # contour's right edge (reduce + shift); LargestArea picks the
+      # roomier side; BothSides and the spine variants (which need
+      # binding-side context) reduce by the full overlap. Multiple
+      # contours combine by max — the per-run approximation.
+      def wrap_adjustment(line_y, line_height, frame_x, frame_right)
+        reduction = 0.0
+        shift = 0.0
+        @contours.each do |contour|
+          unless contour.is_a?(WrapContour::Shape)
+            r, s = box_adjustment(contour, line_y, line_height,
+                                  frame_x, frame_right)
+            reduction = [reduction, r].max
+            shift = [shift, s].max
+            next
+          end
+
+          width = WrapContour.overlap_width(contour, line_y,
+                                            line_height, frame_x,
+                                            frame_right)
+          next unless contour.inverse
+
+          reduction = [reduction,
+                       (frame_right - frame_x) - width].max
+        end
+        [reduction, shift]
+      end
+
+      def box_adjustment(contour, line_y, line_height, frame_x,
+                         frame_right)
+        overlap = if y_overlap?(contour, line_y, line_height) &&
+            x_overlap?(contour, frame_x, frame_right)
+                    x_overlap_width(contour, frame_x, frame_right)
+                  else
+                    0.0
+                  end
+        # Inverse contours: text flows only inside, so the reduction
+        # is the frame width minus the covered part (the full width
+        # when the line misses the object entirely).
+        return [(frame_right - frame_x) - overlap, 0.0] if contour.inverse
+
+        return [0.0, 0.0] if overlap.zero?
+
+        side_adjustment(contour, overlap, frame_x, frame_right)
+      end
+      private :box_adjustment
+
+      def side_adjustment(contour, overlap, frame_x, frame_right)
+        case contour.side
+        when "LeftSide"
+          [frame_right - contour.x, 0.0]
+        when "RightSide"
+          shift = contour.x + contour.width - frame_x
+          [shift, shift]
+        when "LargestArea"
+          largest_side_adjustment(contour, frame_x, frame_right)
+        else
+          [overlap, 0.0]
+        end
+      end
+      private :side_adjustment
+
+      def largest_side_adjustment(contour, frame_x, frame_right)
+        left_free = contour.x - frame_x
+        right_free = frame_right - (contour.x + contour.width)
+        return [frame_right - contour.x, 0.0] if left_free >= right_free
+
+        shift = contour.x + contour.width - frame_x
+        [shift, shift]
+      end
+      private :largest_side_adjustment
+
       # Returns the total horizontal overlap of all contours with a
       # text line at the given y range within the given x range.
       # Sum, not max — multiple overlapping contours compound.
@@ -73,12 +151,12 @@ module Idml
         if contour_mode?(pref)
           WrapContour.shape(item, pref, page_height)
         else
-          box_contour(item, page_height)
+          box_contour(item, page_height, pref)
         end
       end
       private_class_method :contour_for
 
-      def self.box_contour(item, page_height)
+      def self.box_contour(item, page_height, pref = nil)
         bounds = item.geometric_bounds
         return nil unless bounds
 
@@ -86,7 +164,8 @@ module Idml
                                        page_height)
         Contour.new(
           x: rect[:x], y: rect[:y],
-          width: rect[:width], height: rect[:height]
+          width: rect[:width], height: rect[:height],
+          side: pref&.text_wrap_side
         )
       end
       private_class_method :box_contour

data/lib/idml/text_engine/justifier.rb

@@ -11,12 +11,14 @@ module Idml
       # InDesign defaults: word spacing max 133%, letter spacing 0%.
       SpacingLimits = Struct.new(
         :max_word_spacing, :max_letter_spacing, :max_glyph_scaling,
+        :min_glyph_scaling,
         keyword_init: true
       )
 
       DEFAULT_MAX_WORD_SPACING = 133.0
       DEFAULT_MAX_LETTER_SPACING = 0.0
       DEFAULT_MAX_GLYPH_SCALING = 100.0
+      DEFAULT_MIN_GLYPH_SCALING = 100.0
 
       def self.justify(line:, frame_width:, alignment: :left,
                        last_line: false, limits: nil)
@@ -55,6 +57,8 @@ module Idml
       def justify_line(line)
         spaces = line.glyphs.count(&:is_space)
         slack = @frame_width - line.width
+        return compress_glyphs(line, slack) if slack.negative?
+
         return if spaces.zero? || slack <= 0
 
         word_share = [slack, word_capacity(line, spaces)].min
@@ -99,6 +103,23 @@ module Idml
       end
       private :distribute_letter_spacing
 
+      # Overlong justified line: compress all glyphs uniformly,
+      # capped at min_glyph_scaling percent. InDesign's default cap
+      # (100%) disables it; only documents that lower the cap get
+      # squeezed glyphs.
+      def compress_glyphs(line, slack)
+        min_pct = @limits&.min_glyph_scaling || DEFAULT_MIN_GLYPH_SCALING
+        shrink = (100 - min_pct) / 100.0
+        return unless shrink.positive?
+
+        total = line.glyphs.sum(&:width)
+        return unless total.positive?
+
+        factor = [-slack / total, shrink].min
+        line.glyphs.each { |glyph| glyph.width *= (1 - factor) }
+      end
+      private :compress_glyphs
+
       # Last resort: uniform glyph scaling for any remaining slack,
       # capped at max_glyph_scaling percent. InDesign's default cap
       # (100%) disables it; only documents that relax the cap get

data/lib/idml/text_engine/line_breaker.rb

@@ -6,10 +6,16 @@ module Idml
     Line = Struct.new(:glyphs, :width, :x_offset)
 
     # Greedy word-wrap line breaker. Accumulates glyphs until
-    # exceeding the frame width, then breaks at the last space.
-    # CJK runs get a kinsoku shori post-pass (no line starts or
-    # ends with a forbidden character).
+    # exceeding the frame width, then breaks at the last break
+    # opportunity: a space, or a hyphen (compound words wrap after
+    # the hyphen, which stays on the first line). CJK runs get a
+    # kinsoku shori post-pass (no line starts or ends with a
+    # forbidden character).
     class LineBreaker
+      # Break-after opportunities besides spaces: hyphen-minus,
+      # the Unicode hyphens, and the soft hyphen (which breaks
+      # without adding a visible hyphen).
+      HYPHEN_CODEPOINTS = [0x2D, 0x2010, 0x2011, 0x00AD].freeze
       def self.break(glyphs:, frame_width:)
         lines = new(frame_width).break(glyphs)
         return lines unless cjk_run?(glyphs)
@@ -44,26 +50,26 @@ module Idml
         lines = []
         current = []
         current_width = 0
-        last_space_idx = -1
-        width_at_space = 0
+        break_idx = -1
+        width_at_break = 0
 
         glyphs.each_with_index do |glyph, _idx|
           current << glyph
           current_width += glyph.width
 
-          if glyph.is_space
-            last_space_idx = current.length - 1
-            width_at_space = current_width
+          if break_after?(glyph)
+            break_idx = current.length - 1
+            width_at_break = current_width
           end
 
           next unless current_width > @frame_width && current.length > 1
 
-          if last_space_idx >= 0
-            line_glyphs = current[0..last_space_idx]
-            lines << Line.new(line_glyphs, width_at_space, 0)
-            current = current[(last_space_idx + 1)..]
+          if break_idx >= 0
+            line_glyphs = current[0..break_idx]
+            lines << Line.new(line_glyphs, width_at_break, 0)
+            current = current[(break_idx + 1)..]
             current_width = current.sum(&:width)
-            last_space_idx = -1
+            break_idx = -1
           elsif cjk_break?(current)
             lines << Line.new(current[0..-2], current_width - glyph.width, 0)
             current = [glyph]
@@ -78,6 +84,11 @@ module Idml
         lines << Line.new(current, current_width, 0) if current.any?
         lines
       end
+
+      def break_after?(glyph)
+        glyph.is_space || HYPHEN_CODEPOINTS.include?(glyph.codepoint)
+      end
+      private :break_after?
     end
   end
 end

data/lib/idml/text_engine/pdfrb_font_metrics.rb

@@ -37,6 +37,12 @@ module Idml
         0
       end
 
+      # Cap height in font units; nil when the font tables don't
+      # report one (some pdfrb-loaded fonts).
+      def cap_height
+        metrics_data[:cap_height]
+      end
+
       # Returns raw advance width in font units (not scaled by size).
       def glyph_width(codepoint)
         cp = codepoint.is_a?(String) ? codepoint.each_codepoint.first : codepoint

data/lib/idml/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Idml
-  VERSION = "0.10.5"
+  VERSION = "0.10.7"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: idml
 version: !ruby/object:Gem::Version
-  version: 0.10.5
+  version: 0.10.7
 platform: ruby
 authors:
 - Ribose
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-26 00:00:00.000000000 Z
+date: 2026-08-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -197,7 +197,14 @@ files:
 - TODO.pdf/132-line-end-compression.md
 - TODO.pdf/133-keep-windows.md
 - TODO.pdf/134-table-row-flow.md
+- TODO.pdf/135-minimum-glyph-scaling.md
+- TODO.pdf/136-diagonal-cell-strokes.md
+- TODO.pdf/137-simple-render-footnote-text.md
+- TODO.pdf/138-text-wrap-sides.md
+- TODO.pdf/139-hyphen-break-opportunities.md
 - TODO.pdf/14-page-item-element-models.md
+- TODO.pdf/140-cap-xheight-first-baselines.md
+- TODO.pdf/141-perf-hundred-pages.md
 - TODO.pdf/15-wire-spread-children.md
 - TODO.pdf/16-typed-model-pipeline.md
 - TODO.pdf/17-shape-rendering.md