sevgi-graphics 0.98.2 → 1.1.0

data/lib/sevgi/graphics/mixtures/save.rb

@@ -54,10 +54,10 @@ module Sevgi
 
         # Saves rendered SVG when its content differs from the destination.
         # Relative destinations are expanded before being returned. When a non-empty backup suffix is given, an
-        # existing destination is copied immediately before replacement; unchanged saves leave both files untouched.
+        # existing destination is copied immediately before replacement. Unchanged saves leave both files untouched.
         # Missing parent directories are created. An existing directory target uses the default file name.
         # @example Save to a relative destination
-        #   path = Sevgi::Graphics.SVG(:minimal).Save("build/drawing.svg")
+        #   path = Sevgi::Graphics.SVG.Save("build/drawing.svg")
         #   path == File.expand_path("build/drawing.svg") # => true
         # @param path [String, #to_path, nil] output path or existing directory
         # @param default [String, #to_path, nil] default output path
@@ -74,7 +74,7 @@ module Sevgi
         # @see Sevgi::Graphics::Document::Proto#call
         def Save(path = nil, default: nil, backup_suffix: nil, **kwargs, &filter)
           default = F.subext(EXT, caller_locations(1..1).first.path) if default.nil?
-          path = Path.resolve(path, default:, context: "Save")
+          path = F.output_path(path, default:, context: "Save")
 
           Writer.(path, self.(**kwargs), backup_suffix:, &filter)
         end
@@ -94,7 +94,7 @@ module Sevgi
         # @raise [SystemCallError] when the destination cannot be read or written
         # @see Sevgi::Graphics::Document::Proto#call
         def Write(path, **kwargs, &filter)
-          path = Path.(path, context: "Write path")
+          path = F.path(path, context: "Write path")
           ArgumentError.("Write path must name a file") if ::File.directory?(path)
 
           Writer.(path, self.(**kwargs), &filter)

data/lib/sevgi/graphics/mixtures/style/declaration.rb

@@ -0,0 +1,117 @@
+# frozen_string_literal: true
+
+require "json"
+
+module Sevgi
+  module Graphics
+    module Mixtures
+      module Style
+        # Immutable authoring declaration for editable PDF paint properties.
+        # Source selectors stay here; the producer resolves them to PDF targets and baselines.
+        # @api private
+        class Declaration
+          # Captures a declaration without changing the SVG or loading a PDF backend.
+          # @param definition [Hash] targets, parameters, optional groups and profileSets
+          # @yield evaluates authoring operations in a private builder
+          # @yieldreturn [Object] ignored block result
+          # @return [void]
+          # @raise [Sevgi::ArgumentError] when the declaration is not finite, acyclic JSON data
+          def initialize(definition = {}, &block)
+            ArgumentError.("Style declaration must be a Hash") unless definition.is_a?(::Hash)
+            ArgumentError.("Style accepts a declaration or a block") if block && !definition.empty?
+
+            definition = Builder.new.call(&block) if block
+            @definition = Snapshot.capture(definition)
+            validate
+            freeze
+          end
+
+          # Returns the owned, deeply frozen declaration with JSON String keys.
+          # @return [Hash{String => Object}] producer authoring declaration
+          def to_h = @definition
+
+          private
+
+          def validate
+            unknown = @definition.keys - %w[targets parameters groups profileSets]
+            ArgumentError.("Unknown Style field: #{unknown.first}") unless unknown.empty?
+            return if %w[targets parameters].all? { @definition[it].is_a?(::Hash) }
+            ArgumentError.("Style requires targets and parameters")
+          end
+
+          # Authoring operations kept outside the SVG method namespace.
+          # @api private
+          class Builder
+            def initialize
+              @definition = {targets: {}, parameters: {}, groups: [], profileSets: []}
+            end
+
+            def call(&block)
+              instance_exec(&block)
+              @definition
+            end
+
+            def Target(id, selectors:, fill: false, display: Undefined)
+              record = {selectors:, fill:}
+              record[:display] = display unless display.equal?(Undefined)
+              add(:targets, id, record)
+            end
+
+            def Param(id, targets:, property:, schema:, value: Undefined)
+              record = {schema:, binding: {targets:, property:}}
+              record[:value] = value unless value.equal?(Undefined)
+              add(:parameters, id, record)
+            end
+
+            def Group(title, parameters:, description: nil)
+              record = {title:, parameters:}
+              record[:description] = description unless description.nil?
+              @definition[:groups] << record
+            end
+
+            def Profiles(id, name:, parameters:, profiles:, description: nil)
+              record = {id:, name:, parameters:, profiles:}
+              record[:description] = description unless description.nil?
+              @definition[:profileSets] << record
+            end
+
+            private
+
+            def add(field, id, value)
+              unless (id.is_a?(::String) || id.is_a?(::Symbol)) && !id.to_s.empty?
+                ArgumentError.("Style id must be nonempty text")
+              end
+              id = id.to_s
+              ArgumentError.("Duplicate Style id: #{id}") if @definition[field].key?(id)
+              @definition[field][id] = value
+            end
+          end
+
+          # JSON ownership rules differ from XML profile metadata.
+          # @api private
+          module Snapshot
+            def self.capture(value)
+              json = JSON.generate(value, strict: true, max_nesting: 32)
+              freeze_tree(JSON.parse(json, max_nesting: 32))
+            rescue JSON::JSONError => e
+              ArgumentError.("Invalid Style JSON: #{e.message}")
+            end
+
+            def self.freeze_tree(value)
+              case value
+              when ::Hash then value.each_value { freeze_tree(it) }
+              when ::Array then value.each { freeze_tree(it) }
+              end
+              value.freeze
+            end
+
+            private_class_method :freeze_tree
+          end
+
+          private_constant :Builder, :Snapshot
+        end
+        private_constant :Declaration
+      end
+    end
+  end
+end

data/lib/sevgi/graphics/mixtures/style.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+require_relative "style/declaration"
+
+module Sevgi
+  module Graphics
+    module Mixtures
+      # Document-local declarations for editable PDF export.
+      module Style
+        # Reads or replaces this document's Style declaration.
+        # A declaration changes export metadata, not rendered SVG appearance.
+        # Ordinary document copies safely share the immutable declaration.
+        # @param definition [Hash, Sevgi::Undefined] declaration, or omitted for a read
+        # @yield defines Target, Param, Group, and Profiles records
+        # @yieldreturn [Object] ignored block result
+        # @return [Hash, nil, Sevgi::Graphics::Element] frozen JSON declaration on read, self on assignment
+        # @raise [Sevgi::ArgumentError] when called outside a document root or with an invalid declaration
+        # @example Declare an editable outline
+        #   drawing.Style do
+        #     Target "ink", selectors: ["#outline"]
+        #     Param "display", targets: ["ink"], property: "display",
+        #       schema: {type: "string", enum: %w[inline none]}
+        #     Param "opacity", targets: ["ink"], property: "stroke-opacity",
+        #       schema: {type: "number", minimum: 0, maximum: 1}
+        #   end
+        def Style(definition = Undefined, &block)
+          ArgumentError.("Style belongs to a document root") unless Root?()
+          return @style&.to_h if definition.equal?(Undefined) && !block
+          definition = {} if definition.equal?(Undefined)
+          @style = Declaration.new(definition, &block)
+          self
+        end
+      end
+    end
+  end
+end

data/lib/sevgi/graphics/mixtures/symbols.rb

@@ -65,7 +65,7 @@ module Sevgi
 
         private_constant :Expansion
 
-        # Renders module callables as symbols under defs. Named modules default the defs id to their final constant name;
+        # Renders module callables as symbols under defs. Named modules default the defs id to their final constant name.
         # anonymous modules omit the id unless supplied.
         # @param mod [Module] module extended with {Sevgi::Graphics::Module}
         # @param args [Array<Object>] callable arguments
@@ -78,7 +78,7 @@ module Sevgi
         #     def tick = path d: "M 0 2 L 2 4 L 6 0"
         #   end
         #   Sevgi::Graphics.SVG(:minimal) { Symbols icons }
-        # @param attributes [Hash] defs attributes; String and Symbol names are normalized and must not collide
+        # @param attributes [Hash] defs attributes. String and Symbol names are normalized and must not collide
         # @param ids [#call, nil] optional callable mapping each method name to a symbol id
         # @param kwargs [Hash] callable keyword arguments
         # @yield forwarded to each callable

data/lib/sevgi/graphics/mixtures/tile.rb

@@ -8,7 +8,7 @@ module Sevgi
       # Use {Sevgi::Sundries::Tile} instead when Ruby code needs inspectable repeated geometry or row/column bounds
       # rather than SVG references.
       # @see Sevgi::Sundries::Tile
-      # @see https://sevgi.roktas.dev/sundries/#choose-a-layout-model Choosing a layout model
+      # @see https://sevgi.roktas.dev/layout/#choose-a-layout-model Choosing a layout model
       module Tile
         # Stable prefix used for generated tile CSS classes.
         PREFIX = "tile"
@@ -30,7 +30,7 @@ module Sevgi
         # @param dy [Numeric] finite vertical spacing, normalized before coordinates are rendered
         # @param oy [Numeric] finite vertical offset, normalized before coordinates are rendered
         # @param proc [Proc, nil] optional callback invoked for each use as `(element, x:, y:, nx:, ny:)`, with
-        #   zero-based coordinates and total counts; the callback may mutate the element and its return value is ignored
+        #   zero-based coordinates and total counts. The callback can mutate the element. Its return value is ignored
         # @yield evaluates the template drawing DSL in a generated `defs` group named by id
         # @yieldreturn [Object] ignored block result
         # @return [Sevgi::Graphics::Element] self
@@ -83,7 +83,7 @@ module Sevgi
         # @param d [Numeric] finite horizontal spacing, normalized before coordinates are rendered
         # @param o [Numeric] finite horizontal offset, normalized before coordinates are rendered
         # @param proc [Proc, nil] optional callback invoked for each use as `(element, x:, n:)`, with a zero-based column
-        #   and total count; the callback may mutate the element and its return value is ignored
+        #   and total count. The callback can mutate the element. Its return value is ignored
         # @yield evaluates the template drawing DSL in a generated `defs` group named by id
         # @yieldreturn [Object] ignored block result
         # @return [Sevgi::Graphics::Element] self
@@ -117,7 +117,7 @@ module Sevgi
         # @param d [Numeric] finite vertical spacing, normalized before coordinates are rendered
         # @param o [Numeric] finite vertical offset, normalized before coordinates are rendered
         # @param proc [Proc, nil] optional callback invoked for each use as `(element, y:, n:)`, with a zero-based row and
-        #   total count; the callback may mutate the element and its return value is ignored
+        #   total count. The callback can mutate the element. Its return value is ignored
         # @yield evaluates the template drawing DSL in a generated `defs` group named by id
         # @yieldreturn [Object] ignored block result
         # @return [Sevgi::Graphics::Element] self

data/lib/sevgi/graphics/mixtures/transform.rb

@@ -11,13 +11,18 @@ module Sevgi
       #     rect(width: 8, height: 4).Translate(12, 6).Rotate(15, 4, 2)
       #   end
       module Transform
+        # Keep box validation here: mixture helper methods would also enter the SVG DSL namespace.
+        # rubocop:disable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+
         # Aligns an inner box inside an outer box.
         # @param position [Symbol, String, nil] alignment name
-        # @param inner [#width, #height, nil] inner box
-        # @param outer [#width, #height, nil] outer box
+        # @param inner [#width, #height, nil] inner box, with optional position exposing x and y
+        # @param outer [#width, #height, nil] outer box, with optional position exposing x and y
         # @return [Sevgi::Graphics::Element] self
         # @raise [Sevgi::ArgumentError] when alignment is unsupported
         # @raise [Sevgi::ArgumentError] when a box dimension is not a finite real number
+        # @raise [Sevgi::ArgumentError] when a supplied box position does not expose finite real x and y coordinates
+        # @note Size-only boxes have origin (0, 0). Positions describe known box geometry, not renderer-computed bounds.
         def Align(position, inner:, outer:)
           return self unless position && inner && outer
 
@@ -25,12 +30,26 @@ module Sevgi
           when :center
             dimensions = [inner.width, inner.height, outer.width, outer.height]
             iw, ih, ow, oh = dimensions.map { Scalar.number(it, context: "alignment", field: :dimension) }
-            Translate((ow - iw) / 2.0, (oh - ih) / 2.0)
+            origins = [inner, outer].map do |box|
+              next [0, 0] unless box.respond_to?(:position)
+
+              origin = box.position
+              unless origin.respond_to?(:x) && origin.respond_to?(:y)
+                ArgumentError.("Alignment box position must expose x and y")
+              end
+
+              [origin.x, origin.y].map { Scalar.number(it, context: "alignment", field: :position) }
+            end
+
+            (ix, iy), (ox, oy) = origins
+            Translate(ox - ix + ((ow - iw) / 2.0), oy - iy + ((oh - ih) / 2.0))
           else
             ArgumentError.("Unsupported alignment: #{position}")
           end
         end
 
+        # rubocop:enable Metrics/AbcSize, Metrics/CyclomaticComplexity, Metrics/MethodLength, Metrics/PerceivedComplexity
+
         # Appends a scale(-1, -1) transform.
         # @return [Sevgi::Graphics::Element] self
         def Flip

data/lib/sevgi/graphics/mixtures/underscore.rb

@@ -18,7 +18,7 @@ module Sevgi
         # Adds an XML comment.
         # @param comment [Object] comment text
         # @return [Sevgi::Graphics::Element] floating comment element
-        # @raise [Sevgi::ArgumentError] when comment cannot be stringified as valid XML or would form malformed markup
+        # @raise [Sevgi::ArgumentError] when comment cannot be stringified as valid XML or forms malformed markup
         def Comment(comment)
           comment = XML.text(comment, context: "XML comment")
 
@@ -29,7 +29,7 @@ module Sevgi
         end
 
         # Merges `-context` metadata from the document root, ancestors, and this element.
-        # Only the direct root-to-self ancestor chain participates; sibling subtrees are ignored. When the same key is
+        # Only the direct root-to-self ancestor chain participates. Sibling subtrees are ignored. When the same key is
         # present on multiple chain elements, the nearest element to the receiver wins. Context remains available in
         # memory but is omitted from rendered SVG. It is unrelated to the `_:` XML namespace syntax preserved by
         # Derender.

data/lib/sevgi/graphics/mixtures/wrappers.rb

@@ -5,6 +5,55 @@ module Sevgi
     module Mixtures
       # DSL wrappers for common SVG shapes and content patterns.
       module Wrappers
+        # rubocop:disable Metrics/ParameterLists
+
+        # Builds an elliptical arc path ending at an absolute point.
+        # SVG resolves the ellipse from its endpoints, radii, and flags, including radius correction and zero radii.
+        # @example Draw an upper semicircle in screen coordinates
+        #   Sevgi::Graphics.SVG { ArcTo x1: 0, y1: 10, x2: 20, y2: 10, rx: 10, ry: 10, sweep: true }
+        # @param x2 [Numeric] finite ending x coordinate
+        # @param y2 [Numeric] finite ending y coordinate
+        # @param rx [Numeric] finite local x radius
+        # @param ry [Numeric] finite local y radius
+        # @param x1 [Numeric] finite starting x coordinate
+        # @param y1 [Numeric] finite starting y coordinate
+        # @param rotation [Numeric] clockwise ellipse rotation in degrees
+        # @param large [Boolean] select the arc exceeding a half turn
+        # @param sweep [Boolean] select increasing parameter angles
+        # @return [Sevgi::Graphics::Element] path element
+        # @raise [Sevgi::ArgumentError] when an operand is not finite real or a flag is not Boolean
+        def ArcTo(x2:, y2:, rx:, ry:, x1: 0, y1: 0, rotation: 0, large: false, sweep: false, **)
+          x1, y1, x2, y2, rx, ry, rotation = Scalar.numbers([x1, y1, x2, y2, rx, ry, rotation], context: "absolute arc")
+          unless [large, sweep].all? { it.equal?(true) || it.equal?(false) }
+            ArgumentError.("Arc flags must be Boolean")
+          end
+
+          path(d: "M #{x1} #{y1} A #{rx} #{ry} #{rotation} #{large ? 1 : 0} #{sweep ? 1 : 0} #{x2} #{y2}", **)
+        end
+
+        # Builds an elliptical arc path ending at a relative offset.
+        # @param dx [Numeric] finite x displacement from the starting point
+        # @param dy [Numeric] finite y displacement from the starting point
+        # @param rx [Numeric] finite local x radius
+        # @param ry [Numeric] finite local y radius
+        # @param x [Numeric] finite starting x coordinate
+        # @param y [Numeric] finite starting y coordinate
+        # @param rotation [Numeric] clockwise ellipse rotation in degrees
+        # @param large [Boolean] select the arc exceeding a half turn
+        # @param sweep [Boolean] select increasing parameter angles
+        # @return [Sevgi::Graphics::Element] path element
+        # @raise [Sevgi::ArgumentError] when an operand is not finite real or a flag is not Boolean
+        # @see #ArcTo
+        def ArcBy(dx:, dy:, rx:, ry:, x: 0, y: 0, rotation: 0, large: false, sweep: false, **)
+          x, y, dx, dy, rx, ry, rotation = Scalar.numbers([x, y, dx, dy, rx, ry, rotation], context: "relative arc")
+          unless [large, sweep].all? { it.equal?(true) || it.equal?(false) }
+            ArgumentError.("Arc flags must be Boolean")
+          end
+
+          path(d: "M #{x} #{y} a #{rx} #{ry} #{rotation} #{large ? 1 : 0} #{sweep ? 1 : 0} #{dx} #{dy}", **)
+        end
+        # rubocop:enable Metrics/ParameterLists
+
         # Builds a line path ending at an absolute point.
         # @example Render a rational coordinate as an SVG number
         #   Sevgi::Graphics.SVG { LineTo(x2: Rational(1, 2), y2: 1) }

data/lib/sevgi/graphics/mixtures.rb

@@ -63,6 +63,7 @@ require_relative "mixtures/polyfills"
 require_relative "mixtures/rdf"
 require_relative "mixtures/render"
 require_relative "mixtures/save"
+require_relative "mixtures/style"
 require_relative "mixtures/symbols"
 require_relative "mixtures/tile"
 require_relative "mixtures/transform"

data/lib/sevgi/graphics/version.rb

@@ -3,6 +3,6 @@
 module Sevgi
   module Graphics
     # Current graphics component version.
-    VERSION = "0.98.2"
+    VERSION = "1.1.0"
   end
 end

data/lib/sevgi/graphics.rb

@@ -2,9 +2,8 @@
 
 require "sevgi/function"
 
-require_relative "graphics/xml"
-require_relative "graphics/attribute"
 require_relative "graphics/auxiliary"
+require_relative "graphics/attribute"
 require_relative "graphics/element"
 require_relative "graphics/mixtures"
 
@@ -15,7 +14,7 @@ require_relative "graphics/version"
 module Sevgi
   # SVG document builder and DSL namespace.
   #
-  # A document profile controls root metadata and preambles; a {Canvas} controls
+  # A document profile controls root metadata and preambles. A {Canvas} controls
   # physical size, margins, viewport, and viewBox. {Graphics.SVG} combines them
   # into an element tree. Library code keeps that tree as an object until it
   # explicitly renders, validates, saves, or exports it.
@@ -25,9 +24,9 @@ module Sevgi
   #     circle cx: 5, cy: 5, r: 4
   #   end
   #   drawing.Render #=> "<svg width=\"10\" height=\"10\">\n  <circle cx=\"5\" cy=\"5\" r=\"4\"/>\n</svg>"
-  # @see https://sevgi.roktas.dev/svg/ SVG construction and profile guide
-  # @see https://sevgi.roktas.dev/library-mode/ Library composition guide
-  # @see https://sevgi.roktas.dev/showcase/ Runnable drawing examples
+  # @see https://sevgi.roktas.dev/documents/ SVG construction and profile guide
+  # @see https://sevgi.roktas.dev/compose/ Composition guide
+  # @see https://sevgi.roktas.dev/examples/ Runnable drawing examples
   # @see Sevgi::Graphics::Document
   # @see Sevgi::Graphics::Canvas
   module Graphics
@@ -63,19 +62,18 @@ module Sevgi
     #   Looks up a named profile when both definition keywords are omitted. Supplying `preambles:` or `attributes:`
     #   defines a named profile, or returns an existing profile when every explicitly supplied field matches. Omitted
     #   fields are ignored during existing-profile comparison. Profile containers and strings are copied into the
-    #   process-global, thread-atomic registry; attribute names and nested Hash keys are normalized, nil attributes are
-    #   omitted, update suffixes are retained for document-class inheritance, and mutable non-container values are
-    #   stringified once before registration. Concurrent identical definitions return the same canonical registered
-    #   class.
+    #   process-global, thread-atomic registry. Attribute names and nested Hash keys are normalized. Nil attributes are
+    #   omitted. Update suffixes remain available for document-class inheritance. Mutable non-container values are
+    #   stringified once before registration. Concurrent identical definitions return the same registered class.
     #   @param name [Symbol, String] profile name
     #   @param preambles [Array<String>, nil, Sevgi::Undefined] document preamble lines
-    #   @param attributes [Hash, nil, Sevgi::Undefined] default root attributes; nil means an empty Hash
+    #   @param attributes [Hash, nil, Sevgi::Undefined] default root attributes. Nil means an empty Hash
     #   @return [Class] document class
     #   @raise [Sevgi::ArgumentError] when a profile conflicts or metadata is invalid XML, cyclic, or cannot be stringified
     # @overload document(preambles: Undefined, attributes: Undefined)
     #   Defines an anonymous document profile without registering it globally.
     #   @param preambles [Array<String>, nil, Sevgi::Undefined] document preamble lines
-    #   @param attributes [Hash, nil, Sevgi::Undefined] default root attributes; nil means an empty Hash
+    #   @param attributes [Hash, nil, Sevgi::Undefined] default root attributes. Nil means an empty Hash
     #   @return [Class] anonymous document class
     #   @raise [Sevgi::ArgumentError] when metadata is invalid XML, cyclic, or cannot be stringified
     # @return [Class] document class
@@ -96,19 +94,20 @@ module Sevgi
 
     # Defines or replaces a document profile class.
     # Validation and snapshot capture complete before an existing registration is atomically replaced.
-    # Use the non-bang {#document} for ordinary idempotent definitions; this
+    # Use the non-bang {#document} for ordinary idempotent definitions. This
     # bang form is an explicit process-global replacement.
     # @param name [Symbol, String] profile name
     # @param preambles [Array<String>, nil] document preamble lines
-    # @param attributes [Hash, nil] default root attributes; nil means an empty Hash
+    # @param attributes [Hash, nil] default root attributes. Nil means an empty Hash
     # @return [Class] document class
     # @raise [Sevgi::ArgumentError] when the name or metadata is invalid XML, cyclic, or cannot be stringified
     def document!(name, preambles: [], attributes: {})
       Graphics::Document.define(name, preambles:, attributes:, overwrite: true)
     end
 
-    # Defines a paper profile unless the same profile already exists. Registration is process-global and thread-atomic;
-    # an identical concurrent definition is idempotent and a conflicting definition is rejected.
+    # Defines a paper profile unless the same profile already exists.
+    # Registration is process-global and thread-atomic. Identical concurrent definitions are idempotent. Conflicting
+    # definitions are rejected.
     # @param width [Numeric] paper width
     # @param height [Numeric] paper height
     # @param name [Symbol, String] profile name
@@ -135,15 +134,20 @@ module Sevgi
 
     # Builds an SVG root element tree without rendering it.
     #
-    # The first argument selects root metadata; the second supplies physical
-    # canvas attributes. Keyword attributes are applied to the root after both.
-    # @param document [Symbol, String, Class] document profile name or document class
+    # The first argument selects root metadata, or supplies the canvas while using the default profile. The second
+    # supplies canvas attributes when the first argument is a profile. Keyword attributes are applied after both.
+    # @param document [Symbol, String, Class, Sevgi::Graphics::Canvas, Sevgi::Graphics::Paper] document profile,
+    #   document class, or canvas input that uses the default profile
     # @param canvas [Sevgi::Graphics::Canvas, Sevgi::Graphics::Paper, Symbol, String, Sevgi::Undefined, nil] canvas input
     # @yield evaluates the drawing DSL in the root element
     # @yieldreturn [Object] ignored block result
     # @return [Sevgi::Graphics::Document::Proto] SVG root element
     # @raise [Sevgi::ArgumentError] when the document/canvas profile or root XML attributes are invalid
     def SVG(document = :default, canvas = Undefined, **, &block)
+      if canvas.equal?(Undefined) && (document.is_a?(Canvas) || document.is_a?(Paper))
+        document, canvas = :default, document
+      end
+
       Graphics::Document.(document, canvas, **, &block)
     end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sevgi-graphics
 version: !ruby/object:Gem::Version
-  version: 0.98.2
+  version: 1.1.0
 platform: ruby
 authors:
 - Recai Oktaş
@@ -9,20 +9,34 @@ bindir: bin
 cert_chain: []
 date: 1980-01-02 00:00:00.000000000 Z
 dependencies:
+- !ruby/object:Gem::Dependency
+  name: json
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: sevgi-function
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.98.2
+        version: 1.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.98.2
+        version: 1.1.0
 description: Builds and renders SVG document trees from Ruby.
 email: roktas@gmail.com
 executables: []
@@ -39,9 +53,8 @@ files:
 - lib/sevgi/graphics/auxiliary/content.rb
 - lib/sevgi/graphics/auxiliary/margin.rb
 - lib/sevgi/graphics/auxiliary/paper.rb
-- lib/sevgi/graphics/auxiliary/path.rb
 - lib/sevgi/graphics/auxiliary/scalar.rb
-- lib/sevgi/graphics/auxiliary/sizes.rb
+- lib/sevgi/graphics/auxiliary/xml.rb
 - lib/sevgi/graphics/document.rb
 - lib/sevgi/graphics/document/base.rb
 - lib/sevgi/graphics/document/default.rb
@@ -63,6 +76,8 @@ files:
 - lib/sevgi/graphics/mixtures/rdf.rb
 - lib/sevgi/graphics/mixtures/render.rb
 - lib/sevgi/graphics/mixtures/save.rb
+- lib/sevgi/graphics/mixtures/style.rb
+- lib/sevgi/graphics/mixtures/style/declaration.rb
 - lib/sevgi/graphics/mixtures/symbols.rb
 - lib/sevgi/graphics/mixtures/tile.rb
 - lib/sevgi/graphics/mixtures/transform.rb
@@ -70,7 +85,6 @@ files:
 - lib/sevgi/graphics/mixtures/validate.rb
 - lib/sevgi/graphics/mixtures/wrappers.rb
 - lib/sevgi/graphics/version.rb
-- lib/sevgi/graphics/xml.rb
 homepage: https://sevgi.roktas.dev
 licenses:
 - GPL-3.0-or-later
@@ -93,7 +107,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 4.0.20
 specification_version: 4
 summary: Core SVG DSL for Sevgi.
 test_files: []

data/lib/sevgi/graphics/auxiliary/path.rb

@@ -1,44 +0,0 @@
-# frozen_string_literal: true
-
-module Sevgi
-  module Graphics
-    # Output path normalization shared by Graphics writers and exporters.
-    # @api private
-    module Path
-      # Converts a non-blank path to an expanded String.
-      # @param value [String, #to_path] raw path value
-      # @param context [String] public operation named in errors
-      # @return [String] expanded path
-      # @raise [Sevgi::ArgumentError] when value is blank, has an invalid type, or path conversion fails
-      def self.call(value, context:)
-        path = value.respond_to?(:to_path) ? value.to_path : value
-        ArgumentError.("#{context} must be a String or path-like object") unless path.is_a?(::String)
-        ArgumentError.("#{context} must be provided") if path.strip.empty?
-
-        ::File.expand_path(path)
-      rescue ::Sevgi::ArgumentError
-        raise
-      rescue ::StandardError => e
-        ArgumentError.("#{context} must be a String or path-like object: #{e.message}")
-      end
-
-      # Resolves an optional path with the writer/exporter directory convention.
-      # @param value [String, #to_path, nil] explicit path or directory
-      # @param default [String, #to_path] default output path
-      # @param context [String] public operation named in errors
-      # @return [String] expanded output file path
-      # @raise [Sevgi::ArgumentError] when a selected path/default is blank, invalid, or cannot be converted
-      def self.resolve(value, default:, context:)
-        return call(default, context: "#{context} default") if value.nil?
-
-        path = call(value, context: "#{context} path")
-        return path unless ::File.directory?(path)
-
-        default = call(default, context: "#{context} default")
-        ::File.join(path, ::File.basename(default))
-      end
-    end
-
-    private_constant :Path
-  end
-end