idml 0.9.5 → 0.9.6

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 955ca35f14b9460085c65187586817bf655085d3f814660e790c7050e1abbe5f
-  data.tar.gz: 1aa96f29ecc97594128d6f88a245e46383efc99f0ff4d9f6797947cd8fe361a9
+  metadata.gz: 76ef12540a7d7d1805189664f88fc0c5b400b8d1240fbc495239ddb35f64822c
+  data.tar.gz: 941893920b3e23a32c196de4286a64f10edb0e377bb716a5287ba110bc3052bd
 SHA512:
-  metadata.gz: 638e2df6de7b160a8f7c64703309986f32644e29ada18f9c8f611b967e80ee4e9fdcf84cc7687ecd364b6aa964bcbb5831c4c279a841dd203b412f39d710fbc1
-  data.tar.gz: 9ef18bb1487ed2d6206c2c3aef6fe4ef699a12db584c2052557343144ae3f38d32cbcc275972114b2b46b1cc660c1cb24525befcd616462c33f9ab5ec52fd6e0
+  metadata.gz: 95da409c1987bac0a36ab73793c02e349d3060f313f3f4fc2670f22efffd89bd2d5f0bcfba4096dab595cf39a7843134ee0fc4f06f9e4136d477c65f44870586
+  data.tar.gz: a74c7d9a0a1ccd22e57308890a0f6b257e9ec2d3aab7d3d8a407c23b4b52f466cd2c39f86be48d4b89e912e26fcd3a582dbdf27455d8db49a405219ede022357

data/TODO.pdf/122-vertical-latin-ruby.md

@@ -0,0 +1,29 @@
+# TODO PDF 122: Vertical mode completion — Latin rotation, vertical ruby
+
+## Status: COMPLETE — implemented 2026-08-20
+
+## Problem
+
+The vertical writing path (TODO 13, 2026-08-19) stacked every glyph
+upright: Latin letters and digits rendered sideways-wrong (rotated
+in appearance relative to convention), and ruby annotations were
+not emitted at all in vertical mode.
+
+## What was done
+
+- Latin rotation: non-CJK glyphs in vertical text render rotated
+  90° clockwise (the vertical-writing convention for Latin runs),
+  via a graphics-state transform (q → translate → rotate −90° →
+  text at origin → Q). CJK glyphs stay upright.
+- Vertical ruby: runs carrying RubyString emit the annotation
+  stacked vertically alongside the base glyphs — to the right of
+  the column by default, to the left for RubyPosition values
+  containing "Below" (mirroring the horizontal above/below
+  convention under rotation). RubyFontSize defaults to half the
+  base size.
+
+## Known limitations
+
+- Tate-chu-yoko (horizontal digit groups inside vertical text) and
+  mojikumi spacing classes remain documented stretch goals
+  (TODO 13).

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

@@ -232,6 +232,8 @@ module Idml
             positioned.each do |glyph|
               emit_vertical_glyph(canvas, glyph, run, context, size)
             end
+            emit_vertical_ruby(canvas, run, positioned, layout_frame,
+                               size, context)
           end
           []
         end
@@ -246,21 +248,80 @@ module Idml
 
         # Emits one upright glyph at its vertical position with the
         # run's character styling.
+        # Emits one glyph in vertical mode: CJK upright; Latin
+        # (non-CJK) rotated 90° clockwise per the vertical-writing
+        # convention, via a graphics-state transform.
         def self.emit_vertical_glyph(canvas, positioned, run, context,
                                      size)
           text = [positioned.codepoint].pack("U")
-          text_kwargs = CharacterStyle.text_kwargs(
-            run,
-            {
-              at: [positioned.x, positioned.y],
-              font: font_for_run(run, context),
-              size: size,
-            },
-          )
-          canvas.text(text, **text_kwargs)
+          if TextEngine::CjkLayout.cjk?(positioned.codepoint)
+            text_kwargs = CharacterStyle.text_kwargs(
+              run,
+              {
+                at: [positioned.x, positioned.y],
+                font: font_for_run(run, context),
+                size: size,
+              },
+            )
+            canvas.text(text, **text_kwargs)
+          else
+            canvas.save_graphics_state do
+              # 90° clockwise: exact matrix (rotate would emit
+              # cos/sin float noise like 6.1e-17).
+              canvas.concat(0, -1, 1, 0, positioned.x, positioned.y)
+              text_kwargs = CharacterStyle.text_kwargs(
+                run,
+                {
+                  at: [0, 0],
+                  font: font_for_run(run, context),
+                  size: size,
+                },
+              )
+              canvas.text(text, **text_kwargs)
+            end
+          end
         end
         private_class_method :emit_vertical_glyph
 
+        # Emits the run's ruby alongside its vertical glyphs:
+        # stacked top-to-bottom beside the column — right side by
+        # default, left for Below* RubyPosition values (the
+        # horizontal above/below convention mirrored under
+        # rotation).
+        def self.emit_vertical_ruby(canvas, run, positioned, frame,
+                                    base_size, context)
+          ruby_text = run.ruby_string
+          return if ruby_text.nil? || ruby_text.empty?
+
+          ruby_size = run.ruby_font_size ||
+            (base_size * RUBY_SIZE_FACTOR)
+          x = ruby_vertical_x(positioned.first, run, base_size)
+          y = frame.y + frame.height - (frame.inset_top || 0)
+          ruby_text.each_codepoint do |codepoint|
+            text_kwargs = CharacterStyle.text_kwargs(
+              run,
+              {
+                at: [x, y - ruby_size],
+                font: font_for_run(run, context),
+                size: ruby_size,
+              },
+            )
+            canvas.text([codepoint].pack("U"), **text_kwargs)
+            y -= ruby_size
+          end
+        end
+        private_class_method :emit_vertical_ruby
+
+        def self.ruby_vertical_x(positioned, run, base_size)
+          offset = base_size * 0.9
+          if run.ruby_position.to_s.include?("Below")
+            positioned.x - offset
+          else
+            positioned.x + offset
+          end
+        end
+        private_class_method :ruby_vertical_x
+
         def self.chain_head?(frame)
           frame.previous_text_frame.nil? || frame.previous_text_frame == "n"
         end

data/lib/idml/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: idml
 version: !ruby/object:Gem::Version
-  version: 0.9.5
+  version: 0.9.6
 platform: ruby
 authors:
 - Ribose
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-08-20 00:00:00.000000000 Z
+date: 2026-08-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: bigdecimal
@@ -180,6 +180,7 @@ files:
 - TODO.pdf/12-idml-to-pdf-pipeline.md
 - TODO.pdf/120-start-paragraph-breaks.md
 - TODO.pdf/121-cell-edge-strokes.md
+- TODO.pdf/122-vertical-latin-ruby.md
 - TODO.pdf/13-cjk-text-layout.md
 - TODO.pdf/14-page-item-element-models.md
 - TODO.pdf/15-wire-spread-children.md