@rsc-kit/core 0.16.3 → 0.18.0

package/dist/js/standardSchema.js

@@ -1,4 +1,22 @@
-"use client";
+/**
+ * Validating a form before it is submitted, with whatever library you use.
+ *
+ * Not a client module, though a client component is its first caller: the
+ * action pipeline validates with it on the server too, and a "use client"
+ * directive here turned that call into a client-reference stub - "client
+ * reference export 'validateWith' is called on server", on every action
+ * with a schema. Pure functions, no React; importable from either side.
+ *
+ * Not with an adapter per library: Standard Schema is the contract Zod,
+ * Valibot, ArkType and others already implement, so this speaks to the schema
+ * itself and never imports one. The types below are the spec, restated here
+ * rather than depended on — it is an interface, and a package for it would be
+ * a dependency that ships nothing.
+ *
+ * Validation on the client is a courtesy, never a control. The server still
+ * has to check: a form is one way to reach an action, and the action is a
+ * public endpoint reachable without it.
+ */
 /**
  * The field an issue belongs to.
  *

package/dist/js/standardSchema.js.map

@@ -1 +1 @@
-{"version":3,"file":"standardSchema.js","sourceRoot":"","sources":["../../src/js/standardSchema.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAmCb;;;;;;;GAOG;AACH,SAAS,OAAO,CAAC,IAA8I;IAC7J,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEzC,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;SAC3F,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAC5B,MAA4D;IAE5D,MAAM,MAAM,GAA6B,EAAE,CAAA;IAE3C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAEhC;QAAA,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC7C,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAoC,EACpC,KAAc;IAEd,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAExB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAExD,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACzF,CAAC","sourcesContent":["\"use client\";\n\n/**\n * Validating a form before it is submitted, with whatever library you use.\n *\n * Not with an adapter per library: Standard Schema is the contract Zod,\n * Valibot, ArkType and others already implement, so this speaks to the schema\n * itself and never imports one. The types below are the spec, restated here\n * rather than depended on — it is an interface, and a package for it would be\n * a dependency that ships nothing.\n *\n * Validation on the client is a courtesy, never a control. The server still\n * has to check: a form is one way to reach an action, and the action is a\n * public endpoint reachable without it.\n */\n\nexport interface StandardSchemaV1<Input = unknown, Output = Input> {\n  readonly '~standard': {\n    readonly version: 1\n    readonly vendor: string\n    readonly validate: (\n      value: unknown,\n    ) => StandardSchemaResult<Output> | Promise<StandardSchemaResult<Output>>\n    readonly types?: { readonly input: Input; readonly output: Output }\n  }\n}\n\ninterface StandardSchemaResult<Output> {\n  readonly value?: Output\n  readonly issues?: ReadonlyArray<{\n    readonly message: string\n    readonly path?: ReadonlyArray<PropertyKey | { readonly key: PropertyKey }>\n  }>\n}\n\n/**\n * The field an issue belongs to.\n *\n * Segments are joined with dots so a nested field reads the way it was named —\n * `address.city`, not `address`. An issue with no path is about the form\n * rather than any field, and goes under the empty string, which is where a\n * component that wants to render it can look.\n */\nfunction fieldOf(path: StandardSchemaResult<unknown>['issues'] extends undefined ? never : NonNullable<StandardSchemaResult<unknown>['issues']>[number]['path']): string {\n  if (!path || path.length === 0) return ''\n\n  return path\n    .map((segment) => (typeof segment === 'object' && segment !== null ? segment.key : segment))\n    .join('.')\n}\n\n/** Issues grouped by field, in the shape the form already reports. */\nexport function issuesToErrors(\n  issues: NonNullable<StandardSchemaResult<unknown>['issues']>,\n): Record<string, string[]> {\n  const errors: Record<string, string[]> = {}\n\n  for (const issue of issues) {\n    const field = fieldOf(issue.path)\n\n    ;(errors[field] ??= []).push(issue.message)\n  }\n\n  return errors\n}\n\n/**\n * Run a schema, or nothing if there is not one.\n *\n * Returns the errors to show, or null when the value is acceptable. The parsed\n * value is deliberately discarded: what gets submitted is the FormData the\n * browser built, and quietly sending something else — a coerced number, a\n * trimmed string — would mean the action receives what the schema decided\n * rather than what the field said.\n */\nexport async function validateWith(\n  schema: StandardSchemaV1 | undefined,\n  value: unknown,\n): Promise<Record<string, string[]> | null> {\n  if (!schema) return null\n\n  const result = await schema['~standard'].validate(value)\n\n  return result.issues && result.issues.length > 0 ? issuesToErrors(result.issues) : null\n}\n"]}
+{"version":3,"file":"standardSchema.js","sourceRoot":"","sources":["../../src/js/standardSchema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAqBH;;;;;;;GAOG;AACH,SAAS,OAAO,CAAC,IAA8I;IAC7J,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEzC,OAAO,IAAI;SACR,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;SAC3F,IAAI,CAAC,GAAG,CAAC,CAAA;AACd,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,cAAc,CAC5B,MAA4D;IAE5D,MAAM,MAAM,GAA6B,EAAE,CAAA;IAE3C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAEhC;QAAA,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IAC7C,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,MAAoC,EACpC,KAAc;IAEd,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAA;IAExB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAA;IAExD,OAAO,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAA;AACzF,CAAC","sourcesContent":["/**\n * Validating a form before it is submitted, with whatever library you use.\n *\n * Not a client module, though a client component is its first caller: the\n * action pipeline validates with it on the server too, and a \"use client\"\n * directive here turned that call into a client-reference stub - \"client\n * reference export 'validateWith' is called on server\", on every action\n * with a schema. Pure functions, no React; importable from either side.\n *\n * Not with an adapter per library: Standard Schema is the contract Zod,\n * Valibot, ArkType and others already implement, so this speaks to the schema\n * itself and never imports one. The types below are the spec, restated here\n * rather than depended on — it is an interface, and a package for it would be\n * a dependency that ships nothing.\n *\n * Validation on the client is a courtesy, never a control. The server still\n * has to check: a form is one way to reach an action, and the action is a\n * public endpoint reachable without it.\n */\n\nexport interface StandardSchemaV1<Input = unknown, Output = Input> {\n  readonly '~standard': {\n    readonly version: 1\n    readonly vendor: string\n    readonly validate: (\n      value: unknown,\n    ) => StandardSchemaResult<Output> | Promise<StandardSchemaResult<Output>>\n    readonly types?: { readonly input: Input; readonly output: Output }\n  }\n}\n\ninterface StandardSchemaResult<Output> {\n  readonly value?: Output\n  readonly issues?: ReadonlyArray<{\n    readonly message: string\n    readonly path?: ReadonlyArray<PropertyKey | { readonly key: PropertyKey }>\n  }>\n}\n\n/**\n * The field an issue belongs to.\n *\n * Segments are joined with dots so a nested field reads the way it was named —\n * `address.city`, not `address`. An issue with no path is about the form\n * rather than any field, and goes under the empty string, which is where a\n * component that wants to render it can look.\n */\nfunction fieldOf(path: StandardSchemaResult<unknown>['issues'] extends undefined ? never : NonNullable<StandardSchemaResult<unknown>['issues']>[number]['path']): string {\n  if (!path || path.length === 0) return ''\n\n  return path\n    .map((segment) => (typeof segment === 'object' && segment !== null ? segment.key : segment))\n    .join('.')\n}\n\n/** Issues grouped by field, in the shape the form already reports. */\nexport function issuesToErrors(\n  issues: NonNullable<StandardSchemaResult<unknown>['issues']>,\n): Record<string, string[]> {\n  const errors: Record<string, string[]> = {}\n\n  for (const issue of issues) {\n    const field = fieldOf(issue.path)\n\n    ;(errors[field] ??= []).push(issue.message)\n  }\n\n  return errors\n}\n\n/**\n * Run a schema, or nothing if there is not one.\n *\n * Returns the errors to show, or null when the value is acceptable. The parsed\n * value is deliberately discarded: what gets submitted is the FormData the\n * browser built, and quietly sending something else — a coerced number, a\n * trimmed string — would mean the action receives what the schema decided\n * rather than what the field said.\n */\nexport async function validateWith(\n  schema: StandardSchemaV1 | undefined,\n  value: unknown,\n): Promise<Record<string, string[]> | null> {\n  if (!schema) return null\n\n  const result = await schema['~standard'].validate(value)\n\n  return result.issues && result.issues.length > 0 ? issuesToErrors(result.issues) : null\n}\n"]}

package/dist/js/useEvents.d.ts

@@ -0,0 +1,25 @@
+export type EventsStatus = "connecting" | "open" | "closed";
+export interface EventsOptions<T> {
+    /** Off, and nothing connects. For a stream that waits on an id. */
+    enabled?: boolean;
+    /** Listen to one named event rather than the unnamed stream. */
+    event?: string;
+    /** Every message, as it arrives. */
+    onMessage?: (message: T) => void;
+    /**
+     * The connection failed or dropped. EventSource reconnects on its own, so
+     * this is for a notice, not a retry; `status` says whether it gave up.
+     */
+    onError?: (error: Event) => void;
+    /** How many messages `all` keeps. Default 100; 0 keeps none. */
+    keep?: number;
+}
+export interface EventsState<T> {
+    latest: T | null;
+    all: T[];
+    status: EventsStatus;
+    error: Event | null;
+    /** Close the stream for good; the hook will not reconnect. */
+    close: () => void;
+}
+export declare function useEvents<T = unknown>(url: string, options?: EventsOptions<T>): EventsState<T>;

package/dist/js/useEvents.js

@@ -0,0 +1,78 @@
+"use client";
+/**
+ * A stream of server-sent events, as state.
+ *
+ *     const { latest, status } = useEvents(`/api/orders/${id}/events`)
+ *
+ * Subscribes in an effect, so it is safe in a component that also renders on
+ * the server. The browser's EventSource reconnects on its own and resumes
+ * with Last-Event-ID when the route yielded ids; `status` says where it is.
+ * `onMessage` is for a store that already holds the value - TanStack's
+ * setQueryData, SWR's mutate, a setState - and `latest` for when the hook is
+ * the store.
+ */
+import { useEffect, useRef, useState } from "react";
+export function useEvents(url, options = {}) {
+    const { enabled = true, event, keep = 100 } = options;
+    const onMessage = useRef(options.onMessage);
+    const onError = useRef(options.onError);
+    onMessage.current = options.onMessage;
+    onError.current = options.onError;
+    const [latest, setLatest] = useState(null);
+    const [all, setAll] = useState([]);
+    const [status, setStatus] = useState(enabled ? "connecting" : "closed");
+    const [error, setError] = useState(null);
+    const source = useRef(null);
+    useEffect(() => {
+        if (!enabled || typeof EventSource === "undefined") {
+            setStatus("closed");
+            return;
+        }
+        const es = new EventSource(url);
+        source.current = es;
+        setStatus("connecting");
+        setError(null);
+        const receive = (e) => {
+            let message;
+            try {
+                message = JSON.parse(e.data);
+            }
+            catch {
+                message = e.data;
+            }
+            setLatest(message);
+            if (keep > 0)
+                setAll((prev) => prev.length >= keep
+                    ? [...prev.slice(1), message]
+                    : [...prev, message]);
+            onMessage.current?.(message);
+        };
+        es.onopen = () => setStatus("open");
+        es.onerror = (e) => {
+            setError(e);
+            onError.current?.(e);
+            // EventSource reconnects on its own; CLOSED means it gave up.
+            setStatus(es.readyState === EventSource.CLOSED ? "closed" : "connecting");
+        };
+        if (event)
+            es.addEventListener(event, receive);
+        else
+            es.onmessage = receive;
+        return () => {
+            es.close();
+            source.current = null;
+        };
+    }, [url, enabled, event, keep]);
+    return {
+        latest,
+        all,
+        status,
+        error,
+        close: () => {
+            source.current?.close();
+            source.current = null;
+            setStatus("closed");
+        },
+    };
+}
+//# sourceMappingURL=useEvents.js.map

package/dist/js/useEvents.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useEvents.js","sourceRoot":"","sources":["../../src/js/useEvents.ts"],"names":[],"mappings":"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","sourcesContent":["\"use client\";\n\n/**\n * A stream of server-sent events, as state.\n *\n *     const { latest, status } = useEvents(`/api/orders/${id}/events`)\n *\n * Subscribes in an effect, so it is safe in a component that also renders on\n * the server. The browser's EventSource reconnects on its own and resumes\n * with Last-Event-ID when the route yielded ids; `status` says where it is.\n * `onMessage` is for a store that already holds the value - TanStack's\n * setQueryData, SWR's mutate, a setState - and `latest` for when the hook is\n * the store.\n */\n\nimport { useEffect, useRef, useState } from \"react\";\n\nexport type EventsStatus = \"connecting\" | \"open\" | \"closed\";\n\nexport interface EventsOptions<T> {\n  /** Off, and nothing connects. For a stream that waits on an id. */\n  enabled?: boolean;\n  /** Listen to one named event rather than the unnamed stream. */\n  event?: string;\n  /** Every message, as it arrives. */\n  onMessage?: (message: T) => void;\n  /**\n   * The connection failed or dropped. EventSource reconnects on its own, so\n   * this is for a notice, not a retry; `status` says whether it gave up.\n   */\n  onError?: (error: Event) => void;\n  /** How many messages `all` keeps. Default 100; 0 keeps none. */\n  keep?: number;\n}\n\nexport interface EventsState<T> {\n  latest: T | null;\n  all: T[];\n  status: EventsStatus;\n  error: Event | null;\n  /** Close the stream for good; the hook will not reconnect. */\n  close: () => void;\n}\n\nexport function useEvents<T = unknown>(\n  url: string,\n  options: EventsOptions<T> = {},\n): EventsState<T> {\n  const { enabled = true, event, keep = 100 } = options;\n  const onMessage = useRef(options.onMessage);\n  const onError = useRef(options.onError);\n\n  onMessage.current = options.onMessage;\n  onError.current = options.onError;\n\n  const [latest, setLatest] = useState<T | null>(null);\n  const [all, setAll] = useState<T[]>([]);\n  const [status, setStatus] = useState<EventsStatus>(\n    enabled ? \"connecting\" : \"closed\",\n  );\n  const [error, setError] = useState<Event | null>(null);\n  const source = useRef<EventSource | null>(null);\n\n  useEffect(() => {\n    if (!enabled || typeof EventSource === \"undefined\") {\n      setStatus(\"closed\");\n\n      return;\n    }\n\n    const es = new EventSource(url);\n\n    source.current = es;\n    setStatus(\"connecting\");\n    setError(null);\n\n    const receive = (e: MessageEvent) => {\n      let message: T;\n\n      try {\n        message = JSON.parse(e.data) as T;\n      } catch {\n        message = e.data as T;\n      }\n\n      setLatest(message);\n      if (keep > 0)\n        setAll((prev) =>\n          prev.length >= keep\n            ? [...prev.slice(1), message]\n            : [...prev, message],\n        );\n      onMessage.current?.(message);\n    };\n\n    es.onopen = () => setStatus(\"open\");\n    es.onerror = (e) => {\n      setError(e);\n      onError.current?.(e);\n      // EventSource reconnects on its own; CLOSED means it gave up.\n      setStatus(es.readyState === EventSource.CLOSED ? \"closed\" : \"connecting\");\n    };\n\n    if (event) es.addEventListener(event, receive as EventListener);\n    else es.onmessage = receive;\n\n    return () => {\n      es.close();\n      source.current = null;\n    };\n  }, [url, enabled, event, keep]);\n\n  return {\n    latest,\n    all,\n    status,\n    error,\n    close: () => {\n      source.current?.close();\n      source.current = null;\n      setStatus(\"closed\");\n    },\n  };\n}\n"]}

package/dist/js/useLinkStatus.d.ts

@@ -1 +1,14 @@
-export { useLinkStatus } from "./Link";
+/**
+ * Whether the enclosing <Link> is mid-navigation, for the thing inside it
+ * that wants to show as much.
+ *
+ * In its own module rather than beside Link: a module that exports a
+ * component and a hook cannot be fast-refreshed, and every change to Link
+ * became a full page reload in development for whoever had it open.
+ */
+export declare const LinkStatusContext: import("react").Context<{
+    pending: boolean;
+}>;
+export declare function useLinkStatus(): {
+    pending: boolean;
+};

package/dist/js/useLinkStatus.js

@@ -1,3 +1,17 @@
 "use client";
-export { useLinkStatus } from "./Link";
+import { createContext, useContext } from "react";
+/**
+ * Whether the enclosing <Link> is mid-navigation, for the thing inside it
+ * that wants to show as much.
+ *
+ * In its own module rather than beside Link: a module that exports a
+ * component and a hook cannot be fast-refreshed, and every change to Link
+ * became a full page reload in development for whoever had it open.
+ */
+export const LinkStatusContext = createContext({
+    pending: false,
+});
+export function useLinkStatus() {
+    return useContext(LinkStatusContext);
+}
 //# sourceMappingURL=useLinkStatus.js.map

package/dist/js/useLinkStatus.js.map

@@ -1 +1 @@
-{"version":3,"file":"useLinkStatus.js","sourceRoot":"","sources":["../../src/js/useLinkStatus.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC","sourcesContent":["\"use client\";\n\nexport { useLinkStatus } from \"./Link\";\n"]}
+{"version":3,"file":"useLinkStatus.js","sourceRoot":"","sources":["../../src/js/useLinkStatus.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAElD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAuB;IACnE,OAAO,EAAE,KAAK;CACf,CAAC,CAAC;AAEH,MAAM,UAAU,aAAa;IAC3B,OAAO,UAAU,CAAC,iBAAiB,CAAC,CAAC;AACvC,CAAC","sourcesContent":["\"use client\";\n\nimport { createContext, useContext } from \"react\";\n\n/**\n * Whether the enclosing <Link> is mid-navigation, for the thing inside it\n * that wants to show as much.\n *\n * In its own module rather than beside Link: a module that exports a\n * component and a hook cannot be fast-refreshed, and every change to Link\n * became a full page reload in development for whoever had it open.\n */\nexport const LinkStatusContext = createContext<{ pending: boolean }>({\n  pending: false,\n});\n\nexport function useLinkStatus(): { pending: boolean } {\n  return useContext(LinkStatusContext);\n}\n"]}

package/dist/js/usePolling.d.ts

@@ -0,0 +1,29 @@
+export interface PollingOptions<T> {
+    /** Milliseconds between reads. */
+    every: number;
+    enabled?: boolean;
+    /** Every answer, as it arrives. */
+    onData?: (data: T) => void;
+    /** When a read is the last one: polling stops, and the answer is settled. */
+    until?: (data: T) => boolean;
+    /** Once, with the answer `until` accepted. */
+    onSettled?: (data: T) => void;
+    /**
+     * Every read that failed. The next interval still reads; `error` is the
+     * state. `failures` counts the failed reads in a row, so a third one can be
+     * a toast where the first was a blip — a success resets it.
+     */
+    onError?: (error: unknown, info: {
+        failures: number;
+    }) => void;
+    /** Keep reading while the tab is hidden. Off by default. */
+    whenHidden?: boolean;
+}
+export interface PollingState<T> {
+    data: T | null;
+    error: unknown;
+    status: "idle" | "reading" | "paused" | "settled";
+    /** Read now, outside the interval - and start again after settling. */
+    refresh: () => Promise<void>;
+}
+export declare function usePolling<T>(read: () => Promise<T>, options: PollingOptions<T>): PollingState<T>;

package/dist/js/usePolling.js

@@ -0,0 +1,141 @@
+"use client";
+/**
+ * A value read again on an interval, as state - until it settles, if asked.
+ *
+ *     const { data } = usePolling(() => fetchQuery(getSeats), { every: 2_000 })
+ *
+ *     // Until a job is done, then re-render the page that showed it.
+ *     usePolling(() => fetchQuery(jobStatus, [id]), {
+ *       every: 2_000,
+ *       until: (job) => job.state === 'done' || job.state === 'failed',
+ *       onSettled: () => refresh('page'),
+ *     })
+ *
+ * The result is the data: whatever `read` returns is what `data` holds, and
+ * a query's Cache-Control lets a CDN absorb a thousand tabs polling the same
+ * thing into one origin request per interval. Settling is separate and
+ * explicit: `until` says when a read is the last one, and `onSettled` fires
+ * once on that read - so a page that wants to re-render through the server
+ * path that built it calls refresh('page') there, and a page that wants the
+ * value in hand reads `data`. Which of those is the page's to decide, not
+ * the hook's.
+ *
+ * Pauses while the tab is hidden, never overlaps two reads, and `refresh()`
+ * reads now - including after it settled, which starts it again.
+ *
+ * Polling against server-sent events: a stream sends bytes only when
+ * something changed and arrives at once, but holds a connection per tab
+ * and needs a source of change to yield from. Polling needs neither - it
+ * reuses the query you wrote - and is cacheable. Start here when you have
+ * no change feed yet; see useEvents when you do.
+ */
+import { useCallback, useEffect, useRef, useState } from "react";
+export function usePolling(read, options) {
+    const { every, enabled = true, whenHidden = false } = options;
+    const latest = useRef({
+        read,
+        onData: options.onData,
+        until: options.until,
+        onSettled: options.onSettled,
+        onError: options.onError,
+    });
+    latest.current = {
+        read,
+        onData: options.onData,
+        until: options.until,
+        onSettled: options.onSettled,
+        onError: options.onError,
+    };
+    const [data, setData] = useState(null);
+    const [error, setError] = useState(null);
+    const failures = useRef(0);
+    const [status, setStatus] = useState(enabled ? "reading" : "idle");
+    const inFlight = useRef(null);
+    // Settled is a stop: the interval is cleared and stays cleared until
+    // refresh() or a change of inputs. Kept in a ref as well as state, so the
+    // interval callback sees it without a re-render in between.
+    const isSettled = useRef(false);
+    const refresh = useCallback(async () => {
+        // Never two at once: a slow answer and a fast interval would otherwise
+        // pile reads up, and the last to land wins whether or not it was newest.
+        if (inFlight.current)
+            return inFlight.current;
+        // A read after settling is asked for: refresh() starts the clock again.
+        if (isSettled.current) {
+            isSettled.current = false;
+            setStatus("reading");
+        }
+        inFlight.current = (async () => {
+            try {
+                const next = await latest.current.read();
+                setData(next);
+                setError(null);
+                failures.current = 0;
+                latest.current.onData?.(next);
+                if (latest.current.until?.(next)) {
+                    isSettled.current = true;
+                    setStatus("settled");
+                    latest.current.onSettled?.(next);
+                }
+            }
+            catch (e) {
+                failures.current += 1;
+                setError(e);
+                latest.current.onError?.(e, { failures: failures.current });
+            }
+            finally {
+                inFlight.current = null;
+            }
+        })();
+        return inFlight.current;
+    }, []);
+    useEffect(() => {
+        if (!enabled) {
+            setStatus("idle");
+            return;
+        }
+        let timer = null;
+        isSettled.current = false;
+        const start = () => {
+            if (timer)
+                return;
+            setStatus("reading");
+            void refresh();
+            timer = setInterval(() => {
+                if (!isSettled.current)
+                    void refresh();
+            }, every);
+        };
+        const stop = () => {
+            if (timer)
+                clearInterval(timer);
+            timer = null;
+        };
+        const onVisibility = () => {
+            if (document.visibilityState === "hidden") {
+                stop();
+                setStatus("paused");
+            }
+            else {
+                start();
+            }
+        };
+        if (whenHidden ||
+            typeof document === "undefined" ||
+            document.visibilityState !== "hidden")
+            start();
+        else
+            setStatus("paused");
+        if (!whenHidden && typeof document !== "undefined") {
+            document.addEventListener("visibilitychange", onVisibility);
+        }
+        return () => {
+            stop();
+            if (!whenHidden && typeof document !== "undefined") {
+                document.removeEventListener("visibilitychange", onVisibility);
+            }
+        };
+    }, [enabled, every, whenHidden, refresh]);
+    return { data, error, status, refresh };
+}
+//# sourceMappingURL=usePolling.js.map

package/dist/js/usePolling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"usePolling.js","sourceRoot":"","sources":["../../src/js/usePolling.ts"],"names":[],"mappings":"AAAA,YAAY,CAAC;AAEb;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AA8BjE,MAAM,UAAU,UAAU,CACxB,IAAsB,EACtB,OAA0B;IAE1B,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,EAAE,UAAU,GAAG,KAAK,EAAE,GAAG,OAAO,CAAC;IAC9D,MAAM,MAAM,GAAG,MAAM,CAAC;QACpB,IAAI;QACJ,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC,CAAC;IAEH,MAAM,CAAC,OAAO,GAAG;QACf,IAAI;QACJ,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,KAAK,EAAE,OAAO,CAAC,KAAK;QACpB,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;IAEF,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAW,IAAI,CAAC,CAAC;IACjD,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAU,IAAI,CAAC,CAAC;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3B,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAClC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAC7B,CAAC;IACF,MAAM,QAAQ,GAAG,MAAM,CAAuB,IAAI,CAAC,CAAC;IACpD,qEAAqE;IACrE,0EAA0E;IAC1E,4DAA4D;IAC5D,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAEhC,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QACrC,uEAAuE;QACvE,yEAAyE;QACzE,IAAI,QAAQ,CAAC,OAAO;YAAE,OAAO,QAAQ,CAAC,OAAO,CAAC;QAE9C,wEAAwE;QACxE,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC;YACtB,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;YAC1B,SAAS,CAAC,SAAS,CAAC,CAAC;QACvB,CAAC;QAED,QAAQ,CAAC,OAAO,GAAG,CAAC,KAAK,IAAI,EAAE;YAC7B,IAAI,CAAC;gBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAEzC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACd,QAAQ,CAAC,IAAI,CAAC,CAAC;gBACf,QAAQ,CAAC,OAAO,GAAG,CAAC,CAAC;gBACrB,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC;gBAE9B,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;oBACjC,SAAS,CAAC,OAAO,GAAG,IAAI,CAAC;oBACzB,SAAS,CAAC,SAAS,CAAC,CAAC;oBACrB,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC;gBACnC,CAAC;YACH,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,QAAQ,CAAC,OAAO,IAAI,CAAC,CAAC;gBACtB,QAAQ,CAAC,CAAC,CAAC,CAAC;gBACZ,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,QAAQ,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;YAC9D,CAAC;oBAAS,CAAC;gBACT,QAAQ,CAAC,OAAO,GAAG,IAAI,CAAC;YAC1B,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QAEL,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,SAAS,CAAC,MAAM,CAAC,CAAC;YAElB,OAAO;QACT,CAAC;QAED,IAAI,KAAK,GAA0C,IAAI,CAAC;QAExD,SAAS,CAAC,OAAO,GAAG,KAAK,CAAC;QAE1B,MAAM,KAAK,GAAG,GAAG,EAAE;YACjB,IAAI,KAAK;gBAAE,OAAO;YAElB,SAAS,CAAC,SAAS,CAAC,CAAC;YACrB,KAAK,OAAO,EAAE,CAAC;YACf,KAAK,GAAG,WAAW,CAAC,GAAG,EAAE;gBACvB,IAAI,CAAC,SAAS,CAAC,OAAO;oBAAE,KAAK,OAAO,EAAE,CAAC;YACzC,CAAC,EAAE,KAAK,CAAC,CAAC;QACZ,CAAC,CAAC;QACF,MAAM,IAAI,GAAG,GAAG,EAAE;YAChB,IAAI,KAAK;gBAAE,aAAa,CAAC,KAAK,CAAC,CAAC;YAEhC,KAAK,GAAG,IAAI,CAAC;QACf,CAAC,CAAC;QACF,MAAM,YAAY,GAAG,GAAG,EAAE;YACxB,IAAI,QAAQ,CAAC,eAAe,KAAK,QAAQ,EAAE,CAAC;gBAC1C,IAAI,EAAE,CAAC;gBACP,SAAS,CAAC,QAAQ,CAAC,CAAC;YACtB,CAAC;iBAAM,CAAC;gBACN,KAAK,EAAE,CAAC;YACV,CAAC;QACH,CAAC,CAAC;QAEF,IACE,UAAU;YACV,OAAO,QAAQ,KAAK,WAAW;YAC/B,QAAQ,CAAC,eAAe,KAAK,QAAQ;YAErC,KAAK,EAAE,CAAC;;YACL,SAAS,CAAC,QAAQ,CAAC,CAAC;QAEzB,IAAI,CAAC,UAAU,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;YACnD,QAAQ,CAAC,gBAAgB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;QAC9D,CAAC;QAED,OAAO,GAAG,EAAE;YACV,IAAI,EAAE,CAAC;YACP,IAAI,CAAC,UAAU,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;gBACnD,QAAQ,CAAC,mBAAmB,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAAC;YACjE,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC;IAE1C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;AAC1C,CAAC","sourcesContent":["\"use client\";\n\n/**\n * A value read again on an interval, as state - until it settles, if asked.\n *\n *     const { data } = usePolling(() => fetchQuery(getSeats), { every: 2_000 })\n *\n *     // Until a job is done, then re-render the page that showed it.\n *     usePolling(() => fetchQuery(jobStatus, [id]), {\n *       every: 2_000,\n *       until: (job) => job.state === 'done' || job.state === 'failed',\n *       onSettled: () => refresh('page'),\n *     })\n *\n * The result is the data: whatever `read` returns is what `data` holds, and\n * a query's Cache-Control lets a CDN absorb a thousand tabs polling the same\n * thing into one origin request per interval. Settling is separate and\n * explicit: `until` says when a read is the last one, and `onSettled` fires\n * once on that read - so a page that wants to re-render through the server\n * path that built it calls refresh('page') there, and a page that wants the\n * value in hand reads `data`. Which of those is the page's to decide, not\n * the hook's.\n *\n * Pauses while the tab is hidden, never overlaps two reads, and `refresh()`\n * reads now - including after it settled, which starts it again.\n *\n * Polling against server-sent events: a stream sends bytes only when\n * something changed and arrives at once, but holds a connection per tab\n * and needs a source of change to yield from. Polling needs neither - it\n * reuses the query you wrote - and is cacheable. Start here when you have\n * no change feed yet; see useEvents when you do.\n */\n\nimport { useCallback, useEffect, useRef, useState } from \"react\";\n\nexport interface PollingOptions<T> {\n  /** Milliseconds between reads. */\n  every: number;\n  enabled?: boolean;\n  /** Every answer, as it arrives. */\n  onData?: (data: T) => void;\n  /** When a read is the last one: polling stops, and the answer is settled. */\n  until?: (data: T) => boolean;\n  /** Once, with the answer `until` accepted. */\n  onSettled?: (data: T) => void;\n  /**\n   * Every read that failed. The next interval still reads; `error` is the\n   * state. `failures` counts the failed reads in a row, so a third one can be\n   * a toast where the first was a blip — a success resets it.\n   */\n  onError?: (error: unknown, info: { failures: number }) => void;\n  /** Keep reading while the tab is hidden. Off by default. */\n  whenHidden?: boolean;\n}\n\nexport interface PollingState<T> {\n  data: T | null;\n  error: unknown;\n  status: \"idle\" | \"reading\" | \"paused\" | \"settled\";\n  /** Read now, outside the interval - and start again after settling. */\n  refresh: () => Promise<void>;\n}\n\nexport function usePolling<T>(\n  read: () => Promise<T>,\n  options: PollingOptions<T>,\n): PollingState<T> {\n  const { every, enabled = true, whenHidden = false } = options;\n  const latest = useRef({\n    read,\n    onData: options.onData,\n    until: options.until,\n    onSettled: options.onSettled,\n    onError: options.onError,\n  });\n\n  latest.current = {\n    read,\n    onData: options.onData,\n    until: options.until,\n    onSettled: options.onSettled,\n    onError: options.onError,\n  };\n\n  const [data, setData] = useState<T | null>(null);\n  const [error, setError] = useState<unknown>(null);\n  const failures = useRef(0);\n  const [status, setStatus] = useState<PollingState<T>[\"status\"]>(\n    enabled ? \"reading\" : \"idle\",\n  );\n  const inFlight = useRef<Promise<void> | null>(null);\n  // Settled is a stop: the interval is cleared and stays cleared until\n  // refresh() or a change of inputs. Kept in a ref as well as state, so the\n  // interval callback sees it without a re-render in between.\n  const isSettled = useRef(false);\n\n  const refresh = useCallback(async () => {\n    // Never two at once: a slow answer and a fast interval would otherwise\n    // pile reads up, and the last to land wins whether or not it was newest.\n    if (inFlight.current) return inFlight.current;\n\n    // A read after settling is asked for: refresh() starts the clock again.\n    if (isSettled.current) {\n      isSettled.current = false;\n      setStatus(\"reading\");\n    }\n\n    inFlight.current = (async () => {\n      try {\n        const next = await latest.current.read();\n\n        setData(next);\n        setError(null);\n        failures.current = 0;\n        latest.current.onData?.(next);\n\n        if (latest.current.until?.(next)) {\n          isSettled.current = true;\n          setStatus(\"settled\");\n          latest.current.onSettled?.(next);\n        }\n      } catch (e) {\n        failures.current += 1;\n        setError(e);\n        latest.current.onError?.(e, { failures: failures.current });\n      } finally {\n        inFlight.current = null;\n      }\n    })();\n\n    return inFlight.current;\n  }, []);\n\n  useEffect(() => {\n    if (!enabled) {\n      setStatus(\"idle\");\n\n      return;\n    }\n\n    let timer: ReturnType<typeof setInterval> | null = null;\n\n    isSettled.current = false;\n\n    const start = () => {\n      if (timer) return;\n\n      setStatus(\"reading\");\n      void refresh();\n      timer = setInterval(() => {\n        if (!isSettled.current) void refresh();\n      }, every);\n    };\n    const stop = () => {\n      if (timer) clearInterval(timer);\n\n      timer = null;\n    };\n    const onVisibility = () => {\n      if (document.visibilityState === \"hidden\") {\n        stop();\n        setStatus(\"paused\");\n      } else {\n        start();\n      }\n    };\n\n    if (\n      whenHidden ||\n      typeof document === \"undefined\" ||\n      document.visibilityState !== \"hidden\"\n    )\n      start();\n    else setStatus(\"paused\");\n\n    if (!whenHidden && typeof document !== \"undefined\") {\n      document.addEventListener(\"visibilitychange\", onVisibility);\n    }\n\n    return () => {\n      stop();\n      if (!whenHidden && typeof document !== \"undefined\") {\n        document.removeEventListener(\"visibilitychange\", onVisibility);\n      }\n    };\n  }, [enabled, every, whenHidden, refresh]);\n\n  return { data, error, status, refresh };\n}\n"]}

package/dist/manifest.d.ts

@@ -1,5 +1,10 @@
 export interface RouteSegment {
-    type: 'static' | 'param' | 'catchAll';
+    /**
+     * `host`: a `[name]` directory at the top of app/. Bound from the request's
+     * host, never from a path segment - so `example.com/nope` is a 404 rather
+     * than a tenant called "nope". See hostRouting.
+     */
+    type: "static" | "param" | "catchAll" | "host";
     value: string;
 }
 export interface ManifestRoute {
@@ -96,6 +101,18 @@ export interface RouteManifest {
         output: string;
         exportPath: string;
         payloadName: string;
+        /**
+         * The site's own hosts, bare and lower-case. A request from any other
+         * host is matched with that host's segment in front of its path - see
+         * hostRouting. Absent or empty: every request is the site's own.
+         */
+        hosts?: string[];
+        /**
+         * Whether every response says what built it: `X-Powered-By: rsc-kit` and
+         * a generator meta tag in the document. The name only, never the version.
+         * `X-RSC-Kit` (how a response was served) is sent regardless.
+         */
+        identify?: boolean;
     };
     routes: ManifestRoute[];
     intercepts: ManifestIntercept[];

package/dist/manifest.js.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAChF,uCAAuC;AACvC,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,oBAAoB","sourcesContent":["// The shape of routes.json — what the build discovered, for a host to read.\n//\n// The build already walks app/ to generate its entries, and every host needs\n// the same facts: which url a component answers, what layouts wrap it, which\n// slots and sections belong to it. Laravel used to scan the tree a second time\n// to work that out; a JS host would have had to write a third walk. This is the\n// one answer, and these are its types.\n//\n// Urls are segments rather than a pattern string, because the pattern is the\n// host's dialect: Laravel writes {slug}, Hono writes :slug, and neither is the\n// build's business.\n\nexport interface RouteSegment {\n  type: 'static' | 'param' | 'catchAll'\n  value: string\n}\n\nexport interface ManifestRoute {\n  component: string\n  segments: RouteSegment[]\n  layouts: string[]\n  loadings: string[]\n  /**\n   * `error.tsx` files above this route, outermost first.\n   *\n   * The nearest one to a failure catches it, the same way the nearest\n   * `loading.tsx` is the fallback. Optional: a manifest from a build before\n   * error boundaries existed has none.\n   */\n  errors?: string[]\n  /**\n   * `middleware.ts` files above this route, outermost first.\n   *\n   * Run before anything at or below them renders, on every path. A check is\n   * not UI, and making it a layout meant the client could decline it: layouts\n   * are skipped on a partial navigation, and what gets skipped is named in a\n   * header nothing can verify.\n   */\n  middleware: string[]\n  slots: Record<string, string>\n  sections: string[]\n  /**\n   * The host's route-config file beside this page, if it named one, and the\n   * ancestor ones that also apply — outermost first, this page's excluded.\n   *\n   * Relative to the project root: an absolute path is true only on the machine\n   * that produced it, and building in a container is ordinary.\n   */\n  config: string | null\n  ancestorConfigs: string[]\n  /**\n   * Host middleware names for this route, outermost first.\n   *\n   * Declared in a route.ts beside or above the page. The engine does not know\n   * what they mean — they are the host's own vocabulary — it only runs them\n   * past the host before anything at or below this route renders.\n   *\n   * Empty on a route that named none, and on every route in an app that never\n   * wrote a route.ts, which is why this needs no flag.\n   *\n   * Optional because registration boots from the PREVIOUS build's manifest: a\n   * shape change takes two builds to settle, and a required field would make\n   * the first of those a hard failure rather than a route with no guards.\n   */\n  hostMiddleware?: string[]\n  /**\n   * Whether the page exports generateStaticParams.\n   *\n   * Recorded here so a host can plan a build — which routes to ask for urls,\n   * which to leave on demand — without loading the server bundle first. The\n   * function itself is reached through the bundle's getStaticParams(), because\n   * only the bundle can run it.\n   */\n  staticParams: boolean\n}\n\nexport interface ManifestIntercept {\n  component: string\n  slot: string\n  segments: RouteSegment[]\n  /** (.) same level, (..) one up, (...) from the root. */\n  marker: string\n}\n\n/**\n * A `route.ts` — an api endpoint rather than a page.\n *\n * Separate from `routes` because it is matched before them and answered\n * without rendering anything: no layouts, no payload, no client. A url cannot\n * be both, and the build refuses one that is.\n */\nexport interface ManifestApiRoute {\n  /** The module name, as the engine's registry keys it. */\n  name: string\n  segments: RouteSegment[]\n  /** Which methods the file exports, so a 405 can name the rest. */\n  methods: string[]\n  /**\n   * `middleware.ts` files above this route, outermost first.\n   *\n   * The same chain a page in that directory runs. A route.ts sits among the\n   * pages it belongs with, so a guard on the directory covers it too —\n   * anything else would mean adding an endpoint under a guarded path silently\n   * opened a hole in it.\n   */\n  middleware: string[]\n}\n\nexport interface RouteManifest {\n  version: number\n  build: { output: string; exportPath: string; payloadName: string }\n  routes: ManifestRoute[]\n  intercepts: ManifestIntercept[]\n  /** Optional: a manifest from a build before api routes existed has none. */\n  apis?: ManifestApiRoute[]\n}\n"]}
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../src/manifest.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,EAAE;AACF,6EAA6E;AAC7E,6EAA6E;AAC7E,+EAA+E;AAC/E,gFAAgF;AAChF,uCAAuC;AACvC,EAAE;AACF,6EAA6E;AAC7E,+EAA+E;AAC/E,oBAAoB","sourcesContent":["// The shape of routes.json — what the build discovered, for a host to read.\n//\n// The build already walks app/ to generate its entries, and every host needs\n// the same facts: which url a component answers, what layouts wrap it, which\n// slots and sections belong to it. Laravel used to scan the tree a second time\n// to work that out; a JS host would have had to write a third walk. This is the\n// one answer, and these are its types.\n//\n// Urls are segments rather than a pattern string, because the pattern is the\n// host's dialect: Laravel writes {slug}, Hono writes :slug, and neither is the\n// build's business.\n\nexport interface RouteSegment {\n  /**\n   * `host`: a `[name]` directory at the top of app/. Bound from the request's\n   * host, never from a path segment - so `example.com/nope` is a 404 rather\n   * than a tenant called \"nope\". See hostRouting.\n   */\n  type: \"static\" | \"param\" | \"catchAll\" | \"host\";\n  value: string;\n}\n\nexport interface ManifestRoute {\n  component: string;\n  segments: RouteSegment[];\n  layouts: string[];\n  loadings: string[];\n  /**\n   * `error.tsx` files above this route, outermost first.\n   *\n   * The nearest one to a failure catches it, the same way the nearest\n   * `loading.tsx` is the fallback. Optional: a manifest from a build before\n   * error boundaries existed has none.\n   */\n  errors?: string[];\n  /**\n   * `middleware.ts` files above this route, outermost first.\n   *\n   * Run before anything at or below them renders, on every path. A check is\n   * not UI, and making it a layout meant the client could decline it: layouts\n   * are skipped on a partial navigation, and what gets skipped is named in a\n   * header nothing can verify.\n   */\n  middleware: string[];\n  slots: Record<string, string>;\n  sections: string[];\n  /**\n   * The host's route-config file beside this page, if it named one, and the\n   * ancestor ones that also apply — outermost first, this page's excluded.\n   *\n   * Relative to the project root: an absolute path is true only on the machine\n   * that produced it, and building in a container is ordinary.\n   */\n  config: string | null;\n  ancestorConfigs: string[];\n  /**\n   * Host middleware names for this route, outermost first.\n   *\n   * Declared in a route.ts beside or above the page. The engine does not know\n   * what they mean — they are the host's own vocabulary — it only runs them\n   * past the host before anything at or below this route renders.\n   *\n   * Empty on a route that named none, and on every route in an app that never\n   * wrote a route.ts, which is why this needs no flag.\n   *\n   * Optional because registration boots from the PREVIOUS build's manifest: a\n   * shape change takes two builds to settle, and a required field would make\n   * the first of those a hard failure rather than a route with no guards.\n   */\n  hostMiddleware?: string[];\n  /**\n   * Whether the page exports generateStaticParams.\n   *\n   * Recorded here so a host can plan a build — which routes to ask for urls,\n   * which to leave on demand — without loading the server bundle first. The\n   * function itself is reached through the bundle's getStaticParams(), because\n   * only the bundle can run it.\n   */\n  staticParams: boolean;\n}\n\nexport interface ManifestIntercept {\n  component: string;\n  slot: string;\n  segments: RouteSegment[];\n  /** (.) same level, (..) one up, (...) from the root. */\n  marker: string;\n}\n\n/**\n * A `route.ts` — an api endpoint rather than a page.\n *\n * Separate from `routes` because it is matched before them and answered\n * without rendering anything: no layouts, no payload, no client. A url cannot\n * be both, and the build refuses one that is.\n */\nexport interface ManifestApiRoute {\n  /** The module name, as the engine's registry keys it. */\n  name: string;\n  segments: RouteSegment[];\n  /** Which methods the file exports, so a 405 can name the rest. */\n  methods: string[];\n  /**\n   * `middleware.ts` files above this route, outermost first.\n   *\n   * The same chain a page in that directory runs. A route.ts sits among the\n   * pages it belongs with, so a guard on the directory covers it too —\n   * anything else would mean adding an endpoint under a guarded path silently\n   * opened a hole in it.\n   */\n  middleware: string[];\n}\n\nexport interface RouteManifest {\n  version: number;\n  build: {\n    output: string;\n    exportPath: string;\n    payloadName: string;\n    /**\n     * The site's own hosts, bare and lower-case. A request from any other\n     * host is matched with that host's segment in front of its path - see\n     * hostRouting. Absent or empty: every request is the site's own.\n     */\n    hosts?: string[];\n    /**\n     * Whether every response says what built it: `X-Powered-By: rsc-kit` and\n     * a generator meta tag in the document. The name only, never the version.\n     * `X-RSC-Kit` (how a response was served) is sent regardless.\n     */\n    identify?: boolean;\n  };\n  routes: ManifestRoute[];\n  intercepts: ManifestIntercept[];\n  /** Optional: a manifest from a build before api routes existed has none. */\n  apis?: ManifestApiRoute[];\n}\n"]}

package/dist/metadata.d.ts

@@ -5,7 +5,7 @@ export interface IconDescriptor {
     color?: string;
     rel?: string;
     media?: string;
-    fetchPriority?: 'high' | 'low' | 'auto';
+    fetchPriority?: "high" | "low" | "auto";
 }
 export type IconURL = string | URL;
 export interface Icons {
@@ -40,13 +40,13 @@ export interface OpenGraph {
     /** Absolute, or relative to `metadataBase`. */
     url?: string | URL;
     siteName?: string;
-    type?: 'website' | 'article' | 'profile' | 'book' | (string & {});
+    type?: "website" | "article" | "profile" | "book" | (string & {});
     locale?: string;
     images?: string | URL | OpenGraphImage | (string | URL | OpenGraphImage)[];
 }
 /** The same card for X, which reads `name=` rather than `property=`. */
 export interface Twitter {
-    card?: 'summary' | 'summary_large_image' | 'app' | 'player';
+    card?: "summary" | "summary_large_image" | "app" | "player";
     title?: string;
     description?: string;
     /** The site's account, `@handle`. */
@@ -55,13 +55,35 @@ export interface Twitter {
     creator?: string;
     images?: string | URL | OpenGraphImage | (string | URL | OpenGraphImage)[];
 }
+export interface Robots {
+    index?: boolean;
+    follow?: boolean;
+    noarchive?: boolean;
+    nosnippet?: boolean;
+    noimageindex?: boolean;
+    nocache?: boolean;
+    notranslate?: boolean;
+    indexifembedded?: boolean;
+    nositelinkssearchbox?: boolean;
+    unavailable_after?: string;
+    "max-video-preview"?: number | string;
+    "max-image-preview"?: "none" | "standard" | "large";
+    "max-snippet"?: number;
+    googleBot?: string | Omit<Robots, "googleBot">;
+}
 export interface Metadata {
     /** A string on a page; a template on a layout, applied to the pages below it. */
     title?: string | TitleTemplate;
     description?: string;
     keywords?: string | string[];
     author?: string;
-    robots?: string;
+    /**
+     * A string, or the object Next takes: `{ index: false, follow: false }`
+     * becomes `<meta name="robots" content="noindex, nofollow">`, the flags
+     * by name, the limits as `name:value`; `googleBot` is the same shape for
+     * `<meta name="googlebot">`.
+     */
+    robots?: string | Robots;
     /**
      * Where the site lives, so a relative image or url can be made absolute.
      *
@@ -77,27 +99,27 @@ export interface Metadata {
     openGraph?: OpenGraph;
     twitter?: Twitter;
     /** @deprecated Use `openGraph.title`. Still rendered, correctly, as `property=`. */
-    'og:title'?: string;
+    "og:title"?: string;
     /** @deprecated Use `openGraph.description`. */
-    'og:description'?: string;
+    "og:description"?: string;
     /** @deprecated Use `openGraph.images`. */
-    'og:image'?: string;
+    "og:image"?: string;
     /** @deprecated Use `openGraph.url`. */
-    'og:url'?: string;
+    "og:url"?: string;
     /** @deprecated Use `openGraph.type`. */
-    'og:type'?: string;
+    "og:type"?: string;
     /** @deprecated Use `openGraph.siteName`. */
-    'og:site_name'?: string;
+    "og:site_name"?: string;
     /** @deprecated Use `twitter.card`. */
-    'twitter:card'?: string;
+    "twitter:card"?: string;
     /** @deprecated Use `twitter.title`. */
-    'twitter:title'?: string;
+    "twitter:title"?: string;
     /** @deprecated Use `twitter.description`. */
-    'twitter:description'?: string;
+    "twitter:description"?: string;
     /** @deprecated Use `twitter.images`. */
-    'twitter:image'?: string;
+    "twitter:image"?: string;
     /** @deprecated Use `twitter.site`. */
-    'twitter:site'?: string;
+    "twitter:site"?: string;
     /**
      * Any other meta tag, by name.
      *
@@ -125,3 +147,60 @@ export type GenerateMetadata<P = Record<string, string>> = (args: {
     params: Promise<P>;
     searchParams: Promise<URLSearchParams>;
 }) => Metadata | Promise<Metadata>;
+/** One rule block of a robots.txt: which agents, what they may and may not fetch. */
+export interface RobotsRule {
+    userAgent?: string | string[];
+    allow?: string | string[];
+    disallow?: string | string[];
+    crawlDelay?: number;
+}
+/** One url of a sitemap. `url` may be relative when the root layout has a metadataBase. */
+export interface SitemapEntry {
+    url: string;
+    lastModified?: string | Date;
+    changeFrequency?: "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+    priority?: number;
+    /** Image urls on this page, for image search. */
+    images?: string[];
+    /** Translations of this page: language tag to url. */
+    alternates?: {
+        languages?: Record<string, string>;
+    };
+}
+/** A link in an llms.txt section. */
+export interface LlmsLink {
+    title: string;
+    url: string;
+    description?: string;
+}
+export interface LlmsSection {
+    title: string;
+    links: LlmsLink[];
+}
+/**
+ * The files a site describes itself with, each from a file beside the root
+ * layout and written the way Next writes them:
+ *
+ *     app/robots.ts   -> /robots.txt     default export returns MetadataRoute.Robots
+ *     app/sitemap.ts  -> /sitemap.xml    default export returns MetadataRoute.Sitemap
+ *     app/llms.ts     -> /llms.txt       default export returns MetadataRoute.Llms
+ *
+ * Each may return a string instead, served as written. A relative url in any
+ * of them is made absolute with the root layout's metadataBase.
+ */
+export declare namespace MetadataRoute {
+    type Robots = {
+        rules: RobotsRule | RobotsRule[];
+        sitemap?: string | string[];
+        host?: string;
+    };
+    type Sitemap = SitemapEntry[];
+    /** The llms.txt shape at llmstxt.org: a title, a summary, then sections of links. */
+    type Llms = {
+        title: string;
+        summary?: string;
+        /** Paragraphs after the summary, before the sections. */
+        details?: string | string[];
+        sections?: LlmsSection[];
+    };
+}