relaton-render 1.4.0.pre.alpha.1 → 1.4.0.pre.alpha.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d8d567a54651ce75901eeb043077a17b840e9a9d9d00e95d3afcde793bfc6795
-  data.tar.gz: 3b6019abeef370c32db6e855238b4500c1be2a785eb726eb6577b6e454588d4b
+  metadata.gz: f944c1a5f1a26e1ec5c4d1cceae37ea7420257034c87b31eaa6ea0c8e46269e6
+  data.tar.gz: 5bcd504fbf58c890f778d4f492d70bbabe9b8a974837c838752fbf367129c67c
 SHA512:
-  metadata.gz: c75141af4b07759f64a7c12ed491509ddfc2cd88595ea6484587a0bb753e333b633906188bf03e765912a06c4fd6e7a1812e0a886486c3c1b3f8435488f376b6
-  data.tar.gz: 2d8b040b077067944c76dd2149af2272bb536811fe228c940d91e5e79c0b42de0f3c4360b9586f0c6a369507eddf01e96246f334b169e4c1e2c5ea1df3507ee5
+  metadata.gz: 0032e8464f6d1731e4aef47a69dfca0e646df0d6c52d85dfa16b72194357f5a5b01f513ffe65498b08e5b6ae4f3e83ef8f6819c6e87e6d1b5a361787a1ce7495
+  data.tar.gz: ab3af5ef2028428f712fca4727fe126cf56cccfb33fac0d523190536b237616d0207d2363aa2f422fc48e2c3fa78e4a9922ade6f7ad6df6c5738e1be8dc02098

data/lib/relaton/render/general.rb

@@ -0,0 +1,124 @@
+# frozen_string_literal: true
+
+module Relaton
+  module Render
+    # Compatibility entry point (relaton-render#90).
+    #
+    # The v2 engine replaced the liquid/config/i18n machinery with the
+    # template evaluator over CitationStyle instances
+    # (Relaton::Render::Iso690). isodoc main's render-isodoc subclasses
+    # this constant, so it must exist for all-git-main stacks to boot.
+    # This facade delegates rendering to the v2 engine; the retired
+    # options (config:, template overrides in liquid syntax) are ignored
+    # with one warning — migrate to a CitationStyle instance, which
+    # expresses everything the old config.yml did (see the citation
+    # module in relaton-models).
+    class General
+      # The eref `style=` vocabulary metanorma-standoc validates against
+      # (cleanup/xref.rb reads citetemplate.template_raw's keys) — the
+      # 1.x default config's top-level citation styles.
+      CITE_STYLES = %i[
+        author_date author_date_br author date reference_tag title
+        title_reference_tag short
+      ].freeze
+
+      CiteTemplate = Struct.new(:template_raw)
+
+      def initialize(options = {})
+        @lang = options[:language] || options[:lang] || "en"
+        @renderer = Iso690::Renderer.new(
+          lang: @lang,
+          script: options[:script] || "Latn",
+          labels: options[:i18nhash] || {},
+        )
+        warn_general_config if options[:config]
+      end
+
+      def render(model, **opts)
+        @renderer.render(model, **opts)
+      end
+
+      def citation(model, **opts)
+        @renderer.citation(model, **opts)
+      end
+
+      # isodoc's references rendering: renderings[id][:formattedref]
+      # feeds the <formattedref> of every bibitem (isodoc
+      # presentation_function/refs.rb).
+      def render_all(bib, type: "author-date")
+        items = facade_bibitems(bib) or return nil
+        items.each_with_object({}).with_index do |(item, m), i|
+          ref = @renderer.render(item)
+          m[item.id] = {
+            id: item.id, ord: i, formattedref: ref,
+            citation: {
+              full: ref,
+              default: item.docidentifier.first&.content.to_s,
+              short: @renderer.citation(item),
+            },
+          }
+        end
+      end
+
+      # isodoc's pref_ref_code_parse reads
+      # data[:authoritative_identifier] to build biblio-tag identifiers
+      # (presentation_function/docid.rb). Returns [data, self] as the
+      # 1.x signature did.
+      def parse(doc)
+        [{ authoritative_identifier: facade_docids(doc) }, self]
+      end
+
+      def citetemplate
+        CiteTemplate.new(CITE_STYLES.to_h { |s| [s, ""] })
+      end
+
+      private
+
+      # 1.x accepted a <references> XML string (isodoc strips namespaces
+      # before building it) or a ready array of models.
+      def facade_bibitems(bib)
+        case bib
+        when Array then bib
+        when String
+          require "moxml"
+          root = Moxml.parse(bib).root
+          return nil unless root&.name == "references"
+
+          klass = facade_bibitem_class
+          root.xpath("./bibitem").filter_map { |b| klass.from_xml(b.to_xml) }
+        end
+      end
+
+      def facade_bibitem_class
+        Relaton::Bib::Bibitem
+      rescue NameError
+        Relaton::Bib::Item
+      end
+
+      def facade_docids(doc)
+        node = doc
+        unless node.respond_to?(:xpath)
+          require "moxml"
+          node = Moxml.parse(doc.to_s).root
+        end
+        return [] unless node
+
+        node.xpath("./docidentifier").map(&:text)
+      end
+
+      def warn_general_config
+        return if General.config_warned
+
+        General.config_warned = true
+        warn "relaton-render: Relaton::Render::General is a compatibility " \
+             "facade over the v2 engine; the liquid config option is " \
+             "retired and ignored. Author a CitationStyle instance " \
+             "(relaton-models citation module) for custom rendering."
+      end
+
+      class << self
+        attr_accessor :config_warned
+      end
+    end
+  end
+end

data/lib/relaton/render/iso690/i18n.rb

@@ -36,16 +36,41 @@ module Relaton
           self
         end
 
+        # Runtime label overrides (a caller's i18n hash): the pack's label
+        # names win as the key mapping; unknown keys are ignored.
+        def overlay_hash!(hash)
+          known = %w[
+            edition series_no report_no available_from in and oxford_comma
+            ed eds date_range others no_date no_author at
+          ]
+          hash.each do |key, value|
+            labels[key.to_s] = value if known.include?(key.to_s) && !value.nil?
+          end
+          self
+        end
+
         class << self
           def load(lang = "en")
             code = lang.to_s.empty? ? "en" : lang
             path = File.join(__dir__, "i18n", "#{code}.yml")
             unless File.file?(path)
-              raise ArgumentError, "no i18n declarations for language #{code}"
+              # 1.x carried declarations for every locale isodoc uses; the
+              # v2 packs are per-style data. Unknown languages fall back to
+              # the English pack rather than killing the whole conversion.
+              fallback_warn(code)
+              path = File.join(__dir__, "i18n", "en.yml")
+              raise ArgumentError, "no i18n declarations for language #{code}" unless File.file?(path)
             end
 
             from_yaml(File.read(path))
           end
+
+          def fallback_warn(code)
+            (@fallback_warned ||= {})[code] and return
+            @fallback_warned[code] = true
+            warn "relaton-render: no i18n declarations for language " \
+                 "#{code}; falling back to en"
+          end
         end
       end
     end

data/lib/relaton/render/iso690/renderer.rb

@@ -24,9 +24,11 @@ module Relaton
           end
         end
 
-        def initialize(style: DEFAULT_STYLE, lang: "en", script: "Latn")
+        def initialize(style: DEFAULT_STYLE, lang: "en", script: "Latn",
+                       labels: {})
           @style = Style.load(style)
           @i18n = I18n.load(lang).overlay!(@style.scheme.locale)
+          @i18n.overlay_hash!(labels) unless labels.empty?
           @script = script
         end
 

data/lib/relaton/render/iso690/style.rb

@@ -1,5 +1,7 @@
 # frozen_string_literal: true
 
+require "lutaml/model"
+
 module Relaton
   module Render
     module Iso690

data/lib/relaton/render/iso690.rb

@@ -6,6 +6,10 @@ module Relaton
     # places the inventory's data elements (clause 7) in each resource
     # kind's order (clause 8); the engine is a template evaluator over a
     # field resolver and holds no styles, no vocabularies, no i18n.
+    # The v1 compatibility facade (relaton-render#90): isodoc's
+    # render-isodoc subclasses Relaton::Render::General.
+    autoload :General, "relaton/render/general"
+
     module Iso690
       autoload :Element, "relaton/render/iso690/element"
       autoload :Elements, "relaton/render/iso690/elements"

data/lib/relaton/render/version.rb

@@ -1,5 +1,5 @@
 module Relaton
   module Render
-    VERSION = "1.4.0.pre.alpha.1".freeze
+    VERSION = "1.4.0.pre.alpha.3".freeze
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton-render
 version: !ruby/object:Gem::Version
-  version: 1.4.0.pre.alpha.1
+  version: 1.4.0.pre.alpha.3
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-10-01 00:00:00.000000000 Z
+date: 2026-10-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: lutaml-model
@@ -54,6 +54,7 @@ files:
 - lib/isodoc-yaml/i18n-zh-Hant.yaml
 - lib/isodoc/i18n.rb
 - lib/relaton-render.rb
+- lib/relaton/render/general.rb
 - lib/relaton/render/iso690.rb
 - lib/relaton/render/iso690/element.rb
 - lib/relaton/render/iso690/elements.rb