@reckona/mreact-server 0.0.81 → 0.0.83

package/dist/boundary.d.ts

@@ -0,0 +1,39 @@
+import type { HtmlSink } from "@reckona/mreact-shared/compiler-contract";
+export interface AsyncBoundaryOptions {
+    catch?: (sink: HtmlSink, error: unknown) => void | PromiseLike<void>;
+    hydrationAwaitId?: string;
+}
+export interface OutOfOrderBoundaryOptions extends AsyncBoundaryOptions {
+    hydration?: boolean;
+    placeholder?: (sink: HtmlSink) => void | PromiseLike<void>;
+    placeholderTag?: string;
+}
+export interface OutOfOrderReorderScriptOptions {
+    nonce?: string;
+    src?: string;
+}
+export interface HydrationScriptOptions {
+    nonce?: string;
+}
+export interface ReactSuspenseScriptOptions {
+    nonce?: string;
+    src?: string;
+}
+export interface ReactSuspenseBoundaryOptions extends AsyncBoundaryOptions {
+    fallback?: (sink: HtmlSink) => void | PromiseLike<void>;
+    nonce?: string;
+}
+export interface ReactSuspenseClientRenderOptions {
+    message?: string;
+    stack?: string;
+}
+export type AsyncBoundaryRender<T> = (sink: HtmlSink, value: Awaited<T>) => void | PromiseLike<void>;
+export declare function renderAsyncBoundary<T>(sink: HtmlSink, value: T, render: AsyncBoundaryRender<T>, options?: AsyncBoundaryOptions): Promise<void>;
+export declare function renderOutOfOrderBoundary<T>(sink: HtmlSink, id: string, value: T, render: AsyncBoundaryRender<T>, options?: OutOfOrderBoundaryOptions): void;
+export declare function renderOutOfOrderReorderScript(sink: HtmlSink, options?: OutOfOrderReorderScriptOptions): void;
+export declare function renderReactSuspenseBoundary(sink: HtmlSink, render: (sink: HtmlSink) => void | PromiseLike<void>): void | PromiseLike<void>;
+export declare function renderReactSuspenseOutOfOrderBoundary<T>(sink: HtmlSink, boundaryId: string, segmentId: string, value: T, render: AsyncBoundaryRender<T>, options?: ReactSuspenseBoundaryOptions): void;
+export declare function renderReactSuspenseClientRenderBoundary(sink: HtmlSink, fallback: (sink: HtmlSink) => void | PromiseLike<void>, options?: ReactSuspenseClientRenderOptions): void | PromiseLike<void>;
+export declare function renderHydrationBoundary(sink: HtmlSink, id: string, render: (sink: HtmlSink) => void | PromiseLike<void>): void | PromiseLike<void>;
+export declare const reactSuspenseRevealExternalScript = "(()=>{(self.$RC=self.$RC||function(bid,sid){var b=document.getElementById(bid);var s=document.getElementById(sid);if(!b||!s)return;var p=b.parentNode;var e=b.nextSibling;var d=0;var r=[];for(var n=e;n;n=n.nextSibling){if(n.nodeType===8){if(n.data===\"$\"||n.data===\"$?\"||n.data===\"$!\")d++;else if(n.data===\"/$\"){if(d===0){e=n;break;}d--;}}r.push(n);}for(var i=0;r[i];i++)p.removeChild(r[i]);while(s.firstChild)p.insertBefore(s.firstChild,e);s.remove();b.data=\"$\";});var s=document.currentScript;if(!s)return;var b=s.getAttribute(\"data-boundary-id\");var seg=s.getAttribute(\"data-segment-id\");if(b!==null&&seg!==null)self.$RC(b,seg);})();";
+//# sourceMappingURL=boundary.d.ts.map

package/dist/boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.d.ts","sourceRoot":"","sources":["../src/boundary.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AASzE,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACrE,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,yBAA0B,SAAQ,oBAAoB;IACrE,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,8BAA8B;IAC7C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,4BAA6B,SAAQ,oBAAoB;IACxE,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,gCAAgC;IAC/C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CACnC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,KACd,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;AAI9B,wBAAsB,mBAAmB,CAAC,CAAC,EACzC,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE,oBAAyB,GACjC,OAAO,CAAC,IAAI,CAAC,CAgBf;AA+ID,wBAAgB,wBAAwB,CAAC,CAAC,EACxC,IAAI,EAAE,QAAQ,EACd,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE,yBAA8B,GACtC,IAAI,CAqBN;AA2CD,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,QAAQ,EACd,OAAO,GAAE,8BAAmC,GAC3C,IAAI,CAcN;AAED,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,QAAQ,EACd,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,GACnD,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAW1B;AAED,wBAAgB,qCAAqC,CAAC,CAAC,EACrD,IAAI,EAAE,QAAQ,EACd,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,CAAC,EACR,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,EAC9B,OAAO,GAAE,4BAAiC,GACzC,IAAI,CAyBN;AAgBD,wBAAgB,uCAAuC,CACrD,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,EACtD,OAAO,GAAE,gCAAqC,GAC7C,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAW1B;AA4CD,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,QAAQ,EACd,EAAE,EAAE,MAAM,EACV,MAAM,EAAE,CAAC,IAAI,EAAE,QAAQ,KAAK,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,GACnD,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,CAY1B;AAUD,eAAO,MAAM,iCAAiC,6oBAAsN,CAAC"}

package/dist/boundary.js

@@ -0,0 +1,249 @@
+import { escapeAttribute, isPromiseLikeUnknown, renderNonceAttribute, serializeScriptJson, } from "./html-internals.js";
+import { createStringSink } from "./sink.js";
+const outOfOrderBoundaryInstances = new WeakMap();
+export async function renderAsyncBoundary(sink, value, render, options = {}) {
+    try {
+        const resolved = await value;
+        await sink.backpressure?.();
+        await render(sink, resolved);
+        if (options.hydrationAwaitId !== undefined) {
+            appendAwaitHydrationData(sink, options.hydrationAwaitId, resolved);
+        }
+    }
+    catch (error) {
+        if (options.catch === undefined) {
+            throw error;
+        }
+        await sink.backpressure?.();
+        await options.catch(sink, error);
+    }
+}
+// Threshold for `<Await>` payload size warnings (UTF-8 byte length of
+// JSON-serialized representation). 100KB warn / 1MB error follow the
+// "you're sending a lot of data" hint pattern used by other frameworks.
+const AWAIT_PAYLOAD_WARN_BYTES = 100 * 1024;
+const AWAIT_PAYLOAD_ERROR_BYTES = 1024 * 1024;
+function isProductionMode() {
+    // `process` may not exist in cross-runtime environments (Cloudflare/Deno).
+    // The server tsconfig does not include `@types/node`, so we look it up
+    // through `globalThis` with a minimal local typing.
+    const globalProcess = globalThis
+        .process;
+    try {
+        return globalProcess?.env?.["NODE_ENV"] === "production";
+    }
+    catch {
+        return false;
+    }
+}
+function appendAwaitHydrationData(sink, awaitId, resolved) {
+    const serialized = serializeAwaitHydrationValue(resolved, awaitId);
+    if (serialized === undefined) {
+        return;
+    }
+    const idLiteral = JSON.stringify(awaitId).replaceAll("<", "\\u003c");
+    sink.append(`<script data-mreact-await=${idLiteral}>(self.__mreactAwaitData||(self.__mreactAwaitData={}))[${idLiteral}]={value:${serialized}}</script>`);
+}
+// Emits a single console.warn in dev when `resolved` contains shapes the
+// wire format will silently drop or coerce (Date / Map / Set / RegExp /
+// class instance / function / Symbol / nested non-POJO).
+function warnIfNonSerializableAwaitValue(value, awaitId) {
+    if (isProductionMode()) {
+        return;
+    }
+    if (!containsNonSerializableSurface(value)) {
+        return;
+    }
+    console.warn(`[mreact] <Await value={...}> for "${awaitId}" includes non-serializable ` +
+        `data (Date / Map / Set / RegExp / class instance / function / Symbol). ` +
+        `The wire format uses JSON.stringify, so the client-side renderer may ` +
+        `receive a different shape after the JSON round-trip. Convert to plain ` +
+        `JSON-serializable data before it reaches <Await>. See ` +
+        `https://github.com/t-k/mreact#streaming-loading-and-await.`);
+}
+function containsNonSerializableSurface(value) {
+    if (value === null || value === undefined || typeof value !== "object") {
+        return false;
+    }
+    if (value instanceof Date || value instanceof Map || value instanceof Set || value instanceof RegExp) {
+        return true;
+    }
+    if (Array.isArray(value)) {
+        return value.some((entry) => containsNonSerializableSurface(entry));
+    }
+    const proto = Object.getPrototypeOf(value);
+    if (proto !== Object.prototype && proto !== null) {
+        return true;
+    }
+    for (const entry of Object.values(value)) {
+        if (containsNonSerializableSurface(entry)) {
+            return true;
+        }
+    }
+    return false;
+}
+function reportAwaitPayloadSize(json, awaitId) {
+    const byteLength = typeof TextEncoder !== "undefined" ? new TextEncoder().encode(json).length : json.length;
+    if (byteLength > AWAIT_PAYLOAD_ERROR_BYTES) {
+        console.error(`[mreact] <Await> payload for "${awaitId}" is ${(byteLength / 1024 / 1024).toFixed(2)}MB, ` +
+            `exceeding the 1MB error threshold. Large payloads inflate HTML response size and ` +
+            `client memory pressure. Stream the data via loader or split into smaller boundaries.`);
+        return;
+    }
+    if (byteLength > AWAIT_PAYLOAD_WARN_BYTES) {
+        console.warn(`[mreact] large await payload for "${awaitId}": ${(byteLength / 1024).toFixed(1)}KB ` +
+            `(over the 100KB warning threshold). Consider streaming the data via loader or ` +
+            `splitting into smaller boundaries.`);
+    }
+}
+function serializeAwaitHydrationValue(value, awaitId) {
+    try {
+        const json = JSON.stringify(value);
+        if (json === undefined) {
+            return undefined;
+        }
+        warnIfNonSerializableAwaitValue(value, awaitId);
+        reportAwaitPayloadSize(json, awaitId);
+        // Defuse `</script>` and runaway control characters so the data can be
+        // safely embedded inside a `<script>` element.
+        return json
+            .replaceAll("<", "\\u003c")
+            .replaceAll("\u2028", "\\u2028")
+            .replaceAll("\u2029", "\\u2029");
+    }
+    catch {
+        return undefined;
+    }
+}
+function inheritBackpressure(childSink, parentSink) {
+    if (parentSink.backpressure === undefined) {
+        return childSink;
+    }
+    return {
+        ...childSink,
+        backpressure: parentSink.backpressure,
+    };
+}
+export function renderOutOfOrderBoundary(sink, id, value, render, options = {}) {
+    const boundaryId = nextOutOfOrderBoundaryInstanceId(sink, id);
+    const placeholderSink = createStringSink();
+    void options.placeholder?.(placeholderSink);
+    const placeholderTag = normalizeOutOfOrderPlaceholderTag(options.placeholderTag);
+    const hydrationStart = options.hydration === true ? `<!--mreact-h:start:${encodeURIComponent(boundaryId)}-->` : "";
+    const hydrationEnd = options.hydration === true ? `<!--mreact-h:end:${encodeURIComponent(boundaryId)}-->` : "";
+    sink.append(`${hydrationStart}<${placeholderTag} data-mreact-oob-placeholder="${escapeAttribute(boundaryId)}">${placeholderSink.toString()}</${placeholderTag}>${hydrationEnd}`);
+    const task = renderOutOfOrderFragment(sink, boundaryId, value, render, options);
+    if (sink.defer === undefined) {
+        void task;
+        return;
+    }
+    sink.defer(task);
+}
+function normalizeOutOfOrderPlaceholderTag(tag) {
+    if (typeof tag !== "string") {
+        return "span";
+    }
+    const normalized = tag.trim().toLowerCase();
+    return /^[a-z][a-z0-9-]*$/.test(normalized) ? normalized : "span";
+}
+async function renderOutOfOrderFragment(sink, id, value, render, options) {
+    const fragmentSink = inheritBackpressure(createStringSink(), sink);
+    let resolvedValue;
+    let hasResolvedValue = false;
+    await renderAsyncBoundary(fragmentSink, value, async (childSink, resolved) => {
+        resolvedValue = resolved;
+        hasResolvedValue = true;
+        await render(childSink, resolved);
+    }, options.catch === undefined ? {} : { catch: options.catch });
+    await fragmentSink.drain();
+    sink.append(`<template data-mreact-oob-fragment="${escapeAttribute(id)}">${fragmentSink.toString()}</template>`);
+    if (hasResolvedValue && options.hydrationAwaitId !== undefined) {
+        appendAwaitHydrationData(sink, options.hydrationAwaitId, resolvedValue);
+    }
+}
+export function renderOutOfOrderReorderScript(sink, options = {}) {
+    const nonceAttribute = options.nonce === undefined ? "" : ` nonce="${escapeAttribute(options.nonce)}"`;
+    if (options.src !== undefined) {
+        sink.append(`<script data-mreact-oob-reorder${nonceAttribute} src="${escapeAttribute(options.src)}"></script>`);
+        return;
+    }
+    sink.append(`<script data-mreact-oob-reorder${nonceAttribute}>${outOfOrderReorderScript}</script>`);
+}
+export function renderReactSuspenseBoundary(sink, render) {
+    sink.append("<!--$-->");
+    const result = render(sink);
+    if (isPromiseLike(result)) {
+        return result.then(() => {
+            sink.append("<!--/$-->");
+        });
+    }
+    sink.append("<!--/$-->");
+}
+export function renderReactSuspenseOutOfOrderBoundary(sink, boundaryId, segmentId, value, render, options = {}) {
+    const actualBoundaryId = nextOutOfOrderBoundaryInstanceId(sink, boundaryId);
+    const suffix = actualBoundaryId.slice(boundaryId.length);
+    const actualSegmentId = `${segmentId}${suffix}`;
+    const fallbackSink = createStringSink();
+    void options.fallback?.(fallbackSink);
+    sink.append(`<!--$?--><template id="${escapeAttribute(actualBoundaryId)}"></template>${fallbackSink.toString()}<!--/$-->`);
+    const task = renderReactSuspenseSegment(sink, actualBoundaryId, actualSegmentId, value, render, options);
+    if (sink.defer === undefined) {
+        void task;
+        return;
+    }
+    sink.defer(task);
+}
+function nextOutOfOrderBoundaryInstanceId(sink, id) {
+    let instances = outOfOrderBoundaryInstances.get(sink);
+    if (instances === undefined) {
+        instances = new Map();
+        outOfOrderBoundaryInstances.set(sink, instances);
+    }
+    const count = instances.get(id) ?? 0;
+    instances.set(id, count + 1);
+    return count === 0 ? id : `${id}-${count.toString(36)}`;
+}
+export function renderReactSuspenseClientRenderBoundary(sink, fallback, options = {}) {
+    sink.append(`<!--$!--><template${renderReactSuspenseErrorAttributes(options)}></template>`);
+    const result = fallback(sink);
+    if (isPromiseLike(result)) {
+        return result.then(() => {
+            sink.append("<!--/$-->");
+        });
+    }
+    sink.append("<!--/$-->");
+}
+async function renderReactSuspenseSegment(sink, boundaryId, segmentId, value, render, options) {
+    const segmentSink = inheritBackpressure(createStringSink(), sink);
+    await renderAsyncBoundary(segmentSink, value, render, options.catch === undefined ? {} : { catch: options.catch });
+    sink.append(`<div hidden id="${escapeAttribute(segmentId)}">${segmentSink.toString()}</div>${renderReactSuspenseRevealScript(boundaryId, segmentId, options)}`);
+}
+function renderReactSuspenseErrorAttributes(options) {
+    const message = options.message === undefined ? "" : ` data-msg="${escapeAttribute(options.message)}"`;
+    const stack = options.stack === undefined ? "" : ` data-stck="${escapeAttribute(options.stack)}"`;
+    return `${message}${stack}`;
+}
+function renderReactSuspenseRevealScript(boundaryId, segmentId, options = {}) {
+    if (options.src !== undefined) {
+        return `<script data-mreact-react-suspense-reveal${renderNonceAttribute(options.nonce)} src="${escapeAttribute(options.src)}" data-boundary-id="${escapeAttribute(boundaryId)}" data-segment-id="${escapeAttribute(segmentId)}"></script>`;
+    }
+    return `<script${renderNonceAttribute(options.nonce)}>${reactSuspenseRevealScriptBody};$RC(${serializeScriptJson(boundaryId)},${serializeScriptJson(segmentId)})</script>`;
+}
+export function renderHydrationBoundary(sink, id, render) {
+    const markerId = encodeURIComponent(id);
+    sink.append(`<!--mreact-h:start:${markerId}-->`);
+    const result = render(sink);
+    if (isPromiseLike(result)) {
+        return result.then(() => {
+            sink.append(`<!--mreact-h:end:${markerId}-->`);
+        });
+    }
+    sink.append(`<!--mreact-h:end:${markerId}-->`);
+}
+function isPromiseLike(value) {
+    return isPromiseLikeUnknown(value);
+}
+const outOfOrderReorderScript = `(()=>{function apply(root){const fragments=Array.from(root.querySelectorAll("template[data-mreact-oob-fragment]"));for(const fragment of fragments){const id=fragment.getAttribute("data-mreact-oob-fragment");if(id===null)continue;const placeholders=Array.from(root.querySelectorAll("[data-mreact-oob-placeholder]"));const placeholder=placeholders.find((candidate)=>candidate.getAttribute("data-mreact-oob-placeholder")===id);if(placeholder===undefined)continue;placeholder.replaceWith(fragment.content.cloneNode(true));fragment.remove();}}apply(document);new MutationObserver(()=>apply(document)).observe(document.documentElement,{childList:true,subtree:true});})();`;
+const reactSuspenseRevealScriptBody = `(self.$RC=self.$RC||function(bid,sid){var b=document.getElementById(bid);var s=document.getElementById(sid);if(!b||!s)return;var p=b.parentNode;var e=b.nextSibling;var d=0;var r=[];for(var n=e;n;n=n.nextSibling){if(n.nodeType===8){if(n.data==="$"||n.data==="$?"||n.data==="$!")d++;else if(n.data==="/$"){if(d===0){e=n;break;}d--;}}r.push(n);}for(var i=0;r[i];i++)p.removeChild(r[i]);while(s.firstChild)p.insertBefore(s.firstChild,e);s.remove();b.data="$";})`;
+export const reactSuspenseRevealExternalScript = `(()=>{${reactSuspenseRevealScriptBody};var s=document.currentScript;if(!s)return;var b=s.getAttribute("data-boundary-id");var seg=s.getAttribute("data-segment-id");if(b!==null&&seg!==null)self.$RC(b,seg);})();`;
+//# sourceMappingURL=boundary.js.map

package/dist/boundary.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boundary.js","sourceRoot":"","sources":["../src/boundary.ts"],"names":[],"mappings":"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","sourcesContent":["import type { HtmlSink } from \"@reckona/mreact-shared/compiler-contract\";\nimport {\n  escapeAttribute,\n  isPromiseLikeUnknown,\n  renderNonceAttribute,\n  serializeScriptJson,\n} from \"./html-internals.js\";\nimport { createStringSink, type StringHtmlSink } from \"./sink.js\";\n\nexport interface AsyncBoundaryOptions {\n  catch?: (sink: HtmlSink, error: unknown) => void | PromiseLike<void>;\n  hydrationAwaitId?: string;\n}\n\nexport interface OutOfOrderBoundaryOptions extends AsyncBoundaryOptions {\n  hydration?: boolean;\n  placeholder?: (sink: HtmlSink) => void | PromiseLike<void>;\n  placeholderTag?: string;\n}\n\nexport interface OutOfOrderReorderScriptOptions {\n  nonce?: string;\n  src?: string;\n}\n\nexport interface HydrationScriptOptions {\n  nonce?: string;\n}\n\nexport interface ReactSuspenseScriptOptions {\n  nonce?: string;\n  src?: string;\n}\n\nexport interface ReactSuspenseBoundaryOptions extends AsyncBoundaryOptions {\n  fallback?: (sink: HtmlSink) => void | PromiseLike<void>;\n  nonce?: string;\n}\n\nexport interface ReactSuspenseClientRenderOptions {\n  message?: string;\n  stack?: string;\n}\n\nexport type AsyncBoundaryRender<T> = (\n  sink: HtmlSink,\n  value: Awaited<T>,\n) => void | PromiseLike<void>;\n\nconst outOfOrderBoundaryInstances = new WeakMap<HtmlSink, Map<string, number>>();\n\nexport async function renderAsyncBoundary<T>(\n  sink: HtmlSink,\n  value: T,\n  render: AsyncBoundaryRender<T>,\n  options: AsyncBoundaryOptions = {},\n): Promise<void> {\n  try {\n    const resolved = await value;\n    await sink.backpressure?.();\n    await render(sink, resolved);\n    if (options.hydrationAwaitId !== undefined) {\n      appendAwaitHydrationData(sink, options.hydrationAwaitId, resolved);\n    }\n  } catch (error) {\n    if (options.catch === undefined) {\n      throw error;\n    }\n\n    await sink.backpressure?.();\n    await options.catch(sink, error);\n  }\n}\n\n// Threshold for `<Await>` payload size warnings (UTF-8 byte length of\n// JSON-serialized representation). 100KB warn / 1MB error follow the\n// \"you're sending a lot of data\" hint pattern used by other frameworks.\nconst AWAIT_PAYLOAD_WARN_BYTES = 100 * 1024;\nconst AWAIT_PAYLOAD_ERROR_BYTES = 1024 * 1024;\n\nfunction isProductionMode(): boolean {\n  // `process` may not exist in cross-runtime environments (Cloudflare/Deno).\n  // The server tsconfig does not include `@types/node`, so we look it up\n  // through `globalThis` with a minimal local typing.\n  const globalProcess = (globalThis as { process?: { env?: Record<string, string | undefined> } })\n    .process;\n\n  try {\n    return globalProcess?.env?.[\"NODE_ENV\"] === \"production\";\n  } catch {\n    return false;\n  }\n}\n\nfunction appendAwaitHydrationData(\n  sink: HtmlSink,\n  awaitId: string,\n  resolved: unknown,\n): void {\n  const serialized = serializeAwaitHydrationValue(resolved, awaitId);\n\n  if (serialized === undefined) {\n    return;\n  }\n\n  const idLiteral = JSON.stringify(awaitId).replaceAll(\"<\", \"\\\\u003c\");\n  sink.append(\n    `<script data-mreact-await=${idLiteral}>(self.__mreactAwaitData||(self.__mreactAwaitData={}))[${idLiteral}]={value:${serialized}}</script>`,\n  );\n}\n\n// Emits a single console.warn in dev when `resolved` contains shapes the\n// wire format will silently drop or coerce (Date / Map / Set / RegExp /\n// class instance / function / Symbol / nested non-POJO).\nfunction warnIfNonSerializableAwaitValue(value: unknown, awaitId: string): void {\n  if (isProductionMode()) {\n    return;\n  }\n\n  if (!containsNonSerializableSurface(value)) {\n    return;\n  }\n\n  console.warn(\n    `[mreact] <Await value={...}> for \"${awaitId}\" includes non-serializable ` +\n      `data (Date / Map / Set / RegExp / class instance / function / Symbol). ` +\n      `The wire format uses JSON.stringify, so the client-side renderer may ` +\n      `receive a different shape after the JSON round-trip. Convert to plain ` +\n      `JSON-serializable data before it reaches <Await>. See ` +\n      `https://github.com/t-k/mreact#streaming-loading-and-await.`,\n  );\n}\n\nfunction containsNonSerializableSurface(value: unknown): boolean {\n  if (value === null || value === undefined || typeof value !== \"object\") {\n    return false;\n  }\n\n  if (value instanceof Date || value instanceof Map || value instanceof Set || value instanceof RegExp) {\n    return true;\n  }\n\n  if (Array.isArray(value)) {\n    return value.some((entry) => containsNonSerializableSurface(entry));\n  }\n\n  const proto = Object.getPrototypeOf(value);\n\n  if (proto !== Object.prototype && proto !== null) {\n    return true;\n  }\n\n  for (const entry of Object.values(value as Record<string, unknown>)) {\n    if (containsNonSerializableSurface(entry)) {\n      return true;\n    }\n  }\n\n  return false;\n}\n\nfunction reportAwaitPayloadSize(json: string, awaitId: string): void {\n  const byteLength =\n    typeof TextEncoder !== \"undefined\" ? new TextEncoder().encode(json).length : json.length;\n\n  if (byteLength > AWAIT_PAYLOAD_ERROR_BYTES) {\n    console.error(\n      `[mreact] <Await> payload for \"${awaitId}\" is ${(byteLength / 1024 / 1024).toFixed(2)}MB, ` +\n        `exceeding the 1MB error threshold. Large payloads inflate HTML response size and ` +\n        `client memory pressure. Stream the data via loader or split into smaller boundaries.`,\n    );\n    return;\n  }\n\n  if (byteLength > AWAIT_PAYLOAD_WARN_BYTES) {\n    console.warn(\n      `[mreact] large await payload for \"${awaitId}\": ${(byteLength / 1024).toFixed(1)}KB ` +\n        `(over the 100KB warning threshold). Consider streaming the data via loader or ` +\n        `splitting into smaller boundaries.`,\n    );\n  }\n}\n\nfunction serializeAwaitHydrationValue(value: unknown, awaitId: string): string | undefined {\n  try {\n    const json = JSON.stringify(value);\n    if (json === undefined) {\n      return undefined;\n    }\n\n    warnIfNonSerializableAwaitValue(value, awaitId);\n    reportAwaitPayloadSize(json, awaitId);\n\n    // Defuse `</script>` and runaway control characters so the data can be\n    // safely embedded inside a `<script>` element.\n    return json\n      .replaceAll(\"<\", \"\\\\u003c\")\n      .replaceAll(\"\\u2028\", \"\\\\u2028\")\n      .replaceAll(\"\\u2029\", \"\\\\u2029\");\n  } catch {\n    return undefined;\n  }\n}\n\nfunction inheritBackpressure(childSink: StringHtmlSink, parentSink: HtmlSink): StringHtmlSink {\n  if (parentSink.backpressure === undefined) {\n    return childSink;\n  }\n\n  return {\n    ...childSink,\n    backpressure: parentSink.backpressure,\n  };\n}\n\nexport function renderOutOfOrderBoundary<T>(\n  sink: HtmlSink,\n  id: string,\n  value: T,\n  render: AsyncBoundaryRender<T>,\n  options: OutOfOrderBoundaryOptions = {},\n): void {\n  const boundaryId = nextOutOfOrderBoundaryInstanceId(sink, id);\n  const placeholderSink = createStringSink();\n  void options.placeholder?.(placeholderSink);\n  const placeholderTag = normalizeOutOfOrderPlaceholderTag(options.placeholderTag);\n  const hydrationStart =\n    options.hydration === true ? `<!--mreact-h:start:${encodeURIComponent(boundaryId)}-->` : \"\";\n  const hydrationEnd =\n    options.hydration === true ? `<!--mreact-h:end:${encodeURIComponent(boundaryId)}-->` : \"\";\n  sink.append(\n    `${hydrationStart}<${placeholderTag} data-mreact-oob-placeholder=\"${escapeAttribute(boundaryId)}\">${placeholderSink.toString()}</${placeholderTag}>${hydrationEnd}`,\n  );\n\n  const task = renderOutOfOrderFragment(sink, boundaryId, value, render, options);\n\n  if (sink.defer === undefined) {\n    void task;\n    return;\n  }\n\n  sink.defer(task);\n}\n\nfunction normalizeOutOfOrderPlaceholderTag(tag: unknown): string {\n  if (typeof tag !== \"string\") {\n    return \"span\";\n  }\n\n  const normalized = tag.trim().toLowerCase();\n  return /^[a-z][a-z0-9-]*$/.test(normalized) ? normalized : \"span\";\n}\n\nasync function renderOutOfOrderFragment<T>(\n  sink: HtmlSink,\n  id: string,\n  value: T,\n  render: AsyncBoundaryRender<T>,\n  options: OutOfOrderBoundaryOptions,\n): Promise<void> {\n  const fragmentSink = inheritBackpressure(createStringSink(), sink);\n  let resolvedValue: unknown;\n  let hasResolvedValue = false;\n\n  await renderAsyncBoundary(\n    fragmentSink,\n    value,\n    async (childSink, resolved) => {\n      resolvedValue = resolved;\n      hasResolvedValue = true;\n      await render(childSink, resolved);\n    },\n    options.catch === undefined ? {} : { catch: options.catch },\n  );\n  await fragmentSink.drain();\n\n  sink.append(\n    `<template data-mreact-oob-fragment=\"${escapeAttribute(id)}\">${fragmentSink.toString()}</template>`,\n  );\n\n  if (hasResolvedValue && options.hydrationAwaitId !== undefined) {\n    appendAwaitHydrationData(sink, options.hydrationAwaitId, resolvedValue);\n  }\n}\n\nexport function renderOutOfOrderReorderScript(\n  sink: HtmlSink,\n  options: OutOfOrderReorderScriptOptions = {},\n): void {\n  const nonceAttribute =\n    options.nonce === undefined ? \"\" : ` nonce=\"${escapeAttribute(options.nonce)}\"`;\n\n  if (options.src !== undefined) {\n    sink.append(\n      `<script data-mreact-oob-reorder${nonceAttribute} src=\"${escapeAttribute(options.src)}\"></script>`,\n    );\n    return;\n  }\n\n  sink.append(\n    `<script data-mreact-oob-reorder${nonceAttribute}>${outOfOrderReorderScript}</script>`,\n  );\n}\n\nexport function renderReactSuspenseBoundary(\n  sink: HtmlSink,\n  render: (sink: HtmlSink) => void | PromiseLike<void>,\n): void | PromiseLike<void> {\n  sink.append(\"<!--$-->\");\n  const result = render(sink);\n\n  if (isPromiseLike(result)) {\n    return result.then(() => {\n      sink.append(\"<!--/$-->\");\n    });\n  }\n\n  sink.append(\"<!--/$-->\");\n}\n\nexport function renderReactSuspenseOutOfOrderBoundary<T>(\n  sink: HtmlSink,\n  boundaryId: string,\n  segmentId: string,\n  value: T,\n  render: AsyncBoundaryRender<T>,\n  options: ReactSuspenseBoundaryOptions = {},\n): void {\n  const actualBoundaryId = nextOutOfOrderBoundaryInstanceId(sink, boundaryId);\n  const suffix = actualBoundaryId.slice(boundaryId.length);\n  const actualSegmentId = `${segmentId}${suffix}`;\n  const fallbackSink = createStringSink();\n  void options.fallback?.(fallbackSink);\n  sink.append(\n    `<!--$?--><template id=\"${escapeAttribute(actualBoundaryId)}\"></template>${fallbackSink.toString()}<!--/$-->`,\n  );\n\n  const task = renderReactSuspenseSegment(\n    sink,\n    actualBoundaryId,\n    actualSegmentId,\n    value,\n    render,\n    options,\n  );\n\n  if (sink.defer === undefined) {\n    void task;\n    return;\n  }\n\n  sink.defer(task);\n}\n\nfunction nextOutOfOrderBoundaryInstanceId(sink: HtmlSink, id: string): string {\n  let instances = outOfOrderBoundaryInstances.get(sink);\n\n  if (instances === undefined) {\n    instances = new Map();\n    outOfOrderBoundaryInstances.set(sink, instances);\n  }\n\n  const count = instances.get(id) ?? 0;\n  instances.set(id, count + 1);\n\n  return count === 0 ? id : `${id}-${count.toString(36)}`;\n}\n\nexport function renderReactSuspenseClientRenderBoundary(\n  sink: HtmlSink,\n  fallback: (sink: HtmlSink) => void | PromiseLike<void>,\n  options: ReactSuspenseClientRenderOptions = {},\n): void | PromiseLike<void> {\n  sink.append(`<!--$!--><template${renderReactSuspenseErrorAttributes(options)}></template>`);\n  const result = fallback(sink);\n\n  if (isPromiseLike(result)) {\n    return result.then(() => {\n      sink.append(\"<!--/$-->\");\n    });\n  }\n\n  sink.append(\"<!--/$-->\");\n}\n\nasync function renderReactSuspenseSegment<T>(\n  sink: HtmlSink,\n  boundaryId: string,\n  segmentId: string,\n  value: T,\n  render: AsyncBoundaryRender<T>,\n  options: ReactSuspenseBoundaryOptions,\n): Promise<void> {\n  const segmentSink = inheritBackpressure(createStringSink(), sink);\n\n  await renderAsyncBoundary(\n    segmentSink,\n    value,\n    render,\n    options.catch === undefined ? {} : { catch: options.catch },\n  );\n\n  sink.append(\n    `<div hidden id=\"${escapeAttribute(segmentId)}\">${segmentSink.toString()}</div>${renderReactSuspenseRevealScript(boundaryId, segmentId, options)}`,\n  );\n}\n\nfunction renderReactSuspenseErrorAttributes(options: ReactSuspenseClientRenderOptions): string {\n  const message =\n    options.message === undefined ? \"\" : ` data-msg=\"${escapeAttribute(options.message)}\"`;\n  const stack = options.stack === undefined ? \"\" : ` data-stck=\"${escapeAttribute(options.stack)}\"`;\n\n  return `${message}${stack}`;\n}\n\nfunction renderReactSuspenseRevealScript(\n  boundaryId: string,\n  segmentId: string,\n  options: ReactSuspenseScriptOptions = {},\n): string {\n  if (options.src !== undefined) {\n    return `<script data-mreact-react-suspense-reveal${renderNonceAttribute(options.nonce)} src=\"${escapeAttribute(options.src)}\" data-boundary-id=\"${escapeAttribute(boundaryId)}\" data-segment-id=\"${escapeAttribute(segmentId)}\"></script>`;\n  }\n\n  return `<script${renderNonceAttribute(options.nonce)}>${reactSuspenseRevealScriptBody};$RC(${serializeScriptJson(boundaryId)},${serializeScriptJson(segmentId)})</script>`;\n}\n\nexport function renderHydrationBoundary(\n  sink: HtmlSink,\n  id: string,\n  render: (sink: HtmlSink) => void | PromiseLike<void>,\n): void | PromiseLike<void> {\n  const markerId = encodeURIComponent(id);\n  sink.append(`<!--mreact-h:start:${markerId}-->`);\n  const result = render(sink);\n\n  if (isPromiseLike(result)) {\n    return result.then(() => {\n      sink.append(`<!--mreact-h:end:${markerId}-->`);\n    });\n  }\n\n  sink.append(`<!--mreact-h:end:${markerId}-->`);\n}\n\nfunction isPromiseLike(value: unknown): value is PromiseLike<void> {\n  return isPromiseLikeUnknown(value);\n}\n\nconst outOfOrderReorderScript = `(()=>{function apply(root){const fragments=Array.from(root.querySelectorAll(\"template[data-mreact-oob-fragment]\"));for(const fragment of fragments){const id=fragment.getAttribute(\"data-mreact-oob-fragment\");if(id===null)continue;const placeholders=Array.from(root.querySelectorAll(\"[data-mreact-oob-placeholder]\"));const placeholder=placeholders.find((candidate)=>candidate.getAttribute(\"data-mreact-oob-placeholder\")===id);if(placeholder===undefined)continue;placeholder.replaceWith(fragment.content.cloneNode(true));fragment.remove();}}apply(document);new MutationObserver(()=>apply(document)).observe(document.documentElement,{childList:true,subtree:true});})();`;\n\nconst reactSuspenseRevealScriptBody = `(self.$RC=self.$RC||function(bid,sid){var b=document.getElementById(bid);var s=document.getElementById(sid);if(!b||!s)return;var p=b.parentNode;var e=b.nextSibling;var d=0;var r=[];for(var n=e;n;n=n.nextSibling){if(n.nodeType===8){if(n.data===\"$\"||n.data===\"$?\"||n.data===\"$!\")d++;else if(n.data===\"/$\"){if(d===0){e=n;break;}d--;}}r.push(n);}for(var i=0;r[i];i++)p.removeChild(r[i]);while(s.firstChild)p.insertBefore(s.firstChild,e);s.remove();b.data=\"$\";})`;\n\nexport const reactSuspenseRevealExternalScript = `(()=>{${reactSuspenseRevealScriptBody};var s=document.currentScript;if(!s)return;var b=s.getAttribute(\"data-boundary-id\");var seg=s.getAttribute(\"data-segment-id\");if(b!==null&&seg!==null)self.$RC(b,seg);})();`;\n"]}

package/dist/html-helpers.d.ts

@@ -0,0 +1,31 @@
+import type { HtmlSink } from "@reckona/mreact-shared/compiler-contract";
+import { type HydrationScriptOptions } from "./boundary.js";
+import { type StreamRender } from "./sink.js";
+export interface ScriptAssetOptions {
+    src: string;
+    nonce?: string;
+    integrity?: string;
+    crossOrigin?: "anonymous" | "use-credentials";
+}
+export interface EventHydrationEntry {
+    id: string;
+    event: string;
+    handler: string;
+}
+export interface EventHydrationManifest {
+    version: 1;
+    events: EventHydrationEntry[];
+}
+export interface HtmlResponseOptions {
+    headers?: HeadersInit;
+    status?: number;
+    statusText?: string;
+}
+export declare function serializeSsrState(value: unknown): string;
+export declare function renderSsrState(sink: HtmlSink, value: unknown, options?: HydrationScriptOptions): void;
+export declare function createEventHydrationManifest(events: readonly EventHydrationEntry[]): EventHydrationManifest;
+export declare function renderEventHydrationManifest(sink: HtmlSink, manifest: EventHydrationManifest, options?: HydrationScriptOptions): void;
+export declare function renderScriptAsset(sink: HtmlSink, options: ScriptAssetOptions): void;
+export declare function html(node: unknown, options?: HtmlResponseOptions): Response;
+export declare function renderToString(render: StreamRender): Promise<string>;
+//# sourceMappingURL=html-helpers.d.ts.map

package/dist/html-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-helpers.d.ts","sourceRoot":"","sources":["../src/html-helpers.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0CAA0C,CAAC;AAEzE,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,eAAe,CAAC;AAavB,OAAO,EAAoB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AAGhE,MAAM,WAAW,kBAAkB;IACjC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,WAAW,GAAG,iBAAiB,CAAC;CAC/C;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE,mBAAmB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAExD;AAED,wBAAgB,cAAc,CAC5B,IAAI,EAAE,QAAQ,EACd,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,sBAA2B,GACnC,IAAI,CAIN;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,SAAS,mBAAmB,EAAE,GACrC,sBAAsB,CAKxB;AAED,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,QAAQ,EACd,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE,sBAA2B,GACnC,IAAI,CAIN;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAWnF;AAED,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,GAAE,mBAAwB,GAAG,QAAQ,CAuB/E;AAED,wBAAsB,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAO1E"}

package/dist/html-helpers.js

@@ -0,0 +1,259 @@
+import { Fragment, Suspense as ReactCompatSuspense, isValidElement, } from "@reckona/mreact-compat";
+import { escapeHtmlText as escapeHtml } from "@reckona/mreact-shared/html-escape";
+import { renderReactSuspenseBoundary, renderReactSuspenseOutOfOrderBoundary, } from "./boundary.js";
+import { isDangerousHtmlAttribute, isDangerousHtmlOptIn, isUnsafeMetaRefreshContent, isUnsafeUrlAttribute, } from "./url-safety.js";
+import { escapeAttribute, isPromiseLikeUnknown, renderNonceAttribute, serializeScriptJson, } from "./html-internals.js";
+import { createStringSink } from "./sink.js";
+import { renderToReadableStream } from "./stream.js";
+export function serializeSsrState(value) {
+    return serializeScriptJson(value);
+}
+export function renderSsrState(sink, value, options = {}) {
+    sink.append(`<script type="application/json" data-mreact-ssr-state${renderNonceAttribute(options.nonce)}>${serializeSsrState(value)}</script>`);
+}
+export function createEventHydrationManifest(events) {
+    return {
+        version: 1,
+        events: events.map((event) => ({ ...event })),
+    };
+}
+export function renderEventHydrationManifest(sink, manifest, options = {}) {
+    sink.append(`<script type="application/json" data-mreact-event-manifest${renderNonceAttribute(options.nonce)}>${serializeSsrState(manifest)}</script>`);
+}
+export function renderScriptAsset(sink, options) {
+    const integrityAttribute = options.integrity === undefined ? "" : ` integrity="${escapeAttribute(options.integrity)}"`;
+    const crossOrigin = options.integrity === undefined ? options.crossOrigin : (options.crossOrigin ?? "anonymous");
+    const crossOriginAttribute = crossOrigin === undefined ? "" : ` crossorigin="${escapeAttribute(crossOrigin)}"`;
+    sink.append(`<script src="${escapeAttribute(options.src)}"${renderNonceAttribute(options.nonce)}${integrityAttribute}${crossOriginAttribute}></script>`);
+}
+export function html(node, options = {}) {
+    const headers = new Headers(options.headers);
+    const responseOptions = { headers };
+    if (!headers.has("content-type")) {
+        headers.set("content-type", "text/html; charset=utf-8");
+    }
+    if (options.status !== undefined) {
+        responseOptions.status = options.status;
+    }
+    if (options.statusText !== undefined) {
+        responseOptions.statusText = options.statusText;
+    }
+    return new Response(renderToReadableStream((sink) => {
+        const state = { suspenseId: 0 };
+        return appendReactNode(sink, node, state);
+    }), responseOptions);
+}
+export async function renderToString(render) {
+    const sink = createStringSink();
+    await render(sink);
+    await sink.drain();
+    return sink.toString();
+}
+function appendReactNode(sink, node, state) {
+    if (isPromiseLikeNode(node)) {
+        return node.then((resolved) => appendReactNode(sink, resolved, state));
+    }
+    if (node === null || node === undefined || typeof node === "boolean") {
+        return;
+    }
+    if (typeof node === "string" || typeof node === "number") {
+        sink.append(escapeHtml(node));
+        return;
+    }
+    if (Array.isArray(node)) {
+        return appendReactNodeList(sink, node, state);
+    }
+    if (!isValidElement(node)) {
+        return;
+    }
+    return appendReactElement(sink, node, state);
+}
+function appendReactNodeList(sink, nodes, state) {
+    let chain;
+    for (const node of nodes) {
+        if (chain !== undefined) {
+            chain = chain.then(() => appendReactNode(sink, node, state));
+            continue;
+        }
+        const result = appendReactNode(sink, node, state);
+        if (isPromiseLike(result)) {
+            chain = result;
+        }
+    }
+    return chain;
+}
+function appendReactElement(sink, element, state) {
+    if (typeof element.type === "string") {
+        return appendHostElement(sink, element, state);
+    }
+    if (element.type === Fragment) {
+        return appendReactNode(sink, element.props.children, state);
+    }
+    if (element.type === ReactCompatSuspense) {
+        return appendSuspenseElement(sink, element, state);
+    }
+    if (isClassComponentType(element.type)) {
+        const instance = new element.type(element.props);
+        return appendReactNode(sink, instance.render(), state);
+    }
+    if (typeof element.type === "function") {
+        return appendReactNode(sink, element.type(element.props), state);
+    }
+}
+function isClassComponentType(value) {
+    return typeof value === "function" && value.prototype?.render !== undefined;
+}
+function appendHostElement(sink, element, state) {
+    const tagName = element.type;
+    const innerHtml = element.props
+        .dangerouslySetInnerHTML;
+    sink.append(`<${tagName}${renderHtmlAttributes(element.props)}>`);
+    if (innerHtml !== undefined) {
+        sink.append(String(innerHtml.__html ?? ""));
+        sink.append(`</${tagName}>`);
+        return;
+    }
+    const result = appendReactNode(sink, element.props.children, state);
+    if (isPromiseLike(result)) {
+        return result.then(() => {
+            sink.append(`</${tagName}>`);
+        });
+    }
+    sink.append(`</${tagName}>`);
+}
+function appendSuspenseElement(sink, element, state) {
+    const rendered = renderReactNodeToString(element.props.children, state);
+    if (!isPromiseLikeString(rendered)) {
+        renderReactSuspenseBoundary(sink, (boundarySink) => {
+            boundarySink.append(rendered);
+        });
+        return;
+    }
+    const id = state.suspenseId;
+    state.suspenseId += 1;
+    renderReactSuspenseOutOfOrderBoundary(sink, `B:${id}`, `S:${id}`, rendered, (boundarySink, renderedHtml) => {
+        boundarySink.append(renderedHtml);
+    }, {
+        fallback(boundarySink) {
+            const fallback = renderReactNodeToString(element.props.fallback, state);
+            if (isPromiseLikeString(fallback)) {
+                return fallback.then((html) => {
+                    boundarySink.append(html);
+                });
+            }
+            boundarySink.append(fallback);
+        },
+    });
+}
+function renderReactNodeToString(node, state) {
+    const sink = createStringSink();
+    const result = appendReactNode(sink, node, state);
+    if (isPromiseLike(result)) {
+        return result.then(() => sink.toString());
+    }
+    return sink.toString();
+}
+function renderHtmlAttributes(props) {
+    // Issue 078: <meta http-equiv="refresh" content="0;url=javascript:...">
+    // is URL-bearing only when http-equiv is "refresh", so we need both
+    // attributes in scope to make the call. Strip the unsafe content
+    // before per-attribute rendering.
+    const sanitizedProps = sanitizeMetaRefreshProps(props);
+    return Object.entries(sanitizedProps)
+        .map(([name, value]) => renderHtmlAttribute(name, value))
+        .filter((attribute) => attribute !== "")
+        .join("");
+}
+function sanitizeMetaRefreshProps(props) {
+    const httpEquiv = props["http-equiv"] ?? props.httpEquiv;
+    const content = props["content"];
+    if (typeof httpEquiv !== "string" || typeof content !== "string")
+        return props;
+    if (!isUnsafeMetaRefreshContent(httpEquiv, content))
+        return props;
+    // Drop only `content`; keep http-equiv so the developer's intent is
+    // still visible in the rendered HTML (debugging hint).
+    const sanitized = { ...props };
+    delete sanitized["content"];
+    return sanitized;
+}
+// Mirrors `isAttributeNameSafe` in react-dom: an attribute name must start with
+// an ASCII letter (or underscore) and contain only word chars, dot, hyphen, or
+// colon. Anything else is dropped to prevent SSR XSS via spread props
+// (`<div {...userControlled} />`). See docs/issues/resolved Issue 060.
+const VALID_ATTRIBUTE_NAME = /^[A-Za-z_][\w.\-:]*$/;
+// URL scheme allow/block list is shared with the compiler emit paths
+// (Issues 062 / 073). See packages/server/src/url-safety.ts.
+function renderHtmlAttribute(name, value) {
+    if (name === "children" ||
+        name === "dangerouslySetInnerHTML" ||
+        name === "key" ||
+        name === "ref" ||
+        value === false ||
+        value === null ||
+        value === undefined ||
+        typeof value === "function") {
+        return "";
+    }
+    const attributeName = toHtmlAttributeName(name);
+    if (!VALID_ATTRIBUTE_NAME.test(attributeName)) {
+        return "";
+    }
+    // Issue 077: HTML-bearing attributes (`srcdoc`) require the explicit
+    // `{ __html: "..." }` opt-in. A plain string value -- even if escaped
+    // for the attribute syntax -- decodes back to executable HTML inside
+    // the iframe document with the parent's origin.
+    if (isDangerousHtmlAttribute(attributeName)) {
+        if (!isDangerousHtmlOptIn(value)) {
+            return "";
+        }
+        return ` ${attributeName}="${escapeAttribute(value.__html)}"`;
+    }
+    if (value === true) {
+        return ` ${attributeName}`;
+    }
+    const stringValue = String(value);
+    if (isUnsafeUrlAttribute(attributeName, stringValue)) {
+        return "";
+    }
+    return ` ${attributeName}="${escapeAttribute(stringValue)}"`;
+}
+function toHtmlAttributeName(name) {
+    return HTML_ATTRIBUTE_ALIASES[name] ?? name;
+}
+const HTML_ATTRIBUTE_ALIASES = {
+    acceptCharset: "accept-charset",
+    autoFocus: "autofocus",
+    autoPlay: "autoplay",
+    charSet: "charset",
+    className: "class",
+    colSpan: "colspan",
+    contentEditable: "contenteditable",
+    crossOrigin: "crossorigin",
+    encType: "enctype",
+    formAction: "formaction",
+    frameBorder: "frameborder",
+    htmlFor: "for",
+    httpEquiv: "http-equiv",
+    maxLength: "maxlength",
+    minLength: "minlength",
+    noValidate: "novalidate",
+    playsInline: "playsinline",
+    readOnly: "readonly",
+    rowSpan: "rowspan",
+    spellCheck: "spellcheck",
+    srcDoc: "srcdoc",
+    srcSet: "srcset",
+    tabIndex: "tabindex",
+    useMap: "usemap",
+};
+function isPromiseLikeNode(value) {
+    return isPromiseLikeUnknown(value);
+}
+function isPromiseLikeString(value) {
+    return isPromiseLikeUnknown(value);
+}
+function isPromiseLike(value) {
+    return isPromiseLikeUnknown(value);
+}
+//# sourceMappingURL=html-helpers.js.map