glossarist 2.8.2 → 2.8.5

data/lib/glossarist/rdf/gloss_designation.rb

@@ -5,20 +5,30 @@ require "lutaml/model"
 module Glossarist
   module Rdf
     COMMON_DESIGNATION_PREDICATES = lambda { |dsl|
-      dsl.predicate :literalForm, namespace: Namespaces::SkosxlNamespace, to: :designation
-      dsl.predicate :normativeStatus, namespace: Namespaces::GlossaristNamespace, to: :normative_status, uri_reference: true
-      dsl.predicate :hasTermType, namespace: Namespaces::GlossaristNamespace, to: :term_type, uri_reference: true
-      dsl.predicate :isInternational, namespace: Namespaces::GlossaristNamespace, to: :international
-      dsl.predicate :isAbsent, namespace: Namespaces::GlossaristNamespace, to: :absent
-      dsl.predicate :geographicalArea, namespace: Namespaces::GlossaristNamespace, to: :language
-      dsl.predicate :language, namespace: Namespaces::DctermsNamespace, to: :lang_code
-      dsl.predicate :script, namespace: Namespaces::GlossaristNamespace, to: :script
-      dsl.predicate :conversionSystem, namespace: Namespaces::GlossaristNamespace, to: :system
+      dsl.predicate :literalForm, namespace: Namespaces::SkosxlNamespace,
+                                  to: :designation
+      dsl.predicate :normativeStatus,
+                    namespace: Namespaces::GlossaristNamespace, to: :normative_status, uri_reference: true
+      dsl.predicate :hasTermType, namespace: Namespaces::GlossaristNamespace,
+                                  to: :term_type, uri_reference: true
+      dsl.predicate :isInternational,
+                    namespace: Namespaces::GlossaristNamespace, to: :international
+      dsl.predicate :isAbsent, namespace: Namespaces::GlossaristNamespace,
+                               to: :absent
+      dsl.predicate :geographicalArea,
+                    namespace: Namespaces::GlossaristNamespace, to: :language
+      dsl.predicate :language, namespace: Namespaces::DctermsNamespace,
+                               to: :lang_code
+      dsl.predicate :script, namespace: Namespaces::GlossaristNamespace,
+                             to: :script
+      dsl.predicate :conversionSystem,
+                    namespace: Namespaces::GlossaristNamespace, to: :system
       dsl.members :pronunciations, link: "gloss:hasPronunciation"
       dsl.members :sources
 
       RelationshipPredicates::DESIGNATION_REL_PREDICATES.each do |type, (ns, name)|
-        dsl.predicate name, namespace: ns, to: :"#{type}_targets", uri_reference: true
+        dsl.predicate name, namespace: ns, to: :"#{type}_targets",
+                            uri_reference: true
       end
     }.freeze
 
@@ -53,7 +63,9 @@ module Glossarist
       rdf do
         namespace(*DESIGNATION_NAMESPACES)
 
-        subject { |d| "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}" }
+        subject do |d|
+          "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}"
+        end
 
         types "gloss:Designation", "skosxl:Label"
 
@@ -70,14 +82,19 @@ module Glossarist
       rdf do
         namespace(*DESIGNATION_NAMESPACES)
 
-        subject { |d| "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}" }
+        subject do |d|
+          "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}"
+        end
 
         types "gloss:Expression", "skosxl:Label"
 
         COMMON_DESIGNATION_PREDICATES.call(self)
-        predicate :prefix, namespace: Namespaces::GlossaristNamespace, to: :prefix
-        predicate :usageInfo, namespace: Namespaces::GlossaristNamespace, to: :usage_info
-        predicate :fieldOfApplication, namespace: Namespaces::GlossaristNamespace, to: :field_of_application
+        predicate :prefix, namespace: Namespaces::GlossaristNamespace,
+                           to: :prefix
+        predicate :usageInfo, namespace: Namespaces::GlossaristNamespace,
+                              to: :usage_info
+        predicate :fieldOfApplication,
+                  namespace: Namespaces::GlossaristNamespace, to: :field_of_application
         members :grammar_info, link: "gloss:hasGrammarInfo"
       end
     end
@@ -90,18 +107,26 @@ module Glossarist
       rdf do
         namespace(*DESIGNATION_NAMESPACES)
 
-        subject { |d| "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}" }
+        subject do |d|
+          "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}"
+        end
 
         types "gloss:Abbreviation", "skosxl:Label"
 
         COMMON_DESIGNATION_PREDICATES.call(self)
-        predicate :prefix, namespace: Namespaces::GlossaristNamespace, to: :prefix
-        predicate :usageInfo, namespace: Namespaces::GlossaristNamespace, to: :usage_info
-        predicate :fieldOfApplication, namespace: Namespaces::GlossaristNamespace, to: :field_of_application
+        predicate :prefix, namespace: Namespaces::GlossaristNamespace,
+                           to: :prefix
+        predicate :usageInfo, namespace: Namespaces::GlossaristNamespace,
+                              to: :usage_info
+        predicate :fieldOfApplication,
+                  namespace: Namespaces::GlossaristNamespace, to: :field_of_application
         members :grammar_info, link: "gloss:hasGrammarInfo"
-        predicate :isAcronym, namespace: Namespaces::GlossaristNamespace, to: :acronym
-        predicate :isInitialism, namespace: Namespaces::GlossaristNamespace, to: :initialism
-        predicate :isTruncation, namespace: Namespaces::GlossaristNamespace, to: :truncation
+        predicate :isAcronym, namespace: Namespaces::GlossaristNamespace,
+                              to: :acronym
+        predicate :isInitialism, namespace: Namespaces::GlossaristNamespace,
+                                 to: :initialism
+        predicate :isTruncation, namespace: Namespaces::GlossaristNamespace,
+                                 to: :truncation
       end
     end
 
@@ -109,7 +134,9 @@ module Glossarist
       rdf do
         namespace(*DESIGNATION_NAMESPACES)
 
-        subject { |d| "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}" }
+        subject do |d|
+          "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}"
+        end
 
         types "gloss:Symbol", "skosxl:Label"
 
@@ -123,7 +150,9 @@ module Glossarist
       rdf do
         namespace(*DESIGNATION_NAMESPACES)
 
-        subject { |d| "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}" }
+        subject do |d|
+          "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}"
+        end
 
         types "gloss:LetterSymbol", "skosxl:Label"
 
@@ -139,7 +168,9 @@ module Glossarist
       rdf do
         namespace(*DESIGNATION_NAMESPACES)
 
-        subject { |d| "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}" }
+        subject do |d|
+          "concept/#{d.concept_id}/#{d.lang_code}/designation/#{d.index}"
+        end
 
         types "gloss:GraphicalSymbol", "skosxl:Label"
 

data/lib/glossarist/rdf/gloss_grammar_info.rb

@@ -15,18 +15,28 @@ module Glossarist
       rdf do
         namespace Namespaces::GlossaristNamespace
 
-        subject { |g| "concept/#{g.concept_id}/#{g.lang_code}/designation/#{g.index}/grammar" }
+        subject do |g|
+          "concept/#{g.concept_id}/#{g.lang_code}/designation/#{g.index}/grammar"
+        end
 
         types "gloss:GrammarInfo"
 
-        predicate :gender, namespace: Namespaces::GlossaristNamespace, to: :gender, uri_reference: true
-        predicate :number, namespace: Namespaces::GlossaristNamespace, to: :number, uri_reference: true
-        predicate :isNoun, namespace: Namespaces::GlossaristNamespace, to: :noun?
-        predicate :isVerb, namespace: Namespaces::GlossaristNamespace, to: :verb?
-        predicate :isAdjective, namespace: Namespaces::GlossaristNamespace, to: :adjective?
-        predicate :isAdverb, namespace: Namespaces::GlossaristNamespace, to: :adverb?
-        predicate :isPreposition, namespace: Namespaces::GlossaristNamespace, to: :preposition?
-        predicate :isParticiple, namespace: Namespaces::GlossaristNamespace, to: :participle?
+        predicate :gender, namespace: Namespaces::GlossaristNamespace,
+                           to: :gender, uri_reference: true
+        predicate :number, namespace: Namespaces::GlossaristNamespace,
+                           to: :number, uri_reference: true
+        predicate :isNoun, namespace: Namespaces::GlossaristNamespace,
+                           to: :noun?
+        predicate :isVerb, namespace: Namespaces::GlossaristNamespace,
+                           to: :verb?
+        predicate :isAdjective, namespace: Namespaces::GlossaristNamespace,
+                                to: :adjective?
+        predicate :isAdverb, namespace: Namespaces::GlossaristNamespace,
+                             to: :adverb?
+        predicate :isPreposition, namespace: Namespaces::GlossaristNamespace,
+                                  to: :preposition?
+        predicate :isParticiple, namespace: Namespaces::GlossaristNamespace,
+                                 to: :participle?
       end
 
       def noun?

data/lib/glossarist/rdf/gloss_locality.rb

@@ -16,9 +16,12 @@ module Glossarist
 
         types "gloss:Locality"
 
-        predicate :localityType, namespace: Namespaces::GlossaristNamespace, to: :locality_type
-        predicate :referenceFrom, namespace: Namespaces::GlossaristNamespace, to: :reference_from
-        predicate :referenceTo, namespace: Namespaces::GlossaristNamespace, to: :reference_to
+        predicate :localityType, namespace: Namespaces::GlossaristNamespace,
+                                 to: :locality_type
+        predicate :referenceFrom, namespace: Namespaces::GlossaristNamespace,
+                                  to: :reference_from
+        predicate :referenceTo, namespace: Namespaces::GlossaristNamespace,
+                                to: :reference_to
       end
     end
   end

data/lib/glossarist/rdf/gloss_localized_concept.rb

@@ -32,13 +32,20 @@ module Glossarist
 
         types "gloss:LocalizedConcept", "skos:Concept"
 
-        predicate :language, namespace: Namespaces::DctermsNamespace, to: :language_code
-        predicate :hasEntryStatus, namespace: Namespaces::GlossaristNamespace, to: :entry_status, uri_reference: true
-        predicate :domain, namespace: Namespaces::GlossaristNamespace, to: :domain
-        predicate :release, namespace: Namespaces::GlossaristNamespace, to: :release
-        predicate :lineageSimilarity, namespace: Namespaces::GlossaristNamespace, to: :lineage_similarity
-        predicate :script, namespace: Namespaces::GlossaristNamespace, to: :script
-        predicate :conversionSystem, namespace: Namespaces::GlossaristNamespace, to: :system
+        predicate :language, namespace: Namespaces::DctermsNamespace,
+                             to: :language_code
+        predicate :hasEntryStatus, namespace: Namespaces::GlossaristNamespace,
+                                   to: :entry_status, uri_reference: true
+        predicate :domain, namespace: Namespaces::GlossaristNamespace,
+                           to: :domain
+        predicate :release, namespace: Namespaces::GlossaristNamespace,
+                            to: :release
+        predicate :lineageSimilarity,
+                  namespace: Namespaces::GlossaristNamespace, to: :lineage_similarity
+        predicate :script, namespace: Namespaces::GlossaristNamespace,
+                           to: :script
+        predicate :conversionSystem,
+                  namespace: Namespaces::GlossaristNamespace, to: :system
 
         members :designations,
                 link: ->(d) { GlossLocalizedConcept.skosxl_label_for(d) }

data/lib/glossarist/rdf/gloss_non_verbal_rep.rb

@@ -16,13 +16,18 @@ module Glossarist
       rdf do
         namespace Namespaces::GlossaristNamespace
 
-        subject { |n| "concept/#{n.concept_id}/#{n.lang_code}/nonverbal/#{n.index}" }
+        subject do |n|
+          "concept/#{n.concept_id}/#{n.lang_code}/nonverbal/#{n.index}"
+        end
 
         types "gloss:NonVerbalRepresentation"
 
-        predicate :representationType, namespace: Namespaces::GlossaristNamespace, to: :representation_type
-        predicate :representationRef, namespace: Namespaces::GlossaristNamespace, to: :representation_ref
-        predicate :representationText, namespace: Namespaces::GlossaristNamespace, to: :representation_text
+        predicate :representationType,
+                  namespace: Namespaces::GlossaristNamespace, to: :representation_type
+        predicate :representationRef,
+                  namespace: Namespaces::GlossaristNamespace, to: :representation_ref
+        predicate :representationText,
+                  namespace: Namespaces::GlossaristNamespace, to: :representation_text
 
         members :sources
       end

data/lib/glossarist/rdf/gloss_pronunciation.rb

@@ -17,15 +17,22 @@ module Glossarist
       rdf do
         namespace Namespaces::GlossaristNamespace
 
-        subject { |p| "concept/#{p.concept_id}/#{p.lang_code}/pronunciation/#{p.index}" }
+        subject do |p|
+          "concept/#{p.concept_id}/#{p.lang_code}/pronunciation/#{p.index}"
+        end
 
         types "gloss:Pronunciation"
 
-        predicate :pronunciationContent, namespace: Namespaces::GlossaristNamespace, to: :content
-        predicate :pronunciationLanguage, namespace: Namespaces::GlossaristNamespace, to: :language
-        predicate :pronunciationScript, namespace: Namespaces::GlossaristNamespace, to: :script
-        predicate :pronunciationCountry, namespace: Namespaces::GlossaristNamespace, to: :country
-        predicate :pronunciationSystem, namespace: Namespaces::GlossaristNamespace, to: :system
+        predicate :pronunciationContent,
+                  namespace: Namespaces::GlossaristNamespace, to: :content
+        predicate :pronunciationLanguage,
+                  namespace: Namespaces::GlossaristNamespace, to: :language
+        predicate :pronunciationScript,
+                  namespace: Namespaces::GlossaristNamespace, to: :script
+        predicate :pronunciationCountry,
+                  namespace: Namespaces::GlossaristNamespace, to: :country
+        predicate :pronunciationSystem,
+                  namespace: Namespaces::GlossaristNamespace, to: :system
       end
     end
   end

data/lib/glossarist/rdf/gloss_reference.rb

@@ -30,12 +30,16 @@ module Glossarist
 
         types "gloss:Reference"
 
-        predicate :citationText, namespace: Namespaces::GlossaristNamespace, to: :text
-        predicate :source, namespace: Namespaces::GlossaristNamespace, to: :source
+        predicate :citationText, namespace: Namespaces::GlossaristNamespace,
+                                 to: :text
+        predicate :source, namespace: Namespaces::GlossaristNamespace,
+                           to: :source
         predicate :refId, namespace: Namespaces::GlossaristNamespace, to: :id
-        predicate :version, namespace: Namespaces::GlossaristNamespace, to: :version
+        predicate :version, namespace: Namespaces::GlossaristNamespace,
+                            to: :version
         predicate :link, namespace: Namespaces::GlossaristNamespace, to: :link
-        predicate :refType, namespace: Namespaces::GlossaristNamespace, to: :ref_type
+        predicate :refType, namespace: Namespaces::GlossaristNamespace,
+                            to: :ref_type
         predicate :urn, namespace: Namespaces::GlossaristNamespace, to: :urn
         predicate :term, namespace: Namespaces::GlossaristNamespace, to: :term
         members :locality, link: "gloss:hasLocality"

data/lib/glossarist/rdf/namespaces.rb

@@ -3,8 +3,9 @@
 module Glossarist
   module Rdf
     module Namespaces
-      autoload :DctermsNamespace,    "#{__dir__}/namespaces/dcterms_namespace"
-      autoload :GlossaristNamespace, "#{__dir__}/namespaces/glossarist_namespace"
+      autoload :DctermsNamespace, "#{__dir__}/namespaces/dcterms_namespace"
+      autoload :GlossaristNamespace,
+               "#{__dir__}/namespaces/glossarist_namespace"
       autoload :IsoThesNamespace,    "#{__dir__}/namespaces/iso_thes_namespace"
       autoload :OwlNamespace,        "#{__dir__}/namespaces/owl_namespace"
       autoload :RdfNamespace,        "#{__dir__}/namespaces/rdf_namespace"

data/lib/glossarist/rdf/relationship_predicates.rb

@@ -18,7 +18,8 @@ module Glossarist
         broader_partitive: [Namespaces::IsoThesNamespace, :broaderPartitive],
         narrower_partitive: [Namespaces::IsoThesNamespace, :narrowerPartitive],
         broader_instantial: [Namespaces::IsoThesNamespace, :broaderInstantial],
-        narrower_instantial: [Namespaces::IsoThesNamespace, :narrowerInstantial],
+        narrower_instantial: [Namespaces::IsoThesNamespace,
+                              :narrowerInstantial],
         equivalent: [Namespaces::SkosNamespace, :exactMatch],
         close_match: [Namespaces::SkosNamespace, :closeMatch],
         broad_match: [Namespaces::SkosNamespace, :broadMatch],
@@ -30,17 +31,23 @@ module Glossarist
         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],
-        related_concept_broader: [Namespaces::GlossaristNamespace, :relatedConceptBroader],
-        related_concept_narrower: [Namespaces::GlossaristNamespace, :relatedConceptNarrower],
+        sequentially_related_concept: [Namespaces::GlossaristNamespace,
+                                       :sequentiallyRelated],
+        spatially_related_concept: [Namespaces::GlossaristNamespace,
+                                    :spatiallyRelated],
+        temporally_related_concept: [Namespaces::GlossaristNamespace,
+                                     :temporallyRelated],
+        related_concept_broader: [Namespaces::GlossaristNamespace,
+                                  :relatedConceptBroader],
+        related_concept_narrower: [Namespaces::GlossaristNamespace,
+                                   :relatedConceptNarrower],
       }.freeze
 
       DESIGNATION_REL_PREDICATES = {
         homograph: [Namespaces::GlossaristNamespace, :hasHomograph],
         false_friend: [Namespaces::GlossaristNamespace, :hasFalseFriend],
-        abbreviated_form_for: [Namespaces::GlossaristNamespace, :abbreviatedFormFor],
+        abbreviated_form_for: [Namespaces::GlossaristNamespace,
+                               :abbreviatedFormFor],
         short_form_for: [Namespaces::GlossaristNamespace, :shortFormFor],
       }.freeze
 

data/lib/glossarist/rdf.rb

@@ -12,7 +12,8 @@ module Glossarist
     autoload :GlossLocality,          "#{__dir__}/rdf/gloss_locality"
     autoload :GlossCitation,          "#{__dir__}/rdf/gloss_citation"
     autoload :GlossConceptSource,     "#{__dir__}/rdf/gloss_concept_source"
-    autoload :GlossDetailedDefinition, "#{__dir__}/rdf/gloss_detailed_definition"
+    autoload :GlossDetailedDefinition,
+             "#{__dir__}/rdf/gloss_detailed_definition"
     autoload :GlossPronunciation,     "#{__dir__}/rdf/gloss_pronunciation"
     autoload :GlossGrammarInfo,       "#{__dir__}/rdf/gloss_grammar_info"
     autoload :GlossNonVerbalRep,      "#{__dir__}/rdf/gloss_non_verbal_rep"

data/lib/glossarist/register_data.rb

@@ -2,38 +2,92 @@
 
 module Glossarist
   class RegisterData < Lutaml::Model::Serializable
-    attribute :data, :hash, default: -> { {} }
+    attribute :key, :string, default: -> { "register" }
+    attribute :shortname, :string
+    attribute :name, :string
+    attribute :description, :string
+    attribute :schema_version, :string
+    attribute :version, :string
+    attribute :owner, :string
+    attribute :languages, :string, collection: true
+    attribute :subregisters, :hash, default: -> { {} }
+    attribute :uri_prefix, :string
+    attribute :concept_uri_template, :string
+    attribute :homepage, :string
+    attribute :repository, :string
+    attribute :license, :string
+    attribute :tags, :string, collection: true
+    attribute :translations, :hash, default: -> { {} }
 
     key_value do
-      map nil, to: :data, with: { from: :data_from, to: :data_to }
-    end
-
-    def self.from_file(path)
-      from_yaml(File.read(path))
-    rescue Errno::ENOENT
-      nil
+      map %i[id shortname], to: :shortname
+      map "name", to: :name
+      map "description", to: :description
+      map "schema_version", to: :schema_version
+      map "version", to: :version
+      map "owner", to: :owner
+      map "languages", to: :languages
+      map "subregisters", to: :subregisters
+      map "uri_prefix", to: :uri_prefix
+      map "concept_uri_template", to: :concept_uri_template
+      map "homepage", to: :homepage
+      map "repository", to: :repository
+      map "license", to: :license
+      map "tags", to: :tags
+      map "translations", to: :translations
     end
 
     def [](key)
-      data[key]
+      case key
+      when "shortname", "id" then shortname
+      when "name" then name
+      when "description" then description
+      when "schema_version" then schema_version
+      when "version" then version
+      when "owner" then owner
+      when "languages" then languages
+      when "subregisters" then subregisters
+      when "uri_prefix" then uri_prefix
+      when "concept_uri_template" then concept_uri_template
+      when "homepage" then homepage
+      when "repository" then repository
+      when "license" then license
+      when "tags" then tags
+      when "translations" then translations
+      end
     end
 
     def dig(*keys)
-      data.dig(*keys)
+      return nil if keys.empty?
+
+      first = self[keys.first]
+      keys.length == 1 ? first : nil
     end
 
     def to_h
-      data
+      h = {}
+      h["shortname"] = shortname if shortname
+      h["name"] = name if name
+      h["description"] = description if description
+      h["schema_version"] = schema_version if schema_version
+      h["version"] = version if version
+      h["owner"] = owner if owner
+      h["languages"] = languages if languages && !languages.empty?
+      h["subregisters"] = subregisters if subregisters && !subregisters.empty?
+      h["uri_prefix"] = uri_prefix if uri_prefix
+      h["concept_uri_template"] = concept_uri_template if concept_uri_template
+      h["homepage"] = homepage if homepage
+      h["repository"] = repository if repository
+      h["license"] = license if license
+      h["tags"] = tags if tags && !tags.empty?
+      h["translations"] = translations if translations && !translations.empty?
+      h
     end
 
-    def data_from(model, value)
-      model.data = value
-    end
+    def self.from_file(path)
+      return nil unless File.exist?(path)
 
-    def data_to(model, doc)
-      model.data.each do |key, value|
-        doc[key] = value
-      end
+      from_yaml(File.read(path, encoding: "utf-8"))
     end
   end
 end

data/lib/glossarist/schema_migration.rb

@@ -23,7 +23,10 @@ module Glossarist
         end
       end
 
-      raise Error, "Migration chain too long or unresolvable" unless current == target
+      unless current == target
+        raise Error,
+              "Migration chain too long or unresolvable"
+      end
 
       concept.schema_version = target
       concept
@@ -53,8 +56,8 @@ module Glossarist
 
     LANG_CODES = Glossarist::LANG_CODES
 
-    IEV_PATTERN = /\{\{([^,}]+),\s*IEV:([^}]+)\}\}/.freeze
-    URN_PATTERN = /\{urn:iso:std:iso:(\d+):([^,}]+),([^}]+)\}/.freeze
+    IEV_PATTERN = /\{\{([^,}]+),\s*IEV:([^}]+)\}\}/
+    URN_PATTERN = /\{urn:iso:std:iso:(\d+):([^,}]+),([^}]+)\}/
 
     attr_reader :from_version, :to_version
 
@@ -149,7 +152,7 @@ module Glossarist
       src = lc.delete("authoritative_source")
       return if lc.key?("sources")
 
-      sources = (src.is_a?(Array) ? src : [src]).map do |s|
+      sources = (src.is_a?(Array) ? src : [src]).filter_map do |s|
         next unless s.is_a?(Hash)
 
         origin = {}
@@ -166,7 +169,7 @@ module Glossarist
           end
         end
         entry
-      end.compact
+      end
 
       lc["sources"] = sources if sources.any?
     end

data/lib/glossarist/section.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+module Glossarist
+  class Section < Lutaml::Model::Serializable
+    attribute :id, :string
+    attribute :names, :hash
+    attribute :ordering, :string
+    attribute :children, Section, collection: true
+
+    key_value do
+      map :id, to: :id
+      map :names, to: :names
+      map :ordering, to: :ordering
+      map :children, to: :children
+    end
+
+    def name(lang = nil)
+      return names&.dig("eng") if lang.nil?
+
+      names&.dig(lang) || names&.dig("eng")
+    end
+
+    def descendant_by_id(target_id)
+      children&.each do |child|
+        return child if child.id == target_id
+
+        found = child.descendant_by_id(target_id)
+        return found if found
+      end
+      nil
+    end
+
+    def self.from_file(path)
+      return nil unless File.exist?(path)
+
+      from_yaml(File.read(path, encoding: "utf-8"))
+    end
+  end
+end