@fluixi/core 1.0.0-alpha.100

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

@@ -0,0 +1,44 @@
+"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,
+  env: () => env,
+  isClient: () => isClient,
+  isServer: () => import_dom.isServer
+});
+module.exports = __toCommonJS(index_exports);
+var import_dom = require("@fluixi/dom");
+var import_dom2 = require("@fluixi/dom");
+function isClient() {
+  return !(0, import_dom2.isServer)();
+}
+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

@@ -0,0 +1,26 @@
+/**
+ * Universal environment utilities, the same imports work on the server and the
+ * client, so app code never reaches for raw globals (`window`, `document`) that don't
+ * exist under SSR and crash at module-eval time. Storage is `@fluixi/core/storage`.
+ */
+export { isServer } from '@fluixi/dom';
+/** True in a browser (or jsdom) environment. */
+export declare function isClient(): boolean;
+/**
+ * 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.
+ */
+export declare const env: {
+    readonly window: (Window & typeof globalThis) | undefined;
+    readonly document: Document | undefined;
+};
+/**
+ * Run `fn` only on the client; on the server return `fallback` (or `undefined`).
+ * For values that genuinely don't exist server-side, e.g.
+ * `clientOnly(() => window.innerWidth, 0)`.
+ */
+export declare function clientOnly<T>(fn: () => T): T | undefined;
+export declare function clientOnly<T>(fn: () => T, fallback: T): T;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/env/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGvC,gDAAgD;AAChD,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;;;;GAKG;AACH,eAAO,MAAM,GAAG;qBACA,CAAC,MAAM,GAAG,OAAO,UAAU,CAAC,GAAG,SAAS;uBAGtC,QAAQ,GAAG,SAAS;CAGrC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC;AAC1D,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Universal environment utilities, the same imports work on the server and the
+ * client, so app code never reaches for raw globals (`window`, `document`) that don't
+ * exist under SSR and crash at module-eval time. Storage is `@fluixi/core/storage`.
+ */
+// One answer for the whole framework, from the renderer that decides it. The constant
+// this used to be was read once at module eval, so it could not see renderToString turn
+// server mode on and reported false for the whole of a server render.
+export { isServer } from '@fluixi/dom';
+import { isServer as onServer } from '@fluixi/dom';
+/** True in a browser (or jsdom) environment. */
+export function isClient() {
+    return !onServer();
+}
+/**
+ * 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.
+ */
+export const env = {
+    get window() {
+        return typeof window !== 'undefined' ? window : undefined;
+    },
+    get document() {
+        return typeof document !== 'undefined' ? document : undefined;
+    },
+};
+export function clientOnly(fn, fallback) {
+    return isClient() ? fn() : fallback;
+}

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

@@ -0,0 +1,23 @@
+// src/lib/env/index.ts
+import { isServer } from "@fluixi/dom";
+import { isServer as onServer } from "@fluixi/dom";
+function isClient() {
+  return !onServer();
+}
+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,
+  env,
+  isClient,
+  isServer
+};

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

@@ -0,0 +1,123 @@
+/*! @fluixi/core v1.0.0-alpha.100 | (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 RELATIVE_UNITS = [
+  ["year", 365 * 24 * 3600],
+  ["month", 30 * 24 * 3600],
+  ["week", 7 * 24 * 3600],
+  ["day", 24 * 3600],
+  ["hour", 3600],
+  ["minute", 60],
+  ["second", 1]
+];
+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);
+  const rt = (value, options = {}) => {
+    const { now = Date.now(), ...format } = options;
+    const seconds = (+value - +now) / 1e3;
+    const [unit, size] = RELATIVE_UNITS.find(([, size2]) => Math.abs(seconds) >= size2) ?? ["second", 1];
+    return new Intl.RelativeTimeFormat(locale(), { numeric: "auto", ...format }).format(Math.round(seconds / size), unit);
+  };
+  return { t, n, d, rt, 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

@@ -0,0 +1,110 @@
+/**
+ * @fluixi/core/i18n: built-in, reactive, SSR-correct internationalization.
+ *
+ * Three things make this distinct:
+ *
+ *  1. **SSR request-scoped locale.** The active locale is per-request on the server (kept in the
+ *     RequestContext) and a reactive module signal on the client. Two concurrent SSR requests in
+ *     different languages never bleed, and the server-resolved locale is seeded to the client
+ *     (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,
+ *     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.)
+ *
+ *  3. **Platform-native formatting.** Pluralization via `Intl.PluralRules`, numbers/dates via
+ *     `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;
+ *
+ *     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
+ */
+import { type Accessor } from '@fluixi/reactive/signal';
+/** A leaf message: a plain string, or a plural map keyed by CLDR category (`one`/`other`/...). */
+export type MessageValue = string | {
+    readonly [pluralCategory: string]: string;
+};
+/** A (possibly nested) message tree. */
+export interface Messages {
+    readonly [key: string]: MessageValue | 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.
+ * 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
+ * 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
+ * truncated `nav: { dashboard, settings }` to `'nav'`).
+ */
+export type MessageKey<M> = M extends object ? {
+    [K in keyof M & string]: M[K] extends string ? K : [keyof M[K]] extends [PluralCategory] ? K : M[K] extends object ? `${K}.${MessageKey<M[K]>}` : K;
+}[keyof M & string] : string;
+export interface I18nConfig<L extends string, M extends Record<L, Messages> = Record<L, Messages>> {
+    /** Default / fallback locale. */
+    locale: L;
+    /** Supported locales. */
+    locales: readonly L[];
+    /** Messages per locale (nested; a leaf is a string or a plural map). Keys are inferred for `t`. */
+    messages: M;
+    /** Persist the chosen locale on the client. Default: a year-long `locale` cookie. */
+    persist?: (locale: L) => void;
+}
+export interface RelativeTimeOptions extends Intl.RelativeTimeFormatOptions {
+    /** The moment `value` is relative to. Defaults to the current time. */
+    now?: Date | number;
+}
+export interface I18n<L extends string, K extends string = string> {
+    /** Translate a key (autocompleted from your messages) with optional params; `count` pluralizes. */
+    t: (key: K | (string & {}), params?: Record<string, unknown>) => string;
+    /** Format a number for the active locale (`Intl.NumberFormat`). */
+    n: (value: number, options?: Intl.NumberFormatOptions) => string;
+    /** Format a date for the active locale (`Intl.DateTimeFormat`). */
+    d: (value: Date | number, options?: Intl.DateTimeFormatOptions) => string;
+    /**
+     * A date relative to now, for the active locale (`Intl.RelativeTimeFormat`): "yesterday",
+     * "3 days ago", "in 2 hours". The unit is the largest that fits. Pass `now` when the server
+     * and the client must agree, such as a time the server sent with the data.
+     */
+    rt: (value: Date | number, options?: RelativeTimeOptions) => string;
+    /** 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;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/i18n/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,OAAO,EAAgB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGtE,kGAAkG;AAClG,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG;IAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,CAAC;AAClF,wCAAwC;AACxC,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;CACjD;AAED,+FAA+F;AAC/F,KAAK,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,OAAO,CAAC;AAExE;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,GACxC;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACxC,CAAC,GACD,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,cAAc,CAAC,GACnC,CAAC,GACD,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,GACjB,GAAG,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,GAC1B,CAAC;CACV,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,GACnB,MAAM,CAAC;AAEX,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC;IAC/F,iCAAiC;IACjC,MAAM,EAAE,CAAC,CAAC;IACV,yBAAyB;IACzB,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;IACtB,mGAAmG;IACnG,QAAQ,EAAE,CAAC,CAAC;IACZ,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAAC,yBAAyB;IACzE,uEAAuE;IACvE,GAAG,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CACrB;AAaD,MAAM,WAAW,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IAC/D,mGAAmG;IACnG,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IACxE,mEAAmE;IACnE,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,mBAAmB,KAAK,MAAM,CAAC;IACjE,mEAAmE;IACnE,CAAC,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,qBAAqB,KAAK,MAAM,CAAC;IAC1E;;;;OAIG;IACH,EAAE,EAAE,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,mBAAmB,KAAK,MAAM,CAAC;IACpE,4EAA4E;IAC5E,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACpB,0FAA0F;IAC1F,SAAS,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,IAAI,CAAC;IAC/B,yBAAyB;IACzB,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;CACvB;AAoBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,CAAC,EAAE,QAAQ,CAAC,EAC9E,MAAM,EAAE,UAAU,CAAC,CAAC,EAAE,CAAC,CAAC,GACvB,IAAI,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAwEjC;AAED,yFAAyF;AACzF,wBAAgB,YAAY,CAAC,CAAC,SAAS,MAAM,EAC3C,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACzC,OAAO,EAAE,SAAS,CAAC,EAAE,GACpB,CAAC,GAAG,SAAS,CAef"}

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

@@ -0,0 +1,164 @@
+/**
+ * @fluixi/core/i18n: built-in, reactive, SSR-correct internationalization.
+ *
+ * Three things make this distinct:
+ *
+ *  1. **SSR request-scoped locale.** The active locale is per-request on the server (kept in the
+ *     RequestContext) and a reactive module signal on the client. Two concurrent SSR requests in
+ *     different languages never bleed, and the server-resolved locale is seeded to the client
+ *     (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,
+ *     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.)
+ *
+ *  3. **Platform-native formatting.** Pluralization via `Intl.PluralRules`, numbers/dates via
+ *     `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;
+ *
+ *     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
+ */
+import { createSignal } from '@fluixi/reactive/signal';
+import { getRequestContext, getServerData } from '@fluixi/dom';
+/** Largest first: the first unit the distance reaches is the one shown. */
+const RELATIVE_UNITS = [
+    ['year', 365 * 24 * 3600],
+    ['month', 30 * 24 * 3600],
+    ['week', 7 * 24 * 3600],
+    ['day', 24 * 3600],
+    ['hour', 3600],
+    ['minute', 60],
+    ['second', 1],
+];
+const SEED_KEY = '__i18n:locale';
+const IS_SERVER = typeof document === 'undefined';
+function readSeed() {
+    if (IS_SERVER)
+        return undefined;
+    const data = getServerData();
+    return data ? data[SEED_KEY] : undefined;
+}
+function cookiePersist(locale) {
+    if (typeof document === 'undefined')
+        return;
+    try {
+        document.cookie = `locale=${locale};path=/;max-age=31536000;samesite=lax`;
+    }
+    catch {
+        /* 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).
+    const [clientLocale, setClientLocale] = createSignal(readSeed() ?? config.locale);
+    const serverCtx = () => IS_SERVER ? getRequestContext() : undefined;
+    function locale() {
+        const ctx = serverCtx();
+        if (ctx)
+            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
+            return;
+        }
+        setClientLocale(() => next);
+        persist(next);
+    }
+    function resolve(loc, key) {
+        const bundle = config.messages[loc];
+        if (bundle == null)
+            return undefined;
+        // Flat key first: supports dotted flat keys like `nav.dashboard` (not just nested trees).
+        const flat = bundle[key];
+        if (flat !== undefined)
+            return flat;
+        // Else walk the dot-path through a nested message tree.
+        let node = bundle;
+        for (const part of key.split('.')) {
+            if (node == null || typeof node !== 'object')
+                return undefined;
+            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 === undefined && loc !== config.locale)
+            msg = resolve(config.locale, key); // fallback locale
+        if (msg === undefined)
+            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);
+            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);
+    const rt = (value, options = {}) => {
+        const { now = Date.now(), ...format } = options;
+        const seconds = (+value - +now) / 1000;
+        const [unit, size] = RELATIVE_UNITS.find(([, size]) => Math.abs(seconds) >= size) ?? ['second', 1];
+        return new Intl.RelativeTimeFormat(locale(), { numeric: 'auto', ...format }).format(Math.round(seconds / size), unit);
+    };
+    return { t, n, d, rt, locale, setLocale, locales: config.locales };
+}
+/** Pick the best supported locale from an `Accept-Language` header, else `undefined`. */
+export function detectLocale(acceptLanguage, locales) {
+    if (!acceptLanguage)
+        return undefined;
+    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 undefined;
+}

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

@@ -0,0 +1,103 @@
+/*! @fluixi/core v1.0.0-alpha.100 | (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 RELATIVE_UNITS = [
+  ["year", 365 * 24 * 3600],
+  ["month", 30 * 24 * 3600],
+  ["week", 7 * 24 * 3600],
+  ["day", 24 * 3600],
+  ["hour", 3600],
+  ["minute", 60],
+  ["second", 1]
+];
+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);
+  const rt = (value, options = {}) => {
+    const { now = Date.now(), ...format } = options;
+    const seconds = (+value - +now) / 1e3;
+    const [unit, size] = RELATIVE_UNITS.find(([, size2]) => Math.abs(seconds) >= size2) ?? ["second", 1];
+    return new Intl.RelativeTimeFormat(locale(), { numeric: "auto", ...format }).format(Math.round(seconds / size), unit);
+  };
+  return { t, n, d, rt, 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
+};