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

package/dist/src/lib/isomorphic.cjs

@@ -1 +1,85 @@
-"use strict";var f=Object.defineProperty;var p=Object.getOwnPropertyDescriptor;var I=Object.getOwnPropertyNames;var g=Object.prototype.hasOwnProperty;var S=(t,e)=>{for(var s in e)f(t,s,{get:e[s],enumerable:!0})},h=(t,e,s,i)=>{if(e&&typeof e=="object"||typeof e=="function")for(let n of I(e))!g.call(t,n)&&n!==s&&f(t,n,{get:()=>e[n],enumerable:!(i=p(e,n))||i.enumerable});return t};var k=t=>h(f({},"__esModule",{value:!0}),t);var _={};S(_,{createIsomorphicState:()=>v,createIsomorphicStore:()=>P});module.exports=k(_);var a=require("@fluixi/reactive/signal"),T=require("@fluixi/dom"),x="__fluixi_iso_states__",K="__iso:";function b(){return globalThis[x]??=new Map}function u(t){if(typeof window>"u")return;let e=(0,T.getServerData)();return e?e[K+t]:void 0}function v(t,e){let s=u(t),i=s!==void 0?s:typeof window<"u"&&e.client?e.client():e.fallback,[n,o]=(0,a.createSignal)(i);return b().set(t,{server:e.server,set:o}),{value:n,set:o,key:t}}function P(t,e){let s=u(t)!==void 0,i=v(t,{server:e.server,fallback:e.fallback}),n=()=>i.value()??e.fallback,o=r=>{if(!(!e.persist||typeof localStorage>"u"))try{localStorage.setItem(e.persist,JSON.stringify(r))}catch{}},d=r=>{i.set(r),o(r)},m=(r,y)=>{d({...n(),[r]:y})},l={};for(let r of Object.keys(e.fallback))l[r]=(0,a.createMemo)(()=>n()[r]);let c=null;return{value:n,fields:l,set:d,setField:m,ensureInit:()=>s||!e.client?Promise.resolve():(c||(c=Promise.resolve(e.client()).then(r=>{d(r)}).catch(r=>{throw c=null,r})),c),key:t}}
+"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/isomorphic.ts
+var isomorphic_exports = {};
+__export(isomorphic_exports, {
+  createIsomorphicState: () => createIsomorphicState,
+  createIsomorphicStore: () => createIsomorphicStore
+});
+module.exports = __toCommonJS(isomorphic_exports);
+var import_signal = require("@fluixi/reactive/signal");
+var import_dom = require("@fluixi/dom");
+var REGISTRY_KEY = "__fluixi_iso_states__";
+var SEED_PREFIX = "__iso:";
+function registry() {
+  return globalThis[REGISTRY_KEY] ??= /* @__PURE__ */ new Map();
+}
+function readSeed(key) {
+  if (typeof window === "undefined") return void 0;
+  const data = (0, import_dom.getServerData)();
+  return data ? data[SEED_PREFIX + key] : void 0;
+}
+function createIsomorphicState(key, options) {
+  const seed = readSeed(key);
+  const initial = seed !== void 0 ? seed : typeof window !== "undefined" && options.client ? options.client() : options.fallback;
+  const [value, set] = (0, import_signal.createSignal)(initial);
+  registry().set(key, { server: options.server, set });
+  return { value, set, key };
+}
+function createIsomorphicStore(key, options) {
+  const seeded = readSeed(key) !== void 0;
+  const base = createIsomorphicState(key, {
+    server: options.server,
+    fallback: options.fallback
+  });
+  const value = () => base.value() ?? options.fallback;
+  const persistWrite = (v) => {
+    if (!options.persist || typeof localStorage === "undefined") return;
+    try {
+      localStorage.setItem(options.persist, JSON.stringify(v));
+    } catch {
+    }
+  };
+  const set = (v) => {
+    base.set(v);
+    persistWrite(v);
+  };
+  const setField = (k, val) => {
+    set({ ...value(), [k]: val });
+  };
+  const fields = {};
+  for (const k of Object.keys(options.fallback)) {
+    fields[k] = (0, import_signal.createMemo)(() => value()[k]);
+  }
+  let initPromise = null;
+  const ensureInit = () => {
+    if (seeded || !options.client) return Promise.resolve();
+    if (!initPromise) {
+      initPromise = Promise.resolve(options.client()).then((v) => {
+        set(v);
+      }).catch((e) => {
+        initPromise = null;
+        throw e;
+      });
+    }
+    return initPromise;
+  };
+  return { value, fields, set, setField, ensureInit, key };
+}

package/dist/src/lib/isomorphic.d.ts

@@ -1,5 +1,5 @@
 /**
- * Isomorphic request state — the generic form of "ensureInit + transfer".
+ * Isomorphic request state, the generic form of "ensureInit + transfer".
  *
  * A value that is resolved ONCE on the server (per request, before the app renders),
  * serialized into the page, and seeded SYNCHRONOUSLY on the client so the first client
@@ -11,15 +11,15 @@
  * - Client: `createIsomorphicState` reads that seed at creation and starts there.
  *
  * This module is client-safe (no node imports) so app stores can call it on both sides.
- * It talks to @fluixi/server only through a `globalThis` registry — no import edge.
+ * It talks to @fluixi/server only through a `globalThis` registry, no import edge.
  *
  * NOTE (prototype): the signal is module-scoped, so concurrent SSR requests share it.
  * That is fine for a single default value; per-user, per-request isolation wants the
- * request-scoped (AsyncLocalStorage) store — a follow-up.
+ * request-scoped (AsyncLocalStorage) store, a follow-up.
  */
 import { type Accessor } from '@fluixi/reactive/signal';
 export interface IsomorphicState<T> {
-    /** Reactive accessor for the current value (a real signal — safe in JSX/control flow). */
+    /** Reactive accessor for the current value (a real signal: safe in JSX/control flow). */
     value: Accessor<T | undefined>;
     /** Update the value (client-side preference changes, optimistic updates). */
     set: (v: T | undefined) => void;
@@ -27,16 +27,33 @@ export interface IsomorphicState<T> {
     key: string;
 }
 export interface IsomorphicOptions<T> {
-    /** Resolve the value on the server for THIS request (receives the RequestEvent). */
+    /** Resolve the value on the server for this request (receives the RequestEvent). */
     server: (event: any) => T | Promise<T>;
     /** Optional client-only initial value when there is no server seed (pure SPA load). */
     client?: () => T | undefined;
     /** Value before resolution. */
     fallback?: T;
 }
+/**
+ * A value resolved on the server, transferred to the client, and resolvable there too.
+ *
+ * The server resolver runs per request and its result is serialized into the page, so the
+ * client starts with the answer rather than fetching it again. On a cold client load with
+ * no seed, the client resolver runs once instead.
+ *
+ * `key` names the transfer slot and has to be stable across the two sides.
+ *
+ * @example
+ * ```ts
+ * const user = createIsomorphicState('user', {
+ *   server: (event) => event.locals.user,
+ *   client: () => fetch('/api/me').then((r) => r.json()),
+ * });
+ * ```
+ */
 export declare function createIsomorphicState<T>(key: string, options: IsomorphicOptions<T>): IsomorphicState<T>;
 export interface IsomorphicStore<T extends Record<string, any>> {
-    /** Reactive accessor for the whole record (always defined — falls back to `fallback`). */
+    /** Reactive accessor for the whole record (always defined: falls back to `fallback`). */
     value: Accessor<T>;
     /** Per-field reactive accessors, one for every key of `fallback`. */
     fields: {
@@ -48,7 +65,7 @@ export interface IsomorphicStore<T extends Record<string, any>> {
     setField: <K extends keyof T>(key: K, val: T[K]) => void;
     /**
      * Run the async `client` resolver exactly once (memoised; the promise is reset on
-     * failure so a later call can retry). A NO-OP when the value was server-seeded — the
+     * failure so a later call can retry). A no-op when the value was server-seeded, the
      * server already resolved and transferred it, so there is nothing to fetch.
      */
     ensureInit: () => Promise<void>;
@@ -56,7 +73,7 @@ export interface IsomorphicStore<T extends Record<string, any>> {
     key: string;
 }
 export interface IsomorphicStoreOptions<T> {
-    /** Resolve the record on the server for THIS request (receives the RequestEvent). */
+    /** Resolve the record on the server for this request (receives the RequestEvent). */
     server: (event: any) => T | Promise<T>;
     /** Resolve the record on a pure-SPA cold load (no server seed). Run once by ensureInit(). */
     client?: () => T | Promise<T>;
@@ -65,5 +82,21 @@ export interface IsomorphicStoreOptions<T> {
     /** localStorage key to mirror the record into on every write (optional). */
     persist?: string;
 }
+/**
+ * `createIsomorphicState` for a record, exposed as a store rather than a single value.
+ *
+ * Reads track per key, so a component using one field is untouched when another changes.
+ * Otherwise the transfer is the same: the server resolver runs per request, the result is
+ * serialized into the page, and a seeded client does not refetch.
+ *
+ * @example
+ * ```ts
+ * const settings = createIsomorphicStore('settings', {
+ *   server: (event) => loadSettings(event.locals.userId),
+ *   client: () => fetch('/api/settings').then((r) => r.json()),
+ * });
+ * settings.state.theme;   // tracks `theme` alone
+ * ```
+ */
 export declare function createIsomorphicStore<T extends Record<string, any>>(key: string, options: IsomorphicStoreOptions<T>): IsomorphicStore<T>;
 //# sourceMappingURL=isomorphic.d.ts.map

package/dist/src/lib/isomorphic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"isomorphic.d.ts","sourceRoot":"","sources":["../../../src/lib/isomorphic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAA4B,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAelF,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,0FAA0F;IAC1F,KAAK,EAAE,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/B,6EAA6E;IAC7E,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;IAChC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,oFAAoF;IACpF,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC;CACd;AASD,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,eAAe,CAAC,CAAC,CAAC,CAapB;AAkBD,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC5D,0FAA0F;IAC1F,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,qEAAqE;IACrE,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IAC3C,gCAAgC;IAChC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACzD;;;;OAIG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,qFAAqF;IACrF,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B,sFAAsF;IACtF,QAAQ,EAAE,CAAC,CAAC;IACZ,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjE,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACjC,eAAe,CAAC,CAAC,CAAC,CAmDpB"}
+{"version":3,"file":"isomorphic.d.ts","sourceRoot":"","sources":["../../../src/lib/isomorphic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAA4B,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAelF,MAAM,WAAW,eAAe,CAAC,CAAC;IAChC,yFAAyF;IACzF,KAAK,EAAE,QAAQ,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/B,6EAA6E;IAC7E,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,GAAG,SAAS,KAAK,IAAI,CAAC;IAChC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,oFAAoF;IACpF,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,uFAAuF;IACvF,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC7B,+BAA+B;IAC/B,QAAQ,CAAC,EAAE,CAAC,CAAC;CACd;AASD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,EACrC,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAC5B,eAAe,CAAC,CAAC,CAAC,CAapB;AAkBD,MAAM,WAAW,eAAe,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAC5D,yFAAyF;IACzF,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IACnB,qEAAqE;IACrE,MAAM,EAAE;SAAG,CAAC,IAAI,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IAC3C,gCAAgC;IAChC,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC,KAAK,IAAI,CAAC;IACpB,6CAA6C;IAC7C,QAAQ,EAAE,CAAC,CAAC,SAAS,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;IACzD;;;;OAIG;IACH,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,gCAAgC;IAChC,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,sBAAsB,CAAC,CAAC;IACvC,qFAAqF;IACrF,MAAM,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IACvC,6FAA6F;IAC7F,MAAM,CAAC,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;IAC9B,sFAAsF;IACtF,QAAQ,EAAE,CAAC,CAAC;IACZ,4EAA4E;IAC5E,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACjE,GAAG,EAAE,MAAM,EACX,OAAO,EAAE,sBAAsB,CAAC,CAAC,CAAC,GACjC,eAAe,CAAC,CAAC,CAAC,CAmDpB"}

package/dist/src/lib/isomorphic.js

@@ -1,5 +1,5 @@
 /**
- * Isomorphic request state — the generic form of "ensureInit + transfer".
+ * Isomorphic request state, the generic form of "ensureInit + transfer".
  *
  * A value that is resolved ONCE on the server (per request, before the app renders),
  * serialized into the page, and seeded SYNCHRONOUSLY on the client so the first client
@@ -11,11 +11,11 @@
  * - Client: `createIsomorphicState` reads that seed at creation and starts there.
  *
  * This module is client-safe (no node imports) so app stores can call it on both sides.
- * It talks to @fluixi/server only through a `globalThis` registry — no import edge.
+ * It talks to @fluixi/server only through a `globalThis` registry, no import edge.
  *
  * NOTE (prototype): the signal is module-scoped, so concurrent SSR requests share it.
  * That is fine for a single default value; per-user, per-request isolation wants the
- * request-scoped (AsyncLocalStorage) store — a follow-up.
+ * request-scoped (AsyncLocalStorage) store, a follow-up.
  */
 import { createSignal, createMemo } from '@fluixi/reactive/signal';
 import { getServerData } from '@fluixi/dom';
@@ -31,6 +31,23 @@ function readSeed(key) {
     const data = getServerData();
     return data ? data[SEED_PREFIX + key] : undefined;
 }
+/**
+ * A value resolved on the server, transferred to the client, and resolvable there too.
+ *
+ * The server resolver runs per request and its result is serialized into the page, so the
+ * client starts with the answer rather than fetching it again. On a cold client load with
+ * no seed, the client resolver runs once instead.
+ *
+ * `key` names the transfer slot and has to be stable across the two sides.
+ *
+ * @example
+ * ```ts
+ * const user = createIsomorphicState('user', {
+ *   server: (event) => event.locals.user,
+ *   client: () => fetch('/api/me').then((r) => r.json()),
+ * });
+ * ```
+ */
 export function createIsomorphicState(key, options) {
     const seed = readSeed(key);
     const initial = seed !== undefined
@@ -42,8 +59,24 @@ export function createIsomorphicState(key, options) {
     registry().set(key, { server: options.server, set: set });
     return { value, set: set, key };
 }
+/**
+ * `createIsomorphicState` for a record, exposed as a store rather than a single value.
+ *
+ * Reads track per key, so a component using one field is untouched when another changes.
+ * Otherwise the transfer is the same: the server resolver runs per request, the result is
+ * serialized into the page, and a seeded client does not refetch.
+ *
+ * @example
+ * ```ts
+ * const settings = createIsomorphicStore('settings', {
+ *   server: (event) => loadSettings(event.locals.userId),
+ *   client: () => fetch('/api/settings').then((r) => r.json()),
+ * });
+ * settings.state.theme;   // tracks `theme` alone
+ * ```
+ */
 export function createIsomorphicStore(key, options) {
-    // Whether the server transferred a value for this key (read BEFORE the base state
+    // Whether the server transferred a value for this key (read before the base state
     // consumes the seed). When true, ensureInit() must not refetch on the client.
     const seeded = readSeed(key) !== undefined;
     const base = createIsomorphicState(key, {
@@ -58,7 +91,7 @@ export function createIsomorphicStore(key, options) {
             localStorage.setItem(options.persist, JSON.stringify(v));
         }
         catch {
-            /* quota / private mode — persistence is best-effort */
+            /* quota / private mode: persistence is best-effort */
         }
     };
     const set = (v) => {

package/dist/src/lib/isomorphic.mjs

@@ -1 +1,64 @@
-import{createSignal as u,createMemo as v}from"@fluixi/reactive/signal";import{getServerData as m}from"@fluixi/dom";var y="__fluixi_iso_states__",p="__iso:";function I(){return globalThis[y]??=new Map}function f(r){if(typeof window>"u")return;let e=m();return e?e[p+r]:void 0}function g(r,e){let s=f(r),i=s!==void 0?s:typeof window<"u"&&e.client?e.client():e.fallback,[n,o]=u(i);return I().set(r,{server:e.server,set:o}),{value:n,set:o,key:r}}function x(r,e){let s=f(r)!==void 0,i=g(r,{server:e.server,fallback:e.fallback}),n=()=>i.value()??e.fallback,o=t=>{if(!(!e.persist||typeof localStorage>"u"))try{localStorage.setItem(e.persist,JSON.stringify(t))}catch{}},a=t=>{i.set(t),o(t)},l=(t,T)=>{a({...n(),[t]:T})},d={};for(let t of Object.keys(e.fallback))d[t]=v(()=>n()[t]);let c=null;return{value:n,fields:d,set:a,setField:l,ensureInit:()=>s||!e.client?Promise.resolve():(c||(c=Promise.resolve(e.client()).then(t=>{a(t)}).catch(t=>{throw c=null,t})),c),key:r}}export{g as createIsomorphicState,x as createIsomorphicStore};
+// src/lib/isomorphic.ts
+import { createSignal, createMemo } from "@fluixi/reactive/signal";
+import { getServerData } from "@fluixi/dom";
+var REGISTRY_KEY = "__fluixi_iso_states__";
+var SEED_PREFIX = "__iso:";
+function registry() {
+  return globalThis[REGISTRY_KEY] ??= /* @__PURE__ */ new Map();
+}
+function readSeed(key) {
+  if (typeof window === "undefined") return void 0;
+  const data = getServerData();
+  return data ? data[SEED_PREFIX + key] : void 0;
+}
+function createIsomorphicState(key, options) {
+  const seed = readSeed(key);
+  const initial = seed !== void 0 ? seed : typeof window !== "undefined" && options.client ? options.client() : options.fallback;
+  const [value, set] = createSignal(initial);
+  registry().set(key, { server: options.server, set });
+  return { value, set, key };
+}
+function createIsomorphicStore(key, options) {
+  const seeded = readSeed(key) !== void 0;
+  const base = createIsomorphicState(key, {
+    server: options.server,
+    fallback: options.fallback
+  });
+  const value = () => base.value() ?? options.fallback;
+  const persistWrite = (v) => {
+    if (!options.persist || typeof localStorage === "undefined") return;
+    try {
+      localStorage.setItem(options.persist, JSON.stringify(v));
+    } catch {
+    }
+  };
+  const set = (v) => {
+    base.set(v);
+    persistWrite(v);
+  };
+  const setField = (k, val) => {
+    set({ ...value(), [k]: val });
+  };
+  const fields = {};
+  for (const k of Object.keys(options.fallback)) {
+    fields[k] = createMemo(() => value()[k]);
+  }
+  let initPromise = null;
+  const ensureInit = () => {
+    if (seeded || !options.client) return Promise.resolve();
+    if (!initPromise) {
+      initPromise = Promise.resolve(options.client()).then((v) => {
+        set(v);
+      }).catch((e) => {
+        initPromise = null;
+        throw e;
+      });
+    }
+    return initPromise;
+  };
+  return { value, fields, set, setField, ensureInit, key };
+}
+export {
+  createIsomorphicState,
+  createIsomorphicStore
+};

package/dist/src/lib/jsx-runtime/index.cjs

@@ -1 +1,21 @@
-"use strict";var m=Object.defineProperty;var l=Object.getOwnPropertyDescriptor;var s=Object.getOwnPropertyNames;var u=Object.prototype.hasOwnProperty;var p=(x,i,r,e)=>{if(i&&typeof i=="object"||typeof i=="function")for(let o of s(i))!u.call(x,o)&&o!==r&&m(x,o,{get:()=>i[o],enumerable:!(e=l(i,o))||e.enumerable});return x},t=(x,i,r)=>(p(x,i,"default"),r&&p(r,i,"default"));var J=x=>p(m({},"__esModule",{value:!0}),x);var f={};module.exports=J(f);t(f,require("@fluixi/jsx/jsx-runtime"),module.exports);
+/*! @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 __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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/jsx-runtime/index.ts
+var index_exports = {};
+module.exports = __toCommonJS(index_exports);
+__reExport(index_exports, require("@fluixi/jsx/jsx-runtime"), module.exports);

package/dist/src/lib/jsx-runtime/index.d.ts

@@ -8,6 +8,6 @@ export type { JSX } from '@fluixi/jsx';
  * any file imports from fluixi, because TypeScript processes declare global
  * from all transitively-loaded modules.
  *
- * Pattern: same as SolidJS — the framework's main entry carries the global augmentation.
+ * Pattern: same as SolidJS, the framework's main entry carries the global augmentation.
  */
 //# sourceMappingURL=index.d.ts.map

package/dist/src/lib/jsx-runtime/index.js

@@ -7,17 +7,7 @@ export * from '@fluixi/jsx/jsx-runtime';
  * any file imports from fluixi, because TypeScript processes declare global
  * from all transitively-loaded modules.
  *
- * Pattern: same as SolidJS — the framework's main entry carries the global augmentation.
+ * Pattern: same as SolidJS, the framework's main entry carries the global augmentation.
  */
 // declare global {
 //   namespace JSX {
-//     type Element = FluixiJSX.Element;
-//     interface IntrinsicElements extends FluixiJSX.IntrinsicElements {}
-//     interface ElementChildrenAttribute {
-//       children: {};
-//     }
-//     interface IntrinsicAttributes {
-//       key?: string | number;
-//     }
-//   }
-// }

package/dist/src/lib/jsx-runtime/index.mjs

@@ -1 +1,4 @@
-export*from"@fluixi/jsx/jsx-runtime";
+/*! @fluixi/core v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+
+// src/lib/jsx-runtime/index.ts
+export * from "@fluixi/jsx/jsx-runtime";

package/dist/src/lib/jsx-runtime/jsx-dev-runtime.cjs

@@ -1 +1,21 @@
-"use strict";var a=Object.defineProperty;var b=Object.getOwnPropertyDescriptor;var c=Object.getOwnPropertyNames;var d=Object.prototype.hasOwnProperty;var p=(r,o,f,x)=>{if(o&&typeof o=="object"||typeof o=="function")for(let e of c(o))!d.call(r,e)&&e!==f&&a(r,e,{get:()=>o[e],enumerable:!(x=b(o,e))||x.enumerable});return r},t=(r,o,f)=>(p(r,o,"default"),f&&p(f,o,"default"));var g=r=>p(a({},"__esModule",{value:!0}),r);var m={};module.exports=g(m);t(m,require("@fluixi/jsx/jsx-dev-runtime"),module.exports);
+/*! @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 __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 __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/lib/jsx-runtime/jsx-dev-runtime.ts
+var jsx_dev_runtime_exports = {};
+module.exports = __toCommonJS(jsx_dev_runtime_exports);
+__reExport(jsx_dev_runtime_exports, require("@fluixi/jsx/jsx-dev-runtime"), module.exports);

package/dist/src/lib/jsx-runtime/jsx-dev-runtime.mjs

@@ -1 +1,4 @@
-export*from"@fluixi/jsx/jsx-dev-runtime";
+/*! @fluixi/core v1.0.0-alpha.84 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+
+// src/lib/jsx-runtime/jsx-dev-runtime.ts
+export * from "@fluixi/jsx/jsx-dev-runtime";