pubid 1.15.21 → 2.0.0.alpha.10

data/lib/pubid/bsi/identifiers/electronic_book.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # Electronic Publication (EP) identifier
+      class ElectronicBook < SingleIdentifier
+        def self.type
+          { key: :ep,
+            web: :electronic_book, title: "Electronic Publication", short: "EP" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/expert_commentary.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # Expert Commentary Identifier
+      # Wraps a base identifier with Expert Commentary suffix
+      # Three formats:
+      # 1. "Expert Commentary" (full form)
+      # 2. "ExComm" (abbreviated form)
+      # 3. "ExComm (Fire)" (with optional topic suffix)
+      class ExpertCommentary < SingleIdentifier
+        attribute :base, ::Pubid::Identifier, polymorphic: true
+        attribute :format, :string # "full", "abbr", "abbr_with_topic"
+        attribute :topic, :string # e.g., "Fire"
+
+        def publisher
+          base&.publisher
+        end
+
+        def number
+          base&.number
+        end
+
+        def year
+          base&.year
+        end
+
+        # Base document = the commented standard, fully peeled.
+        def base_document
+          base&.base_document || self
+        end
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/explanatory_supplement.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # ExplanatorySupplement represents BSI explanatory supplement documents
+      # Format: BS {number}-{part}:Explanatory Supplement:{year}
+      #
+      # Examples:
+      #   BS 5655-1:Explanatory Supplement:1981
+      class ExplanatorySupplement < SingleIdentifier
+        # TYPED_STAGES for explanatory supplement (published by default)
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pubexplanatorysupplement,
+            stage_code: :published,
+            type_code: :explanatory_supplement,
+            abbr: ["BS"],
+            name: "Explanatory Supplement",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          {
+            key: :explanatory_supplement,
+            title: "Explanatory Supplement",
+            short: "BS",
+          }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/flex.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # BSI Flex document identifier
+      class Flex < SingleIdentifier
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pubflex,
+            stage_code: :published,
+            type_code: :flex,
+            abbr: ["Flex", "BSI Flex"],
+            name: "BSI Flex",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :flex, title: "BSI Flex", short: "BSI Flex" }
+        end
+
+        # Base document = the Flex standard without its version (edition).
+        def base_document
+          exclude(:edition)
+        end
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/handbook.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # BSI Handbook
+      # Examples: "Handbook 17:1963", "HB 10146:1998"
+      class Handbook < SingleIdentifier
+        attribute :date, Bsi::Components::Date
+        attribute :original_abbr, :string # Preserve "Handbook" or "HB"
+
+        def self.type
+          {
+            short: "HB",
+            full: "Handbook",
+            names: ["Handbook", "HB"],
+          }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/index.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # BSI Index
+      # Examples: "BS 5000:Index:1981", "BS 185 Index:1964", "BS 5000 Index Issue 4:1980"
+      class Index < SingleIdentifier
+        attribute :issue_number, :string  # For "Index Issue N" format
+        attribute :index_format, :string  # Preserve ":Index" or " Index" separator
+
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :index,
+            stage_code: :published,
+            type_code: :index,
+            abbr: ["Index"],
+            name: "Index",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :index, title: "Index", short: "Index" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/method.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # BSI Method
+      # Examples:
+      # - Basic: "BS 2782-1:Method 131B:1983"
+      # - Range: "BS 2782-4:Methods 451F to 451J:1978"
+      # - And: "BS 2782-8:Methods 823A and 823B:1978"
+      class Method < SingleIdentifier
+        attribute :method_code, :string     # Main method code (e.g., "131B")
+        attribute :method_to, :string       # Second method code for "to" format (e.g., "451J")
+        attribute :method_and, :string      # Second method code for "and" format (e.g., "823B")
+        attribute :is_plural, :boolean      # Track singular vs plural ("Method" vs "Methods")
+
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pubmethod,
+            stage_code: :published,
+            type_code: :method,
+            abbr: ["Method", "Methods"],
+            name: "Method",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :method, title: "Method", short: "Method" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/national_annex.rb

@@ -0,0 +1,48 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # National Annex (NA) identifier
+      # Can have own supplements: "NA+A1:2012 to BASE"
+      class NationalAnnex < SingleIdentifier
+        attribute :na_supplements, ::Pubid::Identifier, polymorphic: true, collection: true # Supplements on the NA itself
+        attribute :base_doc, ::Pubid::Identifier, polymorphic: true # The identifier after "to"
+
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pubna,
+            stage_code: :published,
+            type_code: :na,
+            abbr: ["NA"],
+            name: "National Annex",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :na,
+            web: :national_annex, title: "National Annex", short: "NA" }
+        end
+
+        # Delegation methods to access wrapped base_doc attributes
+        def number
+          base_doc&.number || super
+        end
+
+        def date
+          base_doc&.date || super
+        end
+
+        def part
+          base_doc&.part || super
+        end
+
+        def subpart
+          base_doc&.subpart || super
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/practice_guide.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # BSI Practice Guide (PP - Published Practice)
+      # Examples: "PP 888:1982", "PP 7307:1986", "PP 7722:2006"
+      class PracticeGuide < SingleIdentifier
+        attribute :date, Bsi::Components::Date
+
+        def self.type
+          {
+            short: "PP",
+            full: "Published Practice",
+          }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/publicly_available_specification.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # Publicly Available Specification (PAS) identifier
+      class PubliclyAvailableSpecification < SingleIdentifier
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pubpas,
+            stage_code: :published,
+            type_code: :pas,
+            abbr: ["PAS"],
+            name: "Publicly Available Specification",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :pas,
+            web: :publicly_available_specification, title: "Publicly Available Specification", short: "PAS" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/published_document.rb

@@ -0,0 +1,27 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # Published Document (PD) identifier
+      class PublishedDocument < SingleIdentifier
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pubpd,
+            stage_code: :published,
+            type_code: :pd,
+            abbr: ["PD"],
+            name: "Published Document",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :pd,
+            web: :published_document, title: "Published Document", short: "PD" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/section.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # BSI Section
+      # Examples:
+      # - Colon format (DD): "DD 51:Section 0:1977"
+      # - Space format (BS): "BS 3224 Section B2:1970"
+      class Section < SingleIdentifier
+        attribute :section_id, :string # Section identifier (0-7 or B2, C1, D1, etc.)
+        attribute :section_format, :string # Preserve ":Section" or " Section" separator
+
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pubsection,
+            stage_code: :published,
+            type_code: :section,
+            abbr: ["Section"],
+            name: "Section",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :section, title: "Section", short: "Section" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/set.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+require "lutaml/model"
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # Set represents multiple standards published as a set
+      # Format: {identifier} + {identifier} [+ {identifier} ...]
+      # Each identifier is separated by " + " (space, plus, space)
+      #
+      # Examples:
+      #   BS ISO 20400 + BS ISO 44001+BS ISO 44002
+      #   BS ISO 9001+BS ISO 14001
+      class Set < SingleIdentifier
+        attribute :identifiers, ::Pubid::Identifier, collection: true, 
+                                                     polymorphic: true
+        attribute :separators, :string, collection: true # Should all be " + "
+
+        def <=>(other)
+          return nil unless other.is_a?(Set)
+
+          # Compare first identifier
+          identifiers.first <=> other.identifiers.first
+        end
+
+        # As for BundledIdentifier: a set holds no number of its own, so walk
+        # to the first member for the relaton-index key.
+        #
+        # NOTE the members are frequently a FOREIGN flavor (BS ISO ... holds
+        # Pubid::Iso identifiers), which `to_hash` still rejects — see the
+        # hand-off bsi-set-cross-flavor-type. `#root` is unaffected by that:
+        # it only reads the object, never serializes it.
+        def root
+          identifiers&.first ? identifiers.first.root : self
+        end
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/standalone_amendment.rb

@@ -0,0 +1,40 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # Standalone Amendment identifier (no base reference)
+      # Examples: "AMD 11015", "(AMD 10971)", "AMD Corrigendum 14716"
+      class StandaloneAmendment < SingleIdentifier
+        # The amendment number lives in the `number` inherited from
+        # SingleIdentifier — already a Bsi::Components::Code, exactly what the
+        # deleted `amendment_number` was, so nothing is retyped. It used to sit
+        # under the private name, leaving `number` nil and `root.number` "".
+        #
+        # A standalone amendment is its OWN document (there is no base standard
+        # to walk to — that is what "standalone" means), so it needs a real
+        # number rather than a #root override. `Identifiers::Amendment`, the
+        # attached kind, keeps its own `amendment_number` and is untouched:
+        # there the ordinal is a supplement ordinal, not the document number.
+        attribute :corrigendum, :boolean, default: false
+        attribute :parenthesized, :boolean, default: false
+
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :standalone_amendment,
+            stage_code: :published,
+            type_code: :amendment,
+            abbr: ["AMD"],
+            name: "Amendment",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :standalone_amendment, title: "Amendment", short: "AMD" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/supplement_document.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # Supplement Document Identifier
+      # Contains a base identifier plus supplement parameters
+      # Supports both forward and reverse formats:
+      # Forward: "BS 1000:Supplement No. 1:1972", "BS 1722-1 Supplement No. 1:1974"
+      # Reverse: "Supplement No. 1 (1970) to BS 1831:1969"
+      class SupplementDocument < SingleIdentifier
+        attribute :base, ::Pubid::Identifier, polymorphic: true
+        attribute :supplement_number, :string
+        attribute :supplement_year, :integer
+        attribute :supplement_type, :string, default: -> {
+          "No."
+        } # "No." or empty for "Supplement N"
+        attribute :reverse_format, :boolean, default: false # true for "Supplement No. N (YEAR) to BS..."
+        attribute :separator, :string, default: -> {
+          ":"
+        } # Separator before Supplement (":" or " ")
+
+        def publisher
+          base&.publisher
+        end
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/supplementary_index.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # SupplementaryIndex represents BSI supplementary index documents
+      # Format: BS {number} Supplementary Index:{year}
+      #
+      # Examples:
+      #   BS 185 Supplementary Index:1965
+      class SupplementaryIndex < SingleIdentifier
+        # TYPED_STAGES for supplementary index (published by default)
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pubsupplementaryindex,
+            stage_code: :published,
+            type_code: :supplementary_index,
+            abbr: ["BS"],
+            name: "Supplementary Index",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          {
+            key: :supplementary_index,
+            title: "Supplementary Index",
+            short: "BS",
+          }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/technical_specification.rb

@@ -0,0 +1,34 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # TechnicalSpecification represents BSI technical specifications
+      # Format: TS {number}:{year}
+      #
+      # Examples:
+      #   TS 3:1993
+      #   TS 1:1998
+      #   TS 1:1995
+      class TechnicalSpecification < SingleIdentifier
+        # TYPED_STAGES for technical specifications (published by default)
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pubts,
+            stage_code: :published,
+            type_code: :ts,
+            abbr: ["TS"],
+            name: "Technical Specification",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :ts,
+            web: :technical_specification, title: "Technical Specification", short: "TS" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/test_method.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # TestMethod represents BSI test method identifiers
+      # Format: BS {number}:{test_series}:{test_id}:{year}
+      #
+      # Examples:
+      #   BS 1006:B01C:LFS1:1982
+      #   BS 1006:B01C:LFS2:1985
+      #   BS 1006:B01C:LFS4:1990
+      class TestMethod < SingleIdentifier
+        attribute :test_series, :string     # Test series code (e.g., "B01C")
+        attribute :test_id, :string         # Test ID (e.g., "LFS1")
+
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pubtestmethod,
+            stage_code: :published,
+            type_code: :test_method,
+            abbr: ["BS"],
+            name: "Test Method",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :test_method, title: "Test Method", short: "BS" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers/value_added_publication.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      # Value-Added Publication Identifier
+      # Wraps base identifier with format suffix (PDF, TC, BOOK)
+      # Similar to IEC VapIdentifier and BSI ExpertCommentary
+      #
+      # Examples:
+      #   PD 5500:2018+A3:2020 PDF
+      #   PAS 96:2017 - TC
+      #   PP 7722:2006 BOOK
+      class ValueAddedPublication < SingleIdentifier
+        attribute :base, ::Pubid::Identifier, polymorphic: true
+        attribute :format, :string, values: ["PDF", "TC", "BOOK"]
+
+        # Delegate common attributes to base
+        def publisher
+          base&.publisher
+        end
+
+        def number
+          base&.number
+        end
+
+        def year
+          base&.year
+        end
+
+        def date
+          base&.date
+        end
+      end
+    end
+  end
+end

data/lib/pubid/bsi/identifiers.rb

@@ -0,0 +1,51 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Bsi
+    module Identifiers
+      autoload :AddendumDocument, "#{__dir__}/identifiers/addendum_document"
+      autoload :AdoptedEuropeanNorm,
+               "#{__dir__}/identifiers/adopted_european_norm"
+      autoload :AdoptedInternationalStandard,
+               "#{__dir__}/identifiers/adopted_international_standard"
+      autoload :AerospaceStandard, "#{__dir__}/identifiers/aerospace_standard"
+      autoload :Amendment, "#{__dir__}/identifiers/amendment"
+      autoload :BritishIndustrialPractice,
+               "#{__dir__}/identifiers/british_industrial_practice"
+      autoload :BritishStandard, "#{__dir__}/identifiers/british_standard"
+      autoload :BundledIdentifier, "#{__dir__}/identifiers/bundled_identifier"
+      autoload :CommitteeDocument, "#{__dir__}/identifiers/committee_document"
+      autoload :ConsolidatedIdentifier,
+               "#{__dir__}/identifiers/consolidated_identifier"
+      autoload :Corrigendum, "#{__dir__}/identifiers/corrigendum"
+      autoload :DetailedSpecification,
+               "#{__dir__}/identifiers/detailed_specification"
+      autoload :Disc, "#{__dir__}/identifiers/disc"
+      autoload :DraftDocument, "#{__dir__}/identifiers/draft_document"
+      autoload :ElectronicBook, "#{__dir__}/identifiers/electronic_book"
+      autoload :ExplanatorySupplement,
+               "#{__dir__}/identifiers/explanatory_supplement"
+      autoload :ExpertCommentary, "#{__dir__}/identifiers/expert_commentary"
+      autoload :Flex, "#{__dir__}/identifiers/flex"
+      autoload :Handbook, "#{__dir__}/identifiers/handbook"
+      autoload :Index, "#{__dir__}/identifiers/index"
+      autoload :Method, "#{__dir__}/identifiers/method"
+      autoload :NationalAnnex, "#{__dir__}/identifiers/national_annex"
+      autoload :PracticeGuide, "#{__dir__}/identifiers/practice_guide"
+      autoload :PublishedDocument, "#{__dir__}/identifiers/published_document"
+      autoload :PubliclyAvailableSpecification,
+               "#{__dir__}/identifiers/publicly_available_specification"
+      autoload :Section, "#{__dir__}/identifiers/section"
+      autoload :Set, "#{__dir__}/identifiers/set"
+      autoload :StandaloneAmendment,
+               "#{__dir__}/identifiers/standalone_amendment"
+      autoload :SupplementDocument, "#{__dir__}/identifiers/supplement_document"
+      autoload :SupplementaryIndex, "#{__dir__}/identifiers/supplementary_index"
+      autoload :TechnicalSpecification,
+               "#{__dir__}/identifiers/technical_specification"
+      autoload :TestMethod, "#{__dir__}/identifiers/test_method"
+      autoload :ValueAddedPublication,
+               "#{__dir__}/identifiers/value_added_publication"
+    end
+  end
+end