relaton 3.0.6 → 3.0.8

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

@@ -0,0 +1,248 @@
+# frozen_string_literal: true
+
+module Relaton
+  module Render
+    module Iso690
+      # A citation template as declared in a style instance: literal text
+      # interleaved with {{slot}} placeholders resolved against the ISO 690
+      # data element inventory. A leading literal attaches to the first
+      # slot, and a literal between two slots to the preceding one, so an
+      # absent field never orphans punctuation around it. The last rendered
+      # slot gives up its trailing literal in favour of the template
+      # terminator, appended once when any field rendered and the output
+      # does not already end with it.
+      class Template
+        SLOT = /\{\{\s*([\w-]+)\s*\}\}/.freeze
+
+        Field = Struct.new(:present?, :text)
+
+        def initialize(source)
+          @chunks = []
+          @terminator = ""
+          scan(source.to_s)
+        end
+
+        # The short cite renders the reference with the first-biblio
+        # marker appended to its first component: isodoc's styled
+        # references (eref2linkshort) split there (the 1.x
+        # fmt-first-biblio-delim)
+        def evaluate_short(fields, delim)
+          present = present_indices(fields)
+          return "" if present.empty?
+
+          # The split marker follows the leading run of present slots
+          # (the 1.x first SEGMENT: "{{creator}}{{role}}" splits after
+          # the role), before the first literal that follows it
+          lead_slots = []
+          @chunks.each_with_index do |(kind, _value), i|
+            break if kind != :slot || !present.include?(i)
+
+            lead_slots << i
+          end
+          split_at = lead_slots.last ? lead_slots.last + 1 : nil
+
+          out = +""
+          @chunks.each_with_index do |(kind, value), i|
+            text =
+              case kind
+              when :slot
+                field = fields[normalise(value)]
+                next unless field&.present?
+
+                field.text
+              else
+                next unless bridged?(i, present)
+
+                value
+              end
+            if split_at == i
+              out << fieldless(lead_slots, fields) if false
+              out << delim.to_s
+              split_at = nil
+            end
+            out << text unless text.nil?
+          end
+          out << delim.to_s if split_at == @chunks.length
+          terminate(out).rstrip
+        end
+
+        # 1.x segment-join semantics: present elements joined with the
+        # template's separators — a literal renders only when it
+        # separates (a run of absent elements between) two present
+        # elements; leading and trailing literals drop with the
+        # elements they would have attached to
+        def evaluate(fields)
+          present = present_indices(fields)
+          return "" if present.empty?
+
+          out = +"".dup
+          # Parenthetical groups balance on the template's literal
+          # parens alone: data text (a series run "(N.S.)", a host
+          # creator's closing paren) carries parens of its own that
+          # are no part of the template's group structure
+          paren_balance = 0
+          @chunks.each_with_index do |(kind, value), i|
+            if kind == :slot
+              field = fields[normalise(value)]
+              out << field.text if field&.present?
+            elsif value.to_s.match?(/\A[）)]/)
+              # Symmetric close: with no pending open the close-paren
+              # drops, and any trailing punctuation bridges normally
+              closes = value.to_s[/\A[）)]+/]
+              emitted = [paren_balance, closes.size].min
+              if emitted.positive?
+                out << closes[0, emitted] +
+                  value.to_s[closes.size..].to_s
+                paren_balance -= emitted
+              else
+                rest = value.to_s.sub(/\A[）)]+/, "")
+                # the trailing separator of a dropped group bridges as
+                # though the group were never there
+                if !rest.empty? && present.any? { |j| j > i } &&
+                   group_gap?(i, present)
+                  out << rest
+                end
+              end
+            elsif value.to_s.match?(/[（(]\z/)
+              # A literal opening a parenthetical group ("({{series}})",
+              # "。（{{series}}）") attaches its paren to the slot it
+              # opens — the pair drops with an absent element, while
+              # any leading punctuation bridges normally
+              lead, paren = value.to_s.match(/\A(.*)([（(])\z/).captures
+              out << lead if bridged_text?(i, lead, present)
+              if present.include?(i + 1)
+                out << paren
+                paren_balance += 1
+              end
+            elsif bridged?(i, present) ||
+                  (value.include?("<") && present.any? { |j| j < i })
+              # markup attaches to the element it closes
+              out << value
+            elsif close_pending_paren?(out, value)
+              out << value
+            end
+          end
+          terminate(out).rstrip
+        end
+
+        private
+
+        def scan(source)
+          rest = source
+          while (slot = SLOT.match(rest))
+            @chunks << [:text, rest[0...slot.begin(0)]] if
+              slot.begin(0).positive?
+            @chunks << [:slot, slot[1]]
+            rest = rest[slot.end(0)..]
+          end
+          @terminator = rest
+        end
+
+        def present_indices(fields)
+          @chunks.each_index.select do |i|
+            kind, value = @chunks[i]
+            next false unless kind == :slot
+
+            field = fields[normalise(value)]
+            !field.nil? && field.present?
+          end
+        end
+
+        # The texts between this close and the last present slot are
+        # all parenthetical-group parts (each dropped or partial)
+        def group_gap?(index, present)
+          left = present.select { |i| i < index }.max
+          @chunks[(left + 1)...index].all? do |(_, text)|
+            text.to_s.match?(/\A[）)]|[（(]\z/)
+          end
+        end
+
+        # The leading punctuation of a paren-opening literal bridges
+        # per the segment-join rule (a bare paren has no lead)
+        def bridged_text?(index, lead, present)
+          return true if lead.empty?
+
+          first_slot = @chunks.index { |(kind, _)| kind == :slot }
+          return present.include?(first_slot) if index < first_slot
+
+          left = present.select { |i| i < index }.max
+          left && present.any? { |i| i > index } &&
+            !@chunks[(left + 1)...index].any? do |(kind, _)|
+              kind == :text
+            end
+        end
+
+        # A literal is the trailing separator of the element that
+        # precedes it: it renders when that element renders and a
+        # later element renders, and it is the FIRST literal of its
+        # gap (the 1.x segment join — absent elements between two
+        # present ones leave the single separator that follows the
+        # earlier present element; an absent slot directly before a
+        # present one, as "{{date}}{{disambiguator}}, {{access}}",
+        # does not swallow it). A leading literal (no slot precedes
+        # it) attaches to the first slot, emitting only when that
+        # slot is present.
+        def bridged?(index, present)
+          first_slot = @chunks.index { |(kind, _)| kind == :slot }
+          return present.include?(first_slot) if index < first_slot
+
+          left = present.select { |i| i < index }.max
+          left && present.any? { |i| i > index } &&
+            !@chunks[(left + 1)...index].any? do |(kind, _)|
+              kind == :text
+            end
+        end
+
+        # A template's paired literal ("({{production}})") closes even
+        # when nothing follows the present element it wraps. Fullwidth
+        # parens (CJK) pair the same way
+        def close_pending_paren?(out, value)
+          return false unless value.start_with?(")", "\uFF09")
+
+          opens = out.count("(") + out.count("\uFF08")
+          closes = out.count(")") + out.count("\uFF09")
+          opens > closes
+        end
+
+        def terminate(body)
+          # 1.x punctuation cleanup: a sentence period before a spaced
+          # comma yields to the comma (", 2013" over ". , 2013"; an
+          # initials period before a comma ("P.,") stands, being
+          # unspaced), and stacked separators around absent elements
+          # collapse into one (". : ." into ". "); an empty pair left
+          # by an absent element drops
+          body = body.gsub(/:\s*\.\s*/, ": ")
+          body = body.gsub(/\.\s+,/, ",")
+          body = body.gsub(/(?:[.,:;]\s+)+[.,:;]/, ". ")
+          body = body.gsub(/\.\s*\./, ". ")
+          body = body.gsub(/:\s*\.\s*/, ": ")
+          body = body.gsub(/\(\s*\)/, "")
+          body = body.gsub(/ +/, " ").gsub(" ,", ",")
+          terminator = unbalanced_close(body, @terminator)
+          return body if terminator.strip.empty?
+          if terminator !~ /[<\w]/ && body.rstrip.end_with?(terminator.strip)
+            return body
+          end
+
+          "#{body}#{terminator}"
+        end
+
+        # The terminator's closing parens stand only when the body
+        # opened them (their "(" died with an absent element)
+        def unbalanced_close(body, terminator)
+          return terminator unless terminator.start_with?(")")
+
+          open = body.count("(") - body.count(")")
+          return terminator.sub(/\A\)+/) { |closes| closes[0, open] } if
+            open.positive?
+
+          terminator.sub(/\A\)+/, "")
+        end
+
+        def normalise(slot)
+          slot.to_s.delete("_").downcase
+        end
+      end
+    end
+  end
+end

data/lib/relaton/render/iso690.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+
+module Relaton
+  module Render
+    # Citation rendering per the ISO 690 architecture: a style instance
+    # 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"
+      autoload :Fields, "relaton/render/iso690/fields"
+      autoload :I18n, "relaton/render/iso690/i18n"
+      autoload :IndexRenderer, "relaton/render/iso690/index_renderer"
+      autoload :IdentifierKinds, "relaton/render/iso690/identifier_kinds"
+      autoload :Kinds, "relaton/render/iso690/kinds"
+      autoload :Renderer, "relaton/render/iso690/renderer"
+        autoload :Rules, "relaton/render/iso690/rules"
+      autoload :Style, "relaton/render/iso690/style"
+      autoload :CslImport, "relaton/render/iso690/csl_import"
+      autoload :Template, "relaton/render/iso690/template"
+    end
+  end
+end

data/lib/relaton/render/version.rb

@@ -0,0 +1,5 @@
+module Relaton
+  module Render
+    VERSION = "3.0.0".freeze
+  end
+end

data/lib/relaton/un/CLAUDE.md

@@ -88,4 +88,4 @@ Tests are round-trip serialization tests: load a fixture, serialize to XML/YAML,
 - **relaton-bib** (~> 2.0.0-alpha.1) — base bibliographic model with LutaML-Model integration
 - **faraday** — HTTP client
 - **ruby-jing** (dev) — RelaxNG schema validation in tests
-- **equivalent-xml** (dev) — XML comparison in tests
+- **canon** (dev) — XML comparison in tests

data/lib/relaton/version.rb

@@ -1,3 +1,3 @@
 module Relaton
-  VERSION = "3.0.6".freeze
+  VERSION = "3.0.8".freeze
 end

data/lib/relaton-cli.rb

@@ -0,0 +1,17 @@
+# The per-flavor `autoload` lines live in `relaton.rb`, not `relaton/db`.
+# `index_name_for`/`pubid_class_for` resolve `Relaton::<Flavor>::INDEXFILE`, so
+# without the umbrella every `--pubid-flavor` fails with "no relaton flavor".
+# Declaring autoloads is cheap: no flavor is loaded until it is referenced.
+require "relaton"
+require "relaton/db"
+
+module Relaton
+  module Cli
+  end
+end
+
+require_relative "relaton/bibcollection"
+require_relative "relaton/bibdata"
+require_relative "relaton/element_finder"
+require_relative "relaton/cli/yaml_convertor"
+require_relative "relaton/cli"

data/lib/relaton-render.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+require "relaton/render/version"
+require "relaton/render/iso690"
+
+module Relaton
+  module Render
+    # A bibliographic item whose style template resolves to nothing: the
+    # single-item API raises, the batch API skips
+    class Unrenderable < StandardError; end
+
+  end
+end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: relaton
 version: !ruby/object:Gem::Version
-  version: 3.0.6
+  version: 3.0.8
 platform: ruby
 authors:
 - Ribose Inc.
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2026-11-02 00:00:00.000000000 Z
+date: 2026-11-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -318,6 +318,76 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.3.2
+- !ruby/object:Gem::Dependency
+  name: htmlentities
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: twitter_cldr
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: liquid
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: thor
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: thor-hollaback
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 - !ruby/object:Gem::Dependency
   name: mechanize
   requirement: !ruby/object:Gem::Requirement
@@ -408,28 +478,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.121
+        version: 1.3.129
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.3.121
+        version: 1.3.129
 - !ruby/object:Gem::Dependency
   name: pubid
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.4
+        version: 2.0.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 2.0.4
+        version: 2.0.5
 - !ruby/object:Gem::Dependency
   name: yeptris
   requirement: !ruby/object:Gem::Requirement
@@ -444,20 +514,6 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: 0.6.51
-- !ruby/object:Gem::Dependency
-  name: relaton-render
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: rfcxml
   requirement: !ruby/object:Gem::Requirement
@@ -511,17 +567,21 @@ description: |
   The CLI (relaton-cli) is a separate gem.
 email:
 - open.source@ribose.com
-executables: []
+executables:
+- relaton
 extensions: []
 extra_rdoc_files: []
 files:
 - LICENSE
 - README.adoc
 - bin/console
+- bin/relaton
 - bin/rspec
 - bin/setup
 - data/equivalence/adoption-chains.yaml
+- lib/relaton-cli.rb
 - lib/relaton-core.rb
+- lib/relaton-render.rb
 - lib/relaton.rb
 - lib/relaton/3gpp.rb
 - lib/relaton/3gpp/CLAUDE.md
@@ -630,6 +690,8 @@ files:
 - lib/relaton/bib/sanitizer.rb
 - lib/relaton/bib/util.rb
 - lib/relaton/bib/versions.json
+- lib/relaton/bibcollection.rb
+- lib/relaton/bibdata.rb
 - lib/relaton/bipm.rb
 - lib/relaton/bipm/CLAUDE.md
 - lib/relaton/bipm/README.adoc
@@ -737,6 +799,60 @@ files:
 - lib/relaton/cie/processor.rb
 - lib/relaton/cie/scrapper.rb
 - lib/relaton/cie/util.rb
+- lib/relaton/cli.rb
+- lib/relaton/cli/base_convertor.rb
+- lib/relaton/cli/command.rb
+- lib/relaton/cli/data_fetcher.rb
+- lib/relaton/cli/frontend/dist/404.html
+- lib/relaton/cli/frontend/dist/app.iife.js
+- lib/relaton/cli/frontend/dist/style.css
+- lib/relaton/cli/frontend/index.html
+- lib/relaton/cli/frontend/package-lock.json
+- lib/relaton/cli/frontend/package.json
+- lib/relaton/cli/frontend/public/404.html
+- lib/relaton/cli/frontend/src/App.test.ts
+- lib/relaton/cli/frontend/src/App.vue
+- lib/relaton/cli/frontend/src/app.ts
+- lib/relaton/cli/frontend/src/components/DocumentDetail.test.ts
+- lib/relaton/cli/frontend/src/components/DocumentDetail.vue
+- lib/relaton/cli/frontend/src/components/DocumentRow.vue
+- lib/relaton/cli/frontend/src/components/Icon.test.ts
+- lib/relaton/cli/frontend/src/components/Icon.vue
+- lib/relaton/cli/frontend/src/components/Pagination.vue
+- lib/relaton/cli/frontend/src/dev/main.ts
+- lib/relaton/cli/frontend/src/dev/sample-data.json
+- lib/relaton/cli/frontend/src/lib/filter.test.ts
+- lib/relaton/cli/frontend/src/lib/filter.ts
+- lib/relaton/cli/frontend/src/lib/hydrate.test.ts
+- lib/relaton/cli/frontend/src/lib/hydrate.ts
+- lib/relaton/cli/frontend/src/lib/shards.test.ts
+- lib/relaton/cli/frontend/src/lib/shards.ts
+- lib/relaton/cli/frontend/src/lib/types.ts
+- lib/relaton/cli/frontend/src/lib/url.test.ts
+- lib/relaton/cli/frontend/src/lib/url.ts
+- lib/relaton/cli/frontend/src/shims-vue.d.ts
+- lib/relaton/cli/frontend/src/styles/index.css
+- lib/relaton/cli/frontend/src/test/fetch.ts
+- lib/relaton/cli/frontend/tsconfig.json
+- lib/relaton/cli/frontend/vite.config.ts
+- lib/relaton/cli/frontend/vitest.config.ts
+- lib/relaton/cli/frontend_assets.rb
+- lib/relaton/cli/full_text_search.rb
+- lib/relaton/cli/i18n.yaml
+- lib/relaton/cli/index_item_normalizer.rb
+- lib/relaton/cli/index_site_generator.rb
+- lib/relaton/cli/relaton_file.rb
+- lib/relaton/cli/subcommand_collection.rb
+- lib/relaton/cli/subcommand_db.rb
+- lib/relaton/cli/templates/_document.liquid
+- lib/relaton/cli/templates/_index.liquid
+- lib/relaton/cli/templates/index-style.css
+- lib/relaton/cli/templates/index/page.liquid
+- lib/relaton/cli/util.rb
+- lib/relaton/cli/version.rb
+- lib/relaton/cli/xml_convertor.rb
+- lib/relaton/cli/xml_to_html_renderer.rb
+- lib/relaton/cli/yaml_convertor.rb
 - lib/relaton/cloud.rb
 - lib/relaton/core.rb
 - lib/relaton/core/CLAUDE.md
@@ -799,6 +915,7 @@ files:
 - lib/relaton/ecma/processor.rb
 - lib/relaton/ecma/standard_parser.rb
 - lib/relaton/ecma/util.rb
+- lib/relaton/element_finder.rb
 - lib/relaton/equivalence.rb
 - lib/relaton/etsi.rb
 - lib/relaton/etsi/CLAUDE.md
@@ -1223,6 +1340,60 @@ files:
 - lib/relaton/plateau/processor.rb
 - lib/relaton/plateau/technical_report_parser.rb
 - lib/relaton/plateau/util.rb
+- lib/relaton/render/general.rb
+- lib/relaton/render/iso690.rb
+- lib/relaton/render/iso690/csl_import.rb
+- lib/relaton/render/iso690/element.rb
+- lib/relaton/render/iso690/elements.rb
+- lib/relaton/render/iso690/elements/access.rb
+- lib/relaton/render/iso690/elements/authorizer.rb
+- lib/relaton/render/iso690/elements/citeid.rb
+- lib/relaton/render/iso690/elements/component_part.rb
+- lib/relaton/render/iso690/elements/creator.rb
+- lib/relaton/render/iso690/elements/edition.rb
+- lib/relaton/render/iso690/elements/extent.rb
+- lib/relaton/render/iso690/elements/identifier.rb
+- lib/relaton/render/iso690/elements/location.rb
+- lib/relaton/render/iso690/elements/medium.rb
+- lib/relaton/render/iso690/elements/numeration.rb
+- lib/relaton/render/iso690/elements/production.rb
+- lib/relaton/render/iso690/elements/pub_date.rb
+- lib/relaton/render/iso690/elements/series.rb
+- lib/relaton/render/iso690/elements/size.rb
+- lib/relaton/render/iso690/elements/status.rb
+- lib/relaton/render/iso690/elements/stddoc.rb
+- lib/relaton/render/iso690/elements/title.rb
+- lib/relaton/render/iso690/elements/updated.rb
+- lib/relaton/render/iso690/fields.rb
+- lib/relaton/render/iso690/i18n.rb
+- lib/relaton/render/iso690/i18n/en.yml
+- lib/relaton/render/iso690/i18n/fr.yml
+- lib/relaton/render/iso690/i18n/ja.yml
+- lib/relaton/render/iso690/identifier_kinds.rb
+- lib/relaton/render/iso690/index_renderer.rb
+- lib/relaton/render/iso690/kinds.rb
+- lib/relaton/render/iso690/renderer.rb
+- lib/relaton/render/iso690/rules.rb
+- lib/relaton/render/iso690/rules/bipm.rb
+- lib/relaton/render/iso690/rules/jis.rb
+- lib/relaton/render/iso690/rules/nist.rb
+- lib/relaton/render/iso690/style.rb
+- lib/relaton/render/iso690/style/locale.rb
+- lib/relaton/render/iso690/style/name_form.rb
+- lib/relaton/render/iso690/style/scheme.rb
+- lib/relaton/render/iso690/style/sort_rule.rb
+- lib/relaton/render/iso690/style/template_map.rb
+- lib/relaton/render/iso690/style/type_template.rb
+- lib/relaton/render/iso690/styles/apa.yml
+- lib/relaton/render/iso690/styles/author-date.yml
+- lib/relaton/render/iso690/styles/chicago.yml
+- lib/relaton/render/iso690/styles/ieee-sa.yml
+- lib/relaton/render/iso690/styles/jis-en.yml
+- lib/relaton/render/iso690/styles/jis-ja.yml
+- lib/relaton/render/iso690/styles/lncs.yml
+- lib/relaton/render/iso690/styles/mla.yml
+- lib/relaton/render/iso690/template.rb
+- lib/relaton/render/version.rb
 - lib/relaton/sdo.rb
 - lib/relaton/sdo/CLAUDE.md
 - lib/relaton/sdo/config.rb