unitsdb 2.2.2 → 2.2.4

data/lib/unitsdb/dimension.rb

@@ -1,34 +1,7 @@
 # frozen_string_literal: true
 
-# NISTd1:
-#   length:
-#     power: 1
-#     symbol: L
-#     dim_symbols:
-#     - id: "dim_L"
-#       ascii: "L"
-#       html: "𝖫"
-#       mathml: "<mi mathvariant='sans-serif'>L</mi>"
-#       latex: \ensuremath{\mathsf{L}}
-#       unicode: "𝖫"
-
-# NISTd9:
-# -dimensionless: true
-# -plane_angle:
-# -  dim_symbols:
-# -  - ascii: phi
-# -    html: "&#x1D785;"
-# -    id: dim_phi
-# -    latex: "\\ensuremath{\\mathsf{\\phi}}"
-# -    mathml: "<mi mathvariant='sans-serif'>&#x3c6;</mi>"
-# -    unicode: "\U0001D785"
-# -  power: 1
-# -  symbol: phi
-
 module Unitsdb
   class Dimension < Lutaml::Model::Serializable
-    # model Config.model_for(:dimension)
-
     attribute :identifiers, Identifier, collection: true
     attribute :dimensionless, :boolean
     attribute :length, DimensionDetails

data/lib/unitsdb/dimensions.rb

@@ -2,8 +2,6 @@
 
 module Unitsdb
   class Dimensions < Lutaml::Model::Serializable
-    # model Config.model_for(:dimensions)
-
     attribute :schema_version, :string
     attribute :version, :string
     attribute :dimensions, Dimension, collection: true

data/lib/unitsdb/opal.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+# Opal entry point for unitsdb.
+#
+# Under MRI, lib/unitsdb.rb uses autoload for lazy loading. Under Opal,
+# autoload does not lazy-execute, so a single eager-require file lists
+# every entry point the consumer (unitsml-ruby, plurimath-js) needs.
+# Consumers add `-r unitsdb/opal` to their Opal compile command.
+
+require "lutaml/model"
+require "unitsdb"
+require "unitsdb/config"
+require "unitsdb/identifier"
+require "unitsdb/localized_string"
+require "unitsdb/symbol_presentations"
+require "unitsdb/scale_properties"
+require "unitsdb/unit_reference"
+require "unitsdb/prefix_reference"
+require "unitsdb/quantity_reference"
+require "unitsdb/dimension_reference"
+require "unitsdb/unit_system_reference"
+require "unitsdb/scale_reference"
+require "unitsdb/external_reference"
+require "unitsdb/root_unit_reference"
+require "unitsdb/si_derived_base"
+require "unitsdb/dimension_details"
+require "unitsdb/dimension"
+require "unitsdb/prefix"
+require "unitsdb/unit_system"
+require "unitsdb/quantity"
+require "unitsdb/scale"
+require "unitsdb/unit"
+require "unitsdb/dimensions"
+require "unitsdb/prefixes"
+require "unitsdb/quantities"
+require "unitsdb/scales"
+require "unitsdb/unit_systems"
+require "unitsdb/units"
+require "unitsdb/database"
+require "unitsdb/qudt"
+require "unitsdb/ucum"
+require "unitsdb/errors"
+require "unitsdb/utils"

data/lib/unitsdb/prefix.rb

@@ -1,20 +1,7 @@
 # frozen_string_literal: true
 
-# ---
-# NISTp10_30:
-#   name: quetta
-#   symbol:
-#     ascii: Q
-#     html: Q
-#     latex: Q
-#     unicode: Q
-#   base: 10
-#   power: 30
-
 module Unitsdb
   class Prefix < Lutaml::Model::Serializable
-    # model Config.model_for(:prefix)
-
     attribute :identifiers, Identifier, collection: true
     attribute :names, LocalizedString, collection: true
     attribute :short, :string

data/lib/unitsdb/prefixes.rb

@@ -13,8 +13,6 @@
 
 module Unitsdb
   class Prefixes < Lutaml::Model::Serializable
-    # model Config.model_for(:prefixes)
-
     attribute :schema_version, :string
     attribute :version, :string
     attribute :prefixes, Prefix, collection: true

data/lib/unitsdb/quantities.rb

@@ -2,7 +2,6 @@
 
 module Unitsdb
   class Quantities < Lutaml::Model::Serializable
-    # model Config.model_for(:quantities)
     attribute :schema_version, :string
     attribute :version, :string
     attribute :quantities, Quantity, collection: true

data/lib/unitsdb/quantity.rb

@@ -2,8 +2,6 @@
 
 module Unitsdb
   class Quantity < Lutaml::Model::Serializable
-    # model Config.model_for(:quantity)
-
     attribute :identifiers, Identifier, collection: true
     attribute :quantity_type, :string
     attribute :names, LocalizedString, collection: true

data/lib/unitsdb/quantity_reference.rb

@@ -2,8 +2,6 @@
 
 module Unitsdb
   class QuantityReference < Identifier
-    # model Config.model_for(:quantity_reference)
-
     attribute :id, :string
     attribute :type, :string
   end

data/lib/unitsdb/root_unit_reference.rb

@@ -2,8 +2,6 @@
 
 module Unitsdb
   class RootUnitReference < Lutaml::Model::Serializable
-    # model Config.model_for(:root_unit)
-
     attribute :power, :integer
     attribute :unit_reference, UnitReference
     attribute :prefix_reference, PrefixReference

data/lib/unitsdb/scale.rb

@@ -2,8 +2,6 @@
 
 module Unitsdb
   class Scale < Lutaml::Model::Serializable
-    # model Config.model_for(:quantity)
-
     attribute :identifiers, Identifier, collection: true
     attribute :names, LocalizedString, collection: true
     attribute :description, LocalizedString, collection: true

data/lib/unitsdb/scale_properties.rb

@@ -2,7 +2,6 @@
 
 module Unitsdb
   class ScaleProperties < Lutaml::Model::Serializable
-    # model Config.model_for(:quantity)
     attribute :continuous, :boolean
     attribute :ordered, :boolean
     attribute :logarithmic, :boolean

data/lib/unitsdb/scales.rb

@@ -2,7 +2,6 @@
 
 module Unitsdb
   class Scales < Lutaml::Model::Serializable
-    # model Config.model_for(:Scale)
     attribute :schema_version, :string
     attribute :version, :string
     attribute :scales, Scale, collection: true

data/lib/unitsdb/si_derived_base.rb

@@ -12,7 +12,6 @@
 
 module Unitsdb
   class SiDerivedBase < RootUnitReference
-    # model Config.model_for(:si_derived_base)
   end
 
   Config.register_model(SiDerivedBase, id: :si_derived_base)

data/lib/unitsdb/symbol_presentations.rb

@@ -2,8 +2,6 @@
 
 module Unitsdb
   class SymbolPresentations < Lutaml::Model::Serializable
-    # model Config.model_for(:symbol_presentations)
-
     attribute :id, :string
     attribute :ascii, :string
     attribute :html, :string

data/lib/unitsdb/unit.rb

@@ -1,41 +1,7 @@
 # frozen_string_literal: true
 
-# "NISTu10":
-#   dimension_url: "#NISTd9"
-#   short: steradian
-#   root: true
-#   unit_system:
-#     type: "SI_derived_special"
-#     name: "SI"
-#   names:
-#     - "steradian"
-#   unit_symbols:
-#     - id: "sr"
-#       ascii: "sr"
-#       html: "sr"
-#       mathml: "<mi mathvariant='normal'>sr</mi>"
-#       latex: \ensuremath{\mathrm{sr}}
-#       unicode: "sr"
-#   root_units:
-#     enumerated_root_units:
-#       - unit: "steradian"
-#         power_denominator: 1
-#         power: 1
-#   quantity_reference:
-#     - name: "solid angle"
-#       url: "#NISTq11"
-#   si_derived_bases:
-#     - id: NISTu1
-#       prefix:
-#       power: 1
-#     - id: NISTu1
-#       prefix:
-#       power: -1
-
 module Unitsdb
   class Unit < Lutaml::Model::Serializable
-    # model Config.model_for(:unit)
-
     attribute :identifiers, Identifier, collection: true
     attribute :short, :string
     attribute :root, :boolean

data/lib/unitsdb/unit_system.rb

@@ -2,8 +2,6 @@
 
 module Unitsdb
   class UnitSystem < Lutaml::Model::Serializable
-    # model Config.model_for(:unit_system)
-
     attribute :identifiers, Identifier, collection: true
     attribute :names, LocalizedString, collection: true
     attribute :short, :string

data/lib/unitsdb/unit_systems.rb

@@ -2,8 +2,6 @@
 
 module Unitsdb
   class UnitSystems < Lutaml::Model::Serializable
-    # model Config.model_for(:unit_systems)
-
     attribute :schema_version, :string
     attribute :version, :string
     attribute :unit_systems, UnitSystem, collection: true

data/lib/unitsdb/units.rb

@@ -2,8 +2,6 @@
 
 module Unitsdb
   class Units < Lutaml::Model::Serializable
-    # model Config.model_for(:units)
-
     attribute :schema_version, :string
     attribute :version, :string
     attribute :units, Unit, collection: true

data/lib/unitsdb/version.rb

@@ -1,7 +1,7 @@
 # frozen_string_literal: true
 
 module Unitsdb
-  VERSION = "2.2.2"
+  VERSION = "2.2.4"
 
   # The version of the bundled UnitsDB data (from the data/ submodule).
   # This version corresponds to a tag/commit in https://github.com/unitsml/unitsdb.

data/lib/unitsdb.rb

@@ -1,46 +1,124 @@
 # frozen_string_literal: true
 
 require "lutaml/model"
-require "unitsdb/config"
-require "unitsdb/identifier"
-require "unitsdb/localized_string"
-require "unitsdb/symbol_presentations"
-require "unitsdb/scale_properties"
-require "unitsdb/unit_reference"
-require "unitsdb/prefix_reference"
-require "unitsdb/quantity_reference"
-require "unitsdb/dimension_reference"
-require "unitsdb/unit_system_reference"
-require "unitsdb/scale_reference"
-require "unitsdb/external_reference"
-require "unitsdb/root_unit_reference"
-require "unitsdb/si_derived_base"
-require "unitsdb/dimension_details"
-require "unitsdb/dimension"
-require "unitsdb/prefix"
-require "unitsdb/unit_system"
-require "unitsdb/quantity"
-require "unitsdb/scale"
-require "unitsdb/unit"
-require "unitsdb/dimensions"
-require "unitsdb/prefixes"
-require "unitsdb/quantities"
-require "unitsdb/scales"
-require "unitsdb/unit_systems"
-require "unitsdb/units"
-require "unitsdb/database"
-require "unitsdb/qudt"
-require "unitsdb/ucum"
 
 module Unitsdb
-  # Core models are eagerly loaded so type registrations are complete before
-  # any context or database loading happens.
+  # All model constants are autoloaded from their respective files.
+  # Config.build_registry triggers `eager_load_models!` so the type
+  # registry is complete before iteration — otherwise autoload would
+  # leave unreferenced models (Scale, Qudt*, Ucum*) unregistered.
+
+  autoload :Config, "unitsdb/config"
+  autoload :Errors, "unitsdb/errors"
+  autoload :Utils, "unitsdb/utils"
+  autoload :Database, "unitsdb/database"
+
+  # Leaf models
+  autoload :Identifier, "unitsdb/identifier"
+  autoload :LocalizedString, "unitsdb/localized_string"
+  autoload :SymbolPresentations, "unitsdb/symbol_presentations"
+  autoload :ScaleProperties, "unitsdb/scale_properties"
+
+  # Reference models
+  autoload :UnitReference, "unitsdb/unit_reference"
+  autoload :PrefixReference, "unitsdb/prefix_reference"
+  autoload :QuantityReference, "unitsdb/quantity_reference"
+  autoload :DimensionReference, "unitsdb/dimension_reference"
+  autoload :UnitSystemReference, "unitsdb/unit_system_reference"
+  autoload :ScaleReference, "unitsdb/scale_reference"
+  autoload :ExternalReference, "unitsdb/external_reference"
+  autoload :RootUnitReference, "unitsdb/root_unit_reference"
+  autoload :SiDerivedBase, "unitsdb/si_derived_base"
+  autoload :DimensionDetails, "unitsdb/dimension_details"
+
+  # Entity models
+  autoload :Dimension, "unitsdb/dimension"
+  autoload :Prefix, "unitsdb/prefix"
+  autoload :UnitSystem, "unitsdb/unit_system"
+  autoload :Quantity, "unitsdb/quantity"
+  autoload :Scale, "unitsdb/scale"
+  autoload :Unit, "unitsdb/unit"
+
+  # Collection container models
+  autoload :Dimensions, "unitsdb/dimensions"
+  autoload :Prefixes, "unitsdb/prefixes"
+  autoload :Quantities, "unitsdb/quantities"
+  autoload :Scales, "unitsdb/scales"
+  autoload :UnitSystems, "unitsdb/unit_systems"
+  autoload :Units, "unitsdb/units"
+
+  # QUDT vocabulary models — all defined in unitsdb/qudt.rb
+  autoload :QudtUnit, "unitsdb/qudt"
+  autoload :QudtQuantityKind, "unitsdb/qudt"
+  autoload :QudtDimensionVector, "unitsdb/qudt"
+  autoload :QudtSystemOfUnits, "unitsdb/qudt"
+  autoload :QudtPrefix, "unitsdb/qudt"
+  autoload :QudtVocabularies, "unitsdb/qudt"
+
+  # UCUM XML models — all defined in unitsdb/ucum.rb
+  autoload :UcumBaseUnit, "unitsdb/ucum"
+  autoload :UcumPrefixValue, "unitsdb/ucum"
+  autoload :UcumPrefix, "unitsdb/ucum"
+  autoload :UcumUnitValueFunction, "unitsdb/ucum"
+  autoload :UcumUnitValue, "unitsdb/ucum"
+  autoload :UcumUnit, "unitsdb/ucum"
+  autoload :UcumNamespace, "unitsdb/ucum"
+  autoload :UcumFile, "unitsdb/ucum"
+
+  # CLI and Commands pull in Thor, which doesn't run under Opal.
   unless RUBY_ENGINE == "opal"
     autoload :Cli, "unitsdb/cli"
     autoload :Commands, "unitsdb/commands"
   end
-  autoload :Errors, "unitsdb/errors"
-  autoload :Utils, "unitsdb/utils"
+
+  # Constants eagerly loaded so Lutaml::Model type registrations are
+  # complete before Config.build_registry iterates them. Listed
+  # explicitly so unreferenced models (Scale, Qudt*, Ucum*) still
+  # register themselves via their file-bottom `Config.register_model`
+  # calls.
+  MODELS = %i[
+    Identifier
+    LocalizedString
+    SymbolPresentations
+    ScaleProperties
+    UnitReference
+    PrefixReference
+    QuantityReference
+    DimensionReference
+    UnitSystemReference
+    ScaleReference
+    ExternalReference
+    RootUnitReference
+    SiDerivedBase
+    DimensionDetails
+    Dimension
+    Prefix
+    UnitSystem
+    Quantity
+    Scale
+    Unit
+    Dimensions
+    Prefixes
+    Quantities
+    Scales
+    UnitSystems
+    Units
+    Database
+    QudtUnit
+    QudtQuantityKind
+    QudtDimensionVector
+    QudtSystemOfUnits
+    QudtPrefix
+    QudtVocabularies
+    UcumBaseUnit
+    UcumPrefixValue
+    UcumPrefix
+    UcumUnitValueFunction
+    UcumUnitValue
+    UcumUnit
+    UcumNamespace
+    UcumFile
+  ].freeze
 
   class << self
     # Returns the path to the bundled data directory containing YAML files
@@ -51,13 +129,42 @@ module Unitsdb
     # Returns a pre-loaded Database instance from the bundled data
     def database(context: Config.context_id)
       context_id = context.to_sym
-      Config.context(context_id) if context_id == Config.context_id && Config.find_context(context_id).nil?
+      Config.ensure_default_context! if context_id == Config.context_id
       klass = Config.resolve_type(:database, context: context_id)
       databases[context_id] ||= klass.from_db(data_dir, context: context_id)
     end
 
+    # Drop the memoized Database instances so the next `database` call
+    # reloads from disk. Specs use this between examples.
+    def reset_database_cache!
+      @databases = nil
+    end
+
+    # Force every autoloaded model to load AND register itself with
+    # Config. The per-file `Config.register_model(Class, id: :foo)`
+    # calls at file-bottom run the first time a model loads, but
+    # `Config.capture_state` / `restore_state` can wipe those entries
+    # between tests. Re-registering here makes the registry
+    # self-healing across snapshot/restore cycles.
+    def eager_load_models!
+      MODELS.each do |sym|
+        klass = const_get(sym)
+        next unless klass.is_a?(Class) && klass < ::Lutaml::Model::Serializable
+
+        Config.register_model(klass, id: model_id_for(klass))
+      end
+    end
+
     private
 
+    def model_id_for(klass)
+      klass.name.split("::").last
+        .gsub(/([A-Z]+)([A-Z][a-z])/, '\1_\2')
+        .gsub(/([a-z\d])([A-Z])/, '\1_\2')
+        .downcase
+        .to_sym
+    end
+
     def databases
       @databases ||= {}
     end

data/unitsdb.gemspec

@@ -34,6 +34,7 @@ Gem::Specification.new do |spec|
   spec.require_paths = ["lib"]
 
   spec.add_dependency "fuzzy_match"
+  spec.add_dependency "logger"
   spec.add_dependency "lutaml-model", "~> 0.8.0"
   spec.add_dependency "rdf", "~> 3.1"
   spec.add_dependency "rdf-turtle", "~> 3.1"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: unitsdb
 version: !ruby/object:Gem::Version
-  version: 2.2.2
+  version: 2.2.4
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-04-22 00:00:00.000000000 Z
+date: 2026-06-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: fuzzy_match
@@ -24,6 +24,20 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
+- !ruby/object:Gem::Dependency
+  name: logger
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: lutaml-model
   requirement: !ruby/object:Gem::Requirement
@@ -118,6 +132,7 @@ extra_rdoc_files: []
 files:
 - ".github/workflows/dependent-repos.json"
 - ".github/workflows/depenedent-gems.yml"
+- ".github/workflows/opal.yml"
 - ".github/workflows/rake.yml"
 - ".github/workflows/release.yml"
 - ".gitignore"
@@ -156,6 +171,7 @@ files:
 - lib/unitsdb/commands/check_si/si_matcher.rb
 - lib/unitsdb/commands/check_si/si_ttl_parser.rb
 - lib/unitsdb/commands/check_si/si_updater.rb
+- lib/unitsdb/commands/entity_presenter.rb
 - lib/unitsdb/commands/get.rb
 - lib/unitsdb/commands/normalize.rb
 - lib/unitsdb/commands/qudt.rb
@@ -167,6 +183,7 @@ files:
 - lib/unitsdb/commands/qudt/updater.rb
 - lib/unitsdb/commands/release.rb
 - lib/unitsdb/commands/search.rb
+- lib/unitsdb/commands/thor.rb
 - lib/unitsdb/commands/ucum.rb
 - lib/unitsdb/commands/ucum/check.rb
 - lib/unitsdb/commands/ucum/formatter.rb
@@ -182,6 +199,9 @@ files:
 - lib/unitsdb/commands/validate/ucum_references.rb
 - lib/unitsdb/config.rb
 - lib/unitsdb/database.rb
+- lib/unitsdb/database/loader.rb
+- lib/unitsdb/database/reference_validator.rb
+- lib/unitsdb/database/uniqueness_validator.rb
 - lib/unitsdb/dimension.rb
 - lib/unitsdb/dimension_details.rb
 - lib/unitsdb/dimension_reference.rb
@@ -190,6 +210,7 @@ files:
 - lib/unitsdb/external_reference.rb
 - lib/unitsdb/identifier.rb
 - lib/unitsdb/localized_string.rb
+- lib/unitsdb/opal.rb
 - lib/unitsdb/prefix.rb
 - lib/unitsdb/prefix_reference.rb
 - lib/unitsdb/prefixes.rb