pubid 1.15.21 → 2.0.0.alpha.10

data/lib/pubid/iec/identifiers/operational_document.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # Operational Document identifier class
+      # Single Responsibility: Represents IEC OD documents
+      class OperationalDocument < Base
+        # Operational Documents have OD as type abbreviation
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :od,
+            stage_code: :published,
+            type_code: :od,
+            abbr: ["OD"],
+            name: "Operational Document",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :od,
+            web: :operational_document, title: "Operational Document", short: "OD" }
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,88 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # Publicly Available Specification identifier class
+      # Single Responsibility: Represents IEC PAS documents
+      class PubliclyAvailableSpecification < Base
+        # Convert v1 hash-based TYPED_STAGES to v2 object-based
+        # From gems/pubid-iec/lib/pubid/iec/identifier/publicly_available_specification.rb
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pwi_pas,
+            stage_code: :pwi,
+            type_code: :pas,
+            abbr: ["PWI PAS"],
+            name: "Preliminary Work Item Publicly Available Specification",
+            harmonized_stages: %w[00.00 00.20 00.60 00.98 00.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :np_pas,
+            stage_code: :np,
+            type_code: :pas,
+            abbr: ["NP PAS"],
+            name: "New Proposal Publicly Available Specification",
+            harmonized_stages: %w[10.00 10.20 10.60 10.92 10.98],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :anw_pas,
+            stage_code: :anw,
+            type_code: :pas,
+            abbr: ["ANW PAS"],
+            name: "Approved New Work Item Publicly Available Specification",
+            harmonized_stages: %w[10.99 20.00],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :wd_pas,
+            stage_code: :wd,
+            type_code: :pas,
+            abbr: ["WD PAS"],
+            name: "Working Draft Publicly Available Specification",
+            harmonized_stages: %w[20.20 20.60 20.98 20.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :cdpas,
+            stage_code: :cd,
+            type_code: :pas,
+            abbr: ["CDPAS"],
+            name: "Committee Draft Publicly Available Specification",
+            harmonized_stages: %w[30.00 30.20 30.60 30.92 30.98 30.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :dpas,
+            stage_code: :draft,
+            type_code: :pas,
+            abbr: ["DPAS"],
+            name: "Draft Publicly Available Specification",
+            harmonized_stages: %w[50.00 50.20 50.60 50.92 50.98 50.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :pas,
+            stage_code: :published,
+            type_code: :pas,
+            abbr: ["PAS"],
+            name: "Publicly Available Specification",
+            harmonized_stages: %w[60.00 60.60 90.20 90.60 90.92 90.93 90.99
+                                  95.20 95.60 95.92 95.99],
+          ),
+        ].freeze
+
+        # Project stages specific to PAS
+        PROJECT_STAGES = {
+          PRVDPAS: {
+            abbr: "PRVDPAS",
+            name: "Preparation of RVDPAS",
+            harmonized_stages: %w[50.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/iec/identifiers/sheet_identifier.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # Sheet Identifier
+      # Single Responsibility: Wraps another identifier with sheet number and year
+      # Example: "IEC 60695-2-1/1:1994" = Sheet 1 of IEC 60695-2-1 from 1994
+      class SheetIdentifier < Identifier
+        attribute :base, Identifier, polymorphic: true
+        attribute :sheet_number, :string
+        attribute :year, :string, default: -> {}
+
+        # Common fields are delegated to base, so serialize the
+        # wrapped identifier under "base" plus the sheet number/year; suppress
+        # the delegated common maps (they live inside "base").
+        include Pubid::Iec::DelegatedFieldSuppression
+
+        key_value do
+          map "base", with: { to: :base_to_kv, from: :base_from_kv }
+          map "sheet_number", to: :sheet_number, render_default: false
+          map "sheet_year", to: :year, render_default: false
+        end
+
+        def base_to_kv(model, doc)
+          base = model.base
+          return unless base
+
+          doc.add_child(Lutaml::KeyValue::DataModel::Element.new("base",
+                                                                 base.to_hash))
+        end
+
+        def base_from_kv(model, value)
+          model.base = ::Pubid::Iec::Identifier.from_hash(value) if value
+        end
+
+        # Delegate common attributes to base
+        def publisher
+          base&.publisher
+        end
+
+        def copublishers
+          base&.copublishers
+        end
+
+        def code
+          base&.code
+        end
+
+        def number
+          base&.number
+        end
+
+        def date
+          base&.date
+        end
+
+        def stage
+          base&.stage
+        end
+
+        def typed_stage
+          base&.typed_stage
+        end
+      end
+    end
+  end
+end

data/lib/pubid/iec/identifiers/societal_technology_trend_report.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # Societal Technology Trend Report identifier class
+      # Single Responsibility: Represents IEC STTR documents
+      class SocietalTechnologyTrendReport < Base
+        # Societal Technology Trend Reports have full phrase as type abbreviation
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :sttr,
+            stage_code: :published,
+            type_code: :sttr,
+            abbr: ["Trend Report"],
+            name: "Societal and Technology Trend Report",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :sttr,
+            web: :societal_technology_trend_report, title: "Societal and Technology Trend Report",
+            short: "Trend Report" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/iec/identifiers/systems_reference_document.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # Systems Reference Document identifier class
+      # Single Responsibility: Represents IEC SRD documents
+      class SystemsReferenceDocument < Base
+        # Systems Reference Documents have SRD as type abbreviation
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :srd,
+            stage_code: :published,
+            type_code: :srd,
+            abbr: ["SRD"],
+            name: "Systems Reference Document",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :srd,
+            web: :systems_reference_document, title: "Systems Reference Document", short: "SRD" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/iec/identifiers/technical_group.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # Technical Group identifier — identifies a committee rather than a
+      # publication. Covers:
+      #
+      #   IEC TC 1             (Technical Committee)
+      #   IEC PC 118           (Project Committee)
+      #   ISO/IEC JTC 1        (Joint Technical Committee)
+      #   ISO/IEC JPC 2        (Joint Project Committee)
+      #   ISO/IEC JTC 1/SC 7   (Joint TC with Subcommittee)
+      #   IEC SC 100A          (Subcommittee with letter suffix)
+      #   CIS/A                (CISPR Subcommittee, bare form)
+      #   CISPR                (CISPR Committee, bare form)
+      class TechnicalGroup < Base
+        attribute :technical_committee, :string
+        attribute :subcommittee, :string
+
+        TYPED_STAGES = [].freeze
+
+        def self.type
+          { key: :tg,
+            web: :technical_group, title: "Technical Group", short: "TG" }
+        end
+      end
+    end
+  end
+end

data/lib/pubid/iec/identifiers/technical_report.rb

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # Technical Report identifier class
+      # Single Responsibility: Represents IEC Technical Report documents
+      class TechnicalReport < Base
+        # Convert v1 hash-based TYPED_STAGES to v2 object-based
+        # From gems/pubid-iec/lib/pubid/iec/identifier/technical_report.rb
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pwi_tr,
+            stage_code: :pwi,
+            type_code: :tr,
+            abbr: ["PWI TR"],
+            name: "Preliminary Work Item Technical Report",
+            harmonized_stages: %w[00.00 00.20 00.60 00.98 00.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :np_tr,
+            stage_code: :np,
+            type_code: :tr,
+            abbr: ["NP TR"],
+            name: "New Proposal Technical Report",
+            harmonized_stages: %w[10.00 10.20 10.60 10.92 10.98],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :anw_tr,
+            stage_code: :anw,
+            type_code: :tr,
+            abbr: ["ANW TR"],
+            name: "Approved New Work Item Technical Report",
+            harmonized_stages: %w[10.99 20.00],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :wd_tr,
+            stage_code: :wd,
+            type_code: :tr,
+            abbr: ["WD TR"],
+            name: "Working Draft Technical Report",
+            harmonized_stages: %w[20.20 20.60 20.98 20.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :cd_tr,
+            stage_code: :cd,
+            type_code: :tr,
+            abbr: ["CD TR"],
+            name: "Committee Draft Technical Report",
+            harmonized_stages: %w[30.00 30.20 30.60 30.92 30.98 30.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :dtr,
+            stage_code: :draft,
+            type_code: :tr,
+            abbr: %w[DTR ADTR CDTR DTRM NDTR DTSM DTRM],
+            name: "Draft Technical Report",
+            harmonized_stages: %w[50.00 50.20 50.60 50.92 50.98 50.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :tr,
+            stage_code: :published,
+            type_code: :tr,
+            abbr: ["TR"],
+            name: "Technical Report",
+            harmonized_stages: %w[60.00 60.60 90.20 90.60 90.92 90.93 90.99
+                                  95.20 95.60 95.92 95.99],
+          ),
+        ].freeze
+
+        # Project stages specific to Technical Reports
+        # These are IEC-specific workflow stages
+        PROJECT_STAGES = {
+          adtr: {
+            abbr: "ADTR",
+            name: "Approved for DTR",
+            harmonized_stages: %w[40.99],
+          },
+          cdtr: {
+            abbr: "CDTR",
+            name: "Draft circulated as DTR",
+            harmonized_stages: %w[50.20],
+          },
+          dtrm: {
+            abbr: "DTRM",
+            name: "Rejected DTR to be discussed at meeting",
+            harmonized_stages: %w[50.92],
+          },
+          ndtr: {
+            abbr: "NDTR",
+            name: "DTR rejected",
+            harmonized_stages: %w[50.92],
+          },
+          prvdtr: {
+            abbr: "PRVDTR",
+            name: "Preparation of RVDTR",
+            harmonized_stages: %w[50.60],
+          },
+          tdtr: {
+            abbr: "TDTR",
+            name: "Translation of DTR",
+            harmonized_stages: %w[50.00],
+          },
+        }.freeze
+
+        def self.type
+          { key: :tr,
+            web: :technical_report, title: "Technical Report", short: "TR" }
+        end
+
+      end
+    end
+  end
+end

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

@@ -0,0 +1,114 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # Technical Specification identifier class
+      # Single Responsibility: Represents IEC Technical Specification documents
+      class TechnicalSpecification < Base
+        # Convert v1 hash-based TYPED_STAGES to v2 object-based
+        # From gems/pubid-iec/lib/pubid/iec/identifier/technical_specification.rb
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :pwi_ts,
+            stage_code: :pwi,
+            type_code: :ts,
+            abbr: ["PWI TS"],
+            name: "Preliminary Work Item Technical Specification",
+            harmonized_stages: %w[00.00 00.20 00.60 00.98 00.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :np_ts,
+            stage_code: :np,
+            type_code: :ts,
+            abbr: ["NP TS"],
+            name: "New Proposal Technical Specification",
+            harmonized_stages: %w[10.00 10.20 10.60 10.92 10.98],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :anw_ts,
+            stage_code: :anw,
+            type_code: :ts,
+            abbr: ["ANW TS"],
+            name: "Approved New Work Item Technical Specification",
+            harmonized_stages: %w[10.99 20.00],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :wd_ts,
+            stage_code: :wd,
+            type_code: :ts,
+            abbr: ["WD TS"],
+            name: "Working Draft Technical Specification",
+            harmonized_stages: %w[20.20 20.60 20.98 20.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :cd_ts,
+            stage_code: :cd,
+            type_code: :ts,
+            abbr: ["CD TS"],
+            name: "Committee Draft Technical Specification",
+            harmonized_stages: %w[30.00 30.20 30.60 30.92 30.98 30.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :dts,
+            stage_code: :draft,
+            type_code: :ts,
+            abbr: %w[DTS ADTS CDTS NDTS],
+            name: "Draft Technical Specification",
+            harmonized_stages: %w[50.00 50.20 50.60 50.92 50.98 50.99],
+          ),
+          Pubid::Components::TypedStage.new(
+            code: :ts,
+            stage_code: :published,
+            type_code: :ts,
+            abbr: ["TS"],
+            name: "Technical Specification",
+            harmonized_stages: %w[60.00 60.60 90.20 90.60 90.92 90.93 90.99
+                                  95.20 95.60 95.92 95.99],
+          ),
+        ].freeze
+
+        # Project stages specific to Technical Specifications
+        # These are IEC-specific workflow stages
+        PROJECT_STAGES = {
+          adts: {
+            abbr: "ADTS",
+            name: "Approved for DTS",
+            harmonized_stages: %w[40.99],
+          },
+          cdts: {
+            abbr: "CDTS",
+            name: "Draft circulated as DTS",
+            harmonized_stages: %w[50.20],
+          },
+          dtsm: {
+            abbr: "DTSM",
+            name: "Rejected DTS to be discussed at meeting",
+            harmonized_stages: %w[50.92],
+          },
+          ndts: {
+            abbr: "NDTS",
+            name: "DTS rejected",
+            harmonized_stages: %w[50.92],
+          },
+          prvdts: {
+            abbr: "PRVDTS",
+            name: "Preparation of RVDTS",
+            harmonized_stages: %w[50.60],
+          },
+          tdts: {
+            abbr: "TDTS",
+            name: "Translation of DTS",
+            harmonized_stages: %w[50.00],
+          },
+        }.freeze
+
+        def self.type
+          { key: :ts,
+            web: :technical_specification, title: "Technical Specification", short: "TS" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/iec/identifiers/technology_report.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # Technology Report identifier class
+      # Single Responsibility: Represents IEC Technology Report documents
+      class TechnologyReport < Base
+        # Technology Reports have full phrase as type abbreviation
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :tec,
+            stage_code: :published,
+            type_code: :tec,
+            abbr: ["Technology Report"],
+            name: "Technology Report",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :tec, title: "Technology Report", short: "Technology Report" }
+        end
+
+      end
+    end
+  end
+end

data/lib/pubid/iec/identifiers/test_report_form.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # Test Report Form identifier class
+      # Single Responsibility: Represents IEC TRF documents
+      # Can embed CISPR identifiers for IECEE TRF format
+      class TestReportForm < Base
+        # TRF can embed a CISPR identifier (MODEL-DRIVEN)
+        attribute :cispr_identifier, Identifier, polymorphic: true, default: -> {
+        }
+
+        # TRF has type abbreviation for parsing
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :trf,
+            stage_code: :published,
+            type_code: :trf,
+            abbr: ["TRF"],
+            name: "Test Report Form",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :trf,
+            web: :test_report_form, title: "Test Report Form", short: "TRF" }
+        end
+
+        # TRF uses special rendering via the Renderer
+      end
+    end
+  end
+end

data/lib/pubid/iec/identifiers/vap_identifier.rb

@@ -0,0 +1,76 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # VAP (Version/Compilation) Identifier
+      # Single Responsibility: Wraps another identifier with VAP type suffix
+      # Examples: "IEC 61666:2010+AMD1:2021 CSV"
+      class VapIdentifier < Identifier
+        attribute :base, Identifier, polymorphic: true
+        # One or more VAP codes (e.g. ["CSV"] or ["EXV", "CMV"]). Plain strings.
+        attribute :vap, :string, collection: true
+        attribute :edition, ::Pubid::Components::Edition, default: -> {}
+
+        # number/date/publisher/stage are delegated to base, so
+        # serialize the wrapped identifier under "base" plus the vap array; the
+        # common fields live inside "base", not at the top level.
+        include Pubid::Iec::DelegatedFieldSuppression
+
+        key_value do
+          map "base", with: { to: :base_to_kv, from: :base_from_kv }
+          map "vap", to: :vap, render_default: false
+        end
+
+        def base_to_kv(model, doc)
+          base = model.base
+          return unless base
+
+          doc.add_child(Lutaml::KeyValue::DataModel::Element.new("base",
+                                                                 base.to_hash))
+        end
+
+        def base_from_kv(model, value)
+          model.base = ::Pubid::Iec::Identifier.from_hash(value) if value
+        end
+
+        # VAP types mapping
+        TYPE_MAP = {
+          "CSV" => "Consolidated version (with Supplements)",
+          "CMV" => "Compiled Maintenance Version",
+          "RLV" => "Redline Version (shows changes)",
+          "SER" => "Serial version",
+        }.freeze
+
+        # Delegate common attributes to base
+        def publisher
+          base&.publisher
+        end
+
+        def copublishers
+          base&.copublishers
+        end
+
+        def code
+          base&.code
+        end
+
+        def number
+          base&.number
+        end
+
+        def date
+          base&.date
+        end
+
+        def stage
+          base&.stage
+        end
+
+        def typed_stage
+          base&.typed_stage
+        end
+      end
+    end
+  end
+end

data/lib/pubid/iec/identifiers/white_paper.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+module Pubid
+  module Iec
+    module Identifiers
+      # White Paper identifier class
+      # Single Responsibility: Represents IEC White Paper documents
+      class WhitePaper < Base
+        # White Papers have full phrase as type abbreviation
+        TYPED_STAGES = [
+          Pubid::Components::TypedStage.new(
+            code: :wp,
+            stage_code: :published,
+            type_code: :wp,
+            abbr: ["White Paper"],
+            name: "White Paper",
+            harmonized_stages: %w[60.00 60.60],
+          ),
+        ].freeze
+
+        def self.type
+          { key: :wp,
+            web: :white_paper, title: "White Paper", short: "White Paper" }
+        end
+
+      end
+    end
+  end
+end