@intlayer/use-intl 9.0.0-canary.10

package/dist/types/shared/intlFormatter.d.ts

@@ -0,0 +1,19 @@
+import { createFormatter } from "use-intl";
+
+//#region src/shared/intlFormatter.d.ts
+/** The formatter object shape exposed by use-intl. */
+type Formatter = ReturnType<typeof createFormatter>;
+/**
+ * Builds a use-intl compatible formatter backed by the native `Intl.*` APIs
+ * for the given locale.
+ *
+ * Shared by `useFormatter` (React hook) and `createFormatter` (non-React core).
+ *
+ * @param locale - The locale used by every `Intl.*` formatter instance.
+ * @returns A formatter exposing `dateTime`, `number`, `dateTimeRange`,
+ *   `relativeTime`, `list`, and `displayName`.
+ */
+declare const buildIntlFormatter: (locale: string) => Formatter;
+//#endregion
+export { Formatter, buildIntlFormatter };
+//# sourceMappingURL=intlFormatter.d.ts.map

package/dist/types/shared/intlFormatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intlFormatter.d.ts","names":[],"sources":["../../../src/shared/intlFormatter.ts"],"mappings":";;;;KAGY,SAAA,GAAY,UAAA,QAAkB,eAAA;AAA1C;;;;;AA0BA;;;;;AA1BA,cA0Ba,kBAAA,GAAsB,MAAA,aAAiB,SAAA"}

package/dist/types/shared/namespaceTranslator.d.ts

@@ -0,0 +1,51 @@
+import { LocalesValues } from "@intlayer/types/module_augmentation";
+import { ReactNode } from "react";
+import { MessageValues } from "@intlayer/core/messageFormat";
+
+//#region src/shared/namespaceTranslator.d.ts
+/** Chunk renderer used by `t.rich()` — maps tag children to a React node. */
+type RichChunkRenderer = (chunks: ReactNode) => ReactNode;
+/** Chunk renderer used by `t.markup()` — maps tag children to a string. */
+type MarkupChunkRenderer = (chunks: string) => string;
+/**
+ * Reads a dotted `path` (e.g. `counter.label`) out of a nested object value.
+ *
+ * @param objectValue - The object to read from.
+ * @param path - Dot-separated path. An empty path returns `objectValue`.
+ * @returns The value found at `path`, or `undefined` when any segment is absent.
+ */
+declare const navigatePath: (objectValue: unknown, path: string) => unknown;
+/**
+ * The untyped runtime translator shared by `useTranslations` (React hook) and
+ * `createTranslator` (non-React core).
+ *
+ * Behaviour matches use-intl / next-intl:
+ * - namespace `'about'` → keys resolved inside the `about` dictionary
+ * - namespace `'about.counter'` → dictionary `about`, key prefix `counter`
+ * - no namespace → the first segment of each key is the dictionary key
+ * - messages support ICU syntax (plural, select, `#`, formatted arguments)
+ * - `t.rich` / `t.markup` map `<tag>chunks</tag>` through the provided
+ *   renderers; `t.raw` returns the raw value; `t.has` checks existence
+ *
+ * @param locale - The locale dictionaries are resolved for.
+ * @param namespace - Optional dictionary key, optionally with a nested scope.
+ * @returns A translate function augmented with `has`, `raw`, `rich`, `markup`.
+ */
+declare const createNamespaceTranslator: (locale: LocalesValues, namespace?: string) => ((key: string, values?: MessageValues) => string) & {
+  /** Returns `true` if the given key exists in the namespace. */has: (key: string) => boolean; /** Returns the raw unprocessed content for the given key. */
+  raw: (key: string) => unknown;
+  /**
+   * Resolves a message containing `<tag>chunks</tag>` markup, mapping each
+   * tag through the matching renderer in `values`.
+   */
+  rich: (key: string, values?: Record<string, unknown>) => ReactNode;
+  /**
+   * Resolves a message containing `<tag>chunks</tag>` markup into a string,
+   * mapping each tag through the matching string renderer in `values`.
+   */
+  markup: (key: string, values?: Record<string, unknown>) => string;
+};
+type CompatTranslator = ReturnType<typeof createNamespaceTranslator>;
+//#endregion
+export { CompatTranslator, MarkupChunkRenderer, RichChunkRenderer, createNamespaceTranslator, navigatePath };
+//# sourceMappingURL=namespaceTranslator.d.ts.map

package/dist/types/shared/namespaceTranslator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaceTranslator.d.ts","names":[],"sources":["../../../src/shared/namespaceTranslator.tsx"],"mappings":";;;;;;KAeY,iBAAA,IAAqB,MAAA,EAAQ,SAAA,KAAc,SAAA;AAAvD;AAAA,KAGY,mBAAA,IAAuB,MAAA;;;;;;;;cAStB,YAAA,GAAgB,WAAA,WAAsB,IAAA;;;;;AAAnD;;;;;AAwGA;;;;;;;cAAa,yBAAA,GACX,MAAA,EAAQ,aAAA,EACR,SAAA,gBAAkB,GAAA,UAyDY,MAAA,GAAW,aAAA;EAyBF,8FAnF/B;;EACR;;;;sBAuEoB,MAAA,GAAW,MAAA,sBAA0B,SAAA;;;;;wBAWnC,MAAA,GAAW,MAAA;AAAA;AAAA,KASvB,gBAAA,GAAmB,UAAA,QAAkB,yBAAA"}

package/dist/types/shared/translateFunctionTypes.d.ts

@@ -0,0 +1,34 @@
+import { MarkupChunkRenderer, RichChunkRenderer } from "./namespaceTranslator.js";
+import { DictionaryKeys } from "@intlayer/types/module_augmentation";
+import { ReactNode } from "react";
+import { ValidDotPathsFor } from "@intlayer/core/transpiler";
+
+//#region src/shared/translateFunctionTypes.d.ts
+/**
+ * The translation function returned for a bare dictionary key namespace.
+ *
+ * `key` is validated against the dictionary's dot-paths. Beyond the call
+ * signature, the function exposes:
+ * - `has(key)` — returns `true` when the key exists in the namespace.
+ * - `raw(key)` — returns the unprocessed content value.
+ * - `rich(key, values)` — resolves `<tag>chunks</tag>` markup to React nodes.
+ * - `markup(key, values)` — resolves `<tag>chunks</tag>` markup to a string.
+ */
+type TranslateFunction<N extends DictionaryKeys> = {
+  /** Translate a key to a string, with optional ICU interpolation params. */<P extends ValidDotPathsFor<N>>(key: P, params?: Record<string, unknown>): string; /** Returns `true` if the given key exists in the namespace. */
+  has<P extends ValidDotPathsFor<N>>(key: P): boolean; /** Returns the raw unprocessed content for the given key. */
+  raw<P extends ValidDotPathsFor<N>>(key: P): unknown; /** Resolves rich-text markup, mapping tags through React renderers. */
+  rich<P extends ValidDotPathsFor<N>>(key: P, values?: Record<string, RichChunkRenderer | ReactNode>): ReactNode; /** Resolves rich-text markup, mapping tags through string renderers. */
+  markup<P extends ValidDotPathsFor<N>>(key: P, values?: Record<string, MarkupChunkRenderer | string | number>): string;
+};
+/** Loosely-typed function returned for nested `'dict.scope'` namespaces. */
+type LooseTranslateFunction = {
+  (key: string, params?: Record<string, unknown>): string;
+  has(key: string): boolean;
+  raw(key: string): unknown;
+  rich(key: string, values?: Record<string, RichChunkRenderer | ReactNode>): ReactNode;
+  markup(key: string, values?: Record<string, MarkupChunkRenderer | string | number>): string;
+};
+//#endregion
+export { LooseTranslateFunction, TranslateFunction };
+//# sourceMappingURL=translateFunctionTypes.d.ts.map

package/dist/types/shared/translateFunctionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"translateFunctionTypes.d.ts","names":[],"sources":["../../../src/shared/translateFunctionTypes.ts"],"mappings":";;;;;;;;AAkBA;;;;;;;;KAAY,iBAAA,WAA4B,cAAA;EAOxB,sFALH,gBAAA,CAAiB,CAAA,GAC1B,GAAA,EAAK,CAAA,EACL,MAAA,GAAS,MAAA,4BAKoB;EAF/B,GAAA,WAAc,gBAAA,CAAiB,CAAA,GAAI,GAAA,EAAK,CAAA,YAEA;EAAxC,GAAA,WAAc,gBAAA,CAAiB,CAAA,GAAI,GAAA,EAAK,CAAA,YAEzB;EAAf,IAAA,WAAe,gBAAA,CAAiB,CAAA,GAC9B,GAAA,EAAK,CAAA,EACL,MAAA,GAAS,MAAA,SAAe,iBAAA,GAAoB,SAAA,IAC3C,SAAA,EADuB;EAG1B,MAAA,WAAiB,gBAAA,CAAiB,CAAA,GAChC,GAAA,EAAK,CAAA,EACL,MAAA,GAAS,MAAA,SAAe,mBAAA;AAAA;;KAKhB,sBAAA;EAAA,CACT,GAAA,UAAa,MAAA,GAAS,MAAA;EACvB,GAAA,CAAI,GAAA;EACJ,GAAA,CAAI,GAAA;EACJ,IAAA,CACE,GAAA,UACA,MAAA,GAAS,MAAA,SAAe,iBAAA,GAAoB,SAAA,IAC3C,SAAA;EACH,MAAA,CACE,GAAA,UACA,MAAA,GAAS,MAAA,SAAe,mBAAA;AAAA"}

package/dist/types/useDictionary.d.ts

@@ -0,0 +1,23 @@
+import { ValidDotPathsFor } from "@intlayer/core/transpiler";
+import { Dictionary } from "@intlayer/types/dictionary";
+
+//#region src/useDictionary.d.ts
+/**
+ * Dictionary-accepting variant of `useTranslations`.
+ *
+ * Used internally by the build-time optimization: instead of looking up the
+ * dictionary at runtime by key, the babel/swc plugin pre-imports the dictionary
+ * JSON at build time and passes it directly here. This enables tree-shaking of
+ * unused locale content.
+ *
+ * @example (generated by the plugin, not written manually)
+ * import _abc from '.intlayer/dictionaries/about.json' with { type: 'json' };
+ * const t = useDictionary(_abc);
+ */
+declare const useDictionary: <T extends Dictionary>(dictionary: T, namespacePrefix?: string) => (<P extends ValidDotPathsFor<string>>(lookup: P, params?: Record<string, unknown>) => string) & {
+  has: <P extends ValidDotPathsFor<string>>(lookup: P) => boolean;
+  raw: <P extends ValidDotPathsFor<string>>(lookup: P) => unknown;
+};
+//#endregion
+export { useDictionary };
+//# sourceMappingURL=useDictionary.d.ts.map

package/dist/types/useDictionary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDictionary.d.ts","names":[],"sources":["../../src/useDictionary.ts"],"mappings":";;;;;;AAmBA;;;;;;;;;;cAAa,aAAA,aAA2B,UAAA,EACtC,UAAA,EAAY,CAAA,EACZ,eAAA,0BAQa,gBAAA,UAAwB,MAAA,EACzB,CAAA,EAAC,MAAA,GACA,MAAA;kBAUO,gBAAA,UAAwB,MAAA,EAAU,CAAA;kBAElC,gBAAA,UAAwB,MAAA,EAAU,CAAA;AAAA"}

package/dist/types/useDictionaryDynamic.d.ts

@@ -0,0 +1,18 @@
+import { StrictModeLocaleMap } from "@intlayer/types/module_augmentation";
+import { ValidDotPathsFor } from "@intlayer/core/transpiler";
+import { Dictionary } from "@intlayer/types/dictionary";
+
+//#region src/useDictionaryDynamic.d.ts
+/**
+ * Dynamic dictionary-accepting variant of `useTranslations`.
+ *
+ * Counterpart to {@link useDictionary} for dictionaries imported lazily per
+ * locale. Used internally by the build-time optimization.
+ */
+declare const useDictionaryDynamic: <const T extends Dictionary, const K extends string>(dictionaryPromise: StrictModeLocaleMap<() => Promise<T>>, key: K, namespacePrefix?: string) => (<P extends ValidDotPathsFor<string>>(lookup: P, params?: Record<string, unknown>) => string) & {
+  has: <P extends ValidDotPathsFor<string>>(lookup: P) => boolean;
+  raw: <P extends ValidDotPathsFor<string>>(lookup: P) => unknown;
+};
+//#endregion
+export { useDictionaryDynamic };
+//# sourceMappingURL=useDictionaryDynamic.d.ts.map

package/dist/types/useDictionaryDynamic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDictionaryDynamic.d.ts","names":[],"sources":["../../src/useDictionaryDynamic.ts"],"mappings":";;;;;;;AAcA;;;;cAAa,oBAAA,mBACK,UAAA,0BAGhB,iBAAA,EAAmB,mBAAA,OAA0B,OAAA,CAAQ,CAAA,IACrD,GAAA,EAAK,CAAA,EACL,eAAA,0BAQa,gBAAA,UAAwB,MAAA,EACzB,CAAA,EAAC,MAAA,GACA,MAAA;kBAUO,gBAAA,UAAwB,MAAA,EAAU,CAAA;kBAElC,gBAAA,UAAwB,MAAA,EAAU,CAAA;AAAA"}

package/package.json

@@ -0,0 +1,127 @@
+{
+  "name": "@intlayer/use-intl",
+  "version": "9.0.0-canary.10",
+  "private": false,
+  "description": "use-intl API adapter for intlayer — useTranslations, useLocale, useFormatter, IntlProvider, createTranslator backed by react-intlayer",
+  "keywords": [
+    "intlayer",
+    "use-intl",
+    "react",
+    "i18n",
+    "adapter",
+    "compatibility"
+  ],
+  "homepage": "https://intlayer.org",
+  "bugs": {
+    "url": "https://github.com/aymericzip/intlayer/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aymericzip/intlayer.git"
+  },
+  "license": "Apache-2.0",
+  "author": {
+    "name": "Aymeric PINEAU",
+    "url": "https://github.com/aymericzip"
+  },
+  "contributors": [
+    {
+      "name": "Aymeric Pineau",
+      "email": "ay.pineau@gmail.com",
+      "url": "https://github.com/aymericzip"
+    }
+  ],
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.mjs"
+    },
+    "./core": {
+      "types": "./dist/types/core/index.d.ts",
+      "import": "./dist/esm/core/index.mjs"
+    },
+    "./react": {
+      "types": "./dist/types/client/index.d.ts",
+      "import": "./dist/esm/client/index.mjs"
+    },
+    "./plugin": {
+      "types": "./dist/types/plugin/index.d.ts",
+      "import": "./dist/esm/plugin/index.mjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "dist/esm/index.mjs",
+  "module": "dist/esm/index.mjs",
+  "types": "dist/types/index.d.ts",
+  "typesVersions": {
+    "*": {
+      "core": [
+        "./dist/types/core/index.d.ts"
+      ],
+      "react": [
+        "./dist/types/client/index.d.ts"
+      ],
+      "plugin": [
+        "./dist/types/plugin/index.d.ts"
+      ]
+    }
+  },
+  "files": [
+    "./dist",
+    "./package.json"
+  ],
+  "scripts": {
+    "build": "bun --bun tsdown --config tsdown.config.ts",
+    "build:ci": "bun --bun tsdown --config tsdown.config.ts",
+    "clean": "bun --bun rimraf ./dist .turbo",
+    "dev": "bun --bun tsdown --config tsdown.config.ts --watch",
+    "format": "bun --bun biome format . --check",
+    "format:fix": "bun --bun biome format --write .",
+    "lint": "bun --bun biome lint .",
+    "lint:fix": "bun --bun biome lint --write .",
+    "prepublish": "cp -f ../../README.md ./README.md",
+    "publish": "bun publish || true",
+    "publish:canary": "bun publish --access public --tag canary || true",
+    "publish:latest": "bun publish --access public --tag latest || true",
+    "test": "bun --bun vitest run",
+    "test:watch": "bun --bun vitest",
+    "typecheck": "tsc --noEmit --project tsconfig.types.json"
+  },
+  "dependencies": {
+    "@intlayer/chokidar": "9.0.0-canary.10",
+    "@intlayer/config": "9.0.0-canary.10",
+    "@intlayer/core": "9.0.0-canary.10",
+    "@intlayer/dictionaries-entry": "9.0.0-canary.10",
+    "@intlayer/types": "9.0.0-canary.10",
+    "react-intlayer": "9.0.0-canary.10",
+    "vite-intlayer": "9.0.0-canary.10"
+  },
+  "devDependencies": {
+    "@types/node": "25.9.4",
+    "@types/react": "19.2.17",
+    "@utils/ts-config": "1.0.4",
+    "@utils/ts-config-types": "1.0.4",
+    "@utils/tsdown-config": "1.0.4",
+    "rimraf": "6.1.3",
+    "tsdown": "0.21.10",
+    "typescript": "6.0.3",
+    "use-intl": "4.13.0",
+    "vite": "8.1.0",
+    "vitest": "4.1.9"
+  },
+  "peerDependencies": {
+    "react": ">=16.0.0",
+    "react-dom": ">=16.0.0",
+    "use-intl": ">=3.0.0",
+    "vite": ">=4.0.0"
+  },
+  "peerDependenciesMeta": {
+    "vite": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=14.18"
+  }
+}