netjes 0.0.0-stage → 0.0.1

package/dist/actions.d.ts

@@ -0,0 +1,98 @@
+import { type ActionResponse, type AntiforgeryToken } from './payload.ts';
+import { type StandardSchemaV1 } from './schema.ts';
+/**
+ * What a server action resolves to: its result, or the validation errors (status 422) per field. An action typed with
+ * a result can still answer `ServerAction.Redirect(...)` (then `result` is undefined and the router has already moved
+ * on), so code that runs after `await action(...)` in a component that may stay mounted should not assume one.
+ */
+export type ActionState<TResult> = {
+    ok: true;
+    result: TResult;
+} | {
+    ok: false;
+    status: number;
+    errors: Record<string, string[]>;
+    values?: Record<string, string | string[]>;
+};
+/**
+ * A reference to a C# server action (`app.MapAction(name, ...)`). Call it with a plain object (sent as JSON) or
+ * FormData (sent as a form post); use it in a form through {@link useAction}.
+ */
+export interface ServerAction<TInput, TResult> {
+    (input: TInput | FormData): Promise<ActionState<TResult>>;
+    readonly actionName: string;
+    readonly url: string;
+}
+/** Thrown into the nearest error boundary when the server could not run the action (not for validation errors). */
+export declare class ServerActionError extends Error {
+    name: string;
+    readonly status: number;
+    constructor(message: string, status: number);
+}
+/** Runs action calls for the page: the router in the browser (fetch, then redirect/refresh/query updates), a fake in tests. */
+export type ActionClient = {
+    invoke(name: string, url: string, input: unknown): Promise<ActionResponse>;
+    /** The antiforgery form field, left out of the values a failed call hands back. */
+    tokenField?(): string | undefined;
+};
+/** A router is mounting (called as it first renders, in the browser): calls from now on wait until it registers. */
+export declare function expectActionClient(): void;
+/** The router registers itself; there is one per page in the browser. */
+export declare function setActionClient(next: ActionClient | null): () => void;
+export declare const RETURN_FIELD = "__netjes_return";
+type ActionMeta = {
+    url: string;
+    name: string;
+};
+/** The action URL and name a form action carries, so `<Form>` can render a real form post on the server. */
+export declare function actionMetaOf(action: unknown): ActionMeta | undefined;
+export declare function actionRequest(input: unknown, token: AntiforgeryToken | undefined, returnUrl: string): RequestInit;
+/**
+ * The fetch half of a call, for the router's action client. `tokenRefused` says the server refused the call's
+ * antiforgery token, so the action did not run; no other answer says that, whatever its status. `onCookiesChanged`
+ * runs as soon as the server says the call set or deleted a cookie (signed someone in or out), which script cannot
+ * see in the response itself, whatever the rest of the answer turns out to be.
+ */
+export declare function fetchAction(name: string, url: string, init: RequestInit, onCookiesChanged?: () => void): Promise<{
+    response: ActionResponse;
+    tokenRefused: boolean;
+}>;
+/**
+ * Declares a server action by name. The result is parsed with `options.result` when given (zod, valibot, ...).
+ * `npx netjes generate` writes these for every `MapAction`, with types from the C# signature.
+ */
+export declare function serverAction<TInput = FormData, TResult = unknown>(name: string, options?: {
+    result?: StandardSchemaV1<unknown, TResult>;
+}): ServerAction<TInput, TResult>;
+/** Options for `useAction`. */
+export type UseActionOptions<TResult> = {
+    /** The state before the first submission. Default null. */
+    initialState?: ActionState<TResult> | null;
+    /**
+     * Called with the form's data inside the action's transition, just before the call to the server: the place for
+     * `useOptimistic` updates, which React keeps until the action (and the page refresh after it) finishes.
+     */
+    onSubmit?: (formData: FormData) => void;
+};
+/**
+ * `useActionState` for a server action: `[state, formAction, isPending]`. Pass `formAction` to `<Form action>`;
+ * `useFormStatus` works as usual, and `onSubmit` is where optimistic updates go. After a failed post without
+ * JavaScript, the state starts as that failure, with the submitted values.
+ */
+export declare function useAction<TInput, TResult>(action: ServerAction<TInput, TResult>, options?: UseActionOptions<TResult>): [state: ActionState<TResult> | null, formAction: (formData: FormData) => void, isPending: boolean];
+/** A page action's failure, in the shape of `useAction`'s failure state. */
+export type PageActionFailure = {
+    ok: false;
+    status: number;
+    errors: Record<string, string[]>;
+    values: Record<string, string | string[]>;
+};
+/**
+ * After the input of the page's action (`MapPageAction`) failed its checks, its DataAnnotations or
+ * `IValidatableObject`: the errors per field and the submitted values of the fields the action declares, as the page
+ * is rendered again from its loader, with and without JavaScript. Else null, also after a server action's failure,
+ * which `useAction` reads.
+ */
+export declare function usePageActionState(): PageActionFailure | null;
+export {};
+//# sourceMappingURL=actions.d.ts.map

package/dist/actions.d.ts.map

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

package/dist/actions.js

@@ -0,0 +1,176 @@
+import { useActionState, useMemo } from 'react';
+import { encodeForm } from './form-data.js';
+import { ANTIFORGERY_HEADER, COOKIES_HEADER, DATA_HEADER, parseActionResponse } from './payload.js';
+import { usePagePayload } from './router.js';
+import { parseWith } from './schema.js';
+/** Thrown into the nearest error boundary when the server could not run the action (not for validation errors). */
+export class ServerActionError extends Error {
+    name = 'ServerActionError';
+    status;
+    constructor(message, status) {
+        super(message);
+        this.status = status;
+    }
+}
+let client = null;
+/**
+ * Set from the moment a router renders until it registers: React dispatches the clicks that came in while it hydrated
+ * the page before it runs the router's effects, and runs a page's own effects before its router's. Calls made then
+ * wait here.
+ */
+let arriving = null;
+/** A router is mounting (called as it first renders, in the browser): calls from now on wait until it registers. */
+export function expectActionClient() {
+    if (arriving)
+        return;
+    let resolve = () => { };
+    const ready = new Promise((done) => {
+        resolve = done;
+    });
+    arriving = { ready, resolve };
+}
+/** The router registers itself; there is one per page in the browser. */
+export function setActionClient(next) {
+    client = next;
+    if (next && arriving) {
+        arriving.resolve();
+        arriving = null;
+    }
+    return () => {
+        if (client === next)
+            client = null;
+    };
+}
+/** How long a call waits for the router on its way; one whose render React threw away never registers. */
+const READY_TIMEOUT_MS = 10_000;
+/**
+ * The registered client, once the router on its way has registered; the error without a router on its way, or when it
+ * has not registered in time.
+ */
+async function readyClient(name) {
+    const waitingFor = arriving;
+    if (!client && waitingFor) {
+        let timer;
+        const timedOut = new Promise((resolve) => {
+            timer = setTimeout(() => resolve('timeout'), READY_TIMEOUT_MS);
+        });
+        // Given up on, so that later calls fail at once.
+        if ((await Promise.race([waitingFor.ready, timedOut])) === 'timeout' && arriving === waitingFor)
+            arriving = null;
+        clearTimeout(timer);
+    }
+    if (!client)
+        throw new Error(`netjes: server action ${name} was called before the page was ready`);
+    return client;
+}
+export const RETURN_FIELD = '__netjes_return';
+const ACTION_META = Symbol.for('netjes.action');
+/** The action URL and name a form action carries, so `<Form>` can render a real form post on the server. */
+export function actionMetaOf(action) {
+    return typeof action === 'function' ? action[ACTION_META] : undefined;
+}
+/**
+ * The fields of a rejected form, as the failure state's `values`: React resets a form after its action runs, so a
+ * `defaultValue={state.values.name}` is what keeps what the user typed. Files, the token and Netjes's own fields are
+ * left out, and so is anything outside `fields`: the server names the fields a post without JavaScript would echo
+ * (those the action declares, none private).
+ */
+function submittedValues(input, tokenField, fields) {
+    if (!(input instanceof FormData))
+        return undefined;
+    const values = {};
+    for (const [key, value] of input.entries()) {
+        if (typeof value !== 'string' || key === tokenField || key.startsWith('__netjes_'))
+            continue;
+        if (fields && !fields.includes(key))
+            continue;
+        const existing = values[key];
+        values[key] = existing === undefined ? value : Array.isArray(existing) ? [...existing, value] : [existing, value];
+    }
+    return values;
+}
+export function actionRequest(input, token, returnUrl) {
+    const headers = { [DATA_HEADER]: '1', Accept: 'application/json' };
+    if (token?.headerName && token.requestToken)
+        headers[token.headerName] = token.requestToken;
+    if (input instanceof FormData) {
+        if (!input.has(RETURN_FIELD))
+            input.append(RETURN_FIELD, returnUrl);
+        const encoded = encodeForm(input);
+        if (encoded.contentType)
+            headers['Content-Type'] = encoded.contentType;
+        return { method: 'POST', headers, body: encoded.body, credentials: 'same-origin' };
+    }
+    headers['Content-Type'] = 'application/json';
+    return { method: 'POST', headers, body: JSON.stringify(input ?? {}), credentials: 'same-origin' };
+}
+/**
+ * The fetch half of a call, for the router's action client. `tokenRefused` says the server refused the call's
+ * antiforgery token, so the action did not run; no other answer says that, whatever its status. `onCookiesChanged`
+ * runs as soon as the server says the call set or deleted a cookie (signed someone in or out), which script cannot
+ * see in the response itself, whatever the rest of the answer turns out to be.
+ */
+export async function fetchAction(name, url, init, onCookiesChanged) {
+    const response = await fetch(url, init);
+    if (response.headers.get(COOKIES_HEADER) === 'changed')
+        onCookiesChanged?.();
+    const type = response.headers.get('content-type') ?? '';
+    if (!type.includes('application/json'))
+        throw new ServerActionError(`Server action ${name} failed with status ${response.status}`, response.status);
+    return { response: parseActionResponse(await response.json()), tokenRefused: response.headers.get(ANTIFORGERY_HEADER) === 'invalid' };
+}
+/**
+ * Declares a server action by name. The result is parsed with `options.result` when given (zod, valibot, ...).
+ * `npx netjes generate` writes these for every `MapAction`, with types from the C# signature.
+ */
+export function serverAction(name, options = {}) {
+    const url = `/_netjes/actions/${name}`;
+    async function call(input) {
+        const active = client ?? (await readyClient(name));
+        const answer = await active.invoke(name, url, input);
+        if (!answer.ok && answer.status !== 422) {
+            throw new ServerActionError(answer.message ?? `Server action ${name} failed with status ${answer.status}`, answer.status);
+        }
+        if (!answer.ok) {
+            const values = submittedValues(input, active.tokenField?.(), answer.fields);
+            return { ok: false, status: answer.status, errors: answer.errors ?? {}, ...(values ? { values } : {}) };
+        }
+        // `ServerAction.Redirect(...)` and `Ok()` send no result, even from an action whose C# type promises one.
+        const result = options.result && answer.result !== undefined ? parseWith(options.result, answer.result, `result of ${name}`) : answer.result;
+        return { ok: true, result };
+    }
+    return Object.assign(call, { actionName: name, url });
+}
+/**
+ * `useActionState` for a server action: `[state, formAction, isPending]`. Pass `formAction` to `<Form action>`;
+ * `useFormStatus` works as usual, and `onSubmit` is where optimistic updates go. After a failed post without
+ * JavaScript, the state starts as that failure, with the submitted values.
+ */
+export function useAction(action, options = {}) {
+    const { actionState } = usePagePayload();
+    const initial = actionState?.action === action.actionName
+        ? { ok: false, status: 422, errors: actionState.errors, values: actionState.values }
+        : (options.initialState ?? null);
+    const { onSubmit } = options;
+    const [state, dispatch, pending] = useActionState((_previous, formData) => {
+        onSubmit?.(formData);
+        return action(formData);
+    }, initial);
+    if (!(ACTION_META in dispatch)) {
+        Object.defineProperty(dispatch, ACTION_META, { value: { url: action.url, name: action.actionName } });
+    }
+    return [state, dispatch, pending];
+}
+/**
+ * After the input of the page's action (`MapPageAction`) failed its checks, its DataAnnotations or
+ * `IValidatableObject`: the errors per field and the submitted values of the fields the action declares, as the page
+ * is rendered again from its loader, with and without JavaScript. Else null, also after a server action's failure,
+ * which `useAction` reads.
+ */
+export function usePageActionState() {
+    const { actionState, route } = usePagePayload();
+    return useMemo(() => actionState && route !== null && actionState.action === route
+        ? { ok: false, status: 422, errors: actionState.errors, values: actionState.values }
+        : null, [actionState, route]);
+}
+//# sourceMappingURL=actions.js.map

package/dist/actions.js.map

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

package/dist/client-entry.d.ts

@@ -0,0 +1,2 @@
+import '@vitejs/plugin-react/preamble';
+//# sourceMappingURL=client-entry.d.ts.map

package/dist/client-entry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-entry.d.ts","sourceRoot":"","sources":["../src/client-entry.tsx"],"names":[],"mappings":"AACA,OAAO,+BAA+B,CAAC"}

package/dist/client-entry.js

@@ -0,0 +1,102 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+// Must come first: installs the React Fast Refresh runtime before any component module runs (empty in builds).
+import '@vitejs/plugin-react/preamble';
+import { createRoot, hydrateRoot } from 'react-dom/client';
+import { pages } from 'virtual:netjes/pages';
+import { deferredRegistry, revivePayload } from './deferred.js';
+import { createModuleLoader } from './modules.js';
+import { DATA_ELEMENT_ID, parseInitialPayload } from './payload.js';
+import { Root } from './root.js';
+import { withClockOffset } from './router.js';
+/**
+ * The payload is the body's first element, so it is normally parsed by the time this async script runs. If the
+ * script won the race, wait for the element rather than for the whole (streaming) document.
+ */
+function payloadElement() {
+    // Complete once the parser has moved past it (a large payload can arrive in several chunks).
+    const complete = () => {
+        const element = document.getElementById(DATA_ELEMENT_ID);
+        return element && (element.nextSibling || document.readyState !== 'loading') ? element : null;
+    };
+    const found = complete();
+    if (found || document.readyState !== 'loading')
+        return Promise.resolve(found ?? document.getElementById(DATA_ELEMENT_ID));
+    return new Promise((resolve) => {
+        const observer = new MutationObserver(() => {
+            const element = complete();
+            if (element) {
+                observer.disconnect();
+                resolve(element);
+            }
+        });
+        observer.observe(document, { childList: true, subtree: true });
+        document.addEventListener('DOMContentLoaded', () => {
+            observer.disconnect();
+            resolve(document.getElementById(DATA_ELEMENT_ID));
+        });
+    });
+}
+const dataJson = (await payloadElement())?.textContent;
+if (!dataJson)
+    throw new Error(`netjes: #${DATA_ELEMENT_ID} is missing; was this page rendered by Netjes?`);
+const globals = self;
+const deferred = deferredRegistry();
+const settle = (id, value, error) => (error === undefined || error === null ? deferred.resolve(id, value) : deferred.reject(id, error));
+/**
+ * The values the head bootstrap collected: its own plain object, `{ id: [value, error] }`. Anything else is page
+ * markup standing in for the global (an element with `id="__netjes_v"`), and must not stop the page from hydrating.
+ */
+function collectedValues(collected) {
+    if (typeof collected !== 'object' || collected === null)
+        return [];
+    const prototype = Object.getPrototypeOf(collected);
+    return prototype === Object.prototype || prototype === null ? Object.entries(collected) : [];
+}
+for (const [id, entry] of collectedValues(globals.__netjes_v)) {
+    if (Array.isArray(entry))
+        settle(id, entry[0], typeof entry[1] === 'string' ? entry[1] : undefined);
+}
+globals.__netjes_d = settle;
+const parsed = revivePayload(parseInitialPayload(JSON.parse(dataJson)), deferred.source);
+// Judge the server's seeded data as fresh as the server did when it rendered, so hydration matches.
+const payload = withClockOffset(parsed, parsed.renderedAt);
+const loader = createModuleLoader(pages, { nameFailedImports: true });
+/** How long the first page waits before it tries a module that failed to load once more. */
+const RETRY_DELAY_MS = 500;
+/**
+ * The first page's modules. One that fails to load (a dropped request, a deploy that removed its chunk) gets one more
+ * try, which the browser fetches again. If that fails too, the page stays as the server sent it, without the client
+ * router: its links and forms are plain HTML, and the browser loads each in full.
+ */
+async function firstPageModules() {
+    try {
+        return await loader.loadRoute(payload);
+    }
+    catch {
+        await new Promise((resolve) => setTimeout(resolve, RETRY_DELAY_MS));
+    }
+    try {
+        return await loader.loadRoute(payload);
+    }
+    catch (error) {
+        const reason = error instanceof Error ? error.message : `netjes: the page's modules could not be loaded (${String(error)})`;
+        const outcome = payload.document.clientRender
+            ? 'the page cannot render without it'
+            : 'the page stays as the server rendered it, without the client router, and its links and forms load pages in full';
+        console.error(`${reason}: ${outcome}`, error);
+        return null;
+    }
+}
+const modules = await firstPageModules();
+if (modules) {
+    const root = _jsx(Root, { payload: payload, modules: modules, loader: loader, dataJson: dataJson });
+    if (payload.document.clientRender) {
+        // No sidecar was ready, so the server sent the document without the page: there is nothing to hydrate. React keeps
+        // the scripts and stylesheets already in it and replaces the rest.
+        createRoot(document).render(root);
+    }
+    else {
+        hydrateRoot(document, root);
+    }
+}
+//# sourceMappingURL=client-entry.js.map

package/dist/client-entry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-entry.js","sourceRoot":"","sources":["../src/client-entry.tsx"],"names":[],"mappings":";AAAA,+GAA+G;AAC/G,OAAO,+BAA+B,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAqB,kBAAkB,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAY,CAAC;AAClC,OAAO,EAAE,eAAe,EAAE,MAAM,aAAc,CAAC;AAE/C;;;GAGG;AACH,SAAS,cAAc;IACrB,6FAA6F;IAC7F,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,MAAM,OAAO,GAAG,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC;QACzD,OAAO,OAAO,IAAI,CAAC,OAAO,CAAC,WAAW,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAChG,CAAC,CAAC;IACF,MAAM,KAAK,GAAG,QAAQ,EAAE,CAAC;IACzB,IAAI,KAAK,IAAI,QAAQ,CAAC,UAAU,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC,OAAO,CAAC,KAAK,IAAI,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC;IAC1H,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,IAAI,gBAAgB,CAAC,GAAG,EAAE;YACzC,MAAM,OAAO,GAAG,QAAQ,EAAE,CAAC;YAC3B,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,UAAU,EAAE,CAAC;gBACtB,OAAO,CAAC,OAAO,CAAC,CAAC;YACnB,CAAC;QACH,CAAC,CAAC,CAAC;QACH,QAAQ,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,GAAG,EAAE;YACjD,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtB,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAC,eAAe,CAAC,CAAC,CAAC;QACpD,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,QAAQ,GAAG,CAAC,MAAM,cAAc,EAAE,CAAC,EAAE,WAAW,CAAC;AACvD,IAAI,CAAC,QAAQ;IAAE,MAAM,IAAI,KAAK,CAAC,YAAY,eAAe,gDAAgD,CAAC,CAAC;AAI5G,MAAM,OAAO,GAAG,IAAkC,CAAC;AACnD,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC;AACpC,MAAM,MAAM,GAAG,CAAC,EAAU,EAAE,KAAc,EAAE,KAAc,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC;AAElK;;;GAGG;AACH,SAAS,eAAe,CAAC,SAAkB;IACzC,IAAI,OAAO,SAAS,KAAK,QAAQ,IAAI,SAAS,KAAK,IAAI;QAAE,OAAO,EAAE,CAAC;IACnE,MAAM,SAAS,GAAY,MAAM,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC;IAC5D,OAAO,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/F,CAAC;AACD,KAAK,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,IAAI,eAAe,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;IAC9D,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,KAAK,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACtG,CAAC;AACD,OAAO,CAAC,UAAU,GAAG,MAAM,CAAC;AAE5B,MAAM,MAAM,GAAG,aAAa,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;AACzF,oGAAoG;AACpG,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;AAC3D,MAAM,MAAM,GAAG,kBAAkB,CAAC,KAAK,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC,CAAC;AAEtE,4FAA4F;AAC5F,MAAM,cAAc,GAAG,GAAG,CAAC;AAE3B;;;;GAIG;AACH,KAAK,UAAU,gBAAgB;IAC7B,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IACtE,CAAC;IACD,IAAI,CAAC;QACH,OAAO,MAAM,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,mDAAmD,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QAC5H,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,YAAY;YAC3C,CAAC,CAAC,mCAAmC;YACrC,CAAC,CAAC,iHAAiH,CAAC;QACtH,OAAO,CAAC,KAAK,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9C,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,MAAM,gBAAgB,EAAE,CAAC;AACzC,IAAI,OAAO,EAAE,CAAC;IACZ,MAAM,IAAI,GAAG,KAAC,IAAI,IAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAI,CAAC;IAC9F,IAAI,OAAO,CAAC,QAAQ,CAAC,YAAY,EAAE,CAAC;QAClC,mHAAmH;QACnH,mEAAmE;QACnE,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,WAAW,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;AACH,CAAC"}

package/dist/deferred.d.ts

@@ -0,0 +1,39 @@
+import type { PagePayload } from './payload.ts';
+/** A promise that records its outcome the way React's `use()` reads it, so a settled one renders without suspending. */
+export type Thenable<T> = Promise<T> & {
+    status?: 'pending' | 'fulfilled' | 'rejected';
+    value?: T;
+    reason?: unknown;
+};
+export type Deferred<T> = {
+    promise: Thenable<T>;
+    resolve(value: T): void;
+    reject(reason: unknown): void;
+};
+export declare function createDeferred<T>(): Deferred<T>;
+/** Where revived placeholders get their promise from, by id. */
+export type DeferredSource = (id: string) => Thenable<unknown>;
+/** Replaces every `{ $netjes: 'deferred', id }` in a JSON value; returns the same object when there are none. */
+export declare function reviveDeferred(value: unknown, source: DeferredSource): unknown;
+/** Revives the placeholders in a page's props and its segments' props. */
+export declare function revivePayload<T extends PagePayload>(payload: T, source: DeferredSource): T;
+/** A source that hands out one deferred per id and settles it when the value arrives. */
+export declare function deferredRegistry(): {
+    source: DeferredSource;
+    resolve(id: string, value: unknown): void;
+    reject(id: string, message: string): void;
+    /** Rejects every value still pending, e.g. when the stream that was to deliver them ended. */
+    rejectPending(message: (id: string) => string): void;
+};
+/**
+ * Inline in every document: collects deferred values streamed as `<script>self.__netjes_d(id, value, error)</script>`
+ * until the client entry takes over (it replaces `__netjes_d`). The async client entry can run first, so this never
+ * replaces a handler that is already there. It creates `__netjes_v` up front, as a window property of its own: until
+ * then, page markup with `id="__netjes_v"` would be what that name reads (DOM clobbering).
+ */
+export declare const DEFERRED_BOOTSTRAP = "self.__netjes_d=self.__netjes_d||function(i,v,e){self.__netjes_v[i]=[v,e]};Object.prototype.hasOwnProperty.call(self,'__netjes_v')||(self.__netjes_v={})";
+/** JSON that can sit inside a <script> element. */
+export declare function htmlSafeJson(value: unknown): string;
+/** The script that hands one deferred value (or its error) to the browser. */
+export declare function deferredScript(id: string, value: unknown, error?: string, nonce?: string): string;
+//# sourceMappingURL=deferred.d.ts.map

package/dist/deferred.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deferred.d.ts","sourceRoot":"","sources":["../src/deferred.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAc,MAAM,cAAc,CAAC;AAE5D,wHAAwH;AACxH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,UAAU,CAAC;IAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAEtH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;IAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC,CAAC;IAAC,OAAO,CAAC,KAAK,EAAE,CAAC,GAAG,IAAI,CAAC;IAAC,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;CAAE,CAAC;AAE3G,wBAAgB,cAAc,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAuB/C;AAED,gEAAgE;AAChE,MAAM,MAAM,cAAc,GAAG,CAAC,EAAE,EAAE,MAAM,KAAK,QAAQ,CAAC,OAAO,CAAC,CAAC;AAM/D,iHAAiH;AACjH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,GAAG,OAAO,CAoB9E;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,CAAC,SAAS,WAAW,EAAE,OAAO,EAAE,CAAC,EAAE,MAAM,EAAE,cAAc,GAAG,CAAC,CAW1F;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB;IAa5B,MAAM,EAAiC,cAAc;IACrD,OAAO,KAAK,MAAM,SAAS,OAAO;IAGlC,MAAM,KAAK,MAAM,WAAW,MAAM;IAGlC,8FAA8F;IAC9F,aAAa,UAAU,CAAC,EAAE,EAAE,MAAM,KAAK,MAAM;EAMhD;AAED;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,6JAC6H,CAAC;AAI7J,mDAAmD;AACnD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAEnD;AAED,8EAA8E;AAC9E,wBAAgB,cAAc,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAQjG"}

package/dist/deferred.js

@@ -0,0 +1,123 @@
+export function createDeferred() {
+    let resolve;
+    let reject;
+    const promise = new Promise((res, rej) => {
+        resolve = res;
+        reject = rej;
+    });
+    promise.status = 'pending';
+    return {
+        promise,
+        resolve(value) {
+            if (promise.status !== 'pending')
+                return;
+            promise.status = 'fulfilled';
+            promise.value = value;
+            resolve(value);
+        },
+        reject(reason) {
+            if (promise.status !== 'pending')
+                return;
+            promise.status = 'rejected';
+            promise.reason = reason;
+            reject(reason);
+        },
+    };
+}
+function isPlaceholder(value) {
+    return value.$netjes === 'deferred' && typeof value.id === 'string';
+}
+/** Replaces every `{ $netjes: 'deferred', id }` in a JSON value; returns the same object when there are none. */
+export function reviveDeferred(value, source) {
+    if (typeof value !== 'object' || value === null)
+        return value;
+    if (Array.isArray(value)) {
+        let changed = false;
+        const items = value.map((item) => {
+            const revived = reviveDeferred(item, source);
+            if (revived !== item)
+                changed = true;
+            return revived;
+        });
+        return changed ? items : value;
+    }
+    if (isPlaceholder(value))
+        return source(value.id);
+    let changed = false;
+    const entries = Object.entries(value).map(([key, item]) => {
+        const revived = reviveDeferred(item, source);
+        if (revived !== item)
+            changed = true;
+        return [key, revived];
+    });
+    // Keys are defined, not assigned: JSON.parse keeps "__proto__" as a key, and assigning it would set the prototype.
+    return changed ? Object.fromEntries(entries) : value;
+}
+/** Revives the placeholders in a page's props and its segments' props. */
+export function revivePayload(payload, source) {
+    const props = reviveDeferred(payload.props, source);
+    let segmentsChanged = false;
+    const segments = payload.segments.map((segment) => {
+        if (!segment.props)
+            return segment;
+        const revived = reviveDeferred(segment.props, source);
+        if (revived === segment.props)
+            return segment;
+        segmentsChanged = true;
+        return { ...segment, props: revived };
+    });
+    return props === payload.props && !segmentsChanged ? payload : { ...payload, props, segments };
+}
+/** A source that hands out one deferred per id and settles it when the value arrives. */
+export function deferredRegistry() {
+    const entries = new Map();
+    const entry = (id) => {
+        let found = entries.get(id);
+        if (!found) {
+            found = createDeferred();
+            // Unread values must not surface as unhandled rejections.
+            found.promise.catch(() => { });
+            entries.set(id, found);
+        }
+        return found;
+    };
+    return {
+        source: ((id) => entry(id).promise),
+        resolve(id, value) {
+            entry(id).resolve(value);
+        },
+        reject(id, message) {
+            entry(id).reject(new Error(message));
+        },
+        /** Rejects every value still pending, e.g. when the stream that was to deliver them ended. */
+        rejectPending(message) {
+            for (const [id, deferred] of entries) {
+                if (deferred.promise.status === 'pending')
+                    deferred.reject(new Error(message(id)));
+            }
+        },
+    };
+}
+/**
+ * Inline in every document: collects deferred values streamed as `<script>self.__netjes_d(id, value, error)</script>`
+ * until the client entry takes over (it replaces `__netjes_d`). The async client entry can run first, so this never
+ * replaces a handler that is already there. It creates `__netjes_v` up front, as a window property of its own: until
+ * then, page markup with `id="__netjes_v"` would be what that name reads (DOM clobbering).
+ */
+export const DEFERRED_BOOTSTRAP = "self.__netjes_d=self.__netjes_d||function(i,v,e){self.__netjes_v[i]=[v,e]};Object.prototype.hasOwnProperty.call(self,'__netjes_v')||(self.__netjes_v={})";
+const UNSAFE = /[<>&\u2028\u2029]/g;
+/** JSON that can sit inside a <script> element. */
+export function htmlSafeJson(value) {
+    return (JSON.stringify(value) ?? 'null').replace(UNSAFE, (c) => `\\u${c.charCodeAt(0).toString(16).padStart(4, '0')}`);
+}
+/** The script that hands one deferred value (or its error) to the browser. */
+export function deferredScript(id, value, error, nonce) {
+    // The value goes as JSON text for JSON.parse, which reads it as the other paths do: as an object literal, a
+    // "__proto__" key would set the object's prototype instead.
+    const json = htmlSafeJson(JSON.stringify(value) ?? 'null');
+    const args = error === undefined ? `${htmlSafeJson(id)},JSON.parse(${json})` : `${htmlSafeJson(id)},null,${htmlSafeJson(error)}`;
+    // Under a CSP with nonces, inline scripts run only with the page's nonce (base64, but escaped all the same).
+    const attribute = nonce ? ` nonce="${nonce.replace(/[^A-Za-z0-9+/=_-]/g, '')}"` : '';
+    return `<script${attribute}>self.__netjes_d(${args})</script>`;
+}
+//# sourceMappingURL=deferred.js.map

package/dist/deferred.js.map

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

package/dist/define-page.d.ts

@@ -0,0 +1,15 @@
+import type { ComponentType, FunctionComponent } from 'react';
+import type { LayoutProps } from './modules.ts';
+import { type StandardSchemaV1 } from './schema.ts';
+export type { StandardSchemaV1 } from './schema.ts';
+/**
+ * Declares a page whose props (sent by the C# loader) are validated with a Standard Schema before rendering,
+ * so the component receives parsed, typed props instead of trusting the server's JSON.
+ */
+export declare function definePage<Schema extends StandardSchemaV1>(schema: Schema, Page: ComponentType<StandardSchemaV1.InferOutput<Schema>>): FunctionComponent<Record<string, unknown>>;
+/**
+ * Declares a layout whose loader props (from `MapLayoutLoader` in C#) are validated with a Standard Schema. The
+ * component gets the parsed props next to `children` and `params`.
+ */
+export declare function defineLayout<Schema extends StandardSchemaV1>(schema: Schema, Layout: ComponentType<StandardSchemaV1.InferOutput<Schema> & LayoutProps>): FunctionComponent<LayoutProps & Record<string, unknown>>;
+//# sourceMappingURL=define-page.d.ts.map

package/dist/define-page.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-page.d.ts","sourceRoot":"","sources":["../src/define-page.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAa,MAAM,OAAO,CAAC;AACzE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,KAAK,gBAAgB,EAAa,MAAM,aAAa,CAAC;AAE/D,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,MAAM,SAAS,gBAAgB,EACxD,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,aAAa,CAAC,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,GACxD,iBAAiB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAO5C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,MAAM,SAAS,gBAAgB,EAC1D,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,aAAa,CAAC,gBAAgB,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,WAAW,CAAC,GACxE,iBAAiB,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAW1D"}

package/dist/define-page.js

@@ -0,0 +1,27 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { parseWith } from './schema.js';
+/**
+ * Declares a page whose props (sent by the C# loader) are validated with a Standard Schema before rendering,
+ * so the component receives parsed, typed props instead of trusting the server's JSON.
+ */
+export function definePage(schema, Page) {
+    function ValidatedPage(props) {
+        const parsed = parseWith(schema, props, 'props');
+        return _jsx(Page, { ...parsed });
+    }
+    ValidatedPage.displayName = `definePage(${Page.displayName ?? Page.name ?? 'Page'})`;
+    return ValidatedPage;
+}
+/**
+ * Declares a layout whose loader props (from `MapLayoutLoader` in C#) are validated with a Standard Schema. The
+ * component gets the parsed props next to `children` and `params`.
+ */
+export function defineLayout(schema, Layout) {
+    function ValidatedLayout({ children, params, ...props }) {
+        const parsed = parseWith(schema, props, 'layout props');
+        return (_jsx(Layout, { ...parsed, params: params, children: children }));
+    }
+    ValidatedLayout.displayName = `defineLayout(${Layout.displayName ?? Layout.name ?? 'Layout'})`;
+    return ValidatedLayout;
+}
+//# sourceMappingURL=define-page.js.map