sevgi-standard 0.95.0 → 0.98.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bbd8aa9bd86beedb621d7f5a2231821c3e33e15f038a6b9b858764fc6789e16e
-  data.tar.gz: c2aa30f2b04fe0b7769667223902ba92d17aa99e3e5d182d79c24ec5fbf53961
+  metadata.gz: 3787ffa0eaba0ccbed4e09617d690e86bd573e582a998c66f9c3aaaff1a0e5ea
+  data.tar.gz: 0afd16d8886430a82f8294ebaeccb320adec60a6265a9ced7e765116fe74b48e
 SHA512:
-  metadata.gz: e180e41124e5579fef07b58ff3fb7b54371feebd118919a33ca1720bf3d50623d4accdd419d0465df0721b16ca866a9722a8196177d5aa1c7194ef8093fc906d
-  data.tar.gz: a28509223d1ec39ff0feb51d60df71f4a1b3c1d459173d596f67f7c76a8a1a2c06457f6d60fd1ce1b2e16786ea0ffd7bc89ac49e1a928750a9a6c3c7b79b7fb0
+  metadata.gz: 928b65a3adaf1c1bf5eb5a75de77989fe7574fdb037833dea0986a08e1f89466dbe879ab28327fa14ed513bc897be0535d10ae507bc0a95ab4c8a05b4cd3d413
+  data.tar.gz: b7016a3f90576b7e0e669a0b569a86689d95197ec06500b242b1f1f9ae79cf871f37796d4dc32ff1df517fd84bf2062a1aefda2759d858d59dd67a08284aab3d

data/CHANGELOG.md

@@ -5,6 +5,131 @@ This project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.htm
 
 ## Unreleased
 
+## 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
 
 ### Security

data/README.md

@@ -1,6 +1,6 @@
 # Sevgi Standard
 
-SVG element, attribute, and conformance data used by Sevgi validation.
+Sevgi Standard supplies the SVG element and attribute data used by validation.
 
 ## Install
 
@@ -23,15 +23,15 @@ Sevgi::Standard.attribute?(:width)
 
 ## 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
 
-None beyond Ruby and this gem's Ruby dependencies.
+This gem needs only Ruby and its Ruby dependencies.
 
 ## Links
 
-- Documentation: https://sevgi.roktas.dev
-- API documentation: https://www.rubydoc.info/gems/sevgi-standard
-- Source: https://github.com/roktas/sevgi/tree/main/standard
-- Changelog: https://github.com/roktas/sevgi/blob/main/CHANGELOG.md
+- Documentation: <https://sevgi.roktas.dev>
+- API documentation: <https://www.rubydoc.info/gems/sevgi-standard>
+- Source: <https://github.com/roktas/sevgi/tree/main/standard>
+- Changelog: <https://github.com/roktas/sevgi/blob/main/CHANGELOG.md>

data/lib/sevgi/standard/conform.rb

@@ -38,6 +38,7 @@ module Sevgi
       # @param elements [Array<String, Symbol>, String, Symbol, nil] child element names
       # @return [Boolean] true when the usage conforms
       # @raise [Sevgi::ArgumentError] when any name is not a valid public name
+      # @raise [Sevgi::ArgumentError] when cdata is not a String or nil
       # @raise [Sevgi::ValidationError] when the usage violates the standard data
       def call(attributes: nil, cdata: nil, elements: nil)
         if attributes
@@ -60,33 +61,45 @@ module Sevgi
       # @param elements [Array<String, Symbol>, nil] child element names
       # @return [Boolean] true when the usage conforms or the element is ignored
       # @raise [Sevgi::ArgumentError] when any name is not a valid public name
+      # @raise [Sevgi::ArgumentError] when cdata is not a String or nil
       # @raise [Sevgi::ValidationError] when the usage violates the standard data
       # @raise [Sevgi::PanicError] when the standard data refers to an invalid model
       def self.call(element, attributes: nil, cdata: nil, elements: nil)
         element = Name.normalize!(element, context: "element")
         attributes = Name.list!(attributes, context: "attribute")
         elements = Name.list!(elements, context: "element") || []
+        cdata = normalize_cdata(cdata)
 
         Element.ignore?(element) or
           validate(element, attributes:, elements:, cdata:)
       end
 
-      def self.validate(element, attributes:, elements:, cdata:)
-        validator = @cache[element] || new(element)
-        result = validator.call(**arguments(attributes, elements, cdata))
-        @cache[element] ||= validator
-        result
-      end
+      class << self
+        private
 
-      def self.arguments(attributes, elements, cdata)
-        {
-          attributes: Attribute.concerns(attributes),
-          elements: Element.concerns(elements),
-          cdata:
-        }
-      end
+        def validate(element, attributes:, elements:, cdata:)
+          validator = @cache[element] || new(element)
+          result = validator.call(**arguments(attributes, elements, cdata))
+          @cache[element] ||= validator
+          result
+        end
+
+        def arguments(attributes, elements, cdata)
+          {
+            attributes: Attribute.concerns(attributes),
+            elements: Element.concerns(elements),
+            cdata:
+          }
+        end
+
+        def normalize_cdata(cdata)
+          unless cdata.nil? || cdata.is_a?(::String)
+            ArgumentError.("Character data must be a String or nil: #{cdata.inspect}")
+          end
 
-      private_class_method :arguments, :validate
+          cdata unless cdata == ""
+        end
+      end
     end
 
     private_constant :Conform, :Model

data/lib/sevgi/standard/data.rb

@@ -43,6 +43,10 @@ module Sevgi
       # @return [Set<Symbol>] mutation-isolated set snapshot
       def all = Snapshot.copy(@all ||= Set[*data.values.flatten.uniq.sort])
 
+      # Returns accepted group names for this data list.
+      # @return [Set<Symbol>] frozen group-name snapshot
+      def groups = @groups ||= Set[*data.keys.sort].freeze
+
       # Checks whether a name belongs to a group.
       # @param name [Symbol] item name
       # @param group [Symbol] group name
@@ -94,6 +98,8 @@ module Sevgi
 
     private_constant :Common
 
+    # SVG attribute registry implementation.
+    # @api private
     module Attribute
       extend Common
       extend self
@@ -103,6 +109,8 @@ module Sevgi
 
     private_constant :Attribute
 
+    # SVG element registry implementation.
+    # @api private
     module Element
       extend Common
       extend self
@@ -112,6 +120,8 @@ module Sevgi
 
     private_constant :Element
 
+    # SVG specification registry implementation.
+    # @api private
     module Specification
       extend List
       extend self
@@ -162,11 +172,6 @@ module Sevgi
         names.replace(names.flat_map { |name| group?(name) ? list[name] : name }.uniq)
       end
 
-      # For testing purposes
-
-      def charge = data.each_key { expand(it) }
-
-      def flush = (@spec = {})
     end
 
     private_constant :Specification

data/lib/sevgi/standard/version.rb

@@ -3,6 +3,6 @@
 module Sevgi
   module Standard
     # Current version of the Sevgi standard gem.
-    VERSION = "0.95.0"
+    VERSION = "0.98.2"
   end
 end

data/lib/sevgi/standard.rb

@@ -15,6 +15,10 @@ module Sevgi
   # The registry is a Sevgi compatibility set based on SVG 2 plus the split-out SVG modules and legacy entries already
   # modeled in the bundled specifications. Supported element names must have matching specification data; abandoned or
   # unspecified proposal entries are not exposed as supported elements.
+  #
+  # @example Validate an SVG element usage
+  #   Sevgi::Standard.conform(:rect, attributes: %i[width height]) #=> true
+  #   Sevgi::Standard.element?(:foreignObject)                    #=> true
   module Standard
     extend self
 
@@ -22,8 +26,16 @@ module Sevgi
     #   Returns SVG attributes, optionally restricted to one or more attribute groups.
     #   @param groups [Array<String, Symbol>] attribute group names
     #   @return [Set<Symbol>] mutation-isolated attribute-name snapshot
+    #   @raise [Sevgi::ArgumentError] when a group name is invalid or not listed by {.attribute_groups}
+    # @example Discover and apply an attribute group
+    #   Sevgi::Standard.attribute_groups.include?(:Core) #=> true
+    #   Sevgi::Standard.attributes(:Core).include?(:id)  #=> true
     def attributes(...) = Attribute.set(...)
 
+    # Returns accepted attribute group names.
+    # @return [Set<Symbol>] frozen group-name snapshot
+    def attribute_groups = Attribute.groups
+
     # Reports whether an attribute name is recognized by the SVG standard data.
     # @param name [String, Symbol] attribute name
     # @return [Boolean]
@@ -40,16 +52,26 @@ module Sevgi
     #   @return [Boolean] true when the usage conforms
     #   @raise [Sevgi::ArgumentError] when any name is not a String or Symbol
     #   @raise [Sevgi::ArgumentError] when any name is not a valid SVG-style name
+    #   @raise [Sevgi::ArgumentError] when cdata is not a String or nil
     #   @raise [Sevgi::ValidationError] when the usage violates the standard data
     #   @raise [Sevgi::PanicError] when the standard data refers to an invalid model
+    #   @note Empty character data is treated as absent.
     def conform(...) = Conform.(...)
 
     # @overload elements(*groups)
     #   Returns SVG elements, optionally restricted to one or more element groups.
     #   @param groups [Array<String, Symbol>] element group names
     #   @return [Set<Symbol>] mutation-isolated element-name snapshot
+    #   @raise [Sevgi::ArgumentError] when a group name is invalid or not listed by {.element_groups}
+    # @example Discover and apply an element group
+    #   Sevgi::Standard.element_groups.include?(:Descriptive) #=> true
+    #   Sevgi::Standard.elements(:Descriptive)                 #=> Set[:desc, :metadata, :title]
     def elements(...) = Element.set(...)
 
+    # Returns accepted element group names.
+    # @return [Set<Symbol>] frozen group-name snapshot
+    def element_groups = Element.groups
+
     # Reports whether an element name is recognized by the SVG standard data.
     # @param name [String, Symbol] element name
     # @return [Boolean]

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sevgi-standard
 version: !ruby/object:Gem::Version
-  version: 0.95.0
+  version: 0.98.2
 platform: ruby
 authors:
 - Recai Oktaş
@@ -15,15 +15,15 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.95.0
+        version: 0.98.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.95.0
-description: Validates elements and attributes according to the SVG specification.
+        version: 0.98.2
+description: Checks generated SVG against standard element and attribute rules.
 email: roktas@gmail.com
 executables: []
 extensions: []
@@ -65,7 +65,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.11
+rubygems_version: 4.0.16
 specification_version: 4
-summary: SVG Validation for the Sevgi toolkit.
+summary: SVG element and attribute validation for Sevgi.
 test_files: []