@mailwoman/resolver-wof-sqlite 10.0.0 → 10.2.0

package/out/fst/format.js

@@ -4,22 +4,29 @@
  * @author Teffen Ellis, et al.
  *
  *   The FST binary-format constants, shared by the Node serializer/deserializer (`fst-serialize.ts`)
- *   and the browser deserializer (`fst-deserialize-web.ts`). Platform-free by design — no Buffer at
- *   module scope; both runtimes convert {@link FST_MAGIC_BYTES} themselves.
+ *   and the browser deserializer (`fst-deserialize-web.ts`). This module stays platform-free.
+ *   It uses no Buffer at module scope. Both runtimes convert {@link FST_MAGIC_BYTES} themselves.
  */
 /**
- * Format version this tree WRITES and the maximum either deserializer accepts, published so a freshness guard can call
- * an older artifact format-stale without re-typing the number (mirrors `REQUIRED_PAIR_INDEX_SCHEMA`'s role for PIX1 —
- * see `fst-freshness.ts`).
+ * Format version this tree writes and the maximum either deserializer accepts, published
+ * so a freshness guard can call an older artifact format-stale without re-typing the number
+ * (mirrors `REQUIRED_PAIR_INDEX_SCHEMA`'s role for PIX1 — see `fst-freshness.ts`).
  *
- * ONE constant for the writer and both readers, deliberately. The browser reader's acceptance criterion was a SEPARATE
- * `MAX_VERSION` number from the layout branches, and it drifted twice: left stale at 2 when the v4 wide-state layout
- * shipped (rejecting every real artifact), and stale again at 4 through the v5 two-score split until the line moved by
- * hand. A check that is the writer's version cannot drift from it.
+ * One constant for the writer and both readers, deliberately.
+ * The browser reader once kept a separate `MAX_VERSION` from the layout branches.
+ *
+ * It drifted twice.
+ * It stayed at 2 after the v4 wide-state layout shipped and rejected every real artifact.
+ *
+ * It later stayed at 4 through the v5 two-score split until someone updated it by hand.
+ *
+ * A check that is the writer's version cannot drift from it.
  */
 export const FST_FORMAT_VERSION = 5;
 /**
- * Fixed header size in bytes: magic, version, and the section offsets that follow it.
+ * Fixed header size in bytes.
+ *
+ * It stores the magic and version, followed by section offsets.
  */
 export const HEADER_SIZE = 32;
 /**
@@ -27,8 +34,10 @@ export const HEADER_SIZE = 32;
  */
 export const EDGE_ENTRY_SIZE = 8;
 /**
- * Format version that widened the per-state edge and place counters from 16 to 32 bits, growing the state entry from 12
- * to 16 bytes. Readers branch on it to stay backward-compatible with v2/v3 files.
+ * Format version that widened the per-state edge and place counters from 16 to 32 bits,
+ * growing the state entry from 12 to 16 bytes.
+ *
+ * Readers branch on it to stay backward-compatible with v2/v3 files.
  */
 export const VERSION_WIDE_STATE_COUNTERS = 4;
 /**
@@ -40,13 +49,14 @@ export const WIDE_STATE_ENTRY_SIZE = 16;
  */
 export const NARROW_STATE_ENTRY_SIZE = 12;
 /**
- * First format version carrying the trailing metadata block; older files simply have none.
+ * First format version carrying the trailing metadata block.
+ * Older files simply have none.
  */
 export const VERSION_WITH_METADATA = 3;
 /**
- * Format version that split the single `importance` float into `referential` + `encyclopedic` (ROAD_TO_V9 §2 R1),
- * growing the place entry from 56 to 60 bytes and claiming the previously-reserved `pp+7` byte as
- * {@link PLACE_FLAG_HAS_ENCYCLOPEDIC}.
+ * Format version that split the single `importance` float into `referential` +
+ * `encyclopedic` (ROAD_TO_V9 §2 R1), growing the place entry from 56 to 60 bytes
+ * and claiming the previously-reserved `pp+7` byte as {@link PLACE_FLAG_HAS_ENCYCLOPEDIC}.
  */
 export const VERSION_TWO_SCORE_SPLIT = 5;
 /**
@@ -58,22 +68,30 @@ export const SPLIT_PLACE_ENTRY_SIZE = 60;
  */
 export const LEGACY_PLACE_ENTRY_SIZE = 56;
 /**
- * Byte offset of the encyclopedic float inside a v5 place entry — immediately after the 8-slot parent chain.
+ * Byte offset of the encyclopedic float inside a v5 place entry — immediately
+ * after the 8-slot parent chain.
  */
 export const ENCYCLOPEDIC_OFFSET = 56;
 /**
- * `placeFlags` bit 0 (byte `pp+7`, v5+): this place carries an encyclopedic score. Per-PLACE rather than per-file
- * because absence is the common case — roughly 89% of the 2026-08-05 gazetteer has no Wikipedia article — and a
- * file-level flag would force every one of those rows to claim a 0 it never had.
+ * `placeFlags` bit 0 (byte `pp+7`, v5+): this place has an encyclopedic score.
+ *
+ * Per-place rather than per-file because absence is the common case — roughly 89% of
+ * the 2026-08-05 gazetteer has no Wikipedia article — and a file-level flag would
+ * force every one of those rows to claim a 0 it never had.
  */
 export const PLACE_FLAG_HAS_ENCYCLOPEDIC = 1;
 /**
- * File magic, "FST\0" as bytes. A reader rejects anything not starting with these four bytes before parsing further.
+ * File magic, "FST\0" as bytes.
+ *
+ * A reader rejects anything not starting with these four bytes before parsing further.
  */
 export const FST_MAGIC_BYTES = [0x46, 0x53, 0x54, 0x00];
 /**
- * Placetypes in hierarchy order, largest first. The index into this array is what gets written into a place entry, so
- * REORDERING IT BREAKS EVERY EXISTING FILE — append instead, and bump the version.
+ * Placetypes in hierarchy order, largest first.
+ *
+ * The writer stores each placetype's index in a place entry.
+ * A different array order invalidates every existing file.
+ * Append entries and bump the version.
  */
 export const PLACETYPE_ORDER = [
     "country",

package/out/fst/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../../lib/fst/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAEnC;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAA;AAE7B;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAEhC;;;GAGG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAA;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAA;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAA;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAA;AAEzC;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAA;AAErC;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAA;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAE1E;;;GAGG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2B;IACtD,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,SAAS;IACT,eAAe;IACf,YAAY;IACZ,QAAQ;IACR,YAAY;IACZ,cAAc;CACd,CAAA"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../lib/fst/format.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,CAAA;AAEnC;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAA;AAE7B;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAA;AAEhC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAA;AAE5C;;GAEG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,EAAE,CAAA;AAEvC;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAA;AAEtC;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAA;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAA;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,CAAA;AAEzC;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,EAAE,CAAA;AAErC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAA;AAE5C;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAsB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AAE1E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,eAAe,GAA2B;IACtD,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,YAAY;IACZ,SAAS;IACT,eAAe;IACf,YAAY;IACZ,QAAQ;IACR,YAAY;IACZ,cAAc;CACd,CAAA"}

package/out/fst/freshness.d.ts

@@ -3,43 +3,17 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Does an `fst-*.bin` still match the gazetteer it was built from?
- *
- *   WHY THIS EXISTS. Every FST artifact is a projection of one WOF admin database, and the admin
- *   database is a sealed readonly artifact that a rebuild REPLACES. Nothing mechanically tied the two
- *   together: the 2026-08-04 admin swap (4.87M rows, ancestry repaired, macrohood/microhood ingested)
- *   left `fst-global-priority.bin` at its 2026-05-28 build and the per-locale set at 2026-07-26, and
- *   the only way to notice was to compare mtimes by hand. The artifacts kept loading, kept answering
- *   queries, and answered them from a gazetteer that no longer exists.
- *
- *   `FSTProvenance` already recorded `sourceDB` — the source's PATH, which is exactly the field that
- *   cannot change when the bytes behind it do. So the stamp gains the source's IDENTITY (md5 + byte
- *   size) and this module compares it. The shape deliberately mirrors
- *   `@mailwoman/resolver-wof-sqlite/weights-overlay-linker`'s `pairIndexStaleReason`: one function returning a reason
- *   string or `undefined`, so a fact added to the stamp cannot be checked by some callers and not
- *   others — which is how three of the four base linkers ended up unable to notice a PIX1 schema bump.
- *
- *   FORMAT IS PART OF FRESHNESS. The check compares the serializer version too, not just the source
- *   md5. A guard that checks only the source reads a format-obsolete binary as "current" (the R5
- *   freshness-guard lesson, format edition), and a file below {@link MIN_STAMPED_FORMAT_VERSION}
- *   cannot carry a stamp at all — reported as its own reason rather than silently passing.
- *
- *   STALE IS A WARNING, NOT A FAULT. A dev tree with an old FST must still run; the artifact is a
- *   decode-time bias list, not a correctness dependency. Callers print {@link formatFSTStaleWarning}
- *   and continue.
+ * Does an `fst-*.bin` still match the gazetteer it was built from?
  */
 import { type PathBuilderLike } from "path-ts";
 import type { FSTProvenance } from "#fst/types";
 /**
- * First serializer version carrying the trailing provenance block. Below this a file has no place to put a stamp, so
- * "unstamped" is a statement about the FORMAT, not about the builder.
+ * First serializer version carrying the trailing provenance block. below it
+ * a file has no place to put a stamp.
  */
 export declare const MIN_STAMPED_FORMAT_VERSION = 3;
 /**
  * What an FST was built from, recorded so a later reader can tell whether that thing still exists.
- *
- * `bytes` is not redundant with `md5` — it is the field that survives a truncated or half-written source and makes the
- * mismatch legible in the warning ("5,273,722,880 → 5,372,076,032" names the rebuild; a hex delta does not).
  */
 export interface FSTSourceIdentity {
     md5: string;
@@ -47,87 +21,51 @@ export interface FSTSourceIdentity {
 }
 /**
  * The stamp fields a freshness guard reads off an artifact, plus the format version it was written at.
- *
- * Every field is optional because every one of them can be legitimately absent on an artifact that predates it, and the
- * meaning-of-zero rule applies to all of them: absent is a distinct state from "matches", and the reasons below say so
- * in different words.
  */
 export interface FSTStampFields {
     formatVersion: number;
-    provenance: FSTProvenance | undefined;
+    provenance: FSTProvenance | null;
 }
 /**
  * What a caller expects the artifact to have been built from.
- *
- * `exclusionPolicy` is optional and caller-supplied on purpose. The policy id lives in
- * `mailwoman/gazetteer-pipeline/fst.ts` (which depends on this package, not the other way round), so only the caller
- * knows which policy it means — the same split as the pair-index guard, where the format+magnitude half is shared and
- * the source-md5 half stays with the script that knows its sources.
  */
 export interface FSTExpectation {
     source: FSTSourceIdentity;
     /**
-     * Serializer version to require. Defaults to {@link FST_FORMAT_VERSION} — the version this tree writes — so a caller
-     * cannot forget the format half of the comparison. Override only to check against a specific older floor.
+     * Serializer version to require, defaulting to {@link FST_FORMAT_VERSION}.
      */
-    formatVersion?: number;
-    exclusionPolicy?: string;
+    formatVersion?: number | null;
+    exclusionPolicy?: string | null;
 }
 /**
- * Read an artifact's stamp WITHOUT deserializing it — a header seek plus the trailer, three reads totalling a few
- * kilobytes. The distinction matters: `fst-global-priority.bin` is 317 MB and this runs on every `yarn test` via the
- * weights linkers, so `readFileSync` + `readFSTProvenance` would trade a freshness guard for a slower test suite and
- * nobody would keep it.
- *
- * Returns `undefined` for a file that is absent, too small, or not an FST at all — none of which is this function's
- * business to diagnose.
- */
-export declare function peekFSTStampFields(path: string): Promise<FSTStampFields | undefined>;
-/**
- * Re-exported from `@mailwoman/core/hash`. This package's own test imports it from here, and the sidecar convention
- * below is what it is for.
+ * Read an artifact's stamp without deserializing it.
  */
+export declare function peekFSTStampFields(path: PathBuilderLike): Promise<FSTStampFields | null>;
 /**
  * The source identity an FST build should stamp, or a check should compare against.
- *
- * Uses the `.md5` sidecar convention the weights linkers already established on this exact file: `<path>.md5` in
- * md5sum(1) format (`<hash> <filename>`), trusted only while its mtime is at least the source's. An older sidecar is
- * recomputed. Without it the admin DB costs 7.3 s per call and the guard would be quietly disabled by whoever noticed
- * `yarn test` got slower.
- *
- * `refreshSidecar` writes the recomputed digest back. Best-effort: a sealed data root or a read-only mount fails the
- * write and the caller still gets its answer, because refusing to check freshness on a read-only tree would be the
- * wrong trade.
  */
 export declare function readWOFSourceIdentity(source: PathBuilderLike, { refreshSidecar }?: {
     refreshSidecar?: boolean | undefined;
 }): Promise<FSTSourceIdentity>;
 /**
- * Why an FST artifact is stale against `expected`, or `undefined` when it still matches.
- *
- * The order is deliberate: FORMAT first (a version-obsolete file is stale whatever its source says), then the presence
- * of a stamp, then the source identity, then the build policy. Each returns prose a reader can act on — the reasons are
- * printed verbatim into {@link formatFSTStaleWarning}.
+ * Why an FST artifact is stale against `expected`, or `null` when it still matches.
  */
-export declare function fstStaleReason(fields: FSTStampFields | undefined, expected: FSTExpectation): string | undefined;
+export declare function fstStaleReason(fields: FSTStampFields | null, expected: FSTExpectation): string | null;
 /**
- * The whole check, for a caller that has a path and a source DB and wants a warning string or nothing.
- *
- * Returns `undefined` when the artifact is current OR when it is absent — an absent artifact is a different problem
- * with a different message, and every existing caller already reports it in place.
+ * The whole check, for a caller with a path and a source DB that wants a warning string or none.
  */
 export declare function fstFreshnessWarning({ fstPath, sourceDBPath, formatVersion, exclusionPolicy, rebuildCommand, }: {
-    fstPath: string;
-    sourceDBPath: string;
-    formatVersion?: number;
-    exclusionPolicy?: string;
+    fstPath: PathBuilderLike;
+    sourceDBPath: PathBuilderLike;
+    formatVersion?: number | null;
+    exclusionPolicy?: string | null;
     rebuildCommand: string;
-}): Promise<string | undefined>;
+}): Promise<string | null>;
 /**
- * The one warning format, so `grep -r "FST STALE"` finds every site that can emit one.
+ * The one warning format, so `grep -r "FST stale"` finds every site that emits one.
  */
 export declare function formatFSTStaleWarning({ fstPath, reason, rebuildCommand, }: {
-    fstPath: string;
+    fstPath: PathBuilderLike;
     reason: string;
     rebuildCommand: string;
 }): string;

package/out/fst/freshness.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../../lib/fst/freshness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAMH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAGrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAmB/C;;;GAGG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAA;AAO3C;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACb;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,aAAa,GAAG,SAAS,CAAA;CACrC;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,iBAAiB,CAAA;IACzB;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;CACxB;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAwB1F;AAED;;;GAGG;AAEH;;;;;;;;;;;GAWG;AACH,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,eAAe,EACvB,EAAE,cAAqB,EAAE;;CAAK,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAsC5B;AASD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,SAAS,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,GAAG,SAAS,CAmC/G;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,EACzC,OAAO,EACP,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GACd,EAAE;IACF,OAAO,EAAE,MAAM,CAAA;IACf,YAAY,EAAE,MAAM,CAAA;IACpB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,cAAc,EAAE,MAAM,CAAA;CACtB,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAU9B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EACrC,OAAO,EACP,MAAM,EACN,cAAc,GACd,EAAE;IACF,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;CACtB,GAAG,MAAM,CAET"}
+{"version":3,"file":"freshness.d.ts","sourceRoot":"","sources":["../../lib/fst/freshness.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,SAAS,CAAA;AAGrE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAc/C;;;GAGG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAA;AAI3C;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC,GAAG,EAAE,MAAM,CAAA;IACX,KAAK,EAAE,MAAM,CAAA;CACb;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,aAAa,EAAE,MAAM,CAAA;IACrB,UAAU,EAAE,aAAa,GAAG,IAAI,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC9B,MAAM,EAAE,iBAAiB,CAAA;IACzB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAC/B;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAwB9F;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAC1C,MAAM,EAAE,eAAe,EACvB,EAAE,cAAqB,EAAE;;CAAK,GAC5B,OAAO,CAAC,iBAAiB,CAAC,CAsC5B;AAID;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,EAAE,QAAQ,EAAE,cAAc,GAAG,MAAM,GAAG,IAAI,CAiCrG;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CAAC,EACzC,OAAO,EACP,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GACd,EAAE;IACF,OAAO,EAAE,eAAe,CAAA;IACxB,YAAY,EAAE,eAAe,CAAA;IAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC7B,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/B,cAAc,EAAE,MAAM,CAAA;CACtB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAUzB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,EACrC,OAAO,EACP,MAAM,EACN,cAAc,GACd,EAAE;IACF,OAAO,EAAE,eAAe,CAAA;IACxB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;CACtB,GAAG,MAAM,CAET"}

package/out/fst/freshness.js

@@ -3,107 +3,58 @@
  * @license AGPL-3.0
  * @author Teffen Ellis, et al.
  *
- *   Does an `fst-*.bin` still match the gazetteer it was built from?
- *
- *   WHY THIS EXISTS. Every FST artifact is a projection of one WOF admin database, and the admin
- *   database is a sealed readonly artifact that a rebuild REPLACES. Nothing mechanically tied the two
- *   together: the 2026-08-04 admin swap (4.87M rows, ancestry repaired, macrohood/microhood ingested)
- *   left `fst-global-priority.bin` at its 2026-05-28 build and the per-locale set at 2026-07-26, and
- *   the only way to notice was to compare mtimes by hand. The artifacts kept loading, kept answering
- *   queries, and answered them from a gazetteer that no longer exists.
- *
- *   `FSTProvenance` already recorded `sourceDB` — the source's PATH, which is exactly the field that
- *   cannot change when the bytes behind it do. So the stamp gains the source's IDENTITY (md5 + byte
- *   size) and this module compares it. The shape deliberately mirrors
- *   `@mailwoman/resolver-wof-sqlite/weights-overlay-linker`'s `pairIndexStaleReason`: one function returning a reason
- *   string or `undefined`, so a fact added to the stamp cannot be checked by some callers and not
- *   others — which is how three of the four base linkers ended up unable to notice a PIX1 schema bump.
- *
- *   FORMAT IS PART OF FRESHNESS. The check compares the serializer version too, not just the source
- *   md5. A guard that checks only the source reads a format-obsolete binary as "current" (the R5
- *   freshness-guard lesson, format edition), and a file below {@link MIN_STAMPED_FORMAT_VERSION}
- *   cannot carry a stamp at all — reported as its own reason rather than silently passing.
- *
- *   STALE IS A WARNING, NOT A FAULT. A dev tree with an old FST must still run; the artifact is a
- *   decode-time bias list, not a correctness dependency. Callers print {@link formatFSTStaleWarning}
- *   and continue.
+ * Does an `fst-*.bin` still match the gazetteer it was built from?
  */
-import { pathExists, readFileRange, readLocalTextFile, statPath } from "@mailwoman/core/fs/readers";
+import { readFileRange, readLocalTextFile } from "@mailwoman/core/fs/readers";
+import { pathExists, statPath } from "@mailwoman/core/fs/readers/stat";
 import { writeLocalTextFile } from "@mailwoman/core/fs/writers";
 import { md5File } from "@mailwoman/core/hash";
 import { tryParsingJSON } from "@mailwoman/core/json";
 import { basename, resolvePath } from "path-ts";
-import { FST_FORMAT_VERSION } from "#fst/serialize";
+import { FST_FORMAT_VERSION } from "#fst/format";
 /**
- * Fixed header size in bytes — mirrors `fst-serialize.ts`'s `HEADER_SIZE`. Duplicated rather than exported across
- * because this module reads the header by SEEK (never buffering the file), and the serializer's constant is private to
- * its own read/write pair.
+ * Fixed header size in bytes, mirroring `fst-serialize.ts`'s private `HEADER_SIZE`.
  */
 const HEADER_SIZE = 32;
 /**
- * `"FST\0"` little-endian, the four magic bytes every artifact opens with.
+ * `"FST\0"` little-endian, the four bytes every artifact opens with.
  */
 const MAGIC = 0x00_54_53_46;
-/**
- * Byte offset of the u32 trailer offset inside the header (the last of its eight fields).
- */
 const PROVENANCE_OFFSET_FIELD = 28;
 /**
- * First serializer version carrying the trailing provenance block. Below this a file has no place to put a stamp, so
- * "unstamped" is a statement about the FORMAT, not about the builder.
+ * First serializer version carrying the trailing provenance block. below it
+ * a file has no place to put a stamp.
  */
 export const MIN_STAMPED_FORMAT_VERSION = 3;
-/**
- * Hex characters in an md5 digest.
- */
 const MD5_HEX_LENGTH = 32;
 /**
- * Read an artifact's stamp WITHOUT deserializing it — a header seek plus the trailer, three reads totalling a few
- * kilobytes. The distinction matters: `fst-global-priority.bin` is 317 MB and this runs on every `yarn test` via the
- * weights linkers, so `readFileSync` + `readFSTProvenance` would trade a freshness guard for a slower test suite and
- * nobody would keep it.
- *
- * Returns `undefined` for a file that is absent, too small, or not an FST at all — none of which is this function's
- * business to diagnose.
+ * Read an artifact's stamp without deserializing it.
  */
 export async function peekFSTStampFields(path) {
     if (!(await pathExists(path)))
-        return undefined;
+        return null;
     const size = (await statPath(path)).size;
     if (size < HEADER_SIZE)
-        return undefined;
+        return null;
     const header = await readFileRange(path, 0, HEADER_SIZE);
     if (header.readUInt32LE(0) !== MAGIC)
-        return undefined;
+        return null;
     const formatVersion = header.readUInt16LE(4);
     if (formatVersion < MIN_STAMPED_FORMAT_VERSION)
-        return { formatVersion, provenance: undefined };
+        return { formatVersion, provenance: null };
     const trailerStart = header.readUInt32LE(PROVENANCE_OFFSET_FIELD);
-    // 0 = "this build wrote no trailer" (the serializer's own encoding); anything past EOF is a
-    // truncated file. Both read as "no stamp", which is what the caller does with them anyway.
+    // 0 means this build wrote no trailer and past-EOF means truncated.
+    // Both read as no stamp.
     if (trailerStart === 0 || trailerStart + 4 > size)
-        return { formatVersion, provenance: undefined };
+        return { formatVersion, provenance: null };
     const jsonLength = (await readFileRange(path, trailerStart, 4)).readUInt32LE(0);
     if (jsonLength === 0 || trailerStart + 4 + jsonLength > size)
-        return { formatVersion, provenance: undefined };
+        return { formatVersion, provenance: null };
     const json = await readFileRange(path, trailerStart + 4, jsonLength);
-    return { formatVersion, provenance: tryParsingJSON(json.toString("utf8")) ?? undefined };
+    return { formatVersion, provenance: tryParsingJSON(json.toString("utf8")) ?? null };
 }
-/**
- * Re-exported from `@mailwoman/core/hash`. This package's own test imports it from here, and the sidecar convention
- * below is what it is for.
- */
 /**
  * The source identity an FST build should stamp, or a check should compare against.
- *
- * Uses the `.md5` sidecar convention the weights linkers already established on this exact file: `<path>.md5` in
- * md5sum(1) format (`<hash> <filename>`), trusted only while its mtime is at least the source's. An older sidecar is
- * recomputed. Without it the admin DB costs 7.3 s per call and the guard would be quietly disabled by whoever noticed
- * `yarn test` got slower.
- *
- * `refreshSidecar` writes the recomputed digest back. Best-effort: a sealed data root or a read-only mount fails the
- * write and the caller still gets its answer, because refusing to check freshness on a read-only tree would be the
- * wrong trade.
  */
 export async function readWOFSourceIdentity(source, { refreshSidecar = true } = {}) {
     const path = resolvePath(source);
@@ -113,7 +64,7 @@ export async function readWOFSourceIdentity(source, { refreshSidecar = true } =
     if (hit)
         return hit;
     const sidecarPath = `${path}.md5`;
-    let md5;
+    let md5 = null;
     if (await pathExists(sidecarPath)) {
         const sidecarStats = await statPath(sidecarPath);
         if (sidecarStats.mtimeMs >= stats.mtimeMs) {
@@ -130,7 +81,7 @@ export async function readWOFSourceIdentity(source, { refreshSidecar = true } =
                 await writeLocalTextFile(`${md5}  ${basename(path)}\n`, sidecarPath);
             }
             catch {
-                // Read-only data root — the digest is still correct, it just isn't cached.
+                // Read-only data root: the digest is still correct, only the cache write failed.
             }
         }
     }
@@ -138,18 +89,9 @@ export async function readWOFSourceIdentity(source, { refreshSidecar = true } =
     sourceIdentityMemo.set(memoKey, identity);
     return identity;
 }
-/**
- * Memo for {@link readWOFSourceIdentity}, keyed on (path, mtimeMs, size) — NOT on path alone, for the same reason
- * `computeSurfaceCountryCounts` isn't: the admin DB is a sealed artifact that a rebuild REPLACES, so a path-only memo
- * would serve a stale digest against a new file for the life of the process.
- */
 const sourceIdentityMemo = new Map();
 /**
- * Why an FST artifact is stale against `expected`, or `undefined` when it still matches.
- *
- * The order is deliberate: FORMAT first (a version-obsolete file is stale whatever its source says), then the presence
- * of a stamp, then the source identity, then the build policy. Each returns prose a reader can act on — the reasons are
- * printed verbatim into {@link formatFSTStaleWarning}.
+ * Why an FST artifact is stale against `expected`, or `null` when it still matches.
  */
 export function fstStaleReason(fields, expected) {
     if (!fields)
@@ -170,36 +112,31 @@ export function fstStaleReason(fields, expected) {
     if (provenance.sourceDBMD5 !== expected.source.md5) {
         return `source db ${provenance.sourceDBMD5.slice(0, 8)} → ${expected.source.md5.slice(0, 8)} (built ${provenance.builtAt})`;
     }
-    // Reached only when the md5s agree, so a size disagreement means one of the two was recorded
-    // against a different file than it was hashed from. Cheap to check, and it never fires by accident.
-    if (provenance.sourceDBBytes !== undefined && provenance.sourceDBBytes !== expected.source.bytes) {
+    if (provenance.sourceDBBytes != null && provenance.sourceDBBytes !== expected.source.bytes) {
         return `source db size ${provenance.sourceDBBytes} → ${expected.source.bytes} at a matching md5 — one of the two is misrecorded`;
     }
-    if (expected.exclusionPolicy !== undefined && provenance.exclusionPolicy !== expected.exclusionPolicy) {
+    if (expected.exclusionPolicy && provenance.exclusionPolicy !== expected.exclusionPolicy) {
         return `exclusion policy ${provenance.exclusionPolicy ?? "(none)"} → ${expected.exclusionPolicy}`;
     }
-    return undefined;
+    return null;
 }
 /**
- * The whole check, for a caller that has a path and a source DB and wants a warning string or nothing.
- *
- * Returns `undefined` when the artifact is current OR when it is absent — an absent artifact is a different problem
- * with a different message, and every existing caller already reports it in place.
+ * The whole check, for a caller with a path and a source DB that wants a warning string or none.
  */
 export async function fstFreshnessWarning({ fstPath, sourceDBPath, formatVersion, exclusionPolicy, rebuildCommand, }) {
     if (!(await pathExists(fstPath)) || !(await pathExists(sourceDBPath)))
-        return undefined;
+        return null;
     const reason = fstStaleReason(await peekFSTStampFields(fstPath), {
         source: await readWOFSourceIdentity(sourceDBPath),
-        ...(formatVersion === undefined ? {} : { formatVersion }),
-        ...(exclusionPolicy === undefined ? {} : { exclusionPolicy }),
+        formatVersion: formatVersion ?? null,
+        exclusionPolicy: exclusionPolicy ?? null,
     });
-    return reason === undefined ? undefined : formatFSTStaleWarning({ fstPath, reason, rebuildCommand });
+    return reason ? formatFSTStaleWarning({ fstPath, reason, rebuildCommand }) : null;
 }
 /**
- * The one warning format, so `grep -r "FST STALE"` finds every site that can emit one.
+ * The one warning format, so `grep -r "FST stale"` finds every site that emits one.
  */
 export function formatFSTStaleWarning({ fstPath, reason, rebuildCommand, }) {
-    return `WARNING: FST STALE — ${fstPath}: ${reason}. Rebuild with: ${rebuildCommand}`;
+    return `WARNING: FST STALE — ${fstPath.toString()}: ${reason}. Rebuild with: ${rebuildCommand}`;
 }
 //# sourceMappingURL=freshness.js.map

package/out/fst/freshness.js.map

@@ -1 +1 @@
-{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../../lib/fst/freshness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,iBAAiB,EAAE,QAAQ,EAAE,MAAM,4BAA4B,CAAA;AACnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAA;AAC/D,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAA;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AACrD,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAwB,MAAM,SAAS,CAAA;AAErE,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAA;AAGnD;;;;GAIG;AACH,MAAM,WAAW,GAAG,EAAE,CAAA;AAEtB;;GAEG;AACH,MAAM,KAAK,GAAG,aAAa,CAAA;AAE3B;;GAEG;AACH,MAAM,uBAAuB,GAAG,EAAE,CAAA;AAElC;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAA;AAE3C;;GAEG;AACH,MAAM,cAAc,GAAG,EAAE,CAAA;AA2CzB;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAY;IACpD,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IAC/C,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;IAExC,IAAI,IAAI,GAAG,WAAW;QAAE,OAAO,SAAS,CAAA;IACxC,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,CAAC,EAAE,WAAW,CAAC,CAAA;IAExD,IAAI,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,KAAK,KAAK;QAAE,OAAO,SAAS,CAAA;IACtD,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAE5C,IAAI,aAAa,GAAG,0BAA0B;QAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,CAAA;IAC/F,MAAM,YAAY,GAAG,MAAM,CAAC,YAAY,CAAC,uBAAuB,CAAC,CAAA;IAEjE,4FAA4F;IAC5F,2FAA2F;IAC3F,IAAI,YAAY,KAAK,CAAC,IAAI,YAAY,GAAG,CAAC,GAAG,IAAI;QAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,CAAA;IAElG,MAAM,UAAU,GAAG,CAAC,MAAM,aAAa,CAAC,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAA;IAE/E,IAAI,UAAU,KAAK,CAAC,IAAI,YAAY,GAAG,CAAC,GAAG,UAAU,GAAG,IAAI;QAAE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,SAAS,EAAE,CAAA;IAE7G,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,CAAC,EAAE,UAAU,CAAC,CAAA;IAEpE,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,cAAc,CAAgB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,IAAI,SAAS,EAAE,CAAA;AACxG,CAAC;AAED;;;GAGG;AAEH;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAC1C,MAAuB,EACvB,EAAE,cAAc,GAAG,IAAI,EAAE,GAAG,EAAE;IAE9B,MAAM,IAAI,GAAG,WAAW,CAAC,MAAM,CAAC,CAAA;IAChC,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAA;IAClC,MAAM,OAAO,GAAG,GAAG,IAAI,KAAK,KAAK,CAAC,OAAO,KAAK,KAAK,CAAC,IAAI,EAAE,CAAA;IAC1D,MAAM,GAAG,GAAG,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IAE3C,IAAI,GAAG;QAAE,OAAO,GAAG,CAAA;IACnB,MAAM,WAAW,GAAG,GAAG,IAAI,MAAM,CAAA;IACjC,IAAI,GAAuB,CAAA;IAE3B,IAAI,MAAM,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QACnC,MAAM,YAAY,GAAG,MAAM,QAAQ,CAAC,WAAW,CAAC,CAAA;QAEhD,IAAI,YAAY,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YAC3C,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,iBAAiB,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;YAEzE,IAAI,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,cAAc,EAAE,CAAC;gBAC5C,GAAG,GAAG,IAAI,CAAA;YACX,CAAC;QACF,CAAC;IACF,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACV,GAAG,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;QAEzB,IAAI,cAAc,EAAE,CAAC;YACpB,IAAI,CAAC;gBACJ,MAAM,kBAAkB,CAAC,GAAG,GAAG,KAAK,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAA;YACrE,CAAC;YAAC,MAAM,CAAC;gBACR,2EAA2E;YAC5E,CAAC;QACF,CAAC;IACF,CAAC;IAED,MAAM,QAAQ,GAAsB,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,CAAA;IAC9D,kBAAkB,CAAC,GAAG,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAA;IAEzC,OAAO,QAAQ,CAAA;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,EAA6B,CAAA;AAE/D;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,MAAkC,EAAE,QAAwB;IAC1F,IAAI,CAAC,MAAM;QAAE,OAAO,mCAAmC,CAAA;IACvD,MAAM,cAAc,GAAG,QAAQ,CAAC,aAAa,IAAI,kBAAkB,CAAA;IAEnE,IAAI,MAAM,CAAC,aAAa,GAAG,cAAc,EAAE,CAAC;QAC3C,OAAO,WAAW,MAAM,CAAC,aAAa,OAAO,cAAc,EAAE,CAAA;IAC9D,CAAC;IAED,IAAI,MAAM,CAAC,aAAa,GAAG,0BAA0B,EAAE,CAAC;QACvD,OAAO,WAAW,MAAM,CAAC,aAAa,qCAAqC,0BAA0B,IAAI,CAAA;IAC1G,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAA;IAEpC,IAAI,CAAC,UAAU;QAAE,OAAO,wBAAwB,CAAA;IAEhD,IAAI,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;QAC7B,OAAO,SAAS,UAAU,CAAC,OAAO,iDAAiD,CAAA;IACpF,CAAC;IAED,IAAI,UAAU,CAAC,WAAW,KAAK,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QACpD,OAAO,aAAa,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,WAAW,UAAU,CAAC,OAAO,GAAG,CAAA;IAC5H,CAAC;IAED,6FAA6F;IAC7F,oGAAoG;IACpG,IAAI,UAAU,CAAC,aAAa,KAAK,SAAS,IAAI,UAAU,CAAC,aAAa,KAAK,QAAQ,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAClG,OAAO,kBAAkB,UAAU,CAAC,aAAa,MAAM,QAAQ,CAAC,MAAM,CAAC,KAAK,oDAAoD,CAAA;IACjI,CAAC;IAED,IAAI,QAAQ,CAAC,eAAe,KAAK,SAAS,IAAI,UAAU,CAAC,eAAe,KAAK,QAAQ,CAAC,eAAe,EAAE,CAAC;QACvG,OAAO,oBAAoB,UAAU,CAAC,eAAe,IAAI,QAAQ,MAAM,QAAQ,CAAC,eAAe,EAAE,CAAA;IAClG,CAAC;IAED,OAAO,SAAS,CAAA;AACjB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CAAC,EACzC,OAAO,EACP,YAAY,EACZ,aAAa,EACb,eAAe,EACf,cAAc,GAOd;IACA,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,UAAU,CAAC,YAAY,CAAC,CAAC;QAAE,OAAO,SAAS,CAAA;IAEvF,MAAM,MAAM,GAAG,cAAc,CAAC,MAAM,kBAAkB,CAAC,OAAO,CAAC,EAAE;QAChE,MAAM,EAAE,MAAM,qBAAqB,CAAC,YAAY,CAAC;QACjD,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC;QACzD,GAAG,CAAC,eAAe,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,CAAC;KAC7D,CAAC,CAAA;IAEF,OAAO,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,qBAAqB,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC,CAAA;AACrG,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,EACrC,OAAO,EACP,MAAM,EACN,cAAc,GAKd;IACA,OAAO,wBAAwB,OAAO,KAAK,MAAM,mBAAmB,cAAc,EAAE,CAAA;AACrF,CAAC"}
+{"version":3,"file":"freshness.js","sourceRoot":"","sources":["../../lib/fst/freshness.ts"],"names":[],"mappings":"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"}

package/out/fst/matcher.d.ts

@@ -7,7 +7,8 @@
  *   introspection. The structure is a deterministic trie over normalized tokens with PlaceEntry
  *   arrays at accepting states.
  */
-import type { FSTContinuation, FSTMatchResult, FSTQueryResult, PlaceEntry } from "#fst/types";
+import type { AncestrieMatch } from "@mailwoman/ancestrie";
+import type { FSTContinuation, FSTQueryResult, PlaceEntry } from "#fst/types";
 interface FSTNode {
     edges: Map<string, number>;
     places: PlaceEntry[];
@@ -17,8 +18,8 @@ export declare class FSTMatcher {
     constructor(nodes: FSTNode[]);
     get stateCount(): number;
     get placeCount(): number;
-    walk(tokens: string[]): FSTMatchResult | null;
-    walkFrom(prev: FSTMatchResult, token: string): FSTMatchResult | null;
+    walk(tokens: string[]): AncestrieMatch | null;
+    walkFrom(prev: AncestrieMatch, token: string): AncestrieMatch | null;
     accepting(stateID: number): PlaceEntry[];
     continuations(stateID: number): FSTContinuation[];
     query(text: string): FSTQueryResult;
@@ -30,7 +31,7 @@ export declare class FSTMatcher {
     static fromNodes(nodes: FSTNode[]): FSTMatcher;
 }
 /**
- * Normalize text into FST tokens: lowercase, NFKC, strip punctuation, split on whitespace.
+ * Normalize text into FST tokens: lowercase, nfkc, strip punctuation, split on whitespace.
  */
 export declare function normalizeTokens(text: string): string[];
 export type { FSTNode };

package/out/fst/matcher.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../lib/fst/matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE7F,UAAU,OAAO;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1B,MAAM,EAAE,UAAU,EAAE,CAAA;CACpB;AAED,qBAAa,UAAU;IACtB,OAAO,CAAC,KAAK,CAAW;IAExB,YAAY,KAAK,EAAE,OAAO,EAAE,EAE3B;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,CAQvB;IAED,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,GAAG,IAAI,CAgB5C;IAED,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAUnE;IAED,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAEvC;IAED,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAiBhD;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAmClC;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,OAAO,IAAI,SAAS,OAAO,EAAE,CAE5B;IAED,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,CAE7C;CACD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOtD;AAED,YAAY,EAAE,OAAO,EAAE,CAAA"}
+{"version":3,"file":"matcher.d.ts","sourceRoot":"","sources":["../../lib/fst/matcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE7E,UAAU,OAAO;IAChB,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC1B,MAAM,EAAE,UAAU,EAAE,CAAA;CACpB;AAED,qBAAa,UAAU;IACtB,OAAO,CAAC,KAAK,CAAW;IAExB,YAAY,KAAK,EAAE,OAAO,EAAE,EAE3B;IAED,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED,IAAI,UAAU,IAAI,MAAM,CAQvB;IAED,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,cAAc,GAAG,IAAI,CAgB5C;IAED,QAAQ,CAAC,IAAI,EAAE,cAAc,EAAE,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAUnE;IAED,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,EAAE,CAEvC;IAED,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAiBhD;IAED,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAmClC;IAED,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,OAAO,IAAI,SAAS,OAAO,EAAE,CAE5B;IAED,MAAM,CAAC,SAAS,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,UAAU,CAE7C;CACD;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAOtD;AAED,YAAY,EAAE,OAAO,EAAE,CAAA"}

package/out/fst/matcher.js

@@ -109,7 +109,7 @@ export class FSTMatcher {
     }
 }
 /**
- * Normalize text into FST tokens: lowercase, NFKC, strip punctuation, split on whitespace.
+ * Normalize text into FST tokens: lowercase, nfkc, strip punctuation, split on whitespace.
  */
 export function normalizeTokens(text) {
     return text
@@ -117,6 +117,6 @@ export function normalizeTokens(text) {
         .toLowerCase()
         .replaceAll(/[\p{P}\p{S}]/gu, "")
         .split(/\s+/)
-        .filter((t) => t.length > 0);
+        .filter((t) => t.length);
 }
 //# sourceMappingURL=matcher.js.map

package/out/fst/matcher.js.map

@@ -1 +1 @@
-{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../../lib/fst/matcher.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"matcher.js","sourceRoot":"","sources":["../../lib/fst/matcher.ts"],"names":[],"mappings":"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"}