sevgi-graphics 0.98.2 → 1.1.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 753194f4865e2c8b099f788588a684a72a116004b3e56bb40cfd626a7b14043f
-  data.tar.gz: d443e433a8c86e4d902b31a4dadb71a244905f83aca4b67d8d56c64fdd7cb6c7
+  metadata.gz: 9e205e418f5e60262a7e2cea0c4d32879942f7b238ea5fbf07bbbc01be5a9bbf
+  data.tar.gz: 889bb3fc5e72a27efba882624c3af23681a2811866d6c165f344edbb79173db7
 SHA512:
-  metadata.gz: 05517e6f426cc1cd7ce0077705f147db602346bfba518500551dfce4008d669935f1fe3f21fc83b4531f33a44e4eec38e5b3ff82ccceff1bf1968a30f7ce8998
-  data.tar.gz: d19ec2a6d3e5e093876ab72eaa594220241f5ff8f5c744124330ee69adff71f12a67159779b9894a6bd4589ea0b3af78ad16ed768d41b422ffc18bca77248075
+  metadata.gz: 67bcec199b5f5a1e607a316da7dd618792e07df4b9db5bdd86104373ac1772324eb9f1b268e3ae1ce28db413bcefb68db4d531e82098ffa112c9da998de9e9dd
+  data.tar.gz: ad2787c76d899b961dc73da906dcfb57ed38f94fc2f317c8ce0c0692ebbdd181260b1e97ee02efa871350ba9239ba53341c755919a02dd1860b8d6431357c6fb

data/CHANGELOG.md

@@ -5,6 +5,120 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## Unreleased
 
+## 1.1.0 - 2026-10-29
+
+### Added
+
+- `Classes` returns an element's distinct CSS class names without changing the element; `Classify` shares its attribute normalization.
+- Generic document-local Style declarations with `Target`, `Param`, `Group`, and `Profiles`, and optional prepared PDF export through the native Mainz CLI.
+- Backend-independent `fallback: false` for export failures and `F.executable` for executable path lookup.
+- `F.path` for path validation and expansion, and `F.output_path` for default output names and directory targets.
+
+### Changed
+
+- Moved Graphics XML validation into auxiliary helpers and kept built-in paper dimensions in `Paper`.
+- Shared path validation between Graphics writers and Sundries exports while preserving output paths and error messages.
+
+### Fixed
+
+- Stamp code placeholders in nested and shared PDF Forms, with cycle-safe resource traversal.
+
+## 1.0.0 - 2026-09-16
+
+### Added
+
+- Added Hatch and Orb Showcase examples and displayed both arc lengths in the Arc example.
+
+### Changed
+
+- Matched documentation page widths to the homepage Showcase.
+- Aligned Derender user guidance with UTF-8 normalization and safe subtree selection rules.
+- Clarified the packaged skill's script invocation, subtree copying, and Derender selection and encoding rules.
+- Allowed Canvas and Paper values as the first `SVG` argument when using the default document profile.
+- Made element `dup` and `clone` own independent subtrees while retaining IDs and Ruby copy semantics.
+- Made Segment equality compare length and direction; ordering still compares length only.
+- Limited Tile cell, row, and column queries to the requested geometry and accelerated XML character validation.
+- Simplified the first-run guide and aligned library constructor examples.
+- Updated the packaged skill for canvas origins, alignment, Paper lookup, curved geometry, and export constraints.
+- Revised DSL catalog examples and packaged Sevgi skill guidance to use statement-style calls and show inspection results.
+- Refined Showcase example tabs, made Ruby and XML views fill their panels, and hid executable preambles from Ruby views.
+- Documented non-rendering element data and clarified the related DSL catalog examples.
+- Refined Showcase heading spacing, page-title colors, and DSL catalog cards across light and dark themes.
+- Removed an obsolete ruler example and unused site code.
+- Kept the Squared and Copperplate guidesheet examples together at the end of the Showcase.
+- Updated the packaged skill to avoid duplicate semantic shapes and unnecessary paint passes.
+
+### Fixed
+
+- Kept horizontal scrollbars visible in Showcase example code panels.
+- Read Derender input in its declared XML encoding and normalized generated source, XML declarations, and markup to UTF-8.
+- Preserved open-path endpoints and derived edges independently of display precision.
+- Kept near-axis and near-parallel line equations and intersections independent of angle and slope rounding.
+- Corrected the Showcase social image dimensions.
+- Added SVG namespaces to standalone drawing examples and regenerated their outputs.
+- Made failed Sevgi Rake tasks stop dependent tasks and captured required-library failures in executor results.
+- Removed executor signal-handler replacement so the host and shell retain SIGINT ownership.
+- Escaped late export CSS as XML text and inserted it only at a supported final root closing tag.
+- Preserved Derender processing instructions and rejected custom entity references and unsupported trailing document nodes before inclusion.
+- Included both box origins in `Align`, unified Tile index validation, and isolated custom numeric attribute snapshots.
+- Prevented avoidable overflow and underflow in point distances.
+- Corrected browser source-panel expectations and added executable documentation, YARD, and packaged-skill checks.
+- Rendered inline code in DSL catalog summaries and kept linked task themes visible below the sticky header.
+- Restored Showcase tab icons with embedded Font Awesome SVGs.
+
+## 0.100.0 - 2026-09-09
+
+### Added
+
+- Added `ArcTo` and `ArcBy` for SVG-native elliptical arc paths.
+- Added Geometry `Arc`, `Ellipse`, and `Circle` with bounds, length, predicates, affine transformations, and
+  linear/quadratic intersections. Closed ellipses and circles support sweeps and hatching.
+- Added Geometry `Point.midpoint`, `Element#closed?`, lined `vertices`, open-path traversal, and `Rect#center`.
+- Added Geometry aggregate bounding boxes through `Operation.box`, point collinearity through `Point.collinear?`, and
+  polygon `simple?`, `convex?`, and `concave?` predicates.
+- Added Protractor and Arc examples and documented the drawing and calculation APIs.
+
+### Changed
+
+- Removed redundant parent scans while duplicating element subtrees.
+- Reused source bounds across Tile cells to reduce repeated calculations and object allocations.
+
+### Fixed
+
+- Preserved Showcase card HTML through Markdown rendering so all examples and their tabs remain visible.
+- Preserved XML declarations, pre-root comments, CDATA sections, inline comments, and namespace-only leaves in
+  Derender output and evaluation.
+- Limited PDF stamp recoloring to replaced text and carried graphics state across a page's content streams.
+- Corrected decimal interval fitting and made Grid point queries honor the active numeric precision.
+- Prevented implicit shell interpretation of single executable arguments in `F.sh` and `F.sh!`, including paths with spaces or shell metacharacters.
+- Preserved inherited namespaces on detached Derender nodes in generated source and direct evaluation, including imports through `EvaluateChildren` and `IncludeChildren`.
+- Prevented sweep and Hatch lines from crossing the exterior between two tangent vertices of a concave polygon.
+- Aligned Tile cells with their declared bounds for circles, rotated shapes, and polygons whose first vertex differs from their bounding-box origin.
+- Limited `Load` chains to 128 active sources with `Executor::LoadDepthError`, preserving cycle detection and nested load diagnostics.
+- Rejected nil and false aggregate-box inputs with the documented geometry error.
+- Restored precision-aware rejection of zero-length Triangle sides.
+- Made point-set collinearity independent of input order and removed eager polygon edge-pair storage.
+- Applied the collinearity tolerance to every three-point subset, removing coordinate-axis-dependent baseline selection.
+
+## 0.99.0 - 2026-08-09
+
+### Added
+
+- Added `SVG.Module` for building anonymous callable drawing modules with their contract installed before definition.
+- Added responsive Mermaid diagrams for the Derender round trip and SVG validation lifecycle.
+
+### Changed
+
+- Reorganized the documentation around getting started, usage, composition, documents, layout, output, and examples.
+- Documented how the `igves` and `igsev` command names reflect their conversion directions.
+- Normalized DSL catalog provider labels to lowercase and simplified polyfill-backed editor entries to `inkscape`.
+
+### Fixed
+
+- Allowed A5-on-A4 pdfcpu conversion to replace an existing output file.
+- Pre-rendered Mermaid diagrams as inline SVG instead of parsing them in site visitors' browsers.
+- Removed duplicate provider and context labels from DSL catalog entries.
+
 ## 0.98.2 - 2026-07-25
 
 ### Fixed
@@ -212,7 +326,7 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ### Changed
 
-- Added the checker board example to the documentation showcase flow.
+- Added the checkerboard example to the documentation showcase flow.
 - Consolidated Victor Book attribution for adapted showcase examples into a single documentation note.
 
 ### Fixed

data/README.md

@@ -18,9 +18,63 @@ require "sevgi/graphics"
 
 ```ruby
 doc = Sevgi::Graphics.SVG(:minimal) { rect width: 3, height: 5 }
-doc.call
+puts doc.Render
 ```
 
+This focused gem exposes `Sevgi::Graphics.SVG` and lowercase component constructors. Install the umbrella `sevgi` gem
+when you need the global `SVG` facade or the `.sevgi` script runner.
+
+## Editable PDF styles
+
+`Style` attaches an immutable producer declaration to an SVG document.
+It does not change the SVG or load a PDF backend.
+The lowercase `style` method still creates an SVG CSS element.
+
+```ruby
+doc = Sevgi::Graphics.SVG width: 20, height: 20 do
+  g id: "outline" do
+    rect width: 10, height: 10, fill: "none", stroke: "black"
+  end
+  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}
+    Group "Ink", parameters: ["opacity"]
+    Profiles "print", name: "Printer", parameters: ["opacity"], profiles: [
+      {id: "original", name: "Original", overrides: {}},
+      {id: "light", name: "Light", overrides: {opacity: 0.4}}
+    ]
+  end
+end
+
+doc.PDF "drawing.pdf"
+doc.PDF "prepared.pdf", fallback: false
+```
+
+`PDF` uses Mainz automatically when the document has a Style declaration.
+If Mainz is unavailable or preparation fails, the default mode warns and exports an ordinary PDF.
+`fallback: false` raises `Sevgi::Sundries::Mainz::Error` instead.
+An unstyled PDF uses ordinary export without a Mainz warning.
+PNG and SVG output retain their ordinary behavior.
+
+`Target` selects whole SVG groups or direct `use` placements with `#id` or `#id > use.class` selectors.
+Its optional `fill: true` allows eligible closed paths to acquire a fill.
+`Param` binds one supported paint property to targets and supplies its value schema.
+`Group` orders parameter references. `Profiles` records named sets of overrides.
+Every target requires a `display` parameter.
+`Param` accepts an optional `value:` to assign an override after Mainz captures original paint.
+For an authored hidden target, `Target` accepts `display: "none"`.
+Mainz owns selector resolution, supported properties, binding admission, and PDF baselines.
+The [declaration contract](https://github.com/roktas/mainz/blob/v1.0.0/lib/doc/SPEC.md#71-svg-declarations) defines those fields.
+
+`doc.Style` returns the declaration as deeply frozen JSON data with String keys.
+`doc.Style declaration_hash` accepts the same fields without a builder block.
+Applications supply their own parameter names, schemas, profiles, and publication requirements.
+Separate documents have separate declarations. Document copies safely share an immutable declaration.
+Invalid Ruby declarations raise `Sevgi::ArgumentError` before export.
+
 ## Ruby compatibility
 
 Requires Ruby 3.4.0 or newer. CI verifies the current Ruby 3.4 release and the development Ruby from `.ruby-version`.

data/lib/sevgi/graphics/attribute.rb

@@ -60,6 +60,9 @@ module Sevgi
       # Owned mutable snapshots for values entering an attribute store.
       # @api private
       module Snapshot
+        SCALARS = [::NilClass, ::TrueClass, ::FalseClass, ::Symbol, ::Integer, ::Float, ::Rational, ::Complex].freeze
+        private_constant :SCALARS
+
         class << self
           def capture(value, normalize_keys: false, seen: {}.compare_by_identity)
             case value
@@ -90,12 +93,7 @@ module Sevgi
 
           def capture_value(value)
             text = XML.text(value, context: "XML attribute value")
-            case value
-            when ::Numeric, ::Symbol, ::NilClass, ::TrueClass, ::FalseClass
-              value
-            else
-              text
-            end
+            SCALARS.include?(value.class) ? value : text
           end
 
           def nested(value, seen)
@@ -168,11 +166,18 @@ module Sevgi
         XML.text(text, context: "XML attribute value")
       end
 
+      # Returns distinct class names in rendered order from nested attribute values.
+      # @param values [Array<Object>] class values to combine
+      # @return [Array<String>] owned class-name snapshot
+      # @raise [Sevgi::ArgumentError] when a value is invalid, cyclic, or cannot be stringified as XML
+      # @api private
+      def self.classes(*values) = xml_text(values).split.uniq
+
       # Mutable backing store for SVG attributes.
       # @api private
       class Store
         # Creates an attribute store from recursively owned snapshots. Mutable non-container leaves are stringified
-        # once; later caller mutation cannot change the store.
+        # once. Later caller mutation cannot change the store.
         # @param attributes [Hash] initial attributes
         # @return [void]
         # @raise [Sevgi::ArgumentError] when input is not a Hash or a name/value is invalid, cyclic, colliding, or cannot
@@ -205,7 +210,7 @@ module Sevgi
 
         # Assigns a recursively owned attribute snapshot. Mutable non-container leaves are stringified once.
         # @param key [String, Symbol] attribute key
-        # @param value [Object, nil] attribute value; nil is ignored
+        # @param value [Object, nil] attribute value. Nil is ignored
         # @return [Object, nil] stored snapshot or nil
         # @raise [Sevgi::ArgumentError] when update syntax receives incompatible values
         # @raise [Sevgi::ArgumentError] when update syntax receives an unsupported value type
@@ -354,7 +359,7 @@ module Sevgi
 
       # Assigns or updates a recursively owned attribute value.
       # @param key [String, Symbol] attribute key, optionally ending in {UPDATE_SUFFIX}
-      # @param value [Object, nil] attribute value; nil is ignored
+      # @param value [Object, nil] attribute value. Nil is ignored
       # @return [Object, nil] recursively owned resulting value or nil when absent
       # @raise [Sevgi::ArgumentError] when the name or value is invalid, or an existing update uses incompatible or
       #   unsupported value families
@@ -392,7 +397,7 @@ module Sevgi
       def keys = @store.list.freeze
 
       # Atomically assigns or updates recursively owned attributes.
-      # @param attributes [Hash] attributes and non-rendering metadata; names may end in {UPDATE_SUFFIX}
+      # @param attributes [Hash] attributes and non-rendering metadata. Names can end in {UPDATE_SUFFIX}
       # @return [Sevgi::Graphics::Attributes] self
       # @raise [Sevgi::ArgumentError] when input is not a Hash, names collide, a name or value is invalid, or an existing
       #   update uses incompatible or unsupported value families

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

@@ -113,12 +113,12 @@ module Sevgi
 
       # @overload attributes(origin = Undefined)
       #   Returns SVG root viewport attributes.
-      #   Omission uses the negative left and top margins; nil uses zero for both coordinates.
+      #   Omission uses the negative left and top margins. Nil uses zero for both coordinates.
       #   @example Compare margin-aware and zero-origin viewBoxes
       #     canvas = Sevgi::Graphics::Canvas.call(width: 80, height: 50, margins: [5, 10])
       #     canvas.attributes[:viewBox] # => "-10 -5 80 50"
       #     canvas.attributes(nil)[:viewBox] # => "0 0 80 50"
-      #   @param origin [Numeric, Array<Numeric>, nil, Sevgi::Undefined] viewBox origin; a scalar sets both coordinates
+      #   @param origin [Numeric, Array<Numeric>, nil, Sevgi::Undefined] viewBox origin. A scalar sets both coordinates
       #   @return [Hash{Symbol => String}] SVG viewport and viewBox attributes
       #   @raise [Sevgi::ArgumentError] when origin is invalid
       def attributes(...) = {**viewport, viewBox: viewbox(...)}
@@ -142,8 +142,8 @@ module Sevgi
       def viewport = {width: "#{width}#{unit}", height: "#{height}#{unit}"}
 
       # Returns the SVG viewBox string.
-      # Omission uses the negative left and top margins; nil uses zero for both coordinates.
-      # @param origin [Numeric, Array<Numeric>, nil, Sevgi::Undefined] viewBox origin; a scalar sets both coordinates
+      # Omission uses the negative left and top margins. Nil uses zero for both coordinates.
+      # @param origin [Numeric, Array<Numeric>, nil, Sevgi::Undefined] viewBox origin. A scalar sets both coordinates
       # @return [String]
       # @raise [Sevgi::ArgumentError] when origin is invalid
       def viewbox(origin = Undefined) = prettify(*originate(origin), width, height).join(" ")

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

@@ -30,7 +30,7 @@ module Sevgi
     #   Sevgi::Graphics.SVG(:minimal) { text Emphasis["important & safe"] }.Render
     #
     #   # The renderer ignores Emphasis#render's return value. Custom content must escape inserted data itself.
-    # @see https://sevgi.roktas.dev/svg/#content-safety Content safety guide
+    # @see https://sevgi.roktas.dev/documents/#content-safety Content safety guide
     class Content
       private_class_method :new
 
@@ -106,7 +106,7 @@ module Sevgi
       # @return [Object] wrapped content snapshot
       def content = Snapshot.copy(@content)
 
-      # Creates immutable content from a deep payload snapshot. Strings and containers are copied recursively; mutable
+      # Creates immutable content from a deep payload snapshot. Strings and containers are copied recursively. Mutable
       # non-container objects are stringified once during construction. The caller's objects are never retained.
       # @param content [Object] wrapped content
       # @return [void]
@@ -118,17 +118,6 @@ module Sevgi
         XML.validate(@content)
       end
 
-      # Copies content payload ownership for duplicated element trees.
-      # @param original [Sevgi::Graphics::Content] source content
-      # @return [void]
-      # @api private
-      def initialize_copy(original)
-        @content = Snapshot.capture(original.content)
-        super
-      end
-
-      private :initialize_copy
-
       # Appends this content's serialized XML lines to rendering output.
       # The output collaborator responds to `append(depth, *lines)`, where `depth` is an Integer or nil and every line
       # is a String containing valid serialized XML text. The rendering engine ignores both `append` and `render` return
@@ -185,7 +174,7 @@ module Sevgi
       def self.verbatim(...) = Verbatim.send(:new, ...)
 
       # CDATA section content backed by an immutable payload snapshot. Mutable leaf objects are stringified during
-      # construction; embedded terminators are split during rendering.
+      # construction. Embedded terminators are split during rendering.
       # @see Content.cdata
       class CData < Content
         # Renders CDATA content.
@@ -206,7 +195,7 @@ module Sevgi
         def safe(value) = XML.cdata(value)
       end
 
-      # CSS content rendered inside a CDATA section. Rules are captured recursively during construction; mutable
+      # CSS content rendered inside a CDATA section. Rules are captured recursively during construction. Mutable
       # selectors, property names, and values are stringified once, and embedded CDATA terminators are split safely.
       # @see Content.css
       class CSS < Content
@@ -281,7 +270,7 @@ module Sevgi
       end
 
       # Verbatim content backed by an immutable payload snapshot. Mutable leaf objects are stringified during
-      # construction. Verbatim content bypasses XML escaping; validation guarantees encoding and legal XML 1.0 code
+      # construction. Verbatim content bypasses XML escaping. Validation guarantees encoding and legal XML 1.0 code
       # points, not well-formed markup supplied by the caller.
       # @see Content.verbatim
       class Verbatim < Content

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

@@ -180,7 +180,58 @@ module Sevgi
 
       @reserved = methods.map(&:to_sym).freeze
 
-      PAPER_SIZES.each { |name, (width, height, unit)| define(name, width:, height:, unit:) }
+      {
+        a0: [841, 1189, "mm"],
+        a1: [594, 841, "mm"],
+        a2: [420, 594, "mm"],
+        a3: [297, 420, "mm"],
+        a4: [210, 297, "mm"],
+        a5: [148, 210, "mm"],
+        a6: [105, 148, "mm"],
+        a7: [74, 105, "mm"],
+        a8: [52, 74, "mm"],
+        a9: [37, 52, "mm"],
+        a10: [26, 37, "mm"],
+
+        b0: [1000, 1414, "mm"],
+        b1: [707, 1000, "mm"],
+        b2: [500, 707, "mm"],
+        b3: [353, 500, "mm"],
+        b4: [250, 353, "mm"],
+        b5: [176, 250, "mm"],
+        b6: [125, 176, "mm"],
+        b7: [88, 125, "mm"],
+        b8: [62, 88, "mm"],
+        b9: [44, 62, "mm"],
+        b10: [31, 44, "mm"],
+
+        c0: [917, 1297, "mm"],
+        c1: [648, 917, "mm"],
+        c2: [458, 648, "mm"],
+        c3: [324, 458, "mm"],
+        c4: [229, 324, "mm"],
+        c5: [162, 229, "mm"],
+        c6: [114, 162, "mm"],
+        c7: [81, 114, "mm"],
+        c8: [57, 81, "mm"],
+        c9: [40, 57, "mm"],
+        c10: [28, 40, "mm"],
+
+        business: [85, 55, "mm"],
+        large: [130, 210, "mm"],
+        passport: [88, 125, "mm"],
+        pocket: [90, 140, "mm"],
+        travelers: [110, 210, "mm"],
+        us: [216, 279, "mm"],
+        xlarge: [190, 250, "mm"],
+
+        icon16: [16, 16, "px"],
+        icon32: [32, 32, "px"],
+        icon64: [64, 64, "px"],
+        icon128: [128, 128, "px"],
+        icon256: [256, 256, "px"],
+        icon512: [512, 512, "px"]
+      }.each { |name, (width, height, unit)| define(name, width:, height:, unit:) }
 
       # Returns the default paper profile.
       # @return [Sevgi::Graphics::Paper]

data/lib/sevgi/graphics/{xml.rb → auxiliary/xml.rb}

@@ -11,8 +11,9 @@ module Sevgi
       NCNAME_CHAR = "#{NCNAME_START}\\-.0-9\u{B7}\u{300}-\u{36F}\u{203F}-\u{2040}".freeze
       NCNAME = "[#{NCNAME_START}][#{NCNAME_CHAR}]*".freeze
       QNAME = /\A#{NCNAME}(?::#{NCNAME})?\z/u
+      ILLEGAL_CHARACTER = /[^\u0009\u000A\u000D\u0020-\uD7FF\uE000-\uFFFD\u{10000}-\u{10FFFF}]/u
 
-      private_constant :NCNAME, :NCNAME_CHAR, :NCNAME_START, :QNAME
+      private_constant :NCNAME, :NCNAME_CHAR, :NCNAME_START, :QNAME, :ILLEGAL_CHARACTER
 
       class << self
         # Validates an XML 1.0 string representation.
@@ -104,8 +105,8 @@ module Sevgi
           ArgumentError.("#{context} must be valid UTF-8") unless value.valid_encoding?
 
           text = value.encode("UTF-8")
-          if (codepoint = text.each_codepoint.find { !legal_codepoint?(it) })
-            ArgumentError.("#{context} contains illegal character U+#{format("%04X", codepoint)}")
+          if (match = ILLEGAL_CHARACTER.match(text))
+            ArgumentError.("#{context} contains illegal character U+#{format("%04X", match[0].ord)}")
           end
 
           text
@@ -113,12 +114,6 @@ module Sevgi
           ArgumentError.("#{context} must be valid UTF-8: #{e.message}")
         end
 
-        def legal_codepoint?(codepoint)
-          [0x9, 0xA, 0xD].include?(codepoint) ||
-            (0x20..0xD7FF).cover?(codepoint) ||
-            (0xE000..0xFFFD).cover?(codepoint) ||
-            (0x10000..0x10FFFF).cover?(codepoint)
-        end
       end
     end
 

data/lib/sevgi/graphics/auxiliary.rb

@@ -1,9 +1,8 @@
 # frozen_string_literal: true
 
+require_relative "auxiliary/xml"
 require_relative "auxiliary/scalar"
-require_relative "auxiliary/path"
 require_relative "auxiliary/margin"
-require_relative "auxiliary/sizes"
 require_relative "auxiliary/paper"
 
 require_relative "auxiliary/canvas"

data/lib/sevgi/graphics/document/base.rb

@@ -4,8 +4,8 @@ module Sevgi
   module Graphics
     module Document
       # Abstract common document layer with the profile-independent DSL mixture set. It is not registered as a
-      # selectable profile. Advanced extensions may target this class through {Sevgi::Graphics::Mixtures.mixin}; doing
-      # so changes every descendant profile process-wide. Subclass it first when an extension should remain scoped.
+      # selectable profile. Advanced extensions can target this class through {Sevgi::Graphics::Mixtures.mixin}. This
+      # changes every descendant profile process-wide. Subclass it first to keep an extension scoped.
       class Base < Proto
         document nil, register: false
 
@@ -16,6 +16,7 @@ module Sevgi
         mixture :Include
         mixture :Lint
         mixture :Save
+        mixture :Style
         mixture :Tile
         mixture :Transform
         mixture :Underscore

data/lib/sevgi/graphics/document.rb

@@ -5,7 +5,7 @@ module Sevgi
     # SVG document profile factory and process-global named-profile registry.
     #
     # A profile owns SVG root attributes and optional preamble lines, but not canvas size. Built-in and named profiles
-    # can be passed to {Sevgi::Graphics.SVG}; an anonymous profile class is useful when library code needs one-off
+    # can be passed to {Sevgi::Graphics.SVG}. An anonymous profile class is useful when library code needs one-off
     # metadata without adding a global name.
     #
     # | Profile | Preamble | Root metadata | Additional DSL |
@@ -13,20 +13,23 @@ module Sevgi
     # | `:minimal` | none | none | common document DSL |
     # | `:default` | XML declaration | SVG namespace | common document DSL |
     # | `:html` | none | SVG namespace | common document DSL |
-    # | `:inkscape` | XML declaration | SVG and editor namespaces; crisp edges | `Draw`, `Hatch`, and editor/RDF helpers |
+    # | `:inkscape` | XML declaration | SVG and editor namespaces with crisp edges | `Draw`, `Hatch`, and editor/RDF helpers |
     #
     # The Inkscape root adds Sevgi, Inkscape, and Sodipodi namespaces plus `shape-rendering="crispEdges"`. Every
-    # selectable profile has the same validation and lint lifecycle; `:minimal` changes serialization metadata, not
+    # selectable profile has the same validation and lint lifecycle. `:minimal` changes serialization metadata, not
     # checking policy. {Base} is the public common extension layer rather than a selectable profile. {Minimal} and
     # {Default} are sibling concrete profiles: Minimal contributes no metadata and is not the semantic base of the other
-    # profiles. Targeting Base through {Sevgi::Graphics::Mixtures.mixin} changes every descendant profile process-wide;
-    # subclass Base first when an extension should remain scoped.
+    # profiles. Targeting Base through {Sevgi::Graphics::Mixtures.mixin} changes every descendant profile process-wide.
+    # Subclass Base first to keep an extension scoped.
     #
-    # @see https://sevgi.roktas.dev/svg/#document-profiles Document profiles guide
+    # @see https://sevgi.roktas.dev/documents/#profiles Document profiles guide
     module Document
       # Defensive copy helper for profile metadata snapshots.
       # @api private
       module Snapshot
+        SCALARS = [::NilClass, ::TrueClass, ::FalseClass, ::Symbol, ::Integer, ::Float, ::Rational, ::Complex].freeze
+        private_constant :SCALARS
+
         class << self
           # Captures recursively immutable profile metadata. Mutable non-container values are stringified once.
           # @param value [Object] value to capture
@@ -81,19 +84,8 @@ module Sevgi
           end
 
           def capture_value(value)
-            case value
-            when ::String
-              XML.text(value, context: "Document profile metadata").freeze
-            when ::Numeric, ::Symbol, ::NilClass, ::TrueClass, ::FalseClass
-              XML.text(value, context: "Document profile metadata")
-              value
-            else
-              stringify(value).freeze
-            end
-          end
-
-          def stringify(value)
-            XML.text(value, context: "Document profile metadata")
+            text = XML.text(value, context: "Document profile metadata")
+            SCALARS.include?(value.class) ? value : text.freeze
           end
         end
       end
@@ -194,7 +186,7 @@ module Sevgi
       # A name without metadata performs lookup. A name plus either metadata
       # keyword defines or compatibly reuses a named profile. Omitting the name
       # creates an anonymous class and leaves the registry unchanged. Named
-      # profiles are process-global; use them for shared vocabulary rather than
+      # profiles are process-global. Use them for shared vocabulary rather than
       # per-call configuration.
       # Profile metadata is captured before class or thread-atomic registry mutation. Mutable non-container attribute
       # values are stringified once, attribute names and nested Hash keys are normalized, and nil attributes are omitted
@@ -221,7 +213,7 @@ module Sevgi
         overwrite!(overwrite)
         return anonymous(attributes:, preambles:) if name == Undefined
 
-        return lookup(name) if preambles == Undefined && attributes == Undefined
+        return fetch(name) if preambles == Undefined && attributes == Undefined
 
         name = Name.normalize!(name)
         current = reuse(name, attributes:, preambles:, overwrite:)
@@ -240,10 +232,6 @@ module Sevgi
           Class.new(Base) { document(Undefined, preambles:, attributes:, register: false) }
         end
 
-        def lookup(name)
-          fetch(name)
-        end
-
         def defaults(attributes:, preambles:)
           [attributes == Undefined ? {} : attributes, preambles == Undefined ? nil : preambles]
         end
@@ -324,7 +312,7 @@ module Sevgi
       private_constant :Registry
 
       # Immutable, read-only document profile metadata exposed by document classes. Process-global lookup and registration
-      # are thread-atomic. Metadata containers and strings are captured recursively; other mutable attribute values are
+      # are thread-atomic. Metadata containers and strings are captured recursively. Other mutable attribute values are
       # stringified once during construction. Attribute names and nested Hash keys are normalized to Symbols, nil values
       # are omitted, and update-suffix intent is retained for inheritance.
       # Returned attribute and preamble collections are caller-owned snapshots,
@@ -336,7 +324,7 @@ module Sevgi
 
         # Creates profile metadata.
         # @param name [Object, nil] profile name
-        # @param attributes [Hash, nil] default root attributes; nil means an empty Hash
+        # @param attributes [Hash, nil] default root attributes. Nil means an empty Hash
         # @param preambles [Array<String>, nil] preamble lines
         # @return [void]
         # @raise [Sevgi::ArgumentError] when name or metadata is invalid XML, cyclic, or cannot be stringified