spica 0.1.1 → 0.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 455f7fc3f7147d6d59a3e1a640930d8599f078b8819aa465224a27022480e5e8
-  data.tar.gz: 1dfa01ddc8f1a5afda5eb554091e18a9096f630df332b50dc9962009cdfb2337
+  metadata.gz: '08bd3e463725a188508e13a5e8b06cc3a13e23f800bbcffdc32497ae1049955e'
+  data.tar.gz: 74f3ad3e94f36f424639620009721d711454ed7bb3a4e8ed29075cdde42993b3
 SHA512:
-  metadata.gz: 2eba4b4ccf8b945eef7a2456607af4deb934944ea8bb33d802e6d306b799089cbb2d9f209b0a722a30cd0f9d5ace8d05af134d058b6c22b93a7f645e3c5bc0b9
-  data.tar.gz: 29ec465710dd68cdd5e50f2e71b3a634cac39a446929e98a046d96db2308aa91dff52f4bc5fc8f9d550df9e81c2d0f3e76977f3438f03df2bb94a9b629fde5af
+  metadata.gz: 8fd3732d8cd1f5a69a604e52574277bfa739c5ceb6b326980ff649603fdda32ad2db57bdda106cb21bf291b606d8ca9c06d359570fff121e6fc99bfec7b5fc8b
+  data.tar.gz: b87874f50294213f1c69e4d38af61670334d87be9039ec2563cebba293341fbefdbe9fc808175383668753325ac7c92c7e46e47fc2dd76b7f88c74b48e6d70a5

data/CHANGELOG.md

@@ -1,5 +1,9 @@
 # Changelog
 
+## 0.2.0 — 2026-09-24
+
+- Add an optional Zaniah matcher adapter with stable duplicate indices and UTF-8 highlight ranges.
+
 ## 0.1.1 — 2026-09-21
 
 - Add a deterministic fuzzy-matching demo image and regeneration task.

data/README.md

@@ -120,6 +120,20 @@ Indexes deduplicate identical text. Removing and re-adding a candidate assigns i
 
 `Match#text` aliases `candidate`; `Match#index` is the stable registration ID. A session keeps the active prefix chain, while an unrelated query restarts from the full index. Display limits never discard candidates needed by the next query.
 
+### Zaniah command palettes and comboboxes
+
+The optional adapter requires Zaniah 0.7 or newer (below 1.0). It converts Spica's Unicode character positions to the UTF-8 byte ranges used by Zaniah's highlights:
+
+```ruby
+require "spica/zaniah_matcher"
+
+matcher = Spica::ZaniahMatcher.new
+Zaniah::UI::CommandPalette.new(commands, matcher: matcher)
+# Or: Zaniah.configure { |config| config.matcher = matcher }
+```
+
+The adapter preserves duplicate labels and reports each label's input-array index. This differs from `Spica::Match#index`, which identifies a deduplicated index entry. Non-UTF-8 multibyte labels are rejected because their original byte offsets cannot be used as Zaniah highlight ranges. The adapter does not implement optional incremental `refine`; Zaniah calls `match` on each query.
+
 ## Configuration
 
 Pass settings directly or reuse an immutable `Spica::Options` instance:

data/lib/spica/version.rb

@@ -2,5 +2,5 @@
 
 module Spica
   # Library semantic version.
-  VERSION = "0.1.1"
+  VERSION = "0.2.0"
 end

data/lib/spica/zaniah_matcher.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+require "spica"
+require "zaniah/ui"
+
+module Spica
+  # Optional adapter for Zaniah's command palette and combobox matcher API.
+  class ZaniahMatcher
+    def match(query, labels)
+      matcher = Matcher.new(query)
+      if query.empty?
+        return labels.each_index.map { |index| Zaniah::UI::Matcher::Match.new(index: index, score: 0.0, ranges: []) }
+      end
+
+      labels.each_with_index.filter_map do |label, index|
+        result = matcher.match(Candidate.new(label, index, precompute_mask: false))
+        next unless result
+
+        unless label.encoding == Encoding::UTF_8 || label.ascii_only?
+          raise ArgumentError, "Zaniah labels must be UTF-8 text"
+        end
+
+        offsets = [0]
+        label.each_char { |char| offsets << offsets.last + char.bytesize }
+        ranges = result.positions.map { |position| offsets[position]...offsets[position + 1] }
+        Zaniah::UI::Matcher::Match.new(index: index, score: result.score, ranges: ranges)
+      end.sort_by { |result| [-result.score, labels[result.index].length, result.index] }
+    end
+  end
+end

data/sig/spica.rbs

@@ -81,4 +81,9 @@ module Spica
     def matches: (?Integer limit) -> Array[Match]
     def total_matches: () -> Integer
   end
+
+  # Load with `require "spica/zaniah_matcher"`; the optional Zaniah gem supplies the result type.
+  class ZaniahMatcher
+    def match: (String query, Array[String] labels) -> Array[untyped]
+  end
 end

metadata

@@ -1,16 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spica
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.2.0
 platform: ruby
 authors:
 - Yudai Takada
-autorequire:
 bindir: exe
 cert_chain: []
-date: 2026-09-21 00:00:00.000000000 Z
+date: 1980-01-02 00:00:00.000000000 Z
 dependencies: []
-description:
 email:
 - t.yudai92@gmail.com
 executables: []
@@ -25,6 +23,7 @@ files:
 - lib/spica/index.rb
 - lib/spica/matcher.rb
 - lib/spica/version.rb
+- lib/spica/zaniah_matcher.rb
 - sig/spica.rbs
 homepage: https://github.com/noxdea/spica
 licenses:
@@ -34,7 +33,6 @@ metadata:
   changelog_uri: https://github.com/noxdea/spica/blob/main/CHANGELOG.md
   allowed_push_host: https://rubygems.org
   rubygems_mfa_required: 'true'
-post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -49,8 +47,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.3.27
-signing_key:
+rubygems_version: 3.6.9
 specification_version: 4
 summary: Deterministic fuzzy subsequence matching with incremental filtering
 test_files: []