@fluixi/core 1.0.0-alpha.83 → 1.0.0-alpha.84

package/dist/src/lib/env/index.cjs

@@ -1 +1,60 @@
-"use strict";var r=Object.defineProperty;var c=Object.getOwnPropertyDescriptor;var a=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var s=(n,e)=>{for(var t in e)r(n,t,{get:e[t],enumerable:!0})},m=(n,e,t,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of a(e))!g.call(n,o)&&o!==t&&r(n,o,{get:()=>e[o],enumerable:!(i=c(e,o))||i.enumerable});return n};var p=n=>m(r({},"__esModule",{value:!0}),n);var w={};s(w,{clientOnly:()=>S,createMemoryStorage:()=>f,env:()=>y,isClient:()=>u,isServer:()=>l.isServer,storage:()=>T});module.exports=p(w);var l=require("@fluixi/dom"),d=require("@fluixi/dom");function u(){return!(0,d.isServer)()}function f(){let n=new Map;return{getItem:e=>n.has(e)?n.get(e):null,setItem:(e,t)=>{n.set(e,String(t))},removeItem:e=>{n.delete(e)},clear:()=>n.clear(),key:e=>Array.from(n.keys())[e]??null,get length(){return n.size}}}var T=typeof localStorage<"u"?localStorage:f(),y={get window(){return typeof window<"u"?window:void 0},get document(){return typeof document<"u"?document:void 0}};function S(n,e){return u()?n():e}
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/env/index.ts
+var index_exports = {};
+__export(index_exports, {
+  clientOnly: () => clientOnly,
+  createMemoryStorage: () => createMemoryStorage,
+  env: () => env,
+  isClient: () => isClient,
+  isServer: () => import_dom.isServer,
+  storage: () => storage
+});
+module.exports = __toCommonJS(index_exports);
+var import_dom = require("@fluixi/dom");
+var import_dom2 = require("@fluixi/dom");
+function isClient() {
+  return !(0, import_dom2.isServer)();
+}
+function createMemoryStorage() {
+  const mem = /* @__PURE__ */ new Map();
+  return {
+    getItem: (k) => mem.has(k) ? mem.get(k) : null,
+    setItem: (k, v) => void mem.set(k, String(v)),
+    removeItem: (k) => void mem.delete(k),
+    clear: () => mem.clear(),
+    key: (i) => Array.from(mem.keys())[i] ?? null,
+    get length() {
+      return mem.size;
+    }
+  };
+}
+var storage = typeof localStorage !== "undefined" ? localStorage : createMemoryStorage();
+var env = {
+  get window() {
+    return typeof window !== "undefined" ? window : void 0;
+  },
+  get document() {
+    return typeof document !== "undefined" ? document : void 0;
+  }
+};
+function clientOnly(fn, fallback) {
+  return isClient() ? fn() : fallback;
+}

package/dist/src/lib/env/index.d.ts

@@ -1,8 +1,8 @@
 /**
- * Universal environment utilities — the same imports work on the server and the
+ * Universal environment utilities, the same imports work on the server and the
  * client, so app code never reaches for raw globals (`localStorage`, `window`,
  * `document`) that don't exist under SSR and crash at module-eval time. This
- * replaces hand-rolled `globalThis.localStorage = …` shims and scattered
+ * replaces hand-rolled `globalThis.localStorage = ...` shims and scattered
  * `typeof window === 'undefined'` guards.
  */
 export { isServer } from '@fluixi/dom';
@@ -12,7 +12,7 @@ export declare function isClient(): boolean;
 export declare function createMemoryStorage(): Storage;
 /**
  * Universal key/value storage with the exact `localStorage` API. On the client it
- * IS `localStorage`; on the server (no DOM) it is an ephemeral in-memory store, so
+ * is `localStorage`; on the server (no DOM) it is an ephemeral in-memory store, so
  * a module that reads `storage.getItem(...)` at import time never crashes under SSR.
  * Server reads/writes do not persist across requests (a later pass can back them with
  * the request cookie for true per-user server state).
@@ -21,8 +21,8 @@ export declare const storage: Storage;
 /**
  * Lazy, typed accessors for the browser globals. They return the real object on the
  * client and `undefined` on the server, so `env.window?.matchMedia(...)` is safe and
- * typed everywhere. Deliberately NOT faked on the server: a stub `location`/`innerWidth`
- * would return wrong values and cause hydration mismatches — guard with `?.` instead.
+ * typed everywhere. Deliberately not faked on the server: a stub `location`/`innerWidth`
+ * would return wrong values and cause hydration mismatches: guard with `?.` instead.
  */
 export declare const env: {
     readonly window: (Window & typeof globalThis) | undefined;

package/dist/src/lib/env/index.js

@@ -1,8 +1,8 @@
 /**
- * Universal environment utilities — the same imports work on the server and the
+ * Universal environment utilities, the same imports work on the server and the
  * client, so app code never reaches for raw globals (`localStorage`, `window`,
  * `document`) that don't exist under SSR and crash at module-eval time. This
- * replaces hand-rolled `globalThis.localStorage = …` shims and scattered
+ * replaces hand-rolled `globalThis.localStorage = ...` shims and scattered
  * `typeof window === 'undefined'` guards.
  */
 // One answer for the whole framework, from the renderer that decides it. The constant
@@ -30,7 +30,7 @@ export function createMemoryStorage() {
 }
 /**
  * Universal key/value storage with the exact `localStorage` API. On the client it
- * IS `localStorage`; on the server (no DOM) it is an ephemeral in-memory store, so
+ * is `localStorage`; on the server (no DOM) it is an ephemeral in-memory store, so
  * a module that reads `storage.getItem(...)` at import time never crashes under SSR.
  * Server reads/writes do not persist across requests (a later pass can back them with
  * the request cookie for true per-user server state).
@@ -39,8 +39,8 @@ export const storage = typeof localStorage !== 'undefined' ? localStorage : crea
 /**
  * Lazy, typed accessors for the browser globals. They return the real object on the
  * client and `undefined` on the server, so `env.window?.matchMedia(...)` is safe and
- * typed everywhere. Deliberately NOT faked on the server: a stub `location`/`innerWidth`
- * would return wrong values and cause hydration mismatches — guard with `?.` instead.
+ * typed everywhere. Deliberately not faked on the server: a stub `location`/`innerWidth`
+ * would return wrong values and cause hydration mismatches: guard with `?.` instead.
  */
 export const env = {
     get window() {

package/dist/src/lib/env/index.mjs

@@ -1 +1,39 @@
-import{isServer as g}from"@fluixi/dom";import{isServer as o}from"@fluixi/dom";function r(){return!o()}function i(){let n=new Map;return{getItem:e=>n.has(e)?n.get(e):null,setItem:(e,t)=>{n.set(e,String(t))},removeItem:e=>{n.delete(e)},clear:()=>n.clear(),key:e=>Array.from(n.keys())[e]??null,get length(){return n.size}}}var u=typeof localStorage<"u"?localStorage:i(),f={get window(){return typeof window<"u"?window:void 0},get document(){return typeof document<"u"?document:void 0}};function l(n,e){return r()?n():e}export{l as clientOnly,i as createMemoryStorage,f as env,r as isClient,g as isServer,u as storage};
+// src/lib/env/index.ts
+import { isServer } from "@fluixi/dom";
+import { isServer as onServer } from "@fluixi/dom";
+function isClient() {
+  return !onServer();
+}
+function createMemoryStorage() {
+  const mem = /* @__PURE__ */ new Map();
+  return {
+    getItem: (k) => mem.has(k) ? mem.get(k) : null,
+    setItem: (k, v) => void mem.set(k, String(v)),
+    removeItem: (k) => void mem.delete(k),
+    clear: () => mem.clear(),
+    key: (i) => Array.from(mem.keys())[i] ?? null,
+    get length() {
+      return mem.size;
+    }
+  };
+}
+var storage = typeof localStorage !== "undefined" ? localStorage : createMemoryStorage();
+var env = {
+  get window() {
+    return typeof window !== "undefined" ? window : void 0;
+  },
+  get document() {
+    return typeof document !== "undefined" ? document : void 0;
+  }
+};
+function clientOnly(fn, fallback) {
+  return isClient() ? fn() : fallback;
+}
+export {
+  clientOnly,
+  createMemoryStorage,
+  env,
+  isClient,
+  isServer,
+  storage
+};

package/dist/src/lib/i18n/index.cjs

@@ -1 +1,108 @@
-"use strict";var L=Object.defineProperty;var K=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var R=Object.prototype.hasOwnProperty;var k=(e,o)=>{for(var l in o)L(e,l,{get:o[l],enumerable:!0})},v=(e,o,l,i)=>{if(o&&typeof o=="object"||typeof o=="function")for(let s of I(o))!R.call(e,s)&&s!==l&&L(e,s,{get:()=>o[s],enumerable:!(i=K(o,s))||i.enumerable});return e};var C=e=>v(L({},"__esModule",{value:!0}),e);var h={};k(h,{createI18n:()=>F,detectLocale:()=>S});module.exports=C(h);var M=require("@fluixi/reactive/signal"),f=require("@fluixi/dom"),y="__i18n:locale",x=typeof document>"u";function _(){if(x)return;let e=(0,f.getServerData)();return e?e[y]:void 0}function D(e){if(!(typeof document>"u"))try{document.cookie=`locale=${e};path=/;max-age=31536000;samesite=lax`}catch{}}function F(e){let o=e.persist??D,[l,i]=(0,M.createSignal)(_()??e.locale),s=()=>x?(0,f.getRequestContext)():void 0;function a(){let n=s();return n?n.__i18nLocale??e.locale:l()}function d(n){let t=s();if(t){t.__i18nLocale=n,t.data?.set?.(y,n);return}i(()=>n),o(n)}function p(n,t){let c=e.messages[n];if(c==null)return;let r=c[t];if(r!==void 0)return r;let u=c;for(let g of t.split(".")){if(u==null||typeof u!="object")return;u=u[g]}return u}function m(n,t){return t?n.replace(/\{(\w+)\}/g,(c,r)=>r in t?String(t[r]):`{${r}}`):n}function w(n,t){let c=a(),r=p(c,n);if(r===void 0&&c!==e.locale&&(r=p(e.locale,n)),r===void 0)return n;if(typeof r!="string"){let u=Number(t?.count??0),g=new Intl.PluralRules(c).select(u),b=r[g]??r.other??Object.values(r)[0]??"";return m(b,t)}return m(r,t)}return{t:w,n:(n,t)=>new Intl.NumberFormat(a(),t).format(n),d:(n,t)=>new Intl.DateTimeFormat(a(),t).format(n),locale:a,setLocale:d,locales:e.locales}}function S(e,o){if(!e)return;let l=e.split(",").map(i=>{let[s,a]=i.trim().split(";q=");return{tag:s.toLowerCase(),q:a?parseFloat(a):1}}).sort((i,s)=>s.q-i.q);for(let{tag:i}of l){let s=i.split("-")[0],a=o.find(d=>d.toLowerCase()===i||d.toLowerCase()===s);if(a)return a}}
+/*! @fluixi/core v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/i18n/index.ts
+var index_exports = {};
+__export(index_exports, {
+  createI18n: () => createI18n,
+  detectLocale: () => detectLocale
+});
+module.exports = __toCommonJS(index_exports);
+var import_signal = require("@fluixi/reactive/signal");
+var import_dom = require("@fluixi/dom");
+var SEED_KEY = "__i18n:locale";
+var IS_SERVER = typeof document === "undefined";
+function readSeed() {
+  if (IS_SERVER) return void 0;
+  const data = (0, import_dom.getServerData)();
+  return data ? data[SEED_KEY] : void 0;
+}
+function cookiePersist(locale) {
+  if (typeof document === "undefined") return;
+  try {
+    document.cookie = `locale=${locale};path=/;max-age=31536000;samesite=lax`;
+  } catch {
+  }
+}
+function createI18n(config) {
+  const persist = config.persist ?? cookiePersist;
+  const [clientLocale, setClientLocale] = (0, import_signal.createSignal)(readSeed() ?? config.locale);
+  const serverCtx = () => IS_SERVER ? (0, import_dom.getRequestContext)() : void 0;
+  function locale() {
+    const ctx = serverCtx();
+    if (ctx) return ctx.__i18nLocale ?? config.locale;
+    return clientLocale();
+  }
+  function setLocale(next) {
+    const ctx = serverCtx();
+    if (ctx) {
+      ctx.__i18nLocale = next;
+      ctx.data?.set?.(SEED_KEY, next);
+      return;
+    }
+    setClientLocale(() => next);
+    persist(next);
+  }
+  function resolve(loc, key) {
+    const bundle = config.messages[loc];
+    if (bundle == null) return void 0;
+    const flat = bundle[key];
+    if (flat !== void 0) return flat;
+    let node = bundle;
+    for (const part of key.split(".")) {
+      if (node == null || typeof node !== "object") return void 0;
+      node = node[part];
+    }
+    return node;
+  }
+  function interpolate(str, params) {
+    if (!params) return str;
+    return str.replace(/\{(\w+)\}/g, (_m, k) => k in params ? String(params[k]) : `{${k}}`);
+  }
+  function t(key, params) {
+    const loc = locale();
+    let msg = resolve(loc, key);
+    if (msg === void 0 && loc !== config.locale) msg = resolve(config.locale, key);
+    if (msg === void 0) return key;
+    if (typeof msg !== "string") {
+      const count = Number(params?.count ?? 0);
+      const category = new Intl.PluralRules(loc).select(count);
+      const branch = msg[category] ?? msg.other ?? Object.values(msg)[0] ?? "";
+      return interpolate(branch, params);
+    }
+    return interpolate(msg, params);
+  }
+  const n = (value, options) => new Intl.NumberFormat(locale(), options).format(value);
+  const d = (value, options) => new Intl.DateTimeFormat(locale(), options).format(value);
+  return { t, n, d, locale, setLocale, locales: config.locales };
+}
+function detectLocale(acceptLanguage, locales) {
+  if (!acceptLanguage) return void 0;
+  const ranked = acceptLanguage.split(",").map((part) => {
+    const [tag, q] = part.trim().split(";q=");
+    return { tag: tag.toLowerCase(), q: q ? parseFloat(q) : 1 };
+  }).sort((a, b) => b.q - a.q);
+  for (const { tag } of ranked) {
+    const base = tag.split("-")[0];
+    const hit = locales.find((l) => l.toLowerCase() === tag || l.toLowerCase() === base);
+    if (hit) return hit;
+  }
+  return void 0;
+}

package/dist/src/lib/i18n/index.d.ts

@@ -1,5 +1,5 @@
 /**
- * @fluixi/core/i18n — built-in, reactive, SSR-correct internationalization.
+ * @fluixi/core/i18n: built-in, reactive, SSR-correct internationalization.
  *
  * Three things make this distinct:
  *
@@ -9,12 +9,12 @@
  *     (no flash, no hydration mismatch).
  *
  *  2. **No reactive-owner-context dependency.** `t()` reads the locale from the request context /
- *     module signal — NOT `useContext` — so it resolves in lazy routes, server functions, loaders,
+ *     module signal, not `useContext`, so it resolves in lazy routes, server functions, loaders,
  *     anywhere. (This is precisely why it sidesteps the classic "useLocale() is undefined under
- *     SSR on a lazy route" failure — there's no provider owner-chain to lose.)
+ *     SSR on a lazy route" failure: there's no provider owner-chain to lose.)
  *
  *  3. **Platform-native formatting.** Pluralization via `Intl.PluralRules`, numbers/dates via
- *     `Intl.NumberFormat`/`Intl.DateTimeFormat` — correct CLDR rules, zero dependencies.
+ *     `Intl.NumberFormat`/`Intl.DateTimeFormat`: correct CLDR rules, zero dependencies.
  *
  *     const i18n = createI18n({ locale: 'en', locales: ['en', 'fr'] as const, messages: { en, fr } });
  *     export const { t, n, d, locale, setLocale } = i18n;
@@ -22,10 +22,10 @@
  *     t('welcome', { name: 'Ada' })   // "Welcome, Ada"
  *     t('cart.items', { count: 3 })   // plural branch via Intl.PluralRules
  *     n(1234.5);  d(new Date());      // locale-aware number/date
- *     setLocale('fr');                // reactive — every t() re-evaluates
+ *     setLocale('fr');                // reactive, every t() re-evaluates
  */
 import { type Accessor } from '@fluixi/reactive/signal';
-/** A leaf message: a plain string, or a plural map keyed by CLDR category (`one`/`other`/…). */
+/** A leaf message: a plain string, or a plural map keyed by CLDR category (`one`/`other`/...). */
 export type MessageValue = string | {
     readonly [pluralCategory: string]: string;
 };
@@ -36,13 +36,13 @@ export interface Messages {
 /** CLDR plural categories. An object keyed *only* by these is a plural leaf, not a subtree. */
 type PluralCategory = 'zero' | 'one' | 'two' | 'few' | 'many' | 'other';
 /**
- * The union of every valid translation key in `M` — `t()` autocompletes these and flags typos.
+ * The union of every valid translation key in `M`: `t()` autocompletes these and flags typos.
  * Flat keys (`'welcome'`, `'nav.dashboard'`), nested trees (`'cart.items'`, `'nested.deep.key'`),
- * and plural maps (`{ one, other }` → a leaf) all work. Only *leaf* paths are emitted, never the
+ * and plural maps (`{ one, other }` -> a leaf) all work. Only *leaf* paths are emitted, never the
  * intermediate branch (`'nav'`, `'cart'`). Falls open to `string` when `M` is just `Messages`.
  *
  * A subtree and a plural map are both `Record<string, string>` structurally, so the plural leaf is
- * detected by its keys being CLDR categories — not by "all children are strings" (which wrongly
+ * detected by its keys being CLDR categories, not by "all children are strings" (which wrongly
  * truncated `nav: { dashboard, settings }` to `'nav'`).
  */
 export type MessageKey<M> = M extends object ? {
@@ -65,13 +65,34 @@ export interface I18n<L extends string, K extends string = string> {
     n: (value: number, options?: Intl.NumberFormatOptions) => string;
     /** Format a date for the active locale (`Intl.DateTimeFormat`). */
     d: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
-    /** The active locale — reactive on the client, per-request on the server. */
+    /** The active locale: reactive on the client, per-request on the server. */
     locale: Accessor<L>;
     /** Switch the active locale (client: reactive + persisted; server: this request only). */
     setLocale: (locale: L) => void;
     /** Supported locales. */
     locales: readonly L[];
 }
+/**
+ * Translations, with the message keys inferred from the messages themselves.
+ *
+ * `t()` accepts only leaf paths that exist in the catalogue, so a typo is a type error
+ * rather than a string echoed back at a visitor. A missing key at runtime returns the key,
+ * which is visible in the page and traceable.
+ *
+ * The locale is per request on the server and reactive on the client, seeded from what the
+ * server resolved so hydration cannot disagree about the language. Persistence is a cookie
+ * by default, which is the only store a server render can read.
+ *
+ * @example
+ * ```ts
+ * const i18n = createI18n({
+ *   locale: 'en',
+ *   messages: { en: { hi: 'Hello' }, fr: { hi: 'Bonjour' } },
+ * });
+ * i18n.t('hi');        // 'Hello'
+ * i18n.setLocale('fr');
+ * ```
+ */
 export declare function createI18n<L extends string, const M extends Record<L, Messages>>(config: I18nConfig<L, M>): I18n<L, MessageKey<M[keyof M]>>;
 /** Pick the best supported locale from an `Accept-Language` header, else `undefined`. */
 export declare function detectLocale<L extends string>(acceptLanguage: string | null | undefined, locales: readonly L[]): L | undefined;

package/dist/src/lib/i18n/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/i18n/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/i18n/index.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/i18n/index.js

@@ -1,5 +1,5 @@
 /**
- * @fluixi/core/i18n — built-in, reactive, SSR-correct internationalization.
+ * @fluixi/core/i18n: built-in, reactive, SSR-correct internationalization.
  *
  * Three things make this distinct:
  *
@@ -9,12 +9,12 @@
  *     (no flash, no hydration mismatch).
  *
  *  2. **No reactive-owner-context dependency.** `t()` reads the locale from the request context /
- *     module signal — NOT `useContext` — so it resolves in lazy routes, server functions, loaders,
+ *     module signal, not `useContext`, so it resolves in lazy routes, server functions, loaders,
  *     anywhere. (This is precisely why it sidesteps the classic "useLocale() is undefined under
- *     SSR on a lazy route" failure — there's no provider owner-chain to lose.)
+ *     SSR on a lazy route" failure: there's no provider owner-chain to lose.)
  *
  *  3. **Platform-native formatting.** Pluralization via `Intl.PluralRules`, numbers/dates via
- *     `Intl.NumberFormat`/`Intl.DateTimeFormat` — correct CLDR rules, zero dependencies.
+ *     `Intl.NumberFormat`/`Intl.DateTimeFormat`: correct CLDR rules, zero dependencies.
  *
  *     const i18n = createI18n({ locale: 'en', locales: ['en', 'fr'] as const, messages: { en, fr } });
  *     export const { t, n, d, locale, setLocale } = i18n;
@@ -22,7 +22,7 @@
  *     t('welcome', { name: 'Ada' })   // "Welcome, Ada"
  *     t('cart.items', { count: 3 })   // plural branch via Intl.PluralRules
  *     n(1234.5);  d(new Date());      // locale-aware number/date
- *     setLocale('fr');                // reactive — every t() re-evaluates
+ *     setLocale('fr');                // reactive, every t() re-evaluates
  */
 import { createSignal } from '@fluixi/reactive/signal';
 import { getRequestContext, getServerData } from '@fluixi/dom';
@@ -41,9 +41,30 @@ function cookiePersist(locale) {
         document.cookie = `locale=${locale};path=/;max-age=31536000;samesite=lax`;
     }
     catch {
-        /* private mode / disabled — best effort */
+        /* private mode / disabled: best effort */
     }
 }
+/**
+ * Translations, with the message keys inferred from the messages themselves.
+ *
+ * `t()` accepts only leaf paths that exist in the catalogue, so a typo is a type error
+ * rather than a string echoed back at a visitor. A missing key at runtime returns the key,
+ * which is visible in the page and traceable.
+ *
+ * The locale is per request on the server and reactive on the client, seeded from what the
+ * server resolved so hydration cannot disagree about the language. Persistence is a cookie
+ * by default, which is the only store a server render can read.
+ *
+ * @example
+ * ```ts
+ * const i18n = createI18n({
+ *   locale: 'en',
+ *   messages: { en: { hi: 'Hello' }, fr: { hi: 'Bonjour' } },
+ * });
+ * i18n.t('hi');        // 'Hello'
+ * i18n.setLocale('fr');
+ * ```
+ */
 export function createI18n(config) {
     const persist = config.persist ?? cookiePersist;
     // Client: a reactive signal seeded from the server-resolved locale (so hydration matches).
@@ -52,14 +73,14 @@ export function createI18n(config) {
     function locale() {
         const ctx = serverCtx();
         if (ctx)
-            return ctx.__i18nLocale ?? config.locale; // server: per-request, no shared signal → no leak
+            return ctx.__i18nLocale ?? config.locale; // server: per-request, no shared signal -> no leak
         return clientLocale(); // client: reactive
     }
     function setLocale(next) {
         const ctx = serverCtx();
         if (ctx) {
             ctx.__i18nLocale = next;
-            ctx.data?.set?.(SEED_KEY, next); // serialize → client hydrates in the same language
+            ctx.data?.set?.(SEED_KEY, next); // serialize -> client hydrates in the same language
             return;
         }
         setClientLocale(() => next);
@@ -69,7 +90,7 @@ export function createI18n(config) {
         const bundle = config.messages[loc];
         if (bundle == null)
             return undefined;
-        // Flat key first — supports dotted flat keys like `nav.dashboard` (not just nested trees).
+        // Flat key first: supports dotted flat keys like `nav.dashboard` (not just nested trees).
         const flat = bundle[key];
         if (flat !== undefined)
             return flat;
@@ -93,7 +114,7 @@ export function createI18n(config) {
         if (msg === undefined && loc !== config.locale)
             msg = resolve(config.locale, key); // fallback locale
         if (msg === undefined)
-            return key; // missing → echo the key (visible, debuggable)
+            return key; // missing -> echo the key (visible, debuggable)
         if (typeof msg !== 'string') {
             const count = Number(params?.count ?? 0);
             const category = new Intl.PluralRules(loc).select(count);

package/dist/src/lib/i18n/index.mjs

@@ -1 +1,88 @@
-import{createSignal as x}from"@fluixi/reactive/signal";import{getRequestContext as w,getServerData as b}from"@fluixi/dom";var p="__i18n:locale",m=typeof document>"u";function K(){if(m)return;let t=b();return t?t[p]:void 0}function I(t){if(!(typeof document>"u"))try{document.cookie=`locale=${t};path=/;max-age=31536000;samesite=lax`}catch{}}function _(t){let u=t.persist??I,[d,o]=x(K()??t.locale),i=()=>m?w():void 0;function s(){let e=i();return e?e.__i18nLocale??t.locale:d()}function c(e){let n=i();if(n){n.__i18nLocale=e,n.data?.set?.(p,e);return}o(()=>e),u(e)}function g(e,n){let a=t.messages[e];if(a==null)return;let r=a[n];if(r!==void 0)return r;let l=a;for(let f of n.split(".")){if(l==null||typeof l!="object")return;l=l[f]}return l}function L(e,n){return n?e.replace(/\{(\w+)\}/g,(a,r)=>r in n?String(n[r]):`{${r}}`):e}function M(e,n){let a=s(),r=g(a,e);if(r===void 0&&a!==t.locale&&(r=g(t.locale,e)),r===void 0)return e;if(typeof r!="string"){let l=Number(n?.count??0),f=new Intl.PluralRules(a).select(l),y=r[f]??r.other??Object.values(r)[0]??"";return L(y,n)}return L(r,n)}return{t:M,n:(e,n)=>new Intl.NumberFormat(s(),n).format(e),d:(e,n)=>new Intl.DateTimeFormat(s(),n).format(e),locale:s,setLocale:c,locales:t.locales}}function D(t,u){if(!t)return;let d=t.split(",").map(o=>{let[i,s]=o.trim().split(";q=");return{tag:i.toLowerCase(),q:s?parseFloat(s):1}}).sort((o,i)=>i.q-o.q);for(let{tag:o}of d){let i=o.split("-")[0],s=u.find(c=>c.toLowerCase()===o||c.toLowerCase()===i);if(s)return s}}export{_ as createI18n,D as detectLocale};
+/*! @fluixi/core v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+
+// src/lib/i18n/index.ts
+import { createSignal } from "@fluixi/reactive/signal";
+import { getRequestContext, getServerData } from "@fluixi/dom";
+var SEED_KEY = "__i18n:locale";
+var IS_SERVER = typeof document === "undefined";
+function readSeed() {
+  if (IS_SERVER) return void 0;
+  const data = getServerData();
+  return data ? data[SEED_KEY] : void 0;
+}
+function cookiePersist(locale) {
+  if (typeof document === "undefined") return;
+  try {
+    document.cookie = `locale=${locale};path=/;max-age=31536000;samesite=lax`;
+  } catch {
+  }
+}
+function createI18n(config) {
+  const persist = config.persist ?? cookiePersist;
+  const [clientLocale, setClientLocale] = createSignal(readSeed() ?? config.locale);
+  const serverCtx = () => IS_SERVER ? getRequestContext() : void 0;
+  function locale() {
+    const ctx = serverCtx();
+    if (ctx) return ctx.__i18nLocale ?? config.locale;
+    return clientLocale();
+  }
+  function setLocale(next) {
+    const ctx = serverCtx();
+    if (ctx) {
+      ctx.__i18nLocale = next;
+      ctx.data?.set?.(SEED_KEY, next);
+      return;
+    }
+    setClientLocale(() => next);
+    persist(next);
+  }
+  function resolve(loc, key) {
+    const bundle = config.messages[loc];
+    if (bundle == null) return void 0;
+    const flat = bundle[key];
+    if (flat !== void 0) return flat;
+    let node = bundle;
+    for (const part of key.split(".")) {
+      if (node == null || typeof node !== "object") return void 0;
+      node = node[part];
+    }
+    return node;
+  }
+  function interpolate(str, params) {
+    if (!params) return str;
+    return str.replace(/\{(\w+)\}/g, (_m, k) => k in params ? String(params[k]) : `{${k}}`);
+  }
+  function t(key, params) {
+    const loc = locale();
+    let msg = resolve(loc, key);
+    if (msg === void 0 && loc !== config.locale) msg = resolve(config.locale, key);
+    if (msg === void 0) return key;
+    if (typeof msg !== "string") {
+      const count = Number(params?.count ?? 0);
+      const category = new Intl.PluralRules(loc).select(count);
+      const branch = msg[category] ?? msg.other ?? Object.values(msg)[0] ?? "";
+      return interpolate(branch, params);
+    }
+    return interpolate(msg, params);
+  }
+  const n = (value, options) => new Intl.NumberFormat(locale(), options).format(value);
+  const d = (value, options) => new Intl.DateTimeFormat(locale(), options).format(value);
+  return { t, n, d, locale, setLocale, locales: config.locales };
+}
+function detectLocale(acceptLanguage, locales) {
+  if (!acceptLanguage) return void 0;
+  const ranked = acceptLanguage.split(",").map((part) => {
+    const [tag, q] = part.trim().split(";q=");
+    return { tag: tag.toLowerCase(), q: q ? parseFloat(q) : 1 };
+  }).sort((a, b) => b.q - a.q);
+  for (const { tag } of ranked) {
+    const base = tag.split("-")[0];
+    const hit = locales.find((l) => l.toLowerCase() === tag || l.toLowerCase() === base);
+    if (hit) return hit;
+  }
+  return void 0;
+}
+export {
+  createI18n,
+  detectLocale
+};