kettle-dev 1.1.60 → 1.2.1

data/sig/kettle/dev/prism_utils.rbs

@@ -0,0 +1,56 @@
+# TypeProf 0.21.11
+
+module Kettle
+  module Dev
+    # Shared utilities for working with Prism AST nodes
+    module PrismUtils
+      # Parse Ruby source code and return Prism parse result with comments
+      def self.parse_with_comments: (String source) -> Prism::ParseResult
+
+      # Extract statements from a Prism body node
+      def self.extract_statements: (Prism::Node? body_node) -> Array[Prism::Node]
+
+      # Generate a unique key for a statement node to identify equivalent statements
+      def self.statement_key: (
+        Prism::Node node,
+        ?tracked_methods: Array[Symbol]
+      ) -> [Symbol, String?]?
+
+      # Extract literal value from string or symbol nodes
+      def self.extract_literal_value: (Prism::Node? node) -> (String | Symbol)?
+
+      # Extract qualified constant name from a constant node
+      def self.extract_const_name: (Prism::Node? node) -> String?
+
+      # Find leading comments for a statement node
+      def self.find_leading_comments: (
+        Prism::ParseResult parse_result,
+        Prism::Node current_stmt,
+        Prism::Node? prev_stmt,
+        Prism::Node body_node
+      ) -> Array[Prism::Comment]
+
+      # Find inline comments for a statement node
+      def self.inline_comments_for_node: (
+        Prism::ParseResult parse_result,
+        Prism::Node stmt
+      ) -> Array[Prism::Comment]
+
+      # Convert a Prism AST node to Ruby source code
+      def self.node_to_source: (Prism::Node? node) -> String
+
+      # Normalize a call node to use parentheses format
+      def self.normalize_call_node: (Prism::Node node) -> String
+
+      # Normalize an argument node to canonical format
+      def self.normalize_argument: (Prism::Node arg) -> String
+
+      # Check if a node is a specific method call
+      def self.call_to?: (Prism::Node node, Symbol method_name) -> bool
+
+      # Check if a node is a block call to a specific method
+      def self.block_call_to?: (Prism::Node node, Symbol method_name) -> bool
+    end
+  end
+end
+

data/sig/kettle/dev/source_merger.rbs

@@ -0,0 +1,86 @@
+# TypeProf 0.21.11
+
+module Kettle
+  module Dev
+    # Prism-based AST merging for templated Ruby files
+    module SourceMerger
+      FREEZE_START: Regexp
+      FREEZE_END: Regexp
+      FREEZE_BLOCK: Regexp
+      FREEZE_REMINDER: String
+      BUG_URL: String
+
+      # Apply a templating strategy to merge source and destination Ruby files
+      def self.apply: (
+        strategy: Symbol,
+        src: String,
+        dest: String,
+        path: String
+      ) -> String
+
+      # Ensure freeze reminder comment is present at the top of content
+      def self.ensure_reminder: (String content) -> String
+
+      # Normalize source code while preserving formatting
+      def self.normalize_source: (String source) -> String
+
+      # Check if freeze reminder is present in content
+      def self.reminder_present?: (String content) -> bool
+
+      # Find index where freeze reminder should be inserted
+      def self.reminder_insertion_index: (String content) -> Integer
+
+      # Check if line is a shebang
+      def self.shebang?: (String line) -> bool
+
+      # Check if line is a frozen_string_literal comment
+      def self.frozen_comment?: (String line) -> bool
+
+      # Merge kettle-dev:freeze blocks from destination into source content
+      def self.merge_freeze_blocks: (String src_content, String dest_content) -> String
+
+      # Extract freeze blocks from text
+      def self.freeze_blocks: (String? text) -> Array[Hash[Symbol, untyped]]
+
+      # Normalize strategy symbol
+      def self.normalize_strategy: (Symbol? strategy) -> Symbol
+
+      # Warn about bugs and print error information
+      def self.warn_bug: (String path, StandardError error) -> void
+
+      # Ensure text ends with newline
+      def self.ensure_trailing_newline: (String? text) -> String
+
+      # Apply append strategy
+      def self.apply_append: (String src_content, String dest_content) -> String
+
+      # Apply merge strategy
+      def self.apply_merge: (String src_content, String dest_content) -> String
+
+      # Merge node information
+      def self.merge_node_info: (Array[untyped] signature, Hash[Symbol, untyped] dest_node_info, Hash[Symbol, untyped] src_node_info) -> Hash[Symbol, untyped]
+
+      # Merge block node information
+      def self.merge_block_node_info: (Hash[Symbol, untyped] src_node_info) -> Hash[Symbol, untyped]
+
+      # Perform Prism-based merge with block
+      def self.prism_merge: (String src_content, String dest_content) { (Array[Hash[Symbol, untyped]], Array[Hash[Symbol, untyped]], Prism::ParseResult, Prism::ParseResult) -> Array[Hash[Symbol, untyped]] } -> String
+
+      # Extract nodes with comments from parse result
+      def self.extract_nodes_with_comments: (Prism::ParseResult parse_result) -> Array[Hash[Symbol, untyped]]
+
+      # Build source from node information array
+      def self.build_source_from_nodes: (Array[Hash[Symbol, untyped]] node_infos) -> String
+
+      # Generate signature for node
+      def self.node_signature: (Prism::Node? node) -> Array[untyped]
+
+      # Restore custom leading comments from destination
+      def self.restore_custom_leading_comments: (String dest_content, String merged_content) -> String
+
+      # Extract leading comment block from content
+      def self.leading_comment_block: (String content) -> String
+    end
+  end
+end
+

data/sig/kettle/dev/versioning.rbs

@@ -0,0 +1,21 @@
+# TypeProf 0.21.11
+
+module Kettle
+  module Dev
+    # Shared helpers for version detection and bump classification
+    module Versioning
+      # Detects a unique VERSION constant declared under lib/**/version.rb
+      def self.detect_version: (String root) -> String
+
+      # Classify the bump type from prev -> cur
+      def self.classify_bump: (String prev, String cur) -> Symbol
+
+      # Whether MAJOR is an EPIC version (strictly > 1000)
+      def self.epic_major?: (Integer major) -> bool
+
+      # Abort via ExitAdapter if available; otherwise Kernel.abort
+      def self.abort!: (String msg) -> void
+    end
+  end
+end
+

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: kettle-dev
 version: !ruby/object:Gem::Version
-  version: 1.1.60
+  version: 1.2.1
 platform: ruby
 authors:
 - Peter H. Boling
@@ -328,6 +328,7 @@ files:
 - gemfiles/modular/stringio/vHEAD.gemfile
 - gemfiles/modular/style.gemfile
 - gemfiles/modular/style.gemfile.example
+- gemfiles/modular/templating.gemfile
 - gemfiles/modular/x_std_libs.gemfile
 - gemfiles/modular/x_std_libs/r2.3/libs.gemfile
 - gemfiles/modular/x_std_libs/r2.4/libs.gemfile
@@ -352,6 +353,10 @@ files:
 - lib/kettle/dev/modular_gemfiles.rb
 - lib/kettle/dev/open_collective_config.rb
 - lib/kettle/dev/pre_release_cli.rb
+- lib/kettle/dev/prism_appraisals.rb
+- lib/kettle/dev/prism_gemfile.rb
+- lib/kettle/dev/prism_gemspec.rb
+- lib/kettle/dev/prism_utils.rb
 - lib/kettle/dev/rakelib/appraisal.rake
 - lib/kettle/dev/rakelib/bench.rake
 - lib/kettle/dev/rakelib/bundle_audit.rake
@@ -366,6 +371,7 @@ files:
 - lib/kettle/dev/readme_backers.rb
 - lib/kettle/dev/release_cli.rb
 - lib/kettle/dev/setup_cli.rb
+- lib/kettle/dev/source_merger.rb
 - lib/kettle/dev/tasks.rb
 - lib/kettle/dev/tasks/ci_task.rb
 - lib/kettle/dev/tasks/install_task.rb
@@ -376,10 +382,12 @@ files:
 - lib/kettle/emoji_regex.rb
 - sig/kettle-dev.rbs
 - sig/kettle/dev.rbs
+- sig/kettle/dev/appraisals_ast_merger.rbs
+- sig/kettle/dev/changelog_cli.rbs
 - sig/kettle/dev/ci_helpers.rbs
 - sig/kettle/dev/ci_monitor.rbs
 - sig/kettle/dev/commit_msg.rbs
-- sig/kettle/dev/dvcscli.rbs
+- sig/kettle/dev/dvcs_cli.rbs
 - sig/kettle/dev/exit_adapter.rbs
 - sig/kettle/dev/gem_spec_reader.rbs
 - sig/kettle/dev/git_adapter.rbs
@@ -388,25 +396,28 @@ files:
 - sig/kettle/dev/modular_gemfiles.rbs
 - sig/kettle/dev/open_collective_config.rbs
 - sig/kettle/dev/pre_release_cli.rbs
+- sig/kettle/dev/prism_utils.rbs
 - sig/kettle/dev/readme_backers.rbs
 - sig/kettle/dev/release_cli.rbs
 - sig/kettle/dev/setup_cli.rbs
+- sig/kettle/dev/source_merger.rbs
 - sig/kettle/dev/tasks.rbs
 - sig/kettle/dev/tasks/ci_task.rbs
 - sig/kettle/dev/tasks/install_task.rbs
 - sig/kettle/dev/tasks/template_task.rbs
 - sig/kettle/dev/template_helpers.rbs
 - sig/kettle/dev/version.rbs
+- sig/kettle/dev/versioning.rbs
 - sig/kettle/emoji_regex.rbs
 homepage: https://github.com/kettle-rb/kettle-dev
 licenses:
 - MIT
 metadata:
   homepage_uri: https://kettle-dev.galtzo.com/
-  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.1.60
-  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.1.60/CHANGELOG.md
+  source_code_uri: https://github.com/kettle-rb/kettle-dev/tree/v1.2.1
+  changelog_uri: https://github.com/kettle-rb/kettle-dev/blob/v1.2.1/CHANGELOG.md
   bug_tracker_uri: https://github.com/kettle-rb/kettle-dev/issues
-  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.1.60
+  documentation_uri: https://www.rubydoc.info/gems/kettle-dev/1.2.1
   funding_uri: https://github.com/sponsors/pboling
   wiki_uri: https://github.com/kettle-rb/kettle-dev/wiki
   news_uri: https://www.railsbling.com/tags/kettle-dev