idml 0.10.7 → 0.10.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 943028d5bf17ca306e3cce0d23c4b042ddaa9473295f2fa7f4af43009a7423a0
-  data.tar.gz: b9c3c1e5421ffa4de44396dbc94124434dda470c3f10fabd5ddd81146c3991c1
+  metadata.gz: e05a75aaa533dcd8f478d6b4ab635d15cf6c64ac85bebbd42fe3b136ed0c6783
+  data.tar.gz: 3a478cdb4b23ac26ceb9914d5e3740286ef6fda60c80605a01dc6f2a38086b7a
 SHA512:
-  metadata.gz: 86717ea81b1ede4576d3d41e7026cd2731ec40024ea887d33a03c4ff7771384cb0ae9fd04f5948a322d48986dae2946adcebf167a7c51ae3ce7890a28726e7ee
-  data.tar.gz: 12a2089f4600a04fe5cd1d74e409c0933dc6f691156ffca4eeb87fcb25fd5d89e2a1ec58261c8a087ea00b93cf42abee0bb54d64f72032dc3b6bbe919f6cc6b4
+  metadata.gz: effb89c7a3869aa7c268027e4653ecc2072fc41402d53ff2ad8ca0405862b83076bd82637cc9f64a369cd3ceb2ca23b2e6e9ca7ba300de2fd9f073801c65c199
+  data.tar.gz: 371206ab57061b8fa94733db6e489565eeb0cd588ffb6b0908a9a0c6e84fcec2d64745501dd8ec7b8147cb3044119c47d08f479e50cec26e939a35f5127ecf9e

data/TODO.pdf/142-vertical-latin-run-groups.md

@@ -0,0 +1,27 @@
+# TODO PDF 142: Run-grouped Latin rotation in vertical writing
+
+## Status: COMPLETE — implemented 2026-08-27
+
+## Problem
+
+In vertical (StoryOrientation="Vertical") text, every non-CJK glyph
+rotated 90° individually — each Latin letter got its own rotated
+graphics state and stacked one cell apart. InDesign rotates a whole
+Latin run as one block (the word reads sideways as a unit).
+
+## Solution
+
+`TextFrameRenderer#emit_vertical_stack` partitions a vertical run's
+glyphs: CJK singletons stay upright; consecutive non-CJK glyphs
+(groups never span columns, x-reset on column change) render as ONE
+text op inside a single rotated graphics state. The font's natural
+advances land each glyph exactly where per-glyph rotation placed
+it, so the change is lossless for position — but a whole word now
+rotates as a unit and emits one op instead of N. The per-glyph
+`emit_vertical_glyph` path is gone (dead after grouping covered it).
+
+## Files
+
+- `lib/idml/render/renderers/text_frame_renderer.rb`
+- `spec/idml/render/vertical_render_spec.rb`
+- `spec/idml/render/vertical_multirun_spec.rb`

data/TODO.pdf/143-jump-object-below.md

@@ -0,0 +1,31 @@
+# TODO PDF 143: JumpObject wrap — text below the object
+
+## Status: COMPLETE — implemented 2026-08-27
+
+## Problem
+
+JumpObjectTextWrap approximated as the bounding box: text narrowed
+beside the object. InDesign's JumpObject means text NEVER flows
+beside the object — it continues below it.
+
+## Solution
+
+- `TextWrapResolver::Contour` gains a `jump` flag, set from
+  `TextWrapMode="JumpObjectTextWrap"`.
+- A jump contour blocks the FULL frame width in
+  `wrap_adjustment`.
+- `TextFrameRenderer#skip_below_jump_object`: when the run's band
+  is fully blocked (wrap width below the point size), the cursor
+  skips to `jump_contour_bottom` — the blocking object's bottom
+  edge — and the wrap re-measures there once. Text resumes below
+  the object, never beside it.
+
+NextColumn still approximates as the box (it needs column-jump
+chaining, documented in TODO.pdf/61).
+
+## Files
+
+- `lib/idml/render/text_wrap_resolver.rb`
+- `lib/idml/render/renderers/text_frame_renderer.rb`
+- `spec/idml/render/text_wrap_resolver_spec.rb`
+- `spec/idml/render/jump_object_render_spec.rb` (end-to-end)

data/TODO.pdf/144-mojikumi-table-model.md

@@ -0,0 +1,36 @@
+# TODO PDF 144: Named mojikumi sets modeled
+
+## Status: COMPLETE (modeling) — implemented 2026-08-27
+
+## Problem
+
+Designmap-level `<MojikumiTable>` elements (named mojikumi sets:
+詳細 etc. with per-class-pair aki overrides) were ignored by the
+model — a document declaring custom spacing lost that information
+on round-trip.
+
+## Solution
+
+New elements per `designmap.rnc` / `datatype.rnc`:
+
+- `Elements::MojikumiTable` — Self / Name / BasedOnMojikumiSet +
+  `#aki_overrides` (flattened document-order overrides).
+- `Elements::MojikumiTableProperties` — OverrideMojikumiAkiList.
+- `Elements::OverrideMojikumiAkiList` — the entries.
+- `Elements::OverrideMojikumiAki` — all 8 typedef attributes
+  (Target/SideMojikumiClass, SideIsAfterTarget, Minimum/Desired/
+  Maximum, CompressionPriority, AkiDoesNotFloat).
+
+`Parts::Designmap` maps the children; round-trip verified.
+
+**Not yet applied**: rendering still uses the built-in class-based
+aki rules (TODOs 125/132/13); consuming BasedOnMojikumiSet and the
+override entries in `CjkLayout` is the follow-up (TODO.pdf/61).
+
+## Files
+
+- `lib/idml/elements/mojikumi_table.rb`
+- `lib/idml/parts/designmap.rb`
+- `lib/idml/elements.rb`
+- `spec/idml/elements/mojikumi_table_spec.rb`
+- `spec/idml/parts/designmap_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-27
+## Status: DOCUMENTED — refreshed 2026-08-27 (second refresh)
 
 Previously listed limitations (font embedding, tagged PDF, per-run
 styling, dead code) were resolved by TODOs 52/53/55/67/76 long ago;
@@ -27,15 +27,19 @@ this list reflects the current state.
 - **Text wrap**: BoundingBoxTextWrap, Contour, and Inverse modes
   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.
+  variants approximate as BothSides); JumpObject moves text below
+  the object (TODO 143); NextColumn approximates as the box;
+  Contour-mode shapes are not side-aware.
 
 ### CJK
 - **Mojikumi**: script spacing (TODO 125), line-end compression
-  (TODO 132), and class-based pair compression (2026-08-26) are
-  applied; named mojikumi sets (詳細 etc.) are not modeled.
-- **Vertical mode**: Latin rotation is per glyph (not run-grouped);
-  ruby placement is beside-column; keep options do not apply.
+  (TODO 132), and class-based pair compression are applied; named
+  mojikumi sets are modeled (TODO 144: MojikumiTable +
+  OverrideMojikumiAki parse and round-trip) but not yet APPLIED to
+  layout — the built-in class-based aki rules stand in.
+- **Vertical mode**: Latin runs rotate as one group per segment
+  (TODO 142); ruby placement is beside-column; keep options do
+  not apply.
 
 ### Structural features
 - **Endnotes** (TODO 117): reference markers render and endnote TEXT
@@ -56,6 +60,7 @@ this list reflects the current state.
 
 - Hyphenation dictionary integration
 - Shape-mode text wrap contours (side-aware)
-- Named mojikumi sets (詳細 etc.)
+- Apply named mojikumi sets to CJK layout (consume TODO 144's model)
+- NextColumn wrap via column-jump chaining
 - ToBinding / RTL binding alignment
-- Vertical-mode keep options and run-grouped Latin rotation
+- Vertical-mode keep options

data/lib/idml/elements/mojikumi_table.rb

@@ -0,0 +1,85 @@
+# frozen_string_literal: true
+
+module Idml
+  module Elements
+    # One aki override (per `OverrideMojikumiAkiType_TypeDef`):
+    # spacing between the Target and Side character classes, as
+    # minimum / desired / maximum.
+    class OverrideMojikumiAki < Lutaml::Model::Serializable
+      attribute :target_mojikumi_class, :integer
+      attribute :side_mojikumi_class, :integer
+      attribute :side_is_after_target, :boolean
+      attribute :minimum, :float
+      attribute :desired, :float
+      attribute :maximum, :float
+      attribute :compression_priority, :integer
+      attribute :aki_does_not_float, :boolean
+
+      xml do
+        root "OverrideMojikumiAkiType"
+        map_attribute "TargetMojikumiClass", to: :target_mojikumi_class
+        map_attribute "SideMojikumiClass", to: :side_mojikumi_class
+        map_attribute "SideIsAfterTarget", to: :side_is_after_target
+        map_attribute "Minimum", to: :minimum
+        map_attribute "Desired", to: :desired
+        map_attribute "Maximum", to: :maximum
+        map_attribute "CompressionPriority", to: :compression_priority
+        map_attribute "AkiDoesNotFloat", to: :aki_does_not_float
+      end
+    end
+
+    # `<OverrideMojikumiAkiList>` — the per-class-pair override
+    # entries of a named mojikumi set.
+    class OverrideMojikumiAkiList < Lutaml::Model::Serializable
+      attribute :override_mojikumi_aki, OverrideMojikumiAki,
+                collection: true
+
+      xml do
+        root "OverrideMojikumiAkiList"
+        map_element "OverrideMojikumiAkiType",
+                    to: :override_mojikumi_aki
+      end
+    end
+
+    # `<Properties>` inside a MojikumiTable — carries the aki
+    # override list.
+    class MojikumiTableProperties < Lutaml::Model::Serializable
+      attribute :override_mojikumi_aki_list, OverrideMojikumiAkiList,
+                collection: true
+
+      xml do
+        root "Properties"
+        map_element "OverrideMojikumiAkiList",
+                    to: :override_mojikumi_aki_list
+      end
+    end
+
+    # Typed model of `<MojikumiTable>` (TODO 144) — a named
+    # mojikumi set declared at the designmap level. Named sets are
+    # modeled (parsed and round-tripped) but not yet APPLIED: the
+    # renderer keeps using the built-in class-based aki rules (see
+    # TODO.pdf/61).
+    class MojikumiTable < Lutaml::Model::Serializable
+      attribute :self_attr, :string
+      attribute :name, :string
+      attribute :based_on_mojikumi_set, :string
+      attribute :properties, MojikumiTableProperties, collection: true
+
+      xml do
+        root "MojikumiTable"
+        map_attribute "Self", to: :self_attr
+        map_attribute "Name", to: :name
+        map_attribute "BasedOnMojikumiSet", to: :based_on_mojikumi_set
+        map_element "Properties", to: :properties
+      end
+
+      # Aki overrides in document order, flattened across the
+      # Properties > OverrideMojikumiAkiList chain.
+      def aki_overrides
+        properties.flat_map do |prop|
+          prop.override_mojikumi_aki_list.flat_map(&:override_mojikumi_aki)
+        end
+      end
+    end
+  end
+end

data/lib/idml/elements.rb

@@ -90,6 +90,10 @@ module Idml
     autoload :MasterSpreadObject, "idml/elements/master_spread_object"
     autoload :MixedInk, "idml/elements/mixed_ink"
     autoload :MixedInkGroup, "idml/elements/mixed_ink_group"
+    autoload :MojikumiTable, "idml/elements/mojikumi_table"
+    autoload :MojikumiTableProperties, "idml/elements/mojikumi_table"
+    autoload :OverrideMojikumiAki, "idml/elements/mojikumi_table"
+    autoload :OverrideMojikumiAkiList, "idml/elements/mojikumi_table"
     autoload :MojikumiUiPreference, "idml/elements/pref_mojikumi_ui_preference"
     autoload :ObjectExportOption, "idml/elements/object_export_option"
     autoload :ObjectStyle, "idml/elements/object_style"

data/lib/idml/parts/designmap.rb

@@ -54,6 +54,8 @@ module Idml
                 Idml::Elements::HyperlinkPageDestination, collection: true
       attribute :hyperlink_url_destination,
                 Idml::Elements::HyperlinkURLDestination, collection: true
+      attribute :mojikumi_table, Idml::Elements::MojikumiTable,
+                collection: true
 
       xml do
         root "Document"
@@ -99,6 +101,7 @@ module Idml
                     to: :hyperlink_page_destination
         map_element "HyperlinkURLDestination",
                     to: :hyperlink_url_destination
+        map_element "MojikumiTable", to: :mojikumi_table
       end
     end
   end

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

@@ -332,13 +332,60 @@ module Idml
               emit_upright_glyph(canvas, glyph, run, context, size)
             end
           else
-            positioned.each do |glyph|
-              emit_vertical_glyph(canvas, glyph, run, context, size)
-            end
+            emit_vertical_stack(canvas, positioned, run, context, size)
           end
         end
         private_class_method :emit_vertical_run
 
+        # Vertical-stack emission: CJK glyphs stand upright per
+        # glyph; consecutive non-CJK glyphs rotate as ONE group
+        # (the whole Latin word sideways, as InDesign does). The
+        # group's string renders as a single text op inside one
+        # rotated graphics state — the font's advances land each
+        # glyph exactly where per-glyph rotation placed it. A group
+        # never spans columns (x reset) and shares the run's
+        # styling, so one text op is lossless.
+        def self.emit_vertical_stack(canvas, positioned, run, context,
+                                     size)
+          segment = []
+          positioned.each do |glyph|
+            if TextEngine::CjkLayout.cjk?(glyph.codepoint)
+              flush_vertical_segment(canvas, segment, run, context, size)
+              emit_upright_glyph(canvas, glyph, run, context, size)
+            else
+              if !segment.empty? && segment.last.x != glyph.x
+                flush_vertical_segment(canvas, segment, run, context, size)
+              end
+              segment << glyph
+            end
+          end
+          flush_vertical_segment(canvas, segment, run, context, size)
+        end
+        private_class_method :emit_vertical_stack
+
+        def self.flush_vertical_segment(canvas, segment, run, context,
+                                        size)
+          return if segment.empty?
+
+          text = segment.map { |g| [g.codepoint].pack("U") }.join
+          first = segment.first
+          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, first.x, first.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
+        private_class_method :flush_vertical_segment
+
         def self.emit_upright_glyph(canvas, positioned, run, context,
                                     size)
           text = [positioned.codepoint].pack("U")
@@ -361,43 +408,6 @@ module Idml
         end
         private_class_method :vertical_fits?
 
-        # 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")
-          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
@@ -881,6 +891,10 @@ module Idml
               context, layout_frame, cursor_y, run
             )
             run_wrap -= wrap_reduction
+            cursor_y, run_wrap, wrap_shift = skip_below_jump_object(
+              context, layout_frame, cursor_y, run, run_wrap, wrap_shift,
+              wrap_reduction, bottom_limit
+            )
             positioned, next_y = layout_run(
               canvas, run, paragraph, context, layout_frame, font,
               run_wrap, cursor_y, space_before,
@@ -946,6 +960,42 @@ module Idml
         end
         private_class_method :render_footnote_entries
 
+        # JumpObjectTextWrap blocks the full column width: when the
+        # run's band is fully blocked, move the cursor below the
+        # object's bottom edge and re-measure once. InDesign's
+        # semantics — text flows under the object, never beside it.
+        # Returns the (possibly skipped) cursor and re-measured
+        # wrap geometry.
+        def self.skip_below_jump_object(context, layout_frame, cursor_y,
+                                        run, run_wrap, wrap_shift,
+                                        wrap_reduction, bottom_limit)
+          min_width = run.point_size || DEFAULT_SIZE
+          return [cursor_y, run_wrap, wrap_shift] if run_wrap >= min_width
+
+          skip_y = text_wrap_jump_below(context, layout_frame, cursor_y, run)
+          return [cursor_y, run_wrap, wrap_shift] unless skip_y
+          return [cursor_y, run_wrap, wrap_shift] if skip_y >= cursor_y
+          return [cursor_y, run_wrap, wrap_shift] if skip_y <= bottom_limit
+
+          reduction, shift = text_wrap_adjust(context, layout_frame,
+                                              skip_y, run)
+          [skip_y, [run_wrap + wrap_reduction - reduction, 0].max, shift]
+        end
+        private_class_method :skip_below_jump_object
+
+        def self.text_wrap_jump_below(context, layout_frame, cursor_y, run)
+          resolver = context.text_wrap_resolver
+          return nil 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)
+          resolver.jump_contour_bottom(cursor_y, size, frame_x,
+                                       frame_right)
+        end
+        private_class_method :text_wrap_jump_below
+
         # 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

data/lib/idml/render/text_wrap_resolver.rb

@@ -18,7 +18,7 @@ module Idml
     class TextWrapResolver
       # A wrap contour: a PDF-coordinate rectangle the text avoids.
       Contour = Struct.new(
-        :x, :y, :width, :height, :inverse, :side,
+        :x, :y, :width, :height, :inverse, :side, :jump,
         keyword_init: true
       )
 
@@ -86,10 +86,34 @@ module Idml
 
         return [0.0, 0.0] if overlap.zero?
 
+        # JumpObject: text never flows beside the object — the full
+        # frame width is blocked and the renderer skips the run
+        # below the object's bottom edge.
+        return [frame_right - frame_x, 0.0] if contour.jump
+
         side_adjustment(contour, overlap, frame_x, frame_right)
       end
       private :box_adjustment
 
+      # Bottom edge of the lowest jump contour overlapping the given
+      # band — where text resumes below a JumpObject. nil when no
+      # jump contour blocks the band.
+      def jump_contour_bottom(line_y, line_height, frame_x, frame_right)
+        bottoms = @contours.filter_map do |contour|
+          next unless box_contour?(contour) && contour.jump
+          next unless y_overlap?(contour, line_y, line_height) &&
+            x_overlap?(contour, frame_x, frame_right)
+
+          contour.y
+        end
+        bottoms.min
+      end
+
+      def box_contour?(contour)
+        !contour.is_a?(WrapContour::Shape)
+      end
+      private :box_contour?
+
       def side_adjustment(contour, overlap, frame_x, frame_right)
         case contour.side
         when "LeftSide"
@@ -165,7 +189,8 @@ module Idml
         Contour.new(
           x: rect[:x], y: rect[:y],
           width: rect[:width], height: rect[:height],
-          side: pref&.text_wrap_side
+          side: pref&.text_wrap_side,
+          jump: pref&.text_wrap_mode == "JumpObjectTextWrap"
         )
       end
       private_class_method :box_contour

data/lib/idml/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: idml
 version: !ruby/object:Gem::Version
-  version: 0.10.7
+  version: 0.10.8
 platform: ruby
 authors:
 - Ribose
@@ -205,6 +205,9 @@ files:
 - 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/142-vertical-latin-run-groups.md
+- TODO.pdf/143-jump-object-below.md
+- TODO.pdf/144-mojikumi-table-model.md
 - TODO.pdf/15-wire-spread-children.md
 - TODO.pdf/16-typed-model-pipeline.md
 - TODO.pdf/17-shape-rendering.md
@@ -348,6 +351,7 @@ files:
 - lib/idml/elements/master_spread_object.rb
 - lib/idml/elements/mixed_ink.rb
 - lib/idml/elements/mixed_ink_group.rb
+- lib/idml/elements/mojikumi_table.rb
 - lib/idml/elements/object_export_option.rb
 - lib/idml/elements/object_style.rb
 - lib/idml/elements/object_style_content_effects_category_settings.rb