locon 1.5.0 → 1.6.0

package/dist/resources-BwFIzg3m.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Per-call options for `l()`, `lIn()` and `<LText>`.
+ *
+ * All four are optional and independent: `params` interpolates, `count`
+ * selects a plural form, and `locale` renders one call in a language other
+ * than the current one (used when an app exports a document in a language
+ * the interface is not currently showing). `fallback` is returned only when
+ * no locale resolves the input.
+ */
+interface TranslateOptions {
+    /** Values for `{token}` placeholders inside the resolved string. */
+    params?: Record<string, string | number>;
+    /** Selects `key_one` / `key_few` / `key_other` … via `Intl.PluralRules`. */
+    count?: number;
+    /** Resolve against this locale instead of the current one. */
+    locale?: string;
+    /** Human-readable fallback when no locale resolves the key/value. */
+    fallback?: string;
+}
+
+type Resource = Record<string, string>;
+type ResourceLoader = () => Promise<Resource | {
+    default: Resource;
+}>;
+interface ResourceOptions {
+    loaders: Record<string, ResourceLoader>;
+    defaultLocale: string;
+    projectLocale?: string;
+    locale?: string | null;
+    /** Ordered browser/device preferences, or an explicit list in Node. */
+    languages?: readonly string[];
+}
+interface LocaleSnapshot {
+    currentLocale: string;
+    loading: boolean;
+    ready: boolean;
+    error: Error | null;
+}
+/** First matching preference wins; regional variants can use a base resource. */
+declare function matchLocale(languages: readonly string[], supported: readonly string[], fallback: string): string;
+/** A per-app/per-request store. Importing it touches neither React nor a platform API. */
+declare function createLocon(options: ResourceOptions): {
+    locales: string[];
+    l: (key: string, translateOptions?: TranslateOptions) => string;
+    loadLocale: (locale: string) => Promise<Resource>;
+    setLocale: (locale: string | null) => Promise<boolean>;
+    getSnapshot: () => LocaleSnapshot;
+    subscribe(listener: () => void): () => void;
+};
+type LoconInstance = ReturnType<typeof createLocon>;
+
+export { type LocaleSnapshot as L, type ResourceLoader as R, type TranslateOptions as T, type LoconInstance as a, type ResourceOptions as b, createLocon as c, matchLocale as m };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "locon",
-  "version": "1.5.0",
-  "description": "locon is a simple and lightweight library for React Native that provides a simple way to manage translations in your app.",
+  "version": "1.6.0",
+  "description": "Lightweight localization for React Native, React and Node with lazy locale resources.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -10,17 +10,28 @@
       "default": "./dist/index.js"
     },
     "./skills/*": "./skills/*",
-    "./package.json": "./package.json"
+    "./package.json": "./package.json",
+    "./core": {
+      "types": "./dist/core.d.ts",
+      "import": "./dist/core.mjs",
+      "require": "./dist/core.js"
+    },
+    "./react": {
+      "types": "./dist/react.d.ts",
+      "import": "./dist/react.mjs",
+      "require": "./dist/react.js"
+    }
   },
   "files": [
     "dist",
-    "skills"
+    "skills",
+    "CHANGELOG.md"
   ],
   "scripts": {
-    "build": "tsup",
+    "build": "tsup && tsup --config tsup.web.config.ts",
     "lint": "eslint src",
-    "prepare": "tsup",
-    "pretest": "tsup",
+    "prepare": "npm run build",
+    "pretest": "npm run build",
     "test": "jest"
   },
   "keywords": [
@@ -59,6 +70,12 @@
     },
     "react-native-localize": {
       "optional": true
+    },
+    "react": {
+      "optional": true
+    },
+    "react-native": {
+      "optional": true
     }
   },
   "devDependencies": {