@farm.js/islx 0.0.7 → 0.0.9

package/dist/react/client.mjs

@@ -1,9 +1,8 @@
-import { d as valueHeaders, o as emit, t as createServerReference, u as getValueStore } from "../_chunks/actions-C-IwUCKU.mjs";
-import { i as decodeTagged, n as NOT_A_VALUE, r as decode, u as setOwn } from "../_chunks/codec-C8to-RQW.mjs";
-import { F as getTag, f as FORM_STATE_SCRIPT_TYPE, h as ISLAND_ELEMENT, m as HYDRATED_ATTRIBUTE, w as SLOT_ELEMENT, x as PROPS_SCRIPT_TYPE, y as PROMISE_SCRIPT_TYPE } from "../_chunks/wire-QEQWBr5s.mjs";
-import { i as getContexts, o as isolateIslands, u as withinClientRoot } from "../_chunks/island-DVOr-OUw.mjs";
-import { i as createServerTreeLayout, n as PAYLOAD_ONLY_ATTRIBUTE, o as updateServerTrees, r as createServerTreeElement } from "../_chunks/tree-C47p6khN.mjs";
-import { n as isIslandStrategy, r as scheduleHydration, t as ISLAND_STRATEGIES } from "../_chunks/schedule-CjoybS3b.mjs";
+import { d as valueHeaders, o as emit, t as createServerReference, u as getValueStore } from "../_chunks/actions-DAzd4PpV.mjs";
+import { i as decodeTagged, n as NOT_A_VALUE, r as decode, u as setOwn } from "../_chunks/codec-DDpUvgRo.mjs";
+import { D as SLOT_TEMPLATE_ELEMENT, R as getTag, S as PROPS_SCRIPT_TYPE, T as SLOT_ELEMENT, b as PROMISE_SCRIPT_TYPE, f as FORM_STATE_SCRIPT_TYPE, g as ISLAND_ELEMENT, m as HYDRATED_ATTRIBUTE } from "../_chunks/wire-UUwZlUJZ.mjs";
+import { _ as atIdPosition, a as isolateIslands, d as PAYLOAD_ONLY_ATTRIBUTE, f as createServerTreeElement, g as updateServerTrees, i as getContexts, l as withinClientRoot, m as createSlotTree, p as createServerTreeLayout, v as parseIdPosition } from "../_chunks/island-viWIOM1k.mjs";
+import { n as isIslandStrategy, r as scheduleHydration, t as ISLAND_STRATEGIES } from "../_chunks/schedule-IK9_RwZC.mjs";
 import * as React from "react";
 import { hydrateRoot } from "react-dom/client";
 // src/react/hydrate.ts
@@ -39,6 +38,37 @@ function readFormState(document) {
 */
 const revivedValues = /* @__PURE__ */ new WeakMap();
 let slotsRevived = 0;
+/**
+* A slot's server HTML: inside the island where it placed the slot, or in the template after its
+* props for a slot it had not placed.
+*/
+function findSlot(container, name) {
+	for (const slot of container.querySelectorAll(SLOT_ELEMENT)) if (slot.getAttribute("name") === name) return slot;
+	const id = container.getAttribute("props");
+	for (const template of container.ownerDocument.querySelectorAll(`${SLOT_TEMPLATE_ELEMENT}[for]`)) {
+		if (template.getAttribute("for") !== id) continue;
+		for (const slot of template.content.querySelectorAll(SLOT_ELEMENT)) if (slot.getAttribute("name") === name) return slot;
+	}
+	return null;
+}
+/** Each island's slots that carry server trees, rebuilt before the island hydrates. */
+const preparedSlots = /* @__PURE__ */ new WeakMap();
+/** The names of the slots in `value` that carry server trees. */
+function collectTreeSlots(value, names, seen = /* @__PURE__ */ new Set()) {
+	if (!value || typeof value !== "object" || seen.has(value)) return;
+	seen.add(value);
+	const object = value;
+	if (object["$"] === "s" && object["t"] === 1 && typeof object["v"] === "string") {
+		names.add(object["v"]);
+		return;
+	}
+	for (const entry of Array.isArray(value) ? value : Object.values(object)) collectTreeSlots(entry, names, seen);
+}
+/** Whether `container` sits inside another island below `scope`. */
+function insideAnotherIsland(container, scope) {
+	for (let node = container.parentElement; node && node !== scope; node = node.parentElement) if (node.matches(ISLAND_SELECTOR)) return true;
+	return false;
+}
 /** Turns travelled props back into values: slots keep their server HTML, actions become callable. */
 function revive(value, container, values) {
 	if (value && typeof value === "object") {
@@ -70,11 +100,16 @@ function reviveUncached(value, container, values) {
 	if (tag === "s" && typeof object["v"] === "string") {
 		slotsRevived++;
 		const name = object["v"];
-		let html = "";
-		for (const slot of container.querySelectorAll(SLOT_ELEMENT)) if (slot.getAttribute("name") === name) {
-			html = slot.innerHTML;
-			break;
+		if (object["t"] === 1) {
+			const tree = preparedSlots.get(container)?.get(name);
+			if (tree === void 0) throw new Error(`the server tree of slot ${name} was not prepared`);
+			return React.createElement(SLOT_ELEMENT, {
+				key: name,
+				name,
+				style: { display: "contents" }
+			}, tree);
 		}
+		const html = findSlot(container, name)?.innerHTML ?? "";
 		return React.createElement(SLOT_ELEMENT, {
 			key: name,
 			name,
@@ -277,14 +312,43 @@ function createHydrationRuntime(options) {
 		}, [onCommit]);
 		return children;
 	}
-	const element = (Component, props, restore, onCommit) => {
-		const { graph } = getContexts();
-		const inner = React.createElement(Component, props);
-		return React.createElement(graph.Provider, { value: true }, React.createElement(Boundary, { onError: restore }, React.createElement(Committed, {
+	const element = (container, Component, props, restore, position, onCommit) => {
+		const { graph, container: containerContext } = getContexts();
+		const component = React.createElement(Component, props);
+		const inner = position && atIdPosition(position, component) || component;
+		return React.createElement(graph.Provider, { value: true }, React.createElement(containerContext.Provider, { value: container }, React.createElement(Boundary, { onError: restore }, React.createElement(Committed, {
 			onCommit,
 			children: options.wrap ? options.wrap(inner) : inner
-		})));
+		}))));
 	};
+	const ServerHtml = createServerHtml({
+		hydrate,
+		dispose
+	});
+	/** Rebuilds the server trees of an island's slots, loading their client modules. */
+	async function prepareSlots(container, id) {
+		const text = findPropsScript(container, id)?.textContent ?? "";
+		if (!text.includes(`"t":1`)) return;
+		let parsed = JSON.parse(text);
+		if (text.includes(`"\$":"r"`)) {
+			values.ingest(container.ownerDocument);
+			parsed = values.resolve(parsed);
+		}
+		const names = /* @__PURE__ */ new Set();
+		collectTreeSlots(parsed, names);
+		const trees = /* @__PURE__ */ new Map();
+		await Promise.all(Array.from(names, async (name) => {
+			const slot = findSlot(container, name);
+			const tree = slot && await createSlotTree(slot, name, {
+				load: options.load,
+				ServerHtml,
+				values
+			});
+			if (!tree) throw new Error(`slot ${name} has no server tree`);
+			trees.set(name, tree);
+		}));
+		preparedSlots.set(container, trees);
+	}
 	/** An island's props, with values, slots and actions revived. */
 	function readProps(container, id) {
 		const script = findPropsScript(container, id);
@@ -310,7 +374,7 @@ function createHydrationRuntime(options) {
 		if (scope instanceof Document) watchStream(scope);
 		const candidates = Array.from(scope.querySelectorAll(ISLAND_SELECTOR));
 		if (scope instanceof Element && scope.matches(ISLAND_SELECTOR)) candidates.unshift(scope);
-		const islands = candidates.filter((container) => !roots.has(container) && !pending.has(container) && !container.parentElement?.closest(ISLAND_SELECTOR) && !container.closest(STREAM_STAGING) && !awaitsStreamedContent(container));
+		const islands = candidates.filter((container) => !roots.has(container) && !pending.has(container) && !insideAnotherIsland(container, scope) && !container.closest(STREAM_STAGING) && !awaitsStreamedContent(container));
 		await Promise.all(islands.map(async (container) => {
 			const src = container.getAttribute("src");
 			const id = container.getAttribute("props");
@@ -348,7 +412,10 @@ function createHydrationRuntime(options) {
 							if (controller.signal.aborted || !container.isConnected) return;
 							const Component = module[exportName];
 							if (typeof Component !== "function" && (typeof Component !== "object" || Component === null)) throw new Error(`${src} has no export ${exportName}`);
+							await prepareSlots(container, id);
+							if (controller.signal.aborted || !container.isConnected) return;
 							const props = readProps(container, id);
+							const position = parseIdPosition(findPropsScript(container, id)?.getAttribute("ids"));
 							let failure;
 							const restore = (error) => {
 								if (failure !== void 0) return;
@@ -364,8 +431,9 @@ function createHydrationRuntime(options) {
 								strategy,
 								duration: performance.now() - scheduledAt
 							});
-							const root = hydrateRoot(container, element(Component, props, restore, onCommit), {
+							const root = hydrateRoot(container, element(container, Component, props, restore, position, onCommit), {
 								formState,
+								...position ? { identifierPrefix: position.prefix } : {},
 								onUncaughtError: restore,
 								onRecoverableError(error) {
 									if (disposing && isEarlyUpdate(error)) return;
@@ -374,6 +442,7 @@ function createHydrationRuntime(options) {
 								}
 							});
 							roots.set(container, {
+								position,
 								root,
 								Component,
 								src,
@@ -433,7 +502,7 @@ function createHydrationRuntime(options) {
 			if (!previous || !record || !id) continue;
 			try {
 				const props = readProps(container, id);
-				record.root.render(element(record.Component, props, record.restore));
+				record.root.render(element(previous, record.Component, props, record.restore, record.position));
 				record.props = props;
 				container.replaceWith(previous);
 				carried++;
@@ -454,7 +523,7 @@ function createHydrationRuntime(options) {
 				continue;
 			}
 			record.Component = Component;
-			record.root.render(element(record.Component, record.props, record.restore));
+			record.root.render(element(container, record.Component, record.props, record.restore, record.position));
 			updated++;
 		}
 		return updated;

package/dist/react/server.d.mts

@@ -1,5 +1,5 @@
 import { r as ReactFormState } from "../_chunks/handle-C0N9ZyNV.mjs";
-import { _ as setRenderStateResolver, d as ClientReference, f as IslandRenderState, g as isolateIslands, h as getClientReference, l as renderServerTree, m as createIsland, n as PAYLOAD_ONLY_ATTRIBUTE, o as ServerTreeRenderOptions, p as IslandsProvider, t as Outlet, v as withinClientRoot } from "../_chunks/tree-B4RMU2UX.mjs";
+import { _ as setRenderStateResolver, d as ClientReference, f as IslandRenderState, g as isolateIslands, h as getClientReference, l as renderServerTree, m as createIsland, n as PAYLOAD_ONLY_ATTRIBUTE, o as ServerTreeRenderOptions, p as IslandsProvider, t as Outlet, v as withinClientRoot } from "../_chunks/tree-CV13RsJv.mjs";
 import * as React from "react";
 import { RenderToReadableStreamOptions } from "react-dom/server";
 

package/dist/react/server.mjs

@@ -1,11 +1,11 @@
-import { a as encode } from "../_chunks/codec-C8to-RQW.mjs";
-import { f as FORM_STATE_SCRIPT_TYPE } from "../_chunks/wire-QEQWBr5s.mjs";
-import { r as PREHYDRATION_SCRIPT } from "../_chunks/prehydration-B1GLTLdk.mjs";
-import { i as encodeActionReference } from "../_chunks/actions-CvQ0-zjg.mjs";
+import { a as encode } from "../_chunks/codec-DDpUvgRo.mjs";
+import { f as FORM_STATE_SCRIPT_TYPE } from "../_chunks/wire-UUwZlUJZ.mjs";
+import { RUNTIME_GLOBAL } from "../boot.mjs";
+import { r as PREHYDRATION_SCRIPT } from "../_chunks/prehydration-zEYsfFxW.mjs";
+import { i as encodeActionReference } from "../_chunks/actions-DzIPDecd.mjs";
 import { t as getBuildDefaults } from "../_chunks/build-COIcs7wm.mjs";
-import { a as parseHeldValues, n as addressValues, o as selectValuesToSend, r as escapeScriptJson } from "../_chunks/values-37UIzxM0.mjs";
-import { c as setIslandServerHook, i as getContexts, l as setRenderStateResolver, n as createIsland, o as isolateIslands, r as getClientReference, s as runtimeTagged, t as IslandsProvider, u as withinClientRoot } from "../_chunks/island-DVOr-OUw.mjs";
-import { a as renderServerTree, n as PAYLOAD_ONLY_ATTRIBUTE, t as Outlet } from "../_chunks/tree-C47p6khN.mjs";
+import { a as parseHeldValues, n as addressValues, o as selectValuesToSend, r as escapeScriptJson } from "../_chunks/values-gxhIei_m.mjs";
+import { a as isolateIslands, c as setRenderStateResolver, d as PAYLOAD_ONLY_ATTRIBUTE, h as renderServerTree, i as getContexts, l as withinClientRoot, n as createIsland, o as runtimeTagged, r as getClientReference, s as setIslandServerHook, t as IslandsProvider, u as Outlet } from "../_chunks/island-viWIOM1k.mjs";
 import * as React from "react";
 // src/react/server.ts
 /**
@@ -88,9 +88,12 @@ async function renderToStream(element, { request, formState, bootstrap = true, p
 		held: held && held.size > 0 ? held : null,
 		sent: /* @__PURE__ */ new Set()
 	} }, element, formState ? React.createElement(FormStateScript, { formState }) : null);
-	const entry = bootstrap ? getBuildDefaults().entry : void 0;
-	const bootstrapModules = entry ? [...options.bootstrapModules ?? [], entry] : options.bootstrapModules;
-	const bootstrapScriptContent = prehydration ?? entry !== void 0 ? `${PREHYDRATION_SCRIPT}${options.bootstrapScriptContent ?? ""}` : options.bootstrapScriptContent;
+	const defaults = getBuildDefaults();
+	const entry = bootstrap ? defaults.entry : void 0;
+	const boot = entry !== void 0 ? defaults.boot : void 0;
+	const bootstrapModules = entry ? [...options.bootstrapModules ?? [], boot ?? entry] : options.bootstrapModules;
+	const runtime = boot ? `window.${RUNTIME_GLOBAL}=${escapeScriptJson(JSON.stringify(entry))};` : "";
+	const bootstrapScriptContent = prehydration ?? entry !== void 0 ? `${PREHYDRATION_SCRIPT}${runtime}${options.bootstrapScriptContent ?? ""}` : runtime || options.bootstrapScriptContent ? `${runtime}${options.bootstrapScriptContent ?? ""}` : void 0;
 	const { renderToReadableStream } = await import("react-dom/server");
 	const stream = await renderToReadableStream(tree, {
 		...options,

package/dist/react.d.mts

@@ -1,3 +1,7 @@
-import { f as IslandRenderState, g as isolateIslands, l as renderServerTree, m as createIsland, o as ServerTreeRenderOptions, p as IslandsProvider, t as Outlet, v as withinClientRoot } from "./_chunks/tree-B4RMU2UX.mjs";
+import { f as IslandRenderState, g as isolateIslands, l as renderServerTree, m as createIsland, o as ServerTreeRenderOptions, p as IslandsProvider, t as Outlet, v as withinClientRoot } from "./_chunks/tree-CV13RsJv.mjs";
 import { n as IslandStrategy } from "./_chunks/schedule-Dw14dW0H.mjs";
-export { type IslandRenderState, type IslandStrategy, IslandsProvider, Outlet, type ServerTreeRenderOptions, createIsland, isolateIslands, renderServerTree, withinClientRoot };
+import * as ReactDOM from "react-dom";
+
+// src/react/form-status.d.ts
+declare function useFormStatus(): ReactDOM.FormStatus;
+export { type IslandRenderState, type IslandStrategy, IslandsProvider, Outlet, type ServerTreeRenderOptions, createIsland, isolateIslands, renderServerTree, useFormStatus, withinClientRoot };

package/dist/react.mjs

@@ -1,3 +1,22 @@
-import { n as createIsland, o as isolateIslands, t as IslandsProvider, u as withinClientRoot } from "./_chunks/island-DVOr-OUw.mjs";
-import { a as renderServerTree, t as Outlet } from "./_chunks/tree-C47p6khN.mjs";
-export { IslandsProvider, Outlet, createIsland, isolateIslands, renderServerTree, withinClientRoot };
+import { a as isolateIslands, h as renderServerTree, i as getContexts, l as withinClientRoot, n as createIsland, t as IslandsProvider, u as Outlet } from "./_chunks/island-viWIOM1k.mjs";
+import { i as subscribeServerForms, r as getServerFormStatus, t as IDLE_FORM_STATUS } from "./_chunks/forms-CCDY9QHC.mjs";
+import * as React from "react";
+import * as ReactDOM from "react-dom";
+// src/react/form-status.ts
+/**
+* `useFormStatus` for islands. React reports the status of the React `<form>` around a component,
+* but a form written in a server component is server HTML: an island inside it is a React root of
+* its own, with no form above it, so React's hook never sees the form submit. The compiler points
+* client modules' `useFormStatus` from `react-dom` here.
+*
+* Forms do not nest, so an island inside a `<form>` element has no React form of its own around
+* its components: that server form is the one, and `enhanceForms` reports its submissions.
+* Anywhere else this is React's hook.
+*/
+function useFormStatus() {
+	const status = ReactDOM.useFormStatus();
+	const form = React.useContext(getContexts().container)?.parentElement?.closest("form") ?? null;
+	const server = React.useSyncExternalStore(subscribeServerForms, () => form ? getServerFormStatus(form) : IDLE_FORM_STATUS, () => IDLE_FORM_STATUS);
+	return form ? server : status;
+}
+export { IslandsProvider, Outlet, createIsland, isolateIslands, renderServerTree, useFormStatus, withinClientRoot };

package/dist/server.d.mts

@@ -187,6 +187,11 @@ declare function isSameOriginRequest(request: Request, allowedOrigins: readonly
 interface BuildDefaults {
   /** The URL of the browser entry `renderToStream` adds to pages. */
   entry?: string;
+  /**
+   * The URL of the boot entry (`@farm.js/islx/boot`): pages start with it instead, and it loads
+   * `entry` when the page first needs it. An island that hydrates at load preloads `entry`.
+   */
+  boot?: string;
   /** A key made for this build: every instance of one build shares it. */
   key?: string;
   /**

package/dist/server.mjs

@@ -1,7 +1,7 @@
-import { a as parseHeldValues, i as hashValue, n as addressValues, o as selectValuesToSend, r as escapeScriptJson, t as VALUE_MIN_LENGTH } from "./_chunks/values-37UIzxM0.mjs";
-import { a as getActionReference, c as resolveAction, d as generateActionKey, f as sealBound, i as encodeActionReference, l as SealError, n as configureActionKeys, o as registerInlineAction, p as unsealBound, r as decodeActionReference, s as registerServerReference, t as bindInlineAction, u as createActionKeys } from "./_chunks/actions-CvQ0-zjg.mjs";
-import { a as encode, r as decode } from "./_chunks/codec-C8to-RQW.mjs";
-import { I as readPostedAction, L as stripRuntimeFields, N as attachmentField, n as ACTION_KEY_FIELD, o as BOUND_FIELD, r as ACTION_STALE_HEADER, s as CALL_FIELD, t as ACTION_HEADER } from "./_chunks/wire-QEQWBr5s.mjs";
+import { a as parseHeldValues, i as hashValue, n as addressValues, o as selectValuesToSend, r as escapeScriptJson, t as VALUE_MIN_LENGTH } from "./_chunks/values-gxhIei_m.mjs";
+import { a as getActionReference, c as resolveAction, d as generateActionKey, f as sealBound, i as encodeActionReference, l as SealError, n as configureActionKeys, o as registerInlineAction, p as unsealBound, r as decodeActionReference, s as registerServerReference, t as bindInlineAction, u as createActionKeys } from "./_chunks/actions-DzIPDecd.mjs";
+import { a as encode, r as decode } from "./_chunks/codec-DDpUvgRo.mjs";
+import { B as stripRuntimeFields, I as attachmentField, n as ACTION_KEY_FIELD, o as BOUND_FIELD, r as ACTION_STALE_HEADER, s as CALL_FIELD, t as ACTION_HEADER, z as readPostedAction } from "./_chunks/wire-UUwZlUJZ.mjs";
 import { n as setBuildDefaults, t as getBuildDefaults } from "./_chunks/build-COIcs7wm.mjs";
 // src/server/hooks.ts
 const HOOKS_KEY = Symbol.for("islx.server.hooks");

package/dist/tanstack-start/server.mjs

@@ -1,6 +1,6 @@
-import { t as IslandsProvider } from "../_chunks/island-DVOr-OUw.mjs";
-import { A as VALUES_HEADER, C as RENDER_HEADER } from "../_chunks/wire-QEQWBr5s.mjs";
-import { a as parseHeldValues } from "../_chunks/values-37UIzxM0.mjs";
+import { t as IslandsProvider } from "../_chunks/island-viWIOM1k.mjs";
+import { N as VALUES_HEADER, w as RENDER_HEADER } from "../_chunks/wire-UUwZlUJZ.mjs";
+import { a as parseHeldValues } from "../_chunks/values-gxhIei_m.mjs";
 import * as React from "react";
 import { StartServer } from "@tanstack/react-start/server";
 import { createSsrStreamResponse, defineHandlerCallback, getSsrStatus, renderRouterToStream, transformReadableStreamWithRouter } from "@tanstack/react-router/ssr/server";

package/dist/tanstack-start.mjs

@@ -1,4 +1,4 @@
-import { n as islx, t as ENTRY_ID } from "./_chunks/vite-BTzYlEiY.mjs";
+import { n as ENTRY_ID, r as islx } from "./_chunks/vite-CHB6B8tP.mjs";
 import { normalizePath } from "vite";
 // src/tanstack-start/index.ts
 /**

package/dist/vite.d.mts

@@ -42,9 +42,24 @@ interface IslxOptions {
     client?: string | ClientHooks;
     server?: string | ServerHooks;
   };
+  /**
+   * A client module without a `hydrate` export waits for a click when its code provably does
+   * nothing before one (`inferStrategy` in `@farm.js/islx/compiler`): a page of such islands loads
+   * the runtime only when one is used. Default true; false hydrates them at load.
+   */
+  infer?: boolean;
+  /**
+   * Pages start with a small boot script (`@farm.js/islx/boot`) instead of the browser entry,
+   * and load the entry when the page first needs it: at once when an island hydrates at load,
+   * otherwise on an island's trigger or a link. Default true; false starts every page with the
+   * entry.
+   */
+  boot?: boolean;
 }
 /** @internal The browser entry, for a framework whose own entry imports it. */
 declare const ENTRY_ID = "virtual:islx/client-entry";
+/** The boot entry: pages start with it, and it loads ENTRY_ID when the page first needs it. */
+declare const BOOT_ID = "virtual:islx/boot";
 /**
  * The source of a hooks module made from callbacks. Each callback is copied as written, so it
  * must not use anything from where it was written: an outside variable, an import.
@@ -73,4 +88,4 @@ interface IslxHost {
   frameworkBuild?: boolean;
 }
 declare function islx(options?: IslxOptions, host?: IslxHost): Plugin[];
-export { ENTRY_ID, IslxHost, IslxOptions, islx as default, islx, resolveDirectives, serializeHooks };
+export { BOOT_ID, ENTRY_ID, IslxHost, IslxOptions, islx as default, islx, resolveDirectives, serializeHooks };

package/dist/vite.mjs

@@ -1 +1 @@
-export { t as ENTRY_ID, n as default, n as islx, r as resolveDirectives, i as serializeHooks } from "./_chunks/vite-BTzYlEiY.mjs";
+export { t as BOOT_ID, n as ENTRY_ID, r as default, r as islx, i as resolveDirectives, a as serializeHooks } from "./_chunks/vite-CHB6B8tP.mjs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farm.js/islx",
-  "version": "0.0.7",
+  "version": "0.0.9",
   "description": "A renderer-agnostic wire format for server-rendered islands: typed props, values sent once, server actions, and partial navigations.",
   "keywords": [
     "islands",
@@ -39,6 +39,10 @@
       "types": "./dist/client.d.mts",
       "default": "./dist/client.mjs"
     },
+    "./boot": {
+      "types": "./dist/boot.d.mts",
+      "default": "./dist/boot.mjs"
+    },
     "./server": {
       "types": "./dist/server.d.mts",
       "default": "./dist/server.mjs"

package/dist/_chunks/island-DVOr-OUw.mjs

@@ -1,262 +0,0 @@
-import { t as getBuildDefaults } from "./build-COIcs7wm.mjs";
-import { M as VALUE_SCRIPT_TYPE, h as ISLAND_ELEMENT, w as SLOT_ELEMENT, x as PROPS_SCRIPT_TYPE, y as PROMISE_SCRIPT_TYPE } from "./wire-QEQWBr5s.mjs";
-import * as React from "react";
-import * as ReactDOM from "react-dom";
-// src/react/island.ts
-/**
-* A client component, as the server renders it: its HTML inside `<f-island>`, and its props in
-* a script after it. Shared by the server and the browser: inside a hydrating island, a nested
-* client component is part of that island's React tree, not an island of its own.
-*
-* The compiler wraps every export of a `"use client"` module with `createIsland` in the server
-* build. The browser build keeps the module as it is.
-*/
-const CLIENT_REFERENCE = Symbol.for("islx.react.client-reference");
-/** The module export an island component renders, or undefined for any other type. */
-function getClientReference(type) {
-	if (!type || typeof type !== "function" && typeof type !== "object") return void 0;
-	return type[CLIENT_REFERENCE];
-}
-/**
-* Makes `element`'s client components part of the React root around it (a layout that hydrates
-* as one root), instead of islands of their own.
-*/
-function withinClientRoot(element) {
-	return React.createElement(getContexts().graph.Provider, { value: true }, element);
-}
-/**
-* Starts islands again below a `withinClientRoot`: the page a hydrating layout keeps as server
-* HTML renders its client components as islands of their own.
-*/
-function isolateIslands(element) {
-	return React.createElement(getContexts().graph.Provider, { value: false }, element);
-}
-const RENDER_STATE_RESOLVER = Symbol.for("islx.react.render-state");
-/**
-* For a framework that knows the request being rendered without React context (a request store):
-* returns the render's settings when no `IslandsProvider` or `renderToStream` gave them. Keep the
-* same `sent` set for the whole response.
-*/
-function setRenderStateResolver(resolve) {
-	globalThis[RENDER_STATE_RESOLVER] = resolve;
-}
-function resolveRenderState() {
-	const resolve = globalThis[RENDER_STATE_RESOLVER];
-	return resolve ? resolve() : null;
-}
-/**
-* Gives islands a render's settings when the framework renders the page itself (not through
-* `renderToStream`): which values the browser holds, and which this render already wrote.
-*/
-function IslandsProvider({ held = null, children }) {
-	const state = React.useMemo(() => ({
-		held: held && held.size > 0 ? held : null,
-		sent: /* @__PURE__ */ new Set()
-	}), [held]);
-	return React.createElement(getContexts().render.Provider, { value: state }, children);
-}
-const SERVER_HOOK = Symbol.for("islx.react.server");
-/** @internal */
-function getIslandServerHook() {
-	return globalThis[SERVER_HOOK];
-}
-/** @internal */
-function setIslandServerHook(hook) {
-	globalThis[SERVER_HOOK] = hook;
-}
-/** Tagged objects the runtime made (slots), as opposed to app data with a "$" key. */
-const runtimeTagged = /* @__PURE__ */ new WeakSet();
-const CONTEXTS = Symbol.for("islx.react.contexts");
-/** @internal */
-function getContexts() {
-	const scope = globalThis;
-	const all = scope[CONTEXTS] ??= /* @__PURE__ */ new WeakMap();
-	let contexts = all.get(React.createElement);
-	if (!contexts) {
-		contexts = {
-			graph: React.createContext(false),
-			render: React.createContext(null)
-		};
-		all.set(React.createElement, contexts);
-	}
-	return contexts;
-}
-function isElement(value) {
-	const type = value?.$$typeof;
-	return type === Symbol.for("react.transitional.element") || type === Symbol.for("react.element");
-}
-const slotStyle = { display: "contents" };
-/**
-* Splits props into what renders on the server and what travels: server output passed to an
-* island (`children`, or any element prop) renders once inside `<f-slot>`, and travels as a
-* reference to it, so the browser reads its HTML from the page instead of receiving it twice.
-*/
-function splitSlots(value, prefix, counter) {
-	if (isElement(value)) {
-		const name = `${prefix}${counter.next++}`;
-		const reference = {
-			["$"]: "s",
-			["v"]: name
-		};
-		runtimeTagged.add(reference);
-		return {
-			render: React.createElement(SLOT_ELEMENT, {
-				key: value.key ?? name,
-				name,
-				style: slotStyle
-			}, value),
-			wire: reference
-		};
-	}
-	if (Array.isArray(value)) {
-		const parts = value.map((entry) => splitSlots(entry, prefix, counter));
-		return {
-			render: parts.map((part) => part.render),
-			wire: parts.map((part) => part.wire)
-		};
-	}
-	if (value && typeof value === "object") {
-		const prototype = Object.getPrototypeOf(value);
-		if (prototype !== Object.prototype && prototype !== null) return {
-			render: value,
-			wire: value
-		};
-		const render = {};
-		const wire = {};
-		for (const [key, entry] of Object.entries(value)) {
-			const part = splitSlots(entry, prefix, counter);
-			render[key] = part.render;
-			wire[key] = part.wire;
-		}
-		return {
-			render,
-			wire
-		};
-	}
-	return {
-		render: value,
-		wire: value
-	};
-}
-const warned = /* @__PURE__ */ new Set();
-const outcomes = /* @__PURE__ */ new WeakMap();
-function settle(promise) {
-	let outcome = outcomes.get(promise);
-	if (!outcome) {
-		outcome = Promise.resolve(promise).then((value) => ({
-			ok: true,
-			value
-		}), (reason) => ({
-			ok: false,
-			reason
-		}));
-		outcomes.set(promise, outcome);
-	}
-	return outcome;
-}
-const REJECTED = "{\"e\":1}";
-/** Each promise an island received, in a boundary of its own: its outcome once it settles. */
-function promiseBoundaries(promises, label) {
-	return promises.map(({ name, promise }) => React.createElement(React.Suspense, {
-		key: name,
-		fallback: null
-	}, React.createElement(IslandPromise, {
-		name,
-		promise,
-		label
-	})));
-}
-/**
-* A promise's outcome, written when it settles. Its values are sent whether or not the page wrote
-* them already: this script may land before an earlier island's, wherever React puts it.
-*/
-function IslandPromise({ name, promise, label }) {
-	const outcome = React.use(settle(promise));
-	const state = React.useContext(getContexts().render) ?? resolveRenderState();
-	const hook = getIslandServerHook();
-	let encoded = {
-		json: REJECTED,
-		values: [],
-		promises: []
-	};
-	if (outcome.ok) try {
-		encoded = hook.encode({ v: outcome.value }, state?.held ?? null);
-	} catch (error) {
-		console.warn(`[islx] A promise passed to ${label} resolved to a value that cannot be sent to the browser: it rejects there.`, error);
-	}
-	else console.error(`[islx] A promise passed to ${label} rejected.`, outcome.reason);
-	return React.createElement(React.Fragment, null, ...encoded.values.map((value) => React.createElement("script", {
-		key: value.key,
-		type: VALUE_SCRIPT_TYPE,
-		name: value.key,
-		dangerouslySetInnerHTML: { __html: hook.escape(value.json) }
-	})), React.createElement("script", {
-		key: "outcome",
-		type: PROMISE_SCRIPT_TYPE,
-		name,
-		dangerouslySetInnerHTML: { __html: hook.escape(encoded.json) }
-	}), ...promiseBoundaries(encoded.promises, label));
-}
-function isThenable(value) {
-	return !!value && typeof value.then === "function";
-}
-/**
-* Wraps a client component so the server renders it as an island. `src` is the module the browser
-* imports, `exportName` the component's export there.
-*/
-function createIsland(Component, src, exportName, strategy = "load") {
-	function Island(props) {
-		const { graph, render } = getContexts();
-		const insideIsland = React.useContext(graph);
-		const state = React.useContext(render) ?? resolveRenderState();
-		const id = React.useId();
-		if (insideIsland) return React.createElement(Component, props);
-		const hook = getIslandServerHook();
-		if (!hook) throw new Error("islx: an island rendered on a server that did not import @farm.js/islx/react/server");
-		let encoded;
-		let renderProps;
-		try {
-			const { render: rendered, wire } = splitSlots(props, `${id}s`, { next: 0 });
-			renderProps = rendered;
-			const skip = state ? /* @__PURE__ */ new Set([...state.held ?? [], ...state.sent]) : null;
-			encoded = hook.encode(wire, skip);
-			for (const value of encoded.values) state?.sent.add(value.key);
-		} catch (error) {
-			if (isThenable(error)) throw error;
-			const message = error instanceof Error ? error.message : String(error);
-			const key = `${src}#${exportName}:${message}`;
-			if (!warned.has(key)) {
-				warned.add(key);
-				console.warn(`[islx] ${exportName} (${src}) was rendered without hydration: its props cannot be sent to the browser. ${message}`);
-			}
-			return React.createElement(Component, props);
-		}
-		if (strategy === "load") for (const href of getBuildDefaults().modules?.[src] ?? []) ReactDOM.preloadModule?.(href, { as: "script" });
-		return React.createElement(React.Fragment, null, ...encoded.values.map((value) => React.createElement("script", {
-			key: value.key,
-			type: VALUE_SCRIPT_TYPE,
-			name: value.key,
-			dangerouslySetInnerHTML: { __html: hook.escape(value.json) }
-		})), React.createElement(ISLAND_ELEMENT, {
-			key: "island",
-			src,
-			export: exportName,
-			props: id,
-			strategy,
-			style: slotStyle
-		}, React.createElement(graph.Provider, { value: true }, React.createElement(Component, renderProps))), React.createElement("script", {
-			key: "props",
-			type: PROPS_SCRIPT_TYPE,
-			htmlFor: id,
-			dangerouslySetInnerHTML: { __html: hook.escape(encoded.json) }
-		}), ...promiseBoundaries(encoded.promises, `${exportName} (${src})`));
-	}
-	Island.displayName = `Island(${Component.displayName || Component.name || exportName})`;
-	Object.defineProperty(Island, CLIENT_REFERENCE, { value: {
-		src,
-		exportName,
-		Component
-	} });
-	return Island;
-}
-export { getIslandServerHook as a, setIslandServerHook as c, getContexts as i, setRenderStateResolver as l, createIsland as n, isolateIslands as o, getClientReference as r, runtimeTagged as s, IslandsProvider as t, withinClientRoot as u };