@cobre-npm/library-portal-core 0.67.0 → 0.68.0

package/README.md

@@ -55,7 +55,7 @@ import { getCountries }    from "@cobre-npm/library-portal-core/countries"
 | `@cobre-npm/library-portal-core/trustedSessions` | Trusted session (OTP elevation window) interfaces + constants |
 | `@cobre-npm/library-portal-core/exports` | Export request/response entity + the engine's format/operator allow-lists |
 | `@cobre-npm/library-portal-core/financialInstitutions` | Financial institutions (banks) by country, with labels |
-| `@cobre-npm/library-portal-core/lang` | Supported locales (`Locale`, defaults) |
+| `@cobre-npm/library-portal-core/lang` | Supported locales (`Locale`, defaults) and `toSupportedLocale` |
 | `@cobre-npm/library-portal-core` (root) | ⚠️ **Legacy / deprecated** — see [below](#legacy-code--and-its-deprecation) |
 
 ---
@@ -125,6 +125,7 @@ Every use case comes out of this, without the consumer having to walk internal s
 
 | I need… | How |
 |---|---|
+| A code or its metadata, no text (compare, filter, send to an API) | `getX()[code].code` — no language |
 | The label of a code | `getX(lang)[code].label` |
 | The full list (dropdown, table) | `Object.values(getX(lang))` |
 | Filter by some property | `Object.values(getX(lang)).filter(x => …)` |
@@ -155,12 +156,30 @@ one-off predicates even where `queryX()` exists.
 
 `currencies`/`providers` **don't take `lang`** because there's no translation — the signature is honest.
 
+**An i18n getter can also be called without `lang`**, and then it returns the same records **with no `label`**:
+
+```ts
+getAccountStatuses().connected.code        // "connected"  → codes and metadata, no language needed
+getAccountStatuses().connected.label       // ✗ compile error: without a language there is no text
+getAccountStatuses("en").connected.label   // "Connected"
+```
+
+Use it where only codes are read — module-level constants, filters sent to an API — instead of passing a
+placeholder language. Without a language there is no label, so text in the wrong language cannot leak out.
+`ReturnType<typeof getX>` still resolves to the labeled shape (the overload with `lang` is declared last).
+
+The active language rarely arrives as a library literal (`en-US` from the browser, a user preference saved
+unvalidated). Narrow it once with `toSupportedLocale(value)` from `/lang` — an exact `Locale` passes through,
+anything else falls back to `es-mex` — before handing it to any `getX(lang)` / `queryX({ lang })`.
+
 ### Type convention
 
 - **`XOption`** = the catalog record **+ `label`** (what `getX(lang)` returns in i18n domains). This is the type
   consumers use to type results.
 - **`XRecord`** = the raw record. In non-i18n domains (currencies/providers) it is the result type
   (the label is already inline); in i18n domains it is **internal** (only input to `XOption`) and is not exported.
+  `getX()` without `lang` in an i18n domain is typed `WithoutLabel<XOption>` (a distributive `Omit`, so fields only
+  some records carry, like `filterDisplay`, survive), and `XRecord` stays internal.
 - **`X`** (e.g. `AccountType`, `Currency`) = the union of codes. Always public (for typing variables/params).
 
 ---
@@ -561,7 +580,7 @@ options.filter(isGroupOption)                              // only the group opt
 - **Family** (`FilterClassificationCategoryFamily`): the chips of the grouped type filter, in chip order: `payments`, `collections`,
   `international`, `conversions`, `top_up`, `between_accounts` and `unclassified`. Each family lists the
   `categories` it groups, and a category belongs to exactly one family (`adjustment` and `reward` fold into
-  `between_accounts`). `getFilterClassificationCategoryFamilies(lang)` returns each family with its label and categories; `lang` is required.
+  `between_accounts`). `getFilterClassificationCategoryFamilies(lang)` returns each family with its label and categories; without `lang`, the same families with no label.
 - **Category** (`FilterClassificationCategory`): derived from the families' lists: `payments`, `collections`, `conversions`,
   `international`, `between_accounts`, `top_up`, `adjustment`, `reward`, `unclassified`. The family is never stored
   per record: group types by family with `getFilterClassificationCategoryFamilies(lang)[family].categories.includes(type.category)`.

package/dist/cjs/accounts/status/utils/account-status.utils.d.ts

@@ -1,10 +1,13 @@
 import type { AccountStatus, AccountStatusRecord } from "../catalog";
 import type { Locale } from "../../../lang";
 import type { CatalogQuery } from "../../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type AccountStatusOption = AccountStatusRecord & {
     label: string;
 };
-export declare const getAccountStatuses: (lang: Locale) => Record<AccountStatus, AccountStatusOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getAccountStatuses(): Record<AccountStatus, WithoutLabel<AccountStatusOption>>;
+export declare function getAccountStatuses(lang: Locale): Record<AccountStatus, AccountStatusOption>;
 /** `lang` is required (i18n domain, no default) and travels inside the query object, never positional. */
 export type AccountStatusQuery = CatalogQuery<AccountStatusRecord> & {
     lang: Locale;

package/dist/cjs/accounts/status/utils/account-status.utils.js

@@ -3,25 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryAccountStatuses = exports.getAccountStatuses = void 0;
+exports.queryAccountStatuses = void 0;
+exports.getAccountStatuses = getAccountStatuses;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
 const catalog_query_utils_1 = require("../../../utils/catalog-query.utils");
 const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
-const getAccountStatuses = (lang) => {
-    const locale = locales[lang];
+function getAccountStatuses(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.ACCOUNT_STATUSES)) {
-        result[record.code] = { ...record, label: locale.accountStatuses[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].accountStatuses[record.code] };
     }
     return result;
-};
-exports.getAccountStatuses = getAccountStatuses;
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 const queryAccountStatuses = (query) => {
     const { lang, ...criteria } = query;
-    const statuses = (0, exports.getAccountStatuses)(lang);
+    const statuses = getAccountStatuses(lang);
     return Object.values(statuses).filter(status => (0, catalog_query_utils_1.matchesQuery)(status, criteria));
 };
 exports.queryAccountStatuses = queryAccountStatuses;

package/dist/cjs/accounts/types/utils/account-type.utils.d.ts

@@ -1,14 +1,17 @@
 import type { AccountType, AccountTypeRecord } from "../catalog";
 import type { Locale } from "../../../lang";
 import type { CatalogQuery } from "../../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type AccountTypeOption = AccountTypeRecord & {
     label: string;
 };
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getAccountTypes(): Record<AccountType, WithoutLabel<AccountTypeOption>>;
 /**
  * The catalog indexed by code (same shape as ACCOUNT_TYPES), each record enriched
  * with its label for the given language. Access by code directly, or Object.values for a list.
  */
-export declare const getAccountTypes: (lang: Locale) => Record<AccountType, AccountTypeOption>;
+export declare function getAccountTypes(lang: Locale): Record<AccountType, AccountTypeOption>;
 /** `lang` is required (i18n domain, no default) and travels inside the query object, never positional. */
 export type AccountTypeQuery = CatalogQuery<AccountTypeRecord> & {
     lang: Locale;

package/dist/cjs/accounts/types/utils/account-type.utils.js

@@ -3,29 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryAccountTypes = exports.getAccountTypes = void 0;
+exports.queryAccountTypes = void 0;
+exports.getAccountTypes = getAccountTypes;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
 const catalog_query_utils_1 = require("../../../utils/catalog-query.utils");
 const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
-/**
- * The catalog indexed by code (same shape as ACCOUNT_TYPES), each record enriched
- * with its label for the given language. Access by code directly, or Object.values for a list.
- */
-const getAccountTypes = (lang) => {
-    const locale = locales[lang];
+function getAccountTypes(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.ACCOUNT_TYPES)) {
-        result[record.code] = { ...record, label: locale.accountTypes[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].accountTypes[record.code] };
     }
     return result;
-};
-exports.getAccountTypes = getAccountTypes;
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 const queryAccountTypes = (query) => {
     const { lang, ...criteria } = query;
-    const types = (0, exports.getAccountTypes)(lang);
+    const types = getAccountTypes(lang);
     return Object.values(types).filter(type => (0, catalog_query_utils_1.matchesQuery)(type, criteria));
 };
 exports.queryAccountTypes = queryAccountTypes;

package/dist/cjs/blockchains/utils/blockchain.utils.d.ts

@@ -1,10 +1,13 @@
 import type { Blockchain, BlockchainRecord } from "../catalog";
 import type { Locale } from "../../lang";
 import type { CatalogQuery } from "../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../utils/catalog-label.utils";
 export type BlockchainOption = BlockchainRecord & {
     label: string;
 };
-export declare const getBlockchains: (lang: Locale) => Record<Blockchain, BlockchainOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getBlockchains(): Record<Blockchain, WithoutLabel<BlockchainOption>>;
+export declare function getBlockchains(lang: Locale): Record<Blockchain, BlockchainOption>;
 /** `lang` is required (i18n domain, no default) and travels inside the query object, never positional. */
 export type BlockchainQuery = CatalogQuery<BlockchainRecord> & {
     lang: Locale;

package/dist/cjs/blockchains/utils/blockchain.utils.js

@@ -3,25 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryBlockchains = exports.getBlockchains = void 0;
+exports.queryBlockchains = void 0;
+exports.getBlockchains = getBlockchains;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
 const catalog_query_utils_1 = require("../../utils/catalog-query.utils");
 const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
-const getBlockchains = (lang) => {
-    const locale = locales[lang];
+function getBlockchains(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.BLOCKCHAINS)) {
-        result[record.code] = { ...record, label: locale.blockchains[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].blockchains[record.code] };
     }
     return result;
-};
-exports.getBlockchains = getBlockchains;
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 const queryBlockchains = (query) => {
     const { lang, ...criteria } = query;
-    const blockchains = (0, exports.getBlockchains)(lang);
+    const blockchains = getBlockchains(lang);
     return Object.values(blockchains).filter(blockchain => (0, catalog_query_utils_1.matchesQuery)(blockchain, criteria));
 };
 exports.queryBlockchains = queryBlockchains;

package/dist/cjs/canonicalTransactions/nature/utils/nature.utils.d.ts

@@ -1,6 +1,9 @@
 import type { Nature, NatureRecord } from "../catalog";
 import type { Locale } from "../../../lang";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type NatureOption = NatureRecord & {
     label: string;
 };
-export declare const getNatures: (lang: Locale) => Record<Nature, NatureOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getNatures(): Record<Nature, WithoutLabel<NatureOption>>;
+export declare function getNatures(lang: Locale): Record<Nature, NatureOption>;

package/dist/cjs/canonicalTransactions/nature/utils/nature.utils.js

@@ -3,17 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getNatures = void 0;
+exports.getNatures = getNatures;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
 const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
-const getNatures = (lang) => {
-    const locale = locales[lang];
+function getNatures(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.NATURES)) {
-        result[record.code] = { ...record, label: locale.natures[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].natures[record.code] };
     }
     return result;
-};
-exports.getNatures = getNatures;
+}

package/dist/cjs/canonicalTransactions/productType/utils/product-type.utils.d.ts

@@ -1,6 +1,9 @@
 import type { ProductType, ProductTypeRecord } from "../catalog";
 import type { Locale } from "../../../lang";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type ProductTypeOption = ProductTypeRecord & {
     label: string;
 };
-export declare const getProductTypes: (lang: Locale) => Record<ProductType, ProductTypeOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getProductTypes(): Record<ProductType, WithoutLabel<ProductTypeOption>>;
+export declare function getProductTypes(lang: Locale): Record<ProductType, ProductTypeOption>;

package/dist/cjs/canonicalTransactions/productType/utils/product-type.utils.js

@@ -3,17 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getProductTypes = void 0;
+exports.getProductTypes = getProductTypes;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
 const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
-const getProductTypes = (lang) => {
-    const locale = locales[lang];
+function getProductTypes(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.PRODUCT_TYPES)) {
-        result[record.code] = { ...record, label: locale.productTypes[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].productTypes[record.code] };
     }
     return result;
-};
-exports.getProductTypes = getProductTypes;
+}

package/dist/cjs/counterparties/types/utils/counterparty-type.utils.d.ts

@@ -1,10 +1,13 @@
 import type { CounterpartyType, CounterpartyTypeRecord } from "../catalog";
 import type { Locale } from "../../../lang";
 import type { CatalogQuery } from "../../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type CounterpartyTypeOption = CounterpartyTypeRecord & {
     label: string;
 };
-export declare const getCounterpartyTypes: (lang: Locale) => Record<CounterpartyType, CounterpartyTypeOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getCounterpartyTypes(): Record<CounterpartyType, WithoutLabel<CounterpartyTypeOption>>;
+export declare function getCounterpartyTypes(lang: Locale): Record<CounterpartyType, CounterpartyTypeOption>;
 /** `lang` is required (i18n domain, no default) and travels inside the query object, never positional. */
 export type CounterpartyTypeQuery = CatalogQuery<CounterpartyTypeRecord> & {
     lang: Locale;

package/dist/cjs/counterparties/types/utils/counterparty-type.utils.js

@@ -3,25 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryCounterpartyTypes = exports.getCounterpartyTypes = void 0;
+exports.queryCounterpartyTypes = void 0;
+exports.getCounterpartyTypes = getCounterpartyTypes;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
 const catalog_query_utils_1 = require("../../../utils/catalog-query.utils");
 const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
-const getCounterpartyTypes = (lang) => {
-    const locale = locales[lang];
+function getCounterpartyTypes(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.COUNTERPARTY_TYPES)) {
-        result[record.code] = { ...record, label: locale.counterpartyTypes[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].counterpartyTypes[record.code] };
     }
     return result;
-};
-exports.getCounterpartyTypes = getCounterpartyTypes;
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 const queryCounterpartyTypes = (query) => {
     const { lang, ...criteria } = query;
-    const types = (0, exports.getCounterpartyTypes)(lang);
+    const types = getCounterpartyTypes(lang);
     return Object.values(types).filter(type => (0, catalog_query_utils_1.matchesQuery)(type, criteria));
 };
 exports.queryCounterpartyTypes = queryCounterpartyTypes;

package/dist/cjs/countries/base/utils/country.utils.d.ts

@@ -1,10 +1,13 @@
 import type { Country, CountryRecord } from "../catalog";
 import type { Locale } from "../../../lang";
 import type { CatalogQuery } from "../../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type CountryOption = CountryRecord & {
     label: string;
 };
-export declare const getCountries: (lang: Locale) => Record<Country, CountryOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getCountries(): Record<Country, WithoutLabel<CountryOption>>;
+export declare function getCountries(lang: Locale): Record<Country, CountryOption>;
 /** `lang` is required (i18n domain, no default) and travels inside the query object, never positional. */
 export type CountryQuery = CatalogQuery<CountryRecord> & {
     lang: Locale;

package/dist/cjs/countries/base/utils/country.utils.js

@@ -3,25 +3,24 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.queryCountries = exports.getCountries = void 0;
+exports.queryCountries = void 0;
+exports.getCountries = getCountries;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
 const catalog_query_utils_1 = require("../../../utils/catalog-query.utils");
 const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
-const getCountries = (lang) => {
-    const locale = locales[lang];
+function getCountries(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.COUNTRIES)) {
-        result[record.code] = { ...record, label: locale.countries[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].countries[record.code] };
     }
     return result;
-};
-exports.getCountries = getCountries;
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 const queryCountries = (query) => {
     const { lang, ...criteria } = query;
-    const countries = (0, exports.getCountries)(lang);
+    const countries = getCountries(lang);
     return Object.values(countries).filter(country => (0, catalog_query_utils_1.matchesQuery)(country, criteria));
 };
 exports.queryCountries = queryCountries;

package/dist/cjs/countries/iso/utils/country-iso.utils.d.ts

@@ -1,6 +1,7 @@
 import type { CountryISO, CountryISORecord } from "../catalog";
 import type { Locale } from "../../../lang";
 import type { CatalogQuery } from "../../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export declare const hasCountryISOFlag: (code: CountryISO) => boolean;
 export type CountryISOOption = CountryISORecord & {
     label: string;
@@ -12,7 +13,9 @@ export interface IndicativeWithCode {
     country: string;
     isoCode: string | undefined;
 }
-export declare const getCountriesISO: (lang: Locale) => Record<CountryISO, CountryISOOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getCountriesISO(): Record<CountryISO, WithoutLabel<CountryISOOption>>;
+export declare function getCountriesISO(lang: Locale): Record<CountryISO, CountryISOOption>;
 /** `lang` is required (i18n domain, no default) and travels inside the query object, never positional. */
 export type CountryISOQuery = CatalogQuery<CountryISORecord> & {
     lang: Locale;

package/dist/cjs/countries/iso/utils/country-iso.utils.js

@@ -3,7 +3,8 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getIndicativesWithCodes = exports.queryCountriesISO = exports.getCountriesISO = exports.hasCountryISOFlag = void 0;
+exports.getIndicativesWithCodes = exports.queryCountriesISO = exports.hasCountryISOFlag = void 0;
+exports.getCountriesISO = getCountriesISO;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
@@ -12,19 +13,17 @@ const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
 const AVAILABLE_FLAG_CODES = new Set(["col", "mex", "usa"]);
 const hasCountryISOFlag = (code) => AVAILABLE_FLAG_CODES.has(code);
 exports.hasCountryISOFlag = hasCountryISOFlag;
-const getCountriesISO = (lang) => {
-    const locale = locales[lang];
+function getCountriesISO(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.COUNTRIES_ISO)) {
-        result[record.code] = { ...record, label: locale.countriesISO[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].countriesISO[record.code] };
     }
     return result;
-};
-exports.getCountriesISO = getCountriesISO;
+}
 /** The catalog as a list, narrowed by the query — see `matchesQuery` for the matching rules. */
 const queryCountriesISO = (query) => {
     const { lang, ...criteria } = query;
-    const countries = (0, exports.getCountriesISO)(lang);
+    const countries = getCountriesISO(lang);
     return Object.values(countries).filter(country => (0, catalog_query_utils_1.matchesQuery)(country, criteria));
 };
 exports.queryCountriesISO = queryCountriesISO;

package/dist/cjs/documentTypes/utils/document-type.utils.d.ts

@@ -1,6 +1,7 @@
 import type { DocumentType, DocumentTypeGeo, DocumentTypeRecord, DocumentTypeUsage } from "../catalog";
 import type { Locale } from "../../lang";
 import type { CatalogQuery } from "../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../utils/catalog-label.utils";
 type DocumentTypeValidation = Omit<DocumentTypeRecord, "geo">;
 export type DocumentTypeOption = DocumentTypeValidation & {
     label: string;
@@ -12,11 +13,13 @@ type DocumentTypeGeoRecord = DocumentTypeValidation & {
 export type DocumentTypeGeoOption = DocumentTypeGeoRecord & {
     label: string;
 };
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getDocumentTypes(): Record<DocumentType, WithoutLabel<DocumentTypeOption>>;
 /**
  * Documents indexed by code (definition + label). For the unique list (Object.values),
  * validation ([code].minLength / maxLength / type) and label ([code].label).
  */
-export declare const getDocumentTypes: (lang: Locale) => Record<DocumentType, DocumentTypeOption>;
+export declare function getDocumentTypes(lang: Locale): Record<DocumentType, DocumentTypeOption>;
 /** i18n domain: `lang` is required, inside the query object — see matchesQuery for the matching rules. */
 export type DocumentTypeQuery = CatalogQuery<DocumentTypeGeoRecord> & {
     lang: Locale;

package/dist/cjs/documentTypes/utils/document-type.utils.js

@@ -3,25 +3,21 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDocumentTypesByGeo = exports.queryDocumentTypes = exports.getDocumentTypes = void 0;
+exports.getDocumentTypesByGeo = exports.queryDocumentTypes = void 0;
+exports.getDocumentTypes = getDocumentTypes;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
 const catalog_query_utils_1 = require("../../utils/catalog-query.utils");
 const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
-/**
- * Documents indexed by code (definition + label). For the unique list (Object.values),
- * validation ([code].minLength / maxLength / type) and label ([code].label).
- */
-const getDocumentTypes = (lang) => {
-    const locale = locales[lang];
+function getDocumentTypes(...args) {
     const result = {};
     for (const { code, minLength, maxLength, type } of Object.values(catalog_1.DOCUMENT_TYPES)) {
-        result[code] = { code, minLength, maxLength, type, label: locale.documentTypes[code] };
+        const validation = { code, minLength, maxLength, type };
+        result[code] = args.length === 0 ? validation : { ...validation, label: locales[args[0]].documentTypes[code] };
     }
     return result;
-};
-exports.getDocumentTypes = getDocumentTypes;
+}
 /** DOCUMENT_TYPES flattened by geo, one row per (code, geo) pair — no label, so it is what gets filtered. */
 const flattenByGeo = () => Object.values(catalog_1.DOCUMENT_TYPES).flatMap(({ geo, ...record }) => {
     const entries = Object.entries(geo);
@@ -30,7 +26,7 @@ const flattenByGeo = () => Object.values(catalog_1.DOCUMENT_TYPES).flatMap(({ ge
 /** The catalog flattened by geo, narrowed by the query, each record enriched with its label for `query.lang`. */
 const queryDocumentTypes = (query) => {
     const { lang, ...filters } = query;
-    const docs = (0, exports.getDocumentTypes)(lang);
+    const docs = getDocumentTypes(lang);
     return flattenByGeo()
         .filter(record => (0, catalog_query_utils_1.matchesQuery)(record, filters))
         .map(record => ({ ...record, label: docs[record.code].label }));

package/dist/cjs/filterClassification/categoryFamilies/utils/filter-classification-category-family.utils.d.ts

@@ -1,8 +1,11 @@
 import type { FilterClassificationCategory, FilterClassificationCategoryFamily } from "../catalog";
 import type { Locale } from "../../../lang";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type FilterClassificationCategoryFamilyOption = {
     code: FilterClassificationCategoryFamily;
     categories: readonly FilterClassificationCategory[];
     label: string;
 };
-export declare const getFilterClassificationCategoryFamilies: (lang: Locale) => Record<FilterClassificationCategoryFamily, FilterClassificationCategoryFamilyOption>;
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getFilterClassificationCategoryFamilies(): Record<FilterClassificationCategoryFamily, WithoutLabel<FilterClassificationCategoryFamilyOption>>;
+export declare function getFilterClassificationCategoryFamilies(lang: Locale): Record<FilterClassificationCategoryFamily, FilterClassificationCategoryFamilyOption>;

package/dist/cjs/filterClassification/categoryFamilies/utils/filter-classification-category-family.utils.js

@@ -3,17 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFilterClassificationCategoryFamilies = void 0;
+exports.getFilterClassificationCategoryFamilies = getFilterClassificationCategoryFamilies;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
 const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
-const getFilterClassificationCategoryFamilies = (lang) => {
-    const locale = locales[lang];
+function getFilterClassificationCategoryFamilies(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.FILTER_CLASSIFICATION_CATEGORY_FAMILIES)) {
-        result[record.code] = { ...record, label: locale.categoryFamilies[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].categoryFamilies[record.code] };
     }
     return result;
-};
-exports.getFilterClassificationCategoryFamilies = getFilterClassificationCategoryFamilies;
+}

package/dist/cjs/filterClassification/sections/utils/filter-classification-section.utils.d.ts

@@ -1,7 +1,10 @@
 import type { FilterClassificationSection, FilterClassificationSectionRecord } from "../catalog";
 import type { Locale } from "../../../lang";
+import type { WithoutLabel } from "../../../utils/catalog-label.utils";
 export type FilterClassificationSectionOption = FilterClassificationSectionRecord & {
     label: string;
 };
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getFilterClassificationSections(): Record<FilterClassificationSection, WithoutLabel<FilterClassificationSectionOption>>;
 /** The section headings indexed by code, each with its label. A section is a heading: never selectable, never sent to an API. */
-export declare const getFilterClassificationSections: (lang: Locale) => Record<FilterClassificationSection, FilterClassificationSectionOption>;
+export declare function getFilterClassificationSections(lang: Locale): Record<FilterClassificationSection, FilterClassificationSectionOption>;

package/dist/cjs/filterClassification/sections/utils/filter-classification-section.utils.js

@@ -3,18 +3,15 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getFilterClassificationSections = void 0;
+exports.getFilterClassificationSections = getFilterClassificationSections;
 const catalog_1 = require("../catalog");
 const en_json_1 = __importDefault(require("../locales/en.json"));
 const es_mex_json_1 = __importDefault(require("../locales/es-mex.json"));
 const locales = { en: en_json_1.default, "es-mex": es_mex_json_1.default };
-/** The section headings indexed by code, each with its label. A section is a heading: never selectable, never sent to an API. */
-const getFilterClassificationSections = (lang) => {
-    const locale = locales[lang];
+function getFilterClassificationSections(...args) {
     const result = {};
     for (const record of Object.values(catalog_1.FILTER_CLASSIFICATION_SECTIONS)) {
-        result[record.code] = { ...record, label: locale.sections[record.code] };
+        result[record.code] = args.length === 0 ? { ...record } : { ...record, label: locales[args[0]].sections[record.code] };
     }
     return result;
-};
-exports.getFilterClassificationSections = getFilterClassificationSections;
+}

package/dist/cjs/financialInstitutions/utils/financial-institution.utils.d.ts

@@ -1,6 +1,7 @@
 import type { FinancialInstitution, FinancialInstitutionRecord } from "../catalog";
 import type { Locale } from "../../lang";
 import type { CatalogQuery } from "../../utils/catalog-query.utils";
+import type { WithoutLabel } from "../../utils/catalog-label.utils";
 export type FinancialInstitutionOption = FinancialInstitutionRecord & {
     label: string;
 };
@@ -8,14 +9,16 @@ export type FinancialInstitutionOption = FinancialInstitutionRecord & {
  * The catalog by code. Indexed by a plain string (e.g. a code from an API payload) instead of a known code,
  * the lookup is `FinancialInstitutionOption | undefined`, so an unknown code needs no cast to be handled.
  */
-export interface FinancialInstitutionCatalog extends Record<FinancialInstitution, FinancialInstitutionOption> {
-    [code: string]: FinancialInstitutionOption | undefined;
+export interface FinancialInstitutionCatalog<T = FinancialInstitutionOption> extends Record<FinancialInstitution, T> {
+    [code: string]: T | undefined;
 }
+/** Without `lang`: the records with no `label`, to read codes and metadata where no language applies. */
+export declare function getFinancialInstitutions(): FinancialInstitutionCatalog<WithoutLabel<FinancialInstitutionOption>>;
 /**
  * The catalog indexed by code (same shape as FINANCIAL_INSTITUTIONS), each record enriched
  * with its label for the given language. Access by code directly; for a list use `queryFinancialInstitutions`.
  */
-export declare const getFinancialInstitutions: (lang: Locale) => FinancialInstitutionCatalog;
+export declare function getFinancialInstitutions(lang: Locale): FinancialInstitutionCatalog;
 /** `lang` is required (i18n domain, no default) and travels inside the query object, never positional. */
 export type FinancialInstitutionQuery = CatalogQuery<FinancialInstitutionRecord> & {
     lang: Locale;