toml-merge 2.0.0 → 7.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f9cb256fd16a085c6a1d5f568bbe2eef0bcbeaf4a9cbc3f7bce5637b5770bce
-  data.tar.gz: 4000f1e9f82713bb1016ab52fa96112ca917f2f371baefc2dabf2a29f0807013
+  metadata.gz: 3acee846936049e12d2a86754efa4883e926acb0a27ff50088ab4b0f07b2136d
+  data.tar.gz: ad65f5a29dc6ffa0c683c5dd88d53f52eb1c9cd2109a1d69643ab9a8157a2c66
 SHA512:
-  metadata.gz: b57d61b70484cc8099d2d7b8249c093b729718182ffb607cd4f1db59c8ca372b7ee26d4b64f92d7f359956e01b337f07498e396353373d998efefb921feba5a1
-  data.tar.gz: 0dce84d713ce68e1f5158fa3c2d883311741e7d28c4a7d93a17c9baa9e2356e8ecbc6d7be0aa1d3247712e287ae153d6170284b7132caa2de19e225b1d305b1e
+  metadata.gz: efcc0a2c04eed99bbcb29e13fb232812d3ce0f783214425b3e85fbc6c0a7eb265ce104459181b2615d4ca6503e02991fb8bf9cceac709cfd03b0384c5bc5d3e9
+  data.tar.gz: 903808d9d7df793cce2e67cb76c27ed8d04ec2e1248aae96a70362b973c1ebe26e1bb326d5a9c6333673a47e52f0c8b2c57f8487ea69d1b105a71b413adac9f3

data/lib/toml/merge/version.rb

@@ -2,11 +2,10 @@
 
 module Toml
   module Merge
-    # Version information for Toml::Merge
     module Version
-      # Current version of the toml-merge gem
-      VERSION = "2.0.0"
+      VERSION = "7.0.0"
     end
-    VERSION = Version::VERSION # traditional location
+
+    VERSION = Version::VERSION
   end
 end

data/lib/toml/merge.rb

@@ -1,108 +1,422 @@
 # frozen_string_literal: true
 
-# std libs
-require "set"
-
-# External gems
-# TreeHaver provides a unified cross-Ruby interface to tree-sitter.
-# It handles grammar discovery, backend selection, and Citrus fallback automatically
-# via parser_for(:toml). No manual registration needed.
+require "json"
 require "tree_haver"
-require "version_gem"
-
-# Shared merge infrastructure
-require "ast/merge"
-
-# This gem
-require_relative "merge/version"
-
-# Toml::Merge provides a TOML file smart merge system using tree-sitter AST analysis.
-# It intelligently merges template and destination TOML files by identifying matching
-# keys and resolving differences using structural signatures.
-#
-# @example Basic usage
-#   template = File.read("template.toml")
-#   destination = File.read("destination.toml")
-#   merger = Toml::Merge::SmartMerger.new(template, destination)
-#   result = merger.merge
-#
-# @example With debug information
-#   merger = Toml::Merge::SmartMerger.new(template, destination)
-#   debug_result = merger.merge_with_debug
-#   puts debug_result[:content]
-#   puts debug_result[:statistics]
+
 module Toml
-  # Smart merge system for TOML files using tree-sitter AST analysis.
-  # Provides intelligent merging by understanding TOML structure
-  # rather than treating files as plain text.
-  #
-  # @see SmartMerger Main entry point for merge operations
-  # @see FileAnalysis Analyzes TOML structure
-  # @see ConflictResolver Resolves content conflicts
   module Merge
-    # Base error class for Toml::Merge
-    # Inherits from Ast::Merge::Error for consistency across merge gems.
-    class Error < Ast::Merge::Error; end
-
-    # Raised when a TOML file has parsing errors.
-    # Inherits from Ast::Merge::ParseError for consistency across merge gems.
-    #
-    # @example Handling parse errors
-    #   begin
-    #     analysis = FileAnalysis.new(toml_content)
-    #   rescue ParseError => e
-    #     puts "TOML syntax error: #{e.message}"
-    #     e.errors.each { |error| puts "  #{error}" }
-    #   end
-    class ParseError < Ast::Merge::ParseError
-      # @param message [String, nil] Error message (auto-generated if nil)
-      # @param content [String, nil] The TOML source that failed to parse
-      # @param errors [Array] Parse errors from tree-sitter
-      def initialize(message = nil, content: nil, errors: [])
-        super(message, errors: errors, content: content)
+    PACKAGE_NAME = "toml-merge"
+    DESTINATION_WINS_ARRAY_POLICY = {
+      surface: "array",
+      name: "destination_wins_array"
+    }.freeze
+
+    class ParseError < StandardError; end
+
+    module_function
+
+    def toml_feature_profile
+      {
+        family: "toml",
+        supported_dialects: ["toml"],
+        supported_policies: [DESTINATION_WINS_ARRAY_POLICY]
+      }
+    end
+
+    def available_toml_backends
+      [TreeHaver::KREUZBERG_LANGUAGE_PACK_BACKEND]
+    end
+
+    def toml_backend_feature_profile(backend: nil)
+      resolved_backend = resolve_backend(backend)
+      return unsupported_feature_result("Unsupported TOML backend #{resolved_backend}.") unless resolved_backend == TreeHaver::KREUZBERG_LANGUAGE_PACK_BACKEND.id
+
+      toml_feature_profile.merge(
+        backend: TreeHaver::KREUZBERG_LANGUAGE_PACK_BACKEND.id,
+        backend_ref: TreeHaver::KREUZBERG_LANGUAGE_PACK_BACKEND.to_h
+      )
+    end
+
+    def toml_plan_context(backend: nil)
+      profile = toml_backend_feature_profile(backend: backend)
+      return profile if profile[:ok] == false
+
+      {
+        family_profile: toml_feature_profile,
+        feature_profile: {
+          backend: profile[:backend],
+          supports_dialects: false,
+          supported_policies: profile[:supported_policies]
+        }
+      }
+    end
+
+    def analyze_toml_source(source, dialect)
+      return unsupported_feature_result("Unsupported TOML dialect #{dialect}.") unless dialect == "toml"
+
+      parsed = parse_toml_document(source)
+      {
+        ok: true,
+        diagnostics: [],
+        analysis: {
+          kind: "toml",
+          dialect: "toml",
+          normalized_source: canonical_toml(parsed),
+          root_kind: "table",
+          owners: collect_toml_owners(parsed)
+        },
+        policies: []
+      }
+    rescue StandardError => e
+      parse_error_result(e.message)
+    end
+
+    def parse_toml(source, dialect, backend: nil)
+      return unsupported_feature_result("Unsupported TOML dialect #{dialect}.") unless dialect == "toml"
+
+      resolved_backend = resolve_backend(backend)
+      return unsupported_feature_result("Unsupported TOML backend #{resolved_backend}.") unless resolved_backend == TreeHaver::KREUZBERG_LANGUAGE_PACK_BACKEND.id
+
+      syntax_result = TreeHaver.parse_with_language_pack(
+        TreeHaver::ParserRequest.new(source: source, language: "toml", dialect: dialect)
+      )
+      return { ok: false, diagnostics: syntax_result[:diagnostics] } unless syntax_result[:ok]
+
+      analyze_toml_source(source, dialect)
+    end
+
+    def match_toml_owners(template, destination)
+      destination_paths = destination[:owners].to_h { |owner| [owner[:path], true] }
+      template_paths = template[:owners].to_h { |owner| [owner[:path], true] }
+
+      {
+        matched: template[:owners]
+          .filter { |owner| destination_paths[owner[:path]] }
+          .map { |owner| { template_path: owner[:path], destination_path: owner[:path] } },
+        unmatched_template: template[:owners].map { |owner| owner[:path] }.reject { |path| destination_paths[path] },
+        unmatched_destination: destination[:owners].map { |owner| owner[:path] }.reject { |path| template_paths[path] }
+      }
+    end
+
+    def merge_toml_with_parser(template_source, destination_source, dialect, &parser)
+      template = parser.call(template_source, dialect)
+      return { ok: false, diagnostics: template[:diagnostics], policies: [] } unless template[:ok]
+
+      destination = parser.call(destination_source, dialect)
+      unless destination[:ok]
+        return {
+          ok: false,
+          diagnostics: destination[:diagnostics].map do |diagnostic|
+            diagnostic[:category] == "parse_error" ? diagnostic.merge(category: "destination_parse_error") : diagnostic
+          end,
+          policies: []
+        }
       end
+
+      merged = merge_toml_tables(
+        parse_toml_document(template.dig(:analysis, :normalized_source)),
+        parse_toml_document(destination.dig(:analysis, :normalized_source))
+      )
+
+      {
+        ok: true,
+        diagnostics: [],
+        output: canonical_toml(merged),
+        policies: [DESTINATION_WINS_ARRAY_POLICY]
+      }
+    rescue StandardError => e
+      {
+        ok: false,
+        diagnostics: [{ severity: "error", category: "destination_parse_error", message: e.message }],
+        policies: []
+      }
     end
 
-    # Raised when the template file has syntax errors.
-    #
-    # @example Handling template parse errors
-    #   begin
-    #     merger = SmartMerger.new(template, destination)
-    #     result = merger.merge
-    #   rescue TemplateParseError => e
-    #     puts "Template syntax error: #{e.message}"
-    #     e.errors.each do |error|
-    #       puts "  #{error.message}"
-    #     end
-    #   end
-    class TemplateParseError < ParseError; end
-
-    # Raised when the destination file has syntax errors.
-    #
-    # @example Handling destination parse errors
-    #   begin
-    #     merger = SmartMerger.new(template, destination)
-    #     result = merger.merge
-    #   rescue DestinationParseError => e
-    #     puts "Destination syntax error: #{e.message}"
-    #     e.errors.each do |error|
-    #       puts "  #{error.message}"
-    #     end
-    #   end
-    class DestinationParseError < ParseError; end
-
-    autoload :DebugLogger, "toml/merge/debug_logger"
-    autoload :Emitter, "toml/merge/emitter"
-    autoload :FileAnalysis, "toml/merge/file_analysis"
-    autoload :MergeResult, "toml/merge/merge_result"
-    autoload :NodeTypeNormalizer, "toml/merge/node_type_normalizer"
-    autoload :NodeWrapper, "toml/merge/node_wrapper"
-    autoload :ConflictResolver, "toml/merge/conflict_resolver"
-    autoload :SmartMerger, "toml/merge/smart_merger"
-    autoload :TableMatchRefiner, "toml/merge/table_match_refiner"
-  end
-end
+    def merge_toml(template_source, destination_source, dialect, backend: nil)
+      resolved_backend = resolve_backend(backend)
+      return unsupported_feature_result("Unsupported TOML backend #{resolved_backend}.") unless resolved_backend == TreeHaver::KREUZBERG_LANGUAGE_PACK_BACKEND.id
+
+      merge_toml_with_parser(template_source, destination_source, dialect) do |source, parse_dialect|
+        parse_toml(source, parse_dialect, backend: resolved_backend)
+      end
+    end
+
+    def resolve_backend(backend)
+      backend.to_s.empty? ? TreeHaver::KREUZBERG_LANGUAGE_PACK_BACKEND.id : backend.to_s
+    end
+    private_class_method :resolve_backend
+
+    def normalize_toml_source(source)
+      source.gsub(/\r\n?/, "\n")
+    end
+    private_class_method :normalize_toml_source
+
+    def strip_toml_comment(line)
+      result = +""
+      in_string = false
+      escaped = false
+
+      line.each_char do |char|
+        if in_string
+          result << char
+          if escaped
+            escaped = false
+          elsif char == "\\"
+            escaped = true
+          elsif char == '"'
+            in_string = false
+          end
+          next
+        end
 
-Toml::Merge::Version.class_eval do
-  extend VersionGem::Basic
+        if char == '"'
+          in_string = true
+          result << char
+          next
+        end
+
+        break if char == "#"
+
+        result << char
+      end
+
+      raise ParseError, "Unterminated TOML string." if in_string
+
+      result.strip
+    end
+    private_class_method :strip_toml_comment
+
+    def split_outside_quotes(value, separator)
+      parts = []
+      current = +""
+      in_string = false
+      escaped = false
+      depth = 0
+
+      value.each_char do |char|
+        if in_string
+          current << char
+          if escaped
+            escaped = false
+          elsif char == "\\"
+            escaped = true
+          elsif char == '"'
+            in_string = false
+          end
+          next
+        end
+
+        case char
+        when '"'
+          in_string = true
+          current << char
+        when "["
+          depth += 1
+          current << char
+        when "]"
+          depth -= 1
+          current << char
+        else
+          if char == separator && depth.zero?
+            parts << current.strip
+            current = +""
+          else
+            current << char
+          end
+        end
+      end
+
+      raise ParseError, "Unterminated TOML string or array." if in_string || !depth.zero?
+
+      parts << current.strip
+      parts
+    end
+    private_class_method :split_outside_quotes
+
+    def parse_toml_key_path(value)
+      trimmed = value.strip
+      raise ParseError, "Missing TOML key path." if trimmed.empty?
+
+      parts = trimmed.split(".").map(&:strip)
+      raise ParseError, "Unsupported TOML key path #{trimmed}." unless parts.all? { |part| part.match?(/\A[A-Za-z0-9_-]+\z/) }
+
+      parts
+    end
+    private_class_method :parse_toml_key_path
+
+    def parse_toml_scalar_value(value)
+      case value
+      when /\A".*"\z/m
+        JSON.parse(value)
+      when "true"
+        true
+      when "false"
+        false
+      when /\A-?\d+\z/
+        value.to_i
+      when /\A-?\d+\.\d+\z/
+        value.to_f
+      else
+        raise ParseError, "Unsupported TOML value #{value}."
+      end
+    rescue JSON::ParserError
+      raise ParseError, "Invalid TOML string #{value}."
+    end
+    private_class_method :parse_toml_scalar_value
+
+    def parse_toml_value(value)
+      stripped = value.strip
+      if stripped.start_with?("[")
+        raise ParseError, "Invalid TOML array #{value}." unless stripped.end_with?("]")
+
+        inner = stripped[1..-2].strip
+        return [] if inner.empty?
+
+        split_outside_quotes(inner, ",").map { |entry| parse_toml_scalar_value(entry) }
+      else
+        parse_toml_scalar_value(stripped)
+      end
+    end
+    private_class_method :parse_toml_value
+
+    def ensure_toml_table(root, path)
+      current = root
+      path.each do |segment|
+        existing = current[segment]
+        if existing.nil?
+          current[segment] = {}
+          current = current[segment]
+        elsif existing.is_a?(Hash)
+          current = existing
+        else
+          raise ParseError, "TOML table path /#{path.join('/')} conflicts with a value."
+        end
+      end
+      current
+    end
+    private_class_method :ensure_toml_table
+
+    def assign_toml_value(root, path, value)
+      raise ParseError, "Missing TOML assignment path." if path.empty?
+
+      table = ensure_toml_table(root, path[0..-2])
+      key = path[-1]
+      existing = table[key]
+      raise ParseError, "TOML key /#{path.join('/')} conflicts with a table." if existing.is_a?(Hash)
+
+      table[key] = value
+    end
+    private_class_method :assign_toml_value
+
+    def parse_toml_document(source)
+      lines = normalize_toml_source(source).split("\n")
+      root = {}
+      current_table_path = []
+
+      lines.each do |raw_line|
+        line = strip_toml_comment(raw_line)
+        next if line.empty?
+
+        if line.start_with?("[")
+          raise ParseError, "Invalid TOML table header #{line}." unless line.end_with?("]")
+
+          current_table_path = parse_toml_key_path(line[1..-2])
+          ensure_toml_table(root, current_table_path)
+          next
+        end
+
+        parts = split_outside_quotes(line, "=")
+        raise ParseError, "Invalid TOML assignment #{line}." unless parts.length == 2
+
+        key_path = parse_toml_key_path(parts[0])
+        value = parse_toml_value(parts[1])
+        assign_toml_value(root, current_table_path + key_path, value)
+      end
+
+      root
+    end
+    private_class_method :parse_toml_document
+
+    def render_toml_scalar(value)
+      if value.is_a?(String)
+        JSON.generate(value)
+      elsif value == true || value == false
+        value ? "true" : "false"
+      else
+        value.to_s
+      end
+    end
+    private_class_method :render_toml_scalar
+
+    def render_toml_value(value)
+      return "[#{value.map { |item| render_toml_scalar(item) }.join(', ')}]" if value.is_a?(Array)
+
+      render_toml_scalar(value)
+    end
+    private_class_method :render_toml_value
+
+    def render_toml_table(table, path = [])
+      lines = []
+      keys = table.keys.sort
+      value_keys = keys.reject { |key| table[key].is_a?(Hash) }
+      table_keys = keys.select { |key| table[key].is_a?(Hash) }
+
+      lines << "[#{path.join('.')}]" unless path.empty?
+      value_keys.each do |key|
+        lines << "#{key} = #{render_toml_value(table[key])}"
+      end
+      table_keys.each do |key|
+        lines << "" unless lines.empty?
+        lines.concat(render_toml_table(table[key], path + [key]))
+      end
+      lines
+    end
+    private_class_method :render_toml_table
+
+    def canonical_toml(table)
+      "#{render_toml_table(table).join("\n")}\n"
+    end
+    private_class_method :canonical_toml
+
+    def collect_toml_owners(table, prefix = "")
+      table.keys.sort.flat_map do |key|
+        path = "#{prefix}/#{key}"
+        value = table[key]
+        if value.is_a?(Array)
+          [{ path: path, owner_kind: "key_value", match_key: key }] +
+            value.each_index.map { |index| { path: "#{path}/#{index}", owner_kind: "array_item" } }
+        elsif value.is_a?(Hash)
+          [{ path: path, owner_kind: "table", match_key: key }] + collect_toml_owners(value, path)
+        else
+          [{ path: path, owner_kind: "key_value", match_key: key }]
+        end
+      end
+    end
+    private_class_method :collect_toml_owners
+
+    def merge_toml_tables(template, destination)
+      (template.keys | destination.keys).sort.each_with_object({}) do |key, merged|
+        if !template.key?(key)
+          merged[key] = destination[key]
+        elsif !destination.key?(key)
+          merged[key] = template[key]
+        elsif template[key].is_a?(Hash) && destination[key].is_a?(Hash)
+          merged[key] = merge_toml_tables(template[key], destination[key])
+        else
+          merged[key] = destination[key]
+        end
+      end
+    end
+    private_class_method :merge_toml_tables
+
+    def parse_error_result(message)
+      { ok: false, diagnostics: [{ severity: "error", category: "parse_error", message: message }] }
+    end
+    private_class_method :parse_error_result
+
+    def unsupported_feature_result(message)
+      { ok: false, diagnostics: [{ severity: "error", category: "unsupported_feature", message: message }], policies: [] }
+    end
+    private_class_method :unsupported_feature_result
+  end
 end

data/lib/toml-merge.rb

@@ -1,4 +1,3 @@
-# For technical reasons, if we move to Zeitwerk, this cannot be require_relative.
-#   See: https://github.com/fxn/zeitwerk#for_gem_extension
-# Hook for other libraries to load this library (e.g. via bundler)
-require "toml/merge"
+# frozen_string_literal: true
+
+require_relative "toml/merge"