@mailwoman/variant-aliases 9.1.0 → 9.3.0

package/{index.ts → lib/index.ts}

@@ -13,16 +13,18 @@
  *   - `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, gated by locale-gate output).
+ *       `kind=amenity` / `kind=brand` proposals, filtered by `@mailwoman/locale-hint` output).
  */
 
-export { VARIANT_ALIAS_VERSION, getAllAliases, lookupVariantAliases } from "./lookup.ts"
+export { VARIANT_ALIAS_VERSION, getAllAliases, lookupVariantAliases, resolveLocaleScope } from "#lookup"
 
 export type {
 	AliasLookupResult,
 	AmenityAlias,
 	BrandAlias,
+	LocaleScope,
+	LocaleScopeMatch,
 	VariantAlias,
 	VariantAliasTable,
 	VariantKind,
-} from "./types.ts"
+} from "#types"

package/{lookup.ts → lib/lookup.ts}

@@ -6,44 +6,26 @@
  *   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-gated category matching).
+ *   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 { existsSync, readFileSync } from "node:fs"
-import { resolve } from "node:path"
+import { readLocalJSONFile } from "@mailwoman/core/fs/readers"
+import { resolvePackagedDataPath } from "@mailwoman/core/module/packaged-data"
 
-import type { AliasLookupResult, VariantAlias, VariantAliasTable } from "./types.ts"
+import type { AliasLookupResult, LocaleScopeMatch, VariantAlias, VariantAliasTable } from "#types"
 
 const moduleDir = import.meta.dirname
 
 /**
- * Read the shipped alias table.
- *
- * `data/` sits at the package root (it is a `files` entry), and this module sits either at that root — running from
- * source — or under `out/` when compiled, so there are exactly two places to look. The probe tests for the FILE:
- * probing by attempting a parse folds a corrupt table into "not this candidate", and the package then reports a missing
- * table it is looking straight at.
- *
- * `@mailwoman/poi-taxonomy` carries the same loader against its own tables. The duplication is deliberate — both
- * packages declare ZERO dependencies and publish independently, so sharing one would mean one taking a dependency on
- * the other for eight lines.
+ * Read the shipped alias table, located by the shared source-tree/`out/` probe in
+ * `@mailwoman/core/module/packaged-data`.
  */
-function loadTable(): VariantAliasTable {
-	const candidates = [resolve(moduleDir, "data", "aliases.json"), resolve(moduleDir, "..", "data", "aliases.json")]
-	const found = candidates.find((candidate) => existsSync(candidate))
-
-	if (!found) {
-		throw new Error(`variant-aliases: could not find data/aliases.json — looked in ${candidates.join(", ")}`)
-	}
-
-	// A corrupt shipped table is a broken build, and the SyntaxError names the offset. Zero dependencies here, so
-	// `@mailwoman/core`'s parse wrappers are deliberately out of reach.
-	// oxlint-disable-next-line no-restricted-properties
-	return JSON.parse(readFileSync(found, "utf8")) as VariantAliasTable
+async function loadTable(): Promise<VariantAliasTable> {
+	return readLocalJSONFile<VariantAliasTable>(await resolvePackagedDataPath(moduleDir, "aliases.json"))
 }
 
-const TABLE = loadTable()
+const TABLE = await loadTable()
 
 /**
  * Indexed by lowercased variant string for O(1) lookup. Multiple entries can share the same variant key (e.g. ambiguous
@@ -64,7 +46,35 @@ const INDEX: ReadonlyMap<string, ReadonlyArray<VariantAlias>> = (() => {
 })()
 
 /**
- * Match a query token against the variant alias table, gated by detected locale.
+ * 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.
+ */
+export function resolveLocaleScope(
+	locales: ReadonlyArray<string> | undefined,
+	locale: string | undefined
+): LocaleScopeMatch | null {
+	if (!locales) return { scope: "unscoped", confidence: 1 }
+
+	if (!locale) return null
+
+	if (locales.includes(locale)) return { scope: "exact", confidence: 1 }
+
+	const language = locale.split(/[-_]/)[0]
+
+	if (locales.some((tag) => tag.split(/[-_]/)[0] === language)) return { scope: "language", confidence: 0.5 }
+
+	return null
+}
+
+/**
+ * Match a query token against the variant alias table, filtered by detected locale.
  *
  * Confidence:
  *
@@ -85,21 +95,13 @@ export function lookupVariantAliases(text: string, locale: string): AliasLookupR
 
 	if (!candidates || !candidates.length) return []
 
-	const language = locale.split(/[-_]/)[0]
 	const results: AliasLookupResult[] = []
 
 	for (const alias of candidates) {
-		if (alias.locales.includes(locale)) {
-			results.push({ alias, confidence: 1 })
-
-			continue
-		}
-
-		// Relaxed match: any locale in `locales` that shares the same language part.
-		const langMatch = alias.locales.some((l) => l.split(/[-_]/)[0] === language)
+		const match = resolveLocaleScope(alias.locales, locale)
 
-		if (langMatch) {
-			results.push({ alias, confidence: 0.5 })
+		if (match) {
+			results.push({ alias, confidence: match.confidence })
 		}
 	}
 

package/{types.ts → lib/types.ts}

@@ -16,13 +16,13 @@
  */
 export type VariantKind = "amenity" | "brand"
 
-export interface VariantAliasBase {
+interface VariantAliasBase {
 	/**
 	 * 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 gate lookups: only consider an alias when the
+	 * 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"]`.
 	 */
@@ -58,6 +58,27 @@ export interface VariantAliasTable {
 	aliases: ReadonlyArray<VariantAlias>
 }
 
+/**
+ * How a record's locale scope met the locale a query was read under.
+ *
+ * - `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.
+ */
+export type LocaleScope = "unscoped" | "exact" | "language"
+
+/**
+ * One locale-scoped record matched under one locale.
+ */
+export interface LocaleScopeMatch {
+	scope: LocaleScope
+	/**
+	 * `1` for `unscoped` and `exact`, `0.5` for `language`.
+	 */
+	confidence: number
+}
+
 export interface AliasLookupResult {
 	alias: VariantAlias
 	/**

package/out/index.d.ts

@@ -13,8 +13,8 @@
  *   - `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, gated by locale-gate output).
+ *       `kind=amenity` / `kind=brand` proposals, filtered by `@mailwoman/locale-hint` output).
  */
-export { VARIANT_ALIAS_VERSION, getAllAliases, lookupVariantAliases } from "./lookup.ts";
-export type { AliasLookupResult, AmenityAlias, BrandAlias, VariantAlias, VariantAliasTable, VariantKind, } from "./types.ts";
+export { VARIANT_ALIAS_VERSION, getAllAliases, lookupVariantAliases, resolveLocaleScope } from "#lookup";
+export type { AliasLookupResult, AmenityAlias, BrandAlias, LocaleScope, LocaleScopeMatch, VariantAlias, VariantAliasTable, VariantKind, } from "#types";
 //# sourceMappingURL=index.d.ts.map

package/out/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAExF,YAAY,EACX,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,WAAW,GACX,MAAM,YAAY,CAAA"}
+{"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"}

package/out/index.js

@@ -13,7 +13,7 @@
  *   - `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, gated by locale-gate output).
+ *       `kind=amenity` / `kind=brand` proposals, filtered by `@mailwoman/locale-hint` output).
  */
-export { VARIANT_ALIAS_VERSION, getAllAliases, lookupVariantAliases } from "./lookup.js";
+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":["../index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,qBAAqB,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA"}
+{"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"}

package/out/lookup.d.ts

@@ -6,12 +6,24 @@
  *   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-gated category matching).
+ *   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, VariantAlias } from "./types.ts";
+import type { AliasLookupResult, LocaleScopeMatch, VariantAlias } from "#types";
 /**
- * Match a query token against the variant alias table, gated by detected locale.
+ * 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.
+ */
+export declare function resolveLocaleScope(locales: ReadonlyArray<string> | undefined, locale: string | undefined): LocaleScopeMatch | null;
+/**
+ * Match a query token against the variant alias table, filtered by detected locale.
  *
  * Confidence:
  *

package/out/lookup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lookup.d.ts","sourceRoot":"","sources":["../lookup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,YAAY,EAAqB,MAAM,YAAY,CAAA;AAkDpF;;;;;;;;;;;;GAYG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,EAAE,CA8BtF;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;;;;;;;;;;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"}

package/out/lookup.js

@@ -6,36 +6,20 @@
  *   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-gated category matching).
+ *   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 { existsSync, readFileSync } from "node:fs";
-import { resolve } from "node:path";
+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.
- *
- * `data/` sits at the package root (it is a `files` entry), and this module sits either at that root — running from
- * source — or under `out/` when compiled, so there are exactly two places to look. The probe tests for the FILE:
- * probing by attempting a parse folds a corrupt table into "not this candidate", and the package then reports a missing
- * table it is looking straight at.
- *
- * `@mailwoman/poi-taxonomy` carries the same loader against its own tables. The duplication is deliberate — both
- * packages declare ZERO dependencies and publish independently, so sharing one would mean one taking a dependency on
- * the other for eight lines.
+ * Read the shipped alias table, located by the shared source-tree/`out/` probe in
+ * `@mailwoman/core/module/packaged-data`.
  */
-function loadTable() {
-    const candidates = [resolve(moduleDir, "data", "aliases.json"), resolve(moduleDir, "..", "data", "aliases.json")];
-    const found = candidates.find((candidate) => existsSync(candidate));
-    if (!found) {
-        throw new Error(`variant-aliases: could not find data/aliases.json — looked in ${candidates.join(", ")}`);
-    }
-    // A corrupt shipped table is a broken build, and the SyntaxError names the offset. Zero dependencies here, so
-    // `@mailwoman/core`'s parse wrappers are deliberately out of reach.
-    // oxlint-disable-next-line no-restricted-properties
-    return JSON.parse(readFileSync(found, "utf8"));
+async function loadTable() {
+    return readLocalJSONFile(await resolvePackagedDataPath(moduleDir, "aliases.json"));
 }
-const TABLE = loadTable();
+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
@@ -52,7 +36,30 @@ const INDEX = (() => {
     return map;
 })();
 /**
- * Match a query token against the variant alias table, gated by detected locale.
+ * 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.
+ */
+export function resolveLocaleScope(locales, locale) {
+    if (!locales)
+        return { scope: "unscoped", confidence: 1 };
+    if (!locale)
+        return null;
+    if (locales.includes(locale))
+        return { scope: "exact", confidence: 1 };
+    const language = locale.split(/[-_]/)[0];
+    if (locales.some((tag) => tag.split(/[-_]/)[0] === language))
+        return { scope: "language", confidence: 0.5 };
+    return null;
+}
+/**
+ * Match a query token against the variant alias table, filtered by detected locale.
  *
  * Confidence:
  *
@@ -71,17 +78,11 @@ export function lookupVariantAliases(text, locale) {
     const candidates = INDEX.get(norm);
     if (!candidates || !candidates.length)
         return [];
-    const language = locale.split(/[-_]/)[0];
     const results = [];
     for (const alias of candidates) {
-        if (alias.locales.includes(locale)) {
-            results.push({ alias, confidence: 1 });
-            continue;
-        }
-        // Relaxed match: any locale in `locales` that shares the same language part.
-        const langMatch = alias.locales.some((l) => l.split(/[-_]/)[0] === language);
-        if (langMatch) {
-            results.push({ alias, confidence: 0.5 });
+        const match = resolveLocaleScope(alias.locales, locale);
+        if (match) {
+            results.push({ alias, confidence: match.confidence });
         }
     }
     results.sort((a, b) => b.confidence - a.confidence);

package/out/lookup.js.map

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

@@ -14,13 +14,13 @@
  *   "Mickey D's", "マクド") all map to `McDonald's`.
  */
 export type VariantKind = "amenity" | "brand";
-export interface VariantAliasBase {
+interface VariantAliasBase {
     /**
      * 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 gate lookups: only consider an alias when the
+     * 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"]`.
      */
@@ -51,6 +51,25 @@ export interface VariantAliasTable {
     description: string;
     aliases: ReadonlyArray<VariantAlias>;
 }
+/**
+ * How a record's locale scope met the locale a query was read under.
+ *
+ * - `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.
+ */
+export type LocaleScope = "unscoped" | "exact" | "language";
+/**
+ * One locale-scoped record matched under one locale.
+ */
+export interface LocaleScopeMatch {
+    scope: LocaleScope;
+    /**
+     * `1` for `unscoped` and `exact`, `0.5` for `language`.
+     */
+    confidence: number;
+}
 export interface AliasLookupResult {
     alias: VariantAlias;
     /**
@@ -58,4 +77,5 @@ export interface AliasLookupResult {
      */
     confidence: number;
 }
+export {};
 //# sourceMappingURL=types.d.ts.map

package/out/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;;;;;GAOG;AACH,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,OAAO,CAAA;AAE7C,MAAM,WAAW,gBAAgB;IAChC;;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,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;;;;;;;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"}

package/out/types.js.map

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

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@mailwoman/variant-aliases",
-  "version": "9.1.0",
-  "description": "Regional variant alias table — local terms for amenities/brands gated by locale. 'servo' → fuel (en-AU), 'マクド' → McDonald's (ja-JP), 'PFK' → KFC (fr-CA).",
+  "version": "9.3.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": {
     "type": "git",
     "url": "https://github.com/sister-software/mailwoman.git",
-    "directory": "variant-aliases"
+    "directory": "packages/variant-aliases"
   },
   "files": [
     "out/**/*.js",
@@ -21,14 +21,29 @@
     "!*.test.ts",
     "!*.test.tsx",
     "!**/*.test.ts",
-    "!**/*.test.tsx"
+    "!**/*.test.tsx",
+    "!test/**"
   ],
   "type": "module",
+  "sideEffects": false,
+  "imports": {
+    "#*": {
+      "types": "./out/*.d.ts",
+      "node": "./out/*.js",
+      "default": "./out/*.js"
+    }
+  },
   "exports": {
     "./package.json": "./package.json",
     ".": {
       "types": "./out/index.d.ts",
+      "node": "./out/index.js",
       "default": "./out/index.js"
+    },
+    "./lookup": {
+      "types": "./out/lookup.d.ts",
+      "node": "./out/lookup.js",
+      "default": "./out/lookup.js"
     }
   },
   "publishConfig": {
@@ -37,8 +52,24 @@
       "./package.json": "./package.json",
       ".": {
         "types": "./out/index.d.ts",
+        "node": "./out/index.js",
         "default": "./out/index.js"
+      },
+      "./lookup": {
+        "types": "./out/lookup.d.ts",
+        "node": "./out/lookup.js",
+        "default": "./out/lookup.js"
+      }
+    },
+    "imports": {
+      "#*": {
+        "types": "./out/*.d.ts",
+        "node": "./out/*.js",
+        "default": "./out/*.js"
       }
     }
+  },
+  "dependencies": {
+    "@mailwoman/core": "9.3.0"
   }
 }