glossarist 2.8.10 → 2.8.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 3d52bb386f776f12beb9671c25c5f1ce8330ff8349df68d734c80fa3937cec6f
-  data.tar.gz: 43cab5da334046a266967ba590d9791ee56f1fe283110075c880ddb8f5ec8344
+  metadata.gz: 284d64ec4a9bac75c0639dd3254a715e881d46949240f430db9d6322cec09379
+  data.tar.gz: a349a57dba2f2e5b79c93561dcfa2fd54ee1627326d66b3cf2d6b66cbcca2f3c
 SHA512:
-  metadata.gz: 6364fe8da9e37fdf669b2064fa244ad7f97f745cc4059243e4d1a337e710aff0ad1f1a6034573504b6106708cc9ed153e8fd9a6f1396d504c5d8b45e917c6e15
-  data.tar.gz: 71ac705f2149e4995b1476a2802a3f5361e8d8733435d3fda15b7f2033d4ac62c72183b11770032bda22c6e6de8fadc8798f80c6f9af636b2e06828571d16d30
+  metadata.gz: 270a84779887cf795087a0fb56f923240b26c028bef18c6b436b5129cfcc0985a020e9ab5b2ce2b2b6e5f472f75de7c79546d56fe0a94465f068d3f5ee28617a
+  data.tar.gz: 1411213954c8fbbdb95bc9e5c4bc8455d55edf4df1944714dcd8a0ffac4733d64ed16bd32ae6c259691739dda04418fe9bcf91ba2af04451505a0b0d61168c55

data/config.yml

@@ -39,10 +39,17 @@ designation:
 
 related_concept:
   type:
-    # Lifecycle (ISO 10241-1)
+    # Lifecycle (ISO 10241-1 / ISO 19135)
     - deprecates
+    - deprecated_by
     - supersedes
     - superseded_by
+    - replaces
+    - replaced_by
+    - invalidates
+    - invalidated_by
+    - retires
+    - retired_by
     # Hierarchical (ISO 10241-1 / ISO 25964)
     - narrower
     - broader
@@ -52,9 +59,13 @@ related_concept:
     # Hierarchical sub-types — ISO 25964 partitive (BTP/NTP)
     - broader_partitive
     - narrower_partitive
+    - has_part
+    - is_part_of
     # Hierarchical sub-types — ISO 25964 instantial (BTI/NTI)
     - broader_instantial
     - narrower_instantial
+    - instance_of
+    - has_instance
     # Equivalence (ISO 10241-1 / ISO 25964 exactMatch / SKOS)
     - equivalent
     - exact_match
@@ -69,17 +80,30 @@ related_concept:
     - contrast
     # Associative (ISO 10241-1 / ISO 25964 RT / TBX crossReference)
     - see
+    - references
     # Associative sub-types (ISO 25964 / TBX)
     - related_concept
     - related_concept_broader
     - related_concept_narrower
     # Associative — spatial/temporal (ISO 25964 / TBX)
-    - sequentially_related_concept
-    - spatially_related_concept
-    - temporally_related_concept
+    - sequentially_related
+    - spatially_related
+    - temporally_related
     # Lexical (ISO 12620 / TBX)
     - homograph
     - false_friend
+    # Register management (ISO 19135)
+    - has_concept
+    - is_concept_of
+    - has_definition
+    - definition_of
+    - inherits
+    - inherited_by
+    # Versioning / definitional (ISO 19135)
+    - has_version
+    - version_of
+    - current_version
+    - current_version_of
 
 iso12620:
   term_type:

data/lib/glossarist/concept_data.rb

@@ -86,7 +86,7 @@ module Glossarist
     def all_sources
       list = sources.to_a
       self.class.detailed_definition_fields.each do |field|
-        send(field).each { |d| list.concat(d.sources.to_a) }
+        public_send(field).each { |d| list.concat(d.sources.to_a) }
       end
       Array(terms).each { |t| list.concat(Array(t.sources)) }
       list
@@ -95,7 +95,7 @@ module Glossarist
     def text_content
       texts = []
       self.class.detailed_definition_fields.each do |field|
-        send(field).each { |d| texts << d.content if d.content }
+        public_send(field).each { |d| texts << d.content if d.content }
       end
       texts
     end

data/lib/glossarist/concept_reference.rb

@@ -17,7 +17,7 @@ module Glossarist
 
     key_value do
       map :term, to: :term
-      map :concept_id, to: :concept_id
+      map %i[concept_id id], to: :concept_id
       map :source, to: :source
       map :ref_type, to: :ref_type
       map :urn, to: :urn

data/lib/glossarist/concept_set.rb

@@ -67,7 +67,11 @@ module Glossarist
 
     def normalize_definition(definition)
       definition.gsub(/{{([^}]*)}}/) do |_match|
-        "\\textbf{\\gls{#{Regexp.last_match[1].tr('_', '-')}}}"
+        inner = Regexp.last_match[1]
+        # Mention syntax: {{identifier}} or {{identifier, render term}}
+        # Use the identifier (first part before comma) as the gloss label.
+        label = inner.split(",", 2).first.strip.tr("_", "-")
+        "\\textbf{\\gls{#{label}}}"
       end
     end
 

data/lib/glossarist/managed_concept.rb

@@ -13,19 +13,28 @@ module Glossarist
     attribute :status, :string,
               values: Glossarist::GlossaryDefinition::CONCEPT_STATUSES
 
-    attribute :identifier, :string
-    alias :id :identifier
-    alias :id= :identifier=
-
     attribute :uuid, :string
 
     attribute :version, :string
     attribute :schema_version, :string
 
+    # identifier and id are aliases for uuid — the concept's canonical
+    # identity. There is one source of truth: uuid, serialized to the
+    # YAML "id" key. Having separate identifier/uuid attributes that both
+    # map to the same key caused dual-mapping fragility.
+    def identifier
+      uuid
+    end
+
+    def identifier=(value)
+      self.uuid = value
+    end
+
+    alias :id :identifier
+    alias :id= :identifier=
+
     key_value do
       map :data, to: :data
-      map :identifier,
-          with: { to: :identifier_to_yaml, from: :identifier_from_yaml }
       map :related, to: :related
       map :dates, to: :dates
       map :sources, to: :sources
@@ -74,15 +83,6 @@ module Glossarist
       )
     end
 
-    def identifier_to_yaml(model, doc)
-      value = model.identifier || model.id
-      doc["id"] = value if value && !doc["id"]
-    end
-
-    def identifier_from_yaml(model, value)
-      model.identifier = value || model.identifier
-    end
-
     def localized_concepts=(localized_concepts_collection) # rubocop:disable Metrics/AbcSize
       return unless localized_concepts_collection
 

data/lib/glossarist/rdf/relationship_predicates.rb

@@ -27,16 +27,17 @@ module Glossarist
         related_match: [Namespaces::SkosNamespace, :relatedMatch],
         see: [Namespaces::SkosNamespace, :related],
         deprecates: [Namespaces::GlossaristNamespace, :deprecates],
+        deprecated_by: [Namespaces::GlossaristNamespace, :deprecatedBy],
         supersedes: [Namespaces::GlossaristNamespace, :supersedes],
         superseded_by: [Namespaces::GlossaristNamespace, :supersededBy],
         compare: [Namespaces::GlossaristNamespace, :compares],
         contrast: [Namespaces::GlossaristNamespace, :contrasts],
-        sequentially_related_concept: [Namespaces::GlossaristNamespace,
-                                       :sequentiallyRelated],
-        spatially_related_concept: [Namespaces::GlossaristNamespace,
-                                    :spatiallyRelated],
-        temporally_related_concept: [Namespaces::GlossaristNamespace,
-                                     :temporallyRelated],
+        sequentially_related: [Namespaces::GlossaristNamespace,
+                               :sequentiallyRelated],
+        spatially_related: [Namespaces::GlossaristNamespace,
+                            :spatiallyRelated],
+        temporally_related: [Namespaces::GlossaristNamespace,
+                             :temporallyRelated],
         related_concept_broader: [Namespaces::GlossaristNamespace,
                                   :relatedConceptBroader],
         related_concept_narrower: [Namespaces::GlossaristNamespace,

data/lib/glossarist/sts/term_extractor.rb

@@ -253,9 +253,10 @@ module Glossarist
       end
 
       def extract_ref_text(ref)
-        if ref.respond_to?(:content) && ref.content.is_a?(Array)
+        case ref
+        when ::Sts::IsoSts::StdRef
           normalize_whitespace(ref.content.join.to_s)
-        elsif ref.respond_to?(:value)
+        when ::Sts::NisoSts::StandardRef
           normalize_whitespace(ref.value.to_s)
         else
           ""

data/lib/glossarist/transforms/concept_to_gloss_transform.rb

@@ -122,7 +122,7 @@ module Glossarist
 
         dd_attrs = if data
                      data.class.detailed_definition_fields.to_h do |field|
-                       [field, build_gloss_definitions(data.send(field))]
+                       [field, build_gloss_definitions(data.public_send(field))]
                      end
                    else
                      { definition: [], notes: [], examples: [] }

data/lib/glossarist/v2/managed_concept.rb

@@ -9,15 +9,13 @@ module Glossarist
 
       key_value do
         map :data, to: :data
-        map :id, with: { to: :identifier_to_yaml, from: :identifier_from_yaml }
-        map :identifier,
-            with: { to: :identifier_to_yaml, from: :identifier_from_yaml }
         map :related, to: :related
         map :dates, to: :dates
         map %i[date_accepted dateAccepted],
             with: { from: :date_accepted_from_yaml, to: :date_accepted_to_yaml }
         map :status, to: :status
-        map :uuid, to: :uuid, with: { from: :uuid_from_yaml, to: :uuid_to_yaml }
+        map %i[id uuid], to: :uuid,
+                         with: { from: :uuid_from_yaml, to: :uuid_to_yaml }
         map :sources, to: :sources
       end
     end

data/lib/glossarist/v3/managed_concept.rb

@@ -9,15 +9,13 @@ module Glossarist
 
       key_value do
         map :data, to: :data
-        map :id, with: { to: :identifier_to_yaml, from: :identifier_from_yaml }
-        map :identifier,
-            with: { to: :identifier_to_yaml, from: :identifier_from_yaml }
         map :related, to: :related
         map :dates, to: :dates
         map %i[date_accepted dateAccepted],
             with: { from: :date_accepted_from_yaml, to: :date_accepted_to_yaml }
         map :status, to: :status
-        map :uuid, to: :uuid, with: { from: :uuid_from_yaml, to: :uuid_to_yaml }
+        map %i[id uuid], to: :uuid,
+                         with: { from: :uuid_from_yaml, to: :uuid_to_yaml }
         map :schema_version, to: :schema_version
         map :sources, to: :sources
       end

data/lib/glossarist/validation/rules/asciidoc_xref_rule.rb

@@ -14,30 +14,20 @@ module Glossarist
         end
 
         def check(context)
-          concept = context.concept
           fname = context.file_name
-          extractor = ReferenceExtractor.new
           issues = []
 
-          concept.localizations.each do |l10n|
-            lang = l10n.language_code || "unknown"
-
-            l10n.text_content.each do |text|
-              next unless text
-
-              extractor.extract_from_text(text).each do |ref|
-                next unless ref.is_a?(BibliographicReference)
-                next if context.bibliography_index.resolve?(ref.anchor)
-
-                issues << issue(
-                  "unresolved bibliography reference <<#{ref.anchor}>>",
-                  code: code, severity: severity,
-                  location: "#{fname}/#{lang}",
-                  suggestion: "add '#{ref.anchor}' as a source, " \
-                              "or verify it exists in bibliography.yaml"
-                )
-              end
-            end
+          context.references.each do |ref|
+            next unless ref.is_a?(BibliographicReference)
+            next if context.bibliography_index.resolve?(ref.anchor)
+
+            issues << issue(
+              "unresolved bibliography reference <<#{ref.anchor}>>",
+              code: code, severity: severity,
+              location: fname,
+              suggestion: "add '#{ref.anchor}' as a source, " \
+                          "or verify it exists in bibliography.yaml"
+            )
           end
 
           issues

data/lib/glossarist/validation/rules/cite_ref_integrity_rule.rb

@@ -19,7 +19,7 @@ module Glossarist
           issues = []
 
           check_unique_source_ids(concept, fname, issues)
-          check_unresolved_mentions(concept, fname, issues)
+          check_unresolved_mentions(context, concept, fname, issues)
 
           issues
         end
@@ -46,8 +46,8 @@ module Glossarist
           end
         end
 
-        def check_unresolved_mentions(concept, fname, issues)
-          keys = cite_mention_keys(concept)
+        def check_unresolved_mentions(context, concept, fname, issues)
+          keys = cite_mention_keys(context)
           return if keys.empty?
 
           known_ids = concept.all_sources.filter_map(&:id).to_set
@@ -63,9 +63,8 @@ module Glossarist
           end
         end
 
-        def cite_mention_keys(concept)
-          extractor = ReferenceExtractor.new
-          extractor.extract_from_managed_concept(concept)
+        def cite_mention_keys(context)
+          context.references
             .select(&:cite?)
             .filter_map(&:concept_id)
         end

data/lib/glossarist/validation/rules/concept_context.rb

@@ -3,6 +3,12 @@
 module Glossarist
   module Validation
     module Rules
+      # Shared context for concept-scoped validation rules.
+      #
+      # Provides lazy-memoized access to extracted references so that multiple
+      # rules examining the same concept share one extraction pass (DRY,
+      # single source of truth). Rules ask the context for references rather
+      # than instantiating their own ReferenceExtractor.
       class ConceptContext
         attr_reader :concept, :file_name, :collection_context
 
@@ -16,6 +22,24 @@ module Glossarist
           @concept.data&.id&.to_s
         end
 
+        # All references extracted from the concept's text fields
+        # (definitions, notes, examples) via {{...}} mentions, <<xrefs>>,
+        # and image::...[] references. Includes ConceptReference,
+        # BibliographicReference, and AssetReference objects.
+        # Memoized — extracted once per concept, shared across all rules.
+        def references
+          @references ||= ReferenceExtractor.new
+            .extract_from_managed_concept(@concept)
+        end
+
+        # All asset references (NonVerbRep, GraphicalSymbol) extracted
+        # from the concept's model attributes.
+        # Memoized — extracted once per concept, shared across all rules.
+        def asset_references
+          @asset_references ||= ReferenceExtractor.new
+            .extract_asset_refs_from_concept(@concept)
+        end
+
         def bibliography_index
           @collection_context.bibliography_index
         end

data/lib/glossarist/validation/rules/concept_mention_rule.rb

@@ -14,12 +14,10 @@ module Glossarist
         end
 
         def check(context)
-          concept = context.concept
           fname = context.file_name
-          extractor = ReferenceExtractor.new
           issues = []
 
-          refs = extractor.extract_from_managed_concept(concept)
+          refs = context.references
             .select { |r| r.is_a?(ConceptReference) && r.local? }
 
           refs.each do |ref|

data/lib/glossarist/validation/rules/image_reference_rule.rb

@@ -14,33 +14,22 @@ module Glossarist
         end
 
         def check(context)
-          concept = context.concept
           fname = context.file_name
-          extractor = ReferenceExtractor.new
           issues = []
 
-          concept.localizations.each do |l10n|
-            lang = l10n.language_code || "unknown"
-
-            l10n.text_content.each do |text|
-              next unless text
-
-              extractor.extract_from_text(text).each do |ref|
-                next unless ref.is_a?(AssetReference)
-                next if context.asset_index.resolve?(ref.path)
+          context.references.each do |ref|
+            next unless ref.is_a?(AssetReference)
+            next if context.asset_index.resolve?(ref.path)
 
-                issues << issue(
-                  "unresolved image reference #{ref.path}",
-                  code: "GLS-103", severity: severity,
-                  location: "#{fname}/#{lang}",
-                  suggestion: "add '#{ref.path}' to the dataset's images/ directory"
-                )
-              end
-            end
+            issues << issue(
+              "unresolved image reference #{ref.path}",
+              code: "GLS-103", severity: severity,
+              location: fname,
+              suggestion: "add '#{ref.path}' to the dataset's images/ directory"
+            )
           end
 
-          asset_refs = extractor.extract_asset_refs_from_concept(concept)
-          asset_refs.each do |ref|
+          context.asset_references.each do |ref|
             next if context.asset_index.resolve?(ref.path)
 
             issues << issue(

data/lib/glossarist/version.rb

@@ -4,5 +4,5 @@
 #
 
 module Glossarist
-  VERSION = "2.8.10"
+  VERSION = "2.8.12"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: glossarist
 version: !ruby/object:Gem::Version
-  version: 2.8.10
+  version: 2.8.12
 platform: ruby
 authors:
 - Ribose
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-06-13 00:00:00.000000000 Z
+date: 2026-06-15 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model