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

package/dist/lib/dom/island.d.ts

@@ -16,7 +16,7 @@ export type IslandRegistry = Record<string, (props: any) => any>;
 /**
  * Client entry for an islands page: find every `<fluixi-island>`, look its component up
  * in `registry` by name, parse its props, and hydrate that subtree in place. The rest of
- * the page stays static (never hydrated → no reactivity wired, no extra JS executed).
+ * the page stays static (never hydrated -> no reactivity wired, no extra JS executed).
  * Call this instead of `startClient(App)`.
  */
 export declare function hydrateIslands(registry: IslandRegistry): void;

package/dist/lib/dom/island.js

@@ -1,23 +1,23 @@
 /**
- * Islands — partial hydration. By default Fluixi hydrates the whole app; an island
- * hydrates ONLY its own interactive subtree, leaving the rest of the page as inert
+ * Islands: partial hydration. By default Fluixi hydrates the whole app; an island
+ * hydrates only its own interactive subtree, leaving the rest of the page as inert
  * static server HTML (less client JS, faster TTI).
  *
  *   // server-rendered page
  *   <Island name="Counter" component={Counter} props={{ start: 0 }} />
  *
- *   // client entry — instead of startClient(App):
+ *   // client entry: instead of startClient(App):
  *   hydrateIslands({ Counter });
  *
  * The server wraps the component in a `<fluixi-island name props>` boundary (props as a
  * JSON attribute). On the client, `hydrateIslands` finds those boundaries, looks each up
  * in the registry, and hydrates just that subtree in place.
  *
- * Note: islands are self-contained interactivity — pass data via `props`. Resources read
+ * Note: islands are self-contained interactivity: pass data via `props`. Resources read
  * inside an island ARE seeded per-island from `__FX_DATA__`: the server namespaces each
- * island's resource ids (`Counter#0:r0`, …) and the client reproduces that namespace when
+ * island's resource ids (`Counter#0:r0`, ...) and the client reproduces that namespace when
  * it hydrates the island, so the island's resources don't refetch. (A resource created
- * lazily in a data WATERFALL — after the first resolves during the async drain — falls
+ * lazily in a data WATERFALL, after the first resolves during the async drain, falls
  * outside the synchronous island scope and refetches on the client; pass such data via
  * `props` instead.)
  */
@@ -41,7 +41,7 @@ export function Island(props) {
     // On the server, scope this island's resource ids to a per-island namespace
     // (`name#N` in render order). The render-once model runs the insert effect
     // synchronously, so resources created while the island's subtree renders are
-    // numbered within the scope — and the client reproduces the same ids per island.
+    // numbered within the scope, and the client reproduces the same ids per island.
     const ctx = isServer() ? getRequestContext() : undefined;
     if (ctx) {
         const ns = ctx.nextIslandNamespace(islandName);
@@ -65,7 +65,7 @@ function ensureDisplayContents() {
 /**
  * Client entry for an islands page: find every `<fluixi-island>`, look its component up
  * in `registry` by name, parse its props, and hydrate that subtree in place. The rest of
- * the page stays static (never hydrated → no reactivity wired, no extra JS executed).
+ * the page stays static (never hydrated -> no reactivity wired, no extra JS executed).
  * Call this instead of `startClient(App)`.
  */
 export function hydrateIslands(registry) {
@@ -73,7 +73,7 @@ export function hydrateIslands(registry) {
         return;
     ensureDisplayContents();
     const els = document.querySelectorAll(TAG);
-    // Per-name occurrence counter, in document order — mirrors the server's render-order
+    // Per-name occurrence counter, in document order: mirrors the server's render-order
     // `nextIslandNamespace`, so island `name#N` here maps to the same namespace the server
     // used when it numbered that island's resource ids.
     const counts = new Map();
@@ -84,7 +84,7 @@ export function hydrateIslands(registry) {
         const Comp = registry[name];
         if (!Comp) {
             if (typeof process === 'undefined' || process.env?.NODE_ENV !== 'production') {
-                console.warn(`[fluixi] island "${name}" has no component in the registry — left static.`);
+                console.warn(`[fluixi] island "${name}" has no component in the registry, left static.`);
             }
             return;
         }
@@ -93,7 +93,7 @@ export function hydrateIslands(registry) {
             props = JSON.parse(el.getAttribute('props') || '{}');
         }
         catch {
-            /* malformed props → hydrate with none */
+            /* malformed props -> hydrate with none */
         }
         hydrate(() => Comp(props), el, { resourceNamespace: `${name}#${occ}` });
     });