suma 0.2.6 → 0.3.0

data/lib/suma/urn.rb

@@ -0,0 +1,61 @@
+# frozen_string_literal: true
+
+module Suma
+  # Value object encapsulating URN semantics for ISO 10303 datasets.
+  #
+  # Normalises a URN prefix (stripping any trailing wildcard `:*`) and
+  # provides factory methods for composing leaf URNs:
+  #
+  # - `#for_schema(id)`   → `<base>:tech:<id>`
+  # - `#for_term(id)`     → `<base>:term:<id>`
+  # - `#for_entity(ref)`  → `<base>:tech:<ref>`
+  #
+  # The wildcard form is preserved via `#wildcard` and `#aliases` so callers
+  # can populate `urnAliases` in register.yaml without re-implementing the
+  # normalisation logic.
+  class Urn
+    WILDCARD_SUFFIX = ":*"
+    TECH_COMPONENT = "tech"
+    TERM_COMPONENT = "term"
+
+    attr_reader :base
+
+    def initialize(raw)
+      @base = strip_wildcard(raw.to_s)
+    end
+
+    def to_s
+      base
+    end
+
+    def wildcard
+      "#{base}#{WILDCARD_SUFFIX}"
+    end
+
+    def aliases
+      [wildcard]
+    end
+
+    def for_schema(schema_id)
+      compose(TECH_COMPONENT, schema_id)
+    end
+
+    def for_term(concept_identifier)
+      compose(TERM_COMPONENT, concept_identifier)
+    end
+
+    def for_entity(full_ref)
+      compose(TECH_COMPONENT, full_ref)
+    end
+
+    private
+
+    def strip_wildcard(value)
+      value.sub(/#{Regexp.escape(WILDCARD_SUFFIX)}\z/o, "")
+    end
+
+    def compose(component, identifier)
+      "#{base}:#{component}:#{identifier}"
+    end
+  end
+end

data/lib/suma/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Suma
-  VERSION = "0.2.6"
+  VERSION = "0.3.0"
 end

data/lib/suma.rb

@@ -3,10 +3,38 @@
 require "expressir"
 require "lutaml/model"
 
-require_relative "suma/version"
-require_relative "suma/processor"
-
 module Suma
+  autoload :VERSION, "suma/version"
+
+  autoload :Processor,              "suma/processor"
+  autoload :CollectionConfig,       "suma/collection_config"
+  autoload :CollectionManifest,     "suma/collection_manifest"
+  autoload :EengineConverter,       "suma/eengine_converter"
+  autoload :ExpressSchema,          "suma/express_schema"
+  autoload :LinkValidator,          "suma/link_validator"
+  autoload :ManifestTraverser,      "suma/manifest_traverser"
+  autoload :RegisterManifestGenerator, "suma/register_manifest_generator"
+  autoload :SchemaCategory,         "suma/schema_category"
+  autoload :SchemaCollection,       "suma/schema_collection"
+  autoload :SchemaComparer,         "suma/schema_comparer"
+  autoload :SchemaCompiler,         "suma/schema_compiler"
+  autoload :SchemaDiscovery,        "suma/schema_discovery"
+  autoload :SchemaExporter,         "suma/schema_exporter"
+  autoload :SchemaIndex,            "suma/schema_index"
+  autoload :SchemaManifestGenerator, "suma/schema_manifest_generator"
+  autoload :SchemaNaming,           "suma/schema_naming"
+  autoload :SchemaTemplate,         "suma/schema_template"
+  autoload :SiteConfig,             "suma/site_config"
+  autoload :SvgQuality,             "suma/svg_quality"
+  autoload :TermExtractor,          "suma/term_extractor"
+  autoload :ThorExt,                "suma/thor_ext"
+  autoload :Urn,                    "suma/urn"
+  autoload :Utils,                  "suma/utils"
+
+  autoload :Cli, "suma/cli"
+  autoload :Eengine, "suma/eengine"
+  autoload :Jsdai, "suma/jsdai"
+
   class Error < StandardError; end
   class SchemaNotFoundError < Error; end
   class CompilationError < Error; end

data/suma.gemspec

@@ -34,7 +34,7 @@ Gem::Specification.new do |spec| # rubocop:disable Metrics/BlockLength
   spec.require_paths = ["lib"]
 
   spec.add_dependency "expressir", ">= 2.1.29", "~> 2.1"
-  spec.add_dependency "glossarist", "~> 2.4"
+  spec.add_dependency "glossarist", "~> 2.8", ">= 2.8.7"
   spec.add_dependency "lutaml-model", "~> 0.8.0"
   spec.add_dependency "metanorma", "~> 2.3"
   spec.add_dependency "plurimath"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: suma
 version: !ruby/object:Gem::Version
-  version: 0.2.6
+  version: 0.3.0
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-12 00:00:00.000000000 Z
+date: 2026-07-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: expressir
@@ -36,14 +36,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.4'
+        version: '2.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.8.7
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.4'
+        version: '2.8'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.8.7
 - !ruby/object:Gem::Dependency
   name: lutaml-model
   requirement: !ruby/object:Gem::Requirement
@@ -186,14 +192,17 @@ files:
 - lib/suma/cli/check_svg_quality.rb
 - lib/suma/cli/compare.rb
 - lib/suma/cli/convert_jsdai.rb
+- lib/suma/cli/core.rb
 - lib/suma/cli/export.rb
 - lib/suma/cli/extract_terms.rb
+- lib/suma/cli/generate_register.rb
 - lib/suma/cli/generate_schemas.rb
 - lib/suma/cli/reformat.rb
 - lib/suma/cli/validate.rb
 - lib/suma/cli/validate_links.rb
 - lib/suma/collection_config.rb
 - lib/suma/collection_manifest.rb
+- lib/suma/eengine.rb
 - lib/suma/eengine/errors.rb
 - lib/suma/eengine/wrapper.rb
 - lib/suma/eengine_converter.rb
@@ -203,23 +212,32 @@ files:
 - lib/suma/jsdai/figure_image.rb
 - lib/suma/jsdai/figure_xml.rb
 - lib/suma/link_validator.rb
+- lib/suma/manifest_traverser.rb
 - lib/suma/processor.rb
-- lib/suma/schema_attachment.rb
+- lib/suma/register_manifest_generator.rb
+- lib/suma/schema_category.rb
 - lib/suma/schema_collection.rb
 - lib/suma/schema_comparer.rb
-- lib/suma/schema_document.rb
+- lib/suma/schema_compiler.rb
+- lib/suma/schema_discovery.rb
 - lib/suma/schema_exporter.rb
 - lib/suma/schema_index.rb
 - lib/suma/schema_manifest_generator.rb
+- lib/suma/schema_naming.rb
+- lib/suma/schema_template.rb
+- lib/suma/schema_template/document.rb
+- lib/suma/schema_template/plain.rb
 - lib/suma/site_config.rb
 - lib/suma/svg_quality.rb
 - lib/suma/svg_quality/batch_report.rb
+- lib/suma/svg_quality/formatters.rb
 - lib/suma/svg_quality/formatters/json_formatter.rb
 - lib/suma/svg_quality/formatters/terminal_formatter.rb
 - lib/suma/svg_quality/formatters/yaml_formatter.rb
 - lib/suma/svg_quality/report.rb
 - lib/suma/term_extractor.rb
 - lib/suma/thor_ext.rb
+- lib/suma/urn.rb
 - lib/suma/utils.rb
 - lib/suma/version.rb
 - sig/suma.rbs

data/lib/suma/schema_attachment.rb

@@ -1,103 +0,0 @@
-# frozen_string_literal: true
-
-require "fileutils"
-require "expressir"
-
-module Suma
-  class SchemaAttachment
-    attr_accessor :schema, :output_path, :config, :id
-
-    def initialize(schema:, output_path:)
-      @schema = schema
-      @id = schema.id
-      @output_path = output_path
-    end
-
-    def output_extensions
-      "xml,html"
-    end
-
-    def to_adoc(path_to_schema_yaml)
-      <<~HEREDOC
-        = #{@id}
-        :lutaml-express-index: schemas; #{path_to_schema_yaml};
-        :bare: true
-        :mn-document-class: iso
-        :mn-output-extensions: #{output_extensions}
-
-        [lutaml_express_liquid,schemas,context]
-        ----
-        {% for schema in context.schemas %}
-
-        [%unnumbered]
-        == #{@id}
-
-        [source%unnumbered]
-        --
-        {{ schema.formatted }}
-        --
-        {% endfor %}
-        ----
-
-      HEREDOC
-    end
-
-    def filename_adoc(ext = "adoc")
-      File.join(@output_path, "doc_#{@schema.id}.#{ext}")
-    end
-
-    def save_adoc
-      relative_path = Pathname.new(filename_adoc).relative_path_from(Dir.pwd)
-      Utils.log "Save EXPRESS adoc: #{relative_path}"
-
-      FileUtils.mkdir_p(File.dirname(filename_adoc))
-
-      config_relative = Pathname.new(filename_config)
-        .relative_path_from(Pathname.new(File.dirname(filename_adoc)))
-
-      File.write(filename_adoc, to_adoc(config_relative))
-    end
-
-    def filename_config
-      File.join(@output_path, "schema_#{@schema.id}.yaml")
-    end
-
-    def to_config(path: nil)
-      @config = Expressir::SchemaManifest.new
-      @config.schemas << Expressir::SchemaManifestEntry.new(
-        id: @schema.id,
-        path: @schema.path,
-      )
-      path and @config.path = path
-
-      @config
-    end
-
-    def save_config
-      relative_path = Pathname.new(filename_config).relative_path_from(Dir.pwd)
-      Utils.log "Save schema config: #{relative_path}"
-
-      FileUtils.mkdir_p(File.dirname(filename_config))
-
-      to_config.save_to_path(filename_config)
-    end
-
-    # Compile Metanorma adoc per EXPRESS schema
-    def compile
-      save_config
-      save_adoc
-
-      relative_path = Pathname.new(filename_adoc).relative_path_from(Dir.pwd)
-      Utils.log "Compiling schema (id: #{id}, type: #{self.class}) => #{relative_path}"
-      Metanorma::Compile.new.compile(filename_adoc, agree_to_terms: true,
-                                                    install_fonts: false)
-      Utils.log "Compiling schema (id: #{id}, type: #{self.class}) => #{relative_path}... done!"
-
-      self
-    end
-
-    def output_xml_path
-      filename_adoc("xml")
-    end
-  end
-end

data/lib/suma/schema_document.rb

@@ -1,118 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "schema_attachment"
-
-module Suma
-  class SchemaDocument < SchemaAttachment
-    def bookmark(anchor)
-      a = anchor.gsub("}}", ' | replace: "\", "-"}}')
-      "[[#{@id}.#{a}]]"
-    end
-
-    def schema_anchors
-      <<~HEREDOC
-        // _fund_cons.liquid
-        [[#{@id}_funds]]
-
-        // _constants.liquid
-        {% if schema.constants.size > 0 %}
-        #{bookmark('constants')}
-        {% for thing in schema.constants %}
-        #{bookmark('{{thing.id}}')}
-        {% endfor %}
-        {% endif %}
-
-        // _types.liquid
-        {% if schema.types.size > 0 %}
-        #{bookmark('types')}
-        // _type.liquid
-        {% for thing in schema.types %}
-        #{bookmark('{{thing.id}}')}
-        {% if thing.items.size > 0 %}
-        // _type_items.liquid
-        #{bookmark('{{thing.id}}.items')}
-        {% for item in thing.items %}
-        #{bookmark('{{thing.id}}.items.{{item.id}}')}
-        {% endfor %}
-        {% endif %}
-        {% endfor %}
-        {% endif %}
-
-        // _entities.liquid
-        {% if schema.entities.size > 0 %}
-        #{bookmark('entities')}
-        {% for thing in schema.entities %}
-        // _entity.liquid
-        #{bookmark('{{thing.id}}')}
-        {% endfor %}
-        {% endif %}
-
-        // _subtype_constraints.liquid
-        {% if schema.subtype_constraints.size > 0 %}
-        #{bookmark('subtype_constraints')}
-        // _subtype_constraint.liquid
-        {% for thing in schema.subtype_constraints %}
-        #{bookmark('{{thing.id}}')}
-        {% endfor %}
-        {% endif %}
-
-        // _functions.liquid
-        {% if schema.functions.size > 0 %}
-        #{bookmark('functions')}
-        // _function.liquid
-        {% for thing in schema.functions %}
-        #{bookmark('{{thing.id}}')}
-        {% endfor %}
-        {% endif %}
-
-        // _procedures.liquid
-        {% if schema.procedures.size > 0 %}
-        #{bookmark('procedures')}
-        // _procedure.liquid
-        {% for thing in schema.procedures %}
-        #{bookmark('{{thing.id}}')}
-        {% endfor %}
-        {% endif %}
-
-        // _rules.liquid
-        {% if schema.rules.size > 0 %}
-        #{bookmark('rules')}
-        // _rule.liquid
-        {% for thing in schema.rules %}
-        #{bookmark('{{thing.id}}')}
-        {% endfor %}
-        {% endif %}
-      HEREDOC
-    end
-
-    def output_extensions
-      "xml"
-    end
-
-    def to_adoc(path_to_schema_yaml)
-      <<~HEREDOC
-        = #{@schema.id}
-        :lutaml-express-index: schemas; #{path_to_schema_yaml};
-        :bare: true
-        :mn-document-class: iso
-        :mn-output-extensions: xml,html
-
-        [lutaml_express_liquid,schemas,context]
-        ----
-        {% for schema in context.schemas %}
-
-        [[#{@id}]]
-        [%unnumbered,type=express]
-        == #{@id} #{schema_anchors.gsub(%r{//[^\r\n]+}, '').gsub(/[\n\r]+/, '').gsub(/^[\n\r]/, '')}
-
-        [source%unnumbered]
-        --
-        {{ schema.formatted }}
-        --
-        {% endfor %}
-        ----
-
-      HEREDOC
-    end
-  end
-end