@nifrajs/web 4.0.2 → 5.0.0

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

@@ -0,0 +1,44 @@
+import type { StandardSchemaV1 } from "@nifrajs/core/server";
+import type { ComponentKey, ComponentRecord, ServerComponentHandle } from "./types.js";
+declare const contractBrand: unique symbol;
+declare const viewBrand: unique symbol;
+export interface ClientIsland<Props = unknown, Component = unknown> {
+    readonly reference?: string;
+    readonly props: StandardSchemaV1<unknown, Props>;
+    readonly component: Component;
+    readonly slots: readonly string[];
+    readonly [contractBrand]: true;
+}
+type NativeComponentProps<Component> = Component extends abstract new (...args: never[]) => {
+    $props: infer Props;
+} ? Props : Component extends abstract new (...args: never[]) => {
+    props: infer Props;
+} ? Props : Component extends (...args: infer Args) => unknown ? Args extends [] ? object : Args extends [unknown, infer Props, ...unknown[]] ? Args[0] | Props : Args[0] : never;
+type CompatibleComponent<Props, Component> = Props extends NativeComponentProps<Component> ? unknown : {
+    readonly __nifraIslandPropsMustMatchComponent: never;
+};
+export declare function defineClientIsland<Props, Component>(definition: {
+    readonly props: StandardSchemaV1<unknown, Props>;
+    readonly component: Component;
+    readonly slots?: readonly string[];
+} & CompatibleComponent<NoInfer<Props>, NoInfer<Component>>, reference?: string): ClientIsland<Props, Component>;
+export interface IslandInstance {
+    readonly contract: ClientIsland;
+    readonly key: ComponentKey;
+    readonly props: unknown;
+    readonly slots: Readonly<Record<string, string>>;
+}
+export declare function clientIsland<Props>(contract: ClientIsland<Props>, key: ComponentKey, props: NoInfer<Props>, slots?: Readonly<Record<string, string>>): IslandInstance;
+export interface NativeServerView {
+    readonly component: unknown;
+    readonly islands: Readonly<Record<string, IslandInstance>>;
+    readonly ranges: Readonly<Record<string, ComponentRecord>>;
+    readonly [viewBrand]: true;
+}
+/** Server-only native view rendered by the selected framework's own renderer. */
+export declare function nativeServerView(component: unknown, islands?: Readonly<Record<string, IslandInstance>>, ranges?: Readonly<Record<string, ComponentRecord>>): NativeServerView;
+export declare function serverComponentChild(children: readonly ComponentRecord[], component: Pick<ServerComponentHandle, "reference">, key: ComponentKey): ComponentRecord;
+export declare function isNativeServerView(value: unknown): value is NativeServerView;
+export declare function isClientIsland(value: unknown): value is ClientIsland;
+export {};
+//# sourceMappingURL=islands.d.ts.map

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

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

package/dist/server-components/islands.js

@@ -0,0 +1,42 @@
+const contractBrand = Symbol.for("nifra.components.island");
+const viewBrand = Symbol.for("nifra.components.view");
+export function defineClientIsland(definition, reference) {
+    const slots = definition.slots ?? [];
+    if (slots.length > 16 ||
+        new Set(slots).size !== slots.length ||
+        slots.some((name) => !/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(name) || ["ref", "key", "constructor"].includes(name)))
+        throw new Error("component_contract");
+    const contract = {
+        props: definition.props,
+        component: definition.component,
+        slots: Object.freeze([...slots]),
+        [contractBrand]: true,
+    };
+    if (reference !== undefined)
+        Object.assign(contract, { reference });
+    return Object.freeze(contract);
+}
+export function clientIsland(contract, key, props, slots = {}) {
+    return { contract, key, props, slots };
+}
+/** Server-only native view rendered by the selected framework's own renderer. */
+export function nativeServerView(component, islands = {}, ranges = {}) {
+    return { component, islands, ranges, [viewBrand]: true };
+}
+export function serverComponentChild(children, component, key) {
+    const matches = children.filter((record) => record.reference === component.reference && record.key === key);
+    if (matches.length !== 1)
+        throw new Error("component_contract");
+    return matches[0];
+}
+export function isNativeServerView(value) {
+    return (
+    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: Object shape is checked before inspecting the private symbol brand created by this module.
+    typeof value === "object" && value !== null && value[viewBrand] === true);
+}
+export function isClientIsland(value) {
+    return (
+    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: Object shape is checked before inspecting the private symbol brand created by this module.
+    typeof value === "object" && value !== null && value[contractBrand] === true);
+}
+//# sourceMappingURL=islands.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"islands.js","sourceRoot":"","sources":["../../src/server-components/islands.ts"],"names":[],"mappings":"AAGA,MAAM,aAAa,GAAG,MAAM,CAAC,GAAG,CAAC,yBAAyB,CAAC,CAAA;AAC3D,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,uBAAuB,CAAC,CAAA;AA6BrD,MAAM,UAAU,kBAAkB,CAChC,UAI2D,EAC3D,SAAkB;IAElB,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE,CAAA;IACpC,IACE,KAAK,CAAC,MAAM,GAAG,EAAE;QACjB,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,KAAK,CAAC,MAAM;QACpC,KAAK,CAAC,IAAI,CACR,CAAC,IAAI,EAAE,EAAE,CACP,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAC7F;QAED,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;IACvC,MAAM,QAAQ,GAAmC;QAC/C,KAAK,EAAE,UAAU,CAAC,KAAK;QACvB,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC;QAChC,CAAC,aAAa,CAAC,EAAE,IAAI;KACtB,CAAA;IACD,IAAI,SAAS,KAAK,SAAS;QAAE,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,CAAC,CAAA;IACnE,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAA;AAChC,CAAC;AAOD,MAAM,UAAU,YAAY,CAC1B,QAA6B,EAC7B,GAAiB,EACjB,KAAqB,EACrB,QAA0C,EAAE;IAE5C,OAAO,EAAE,QAAQ,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,CAAA;AACxC,CAAC;AAOD,iFAAiF;AACjF,MAAM,UAAU,gBAAgB,CAC9B,SAAkB,EAClB,UAAoD,EAAE,EACtD,SAAoD,EAAE;IAEtD,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,CAAA;AAC1D,CAAC;AACD,MAAM,UAAU,oBAAoB,CAClC,QAAoC,EACpC,SAAmD,EACnD,GAAiB;IAEjB,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAC7B,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,KAAK,SAAS,CAAC,SAAS,IAAI,MAAM,CAAC,GAAG,KAAK,GAAG,CAC3E,CAAA;IACD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;IAC/D,OAAO,OAAO,CAAC,CAAC,CAAE,CAAA;AACpB,CAAC;AACD,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO;IACL,4JAA4J;IAC5J,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAA0B,CAAC,SAAS,CAAC,KAAK,IAAI,CAC/F,CAAA;AACH,CAAC;AACD,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO;IACL,4JAA4J;IAC5J,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAK,KAAsB,CAAC,aAAa,CAAC,KAAK,IAAI,CAC/F,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { ServerComponentRenderAdapter } from "./types.js";
+export type NativeRender = (component: unknown, props: Record<string, unknown>, renderId: string) => string | Promise<string>;
+export declare function nativeServerComponents(name: "vue" | "svelte" | "solid" | "preact", render: NativeRender): ServerComponentRenderAdapter;
+//# sourceMappingURL=native.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../../src/server-components/native.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAmB,4BAA4B,EAAE,MAAM,YAAY,CAAA;AAE/E,MAAM,MAAM,YAAY,GAAG,CACzB,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,QAAQ,EAAE,MAAM,KACb,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;AAC7B,wBAAgB,sBAAsB,CACpC,IAAI,EAAE,KAAK,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,EAC3C,MAAM,EAAE,YAAY,GACnB,4BAA4B,CAsF9B"}

package/dist/server-components/native.js

@@ -0,0 +1,81 @@
+import { isClientIsland, isNativeServerView } from "./islands.js";
+import { guardComponentProps } from "./props.js";
+import { COMPONENT_LIMITS, componentKey } from "./protocol.js";
+import { componentToken } from "./state.js";
+export function nativeServerComponents(name, render) {
+    return {
+        name,
+        version: 1,
+        async render(view, props, context) {
+            if (typeof view !== "function")
+                throw new Error("component_contract");
+            const value = await view({ props, children: context.children ?? [] });
+            if (!isNativeServerView(value))
+                throw new Error("component_contract");
+            const entries = Object.entries(value.islands);
+            if (entries.length > COMPONENT_LIMITS.instances)
+                throw new Error("component_limit");
+            const seen = new Set();
+            const islands = [];
+            const markup = Object.create(null);
+            for (const [slot, instance] of entries) {
+                if (!/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(slot) ||
+                    !isClientIsland(instance.contract) ||
+                    !componentToken(instance.contract.reference) ||
+                    !componentKey(instance.key) ||
+                    Object.keys(instance.slots).some((name) => !instance.contract.slots.includes(name)))
+                    throw new Error("component_contract");
+                const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(JSON.stringify([context.instance, instance.contract.reference, instance.key])));
+                const renderId = `i_${[...new Uint8Array(digest)].map((n) => n.toString(16).padStart(2, "0")).join("")}`;
+                if (seen.has(renderId))
+                    throw new Error("component_contract");
+                seen.add(renderId);
+                const projected = await guardComponentProps(instance.contract.props, instance.props);
+                // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: The closed schema guard and bounded JSON validator produced this public props object before native rendering.
+                const guarded = projected; // Closed schema guard and JSON check own this boundary.
+                const slots = Object.fromEntries(instance.contract.slots.map((name) => {
+                    const html = instance.slots[name] ?? "";
+                    if (typeof html !== "string")
+                        throw new Error("component_contract");
+                    return [name, `<nifra-slot data-nifra-slot="${name}">${html}</nifra-slot>`];
+                }));
+                const html = await render(instance.contract.component, { ...guarded, slots }, renderId);
+                if (context.signal.aborted)
+                    throw new Error("component_cancelled");
+                markup[slot] = {
+                    html: `<nifra-island data-nifra-island="${renderId}">${html}</nifra-island>`,
+                    renderId,
+                };
+                islands.push({
+                    reference: instance.contract.reference,
+                    key: instance.key,
+                    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: The closed schema guard and bounded JSON validator produced this public props object before native rendering.
+                    props: projected,
+                    renderId,
+                    slots: instance.slots,
+                });
+            }
+            const ranges = Object.create(null);
+            const rangeIds = new Set();
+            for (const [name, child] of Object.entries(value.ranges)) {
+                if (!/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(name) ||
+                    child.parent !== context.instance ||
+                    !(context.children ?? []).includes(child) ||
+                    rangeIds.has(child.instance))
+                    throw new Error("component_contract");
+                rangeIds.add(child.instance);
+                ranges[name] = {
+                    instance: child.instance,
+                    html: '<nifra-component data-nifra-component="' +
+                        child.instance +
+                        '">' +
+                        child.html +
+                        "</nifra-component>",
+                };
+            }
+            const html = await render(value.component, { props, islands: markup, ranges }, `${context.instance}-view`);
+            return { html, islands };
+        },
+    };
+}
+//# sourceMappingURL=native.js.map

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

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

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

@@ -0,0 +1,6 @@
+/** Resolve only a declared target inside the island or component that owns the calling node. */
+export declare function componentPortalTarget(source: Element, target: Element): Element;
+/** Native portal actions register cleanup with the island that owns their target. */
+export declare function ownComponentPortal(source: Element, target: Element, cleanup: () => void | Promise<void>): () => Promise<void>;
+export declare function disposeComponentPortals(owner: Element): Promise<void>;
+//# sourceMappingURL=portal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portal.d.ts","sourceRoot":"","sources":["../../src/server-components/portal.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAY/E;AAID,qFAAqF;AACrF,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,OAAO,EACf,OAAO,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GAClC,MAAM,OAAO,CAAC,IAAI,CAAC,CAarB;AAED,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAI3E"}

package/dist/server-components/portal.js

@@ -0,0 +1,35 @@
+/** Resolve only a declared target inside the island or component that owns the calling node. */
+export function componentPortalTarget(source, target) {
+    const owner = source.closest("[data-nifra-island], [data-nifra-component]");
+    const name = target.getAttribute("data-nifra-portal");
+    if (owner === null ||
+        name === null ||
+        !/^[A-Za-z][A-Za-z0-9_]{0,63}$/.test(name) ||
+        !owner.contains(target) ||
+        target.closest("[data-nifra-island], [data-nifra-component]") !== owner)
+        throw new Error("component_contract");
+    return target;
+}
+const cleanups = new WeakMap();
+/** Native portal actions register cleanup with the island that owns their target. */
+export function ownComponentPortal(source, target, cleanup) {
+    componentPortalTarget(source, target);
+    const owner = source.closest("[data-nifra-island], [data-nifra-component]");
+    const entries = cleanups.get(owner) ?? new Set();
+    let pending;
+    const dispose = () => {
+        entries.delete(dispose);
+        pending ??= Promise.resolve().then(cleanup);
+        return pending;
+    };
+    entries.add(dispose);
+    cleanups.set(owner, entries);
+    return dispose;
+}
+export async function disposeComponentPortals(owner) {
+    const entries = cleanups.get(owner);
+    cleanups.delete(owner);
+    if (entries !== undefined)
+        await Promise.all([...entries].map((cleanup) => cleanup()));
+}
+//# sourceMappingURL=portal.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"portal.js","sourceRoot":"","sources":["../../src/server-components/portal.ts"],"names":[],"mappings":"AAAA,gGAAgG;AAChG,MAAM,UAAU,qBAAqB,CAAC,MAAe,EAAE,MAAe;IACpE,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,6CAA6C,CAAC,CAAA;IAC3E,MAAM,IAAI,GAAG,MAAM,CAAC,YAAY,CAAC,mBAAmB,CAAC,CAAA;IACrD,IACE,KAAK,KAAK,IAAI;QACd,IAAI,KAAK,IAAI;QACb,CAAC,8BAA8B,CAAC,IAAI,CAAC,IAAI,CAAC;QAC1C,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;QACvB,MAAM,CAAC,OAAO,CAAC,6CAA6C,CAAC,KAAK,KAAK;QAEvE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;IACvC,OAAO,MAAM,CAAA;AACf,CAAC;AAED,MAAM,QAAQ,GAAG,IAAI,OAAO,EAAqC,CAAA;AAEjE,qFAAqF;AACrF,MAAM,UAAU,kBAAkB,CAChC,MAAe,EACf,MAAe,EACf,OAAmC;IAEnC,qBAAqB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IACrC,MAAM,KAAK,GAAG,MAAM,CAAC,OAAO,CAAC,6CAA6C,CAAE,CAAA;IAC5E,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAuB,CAAA;IACrE,IAAI,OAAkC,CAAA;IACtC,MAAM,OAAO,GAAG,GAAG,EAAE;QACnB,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,CAAA;QACvB,OAAO,KAAK,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAA;QAC3C,OAAO,OAAO,CAAA;IAChB,CAAC,CAAA;IACD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACpB,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IAC5B,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,KAAc;IAC1D,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;IACnC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IACtB,IAAI,OAAO,KAAK,SAAS;QAAE,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,EAAE,CAAC,CAAC,CAAA;AACxF,CAAC"}

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

@@ -0,0 +1,3 @@
+import type { StandardSchemaV1 } from "@nifrajs/core/schema";
+export declare function guardComponentProps(schema: StandardSchemaV1, value: unknown): Promise<unknown>;
+//# sourceMappingURL=props.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"props.d.ts","sourceRoot":"","sources":["../../src/server-components/props.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAA;AAO5D,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,gBAAgB,EACxB,KAAK,EAAE,OAAO,GACb,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/server-components/props.js

@@ -0,0 +1,14 @@
+import { outputGuard, runGuard } from "../internal/output-guard.js";
+import { assertComponentSchema } from "./schema.js";
+import { componentValue } from "./value.js";
+const guards = new WeakMap();
+export async function guardComponentProps(schema, value) {
+    let guard = guards.get(schema);
+    if (guard === undefined) {
+        assertComponentSchema(schema);
+        guard = outputGuard(schema, "client component", "props");
+        guards.set(schema, guard);
+    }
+    return componentValue(await runGuard(guard, value, "client component props"));
+}
+//# sourceMappingURL=props.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"props.js","sourceRoot":"","sources":["../../src/server-components/props.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAA;AACnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAA;AACnD,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3C,MAAM,MAAM,GAAG,IAAI,OAAO,EAA0C,CAAA;AAEpE,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAwB,EACxB,KAAc;IAEd,IAAI,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAA;IAC9B,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,qBAAqB,CAAC,MAAM,CAAC,CAAA;QAC7B,KAAK,GAAG,WAAW,CAAC,MAAM,EAAE,kBAAkB,EAAE,OAAO,CAAC,CAAA;QACxD,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAA;IAC3B,CAAC;IACD,OAAO,cAAc,CAAC,MAAM,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,wBAAwB,CAAC,CAAC,CAAA;AAC/E,CAAC"}

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

@@ -0,0 +1,44 @@
+import type { ComponentKey, ComponentValue } from "./types.js";
+export declare const COMPONENT_HEADER = "x-nifra-component";
+export declare const COMPONENT_MEDIA_TYPE = "application/vnd.nifra.component-v1";
+export declare const COMPONENT_PROTOCOL = 1;
+export declare const COMPONENT_LIMITS: Readonly<{
+    headerBytes: 2048;
+    encodedHeaderBytes: 2732;
+    inputBytes: 1024;
+    propsBytes: 65536;
+    outputBytes: 1048576;
+    documentBytes: 4194304;
+    frameBytes: 262144;
+    depth: 16;
+    instances: 128;
+    requestLoads: 8;
+    activeLoads: 64;
+    queuedLoads: 128;
+    executionMs: 10000;
+    idleMs: 5000;
+    operationMs: 15000;
+}>;
+export interface ComponentRequest {
+    readonly v: 1;
+    readonly build: string;
+    readonly reference: string;
+    readonly key: ComponentKey;
+    readonly parent: string | null;
+    readonly generation: number;
+    readonly routeEpoch: number;
+    readonly authEpoch: number;
+    readonly input: ComponentValue;
+}
+export declare function componentKey(value: unknown): value is ComponentKey;
+export declare function parseComponentRequest(value: unknown): ComponentRequest;
+export declare function componentRequestHeader(value: ComponentRequest): string;
+export declare function readComponentRequest(request: Request): ComponentRequest | undefined;
+export declare const COMPONENT_RESPONSE_HEADERS: Readonly<{
+    "content-type": "application/vnd.nifra.component-v1";
+    "cache-control": "private, no-store";
+    "x-content-type-options": "nosniff";
+    vary: "x-nifra-component, x-nifra-data";
+}>;
+export declare function componentFailure(error: unknown): Response;
+//# sourceMappingURL=protocol.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/server-components/protocol.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG9D,eAAO,MAAM,gBAAgB,sBAAsB,CAAA;AACnD,eAAO,MAAM,oBAAoB,uCAAuC,CAAA;AACxE,eAAO,MAAM,kBAAkB,IAAI,CAAA;AACnC,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;EAgB3B,CAAA;AAEF,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,CAAC,CAAA;IACb,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,YAAY,CAAA;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;CAC/B;AAiBD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAOlE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAmCtE;AAQD,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,gBAAgB,GAAG,MAAM,CAMtE;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,GAAG,gBAAgB,GAAG,SAAS,CAmCnF;AAED,eAAO,MAAM,0BAA0B;;;;;EAKrC,CAAA;AAEF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAUzD"}

package/dist/server-components/protocol.js

@@ -0,0 +1,139 @@
+import { ServerComponentError } from "./error.js";
+import { componentValue } from "./value.js";
+export const COMPONENT_HEADER = "x-nifra-component";
+export const COMPONENT_MEDIA_TYPE = "application/vnd.nifra.component-v1";
+export const COMPONENT_PROTOCOL = 1;
+export const COMPONENT_LIMITS = Object.freeze({
+    headerBytes: 2048,
+    encodedHeaderBytes: 2732,
+    inputBytes: 1024,
+    propsBytes: 65536,
+    outputBytes: 1048576,
+    documentBytes: 4194304,
+    frameBytes: 262144,
+    depth: 16,
+    instances: 128,
+    requestLoads: 8,
+    activeLoads: 64,
+    queuedLoads: 128,
+    executionMs: 10000,
+    idleMs: 5000,
+    operationMs: 15000,
+});
+const fields = [
+    "v",
+    "build",
+    "reference",
+    "key",
+    "parent",
+    "generation",
+    "routeEpoch",
+    "authEpoch",
+    "input",
+];
+const token = /^[A-Za-z0-9_-]{1,128}$/;
+const encoder = new TextEncoder();
+const decoder = new TextDecoder("utf-8", { fatal: true });
+export function componentKey(value) {
+    return ((typeof value === "string" &&
+        encoder.encode(value).length > 0 &&
+        encoder.encode(value).length <= 128) ||
+        (typeof value === "number" && Number.isSafeInteger(value)));
+}
+export function parseComponentRequest(value) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        throw new ServerComponentError("component_protocol", 400);
+    // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: Object shape is checked before field inspection; every field is validated before a request is returned.
+    const object = value;
+    if (Object.keys(object).length !== fields.length ||
+        fields.some((name) => !Object.hasOwn(object, name)) ||
+        object.v !== 1 ||
+        typeof object.build !== "string" ||
+        !token.test(object.build) ||
+        typeof object.reference !== "string" ||
+        !token.test(object.reference) ||
+        !componentKey(object.key) ||
+        (object.parent !== null && (typeof object.parent !== "string" || !token.test(object.parent)))) {
+        throw new ServerComponentError("component_protocol", 400);
+    }
+    const counter = (value) => {
+        if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0)
+            throw new ServerComponentError("component_protocol", 400);
+        return value;
+    };
+    const input = componentValue(object.input, COMPONENT_LIMITS.inputBytes);
+    return {
+        v: 1,
+        build: object.build,
+        reference: object.reference,
+        key: object.key,
+        parent: object.parent,
+        generation: counter(object.generation),
+        routeEpoch: counter(object.routeEpoch),
+        authEpoch: counter(object.authEpoch),
+        input,
+    };
+}
+function base64url(bytes) {
+    let binary = "";
+    for (const byte of bytes)
+        binary += String.fromCharCode(byte);
+    return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
+}
+export function componentRequestHeader(value) {
+    const request = parseComponentRequest(value);
+    const bytes = encoder.encode(JSON.stringify(request));
+    if (bytes.length > COMPONENT_LIMITS.headerBytes)
+        throw new ServerComponentError("component_limit", 431);
+    return base64url(bytes);
+}
+export function readComponentRequest(request) {
+    const encoded = request.headers.get(COMPONENT_HEADER);
+    if (encoded === null)
+        return undefined;
+    if (request.method !== "GET" ||
+        request.headers.has("x-nifra-data") ||
+        request.headers.has("x-nifra-retain") ||
+        request.headers.has("x-nifra-revalidate") ||
+        request.headers.has("x-nifra-from"))
+        throw new ServerComponentError("component_protocol", 400);
+    if (encoded.length > COMPONENT_LIMITS.encodedHeaderBytes)
+        throw new ServerComponentError("component_limit", 431);
+    if (!/^[A-Za-z0-9_-]+$/.test(encoded) || encoded.length % 4 === 1)
+        throw new ServerComponentError("component_protocol", 400);
+    const origin = new URL(request.url).origin;
+    if (request.headers.get("sec-fetch-site") !== "same-origin" ||
+        (request.headers.has("origin") && request.headers.get("origin") !== origin)) {
+        throw new ServerComponentError("component_denied", 403);
+    }
+    let decoded;
+    try {
+        const binary = atob(encoded.replaceAll("-", "+").replaceAll("_", "/"));
+        const bytes = Uint8Array.from(binary, (char) => char.charCodeAt(0));
+        if (bytes.length > COMPONENT_LIMITS.headerBytes)
+            throw new ServerComponentError("component_limit", 431);
+        if (base64url(bytes) !== encoded)
+            throw new ServerComponentError("component_protocol", 400);
+        decoded = JSON.parse(decoder.decode(bytes));
+    }
+    catch (error) {
+        if (error instanceof ServerComponentError)
+            throw error;
+        throw new ServerComponentError("component_protocol", 400);
+    }
+    return parseComponentRequest(decoded);
+}
+export const COMPONENT_RESPONSE_HEADERS = Object.freeze({
+    "content-type": COMPONENT_MEDIA_TYPE,
+    "cache-control": "private, no-store",
+    "x-content-type-options": "nosniff",
+    vary: "x-nifra-component, x-nifra-data",
+});
+export function componentFailure(error) {
+    const failure = error instanceof ServerComponentError ? error : new ServerComponentError("component_failed");
+    return Response.json({ v: 1, error: failure.code }, {
+        status: failure.status === 499 ? 409 : failure.status,
+        headers: { ...COMPONENT_RESPONSE_HEADERS, "content-type": "application/json" },
+    });
+}
+//# sourceMappingURL=protocol.js.map

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

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

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

@@ -0,0 +1,24 @@
+import type { ComponentClientAdapter, CurrentComponent } from "./client.js";
+import { type ClientIsland } from "./islands.js";
+import type { ComponentIsland, ComponentState } from "./types.js";
+export interface NativeIslandRoot {
+    readonly ready?: Promise<void>;
+    update(props: Record<string, unknown>, current: CurrentComponent): void | Promise<void>;
+    dispose(): void | Promise<void>;
+}
+export interface NativeIslandRuntime {
+    hydrate(host: Element, contract: ClientIsland, record: ComponentIsland, current: CurrentComponent): NativeIslandRoot | Promise<NativeIslandRoot>;
+}
+export interface NativeRangeOptions {
+    readonly adapter: Exclude<ComponentState["adapter"], "react">;
+    readonly islands: readonly ClientIsland[];
+    readonly runtime: NativeIslandRuntime;
+    /** A narrowly scoped Trusted Types policy's createHTML, when the application requires TT. */
+    readonly trustedHTML?: (html: string) => string | {
+        toString(): string;
+    };
+}
+/** Parse inertly and reject executable content before it can reach a live document. */
+export declare function parseComponentHTML(html: string, context: Element, trustedHTML?: NativeRangeOptions["trustedHTML"]): DocumentFragment;
+export declare function nativeComponentClient(options: NativeRangeOptions): ComponentClientAdapter;
+//# sourceMappingURL=range.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"range.d.ts","sourceRoot":"","sources":["../../src/server-components/range.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAuB,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAGhG,OAAO,EAAE,KAAK,YAAY,EAAkB,MAAM,cAAc,CAAA;AAEhE,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAEjE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9B,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,gBAAgB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACvF,OAAO,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAChC;AACD,MAAM,WAAW,mBAAmB;IAClC,OAAO,CACL,IAAI,EAAE,OAAO,EACb,QAAQ,EAAE,YAAY,EACtB,MAAM,EAAE,eAAe,EACvB,OAAO,EAAE,gBAAgB,GACxB,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAA;CAChD;AACD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC,cAAc,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,CAAA;IAC7D,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAA;IACzC,QAAQ,CAAC,OAAO,EAAE,mBAAmB,CAAA;IACrC,6FAA6F;IAC7F,QAAQ,CAAC,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG;QAAE,QAAQ,IAAI,MAAM,CAAA;KAAE,CAAA;CACzE;AAgBD,uFAAuF;AACvF,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,OAAO,EAChB,WAAW,CAAC,EAAE,kBAAkB,CAAC,aAAa,CAAC,GAC9C,gBAAgB,CAWlB;AA4LD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,sBAAsB,CAkEzF"}