@mailwoman/variant-aliases 10.0.0 → 10.2.0

package/lib/index.ts

@@ -8,12 +8,7 @@
  *   The data file (`data/aliases.json`) catalogs ~35 hand-curated regional terms: "servo" → fuel
  *   (en-AU), "マクド" → McDonald's (ja-JP), "PFK" → KFC (fr-CA), etc.
  *
- *   See:
- *
- *   - `docs/articles/understanding/exotic-poi/regional-variant-queries.md` for the linguistic
- *       background and the source tables this data is derived from.
- *   - Issue #166 for the v0.6.0+ runtime integration plan (kind classifier consumes this table to emit
- *       `kind=amenity` / `kind=brand` proposals, filtered by `@mailwoman/locale-hint` output).
+ *   The runtime uses this table when resolving POI intent.
  */
 
 export { VARIANT_ALIAS_VERSION, getAllAliases, lookupVariantAliases, resolveLocaleScope } from "#lookup"

package/lib/lookup.ts

@@ -6,8 +6,6 @@
  *   Regional variant alias lookup. Given a token (or short phrase) and a detected locale, return the
  *   canonical amenity category or brand it refers to.
  *
- *   This is the data-side foundation for #166 (variant alias table + locale-restricted category matching).
- *   The runtime integration into the kind classifier is v0.6.0+ work.
  */
 
 import { readLocalJSONFile } from "@mailwoman/core/fs/readers"
@@ -18,8 +16,8 @@ import type { AliasLookupResult, LocaleScopeMatch, VariantAlias, VariantAliasTab
 const moduleDir = import.meta.dirname
 
 /**
- * Read the shipped alias table, located by the shared source-tree/`out/` probe in
- * `@mailwoman/core/module/packaged-data`.
+ * Read the shipped alias table, located by the shared source-tree/`out/` probe
+ * in `@mailwoman/core/module/packaged-data`.
  */
 async function loadTable(): Promise<VariantAliasTable> {
 	return readLocalJSONFile<VariantAliasTable>(await resolvePackagedDataPath(moduleDir, "aliases.json"))
@@ -28,9 +26,10 @@ async function loadTable(): Promise<VariantAliasTable> {
 const TABLE = await loadTable()
 
 /**
- * Indexed by lowercased variant string for O(1) lookup. Multiple entries can share the same variant key (e.g. ambiguous
- * "takeaway" only matches GB but not AU if both list it differently), so each entry is an array of all aliases that
- * share the key.
+ * Indexed by lowercased variant string for O(1) lookup.
+ *
+ * Multiple entries can share the same variant key (e.g. Ambiguous "takeaway" only matches GB
+ * but not AU if both list it differently), so each entry is an array of all aliases that share the key.
  */
 const INDEX: ReadonlyMap<string, ReadonlyArray<VariantAlias>> = (() => {
 	const map = new Map<string, VariantAlias[]>()
@@ -46,18 +45,18 @@ const INDEX: ReadonlyMap<string, ReadonlyArray<VariantAlias>> = (() => {
 })()
 
 /**
- * Decide how a locale-scoped record answers under a detected locale — the rule every locale-restricted vocabulary in
- * the pipeline follows.
+ * Decide how a locale-scoped record answers under a detected locale — the rule every
+ * locale-restricted vocabulary in the pipeline follows.
  *
  * - `unscoped` (confidence 1) when the record declares no locales at all.
  * - `exact` (confidence 1) when the detected locale is one the record declares.
- * - `language` (confidence 0.5) when only the language subtag agrees — weaker on purpose, because regional variants are
- *   by definition regional.
- * - `null` otherwise, and for any scoped record when the locale is unknown: a phrasing declared regional cannot be
- *   reached without knowing the region.
+ * - `language` (confidence 0.5) when only the language subtag agrees — weaker on purpose,
+ *   because regional variants are by definition regional.
+ * - `null` for every scoped record when the locale is unknown: a phrasing declared
+ *   regional cannot be reached without knowing the region.
  */
 export function resolveLocaleScope(
-	locales: ReadonlyArray<string> | undefined,
+	locales: ReadonlyArray<string> | null,
 	locale: string | undefined
 ): LocaleScopeMatch | null {
 	if (!locales) return { scope: "unscoped", confidence: 1 }
@@ -79,12 +78,13 @@ export function resolveLocaleScope(
  * Confidence:
  *
  * - `1.0` when the detected locale (e.g. `en-AU`) is in the alias's `locales` list.
- * - `0.5` when only the language part matches (e.g. detected `en-IE`, alias supports `en-AU`). This is intentionally
- *   weaker because regional variants are by definition regional.
+ * - `0.5` when only the language part matches (e.g. Detected `en-IE`, alias supports `en-AU`).
+ *   This is intentionally weaker because regional variants are by definition regional.
  * - No match when neither holds.
  *
- * Returns ALL matches sorted by confidence descending. Multi-locale variants (like "petrol station" →
- * en-GB/en-AU/en-NZ/en-ZA) return one entry per locale list — the caller picks.
+ * @returns all matches sorted by confidence descending.
+ * Multi-locale variants (like "petrol station" → en-GB/en-AU/en-NZ/en-ZA) return
+ * one entry per locale list — the caller picks.
  */
 export function lookupVariantAliases(text: string, locale: string): AliasLookupResult[] {
 	const norm = text.trim().toLowerCase()
@@ -111,7 +111,7 @@ export function lookupVariantAliases(text: string, locale: string): AliasLookupR
 }
 
 /**
- * Pure-data accessor for callers that want to enumerate the table (e.g. corpus synthesis).
+ * Pure-data accessor for callers that want to enumerate the table (e.g. Corpus synthesis).
  */
 export function getAllAliases(): ReadonlyArray<VariantAlias> {
 	return TABLE.aliases

package/lib/types.ts

@@ -9,27 +9,35 @@
 /**
  * The semantic kind of a variant — either a generic amenity category or a specific brand.
  *
- * - `amenity` aliases resolve to a category (`fuel`, `pharmacy`, `convenience`, ...). Several variants can map to the
- *   same category ("servo" and "petrol station" both → `fuel`).
- * - `brand` aliases resolve to a canonical brand name. Multiple regional variants of the same brand ("Macca's", "McDo",
- *   "Mickey D's", "マクド") all map to `McDonald's`.
+ * - `amenity` aliases resolve to a category (`fuel`, `pharmacy`, `convenience`, ...).
+ *   Several variants can map to the same category ("servo" and "petrol station" both → `fuel`).
+ * - `brand` aliases resolve to a canonical brand name.
+ *   Multiple regional variants of the same brand ("Macca's", "McDo", "Mickey D's", "マクド")
+ *   all map to `McDonald's`.
  */
 export type VariantKind = "amenity" | "brand"
 
 interface VariantAliasBase {
 	/**
-	 * The user-typed variant. Always lowercase for the lookup key (CJK preserved as-is).
+	 * The user-typed variant.
+	 *
+	 * Always lowercase for the lookup key (CJK preserved as-is).
 	 */
 	variant: string
 	/**
-	 * BCP-47 locale tags where this variant is in active use. Used to filter lookups: only consider an alias when the
-	 * detected locale matches one of these. A query in `en-US` won't match Australian "servo" because `en-AU` is not in
-	 * `["en-US"]`.
+	 * BCP-47 locale tags where this variant is in active use.
+	 *
+	 * Used to filter lookups: only consider an alias when the detected locale matches one of these.
+	 * A query in `en-US` won't match Australian "servo" because `en-AU` is not in `["en-US"]`.
 	 */
 	locales: ReadonlyArray<string>
 	/**
-	 * Free-form regional refinement within the locale (e.g. "NYC", "Kansai", "Quebec"). Not used for matching today;
-	 * informational. A future enhancement could combine this with a coarse geolocation signal to further disambiguate.
+	 * Free-form regional refinement within the locale (e.g. "NYC", "Kansai", "Quebec").
+	 *
+	 * Not used for matching today.
+	 * Informational.
+	 *
+	 * A future enhancement could combine this with a coarse geolocation signal to further disambiguate.
 	 */
 	regionHint?: string
 }
@@ -63,8 +71,9 @@ export interface VariantAliasTable {
  *
  * - `unscoped` — the record declares no locales and answers under any.
  * - `exact` — the query's locale tag is one the record declares.
- * - `language` — only the language subtag agrees. Weaker on purpose: a regional phrasing reached through its language
- *   alone is a guess about the region.
+ * - `language` — only the language subtag agrees.
+ *   Weaker on purpose: a regional phrasing reached through its language by
+ *   itself is a guess about the region.
  */
 export type LocaleScope = "unscoped" | "exact" | "language"
 

package/out/index.d.ts

@@ -8,12 +8,7 @@
  *   The data file (`data/aliases.json`) catalogs ~35 hand-curated regional terms: "servo" → fuel
  *   (en-AU), "マクド" → McDonald's (ja-JP), "PFK" → KFC (fr-CA), etc.
  *
- *   See:
- *
- *   - `docs/articles/understanding/exotic-poi/regional-variant-queries.md` for the linguistic
- *       background and the source tables this data is derived from.
- *   - Issue #166 for the v0.6.0+ runtime integration plan (kind classifier consumes this table to emit
- *       `kind=amenity` / `kind=brand` proposals, filtered by `@mailwoman/locale-hint` output).
+ *   The runtime uses this table when resolving POI intent.
  */
 export { VARIANT_ALIAS_VERSION, getAllAliases, lookupVariantAliases, resolveLocaleScope } from "#lookup";
 export type { AliasLookupResult, AmenityAlias, BrandAlias, LocaleScope, LocaleScopeMatch, VariantAlias, VariantAliasTable, VariantKind, } from "#types";

package/out/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAExG,YAAY,EACX,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,WAAW,GACX,MAAM,QAAQ,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AAExG,YAAY,EACX,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,YAAY,EACZ,iBAAiB,EACjB,WAAW,GACX,MAAM,QAAQ,CAAA"}

package/out/index.js

@@ -8,12 +8,7 @@
  *   The data file (`data/aliases.json`) catalogs ~35 hand-curated regional terms: "servo" → fuel
  *   (en-AU), "マクド" → McDonald's (ja-JP), "PFK" → KFC (fr-CA), etc.
  *
- *   See:
- *
- *   - `docs/articles/understanding/exotic-poi/regional-variant-queries.md` for the linguistic
- *       background and the source tables this data is derived from.
- *   - Issue #166 for the v0.6.0+ runtime integration plan (kind classifier consumes this table to emit
- *       `kind=amenity` / `kind=brand` proposals, filtered by `@mailwoman/locale-hint` output).
+ *   The runtime uses this table when resolving POI intent.
  */
 export { VARIANT_ALIAS_VERSION, getAllAliases, lookupVariantAliases, resolveLocaleScope } from "#lookup";
 //# sourceMappingURL=index.js.map

package/out/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../lib/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,oBAAoB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA"}

package/out/lookup.d.ts

@@ -6,38 +6,37 @@
  *   Regional variant alias lookup. Given a token (or short phrase) and a detected locale, return the
  *   canonical amenity category or brand it refers to.
  *
- *   This is the data-side foundation for #166 (variant alias table + locale-restricted category matching).
- *   The runtime integration into the kind classifier is v0.6.0+ work.
  */
 import type { AliasLookupResult, LocaleScopeMatch, VariantAlias } from "#types";
 /**
- * Decide how a locale-scoped record answers under a detected locale — the rule every locale-restricted vocabulary in
- * the pipeline follows.
+ * Decide how a locale-scoped record answers under a detected locale — the rule every
+ * locale-restricted vocabulary in the pipeline follows.
  *
  * - `unscoped` (confidence 1) when the record declares no locales at all.
  * - `exact` (confidence 1) when the detected locale is one the record declares.
- * - `language` (confidence 0.5) when only the language subtag agrees — weaker on purpose, because regional variants are
- *   by definition regional.
- * - `null` otherwise, and for any scoped record when the locale is unknown: a phrasing declared regional cannot be
- *   reached without knowing the region.
+ * - `language` (confidence 0.5) when only the language subtag agrees — weaker on purpose,
+ *   because regional variants are by definition regional.
+ * - `null` for every scoped record when the locale is unknown: a phrasing declared
+ *   regional cannot be reached without knowing the region.
  */
-export declare function resolveLocaleScope(locales: ReadonlyArray<string> | undefined, locale: string | undefined): LocaleScopeMatch | null;
+export declare function resolveLocaleScope(locales: ReadonlyArray<string> | null, locale: string | undefined): LocaleScopeMatch | null;
 /**
  * Match a query token against the variant alias table, filtered by detected locale.
  *
  * Confidence:
  *
  * - `1.0` when the detected locale (e.g. `en-AU`) is in the alias's `locales` list.
- * - `0.5` when only the language part matches (e.g. detected `en-IE`, alias supports `en-AU`). This is intentionally
- *   weaker because regional variants are by definition regional.
+ * - `0.5` when only the language part matches (e.g. Detected `en-IE`, alias supports `en-AU`).
+ *   This is intentionally weaker because regional variants are by definition regional.
  * - No match when neither holds.
  *
- * Returns ALL matches sorted by confidence descending. Multi-locale variants (like "petrol station" →
- * en-GB/en-AU/en-NZ/en-ZA) return one entry per locale list — the caller picks.
+ * @returns all matches sorted by confidence descending.
+ * Multi-locale variants (like "petrol station" → en-GB/en-AU/en-NZ/en-ZA) return
+ * one entry per locale list — the caller picks.
  */
 export declare function lookupVariantAliases(text: string, locale: string): AliasLookupResult[];
 /**
- * Pure-data accessor for callers that want to enumerate the table (e.g. corpus synthesis).
+ * Pure-data accessor for callers that want to enumerate the table (e.g. Corpus synthesis).
  */
 export declare function getAllAliases(): ReadonlyArray<VariantAlias>;
 /**

package/out/lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../lib/lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAqB,MAAM,QAAQ,CAAA;AAgClG;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,SAAS,EAC1C,MAAM,EAAE,MAAM,GAAG,SAAS,GACxB,gBAAgB,GAAG,IAAI,CAYzB;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAsBtF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAAC,YAAY,CAAC,CAE3D;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAgB,CAAA"}
+{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../lib/lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,YAAY,EAAqB,MAAM,QAAQ,CAAA;AAiClG;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CACjC,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,GAAG,IAAI,EACrC,MAAM,EAAE,MAAM,GAAG,SAAS,GACxB,gBAAgB,GAAG,IAAI,CAYzB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CAsBtF;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,aAAa,CAAC,YAAY,CAAC,CAE3D;AAED;;GAEG;AACH,eAAO,MAAM,qBAAqB,QAAgB,CAAA"}

package/out/lookup.js

@@ -6,24 +6,23 @@
  *   Regional variant alias lookup. Given a token (or short phrase) and a detected locale, return the
  *   canonical amenity category or brand it refers to.
  *
- *   This is the data-side foundation for #166 (variant alias table + locale-restricted category matching).
- *   The runtime integration into the kind classifier is v0.6.0+ work.
  */
 import { readLocalJSONFile } from "@mailwoman/core/fs/readers";
 import { resolvePackagedDataPath } from "@mailwoman/core/module/packaged-data";
 const moduleDir = import.meta.dirname;
 /**
- * Read the shipped alias table, located by the shared source-tree/`out/` probe in
- * `@mailwoman/core/module/packaged-data`.
+ * Read the shipped alias table, located by the shared source-tree/`out/` probe
+ * in `@mailwoman/core/module/packaged-data`.
  */
 async function loadTable() {
     return readLocalJSONFile(await resolvePackagedDataPath(moduleDir, "aliases.json"));
 }
 const TABLE = await loadTable();
 /**
- * Indexed by lowercased variant string for O(1) lookup. Multiple entries can share the same variant key (e.g. ambiguous
- * "takeaway" only matches GB but not AU if both list it differently), so each entry is an array of all aliases that
- * share the key.
+ * Indexed by lowercased variant string for O(1) lookup.
+ *
+ * Multiple entries can share the same variant key (e.g. Ambiguous "takeaway" only matches GB
+ * but not AU if both list it differently), so each entry is an array of all aliases that share the key.
  */
 const INDEX = (() => {
     const map = new Map();
@@ -36,15 +35,15 @@ const INDEX = (() => {
     return map;
 })();
 /**
- * Decide how a locale-scoped record answers under a detected locale — the rule every locale-restricted vocabulary in
- * the pipeline follows.
+ * Decide how a locale-scoped record answers under a detected locale — the rule every
+ * locale-restricted vocabulary in the pipeline follows.
  *
  * - `unscoped` (confidence 1) when the record declares no locales at all.
  * - `exact` (confidence 1) when the detected locale is one the record declares.
- * - `language` (confidence 0.5) when only the language subtag agrees — weaker on purpose, because regional variants are
- *   by definition regional.
- * - `null` otherwise, and for any scoped record when the locale is unknown: a phrasing declared regional cannot be
- *   reached without knowing the region.
+ * - `language` (confidence 0.5) when only the language subtag agrees — weaker on purpose,
+ *   because regional variants are by definition regional.
+ * - `null` for every scoped record when the locale is unknown: a phrasing declared
+ *   regional cannot be reached without knowing the region.
  */
 export function resolveLocaleScope(locales, locale) {
     if (!locales)
@@ -64,12 +63,13 @@ export function resolveLocaleScope(locales, locale) {
  * Confidence:
  *
  * - `1.0` when the detected locale (e.g. `en-AU`) is in the alias's `locales` list.
- * - `0.5` when only the language part matches (e.g. detected `en-IE`, alias supports `en-AU`). This is intentionally
- *   weaker because regional variants are by definition regional.
+ * - `0.5` when only the language part matches (e.g. Detected `en-IE`, alias supports `en-AU`).
+ *   This is intentionally weaker because regional variants are by definition regional.
  * - No match when neither holds.
  *
- * Returns ALL matches sorted by confidence descending. Multi-locale variants (like "petrol station" →
- * en-GB/en-AU/en-NZ/en-ZA) return one entry per locale list — the caller picks.
+ * @returns all matches sorted by confidence descending.
+ * Multi-locale variants (like "petrol station" → en-GB/en-AU/en-NZ/en-ZA) return
+ * one entry per locale list — the caller picks.
  */
 export function lookupVariantAliases(text, locale) {
     const norm = text.trim().toLowerCase();
@@ -89,7 +89,7 @@ export function lookupVariantAliases(text, locale) {
     return results;
 }
 /**
- * Pure-data accessor for callers that want to enumerate the table (e.g. corpus synthesis).
+ * Pure-data accessor for callers that want to enumerate the table (e.g. Corpus synthesis).
  */
 export function getAllAliases() {
     return TABLE.aliases;

package/out/lookup.js.map

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

package/out/types.d.ts

@@ -8,26 +8,34 @@
 /**
  * The semantic kind of a variant — either a generic amenity category or a specific brand.
  *
- * - `amenity` aliases resolve to a category (`fuel`, `pharmacy`, `convenience`, ...). Several variants can map to the
- *   same category ("servo" and "petrol station" both → `fuel`).
- * - `brand` aliases resolve to a canonical brand name. Multiple regional variants of the same brand ("Macca's", "McDo",
- *   "Mickey D's", "マクド") all map to `McDonald's`.
+ * - `amenity` aliases resolve to a category (`fuel`, `pharmacy`, `convenience`, ...).
+ *   Several variants can map to the same category ("servo" and "petrol station" both → `fuel`).
+ * - `brand` aliases resolve to a canonical brand name.
+ *   Multiple regional variants of the same brand ("Macca's", "McDo", "Mickey D's", "マクド")
+ *   all map to `McDonald's`.
  */
 export type VariantKind = "amenity" | "brand";
 interface VariantAliasBase {
     /**
-     * The user-typed variant. Always lowercase for the lookup key (CJK preserved as-is).
+     * The user-typed variant.
+     *
+     * Always lowercase for the lookup key (CJK preserved as-is).
      */
     variant: string;
     /**
-     * BCP-47 locale tags where this variant is in active use. Used to filter lookups: only consider an alias when the
-     * detected locale matches one of these. A query in `en-US` won't match Australian "servo" because `en-AU` is not in
-     * `["en-US"]`.
+     * BCP-47 locale tags where this variant is in active use.
+     *
+     * Used to filter lookups: only consider an alias when the detected locale matches one of these.
+     * A query in `en-US` won't match Australian "servo" because `en-AU` is not in `["en-US"]`.
      */
     locales: ReadonlyArray<string>;
     /**
-     * Free-form regional refinement within the locale (e.g. "NYC", "Kansai", "Quebec"). Not used for matching today;
-     * informational. A future enhancement could combine this with a coarse geolocation signal to further disambiguate.
+     * Free-form regional refinement within the locale (e.g. "NYC", "Kansai", "Quebec").
+     *
+     * Not used for matching today.
+     * Informational.
+     *
+     * A future enhancement could combine this with a coarse geolocation signal to further disambiguate.
      */
     regionHint?: string;
 }
@@ -56,8 +64,9 @@ export interface VariantAliasTable {
  *
  * - `unscoped` — the record declares no locales and answers under any.
  * - `exact` — the query's locale tag is one the record declares.
- * - `language` — only the language subtag agrees. Weaker on purpose: a regional phrasing reached through its language
- *   alone is a guess about the region.
+ * - `language` — only the language subtag agrees.
+ *   Weaker on purpose: a regional phrasing reached through its language by
+ *   itself is a guess about the region.
  */
 export type LocaleScope = "unscoped" | "exact" | "language";
 /**

package/out/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;AAE7C,UAAU,gBAAgB;IACzB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;;OAIG;IACH,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACrD,IAAI,EAAE,SAAS,CAAA;IACf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IACnD,IAAI,EAAE,OAAO,CAAA;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,UAAU,CAAA;AAEpD,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;CACpC;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,WAAW,CAAA;IAClB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,YAAY,CAAA;IACnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CAClB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../lib/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;AAE7C,UAAU,gBAAgB;IACzB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAA;IACf;;;;;OAKG;IACH,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,CAAA;IAC9B;;;;;;;OAOG;IACH,UAAU,CAAC,EAAE,MAAM,CAAA;CACnB;AAED,MAAM,WAAW,YAAa,SAAQ,gBAAgB;IACrD,IAAI,EAAE,SAAS,CAAA;IACf;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,UAAW,SAAQ,gBAAgB;IACnD,IAAI,EAAE,OAAO,CAAA;IACb;;OAEG;IACH,KAAK,EAAE,MAAM,CAAA;CACb;AAED,MAAM,MAAM,YAAY,GAAG,YAAY,GAAG,UAAU,CAAA;AAEpD,MAAM,WAAW,iBAAiB;IACjC,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,MAAM,CAAA;IACnB,OAAO,EAAE,aAAa,CAAC,YAAY,CAAC,CAAA;CACpC;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,UAAU,CAAA;AAE3D;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,KAAK,EAAE,WAAW,CAAA;IAClB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,iBAAiB;IACjC,KAAK,EAAE,YAAY,CAAA;IACnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAA;CAClB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailwoman/variant-aliases",
-  "version": "10.0.0",
+  "version": "10.2.0",
   "description": "Regional variant alias table — local terms for amenities/brands blocked by locale. 'servo' → fuel (en-AU), 'マクド' → McDonald's (ja-JP), 'PFK' → KFC (fr-CA).",
   "license": "AGPL-3.0-only OR LicenseRef-Commercial",
   "repository": {
@@ -14,15 +14,10 @@
     "out/**/*.d.ts",
     "out/**/*.d.ts.map",
     "data/**/*.json",
-    "*.ts",
-    "*.tsx",
-    "**/*.ts",
-    "**/*.tsx",
-    "!*.test.ts",
-    "!*.test.tsx",
+    "lib/**/*.ts",
+    "lib/**/*.tsx",
     "!**/*.test.ts",
-    "!**/*.test.tsx",
-    "!test/**"
+    "!**/*.test.tsx"
   ],
   "type": "module",
   "sideEffects": false,
@@ -40,10 +35,10 @@
       "node": "./out/index.js",
       "default": "./out/index.js"
     },
-    "./lookup": {
-      "types": "./out/lookup.d.ts",
-      "node": "./out/lookup.js",
-      "default": "./out/lookup.js"
+    "./*": {
+      "types": "./out/*.d.ts",
+      "node": "./out/*.js",
+      "default": "./out/*.js"
     }
   },
   "publishConfig": {
@@ -55,10 +50,10 @@
         "node": "./out/index.js",
         "default": "./out/index.js"
       },
-      "./lookup": {
-        "types": "./out/lookup.d.ts",
-        "node": "./out/lookup.js",
-        "default": "./out/lookup.js"
+      "./*": {
+        "types": "./out/*.d.ts",
+        "node": "./out/*.js",
+        "default": "./out/*.js"
       }
     },
     "imports": {
@@ -70,6 +65,6 @@
     }
   },
   "dependencies": {
-    "@mailwoman/core": "10.0.0"
+    "@mailwoman/core": "10.2.0"
   }
 }