@mailwoman/normalize 4.0.0

package/out/abbreviations.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Abbreviation expansion — a small bounded dictionary per locale. Initial dict covers en-US street
+ *   suffixes + directional prefixes. fr-FR + others added as needed.
+ *
+ *   This is the INVERSE of the corpus synthesis pass (which produces `Ave` from `Avenue` for
+ *   augmentation). Both sides should eventually share dictionaries; for v1 this dict is duplicated
+ *   intentionally — refactoring sharing is a separate task.
+ */
+import type { SpanRange } from "./types.js";
+export interface AbbreviationResult {
+    text: string;
+    map: number[];
+    expansions: Array<{
+        from: string;
+        to: string;
+        at: SpanRange;
+    }>;
+}
+/**
+ * Expand known abbreviations. Walks the input token-by-token (whitespace-delimited) and rewrites
+ * matching tokens to their canonical long form. The output map points every char of the expanded
+ * form to its position in the original short form (first char of input token).
+ *
+ * Case rules: match case-insensitively. Output form preserves the dictionary's canonical casing
+ * (`St` → `Street`, `st` → `Street`, `ST` → `Street`).
+ */
+export declare function expandAbbreviations(input: string, locale?: string): AbbreviationResult;
+//# sourceMappingURL=abbreviations.d.ts.map

package/out/abbreviations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"abbreviations.d.ts","sourceRoot":"","sources":["../abbreviations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAgD3C,MAAM,WAAW,kBAAkB;IAClC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,UAAU,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,SAAS,CAAA;KAAE,CAAC,CAAA;CAC9D;AAED;;;;;;;GAOG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,kBAAkB,CAiDtF"}

package/out/abbreviations.js

@@ -0,0 +1,110 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Abbreviation expansion — a small bounded dictionary per locale. Initial dict covers en-US street
+ *   suffixes + directional prefixes. fr-FR + others added as needed.
+ *
+ *   This is the INVERSE of the corpus synthesis pass (which produces `Ave` from `Avenue` for
+ *   augmentation). Both sides should eventually share dictionaries; for v1 this dict is duplicated
+ *   intentionally — refactoring sharing is a separate task.
+ */
+const EN_US_DICT = [
+    // Directional prefixes / suffixes
+    { from: "N", to: "North" },
+    { from: "S", to: "South" },
+    { from: "E", to: "East" },
+    { from: "W", to: "West" },
+    { from: "NE", to: "Northeast" },
+    { from: "NW", to: "Northwest" },
+    { from: "SE", to: "Southeast" },
+    { from: "SW", to: "Southwest" },
+    // Street suffixes
+    { from: "St", to: "Street" },
+    { from: "Ave", to: "Avenue" },
+    { from: "Blvd", to: "Boulevard" },
+    { from: "Rd", to: "Road" },
+    { from: "Dr", to: "Drive" },
+    { from: "Ct", to: "Court" },
+    { from: "Ln", to: "Lane" },
+    { from: "Pl", to: "Place" },
+    { from: "Pkwy", to: "Parkway" },
+    { from: "Hwy", to: "Highway" },
+    { from: "Sq", to: "Square" },
+    { from: "Ter", to: "Terrace" },
+];
+const FR_FR_DICT = [
+    { from: "R", to: "Rue" },
+    { from: "Bd", to: "Boulevard" },
+    { from: "Av", to: "Avenue" },
+    { from: "Bvd", to: "Boulevard" },
+    { from: "Pl", to: "Place" },
+    { from: "Imp", to: "Impasse" },
+    { from: "Sq", to: "Square" },
+];
+function getDictionary(locale) {
+    const lc = (locale ?? "en-US").toLowerCase();
+    if (lc.startsWith("fr"))
+        return FR_FR_DICT;
+    return EN_US_DICT;
+}
+/**
+ * Expand known abbreviations. Walks the input token-by-token (whitespace-delimited) and rewrites
+ * matching tokens to their canonical long form. The output map points every char of the expanded
+ * form to its position in the original short form (first char of input token).
+ *
+ * Case rules: match case-insensitively. Output form preserves the dictionary's canonical casing
+ * (`St` → `Street`, `st` → `Street`, `ST` → `Street`).
+ */
+export function expandAbbreviations(input, locale) {
+    const dict = getDictionary(locale);
+    const lookup = new Map();
+    for (const entry of dict)
+        lookup.set(entry.from.toLowerCase(), entry.to);
+    const out = [];
+    const map = [];
+    const expansions = [];
+    let i = 0;
+    while (i < input.length) {
+        const ch = input[i];
+        // Walk to end of token (non-whitespace, non-punctuation). Unicode-letter-aware so
+        // "République" stays one token instead of fragmenting on 'é'.
+        const isTokenChar = (c) => /[\p{L}\p{N}'_-]/u.test(c);
+        if (!isTokenChar(ch)) {
+            out.push(ch);
+            map.push(i);
+            i += 1;
+            continue;
+        }
+        const start = i;
+        while (i < input.length && isTokenChar(input[i]))
+            i += 1;
+        const token = input.slice(start, i);
+        const tokenWithTrailingDot = i < input.length && input[i] === "." ? `${token}.` : token;
+        const lookupKey = token.replace(/\.$/, "").toLowerCase();
+        const expansion = lookup.get(lookupKey);
+        if (!expansion) {
+            for (let k = 0; k < token.length; k++) {
+                out.push(token[k]);
+                map.push(start + k);
+            }
+            continue;
+        }
+        // Emit expansion; map every char back to start of source token.
+        for (let k = 0; k < expansion.length; k++) {
+            out.push(expansion[k]);
+            map.push(start + Math.min(k, token.length - 1));
+        }
+        expansions.push({
+            from: tokenWithTrailingDot,
+            to: expansion,
+            at: { start, end: i, body: token },
+        });
+        // Skip the trailing period if we consumed an abbreviation with one (e.g. "St." → "Street").
+        if (i < input.length && input[i] === ".")
+            i += 1;
+    }
+    return { text: out.join(""), map, expansions };
+}
+//# sourceMappingURL=abbreviations.js.map

package/out/abbreviations.js.map

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

package/out/cjk.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   CJK input normalization (Direction E, #291) — a conservative, character-level pass that runs as
+ *   part of `normalize()` so the parser sees a stable form of CJK addresses. It does only the
+ *   transformations that are UNAMBIGUOUS in any context:
+ *
+ *   - **Strip the postal mark 〒 (U+3012).** The JP cheap-probe found 〒 is byte-fallback OOV for the
+ *       SentencePiece tokenizer — it fragments into raw UTF-8 byte pieces and poisons the parse of
+ *       the digits right after it (the postcode gets mislabeled as a house number). It's a
+ *       "postcode follows" marker with no addressing content of its own, so dropping it is safe and
+ *       fixes the bug.
+ *   - **Fold full-width ASCII (U+FF01–U+FF5E → U+0021–U+007E).** A full-width `１` is always the digit
+ *       1, a full-width `－` always a hyphen — keyboards and copy-paste produce these constantly.
+ *       Folding them to ASCII makes `１０４−００６１` and `104-0061` the same input.
+ *   - **Fold the ideographic space (U+3000 → ' ').**
+ *
+ *   It deliberately does NOT convert **kanji numerals** (一二三…): place names carry numeral kanji as
+ *   ordinary characters (三田 _Mita_, 四谷 _Yotsuya_), so a blind 三→3 would corrupt them.
+ *   Disambiguating "this 三 is a block number, that one is part of a name" is parsing, not
+ *   normalization — deferred. Kana→kanji transliteration (ちょうめ→丁目) is dictionary work and likewise
+ *   deferred.
+ *
+ *   Self-gating: a string with none of these characters returns identity, so Latin input is
+ *   untouched.
+ */
+export interface CjkResult {
+    text: string;
+    map: number[];
+    /** Count of characters folded in place (full-width → ASCII, ideographic space → ' '). */
+    folded: number;
+    /** Count of characters dropped (the postal mark). */
+    stripped: number;
+}
+export declare function applyCjkNormalization(input: string): CjkResult;
+//# sourceMappingURL=cjk.d.ts.map

package/out/cjk.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cjk.d.ts","sourceRoot":"","sources":["../cjk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAIH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,yFAAyF;IACzF,MAAM,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,QAAQ,EAAE,MAAM,CAAA;CAChB;AAQD,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAkC9D"}

package/out/cjk.js

@@ -0,0 +1,68 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   CJK input normalization (Direction E, #291) — a conservative, character-level pass that runs as
+ *   part of `normalize()` so the parser sees a stable form of CJK addresses. It does only the
+ *   transformations that are UNAMBIGUOUS in any context:
+ *
+ *   - **Strip the postal mark 〒 (U+3012).** The JP cheap-probe found 〒 is byte-fallback OOV for the
+ *       SentencePiece tokenizer — it fragments into raw UTF-8 byte pieces and poisons the parse of
+ *       the digits right after it (the postcode gets mislabeled as a house number). It's a
+ *       "postcode follows" marker with no addressing content of its own, so dropping it is safe and
+ *       fixes the bug.
+ *   - **Fold full-width ASCII (U+FF01–U+FF5E → U+0021–U+007E).** A full-width `１` is always the digit
+ *       1, a full-width `－` always a hyphen — keyboards and copy-paste produce these constantly.
+ *       Folding them to ASCII makes `１０４−００６１` and `104-0061` the same input.
+ *   - **Fold the ideographic space (U+3000 → ' ').**
+ *
+ *   It deliberately does NOT convert **kanji numerals** (一二三…): place names carry numeral kanji as
+ *   ordinary characters (三田 _Mita_, 四谷 _Yotsuya_), so a blind 三→3 would corrupt them.
+ *   Disambiguating "this 三 is a block number, that one is part of a name" is parsing, not
+ *   normalization — deferred. Kana→kanji transliteration (ちょうめ→丁目) is dictionary work and likewise
+ *   deferred.
+ *
+ *   Self-gating: a string with none of these characters returns identity, so Latin input is
+ *   untouched.
+ */
+import { identityMap } from "./offset-map.js";
+const FULLWIDTH_START = 0xff01; // ！
+const FULLWIDTH_END = 0xff5e; // ～
+const FULLWIDTH_TO_ASCII = 0xfee0; // U+FFxx − 0xFEE0 = U+00xx
+const IDEOGRAPHIC_SPACE = 0x3000;
+const POSTAL_MARK = 0x3012; // 〒
+export function applyCjkNormalization(input) {
+    let folded = 0;
+    let stripped = 0;
+    const out = [];
+    const map = [];
+    // All transformed code points are in the BMP (single UTF-16 unit), and every other character is
+    // passed through verbatim, so a per-unit walk is safe for surrogate-pair input too.
+    for (let i = 0; i < input.length; i++) {
+        const code = input.charCodeAt(i);
+        if (code === POSTAL_MARK) {
+            stripped += 1;
+            continue; // drop — no addressing content; whitespace collapse later tidies any gap
+        }
+        if (code >= FULLWIDTH_START && code <= FULLWIDTH_END) {
+            out.push(String.fromCharCode(code - FULLWIDTH_TO_ASCII));
+            map.push(i);
+            folded += 1;
+            continue;
+        }
+        if (code === IDEOGRAPHIC_SPACE) {
+            out.push(" ");
+            map.push(i);
+            folded += 1;
+            continue;
+        }
+        out.push(input[i]);
+        map.push(i);
+    }
+    if (folded === 0 && stripped === 0) {
+        return { text: input, map: identityMap(input.length), folded: 0, stripped: 0 };
+    }
+    return { text: out.join(""), map, folded, stripped };
+}
+//# sourceMappingURL=cjk.js.map

package/out/cjk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cjk.js","sourceRoot":"","sources":["../cjk.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAW7C,MAAM,eAAe,GAAG,MAAM,CAAA,CAAC,IAAI;AACnC,MAAM,aAAa,GAAG,MAAM,CAAA,CAAC,IAAI;AACjC,MAAM,kBAAkB,GAAG,MAAM,CAAA,CAAC,2BAA2B;AAC7D,MAAM,iBAAiB,GAAG,MAAM,CAAA;AAChC,MAAM,WAAW,GAAG,MAAM,CAAA,CAAC,IAAI;AAE/B,MAAM,UAAU,qBAAqB,CAAC,KAAa;IAClD,IAAI,MAAM,GAAG,CAAC,CAAA;IACd,IAAI,QAAQ,GAAG,CAAC,CAAA;IAChB,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,MAAM,GAAG,GAAa,EAAE,CAAA;IAExB,gGAAgG;IAChG,oFAAoF;IACpF,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAChC,IAAI,IAAI,KAAK,WAAW,EAAE,CAAC;YAC1B,QAAQ,IAAI,CAAC,CAAA;YACb,SAAQ,CAAC,yEAAyE;QACnF,CAAC;QACD,IAAI,IAAI,IAAI,eAAe,IAAI,IAAI,IAAI,aAAa,EAAE,CAAC;YACtD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,GAAG,kBAAkB,CAAC,CAAC,CAAA;YACxD,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACX,MAAM,IAAI,CAAC,CAAA;YACX,SAAQ;QACT,CAAC;QACD,IAAI,IAAI,KAAK,iBAAiB,EAAE,CAAC;YAChC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;YACb,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACX,MAAM,IAAI,CAAC,CAAA;YACX,SAAQ;QACT,CAAC;QACD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,CAAA;QACnB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IACZ,CAAC;IAED,IAAI,MAAM,KAAK,CAAC,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;QACpC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC,EAAE,CAAA;IAC/E,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAA;AACrD,CAAC"}

package/out/compute.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `normalize(raw, opts)` — the Stage 1 entry point. Composes NFC + punctuation + whitespace
+ *   (always) with case-fold + abbreviation expansion (opt-in).
+ */
+import type { NormalizedInput, NormalizeOpts } from "./types.js";
+export declare function normalize(raw: string, opts?: NormalizeOpts): NormalizedInput;
+//# sourceMappingURL=compute.d.ts.map

package/out/compute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compute.d.ts","sourceRoot":"","sources":["../compute.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,OAAO,KAAK,EAA0B,eAAe,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAGxF,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,eAAe,CA2E5E"}

package/out/compute.js

@@ -0,0 +1,84 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `normalize(raw, opts)` — the Stage 1 entry point. Composes NFC + punctuation + whitespace
+ *   (always) with case-fold + abbreviation expansion (opt-in).
+ */
+import { expandAbbreviations } from "./abbreviations.js";
+import { applyCjkNormalization } from "./cjk.js";
+import { applyNfc } from "./nfc.js";
+import { composeMaps, identityMap } from "./offset-map.js";
+import { applyPunctuation } from "./punctuation.js";
+import { collapseWhitespace } from "./whitespace.js";
+export function normalize(raw, opts) {
+    const transforms = [];
+    let text = raw;
+    let map = identityMap(raw.length);
+    // 1. NFC
+    if (!opts?.skipNfc) {
+        const r = applyNfc(text);
+        text = r.text;
+        map = composeMaps(map, r.map);
+        transforms.push({ kind: "nfc", changed: r.changed });
+    }
+    // 1.5 CJK normalization — strip the postal mark 〒 (byte-fallback OOV that poisons the postcode
+    // parse) and fold full-width ASCII + the ideographic space. Runs after NFC so it sees composed
+    // forms, before punctuation/whitespace so any gap left by 〒 is then collapsed. No-op off-script.
+    {
+        const r = applyCjkNormalization(text);
+        if (r.folded > 0 || r.stripped > 0) {
+            text = r.text;
+            map = composeMaps(map, r.map);
+            transforms.push({ kind: "normalize_cjk", folded: r.folded, stripped: r.stripped });
+        }
+    }
+    // 2. Punctuation
+    {
+        const r = applyPunctuation(text);
+        if (r.replacements > 0) {
+            text = r.text;
+            map = composeMaps(map, r.map);
+            transforms.push({ kind: "normalize_punctuation", replacements: r.replacements });
+        }
+    }
+    // 3. Whitespace
+    {
+        const r = collapseWhitespace(text);
+        if (r.runs > 0 || r.text.length !== text.length) {
+            text = r.text;
+            map = composeMaps(map, r.map);
+            transforms.push({ kind: "collapse_whitespace", runs: r.runs });
+        }
+    }
+    // 4. Abbreviation expansion (opt-in) — runs BEFORE case-fold so case-folding the canonical
+    // expansion form (e.g. "Street") gives a consistent final case.
+    if (opts?.expandAbbreviations) {
+        const r = expandAbbreviations(text, opts.locale);
+        if (r.expansions.length > 0) {
+            text = r.text;
+            map = composeMaps(map, r.map);
+            for (const e of r.expansions) {
+                transforms.push({ kind: "expand_abbreviation", from: e.from, to: e.to, at: e.at });
+            }
+        }
+    }
+    // 5. Case fold (opt-in)
+    if (opts?.caseFold) {
+        const lc = text.toLocaleLowerCase(opts.locale);
+        if (lc !== text) {
+            text = lc;
+            // Case-fold is identity-length for ASCII + most Latin; map unchanged.
+            transforms.push({ kind: "case_fold", locale: opts.locale ?? "und" });
+        }
+    }
+    return Object.freeze({
+        raw,
+        normalized: text,
+        transforms: Object.freeze(transforms),
+        offsetMap: map,
+        appliedLocale: opts?.locale,
+    });
+}
+//# sourceMappingURL=compute.js.map

package/out/compute.js.map

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

package/out/index.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `@mailwoman/normalize` — Stage 1 of the runtime pipeline.
+ *
+ *   Deterministic input preprocessing: NFC, punctuation, whitespace, optional case-fold +
+ *   abbreviation expansion. Pure functions. Produces a `NormalizedInput` with a load-bearing
+ *   `offsetMap` so downstream stages can map normalized-string spans back to raw-string character
+ *   offsets.
+ *
+ *   See `docs/articles/plan/reference/STAGES.md` § Stage 1 for the contract.
+ */
+export { expandAbbreviations } from "./abbreviations.js";
+export { applyCjkNormalization, type CjkResult } from "./cjk.js";
+export { normalize } from "./compute.js";
+export { applyNfc } from "./nfc.js";
+export { composeMaps, identityMap } from "./offset-map.js";
+export { applyPunctuation } from "./punctuation.js";
+export type { NormalizationTransform, NormalizeOpts, NormalizedInput, SpanRange } from "./types.js";
+export { collapseWhitespace } from "./whitespace.js";
+//# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAE,KAAK,SAAS,EAAE,MAAM,UAAU,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AACnD,YAAY,EAAE,sBAAsB,EAAE,aAAa,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AACnG,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/out/index.js

@@ -0,0 +1,22 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   `@mailwoman/normalize` — Stage 1 of the runtime pipeline.
+ *
+ *   Deterministic input preprocessing: NFC, punctuation, whitespace, optional case-fold +
+ *   abbreviation expansion. Pure functions. Produces a `NormalizedInput` with a load-bearing
+ *   `offsetMap` so downstream stages can map normalized-string spans back to raw-string character
+ *   offsets.
+ *
+ *   See `docs/articles/plan/reference/STAGES.md` § Stage 1 for the contract.
+ */
+export { expandAbbreviations } from "./abbreviations.js";
+export { applyCjkNormalization } from "./cjk.js";
+export { normalize } from "./compute.js";
+export { applyNfc } from "./nfc.js";
+export { composeMaps, identityMap } from "./offset-map.js";
+export { applyPunctuation } from "./punctuation.js";
+export { collapseWhitespace } from "./whitespace.js";
+//# sourceMappingURL=index.js.map

package/out/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,EAAE,qBAAqB,EAAkB,MAAM,UAAU,CAAA;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AACxC,OAAO,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAA;AACnC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAA;AAEnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAA"}

package/out/nfc.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Unicode NFC normalization. For inputs already in NFC (the common case) this is a no-op. When the
+ *   input has combining characters (`e` + `́` → `é`), NFC composes them — the normalized string can
+ *   be shorter than the raw.
+ *
+ *   Approximation: we walk the input grapheme-by-grapheme (best effort via codepoint stepping) and
+ *   map each output index to the start of its source sequence. Rare CJK edge cases involving
+ *   variant selectors may produce off-by-one offsets — acceptable for v1.
+ */
+export interface NfcResult {
+    text: string;
+    /** `text[i]` came from `input[map[i]]`. */
+    map: number[];
+    changed: boolean;
+}
+export declare function applyNfc(input: string): NfcResult;
+//# sourceMappingURL=nfc.d.ts.map

package/out/nfc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nfc.d.ts","sourceRoot":"","sources":["../nfc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,SAAS;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,2CAA2C;IAC3C,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,OAAO,EAAE,OAAO,CAAA;CAChB;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAMjD"}

package/out/nfc.js

@@ -0,0 +1,53 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Unicode NFC normalization. For inputs already in NFC (the common case) this is a no-op. When the
+ *   input has combining characters (`e` + `́` → `é`), NFC composes them — the normalized string can
+ *   be shorter than the raw.
+ *
+ *   Approximation: we walk the input grapheme-by-grapheme (best effort via codepoint stepping) and
+ *   map each output index to the start of its source sequence. Rare CJK edge cases involving
+ *   variant selectors may produce off-by-one offsets — acceptable for v1.
+ */
+import { identityMap } from "./offset-map.js";
+export function applyNfc(input) {
+    const normalized = input.normalize("NFC");
+    if (normalized === input) {
+        return { text: input, map: identityMap(input.length), changed: false };
+    }
+    return { text: normalized, map: estimateNfcMap(input, normalized), changed: true };
+}
+/**
+ * Estimate per-output-codepoint offsets. Walks both strings in parallel; emits the next source
+ * index for each output position. Imprecise for combining sequences but correct for length-equal
+ * NFC outputs (the common length-changing case is when a sequence shortens).
+ */
+function estimateNfcMap(input, output) {
+    const map = [];
+    let inIdx = 0;
+    for (let outIdx = 0; outIdx < output.length; outIdx++) {
+        map.push(inIdx);
+        const outCp = output.codePointAt(outIdx);
+        const outStep = outCp > 0xffff ? 2 : 1;
+        // Walk the input forward by at least one codepoint; absorb any combining marks (0x0300–0x036f).
+        if (inIdx < input.length) {
+            const inCp = input.codePointAt(inIdx);
+            inIdx += inCp > 0xffff ? 2 : 1;
+            while (inIdx < input.length) {
+                const nextCp = input.codePointAt(inIdx);
+                if (nextCp >= 0x0300 && nextCp <= 0x036f) {
+                    inIdx += nextCp > 0xffff ? 2 : 1;
+                }
+                else {
+                    break;
+                }
+            }
+        }
+        if (outStep === 2)
+            outIdx += 1;
+    }
+    return map;
+}
+//# sourceMappingURL=nfc.js.map

package/out/nfc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nfc.js","sourceRoot":"","sources":["../nfc.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAS7C,MAAM,UAAU,QAAQ,CAAC,KAAa;IACrC,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAA;IACzC,IAAI,UAAU,KAAK,KAAK,EAAE,CAAC;QAC1B,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAA;IACvE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,cAAc,CAAC,KAAK,EAAE,UAAU,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAA;AACnF,CAAC;AAED;;;;GAIG;AACH,SAAS,cAAc,CAAC,KAAa,EAAE,MAAc;IACpD,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,IAAI,MAAM,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC;QACvD,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACf,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAE,CAAA;QACzC,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;QACtC,gGAAgG;QAChG,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAE,CAAA;YACtC,KAAK,IAAI,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;YAC9B,OAAO,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC7B,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,CAAC,KAAK,CAAE,CAAA;gBACxC,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;oBAC1C,KAAK,IAAI,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAA;gBACjC,CAAC;qBAAM,CAAC;oBACP,MAAK;gBACN,CAAC;YACF,CAAC;QACF,CAAC;QACD,IAAI,OAAO,KAAK,CAAC;YAAE,MAAM,IAAI,CAAC,CAAA;IAC/B,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC"}

package/out/offset-map.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Utilities for composing per-transform offset maps into the final `raw → normalized` map.
+ */
+/** Identity map for an input of length `n`: `[0, 1, 2, ..., n-1]`. */
+export declare function identityMap(n: number): number[];
+/**
+ * Compose `inputMap` (input → raw) with `transformMap` (output → input) to produce `outputMap`
+ * (output → raw).
+ *
+ * @example // raw = "350 5th" (chars 0..7, double space at 3-4) // input = "350 5th" (identity from
+ * raw, length 8) // output = "350 5th" (whitespace collapsed, length 7) // inputMap =
+ * [0,1,2,3,4,5,6,7] // transformMap = [0,1,2,3,5,6,7] (output[3]=' ' came from input[3];
+ * output[4]='5' from input[5]) // composed = [0,1,2,3,5,6,7]
+ */
+export declare function composeMaps(inputMap: number[], transformMap: number[]): number[];
+//# sourceMappingURL=offset-map.d.ts.map

package/out/offset-map.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"offset-map.d.ts","sourceRoot":"","sources":["../offset-map.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAI/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,YAAY,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAOhF"}

package/out/offset-map.js

@@ -0,0 +1,32 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Utilities for composing per-transform offset maps into the final `raw → normalized` map.
+ */
+/** Identity map for an input of length `n`: `[0, 1, 2, ..., n-1]`. */
+export function identityMap(n) {
+    const m = new Array(n);
+    for (let i = 0; i < n; i++)
+        m[i] = i;
+    return m;
+}
+/**
+ * Compose `inputMap` (input → raw) with `transformMap` (output → input) to produce `outputMap`
+ * (output → raw).
+ *
+ * @example // raw = "350 5th" (chars 0..7, double space at 3-4) // input = "350 5th" (identity from
+ * raw, length 8) // output = "350 5th" (whitespace collapsed, length 7) // inputMap =
+ * [0,1,2,3,4,5,6,7] // transformMap = [0,1,2,3,5,6,7] (output[3]=' ' came from input[3];
+ * output[4]='5' from input[5]) // composed = [0,1,2,3,5,6,7]
+ */
+export function composeMaps(inputMap, transformMap) {
+    const out = new Array(transformMap.length);
+    for (let i = 0; i < transformMap.length; i++) {
+        const j = transformMap[i];
+        out[i] = inputMap[j] ?? j;
+    }
+    return out;
+}
+//# sourceMappingURL=offset-map.js.map

package/out/offset-map.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"offset-map.js","sourceRoot":"","sources":["../offset-map.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,CAAS;IACpC,MAAM,CAAC,GAAG,IAAI,KAAK,CAAS,CAAC,CAAC,CAAA;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE;QAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IACpC,OAAO,CAAC,CAAA;AACT,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,WAAW,CAAC,QAAkB,EAAE,YAAsB;IACrE,MAAM,GAAG,GAAG,IAAI,KAAK,CAAS,YAAY,CAAC,MAAM,CAAC,CAAA;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,YAAY,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9C,MAAM,CAAC,GAAG,YAAY,CAAC,CAAC,CAAE,CAAA;QAC1B,GAAG,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAA;IAC1B,CAAC;IACD,OAAO,GAAG,CAAA;AACX,CAAC"}

package/out/punctuation.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Punctuation normalization — fancy quotes / dashes to ASCII equivalents. Identity-length: every
+ *   fancy character is a single codepoint that maps to a single ASCII char.
+ */
+export interface PunctuationResult {
+    text: string;
+    map: number[];
+    replacements: number;
+}
+export declare function applyPunctuation(input: string): PunctuationResult;
+//# sourceMappingURL=punctuation.d.ts.map

package/out/punctuation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"punctuation.d.ts","sourceRoot":"","sources":["../punctuation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiBH,MAAM,WAAW,iBAAiB;IACjC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,YAAY,EAAE,MAAM,CAAA;CACpB;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,iBAAiB,CA0BjE"}

package/out/punctuation.js

@@ -0,0 +1,48 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Punctuation normalization — fancy quotes / dashes to ASCII equivalents. Identity-length: every
+ *   fancy character is a single codepoint that maps to a single ASCII char.
+ */
+import { identityMap } from "./offset-map.js";
+const REPLACEMENTS = new Map([
+    ["‘", "'"], // ‘
+    ["’", "'"], // ’
+    ["“", '"'], // “
+    ["”", '"'], // ”
+    ["–", "-"], // – en dash
+    ["—", "-"], // — em dash
+    ["−", "-"], // − U+2212 minus sign — Japanese IMEs emit this as the block separator (1−2−3)
+    ["―", "-"], // ― U+2015 horizontal bar — another common JP block separator
+    ["…", "..."], // … expands; tracked specially
+    [" ", " "], // non-breaking space
+]);
+export function applyPunctuation(input) {
+    let changed = false;
+    let replacements = 0;
+    const out = [];
+    const map = [];
+    for (let i = 0; i < input.length; i++) {
+        const ch = input[i];
+        const sub = REPLACEMENTS.get(ch);
+        if (sub === undefined) {
+            out.push(ch);
+            map.push(i);
+        }
+        else {
+            changed = true;
+            replacements += 1;
+            for (let k = 0; k < sub.length; k++) {
+                out.push(sub[k]);
+                map.push(i);
+            }
+        }
+    }
+    if (!changed) {
+        return { text: input, map: identityMap(input.length), replacements: 0 };
+    }
+    return { text: out.join(""), map, replacements };
+}
+//# sourceMappingURL=punctuation.js.map

package/out/punctuation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"punctuation.js","sourceRoot":"","sources":["../punctuation.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAE7C,MAAM,YAAY,GAAG,IAAI,GAAG,CAAiB;IAC5C,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI;IAChB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI;IAChB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI;IAChB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,IAAI;IAChB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,YAAY;IACxB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,YAAY;IACxB,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,+EAA+E;IAC3F,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,8DAA8D;IAC1E,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,+BAA+B;IAC7C,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,qBAAqB;CACjC,CAAC,CAAA;AAQF,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC7C,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,IAAI,YAAY,GAAG,CAAC,CAAA;IACpB,MAAM,GAAG,GAAa,EAAE,CAAA;IACxB,MAAM,GAAG,GAAa,EAAE,CAAA;IAExB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,EAAE,GAAG,KAAK,CAAC,CAAC,CAAE,CAAA;QACpB,MAAM,GAAG,GAAG,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;QAChC,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACvB,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAA;YACZ,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACZ,CAAC;aAAM,CAAC;YACP,OAAO,GAAG,IAAI,CAAA;YACd,YAAY,IAAI,CAAC,CAAA;YACjB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;gBACrC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAE,CAAC,CAAA;gBACjB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;YACZ,CAAC;QACF,CAAC;IACF,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACd,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,YAAY,EAAE,CAAC,EAAE,CAAA;IACxE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,CAAA;AACjD,CAAC"}

package/out/types.d.ts

@@ -0,0 +1,63 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export interface SpanRange {
+    start: number;
+    end: number;
+    body: string;
+}
+/** A single normalization step, as recorded on `NormalizedInput.transforms`. */
+export type NormalizationTransform = {
+    kind: "nfc";
+    changed: boolean;
+} | {
+    kind: "case_fold";
+    locale: string;
+} | {
+    kind: "expand_abbreviation";
+    from: string;
+    to: string;
+    at: SpanRange;
+} | {
+    kind: "collapse_whitespace";
+    runs: number;
+} | {
+    kind: "normalize_punctuation";
+    replacements: number;
+} | {
+    kind: "normalize_cjk";
+    folded: number;
+    stripped: number;
+};
+/**
+ * Result of running `normalize()` on a raw input string.
+ *
+ * `offsetMap[i]` is the index in `raw` from which `normalized[i]` came. For multi-character source
+ * sequences (NFC composition, whitespace collapse, abbreviation expansion), each output char points
+ * to the FIRST source char by convention.
+ */
+export interface NormalizedInput {
+    /** The input as the caller sent it. */
+    raw: string;
+    /** Canonical form, all transforms applied. */
+    normalized: string;
+    /** Ordered record of what was done. */
+    transforms: NormalizationTransform[];
+    /** `normalized[i]` came from `raw[offsetMap[i]]`. Length === normalized.length. */
+    offsetMap: number[];
+    /** The locale used for case-folding + abbreviation rules. */
+    appliedLocale?: string;
+}
+export interface NormalizeOpts {
+    /** Locale hint for case-folding + abbreviation dictionaries. */
+    locale?: string;
+    /** Apply locale-aware lowercasing. Default: false (preserve case for downstream consumers). */
+    caseFold?: boolean;
+    /** Expand known abbreviations (`St` → `Street`, `NW` → `Northwest`, etc.). Default: false. */
+    expandAbbreviations?: boolean;
+    /** Skip Unicode NFC. Only use for debugging — production callers should leave on. */
+    skipNfc?: boolean;
+}
+//# sourceMappingURL=types.d.ts.map

package/out/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAA;IACb,GAAG,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,gFAAgF;AAChF,MAAM,MAAM,sBAAsB,GAC/B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,SAAS,CAAA;CAAE,GACxE;IAAE,IAAI,EAAE,qBAAqB,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,uBAAuB,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GACvD;IAAE,IAAI,EAAE,eAAe,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC/B,uCAAuC;IACvC,GAAG,EAAE,MAAM,CAAA;IAEX,8CAA8C;IAC9C,UAAU,EAAE,MAAM,CAAA;IAElB,uCAAuC;IACvC,UAAU,EAAE,sBAAsB,EAAE,CAAA;IAEpC,mFAAmF;IACnF,SAAS,EAAE,MAAM,EAAE,CAAA;IAEnB,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,WAAW,aAAa;IAC7B,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IAEf,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,OAAO,CAAA;IAElB,8FAA8F;IAC9F,mBAAmB,CAAC,EAAE,OAAO,CAAA;IAE7B,qFAAqF;IACrF,OAAO,CAAC,EAAE,OAAO,CAAA;CACjB"}

package/out/types.js

@@ -0,0 +1,7 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/out/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/out/whitespace.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Whitespace collapse — runs of whitespace become a single ASCII space. Newlines and tabs are
+ *   preserved as-is (segmentation grammar in QueryShape uses them); inline runs of spaces
+ *   collapse.
+ */
+export interface WhitespaceResult {
+    text: string;
+    map: number[];
+    runs: number;
+}
+export declare function collapseWhitespace(input: string): WhitespaceResult;
+//# sourceMappingURL=whitespace.d.ts.map

package/out/whitespace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whitespace.d.ts","sourceRoot":"","sources":["../whitespace.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAOH,MAAM,WAAW,gBAAgB;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,EAAE,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;CACZ;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,gBAAgB,CAoDlE"}

package/out/whitespace.js

@@ -0,0 +1,66 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Whitespace collapse — runs of whitespace become a single ASCII space. Newlines and tabs are
+ *   preserved as-is (segmentation grammar in QueryShape uses them); inline runs of spaces
+ *   collapse.
+ */
+import { identityMap } from "./offset-map.js";
+const INLINE_SPACE = /[ \t]/;
+const ANY_SPACE = /[ \t\n\r]/;
+export function collapseWhitespace(input) {
+    let changed = false;
+    let runs = 0;
+    const out = [];
+    const map = [];
+    let i = 0;
+    while (i < input.length) {
+        const ch = input[i];
+        if (ch === "\n" || ch === "\r") {
+            // Preserve newlines as segment separators.
+            out.push(ch);
+            map.push(i);
+            i += 1;
+            continue;
+        }
+        if (INLINE_SPACE.test(ch)) {
+            out.push(" ");
+            map.push(i);
+            const start = i;
+            i += 1;
+            while (i < input.length && INLINE_SPACE.test(input[i]))
+                i += 1;
+            if (i - start > 1) {
+                changed = true;
+                runs += 1;
+            }
+            continue;
+        }
+        // Collapse \r\n into one
+        if (ch === "\n" && out[out.length - 1] === "\r") {
+            // Already handled in CR branch above by emitting both; skip combiner check
+        }
+        out.push(ch);
+        map.push(i);
+        i += 1;
+    }
+    // Trim leading and trailing whitespace.
+    let lead = 0;
+    while (lead < out.length && ANY_SPACE.test(out[lead]))
+        lead += 1;
+    let trail = out.length;
+    while (trail > lead && ANY_SPACE.test(out[trail - 1]))
+        trail -= 1;
+    if (lead > 0 || trail < out.length) {
+        changed = true;
+    }
+    const trimmedOut = out.slice(lead, trail);
+    const trimmedMap = map.slice(lead, trail);
+    if (!changed && trimmedOut.length === input.length) {
+        return { text: input, map: identityMap(input.length), runs: 0 };
+    }
+    return { text: trimmedOut.join(""), map: trimmedMap, runs };
+}
+//# sourceMappingURL=whitespace.js.map

package/out/whitespace.js.map

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

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@mailwoman/normalize",
+  "version": "4.0.0",
+  "description": "Stage 1 of the runtime pipeline — deterministic input preprocessing (Unicode NFC, punctuation, whitespace, abbreviation). Pure functions, no ML.",
+  "license": "AGPL-3.0-only",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/sister-software/mailwoman.git",
+    "directory": "normalize"
+  },
+  "type": "module",
+  "exports": {
+    "./package.json": "./package.json",
+    ".": "./out/index.js"
+  },
+  "files": [
+    "out/**/*.js",
+    "out/**/*.js.map",
+    "out/**/*.d.ts",
+    "out/**/*.d.ts.map"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}