@mailwoman/core 2.0.0

package/out/locale/profiles/en-us.js

@@ -0,0 +1,67 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   En-US locale profile (per Phase 0 task 5). Lists the rule classifier IDs the legacy registry will
+ *   assign and the `ComponentTag`s the US locale actually uses. No `weightsPackage` is set in Phase
+ *   0 — neural weights ship in Phase 3.
+ */
+export const enUS = {
+    locale: "en-US",
+    ruleClassifiers: [
+        "alpha_numeric",
+        "chain",
+        "compound_level",
+        "compound_street",
+        "compound_unit_designator",
+        "directional",
+        "given_name",
+        "house_number",
+        "intersection",
+        "level",
+        "level_designator",
+        "middle_initial",
+        "ordinal",
+        "person",
+        "personal_suffix",
+        "personal_title",
+        "place",
+        "postcode",
+        "road_type",
+        "stop_word",
+        "street_prefix",
+        "street_proper_name",
+        "street_suffix",
+        "surname",
+        "token_position",
+        "toponym",
+        "unit",
+        "unit_designator",
+        "whos_on_first",
+        "composite_intersection",
+        "composite_person",
+        "composite_street",
+        "composite_street_name",
+        "composite_venue",
+        "subdivision",
+    ],
+    componentsSupported: [
+        "country",
+        "region",
+        "locality",
+        "postcode",
+        "house_number",
+        "street",
+        "street_prefix",
+        "street_suffix",
+        "unit",
+        "venue",
+        "attention",
+        "po_box",
+        "intersection_a",
+        "intersection_b",
+    ],
+    policy: [],
+};
+//# sourceMappingURL=en-us.js.map

package/out/locale/profiles/en-us.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"en-us.js","sourceRoot":"","sources":["../../../locale/profiles/en-us.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,CAAC,MAAM,IAAI,GAAkB;IAClC,MAAM,EAAE,OAAO;IACf,eAAe,EAAE;QAChB,eAAe;QACf,OAAO;QACP,gBAAgB;QAChB,iBAAiB;QACjB,0BAA0B;QAC1B,aAAa;QACb,YAAY;QACZ,cAAc;QACd,cAAc;QACd,OAAO;QACP,kBAAkB;QAClB,gBAAgB;QAChB,SAAS;QACT,QAAQ;QACR,iBAAiB;QACjB,gBAAgB;QAChB,OAAO;QACP,UAAU;QACV,WAAW;QACX,WAAW;QACX,eAAe;QACf,oBAAoB;QACpB,eAAe;QACf,SAAS;QACT,gBAAgB;QAChB,SAAS;QACT,MAAM;QACN,iBAAiB;QACjB,eAAe;QACf,wBAAwB;QACxB,kBAAkB;QAClB,kBAAkB;QAClB,uBAAuB;QACvB,iBAAiB;QACjB,aAAa;KACb;IACD,mBAAmB,EAAE;QACpB,SAAS;QACT,QAAQ;QACR,UAAU;QACV,UAAU;QACV,cAAc;QACd,QAAQ;QACR,eAAe;QACf,eAAe;QACf,MAAM;QACN,OAAO;QACP,WAAW;QACX,QAAQ;QACR,gBAAgB;QAChB,gBAAgB;KAChB;IACD,MAAM,EAAE,EAAE;CACV,CAAA"}

package/out/locale/profiles/fr-fr.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Fr-FR locale profile (per Phase 0 task 5). Uses the same rule classifier set as en-US for
+ *   locale-agnostic primitives, with the French-specific component set: cedex (postal routing),
+ *   street_prefix_particle (de la / du / des), and dependent_locality (arrondissement). The
+ *   `central_european_street_name` classifier lives in the registry for FR / DE / etc. and is
+ *   included here.
+ */
+import type { LocaleProfile } from "../locale.js";
+export declare const frFR: LocaleProfile;
+//# sourceMappingURL=fr-fr.d.ts.map

package/out/locale/profiles/fr-fr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fr-fr.d.ts","sourceRoot":"","sources":["../../../locale/profiles/fr-fr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,eAAO,MAAM,IAAI,EAAE,aA4DlB,CAAA"}

package/out/locale/profiles/fr-fr.js

@@ -0,0 +1,73 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Fr-FR locale profile (per Phase 0 task 5). Uses the same rule classifier set as en-US for
+ *   locale-agnostic primitives, with the French-specific component set: cedex (postal routing),
+ *   street_prefix_particle (de la / du / des), and dependent_locality (arrondissement). The
+ *   `central_european_street_name` classifier lives in the registry for FR / DE / etc. and is
+ *   included here.
+ */
+export const frFR = {
+    locale: "fr-FR",
+    ruleClassifiers: [
+        "alpha_numeric",
+        "central_european_street_name",
+        "chain",
+        "compound_level",
+        "compound_street",
+        "compound_unit_designator",
+        "directional",
+        "given_name",
+        "house_number",
+        "intersection",
+        "level",
+        "level_designator",
+        "middle_initial",
+        "ordinal",
+        "person",
+        "personal_suffix",
+        "personal_title",
+        "place",
+        "postcode",
+        "road_type",
+        "stop_word",
+        "street_prefix",
+        "street_proper_name",
+        "street_suffix",
+        "surname",
+        "token_position",
+        "toponym",
+        "unit",
+        "unit_designator",
+        "whos_on_first",
+        "composite_intersection",
+        "composite_person",
+        "composite_street",
+        "composite_street_name",
+        "composite_venue",
+        "subdivision",
+    ],
+    componentsSupported: [
+        "country",
+        "region",
+        "locality",
+        "postcode",
+        "house_number",
+        "street",
+        "street_prefix",
+        "street_prefix_particle",
+        "street_suffix",
+        "unit",
+        "venue",
+        "attention",
+        "po_box",
+        "intersection_a",
+        "intersection_b",
+        "cedex",
+        "dependent_locality",
+    ],
+    policy: [],
+};
+//# sourceMappingURL=fr-fr.js.map

package/out/locale/profiles/fr-fr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fr-fr.js","sourceRoot":"","sources":["../../../locale/profiles/fr-fr.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,MAAM,CAAC,MAAM,IAAI,GAAkB;IAClC,MAAM,EAAE,OAAO;IACf,eAAe,EAAE;QAChB,eAAe;QACf,8BAA8B;QAC9B,OAAO;QACP,gBAAgB;QAChB,iBAAiB;QACjB,0BAA0B;QAC1B,aAAa;QACb,YAAY;QACZ,cAAc;QACd,cAAc;QACd,OAAO;QACP,kBAAkB;QAClB,gBAAgB;QAChB,SAAS;QACT,QAAQ;QACR,iBAAiB;QACjB,gBAAgB;QAChB,OAAO;QACP,UAAU;QACV,WAAW;QACX,WAAW;QACX,eAAe;QACf,oBAAoB;QACpB,eAAe;QACf,SAAS;QACT,gBAAgB;QAChB,SAAS;QACT,MAAM;QACN,iBAAiB;QACjB,eAAe;QACf,wBAAwB;QACxB,kBAAkB;QAClB,kBAAkB;QAClB,uBAAuB;QACvB,iBAAiB;QACjB,aAAa;KACb;IACD,mBAAmB,EAAE;QACpB,SAAS;QACT,QAAQ;QACR,UAAU;QACV,UAAU;QACV,cAAc;QACd,QAAQ;QACR,eAAe;QACf,wBAAwB;QACxB,eAAe;QACf,MAAM;QACN,OAAO;QACP,WAAW;QACX,QAAQ;QACR,gBAAgB;QAChB,gBAAgB;QAChB,OAAO;QACP,oBAAoB;KACpB;IACD,MAAM,EAAE,EAAE;CACV,CAAA"}

package/out/locale/profiles/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "./en-us.js";
+export * from "./fr-fr.js";
+export * from "./ja-jp.js";
+//# sourceMappingURL=index.d.ts.map

package/out/locale/profiles/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../locale/profiles/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/out/locale/profiles/index.js

@@ -0,0 +1,9 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "./en-us.js";
+export * from "./fr-fr.js";
+export * from "./ja-jp.js";
+//# sourceMappingURL=index.js.map

package/out/locale/profiles/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../locale/profiles/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/out/locale/profiles/ja-jp.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Ja-JP locale profile, used in Phase 0 §8 for the forward-compat sanity check (#8 task 8): does
+ *   the core abstraction accept a locale that omits `street` and `house_number` entirely without
+ *   throwing or tripping a type assertion? If this profile registers cleanly today, Phase 6 (Japan)
+ *   does not need a core refactor.
+ *
+ *   Note: no rule classifiers are listed because the JP profile is neural-only in Phase 6. The rule
+ *   pipeline does not produce Japanese-specific tags; declaring an empty list here verifies the
+ *   system does not assume there are rule classifiers for every locale.
+ */
+import type { LocaleProfile } from "../locale.js";
+export declare const jaJP: LocaleProfile;
+//# sourceMappingURL=ja-jp.d.ts.map

package/out/locale/profiles/ja-jp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ja-jp.d.ts","sourceRoot":"","sources":["../../../locale/profiles/ja-jp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,eAAO,MAAM,IAAI,EAAE,aAelB,CAAA"}

package/out/locale/profiles/ja-jp.js

@@ -0,0 +1,31 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   Ja-JP locale profile, used in Phase 0 §8 for the forward-compat sanity check (#8 task 8): does
+ *   the core abstraction accept a locale that omits `street` and `house_number` entirely without
+ *   throwing or tripping a type assertion? If this profile registers cleanly today, Phase 6 (Japan)
+ *   does not need a core refactor.
+ *
+ *   Note: no rule classifiers are listed because the JP profile is neural-only in Phase 6. The rule
+ *   pipeline does not produce Japanese-specific tags; declaring an empty list here verifies the
+ *   system does not assume there are rule classifiers for every locale.
+ */
+export const jaJP = {
+    locale: "ja-JP",
+    ruleClassifiers: [],
+    componentsSupported: [
+        "country",
+        "postcode",
+        "prefecture",
+        "municipality",
+        "district",
+        "block",
+        "sub_block",
+        "building_number",
+        "building_name",
+    ],
+    policy: [],
+};
+//# sourceMappingURL=ja-jp.js.map

package/out/locale/profiles/ja-jp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ja-jp.js","sourceRoot":"","sources":["../../../locale/profiles/ja-jp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,CAAC,MAAM,IAAI,GAAkB;IAClC,MAAM,EAAE,OAAO;IACf,eAAe,EAAE,EAAE;IACnB,mBAAmB,EAAE;QACpB,SAAS;QACT,UAAU;QACV,YAAY;QACZ,cAAc;QACd,UAAU;QACV,OAAO;QACP,WAAW;QACX,iBAAiB;QACjB,eAAe;KACf;IACD,MAAM,EAAE,EAAE;CACV,CAAA"}

package/out/locale/registry.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   In-memory `LocaleRegistry`. Validates that every `LocaleProfile.componentsSupported` entry is a
+ *   known `ComponentTag`, and that each policy override targets a component inside
+ *   `componentsSupported`. Fails loudly at registration when either invariant is broken (#6
+ *   §LocaleProfile validation rule).
+ */
+import type { LocaleProfile, LocaleRegistry } from "./locale.js";
+export declare class InMemoryLocaleRegistry implements LocaleRegistry {
+    #private;
+    register(profile: LocaleProfile): void;
+    get(locale: string): LocaleProfile | undefined;
+    list(): LocaleProfile[];
+    /** Remove a locale. No-op if not present. */
+    unregister(locale: string): void;
+}
+//# sourceMappingURL=registry.d.ts.map

package/out/locale/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../locale/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAIhE,qBAAa,sBAAuB,YAAW,cAAc;;IAG5D,QAAQ,CAAC,OAAO,EAAE,aAAa,GAAG,IAAI;IAKtC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI9C,IAAI,IAAI,aAAa,EAAE;IAIvB,6CAA6C;IAC7C,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;CAGhC"}

package/out/locale/registry.js

@@ -0,0 +1,49 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ *
+ *   In-memory `LocaleRegistry`. Validates that every `LocaleProfile.componentsSupported` entry is a
+ *   known `ComponentTag`, and that each policy override targets a component inside
+ *   `componentsSupported`. Fails loudly at registration when either invariant is broken (#6
+ *   §LocaleProfile validation rule).
+ */
+import { COMPONENT_TAGS } from "@mailwoman/core/types";
+const COMPONENT_TAG_SET = new Set(COMPONENT_TAGS);
+export class InMemoryLocaleRegistry {
+    #profiles = new Map();
+    register(profile) {
+        assertValidProfile(profile);
+        this.#profiles.set(profile.locale, profile);
+    }
+    get(locale) {
+        return this.#profiles.get(locale);
+    }
+    list() {
+        return Array.from(this.#profiles.values());
+    }
+    /** Remove a locale. No-op if not present. */
+    unregister(locale) {
+        this.#profiles.delete(locale);
+    }
+}
+function assertValidProfile(profile) {
+    if (!profile.locale) {
+        throw new TypeError("LocaleProfile.locale must be a non-empty BCP-47 tag");
+    }
+    const supported = new Set(profile.componentsSupported);
+    for (const tag of supported) {
+        if (!COMPONENT_TAG_SET.has(tag)) {
+            throw new RangeError(`LocaleProfile ${profile.locale}: componentsSupported contains unknown ComponentTag ${JSON.stringify(tag)}`);
+        }
+    }
+    for (const policy of profile.policy) {
+        if (!COMPONENT_TAG_SET.has(policy.component)) {
+            throw new RangeError(`LocaleProfile ${profile.locale}: policy targets unknown ComponentTag ${JSON.stringify(policy.component)}`);
+        }
+        if (!supported.has(policy.component)) {
+            throw new RangeError(`LocaleProfile ${profile.locale}: policy targets ${policy.component} which is not in componentsSupported`);
+        }
+    }
+}
+//# sourceMappingURL=registry.js.map

package/out/locale/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../locale/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,cAAc,EAAqB,MAAM,uBAAuB,CAAA;AAGzE,MAAM,iBAAiB,GAAG,IAAI,GAAG,CAAe,cAAc,CAAC,CAAA;AAE/D,MAAM,OAAO,sBAAsB;IAClC,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAA;IAE5C,QAAQ,CAAC,OAAsB;QAC9B,kBAAkB,CAAC,OAAO,CAAC,CAAA;QAC3B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC5C,CAAC;IAED,GAAG,CAAC,MAAc;QACjB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAClC,CAAC;IAED,IAAI;QACH,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED,6CAA6C;IAC7C,UAAU,CAAC,MAAc;QACxB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IAC9B,CAAC;CACD;AAED,SAAS,kBAAkB,CAAC,OAAsB;IACjD,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACrB,MAAM,IAAI,SAAS,CAAC,qDAAqD,CAAC,CAAA;IAC3E,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,GAAG,CAAe,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACpE,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC7B,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACjC,MAAM,IAAI,UAAU,CACnB,iBAAiB,OAAO,CAAC,MAAM,uDAAuD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAC3G,CAAA;QACF,CAAC;IACF,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QACrC,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9C,MAAM,IAAI,UAAU,CACnB,iBAAiB,OAAO,CAAC,MAAM,yCAAyC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAC1G,CAAA;QACF,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,UAAU,CACnB,iBAAiB,OAAO,CAAC,MAAM,oBAAoB,MAAM,CAAC,SAAS,sCAAsC,CACzG,CAAA;QACF,CAAC;IACF,CAAC;AACF,CAAC"}

package/out/parser/AddressParser.d.ts

@@ -0,0 +1,97 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { Alpha2LanguageCode } from "@mailwoman/core";
+import type { Classifier, ClassifierConstructor } from "@mailwoman/core/classification";
+import type { PolicyRegistry } from "@mailwoman/core/policy";
+import { type FilterRelation, type SerializedSolution, Solution, type Solver, type SolverConstructor } from "@mailwoman/core/solver";
+import { TokenContext } from "@mailwoman/core/tokenization";
+import type { ClassificationProposal, ProposalClassifier } from "@mailwoman/core/types";
+import type { PerformanceMeasure } from "node:perf_hooks";
+import { type WritebackResult } from "./proposal-pipeline.js";
+export interface AddressParserOptions {
+    classifiers?: Iterable<Classifier | ClassifierConstructor>;
+    solvers?: Iterable<Solver | SolverConstructor>;
+    languages?: Alpha2LanguageCode[] | readonly Alpha2LanguageCode[] | Set<Alpha2LanguageCode> | ReadonlySet<Alpha2LanguageCode>;
+    solutionLimit?: number;
+    mustNotFollow?: FilterRelation[];
+    /**
+     * Proposal-based classifiers (rule classifiers via `wrapLegacyClassifier`, the neural classifier
+     * via `createNeuralProposalClassifier`, or any custom impl). When provided, they run AFTER the
+     * legacy `classifiers` mutation pass; surviving proposals are written back to the same
+     * `TokenContext` for the solver. The legacy `classifiers` array still runs unchanged so existing
+     * setups stay byte-compatible.
+     */
+    proposalClassifiers?: Iterable<ProposalClassifier>;
+    /**
+     * Policy registry consulted to filter the merged proposal stream before writeback. When absent,
+     * every proposal survives. Typically `InMemoryPolicyRegistry.withDefaults()` plus per-component
+     * overrides set at startup.
+     */
+    policy?: PolicyRegistry;
+}
+export interface ParseOptions {
+    verbose?: boolean;
+    /**
+     * BCP-47 locale tag (e.g. `"en-US"`, `"fr-FR"`). When provided, downstream locale-aware pipelines
+     * (Phase 1+) narrow classification to the registered `LocaleProfile`. Accepted but ignored by the
+     * legacy rule-only pipeline in Phase 0; the field exists so the CLI and library callers can begin
+     * tagging their requests now.
+     */
+    locale?: string;
+}
+export interface VerboseParseResult {
+    solutions: Solution[];
+    context: TokenContext;
+    measures: {
+        tokenizer: PerformanceMeasure;
+        classifier: PerformanceMeasure;
+        solver: PerformanceMeasure;
+    };
+    /**
+     * Present when proposal classifiers ran. `proposals` is the policy-filtered list; `writeback` is
+     * a small summary of how many proposals reached the context's span graph. Omitted when no
+     * `proposalClassifiers` were configured.
+     */
+    proposals?: {
+        filtered: ClassificationProposal[];
+        writeback: WritebackResult;
+    };
+}
+/**
+ * Parses a tokenized address into a structured address.
+ */
+export declare class AddressParser {
+    #private;
+    protected classifiers: Classifier[];
+    protected solvers: Solver[];
+    protected proposalClassifiers: ProposalClassifier[];
+    protected policy?: PolicyRegistry;
+    protected solutionLimit: number;
+    constructor({ languages, classifiers, solvers, proposalClassifiers, policy, solutionLimit, }?: AddressParserOptions);
+    ready(): Promise<this>;
+    /**
+     * Parse an address. A high-level function that runs all classifiers and solvers.
+     *
+     * @param input - The address to parse.
+     */
+    parse(input: string, options: ParseOptions & {
+        verbose: true;
+    }): Promise<VerboseParseResult>;
+    parse(input: string, options?: ParseOptions): Promise<SerializedSolution[]>;
+    /**
+     * Run all classifiers.
+     */
+    protected classify(context: TokenContext): void;
+    /**
+     * Get the performance measure for a classifier in the most recent parse.
+     */
+    sampleClassifierMeasure(classifier: Classifier): PerformanceMeasure | undefined;
+    /**
+     * Run all solvers.
+     */
+    findSolutions(context: TokenContext): Solution[];
+}
+//# sourceMappingURL=AddressParser.d.ts.map

package/out/parser/AddressParser.d.ts.map

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

package/out/parser/AddressParser.js

@@ -0,0 +1,116 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+import { Alpha2LanguageCode } from "@mailwoman/core";
+import { Solution, } from "@mailwoman/core/solver";
+import { TokenContext } from "@mailwoman/core/tokenization";
+import { runProposalPipeline } from "./proposal-pipeline.js";
+/**
+ * Parses a tokenized address into a structured address.
+ */
+export class AddressParser {
+    classifiers;
+    solvers;
+    proposalClassifiers;
+    policy;
+    solutionLimit;
+    #initialized = false;
+    constructor({ languages, classifiers = [], solvers = [], proposalClassifiers = [], policy, solutionLimit = 10, } = {}) {
+        this.classifiers = Array.from(classifiers, (AddressClassifier) => {
+            return typeof AddressClassifier === "function" ? new AddressClassifier({ languages }) : AddressClassifier;
+        });
+        this.solvers = Array.from(solvers, (AddressSolver) => {
+            return typeof AddressSolver === "function" ? new AddressSolver() : AddressSolver;
+        });
+        this.proposalClassifiers = Array.from(proposalClassifiers);
+        this.policy = policy;
+        this.solutionLimit = solutionLimit;
+    }
+    async ready() {
+        if (this.#initialized)
+            return this;
+        await Promise.all([
+            ...this.classifiers.map((classifier) => classifier.ready?.()),
+            ...this.proposalClassifiers.map((classifier) => classifier.ready?.()),
+        ]);
+        this.#initialized = true;
+        return this;
+    }
+    async parse(input, { verbose, locale } = {}) {
+        if (typeof input !== "string") {
+            throw new TypeError("Failed to parse address: input must be a string.");
+        }
+        if (input.length === 0)
+            return [];
+        await this.ready();
+        const startTokenizer = performance.now();
+        const context = new TokenContext(input);
+        const endTokenizer = performance.now();
+        const startClassifier = performance.now();
+        this.classify(context);
+        let proposalsSummary;
+        if (this.proposalClassifiers.length > 0) {
+            const { proposals, writeback } = await runProposalPipeline(context, this.proposalClassifiers, {
+                policy: this.policy,
+                locale,
+                classifierContext: { locale },
+            });
+            proposalsSummary = { filtered: proposals, writeback };
+        }
+        const endClassifier = performance.now();
+        const startSolve = performance.now();
+        const solutions = this.findSolutions(context);
+        const endSolve = performance.now();
+        performance.mark("end-solve");
+        if (verbose) {
+            return {
+                solutions,
+                context,
+                measures: {
+                    tokenizer: performance.measure("Tokenizer", { start: startTokenizer, end: endTokenizer }),
+                    classifier: performance.measure("Classifier", { start: startClassifier, end: endClassifier }),
+                    solver: performance.measure("Solver", { start: startSolve, end: endSolve }),
+                },
+                ...(proposalsSummary ? { proposals: proposalsSummary } : {}),
+            };
+        }
+        return solutions.map((solution) => solution.toJSON());
+    }
+    #classifierMeasures = new WeakMap();
+    /**
+     * Run all classifiers.
+     */
+    classify(context) {
+        for (const [i, classifier] of this.classifiers.entries()) {
+            const classifierName = classifier.constructor?.name || `Unknown Classifier ${i + 1}`;
+            const start = performance.now();
+            classifier.classifyTokens(context);
+            const classifyMeasure = performance.measure("Classify", {
+                start,
+                end: performance.now(),
+                detail: classifierName,
+            });
+            this.#classifierMeasures.set(classifier, classifyMeasure);
+        }
+    }
+    /**
+     * Get the performance measure for a classifier in the most recent parse.
+     */
+    sampleClassifierMeasure(classifier) {
+        return this.#classifierMeasures.get(classifier);
+    }
+    /**
+     * Run all solvers.
+     */
+    findSolutions(context) {
+        for (const solver of this.solvers) {
+            context.evaluateAndRank(this.solutionLimit);
+            solver.solve(context);
+        }
+        context.evaluateAndRank(this.solutionLimit);
+        return context.solutions;
+    }
+}
+//# sourceMappingURL=AddressParser.js.map

package/out/parser/AddressParser.js.map

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

package/out/parser/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "./AddressParser.js";
+export * from "./proposal-pipeline.js";
+//# sourceMappingURL=index.d.ts.map

package/out/parser/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../parser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA"}

package/out/parser/index.js

@@ -0,0 +1,8 @@
+/**
+ * @copyright Sister Software
+ * @license AGPL-3.0
+ * @author Teffen Ellis, et al.
+ */
+export * from "./AddressParser.js";
+export * from "./proposal-pipeline.js";
+//# sourceMappingURL=index.js.map

package/out/parser/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../parser/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,cAAc,oBAAoB,CAAA;AAClC,cAAc,wBAAwB,CAAA"}