metanorma-core 0.2.3 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 41c7086b0f760b06a87c99ce115f66d31c1a8e30a6f43a182e1ed81a076b0ee6
-  data.tar.gz: a55d956d5122b77c0078b9d48adb4c4c3b6c97b1c7638498a8a9d31d342b799b
+  metadata.gz: 68e4e30c0ecd25f66ab9f39d7132b23d05f3266a5afba3a6e67f91916329385c
+  data.tar.gz: 3d9d4072b81250ec95cb81d7630eeaaf1115338ba24469ee62a58d25bbfe8910
 SHA512:
-  metadata.gz: c37685805cfcff21fe4bb18e2a17661242c36a7605aa257736875c5735870e875fcfeb399f3769c25cd8ec4515a68561f8bcc8a503b970c805fe04251e2c2f6f
-  data.tar.gz: 4ce50e2bba70f304654640489d89a8d3e9fe45b2e42c3b34f634985b8d79db23bdb5f9e2f2da15bda5fdd6da9b0089b344657e9cbc131ce26d80a0011662ac82
+  metadata.gz: 002dd0efbf7c11b30d665b62f377fac848f3636448728ee01012062b332c5e33bec62523f2b6ff194f2c6651efcec93ec24ad33edfeeb11212be9e00fb1b3e90
+  data.tar.gz: e2ebc0042409579e2f17312a96b6f8c77a8247235d243500d4f888282738aaf83bda659dfa6a77ab93010fd4675ed1230c426cc50696070e8a1fba740c30f66d

data/README.adoc

@@ -11,3 +11,5 @@ image:https://img.shields.io/github/commits-since/metanorma/metanorma-core/lates
 
 This is a core repository for plugin dependencies of Metanorma, allowing metanorma-standoc and metanorma to share code without circular dependencies.
 
+
+<!-- canary: automerge stub verification, revert not needed -->

data/lib/metanorma/core/flavor.rb

@@ -0,0 +1,89 @@
+# frozen_string_literal: true
+
+module Metanorma
+  module Core
+    # One entry in the flavor/taste table — the single source of truth
+    # for flavor identity across the ecosystem.
+    #
+    # A FLAVOR entry (base_flavor nil): a document model family — model
+    # root, processor, per-format renderers, pubid module, gem name.
+    # A TASTE entry (base_flavor set): a config-only variant of a flavor
+    # — no model of its own; it carries the publisher discriminator,
+    # branding directory, and doctype map, and inherits everything else
+    # through its base chain.
+    #
+    # renderers values: a renderer class, or a Proc resolver taking
+    # (document, **options) and returning a class — flavor-owned variant
+    # selection (publisher/profile/doctype). Returning nil falls through
+    # to the next matching entry.
+    class Flavor
+      attr_reader :name, :base_flavor, :gem, :model_root, :processor,
+                  :renderers, :pubid_module, :branding_dir,
+                  :publisher_abbr, :doctype_map, :semantic_input
+
+      def initialize(name:, base_flavor: nil, gem: nil, model_root: nil,
+                     processor: nil, renderers: {}, pubid_module: nil,
+                     branding_dir: nil, publisher_abbr: nil, doctype_map: {},
+                     semantic_input: false)
+        @name = name&.to_sym
+        @base_flavor = base_flavor&.to_sym
+        @gem = gem || "metanorma-#{name}"
+        @model_root = model_root
+        @processor = processor
+        @renderers = renderers
+        @pubid_module = pubid_module
+        @branding_dir = branding_dir
+        @publisher_abbr = publisher_abbr
+        @doctype_map = doctype_map
+        @semantic_input = semantic_input
+      end
+
+      def taste? = !!base_flavor
+
+      def renderer_for(format, document, **options)
+        entry = renderers[format]
+        return nil unless entry
+
+        entry.is_a?(Proc) ? entry.call(document, **options) : entry
+      end
+
+      def matches?(document_class)
+        return false unless document_class.is_a?(Class)
+
+        root = model_root_class
+        return false unless root
+
+        !!(document_class <= root)
+      end
+
+      def model_root_class
+        return @model_root_class if @model_root_class
+
+        # Never cache a miss: the flavor gem may load after the first
+        # lookup (lazy string roots resolve once the owning gem is
+        # required), and a cached nil would poison every later walk.
+        klass = if model_root.is_a?(Class)
+                  model_root
+                elsif model_root && Object.const_defined?(model_root)
+                  Object.const_get(model_root)
+                end
+        @model_root_class = klass
+        klass
+      end
+
+      def pubid_module_const
+        return nil unless pubid_module
+
+        begin
+          require "pubid"
+        rescue LoadError
+          return nil
+        end
+        Object.const_get(pubid_module.to_s)
+      rescue NameError
+        raise ArgumentError,
+              "Flavor #{name.inspect}: pubid module #{pubid_module} could "               "not be resolved — fix the flavor's registration"
+      end
+    end
+  end
+end

data/lib/metanorma/core/flavor_loader.rb

@@ -27,6 +27,12 @@ module Metanorma
       #   taste alias matched).
       def taste2flavor(stdtype)
         stdtype = stdtype.to_sym
+        entry = Flavors.find(stdtype)
+        return entry.base_flavor if entry&.taste?
+
+        # Transitional: taste entries land in the table with
+        # metanorma-taste's restructure PR; until then fall back to
+        # TasteRegister.aliases. Removed in this branch's final commit.
         tastes = Metanorma::TasteRegister.instance.aliases
         tastes[stdtype] and stdtype = tastes[stdtype].to_sym
         stdtype

data/lib/metanorma/core/flavor_registry.rb

@@ -0,0 +1,56 @@
+# frozen_string_literal: true
+
+module Metanorma
+  module Core
+    # The process-wide flavor/taste table. Registered most-specific-last;
+    # resolution walks most-specific-first so flavor gems (loaded after
+    # the harness defaults) win, and taste entries fall through to their
+    # base chain by yielding nil.
+    class FlavorRegistry
+      include Enumerable
+
+      def initialize
+        @flavors = []
+      end
+
+      def register(flavor)
+        @flavors << flavor
+        self
+      end
+
+      def each(&) = @flavors.each(&)
+
+      def find_by_name(name)
+        @flavors.reverse_each.find { |f| f.name == name.to_sym }
+      end
+
+      def flavor_for(document)
+        @flavors.reverse_each.find { |f| f.matches?(document.class) }
+      end
+
+      # Renderer class for (document, format): walk matching entries
+      # most-specific-first; a taste without its own renderer for the
+      # format yields nil and falls through to the base flavor entry.
+      def renderer_for(format, document, **options)
+        @flavors.reverse_each.each do |flavor|
+          next unless flavor.matches?(document.class)
+
+          renderer = flavor.renderer_for(format, document, **options)
+          return renderer if renderer
+        end
+        nil
+      end
+
+      # Canonical FLAVOR entry for a stdtype/taste name: follows the
+      # base_flavor chain so compile loads the base flavor's gem and
+      # processor while the taste supplies config.
+      def canonical(name)
+        entry = find_by_name(name)
+        return nil unless entry
+
+        entry = find_by_name(entry.base_flavor) while entry&.base_flavor
+        entry
+      end
+    end
+  end
+end

data/lib/metanorma/core/flavors.rb

@@ -0,0 +1,63 @@
+# frozen_string_literal: true
+
+module Metanorma
+  module Core
+    # The composition-layer API over the flavor/taste table. Replaces
+    # the former scattered mechanisms: Registry-only processor dispatch,
+    # FlavorLoader.taste2flavor, CLI hand-merged dictionaries, and the
+    # renderer registries the harness once carried.
+    module Flavors
+      class << self
+        def table
+          @table ||= FlavorRegistry.new
+        end
+
+        def register(flavor)
+          table.register(flavor)
+        end
+
+        # Compile-time: canonical flavor entry for a stdtype name
+        # (taste chains resolved), loading its gem if needed.
+        def resolve(type)
+          canonical = table.canonical(type)
+          return nil unless canonical
+
+          unless backends.include?(canonical.name)
+            require canonical.gem
+          end
+          canonical
+        end
+
+        # Render-time: renderer class for (document, format).
+        def renderer_for(document, format:, **options)
+          table.renderer_for(format, document, **options)
+        end
+
+        def flavor_for(document)
+          table.flavor_for(document)
+        end
+
+        def find(name)
+          table.find_by_name(name)
+        end
+
+        # Tastes of a given base flavor (for dictionaries/projections).
+        def tastes_of(base)
+          table.select { |f| f.taste? && f.base_flavor == base.to_sym }
+        end
+
+        def available_tastes
+          table.select(&:taste?).map(&:name)
+        end
+
+        private
+
+        def backends
+          Metanorma::Registry.instance.supported_backends
+        rescue NameError
+          []
+        end
+      end
+    end
+  end
+end

data/lib/metanorma/core/version.rb

@@ -1,5 +1,5 @@
 module Metanorma
   module Core
-    VERSION = "0.2.3".freeze
+    VERSION = "0.2.4".freeze
   end
 end

data/lib/metanorma-core.rb

@@ -8,6 +8,9 @@ require "metanorma/input"
 require "metanorma/processor/processor"
 require "metanorma/registry/registry"
 require "metanorma/asciidoctor_extensions"
+require "metanorma/core/flavor"
+require "metanorma/core/flavor_registry"
+require "metanorma/core/flavors"
 require "metanorma/core/flavor_loader"
 require "metanorma/core/isodoc"
 require "metanorma/core/boilerplate"

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: metanorma-core
 version: !ruby/object:Gem::Version
-  version: 0.2.3
+  version: 0.2.4
 platform: ruby
 authors:
 - Ribose Inc.
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-09-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: asciidoctor
@@ -169,7 +170,10 @@ files:
 - lib/metanorma/asciidoctor_extensions/glob_include_processor.rb
 - lib/metanorma/config/config.rb
 - lib/metanorma/core/boilerplate.rb
+- lib/metanorma/core/flavor.rb
 - lib/metanorma/core/flavor_loader.rb
+- lib/metanorma/core/flavor_registry.rb
+- lib/metanorma/core/flavors.rb
 - lib/metanorma/core/isodoc.rb
 - lib/metanorma/core/version.rb
 - lib/metanorma/input.rb
@@ -184,6 +188,7 @@ homepage: https://github.com/metanorma/metanorma-core
 licenses:
 - BSD-2-Clause
 metadata: {}
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -198,7 +203,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.16
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: Metanorma Core
 test_files: []