@nifrajs/web 4.0.2 → 5.0.0

package/dist/server-components/source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.ts","sourceRoot":"","sources":["../../src/server-components/source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,KAAK,EAAE,MAAM,YAAY,CAAA;AAGrC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACtD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAQnF;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,EAAE,CAAC,UAAU,CAQtE;AAmCD;+EAC+E;AAC/E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAoB7E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAarE;AAED,wBAAgB,cAAc,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,GAAG,SAAS,MAAM,EAAE,CAoCrE;AAED,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,IAAI,GAAE,QAAQ,GAAG,QAAmB,GACnC,uBAAuB,CA4HzB;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAmD5E"}

package/dist/server-components/source.js

@@ -0,0 +1,269 @@
+import { createHash } from "node:crypto";
+import { relative } from "node:path";
+import { ts } from "./typescript.js";
+export function componentReference(file, root, name) {
+    return ("sc_" +
+        createHash("sha256")
+            .update(`${relative(root, file).replaceAll("\\", "/")}#${name}`)
+            .digest("hex")
+            .slice(0, 32));
+}
+export function sourceFile(source, file) {
+    return ts.createSourceFile(file, source, ts.ScriptTarget.Latest, true, /\.[jt]sx$/.test(file) ? ts.ScriptKind.TSX : ts.ScriptKind.TS);
+}
+function modifier(node, kind) {
+    return (ts.canHaveModifiers(node) &&
+        (ts.getModifiers(node)?.some((item) => item.kind === kind) ?? false));
+}
+function literal(node) {
+    if (ts.isAsExpression(node) ||
+        ts.isSatisfiesExpression(node) ||
+        ts.isParenthesizedExpression(node))
+        return literal(node.expression);
+    if (ts.isStringLiteral(node))
+        return node.text;
+    if (!ts.isObjectLiteralExpression(node))
+        throw new Error("component_pipeline_literal");
+    const result = Object.create(null);
+    for (const member of node.properties) {
+        if (!ts.isPropertyAssignment(member) ||
+            !(ts.isIdentifier(member.name) || ts.isStringLiteral(member.name)))
+            throw new Error("component_pipeline_literal");
+        if (Object.hasOwn(result, member.name.text) ||
+            ["__proto__", "prototype", "constructor"].includes(member.name.text))
+            throw new Error("component_pipeline_literal");
+        result[member.name.text] = literal(member.initializer);
+    }
+    return result;
+}
+/** The `componentPipeline` a config module exports as a plain literal, read without running the
+ * module, or `undefined` when it exports none or one that is not a literal. */
+export function staticComponentPipeline(source, file) {
+    let pipeline;
+    for (const statement of sourceFile(source, file).statements) {
+        if (!ts.isVariableStatement(statement) || !modifier(statement, ts.SyntaxKind.ExportKeyword))
+            continue;
+        for (const variable of statement.declarationList.declarations) {
+            if (!ts.isIdentifier(variable.name) ||
+                variable.name.text !== "componentPipeline" ||
+                variable.initializer === undefined)
+                continue;
+            try {
+                pipeline = literal(variable.initializer);
+            }
+            catch {
+                return undefined;
+            }
+        }
+    }
+    return pipeline;
+}
+export function directive(file, value) {
+    let found = false;
+    const visit = (node) => {
+        if (ts.isSourceFile(node) || ts.isBlock(node)) {
+            for (const statement of node.statements) {
+                if (!ts.isExpressionStatement(statement) || !ts.isStringLiteral(statement.expression))
+                    break;
+                if (statement.expression.text === value)
+                    found = true;
+            }
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(file);
+    return found;
+}
+export function exportedValues(file) {
+    const names = new Set();
+    for (const statement of file.statements) {
+        if (ts.isExportAssignment(statement)) {
+            names.add("default");
+            continue;
+        }
+        if (ts.isExportDeclaration(statement)) {
+            if (statement.isTypeOnly)
+                continue;
+            if (statement.exportClause === undefined || !ts.isNamedExports(statement.exportClause))
+                throw new Error("[nifra/components] Native client modules require explicit, schema-registered component exports");
+            for (const element of statement.exportClause.elements)
+                if (!element.isTypeOnly)
+                    names.add(element.name.text);
+        }
+        if (!modifier(statement, ts.SyntaxKind.ExportKeyword))
+            continue;
+        if (modifier(statement, ts.SyntaxKind.DefaultKeyword)) {
+            names.add("default");
+            continue;
+        }
+        if (ts.isVariableStatement(statement)) {
+            for (const declaration of statement.declarationList.declarations) {
+                if (!ts.isIdentifier(declaration.name))
+                    throw new Error("[nifra/components] Destructured component exports are unsupported");
+                names.add(declaration.name.text);
+            }
+        }
+        else if (ts.isFunctionDeclaration(statement) ||
+            ts.isClassDeclaration(statement) ||
+            ts.isEnumDeclaration(statement)) {
+            if (statement.name !== undefined)
+                names.add(statement.name.text);
+        }
+    }
+    return [...names];
+}
+export function compileComponentModule(source, file, root, environment, kind = "server") {
+    const ast = sourceFile(source, file);
+    if (directive(ast, "use server"))
+        throw new Error("[nifra/components] Native use-server actions are unsupported; use a validated serverFn in a *.fn.ts module");
+    const factories = new Set();
+    const namespaces = new Set();
+    for (const statement of ast.statements) {
+        if (!ts.isImportDeclaration(statement) ||
+            !ts.isStringLiteral(statement.moduleSpecifier) ||
+            statement.moduleSpecifier.text !==
+                (kind === "server"
+                    ? "@nifrajs/web/server-components"
+                    : "@nifrajs/web/server-components/islands"))
+            continue;
+        const bindings = statement.importClause?.namedBindings;
+        if (bindings !== undefined && ts.isNamedImports(bindings)) {
+            for (const element of bindings.elements)
+                if ((element.propertyName ?? element.name).text ===
+                    (kind === "server" ? "defineServerComponent" : "defineClientIsland"))
+                    factories.add(element.name.text);
+        }
+        else if (bindings !== undefined && ts.isNamespaceImport(bindings))
+            namespaces.add(bindings.name.text);
+    }
+    const definitions = new Map();
+    for (const statement of ast.statements) {
+        if (!ts.isVariableStatement(statement))
+            continue;
+        for (const declaration of statement.declarationList.declarations) {
+            let expression = declaration.initializer;
+            while (expression !== undefined &&
+                (ts.isAsExpression(expression) ||
+                    ts.isSatisfiesExpression(expression) ||
+                    ts.isParenthesizedExpression(expression)))
+                expression = expression.expression;
+            if (!ts.isIdentifier(declaration.name) ||
+                expression === undefined ||
+                !ts.isCallExpression(expression))
+                continue;
+            const callee = expression.expression;
+            if ((ts.isIdentifier(callee) && factories.has(callee.text)) ||
+                (ts.isPropertyAccessExpression(callee) &&
+                    ts.isIdentifier(callee.expression) &&
+                    namespaces.has(callee.expression.text) &&
+                    callee.name.text === (kind === "server" ? "defineServerComponent" : "defineClientIsland"))) {
+                if (expression.arguments.length !== 1)
+                    throw new Error("[nifra/components] Component references are generated by the compiler; remove the handwritten reference");
+                definitions.set(declaration.name.text, expression);
+            }
+        }
+    }
+    const references = Object.create(null);
+    for (const statement of ast.statements) {
+        if (ts.isVariableStatement(statement) && modifier(statement, ts.SyntaxKind.ExportKeyword)) {
+            for (const declaration of statement.declarationList.declarations) {
+                if (!ts.isIdentifier(declaration.name) || !definitions.has(declaration.name.text))
+                    throw new Error("[nifra/components] Only named defineServerComponent handles may be exported from *.component.server modules");
+                references[declaration.name.text] = componentReference(file, root, declaration.name.text);
+            }
+        }
+        else if (ts.isExportDeclaration(statement) && !statement.isTypeOnly) {
+            if (statement.moduleSpecifier !== undefined ||
+                statement.exportClause === undefined ||
+                !ts.isNamedExports(statement.exportClause))
+                throw new Error("[nifra/components] Re-export component handles through a separate barrel");
+            for (const element of statement.exportClause.elements) {
+                if (element.isTypeOnly)
+                    continue;
+                const local = (element.propertyName ?? element.name).text;
+                if (!definitions.has(local))
+                    throw new Error("[nifra/components] A component module exported an unregistered value");
+                references[element.name.text] = componentReference(file, root, local);
+            }
+        }
+        else if (ts.isExportAssignment(statement) ||
+            (modifier(statement, ts.SyntaxKind.ExportKeyword) &&
+                !ts.isInterfaceDeclaration(statement) &&
+                !ts.isTypeAliasDeclaration(statement))) {
+            throw new Error("[nifra/components] Export named defineServerComponent handles from *.component.server modules");
+        }
+    }
+    if (Object.keys(references).length === 0)
+        throw new Error("[nifra/components] A component module has no recognized server component");
+    if (environment === "client" && kind === "server") {
+        return {
+            references,
+            code: Object.entries(references)
+                .map(([name, reference]) => `export const ${name} = Object.freeze({ reference: ${JSON.stringify(reference)} });`)
+                .join("\n"),
+        };
+    }
+    let code = source;
+    for (const [name, call] of [...definitions].sort((a, b) => b[1].end - a[1].end)) {
+        const argument = call.arguments[0];
+        if (argument === undefined)
+            throw new Error("[nifra/components] Missing server component definition");
+        const at = argument.end;
+        code =
+            code.slice(0, at) +
+                ", " +
+                JSON.stringify(componentReference(file, root, name)) +
+                code.slice(at);
+    }
+    return { code, references };
+}
+export function guardCreateElementCalls(source, file) {
+    const ast = sourceFile(source, file);
+    const namespaces = new Set();
+    const factories = new Set();
+    for (const statement of ast.statements) {
+        if (!ts.isImportDeclaration(statement) ||
+            !ts.isStringLiteral(statement.moduleSpecifier) ||
+            statement.moduleSpecifier.text !== "react")
+            continue;
+        if (statement.importClause?.name !== undefined)
+            namespaces.add(statement.importClause.name.text);
+        const bindings = statement.importClause?.namedBindings;
+        if (bindings !== undefined && ts.isNamespaceImport(bindings))
+            namespaces.add(bindings.name.text);
+        if (bindings !== undefined && ts.isNamedImports(bindings))
+            for (const element of bindings.elements) {
+                if ((element.propertyName ?? element.name).text === "createElement")
+                    factories.add(element.name.text);
+            }
+    }
+    const changes = [];
+    const visit = (node) => {
+        if (ts.isCallExpression(node)) {
+            const expression = node.expression;
+            const named = ts.isIdentifier(expression) && factories.has(expression.text);
+            const member = ts.isPropertyAccessExpression(expression) &&
+                ts.isIdentifier(expression.expression) &&
+                namespaces.has(expression.expression.text) &&
+                expression.name.text === "createElement";
+            const computed = ts.isElementAccessExpression(expression) &&
+                ts.isIdentifier(expression.expression) &&
+                namespaces.has(expression.expression.text) &&
+                ts.isStringLiteral(expression.argumentExpression) &&
+                expression.argumentExpression.text === "createElement";
+            if (named || member || computed)
+                changes.push({ start: expression.getStart(ast), end: expression.end });
+        }
+        ts.forEachChild(node, visit);
+    };
+    visit(ast);
+    if (changes.length === 0)
+        return source;
+    const identifier = `__nifra_guardedCreateElement_${createHash("sha256").update(file).digest("hex").slice(0, 12)}`;
+    let code = source;
+    for (const change of changes.sort((a, b) => b.start - a.start))
+        code = code.slice(0, change.start) + identifier + code.slice(change.end);
+    return (`import { guardedCreateElement as ${identifier} } from "@nifrajs/web-react/server-components/guard";\n` +
+        code);
+}
+//# sourceMappingURL=source.js.map

package/dist/server-components/source.js.map

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

package/dist/server-components/state.d.ts

@@ -0,0 +1,4 @@
+import type { ComponentState } from "./types.js";
+export declare function componentToken(value: unknown): value is string;
+export declare function parseComponentState(value: unknown, maxBytes?: number, externalParent?: string | null): ComponentState;
+//# sourceMappingURL=state.d.ts.map

package/dist/server-components/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/server-components/state.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAoC,cAAc,EAAE,MAAM,YAAY,CAAA;AAoBlF,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AA2BD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,OAAO,EACd,QAAQ,GAAE,MAAuC,EACjD,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAC7B,cAAc,CAsFhB"}

package/dist/server-components/state.js

@@ -0,0 +1,123 @@
+import { ServerComponentError } from "./error.js";
+import { validateComponentHTML } from "./html.js";
+import { COMPONENT_LIMITS, componentKey } from "./protocol.js";
+import { componentValue } from "./value.js";
+const token = /^[A-Za-z0-9_-]{1,128}$/;
+function object(value, fields, optional = []) {
+    if (typeof value !== "object" ||
+        value === null ||
+        Array.isArray(value) ||
+        fields.some((field) => !Object.hasOwn(value, field)) ||
+        Object.keys(value).some((field) => !fields.includes(field) && !optional.includes(field)))
+        throw new ServerComponentError("component_protocol", 400);
+    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: Object shape is checked before field inspection; each typed field follows its closed vocabulary check.
+    return value;
+}
+export function componentToken(value) {
+    return typeof value === "string" && token.test(value);
+}
+function island(value) {
+    const item = object(value, ["reference", "key", "props", "renderId"], ["slots"]);
+    if (!componentToken(item.reference) || !componentToken(item.renderId) || !componentKey(item.key))
+        throw new ServerComponentError("component_protocol", 400);
+    if (item.slots !== undefined &&
+        (typeof item.slots !== "object" ||
+            item.slots === null ||
+            Array.isArray(item.slots) ||
+            Object.entries(item.slots).some(([key, html]) => !/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(key) || typeof html !== "string")))
+        throw new ServerComponentError("component_protocol", 400);
+    if (item.slots !== undefined)
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: Object shape is checked before field inspection; each typed field follows its closed vocabulary check.
+        for (const html of Object.values(item.slots))
+            validateComponentHTML(html);
+    const result = {
+        reference: item.reference,
+        key: item.key,
+        renderId: item.renderId,
+        props: componentValue(item.props),
+    };
+    if (item.slots !== undefined)
+        Object.assign(result, { slots: item.slots });
+    return result;
+}
+export function parseComponentState(value, maxBytes = COMPONENT_LIMITS.documentBytes, externalParent) {
+    const bounded = componentValue(value, maxBytes);
+    const state = object(bounded, ["v", "build", "adapter", "owner", "scope", "records"]);
+    if (state.v !== 1 ||
+        !componentToken(state.build) ||
+        !componentToken(state.owner) ||
+        !componentToken(state.scope) ||
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: Object shape is checked before field inspection; each typed field follows its closed vocabulary check.
+        !["react", "vue", "svelte", "solid", "preact"].includes(state.adapter) ||
+        !Array.isArray(state.records) ||
+        state.records.length > COMPONENT_LIMITS.instances)
+        throw new ServerComponentError("component_protocol", 400);
+    const ids = new Set();
+    const islandIds = new Set();
+    let instances = state.records.length;
+    const records = state.records.map((value) => {
+        const record = object(value, ["instance", "reference", "key", "parent", "input", "html"], ["payload", "islands"]);
+        if (!componentToken(record.instance) ||
+            ids.has(record.instance) ||
+            !componentToken(record.reference) ||
+            !componentKey(record.key) ||
+            (record.parent !== null && !componentToken(record.parent)) ||
+            typeof record.html !== "string")
+            throw new ServerComponentError("component_protocol", 400);
+        ids.add(record.instance);
+        validateComponentHTML(record.html);
+        if (record.islands !== undefined &&
+            (!Array.isArray(record.islands) || record.islands.length > COMPONENT_LIMITS.instances))
+            throw new ServerComponentError("component_protocol", 400);
+        const islands = 
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: Object shape is checked before field inspection; each typed field follows its closed vocabulary check.
+        record.islands === undefined ? undefined : record.islands.map(island);
+        for (const island of islands ?? []) {
+            if (islandIds.has(island.renderId))
+                throw new ServerComponentError("component_protocol", 400);
+            islandIds.add(island.renderId);
+        }
+        instances += islands?.length ?? 0;
+        if (instances > COMPONENT_LIMITS.instances)
+            throw new ServerComponentError("component_limit", 413);
+        const result = {
+            instance: record.instance,
+            reference: record.reference,
+            key: record.key,
+            // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: Object shape is checked before field inspection; each typed field follows its closed vocabulary check.
+            parent: record.parent,
+            html: record.html,
+            input: componentValue(record.input, COMPONENT_LIMITS.inputBytes),
+        };
+        if (record.payload !== undefined)
+            Object.assign(result, {
+                payload: componentValue(record.payload, COMPONENT_LIMITS.outputBytes),
+            });
+        if (islands !== undefined)
+            Object.assign(result, { islands });
+        return result;
+    });
+    // Refreshes contain a single child and may name its already mounted parent. Documents carry the full forest.
+    for (const record of records) {
+        const chain = new Set([record.instance]);
+        let parent = record.parent;
+        while (parent !== null) {
+            if (!ids.has(parent) && parent === externalParent)
+                break;
+            if (chain.has(parent) || !ids.has(parent) || chain.size >= 16)
+                throw new ServerComponentError("component_protocol", 400);
+            chain.add(parent);
+            parent = records.find((item) => item.instance === parent)?.parent ?? null;
+        }
+    }
+    return {
+        v: 1,
+        build: state.build,
+        owner: state.owner,
+        scope: state.scope,
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: Object shape is checked before field inspection; each typed field follows its closed vocabulary check.
+        adapter: state.adapter,
+        records,
+    };
+}
+//# sourceMappingURL=state.js.map

package/dist/server-components/state.js.map

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

package/dist/server-components/stream.d.ts

@@ -0,0 +1,6 @@
+export declare function bytesStream(bytes: Uint8Array): ReadableStream<Uint8Array>;
+/** The bounded snapshot is shared by SSR and hydration; it never tees into an unread branch. */
+export declare function readComponentBytes(stream: ReadableStream<Uint8Array>, signal: AbortSignal, limit?: number): Promise<Uint8Array>;
+export declare function encodeComponentBytes(bytes: Uint8Array): string;
+export declare function decodeComponentBytes(value: unknown): Uint8Array;
+//# sourceMappingURL=stream.d.ts.map

package/dist/server-components/stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stream.d.ts","sourceRoot":"","sources":["../../src/server-components/stream.ts"],"names":[],"mappings":"AAGA,wBAAgB,WAAW,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,CAAC,UAAU,CAAC,CAOzE;AAED,gGAAgG;AAChG,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,cAAc,CAAC,UAAU,CAAC,EAClC,MAAM,EAAE,WAAW,EACnB,KAAK,GAAE,MAAqC,GAC3C,OAAO,CAAC,UAAU,CAAC,CAqCrB;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAI9D;AAED,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAQ/D"}

package/dist/server-components/stream.js

@@ -0,0 +1,70 @@
+import { ServerComponentError } from "./error.js";
+import { COMPONENT_LIMITS } from "./protocol.js";
+export function bytesStream(bytes) {
+    return new ReadableStream({
+        start(controller) {
+            controller.enqueue(bytes);
+            controller.close();
+        },
+    });
+}
+/** The bounded snapshot is shared by SSR and hydration; it never tees into an unread branch. */
+export async function readComponentBytes(stream, signal, limit = COMPONENT_LIMITS.outputBytes) {
+    const reader = stream.getReader();
+    const chunks = [];
+    let size = 0;
+    const cancel = () => {
+        void reader.cancel().catch(() => {
+            /* Keep the primary read failure. */
+        });
+    };
+    signal.addEventListener("abort", cancel, { once: true });
+    try {
+        while (true) {
+            if (signal.aborted)
+                throw new ServerComponentError("component_cancelled", 499);
+            const result = await reader.read();
+            if (result.done)
+                break;
+            if (result.value.length === 0)
+                throw new ServerComponentError("component_protocol", 400);
+            size += result.value.length;
+            if (size > limit)
+                throw new ServerComponentError("component_limit", 413);
+            chunks.push(result.value);
+        }
+        if (signal.aborted)
+            throw new ServerComponentError("component_cancelled", 499);
+        const bytes = new Uint8Array(size);
+        let offset = 0;
+        for (const chunk of chunks) {
+            bytes.set(chunk, offset);
+            offset += chunk.length;
+        }
+        return bytes;
+    }
+    catch (error) {
+        await reader.cancel().catch(() => {
+            /* Keep the primary read failure. */
+        });
+        throw error;
+    }
+    finally {
+        signal.removeEventListener("abort", cancel);
+        reader.releaseLock();
+    }
+}
+export function encodeComponentBytes(bytes) {
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary);
+}
+export function decodeComponentBytes(value) {
+    if (typeof value !== "string" ||
+        value.length > Math.ceil(COMPONENT_LIMITS.outputBytes / 3) * 4 ||
+        !/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/.test(value))
+        throw new ServerComponentError("component_protocol", 400);
+    return Uint8Array.from(atob(value), (item) => item.charCodeAt(0));
+}
+//# sourceMappingURL=stream.js.map

package/dist/server-components/stream.js.map

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

package/dist/server-components/trusted-html.d.ts

@@ -0,0 +1,3 @@
+/** Explicit opt-in for native framework HTML sinks. Every accepted string is tokenized first. */
+export declare function installComponentTrustedTypesPolicy(): void;
+//# sourceMappingURL=trusted-html.d.ts.map

package/dist/server-components/trusted-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trusted-html.d.ts","sourceRoot":"","sources":["../../src/server-components/trusted-html.ts"],"names":[],"mappings":"AASA,iGAAiG;AACjG,wBAAgB,kCAAkC,IAAI,IAAI,CAUzD"}

package/dist/server-components/trusted-html.js

@@ -0,0 +1,14 @@
+import { validateComponentHTML } from "./html.js";
+/** Explicit opt-in for native framework HTML sinks. Every accepted string is tokenized first. */
+export function installComponentTrustedTypesPolicy() {
+    // Trusted Types is not yet declared in all supported TypeScript DOM libraries.
+    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion lint/plugin/noChainedTypeAssertions: Trusted Types is optional on globalThis and absent from some DOM type libraries; the policy still validates HTML before insertion.
+    const factory = globalThis.trustedTypes;
+    factory?.createPolicy("default", {
+        createHTML(html) {
+            validateComponentHTML(html);
+            return html;
+        },
+    });
+}
+//# sourceMappingURL=trusted-html.js.map

package/dist/server-components/trusted-html.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trusted-html.js","sourceRoot":"","sources":["../../src/server-components/trusted-html.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AASjD,iGAAiG;AACjG,MAAM,UAAU,kCAAkC;IAChD,+EAA+E;IAC/E,wOAAwO;IACxO,MAAM,OAAO,GAAI,UAA+D,CAAC,YAAY,CAAA;IAC7F,OAAO,EAAE,YAAY,CAAC,SAAS,EAAE;QAC/B,UAAU,CAAC,IAAI;YACb,qBAAqB,CAAC,IAAI,CAAC,CAAA;YAC3B,OAAO,IAAI,CAAA;QACb,CAAC;KACF,CAAC,CAAA;AACJ,CAAC"}