pubid 2.0.0.pre.alpha.6 → 2.0.0.pre.alpha.7

data/lib/pubid/ieee.rb

@@ -2,6 +2,14 @@
 
 module Pubid
   module Ieee
+    extend Pubid::PrefixesSupport
+
+    # Publisher prefix. The private PreParser::PUBLISHERS list also holds adopted
+    # co-org names (ANSI, AIEE, ASA, ...) that are not leading routing tokens for
+    # an IEEE reference, so they are deliberately excluded. The joint ISO/IEC/IEEE
+    # form comes from Pubid::JOINT_PREFIXES.
+    PREFIXES = ["IEEE"].freeze
+
     autoload :Aiee, "#{__dir__}/ieee/aiee"
     autoload :Builder, "#{__dir__}/ieee/builder"
     autoload :Identifier, "#{__dir__}/ieee/identifier"

data/lib/pubid/iho.rb

@@ -2,6 +2,11 @@
 
 module Pubid
   module Iho
+    extend Pubid::PrefixesSupport
+
+    # Sole IHO publisher token (see the parser grammar).
+    PREFIXES = ["IHO"].freeze
+
     autoload :Builder,      "#{__dir__}/iho/builder"
     autoload :Identifier,   "#{__dir__}/iho/identifier"
     autoload :Identifiers,  "#{__dir__}/iho/identifiers"

data/lib/pubid/iso.rb

@@ -4,6 +4,12 @@ require "lutaml/model"
 
 module Pubid
   module Iso
+    extend Pubid::PrefixesSupport
+
+    # Sole ISO publisher token. Joint / co-publication forms (ISO/IEC, IEC/ISO,
+    # ISO/IEC/IEEE) are contributed symmetrically via Pubid::JOINT_PREFIXES.
+    PREFIXES = ["ISO"].freeze
+
     autoload :Builder, "#{__dir__}/iso/builder"
     autoload :BundledIdentifier, "#{__dir__}/iso/bundled_identifier"
     autoload :CombinedIdentifier, "#{__dir__}/iso/combined_identifier"

data/lib/pubid/itu.rb

@@ -4,6 +4,11 @@ require "lutaml/model"
 
 module Pubid
   module Itu
+    extend Pubid::PrefixesSupport
+
+    # Sole ITU publisher token (see the parser's `itu_prefix` rule).
+    PREFIXES = ["ITU"].freeze
+
     autoload :Builder, "#{__dir__}/itu/builder"
     autoload :Components, "#{__dir__}/itu/components"
     autoload :Identifier, "#{__dir__}/itu/identifier"

data/lib/pubid/jcgm.rb

@@ -2,6 +2,11 @@
 
 module Pubid
   module Jcgm
+    extend Pubid::PrefixesSupport
+
+    # Sole JCGM publisher token (see the parser's `publisher` rule).
+    PREFIXES = ["JCGM"].freeze
+
     autoload :Builder, "#{__dir__}/jcgm/builder"
     autoload :Components, "#{__dir__}/jcgm/components"
     autoload :Identifier, "#{__dir__}/jcgm/identifier"

data/lib/pubid/jis.rb

@@ -2,6 +2,12 @@
 
 module Pubid
   module Jis
+    extend Pubid::PrefixesSupport
+
+    # Sole JIS publisher token (see the parser's `jis_prefix` rule). Document
+    # types (TR/TS) follow the JIS prefix and are excluded.
+    PREFIXES = ["JIS"].freeze
+
     autoload :Builder, "#{__dir__}/jis/builder"
     autoload :Identifier, "#{__dir__}/jis/identifier"
     autoload :Identifiers, "#{__dir__}/jis/identifiers"

data/lib/pubid/nist.rb

@@ -2,6 +2,19 @@
 
 module Pubid
   module Nist
+    extend Pubid::PrefixesSupport
+
+    # Publisher prefixes (NBS/NIST) plus the "simple series" tokens that can
+    # *begin* a printed reference on their own — mirrors the parser's
+    # `publisher` and `simple_series` rules (lib/pubid/nist/parser.rb). Compound
+    # series that only appear glued to a publisher (e.g. "NBS CRPL-F-A") are
+    # excluded because they never lead a routable reference by themselves.
+    PREFIXES = %w[
+      NIST NBS
+      AMS VTS BSS BMS BH FIPS GCR HB MONO MP NCSTAR NSRDS IR SP TN CSWP
+      AI CIRC CS CSM CRPL LCIRC OWMWP PC RPT SIBS TIBM TTB EAB JPCRD JRES
+    ].freeze
+
     autoload :Builder, "#{__dir__}/nist/builder"
     autoload :Caster, "#{__dir__}/nist/caster"
     autoload :CircularSupplementBuilder, "#{__dir__}/nist/circular_supplement_builder"

data/lib/pubid/oiml/builder.rb

@@ -6,6 +6,7 @@ module Pubid
       # Type to identifier class mapping (MECE)
       TYPE_CLASS_MAP = {
         "B" => "BasicPublication",
+        "Bulletin" => "Bulletin",
         "D" => "Document",
         "E" => "ExpertReport",
         "G" => "Guide",
@@ -175,12 +176,26 @@ module Pubid
           identifier.date = Pubid::Components::Date.new(year: year_value.to_s)
         end
 
+        # Bulletin-specific locator fields. The structured form captures
+        # issue/sequence directly; the citation form captures volume/issue/
+        # article_id, which we decode to the same (year, issue, sequence)
+        # tuple. Year comes from either the date rule (structured) or the
+        # article_id (citation).
+        if identifier.is_a?(Identifiers::Bulletin)
+          apply_bulletin_locator(identifier, parsed_hash)
+        end
+
         # Determine parsed format for round-trip fidelity
         # If edition_format was captured, it means "Edition" text was present
         identifier.parsed_format = if parsed_hash[:edition_format]
                                      "long"
                                    elsif parsed_hash[:space_before_lang]
                                      "short_with_space"
+                                   elsif parsed_hash[:article_id]
+                                     # Bulletin citation form — preserve on
+                                     # the identifier so default to_s gives
+                                     # back the citation string verbatim.
+                                     "citation"
                                    else
                                      "short"
                                    end
@@ -195,6 +210,24 @@ module Pubid
         identifier
       end
 
+      # Populate issue/sequence on a Bulletin from either parse shape.
+      # Structured: :issue and :sequence captured directly as zero-padded
+      # strings. Citation: :volume_roman, :issue_arabic, :article_id —
+      # decode the 8-digit article_id to recover year+issue+sequence.
+      def apply_bulletin_locator(identifier, parsed_hash)
+        if parsed_hash[:article_id]
+          article_id = parsed_hash[:article_id].to_s
+          identifier.date ||= Pubid::Components::Date.new
+          identifier.date.year = article_id[0, 4]
+          identifier.issue = article_id[4, 2]
+          identifier.sequence = article_id[6, 2]
+          return
+        end
+
+        identifier.issue = parsed_hash[:issue].to_s if parsed_hash[:issue]
+        identifier.sequence = parsed_hash[:sequence].to_s if parsed_hash[:sequence]
+      end
+
       def extract_language(lang_data)
         # Handle both direct string and nested hash from parser
         case lang_data

data/lib/pubid/oiml/identifier.rb

@@ -10,6 +10,7 @@ module Pubid
       OIML_TYPE_MAP = {
         "pubid:oiml:recommendation" => "Pubid::Oiml::Identifiers::Recommendation",
         "pubid:oiml:basic-publication" => "Pubid::Oiml::Identifiers::BasicPublication",
+        "pubid:oiml:bulletin" => "Pubid::Oiml::Identifiers::Bulletin",
         "pubid:oiml:document" => "Pubid::Oiml::Identifiers::Document",
         "pubid:oiml:guide" => "Pubid::Oiml::Identifiers::Guide",
         "pubid:oiml:vocabulary" => "Pubid::Oiml::Identifiers::Vocabulary",

data/lib/pubid/oiml/identifiers/bulletin.rb

@@ -0,0 +1,101 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Oiml
+    module Identifiers
+      # OIML Bulletin issues and articles. Carries no code — the locator is
+      # the (year, issue, sequence) tuple drawn from the issue's place in the
+      # periodical hierarchy.
+      #
+      # Two input forms are accepted, both referring to the same article:
+      #
+      #   structured:  "OIML Bulletin 2026-02-11"
+      #   citation:    "OIML Bulletin LXVII(2) 20260211"
+      #
+      # The structured form is the dataset's primary docid (sortable,
+      # deterministic). The citation form is what OIML prints on the article
+      # page (`Citation: AUTHOR YEAR OIML Bulletin VOLUME(ISSUE) ARTID`).
+      #
+      # Volume tracks year deterministically: 1960 = I, year - 1959 = volume.
+      # The 8-digit article id is YYYYNNSS — the same three values concatenated,
+      # so the citation form is decoded entirely from the article id; the
+      # roman volume and parenthesised issue are redundant display.
+      #
+      # Shapes in relaton-data-oiml:
+      #   "OIML Bulletin"                       (periodical)
+      #   "OIML Bulletin 1960"                  (volume / year)
+      #   "OIML Bulletin 1960-03"               (issue)
+      #   "OIML Bulletin 1960-03-01"            (article, structured)
+      #   "OIML Bulletin LXVII(2) 20260211"     (article, citation)
+      class Bulletin < SingleIdentifier
+        # OIML Bulletin volume I was issued in 1960. Volume N corresponds to
+        # year (N + BASE_YEAR_OFFSET). Used to translate between the year
+        # carried in the structured form and the roman volume in citations.
+        BASE_YEAR_OFFSET = 1959
+
+        # Zero-padded issue number within the year ("01".."04", plus "07"/"10"
+        # for the online-bulletin series). Always 2 digits.
+        attribute :issue, :string
+        # Zero-padded sequence within the issue ("00" = editorial, "01"+ for
+        # articles). Always 2 digits.
+        attribute :sequence, :string
+
+        key_value do
+          map "issue", to: :issue
+          map "sequence", to: :sequence
+        end
+
+        def type_string
+          "Bulletin"
+        end
+
+        # Volume as an arabic string ("67"), derived from the year. nil when
+        # the year is absent (bare periodical reference).
+        def volume_arabic
+          return nil unless date&.year
+
+          (date.year.to_i - BASE_YEAR_OFFSET).to_s
+        end
+
+        # Volume as a roman-numeral string ("LXVII"), derived from the year.
+        # nil when the year is absent.
+        def volume_roman
+          number = volume_arabic&.to_i
+          return nil unless number&.positive?
+
+          self.class.to_roman(number)
+        end
+
+        # 8-digit oiml.org article id ("20260211"). Composed by concatenating
+        # year + issue + sequence. nil unless all three are present.
+        def article_id
+          return nil unless date&.year && issue && sequence
+
+          "#{date.year}#{issue}#{sequence}"
+        end
+
+        class << self
+          # Convert a positive integer to its roman-numeral representation.
+          # Used to render the citation form. The dataset already stores the
+          # roman volume verbatim in `extent.locality`, so this conversion is
+          # only needed when rendering from the structured form.
+          def to_roman(number)
+            raise ArgumentError, "volume must be > 0" unless number.positive?
+
+            ROMAN_TABLE.each_with_object(+"") do |(value, sym), result|
+              quotient, number = number.divmod(value)
+              result << (sym * quotient)
+            end.freeze
+          end
+
+          ROMAN_TABLE = [
+            [1000, "M"], [900, "CM"], [500, "D"], [400, "CD"],
+            [100, "C"], [90, "XC"], [50, "L"], [40, "XL"],
+            [10, "X"], [9, "IX"], [5, "V"], [4, "IV"],
+            [1, "I"]
+          ].freeze
+        end
+      end
+    end
+  end
+end

data/lib/pubid/oiml/identifiers.rb

@@ -6,6 +6,7 @@ module Pubid
       autoload :Amendment, "#{__dir__}/identifiers/amendment"
       autoload :Annex, "#{__dir__}/identifiers/annex"
       autoload :BasicPublication, "#{__dir__}/identifiers/basic_publication"
+      autoload :Bulletin, "#{__dir__}/identifiers/bulletin"
       autoload :Document, "#{__dir__}/identifiers/document"
       autoload :Errata, "#{__dir__}/identifiers/errata"
       autoload :ExpertReport, "#{__dir__}/identifiers/expert_report"

data/lib/pubid/oiml/parser.rb

@@ -20,7 +20,7 @@ module Pubid
       rule(:identifier) do
         amendment_identifier | amendment_short | annex_letter_identifier |
           annex_identifier | plus_supplement_identifier |
-          trailing_supplement_identifier | base_identifier
+          trailing_supplement_identifier | bulletin_identifier | base_identifier
       end
 
       # Publisher - always "OIML"
@@ -29,6 +29,48 @@ module Pubid
       # Document type - single letter
       rule(:doc_type) { match("[BDEGRSVX]").as(:type) >> space }
 
+      # Bulletin locator — structured form. Year optionally followed by
+      # 2-digit issue and 2-digit sequence:
+      #   "OIML Bulletin", "OIML Bulletin 1960",
+      #   "OIML Bulletin 1960-03", "OIML Bulletin 1960-03-01"
+      # All four shapes appear as primary docids in relaton-data-oiml.
+      rule(:bulletin_date) do
+        space >> year_digits.as(:year) >>
+          (dash >> two_digits.as(:issue)).maybe >>
+          (dash >> two_digits.as(:sequence)).maybe
+      end
+
+      # Two-digit zero-padded number (used for issue / sequence).
+      rule(:two_digits) { match('\d').repeat(2, 2) }
+
+      # Roman numeral token composed of I,V,X,L,C,D,M (uppercase, matching
+      # OIML's print convention). Consumed but not captured — the 8-digit
+      # article id in the same citation carries year/issue/sequence
+      # deterministically, so the roman volume is redundant for parsing.
+      rule(:roman_numeral) { match("[IVXLCDM]").repeat(1) }
+
+      # Bulletin locator — citation form. The format OIML prints on the
+      # article page is: "LXVII(2) 20260211" where LXVII is the volume in
+      # roman numerals, (2) is the issue in arabic without zero padding,
+      # and 20260211 is the 8-digit oiml.org article id (YYYYNNSS).
+      rule(:bulletin_citation) do
+        space >> roman_numeral >>
+          lparen >> digits.as(:issue_arabic) >> rparen >>
+          space >> match('\d').repeat(8, 8).as(:article_id)
+      end
+
+      # Bulletin identifier — no code; the locator (when present) is the
+      # (year, issue, sequence) tuple drawn from either the structured
+      # YYYY-II-SS form or the citation VOLUME(ISSUE) ARTID form. Both
+      # decode to the same record. Tried before base_identifier because
+      # "Bulletin" is a word that the single-letter doc_type rule cannot
+      # match.
+      rule(:bulletin_identifier) do
+        publisher >> str("Bulletin").as(:type) >>
+          (bulletin_citation | bulletin_date).maybe >>
+          language_portion.maybe.as(:language)
+      end
+
       # Number with optional part and subpart
       rule(:number_only) { digits.as(:number) }
 

data/lib/pubid/oiml/renderer.rb

@@ -20,6 +20,8 @@ module Pubid
         case id
         when Identifiers::Annex
           render_annex(id)
+        when Identifiers::Bulletin
+          render_bulletin(id)
         when SupplementIdentifier
           render_supplement(id)
         when SingleIdentifier
@@ -31,6 +33,55 @@ module Pubid
 
       private
 
+      # Render the Bulletin in the requested or parsed form. Default is the
+      # structured "YYYY-II-SS" form (the dataset's primary docid). The
+      # citation form ("LXVII(2) 20260211") is emitted when the user asks
+      # for it via `to_s(format: :citation)` or when the identifier was
+      # itself parsed from a citation string (parsed_format == "citation").
+      def render_bulletin(id)
+        if citation_form?(id)
+          render_bulletin_citation(id)
+        else
+          render_bulletin_structured(id)
+        end
+      end
+
+      # User's explicit format request takes precedence over the parsed
+      # form, so `parse("LXVII(2) 20260211").to_s(format: :short)` returns
+      # the structured form. With no explicit request, the parsed form is
+      # preserved for round-trip fidelity.
+      def citation_form?(id)
+        case id.requested_format
+        when :citation then true
+        when :short, :structured then false
+        else
+          id.parsed_format == "citation"
+        end
+      end
+
+      # "OIML Bulletin" / "OIML Bulletin 1960" / "OIML Bulletin 1960-03" /
+      # "OIML Bulletin 1960-03-01". No code; the locator is space-separated.
+      def render_bulletin_structured(id)
+        result = "#{id.publisher} Bulletin"
+        if id.date&.year
+          result += " #{id.date.year}"
+          result += "-#{id.issue}" if id.issue
+          result += "-#{id.sequence}" if id.sequence
+        end
+        result += " (#{id.language})" if id.language
+        result
+      end
+
+      # "OIML Bulletin LXVII(2) 20260211". Only emitted for full articles
+      # (year + issue + sequence all present); lower tiers fall back to
+      # structured since OIML's citation format doesn't define volume-only
+      # or issue-only variants.
+      def render_bulletin_citation(id)
+        return render_bulletin_structured(id) unless id.date&.year && id.issue && id.sequence
+
+        "#{id.publisher} Bulletin #{id.volume_roman}(#{id.issue.to_i}) #{id.article_id}"
+      end
+
       def effective_format(id)
         id.requested_format ||
           (id.parsed_format == "long" ? :long : :short)

data/lib/pubid/oiml/urn_generator.rb

@@ -28,6 +28,17 @@ module Pubid
       end
 
       def generate
+        # Bulletin issues carry no code; the (year, issue, sequence) tuple
+        # is the locator. URNs are canonical regardless of how the input was
+        # formatted, so we always emit the structured YYYY-II-SS form even
+        # when the identifier was parsed from a citation string.
+        if identifier.is_a?(Identifiers::Bulletin)
+          parts = ["urn", "oiml", "bulletin"]
+          parts << bulletin_locator if identifier.date&.present?
+          parts << urn_language if urn_language
+          return parts.join(":")
+        end
+
         parts = ["urn", "oiml"]
         parts << urn_type
         parts << urn_number if urn_number
@@ -51,6 +62,17 @@ module Pubid
 
         parts.join(":")
       end
+
+      # Structured locator "YYYY-II-SS" (or "YYYY-II" / "YYYY") for a Bulletin.
+      # Built directly from the date year and the issue/sequence attributes so
+      # the URN is identical regardless of whether the input was the structured
+      # or citation form.
+      def bulletin_locator
+        locator = identifier.date.year.to_s
+        locator += "-#{identifier.issue}" if identifier.issue
+        locator += "-#{identifier.sequence}" if identifier.sequence
+        locator
+      end
     end
   end
 end

data/lib/pubid/oiml.rb

@@ -2,6 +2,11 @@
 
 module Pubid
   module Oiml
+    extend Pubid::PrefixesSupport
+
+    # Sole OIML publisher token (see the parser's `publisher` rule).
+    PREFIXES = ["OIML"].freeze
+
     autoload :Builder, "#{__dir__}/oiml/builder"
     autoload :Components, "#{__dir__}/oiml/components"
     autoload :Identifier, "#{__dir__}/oiml/identifier"

data/lib/pubid/plateau.rb

@@ -4,6 +4,11 @@ require "parslet"
 
 module Pubid
   module Plateau
+    extend Pubid::PrefixesSupport
+
+    # Sole PLATEAU publisher token (see the parser's `publisher` rule).
+    PREFIXES = ["PLATEAU"].freeze
+
     autoload :Builder, "#{__dir__}/plateau/builder"
     autoload :Identifier, "#{__dir__}/plateau/identifier"
     autoload :Identifiers, "#{__dir__}/plateau/identifiers"

data/lib/pubid/prefixes_support.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Pubid
+  # Mixin providing the uniform, static +prefixes+ class method that every
+  # registered flavor exposes. relaton uses this to build a global prefix
+  # register that routes a printed reference string (e.g. +"DD 1234"+,
+  # +"ISO/IEC 8802"+) to the flavor(s) that own it.
+  #
+  # A flavor +extend+s this module and defines a frozen +PREFIXES+ array holding
+  # only *its own* leading tokens. Joint / co-publication tokens are injected
+  # centrally from {Pubid::JOINT_PREFIXES} so that a co-published prefix
+  # (e.g. +"ISO/IEC"+) is listed symmetrically by every co-publisher without
+  # being duplicated by hand in two files.
+  #
+  # == Inclusion policy
+  # +prefixes+ returns the set of *leading identifier prefix tokens* — the
+  # tokens a printed identifier can start with such that the string belongs to
+  # this SDO. Concretely it INCLUDES:
+  # * publisher prefixes (e.g. +ISO+, +IEC+, +NIST+, +NBS+, +BS+, +BSI+);
+  # * leading series/type tokens that can *begin* a printed reference on their
+  #   own (e.g. BSI +DD+/+PD+, NIST +FIPS+/+SP+);
+  # * joint / co-publication forms (e.g. +ISO/IEC+, +ISO/IEC/IEEE+).
+  # It EXCLUDES:
+  # * pure sub-series that never appear without a publisher prefix;
+  # * dangerously-ambiguous single letters (e.g. BSI aerospace +A+/+B+/+C+),
+  #   which would cause false routing.
+  module PrefixesSupport
+    # The static set of leading prefix tokens this flavor recognizes.
+    #
+    # Static: callable without parsing any identifier string. Strings are
+    # returned in canonical case exactly as printed (e.g. +"BS EN ISO"+,
+    # +"ISO/IEC"+); consumers fold case themselves.
+    #
+    # @return [Array<String>] frozen, de-duplicated list of prefix tokens
+    def prefixes
+      own = const_defined?(:PREFIXES) ? const_get(:PREFIXES) : []
+      joint = Pubid::JOINT_PREFIXES.fetch(prefix_flavor_key, [])
+      (own + joint).uniq.freeze
+    end
+
+    # The registry key for this flavor, derived from the module name
+    # (e.g. +Pubid::CenCenelec+ => +:cen_cenelec+). Used to look this flavor up
+    # in {Pubid::JOINT_PREFIXES} and to label it in {Pubid.prefix_flavors}.
+    #
+    # @return [Symbol]
+    def prefix_flavor_key
+      name.split("::").last
+        .gsub(/([a-z\d])([A-Z])/, '\1_\2').downcase.to_sym
+    end
+  end
+end

data/lib/pubid/sae.rb

@@ -2,6 +2,12 @@
 
 module Pubid
   module Sae
+    extend Pubid::PrefixesSupport
+
+    # Sole SAE publisher token (see the parser's `publisher` rule). Document
+    # types (AMS/AIR/ARP/AS/J/MA) follow the SAE prefix and are excluded.
+    PREFIXES = ["SAE"].freeze
+
     autoload :Builder, "#{__dir__}/sae/builder"
     autoload :Components, "#{__dir__}/sae/components"
     autoload :Identifier, "#{__dir__}/sae/identifier"

data/lib/pubid/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Pubid
-  VERSION = "2.0.0.pre.alpha.6"
+  VERSION = "2.0.0.pre.alpha.7"
 end

data/lib/pubid.rb

@@ -9,6 +9,11 @@ require "parslet"
 # code runs.
 require "pubid/lutaml/no_store_registration"
 
+# Uniform, static per-flavor prefix API (Pubid::<Flavor>.prefixes). Required
+# before the flavor autoloads below so each flavor file can `extend` it and the
+# central JOINT_PREFIXES constant is visible when its PREFIXES is defined.
+require "pubid/prefixes_support"
+
 module Pubid
   # Upper bound on the length of an identifier string accepted by any +parse+
   # entry point. Real-world standards identifiers are well under 200 characters;
@@ -61,6 +66,21 @@ module Pubid
     end
   end
 
+  # Canonical joint / co-publication leading tokens, injected symmetrically into
+  # every participating flavor's +prefixes+ (see {PrefixesSupport}). Single
+  # source of truth: editing an entry here updates both sides at once
+  # (e.g. +"ISO/IEC"+ appears in +Pubid::Iso.prefixes+ and +Pubid::Iec.prefixes+),
+  # so co-publication symmetry can never drift. Keyed by
+  # {PrefixesSupport#prefix_flavor_key}.
+  JOINT_PREFIXES = {
+    iso: ["ISO/IEC", "IEC/ISO", "ISO/IEC/IEEE"],
+    iec: ["ISO/IEC", "IEC/ISO", "ISO/IEC/IEEE"],
+    ieee: ["ISO/IEC/IEEE"],
+    ansi: ["ANSI/ASHRAE", "ANSI/AMCA"],
+    ashrae: ["ANSI/ASHRAE"],
+    amca: ["ANSI/AMCA"],
+  }.freeze
+
   autoload :Parser, "pubid/parser"
   autoload :Components, "pubid/components"
   autoload :BundledIdentifier, "pubid/bundled_identifier"
@@ -175,4 +195,52 @@ module Pubid
     end
     @flavors_loaded = true
   end
+
+  # Static leading prefix tokens for a single flavor.
+  #
+  # @param flavor [Symbol, String] a registered flavor name (e.g. +:iso+)
+  # @return [Array<String>] the flavor's prefixes (see {PrefixesSupport})
+  # @raise [ArgumentError] if the flavor is not registered
+  def self.prefixes(flavor)
+    mod = Registry.get(flavor)
+    raise ArgumentError, "unknown flavor: #{flavor.inspect}" unless mod
+
+    mod.prefixes
+  end
+
+  # Reverse index mapping every canonical prefix token to the flavor(s) that
+  # own it — the exact routing table relaton needs. Co-published prefixes list
+  # every co-publisher (e.g. +"ISO/IEC" => [:iec, :iso]+); see the inclusion /
+  # exclusion policy documented on {PrefixesSupport}.
+  #
+  # The +:cen+ alias of +:cen_cenelec+ is de-duplicated by module identity, so a
+  # prefix is attributed to a flavor's canonical
+  # {PrefixesSupport#prefix_flavor_key} exactly once.
+  #
+  # @return [Hash{String => Array<Symbol>}] prefix token => sorted flavor keys,
+  #   e.g. +{ "ISO" => [:iso], "ISO/IEC" => [:iec, :iso], ... }+
+  def self.prefix_flavors
+    index = Hash.new { |h, k| h[k] = [] }
+    each_prefix_flavor_module do |mod|
+      key = mod.prefix_flavor_key
+      mod.prefixes.each { |prefix| index[prefix] |= [key] }
+    end
+    index.transform_values(&:sort).sort.to_h
+  end
+
+  # Yields each unique flavor module that exposes +prefixes+ exactly once,
+  # collapsing alias registrations (e.g. +:cen+ and +:cen_cenelec+ both point to
+  # +Pubid::CenCenelec+) by module identity.
+  # @yieldparam mod [Module] a flavor module
+  def self.each_prefix_flavor_module
+    eager_load_flavors!
+    seen = {}
+    Registry.flavor_names.each do |flavor_name|
+      mod = Registry.get(flavor_name)
+      next if seen.key?(mod) || !mod.respond_to?(:prefixes)
+
+      seen[mod] = true
+      yield mod
+    end
+  end
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: pubid
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre.alpha.6
+  version: 2.0.0.pre.alpha.7
 platform: ruby
 authors:
 - Ribose Inc.
@@ -339,8 +339,12 @@ files:
 - lib/pubid/iala/builder.rb
 - lib/pubid/iala/identifier.rb
 - lib/pubid/iala/identifiers.rb
+- lib/pubid/iala/identifiers/advice.rb
+- lib/pubid/iala/identifiers/annex.rb
 - lib/pubid/iala/identifiers/base.rb
+- lib/pubid/iala/identifiers/general_assembly.rb
 - lib/pubid/iala/identifiers/guideline.rb
+- lib/pubid/iala/identifiers/letter.rb
 - lib/pubid/iala/identifiers/manual.rb
 - lib/pubid/iala/identifiers/model_course.rb
 - lib/pubid/iala/identifiers/recommendation.rb
@@ -625,6 +629,7 @@ files:
 - lib/pubid/oiml/identifiers/amendment.rb
 - lib/pubid/oiml/identifiers/annex.rb
 - lib/pubid/oiml/identifiers/basic_publication.rb
+- lib/pubid/oiml/identifiers/bulletin.rb
 - lib/pubid/oiml/identifiers/document.rb
 - lib/pubid/oiml/identifiers/errata.rb
 - lib/pubid/oiml/identifiers/expert_report.rb
@@ -656,6 +661,7 @@ files:
 - lib/pubid/plateau/supplement_identifier.rb
 - lib/pubid/plateau/urn_generator.rb
 - lib/pubid/plateau/urn_parser.rb
+- lib/pubid/prefixes_support.rb
 - lib/pubid/renderers.rb
 - lib/pubid/renderers/base.rb
 - lib/pubid/renderers/directives_renderer.rb