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

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

@@ -1,16 +1,406 @@
-"use strict";var T=Object.defineProperty;var st=Object.getOwnPropertyDescriptor;var ct=Object.getOwnPropertyNames;var ut=Object.prototype.hasOwnProperty;var dt=(t,e)=>{for(var n in e)T(t,n,{get:e[n],enumerable:!0})},lt=(t,e,n,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let o of ct(e))!ut.call(t,o)&&o!==n&&T(t,o,{get:()=>e[o],enumerable:!(r=st(e,o))||r.enumerable});return t};var pt=t=>lt(T({},"__esModule",{value:!0}),t);var mt={};dt(mt,{batch:()=>I,cleanupHydration:()=>S,clearHydrationData:()=>g,clearHydrationDataKey:()=>H,createComputed:()=>P,createContext:()=>U,createDeferred:()=>X,createEffect:()=>f,createHtmlDocument:()=>tt,createHydratableResource:()=>k,createMemo:()=>m,createRenderEffect:()=>V,createResource:()=>J,createRoot:()=>F,createSelector:()=>B,createSignal:()=>K,deserializeHydrationData:()=>b,getHydrationData:()=>d,getOwner:()=>W,getSSRContext:()=>ft,hasHydrationData:()=>R,hydrationMarker:()=>O,hydrationMarkerEnd:()=>A,hydrationMarkerStart:()=>E,isClient:()=>nt,isClientEnvironment:()=>M,isClientReactive:()=>Q,isHydrating:()=>x,isServer:()=>et,isServerEnvironment:()=>j,isServerReactive:()=>G,onCleanup:()=>z,onClient:()=>gt,onServer:()=>xt,renderToPage:()=>Z,renderToStream:()=>rt,renderToString:()=>h,runWithOwner:()=>L,serializeHydrationData:()=>l,setHydrating:()=>D,setHydrationData:()=>u,setSSRContext:()=>yt,startServer:()=>St,startTransition:()=>q,untrack:()=>N,useContext:()=>Y,useHydrationData:()=>_,withSSRContext:()=>Tt});module.exports=pt(mt);var C=!1,a=new Map;function x(){return C}function D(t){C=t}function u(t,e){a.set(t,e)}function d(t){return a.get(t)}function R(t){return a.has(t)}function g(){a.clear()}function H(t){a.delete(t)}function l(){if(a.size===0)return"";let t=Object.fromEntries(a);return`<script type="application/json" id="__FLUIXI_HYDRATION__">${JSON.stringify(t)}<\/script>`}function b(){if(typeof window>"u")return!1;let t=document.getElementById("__FLUIXI_HYDRATION__");if(!t||t.getAttribute("type")!=="application/json")return!1;try{let e=t.textContent||"{}",n=JSON.parse(e);for(let[r,o]of Object.entries(n))a.set(r,o);return!0}catch(e){return console.error("Failed to deserialize hydration data:",e),!1}}function O(t){return`<!--#${t}-->`}function E(t){return`<!--#${t}-->`}function A(t){return`<!--/${t}-->`}function k(t,e){return async()=>{if(x()||typeof window<"u"){let r=d(t);if(r!==void 0)return r}let n=await e();return typeof window>"u"&&u(t,n),n}}function _(t,e){let n=d(t);if(n!==void 0)return n;let r=typeof e=="function"?e():e;return typeof window>"u"&&u(t,r),r}function S(){if(typeof window>"u")return;let t=document.getElementById("__FLUIXI_HYDRATION__");t&&t.remove();let e=document.createTreeWalker(document.body,NodeFilter.SHOW_COMMENT,null),n=[],r;for(;r=e.nextNode();){let o=r,i=o.nodeValue||"";(i.startsWith("#")||i.startsWith("/"))&&n.push(o)}n.forEach(o=>o.remove()),g()}typeof window<"u"&&window.addEventListener("load",()=>{setTimeout(S,100)});function j(){return typeof window>"u"}function M(){return typeof window<"u"}var v=require("@fluixi/server");function K(t,e){let n=t;return[(()=>n),i=>(typeof i=="function"?n=i(n):n=i,n)]}function f(t,e,n){try{t(e)}catch(r){console.error("[Fluixi Server] Effect error:",r)}return{dispose:()=>{}}}function m(t,e,n){let r=t(e);return(()=>r)}function F(t){let e=[],n=()=>{e.forEach(r=>{try{r()}catch(o){console.error("[Fluixi Server] Cleanup error:",o)}}),e.length=0};try{return t(n)}catch(r){throw n(),r}}function I(t){return t()}function N(t){return t()}var $=null;function z(t){$&&$.push(t)}var p=null;function W(){return p}function L(t,e){let n=p;p=t;try{return e()}finally{p=n}}var s=new Map;function U(t){let e=Symbol("context");return{id:e,Provider:r=>{let o=s.get(e);s.set(e,r.value);try{return r.children}finally{o!==void 0?s.set(e,o):s.delete(e)}},defaultValue:t}}function Y(t){let e=s.get(t.id);return e!==void 0?e:t.defaultValue}function P(t){return f(t)}function V(t){return f(t)}function X(t){return m(t)}function B(t){let e=t();return n=>n===e}function J(t,e,n){return[()=>{},{mutate:r=>r,refetch:()=>{}}]}function q(t){t()}var G=!0,Q=!1;var c=null;function ft(){return c}function yt(t){c=t}function Tt(t,e){let n=c;c=t;try{return e()}finally{c=n}}async function Z(t,e={}){let n=await h(t);return tt(n,e)}function tt(t,e={}){let{title:n="Fluixi App",lang:r="en",stylesheets:o=[],scripts:i=[],head:ot="",bodyAttributes:w=""}=e,it=o.map(y=>`<link rel="stylesheet" href="${y}">`).join(`
-    `),at=i.map(y=>`<script type="module" src="${y}"><\/script>`).join(`
-    `);return`<!DOCTYPE html>
-<html lang="${r}">
+/*! @fluixi/core v1.0.0-alpha.85 | (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/server/index.ts
+var index_exports = {};
+__export(index_exports, {
+  batch: () => batch,
+  cleanupHydration: () => cleanupHydration,
+  clearHydrationData: () => clearHydrationData,
+  clearHydrationDataKey: () => clearHydrationDataKey,
+  createComputed: () => createComputed,
+  createContext: () => createContext,
+  createDeferred: () => createDeferred,
+  createEffect: () => createEffect,
+  createHtmlDocument: () => createHtmlDocument,
+  createHydratableResource: () => createHydratableResource,
+  createMemo: () => createMemo,
+  createRenderEffect: () => createRenderEffect,
+  createResource: () => createResource,
+  createRoot: () => createRoot,
+  createSelector: () => createSelector,
+  createSignal: () => createSignal,
+  deserializeHydrationData: () => deserializeHydrationData,
+  getHydrationData: () => getHydrationData,
+  getOwner: () => getOwner,
+  getSSRContext: () => getSSRContext,
+  hasHydrationData: () => hasHydrationData,
+  hydrationMarker: () => hydrationMarker,
+  hydrationMarkerEnd: () => hydrationMarkerEnd,
+  hydrationMarkerStart: () => hydrationMarkerStart,
+  isClient: () => isClient2,
+  isClientEnvironment: () => isClientEnvironment,
+  isClientReactive: () => isClient,
+  isHydrating: () => isHydrating,
+  isServer: () => import_dom2.isServer,
+  isServerEnvironment: () => isServerEnvironment,
+  isServerReactive: () => isServer,
+  onCleanup: () => onCleanup,
+  onClient: () => onClient,
+  onServer: () => onServer,
+  renderToPage: () => renderToPage,
+  renderToStream: () => renderToStream,
+  renderToString: () => renderToString,
+  runWithOwner: () => runWithOwner,
+  serializeHydrationData: () => serializeHydrationData,
+  setHydrating: () => setHydrating,
+  setHydrationData: () => setHydrationData,
+  setSSRContext: () => setSSRContext,
+  startServer: () => startServer,
+  startTransition: () => startTransition,
+  untrack: () => untrack,
+  useContext: () => useContext,
+  useHydrationData: () => useHydrationData,
+  withSSRContext: () => withSSRContext
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/lib/server/hydration.ts
+var import_dom = require("@fluixi/dom");
+var hydrating = false;
+var hydrationDataMap = /* @__PURE__ */ new Map();
+function isHydrating() {
+  return hydrating;
+}
+function setHydrating(state) {
+  hydrating = state;
+}
+function setHydrationData(key, data) {
+  hydrationDataMap.set(key, data);
+}
+function getHydrationData(key) {
+  return hydrationDataMap.get(key);
+}
+function hasHydrationData(key) {
+  return hydrationDataMap.has(key);
+}
+function clearHydrationData() {
+  hydrationDataMap.clear();
+}
+function clearHydrationDataKey(key) {
+  hydrationDataMap.delete(key);
+}
+function serializeHydrationData() {
+  if (hydrationDataMap.size === 0) {
+    return "";
+  }
+  const data = Object.fromEntries(hydrationDataMap);
+  const json = JSON.stringify(data);
+  return `<script type="application/json" id="__FLUIXI_HYDRATION__">${json}<\/script>`;
+}
+function deserializeHydrationData() {
+  if (typeof window === "undefined") {
+    return false;
+  }
+  const script = document.getElementById("__FLUIXI_HYDRATION__");
+  if (!script || script.getAttribute("type") !== "application/json") {
+    return false;
+  }
+  try {
+    const json = script.textContent || "{}";
+    const data = JSON.parse(json);
+    for (const [key, value] of Object.entries(data)) {
+      hydrationDataMap.set(key, value);
+    }
+    return true;
+  } catch (error) {
+    console.error("Failed to deserialize hydration data:", error);
+    return false;
+  }
+}
+function hydrationMarker(id) {
+  return `<!--#${id}-->`;
+}
+function hydrationMarkerStart(id) {
+  return `<!--#${id}-->`;
+}
+function hydrationMarkerEnd(id) {
+  return `<!--/${id}-->`;
+}
+function createHydratableResource(key, fetcher) {
+  return async () => {
+    if (isHydrating() || typeof window !== "undefined") {
+      const cached = getHydrationData(key);
+      if (cached !== void 0) {
+        return cached;
+      }
+    }
+    const data = await fetcher();
+    if (typeof window === "undefined") {
+      setHydrationData(key, data);
+    }
+    return data;
+  };
+}
+function useHydrationData(key, value) {
+  const hydrationData = getHydrationData(key);
+  if (hydrationData !== void 0) {
+    return hydrationData;
+  }
+  const computedValue = typeof value === "function" ? value() : value;
+  if (typeof window === "undefined") {
+    setHydrationData(key, computedValue);
+  }
+  return computedValue;
+}
+function cleanupHydration() {
+  if (typeof window === "undefined") {
+    return;
+  }
+  const script = document.getElementById("__FLUIXI_HYDRATION__");
+  if (script) {
+    script.remove();
+  }
+  const walker = document.createTreeWalker(
+    document.body,
+    NodeFilter.SHOW_COMMENT,
+    null
+  );
+  const comments = [];
+  let node;
+  while (node = walker.nextNode()) {
+    const comment = node;
+    const text = comment.nodeValue || "";
+    if (text.startsWith("#") || text.startsWith("/")) {
+      comments.push(comment);
+    }
+  }
+  comments.forEach((comment) => comment.remove());
+  clearHydrationData();
+}
+if (typeof window !== "undefined") {
+  window.addEventListener("load", () => {
+    setTimeout(cleanupHydration, 100);
+  });
+}
+function isServerEnvironment() {
+  return (0, import_dom.isServer)();
+}
+function isClientEnvironment() {
+  return !(0, import_dom.isServer)();
+}
+
+// src/lib/server/index.ts
+var import_server = require("@fluixi/server");
+var import_dom2 = require("@fluixi/dom");
+
+// src/lib/server/reactive.ts
+function createSignal(value, options) {
+  let current = value;
+  const read = (() => current);
+  const write = (newValue) => {
+    if (typeof newValue === "function") {
+      current = newValue(current);
+    } else {
+      current = newValue;
+    }
+    return current;
+  };
+  return [read, write];
+}
+function createEffect(fn, value, options) {
+  try {
+    fn(value);
+  } catch (error) {
+    console.error("[Fluixi Server] Effect error:", error);
+  }
+  return { dispose: () => {
+  } };
+}
+function createMemo(fn, value, options) {
+  const computed = fn(value);
+  return (() => computed);
+}
+function createRoot(fn) {
+  const cleanups = [];
+  const dispose = () => {
+    cleanups.forEach((cleanup) => {
+      try {
+        cleanup();
+      } catch (error) {
+        console.error("[Fluixi Server] Cleanup error:", error);
+      }
+    });
+    cleanups.length = 0;
+  };
+  try {
+    return fn(dispose);
+  } catch (error) {
+    dispose();
+    throw error;
+  }
+}
+function batch(fn) {
+  return fn();
+}
+function untrack(fn) {
+  return fn();
+}
+var currentCleanups = null;
+function onCleanup(fn) {
+  if (currentCleanups) {
+    currentCleanups.push(fn);
+  }
+}
+var currentOwner = null;
+function getOwner() {
+  return currentOwner;
+}
+function runWithOwner(owner, fn) {
+  const prev = currentOwner;
+  currentOwner = owner;
+  try {
+    return fn();
+  } finally {
+    currentOwner = prev;
+  }
+}
+var contextMap = /* @__PURE__ */ new Map();
+function createContext(defaultValue) {
+  const id = /* @__PURE__ */ Symbol("context");
+  const Provider = (props) => {
+    const prevValue = contextMap.get(id);
+    contextMap.set(id, props.value);
+    try {
+      return props.children;
+    } finally {
+      if (prevValue !== void 0) {
+        contextMap.set(id, prevValue);
+      } else {
+        contextMap.delete(id);
+      }
+    }
+  };
+  return {
+    id,
+    Provider,
+    defaultValue
+  };
+}
+function useContext(context) {
+  const value = contextMap.get(context.id);
+  return value !== void 0 ? value : context.defaultValue;
+}
+function createComputed(fn) {
+  return createEffect(fn);
+}
+function createRenderEffect(fn) {
+  return createEffect(fn);
+}
+function createDeferred(fn) {
+  return createMemo(fn);
+}
+function createSelector(source) {
+  const value = source();
+  return (key) => key === value;
+}
+function createResource(source, fetcher, options) {
+  return [
+    () => void 0,
+    {
+      mutate: (v) => v,
+      refetch: () => {
+      }
+    }
+  ];
+}
+function startTransition(fn) {
+  fn();
+}
+var isServer = true;
+var isClient = false;
+
+// src/lib/server/index.ts
+var import_dom3 = require("@fluixi/dom");
+var currentSSRContext = null;
+function getSSRContext() {
+  return currentSSRContext;
+}
+function setSSRContext(context) {
+  currentSSRContext = context;
+}
+function withSSRContext(context, fn) {
+  const prev = currentSSRContext;
+  currentSSRContext = context;
+  try {
+    return fn();
+  } finally {
+    currentSSRContext = prev;
+  }
+}
+async function renderToPage(code, options = {}) {
+  const content = await renderToString(code);
+  return createHtmlDocument(content, options);
+}
+function createHtmlDocument(content, options = {}) {
+  const {
+    title = "Fluixi App",
+    lang = "en",
+    stylesheets = [],
+    scripts = [],
+    head = "",
+    bodyAttributes = ""
+  } = options;
+  const styleTags = stylesheets.map((href) => `<link rel="stylesheet" href="${href}">`).join("\n    ");
+  const scriptTags = scripts.map((src) => `<script type="module" src="${src}"><\/script>`).join("\n    ");
+  return `<!DOCTYPE html>
+<html lang="${lang}">
   <head>
     <meta charset="UTF-8">
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
-    <title>${n}</title>
-    ${it}
-    ${ot}
+    <title>${title}</title>
+    ${styleTags}
+    ${head}
   </head>
-  <body${w?" "+w:""}>
-    ${t}
-    ${at}
+  <body${bodyAttributes ? " " + bodyAttributes : ""}>
+    ${content}
+    ${scriptTags}
   </body>
-</html>`}function et(){return typeof window>"u"}function nt(){return typeof window<"u"}function xt(t,e){return et()?t():e}function gt(t,e){return nt()?t():e}async function h(t){let e=await(0,v.renderToString)(t),n=l();return e+n}async function rt(t){let e=await(0,v.renderToString)(t),n=l();return e+n}function St(t){return{render:e=>h(()=>t({url:e})),stream:e=>rt(()=>t({url:e})),page:(e,n)=>Z(()=>t({url:e}),n)}}
+</html>`;
+}
+function isClient2() {
+  return !(0, import_dom3.isServer)();
+}
+function onServer(fn, fallback) {
+  return (0, import_dom3.isServer)() ? fn() : fallback;
+}
+function onClient(fn, fallback) {
+  return !(0, import_dom3.isServer)() ? fn() : fallback;
+}
+async function renderToString(code) {
+  const html = await (0, import_server.renderToString)(code);
+  const script = serializeHydrationData();
+  return html + script;
+}
+async function renderToStream(code) {
+  const html = await (0, import_server.renderToString)(code);
+  const script = serializeHydrationData();
+  return html + script;
+}
+function startServer(App) {
+  return {
+    /** Render the app to a full HTML string (includes hydration data) */
+    render: (url) => renderToString(() => App({ url })),
+    /** Render the app to a streamable HTML string (includes hydration data) */
+    stream: (url) => renderToStream(() => App({ url })),
+    /** Render the app to a complete HTML page document */
+    page: (url, opts) => renderToPage(() => App({ url }), opts)
+  };
+}

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

@@ -1,5 +1,4 @@
 /**
- * @fileoverview Server-Side Rendering Entry Point for Fluixi
  * @module @fluixi/core/server
  *
  * Implements Unified SSR Engine compatible with Lit and JSX.
@@ -38,19 +37,44 @@ export declare function setSSRContext(context: SSRContext | null): void;
 export declare function withSSRContext<T>(context: SSRContext, fn: () => T): T;
 /**
  * Render complete HTML page
- *
- * @param {() => any} code - Component function
- * @param {DocumentOptions} options - Document options
- * @returns {Promise<string>} Complete HTML document
  */
 export declare function renderToPage(code: () => any, options?: DocumentOptions): Promise<string>;
 /**
  * Create HTML document wrapper
  */
 export declare function createHtmlDocument(content: string, options?: DocumentOptions): string;
-export declare function isServer(): boolean;
+/**
+ * Whether this is a server render.
+ *
+ * Re-exported from `@fluixi/dom`, which owns the answer: the flag lives on a realm
+ * singleton that `renderToString` sets, so it is true for the whole of a server render
+ * even in a jsdom process where `window` exists.
+ *
+ * This used to be a local `typeof window === 'undefined'`, which meant
+ * `@fluixi/core/server` and `@fluixi/core` disagreed about the same question, and the
+ * local one was wrong in exactly the case that matters. Four copies of that test were
+ * the alpha.83 SSR bug; do not add a fifth.
+ */
+export { isServer } from '@fluixi/dom';
+/** Whether this is running in a browser, which is the negation of a server render. */
 export declare function isClient(): boolean;
+/**
+ * Run `fn` only during a server render, otherwise take `fallback`.
+ *
+ * @example
+ * ```ts
+ * const secret = onServer(() => process.env.API_KEY, '');
+ * ```
+ */
 export declare function onServer<T>(fn: () => T, fallback: T): T;
+/**
+ * Run `fn` only in the browser, otherwise take `fallback`.
+ *
+ * @example
+ * ```ts
+ * const width = onClient(() => window.innerWidth, 0);
+ * ```
+ */
 export declare function onClient<T>(fn: () => T, fallback: T): T;
 /**
  * Render component to HTML string

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

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

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

@@ -1,5 +1,4 @@
 /**
- * @fileoverview Server-Side Rendering Entry Point for Fluixi
  * @module @fluixi/core/server
  *
  * Implements Unified SSR Engine compatible with Lit and JSX.
@@ -42,10 +41,6 @@ export function withSSRContext(context, fn) {
 // ============================================================================
 /**
  * Render complete HTML page
- *
- * @param {() => any} code - Component function
- * @param {DocumentOptions} options - Document options
- * @returns {Promise<string>} Complete HTML document
  */
 export async function renderToPage(code, options = {}) {
     const content = await renderToString(code);
@@ -80,17 +75,44 @@ export function createHtmlDocument(content, options = {}) {
 // ============================================================================
 // ENVIRONMENT DETECTION
 // ============================================================================
-export function isServer() {
-    return typeof window === 'undefined';
-}
+/**
+ * Whether this is a server render.
+ *
+ * Re-exported from `@fluixi/dom`, which owns the answer: the flag lives on a realm
+ * singleton that `renderToString` sets, so it is true for the whole of a server render
+ * even in a jsdom process where `window` exists.
+ *
+ * This used to be a local `typeof window === 'undefined'`, which meant
+ * `@fluixi/core/server` and `@fluixi/core` disagreed about the same question, and the
+ * local one was wrong in exactly the case that matters. Four copies of that test were
+ * the alpha.83 SSR bug; do not add a fifth.
+ */
+export { isServer } from '@fluixi/dom';
+/** Whether this is running in a browser, which is the negation of a server render. */
 export function isClient() {
-    return typeof window !== 'undefined';
+    return !domIsServer();
 }
+/**
+ * Run `fn` only during a server render, otherwise take `fallback`.
+ *
+ * @example
+ * ```ts
+ * const secret = onServer(() => process.env.API_KEY, '');
+ * ```
+ */
 export function onServer(fn, fallback) {
-    return isServer() ? fn() : fallback;
+    return domIsServer() ? fn() : fallback;
 }
+/**
+ * Run `fn` only in the browser, otherwise take `fallback`.
+ *
+ * @example
+ * ```ts
+ * const width = onClient(() => window.innerWidth, 0);
+ * ```
+ */
 export function onClient(fn, fallback) {
-    return isClient() ? fn() : fallback;
+    return !domIsServer() ? fn() : fallback;
 }
 // ============================================================================
 // EXPORTS
@@ -137,5 +159,6 @@ export function startServer(App) {
 }
 // Re-export server-mapped reactive primitives
 export { createSignal, createEffect, createMemo, createRoot, batch, untrack, onCleanup, getOwner, runWithOwner, createContext, useContext, createComputed, createRenderEffect, createDeferred, createSelector, createResource, startTransition, isServer as isServerReactive, isClient as isClientReactive, } from './reactive.js';
+import { isServer as domIsServer } from '@fluixi/dom';
 // Re-export all hydration utilities
 export { isHydrating, setHydrating, setHydrationData, getHydrationData, hasHydrationData, clearHydrationData, clearHydrationDataKey, serializeHydrationData, deserializeHydrationData, hydrationMarker, hydrationMarkerStart, hydrationMarkerEnd, createHydratableResource, useHydrationData, cleanupHydration, isServerEnvironment, isClientEnvironment, };