tina4ruby 3.13.27 → 3.13.29

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 22585d14a68f2f43593a60d1cd6f6173cd0c6103ef715f381195f8a4f006588e
-  data.tar.gz: a89a7168c5175e862ef902b7501ffb85a1fa195298dd4d5b981f69695fa49cfb
+  metadata.gz: 01fb453b8f6a6ea027dc04bc3e1d56c808969f50739ca60946152030883e7fd0
+  data.tar.gz: b04d9e2902f61df6e37ae6eb81b95b6f60edf579739206ea97b9463a1ba5dd25
 SHA512:
-  metadata.gz: f3cb82ae2d3b78cc1fecc97427200181298c6a4da3fbb1ce5820cce8f066621bacd04f8345ee33636ea2fc1ed0b2b8f905d48358c09d0294448edc87aab54af7
-  data.tar.gz: e551aea110d6e9e86e44d003522145a734221da3942120c2c563df98e05b4092c66919afebeecaae01ed78ca2c533fc6b8ef6eb2a78bf4ebbf0f604c0656ba46
+  metadata.gz: 4c3ce7f5a22fef09964273c1645a3b1756a2359bf2d670bcc2b3c640bd8f0689a38653dd046b12c000fdc78ce9cbbb0dec386317a5d13e3cf09243c39461888f
+  data.tar.gz: dca9b42a7753fd2609d263867846d236e1c3e10b094f37a6030c690cadab75e3041b787e886c6feceb7dbafcb73b8bf3ba090c60fc69167e3309d1f3b79d378c

data/lib/tina4/docs.rb

@@ -98,8 +98,7 @@ module Tina4
     # Full reflection of a single class — `nil` for unknown.
     def class_spec(fqn)
       ensure_index
-      key = normalise_fqn(fqn)
-      class_entry = all_entries.find { |e| e[:kind] == "class" && e[:fqn] == key }
+      class_entry = resolve_class(fqn)
       return nil if class_entry.nil?
 
       methods = all_entries.select do |m|
@@ -123,9 +122,10 @@ module Tina4
     # Single method spec — `nil` for unknown.
     def method_spec(class_fqn, method_name)
       ensure_index
-      key = normalise_fqn(class_fqn)
+      klass = resolve_class(class_fqn)
+      resolved = klass ? klass[:fqn] : normalise_fqn(class_fqn)
       entry = all_entries.find do |e|
-        e[:kind] == "method" && e[:class_fqn] == key && e[:name] == method_name.to_s
+        e[:kind] == "method" && e[:class_fqn] == resolved && e[:name] == method_name.to_s
       end
       entry && method_payload(entry)
     end
@@ -558,6 +558,38 @@ module Tina4
       tokens.each do |tk|
         score += 1 if !tk.empty? && doc.include?(tk)
       end
+
+      # Class-qualified queries ("Frond.add_test" / "Frond::add_test" /
+      # "Frond add_test"): score the owning class so the qualifier steers
+      # ranking instead of being dead weight.
+      class_fqn = (entry[:class_fqn] || entry[:class]).to_s
+      unless class_fqn.empty?
+        parent = class_fqn.split("::").last.to_s.downcase
+        unless parent.empty?
+          # Exact "Class.method" intent — normalise `.`/`::`/whitespace in the
+          # (already space-stripped) joined query to a single `.` separator.
+          q_norm = joined.gsub(/[:.]+/, ".")
+          if q_norm == "#{parent}.#{name}" || q_norm == "#{parent}.#{stripped}"
+            score += 6 # strongest signal we have
+          end
+          tokens.each do |tk|
+            next if tk.empty?
+            if tk == parent
+              score += 2.5
+            elsif parent.start_with?(tk)
+              score += 1
+            end
+          end
+        end
+      end
+
+      # Any token that is a whole dotted / :: segment of the fqn
+      # (namespace / class / method).
+      fqn_segs = entry[:fqn].to_s.downcase.split(/[.:#\s]+/).reject(&:empty?)
+      tokens.each do |tk|
+        score += 1 if !tk.empty? && fqn_segs.include?(tk)
+      end
+
       # Substring fallback — full joined query inside the name.
       if !joined.empty? && score.zero? && name.include?(joined)
         score += 2
@@ -632,5 +664,36 @@ module Tina4
     def normalise_fqn(fqn)
       fqn.to_s.sub(/\A::/, "")
     end
+
+    # Resolve a class entry by exact FQN, documented public path, or bare name.
+    #
+    # Callers naturally type the exact stored FQN (`Tina4::Database`), a bare
+    # class name (`Database`), or a longer path that nests the class name
+    # (`Tina4::Database::Database`). Match exactly first, then by class name
+    # (the last `::`/`.` segment), disambiguating by requiring the given
+    # segments to appear in the stored FQN (framework + shortest wins). A
+    # genuinely unknown name returns `nil` — no false positives.
+    def resolve_class(given)
+      classes = all_entries.select { |e| e[:kind] == "class" }
+      key = normalise_fqn(given)
+
+      exact = classes.find { |e| e[:fqn] == key }
+      return exact if exact
+
+      gsegs = key.split(/[:.]+/).reject(&:empty?)
+      gname = gsegs.empty? ? key : gsegs.last
+      cands = classes.select { |e| e[:fqn].to_s.split(/[:.]+/).last == gname }
+      return nil if cands.empty?
+      return cands.first if cands.size == 1
+
+      # Disambiguate: prefer classes whose stored FQN contains every given
+      # segment, then framework source, then the shortest FQN.
+      subset = cands.select do |e|
+        segs = e[:fqn].to_s.split(/[:.]+/)
+        gsegs.all? { |s| segs.include?(s) }
+      end
+      pool = subset.empty? ? cands : subset
+      pool.min_by { |e| [e[:source] == "framework" ? 0 : 1, e[:fqn].to_s.length, e[:fqn].to_s] }
+    end
   end
 end

data/lib/tina4/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tina4
-  VERSION = "3.13.27"
+  VERSION = "3.13.29"
 end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tina4ruby
 version: !ruby/object:Gem::Version
-  version: 3.13.27
+  version: 3.13.29
 platform: ruby
 authors:
 - Tina4 Team