@fulmenhq/tsfulmen 0.1.13 → 0.2.0

package/dist/similarity/index.d.ts

@@ -0,0 +1,2 @@
+export { SimilarityError, VERSION } from '../foundry/similarity/index.js';
+export { M as MetricType, g as NormalizationPreset, N as NormalizeOptions, a as SuggestOptions, S as Suggestion, c as casefold, d as distance, e as equalsIgnoreCase, n as normalize, s as score, b as stripAccents, f as suggest } from '../suggest-D8LbwtPV.js';

package/dist/similarity/index.js

@@ -0,0 +1,136 @@
+import { substringSimilarity, jaro_winkler, damerau_levenshtein, osa_distance, levenshtein, normalize as normalize$1, score as score$1, suggest as suggest$1 } from '@3leaps/string-metrics-wasm';
+
+// src/foundry/similarity/distance.ts
+function distance(a, b, metric = "levenshtein") {
+  switch (metric) {
+    case "levenshtein":
+      return levenshtein(a, b);
+    case "damerau_osa":
+      return osa_distance(a, b);
+    case "damerau_unrestricted":
+      return damerau_levenshtein(a, b);
+    case "jaro_winkler":
+      return jaro_winkler(a, b);
+    case "substring":
+      return substringSimilarity(a, b).score;
+    default:
+      throw new Error(
+        `Invalid metric '${metric}': must be one of: levenshtein, damerau_osa, damerau_unrestricted, jaro_winkler, substring`
+      );
+  }
+}
+
+// src/foundry/errors.ts
+var FoundryCatalogError = class _FoundryCatalogError extends Error {
+  constructor(message, catalog, cause) {
+    super(message);
+    this.catalog = catalog;
+    this.cause = cause;
+    this.name = "FoundryCatalogError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _FoundryCatalogError);
+    }
+  }
+  static invalidSchema(catalog, details, cause) {
+    return new _FoundryCatalogError(
+      `Invalid schema in ${catalog} catalog: ${details}`,
+      catalog,
+      cause
+    );
+  }
+  static missingCatalog(catalog) {
+    return new _FoundryCatalogError(`Catalog ${catalog} not found or could not be loaded`, catalog);
+  }
+  static invalidPattern(patternId, details) {
+    return new _FoundryCatalogError(`Invalid pattern ${patternId}: ${details}`, "patterns");
+  }
+  static compilationError(patternId, details, cause) {
+    return new _FoundryCatalogError(
+      `Failed to compile pattern ${patternId}: ${details}`,
+      "patterns",
+      cause
+    );
+  }
+};
+
+// src/foundry/similarity/errors.ts
+var SimilarityError = class extends FoundryCatalogError {
+  constructor(message, cause) {
+    super(message, "similarity", cause);
+    this.name = "SimilarityError";
+  }
+};
+function toNormalizationLocale(locale) {
+  if (!locale) {
+    return void 0;
+  }
+  if (locale === "tr" || locale === "az" || locale === "lt") {
+    return locale;
+  }
+  return void 0;
+}
+function normalize(value, preset = "default", locale) {
+  if (typeof preset === "object") {
+    const targetPreset = preset.stripAccents ? "aggressive" : "default";
+    const targetLocale = toNormalizationLocale(preset.locale ?? locale);
+    return normalize$1(value, targetPreset, targetLocale);
+  }
+  return normalize$1(value, preset, toNormalizationLocale(locale));
+}
+function casefold(value, locale) {
+  if (locale === "tr") {
+    return value.toLocaleLowerCase("tr-TR");
+  }
+  return value.toLowerCase();
+}
+function stripAccents(value) {
+  return value.normalize("NFD").replace(/[\u0300-\u036f]/g, "");
+}
+function equalsIgnoreCase(a, b, options) {
+  return normalize(a, options) === normalize(b, options);
+}
+function score(a, b, metric = "levenshtein") {
+  if (metric === "substring") {
+    return substringSimilarity(a, b).score;
+  }
+  return score$1(a, b, metric);
+}
+var DEFAULT_MIN_SCORE = 0.6;
+var DEFAULT_MAX_SUGGESTIONS = 3;
+var DEFAULT_METRIC = "levenshtein";
+var DEFAULT_NORMALIZE_PRESET = "default";
+function suggest(input, candidates, options) {
+  const metric = options?.metric ?? DEFAULT_METRIC;
+  const minScore = options?.minScore ?? DEFAULT_MIN_SCORE;
+  const maxSuggestions = options?.maxSuggestions ?? DEFAULT_MAX_SUGGESTIONS;
+  let normalizePreset = options?.normalizePreset ?? DEFAULT_NORMALIZE_PRESET;
+  if (options?.normalize === false) {
+    normalizePreset = "none";
+  } else if (options?.normalize === true && !options?.normalizePreset) {
+    normalizePreset = "default";
+  }
+  const wasmOptions = {
+    metric,
+    normalizePreset,
+    minScore,
+    maxSuggestions,
+    preferPrefix: options?.preferPrefix,
+    jaroPrefixScale: options?.jaroPrefixScale,
+    jaroMaxPrefix: options?.jaroMaxPrefix
+  };
+  const results = suggest$1(input, candidates, wasmOptions);
+  return results.map((r) => ({
+    value: r.value,
+    score: r.score,
+    matchedRange: r.matchedRange,
+    reason: r.reason,
+    normalizedValue: r.normalizedValue
+  }));
+}
+
+// src/foundry/similarity/index.ts
+var VERSION = "2.0.0";
+
+export { SimilarityError, VERSION, casefold, distance, equalsIgnoreCase, normalize, score, stripAccents, suggest };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/similarity/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/foundry/similarity/distance.ts","../../src/foundry/errors.ts","../../src/foundry/similarity/errors.ts","../../src/foundry/similarity/normalization.ts","../../src/foundry/similarity/score.ts","../../src/foundry/similarity/suggest.ts","../../src/foundry/similarity/index.ts"],"names":["wasmNormalize","substringSimilarity","wasmScore","wasmSuggest"],"mappings":";;;AA+BO,SAAS,QAAA,CAAS,CAAA,EAAW,CAAA,EAAW,MAAA,GAAqB,aAAA,EAAuB;AACzF,EAAA,QAAQ,MAAA;AAAQ,IACd,KAAK,aAAA;AACH,MAAA,OAAO,WAAA,CAAY,GAAG,CAAC,CAAA;AAAA,IACzB,KAAK,aAAA;AACH,MAAA,OAAO,YAAA,CAAa,GAAG,CAAC,CAAA;AAAA,IAC1B,KAAK,sBAAA;AACH,MAAA,OAAO,mBAAA,CAAoB,GAAG,CAAC,CAAA;AAAA,IACjC,KAAK,cAAA;AACH,MAAA,OAAO,YAAA,CAAa,GAAG,CAAC,CAAA;AAAA,IAC1B,KAAK,WAAA;AAEH,MAAA,OAAO,mBAAA,CAAoB,CAAA,EAAG,CAAC,CAAA,CAAE,KAAA;AAAA,IACnC;AACE,MAAA,MAAM,IAAI,KAAA;AAAA,QACR,mBAAmB,MAAM,CAAA,0FAAA;AAAA,OAC3B;AAAA;AAEN;;;AC3CO,IAAM,mBAAA,GAAN,MAAM,oBAAA,SAA4B,KAAA,CAAM;AAAA,EAC7C,WAAA,CACE,OAAA,EACgB,OAAA,EACA,KAAA,EAChB;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAHG,IAAA,IAAA,CAAA,OAAA,GAAA,OAAA;AACA,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAGhB,IAAA,IAAA,CAAK,IAAA,GAAO,qBAAA;AAGZ,IAAA,IAAI,MAAM,iBAAA,EAAmB;AAC3B,MAAA,KAAA,CAAM,iBAAA,CAAkB,MAAM,oBAAmB,CAAA;AAAA,IACnD;AAAA,EACF;AAAA,EAEA,OAAO,aAAA,CAAc,OAAA,EAAiB,OAAA,EAAiB,KAAA,EAAoC;AACzF,IAAA,OAAO,IAAI,oBAAA;AAAA,MACT,CAAA,kBAAA,EAAqB,OAAO,CAAA,UAAA,EAAa,OAAO,CAAA,CAAA;AAAA,MAChD,OAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AAAA,EAEA,OAAO,eAAe,OAAA,EAAsC;AAC1D,IAAA,OAAO,IAAI,oBAAA,CAAoB,CAAA,QAAA,EAAW,OAAO,qCAAqC,OAAO,CAAA;AAAA,EAC/F;AAAA,EAEA,OAAO,cAAA,CAAe,SAAA,EAAmB,OAAA,EAAsC;AAC7E,IAAA,OAAO,IAAI,oBAAA,CAAoB,CAAA,gBAAA,EAAmB,SAAS,CAAA,EAAA,EAAK,OAAO,IAAI,UAAU,CAAA;AAAA,EACvF;AAAA,EAEA,OAAO,gBAAA,CAAiB,SAAA,EAAmB,OAAA,EAAiB,KAAA,EAAoC;AAC9F,IAAA,OAAO,IAAI,oBAAA;AAAA,MACT,CAAA,0BAAA,EAA6B,SAAS,CAAA,EAAA,EAAK,OAAO,CAAA,CAAA;AAAA,MAClD,UAAA;AAAA,MACA;AAAA,KACF;AAAA,EACF;AACF,CAAA;;;AC1CO,IAAM,eAAA,GAAN,cAA8B,mBAAA,CAAoB;AAAA,EACvD,WAAA,CAAY,SAAiB,KAAA,EAAe;AAC1C,IAAA,KAAA,CAAM,OAAA,EAAS,cAAc,KAAK,CAAA;AAClC,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAAA,EACd;AACF;ACQA,SAAS,sBAAsB,MAAA,EAAkD;AAC/E,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,IAAI,MAAA,KAAW,IAAA,IAAQ,MAAA,KAAW,IAAA,IAAQ,WAAW,IAAA,EAAM;AACzD,IAAA,OAAO,MAAA;AAAA,EACT;AAEA,EAAA,OAAO,MAAA;AACT;AAeO,SAAS,SAAA,CACd,KAAA,EACA,MAAA,GAAiD,SAAA,EACjD,MAAA,EACQ;AAER,EAAA,IAAI,OAAO,WAAW,QAAA,EAAU;AAE9B,IAAA,MAAM,YAAA,GAAe,MAAA,CAAO,YAAA,GAAe,YAAA,GAAe,SAAA;AAC1D,IAAA,MAAM,YAAA,GAAe,qBAAA,CAAsB,MAAA,CAAO,MAAA,IAAU,MAAM,CAAA;AAClE,IAAA,OAAOA,WAAA,CAAc,KAAA,EAAO,YAAA,EAAc,YAAY,CAAA;AAAA,EACxD;AAEA,EAAA,OAAOA,WAAA,CAAc,KAAA,EAAO,MAAA,EAAmC,qBAAA,CAAsB,MAAM,CAAC,CAAA;AAC9F;AASO,SAAS,QAAA,CAAS,OAAe,MAAA,EAAyB;AAC/D,EAAA,IAAI,WAAW,IAAA,EAAM;AACnB,IAAA,OAAO,KAAA,CAAM,kBAAkB,OAAO,CAAA;AAAA,EACxC;AACA,EAAA,OAAO,MAAM,WAAA,EAAY;AAC3B;AAQO,SAAS,aAAa,KAAA,EAAuB;AAClD,EAAA,OAAO,MAAM,SAAA,CAAU,KAAK,CAAA,CAAE,OAAA,CAAQ,oBAAoB,EAAE,CAAA;AAC9D;AAUO,SAAS,gBAAA,CAAiB,CAAA,EAAW,CAAA,EAAW,OAAA,EAAqC;AAC1F,EAAA,OAAO,UAAU,CAAA,EAAG,OAAO,CAAA,KAAM,SAAA,CAAU,GAAG,OAAO,CAAA;AACvD;AC1DO,SAAS,KAAA,CAAM,CAAA,EAAW,CAAA,EAAW,MAAA,GAAqB,aAAA,EAAuB;AAEtF,EAAA,IAAI,WAAW,WAAA,EAAa;AAC1B,IAAA,OAAOC,mBAAAA,CAAoB,CAAA,EAAG,CAAC,CAAA,CAAE,KAAA;AAAA,EACnC;AAGA,EAAA,OAAOC,OAAA,CAAU,CAAA,EAAG,CAAA,EAAG,MAA0B,CAAA;AACnD;AC7BA,IAAM,iBAAA,GAAoB,GAAA;AAC1B,IAAM,uBAAA,GAA0B,CAAA;AAChC,IAAM,cAAA,GAAiB,aAAA;AACvB,IAAM,wBAAA,GAA2B,SAAA;AAc1B,SAAS,OAAA,CACd,KAAA,EACA,UAAA,EACA,OAAA,EACc;AACd,EAAA,MAAM,MAAA,GAAS,SAAS,MAAA,IAAU,cAAA;AAClC,EAAA,MAAM,QAAA,GAAW,SAAS,QAAA,IAAY,iBAAA;AACtC,EAAA,MAAM,cAAA,GAAiB,SAAS,cAAA,IAAkB,uBAAA;AAGlD,EAAA,IAAI,eAAA,GAAkB,SAAS,eAAA,IAAmB,wBAAA;AAClD,EAAA,IAAI,OAAA,EAAS,cAAc,KAAA,EAAO;AAChC,IAAA,eAAA,GAAkB,MAAA;AAAA,EACpB,WAAW,OAAA,EAAS,SAAA,KAAc,IAAA,IAAQ,CAAC,SAAS,eAAA,EAAiB;AACnE,IAAA,eAAA,GAAkB,SAAA;AAAA,EACpB;AAGA,EAAA,MAAM,WAAA,GAAc;AAAA,IAClB,MAAA;AAAA,IACA,eAAA;AAAA,IACA,QAAA;AAAA,IACA,cAAA;AAAA,IACA,cAAc,OAAA,EAAS,YAAA;AAAA,IACvB,iBAAiB,OAAA,EAAS,eAAA;AAAA,IAC1B,eAAe,OAAA,EAAS;AAAA,GAC1B;AAEA,EAAA,MAAM,OAAA,GAAUC,SAAA,CAAY,KAAA,EAAO,UAAA,EAAwB,WAAW,CAAA;AAGtE,EAAA,OAAO,OAAA,CAAQ,GAAA,CAAI,CAAC,CAAA,MAAO;AAAA,IACzB,OAAO,CAAA,CAAE,KAAA;AAAA,IACT,OAAO,CAAA,CAAE,KAAA;AAAA,IACT,cAAc,CAAA,CAAE,YAAA;AAAA,IAChB,QAAQ,CAAA,CAAE,MAAA;AAAA,IACV,iBAAiB,CAAA,CAAE;AAAA,GACrB,CAAE,CAAA;AACJ;;;AC1DO,IAAM,OAAA,GAAU","file":"index.js","sourcesContent":["/**\n * Distance calculation with multiple metric support.\n *\n * Implements Crucible Foundry Similarity Standard v2.0.0 with WASM-backed metrics.\n *\n * @module foundry/similarity/distance\n */\n\nimport {\n  damerau_levenshtein,\n  jaro_winkler,\n  levenshtein,\n  osa_distance,\n  substringSimilarity,\n} from \"@3leaps/string-metrics-wasm\";\nimport type { MetricType } from \"./types.js\";\n\n/**\n * Calculate edit distance between two strings using specified metric.\n *\n * @param a - First string\n * @param b - Second string\n * @param metric - Distance metric (default: \"levenshtein\")\n * @returns Edit distance as non-negative integer (or similarity score for jaro_winkler/substring)\n *\n * @example\n * distance(\"kitten\", \"sitting\") // 3\n * distance(\"abcd\", \"abdc\", \"damerau_osa\") // 1\n * distance(\"CA\", \"ABC\", \"damerau_unrestricted\") // 2\n * distance(\"hello world\", \"world\", \"substring\") // 0.625 (as score, not distance)\n */\nexport function distance(a: string, b: string, metric: MetricType = \"levenshtein\"): number {\n  switch (metric) {\n    case \"levenshtein\":\n      return levenshtein(a, b);\n    case \"damerau_osa\":\n      return osa_distance(a, b);\n    case \"damerau_unrestricted\":\n      return damerau_levenshtein(a, b);\n    case \"jaro_winkler\":\n      return jaro_winkler(a, b);\n    case \"substring\":\n      // Returns similarity score (not distance) with longest common substring\n      return substringSimilarity(a, b).score;\n    default:\n      throw new Error(\n        `Invalid metric '${metric}': must be one of: levenshtein, damerau_osa, damerau_unrestricted, jaro_winkler, substring`,\n      );\n  }\n}\n","/**\n * Foundry module - Error handling\n *\n * Custom error classes for Foundry catalog operations with fail-fast validation.\n */\n\nexport class FoundryCatalogError extends Error {\n  constructor(\n    message: string,\n    public readonly catalog?: string,\n    public readonly cause?: Error,\n  ) {\n    super(message);\n    this.name = \"FoundryCatalogError\";\n\n    // Maintain proper stack trace for V8\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, FoundryCatalogError);\n    }\n  }\n\n  static invalidSchema(catalog: string, details: string, cause?: Error): FoundryCatalogError {\n    return new FoundryCatalogError(\n      `Invalid schema in ${catalog} catalog: ${details}`,\n      catalog,\n      cause,\n    );\n  }\n\n  static missingCatalog(catalog: string): FoundryCatalogError {\n    return new FoundryCatalogError(`Catalog ${catalog} not found or could not be loaded`, catalog);\n  }\n\n  static invalidPattern(patternId: string, details: string): FoundryCatalogError {\n    return new FoundryCatalogError(`Invalid pattern ${patternId}: ${details}`, \"patterns\");\n  }\n\n  static compilationError(patternId: string, details: string, cause?: Error): FoundryCatalogError {\n    return new FoundryCatalogError(\n      `Failed to compile pattern ${patternId}: ${details}`,\n      \"patterns\",\n      cause,\n    );\n  }\n}\n","import { FoundryCatalogError } from \"../errors.js\";\n\nexport class SimilarityError extends FoundryCatalogError {\n  constructor(message: string, cause?: Error) {\n    super(message, \"similarity\", cause);\n    this.name = \"SimilarityError\";\n  }\n}\n","/**\n * Unicode-aware text normalization utilities.\n *\n * Implements Crucible Foundry Similarity Standard v2.0.0 with normalization presets.\n *\n * @module foundry/similarity/normalization\n */\n\nimport {\n  type NormalizationLocale,\n  type NormalizationPreset as WasmNormalizationPreset,\n  normalize as wasmNormalize,\n} from \"@3leaps/string-metrics-wasm\";\nimport type { NormalizationPreset, NormalizeOptions } from \"./types.js\";\n\nfunction toNormalizationLocale(locale?: string): NormalizationLocale | undefined {\n  if (!locale) {\n    return undefined;\n  }\n\n  if (locale === \"tr\" || locale === \"az\" || locale === \"lt\") {\n    return locale;\n  }\n\n  return undefined;\n}\n\n/**\n * Apply normalization preset to text.\n *\n * @param value - Text to normalize\n * @param preset - Normalization preset (\"none\" | \"minimal\" | \"default\" | \"aggressive\")\n * @param locale - Optional locale for locale-aware casefolding (e.g., \"tr\" for Turkish)\n * @returns Normalized text\n *\n * @example\n * normalize(\"  Café-Zürich!  \", \"aggressive\") // \"cafezurich\"\n * normalize(\"  Hello  \", \"minimal\") // \"Hello\"\n * normalize(\"İstanbul\", \"default\", \"tr\") // \"istanbul\"\n */\nexport function normalize(\n  value: string,\n  preset: NormalizationPreset | NormalizeOptions = \"default\",\n  locale?: string,\n): string {\n  // Handle legacy NormalizeOptions interface for backward compatibility\n  if (typeof preset === \"object\") {\n    // Map old options to preset and extract locale\n    const targetPreset = preset.stripAccents ? \"aggressive\" : \"default\";\n    const targetLocale = toNormalizationLocale(preset.locale ?? locale);\n    return wasmNormalize(value, targetPreset, targetLocale);\n  }\n\n  return wasmNormalize(value, preset as WasmNormalizationPreset, toNormalizationLocale(locale));\n}\n\n/**\n * Unicode-aware case folding.\n *\n * @param value - Text to casefold\n * @param locale - Optional locale (e.g., \"tr\" for Turkish)\n * @returns Lowercase text\n */\nexport function casefold(value: string, locale?: string): string {\n  if (locale === \"tr\") {\n    return value.toLocaleLowerCase(\"tr-TR\");\n  }\n  return value.toLowerCase();\n}\n\n/**\n * Strip diacritical marks from text.\n *\n * @param value - Text to process\n * @returns Text with accents removed\n */\nexport function stripAccents(value: string): string {\n  return value.normalize(\"NFD\").replace(/[\\u0300-\\u036f]/g, \"\");\n}\n\n/**\n * Compare strings ignoring case and optionally accents.\n *\n * @param a - First string\n * @param b - Second string\n * @param options - Normalization options\n * @returns True if strings are equal after normalization\n */\nexport function equalsIgnoreCase(a: string, b: string, options?: NormalizeOptions): boolean {\n  return normalize(a, options) === normalize(b, options);\n}\n","/**\n * Normalized similarity score with metric selection.\n *\n * Implements Crucible Foundry Similarity Standard v2.0.0.\n *\n * @module foundry/similarity/score\n */\n\nimport {\n  type SimilarityMetric,\n  substringSimilarity,\n  score as wasmScore,\n} from \"@3leaps/string-metrics-wasm\";\nimport type { MetricType } from \"./types.js\";\n\n/**\n * Calculate normalized similarity score between two strings.\n *\n * Returns a value between 0.0 (completely different) and 1.0 (identical).\n * For distance-based metrics: 1 - distance / max(len(a), len(b))\n * For jaro_winkler and substring: direct similarity score\n *\n * @param a - First string\n * @param b - Second string\n * @param metric - Similarity metric (default: \"levenshtein\")\n * @returns Similarity score in range [0.0, 1.0]\n *\n * @example\n * score(\"kitten\", \"sitting\") // 0.5714...\n * score(\"hello\", \"hallo\", \"jaro_winkler\") // 0.88\n * score(\"hello world\", \"world\", \"substring\") // 0.625\n */\nexport function score(a: string, b: string, metric: MetricType = \"levenshtein\"): number {\n  // Special case: substring uses different API to get proper longest common substring\n  if (metric === \"substring\") {\n    return substringSimilarity(a, b).score;\n  }\n\n  // All other metrics supported directly by WASM score function\n  return wasmScore(a, b, metric as SimilarityMetric);\n}\n","/**\n * Suggestion API with fuzzy matching and configurable metrics.\n *\n * Implements Crucible Foundry Similarity Standard v2.0.0.\n *\n * @module foundry/similarity/suggest\n */\n\nimport { type SuggestMetric, suggest as wasmSuggest } from \"@3leaps/string-metrics-wasm\";\nimport type { Suggestion, SuggestOptions } from \"./types.js\";\n\nconst DEFAULT_MIN_SCORE = 0.6;\nconst DEFAULT_MAX_SUGGESTIONS = 3;\nconst DEFAULT_METRIC = \"levenshtein\";\nconst DEFAULT_NORMALIZE_PRESET = \"default\";\n\n/**\n * Generate ranked suggestions from candidate list based on similarity.\n *\n * @param input - Input string to match against\n * @param candidates - List of candidate strings\n * @param options - Suggestion options (metric, thresholds, normalization)\n * @returns Array of suggestions sorted by score (descending)\n *\n * @example\n * suggest(\"docscrib\", [\"docscribe\", \"crucible\"], { metric: \"levenshtein\" })\n * // [{ value: \"docscribe\", score: 0.889, ... }]\n */\nexport function suggest(\n  input: string,\n  candidates: readonly string[],\n  options?: SuggestOptions,\n): Suggestion[] {\n  const metric = options?.metric ?? DEFAULT_METRIC;\n  const minScore = options?.minScore ?? DEFAULT_MIN_SCORE;\n  const maxSuggestions = options?.maxSuggestions ?? DEFAULT_MAX_SUGGESTIONS;\n\n  // Handle legacy 'normalize' boolean option\n  let normalizePreset = options?.normalizePreset ?? DEFAULT_NORMALIZE_PRESET;\n  if (options?.normalize === false) {\n    normalizePreset = \"none\";\n  } else if (options?.normalize === true && !options?.normalizePreset) {\n    normalizePreset = \"default\";\n  }\n\n  // Pass metric name directly to WASM library (it handles \"substring\" correctly)\n  const wasmOptions = {\n    metric: metric as SuggestMetric,\n    normalizePreset,\n    minScore,\n    maxSuggestions,\n    preferPrefix: options?.preferPrefix,\n    jaroPrefixScale: options?.jaroPrefixScale,\n    jaroMaxPrefix: options?.jaroMaxPrefix,\n  };\n\n  const results = wasmSuggest(input, candidates as string[], wasmOptions);\n\n  // Map WASM results to our Suggestion interface\n  return results.map((r) => ({\n    value: r.value,\n    score: r.score,\n    matchedRange: r.matchedRange as [number, number] | undefined,\n    reason: r.reason,\n    normalizedValue: r.normalizedValue,\n  }));\n}\n","/**\n * Foundry similarity module - Text similarity and normalization utilities\n *\n * Implements the Crucible Foundry Text Similarity & Normalization Standard v2.0.0 (2025.10.3).\n *\n * @module foundry/similarity\n */\n\nexport const VERSION = \"2.0.0\";\n\nexport { distance } from \"./distance.js\";\nexport { SimilarityError } from \"./errors.js\";\nexport {\n  casefold,\n  equalsIgnoreCase,\n  normalize,\n  stripAccents,\n} from \"./normalization.js\";\nexport { score } from \"./score.js\";\nexport { suggest } from \"./suggest.js\";\n\nexport type {\n  MetricType,\n  NormalizationPreset,\n  NormalizeOptions,\n  Suggestion,\n  SuggestOptions,\n} from \"./types.js\";\n"]}

package/dist/{suggest-Cv7SVQRu.d.ts → suggest-D8LbwtPV.d.ts}

@@ -165,4 +165,4 @@ declare function score(a: string, b: string, metric?: MetricType): number;
  */
 declare function suggest(input: string, candidates: readonly string[], options?: SuggestOptions): Suggestion[];
 
-export { FoundryCatalogError as F, type MetricType as M, type NormalizationPreset as N, type Suggestion as S, score as a, suggest as b, casefold as c, distance as d, equalsIgnoreCase as e, type NormalizeOptions as f, type SuggestOptions as g, normalize as n, stripAccents as s };
+export { FoundryCatalogError as F, type MetricType as M, type NormalizeOptions as N, type Suggestion as S, type SuggestOptions as a, stripAccents as b, casefold as c, distance as d, equalsIgnoreCase as e, suggest as f, type NormalizationPreset as g, normalize as n, score as s };