sevgi-sundries 0.95.0 → 1.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3dec50633b4f3c460af91dc1ab19341355f3ede4dd1df4bac99d4ab076b0ac53
-  data.tar.gz: b6d478d2d796f1a6379f1a40301795b41f9dca9ad68cce017e17b2c369703641
+  metadata.gz: 20ba96c5308412cca2773c3678698968da83f06814ccdcd9b2d64c9ee522312c
+  data.tar.gz: 52b7e80ff6e5828ca83359eeeca6e593440f1dcd74943142987a1a7f149a5a95
 SHA512:
-  metadata.gz: 9f36b8b5f8d7ca21602e67a50cc3272d452c4308a57b4773c94232337de9b236505e4283f09ffb85f57827087975b8ba53be8ee9d72b41b8f2d111ab6ec5ada3
-  data.tar.gz: f82107592d7771d7ce72cbfc16276db3994097385a10205748064515110faba49b5c3fef842c405deb8b6f4746940736cb985f79be750ed9c58fdb674a014a7b
+  metadata.gz: 4a899ba87fcb53cd0652e27b587ecfe2ec5d8b184e23c27f114ae08b001aa30b3f9d06497ff921738c8fe7482e212aed5bd0cef71f9e221e9169e855c43faa99
+  data.tar.gz: 218c824c2748b155e8d2005df3e8176a6de4b9e80780cba56659ddac4987481d42c23e34b23b4c040d5f5a68d946436ae91640f43d68b94d3f5f841afd9273e8

data/CHANGELOG.md

@@ -3,7 +3,226 @@
 This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html) and follows
 [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
-## Unreleased
+## 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
+
+- Restored the `sevgi` CLI's main-object scope so bare toolkit calls remain available inside script helper classes.
+
+## 0.98.1 - 2026-07-20
+
+### Changed
+
+- Changed the `sevgi` CLI to use the executor's isolated scope by default.
+
+### Removed
+
+- Removed the redundant `-n` and `--nomain` CLI options; library consumers can still select `main: true` through
+  `Sevgi.execute` and `Sevgi.execute_file` when needed.
+
+## 0.98.0 - 2026-07-20
+
+### Added
+
+- Added standard-input support to `sevgi`, `igves`, and `igsev`; `sevgi --as NAME` and
+  `Sevgi.execute_file(..., as: NAME)` supply the logical source basename used by implicit SVG, PDF, and PNG
+  destinations without changing physical load identity.
+
+## 0.97.0 - 2026-07-19
+
+### Added
+
+- Added `sevgi-appendix`, containing the Sevgi agent skill and a RuboCop plugin for preserving readable `.sevgi` DSL
+  source alongside rubyfmt-formatted Ruby; the umbrella `sevgi` gem installs the matching Appendix version.
+- Added `sevgi --skill` to report the validated path of the matching packaged agent skill for product-neutral setup.
+- Added `igsev` to the umbrella gem for normalizing an SVG file through a complete SVG-to-Sevgi-to-SVG round trip.
+
+### Changed
+
+- Made Homebrew the recommended complete CLI installation while retaining Bundler and focused component gems for Ruby
+  application dependencies.
+
+## 0.96.0 - 2026-07-18
+
+### Added
+
+- Added exact, subtree-wide attribute omission to Derender content/file conversion, evaluation, and inclusion APIs;
+  `igves --omit` exposes the same behavior from the command line.
+- Added `Sevgi.SVG` as the explicit namespaced form of the top-level SVG document entrypoint.
+- Added the opt-in recursive `SVG::Modules` contract for callable drawing namespaces.
+- Added callable drawing-module `base` blocks, document and paper registry introspection, Canvas structural equality,
+  renderer options on `RenderChildren`, axis translation helpers, and a CC BY RDF helper.
+- Formalized non-rendering `-` metadata and `+` attribute updates as `Attributes::META_PREFIX` and
+  `Attributes::UPDATE_SUFFIX`; repeated Array updates now concatenate into a stable flat value.
+
+### Changed
+
+- Breaking: replaced the `SVG = Sevgi::Graphics` alias with an independent SVG facade. Facade operations now use
+  capitalized names such as `SVG.Canvas` and `SVG.Document`; lowercase component helpers remain on
+  `Sevgi::Graphics`, and the stuttering `SVG.SVG` form was removed.
+- Breaking: made low-level `Executor.execute` and `execute_file` runners private; consumers use
+  `Sevgi.execute` and `Sevgi.execute_file` while retaining the public result and error types.
+- Breaking: removed the abstract `Document::Base` layer from the selectable document-profile registry; `Minimal` and
+  `Default` are now sibling concrete profiles, and custom profile hierarchies should derive from `Base`.
+- Breaking: renamed Parallelogram segment and constraint arguments by geometric role: `base`, `side`, and
+  `constraint` replace axis-implying constructor names.
+- Made degree-based sine and cosine exact at integer quarter turns, eliminating cardinal Geometry residue.
+- Documented complete file-system failure families for file comparison, output, touch, and upward location helpers.
+- Formalized generated Tile ids, positional CSS classes, template placement, and per-use callback signatures.
+- Formalized String and Symbol ids across Derender selection APIs and documented file-read failures consistently.
+- Breaking: made top-level `Decompile`, `Derender`, `Evaluate`, and `EvaluateChildren` consume inline SVG/XML;
+  file inputs now use the corresponding `File`-suffixed entrypoints.
+- Breaking: replaced callable drawing module `call` block registration with argument-independent `base` blocks;
+  inherited bases run parent-first, and modules with one drawing method conventionally name it `call`.
+- Breaking: made bracket and call notation the canonical Geometry constructors. Among Data value types, bracket notation
+  is public only for Point, Segment, LengthAngle, Margin, and Paper; use `.new` for Location and result carriers, and
+  `Stay` for traversal stop tokens.
+- Breaking: aligned Point and Segment comparison with Ruby `Comparable`; malformed or unrelated comparison operands now
+  return nil from `<=>`.
+- Breaking: executor entrypoints now return immutable `Executor::Result` values and expose only `execute` and
+  `execute_file`; inspect `result.error`, `result.stack`, and `result.value` instead of executor scopes or lifecycle state.
+- Breaking: wrapper attributes and callable arguments use distinct channels, `With` rejects parentless receivers, and
+  unsupported direct constructors are private; use the documented factories for Content, concrete Geometry lined
+  elements, and Grid query values.
+- Breaking: Canvas uses `.new` for explicit fields, `.from_paper(paper, **overrides)` for paper conversion, and
+  `.call`/`Graphics.canvas` for dispatch; the misleading keyword-only `.from_paper(width:, height:)` form was removed.
+- Breaking: `Save`, `Write`, `PNG`, `PDF`, and Sundries native export normalize successful destinations to expanded
+  String paths and create missing parent directories; change-aware SVG writes still return nil when unchanged.
+- Breaking: renamed `Derender.evaluate_file_children` to `evaluate_children_file`; decompiled nodes now own immutable
+  public state while parser, strategy, and construction plumbing remain private.
+- Expanded runtime/YARD parity checks and exact contracts for inherited, extended, generated, and dynamic API surfaces,
+  forwarded options, error channels, path ownership, whitespace, namespaces, nil behavior, and return values.
+
+### Fixed
+
+- Rejected directories from default file discovery while preserving custom locator matchers.
+- Kept `Ancestral` context in non-rendering `-context` metadata instead of leaking it into SVG attributes.
+- Preserved source Canvas units and names when deriving fitted Grid canvases.
+- Prevented stale documentation assets from mixing old layouts with new HTML, and moved sidebar navigation into the
+  tablet menu at 1024px and below.
+- Normalized numeric slots owned by path, shape, transform, tile, and Inkscape page helpers to finite SVG number spelling;
+  arbitrary user-supplied attributes remain untouched.
+- Made named callable wrapper and symbol ids stable while omitting defaults for anonymous modules, and indexed every
+  rendered id value, including false and numeric values, through its serialized string.
+- Preserved signed Geometry constraint directions, rejected invalid sweep/export channels through Sevgi error families,
+  and validated raw output paths before expansion or rendering.
+- Made callable module configuration copy-owned and freeze-aware, document subclasses inherit their nearest profile, and
+  false executor boot receivers remain explicit rather than defaulting to an internal scope.
+- Made element trees, attributes, identifiers, locator results, document profiles, Derender nodes, shell results, and
+  executor results retain owned immutable snapshots where their public contracts promise value semantics.
+- Corrected Shell combined-output separators, nil export density errors, document render-option routing, executor source
+  snapshots, selected-node namespace/whitespace documentation, and Standard character-data validation.
+
+### Removed
+
+- Removed public access to pluralization tables and the internal SVG save extension; pluralization rules are now deeply
+  immutable.
+- Removed public documentation and constant access for command-line implementation modules; the `sevgi` and `igves`
+  executables remain unchanged.
+- Removed eager loading and public documentation of private Showcase build/test support; explicit support entrypoints
+  now keep the harness under the Showcase namespace.
+- Removed public access to document profile name normalizers; registry operations retain them as private plumbing.
+- Removed the redundant `Margin.margin` constructor; use canonical bracket notation.
+- Removed public executor orchestration, obsolete callable-module hooks, the old public attribute syntax constants, and
+  direct construction of abstract or internally wired Content, Element, and Grid query types.
+- Removed accidental public access to abstract Lined factories, internal element-name/export maps, result/location
+  bracket constructors, and direct Stop construction.
 
 ## 0.95.0 - 2026-07-11
 
@@ -87,7 +306,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

@@ -1,6 +1,6 @@
 # Sevgi Sundries
 
-Helper objects and export tools for Sevgi drawings.
+Sevgi Sundries contains shared layout objects and optional export tools.
 
 ## Install
 
@@ -17,14 +17,20 @@ require "sevgi/sundries"
 ## Example
 
 ```ruby
-rect = Sevgi::Geometry::Rect[3, 5]
-tile = Sevgi::Sundries::Tile.new(rect)
-tile.box.height
+x = Sevgi::Sundries::Ruler.new(brut: 80, unit: 1, multiple: 10, margins: [5])
+y = Sevgi::Sundries::Ruler.new(brut: 50, unit: 1, multiple: 10, margins: [5])
+grid = Sevgi::Sundries::Grid[x, y]
+
+grid.x.major.lines.size # => 5
+grid.canvas.margin.to_a # => [5.0, 5.0, 5.0, 5.0]
 ```
 
+Rulers, grids, and tiles are inspectable Ruby values. They create no SVG elements by themselves. Pass their geometry
+to Sevgi Graphics when the document needs it.
+
 ## Ruby compatibility
 
-Requires Ruby 3.4.0 or newer. CI verifies Ruby 3.4.0 and the current development Ruby from `.ruby-version`.
+Requires Ruby 3.4.0 or newer. CI verifies the current Ruby 3.4 release and the development Ruby from `.ruby-version`.
 
 ## Native prerequisites
 
@@ -49,7 +55,7 @@ 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
+- 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

@@ -20,29 +20,33 @@ module Sevgi
 
       # Exports SVG source to a PDF or PNG file using librsvg and Cairo.
       # @param svg [String] SVG source content
-      # @param output [String, #to_s] output file path
+      # Relative paths are expanded, missing parent directories are created after all render inputs validate, and an
+      # existing output file is replaced. Directory paths are not expanded to a default file name.
+      # @param output [String, #to_path] output file path
       # @param format [Symbol, String, nil] explicit output format, or nil to infer from output extension
       # @param width [Numeric, nil] finite positive target width in output pixels for PNG, or CSS pixels before PDF point conversion
       # @param height [Numeric, nil] finite positive target height in output pixels for PNG, or CSS pixels before PDF point conversion
-      # @param dpi [Numeric] finite positive CSS pixel density used for absolute SVG units and PDF point conversion
+      # @param dpi [Numeric] finite positive CSS pixel density. Omission uses {DEFAULT_DPI}, but explicit nil is invalid
       # @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 output, CSS, or transformed SVG has an invalid type
-      # @raise [Sevgi::Sundries::Export::ExportError] when format, numeric options, SVG parsing, SVG dimensions, or render dimensions are invalid
+      # @return [String] expanded output path
+      # @raise [Sevgi::ArgumentError] when output is blank, invalid, or a directory, or CSS/transformed SVG has an
+      #   invalid type
+      # @raise [Sevgi::Sundries::Export::ExportError] when format, numeric options, CSS insertion, SVG parsing, SVG dimensions, or render dimensions are invalid
+      # @raise [SystemCallError] when the output directory or file cannot be created or written
       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)
-        original_output = output
         output = output_path(output)
-        format = format_for!(format, output)
+        format = format_for(format, output)
         width = dimension(width, "width")
         height = dimension(height, "height")
-        dpi = dimension(dpi, "dpi")
+        dpi = dimension(dpi, "dpi", optional: false)
         ArgumentError.("Export CSS must be a String") unless css.nil? || css.is_a?(String)
+        ArgumentError.("Export CSS must be valid text") if css && !css.valid_encoding?
 
-        svg = inject(svg, css) if css && !css.strip.empty?
+        svg = styled(svg, css) if css && !css.strip.empty?
         svg = block.call(svg) if block
         ArgumentError.("SVG content must be a String") unless svg.is_a?(String)
 
@@ -62,6 +66,7 @@ module Sevgi
           tw, th = target_size(iw, ih, width, height)
           ExportError.("Invalid export dimensions") unless target_size?(format, tw, th)
 
+          ::FileUtils.mkdir_p(::File.dirname(output))
           renderer.call(
             handle: handle,
             output: output,
@@ -75,7 +80,7 @@ module Sevgi
           ExportError.("Render error: #{e.message}")
         end
 
-        original_output
+        output
       end
 
       # Replaces exact placeholder text objects in PDF streams.
@@ -88,24 +93,18 @@ module Sevgi
       # @param placeholder [String] placeholder text to replace
       # @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
-      # @note Streams with unbalanced graphics-state or text-object operators are left unchanged.
+      # @note Pages with inline images, unknown operators, or unbalanced graphics-state/text-object operators are left unchanged.
       def stamp(infile, outfile, stamp:, placeholder:)
         doc = HexaPDF::Document.open(infile)
         replacements = 0
 
         doc.pages.each do |page|
-          Array(page[:Contents]).each do |ref|
-            obj = doc.object(ref)
-            next unless obj.respond_to?(:stream)
+          data, count = stamp_stream(page.contents, stamp:, placeholder:)
+          next if count.zero?
 
-            data, count = stamp_stream(obj.stream, stamp:, placeholder:)
-            next if count.zero?
-
-            replacements += count
-
-            obj.stream = data
-            obj.set_filter(:FlateDecode)
-          end
+          replacements += count
+          page.contents = data
+          doc.deref(page[:Contents]).set_filter(:FlateDecode)
         end
 
         doc.write(outfile, optimize: true) if replacements.positive?
@@ -122,7 +121,7 @@ module Sevgi
       # @param placeholder [String] placeholder text to replace
       # @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
-      # @note Streams with unbalanced graphics-state or text-object operators are left unchanged.
+      # @note Pages with inline images, unknown operators, or unbalanced graphics-state/text-object operators are left unchanged.
       def stamp!(infile, stamp:, placeholder:)
         temp = Tempfile.new(%w[stamp .pdf], File.dirname(infile))
         stamped = stamp(infile, temp.path, stamp:, placeholder:)
@@ -181,7 +180,6 @@ module Sevgi
           serializer = HexaPDF::Serializer.new
           operands = []
           state = {
-            fill_span: nil,
             fill_white: false,
             font_size: nil,
             in_text: false,
@@ -202,8 +200,12 @@ module Sevgi
               next
             end
 
+            # Inline image bytes are not PDF tokens; never interpret them as operators.
+            operator = object.to_sym
+            return [{}, 0] if operator == :BI || !HexaPDF::Content::Processor::OPERATOR_MESSAGE_NAME_MAP.key?(operator)
+
             count += process_operator(
-              object.to_sym,
+              operator,
               operands,
               finish,
               data,
@@ -223,11 +225,13 @@ module Sevgi
         def process_operator(operator, operands, finish, data, stamp:, placeholder:, serializer:, state:, replacements:)
           case operator
           when :q
-            state[:stack] << state.values_at(:fill_span, :fill_white, :font_size)
+            state[:stack] << state.values_at(:fill_white, :font_size)
           when :Q
             state[:stack].any? ? restore_state(state) : state[:valid] = false
           when :rg
-            set_fill_state(state, operands, finish)
+            set_fill_state(state, operands)
+          when :g, :k, :cs, :sc, :scn
+            state[:fill_white] = false
           when :BT
             state[:valid] = false if state[:in_text]
             state[:in_text] = true
@@ -241,6 +245,7 @@ module Sevgi
               operator,
               operands,
               data,
+              operator_finish: finish,
               stamp:,
               placeholder:,
               serializer:,
@@ -253,31 +258,38 @@ module Sevgi
         end
 
         def restore_state(state)
-          state[:fill_span], state[:fill_white], state[:font_size] = state[:stack].pop
+          state[:fill_white], state[:font_size] = state[:stack].pop
         end
 
-        def set_fill_state(state, operands, finish)
+        def set_fill_state(state, operands)
           state[:fill_white] = operands.size == 3 && operands.all? { |value, _start, _finish| value == 1 }
-          state[:fill_span] = [operands.first[1], finish] if state[:fill_white]
-          state[:fill_span] = nil unless state[:fill_white]
         end
 
-        def add_text_replacement(operator, operands, data, stamp:, placeholder:, serializer:, state:, replacements:)
+        def add_text_replacement(
+          operator,
+          operands,
+          data,
+          operator_finish:,
+          stamp:,
+          placeholder:,
+          serializer:,
+          state:,
+          replacements:
+        )
           replacement = text_replacement(data, operator, operands, stamp:, placeholder:, serializer:, state:)
           return 0 unless replacement
 
-          start, finish, text = replacement
-          replacements[[start, finish]] = text
-          add_color_replacement(data, state, replacements)
+          start, text_finish, text = replacement
+          color_start = operands.first.fetch(1)
+          text = " 0.101961 0.101961 0.101961 rg#{text}" if start == color_start
+          replacements[[start, text_finish]] = text
+          add_color_replacement(color_start, replacements) unless start == color_start
+          replacements[[operator_finish, operator_finish]] ||= " 1 1 1 rg"
           1
         end
 
-        def add_color_replacement(data, state, replacements)
-          return unless state[:fill_span]
-
-          color_start, color_finish = state[:fill_span]
-          prefix = data[color_start...color_finish].to_s[/\A\s*/]
-          replacements[[color_start, color_finish]] ||= "#{prefix}0.101961 0.101961 0.101961 rg"
+        def add_color_replacement(start, replacements)
+          replacements[[start, start]] ||= " 0.101961 0.101961 0.101961 rg"
         end
 
         def text_replacement(data, operator, operands, stamp:, placeholder:, serializer:, state:)
@@ -308,19 +320,21 @@ module Sevgi
         def output_path(output)
           ArgumentError.("Export output must be provided") if output.nil?
 
-          path = output.to_s
-          ArgumentError.("Export output must be a String-like path") unless path.is_a?(::String)
+          path = output.respond_to?(:to_path) ? output.to_path : output
+          ArgumentError.("Export output must be a String or path-like object") unless path.is_a?(::String)
           ArgumentError.("Export output must be provided") if path.strip.empty?
 
+          path = ::File.expand_path(path)
+          ArgumentError.("Export output must name a file") if ::File.directory?(path)
           path
         rescue ::StandardError => e
           raise if e.is_a?(::Sevgi::ArgumentError)
 
-          ArgumentError.("Export output must be a String-like path: #{e.message}")
+          ArgumentError.("Export output must be a String or path-like object: #{e.message}")
         end
 
-        def dimension(value, field)
-          return if value.nil?
+        def dimension(value, field, optional: true)
+          return if value.nil? && optional
           ExportError.(dimension_error(field)) unless value.is_a?(::Numeric)
 
           number = begin
@@ -420,18 +434,6 @@ module Sevgi
       module Renderer
         extend self
 
-        # Returns a renderer method for a format.
-        # @param format [Symbol, String, nil] format name
-        # @return [Method, nil]
-        def [](format)
-          case format&.to_sym
-          when :png
-            method(:png)
-          when :pdf
-            method(:pdf)
-          end
-        end
-
         # Renders SVG data to a PDF surface.
         # @param handle [Rsvg::Handle] parsed SVG handle
         # @param output [String] output file path

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

@@ -22,8 +22,10 @@ module Sevgi
       # @raise [Errno::ENOENT] when the executable cannot be spawned
       def a5_on_a4!(infile)
         temp = Tempfile.new(%w[output .pdf], File.dirname(infile))
-        a5_on_a4(infile, temp.path)
-        FileUtils.mv(temp.path, infile)
+        outfile = temp.path
+        temp.close!
+        a5_on_a4(infile, outfile)
+        FileUtils.mv(outfile, infile)
       ensure
         temp&.close!
       end
@@ -40,7 +42,7 @@ module Sevgi
       # @param page [Integer, String, nil] page selector passed to Inkscape
       # @param css [String, nil] CSS inserted before exporting
       # @return [Sevgi::Function::Shell::Result] command result
-      # @raise [Sevgi::Sundries::Export::ExportError] when format or output extension is unsupported
+      # @raise [Sevgi::Sundries::Export::ExportError] when format, output extension, or CSS insertion is invalid
       # @raise [Sevgi::Error] when Inkscape is missing or the command fails
       # @raise [Errno::ENOENT] when the executable cannot be spawned
       # @see https://inkscape.org/ Inkscape
@@ -59,11 +61,11 @@ module Sevgi
         infile = File.expand_path(infile)
         outfile ||= F.subext(".pdf", infile)
         outfile = File.expand_path(outfile)
-        format = format_for!(format, outfile)
+        format = format_for(format, outfile)
 
         if css
           temp = Tempfile.new(%w[input .svg], File.dirname(infile))
-          ::File.write(temp.path, inject(::File.read(infile), css))
+          ::File.write(temp.path, styled(::File.read(infile), css))
           infile = temp.path
         end
 
@@ -98,7 +100,7 @@ module Sevgi
       # @param id [String, nil] SVG element id to export
       # @param css [String, nil] CSS inserted before exporting
       # @return [Sevgi::Function::Shell::Result] command result
-      # @raise [Sevgi::Sundries::Export::ExportError] when format or output extension is unsupported
+      # @raise [Sevgi::Sundries::Export::ExportError] when format, output extension, or CSS insertion is invalid
       # @raise [Sevgi::Error] when rsvg-convert is missing or the command fails
       # @raise [Errno::ENOENT] when the executable cannot be spawned
       # @see https://gitlab.gnome.org/GNOME/librsvg librsvg
@@ -115,11 +117,11 @@ module Sevgi
         infile = File.expand_path(infile)
         outfile ||= F.subext(".pdf", infile)
         outfile = File.expand_path(outfile)
-        format = format_for!(format, outfile)
+        format = format_for(format, outfile)
 
         if css
           temp = Tempfile.new(%w[input .svg], File.dirname(infile))
-          ::File.write(temp.path, inject(::File.read(infile), css))
+          ::File.write(temp.path, styled(::File.read(infile), css))
           infile = temp.path
         end