@fluxfast/react 0.0.0-oidc-bootstrap.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 FluxFast Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,52 @@
+# @fluxfast/react
+
+Host-independent React bindings introduced in FluxFast 1.2. These bindings are
+shared by the Next.js and React/Vite hosts, not a standalone HTTP server.
+Existing Next.js applications continue importing `@fluxfast/next`;
+that adapter re-exports the same context, components, hooks, and types.
+
+FastAPI owns application URLs, authentication, resource loading, validation,
+and mutations. These bindings subscribe to `@fluxfast/core`; they do not
+introduce another router or resource cache. A host supplies SSR, the HTML
+document, safe serialization, hydration, assets, and same-origin transport.
+
+## Render a server-selected page
+
+```tsx
+import { FluxRoot, useResource, type FluxApplicationProps } from "@fluxfast/react";
+
+function Rooms() {
+  const rooms = useResource<Array<{ id: number; name: string }>>("rooms");
+  return <ul>{rooms.map(room => <li key={room.id}>{room.name}</li>)}</ul>;
+}
+
+export function Application(props: FluxApplicationProps) {
+  return <FluxRoot {...props} registry={{ "rooms/index": Rooms }} />;
+}
+```
+
+Given an envelope selecting `rooms/index` with a ready `rooms` resource, SSR
+renders its list. The host must hydrate from that same envelope. `FluxRoot`
+starts history, deferred work, and live subscriptions only after hydration.
+Unknown component identifiers fail against the explicit registry; they never
+become arbitrary module paths. Use `Link` for eligible same-origin visits,
+`useResourceState` for status/errors/staleness, `useDeferredResource` for deferred
+values and retry, `useLiveStatus` for connection state, and `useForm` for mutations
+and generated client validation. These retain the existing Next binding semantics.
+
+For custom layouts, `FluxProvider` accepts the same envelope and registry and
+wraps children that use these hooks. `FluxContext` and `useFluxContext` expose
+the shared runtime to integration authors. Core owns navigation, caching,
+deferred authority, mutation patches, and live synchronization.
+
+See the [adapter contract](https://github.com/El37628/FluxFast/blob/main/docs/adapter-contract.md)
+for the host lifecycle and [React API reference](https://github.com/El37628/FluxFast/blob/main/docs/react-api.md)
+for the complete binding API. Application developers can use the
+[React/Vite tutorial](https://github.com/El37628/FluxFast/blob/main/docs/react-getting-started.md).
+
+Separate `@fluxfast/react/server` and `@fluxfast/react/client` entries
+provide safe document SSR and exact-envelope hydration for host authors. They
+do not export a Vite plugin, asset server, or process supervisor; those belong
+to the complete `@fluxfast/vite` host and Python CLI.
+See the [SSR integration reference](https://github.com/El37628/FluxFast/blob/main/docs/react-ssr.md); never import the
+Node server entry into browser application code.

package/dist/client.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import { type Root, type HydrationOptions } from "react-dom/client";
+import type { FluxApplicationProps } from "./config.js";
+export interface HydrateFluxApplicationOptions {
+    document?: Document;
+    onRecoverableError?: HydrationOptions["onRecoverableError"];
+}
+/** Hydrate the actual SSR markup from its exact envelope, without a fetch. */
+export declare function hydrateFluxApplication(application: React.ComponentType<FluxApplicationProps>, options?: HydrateFluxApplicationOptions): Root;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAe,KAAK,IAAI,EAAE,KAAK,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAEjF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAIxD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,kBAAkB,CAAC,EAAE,gBAAgB,CAAC,oBAAoB,CAAC,CAAC;CAC7D;AAED,8EAA8E;AAC9E,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,oBAAoB,CAAC,EACtD,OAAO,GAAE,6BAAkC,GAC1C,IAAI,CA0BN"}

package/dist/client.js

@@ -0,0 +1,41 @@
+"use strict";
+"use client";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hydrateFluxApplication = hydrateFluxApplication;
+const react_1 = __importDefault(require("react"));
+const client_1 = require("react-dom/client");
+const core_1 = require("@fluxfast/core");
+const document_js_1 = require("./document.js");
+const hydration_js_1 = require("./hydration.js");
+/** Hydrate the actual SSR markup from its exact envelope, without a fetch. */
+function hydrateFluxApplication(application, options = {}) {
+    const document = options.document ?? globalThis.document;
+    const roots = document.querySelectorAll(`[id="${document_js_1.ROOT_ID}"]`);
+    const payloads = document.querySelectorAll(`[id="${document_js_1.PAYLOAD_ID}"]`);
+    if (roots.length !== 1 || payloads.length !== 1 || payloads[0].tagName !== "SCRIPT" || payloads[0].getAttribute("type") !== "application/json") {
+        throw new TypeError("FluxFast document requires one SSR root and one JSON payload");
+    }
+    const payload = JSON.parse(payloads[0].textContent ?? "");
+    if (!payload || typeof payload !== "object" || Array.isArray(payload) || !("initialEnvelope" in payload)) {
+        throw new TypeError("Invalid FluxFast hydration payload");
+    }
+    (0, core_1.assertPageEnvelope)(payload.initialEnvelope);
+    // Only server-owned application props cross this boundary; do not spread an
+    // arbitrary object into React or allow it to choose a private transport URL.
+    const props = { initialEnvelope: payload.initialEnvelope };
+    if ("cache" in payload && payload.cache !== undefined) {
+        props.cache = (0, hydration_js_1.readFluxCacheConfig)(payload.cache);
+    }
+    if ("development" in payload && payload.development !== undefined) {
+        if (typeof process === "undefined" || process.env?.NODE_ENV !== "production") {
+            props.development = (0, hydration_js_1.readFluxDevelopmentMetadata)(payload.development);
+        }
+    }
+    return (0, client_1.hydrateRoot)(roots[0], react_1.default.createElement(application, props), {
+        identifierPrefix: document_js_1.IDENTIFIER_PREFIX, onRecoverableError: options.onRecoverableError,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";AAAA,YAAY,CAAC;;;;;;AAEb,kDAA0B;AAC1B,6CAAiF;AACjF,yCAAoD;AAEpD,+CAAuE;AACvE,iDAAkF;AAOlF,8EAA8E;AAC9E,gCACE,WAAsD,EACtD,OAAO,GAAkC,EAAE;IAE3C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,qBAAO,IAAI,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,wBAAU,IAAI,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,kBAAkB,EAAE,CAAC;QAC/I,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,OAAO,GAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,iBAAiB,IAAI,OAAO,CAAC,EAAE,CAAC;QACzG,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC5D,CAAC;IACD,IAAA,yBAAkB,EAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5C,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,KAAK,GAAyB,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;IACjF,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACtD,KAAK,CAAC,KAAK,GAAG,IAAA,kCAAmB,EAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,aAAa,IAAI,OAAO,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAClE,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC7E,KAAK,CAAC,WAAW,GAAG,IAAA,0CAA2B,EAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,IAAA,oBAAW,EAAC,KAAK,CAAC,CAAC,CAAC,EAAE,eAAK,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE;QACpE,gBAAgB,EAAE,+BAAiB,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;KACpF,CAAC,CAAC;AACL,CAAC"}

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+import type { FluxServerDiagnosticTrace, PageEnvelope } from "@fluxfast/core";
+export interface FluxCacheConfig {
+    maxResources?: number;
+    maxPages?: number;
+}
+/** Safe, development-only metadata captured before browser hydration. */
+export interface FluxDevelopmentMetadata {
+    initialPath: string;
+    initialServerTrace: FluxServerDiagnosticTrace;
+}
+export interface FluxApplicationProps {
+    initialEnvelope: PageEnvelope;
+    development?: FluxDevelopmentMetadata;
+    clientUrl?: string;
+    cache?: FluxCacheConfig;
+}
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,yBAAyB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9E,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,yEAAyE;AACzE,MAAM,WAAW,uBAAuB;IACtC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,yBAAyB,CAAC;CAC/C;AAED,MAAM,WAAW,oBAAoB;IACnC,eAAe,EAAE,YAAY,CAAC;IAC9B,WAAW,CAAC,EAAE,uBAAuB,CAAC;IACtC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB"}

package/dist/config.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":""}

package/dist/document.d.ts

@@ -0,0 +1,7 @@
+/** Shared document identifiers, never a backend URL or application route table. */
+export declare const ROOT_ID = "fluxfast-root";
+export declare const PAYLOAD_ID = "fluxfast-page";
+export declare const IDENTIFIER_PREFIX = "fluxfast-";
+export declare const SSR_MARKER = "<!--fluxfast:ssr-->";
+export declare const PAYLOAD_MARKER = "<!--fluxfast:payload-->";
+//# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,OAAO,kBAAkB,CAAC;AACvC,eAAO,MAAM,UAAU,kBAAkB,CAAC;AAC1C,eAAO,MAAM,iBAAiB,cAAc,CAAC;AAC7C,eAAO,MAAM,UAAU,wBAAwB,CAAC;AAChD,eAAO,MAAM,cAAc,4BAA4B,CAAC"}

package/dist/document.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PAYLOAD_MARKER = exports.SSR_MARKER = exports.IDENTIFIER_PREFIX = exports.PAYLOAD_ID = exports.ROOT_ID = void 0;
+/** Shared document identifiers, never a backend URL or application route table. */
+exports.ROOT_ID = "fluxfast-root";
+exports.PAYLOAD_ID = "fluxfast-page";
+exports.IDENTIFIER_PREFIX = "fluxfast-";
+exports.SSR_MARKER = "<!--fluxfast:ssr-->";
+exports.PAYLOAD_MARKER = "<!--fluxfast:payload-->";
+//# sourceMappingURL=document.js.map

package/dist/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":";;;AAAA,mFAAmF;AACtE,QAAA,OAAO,GAAG,eAAe,CAAC;AAC1B,QAAA,UAAU,GAAG,eAAe,CAAC;AAC7B,QAAA,iBAAiB,GAAG,WAAW,CAAC;AAChC,QAAA,UAAU,GAAG,qBAAqB,CAAC;AACnC,QAAA,cAAc,GAAG,yBAAyB,CAAC"}

package/dist/esm/client.js

@@ -0,0 +1,35 @@
+"use client";
+import React from "react";
+import { hydrateRoot } from "react-dom/client";
+import { assertPageEnvelope } from "@fluxfast/core";
+import { IDENTIFIER_PREFIX, PAYLOAD_ID, ROOT_ID } from "./document.js";
+import { readFluxCacheConfig, readFluxDevelopmentMetadata } from "./hydration.js";
+/** Hydrate the actual SSR markup from its exact envelope, without a fetch. */
+export function hydrateFluxApplication(application, options = {}) {
+    const document = options.document ?? globalThis.document;
+    const roots = document.querySelectorAll(`[id="${ROOT_ID}"]`);
+    const payloads = document.querySelectorAll(`[id="${PAYLOAD_ID}"]`);
+    if (roots.length !== 1 || payloads.length !== 1 || payloads[0].tagName !== "SCRIPT" || payloads[0].getAttribute("type") !== "application/json") {
+        throw new TypeError("FluxFast document requires one SSR root and one JSON payload");
+    }
+    const payload = JSON.parse(payloads[0].textContent ?? "");
+    if (!payload || typeof payload !== "object" || Array.isArray(payload) || !("initialEnvelope" in payload)) {
+        throw new TypeError("Invalid FluxFast hydration payload");
+    }
+    assertPageEnvelope(payload.initialEnvelope);
+    // Only server-owned application props cross this boundary; do not spread an
+    // arbitrary object into React or allow it to choose a private transport URL.
+    const props = { initialEnvelope: payload.initialEnvelope };
+    if ("cache" in payload && payload.cache !== undefined) {
+        props.cache = readFluxCacheConfig(payload.cache);
+    }
+    if ("development" in payload && payload.development !== undefined) {
+        if (typeof process === "undefined" || process.env?.NODE_ENV !== "production") {
+            props.development = readFluxDevelopmentMetadata(payload.development);
+        }
+    }
+    return hydrateRoot(roots[0], React.createElement(application, props), {
+        identifierPrefix: IDENTIFIER_PREFIX, onRecoverableError: options.onRecoverableError,
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,WAAW,EAAoC,MAAM,kBAAkB,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAEpD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACvE,OAAO,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAOlF,8EAA8E;AAC9E,MAAM,UAAU,sBAAsB,CACpC,WAAsD,EACtD,OAAO,GAAkC,EAAE;IAE3C,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,UAAU,CAAC,QAAQ,CAAC;IACzD,MAAM,KAAK,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,OAAO,IAAI,CAAC,CAAC;IAC7D,MAAM,QAAQ,GAAG,QAAQ,CAAC,gBAAgB,CAAC,QAAQ,UAAU,IAAI,CAAC,CAAC;IACnE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,MAAM,CAAC,KAAK,kBAAkB,EAAE,CAAC;QAC/I,MAAM,IAAI,SAAS,CAAC,8DAA8D,CAAC,CAAC;IACtF,CAAC;IACD,MAAM,OAAO,GAAY,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IACnE,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,iBAAiB,IAAI,OAAO,CAAC,EAAE,CAAC;QACzG,MAAM,IAAI,SAAS,CAAC,oCAAoC,CAAC,CAAC;IAC5D,CAAC;IACD,kBAAkB,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;IAC5C,4EAA4E;IAC5E,6EAA6E;IAC7E,MAAM,KAAK,GAAyB,EAAE,eAAe,EAAE,OAAO,CAAC,eAAe,EAAE,CAAC;IACjF,IAAI,OAAO,IAAI,OAAO,IAAI,OAAO,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QACtD,KAAK,CAAC,KAAK,GAAG,mBAAmB,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,aAAa,IAAI,OAAO,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QAClE,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,QAAQ,KAAK,YAAY,EAAE,CAAC;YAC7E,KAAK,CAAC,WAAW,GAAG,2BAA2B,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;QACvE,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE;QACpE,gBAAgB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,OAAO,CAAC,kBAAkB;KACpF,CAAC,CAAC;AACL,CAAC"}

package/dist/esm/config.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=config.js.map

package/dist/esm/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/config.ts"],"names":[],"mappings":""}

package/dist/esm/document.js

@@ -0,0 +1,7 @@
+/** Shared document identifiers, never a backend URL or application route table. */
+export const ROOT_ID = "fluxfast-root";
+export const PAYLOAD_ID = "fluxfast-page";
+export const IDENTIFIER_PREFIX = "fluxfast-";
+export const SSR_MARKER = "<!--fluxfast:ssr-->";
+export const PAYLOAD_MARKER = "<!--fluxfast:payload-->";
+//# sourceMappingURL=document.js.map

package/dist/esm/document.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../../src/document.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC;AACvC,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC;AAC1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC;AAC7C,MAAM,CAAC,MAAM,UAAU,GAAG,qBAAqB,CAAC;AAChD,MAAM,CAAC,MAAM,cAAc,GAAG,yBAAyB,CAAC"}

package/dist/esm/form.js

@@ -0,0 +1,204 @@
+"use client";
+import { useState, useCallback, useEffect, useMemo, useRef } from "react";
+import { ValidationError, formatValidationPath } from "@fluxfast/core";
+import { useRouter } from "./hooks.js";
+const EMPTY_ISSUES = Object.freeze([]);
+const EMPTY_ERROR_MAP = Object.freeze(Object.create(null));
+function issuesToTopLevelErrors(issues) {
+    const errors = Object.create(null);
+    for (const issue of issues) {
+        const key = issue.path[0];
+        if (typeof key === "string" &&
+            !Object.prototype.hasOwnProperty.call(errors, key)) {
+            errors[key] = issue.message;
+        }
+    }
+    return errors;
+}
+function issuesToErrorMap(issues) {
+    if (issues.length === 0)
+        return EMPTY_ERROR_MAP;
+    const errorMap = Object.create(null);
+    for (const issue of issues) {
+        const path = formatValidationPath(issue.path);
+        if (!Object.prototype.hasOwnProperty.call(errorMap, path)) {
+            errorMap[path] = issue.message;
+        }
+    }
+    return Object.freeze(errorMap);
+}
+export function useForm(initialValues, formOptions = {}) {
+    const router = useRouter();
+    const initialRef = useRef(initialValues);
+    const [data, setDataState] = useState(initialValues);
+    const dataRef = useRef(initialValues);
+    const [manualErrors, setManualErrors] = useState({});
+    const [issues, setIssues] = useState(EMPTY_ISSUES);
+    const [processing, setProcessing] = useState(false);
+    const [wasSuccessful, setWasSuccessful] = useState(false);
+    const [recentlySuccessful, setRecentlySuccessful] = useState(false);
+    const recentTimerRef = useRef(null);
+    const localErrors = useMemo(() => issuesToTopLevelErrors(issues), [issues]);
+    const errors = useMemo(() => ({ ...manualErrors, ...localErrors }), [manualErrors, localErrors]);
+    const localErrorMap = useMemo(() => issuesToErrorMap(issues), [issues]);
+    const errorMap = useMemo(() => {
+        const entries = Object.entries(manualErrors);
+        if (entries.length === 0)
+            return localErrorMap;
+        const combined = Object.create(null);
+        for (const [key, message] of entries) {
+            if (message !== undefined)
+                combined[key] = message;
+        }
+        for (const [path, message] of Object.entries(localErrorMap)) {
+            combined[path] = message;
+        }
+        return Object.freeze(combined);
+    }, [manualErrors, localErrorMap]);
+    useEffect(() => () => {
+        if (recentTimerRef.current)
+            clearTimeout(recentTimerRef.current);
+    }, []);
+    const setData = useCallback((keyOrValues, maybeValue) => {
+        if (typeof keyOrValues === "string") {
+            const next = { ...dataRef.current, [keyOrValues]: maybeValue };
+            dataRef.current = next;
+            setDataState(next);
+        }
+        else if (typeof keyOrValues === "function") {
+            const next = keyOrValues(dataRef.current);
+            dataRef.current = next;
+            setDataState(next);
+        }
+        else {
+            const next = { ...dataRef.current, ...keyOrValues };
+            dataRef.current = next;
+            setDataState(next);
+        }
+    }, []);
+    const setError = useCallback((key, message) => {
+        setManualErrors(prev => ({ ...prev, [key]: message }));
+    }, []);
+    const clearErrors = useCallback((...keys) => {
+        if (keys.length === 0) {
+            setManualErrors({});
+            setIssues(EMPTY_ISSUES);
+        }
+        else {
+            const selected = new Set(keys);
+            setManualErrors(prev => {
+                const next = { ...prev };
+                for (const k of keys) {
+                    delete next[k];
+                }
+                return next;
+            });
+            setIssues(prev => {
+                const next = prev.filter(issue => {
+                    const key = issue.path[0];
+                    return typeof key !== "string" || !selected.has(key);
+                });
+                return next.length === prev.length ? prev : Object.freeze(next);
+            });
+        }
+    }, []);
+    const reset = useCallback((...keys) => {
+        if (keys.length === 0) {
+            dataRef.current = initialRef.current;
+            setDataState(initialRef.current);
+        }
+        else {
+            const next = { ...dataRef.current };
+            for (const k of keys)
+                next[k] = initialRef.current[k];
+            dataRef.current = next;
+            setDataState(next);
+        }
+    }, []);
+    const validateCurrent = useCallback(() => {
+        const validator = formOptions.validator;
+        return validator?.validate(dataRef.current);
+    }, [formOptions.validator]);
+    const validate = useCallback(() => {
+        const result = validateCurrent();
+        if (!result || result.valid) {
+            setIssues(EMPTY_ISSUES);
+            return true;
+        }
+        setIssues(result.issues);
+        return false;
+    }, [validateCurrent]);
+    const submit = useCallback((url, options) => {
+        return async (e) => {
+            if (e && typeof e.preventDefault === "function") {
+                e.preventDefault();
+            }
+            setWasSuccessful(false);
+            clearErrors();
+            const validationResult = validateCurrent();
+            if (validationResult && !validationResult.valid) {
+                setIssues(validationResult.issues);
+                if (options?.onError) {
+                    options.onError({
+                        ...issuesToTopLevelErrors(validationResult.issues)
+                    });
+                }
+                return;
+            }
+            setIssues(EMPTY_ISSUES);
+            setProcessing(true);
+            try {
+                await router.mutate(url, dataRef.current, {
+                    method: options?.method || "POST",
+                    preserveScroll: options?.preserveScroll,
+                });
+                setWasSuccessful(true);
+                setRecentlySuccessful(true);
+                if (recentTimerRef.current) {
+                    clearTimeout(recentTimerRef.current);
+                }
+                recentTimerRef.current = setTimeout(() => {
+                    setRecentlySuccessful(false);
+                }, 2000);
+                if (options?.onSuccess) {
+                    options.onSuccess();
+                }
+            }
+            catch (err) {
+                if (err instanceof ValidationError && err.details) {
+                    const formattedErrors = Object.create(null);
+                    for (const [k, v] of Object.entries(err.details)) {
+                        formattedErrors[k] = Array.isArray(v) ? v[0] : String(v);
+                    }
+                    setManualErrors(formattedErrors);
+                    setIssues(EMPTY_ISSUES);
+                    if (options?.onError) {
+                        options.onError({ ...formattedErrors });
+                    }
+                }
+                else {
+                    throw err;
+                }
+            }
+            finally {
+                setProcessing(false);
+            }
+        };
+    }, [router, clearErrors, validateCurrent]);
+    return {
+        data,
+        errors,
+        issues,
+        errorMap,
+        processing,
+        wasSuccessful,
+        recentlySuccessful,
+        setData,
+        setError,
+        clearErrors,
+        reset,
+        validate,
+        submit,
+    };
+}
+//# sourceMappingURL=form.js.map

package/dist/esm/form.js.map

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

package/dist/esm/hooks.js

@@ -0,0 +1,50 @@
+"use client";
+import { useSyncExternalStore, useCallback, useMemo } from "react";
+import { useFluxContext } from "./provider.js";
+export function useRouter() {
+    return useFlux().router;
+}
+export function useFlux() {
+    return useFluxContext();
+}
+export function usePage() {
+    const router = useRouter();
+    const subscribe = useCallback((callback) => router.pageStore.subscribe(callback), [router]);
+    const getSnapshot = useCallback(() => router.pageStore.getSnapshot(), [router]);
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+export function useResource(key) {
+    const router = useRouter();
+    if (typeof process !== "undefined" &&
+        process.env?.NODE_ENV !== "production") {
+        const status = router.resourceStore.getStateSnapshot(key).status;
+        if (status === "pending") {
+            console.warn(`[fluxfast] Resource "${key}" is deferred and has not resolved yet.\n\nUse useDeferredResource("${key}") for deferred resources.`);
+        }
+    }
+    const subscribe = useCallback((callback) => router.resourceStore.subscribe(key, callback), [router, key]);
+    const getSnapshot = useCallback(() => router.resourceStore.getSnapshot(key), [router, key]);
+    const getServerSnapshot = useCallback(() => router.resourceStore.getServerSnapshot(key), [router, key]);
+    const val = useSyncExternalStore(subscribe, getSnapshot, getServerSnapshot);
+    return val;
+}
+export function useResourceState(key) {
+    const router = useRouter();
+    const subscribe = useCallback((callback) => router.resourceStore.subscribe(key, callback), [router, key]);
+    const getSnapshot = useCallback(() => router.resourceStore.getStateSnapshot(key), [router, key]);
+    return useSyncExternalStore(subscribe, getSnapshot, getSnapshot);
+}
+export function useDeferredResource(key) {
+    const router = useRouter();
+    const state = useResourceState(key);
+    const retry = useCallback(() => router.loadResources([key], { reason: "retry" }), [router, key]);
+    return useMemo(() => ({
+        ...state,
+        retry,
+        isLoading: state.status === "loading",
+        isError: state.status === "error",
+        isReady: state.status === "ready",
+        isPending: state.status === "pending",
+    }), [state, retry]);
+}
+//# sourceMappingURL=hooks.js.map

package/dist/esm/hooks.js.map

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

package/dist/esm/hydration.js

@@ -0,0 +1,40 @@
+import { decodeServerDiagnosticTrace } from "@fluxfast/core";
+/** Private payload validation shared by the host and browser entry. */
+export function readFluxCacheConfig(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError("Invalid FluxFast hydration cache configuration");
+    }
+    const source = value;
+    const cache = {};
+    for (const name of ["maxResources", "maxPages"]) {
+        if (Object.hasOwn(source, name)) {
+            const limit = source[name];
+            if (!Number.isSafeInteger(limit) || limit <= 0) {
+                throw new TypeError("Invalid FluxFast hydration cache configuration");
+            }
+            cache[name] = limit;
+        }
+    }
+    return cache;
+}
+export function readFluxDevelopmentMetadata(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        throw new TypeError("Invalid FluxFast hydration development metadata");
+    }
+    const source = value;
+    if (typeof source.initialPath !== "string" || !source.initialPath.startsWith("/") || source.initialPath.length > 2_048) {
+        throw new TypeError("Invalid FluxFast hydration development metadata");
+    }
+    const json = JSON.stringify(source.initialServerTrace);
+    if (typeof json !== "string" || json.length > 16_384) {
+        throw new TypeError("Invalid FluxFast hydration development metadata");
+    }
+    const bytes = new TextEncoder().encode(json);
+    const encoded = btoa(Array.from(bytes, byte => String.fromCharCode(byte)).join(""))
+        .replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
+    const trace = decodeServerDiagnosticTrace(encoded);
+    if (!trace)
+        throw new TypeError("Invalid FluxFast hydration development metadata");
+    return { initialPath: source.initialPath, initialServerTrace: trace };
+}
+//# sourceMappingURL=hydration.js.map

package/dist/esm/hydration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydration.js","sourceRoot":"","sources":["../../src/hydration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,MAAM,gBAAgB,CAAC;AAG7D,uEAAuE;AACvE,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;IACxE,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,MAAM,KAAK,GAAoB,EAAE,CAAC;IAClC,KAAK,MAAM,IAAI,IAAI,CAAC,cAAc,EAAE,UAAU,CAAU,EAAE,CAAC;QACzD,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,EAAE,CAAC;YAChC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAC3B,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAK,KAAgB,IAAI,CAAC,EAAE,CAAC;gBAC3D,MAAM,IAAI,SAAS,CAAC,gDAAgD,CAAC,CAAC;YACxE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,GAAG,KAAe,CAAC;QAChC,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,KAAc;IACxD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAChE,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,IAAI,OAAO,MAAM,CAAC,WAAW,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,WAAW,CAAC,MAAM,GAAG,KAAK,EAAE,CAAC;QACvH,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;IACvD,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,MAAM,EAAE,CAAC;QACrD,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;IACzE,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;SAChF,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,2BAA2B,CAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,KAAK;QAAE,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;IACnF,OAAO,EAAE,WAAW,EAAE,MAAM,CAAC,WAAW,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAC;AACxE,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,11 @@
+"use client";
+/** Host-independent React bindings over the public FluxFast Core runtime. */
+export * from "./provider.js";
+export * from "./root.js";
+export * from "./hooks.js";
+export * from "./live.js";
+export * from "./link.js";
+export * from "./form.js";
+export * from "./resolver.js";
+export * from "./config.js";
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,6EAA6E;AAC7E,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}