sevgi-standard 0.93.1 → 0.94.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 845a552c81846d5e0183f1ef2243ea0ddcf90a94a8bcbe64edab77df9e6ac877
-  data.tar.gz: dd99636019944aaee3d6481c44fc67b48c834718a1f843afd22bfb5c1553ec78
+  metadata.gz: 032a1a8f609e2cebf4de52c844f69cdfc13504a438c08042aff5dde09ef0b331
+  data.tar.gz: 8aa466073442ec8062aa48468e7274e7e9d275558a8be154cf26fce32c121d0d
 SHA512:
-  metadata.gz: d1d2d534bab867b6357bb7623f498d60a82965446c06c0553cc37a63529a8e783024ff65f10422cdd382dec9f19497f1c435965a4e72bfd3afcb2afb0e228afa
-  data.tar.gz: aae602ac61b37d6c4de6549bb2763d02fd3a1c3de3157dc8f6bc831d1a93a0f357a125be55fb221d0acf3a7a9c2480fc3d8965e8f1b0b3dde5cded9fdb39f070
+  metadata.gz: 4756ece8ebbcf5d7d971d27e9711ba116652378f271d23bcc543e19a28eae94cdd47a51d90489b79233166a1f9e9adaf0e446f4a43d73d90a6423aad6074d3c6
+  data.tar.gz: bec85c8ec04964a3e44e3d780d4b22f61e87f8faef3fbebad5b95144dbe639a76a4d5373212203e123ce57d7abb441b785d904d2f6b526a4e2e46947e1e99334

data/CHANGELOG.md

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

data/LICENSE

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

data/README.md

@@ -1,5 +1,37 @@
 # Sevgi Standard
 
-Provides SVG element, attribute, and conformance data used by Sevgi validation.
+SVG element, attribute, and conformance data used by Sevgi validation.
 
-See the root [README](../README.md) and the documentation site for usage.
+## Install
+
+```sh
+gem install sevgi-standard
+```
+
+## Require
+
+```ruby
+require "sevgi/standard"
+```
+
+## Example
+
+```ruby
+Sevgi::Standard.element?(:rect)
+Sevgi::Standard.attribute?(:width)
+```
+
+## Ruby compatibility
+
+Requires Ruby 3.4.0 or newer. CI verifies Ruby 3.4 and the current development Ruby from `.ruby-version`.
+
+## Native prerequisites
+
+None beyond Ruby and this gem's 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

data/lib/sevgi/standard/conform.rb

@@ -14,11 +14,14 @@ module Sevgi
       attr_reader :spec
 
       # Builds a validator for one SVG element.
-      # @param element [Symbol] SVG element name
+      # @param element [String, Symbol] SVG element name
       # @return [void]
+      # @raise [Sevgi::ArgumentError] when element is not a valid public name
       # @raise [Sevgi::InvalidElementsError] when the element is unknown
       # @raise [Sevgi::PanicError] when the element model is missing or unimplemented
       def initialize(element)
+        element = Name.normalize!(element, context: "element")
+
         InvalidElementsError.(element) unless (@spec = Specification[@element = element])
 
         PanicError.("No model specified: #{element}") unless spec[:model]
@@ -30,10 +33,11 @@ module Sevgi
       end
 
       # Validates one usage of the configured SVG element.
-      # @param attributes [Array<Symbol>, nil] attribute names used by the element
+      # @param attributes [Array<String, Symbol>, nil] attribute names used by the element
       # @param cdata [String, nil] character data content
-      # @param elements [Array<Symbol>, nil] child element names
+      # @param elements [Array<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::ValidationError] when the usage violates the standard data
       def call(attributes: nil, cdata: nil, elements: nil)
         if attributes
@@ -50,18 +54,23 @@ module Sevgi
       @cache = {}
 
       # Validates one SVG element usage, using cached element validators.
-      # @param element [Symbol] SVG element name
-      # @param attributes [Array<Symbol>, nil] attribute names used by the element
+      # @param element [String, Symbol] SVG element name
+      # @param attributes [Array<String, Symbol>, nil] attribute names used by the element
       # @param cdata [String, nil] character data content
-      # @param elements [Array<Symbol>, nil] child element names
+      # @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::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")
+
         Element.ignore?(element) or
           (@cache[element] ||= new(element)).call(
             attributes: Attribute.concerns(attributes),
-            elements: Element.concerns(elements || []),
+            elements: Element.concerns(elements),
             cdata:
           )
       end

data/lib/sevgi/standard/data/attribute.rb

@@ -483,7 +483,6 @@ module Sevgi
         Deprecated: %i[
           accent-height
           alphabetic
-          amplitude
           arabic-form
           ascent
           attributeType
@@ -492,12 +491,29 @@ module Sevgi
         ]
       )
 
+      RESERVED_NAMESPACE_PREFIXES = %w[xlink: xml:].freeze
+      private_constant :RESERVED_NAMESPACE_PREFIXES
+
+      # Reports whether an attribute name should be ignored by standard validation.
+      # @param attribute [String, Symbol, Object] candidate attribute name
+      # @return [Boolean] true for valid private, data, xmlns, or foreign namespaced attributes
       def ignore?(attribute)
-        attribute.start_with?("_") ||
-          attribute == :xmlns ||
-          attribute.start_with?("data-") ||
-          (attribute.to_s.include?(":") && !attribute.start_with?("xlink:") && !attribute.start_with?("xml:"))
+        return false unless attribute.is_a?(::String) || attribute.is_a?(::Symbol)
+
+        name = attribute.to_s
+
+        Name.valid?(name) && ignored_name?(name)
       end
+
+      def ignored_name?(name)
+        name.start_with?("_") || name == "xmlns" || name.start_with?("data-") || foreign_namespace?(name)
+      end
+
+      def foreign_namespace?(name)
+        name.include?(":") && RESERVED_NAMESPACE_PREFIXES.none? { name.start_with?(it) }
+      end
+
+      private_class_method :foreign_namespace?, :ignored_name?
     end
   end
 end

data/lib/sevgi/standard/data/element.rb

@@ -8,6 +8,7 @@ module Sevgi
           animate
           animateMotion
           animateTransform
+          discard
           mpath
           set
         ],
@@ -146,7 +147,6 @@ module Sevgi
           linearGradient
           pattern
           radialGradient
-          solidcolor
         ],
 
         Renderable: %i[
@@ -265,8 +265,15 @@ module Sevgi
         ]
       )
 
+      # Reports whether an element name should be ignored by standard validation.
+      # @param element [String, Symbol, Object] candidate element name
+      # @return [Boolean] true for valid private or namespaced element names that Sevgi should not validate
       def ignore?(element)
-        (name = element.to_s).include?(":") || name.start_with?("_")
+        return false unless element.is_a?(::String) || element.is_a?(::Symbol)
+
+        name = element.to_s
+
+        Name.valid?(name) && (name.include?(":") || name.start_with?("_"))
       end
     end
   end

data/lib/sevgi/standard/data.rb

@@ -4,12 +4,44 @@ require_relative "data/color"
 
 module Sevgi
   module Standard
+    # Defensive copy helper for public standard-data snapshots.
+    # @api private
+    module Snapshot
+      # Returns a recursively independent copy of a value.
+      # @param value [Object] value to copy
+      # @return [Object] copied value
+      def self.copy(value)
+        case value
+        when ::Hash
+          hash(value)
+        when ::Array
+          value.map { copy(it) }
+        when ::Set
+          Set[*value.map { copy(it) }]
+        else
+          duplicate(value)
+        end
+      end
+
+      def self.hash(value) = value.to_h { |key, item| [key, copy(item)] }
+
+      def self.duplicate(value)
+        value.dup
+      rescue ::TypeError
+        value
+      end
+
+      private_class_method :duplicate, :hash
+    end
+
+    private_constant :Snapshot
+
     # Shared set operations for SVG standard data lists.
     # @api private
     module Common
       # Returns every known name in this data list.
-      # @return [Set<Symbol>]
-      def all = @all ||= Set[*data.values.flatten.uniq.sort]
+      # @return [Set<Symbol>] mutation-isolated set snapshot
+      def all = Snapshot.copy(@all ||= Set[*data.values.flatten.uniq.sort])
 
       # Checks whether a name belongs to a group.
       # @param name [Symbol] item name
@@ -25,7 +57,7 @@ module Sevgi
 
       # Returns all names or names from selected groups.
       # @param groups [Array<Symbol>] group names
-      # @return [Set<Symbol>] selected names
+      # @return [Set<Symbol>] mutation-isolated selected-name snapshot
       def set(*groups) = groups.empty? ? all : Set[*data.values_at(*groups).flatten.compact.uniq.sort]
 
       # Removes names that belong to any requested group.
@@ -74,8 +106,8 @@ module Sevgi
 
       # Returns expanded standard specification data for one element.
       # @param name [Symbol] SVG element name
-      # @return [Hash, nil] expanded specification data
-      def [](name) = expand(name)
+      # @return [Hash, nil] mutation-isolated expanded specification snapshot
+      def [](name) = Snapshot.copy(expand(name))
 
       # Reports whether a name is a data group name.
       # @param name [Symbol] element or group name
@@ -83,10 +115,16 @@ module Sevgi
       def group?(name) = /[[:upper:]]/.match?(name[0])
 
       # Checks whether an element uses one of the requested content models.
-      # @param name [Symbol] SVG element name
-      # @param models [Array<Symbol>] model names to match
+      # @param name [String, Symbol] SVG element name
+      # @param models [Array<String, Symbol>] model names to match
       # @return [Boolean]
-      def model?(name, *models) = models.any? { (self[name] || {})[:model] == it }
+      # @raise [Sevgi::ArgumentError] when any name is not a valid public name
+      def model?(name, *models)
+        name = Name.normalize!(name, context: "element")
+        models = models.map { Name.normalize!(it, context: "model") }
+
+        models.any? { (self[name] || {})[:model] == it }
+      end
 
       private
 
@@ -104,12 +142,12 @@ module Sevgi
       def expand_names(names, list)
         return unless names
 
-        names.replace(names.map { |name| group?(name) ? list[name] : name }.flatten)
+        names.replace(names.flat_map { |name| group?(name) ? list[name] : name }.uniq)
       end
 
       # For testing purposes
 
-      def charge = data.keys { expand(it) }
+      def charge = data.each_key { expand(it) }
 
       def flush = (@spec = {})
     end

data/lib/sevgi/standard/internal.rb

@@ -2,6 +2,47 @@
 
 module Sevgi
   module Standard
+    # Normalizes public SVG standard names at API boundaries.
+    # @api private
+    module Name
+      PATTERN = /\A[A-Za-z_][A-Za-z0-9_.-]*(?::[A-Za-z_][A-Za-z0-9_.-]*)?\z/
+      private_constant :PATTERN
+
+      # Reports whether a string is a supported SVG-style name token.
+      # @param name [String] candidate name
+      # @return [Boolean]
+      def self.valid?(name) = !!PATTERN.match?(name)
+
+      # Normalizes one public name to the registry symbol form.
+      # @param value [String, Symbol] public name
+      # @param context [String] name context for error messages
+      # @return [Symbol] normalized name
+      # @raise [Sevgi::ArgumentError] when value is not a String or Symbol
+      # @raise [Sevgi::ArgumentError] when value is not a valid SVG-style name
+      def self.normalize!(value, context:)
+        case value
+        when ::String, ::Symbol
+          text = value.to_s
+          ArgumentError.("Invalid SVG #{context} name: #{value.inspect}") unless valid?(text)
+
+          text.to_sym
+        else
+          ArgumentError.("SVG #{context} name must be a String or Symbol: #{value.inspect}")
+        end
+      end
+
+      # Normalizes a list of public names.
+      # @param values [Array<String, Symbol>, nil] public names
+      # @param context [String] name context for error messages
+      # @return [Array<Symbol>, nil] normalized names
+      # @raise [Sevgi::ArgumentError] when any value is not a valid public name
+      def self.list!(values, context:)
+        values&.map { normalize!(it, context:) }
+      end
+    end
+
+    private_constant :Name
+
     # Low-level import and lookup helper for static SVG standard data.
     # @api private
     module List

data/lib/sevgi/standard/model.rb

@@ -103,7 +103,7 @@ module Sevgi
             UnmetConditionError.(element, "Exactly one FilterLightSource element as first required")
           end
 
-          if !(unallowed = Element.unpick(elements[1..], :Descriptive)).empty? && !unallowed.empty?
+          unless (unallowed = Element.unpick(elements[1..], :Descriptive)).empty?
             UnallowedElementsError.(element, unallowed)
           end
         end

data/lib/sevgi/standard/version.rb

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

data/lib/sevgi/standard.rb

@@ -12,27 +12,34 @@ require_relative "standard/version"
 
 module Sevgi
   # SVG standard data and validation helpers.
+  # 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.
   module Standard
     extend self
 
     # @overload attributes(*groups)
     #   Returns SVG attributes, optionally restricted to one or more attribute groups.
     #   @param groups [Array<Symbol>] attribute group names
-    #   @return [Set<Symbol>] attribute names
+    #   @return [Set<Symbol>] mutation-isolated attribute-name snapshot
     def attributes(...) = Attribute.set(...)
 
     # Reports whether an attribute name is recognized by the SVG standard data.
-    # @param name [Object] attribute name
+    # @param name [String, Symbol] attribute name
     # @return [Boolean]
-    def attribute?(name) = name.respond_to?(:to_sym) && Attribute.all.include?(name.to_sym)
+    # @raise [Sevgi::ArgumentError] when name is not a String or Symbol
+    # @raise [Sevgi::ArgumentError] when name is not a valid SVG-style name
+    def attribute?(name) = Attribute.all.include?(Name.normalize!(name, context: "attribute"))
 
     # @overload conform(element, attributes: nil, cdata: nil, elements: nil)
     #   Validates an SVG element usage against the standard data.
-    #   @param element [Symbol] SVG element name
-    #   @param attributes [Array<Symbol>, nil] attribute names used by the element
+    #   @param element [String, Symbol] SVG element name
+    #   @param attributes [Array<String, Symbol>, nil] attribute names used by the element
     #   @param cdata [String, nil] character data content
-    #   @param elements [Array<Symbol>, nil] child element names
+    #   @param elements [Array<String, Symbol>, nil] child element names
     #   @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::ValidationError] when the usage violates the standard data
     #   @raise [Sevgi::PanicError] when the standard data refers to an invalid model
     def conform(...) = Conform.(...)
@@ -40,25 +47,32 @@ module Sevgi
     # @overload elements(*groups)
     #   Returns SVG elements, optionally restricted to one or more element groups.
     #   @param groups [Array<Symbol>] element group names
-    #   @return [Set<Symbol>] element names
+    #   @return [Set<Symbol>] mutation-isolated element-name snapshot
     def elements(...) = Element.set(...)
 
     # Reports whether an element name is recognized by the SVG standard data.
-    # @param name [Object] element name
+    # @param name [String, Symbol] element name
     # @return [Boolean]
-    def element?(name) = name.respond_to?(:to_sym) && Element.all.include?(name.to_sym)
+    # @raise [Sevgi::ArgumentError] when name is not a String or Symbol
+    # @raise [Sevgi::ArgumentError] when name is not a valid SVG-style name
+    def element?(name) = Element.all.include?(Name.normalize!(name, context: "element"))
 
     # @overload model?(name, *models)
     #   Checks whether an element uses one of the requested content models.
-    #   @param name [Symbol] SVG element name
-    #   @param models [Array<Symbol>] model names to match
+    #   @param name [String, Symbol] SVG element name
+    #   @param models [Array<String, Symbol>] model names to match
     #   @return [Boolean]
+    #   @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
     def model?(...) = Specification.model?(...)
 
     # Returns the expanded standard contract for an SVG element.
-    # @param name [Object] SVG element name
-    # @return [Hash, nil] expanded specification data, or nil when name is invalid or unknown
-    def specification(name) = name.respond_to?(:to_sym) ? Specification[name.to_sym] : nil
+    # The returned hash and nested arrays are mutation-isolated snapshots; changing them does not alter the registry.
+    # @param name [String, Symbol] SVG element name
+    # @return [Hash, nil] expanded specification snapshot, or nil when name is unknown
+    # @raise [Sevgi::ArgumentError] when name is not a String or Symbol
+    # @raise [Sevgi::ArgumentError] when name is not a valid SVG-style name
+    def specification(name) = Specification[Name.normalize!(name, context: "element")]
 
     alias [] specification
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: sevgi-standard
 version: !ruby/object:Gem::Version
-  version: 0.93.1
+  version: 0.94.0
 platform: ruby
 authors:
 - Recai Oktaş
@@ -15,20 +15,22 @@ dependencies:
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.93.1
+        version: 0.94.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - '='
       - !ruby/object:Gem::Version
-        version: 0.93.1
+        version: 0.94.0
 description: Validates elements and attributes according to the SVG specification.
 email: roktas@gmail.com
 executables: []
 extensions: []
 extra_rdoc_files: []
 files:
+- CHANGELOG.md
+- LICENSE
 - README.md
 - lib/sevgi/standard.rb
 - lib/sevgi/standard/conform.rb
@@ -56,7 +58,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.4.0.pre.preview1
+      version: 3.4.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="