spellkit 0.1.1 → 0.1.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6e690fa50208d003679afff3117b6f00664e6938e7feb992eff6a6544fad279e
-  data.tar.gz: 17d41414cbd48e093913cfa8765aac063f1cb17283df13414ad801fdf0aa79ae
+  metadata.gz: e36701637cedd91531b05d0b18680e57d26b9aae7e117d6a179f27d30a61e444
+  data.tar.gz: 560114d91574153e6b618c509a705bbcd82969e4a437aee777fa2ee7f10babcc
 SHA512:
-  metadata.gz: '0989bcacde87e9405c99f8674c681be65844a381cac11a00f8f05dd2f1a54312ce9d1799ca6317688255ee5fad454f4670845163b87e6a9541a981fff8685b35'
-  data.tar.gz: f12c69803c39ee74083a2090c85aac7bdfe7c39ac81995a95c09ad8c1e70df35cfb8d332de287413accf99aa4b6960e9e0c5f77ccd39b37d4ae092b06d8ea2d4
+  metadata.gz: 6cc82708564b26e943b4bc394ec41c13aa59c3ff7388027d113001cc8f8f8e83f219795b5547ab2ed318c9ab89733efbfbf3b937cdcf75d70a51836d5c2e4283
+  data.tar.gz: a6903fb208c64dc53bd07ee2b183e4a5bfe552d038ee87129e6afe3f32b14197c0d6546139abeada777ff98db3ee2466c86dd158561bf8d9d8beedacc6b7b335

data/README.md

@@ -1,6 +1,6 @@
 <img src="/docs/assets/spellkit-wide.png" alt="spellkit" height="160px">
 
-Fast, safe typo correction for search-term extraction, wrapping the SymSpell algorithm in Rust via Magnus.
+Fast, safe typo correction for search-term extraction. A Ruby gem with a native Rust implementation of the SymSpell algorithm.
 
 SpellKit provides:
 - **Fast correction** using SymSpell with configurable edit distance (1 or 2)
@@ -9,6 +9,8 @@ SpellKit provides:
 - **Sub-millisecond latency** - p95 < 2µs on small dictionaries
 - **Thread-safe** - built with Rust's Arc<RwLock> for safe concurrent access
 
+**Why a custom implementation?** Existing Rust SymSpell crates require lowercase dictionary entries, but SpellKit preserves canonical forms (NASA stays NASA, iPhone stays iPhone). We also needed domain-specific guards, hot-reload, and Aspell-style skip patterns - features not available in existing implementations.
+
 ## Why SpellKit?
 
 ### No Runtime Dependencies
@@ -542,7 +544,7 @@ end
 
 ## Performance
 
-### SpellKit Standalone (M1 MacBook Pro, Ruby 3.3.0, 80k dictionary)
+### SpellKit Standalone (M4 Max MacBook Pro, Ruby 3.3.0, 80k dictionary)
 
 **Single Word Suggestions:**
 - 3,345 i/s (298.96 μs/i) with max: 1 suggestion
@@ -572,6 +574,27 @@ end
 3. **High Throughput**: Over 16k operations per second with 80k word dictionary
 4. **Scales Well**: Minimal performance difference between 1 vs 10 suggestions
 
+### Comparison with Aspell
+
+SpellKit vs Aspell (M4 Max MacBook Pro, Ruby 3.3.0, 80k dictionary):
+
+**Suggestion Performance (13 misspelled words):**
+- SpellKit: 3,162 i/s (316μs per batch)
+- Aspell: 433 i/s (2.31ms per batch)
+- **SpellKit is 7.3x faster**
+
+**Spell Checking (correct? on 26 words):**
+- SpellKit: 263,279 i/s (3.8μs per batch)
+- Aspell: 72,099 i/s (13.9μs per batch)
+- **SpellKit is 3.65x faster**
+
+**Latency Distribution (10,000 single-word suggestions):**
+- SpellKit: p50=63μs, p95=69μs, p99=98μs
+- Aspell: p50=105μs, p95=121μs, p99=182μs
+- **SpellKit is 1.7x faster at p50, 1.75x faster at p95**
+
+Both libraries provide high-quality spell checking, but SpellKit's SymSpell algorithm (O(1) lookup) offers significant performance advantages over Aspell's statistical approach, especially for high-throughput applications.
+
 ## Benchmarks
 
 SpellKit includes comprehensive benchmarks to measure performance and compare with other spell checkers.
@@ -671,4 +694,4 @@ Bug reports and pull requests are welcome at https://github.com/scientist-labs/s
 
 ## License
 
-MIT License - see [LICENSE](LICENSE) file for details.
+MIT License - see [LICENSE](LICENSE.txt) file for details.

data/ext/spellkit/Cargo.toml

@@ -16,4 +16,4 @@ hashbrown = "0.15"
 unicode-normalization = "0.1"
 regex = "1.11"
 
-[dev-dependencies]
+[dev-dependencies]

data/lib/spellkit/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module SpellKit
-  VERSION = "0.1.1"
+  VERSION = "0.1.2"
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: spellkit
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.2
 platform: ruby
 authors:
 - Chris Petersen
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2025-09-27 00:00:00.000000000 Z
+date: 2025-09-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rb_sys
@@ -150,8 +150,8 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-description: A Ruby gem that provides fast typo correction using SymSpell algorithm,
-  with domain-specific term protection
+description: A Ruby gem with a native Rust implementation of the SymSpell algorithm
+  for fast typo correction with domain-specific term protection
 email:
 - chris@petersen.io
 executables: []
@@ -191,7 +191,6 @@ licenses:
 metadata:
   homepage_uri: https://github.com/scientist-labs/spellkit
   source_code_uri: https://github.com/scientist-labs/spellkit
-  changelog_uri: https://github.com/scientist-labs/spellkit/blob/main/CHANGELOG.md
 post_install_message:
 rdoc_options: []
 require_paths:
@@ -206,7 +205,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
-requirements: []
+requirements:
+- Rust >= 1.85
 rubygems_version: 3.5.3
 signing_key:
 specification_version: 4