@pocket-trash/localizations 0.0.3

package/README.md

@@ -0,0 +1,27 @@
+# @pocket-trash/localizations
+
+Shared localization utilities and message catalogs for Pocket Trash.
+
+## Install
+
+```sh
+npm install @pocket-trash/localizations
+```
+
+## Use
+
+```ts
+import { formatMessage, resolveLocale } from '@pocket-trash/localizations';
+
+const locale = resolveLocale('es-MX');
+const label = formatMessage('action.save', {}, locale);
+```
+
+## Develop
+
+```sh
+pnpm install
+pnpm test
+```
+
+Publishing notes live in [docs/publishing.md](docs/publishing.md).

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+import { esMX } from '@clerk/localizations';
+export type SupportedLocale = 'en' | 'es-MX';
+export type MessageKey = 'app.name' | 'action.cancel' | 'action.save' | 'error.generic' | 'locale.current';
+export type Messages = Readonly<Record<MessageKey, string>>;
+export type LocalePreference = string | readonly string[] | null | undefined;
+export type ClerkLocalizationResource = typeof esMX;
+export declare const DEFAULT_LOCALE = "en";
+export declare const SUPPORTED_LOCALES: readonly ["en", "es-MX"];
+export declare const messages: Readonly<{
+    en: Readonly<{
+        'app.name': "Pocket Trash";
+        'action.cancel': "Cancel";
+        'action.save': "Save";
+        'error.generic': "Something went wrong.";
+        'locale.current': "Current language: {locale}";
+    }>;
+    'es-MX': Readonly<{
+        'app.name': "Pocket Trash";
+        'action.cancel': "Cancelar";
+        'action.save': "Guardar";
+        'error.generic': "Algo salio mal.";
+        'locale.current': "Idioma actual: {locale}";
+    }>;
+}>;
+export declare const messageKeys: readonly MessageKey[];
+export declare const clerkLocalizations: Readonly<Record<SupportedLocale, ClerkLocalizationResource | undefined>>;
+export declare function resolveLocale(...preferences: readonly LocalePreference[]): SupportedLocale;
+export declare function getMessages(locale?: string | null): Messages;
+export declare function getClerkLocalization(locale?: string | null): ClerkLocalizationResource | undefined;
+export declare function formatMessage(key: MessageKey | string, values?: Readonly<Record<string, unknown>>, locale?: string | null): string;
+export declare function assertCompleteCatalogs(): true;

package/dist/index.js

@@ -0,0 +1,91 @@
+import { esMX } from '@clerk/localizations';
+export const DEFAULT_LOCALE = 'en';
+export const SUPPORTED_LOCALES = Object.freeze(['en', 'es-MX']);
+const localeAliases = new Map([
+    ['en', 'en'],
+    ['en-us', 'en'],
+    ['en-ca', 'en'],
+    ['es', 'es-MX'],
+    ['es-mx', 'es-MX'],
+    ['es-us', 'es-MX'],
+]);
+export const messages = Object.freeze({
+    en: Object.freeze({
+        'app.name': 'Pocket Trash',
+        'action.cancel': 'Cancel',
+        'action.save': 'Save',
+        'error.generic': 'Something went wrong.',
+        'locale.current': 'Current language: {locale}',
+    }),
+    'es-MX': Object.freeze({
+        'app.name': 'Pocket Trash',
+        'action.cancel': 'Cancelar',
+        'action.save': 'Guardar',
+        'error.generic': 'Algo salio mal.',
+        'locale.current': 'Idioma actual: {locale}',
+    }),
+});
+export const messageKeys = Object.freeze(Object.keys(messages[DEFAULT_LOCALE]));
+export const clerkLocalizations = Object.freeze({
+    en: undefined,
+    'es-MX': esMX,
+});
+export function resolveLocale(...preferences) {
+    for (const preference of preferences.flat()) {
+        for (const tag of parseLocalePreference(preference)) {
+            const locale = matchLocale(tag);
+            if (locale)
+                return locale;
+        }
+    }
+    return DEFAULT_LOCALE;
+}
+export function getMessages(locale) {
+    return messages[resolveLocale(locale)];
+}
+export function getClerkLocalization(locale) {
+    return clerkLocalizations[resolveLocale(locale)];
+}
+export function formatMessage(key, values = {}, locale = DEFAULT_LOCALE) {
+    const template = getMessages(locale)[key] ?? messages[DEFAULT_LOCALE][key];
+    if (!template)
+        return key;
+    return template.replace(/\{([a-zA-Z0-9_]+)\}/g, (_, name) => values[name] == null ? `{${name}}` : String(values[name]));
+}
+export function assertCompleteCatalogs() {
+    const expected = new Set(messageKeys);
+    for (const [locale, catalog] of Object.entries(messages)) {
+        const keys = Object.keys(catalog);
+        const missing = messageKeys.filter((key) => !(key in catalog));
+        const extra = keys.filter((key) => !expected.has(key));
+        if (missing.length || extra.length) {
+            throw new Error(`${locale} catalog mismatch: missing ${missing.join(', ') || 'none'}; extra ${extra.join(', ') || 'none'}`);
+        }
+    }
+    return true;
+}
+function parseLocalePreference(preference) {
+    if (typeof preference !== 'string' || !preference.trim())
+        return [];
+    if (!preference.includes(',') && !preference.includes(';'))
+        return [preference];
+    return preference
+        .split(',')
+        .map((part, index) => {
+        const [tag, ...params] = part.trim().split(';');
+        const q = params
+            .map((param) => param.trim().match(/^q=([0-9.]+)$/i)?.[1])
+            .find(Boolean);
+        return { tag, q: q == null ? 1 : Number(q), index };
+    })
+        .filter(({ tag, q }) => tag && Number.isFinite(q) && q > 0)
+        .sort((a, b) => b.q - a.q || a.index - b.index)
+        .map(({ tag }) => tag);
+}
+function matchLocale(tag) {
+    const normalized = tag.trim().replace('_', '-').toLowerCase();
+    if (normalized === '*')
+        return DEFAULT_LOCALE;
+    return localeAliases.get(normalized) ?? localeAliases.get(normalized.split('-')[0] ?? '') ?? null;
+}
+assertCompleteCatalogs();

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@pocket-trash/localizations",
+  "version": "0.0.3",
+  "description": "Shared localization utilities and message catalogs for Pocket Trash.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Pocket-Trash/pocket-trash-localizations.git"
+  },
+  "bugs": {
+    "url": "https://github.com/Pocket-Trash/pocket-trash-localizations/issues"
+  },
+  "homepage": "https://github.com/Pocket-Trash/pocket-trash-localizations#readme",
+  "keywords": [
+    "pocket-trash",
+    "localization",
+    "i18n"
+  ],
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "changeset": "changeset",
+    "changeset:version": "changeset version",
+    "release": "changeset publish",
+    "test": "pnpm run build && node --test"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "devDependencies": {
+    "@changesets/cli": "^2.31.1",
+    "typescript": "^5.9.2"
+  },
+  "dependencies": {
+    "@clerk/localizations": "^4.14.2",
+    "lts": "^2.0.0"
+  },
+  "packageManager": "pnpm@11.10.0"
+}