pubid 2.0.0.pre.alpha.5 → 2.0.0.pre.alpha.7

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.5"
+  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"
@@ -95,6 +115,7 @@ module Pubid
   autoload :Idf, "pubid/idf"
   autoload :Iec, "pubid/iec"
   autoload :Ieee, "pubid/ieee"
+  autoload :Iala, "pubid/iala"
   autoload :Iho, "pubid/iho"
   autoload :Iso, "pubid/iso"
   autoload :Itu, "pubid/itu"
@@ -174,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,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pubid
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre.alpha.5
+  version: 2.0.0.pre.alpha.7
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-07-06 00:00:00.000000000 Z
+date: 2026-07-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -335,6 +335,26 @@ files:
 - lib/pubid/export/result.rb
 - lib/pubid/format_detector.rb
 - lib/pubid/format_registry.rb
+- lib/pubid/iala.rb
+- 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
+- lib/pubid/iala/identifiers/report.rb
+- lib/pubid/iala/identifiers/resolution.rb
+- lib/pubid/iala/identifiers/standard.rb
+- lib/pubid/iala/parser.rb
+- lib/pubid/iala/renderer.rb
+- lib/pubid/iala/urn_generator.rb
+- lib/pubid/iala/urn_parser.rb
 - lib/pubid/identifier.rb
 - lib/pubid/identifier_metadata.rb
 - lib/pubid/idf.rb
@@ -609,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
@@ -640,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