@takazudo/zfb 0.1.0-next.2

package/dist/content.js.map

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

package/dist/frontmatter.d.ts

@@ -0,0 +1,23 @@
+/** Public shape returned by [`parseFrontmatter`]. */
+export type ParsedFrontmatter = {
+    data: Record<string, unknown>;
+    body: string;
+};
+/**
+ * Parse a leading YAML-ish frontmatter block off a markdown document.
+ *
+ * **Public SDK surface.** Re-exported from `zfb/content` so consumers can
+ * write their own custom content loaders without re-implementing the
+ * (deliberately minimal) v0 frontmatter parser. The accepted grammar is
+ * documented at the top of this module.
+ *
+ * Handles:
+ * - empty frontmatter (`---\n---\nbody`) → `{ data: {}, body: "body" }`
+ * - file ending exactly with `---` (no trailing newline) → frontmatter
+ *   parsed, body is empty.
+ *
+ * Returns `{ data: {}, body: <input> }` unchanged when no frontmatter
+ * fence is present, or when the opening fence has no matching closer.
+ */
+export declare function parseFrontmatter(raw: string): ParsedFrontmatter;
+//# sourceMappingURL=frontmatter.d.ts.map

package/dist/frontmatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.d.ts","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AA4BA,qDAAqD;AACrD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CA2C/D"}

package/dist/frontmatter.js

@@ -0,0 +1,142 @@
+// `zfb/frontmatter` — public subpath for the frontmatter parser.
+//
+// BCI-3: `parseFrontmatter` lives in this dedicated subpath so consumers
+// that only need frontmatter parsing can import it without pulling in
+// `zfb/content`'s Node `fs` transitive dependency chain. Workers / edge
+// bundlers reading user content from a CMS or KV store can therefore
+// use this parser without bringing `node:fs/promises` into their bundle.
+//
+// The implementation lives directly in this module — `zfb/content`
+// imports from here, not the other way around. Tests pin the absence of
+// transitive `node:fs*` imports so a regression that re-introduces the
+// fs dependency surfaces immediately.
+//
+// ---------------------------------------------------------------------------
+// Minimal frontmatter parser. Intentionally NOT a full YAML implementation —
+// the v0 surface accepts the subset documented below. This avoids pulling
+// in `gray-matter` or `js-yaml` for what is, in v0, three field types:
+//
+// - `key: value` scalar (quoted strings unwrapped, ISO dates kept as strings)
+// - `key:` followed by a block list of `- item` lines
+// - blank lines and `#` comment lines are ignored
+//
+// Returns `{ data: {}, body: <input> }` unchanged when no frontmatter
+// fence is present, or when the opening fence has no matching closer.
+// ---------------------------------------------------------------------------
+const FRONTMATTER_DELIM = "---";
+/**
+ * Parse a leading YAML-ish frontmatter block off a markdown document.
+ *
+ * **Public SDK surface.** Re-exported from `zfb/content` so consumers can
+ * write their own custom content loaders without re-implementing the
+ * (deliberately minimal) v0 frontmatter parser. The accepted grammar is
+ * documented at the top of this module.
+ *
+ * Handles:
+ * - empty frontmatter (`---\n---\nbody`) → `{ data: {}, body: "body" }`
+ * - file ending exactly with `---` (no trailing newline) → frontmatter
+ *   parsed, body is empty.
+ *
+ * Returns `{ data: {}, body: <input> }` unchanged when no frontmatter
+ * fence is present, or when the opening fence has no matching closer.
+ */
+export function parseFrontmatter(raw) {
+    // Strip a leading BOM and normalise line endings before splitting.
+    const text = raw.replace(/^/, "").replace(/\r\n/g, "\n");
+    if (!text.startsWith(`${FRONTMATTER_DELIM}\n`)) {
+        return { data: {}, body: text };
+    }
+    const headerStart = FRONTMATTER_DELIM.length + 1; // after first "---\n"
+    // Search for the closing fence. Accept either `\n---\n` (frontmatter
+    // followed by body) or `\n---` at the very end of the document
+    // (frontmatter with no trailing newline). Start the search at
+    // `headerStart - 1` so the empty-frontmatter case `---\n---\n...`
+    // is detected (the `\n---` at index 3 immediately follows the opener).
+    const searchFrom = headerStart - 1;
+    let closeIdx = -1;
+    let bodyStart = -1;
+    let i = searchFrom;
+    while (i <= text.length - `\n${FRONTMATTER_DELIM}`.length) {
+        const candidate = text.indexOf(`\n${FRONTMATTER_DELIM}`, i);
+        if (candidate === -1)
+            break;
+        const afterFence = candidate + `\n${FRONTMATTER_DELIM}`.length;
+        if (afterFence === text.length) {
+            // `\n---` at end-of-string — frontmatter ends here, body is empty.
+            closeIdx = candidate;
+            bodyStart = afterFence;
+            break;
+        }
+        if (text.charAt(afterFence) === "\n") {
+            // `\n---\n` — body starts after the trailing newline.
+            closeIdx = candidate;
+            bodyStart = afterFence + 1;
+            break;
+        }
+        // `\n---` followed by more `-` (e.g. `\n----`) — keep searching.
+        i = candidate + 1;
+    }
+    if (closeIdx === -1 || bodyStart === -1) {
+        // Malformed frontmatter (no closing delimiter): treat as plain body.
+        return { data: {}, body: text };
+    }
+    const header = text.slice(headerStart, closeIdx);
+    const body = text.slice(bodyStart);
+    return { data: parseFrontmatterHeader(header), body };
+}
+function parseFrontmatterHeader(header) {
+    const out = {};
+    const lines = header.split("\n");
+    let i = 0;
+    while (i < lines.length) {
+        const line = lines[i] ?? "";
+        if (line.trim() === "" || line.trimStart().startsWith("#")) {
+            i++;
+            continue;
+        }
+        // Top-level keys are unindented `key: value` or `key:` (then list).
+        const m = /^([A-Za-z_][\w-]*)\s*:\s*(.*)$/.exec(line);
+        if (!m) {
+            i++;
+            continue;
+        }
+        const key = m[1];
+        const inlineValue = (m[2] ?? "").trim();
+        if (inlineValue === "") {
+            // Possible block list.
+            const list = [];
+            let j = i + 1;
+            while (j < lines.length) {
+                const next = lines[j] ?? "";
+                const itemMatch = /^\s*-\s+(.*)$/.exec(next);
+                if (!itemMatch)
+                    break;
+                list.push(unwrapScalar((itemMatch[1] ?? "").trim()));
+                j++;
+            }
+            if (list.length > 0) {
+                out[key] = list;
+                i = j;
+                continue;
+            }
+            // Empty value with no list — record empty string for completeness.
+            out[key] = "";
+            i++;
+            continue;
+        }
+        out[key] = unwrapScalar(inlineValue);
+        i++;
+    }
+    return out;
+}
+function unwrapScalar(value) {
+    if (value.length >= 2) {
+        const first = value.charAt(0);
+        const last = value.charAt(value.length - 1);
+        if ((first === '"' && last === '"') || (first === "'" && last === "'")) {
+            return value.slice(1, -1);
+        }
+    }
+    return value;
+}
+//# sourceMappingURL=frontmatter.js.map

package/dist/frontmatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frontmatter.js","sourceRoot":"","sources":["../src/frontmatter.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,yEAAyE;AACzE,sEAAsE;AACtE,wEAAwE;AACxE,qEAAqE;AACrE,yEAAyE;AACzE,EAAE;AACF,mEAAmE;AACnE,wEAAwE;AACxE,uEAAuE;AACvE,sCAAsC;AACtC,EAAE;AACF,8EAA8E;AAC9E,6EAA6E;AAC7E,0EAA0E;AAC1E,uEAAuE;AACvE,EAAE;AACF,8EAA8E;AAC9E,sDAAsD;AACtD,kDAAkD;AAClD,EAAE;AACF,sEAAsE;AACtE,sEAAsE;AACtE,8EAA8E;AAE9E,MAAM,iBAAiB,GAAG,KAAK,CAAC;AAQhC;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAW;IAC1C,mEAAmE;IACnE,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,iBAAiB,IAAI,CAAC,EAAE,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,WAAW,GAAG,iBAAiB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,sBAAsB;IAExE,qEAAqE;IACrE,+DAA+D;IAC/D,8DAA8D;IAC9D,kEAAkE;IAClE,uEAAuE;IACvE,MAAM,UAAU,GAAG,WAAW,GAAG,CAAC,CAAC;IACnC,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC;IAClB,IAAI,SAAS,GAAG,CAAC,CAAC,CAAC;IACnB,IAAI,CAAC,GAAG,UAAU,CAAC;IACnB,OAAO,CAAC,IAAI,IAAI,CAAC,MAAM,GAAG,KAAK,iBAAiB,EAAE,CAAC,MAAM,EAAE,CAAC;QAC1D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,iBAAiB,EAAE,EAAE,CAAC,CAAC,CAAC;QAC5D,IAAI,SAAS,KAAK,CAAC,CAAC;YAAE,MAAM;QAC5B,MAAM,UAAU,GAAG,SAAS,GAAG,KAAK,iBAAiB,EAAE,CAAC,MAAM,CAAC;QAC/D,IAAI,UAAU,KAAK,IAAI,CAAC,MAAM,EAAE,CAAC;YAC/B,mEAAmE;YACnE,QAAQ,GAAG,SAAS,CAAC;YACrB,SAAS,GAAG,UAAU,CAAC;YACvB,MAAM;QACR,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,KAAK,IAAI,EAAE,CAAC;YACrC,sDAAsD;YACtD,QAAQ,GAAG,SAAS,CAAC;YACrB,SAAS,GAAG,UAAU,GAAG,CAAC,CAAC;YAC3B,MAAM;QACR,CAAC;QACD,iEAAiE;QACjE,CAAC,GAAG,SAAS,GAAG,CAAC,CAAC;IACpB,CAAC;IACD,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACxC,qEAAqE;QACrE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IAClC,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IACnC,OAAO,EAAE,IAAI,EAAE,sBAAsB,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;AACxD,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAc;IAC5C,MAAM,GAAG,GAA4B,EAAE,CAAC;IACxC,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAC3D,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,oEAAoE;QACpE,MAAM,CAAC,GAAG,gCAAgC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAW,CAAC;QAC3B,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,IAAI,WAAW,KAAK,EAAE,EAAE,CAAC;YACvB,uBAAuB;YACvB,MAAM,IAAI,GAAa,EAAE,CAAC;YAC1B,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACd,OAAO,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;gBACxB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC5B,MAAM,SAAS,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC7C,IAAI,CAAC,SAAS;oBAAE,MAAM;gBACtB,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;gBACrD,CAAC,EAAE,CAAC;YACN,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,GAAG,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC;gBAChB,CAAC,GAAG,CAAC,CAAC;gBACN,SAAS;YACX,CAAC;YACD,mEAAmE;YACnE,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC;YACd,CAAC,EAAE,CAAC;YACJ,SAAS;QACX,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,WAAW,CAAC,CAAC;QACrC,CAAC,EAAE,CAAC;IACN,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;QACtB,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;YACvE,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { ANONYMOUS_COMPONENT_NAME, HYDRATE_MARKER_ATTR, Island, SKIP_SSR_MARKER_ATTR, resolveWhen, type IslandElement, type IslandProps, } from "./island.js";
+export { scheduleHydrate, mountIslands, mountNewIslands, cancelPendingIslands, unmountIslands, } from "./runtime.js";
+export type { IslandManifest, IslandManifestValue } from "./runtime.js";
+export { DEFAULT_WHEN, isWhen, WHEN_VALUES, type When } from "./types.js";
+export { definePlugin, type ZfbBuildHookContext, type ZfbDevMiddlewareContext, type ZfbDevMiddlewareHandler, type ZfbDevMiddlewareRequest, type ZfbDevMiddlewareResponse, type ZfbPlugin, type ZfbPluginLogger, } from "./plugins.js";
+export { ContentBlockquote, ContentCode, ContentH2, ContentH3, ContentH4, ContentLink, ContentOl, ContentParagraph, ContentStrong, ContentTable, ContentUl, defaultComponents, type ContentComponentElement, type ContentComponentProps, } from "./content.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAOA,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,MAAM,EACN,oBAAoB,EACpB,WAAW,EACX,KAAK,aAAa,EAClB,KAAK,WAAW,GACjB,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,cAAc,GACf,MAAM,cAAc,CAAC;AACtB,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAE,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAW1E,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,GAC3B,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,21 @@
+// Public entry point for the "@takazudo/zfb" package.
+//
+// User TSX pages reach this module via `import { Island } from "@takazudo/zfb"`.
+// The hydration runtime (Sub 3) reaches the helper via
+// `import { scheduleHydrate } from "@takazudo/zfb/runtime"` (or by inlining the
+// same logic; coordinated separately).
+export { ANONYMOUS_COMPONENT_NAME, HYDRATE_MARKER_ATTR, Island, SKIP_SSR_MARKER_ATTR, resolveWhen, } from "./island.js";
+export { scheduleHydrate, mountIslands, mountNewIslands, cancelPendingIslands, unmountIslands, } from "./runtime.js";
+export { DEFAULT_WHEN, isWhen, WHEN_VALUES } from "./types.js";
+// `defaultComponents` (htmlOverrides convention) is re-exported from the
+// root entry point so `import { defaultComponents } from "@takazudo/zfb"` is the
+// canonical access path. Each named override is also re-exported so
+// consumers can tree-shake-import a single one (`import { ContentLink } from "@takazudo/zfb"`)
+// without dragging in the whole map.
+// Plugin lifecycle types + `definePlugin` identity helper. Plugin
+// authors typically import these from "@takazudo/zfb/plugins" but the
+// root entry re-exports them so simple plugins can pull everything from
+// one path.
+export { definePlugin, } from "./plugins.js";
+export { ContentBlockquote, ContentCode, ContentH2, ContentH3, ContentH4, ContentLink, ContentOl, ContentParagraph, ContentStrong, ContentTable, ContentUl, defaultComponents, } from "./content.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,EAAE;AACF,iFAAiF;AACjF,uDAAuD;AACvD,gFAAgF;AAChF,uCAAuC;AAEvC,OAAO,EACL,wBAAwB,EACxB,mBAAmB,EACnB,MAAM,EACN,oBAAoB,EACpB,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EACL,eAAe,EACf,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,cAAc,GACf,MAAM,cAAc,CAAC;AAEtB,OAAO,EAAE,YAAY,EAAE,MAAM,EAAE,WAAW,EAAa,MAAM,YAAY,CAAC;AAE1E,yEAAyE;AACzE,iFAAiF;AACjF,oEAAoE;AACpE,+FAA+F;AAC/F,qCAAqC;AACrC,kEAAkE;AAClE,sEAAsE;AACtE,wEAAwE;AACxE,YAAY;AACZ,OAAO,EACL,YAAY,GAQb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,iBAAiB,EACjB,WAAW,EACX,SAAS,EACT,SAAS,EACT,SAAS,EACT,WAAW,EACX,SAAS,EACT,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,SAAS,EACT,iBAAiB,GAGlB,MAAM,cAAc,CAAC"}

package/dist/island.d.ts

@@ -0,0 +1,121 @@
+import type { VNode } from "./jsx-types.js";
+import { type When } from "./types.js";
+export { resolveWhen } from "./types.js";
+/**
+ * Marker attribute the SSR wrapper writes when the child component should
+ * be hydrated client-side. The hydration runtime queries
+ * `[data-${HYDRATE_MARKER_ATTR}]` to find islands.
+ */
+export declare const HYDRATE_MARKER_ATTR = "data-zfb-island";
+/**
+ * Marker attribute the SSR wrapper writes when SSR is being skipped (the
+ * client:only-equivalent path). The hydration runtime queries
+ * `[data-${SKIP_SSR_MARKER_ATTR}]` to find these placeholders and renders
+ * the real component into them on hydration — there is no server output
+ * to patch up.
+ */
+export declare const SKIP_SSR_MARKER_ATTR = "data-zfb-island-skip-ssr";
+/** Fallback name surfaced when child identity cannot be determined. */
+export declare const ANONYMOUS_COMPONENT_NAME = "Anonymous";
+/**
+ * Attribute the SSR wrapper writes to ferry the wrapped component's props
+ * across the SSR → hydrate boundary. The hydration runtime parses this
+ * with `JSON.parse` and forwards the result to the per-island `mount()`
+ * call so the hydrated component sees the same props the SSR pass did.
+ *
+ * Omitted entirely when the wrapped child has no own data props (other
+ * than `children`) — `readProps` already falls back to `{}` when the
+ * attribute is missing, and emitting `data-props=""` would just bloat
+ * the SSR markup.
+ */
+export declare const PROPS_DATA_ATTR = "data-props";
+/** Props for `<Island>`. */
+export interface IslandProps {
+    /** Hydration scheduling strategy. Defaults to `"load"`. */
+    when?: When;
+    /**
+     * If supplied, switches the island into SSR-skip mode (Astro's
+     * `client:only` equivalent). The wrapper emits the
+     * `data-zfb-island-skip-ssr` marker, the heavy `children` are **not**
+     * evaluated server-side, and `ssrFallback` is rendered in their place.
+     * On hydration the client runtime swaps in the real component.
+     */
+    ssrFallback?: VNode;
+    /**
+     * Server-rendered children, hydrated client-side once `when` fires.
+     *
+     * Typed as `VNode` (structural union) rather than `ReactNode` so
+     * non-React frameworks can implement `IslandProps` without a React
+     * type dependency (BCI-4).
+     */
+    children?: VNode;
+}
+/**
+ * Public JSX-element shape returned by [`Island`]. Intentionally widened
+ * to a structural type so consumers don't infer through the internal
+ * `{ type, props, key }` VNode shape of either Preact or React. Both
+ * jsx-runtimes accept this object on either side of the boundary.
+ */
+export type IslandElement = {
+    readonly type: string;
+    readonly props: Readonly<Record<string, unknown>>;
+    readonly key: unknown;
+};
+/**
+ * `<Island>` JSX wrapper.
+ *
+ * Returns a JSX element shape compatible with both Preact and React. The
+ * runtime tag is `"div"`. In the default (hydrate) mode the wrapper emits
+ * `data-zfb-island="ComponentName"` and `data-when="<resolved-when>"`. In
+ * SSR-skip mode (when `ssrFallback` is provided) it emits
+ * `data-zfb-island-skip-ssr="ComponentName"` instead and renders the
+ * fallback rather than the heavy child.
+ *
+ * The component-name string is derived from the child JSX element's type
+ * identity (`type.displayName ?? type.name`). For string-typed children
+ * (host elements) the tag name is used. If no usable identity can be
+ * recovered, [`ANONYMOUS_COMPONENT_NAME`] is used so the marker still
+ * lines up with the hydration shim's manifest lookup.
+ *
+ * The return type is the public [`IslandElement`] shape — the internal
+ * VNode structure is deliberately not leaked so consumers never type-infer
+ * through it.
+ */
+export declare function Island(props: IslandProps): IslandElement;
+/**
+ * Pull a component-name string out of a JSX child.
+ *
+ * Both Preact and React store rendered VNodes as plain objects whose
+ * `.type` field is either:
+ * - the component function (look at `displayName ?? name`),
+ * - or the host element tag name as a string.
+ *
+ * If `children` is an array (multiple children), the first child with a
+ * usable identity wins. This is intentional: the typical island shape is
+ * `<Island><Foo /></Island>` (single child); when the caller wraps a
+ * fragment-like list we still want a deterministic, debuggable name.
+ *
+ * Exported for tests; not re-exported from `index.ts`.
+ */
+export declare function captureComponentName(children: unknown): string;
+/**
+ * Serialize the wrapped child's data props as a JSON string the runtime
+ * can parse out of the `data-props` attribute on the Island marker div.
+ *
+ * Mirrors [`captureComponentName`]'s array handling: when `children` is
+ * an array (multiple JSX siblings), the first child whose own props
+ * yield a non-empty serialization wins. This keeps the "first
+ * identifiable child" contract consistent across both attributes —
+ * whatever the marker name points at is what the data-props payload
+ * describes.
+ *
+ * Returns `undefined` (not `"{}"` and not `""`) when no usable props
+ * exist. The runtime's `readProps` already maps a missing attribute to
+ * `{}`, so omitting the attribute keeps the SSR markup smaller and
+ * preserves the invariant that the attribute, when present, always
+ * parses to a non-empty record.
+ *
+ * Exported for tests; not re-exported from `index.ts`.
+ */
+export declare function captureSerializableProps(children: unknown): string | undefined;
+//# sourceMappingURL=island.d.ts.map

package/dist/island.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"island.d.ts","sourceRoot":"","sources":["../src/island.ts"],"names":[],"mappings":"AA0CA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAe,KAAK,IAAI,EAAE,MAAM,YAAY,CAAC;AAMpD,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,oBAAoB,CAAC;AAErD;;;;;;GAMG;AACH,eAAO,MAAM,oBAAoB,6BAA6B,CAAC;AAE/D,uEAAuE;AACvE,eAAO,MAAM,wBAAwB,cAAc,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C,4BAA4B;AAC5B,MAAM,WAAW,WAAW;IAC1B,2DAA2D;IAC3D,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,KAAK,CAAC;IACpB;;;;;;OAMG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,MAAM,aAAa,GAAG;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,aAAa,CAmCxD;AA2BD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,CAS9D;AAgBD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAS9E"}

package/dist/island.js

@@ -0,0 +1,273 @@
+// Build-time `<Island when="...">` JSX wrapper.
+//
+// The wrapper is intentionally JSX-runtime-agnostic: it does not import
+// preact or react and never calls h() / createElement directly. Instead it
+// returns a plain object with a fixed shape that both Preact's and React's
+// jsx-runtime accept when the JSX transform turns the call site into a
+// jsx(Island, props) invocation.
+//
+// At build time, running through the SSR renderer (embedded V8 host):
+//
+//   <Island when="visible"><Counter /></Island>
+//
+// renders as:
+//
+//   <div data-zfb-island="Counter" data-when="visible">
+//     <Counter />
+//   </div>
+//
+// The component-name attribute (`data-zfb-island="ComponentName"`) is filled
+// in *here* by reading the child's JSX type identity (`displayName` first,
+// then `name`). Sub 3's hydration shim then `querySelectorAll`s these
+// markers and looks each one up in the islands manifest produced by the
+// scanner (see `crates/zfb-islands/src/manifest.rs` for the contract).
+//
+// SSR-skip mode: when the caller passes `ssrFallback`, the heavy child is
+// **not** evaluated at SSR time. Instead the wrapper emits a different
+// marker:
+//
+//   <Island ssrFallback={<div>Loading…</div>}><HeavyClientOnly /></Island>
+//   →
+//   <div data-zfb-island-skip-ssr="HeavyClientOnly">
+//     <div>Loading…</div>
+//   </div>
+//
+// On the client the hydration runtime distinguishes hydrate vs. render by
+// which marker attribute is present. This is the equivalent of Astro's
+// `client:only="preact"`.
+//
+// When validation: in development we console.warn for unknown `when`
+// values and fall back to the default. In production we silently fall
+// back to keep the bundle path small.
+import { resolveWhen } from "./types.js";
+// Re-export `resolveWhen` for back-compat: tests and downstream consumers
+// historically imported it from `./island.js`. The implementation lives in
+// `./types.js` so the runtime scheduler can pull it in without dragging
+// the JSX wrapper along for the ride.
+export { resolveWhen } from "./types.js";
+/**
+ * Marker attribute the SSR wrapper writes when the child component should
+ * be hydrated client-side. The hydration runtime queries
+ * `[data-${HYDRATE_MARKER_ATTR}]` to find islands.
+ */
+export const HYDRATE_MARKER_ATTR = "data-zfb-island";
+/**
+ * Marker attribute the SSR wrapper writes when SSR is being skipped (the
+ * client:only-equivalent path). The hydration runtime queries
+ * `[data-${SKIP_SSR_MARKER_ATTR}]` to find these placeholders and renders
+ * the real component into them on hydration — there is no server output
+ * to patch up.
+ */
+export const SKIP_SSR_MARKER_ATTR = "data-zfb-island-skip-ssr";
+/** Fallback name surfaced when child identity cannot be determined. */
+export const ANONYMOUS_COMPONENT_NAME = "Anonymous";
+/**
+ * Attribute the SSR wrapper writes to ferry the wrapped component's props
+ * across the SSR → hydrate boundary. The hydration runtime parses this
+ * with `JSON.parse` and forwards the result to the per-island `mount()`
+ * call so the hydrated component sees the same props the SSR pass did.
+ *
+ * Omitted entirely when the wrapped child has no own data props (other
+ * than `children`) — `readProps` already falls back to `{}` when the
+ * attribute is missing, and emitting `data-props=""` would just bloat
+ * the SSR markup.
+ */
+export const PROPS_DATA_ATTR = "data-props";
+/**
+ * `<Island>` JSX wrapper.
+ *
+ * Returns a JSX element shape compatible with both Preact and React. The
+ * runtime tag is `"div"`. In the default (hydrate) mode the wrapper emits
+ * `data-zfb-island="ComponentName"` and `data-when="<resolved-when>"`. In
+ * SSR-skip mode (when `ssrFallback` is provided) it emits
+ * `data-zfb-island-skip-ssr="ComponentName"` instead and renders the
+ * fallback rather than the heavy child.
+ *
+ * The component-name string is derived from the child JSX element's type
+ * identity (`type.displayName ?? type.name`). For string-typed children
+ * (host elements) the tag name is used. If no usable identity can be
+ * recovered, [`ANONYMOUS_COMPONENT_NAME`] is used so the marker still
+ * lines up with the hydration shim's manifest lookup.
+ *
+ * The return type is the public [`IslandElement`] shape — the internal
+ * VNode structure is deliberately not leaked so consumers never type-infer
+ * through it.
+ */
+export function Island(props) {
+    const when = resolveWhen(props.when);
+    const componentName = captureComponentName(props.children);
+    const isSkipSsr = props.ssrFallback !== undefined;
+    // Always source props from `props.children` (the heavy component VNode),
+    // never from `ssrFallback` — the fallback is just SSR placeholder markup;
+    // the hydrated component is the child, so its props are what `mount()`
+    // needs at hydrate time. (Same rationale as `captureComponentName`.)
+    const dataProps = captureSerializableProps(props.children);
+    if (isSkipSsr) {
+        const skipSsrProps = {
+            [SKIP_SSR_MARKER_ATTR]: componentName,
+            "data-when": when,
+            children: props.ssrFallback ?? null,
+        };
+        if (dataProps !== undefined)
+            skipSsrProps[PROPS_DATA_ATTR] = dataProps;
+        return makeVNode({
+            type: "div",
+            props: skipSsrProps,
+            key: null,
+        });
+    }
+    const hydrateProps = {
+        [HYDRATE_MARKER_ATTR]: componentName,
+        "data-when": when,
+        children: props.children,
+    };
+    if (dataProps !== undefined)
+        hydrateProps[PROPS_DATA_ATTR] = dataProps;
+    return makeVNode({
+        type: "div",
+        props: hydrateProps,
+        key: null,
+    });
+}
+/**
+ * Construct the structural JSX-element shape with `constructor` set to
+ * `undefined`.
+ *
+ * Why: `preact-render-to-string` (and Preact's diff path) recognise a
+ * VNode by checking `vnode.constructor === undefined`. A plain object
+ * literal `{ type, props, key }` inherits `Object` for `.constructor`,
+ * so the renderer treats it as foreign data and emits no markup —
+ * which would silently strip every `<Island>` from SSG output. Marking
+ * `constructor: undefined` is the documented sentinel that both
+ * Preact's and React's renderers treat as a structural VNode.
+ *
+ * The cast back to `IslandElement` keeps the public type tight; the
+ * extra runtime field is JS-only and is invisible to type consumers.
+ */
+function makeVNode(shape) {
+    const v = shape;
+    v.constructor = undefined;
+    return shape;
+}
+/**
+ * Pull a component-name string out of a JSX child.
+ *
+ * Both Preact and React store rendered VNodes as plain objects whose
+ * `.type` field is either:
+ * - the component function (look at `displayName ?? name`),
+ * - or the host element tag name as a string.
+ *
+ * If `children` is an array (multiple children), the first child with a
+ * usable identity wins. This is intentional: the typical island shape is
+ * `<Island><Foo /></Island>` (single child); when the caller wraps a
+ * fragment-like list we still want a deterministic, debuggable name.
+ *
+ * Exported for tests; not re-exported from `index.ts`.
+ */
+export function captureComponentName(children) {
+    if (Array.isArray(children)) {
+        for (const child of children) {
+            const name = nameFromSingle(child);
+            if (name)
+                return name;
+        }
+        return ANONYMOUS_COMPONENT_NAME;
+    }
+    return nameFromSingle(children) || ANONYMOUS_COMPONENT_NAME;
+}
+function nameFromSingle(child) {
+    if (!child || typeof child !== "object")
+        return "";
+    const c = child;
+    const t = c.type;
+    if (typeof t === "function") {
+        const fn = t;
+        if (typeof fn.displayName === "string" && fn.displayName)
+            return fn.displayName;
+        if (typeof fn.name === "string" && fn.name)
+            return fn.name;
+        return "";
+    }
+    if (typeof t === "string" && t)
+        return t;
+    return "";
+}
+/**
+ * Serialize the wrapped child's data props as a JSON string the runtime
+ * can parse out of the `data-props` attribute on the Island marker div.
+ *
+ * Mirrors [`captureComponentName`]'s array handling: when `children` is
+ * an array (multiple JSX siblings), the first child whose own props
+ * yield a non-empty serialization wins. This keeps the "first
+ * identifiable child" contract consistent across both attributes —
+ * whatever the marker name points at is what the data-props payload
+ * describes.
+ *
+ * Returns `undefined` (not `"{}"` and not `""`) when no usable props
+ * exist. The runtime's `readProps` already maps a missing attribute to
+ * `{}`, so omitting the attribute keeps the SSR markup smaller and
+ * preserves the invariant that the attribute, when present, always
+ * parses to a non-empty record.
+ *
+ * Exported for tests; not re-exported from `index.ts`.
+ */
+export function captureSerializableProps(children) {
+    if (Array.isArray(children)) {
+        for (const child of children) {
+            const json = propsFromSingle(child);
+            if (json !== undefined)
+                return json;
+        }
+        return undefined;
+    }
+    return propsFromSingle(children);
+}
+function propsFromSingle(child) {
+    if (!child || typeof child !== "object")
+        return undefined;
+    const c = child;
+    const raw = c.props;
+    if (!raw || typeof raw !== "object" || Array.isArray(raw))
+        return undefined;
+    // Exclude `children` from the serialized payload: the SSR pass already
+    // emitted the rendered children into the DOM (the hydration target),
+    // and JSX child nodes are typically VNode trees with non-serializable
+    // shapes (functions, circular refs) that would either bloat the
+    // payload or throw inside JSON.stringify. The hydration runtime
+    // re-renders into the existing DOM, so it does not need the JSX
+    // children replayed through props.
+    //
+    // Note: JSON.stringify already silently drops function / symbol /
+    // undefined values from the output, so those don't need explicit
+    // pre-filtering here.
+    const propsRecord = raw;
+    let hasOwn = false;
+    const filtered = {};
+    for (const key of Object.keys(propsRecord)) {
+        if (key === "children")
+            continue;
+        filtered[key] = propsRecord[key];
+        hasOwn = true;
+    }
+    if (!hasOwn)
+        return undefined;
+    let json;
+    try {
+        json = JSON.stringify(filtered);
+    }
+    catch {
+        // Circular references, BigInt, or any other non-serializable input
+        // — silently fall through (no `data-props`) rather than ship a
+        // partial payload. The runtime already handles the missing-attribute
+        // case by returning `{}` from `readProps`.
+        return undefined;
+    }
+    // JSON.stringify can also return `undefined` (when the top-level value
+    // serializes to nothing) or `"{}"` (when every key was a function /
+    // symbol / undefined and got dropped). Treat both as "nothing useful
+    // to ship" so the marker stays clean.
+    if (json === undefined || json === "{}")
+        return undefined;
+    return json;
+}
+//# sourceMappingURL=island.js.map

package/dist/island.js.map

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