disarm 0.15.0 → 0.16.0

package/binding.d.ts

@@ -27,6 +27,17 @@ export declare class Lexicon {
 export declare class Pipeline {
   /** Run the named pipeline over `text`, returning the cleaned string. */
   process(text: string): string
+  /**
+   * What the named profile this was built from is for, in one sentence (#860).
+   * `null` for a pipeline not built from a profile.
+   */
+  get purpose(): string | null
+  /**
+   * A copy of this pipeline whose confusable passes fold under `digitPolicy` (#646).
+   * Throws when the profile has no confusables step and the policy is not the default:
+   * a setting that would never run is refused rather than kept.
+   */
+  withDigitPolicy(digitPolicy: string): Pipeline
 }
 
 /**
@@ -71,7 +82,7 @@ export interface AutoLangInspection {
  * WHEN the word also carries an ASCII letter, which is the gate that keeps ordinary
  * non-Latin text from firing; a delimiter-only string is not reported.
  */
-export declare function canonicalize(text: string): string
+export declare function canonicalize(text: string, digitPolicy: string): string
 
 /**
  * Strip the non-interchange and invisible classes while KEEPING the script (#698).
@@ -88,17 +99,36 @@ export declare function canonicalize(text: string): string
  * — the point of the preset.
  * Canonicalize, but fail rather than silently normalize a structural difference away.
  */
-export declare function canonicalizeStrict(text: string): string
+export declare function canonicalizeStrict(text: string, digitPolicy: string): string
 
 /**
  * Library catalog deduplication key (like `searchKey` plus confusable folding).
  * `lang` selects the transliteration table; `strict_iso9` picks the ISO 9:1995
  * Cyrillic scheme.
  */
-export declare function catalogKey(text: string, lang: string | undefined | null, strictIso9: boolean): string
+export declare function catalogKey(text: string, lang: string | undefined | null, strictIso9: boolean, digitPolicy: string): string
 
 export declare function collapseWhitespace(text: string): string
 
+/**
+ * TR39 sources whose prototype is in `script`, and how many the bundled tables fold
+ * (#963). The denominator `unmappedConfusables` does not have: it measures one table
+ * against the whole source population, so a script disarm ships no table for reports a
+ * number determined by that absence. An unknown name raises a
+ * `DisarmInvalidArgument`-tagged error.
+ */
+export declare function confusableCoverage(script: string): ConfusableCoverage
+
+/** Per-script confusable coverage — the fair denominator (#963). */
+export interface ConfusableCoverage {
+  /** The script the figures are about, in disarm's spelling. */
+  script: string
+  /** TR39 sources whose prototype is in this script. */
+  sources: number
+  /** How many of those `sources` a bundled fold table reaches. */
+  folded: number
+}
+
 export declare function confusablesVersion(): string
 
 /** Replace emoji with their plain names; `strip_modifiers` drops skin-tone marks. */
@@ -110,6 +140,9 @@ export declare function demojize(text: string, stripModifiers: boolean): string
  */
 export declare function detectScripts(text: string): Array<string>
 
+/** Levenshtein edit distance between `a` and `b`, in characters (#894). */
+export declare function editDistance(a: string, b: string): number
+
 /** One reason a token is anomalous (a single finding). */
 export interface Finding {
   /** Which branch fired: `"invisible"` | `"bidi"` | `"zalgo"` | `"mixed_script"` | `"bidi_mixed"` | `"leet"` | `"segmentation"`. */
@@ -256,6 +289,9 @@ export declare function inspectAnomalies(text: string, lexicon: Array<string> |
 /** Explain how auto-language detection resolves `text`. */
 export declare function inspectAutoLang(text: string): AutoLangInspection
 
+/** Whether `text` is already its own canonical form under `preset` (#730). */
+export declare function isCanonical(text: string, preset: string): boolean
+
 /**
  * Whether case folding and simple lowercasing agree, so the value is a stable
  * identity key (#619).
@@ -336,12 +372,34 @@ export declare function listScripts(): Array<string>
  */
 export declare function mlNormalize(text: string, lang: string | undefined | null, emojiStyle: string, foldCase: boolean): string
 
+/**
+ * The candidate closest to `value`, with its distance, or `null` beyond `max_distance`
+ * (#894). An exact match is reported with distance 0; ties go to the first candidate at
+ * the lowest distance.
+ */
+export declare function nearestMatch(value: string, candidates: Array<string>, maxDistance: number): NearestMatch | null
+
+/** A candidate and how far `nearestMatch` found it from the value asked about (#894). */
+export interface NearestMatch {
+  /** The candidate, in the spelling the caller supplied. */
+  value: string
+  /** Its edit distance from the value asked about; `0` means the value *is* this candidate. */
+  distance: number
+}
+
 /** Apply a normalization form: `"NFC"` | `"NFD"` | `"NFKC"` | `"NFKD"`. */
 export declare function normalize(text: string, form: string): string
 
 /** Fold cross-script confusables toward `target` (`"latin"` | `"cyrillic"` | `"arabic"` | `"hebrew"`). */
 export declare function normalizeConfusables(text: string, target: string, digitPolicy: string): string
 
+/**
+ * Replace every emoji with `replacement`, verbatim (#972). The counterpart to
+ * `demojize`: that names an emoji from the CLDR table, which is wider than the emoji
+ * set, and this replaces what the UCD calls an emoji and nothing else.
+ */
+export declare function replaceEmoji(text: string, replacement: string): string
+
 /** Reverse-transliterate Latin → native script. `lang` is `"el"` | `"ru"` | `"uk"`. */
 export declare function reverseTransliterate(text: string, lang: string): string
 
@@ -379,7 +437,15 @@ export interface ScriptMeta {
  * Case/accent/script-insensitive search lookup key. `lang` selects the
  * transliteration table (omit for none).
  */
-export declare function searchKey(text: string, lang?: string | undefined | null): string
+export declare function searchKey(text: string, lang: string | undefined | null, digitPolicy: string): string
+
+/**
+ * The TR39 identifier skeleton plus the two prototype classes disarm's table keeps apart
+ * (#650). A spoof key: its only job is to make confusable identifiers collide, and its
+ * output is never for display. `digit_policy` is `"numeric"` (the letter half only),
+ * `"tr39"` (adds `1 ≡ l` and `0 ≡ O`) or `"preserve"`.
+ */
+export declare function skeletonKey(text: string, digitPolicy: string): string
 
 /** Generate a URL-safe slug. */
 export declare function slugify(text: string, opts: SlugOptions): string
@@ -404,7 +470,7 @@ export interface SlugOptions {
  * Collation sort key (like `searchKey` but preserves base accented characters
  * for correct ordering). `lang` selects the transliteration table.
  */
-export declare function sortKey(text: string, lang?: string | undefined | null): string
+export declare function sortKey(text: string, lang: string | undefined | null, digitPolicy: string): string
 
 export declare function stripAccents(text: string): string
 
@@ -417,7 +483,7 @@ export declare function stripFormat(text: string): string
 /** Strip every Unicode noncharacter (#413). */
 export declare function stripNoncharacters(text: string): string
 
-export declare function stripObfuscation(text: string): string
+export declare function stripObfuscation(text: string, digitPolicy: string): string
 
 /** Strip every Private Use Area code point (#413). */
 export declare function stripPua(text: string): string

package/binding.js

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('disarm-android-arm64')
         const bindingPackageVersion = require('disarm-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('disarm-android-arm-eabi')
         const bindingPackageVersion = require('disarm-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('disarm-win32-x64-gnu')
         const bindingPackageVersion = require('disarm-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('disarm-win32-x64-msvc')
         const bindingPackageVersion = require('disarm-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('disarm-win32-ia32-msvc')
         const bindingPackageVersion = require('disarm-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('disarm-win32-arm64-msvc')
         const bindingPackageVersion = require('disarm-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('disarm-darwin-universal')
       const bindingPackageVersion = require('disarm-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('disarm-darwin-x64')
         const bindingPackageVersion = require('disarm-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('disarm-darwin-arm64')
         const bindingPackageVersion = require('disarm-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('disarm-freebsd-x64')
         const bindingPackageVersion = require('disarm-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('disarm-freebsd-arm64')
         const bindingPackageVersion = require('disarm-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('disarm-linux-x64-musl')
           const bindingPackageVersion = require('disarm-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('disarm-linux-x64-gnu')
           const bindingPackageVersion = require('disarm-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('disarm-linux-arm64-musl')
           const bindingPackageVersion = require('disarm-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('disarm-linux-arm64-gnu')
           const bindingPackageVersion = require('disarm-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('disarm-linux-arm-musleabihf')
           const bindingPackageVersion = require('disarm-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('disarm-linux-arm-gnueabihf')
           const bindingPackageVersion = require('disarm-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('disarm-linux-loong64-musl')
           const bindingPackageVersion = require('disarm-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('disarm-linux-loong64-gnu')
           const bindingPackageVersion = require('disarm-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('disarm-linux-riscv64-musl')
           const bindingPackageVersion = require('disarm-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('disarm-linux-riscv64-gnu')
           const bindingPackageVersion = require('disarm-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('disarm-linux-ppc64-gnu')
         const bindingPackageVersion = require('disarm-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('disarm-linux-s390x-gnu')
         const bindingPackageVersion = require('disarm-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('disarm-openharmony-arm64')
         const bindingPackageVersion = require('disarm-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('disarm-openharmony-x64')
         const bindingPackageVersion = require('disarm-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('disarm-openharmony-arm')
         const bindingPackageVersion = require('disarm-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.15.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.15.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.16.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.16.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -594,9 +594,11 @@ module.exports.canonicalize = nativeBinding.canonicalize
 module.exports.canonicalizeStrict = nativeBinding.canonicalizeStrict
 module.exports.catalogKey = nativeBinding.catalogKey
 module.exports.collapseWhitespace = nativeBinding.collapseWhitespace
+module.exports.confusableCoverage = nativeBinding.confusableCoverage
 module.exports.confusablesVersion = nativeBinding.confusablesVersion
 module.exports.demojize = nativeBinding.demojize
 module.exports.detectScripts = nativeBinding.detectScripts
+module.exports.editDistance = nativeBinding.editDistance
 module.exports.findKeyCollisions = nativeBinding.findKeyCollisions
 module.exports.findUnmappedConfusables = nativeBinding.findUnmappedConfusables
 module.exports.findUntranslatable = nativeBinding.findUntranslatable
@@ -611,6 +613,7 @@ module.exports.hasBidiConflict = nativeBinding.hasBidiConflict
 module.exports.hasBidiControl = nativeBinding.hasBidiControl
 module.exports.inspectAnomalies = nativeBinding.inspectAnomalies
 module.exports.inspectAutoLang = nativeBinding.inspectAutoLang
+module.exports.isCanonical = nativeBinding.isCanonical
 module.exports.isCaseFoldStable = nativeBinding.isCaseFoldStable
 module.exports.isConfusable = nativeBinding.isConfusable
 module.exports.isMixedScript = nativeBinding.isMixedScript
@@ -622,12 +625,15 @@ module.exports.langInfo = nativeBinding.langInfo
 module.exports.listContextLangs = nativeBinding.listContextLangs
 module.exports.listScripts = nativeBinding.listScripts
 module.exports.mlNormalize = nativeBinding.mlNormalize
+module.exports.nearestMatch = nativeBinding.nearestMatch
 module.exports.normalize = nativeBinding.normalize
 module.exports.normalizeConfusables = nativeBinding.normalizeConfusables
+module.exports.replaceEmoji = nativeBinding.replaceEmoji
 module.exports.reverseTransliterate = nativeBinding.reverseTransliterate
 module.exports.sanitizeFilename = nativeBinding.sanitizeFilename
 module.exports.scriptInfo = nativeBinding.scriptInfo
 module.exports.searchKey = nativeBinding.searchKey
+module.exports.skeletonKey = nativeBinding.skeletonKey
 module.exports.slugify = nativeBinding.slugify
 module.exports.sortKey = nativeBinding.sortKey
 module.exports.stripAccents = nativeBinding.stripAccents

package/index.d.ts

@@ -1,6 +1,6 @@
 import { Lexicon, Pipeline } from './binding';
-import type { Untranslatable, UnmappedConfusable, AutoLangInspection, KeyCollision, LangMeta, ScriptMeta, Finding as NativeFinding, AnomalyReport as NativeAnomalyReport, HostnameAnalysis as NativeHostnameAnalysis } from './binding';
-export type { Untranslatable, UnmappedConfusable, AutoLangInspection, KeyCollision, LangMeta, ScriptMeta, };
+import type { Untranslatable, UnmappedConfusable, AutoLangInspection, KeyCollision, LangMeta, ScriptMeta, ConfusableCoverage, Finding as NativeFinding, AnomalyReport as NativeAnomalyReport, HostnameAnalysis as NativeHostnameAnalysis } from './binding';
+export type { Untranslatable, UnmappedConfusable, AutoLangInspection, KeyCollision, LangMeta, ScriptMeta, ConfusableCoverage, };
 /** Findings from {@link analyzeHostname}. `suspicious` is a maximally
  * conservative screen, not a precise verdict (#549). */
 export type HostnameAnalysis = NativeHostnameAnalysis;
@@ -25,7 +25,7 @@ export { Lexicon };
  */
 export { Pipeline };
 /** The anomaly branch that fired for a finding. */
-export type AnomalyKind = 'invisible' | 'bidi' | 'bidi_mixed' | 'zalgo' | 'mixed_script' | 'leet' | 'segmentation' | 'control' | 'compat_fold' | 'confusable' | 'enclosing_mark' | 'mixed_numbers' | 'duplicate_mark';
+export type AnomalyKind = 'invisible' | 'bidi' | 'bidi_mixed' | 'zalgo' | 'mixed_script' | 'leet' | 'segmentation' | 'control' | 'compat_fold' | 'confusable' | 'enclosing_mark' | 'mixed_numbers' | 'duplicate_mark' | 'deletion' | 'smuggled';
 /**
  * One reason a token is anomalous. Re-typed over the generated {@link NativeFinding}
  * so `kind` is the {@link AnomalyKind} string-union rather than a bare `string`.
@@ -93,6 +93,20 @@ export declare function normalizeConfusables(text: string, options?: {
     target?: TargetScript;
     digitPolicy?: DigitPolicy;
 }): string;
+/**
+ * Whether `text` is already its own canonical form under `preset` (#730).
+ *
+ * The verification-path counterpart to the presets: text in, normalized text out is the
+ * generation path, and this is the question a caller asks about bytes that arrive already
+ * bound. `hasAnomalies` is not this predicate — 142,760 assigned code points are reported
+ * clean by the detector and are not their own canonical form.
+ *
+ * `preset` is any name in the preset registry or any profile, defaulting to
+ * `'canonicalize'`. An unknown one throws {@link DisarmInvalidArgument}.
+ */
+export declare function isCanonical(text: string, options?: {
+    preset?: string;
+}): boolean;
 /** Whether `text` contains a character confusable with `target` (default `'latin'`). */
 export declare function isConfusable(text: string, options?: {
     target?: TargetScript;
@@ -173,6 +187,19 @@ export declare function findKeyCollisions(values: string[], key: CollisionKey, o
 export declare function demojize(text: string, options?: {
     stripModifiers?: boolean;
 }): string;
+/** Replace every emoji with `replacement`, verbatim (#972).
+ *
+ * The counterpart to {@link demojize}, and a different question of a different table.
+ * `demojize` asks *what does CLDR call this?*, so its domain is the CLDR name table,
+ * which is wider than the emoji: `demojize('x™y')` is `'x trade mark y'`. This asks *is
+ * this an emoji by the UCD's properties?* — `Emoji_Presentation=Yes`, an `Emoji=Yes` base
+ * carrying `U+FE0F`, and the ZWJ, modifier, keycap and flag sequences on those. Nothing
+ * else moves.
+ *
+ * `replacement` is inserted exactly as given, with no padding and no whitespace collapse:
+ * `''` closes an intra-word split (`aa🔥bb` → `aabb`) and `' '` keeps two words apart
+ * (`stop🛑now` → `stop now`), and no rule serves both. */
+export declare function replaceEmoji(text: string, replacement?: string): string;
 /** Apply a Unicode normalization `form` (default `'NFC'`). */
 export declare function normalize(text: string, options?: {
     form?: NormalizationForm;
@@ -219,7 +246,9 @@ export declare function isZalgo(text: string, options?: {
  * the half of the pair that lets a caller reject input instead of comparing a value the
  * sender never wrote.
  */
-export declare function canonicalizeStrict(text: string): string;
+export declare function canonicalizeStrict(text: string, options?: {
+    digitPolicy?: DigitPolicy;
+}): string;
 /**
  * Strip the non-interchange and invisible classes while KEEPING the script.
  *
@@ -231,7 +260,9 @@ export declare function canonicalizeStrict(text: string): string;
  */
 export declare function stripFormat(text: string): string;
 /** Remove obfuscation (zero-width, bidi, combining-mark abuse, homoglyphs) while keeping legible content. */
-export declare function stripObfuscation(text: string): string;
+export declare function stripObfuscation(text: string, options?: {
+    digitPolicy?: DigitPolicy;
+}): string;
 /**
  * Canonicalize text for security-sensitive comparison: NFKC → strip bidi/format
  * → strip invisible classes (#413) → strip control → strip zero-width → collapse
@@ -241,7 +272,9 @@ export declare function stripObfuscation(text: string): string;
  * The name describes the mechanism (Unicode canonicalization for matching), not
  * a safety guarantee — this is not an output sanitizer; encode at the sink.
  */
-export declare function canonicalize(text: string): string;
+export declare function canonicalize(text: string, options?: {
+    digitPolicy?: DigitPolicy;
+}): string;
 /**
  * @deprecated Renamed to {@link canonicalize} in 0.11 (the `*Clean` name
  * overpromised safety); removed in 1.0.
@@ -272,6 +305,7 @@ export declare function sanitizeFilename(text: string, options?: SanitizeFilenam
  */
 export declare function searchKey(text: string, options?: {
     lang?: string;
+    digitPolicy?: DigitPolicy;
 }): string;
 /**
  * Collation sort key — like {@link searchKey} but preserves base accented
@@ -279,6 +313,7 @@ export declare function searchKey(text: string, options?: {
  */
 export declare function sortKey(text: string, options?: {
     lang?: string;
+    digitPolicy?: DigitPolicy;
 }): string;
 /**
  * Library catalog deduplication key — like {@link searchKey} plus confusable
@@ -288,7 +323,38 @@ export declare function sortKey(text: string, options?: {
 export declare function catalogKey(text: string, options?: {
     lang?: string;
     strictIso9?: boolean;
+    digitPolicy?: DigitPolicy;
 }): string;
+/**
+ * The TR39 identifier skeleton plus the two prototype classes disarm's table keeps
+ * apart (#650). A spoof key: its only job is to make confusable identifiers collide,
+ * and its output is never for display. `digitPolicy` `'numeric'` (default) applies the
+ * letter half only; `'tr39'` adds `1 ≡ l` and `0 ≡ O`; `'preserve'` keeps a non-Latin
+ * numeral in its script.
+ */
+export declare function skeletonKey(text: string, options?: {
+    digitPolicy?: DigitPolicy;
+}): string;
+/**
+ * Levenshtein edit distance between `a` and `b`, in characters (#894) — the one class of
+ * registry spoofing the confusable tables deliberately do not model (`paypa1`, `adm1n`).
+ * Canonicalize both sides first when composed and decomposed spellings should compare
+ * equal.
+ */
+export declare function editDistance(a: string, b: string): number;
+/** A candidate and how far {@link nearestMatch} found it from the value asked about. */
+export interface NearestMatch {
+    value: string;
+    distance: number;
+}
+/**
+ * The candidate closest to `value`, with its distance, or `null` beyond `maxDistance`
+ * (default 1). Reports; it does not decide. An exact match is reported with distance 0,
+ * and ties go to the first candidate at the lowest distance (#894).
+ */
+export declare function nearestMatch(value: string, candidates: string[], options?: {
+    maxDistance?: number;
+}): NearestMatch | null;
 /** Options for {@link mlNormalize}. */
 export interface MlNormalizeOptions {
     /** Language code selecting the transliteration table; omit for none. */
@@ -370,6 +436,21 @@ export declare function langInfo(code: string): LangMeta;
  * unknown name throws {@link DisarmInvalidArgument}.
  */
 export declare function scriptInfo(name: string): ScriptMeta;
+/** TR39 sources whose prototype is in `script`, and how many of those disarm's bundled
+ * tables fold (#963).
+ *
+ * The denominator {@link unmappedConfusables} does not have. That function measures one
+ * bundled table against the whole 6,565-source population, which is the right question
+ * for a target disarm ships and a misleading one for a script it does not: Greek reports
+ * almost the entire population unmapped, and the number means only "there is no Greek
+ * table".
+ *
+ * `folded` counts sources any bundled table reaches, not sources folded *toward* this
+ * script — Greek is 71 of 159 because the Latin table folds Greek letters that look
+ * Latin. The grouping uses the UCD's script property, so `"Yi"` and 18 other scripts
+ * disarm's own enum does not name are addressable here. A script disarm knows that TR39
+ * never uses as a prototype returns 0 of 0. */
+export declare function confusableCoverage(script: string): ConfusableCoverage;
 /**
  * The UCD release disarm's normalizer implements. Not a library-wide Unicode version —
  * the bundled tables track different releases. This is the one integrators ask about,

package/index.js

@@ -38,6 +38,7 @@ exports.transliterate = transliterate;
 exports.reverseTransliterate = reverseTransliterate;
 exports.findUntranslatable = findUntranslatable;
 exports.normalizeConfusables = normalizeConfusables;
+exports.isCanonical = isCanonical;
 exports.isConfusable = isConfusable;
 exports.unmappedConfusables = unmappedConfusables;
 exports.findUnmappedConfusables = findUnmappedConfusables;
@@ -47,6 +48,7 @@ exports.foldCase = foldCase;
 exports.isCaseFoldStable = isCaseFoldStable;
 exports.findKeyCollisions = findKeyCollisions;
 exports.demojize = demojize;
+exports.replaceEmoji = replaceEmoji;
 exports.normalize = normalize;
 exports.isNormalized = isNormalized;
 exports.collapseWhitespace = collapseWhitespace;
@@ -69,6 +71,9 @@ exports.sanitizeFilename = sanitizeFilename;
 exports.searchKey = searchKey;
 exports.sortKey = sortKey;
 exports.catalogKey = catalogKey;
+exports.skeletonKey = skeletonKey;
+exports.editDistance = editDistance;
+exports.nearestMatch = nearestMatch;
 exports.mlNormalize = mlNormalize;
 exports.graphemeLen = graphemeLen;
 exports.graphemeSplit = graphemeSplit;
@@ -84,6 +89,7 @@ exports.hasBidiConflict = hasBidiConflict;
 exports.inspectAutoLang = inspectAutoLang;
 exports.langInfo = langInfo;
 exports.scriptInfo = scriptInfo;
+exports.confusableCoverage = confusableCoverage;
 exports.unicodeVersion = unicodeVersion;
 exports.keySchemaVersion = keySchemaVersion;
 exports.confusablesVersion = confusablesVersion;
@@ -167,6 +173,20 @@ function findUntranslatable(text, options = {}) {
 function normalizeConfusables(text, options = {}) {
     return call(() => native.normalizeConfusables(text, options.target ?? 'latin', options.digitPolicy ?? 'numeric'));
 }
+/**
+ * Whether `text` is already its own canonical form under `preset` (#730).
+ *
+ * The verification-path counterpart to the presets: text in, normalized text out is the
+ * generation path, and this is the question a caller asks about bytes that arrive already
+ * bound. `hasAnomalies` is not this predicate — 142,760 assigned code points are reported
+ * clean by the detector and are not their own canonical form.
+ *
+ * `preset` is any name in the preset registry or any profile, defaulting to
+ * `'canonicalize'`. An unknown one throws {@link DisarmInvalidArgument}.
+ */
+function isCanonical(text, options = {}) {
+    return call(() => native.isCanonical(text, options.preset ?? 'canonicalize'));
+}
 /** Whether `text` contains a character confusable with `target` (default `'latin'`). */
 function isConfusable(text, options = {}) {
     return call(() => native.isConfusable(text, options.target ?? 'latin'));
@@ -252,6 +272,21 @@ function findKeyCollisions(values, key, options = {}) {
 function demojize(text, options = {}) {
     return native.demojize(text, options.stripModifiers ?? false);
 }
+/** Replace every emoji with `replacement`, verbatim (#972).
+ *
+ * The counterpart to {@link demojize}, and a different question of a different table.
+ * `demojize` asks *what does CLDR call this?*, so its domain is the CLDR name table,
+ * which is wider than the emoji: `demojize('x™y')` is `'x trade mark y'`. This asks *is
+ * this an emoji by the UCD's properties?* — `Emoji_Presentation=Yes`, an `Emoji=Yes` base
+ * carrying `U+FE0F`, and the ZWJ, modifier, keycap and flag sequences on those. Nothing
+ * else moves.
+ *
+ * `replacement` is inserted exactly as given, with no padding and no whitespace collapse:
+ * `''` closes an intra-word split (`aa🔥bb` → `aabb`) and `' '` keeps two words apart
+ * (`stop🛑now` → `stop now`), and no rule serves both. */
+function replaceEmoji(text, replacement = '') {
+    return native.replaceEmoji(text, replacement);
+}
 // ── Normalization ───────────────────────────────────────────────────────────
 /** Apply a Unicode normalization `form` (default `'NFC'`). */
 function normalize(text, options = {}) {
@@ -317,8 +352,8 @@ function isZalgo(text, options = {}) {
  * the half of the pair that lets a caller reject input instead of comparing a value the
  * sender never wrote.
  */
-function canonicalizeStrict(text) {
-    return call(() => native.canonicalizeStrict(text));
+function canonicalizeStrict(text, options = {}) {
+    return call(() => native.canonicalizeStrict(text, options.digitPolicy ?? 'numeric'));
 }
 /**
  * Strip the non-interchange and invisible classes while KEEPING the script.
@@ -333,8 +368,8 @@ function stripFormat(text) {
     return native.stripFormat(text);
 }
 /** Remove obfuscation (zero-width, bidi, combining-mark abuse, homoglyphs) while keeping legible content. */
-function stripObfuscation(text) {
-    return call(() => native.stripObfuscation(text));
+function stripObfuscation(text, options = {}) {
+    return call(() => native.stripObfuscation(text, options.digitPolicy ?? 'numeric'));
 }
 /**
  * Canonicalize text for security-sensitive comparison: NFKC → strip bidi/format
@@ -345,8 +380,8 @@ function stripObfuscation(text) {
  * The name describes the mechanism (Unicode canonicalization for matching), not
  * a safety guarantee — this is not an output sanitizer; encode at the sink.
  */
-function canonicalize(text) {
-    return call(() => native.canonicalize(text));
+function canonicalize(text, options = {}) {
+    return call(() => native.canonicalize(text, options.digitPolicy ?? 'numeric'));
 }
 /**
  * @deprecated Renamed to {@link canonicalize} in 0.11 (the `*Clean` name
@@ -377,14 +412,14 @@ function sanitizeFilename(text, options = {}) {
  * without confusable folding). `lang` selects the transliteration table.
  */
 function searchKey(text, options = {}) {
-    return call(() => native.searchKey(text, options.lang ?? undefined));
+    return call(() => native.searchKey(text, options.lang ?? undefined, options.digitPolicy ?? 'numeric'));
 }
 /**
  * Collation sort key — like {@link searchKey} but preserves base accented
  * characters for correct ordering. `lang` selects the transliteration table.
  */
 function sortKey(text, options = {}) {
-    return call(() => native.sortKey(text, options.lang ?? undefined));
+    return call(() => native.sortKey(text, options.lang ?? undefined, options.digitPolicy ?? 'numeric'));
 }
 /**
  * Library catalog deduplication key — like {@link searchKey} plus confusable
@@ -392,7 +427,34 @@ function sortKey(text, options = {}) {
  * `false`) picks the ISO 9:1995 Cyrillic scheme.
  */
 function catalogKey(text, options = {}) {
-    return call(() => native.catalogKey(text, options.lang ?? undefined, options.strictIso9 ?? false));
+    return call(() => native.catalogKey(text, options.lang ?? undefined, options.strictIso9 ?? false, options.digitPolicy ?? 'numeric'));
+}
+/**
+ * The TR39 identifier skeleton plus the two prototype classes disarm's table keeps
+ * apart (#650). A spoof key: its only job is to make confusable identifiers collide,
+ * and its output is never for display. `digitPolicy` `'numeric'` (default) applies the
+ * letter half only; `'tr39'` adds `1 ≡ l` and `0 ≡ O`; `'preserve'` keeps a non-Latin
+ * numeral in its script.
+ */
+function skeletonKey(text, options = {}) {
+    return call(() => native.skeletonKey(text, options.digitPolicy ?? 'numeric'));
+}
+/**
+ * Levenshtein edit distance between `a` and `b`, in characters (#894) — the one class of
+ * registry spoofing the confusable tables deliberately do not model (`paypa1`, `adm1n`).
+ * Canonicalize both sides first when composed and decomposed spellings should compare
+ * equal.
+ */
+function editDistance(a, b) {
+    return native.editDistance(a, b);
+}
+/**
+ * The candidate closest to `value`, with its distance, or `null` beyond `maxDistance`
+ * (default 1). Reports; it does not decide. An exact match is reported with distance 0,
+ * and ties go to the first candidate at the lowest distance (#894).
+ */
+function nearestMatch(value, candidates, options = {}) {
+    return call(() => native.nearestMatch(value, candidates, options.maxDistance ?? 1)) ?? null;
 }
 /**
  * ML/NLP normalization: NFKC → emoji→text → transliterate → strip accents →
@@ -487,6 +549,23 @@ function langInfo(code) {
 function scriptInfo(name) {
     return call(() => native.scriptInfo(name));
 }
+/** TR39 sources whose prototype is in `script`, and how many of those disarm's bundled
+ * tables fold (#963).
+ *
+ * The denominator {@link unmappedConfusables} does not have. That function measures one
+ * bundled table against the whole 6,565-source population, which is the right question
+ * for a target disarm ships and a misleading one for a script it does not: Greek reports
+ * almost the entire population unmapped, and the number means only "there is no Greek
+ * table".
+ *
+ * `folded` counts sources any bundled table reaches, not sources folded *toward* this
+ * script — Greek is 71 of 159 because the Latin table folds Greek letters that look
+ * Latin. The grouping uses the UCD's script property, so `"Yi"` and 18 other scripts
+ * disarm's own enum does not name are addressable here. A script disarm knows that TR39
+ * never uses as a prototype returns 0 of 0. */
+function confusableCoverage(script) {
+    return call(() => native.confusableCoverage(script));
+}
 /**
  * The UCD release disarm's normalizer implements. Not a library-wide Unicode version —
  * the bundled tables track different releases. This is the one integrators ask about,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "disarm",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Unicode confusable/text-security building blocks, powered by Rust",
   "main": "index.js",
   "types": "index.d.ts",