sevgi-sundries 0.93.1 → 0.94.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6094018249be152bff171c6077c6b5f7c9bd9f0d24c68381afbe05674e121da0
-  data.tar.gz: 8b9a02a83b2fd4b3614b65fed7c7922b611b78790e187167db3361cdd301cdeb
+  metadata.gz: e8ddc5568e2938adbef615c7bc12663083287016955cd708bd342ec95423bfea
+  data.tar.gz: 64b06db206dcf954131c8348e0e1871a39c80677f83a15fc683cc84ab943d2aa
 SHA512:
-  metadata.gz: ea257e8c2b131b3ae278d35d14850391f6a4bf33467a528d87aa5ec0cd8dd3c4109376da978a3fdd4352d230f5c668d268914e390f33be4c1d28a775d5eabee9
-  data.tar.gz: 7ba89c1d630142ac180bc64aaa15564bb2d54b5a5e68daa1cd2a814f546cef6c1b76d08ff8504f64e4d0a9880c505577ca958c9ae96ce3e814fb584035593879
+  metadata.gz: de63cbabb66ebaa15dfbb78d4aa5cb14384fb8414c15cd13f4a5e1665c3e8a28d66bfef4e7014acb51c486024efcc1e545f04d10172b228716e27050ac1854ff
+  data.tar.gz: 9b74f16efebe20b184b0ba277d588e20403cb3633256868b03b8d9bcf608f846bb266283283bbf7316e65fb0de5c065d69e20ab3f5fd5c7c597ecf74b0f1bc57

data/CHANGELOG.md

@@ -0,0 +1,4 @@
+# Changelog
+
+Sevgi Sundries follows the root Sevgi release notes:
+https://github.com/roktas/sevgi/blob/main/CHANGELOG.md

data/LICENSE

@@ -0,0 +1,5 @@
+Sevgi Sundries is distributed under the GNU General Public License v3.0 or later.
+
+SPDX-License-Identifier: GPL-3.0-or-later
+
+Full project license: https://github.com/roktas/sevgi/blob/main/LICENSE

data/README.md

@@ -1,5 +1,55 @@
 # Sevgi Sundries
 
-Provides helper objects and export tools for Sevgi drawings.
+Helper objects and export tools for Sevgi drawings.
 
-See the root [README](../README.md) and the documentation site for usage.
+## Install
+
+```sh
+gem install sevgi-sundries
+```
+
+## Require
+
+```ruby
+require "sevgi/sundries"
+```
+
+## Example
+
+```ruby
+rect = Sevgi::Geometry::Rect[3, 5]
+tile = Sevgi::Sundries::Tile.new(rect)
+tile.box.height
+```
+
+## Ruby compatibility
+
+Requires Ruby 3.4.0 or newer. CI verifies Ruby 3.4 and the current development Ruby from `.ruby-version`.
+
+## Native prerequisites
+
+Basic ruler, grid, and tile helpers need only Ruby dependencies. Installing `sevgi-sundries` does not install native
+export gems.
+
+PDF/PNG export helpers load the optional Ruby gems `cairo`, `rsvg2`, and `hexapdf` only when export is used. Install
+their system libraries and gems separately:
+
+```sh
+sudo apt-get update
+sudo apt-get install -y libcairo2-dev libgdk-pixbuf-2.0-dev libgirepository1.0-dev libglib2.0-dev librsvg2-dev pkg-config
+gem install cairo rsvg2 hexapdf
+```
+
+On macOS with Homebrew:
+
+```sh
+brew install cairo gdk-pixbuf gobject-introspection librsvg pkg-config
+gem install cairo rsvg2 hexapdf
+```
+
+## Links
+
+- Documentation: https://sevgi.roktas.dev
+- API documentation: https://www.rubydoc.info/gems/sevgi-sundries
+- Source: https://github.com/roktas/sevgi/tree/main/sundries
+- Changelog: https://github.com/roktas/sevgi/blob/main/CHANGELOG.md

data/lib/sevgi/sundries/export/native.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require_relative "../export"
+
 require "cairo"
 require "fileutils"
 require "hexapdf"
@@ -8,13 +10,12 @@ require "tempfile"
 
 module Sevgi
   module Sundries
-    # Exports SVG content and post-processes PDF output.
     module Export
-      # Raised when SVG export or PDF post-processing cannot be completed.
-      ExportError = Class.new(Error)
-
-      # Default SVG CSS pixel density.
-      DEFAULT_DPI = 96.0
+      %i[
+        call
+        stamp
+        stamp!
+      ].each { remove_method(it) if method_defined?(it) }
 
       # Exports SVG source to a PDF or PNG file using librsvg and Cairo.
       # @param svg [String] SVG source content
@@ -30,7 +31,7 @@ module Sevgi
       # @return [Object] the original output argument
       # @raise [Sevgi::ArgumentError] when SVG content is not a string or output is blank
       # @raise [Sevgi::Sundries::Export::ExportError] when format, SVG parsing, SVG dimensions, or render dimensions are invalid
-      def self.call(svg, output, format: nil, width: nil, height: nil, dpi: DEFAULT_DPI, css: nil, &block)
+      def call(svg, output, format: nil, width: nil, height: nil, dpi: DEFAULT_DPI, css: nil, &block)
         ArgumentError.("SVG content must be a String") unless svg.is_a?(String)
         ArgumentError.("Export output must be provided") if output.nil? || output.to_s.strip.empty?
 
@@ -71,81 +72,49 @@ module Sevgi
         output
       end
 
-      # Supported export format names mapped to file extensions.
-      AVAILABLE = (EXTENSIONS = {
-        ".pdf" => :pdf,
-        ".png" => :png
-      }.freeze)
-        .invert
-        .freeze
-
-      # Resolves the export format from an explicit value or output extension.
-      # @param format [Symbol, String, nil] explicit format
-      # @param output [String, #to_s] output path
-      # @return [Symbol] resolved format
-      # @raise [Sevgi::Sundries::Export::ExportError] when the explicit format or output extension is unsupported
-      def format_for!(format, output)
-        if format
-          format = format.to_sym
-          ExportError.("Unsupported export format: #{format}") unless AVAILABLE.key?(format)
-
-          format
-        else
-          ext = File.extname(output.to_s).downcase
-          ExportError.("Unrecognized file extension: #{ext}") unless EXTENSIONS.key?(ext)
-
-          EXTENSIONS[ext]
-        end
-      end
-
-      # Inserts CSS before the closing svg tag.
-      # @param svg [String] SVG source content
-      # @param css [String] CSS source content
-      # @return [String] SVG source with an added style element when a closing svg tag is present
-      def inject(svg, css) = svg.sub("</svg>", "<style>#{css}</style></svg>")
-
-      # Replaces a placeholder text object in a PDF stream.
+      # Replaces exact placeholder text objects in PDF streams.
+      # The placeholder must appear as a PDF literal string in a white text object matching the export stamp pattern.
+      # Replacement text is escaped as a PDF literal string. When no exact match is replaced, the output file is not
+      # written.
       # @param infile [String] source PDF file path
       # @param outfile [String] destination PDF file path
       # @param stamp [String] replacement text
       # @param placeholder [String] placeholder text to replace
-      # @return [Boolean] true when a matching placeholder was replaced
-      # @raise [Sevgi::Sundries::Export::ExportError] when the PDF files cannot be read, written, or stamped
+      # @return [Boolean] true when at least one matching placeholder was replaced
+      # @raise [Sevgi::Sundries::Export::ExportError] when the PDF cannot be read, rewritten, or stamped
       def stamp(infile, outfile, stamp:, placeholder:)
         doc = HexaPDF::Document.open(infile)
-        stamped = false
+        replacements = 0
 
         doc.pages.each do |page|
           Array(page[:Contents]).each do |ref|
             obj = doc.object(ref)
             next unless obj.respond_to?(:stream)
 
-            data = obj.stream
-            next unless data.include?("(#{placeholder})")
+            data, count = stamp_stream(obj.stream, stamp:, placeholder:)
+            next if count.zero?
 
-            data = data.gsub(
-              %r{1 1 1 rg (BT\s+.*?/\S+ \d+ Tf\s+)\(#{Regexp.escape(placeholder)}\)Tj}m,
-              "0.101961 0.101961 0.101961 rg \\1(#{stamp})Tj"
-            )
+            replacements += count
 
             obj.stream = data
             obj.set_filter(:FlateDecode)
-            stamped = true
           end
         end
 
-        doc.write(outfile, optimize: true) if stamped
-        stamped
+        doc.write(outfile, optimize: true) if replacements.positive?
+        replacements.positive?
       rescue HexaPDF::Error, ::SystemCallError => e
         ExportError.("PDF stamp error: #{e.message}")
       end
 
-      # Replaces a placeholder text object inside a PDF file in place.
+      # Replaces exact placeholder text objects inside a PDF file in place.
+      # The input file is replaced only after at least one exact placeholder match is rewritten into a non-empty output
+      # file.
       # @param infile [String] PDF file path to modify
       # @param stamp [String] replacement text
       # @param placeholder [String] placeholder text to replace
-      # @return [Boolean] true when a matching placeholder was replaced
-      # @raise [Sevgi::Sundries::Export::ExportError] when the PDF file cannot be read, written, stamped, or replaced
+      # @return [Boolean] true when at least one matching placeholder was replaced
+      # @raise [Sevgi::Sundries::Export::ExportError] when the PDF cannot be read, rewritten, stamped, or replaced
       def stamp!(infile, stamp:, placeholder:)
         temp = Tempfile.new(%w[stamp .pdf], File.dirname(infile))
         stamped = stamp(infile, temp.path, stamp:, placeholder:)
@@ -234,6 +203,34 @@ module Sevgi
 
           width.round.positive? && height.round.positive?
         end
+
+        PDF_LITERAL_ESCAPE = {
+          "\\" => "\\\\",
+          "(" => "\\(",
+          ")" => "\\)",
+          "\b" => "\\b",
+          "\f" => "\\f",
+          "\n" => "\\n",
+          "\r" => "\\r",
+          "\t" => "\\t"
+        }.freeze
+
+        private_constant :PDF_LITERAL_ESCAPE
+
+        def pdf_literal(text)
+          "(#{text.to_s.each_char.map { PDF_LITERAL_ESCAPE.fetch(it, it) }.join})"
+        end
+
+        def stamp_stream(data, stamp:, placeholder:)
+          count = 0
+          pattern = %r{1 1 1 rg (BT\s+.*?/\S+ \d+ Tf\s+)#{Regexp.escape(pdf_literal(placeholder))}Tj}m
+          stamped = data.gsub(pattern) do
+            count += 1
+            "0.101961 0.101961 0.101961 rg #{Regexp.last_match(1)}#{pdf_literal(stamp)}Tj"
+          end
+
+          [stamped, count]
+        end
       end
 
       # Low-level format renderers used by {Export.call}.

data/lib/sevgi/sundries/export.rb

@@ -1,4 +1,118 @@
 # frozen_string_literal: true
 
-require_relative "export/native"
+require "sevgi/function"
+
 require_relative "export/system"
+
+module Sevgi
+  module Sundries
+    # Exports SVG content and post-processes PDF output.
+    #
+    # Native PDF/PNG rendering is loaded lazily so installing `sevgi-sundries` for SVG-only helpers does not require the
+    # Cairo, RSVG, or HexaPDF gems. Native export entrypoints raise {Sevgi::MissingComponentError} when those optional
+    # gems are unavailable.
+    module Export
+      # Supported export format names mapped to file extensions.
+      AVAILABLE = (EXTENSIONS = {
+        ".pdf" => :pdf,
+        ".png" => :png
+      }.freeze)
+        .invert
+        .freeze
+
+      # Default SVG CSS pixel density.
+      DEFAULT_DPI = 96.0
+
+      # Raised when SVG export or PDF post-processing cannot be completed.
+      ExportError = Class.new(Error)
+
+      NATIVE_COMPONENTS = %w[
+        cairo
+        hexapdf
+        rsvg2
+      ].freeze
+
+      private_constant :NATIVE_COMPONENTS
+
+      # @overload call(svg, output, format: nil, width: nil, height: nil, dpi: DEFAULT_DPI, css: nil)
+      #   Exports SVG source to a PDF or PNG file using the optional native export gems.
+      #   @param svg [String] SVG source content
+      #   @param output [String, #to_s] output file path
+      #   @param format [Symbol, String, nil] explicit output format, or nil to infer from output extension
+      #   @param width [Numeric, nil] target width in output pixels for PNG, or CSS pixels before PDF point conversion
+      #   @param height [Numeric, nil] target height in output pixels for PNG, or CSS pixels before PDF point conversion
+      #   @param dpi [Numeric] CSS pixel density used for absolute SVG units and PDF point conversion
+      #   @param css [String, nil] CSS inserted before the closing svg tag before rendering
+      #   @yield [svg] optional source transformation applied before rendering
+      #   @yieldparam svg [String] SVG source after optional CSS injection
+      #   @yieldreturn [String] SVG source to render
+      #   @return [Object] the original output argument
+      #   @raise [Sevgi::ArgumentError] when SVG content is not a string or output is blank
+      #   @raise [Sevgi::MissingComponentError] when cairo, hexapdf, or rsvg2 is unavailable
+      #   @raise [Sevgi::Sundries::Export::ExportError] when format, SVG parsing, SVG dimensions, or render dimensions
+      #     are invalid
+      def call(*args, **kwargs, &block) = native!.call(*args, **kwargs, &block)
+
+      # Resolves the export format from an explicit value or output extension.
+      # @param format [Symbol, String, nil] explicit format
+      # @param output [String, #to_s] output path
+      # @return [Symbol] resolved format
+      # @raise [Sevgi::Sundries::Export::ExportError] when the explicit format or output extension is unsupported
+      def format_for!(format, output)
+        if format
+          format = format.to_sym
+          ExportError.("Unsupported export format: #{format}") unless AVAILABLE.key?(format)
+
+          format
+        else
+          ext = File.extname(output.to_s).downcase
+          ExportError.("Unrecognized file extension: #{ext}") unless EXTENSIONS.key?(ext)
+
+          EXTENSIONS[ext]
+        end
+      end
+
+      # Inserts CSS before the closing svg tag.
+      # @param svg [String] SVG source content
+      # @param css [String] CSS source content
+      # @return [String] SVG source with an added style element when a closing svg tag is present
+      # @raise [NoMethodError] when SVG content does not support string substitution
+      def inject(svg, css) = svg.sub("</svg>", "<style>#{css}</style></svg>")
+
+      # Replaces exact placeholder text objects in PDF streams.
+      # @param infile [String] source PDF file path
+      # @param outfile [String] destination PDF file path
+      # @param stamp [String] replacement text
+      # @param placeholder [String] placeholder text to replace
+      # @return [Boolean] true when at least one matching placeholder was replaced
+      # @raise [Sevgi::MissingComponentError] when native export gems are unavailable
+      # @raise [Sevgi::Sundries::Export::ExportError] when the PDF cannot be read, rewritten, or stamped
+      def stamp(infile, outfile, stamp:, placeholder:) = native!.stamp(infile, outfile, stamp:, placeholder:)
+
+      # Replaces exact placeholder text objects inside a PDF file in place.
+      # @param infile [String] PDF file path to modify
+      # @param stamp [String] replacement text
+      # @param placeholder [String] placeholder text to replace
+      # @return [Boolean] true when at least one matching placeholder was replaced
+      # @raise [Sevgi::MissingComponentError] when native export gems are unavailable
+      # @raise [Sevgi::Sundries::Export::ExportError] when the PDF cannot be read, rewritten, stamped, or replaced
+      def stamp!(infile, stamp:, placeholder:) = native!.stamp!(infile, stamp:, placeholder:)
+
+      extend self
+
+      class << self
+        private
+
+        def native!
+          require_relative "export/native"
+
+          self
+        rescue ::LoadError => e
+          raise unless NATIVE_COMPONENTS.include?(e.path)
+
+          MissingComponentError.(NATIVE_COMPONENTS.join(", "))
+        end
+      end
+    end
+  end
+end

data/lib/sevgi/sundries/grid.rb

@@ -51,7 +51,6 @@ module Sevgi
       def width = x.d
 
       # Axis wrapper exposing grid line queries for one ruler direction.
-      # @api private
       class Axis < DelegateClass(Ruler)
         # Returns the major line query.
         # @return [Sevgi::Sundries::Grid::Axis::Major]
@@ -78,7 +77,6 @@ module Sevgi
         end
 
         # Memoized grid line query for an axis.
-        # @api private
         class Query
           # Creates a query.
           # @param this [Sevgi::Sundries::Grid::Axis] axis receiving generated lines
@@ -104,7 +102,6 @@ module Sevgi
         end
 
         # Major grid line query.
-        # @api private
         class Major < Query
           # Returns lines at major tick distances.
           # @return [Array<Sevgi::Geometry::Line>]
@@ -112,7 +109,6 @@ module Sevgi
         end
 
         # Midpoint grid line query.
-        # @api private
         class Halve < Query
           # Returns lines at midpoint tick distances.
           # @return [Array<Sevgi::Geometry::Line>]
@@ -120,7 +116,6 @@ module Sevgi
         end
 
         # Minor grid line query.
-        # @api private
         class Minor < Query
           # Returns lines at minor tick distances.
           # @return [Array<Sevgi::Geometry::Line>]
@@ -129,7 +124,6 @@ module Sevgi
       end
 
       # Horizontal grid axis.
-      # @api private
       class X < Axis
         # Returns the base horizontal line for this axis.
         # @return [Sevgi::Geometry::Line]
@@ -142,7 +136,6 @@ module Sevgi
       end
 
       # Vertical grid axis.
-      # @api private
       class Y < Axis
         # Creates a vertical axis wrapper.
         # @param this [Sevgi::Sundries::Ruler] horizontal ruler

data/lib/sevgi/sundries/ruler.rb

@@ -20,7 +20,10 @@ module Sevgi
       # @param n [Integer] non-negative interval count
       # @return [Sevgi::Sundries::Interval]
       # @raise [Sevgi::ArgumentError] when count is not a non-negative integer
-      # @raise [Sevgi::ArgumentError] when the unit length cannot be measured
+      # @raise [Sevgi::ArgumentError] when the unit object does not expose length
+      # @raise [Sevgi::ArgumentError] when the measured unit length is not numeric
+      # @raise [Sevgi::ArgumentError] when the measured unit length is not finite
+      # @raise [Sevgi::ArgumentError] when the measured unit length is not positive
       def self.[](e, n) = new(e, n)
 
       # @!attribute [r] n
@@ -34,12 +37,13 @@ module Sevgi
       # @param n [Integer] non-negative interval count
       # @return [void]
       # @raise [Sevgi::ArgumentError] when count is not a non-negative integer
-      # @raise [Sevgi::ArgumentError] when the unit length cannot be measured
+      # @raise [Sevgi::ArgumentError] when the unit object does not expose length
+      # @raise [Sevgi::ArgumentError] when the measured unit length is not numeric
+      # @raise [Sevgi::ArgumentError] when the measured unit length is not finite
+      # @raise [Sevgi::ArgumentError] when the measured unit length is not positive
       def initialize(e, n)
-        ArgumentError.("Interval count must be a non-negative Integer") unless n.is_a?(::Integer) && !n.negative?
-
+        @n = non_negative_integer(n, "Interval count")
         @u = measure(e)
-        @n = n
       end
 
       # Returns a major tick distance by index.
@@ -50,7 +54,10 @@ module Sevgi
       # Counts how many whole lengths fit into this interval.
       # @param length [Numeric] candidate length
       # @return [Integer]
-      def count(length) = (d / length.to_f).to_i
+      # @raise [Sevgi::ArgumentError] when length is not numeric
+      # @raise [Sevgi::ArgumentError] when length is not finite
+      # @raise [Sevgi::ArgumentError] when length is not positive
+      def count(length) = (d / positive_number(length, "Interval count length")).to_i
 
       # Returns the total interval distance.
       # @return [Float]
@@ -82,11 +89,50 @@ module Sevgi
       private
 
       def measure(e)
-        return e.to_f if e.is_a?(::Numeric)
+        value = if e.is_a?(::Numeric)
+          e
+        else
+          ArgumentError.("#{e.class}#length must be implemented") unless e.respond_to?(:length)
+
+          e.length
+        end
+
+        positive_number(value, "Interval unit length")
+      end
+
+      def non_negative_integer(value, field)
+        ArgumentError.("#{field} must be a non-negative Integer") unless value.is_a?(::Integer) && !value.negative?
+
+        value
+      end
+
+      def non_negative_number(value, field)
+        number = numeric(value, field)
+        ArgumentError.("#{field} must be non-negative") if number.negative?
+
+        number
+      end
+
+      def numeric(value, field)
+        ArgumentError.("#{field} must be Numeric") unless value.is_a?(::Numeric)
+
+        number = value.to_f
+        ArgumentError.("#{field} must be finite") unless number.finite?
+
+        number
+      end
 
-        ArgumentError.("#{e.class}#length must be implemented") unless e.respond_to?(:length)
+      def positive_integer(value, field)
+        ArgumentError.("#{field} must be a positive Integer") unless value.is_a?(::Integer) && value.positive?
 
-        e.length
+        value
+      end
+
+      def positive_number(value, field)
+        number = numeric(value, field)
+        ArgumentError.("#{field} must be positive") unless number.positive?
+
+        number
       end
     end
 
@@ -116,16 +162,22 @@ module Sevgi
       # @param multiple [Integer] number of subinterval units per major interval
       # @param margin [Numeric] minimum margin on each side
       # @return [void]
-      # @raise [Sevgi::ArgumentError] when unit or multiple is not positive
+      # @raise [Sevgi::ArgumentError] when brut is not numeric
+      # @raise [Sevgi::ArgumentError] when brut is not finite
+      # @raise [Sevgi::ArgumentError] when brut is negative
+      # @raise [Sevgi::ArgumentError] when unit is not numeric
+      # @raise [Sevgi::ArgumentError] when unit is not finite
+      # @raise [Sevgi::ArgumentError] when unit is not positive
+      # @raise [Sevgi::ArgumentError] when multiple is not a positive integer
+      # @raise [Sevgi::ArgumentError] when margin is not numeric
+      # @raise [Sevgi::ArgumentError] when margin is not finite
       # @raise [Sevgi::ArgumentError] when margin is negative
       # @raise [Sevgi::ArgumentError] when the fitting span is negative
       def initialize(brut:, unit:, multiple:, margin: 0.0)
-        ArgumentError.("Ruler unit must be positive") unless unit.to_f.positive?
-        ArgumentError.("Ruler multiple must be positive") unless multiple.to_f.positive?
-        ArgumentError.("Ruler margin must be non-negative") if margin.to_f.negative?
-
-        @brut = brut.to_f
-        margin = margin.to_f
+        @brut = non_negative_number(brut, "Ruler brut")
+        unit = positive_number(unit, "Ruler unit")
+        multiple = positive_integer(multiple, "Ruler multiple")
+        margin = non_negative_number(margin, "Ruler margin")
         @sub = Interval.new(unit, multiple)
 
         n = divide(unit:, multiple:, brut: @brut, margin:)

data/lib/sevgi/sundries/tile.rb

@@ -24,13 +24,14 @@ module Sevgi
       # @return [void]
       # @raise [Sevgi::ArgumentError] when element is not a geometry element
       # @raise [Sevgi::ArgumentError] when nx or ny is not a positive integer
+      # @raise [Sevgi::ArgumentError] when position is not a point or two-number array
       def initialize(element, position: Geometry::Origin, nx: 1, ny: 1)
         ArgumentError.("Must be an Element object: #{element}") unless element.is_a?(Geometry::Element)
         ArgumentError.("Tile nx must be positive") unless nx.is_a?(::Integer) && nx.positive?
         ArgumentError.("Tile ny must be positive") unless ny.is_a?(::Integer) && ny.positive?
 
         @element = element
-        @position = position
+        @position = self.class.send(:position, position)
 
         @nx = nx
         @ny = ny
@@ -97,6 +98,22 @@ module Sevgi
 
       private
 
+      # Coerces a public tile position.
+      # @param position [Sevgi::Geometry::Point, Array<Numeric>] tile origin
+      # @return [Sevgi::Geometry::Point]
+      # @raise [Sevgi::ArgumentError] when position is not a point or two-number array
+      def self.position(position)
+        return position if position.is_a?(Geometry::Point)
+
+        unless position.is_a?(::Array) && position.size == 2 && position.all?(::Numeric)
+          ArgumentError.("Tile position must be a Point or two-number Array")
+        end
+
+        Geometry::Point[*position]
+      end
+
+      private_class_method :position
+
       def coordinate(i, j = 0) = position.translate(j * element.box.width, i * element.box.height)
     end
   end

data/lib/sevgi/sundries/version.rb

@@ -3,6 +3,6 @@
 module Sevgi
   module Sundries
     # Component version.
-    VERSION = "0.93.1"
+    VERSION = "0.94.0"
   end
 end

data/lib/sevgi/sundries.rb

@@ -1,6 +1,8 @@
 # frozen_string_literal: true
 
 require "sevgi/function"
+require "sevgi/geometry"
+require "sevgi/graphics"
 
 require_relative "sundries/ruler"
 require_relative "sundries/tile"
@@ -12,6 +14,10 @@ require_relative "sundries/version"
 
 module Sevgi
   # Layout, tiling, grid, and export helpers shared by Sevgi consumers.
+  #
+  # This component loads its eager public surfaces directly. `Ruler`, `Tile`, and `Grid` therefore require
+  # `sevgi-function`, `sevgi-geometry`, and `sevgi-graphics` as runtime dependencies of the `sevgi-sundries` gem.
+  # Native PDF/PNG export gems are optional and loaded only by {Export} when export is used.
   module Sundries
   end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sevgi-sundries
 version: !ruby/object:Gem::Version
-  version: 0.93.1
+  version: 0.94.0
 platform: ruby
 authors:
 - Recai Oktaş
@@ -15,62 +15,50 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.93.1
+        version: 0.94.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.93.1
+        version: 0.94.0
 - !ruby/object:Gem::Dependency
-  name: cairo
+  name: sevgi-geometry
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-- !ruby/object:Gem::Dependency
-  name: hexapdf
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: 0.94.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - '='
       - !ruby/object:Gem::Version
-        version: '1.5'
+        version: 0.94.0
 - !ruby/object:Gem::Dependency
-  name: rsvg2
+  name: sevgi-graphics
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: 4.3.6
+        version: 0.94.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - '='
       - !ruby/object:Gem::Version
-        version: 4.3.6
+        version: 0.94.0
 description: Enhances the Sevgi toolkit with helper objects.
 email: roktas@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- LICENSE
 - README.md
 - lib/sevgi/sundries.rb
 - lib/sevgi/sundries/export.rb
@@ -95,7 +83,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.4.0.pre.preview1
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="