idml 0.9.9 → 0.10.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: fd4031c47fca99598c64ed757ac446d3e1f2d2870603eb31af338132dae01288
-  data.tar.gz: 520a5ded7c74cfc50d0f893921486930c295b113f7e0d3c7af4dfb576186498c
+  metadata.gz: 13770ed8937eeed41a40bd223bb8caadc833da870858d691caa0e1806058c286
+  data.tar.gz: dec0fe8f24c1aaa8258ecf18506560b1e0793bd7d4ebe56bf361dc1a69ff736a
 SHA512:
-  metadata.gz: bad5a41e54b9e173241e08ba9e7006e6f621230ff782e89e4821d6b26749ee11b30fe8a38dae5185ee1cb41e4497ec20f32267584852cac43c9a37e41f488990
-  data.tar.gz: a62b908ae372636a3dec1722265ee44b24ab847510b348dd0029a3d04b388e41c6ad708f53c11ba21d7077817cfa831d700626ee73cc0380e46bfcb02e7ea58d
+  metadata.gz: '0394efac9722c854cd4e8c2771d0ec494aaa8d3b50ca6ea471bbe8f5f44daf62a1f1bd4d12031ee9d59b0d7b6c5f65f5378db661d5a110d056734958369a870e'
+  data.tar.gz: 07d3a9492ea5a41819f4fe0353176671307ad7263feedeb909bd08f8284eb79b84df0fef0057db1d089a3a02ff7d255459ea2e232e5c929d3d1ffccc70685e81

data/TODO.pdf/128-first-baseline-offset.md

@@ -0,0 +1,21 @@
+# TODO PDF 128: Text frame FirstBaselineOffset
+
+## Status: COMPLETE — implemented 2026-08-23
+
+## What was done
+
+`TextFrameRenderer` honors
+`TextFramePreference.FirstBaselineOffset` when positioning the
+first line's baseline: AscentOffset places it ascent-below the top
+inset (typically higher than the default leading-based position);
+FixedHeight uses MinimumFirstBaselineOffset. LeadingOffset /
+CapHeight / XHeight / EmboxHeight approximate as the existing
+leading-based default (cap/x-height metrics are not exposed by
+PdfrbFontMetrics). Applied in both the single-column and
+multi-column paths.
+
+## Known limitations
+
+- CapHeight / XHeight offsets fall back to leading (font metrics
+  expose ascent only).
+- Not applied in vertical writing mode.

data/TODO.pdf/129-justification-glyph-scaling.md

@@ -0,0 +1,18 @@
+# TODO PDF 129: Justification glyph scaling
+
+## Status: COMPLETE — implemented 2026-08-23
+
+## What was done
+
+`Justifier` distributes any residual slack remaining after the
+word-spacing and letter-spacing caps as uniform glyph scaling,
+capped at `MaximumGlyphScaling` (PSR → Paragraph → SpacingLimits).
+InDesign's default cap (100%) disables scaling — only documents
+that relax the cap get stretched glyphs, matching TODO 119's
+layered distribution: words first, then letters, then glyphs.
+
+## Known limitations
+
+- MinimumGlyphScaling (compression of overlong lines) is not
+  applied — the breaker never produces overlong justified lines
+  except forced unbreakable runs.

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

@@ -11,12 +11,15 @@ this list reflects the current state.
 ### 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);
-  glyph scaling (Min/Max/DesiredGlyphScaling) is not applied;
-  ToBinding / RTL binding alignment maps to left.
-- **Keep options**: whole-paragraph KeepAllLinesTogether and
-  KeepWithNext(first-line) are honored; partial keep windows
-  (KeepFirstLines / KeepLastLines) are not.
+- **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.
+- **Keep options**: whole-paragraph KeepAllLinesTogether (TODO
+  123) and KeepWithNext (TODO 127) are honored; partial keep
+  windows (KeepFirstLines / KeepLastLines) are not.
+- **First baseline**: AscentOffset and FixedHeight are honored
+  (TODO 128); CapHeight / XHeight approximate as leading.
 - **StartParagraph** breaks act at frame/column granularity — no
   odd/even page parity.
 - **Text wrap** (TODO 114): BoundingBox mode only; Shape contour

data/lib/idml/render/footnote.rb

@@ -131,6 +131,7 @@ module Idml
           limits = TextEngine::Justifier::SpacingLimits.new(
             max_word_spacing: paragraph.maximum_word_spacing,
             max_letter_spacing: paragraph.maximum_letter_spacing,
+            max_glyph_scaling: paragraph.maximum_glyph_scaling,
           )
           lines.each_with_index do |line, index|
             TextEngine::Justifier.justify(

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

@@ -433,6 +433,7 @@ module Idml
           bottom_limit = TextEngine::VerticalLayout.bottom_limit(layout_frame)
           footnotes = []
           cursor_y = vertical_justify_top(top_y, bottom_limit, state, context)
+          cursor_y -= first_baseline_offset(context, state, font)
           char_cursor = state.char_cursor
 
           if state.current_paragraph
@@ -473,7 +474,7 @@ module Idml
           top_y = col_frame.y + col_frame.height - (col_frame.inset_top || 0)
           bottom_limit = TextEngine::VerticalLayout.bottom_limit(col_frame)
           footnotes = []
-          cursor_y = top_y
+          cursor_y = top_y - first_baseline_offset(context, state, font)
           char_cursor = state.char_cursor
 
           if state.current_paragraph
@@ -564,6 +565,53 @@ module Idml
         end
         private_class_method :vertical_justify_top
 
+        # FirstBaselineOffset: how far below the frame's top inset
+        # 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.
+        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)
+
+          baseline_target(pref, mode, state, font) -
+            first_paragraph_leading(state)
+        end
+        private_class_method :first_baseline_offset
+
+        # Distance from the top inset to the first baseline under
+        # the given mode.
+        def self.baseline_target(pref, mode, state, font)
+          if mode == "AscentOffset"
+            ascent_scaled(font) * first_paragraph_leading(state)
+          else
+            pref.minimum_first_baseline_offset ||
+              first_paragraph_leading(state)
+          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
+        end
+        private_class_method :ascent_scaled
+
+        def self.first_paragraph_leading(state)
+          paragraph = state.current_paragraph || state.paragraphs.first
+          unless paragraph
+            return DEFAULT_SIZE *
+                TextEngine::VerticalLayout::DEFAULT_LEADING_FACTOR
+          end
+
+          size = paragraph.runs.first&.point_size || DEFAULT_SIZE
+          TextEngine::VerticalLayout.leading_for(paragraph.auto_leading,
+                                                 size)
+        end
+        private_class_method :first_paragraph_leading
+
         def self.text_frame_vertical_justification(context)
           pref = context.item&.text_frame_preference&.first
           pref&.vertical_justification
@@ -1051,6 +1099,7 @@ module Idml
           limits = TextEngine::Justifier::SpacingLimits.new(
             max_word_spacing: paragraph.maximum_word_spacing,
             max_letter_spacing: paragraph.maximum_letter_spacing,
+            max_glyph_scaling: paragraph.maximum_glyph_scaling,
           )
           lines.each_with_index do |line, index|
             TextEngine::Justifier.justify(

data/lib/idml/render/style_resolver.rb

@@ -68,6 +68,7 @@ module Idml
         # Justification distribution caps (percent; from PSR).
         :maximum_word_spacing,
         :maximum_letter_spacing,
+        :maximum_glyph_scaling,
         # Forced paragraph break (StartParagraph: NextPage /
         # NextColumn / NextFrame / NextOddPage / NextEvenPage).
         :start_paragraph,
@@ -205,6 +206,9 @@ module Idml
             maximum_letter_spacing: resolve_attr(
               style_lookup, psr, :maximum_letter_spacing
             ),
+            maximum_glyph_scaling: resolve_attr(
+              style_lookup, psr, :maximum_glyph_scaling
+            ),
             start_paragraph: resolve_attr(style_lookup, psr,
                                           :start_paragraph),
             keep_all_lines_together: resolve_attr(

data/lib/idml/text_engine/justifier.rb

@@ -10,11 +10,13 @@ module Idml
       # Justification distribution caps, in percent (100 = natural).
       # InDesign defaults: word spacing max 133%, letter spacing 0%.
       SpacingLimits = Struct.new(
-        :max_word_spacing, :max_letter_spacing, keyword_init: true
+        :max_word_spacing, :max_letter_spacing, :max_glyph_scaling,
+        keyword_init: true
       )
 
       DEFAULT_MAX_WORD_SPACING = 133.0
       DEFAULT_MAX_LETTER_SPACING = 0.0
+      DEFAULT_MAX_GLYPH_SCALING = 100.0
 
       def self.justify(line:, frame_width:, alignment: :left,
                        last_line: false, limits: nil)
@@ -63,7 +65,12 @@ module Idml
           glyph.width += extra
         end
         residual = slack - word_share
-        distribute_letter_spacing(line, residual) if residual.positive?
+        return unless residual.positive?
+
+        before = line.glyphs.sum(&:width)
+        distribute_letter_spacing(line, residual)
+        residual -= (line.glyphs.sum(&:width) - before)
+        distribute_glyph_scaling(line, residual) if residual.positive?
       end
 
       # Total room the word spaces may grow within the max-word-
@@ -91,6 +98,23 @@ module Idml
         line.glyphs.each { |glyph| glyph.width += add }
       end
       private :distribute_letter_spacing
+
+      # 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
+      # stretched glyphs.
+      def distribute_glyph_scaling(line, residual)
+        max_pct = @limits&.max_glyph_scaling || DEFAULT_MAX_GLYPH_SCALING
+        grow = (max_pct - 100) / 100.0
+        return unless grow.positive?
+
+        total = line.glyphs.sum(&:width)
+        return unless total.positive?
+
+        factor = [residual / total, grow].min
+        line.glyphs.each { |glyph| glyph.width *= (1 + factor) }
+      end
+      private :distribute_glyph_scaling
     end
   end
 end

data/lib/idml/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: idml
 version: !ruby/object:Gem::Version
-  version: 0.9.9
+  version: 0.10.0
 platform: ruby
 authors:
 - Ribose
@@ -186,6 +186,8 @@ files:
 - TODO.pdf/125-script-spacing.md
 - TODO.pdf/126-part-cache.md
 - TODO.pdf/127-keep-with-next.md
+- TODO.pdf/128-first-baseline-offset.md
+- TODO.pdf/129-justification-glyph-scaling.md
 - TODO.pdf/13-cjk-text-layout.md
 - TODO.pdf/14-page-item-element-models.md
 - TODO.pdf/15-wire-spread-children.md