Rename Kernel#tee to Kernel#functor

The method returns a Functor, so name it what it is. The tee/tap
metaphors didn't quite fit — this isn't forking data or tapping
into a stream, it's wrapping self in a Functor proxy.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: trans

HISTORY.md

@@ -17,7 +17,7 @@ Changes:
   * Add `Binding#caller_locations`.
   * Add `Range.intersection` and `Range#intersection` for finding the shared
     region of multiple ranges. Works with any comparable type.
-  * Add `Kernel#tee` — block-less method chaining via Functor, replaces `tap` override.
+  * Add `Kernel#functor` — block-less method chaining via Functor, replaces `tap` override.
   * Rename `Hash#to_proc` to `Hash#setter` (avoids clash with Ruby 2.3's `Hash#to_proc`
     which does key lookup; Facets' version does attribute assignment).
   * Consolidate `Array#arrange` and `Array#to_ranges`; `to_ranges` is now primary,

lib/core/facets/kernel.rb

@@ -56,6 +56,7 @@
 require_relative 'kernel/silence.rb'
 require_relative 'kernel/silence_warnings.rb'
 require_relative 'kernel/super_method.rb'
+require_relative 'kernel/functor.rb'
 require_relative 'kernel/tap.rb'
 require_relative 'kernel/temporarily.rb'
 #require_relative 'kernel/trap_chain.rb'        # uncommon

lib/core/facets/kernel/functor.rb

@@ -0,0 +1,16 @@
+require 'facets/functor'
+
+module Kernel
+
+  # Returns a Functor that intercepts method calls, forwards
+  # them to self for side effects, and returns self. This is like
+  # a block-less version of #tap that allows method chaining.
+  #
+  #   YAML.functor.load_file('foo.yml').load_file('bar.yml')
+  #
+
+  def functor
+    Functor.new{ |op,*a,&b| self.send(op, *a, &b); self }
+  end
+
+end

lib/core/facets/kernel/tap.rb

@@ -1,3 +1,3 @@
-# Facets no longer overrides Kernel#tap. Use Kernel#tee instead
+# Facets no longer overrides Kernel#tap. Use Kernel#functor instead
 # for the block-less Functor form.
-require 'facets/kernel/tee'
+require 'facets/kernel/functor'

lib/core/facets/kernel/tee.rb

@@ -1,16 +1,2 @@
-require 'facets/functor'
-
-module Kernel
-
-  # Returns a Functor that intercepts method calls, forwards
-  # them to self for side effects, and returns self. This is like
-  # a block-less version of #tap that allows method chaining.
-  #
-  #   YAML.tee.load_file('foo.yml').load_file('bar.yml')
-  #
-
-  def tee
-    Functor.new{ |op,*a,&b| self.send(op, *a, &b); self }
-  end
-
-end
+# @deprecated Use Kernel#functor instead.
+require 'facets/kernel/functor'