@fluixi/core 1.0.0-alpha.92 → 1.0.0-alpha.93

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/client/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAO,uBAAuB,CAAC;AAgB/B;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,QAOlE;AAED,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;CAChB;AAoBD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,GAAG,EACzB,OAAO,GAAE,kBAAuB,iBAgEjC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/lib/client/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAaH,OAAO,uBAAuB,CAAC;AAgB/B;;;;;;;;;;GAUG;AACH,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,EAAE,SAAS,EAAE,WAAW,GAAG,IAAI,QAOlE;AAED,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,WAAW,kBAAkB;IACjC,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IAC5B,kFAAkF;IAClF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;OAMG;IACH,MAAM,CAAC,EAAE,GAAG,EAAE,CAAC;CAChB;AAoBD;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,WAAW,CAC/B,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,KAAK,GAAG,EACzB,OAAO,GAAE,kBAAuB,iBA8EjC"}

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

@@ -4,7 +4,7 @@
  * Implements client-side mounting and hydration logic using @fluixi/dom runtime.
  * Supports both JSX and Lit HTML.
  */
-import { render as domRender, hydrate as domHydrate, } from '@fluixi/dom';
+import { render as domRender, hydrate as domHydrate, beginAppHydration, endAppHydration, removeUnclaimedKeyed, clearHydrationKeys, } from '@fluixi/dom';
 // Registers core's version with the DOM runtime, which does the stamping. This entry is a
 // separate subpath, so it does not otherwise load core's render, and without this the
 // hydrate path stamped `fx-dom`/`fx-reactive` but never `fluixi`.
@@ -96,26 +96,41 @@ export async function startClient(App, options = {}) {
     // the server already extracted it (the supported adapter/prerender/dev paths do).
     stripHeadMarker(container);
     if (shouldHydrate) {
-        // Preload the lazy chunk(s) for the current route so they resolve synchronously during the
-        // hydration render, the lazy boundary then adopts the server DOM in place instead of
-        // resolving a tick later and rebuilding a duplicate. Dynamic import keeps the router out of
-        // client-only bundles that never pass `routes`.
-        if (options.routes && options.routes.length) {
-            const { preloadRoutes } = await import('../router/index.js');
-            await preloadRoutes(options.routes, window.location.pathname);
+        // Before the first await: custom elements the server rendered upgrade while the route
+        // chunks load, and wait for this hydration to hand them their owner.
+        beginAppHydration();
+        try {
+            // Preload the lazy chunk(s) for the current route so they resolve synchronously during the
+            // hydration render, the lazy boundary then adopts the server DOM in place instead of
+            // resolving a tick later and rebuilding a duplicate. Dynamic import keeps the router out of
+            // client-only bundles that never pass `routes`.
+            if (options.routes && options.routes.length) {
+                const { preloadRoutes } = await import('../router/index.js');
+                await preloadRoutes(options.routes, window.location.pathname);
+            }
+            deserializeHydrationData();
+            setHydrating(true);
+            // A memo around createComponent, which is what compiled JSX emits for every other
+            // component. Called directly, the root is the one component the runtime never hears
+            // about: nothing holds its return value, so no node is made and a graph of the
+            // application starts at whatever the root happened to render.
+            domHydrate(rootOf(App), container);
+            // Handlers are now wired (delegated $$listeners attach during the hydration
+            // render): replay any events the user fired before hydration.
+            replayEvents();
+        }
+        finally {
+            endAppHydration();
         }
-        deserializeHydrationData();
-        setHydrating(true);
-        // A memo around createComponent, which is what compiled JSX emits for every other
-        // component. Called directly, the root is the one component the runtime never hears
-        // about: nothing holds its return value, so no node is made and a graph of the
-        // application starts at whatever the root happened to render.
-        domHydrate(rootOf(App), container);
-        // Handlers are now wired (delegated $$listeners attach during the hydration
-        // render): replay any events the user fired before hydration.
-        replayEvents();
         setTimeout(() => {
             setHydrating(false);
+            // Late route chunks have had their chance to claim their markup: what nothing claimed
+            // is server output the client did not render, or rendered differently.
+            const removed = removeUnclaimedKeyed(container);
+            if (removed && typeof process !== 'undefined' && process.env?.NODE_ENV !== 'production') {
+                console.warn(`[fluixi] hydration: removed ${removed} server element(s) the client did not render. Check for markup that depends on client-only state.`);
+            }
+            clearHydrationKeys();
             cleanupHydration();
         }, 100);
     }

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

@@ -1,26 +1,87 @@
-/*! @fluixi/core v1.0.0-alpha.92 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
-import {
-  cleanupHydration,
-  deserializeHydrationData,
-  setHydrating
-} from "./chunk-VB567ABU.mjs";
+/*! @fluixi/core v1.0.0-alpha.93 | (c) 2026 Ibrahima Touré and Fluixi contributors | MIT */
+import "./chunk-QT3RFKH6.mjs";
 
 // src/lib/client/index.ts
 import {
   render as domRender,
-  hydrate as domHydrate
+  hydrate as domHydrate,
+  beginAppHydration,
+  endAppHydration,
+  removeUnclaimedKeyed,
+  clearHydrationKeys
 } from "@fluixi/dom";
 
 // src/lib/render/versions.ts
 import { registerCoreVersion } from "@fluixi/dom";
 
 // src/version.generated.ts
-var VERSION = "1.0.0-alpha.92";
+var VERSION = "1.0.0-alpha.93";
 
 // src/lib/render/versions.ts
 import { stampVersions, warnOnVersionSkew, versions } from "@fluixi/dom";
 registerCoreVersion(VERSION);
 
+// src/lib/server/hydration.ts
+import { isServer as domIsServer } from "@fluixi/dom";
+var hydrating = false;
+var hydrationDataMap = /* @__PURE__ */ new Map();
+function setHydrating(state) {
+  hydrating = state;
+}
+function clearHydrationData() {
+  hydrationDataMap.clear();
+}
+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 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);
+  });
+}
+
 // src/lib/render/index.ts
 import { isServer as isServer3 } from "@fluixi/dom";
 import { createRoot as createRoot2 } from "@fluixi/reactive/signal";
@@ -182,16 +243,26 @@ async function startClient(App, options = {}) {
   setActiveHead(head);
   stripHeadMarker(container);
   if (shouldHydrate) {
-    if (options.routes && options.routes.length) {
-      const { preloadRoutes } = await import("./router-PHLUYVQU.mjs");
-      await preloadRoutes(options.routes, window.location.pathname);
+    beginAppHydration();
+    try {
+      if (options.routes && options.routes.length) {
+        const { preloadRoutes } = await import("./router-ADTS55OP.mjs");
+        await preloadRoutes(options.routes, window.location.pathname);
+      }
+      deserializeHydrationData();
+      setHydrating(true);
+      domHydrate(rootOf(App), container);
+      replayEvents();
+    } finally {
+      endAppHydration();
     }
-    deserializeHydrationData();
-    setHydrating(true);
-    domHydrate(rootOf(App), container);
-    replayEvents();
     setTimeout(() => {
       setHydrating(false);
+      const removed = removeUnclaimedKeyed(container);
+      if (removed && typeof process !== "undefined" && false) {
+        console.warn(`[fluixi] hydration: removed ${removed} server element(s) the client did not render. Check for markup that depends on client-only state.`);
+      }
+      clearHydrationKeys();
       cleanupHydration();
     }, 100);
   } else {