@ycookiey/yfuzzy 0.3.0 → 0.4.1

package/README.md

@@ -1,176 +1,191 @@
-# yfuzzy
-
-[![npm](https://img.shields.io/npm/v/@ycookiey/yfuzzy)](https://www.npmjs.com/package/@ycookiey/yfuzzy)
-[![types](https://img.shields.io/npm/types/@ycookiey/yfuzzy)](https://www.npmjs.com/package/@ycookiey/yfuzzy)
-[![minzipped](https://badgen.net/bundlephobia/minzip/@ycookiey/yfuzzy)](https://bundlephobia.com/package/@ycookiey/yfuzzy)
-[![license](https://img.shields.io/npm/l/@ycookiey/yfuzzy)](./LICENSE)
-
-日本語特化のあいまい検索ライブラリ。ローマ字混じり入力・ヘボン式/訓令式の同時照合・子音だけのマッチ・誤字許容を 1 パッケージに統合。依存ゼロ・ESM・TypeScript 型付き。
-
-```
-shinjuku / sinjuku / しんじゅく / シンジュク  →  すべて「シンジュク」にヒット
-kmnr                                        →  「カミナリ」にヒット（子音だけ）
-カナリ                                       →  「カミナリ」にヒット（とびとび一致）
-センタイ                                     →  「センダイ」にヒット（誤字）
-```
-
-## なぜ yfuzzy か
-
-既存のあいまい検索ライブラリ（fuse.js / fuzzysort / MiniSearch / uFuzzy / match-sorter など）はラテン文字圏を前提に設計されており、diacritics（発音区別符号）の除去や Unicode 正規化には対応するものの、**ローマ字とかなの変換や、ヘボン式・訓令式の違いを扱わない**。
-
-日本語 UI では、利用者はローマ字・部分的なかな・子音だけ（上の例）で打つ一方、データはひらがな・カタカナ・漢字（の読み）で保持されている。yfuzzy はこの表記のずれを埋めることに特化している。
-
-## スコープ
-
-**向いている**: 日本語の読み（かな）を索引にした短い文字列の検索。駅名・地名・商品名・人名などの読みに対する、逐次検索（type-ahead）やオートコンプリート。
-
-**向いていない**:
-
-- **漢字をそのまま検索**: yfuzzy は漢字を読みに変換しない（文字どおりの一致のみ）。読みで当てたいなら読み仮名を用意し `getText` で返す（[使い方](#使い方)参照）。
-- **ラテン文字の汎用あいまい検索 / 全文検索**（複数フィールド・トークン化・TF-IDF）: fuse.js / MiniSearch 等が成熟している。用途で使い分けるとよい。
-
-## 類似パッケージとの比較
-
-| 機能 | yfuzzy | [fuse.js](https://www.fusejs.io/) | [fuzzysort](https://github.com/farzher/fuzzysort) | [MiniSearch](https://github.com/lucaong/minisearch) | [uFuzzy](https://github.com/leeoniya/uFuzzy) | [match-sorter](https://github.com/kentcdodds/match-sorter) |
-|---|:--:|:--:|:--:|:--:|:--:|:--:|
-| 日本語入力（ローマ字↔かな・ヘボン/訓令・かな正規化） | ✅ | ➖ | ➖ | ➖ | ➖ | ➖ |
-| 子音だけのマッチ | ✅ | ➖ | 🔸 | ➖ | 🔸 | 🔸 |
-| とびとび一致（subsequence） | ✅ | 🔸 | ✅ | ➖ | ✅ | 🔸 |
-| 誤字許容（編集距離） | ✅ | ✅ | ➖ | ✅ | 🔸 | ➖ |
-| ハイライト位置の返却 | ✅ | ✅ | ✅ | 🔸 | ✅ | ➖ |
-| 索引の事前構築 | ✅ | ✅ | ✅ | ✅ | ➖ | ➖ |
-| 全文検索（複数フィールド/トークン） | ➖ | ✅ | 🔸 | ✅ | ➖ | 🔸 |
-| ラテン文字の diacritics 除去 | ➖ | ✅ | ➖ | 🔸 | ✅ | ✅ |
-| 依存ゼロ | ✅ | ✅ | ✅ | ✅ | ✅ | ➖ |
-
-凡例: ✅ 組み込み / 🔸 部分的・間接的（または要カスタム） / ➖ なし。各ライブラリの調査時点の既定挙動を基準とした。多くはカスタム関数で拡張できる。本表は「日本語入力対応＋主要なあいまいマッチ機能」に観点を絞ったもの。
-
-## インストール
-
-```sh
-npm install @ycookiey/yfuzzy
-```
-
-Node 18+ / ESM 専用。
-
-### ブラウザ (CDN)
-
-ビルドツールなしで使う場合は同梱の単一ファイル bundle を `<script>` で読み込む（グローバル `yfuzzy` が定義される）:
-
-```html
-<script src="https://unpkg.com/@ycookiey/yfuzzy@0.3.0/dist/yfuzzy.min.js"></script>
-<script>
-  yfuzzy.search('sinjuku', ['トウキョウ', 'シンジュク', 'シブヤ']);
-  // → [{ item: 'シンジュク', refIndex: 1, score: 1, tier: 1 }]
-</script>
-```
-
-## 使い方
-
-### 文字列配列
-
-```ts
-import { search } from '@ycookiey/yfuzzy';
-
-const stations = ['トウキョウ', 'シンジュク', 'シブヤ', 'シナガワ'];
-
-search('sinjuku', stations);
-// → [{ item: 'シンジュク', refIndex: 1, score: 1, tier: 1 }]
-```
-
-### オブジェクト配列（getText）
-
-`getText` で検索対象の文字列を取り出す。漢字を読みで当てたい場合も、読み仮名を返せばよい（読みは利用者側で用意する）。
-
-```ts
-const items = [
-  { label: '東京', yomi: 'トウキョウ' },
-  { label: '新宿', yomi: 'シンジュク' },
-];
-
-search('しんじゅく', items, { getText: (x) => x.yomi });
-// → [{ item: { label: '新宿', … }, refIndex: 1, score: 1, tier: 1 }]
-```
-
-### 索引の再利用（createIndex）
-
-同じデータを繰り返し検索するなら事前構築する。単発 `search` と結果は同一。
-
-```ts
-import { createIndex } from '@ycookiey/yfuzzy';
-
-const index = createIndex(stations);
-index.search('しぶ');             // → 先頭は シブヤ（短い語なので tier3 候補も続く）
-index.search('しな', { limit: 5 }); // 呼び出しごとに検索オプションを上書き
-```
-
-### ハイライト（includeMatches）
-
-`includeMatches: true` で、**元文字列上**の一致区間 `[start, end)`（半開・昇順、隣接や重複は統合済み）を返す（後述の tier 1・2 でのみ）。各区間を `text.slice` で切り出して囲めばハイライトになる。
-
-```ts
-const r = search('keki', ['ケーキ'], { includeMatches: true });
-// r[0].matches → [[0, 3]]   ← 長音「ー」も含めて隙間なく連続
-```
-
-## マッチの仕組み
-
-クエリは tier 1 から順に評価され、最初に一致した tier で確定する（既定は tier 1〜3。`maxTier: 4` で tier 4 も有効化）。`score` は 0〜1 で、上の tier ほど高い。
-
-| tier | 内容 | 例 | score の範囲（目安） |
-|---|---|---|---|
-| 1 | 直接一致（かな/ローマ字が前方・部分一致） | `シンジュク`→`シンジュク` | 0.75〜1.0 |
-| 2 | 柔軟一致（とびとびでも可。語頭・連続を優遇、子音だけの入力も可） | `kmnr`→`カミナリ` | 0.5〜0.75 |
-| 3 | 誤字許容（編集距離、中間の置換/挿入/削除/入れ替え） | `センタイ`→`センダイ` | 0.25〜0.5 |
-| 4 | 構造類似（2 文字単位の重なりによる類似〔Tversky 係数〕、既定で無効） | 大きく崩れた入力 | 0〜0.25 |
-
-各 tier は幅およそ 0.25 の帯に収まり、スコアが tier 間の境界（0.25 / 0.5 / 0.75）ちょうどになることはない。そのため閾値ひとつで「確実なヒット」と「あいまいな候補（『もしかして』表示向け）」を分離できる。結果は `score` 降順（同点は `refIndex` 昇順で安定）。
-
-## API
-
-### `search(query, items, options?)`
-
-単発検索。`createIndex(items, options).search(query)` と等価。
-
-### `createIndex(items, options?) → SearchIndex`
-
-事前構築した索引を返す。`index.search(query, searchOptions?)` で呼び出しごとに検索オプションを上書きできる。`index.size` で件数。
-
-### オプション
-
-構築時オプション（`createIndex` / `search` の `options`）:
-
-| 名前 | 型 | 既定 | 説明 |
-|---|---|---|---|
-| `getText` | `(item: T) => string` | なし | オブジェクト配列で検索対象文字列を取り出す（`T[]` のとき必須） |
-| `romaji` | `'hepburn' \| 'kunrei' \| 'both' \| false` | `'both'` | ローマ字照合の方式。`false` でローマ字照合せず、かなのみで照合 |
-| `separatorExpansion` | `boolean \| string[]` | `false` | 区切り文字を、取り除いた形と区切りとして扱う形の両方で照合（`true` で `['-', ' ', '・', '_']`） |
-
-検索時オプション（`index.search` で上書き可）:
-
-| 名前 | 型 | 既定 | 説明 |
-|---|---|---|---|
-| `limit` | `number` | 無制限 | 返却件数の上限 |
-| `maxTier` | `1 \| 2 \| 3 \| 4` | `3` | 実行する tier の上限（`4` で構造類似の tier を有効化） |
-| `minScore` | `number` | `0` | この score 未満を除外 |
-| `includeMatches` | `boolean` | `false` | `matches` を含める |
-
-### 結果 `SearchResult<T>`
-
-```ts
-type SearchResult<T> = {
-  item: T;
-  refIndex: number;                       // items 内の位置
-  score: number;                          // 0〜1、高いほど良い
-  tier: 1 | 2 | 3 | 4;
-  matches?: readonly [number, number][];  // includeMatches 時、tier 1/2 のみ
-};
-```
-
-## 性能
-
-短い文字列の索引向け（数百〜数十万件）。内部の前段フィルタと早期打ち切りにより、1 クエリの実測値は千件で約 1.5ms、1 万件で約 10ms、10 万件で約 90ms（環境依存）。同条件で fuse.js より高速。`maxTier` を下げる、または `romaji` を一方の方式だけに絞ると更に軽くなる。索引構築は 10 万件で約 0.7 秒（一度きり）。
-
-## ライセンス
-
-MIT。ローマ字→かな変換に [WanaKana](https://github.com/WaniKani/WanaKana)（MIT）のコードを改変のうえ同梱している。詳細は [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md)。
+# yfuzzy
+
+[![npm](https://img.shields.io/npm/v/@ycookiey/yfuzzy)](https://www.npmjs.com/package/@ycookiey/yfuzzy)
+[![types](https://img.shields.io/npm/types/@ycookiey/yfuzzy)](https://www.npmjs.com/package/@ycookiey/yfuzzy)
+[![minzipped](https://badgen.net/bundlephobia/minzip/@ycookiey/yfuzzy)](https://bundlephobia.com/package/@ycookiey/yfuzzy)
+[![license](https://img.shields.io/npm/l/@ycookiey/yfuzzy)](./LICENSE)
+
+日本語特化のあいまい検索ライブラリ。ローマ字混じり入力・ヘボン式/訓令式の同時照合・子音だけのマッチ・誤字許容を 1 パッケージに統合。依存ゼロ・ESM・TypeScript 型付き。
+
+```
+shinjuku / sinjuku / しんじゅく / シンジュク  →  すべて「シンジュク」にヒット
+kmnr                                        →  「カミナリ」にヒット（子音だけ）
+カナリ                                       →  「カミナリ」にヒット（とびとび一致）
+センタイ                                     →  「センダイ」にヒット（誤字）
+かぇんだr                                     →  「Calendar」にヒット（IME オンのまま英字を打った入力）
+```
+
+## なぜ yfuzzy か
+
+既存のあいまい検索ライブラリ（fuse.js / fuzzysort / MiniSearch / uFuzzy / match-sorter など）はラテン文字圏を前提に設計されており、diacritics（発音区別符号）の除去や Unicode 正規化には対応するものの、**ローマ字とかなの変換や、ヘボン式・訓令式の違いを扱わない**。
+
+日本語 UI では、利用者はローマ字・部分的なかな・子音だけ（上の例）で打つ一方、データはひらがな・カタカナ・漢字（の読み）で保持されている。yfuzzy はこの表記のずれを埋めることに特化している。
+
+## スコープ
+
+**向いている**: 日本語の読み（かな）を索引にした短い文字列の検索。駅名・地名・商品名・人名などの読みに対する、逐次検索（type-ahead）やオートコンプリート。英字の名前が混ざった索引を英字で探す用途にも対応する（[照合経路](#照合経路matching)）。
+
+**向いていない**:
+
+- **漢字をそのまま検索**: yfuzzy は漢字を読みに変換しない（文字どおりの一致のみ）。読みで当てたいなら読み仮名を用意し `getText` で返す（[使い方](#使い方)参照）。
+- **ラテン文字の全文検索**（複数フィールド・トークン化・TF-IDF）: fuse.js / MiniSearch 等が成熟している。用途で使い分けるとよい。
+
+## 類似パッケージとの比較
+
+| 機能 | yfuzzy | [fuse.js](https://www.fusejs.io/) | [fuzzysort](https://github.com/farzher/fuzzysort) | [MiniSearch](https://github.com/lucaong/minisearch) | [uFuzzy](https://github.com/leeoniya/uFuzzy) | [match-sorter](https://github.com/kentcdodds/match-sorter) |
+|---|:--:|:--:|:--:|:--:|:--:|:--:|
+| 日本語入力（ローマ字↔かな・ヘボン/訓令・かな正規化） | ✅ | ➖ | ➖ | ➖ | ➖ | ➖ |
+| 子音だけのマッチ | ✅ | ➖ | 🔸 | ➖ | 🔸 | 🔸 |
+| とびとび一致（subsequence） | ✅ | 🔸 | ✅ | ➖ | ✅ | 🔸 |
+| 誤字許容（編集距離） | ✅ | ✅ | ➖ | ✅ | 🔸 | ➖ |
+| ハイライト位置の返却 | ✅ | ✅ | ✅ | 🔸 | ✅ | ➖ |
+| 索引の事前構築 | ✅ | ✅ | ✅ | ✅ | ➖ | ➖ |
+| 全文検索（複数フィールド/トークン） | ➖ | ✅ | 🔸 | ✅ | ➖ | 🔸 |
+| ラテン文字の diacritics 除去 | ➖ | ✅ | ➖ | 🔸 | ✅ | ✅ |
+| 依存ゼロ | ✅ | ✅ | ✅ | ✅ | ✅ | ➖ |
+
+凡例: ✅ 組み込み / 🔸 部分的・間接的（または要カスタム） / ➖ なし。各ライブラリの調査時点の既定挙動を基準とした。多くはカスタム関数で拡張できる。本表は「日本語入力対応＋主要なあいまいマッチ機能」に観点を絞ったもの。
+
+## インストール
+
+```sh
+npm install @ycookiey/yfuzzy
+```
+
+Node 18+ / ESM 専用。
+
+### ブラウザ (CDN)
+
+ビルドツールなしで使う場合は同梱の単一ファイル bundle を `<script>` で読み込む（グローバル `yfuzzy` が定義される）:
+
+```html
+<script src="https://unpkg.com/@ycookiey/yfuzzy@0.3.0/dist/yfuzzy.min.js"></script>
+<script>
+  yfuzzy.search('sinjuku', ['トウキョウ', 'シンジュク', 'シブヤ']);
+  // → [{ item: 'シンジュク', refIndex: 1, score: 1, tier: 1 }]
+</script>
+```
+
+## 使い方
+
+### 文字列配列
+
+```ts
+import { search } from '@ycookiey/yfuzzy';
+
+const stations = ['トウキョウ', 'シンジュク', 'シブヤ', 'シナガワ'];
+
+search('sinjuku', stations);
+// → [{ item: 'シンジュク', refIndex: 1, score: 1, tier: 1 }]
+```
+
+### オブジェクト配列（getText）
+
+`getText` で検索対象の文字列を取り出す。漢字を読みで当てたい場合も、読み仮名を返せばよい（読みは利用者側で用意する）。
+
+```ts
+const items = [
+  { label: '東京', yomi: 'トウキョウ' },
+  { label: '新宿', yomi: 'シンジュク' },
+];
+
+search('しんじゅく', items, { getText: (x) => x.yomi });
+// → [{ item: { label: '新宿', … }, refIndex: 1, score: 1, tier: 1 }]
+```
+
+### 索引の再利用（createIndex）
+
+同じデータを繰り返し検索するなら事前構築する。単発 `search` と結果は同一。
+
+```ts
+import { createIndex } from '@ycookiey/yfuzzy';
+
+const index = createIndex(stations);
+index.search('しぶ');             // → 先頭は シブヤ（短い語なので tier3 候補も続く）
+index.search('しな', { limit: 5 }); // 呼び出しごとに検索オプションを上書き
+```
+
+### ハイライト（includeMatches）
+
+`includeMatches: true` で、**元文字列上**の一致区間 `[start, end)`（半開・昇順、隣接や重複は統合済み）を返す（後述の tier 1・2 でのみ）。各区間を `text.slice` で切り出して囲めばハイライトになる。
+
+```ts
+const r = search('keki', ['ケーキ'], { includeMatches: true });
+// r[0].matches → [[0, 3]]   ← 長音「ー」も含めて隙間なく連続
+```
+
+## マッチの仕組み
+
+### 照合経路（matching）
+
+クエリは2つの経路で照合し、score の高いほうを採る（既定 `matching: 'both'`）。
+
+- **literal**: 入力した文字のまま照合する（大文字小文字・全角半角・ひらがなカタカナの正規化のみ）。英字の item を英字で探す場合に当たる（`cale` → `Calendar`）。入力中のかなは、それを打ったローマ字の打鍵としても照合するため、IME をオンのまま英字を打った入力も当たる（`かぇんだr` → `Calendar`、`きっちぇn` → `Kitchen`、`Nかl` → `New Calendar`）。打鍵の表記は主要な IME のローマ字表（`ci`→し、`ce`→せ、`tch`→っち 等）に合わせている。
+- **phonetic**: ローマ字をかなに変換して照合する。ヘボン式・訓令式の同時照合、子音だけの入力、誤字の許容はこちら（`sinjuku` → `シンジュク`、`kmnr` → `カミナリ`）。
+
+同点のときは literal の結果を採る（ハイライトが入力した文字の位置になる）。
+
+### tier
+
+クエリは tier 1 から順に評価され、最初に一致した tier で確定する（既定は tier 1〜3。`maxTier: 4` で tier 4 も有効化）。`score` は 0〜1 で、上の tier ほど高い。
+
+| tier | 内容 | 例 | score の範囲（目安） |
+|---|---|---|---|
+| 1 | 直接一致（打った文字列がそのまま現れる、または各単語の頭文字に並ぶ） | `シンジュク`→`シンジュク` | 0.75〜1.0 |
+| 2 | 柔軟一致（とびとびでも可。語頭・連続を優遇、子音だけの入力も可） | `kmnr`→`カミナリ` | 0.5〜0.75 |
+| 3 | 誤字許容（編集距離、中間の置換/挿入/削除/入れ替え） | `センタイ`→`センダイ` | 0.25〜0.5 |
+| 4 | 構造類似（2 文字単位の重なりによる類似〔Tversky 係数〕、既定で無効） | 大きく崩れた入力 | 0〜0.25 |
+
+tier 1 の中は一致の位置で順位を分ける: item の先頭から（`co` → **Co**ffee）> 単語の頭から（Source **Co**de。空白・記号の後と、AutoCorrect のような大文字の区切りを単語の頭とする）> 各単語の頭文字（`ac` → **A**pple **C**ider、`goca` → **Go**ld **Ca**se）> 単語の途中（Dis**co**unt）。同じ段の中は短い item が上。
+
+各 tier は幅およそ 0.25 の帯に収まり、スコアが tier 間の境界（0.25 / 0.5 / 0.75）ちょうどになることはない。そのため閾値ひとつで「確実なヒット」と「あいまいな候補（『もしかして』表示向け）」を分離できる。結果は `score` 降順（同点は `refIndex` 昇順で安定）。
+
+## API
+
+### `search(query, items, options?)`
+
+単発検索。`createIndex(items, options).search(query)` と等価。
+
+### `createIndex(items, options?) → SearchIndex`
+
+事前構築した索引を返す。`index.search(query, searchOptions?)` で呼び出しごとに検索オプションを上書きできる。`index.size` で件数。
+
+### オプション
+
+構築時オプション（`createIndex` / `search` の `options`）:
+
+| 名前 | 型 | 既定 | 説明 |
+|---|---|---|---|
+| `getText` | `(item: T) => string` | なし | オブジェクト配列で検索対象文字列を取り出す（`T[]` のとき必須） |
+| `romaji` | `'hepburn' \| 'kunrei' \| 'both' \| false` | `'both'` | ローマ字照合の方式。`false` でローマ字照合せず、かなのみで照合 |
+| `matching` | `'literal' \| 'phonetic' \| 'both'` | `'both'` | クエリの照合経路（[照合経路](#照合経路matching)）。`'both'` は両方の score の高いほう |
+| `separatorExpansion` | `boolean \| string[]` | `false` | 区切り文字を、取り除いた形と区切りとして扱う形の両方で照合（`true` で `['-', ' ', '・', '_']`） |
+
+検索時オプション（`index.search` で上書き可）:
+
+| 名前 | 型 | 既定 | 説明 |
+|---|---|---|---|
+| `limit` | `number` | 無制限 | 返却件数の上限 |
+| `maxTier` | `1 \| 2 \| 3 \| 4` | `3` | 実行する tier の上限（`4` で構造類似の tier を有効化） |
+| `minScore` | `number` | `0` | この score 未満を除外 |
+| `includeMatches` | `boolean` | `false` | `matches` を含める |
+
+### 結果 `SearchResult<T>`
+
+```ts
+type SearchResult<T> = {
+  item: T;
+  refIndex: number;                       // items 内の位置
+  score: number;                          // 0〜1、高いほど良い
+  tier: 1 | 2 | 3 | 4;
+  matches?: readonly [number, number][];  // includeMatches 時、tier 1/2 のみ
+};
+```
+
+## 性能
+
+短い文字列の索引向け（数百〜数十万件）。内部の前段フィルタと早期打ち切りにより、1 クエリの実測値は千件で約 1.5ms、1 万件で約 10ms、10 万件で約 90ms（環境依存）。同条件で fuse.js より高速。英字の item をかなを含むクエリで探すときは打鍵の照合が加わり、1.5〜2 倍程度になる。`maxTier` を下げる、または `romaji` を一方の方式だけに絞ると更に軽くなる。索引構築は 10 万件で約 0.7 秒（一度きり）。
+
+## ライセンス
+
+MIT。ローマ字→かな変換に [WanaKana](https://github.com/WaniKani/WanaKana)（MIT）のコードを改変のうえ同梱している。詳細は [`THIRD_PARTY_NOTICES.md`](./THIRD_PARTY_NOTICES.md)。

package/THIRD_PARTY_NOTICES.md

@@ -1,13 +1,16 @@
 # Third-Party Notices
 
-yfuzzy bundles (vendors) source code from the following third-party project.
-The code has been ported to TypeScript and modified; see the header comment in
-`src/vendor/wanakana/` for the list of modifications.
+yfuzzy bundles (vendors) source code or data derived from the following
+third-party projects.
 
 ---
 
 ## WanaKana
 
+The code has been ported to TypeScript and modified; see the header comment in
+`src/vendor/wanakana/` for the list of modifications.
+
+
 - Project: https://github.com/WaniKani/WanaKana
 - Version vendored: 5.3.1
 - Files derived from: `src/toKana.js`, `src/utils/kanaMapping.js`,
@@ -36,3 +39,46 @@ COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
 IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 ```
+
+---
+
+## Mozc
+
+The keystroke table in `src/keystroke.ts` was aligned with the Mozc romaji
+table: the romaji spellings it accepts that differ from WanaKana (for example
+`ci`, `ce`, `qu`, `nn`, `tch`) were taken from it.
+
+- Project: https://github.com/google/mozc
+- Data referenced: `src/data/preedit/romanji-hiragana.tsv`
+- Used in: `src/keystroke.ts`
+
+```
+Copyright 2010-2018, Google Inc.
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions are
+met:
+
+  * Redistributions of source code must retain the above copyright
+    notice, this list of conditions and the following disclaimer.
+  * Redistributions in binary form must reproduce the above
+    copyright notice, this list of conditions and the following disclaimer
+    in the documentation and/or other materials provided with the
+    distribution.
+  * Neither the name of Google Inc. nor the names of its
+    contributors may be used to endorse or promote products derived from
+    this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+```

package/dist/entry.d.ts

@@ -9,8 +9,15 @@ export interface IndexEntry {
     readonly raw: string;
     /** 正規化カナ形 + normMap */
     readonly kana: Normalized;
-    /** かな空間の境界位置（spec 2.6） */
+    /** かな空間の境界位置 = 単語の頭（spec 2.6） */
     readonly kanaBoundaries: ReadonlySet<number>;
+    /** romaji 空間の単語の頭（単語の頭のかなから始まる音節の先頭。tier 1 の段、spec 4.1） */
+    readonly kunreiHeads: ReadonlySet<number>;
+    readonly hepburnHeads: ReadonlySet<number>;
+    /** 上の各単語の頭の昇順の一覧（tier 1 の頭文字の一致用） */
+    readonly kanaHeadList: readonly number[];
+    readonly kunreiHeadList: readonly number[];
+    readonly hepburnHeadList: readonly number[];
     /** 各空間の文字集合マスク（前置フィルタ用、空間が無効なら 0） */
     readonly kanaMask: number;
     readonly kunreiMask: number;
@@ -19,6 +26,8 @@ export interface IndexEntry {
     readonly kunrei: RomajiForm | null;
     /** ヘボン式 RomajiForm（romaji オプションで無効時 null） */
     readonly hepburn: RomajiForm | null;
+    /** 打鍵の文字（英小文字・'・-）を含むか。含まなければ打鍵ラティスの打鍵経路は一致し得ない */
+    readonly hasKeystrokeChar: boolean;
     /** bigram 集合（tier 4 用、遅延生成） */
     bigrams: Set<string> | null;
 }

package/dist/entry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAI9E,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,0BAA0B;IAC1B,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7C,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,+BAA+B;IAC/B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAC7B;AAED,yBAAyB;AACzB,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,CAgB1F;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAG5D"}
+{"version":3,"file":"entry.d.ts","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EAKL,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAgC,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAI9E,8BAA8B;AAC9B,MAAM,WAAW,UAAU;IACzB,iBAAiB;IACjB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,sCAAsC;IACtC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,uBAAuB;IACvB,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,iCAAiC;IACjC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC7C,2DAA2D;IAC3D,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC3C,qCAAqC;IACrC,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,qCAAqC;IACrC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;IACnC,6CAA6C;IAC7C,QAAQ,CAAC,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;IACpC,mDAAmD;IACnD,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC,+BAA+B;IAC/B,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CAC7B;AA8BD,yBAAyB;AACzB,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,GAAG,UAAU,CAyB1F;AAED,wCAAwC;AACxC,wBAAgB,aAAa,CAAC,KAAK,EAAE,UAAU,GAAG,GAAG,CAAC,MAAM,CAAC,CAG5D"}

package/dist/entry.js

@@ -5,21 +5,59 @@ import { KUNREI, HEPBURN, kunreiEnabled, hepburnEnabled, } from './romaji/conver
 import { toRomajiForm, kanaBoundaries } from './syllable.js';
 import { generateBigrams } from './bigram.js';
 import { charMask } from './charmask.js';
+const ASCII_LETTER = /[a-z]/;
+/** 単語の頭（spec 2.6）: かな空間の境界に、元の文字列で英小文字の直後の英大文字を加える */
+function wordHeads(kana, raw) {
+    const heads = kanaBoundaries(kana.text);
+    const t = kana.text;
+    const at = (i) => raw.slice(kana.map[i][0], kana.map[i][1]);
+    for (let i = 1; i < t.length; i++) {
+        if (!ASCII_LETTER.test(t[i]) || !ASCII_LETTER.test(t[i - 1]))
+            continue;
+        const cur = at(i);
+        const prev = at(i - 1);
+        if (cur !== cur.toLowerCase() && prev === prev.toLowerCase())
+            heads.add(i);
+    }
+    return heads;
+}
+/** romaji 空間の単語の頭: 単語の頭のかなから始まる音節の先頭位置 */
+function romajiHeads(form, heads) {
+    const out = new Set();
+    if (form === null)
+        return out;
+    for (const s of form.syllables)
+        if (heads.has(s.kanaStart))
+            out.add(s.romajiStart);
+    return out;
+}
+function sorted(set) {
+    return [...set].sort((a, b) => a - b);
+}
 /** 1 item からエントリを構築する */
 export function buildEntry(raw, refIndex, romaji) {
     const kana = normalize(raw);
     const kunrei = kunreiEnabled(romaji) ? toRomajiForm(kana.text, KUNREI) : null;
     const hepburn = hepburnEnabled(romaji) ? toRomajiForm(kana.text, HEPBURN) : null;
+    const heads = wordHeads(kana, raw);
+    const kunreiHeads = romajiHeads(kunrei, heads);
+    const hepburnHeads = romajiHeads(hepburn, heads);
     return {
         refIndex,
         raw,
         kana,
-        kanaBoundaries: kanaBoundaries(kana.text),
+        kanaBoundaries: heads,
+        kunreiHeads,
+        hepburnHeads,
+        kanaHeadList: sorted(heads),
+        kunreiHeadList: sorted(kunreiHeads),
+        hepburnHeadList: sorted(hepburnHeads),
         kanaMask: charMask(kana.text),
         kunreiMask: kunrei ? charMask(kunrei.text) : 0,
         hepburnMask: hepburn ? charMask(hepburn.text) : 0,
         kunrei,
         hepburn,
+        hasKeystrokeChar: /[a-z'-]/.test(kana.text),
         bigrams: null,
     };
 }

package/dist/entry.js.map

@@ -1 +1 @@
-{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,yDAAyD;AAEzD,OAAO,EAAE,SAAS,EAAmB,MAAM,gBAAgB,CAAC;AAC5D,OAAO,EACL,MAAM,EACN,OAAO,EACP,aAAa,EACb,cAAc,GAEf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,YAAY,EAAE,cAAc,EAAmB,MAAM,eAAe,CAAC;AAC9E,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAwBzC,yBAAyB;AACzB,MAAM,UAAU,UAAU,CAAC,GAAW,EAAE,QAAgB,EAAE,MAAoB;IAC5E,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;IAC5B,MAAM,MAAM,GAAG,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9E,MAAM,OAAO,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACjF,OAAO;QACL,QAAQ;QACR,GAAG;QACH,IAAI;QACJ,cAAc,EAAE,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QACzC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7B,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QAC9C,WAAW,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM;QACN,OAAO;QACP,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,wCAAwC;AACxC,MAAM,UAAU,aAAa,CAAC,KAAiB;IAC7C,IAAI,KAAK,CAAC,OAAO,KAAK,IAAI;QAAE,KAAK,CAAC,OAAO,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC7E,OAAO,KAAK,CAAC,OAAO,CAAC;AACvB,CAAC"}
+{"version":3,"file":"entry.js","sourceRoot":"","sources":["../src/entry.ts"],"names":[],"mappings":"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"}

package/dist/expand.d.ts

@@ -3,7 +3,7 @@ export type SeparatorConfig = boolean | readonly string[];
 /** true 指定時のデフォルト separator セット */
 export declare const DEFAULT_SEPARATORS: readonly string[];
 /**
- * クエリ raw を展開経路へ。順序は (c) リテラル → (a) 除去 → (b) 境界。
+ * クエリ raw を展開経路へ。順序は (c) 原文 → (a) 除去 → (b) 境界。
  * - separator を含まない / 無効化時は [raw] のみ
  * - 末尾に separator がある場合は (a) 除去経路を生成しない（入力継続中シグナル、過剰マッチ回避）
  * - 重複・空文字列は除外（(c) は raw が空でも保持しない＝呼び出し側が空クエリ判定）

package/dist/expand.js

@@ -1,6 +1,6 @@
 // separatorExpansion（spec 3章）。クエリを最大3経路に展開する。
 // 展開は「追加」であって置換ではない。経路の順序は同点タイブレーク順（spec 5章）:
-//   (c) リテラル経路（常設）> (a) 除去経路 > (b) 境界経路。
+//   (c) 原文経路（常設）> (a) 除去経路 > (b) 境界経路。
 // データ側は展開しない（separator は 2.6 の境界として効く）。
 /** true 指定時のデフォルト separator セット */
 export const DEFAULT_SEPARATORS = ['-', ' ', '・', '_'];
@@ -16,7 +16,7 @@ function escapeForCharClass(ch) {
     return ch.replace(/[\\\]^-]/g, '\\$&');
 }
 /**
- * クエリ raw を展開経路へ。順序は (c) リテラル → (a) 除去 → (b) 境界。
+ * クエリ raw を展開経路へ。順序は (c) 原文 → (a) 除去 → (b) 境界。
  * - separator を含まない / 無効化時は [raw] のみ
  * - 末尾に separator がある場合は (a) 除去経路を生成しない（入力継続中シグナル、過剰マッチ回避）
  * - 重複・空文字列は除外（(c) は raw が空でも保持しない＝呼び出し側が空クエリ判定）
@@ -37,7 +37,7 @@ export function expandQuery(raw, config) {
             paths.push(s);
         }
     };
-    // (c) リテラル
+    // (c) 原文
     push(raw);
     // (a) 除去（末尾 separator のときはスキップ）
     const lastCp = [...raw].at(-1);

package/dist/expand.js.map

@@ -1 +1 @@
-{"version":3,"file":"expand.js","sourceRoot":"","sources":["../src/expand.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,8CAA8C;AAC9C,yCAAyC;AACzC,wCAAwC;AAKxC,mCAAmC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE1E,SAAS,iBAAiB,CAAC,MAAuB;IAChD,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACxD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,kBAAkB,CAAC;IAC/C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wBAAwB;AACxB,SAAS,kBAAkB,CAAC,EAAU;IACpC,OAAO,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,MAAuB;IAC9D,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAE5D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC;IAE5C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAErD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,CAAS,EAAQ,EAAE;QAC/B,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;IAEF,WAAW;IACX,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,gCAAgC;IAChC,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;IAChC,MAAM,iBAAiB,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAE9B,OAAO,KAAK,CAAC;AACf,CAAC"}
+{"version":3,"file":"expand.js","sourceRoot":"","sources":["../src/expand.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,8CAA8C;AAC9C,uCAAuC;AACvC,wCAAwC;AAKxC,mCAAmC;AACnC,MAAM,CAAC,MAAM,kBAAkB,GAAsB,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC;AAE1E,SAAS,iBAAiB,CAAC,MAAuB;IAChD,IAAI,MAAM,KAAK,KAAK,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACxD,IAAI,MAAM,KAAK,IAAI;QAAE,OAAO,kBAAkB,CAAC;IAC/C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,wBAAwB;AACxB,SAAS,kBAAkB,CAAC,EAAU;IACpC,OAAO,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,WAAW,CAAC,GAAW,EAAE,MAAuB;IAC9D,MAAM,UAAU,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAE5D,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC1D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,KAAK,GAAG,EAAE,GAAG,CAAC,CAAC;IAE5C,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;IAErD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,GAAG,EAAU,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,CAAS,EAAQ,EAAE;QAC/B,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACZ,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAChB,CAAC;IACH,CAAC,CAAC;IAEF,SAAS;IACT,IAAI,CAAC,GAAG,CAAC,CAAC;IAEV,gCAAgC;IAChC,MAAM,MAAM,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;IAChC,MAAM,iBAAiB,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACtD,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC;IAC/B,CAAC;IAED,6BAA6B;IAC7B,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;IAE9B,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import type { IndexOptions, SearchOptions, SearchResult, SearchIndex } from './types.js';
-export type { IndexOptions, SearchOptions, SearchResult, SearchIndex, RomajiOption, SeparatorConfig, } from './types.js';
+export type { IndexOptions, SearchOptions, SearchResult, SearchIndex, RomajiOption, SeparatorConfig, MatchingOption, } from './types.js';
 export declare function createIndex(items: readonly string[], options?: IndexOptions<string> & SearchOptions): SearchIndex<string>;
 export declare function createIndex<T>(items: readonly T[], options: IndexOptions<T> & SearchOptions & {
     getText: (item: T) => string;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,YAAY,CAAC;AAsBpB,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,aAAa,GAC7C,WAAW,CAAC,MAAM,CAAC,CAAC;AACvB,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;CAAE,GAC1E,WAAW,CAAC,CAAC,CAAC,CAAC;AA4ClB,wBAAgB,MAAM,CACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,aAAa,GAC7C,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1B,wBAAgB,MAAM,CAAC,CAAC,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;CAAE,GAC1E,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,EACf,cAAc,GACf,MAAM,YAAY,CAAC;AAwBpB,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,aAAa,GAC7C,WAAW,CAAC,MAAM,CAAC,CAAC;AACvB,wBAAgB,WAAW,CAAC,CAAC,EAC3B,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;CAAE,GAC1E,WAAW,CAAC,CAAC,CAAC,CAAC;AA6ClB,wBAAgB,MAAM,CACpB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,OAAO,CAAC,EAAE,YAAY,CAAC,MAAM,CAAC,GAAG,aAAa,GAC7C,YAAY,CAAC,MAAM,CAAC,EAAE,CAAC;AAC1B,wBAAgB,MAAM,CAAC,CAAC,EACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,SAAS,CAAC,EAAE,EACnB,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,aAAa,GAAG;IAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,MAAM,CAAA;CAAE,GAC1E,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC"}