pubid 2.0.0.pre.alpha.1 → 2.0.0.pre.alpha.2

data/lib/pubid/renderers/iwa_renderer.rb

@@ -5,7 +5,11 @@ module Pubid
     class IwaRenderer < HumanReadable
       def render(context:, with_edition: false)
         parts = []
-        parts << @id.typed_stage.render(context:) if @id.typed_stage
+        if @id.typed_stage
+          parts << annotate(@id.typed_stage.render(context:),
+                            typed_stage_css(@id.typed_stage),
+                            annotated: context.annotated)
+        end
         parts << render_number_portion(context)
         result = parts.compact.join(" ")
         result << render_language_portion(context, with_edition: with_edition)

data/lib/pubid/renderers/supplement_renderer.rb

@@ -10,9 +10,12 @@ module Pubid
           with_edition: with_edition,
           stage_format_long: context.stage_format_long,
           with_date: context.with_date,
+          annotated: context.annotated,
         )
 
-        stage_str = @id.typed_stage.render(context:)
+        stage_str = annotate(@id.typed_stage.render(context:),
+                             typed_stage_css(@id.typed_stage),
+                             annotated: context.annotated)
         parts << "#{base_str}/#{stage_str}"
 
         num_port = render_number_portion(context)

data/lib/pubid/rendering/context.rb

@@ -22,7 +22,8 @@ module Pubid
       attr_reader :stage_separator, :stage_separator_with_copublisher,
                   :type_separator, :type_separator_with_prefix,
                   :default_type_abbr, :lang, :lang_single,
-                  :with_language_code, :stage_format_long, :with_date
+                  :with_language_code, :stage_format_long, :with_date,
+                  :annotated
 
       # Initialize a new rendering context
       #
@@ -42,7 +43,8 @@ module Pubid
                      lang_single: false,
                      with_language_code: :none,
                      stage_format_long: false,
-                     with_date: true)
+                     with_date: true,
+                     annotated: false)
         @stage_separator = stage_separator
         @stage_separator_with_copublisher = stage_separator_with_copublisher
         @type_separator = type_separator
@@ -53,6 +55,7 @@ module Pubid
         @with_language_code = with_language_code
         @stage_format_long = stage_format_long
         @with_date = with_date
+        @annotated = annotated
       end
 
       # Get the appropriate stage separator based on whether there's a copublisher

data/lib/pubid/sae/identifier.rb

@@ -9,6 +9,29 @@ module Pubid
       rescue Parslet::ParseFailed => e
         raise "Failed to parse SAE identifier: #{input}\n#{e.message}"
       end
+
+      # Factory that builds a SAE identifier from a hash of primitives.
+      # SAE has only one identifier class ({Identifiers::Base}); `:type`
+      # is data (the document-type abbreviation: "J", "AS", "ARP", "AMS",
+      # "AIR", "MA") rather than a class-dispatch key.
+      def self.create(**opts)
+        Identifiers::Base.new(**coerce_create_attrs(opts))
+      end
+
+      def self.coerce_create_attrs(opts)
+        attrs = { publisher: (opts[:publisher] || "SAE").to_s }
+        if (v = opts[:type])
+          attrs[:type] = Pubid::Sae::Components::Type.new(abbr: v.to_s)
+        end
+        if (v = opts[:number])
+          attrs[:number] = Pubid::Components::Code.new(value: v.to_s)
+        end
+        if (v = opts[:year])
+          attrs[:date] = Pubid::Components::Date.new(year: v.to_s)
+        end
+        attrs
+      end
+      private_class_method :coerce_create_attrs
     end
   end
 end

data/lib/pubid/scheme.rb

@@ -131,6 +131,18 @@ module Pubid
       end
     end
 
+    # Locate a TypedStage by its unique per-typed-stage code
+    # @param code [String, Symbol] The code to find (e.g. :dtr, :fdisp)
+    # @return [TypedStage, nil] The matching TypedStage, or nil if not found
+    # @note Uses linear search for code lookup
+    def locate_typed_stage_by_code(code)
+      code_sym = code.to_sym
+
+      all_typed_stages.detect do |ts|
+        ts.code&.to_sym == code_sym
+      end
+    end
+
     # Locate a TypedStage by harmonized stage code
     # @param harmonized_code [String] The harmonized stage code to find (e.g., "00.00", "10.00")
     # @return [TypedStage, nil] The matching TypedStage, or nil if not found

data/lib/pubid/version.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: pubid
 version: !ruby/object:Gem::Version
-  version: 2.0.0.pre.alpha.1
+  version: 2.0.0.pre.alpha.2
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-05-21 00:00:00.000000000 Z
+date: 2026-06-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -267,6 +267,7 @@ files:
 - lib/pubid/components/code.rb
 - lib/pubid/components/date.rb
 - lib/pubid/components/edition.rb
+- lib/pubid/components/factory.rb
 - lib/pubid/components/language.rb
 - lib/pubid/components/locality.rb
 - lib/pubid/components/publisher.rb
@@ -545,6 +546,7 @@ files:
 - lib/pubid/nist/components/version.rb
 - lib/pubid/nist/components/volume.rb
 - lib/pubid/nist/configuration.rb
+- lib/pubid/nist/identifier.rb
 - lib/pubid/nist/identifiers.rb
 - lib/pubid/nist/identifiers/base.rb
 - lib/pubid/nist/identifiers/circular.rb
@@ -598,6 +600,7 @@ files:
 - lib/pubid/parsers/mr_string.rb
 - lib/pubid/plateau.rb
 - lib/pubid/plateau/builder.rb
+- lib/pubid/plateau/identifier.rb
 - lib/pubid/plateau/identifiers.rb
 - lib/pubid/plateau/identifiers/annex.rb
 - lib/pubid/plateau/identifiers/base.rb