@nifrajs/web-react 4.0.2 → 5.0.0

package/dist/server-components/jsx-dev-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.d.ts","sourceRoot":"","sources":["../../src/server-components/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAA0B,MAAM,uBAAuB,CAAA;AAGxE,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB,wBAAgB,MAAM,CACpB,IAAI,EAAE,OAAO,EACb,KAAK,EAAE,OAAO,EACd,GAAG,EAAE,OAAO,EACZ,gBAAgB,EAAE,OAAO,EACzB,MAAM,CAAC,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,EACvE,IAAI,CAAC,EAAE,OAAO,GACb,OAAO,CAcT"}

package/dist/server-components/jsx-dev-runtime.js

@@ -0,0 +1,12 @@
+import { Fragment, jsxDEV as nativeJsxDEV } from "react/jsx-dev-runtime";
+import { guardedClientElement } from "./guard.js";
+export { Fragment };
+export function jsxDEV(type, props, key, isStaticChildren, source, self) {
+    return (guardedClientElement(type, props, key) ??
+        nativeJsxDEV(
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: The guard handles registered client references; other elements use the unchanged native React development JSX ABI.
+        type, props, 
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: The guard handles registered client references; other elements use the unchanged native React development JSX ABI.
+        key, isStaticChildren, source, self));
+}
+//# sourceMappingURL=jsx-dev-runtime.js.map

package/dist/server-components/jsx-dev-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-dev-runtime.js","sourceRoot":"","sources":["../../src/server-components/jsx-dev-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,IAAI,YAAY,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB,MAAM,UAAU,MAAM,CACpB,IAAa,EACb,KAAc,EACd,GAAY,EACZ,gBAAyB,EACzB,MAAuE,EACvE,IAAc;IAEd,OAAO,CACL,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC;QACtC,YAAY;QACV,oLAAoL;QACpL,IAA0C,EAC1C,KAAK;QACL,oLAAoL;QACpL,GAAyB,EACzB,gBAAgB,EAChB,MAAM,EACN,IAAI,CACL,CACF,CAAA;AACH,CAAC"}

package/dist/server-components/jsx-runtime.d.ts

@@ -0,0 +1,5 @@
+import { Fragment } from "react/jsx-runtime";
+export { Fragment };
+export declare function jsx(type: unknown, props: unknown, key?: unknown): unknown;
+export declare function jsxs(type: unknown, props: unknown, key?: unknown): unknown;
+//# sourceMappingURL=jsx-runtime.d.ts.map

package/dist/server-components/jsx-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.d.ts","sourceRoot":"","sources":["../../src/server-components/jsx-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAwC,MAAM,mBAAmB,CAAA;AAGlF,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB,wBAAgB,GAAG,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAMzE;AACD,wBAAgB,IAAI,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAM1E"}

package/dist/server-components/jsx-runtime.js

@@ -0,0 +1,14 @@
+import { Fragment, jsx as nativeJsx, jsxs as nativeJsxs } from "react/jsx-runtime";
+import { guardedClientElement } from "./guard.js";
+export { Fragment };
+export function jsx(type, props, key) {
+    return (guardedClientElement(type, props, key) ??
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: The guard handles registered client references; other elements use the unchanged native React JSX ABI.
+        nativeJsx(type, props, key));
+}
+export function jsxs(type, props, key) {
+    return (guardedClientElement(type, props, key) ??
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: The guard handles registered client references; other elements use the unchanged native React JSX ABI.
+        nativeJsxs(type, props, key));
+}
+//# sourceMappingURL=jsx-runtime.js.map

package/dist/server-components/jsx-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jsx-runtime.js","sourceRoot":"","sources":["../../src/server-components/jsx-runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,GAAG,IAAI,SAAS,EAAE,IAAI,IAAI,UAAU,EAAE,MAAM,mBAAmB,CAAA;AAClF,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEjD,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB,MAAM,UAAU,GAAG,CAAC,IAAa,EAAE,KAAc,EAAE,GAAa;IAC9D,OAAO,CACL,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC;QACtC,wKAAwK;QACxK,SAAS,CAAC,IAAuC,EAAE,KAAK,EAAE,GAAyB,CAAC,CACrF,CAAA;AACH,CAAC;AACD,MAAM,UAAU,IAAI,CAAC,IAAa,EAAE,KAAc,EAAE,GAAa;IAC/D,OAAO,CACL,oBAAoB,CAAC,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC;QACtC,wKAAwK;QACxK,UAAU,CAAC,IAAwC,EAAE,KAAK,EAAE,GAAyB,CAAC,CACvF,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,11 @@
+/** The outer Flight root preserves this host; the controller owns the complete nested range. */
+export declare function NestedServerComponent({ instance, html, }: {
+    readonly instance: string;
+    readonly html: string;
+}): import("react").DOMElement<{
+    "data-nifra-component": string;
+    dangerouslySetInnerHTML: {
+        __html: string;
+    };
+}, Element>;
+//# sourceMappingURL=nested.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nested.d.ts","sourceRoot":"","sources":["../../src/server-components/nested.ts"],"names":[],"mappings":"AAGA,gGAAgG;AAChG,wBAAgB,qBAAqB,CAAC,EACpC,QAAQ,EACR,IAAI,GACL,EAAE;IACD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CACtB;;;;;YAOA"}

package/dist/server-components/nested.js

@@ -0,0 +1,12 @@
+"use client";
+import { createElement, useRef } from "react";
+/** The outer Flight root preserves this host; the controller owns the complete nested range. */
+export function NestedServerComponent({ instance, html, }) {
+    const initial = useRef({ __html: html });
+    return createElement("nifra-component", {
+        "data-nifra-component": instance,
+        // biome-ignore lint/security/noDangerouslySetInnerHtml: Parent rendering provides the verified server-owned nested range.
+        dangerouslySetInnerHTML: initial.current,
+    });
+}
+//# sourceMappingURL=nested.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nested.js","sourceRoot":"","sources":["../../src/server-components/nested.ts"],"names":[],"mappings":"AAAA,YAAY,CAAA;AACZ,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,OAAO,CAAA;AAE7C,gGAAgG;AAChG,MAAM,UAAU,qBAAqB,CAAC,EACpC,QAAQ,EACR,IAAI,GAIL;IACC,MAAM,OAAO,GAAG,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAA;IACxC,OAAO,aAAa,CAAC,iBAAiB,EAAE;QACtC,sBAAsB,EAAE,QAAQ;QAChC,0HAA0H;QAC1H,uBAAuB,EAAE,OAAO,CAAC,OAAO;KACzC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,5 @@
+export declare const NestedServerComponent: import("@nifrajs/schema").NifraSchema<import("@sinclair/typebox").TObject<{
+    instance: import("@sinclair/typebox").TString;
+    html: import("@sinclair/typebox").TString;
+}>>;
+//# sourceMappingURL=nested.props.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nested.props.d.ts","sourceRoot":"","sources":["../../src/server-components/nested.props.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,qBAAqB;;;GAAuD,CAAA"}

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

@@ -0,0 +1,3 @@
+import { t } from "@nifrajs/schema";
+export const NestedServerComponent = t.object({ instance: t.string(), html: t.string() });
+//# sourceMappingURL=nested.props.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"nested.props.js","sourceRoot":"","sources":["../../src/server-components/nested.props.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,iBAAiB,CAAA;AACnC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAA"}

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

@@ -0,0 +1,19 @@
+import { type ComponentClientAdapter, ComponentController, type ServerComponent as ComponentHandle, type ComponentKey, type ComponentState } from "@nifrajs/web/server-components/client";
+export interface ServerComponentProps<Input, Props, View> {
+    readonly state: ComponentState;
+    readonly component: ComponentHandle<Input, Props, View>;
+    readonly instanceKey: ComponentKey;
+    readonly input: NoInfer<Input>;
+    readonly parent?: string;
+    readonly controller?: ComponentController | undefined;
+    readonly clientAdapter?: ComponentClientAdapter;
+    readonly onError?: (code: string) => void;
+}
+export declare function ServerComponent<Input, Props, View>(props: ServerComponentProps<Input, Props, View>): import("react").FunctionComponentElement<{
+    readonly state: ComponentState;
+    readonly record: import("@nifrajs/web/server-components/client").ComponentRecord;
+    readonly controller?: ComponentController | undefined;
+    readonly clientAdapter?: ComponentClientAdapter | undefined;
+    readonly onError?: ((code: string) => void) | undefined;
+}>;
+//# sourceMappingURL=outlet.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"outlet.d.ts","sourceRoot":"","sources":["../../src/server-components/outlet.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAC3B,mBAAmB,EACnB,KAAK,eAAe,IAAI,eAAe,EACvC,KAAK,YAAY,EACjB,KAAK,cAAc,EAEpB,MAAM,uCAAuC,CAAA;AAwB9C,MAAM,WAAW,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI;IACtD,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAA;IAC9B,QAAQ,CAAC,SAAS,EAAE,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,CAAA;IACvD,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAA;IAClC,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,CAAA;IAC9B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAA;IACrD,QAAQ,CAAC,aAAa,CAAC,EAAE,sBAAsB,CAAA;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAA;CAC1C;AACD,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAChD,KAAK,EAAE,oBAAoB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC;oBAmB/B,cAAc;qBACb,OAAO,uCAAuC,EAAE,eAAe;0BAC1D,mBAAmB,GAAG,SAAS;6BAC5B,sBAAsB,GAAG,SAAS;uBACxC,CAAC,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC,GAAG,SAAS;GANxD"}

package/dist/server-components/outlet.js

@@ -0,0 +1,76 @@
+import { ComponentController, resolveComponentRecord, } from "@nifrajs/web/server-components/client";
+import { createElement, useLayoutEffect, useRef } from "react";
+function lazyClient() {
+    let pending;
+    const client = () => {
+        if (typeof __NIFRA_COMPONENT_BROWSER__ === "boolean" && !__NIFRA_COMPONENT_BROWSER__)
+            throw new Error("component_contract");
+        pending ??= import("./client.js").then((module) => module.reactComponentClient());
+        return pending;
+    };
+    return {
+        name: "react",
+        prepare: async (...args) => (await client()).prepare(...args),
+        hydrate: async (...args) => (await client()).hydrate(...args),
+        create: async (...args) => {
+            const create = (await client()).create;
+            if (create === undefined)
+                throw new Error("component_contract");
+            return create(...args);
+        },
+        update: async (...args) => (await client()).update(...args),
+    };
+}
+export function ServerComponent(props) {
+    const record = resolveComponentRecord(props.state, props.component, props.instanceKey, props.input, props.parent ?? null);
+    return createElement(ComponentRange, {
+        key: record.instance,
+        state: props.state,
+        record,
+        controller: props.controller,
+        clientAdapter: props.clientAdapter,
+        onError: props.onError,
+    });
+}
+function ComponentRange(props) {
+    const record = props.record;
+    const host = useRef(null);
+    // React owns the shell; the independently hydrated native root is an unassociated child.
+    const initial = useRef({
+        __html: `<nifra-component data-nifra-component="${record.instance}">${record.html}</nifra-component>`,
+    });
+    const active = useRef(undefined);
+    const lifecycle = useRef(props);
+    lifecycle.current = props;
+    useLayoutEffect(() => {
+        const options = lifecycle.current;
+        const element = host.current?.firstElementChild;
+        if (!(element instanceof HTMLElement) || element.localName !== "nifra-component")
+            return;
+        const controller = options.controller ??
+            new ComponentController({
+                state: options.state,
+                adapter: options.clientAdapter ?? lazyClient(),
+                onError: (code) => lifecycle.current.onError?.(code),
+            });
+        active.current = controller;
+        void controller
+            .mount(element, record.instance)
+            .catch(() => lifecycle.current.onError?.("component_failed"));
+        return () => {
+            void (options.controller === undefined
+                ? controller.dispose()
+                : controller.unmount(record.instance)).catch(() => lifecycle.current.onError?.("component_failed"));
+        };
+    }, [record.instance]);
+    useLayoutEffect(() => {
+        if (active.current !== undefined)
+            void active.current.adopt(props.state).catch(() => props.onError?.("component_failed"));
+    }, [props.state, props.onError]);
+    return createElement("nifra-component-outlet", {
+        ref: host,
+        // biome-ignore lint/security/noDangerouslySetInnerHtml: Record HTML passed the shared component policy before an outlet can resolve it.
+        dangerouslySetInnerHTML: initial.current,
+    });
+}
+//# sourceMappingURL=outlet.js.map

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

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

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

@@ -0,0 +1,4 @@
+import type { ComponentRenderContext, ServerComponentHandle } from "@nifrajs/web/server-components";
+/** Export this renderer from the compiler's RSC entry, which owns React's server condition. */
+export declare function createReactComponentRenderer(components: readonly ServerComponentHandle[]): (reference: string, props: unknown, context: ComponentRenderContext) => Promise<ReadableStream<Uint8Array>>;
+//# sourceMappingURL=rsc.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rsc.d.ts","sourceRoot":"","sources":["../../src/server-components/rsc.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAA;AAMnG,+FAA+F;AAC/F,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,SAAS,qBAAqB,EAAE,IAKrF,WAAW,MAAM,EACjB,OAAO,OAAO,EACd,SAAS,sBAAsB,KAC9B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAuBvC"}

package/dist/server-components/rsc.js

@@ -0,0 +1,33 @@
+import { guardComponentProps } from "@nifrajs/web/server-components/props";
+import { renderToReadableStream } from "@vitejs/plugin-rsc/rsc/server";
+import { createElement } from "react";
+import { publicFlightStream } from "./flight.js";
+/** Export this renderer from the compiler's RSC entry, which owns React's server condition. */
+export function createReactComponentRenderer(components) {
+    const references = new Map(components.map((component) => [component.reference, component]));
+    if (references.size !== components.length || references.has(undefined))
+        throw new Error("component_contract");
+    return async (reference, props, context) => {
+        const component = references.get(reference);
+        if (component === undefined)
+            throw new Error("component_unavailable");
+        const projected = await guardComponentProps(component.props, props);
+        const stream = renderToReadableStream(
+        // biome-ignore lint/plugin/requireSafetyCommentForTypeAssertion: The renderer resolves an allowlisted definition and guards its public props before invoking that definition.
+        createElement(component.view, {
+            props: projected,
+            // biome-ignore lint/correctness/noChildrenProp: Server views receive verified record metadata through their declared children prop.
+            children: context.children ?? [],
+        }), {
+            signal: context.signal,
+            // React development debug metadata can contain server-only props; it has no public transport.
+            debugChannel: { writable: new WritableStream({ write() { } }) },
+            filterStackFrame: () => false,
+            onError() {
+                return "component_failed";
+            },
+        });
+        return publicFlightStream(stream, context.signal);
+    };
+}
+//# sourceMappingURL=rsc.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rsc.js","sourceRoot":"","sources":["../../src/server-components/rsc.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sCAAsC,CAAA;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,+BAA+B,CAAA;AACtE,OAAO,EAAsB,aAAa,EAAE,MAAM,OAAO,CAAA;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAA;AAEhD,+FAA+F;AAC/F,MAAM,UAAU,4BAA4B,CAAC,UAA4C;IACvF,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAC3F,IAAI,UAAU,CAAC,IAAI,KAAK,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAA;IACvC,OAAO,KAAK,EACV,SAAiB,EACjB,KAAc,EACd,OAA+B,EACM,EAAE;QACvC,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAA;QAC3C,IAAI,SAAS,KAAK,SAAS;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAA;QACrE,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAA;QACnE,MAAM,MAAM,GAAG,sBAAsB;QACnC,8KAA8K;QAC9K,aAAa,CAAC,SAAS,CAAC,IAA4D,EAAE;YACpF,KAAK,EAAE,SAAS;YAChB,oIAAoI;YACpI,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE;SACjC,CAAC,EACF;YACE,MAAM,EAAE,OAAO,CAAC,MAAM;YACtB,8FAA8F;YAC9F,YAAY,EAAE,EAAE,QAAQ,EAAE,IAAI,cAAc,CAAa,EAAE,KAAK,KAAI,CAAC,EAAE,CAAC,EAAE;YAC1E,gBAAgB,EAAE,GAAG,EAAE,CAAC,KAAK;YAC7B,OAAO;gBACL,OAAO,kBAAkB,CAAA;YAC3B,CAAC;SACF,CACF,CAAA;QACD,OAAO,kBAAkB,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;IACnD,CAAC,CAAA;AACH,CAAC"}

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

@@ -0,0 +1,4 @@
+import type { ComponentRenderContext, ServerComponentRenderAdapter } from "@nifrajs/web/server-components";
+export type ReactFlightRenderer = (reference: string, props: unknown, context: ComponentRenderContext) => Promise<ReadableStream<Uint8Array>>;
+export declare function reactServerComponents(renderFlight: ReactFlightRenderer): ServerComponentRenderAdapter;
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/server-components/server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,sBAAsB,EACtB,4BAA4B,EAC7B,MAAM,gCAAgC,CAAA;AAUvC,MAAM,MAAM,mBAAmB,GAAG,CAChC,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,sBAAsB,KAC5B,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC,CAAA;AAExC,wBAAgB,qBAAqB,CACnC,YAAY,EAAE,mBAAmB,GAChC,4BAA4B,CA8B9B"}

package/dist/server-components/server.js

@@ -0,0 +1,34 @@
+import { bytesStream, encodeComponentBytes, readComponentBytes, } from "@nifrajs/web/server-components/stream";
+import { createFromReadableStream } from "@vitejs/plugin-rsc/ssr";
+import { renderToReadableStream } from "react-dom/server.edge";
+export function reactServerComponents(renderFlight) {
+    return {
+        name: "react",
+        version: 1,
+        async render(_view, props, context) {
+            const flight = await readComponentBytes(await renderFlight(context.reference, props, context), context.signal);
+            const tree = await createFromReadableStream(bytesStream(flight));
+            let failed = false;
+            const options = {
+                identifierPrefix: context.instance + "-",
+                signal: context.signal,
+                onError() {
+                    failed = true;
+                    return "component_failed";
+                },
+            };
+            if (context.nonce !== undefined)
+                options.nonce = context.nonce;
+            const html = await renderToReadableStream(tree, options);
+            await html.allReady;
+            const bytes = await readComponentBytes(html, context.signal);
+            if (failed)
+                throw new Error("component_failed");
+            return {
+                html: new TextDecoder().decode(bytes),
+                payload: { flight: encodeComponentBytes(flight) },
+            };
+        },
+    };
+}
+//# sourceMappingURL=server.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../../src/server-components/server.ts"],"names":[],"mappings":"AAIA,OAAO,EACL,WAAW,EACX,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,uCAAuC,CAAA;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAA;AAEjE,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAA;AAQ9D,MAAM,UAAU,qBAAqB,CACnC,YAAiC;IAEjC,OAAO;QACL,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,CAAC;QACV,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO;YAChC,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACrC,MAAM,YAAY,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,EAAE,OAAO,CAAC,EACrD,OAAO,CAAC,MAAM,CACf,CAAA;YACD,MAAM,IAAI,GAAG,MAAM,wBAAwB,CAAY,WAAW,CAAC,MAAM,CAAC,CAAC,CAAA;YAC3E,IAAI,MAAM,GAAG,KAAK,CAAA;YAClB,MAAM,OAAO,GAA8D;gBACzE,gBAAgB,EAAE,OAAO,CAAC,QAAQ,GAAG,GAAG;gBACxC,MAAM,EAAE,OAAO,CAAC,MAAM;gBACtB,OAAO;oBACL,MAAM,GAAG,IAAI,CAAA;oBACb,OAAO,kBAAkB,CAAA;gBAC3B,CAAC;aACF,CAAA;YACD,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS;gBAAE,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAA;YAC9D,MAAM,IAAI,GAAG,MAAM,sBAAsB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;YACxD,MAAM,IAAI,CAAC,QAAQ,CAAA;YACnB,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAA;YAC5D,IAAI,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,kBAAkB,CAAC,CAAA;YAC/C,OAAO;gBACL,IAAI,EAAE,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC;gBACrC,OAAO,EAAE,EAAE,MAAM,EAAE,oBAAoB,CAAC,MAAM,CAAC,EAAE;aAClD,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nifrajs/web-react",
-  "version": "4.0.2",
+  "version": "5.0.0",
   "description": "React render adapter for @nifrajs/web - SSR + hydration (Bun-native JSX, no Babel).",
   "keywords": [
     "bun",
@@ -80,6 +80,46 @@
       "bun": "./src/fn.ts",
       "types": "./dist/fn.d.ts",
       "default": "./dist/fn.js"
+    },
+    "./server-components/guard": {
+      "bun": "./src/server-components/guard.ts",
+      "types": "./dist/server-components/guard.d.ts",
+      "default": "./dist/server-components/guard.js"
+    },
+    "./server-components/jsx-runtime": {
+      "bun": "./src/server-components/jsx-runtime.ts",
+      "types": "./dist/server-components/jsx-runtime.d.ts",
+      "default": "./dist/server-components/jsx-runtime.js"
+    },
+    "./server-components/jsx-dev-runtime": {
+      "bun": "./src/server-components/jsx-dev-runtime.ts",
+      "types": "./dist/server-components/jsx-dev-runtime.d.ts",
+      "default": "./dist/server-components/jsx-dev-runtime.js"
+    },
+    "./server-components": {
+      "bun": "./src/server-components/server.ts",
+      "types": "./dist/server-components/server.d.ts",
+      "default": "./dist/server-components/server.js"
+    },
+    "./server-components/rsc": {
+      "bun": "./src/server-components/rsc.ts",
+      "types": "./dist/server-components/rsc.d.ts",
+      "default": "./dist/server-components/rsc.js"
+    },
+    "./server-components/client": {
+      "bun": "./src/server-components/client.ts",
+      "types": "./dist/server-components/client.d.ts",
+      "default": "./dist/server-components/client.js"
+    },
+    "./server-components/outlet": {
+      "bun": "./src/server-components/outlet.ts",
+      "types": "./dist/server-components/outlet.d.ts",
+      "default": "./dist/server-components/outlet.js"
+    },
+    "./server-components/nested": {
+      "bun": "./src/server-components/nested.ts",
+      "types": "./dist/server-components/nested.d.ts",
+      "default": "./dist/server-components/nested.js"
     }
   },
   "files": [
@@ -95,21 +135,27 @@
     "access": "public"
   },
   "dependencies": {
-    "@nifrajs/core": "4.0.2",
-    "@nifrajs/authjs": "4.0.2",
-    "@nifrajs/i18n": "4.0.2",
-    "@nifrajs/image": "4.0.2",
-    "@nifrajs/web": "4.0.2"
+    "@nifrajs/core": "5.0.0",
+    "@nifrajs/authjs": "5.0.0",
+    "@nifrajs/i18n": "5.0.0",
+    "@nifrajs/image": "5.0.0",
+    "@nifrajs/web": "5.0.0",
+    "@nifrajs/schema": "5.0.0"
   },
   "peerDependencies": {
     "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "react-dom": "^19.0.0",
+    "@vitejs/plugin-rsc": "0.5.35",
+    "react-server-dom-webpack": "19.2.8"
   },
   "devDependencies": {
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "react": "^19.0.0",
-    "react-dom": "^19.0.0"
+    "react-dom": "^19.0.0",
+    "@vitejs/plugin-rsc": "0.5.35",
+    "react-server-dom-webpack": "19.2.8",
+    "vite": "8.2.1"
   },
   "repository": {
     "type": "git",
@@ -119,5 +165,13 @@
   "bugs": {
     "url": "https://github.com/nifrajs/nifra/issues"
   },
-  "homepage": "https://github.com/nifrajs/nifra#readme"
+  "homepage": "https://github.com/nifrajs/nifra#readme",
+  "peerDependenciesMeta": {
+    "@vitejs/plugin-rsc": {
+      "optional": true
+    },
+    "react-server-dom-webpack": {
+      "optional": true
+    }
+  }
 }

package/src/auth.ts

@@ -18,6 +18,7 @@ import {
   useContext,
   useEffect,
   useMemo,
+  useRef,
   useState,
 } from "react"
 
@@ -55,7 +56,18 @@ export function AuthSessionProvider(props: AuthSessionProviderProps): ReactNode
   const [seed, setSeed] = useState(props.initialSession)
   const [status, setStatus] = useState<AuthStatus>(seededStatus(props.initialSession))
   const [session, setSession] = useState<Session | null>(props.initialSession ?? null)
+  // A read applies only while it holds the latest generation; a newer read, a sign-out, a new client
+  // or seed, and unmount each take one. The record is never replaced, so a sign-out that settles
+  // after a client or seed change still clears the session the server ended.
+  const reads = useRef({ generation: 0, signingOut: 0, live: true, client })
+  if (reads.current.client !== client) {
+    // A new client keeps what is shown (a parent may build one per render); only answers to the
+    // previous client's reads are dropped.
+    reads.current.client = client
+    reads.current.generation++
+  }
   if (seed !== props.initialSession) {
+    reads.current.generation++
     // A render-phase update: React re-runs this component before any child sees the old session.
     setSeed(props.initialSession)
     setStatus(seededStatus(props.initialSession))
@@ -63,40 +75,35 @@ export function AuthSessionProvider(props: AuthSessionProviderProps): ReactNode
   }
   const refresh = useMemo(() => {
     return async (): Promise<void> => {
+      const state = reads.current
+      // A read made while signing out could answer with the session being ended.
+      if (state.signingOut > 0 || state.client !== client) return
+      const generation = ++state.generation
       try {
         const next = await client.getSession()
+        if (!state.live || state.generation !== generation) return
         setSession(next)
         setStatus(next === null ? "unauthenticated" : "authenticated")
       } catch {
         // A failed session read must fail closed as anonymous; leaving "loading" can strand the
         // subtree in an auth-pending state and make protected UI appear available by omission.
+        if (!state.live || state.generation !== generation) return
         setSession(null)
         setStatus("unauthenticated")
       }
     }
   }, [client])
   useEffect(() => {
-    let live = true
+    const state = reads.current
+    state.live = true
     if (props.initialSession === undefined) {
-      void client.getSession().then(
-        (next) => {
-          if (!live) return
-          setSession(next)
-          setStatus(next === null ? "unauthenticated" : "authenticated")
-        },
-        () => {
-          // Treat an unavailable session endpoint as anonymous rather than keeping auth state
-          // pending indefinitely or exposing stale authenticated UI.
-          if (!live) return
-          setSession(null)
-          setStatus("unauthenticated")
-        },
-      )
+      void refresh()
     }
     return () => {
-      live = false
+      state.live = false
+      state.generation++
     }
-  }, [client, props.initialSession])
+  }, [refresh, props.initialSession])
   const value = useMemo<AuthSession>(
     () => ({
       status,
@@ -104,7 +111,16 @@ export function AuthSessionProvider(props: AuthSessionProviderProps): ReactNode
       refresh,
       signIn: (providerId, options) => client.signIn(providerId, options),
       signOut: async (options) => {
-        await client.signOut(options)
+        const state = reads.current
+        state.signingOut++
+        state.generation++
+        try {
+          await client.signOut(options)
+        } finally {
+          state.signingOut--
+          state.generation++
+        }
+        if (!state.live) return
         // The server ended the session: the subtree must not go on showing it, whether a redirect is
         // pending or `redirect: false` keeps the page.
         setSession(null)

package/src/react-dom-server.ts

@@ -124,7 +124,7 @@ export function assertSingleReactCore(
     rendererReact = realpath(resolve("react", dirnamePortable(reactDomServerPath)))
     // The `react` the app's route components import - the core they call hooks on.
     componentsReact = realpath(resolve("react", appRoot()))
-    // @nifra-gate-reviewed: not a security gate. If either `react` cannot be resolved we cannot prove
+    // nifra-expect NF-S001: not a security gate. If either `react` cannot be resolved we cannot prove
     // a duplicate exists, so we skip the assertion rather than block a valid render.
   } catch {
     return

package/src/route-props.ts

@@ -17,6 +17,7 @@ export function routeProps(
   const rawSearch = q === -1 ? "" : state.path.slice(q)
   return {
     data: state.data,
+    ...(state.serverComponents === undefined ? {} : { serverComponents: state.serverComponents }),
     // Each layout's own loader data. Without it a layout renders `data: null` on the client while the
     // server rendered it with its data - a hydration mismatch on the first paint.
     ...(state.layoutData !== undefined ? { layoutData: state.layoutData } : {}),