devframe 0.9.8 → 0.9.9

package/dist/{events-4daw0uK9.mjs → events-BV4Dj59a.mjs}

@@ -1,8 +1,8 @@
 //#region src/events.ts
 /**
-* Centralized registry of the core devframe event names — the node-side host
+* Centralized registry of the core devframe event names: the node-side host
 * bus events, the client RPC connection events, and the server→client
-* broadcast notifications — so these names live in one place instead of
+* broadcast notifications, so these names live in one place instead of
 * scattered string literals.
 *
 * **Keep this in sync with [`docs/content/8.references/3.events.md`](../../../docs/content/8.references/3.events.md)**

package/dist/{host-h3-fRbF9yor.mjs → host-h3-BJ4siyz7.mjs}

@@ -3,7 +3,7 @@ import { join } from "pathe";
 import { homedir } from "node:os";
 //#region src/node/host-h3.ts
 /**
-* h3-backed {@link DevframeHost} — used by the standalone CLI adapter.
+* h3-backed {@link DevframeHost}, used by the standalone CLI adapter.
 */
 function createH3DevframeHost(options) {
 	const workspaceRoot = options.workspaceRoot ?? process.cwd();

package/dist/in-page-channel/index.d.mts

@@ -1,11 +1,11 @@
-import { D as InferArgsType, E as Thenable, O as InferReturnType, T as RpcReturnSchema, i as RpcArgsSchema } from "../types-CMdPYhOx.mjs";
-import { k as SharedState, zt as EventEmitter } from "../context-CLF4-8Pp.mjs";
+import { D as InferArgsType, E as Thenable, O as InferReturnType, T as RpcReturnSchema, i as RpcArgsSchema } from "../types-Dq4i156u.mjs";
+import { Bt as EventEmitter, k as SharedState } from "../context-4AIVRLYF.mjs";
 import { BirpcReturn } from "birpc";
 //#region src/in-page-channel/types.d.ts
 /**
  * The shared contract of one in-page channel, declared once (usually in a
  * `shared/protocol.ts` both sides import) and passed to both endpoints as a
- * type parameter. Purely a type — the only runtime companion is the
+ * type parameter. Purely a type; the only runtime companion is the
  * channel-name constant declared next to it.
  */
 interface InPageChannelProtocol {
@@ -33,13 +33,13 @@ type FnReturn<F> = F extends ((...args: any[]) => infer R) ? Awaited<R> : never;
  */
 type ProtocolHandler<F> = F extends ((...args: any[]) => any) ? (...args: FnArgs<F>) => Thenable<FnReturn<F>> : never;
 /**
- * Types of an in-page channel function — `RpcFunctionType` minus the
+ * Types of an in-page channel function: `RpcFunctionType` minus the
  * server-only `static`: `event` is fire-and-forget (the only type valid for
  * fan-out), `action` performs, `query` requests data (the default).
  */
 type InPageFunctionType = 'action' | 'event' | 'query';
 /**
- * An in-page channel function definition — the `defineRpcFunction` authoring
+ * An in-page channel function definition: the `defineRpcFunction` authoring
  * shape (`name`, `type`, Standard-Schema `args`/`returns`,
  * `jsonSerializable`, `handler`) narrowed to the browser: there is no
  * `dump`/`snapshot`/`cacheable`/`agent`. When `jsonSerializable` is `true`,
@@ -122,7 +122,7 @@ interface InPageChannelCommonOptions {
   callTimeoutMs?: number;
   /**
    * Liveness heartbeat guarding against silently dead ports. Defaults to a
-   * 5s ping / 12s silence window; pass `false` to disable — on both
+   * 5s ping / 12s silence window; pass `false` to disable, on both
    * endpoints together.
    */
   heartbeat?: {
@@ -130,7 +130,7 @@ interface InPageChannelCommonOptions {
     timeoutMs?: number;
   } | false;
   /**
-   * Applied to each outgoing argument and handler result before posting —
+   * Applied to each outgoing argument and handler result before posting;
    * the place to unwrap framework reactivity (Vue `toRaw`, Solid `unwrap`)
    * into plain structured-cloneable values.
    */
@@ -160,7 +160,7 @@ interface ConnectPanelChannelOptions<Protocol extends InPageChannelProtocol = In
   window?: Window | false;
   /**
    * Windows the hello is posted to. Defaults to the panel's ancestor chain
-   * plus its `opener` — the places a same-tab page script can live. When
+   * plus its `opener`, the places a same-tab page script can live. When
    * empty and no `transport` is given, the endpoint stays `connecting` and
    * warns once.
    */
@@ -169,7 +169,7 @@ interface ConnectPanelChannelOptions<Protocol extends InPageChannelProtocol = In
   transport?: MessagePort;
   /**
    * Pin this panel to one page-script instance id. By default the panel
-   * auto-pairs with the most recent page script that answers — almost
+   * auto-pairs with the most recent page script that answers, almost
    * always "my own tab's page script".
    */
   instanceId?: string;
@@ -188,7 +188,7 @@ interface ConnectPanelChannelOptions<Protocol extends InPageChannelProtocol = In
   eventBufferLimit?: number;
 }
 /**
- * The channel shared-state accessor — mirrors `rpc.sharedState`, with the
+ * The channel shared-state accessor, mirroring `rpc.sharedState`, with the
  * page script playing the server's role as rendezvous and authority. The
  * page script's first `get` of a key must provide `initialValue`; a panel's
  * `get` without one resolves once the authority's first replay arrives.
@@ -260,7 +260,7 @@ interface PanelChannel<P extends InPageChannelProtocol> {
   /**
    * Resolves once connected. With `timeoutMs`, rejects with an
    * `InPageChannelError` (code `timeout`) when no page script answered in
-   * time — the hook for a "no page script found" fallback UI.
+   * time; the hook for a "no page script found" fallback UI.
    */
   whenConnected: (timeoutMs?: number) => Promise<void>;
   /**
@@ -308,7 +308,7 @@ declare class InPageChannelError extends Error {
  *
  * It listens for panel hellos on the host page's window and answers each
  * with a dedicated `MessageChannel` port (same-origin enforced both ways),
- * keeping one live peer per panel — dock iframe, popup, and Document-PiP
+ * keeping one live peer per panel: dock iframe, popup, and Document-PiP
  * panels all handshake the same way, and a panel reload is simply a new
  * handshake. No server is involved at any point.
  */
@@ -320,7 +320,7 @@ declare function createPageScriptChannel<P extends InPageChannelProtocol>(option
  *
  * The panel initiates: it posts a versioned hello to every window a
  * same-tab page script can live in (its ancestor chain and its `opener`),
- * retrying with backoff until one answers with a dedicated port — so boot
+ * retrying with backoff until one answers with a dedicated port, so boot
  * order never matters, and a reload of either side is just a re-handshake
  * (`WindowProxy` references survive navigations). While `connecting`,
  * outgoing calls and events are buffered; when no page script exists at all
@@ -331,7 +331,7 @@ declare function connectPanelChannel<P extends InPageChannelProtocol>(options: C
 //#endregion
 //#region src/in-page-channel/index.d.ts
 /**
- * Define one in-page channel function — the `defineRpcFunction` authoring
+ * Define one in-page channel function, the `defineRpcFunction` authoring
  * shape narrowed to the browser (see {@link InPageFunctionDefinition}).
  * Pure identity: it only types the definition. Functions live in
  * side-specific files and are passed to their endpoint via `functions`; the

package/dist/in-page-channel/index.mjs

@@ -1,14 +1,14 @@
-import { t as DEVFRAME_EVENTS } from "../events-4daw0uK9.mjs";
+import { t as DEVFRAME_EVENTS } from "../events-BV4Dj59a.mjs";
 import { createEventEmitter } from "../utils/events.mjs";
-import { t as createSharedState } from "../shared-state--sduc6Xi.mjs";
+import { t as createSharedState } from "../shared-state-CaxB1q0h.mjs";
 import { nanoid } from "../utils/nanoid.mjs";
 import { createBirpc } from "birpc";
 //#region src/in-page-channel/protocol.ts
 /**
 * Wire protocol of the in-page channel handshake and its port-level control
-* frames. The envelope is transport-neutral by design — it identifies the
+* frames. The envelope is transport-neutral by design: it identifies the
 * protocol (`channel` tag + `v`), the user channel (`name`), and the peers
-* (`panelId`, `instanceId`) — so a future cross-tab transport (e.g. a
+* (`panelId`, `instanceId`), so a future cross-tab transport (e.g. a
 * `BroadcastChannel`) can reuse it unchanged.
 */
 /** `postMessage` tag every handshake message carries. */
@@ -26,7 +26,7 @@ let memoryInstanceId;
 /**
 * The page context's instance id: one nanoid per browser tab, persisted in
 * `sessionStorage` so it survives page-script reloads. It scopes handshakes
-* when the same app is open in several tabs — a panel pinned to an instance
+* when the same app is open in several tabs, since a panel pinned to an instance
 * id ignores grants from every other tab's page script.
 */
 function resolveInstanceId(win) {
@@ -52,7 +52,7 @@ function resolveAllowedOrigins(allowedOrigins, win) {
 }
 /**
 * Default handshake targets of a panel: its ancestor chain plus its
-* `opener` — every same-tab window a page script can live in. `WindowProxy`
+* `opener`, every same-tab window a page script can live in. `WindowProxy`
 * references stay valid across navigations, so hellos posted to these reach
 * a page script even after the host page reloads.
 */
@@ -93,7 +93,7 @@ var InPageChannelError = class extends Error {
 };
 const warned = /* @__PURE__ */ new Set();
 /**
-* `console.warn` once per distinct message — handshake noise (foreign
+* `console.warn` once per distinct message, since handshake noise (foreign
 * origins, version mismatches, missing targets) repeats on every retry tick.
 */
 function warnOnce(message) {
@@ -102,19 +102,13 @@ function warnOnce(message) {
 		console.warn(`[devframe] ${message}`);
 	}
 }
-function jsonViolation(value, path, seen) {
-	if (value === null || typeof value === "boolean" || typeof value === "string") return void 0;
-	if (typeof value === "number") return Number.isFinite(value) ? void 0 : `${path} is ${value}`;
-	if (typeof value !== "object") return `${path} is ${value === void 0 ? "`undefined`" : `a ${typeof value}`}`;
-	if (seen.has(value)) return `${path} is circular`;
-	seen.add(value);
-	if (Array.isArray(value)) {
-		for (let i = 0; i < value.length; i++) {
-			const violation = jsonViolation(value[i], `${path}[${i}]`, seen);
-			if (violation) return violation;
-		}
-		return;
+function jsonArrayViolation(value, path, seen) {
+	for (let i = 0; i < value.length; i++) {
+		const violation = jsonViolation(value[i], `${path}[${i}]`, seen);
+		if (violation) return violation;
 	}
+}
+function jsonObjectViolation(value, path, seen) {
 	const proto = Object.getPrototypeOf(value);
 	if (proto !== Object.prototype && proto !== null) return `${path} is an instance of ${value.constructor?.name ?? "an exotic class"}`;
 	for (const [key, entry] of Object.entries(value)) {
@@ -122,10 +116,18 @@ function jsonViolation(value, path, seen) {
 		if (violation) return violation;
 	}
 }
+function jsonViolation(value, path, seen) {
+	if (value === null || typeof value === "boolean" || typeof value === "string") return void 0;
+	if (typeof value === "number") return Number.isFinite(value) ? void 0 : `${path} is ${value}`;
+	if (typeof value !== "object") return `${path} is ${value === void 0 ? "`undefined`" : `a ${typeof value}`}`;
+	if (seen.has(value)) return `${path} is circular`;
+	seen.add(value);
+	return Array.isArray(value) ? jsonArrayViolation(value, path, seen) : jsonObjectViolation(value, path, seen);
+}
 /**
 * Enforce a `jsonSerializable: true` contract: throws code
 * `not-serializable` naming the offending path when the value contains
-* anything strict JSON can't represent — surfacing the bug at the offending
+* anything strict JSON can't represent, surfacing the bug at the offending
 * call instead of a silent coercion later.
 */
 function assertJsonSerializable(value, what, functionName) {
@@ -181,14 +183,35 @@ function createLocalFunctionRegistry(codec) {
 	};
 }
 function wrapPostError(error) {
-	if (error instanceof DOMException && error.name === "DataCloneError") return new InPageChannelError("not-cloneable", `a payload could not be structured-cloned across the in-page channel: ${error.message}. Strip non-cloneable values (functions, DOM nodes, framework reactivity proxies) before sending — declare the function \`jsonSerializable: true\` for a precise error, or provide a \`serialize\` hook.`, { cause: error });
+	if (error instanceof DOMException && error.name === "DataCloneError") return new InPageChannelError("not-cloneable", `a payload could not be structured-cloned across the in-page channel: ${error.message}. Strip non-cloneable values (functions, DOM nodes, framework reactivity proxies) before sending: declare the function \`jsonSerializable: true\` for a precise error, or provide a \`serialize\` hook.`, { cause: error });
 	return error;
 }
 function attachChannelPort(port, options) {
 	let birpcHandler;
 	let disposed = false;
 	const attached = {
-		rpc: void 0,
+		rpc: createBirpc({}, {
+			post: (data) => {
+				try {
+					port.postMessage(data);
+				} catch (error) {
+					throw wrapPostError(error);
+				}
+			},
+			on: (fn) => {
+				birpcHandler = fn;
+			},
+			off: () => {
+				birpcHandler = void 0;
+			},
+			/**
+			* Deadlines live at the endpoint layer (`withCallDeadline`) with
+			* status-aware errors; birpc's own timer stays off.
+			*/
+			timeout: -1,
+			proxify: false,
+			resolver: (name, resolved) => resolved ?? options.resolveLocal(name)
+		}),
 		lastActivity: Date.now(),
 		postControl(kind) {
 			try {
@@ -222,24 +245,6 @@ function attachChannelPort(port, options) {
 	function onClose() {
 		options.onPeerClosed();
 	}
-	attached.rpc = createBirpc({}, {
-		post: (data) => {
-			try {
-				port.postMessage(data);
-			} catch (error) {
-				throw wrapPostError(error);
-			}
-		},
-		on: (fn) => {
-			birpcHandler = fn;
-		},
-		off: () => {
-			birpcHandler = void 0;
-		},
-		timeout: -1,
-		proxify: false,
-		resolver: (name, resolved) => resolved ?? options.resolveLocal(name)
-	});
 	port.addEventListener("message", onMessage);
 	port.addEventListener("close", onClose);
 	port.start?.();
@@ -265,7 +270,7 @@ function withCallDeadline(promise, ms, describeTimeout) {
 //#endregion
 //#region src/in-page-channel/state.ts
 /**
-* The channel shared-state layer — `createSharedState` pumped over the
+* The channel shared-state layer: `createSharedState` pumped over the
 * in-page channel, mirroring the RPC shared-state wire design with the page
 * script playing the server's role: it owns the canonical value, replays a
 * snapshot to every (re)subscribing panel, and fans syncId-deduplicated
@@ -290,7 +295,7 @@ function createPageScriptStateHost(peers) {
 		get: async (key, options) => {
 			const existing = states.get(key);
 			if (existing) return existing;
-			if (options?.initialValue === void 0) throw new InPageChannelError("state-uninitialized", `in-page shared state "${key}" was accessed before initialization — the page script is the authority, so its first \`sharedState.get("${key}")\` must provide \`initialValue\``);
+			if (options?.initialValue === void 0) throw new InPageChannelError("state-uninitialized", `in-page shared state "${key}" was accessed before initialization; the page script is the authority, so its first \`sharedState.get("${key}")\` must provide \`initialValue\``);
 			const state = createSharedState({
 				initialValue: options.initialValue,
 				enablePatches: true
@@ -337,7 +342,7 @@ function createPanelStateHost(options) {
 	const seedWaiters = /* @__PURE__ */ new Map();
 	/**
 	* SyncIds of snapshot adoptions. Adopting the authority's replay must not
-	* echo straight back up as a `set` — the authority already has the value.
+	* echo straight back up as a `set`; the authority already has the value.
 	*/
 	const adoptedSyncIds = /* @__PURE__ */ new Set();
 	function markSeeded(key) {
@@ -381,6 +386,10 @@ function createPanelStateHost(options) {
 			const existing = states.get(key);
 			if (existing) return Promise.resolve(existing);
 			const state = createSharedState({
+				/**
+				* Without an initial value the state stays empty until the
+				* authority's first replay resolves the returned promise.
+				*/
 				initialValue: getOptions?.initialValue,
 				enablePatches: true
 			});
@@ -420,7 +429,7 @@ function createPanelStateHost(options) {
 *
 * It listens for panel hellos on the host page's window and answers each
 * with a dedicated `MessageChannel` port (same-origin enforced both ways),
-* keeping one live peer per panel — dock iframe, popup, and Document-PiP
+* keeping one live peer per panel: dock iframe, popup, and Document-PiP
 * panels all handshake the same way, and a panel reload is simply a new
 * handshake. No server is involved at any point.
 */
@@ -513,7 +522,7 @@ function createPageScriptChannel(options) {
 		const data = event.data;
 		if (!isHandshakeMessage(data) || data.kind !== "hello" || data.name !== name) return;
 		if (data.v !== 1) {
-			warnOnce(`in-page channel "${name}": ignoring a hello with protocol version ${data.v} (this side speaks 1) — align the devframe versions of the page script and the panel`);
+			warnOnce(`in-page channel "${name}": ignoring a hello with protocol version ${data.v} (this side speaks 1); align the devframe versions of the page script and the panel`);
 			return;
 		}
 		if (!allowedOrigins.includes("*") && !allowedOrigins.includes(event.origin)) {
@@ -583,7 +592,7 @@ const DEFAULT_EVENT_BUFFER_LIMIT = 64;
 *
 * The panel initiates: it posts a versioned hello to every window a
 * same-tab page script can live in (its ancestor chain and its `opener`),
-* retrying with backoff until one answers with a dedicated port — so boot
+* retrying with backoff until one answers with a dedicated port, so boot
 * order never matters, and a reload of either side is just a re-handshake
 * (`WindowProxy` references survive navigations). While `connecting`,
 * outgoing calls and events are buffered; when no page script exists at all
@@ -648,7 +657,7 @@ function connectPanelChannel(options) {
 			eventBuffer.shift();
 			if (!droppedEventsWarned) {
 				droppedEventsWarned = true;
-				console.warn(`[devframe] in-page channel "${name}": event buffer overflowed while connecting — oldest events are being dropped (limit ${eventBufferLimit})`);
+				console.warn(`[devframe] in-page channel "${name}": event buffer overflowed while connecting, so the oldest events are being dropped (limit ${eventBufferLimit})`);
 			}
 		}
 		eventBuffer.push({
@@ -657,7 +666,7 @@ function connectPanelChannel(options) {
 		});
 	}
 	function enqueueCall(method, args) {
-		if (status === "closed") return Promise.reject(new InPageChannelError("closed", `in-page channel "${name}": call "${method}" rejected — the channel is closed`));
+		if (status === "closed") return Promise.reject(new InPageChannelError("closed", `in-page channel "${name}": call "${method}" rejected because the channel is closed`));
 		return withCallDeadline(new Promise((resolve, reject) => {
 			const run = () => {
 				attached.rpc.$call(method, ...args).then((result) => resolve(deserializeResult(codec, result)), reject);
@@ -667,7 +676,7 @@ function connectPanelChannel(options) {
 				run,
 				reject
 			});
-		}), callTimeoutMs, () => `in-page channel "${name}": call "${method}" timed out after ${callTimeoutMs}ms (status: ${status}${status === "connecting" ? " — is the page script loaded?" : ""})`);
+		}), callTimeoutMs, () => `in-page channel "${name}": call "${method}" timed out after ${callTimeoutMs}ms (status: ${status}${status === "connecting" ? "; is the page script loaded?" : ""})`);
 	}
 	function adoptPort(port, info) {
 		attached?.dispose({
@@ -712,7 +721,7 @@ function connectPanelChannel(options) {
 		stopTimers();
 		setStatus("connecting");
 		if (canHandshake) startHelloLoop();
-		else warnOnce(`in-page channel "${name}": transport lost (${reason}) and the panel has no handshake targets — staying disconnected`);
+		else warnOnce(`in-page channel "${name}": transport lost (${reason}) and the panel has no handshake targets, so it stays disconnected`);
 	}
 	function startHelloLoop() {
 		if (helloTimer || !canHandshake || status !== "connecting") return;
@@ -739,7 +748,7 @@ function connectPanelChannel(options) {
 		const data = event.data;
 		if (!isHandshakeMessage(data) || data.kind !== "grant" || data.name !== name || data.panelId !== panelId) return;
 		if (data.v !== 1) {
-			warnOnce(`in-page channel "${name}": ignoring a grant with protocol version ${data.v} (this side speaks 1) — align the devframe versions of the page script and the panel`);
+			warnOnce(`in-page channel "${name}": ignoring a grant with protocol version ${data.v} (this side speaks 1); align the devframe versions of the page script and the panel`);
 			return;
 		}
 		if (!allowedOrigins.includes("*") && !allowedOrigins.includes(event.origin)) {
@@ -753,7 +762,7 @@ function connectPanelChannel(options) {
 	win?.addEventListener("message", onWindowMessage);
 	if (options.transport) adoptPort(options.transport);
 	else if (canHandshake) startHelloLoop();
-	else warnOnce(`in-page channel "${name}": the panel has no handshake targets (not embedded, no opener) and no transport — calls will buffer until a transport appears or the channel is closed`);
+	else warnOnce(`in-page channel "${name}": the panel has no handshake targets (not embedded, no opener) and no transport, so calls will buffer until a transport appears or the channel is closed`);
 	return {
 		name,
 		get status() {
@@ -779,7 +788,7 @@ function connectPanelChannel(options) {
 					const index = connectedWaiters.indexOf(waiter);
 					if (index >= 0) {
 						connectedWaiters.splice(index, 1);
-						reject(new InPageChannelError("timeout", `in-page channel "${name}": no page script answered within ${timeoutMs}ms — it may not be loaded in this context (render a fallback state)`));
+						reject(new InPageChannelError("timeout", `in-page channel "${name}": no page script answered within ${timeoutMs}ms; it may not be loaded in this context (render a fallback state)`));
 					}
 				}, timeoutMs);
 			});
@@ -808,7 +817,7 @@ function connectPanelChannel(options) {
 //#endregion
 //#region src/in-page-channel/index.ts
 /**
-* Define one in-page channel function — the `defineRpcFunction` authoring
+* Define one in-page channel function, the `defineRpcFunction` authoring
 * shape narrowed to the browser (see {@link InPageFunctionDefinition}).
 * Pure identity: it only types the definition. Functions live in
 * side-specific files and are passed to their endpoint via `functions`; the

package/dist/{index-BzyopqxV.d.mts → index-pIVt92jP.d.mts}

@@ -1,4 +1,4 @@
-import { C as RpcFunctionType, S as RpcFunctionSetupResult, T as RpcReturnSchema, _ as RpcFunctionDefinition, i as RpcArgsSchema, v as RpcFunctionDefinitionAny, w as RpcFunctionsCollector } from "./types-CMdPYhOx.mjs";
+import { C as RpcFunctionType, S as RpcFunctionSetupResult, T as RpcReturnSchema, _ as RpcFunctionDefinition, i as RpcArgsSchema, v as RpcFunctionDefinitionAny, w as RpcFunctionsCollector } from "./types-Dq4i156u.mjs";
 //#region src/rpc/cache.d.ts
 interface RpcCacheOptions {
   functions: string[];
@@ -66,7 +66,7 @@ declare function getRpcHandler<NAME extends string, TYPE extends RpcFunctionType
  *
  * birpc envelopes always start with `{`, so a leading byte that is not
  * `s` is unambiguously JSON. Each direction independently chooses its
- * encoding from local definitions — request and response are not
+ * encoding from local definitions; request and response are not
  * coupled by a mirror rule.
  */
 declare const STRUCTURED_CLONE_PREFIX = "s:";
@@ -78,16 +78,16 @@ declare const STRUCTURED_CLONE_PREFIX = "s:";
  * instances, or `undefined` inside an array (silently becomes `null`).
  *
  * Native pass-throughs (no extra work needed):
- *   - circular references — `JSON.stringify` raises `TypeError`.
- *   - `BigInt` at top level — caught here for a friendlier error path.
+ *   - circular references: `JSON.stringify` raises `TypeError`.
+ *   - `BigInt` at top level: caught here for a friendlier error path.
  *
  * Lenient cases (allowed without throwing):
- *   - `undefined` as an object property — legitimate optional field;
+ *   - `undefined` as an object property: legitimate optional field;
  *     JSON.stringify just omits it.
- *   - `undefined` at the root — legitimate "action returned nothing".
- *   - `Symbol` / `Function` values — semantically "drop me" in JSON.
+ *   - `undefined` at the root: legitimate "action returned nothing".
+ *   - `Symbol` / `Function` values: semantically "drop me" in JSON.
  *
- * `fnName` is used only for the diagnostic message — pass the RPC
+ * `fnName` is used only for the diagnostic message; pass the RPC
  * function name when calling from a wire serializer / dump writer so
  * the error points at the offending function.
  */
@@ -110,7 +110,7 @@ declare function validateRpcArgs(name: string, argsSchema: RpcArgsSchema | undef
 /**
  * Validate a handler's resolved return value against its declared schema.
  * Throws `DF0039` when the value fails the schema, otherwise returns the
- * original value unchanged (guard-only, never rewriting the payload — see
+ * original value unchanged (guard-only, never rewriting the payload; see
  * {@link validateRpcArgs}). Passes through when no return schema is set.
  *
  * @internal

package/dist/{index-D3k0BIhe.d.mts → index-pKl67H6w.d.mts}

@@ -1,5 +1,5 @@
-import { k as SharedState, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "./context-CLF4-8Pp.mjs";
-import { n as InternalAnonymousAuthStorage } from "./context-DftYyXaR.mjs";
+import { k as SharedState, o as DevframeNodeContext, s as DevframeNodeRpcSession } from "./context-4AIVRLYF.mjs";
+import { n as InternalAnonymousAuthStorage } from "./context-rgBSPFHS.mjs";
 //#region src/node/auth/revoke.d.ts
 /**
  * Flip `isTrusted` to false on any live WS clients connected with `token`
@@ -29,13 +29,13 @@ declare function getTempAuthCode(): string;
 declare function refreshTempAuthCode(): string;
 /**
  * Build a "magic link" authentication URL that embeds a one-time code (OTP) in
- * the URL **fragment**. Opening it authenticates the client without typing —
+ * the URL **fragment**. Opening it authenticates the client without typing;
  * print it on startup (devframe stays headless, so the host prints its own
  * banner). Defaults to the current code; the link is subject to the same TTL.
  *
  * The code rides the fragment (`#devframe_otp=…`), not the query string, so it
  * is never sent to the server, written to an access log, or leaked in a
- * `Referer` header — the browser client reads it locally (see
+ * `Referer` header; the browser client reads it locally (see
  * `consumeOtpFromUrl`). Any existing fragment parameters are preserved.
  */
 declare function buildOtpAuthUrl(baseUrl: string, code?: string): string;

package/dist/index.d.mts

@@ -1,13 +1,13 @@
-import "./index-BzyopqxV.mjs";
-import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-CMdPYhOx.mjs";
-import { d as DevframeRpcConnection, f as DevframeRpcConnectionRequest, p as DevframeRpcTransportKind, u as DevframeNodeRpcSessionMeta } from "./ws-server-VyHlanzy.mjs";
-import { $ as DevframeServicesHost, At as AgentResource, B as DevframeSetupInfo, Bt as EventUnsubscribe, F as DevframeDefinition, Ft as AgentToolProvider, G as McpRouteOptions, H as DevframeSnapshotRpcInputs, I as DevframeDeploymentKind, It as AgentToolProviderHandle, J as DevframeServiceId, K as DevframeServiceDefinition, L as DevframeDockDefaults, Lt as DevframeAgentHost, Mt as AgentResourceInput, Nt as AgentTool, Ot as AgentHandle, P as DevframeCliOptions, Pt as AgentToolInput, Q as DevframeServiceScopeOf, R as DevframeDuplicationStrategy, Rt as DevframeAgentHostEvents, St as DevframeDiagnosticsLogger, U as DevframeSseOptions, V as DevframeSnapshotRpcEntry, Vt as EventsMap, W as DevframeWsOptions, X as DevframeServiceMeta, Y as DevframeServiceInput, Z as DevframeServiceOf, _t as DevframeRpcServerFunctions, a as DevframeConnectionConfigsRegistry, at as DevframeScopedStreamingHost, bt as DevframeStorageScope, c as RpcBroadcastOptions, ct as DevframeSettingsStore, d as RpcSharedStateHost, dt as ScopedRpcFn, et as DevframeServicesRegistry, f as RpcStreamingChannel, ft as ScopedServerFunctions, gt as DevframeRpcClientFunctions, ht as DevframeViewHost, i as DevframeCapabilities, it as DevframeScopedNodeRpc, jt as AgentResourceContent, kt as AgentManifest, l as RpcFunctionsHost, lt as ScopedBroadcastOptions, m as RpcStreamingHost, mt as SettingsForNamespace, n as ConnectionMetaSse, nt as DevframeServicesState, o as DevframeNodeContext, ot as DevframeSettings, p as RpcStreamingChannelOptions, pt as ScopedSharedStates, q as DevframeServiceDescriptor, r as ConnectionMetaWebsocket, rt as DevframeScopedNodeContext, s as DevframeNodeRpcSession, st as DevframeSettingsRegistry, t as ConnectionMeta, tt as DevframeServicesScopeRegistry, u as RpcSharedStateGetOptions, ut as ScopedClientFunctions, vt as DevframeRpcSharedStates, xt as DevframeDiagnosticsHost, yt as DevframeHost, z as DevframeRpcOptions, zt as EventEmitter } from "./context-CLF4-8Pp.mjs";
-import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "./remote-assets-B13_vRkJ.mjs";
-import { i as DevframeDefineDiagnosticsOptions } from "./nostics-SPGDgHEP.mjs";
+import "./index-pIVt92jP.mjs";
+import { C as RpcFunctionType, T as RpcReturnSchema, _ as RpcFunctionDefinition, g as RpcFunctionAgentOptions, i as RpcArgsSchema } from "./types-Dq4i156u.mjs";
+import { c as DevframeNodeRpcSessionMeta, d as DevframeRpcTransportKind, l as DevframeRpcConnection, u as DevframeRpcConnectionRequest } from "./ws-server-D2nv68Hg.mjs";
+import { $ as DevframeServiceScopeOf, At as AgentManifest, B as DevframeSetupInfo, Bt as EventEmitter, Ct as DevframeDiagnosticsLogger, F as DevframeDefinition, Ft as AgentToolInput, G as McpAuthorization, H as DevframeSnapshotRpcInputs, Ht as EventsMap, I as DevframeDeploymentKind, It as AgentToolProvider, J as DevframeServiceDescriptor, K as McpRouteOptions, L as DevframeDockDefaults, Lt as AgentToolProviderHandle, Mt as AgentResourceContent, Nt as AgentResourceInput, P as DevframeCliOptions, Pt as AgentTool, Q as DevframeServiceOf, R as DevframeDuplicationStrategy, Rt as DevframeAgentHost, St as DevframeDiagnosticsHost, U as DevframeSseOptions, V as DevframeSnapshotRpcEntry, Vt as EventUnsubscribe, W as DevframeWsOptions, X as DevframeServiceInput, Y as DevframeServiceId, Z as DevframeServiceMeta, _t as DevframeRpcClientFunctions, a as DevframeConnectionConfigsRegistry, at as DevframeScopedNodeRpc, bt as DevframeHost, c as RpcBroadcastOptions, ct as DevframeSettingsRegistry, d as RpcSharedStateHost, dt as ScopedClientFunctions, et as DevframeServicesHost, f as RpcStreamingChannel, ft as ScopedRpcFn, gt as DevframeViewHost, ht as SettingsForNamespace, i as DevframeCapabilities, it as DevframeScopedNodeContext, jt as AgentResource, kt as AgentHandle, l as RpcFunctionsHost, lt as DevframeSettingsStore, m as RpcStreamingHost, mt as ScopedSharedStates, n as ConnectionMetaSse, nt as DevframeServicesScopeRegistry, o as DevframeNodeContext, ot as DevframeScopedStreamingHost, p as RpcStreamingChannelOptions, pt as ScopedServerFunctions, q as DevframeServiceDefinition, r as ConnectionMetaWebsocket, rt as DevframeServicesState, s as DevframeNodeRpcSession, st as DevframeSettings, t as ConnectionMeta, tt as DevframeServicesRegistry, u as RpcSharedStateGetOptions, ut as ScopedBroadcastOptions, vt as DevframeRpcServerFunctions, xt as DevframeStorageScope, yt as DevframeRpcSharedStates, z as DevframeRpcOptions, zt as DevframeAgentHostEvents } from "./context-4AIVRLYF.mjs";
+import { a as RemoteAssetsStore, i as RemoteAssetsProviderCustom, n as RemoteAssetsErrorMessage, o as StaticAssetsSource, r as RemoteAssetsProvider, t as RemoteAssets } from "./remote-assets-eBvSKZMS.mjs";
+import { i as DevframeDefineDiagnosticsOptions } from "./nostics-0sKe5HIj.mjs";
 //#region src/define.d.ts
 declare const defineRpcFunction: <NAME extends string, TYPE extends RpcFunctionType, ARGS extends any[], RETURN = void, const AS extends RpcArgsSchema | undefined = undefined, const RS extends RpcReturnSchema | undefined = undefined>(definition: RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeNodeContext>) => RpcFunctionDefinition<NAME, TYPE, ARGS, RETURN, AS, RS, DevframeNodeContext>;
 /**
- * Identity helper that types a devframe definition — the primary authoring
+ * Identity helper that types a devframe definition, the primary authoring
  * entry point. Import it from the package root: `import { defineDevframe } from 'devframe'`.
  */
 declare function defineDevframe(d: DevframeDefinition): DevframeDefinition;
@@ -18,4 +18,4 @@ declare function defineDevframe(d: DevframeDefinition): DevframeDefinition;
  */
 declare function resolveClientAssets(d: DevframeDefinition): StaticAssetsSource | undefined;
 //#endregion
-export { type AgentHandle, type AgentManifest, type AgentResource, type AgentResourceContent, type AgentResourceInput, type AgentTool, type AgentToolInput, type AgentToolProvider, type AgentToolProviderHandle, type ConnectionMeta, type ConnectionMetaSse, type ConnectionMetaWebsocket, type DevframeAgentHost, type DevframeAgentHostEvents, type DevframeCapabilities, type DevframeCliOptions, type DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, type DevframeDefinition, type DevframeDeploymentKind, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockDefaults, type DevframeDuplicationStrategy, type DevframeHost, type DevframeNodeContext, type DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, type DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, type DevframeRpcOptions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeRpcTransportKind, type DevframeScopedNodeContext, type DevframeScopedNodeRpc, type DevframeScopedStreamingHost, type DevframeServiceDefinition, type DevframeServiceDescriptor, type DevframeServiceId, type DevframeServiceInput, type DevframeServiceMeta, type DevframeServiceOf, type DevframeServiceScopeOf, type DevframeServicesHost, type DevframeServicesRegistry, type DevframeServicesScopeRegistry, type DevframeServicesState, type DevframeSettings, type DevframeSettingsRegistry, type DevframeSettingsStore, type DevframeSetupInfo, type DevframeSnapshotRpcEntry, type DevframeSnapshotRpcInputs, type DevframeSseOptions, type DevframeStorageScope, type DevframeViewHost, type DevframeWsOptions, type EventEmitter, type EventUnsubscribe, type EventsMap, type McpRouteOptions, type RemoteAssets, type RemoteAssetsErrorMessage, type RemoteAssetsProvider, type RemoteAssetsProviderCustom, type RemoteAssetsStore, type RpcBroadcastOptions, type RpcFunctionAgentOptions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type ScopedBroadcastOptions, type ScopedClientFunctions, type ScopedRpcFn, type ScopedServerFunctions, type ScopedSharedStates, type SettingsForNamespace, type StaticAssetsSource, defineDevframe, defineRpcFunction, resolveClientAssets };
+export { type AgentHandle, type AgentManifest, type AgentResource, type AgentResourceContent, type AgentResourceInput, type AgentTool, type AgentToolInput, type AgentToolProvider, type AgentToolProviderHandle, type ConnectionMeta, type ConnectionMetaSse, type ConnectionMetaWebsocket, type DevframeAgentHost, type DevframeAgentHostEvents, type DevframeCapabilities, type DevframeCliOptions, type DevframeConnectionConfigsRegistry, type DevframeDefineDiagnosticsOptions, type DevframeDefinition, type DevframeDeploymentKind, type DevframeDiagnosticsHost, type DevframeDiagnosticsLogger, type DevframeDockDefaults, type DevframeDuplicationStrategy, type DevframeHost, type DevframeNodeContext, type DevframeNodeRpcSession, type DevframeNodeRpcSessionMeta, type DevframeRpcClientFunctions, type DevframeRpcConnection, type DevframeRpcConnectionRequest, type DevframeRpcOptions, type DevframeRpcServerFunctions, type DevframeRpcSharedStates, type DevframeRpcTransportKind, type DevframeScopedNodeContext, type DevframeScopedNodeRpc, type DevframeScopedStreamingHost, type DevframeServiceDefinition, type DevframeServiceDescriptor, type DevframeServiceId, type DevframeServiceInput, type DevframeServiceMeta, type DevframeServiceOf, type DevframeServiceScopeOf, type DevframeServicesHost, type DevframeServicesRegistry, type DevframeServicesScopeRegistry, type DevframeServicesState, type DevframeSettings, type DevframeSettingsRegistry, type DevframeSettingsStore, type DevframeSetupInfo, type DevframeSnapshotRpcEntry, type DevframeSnapshotRpcInputs, type DevframeSseOptions, type DevframeStorageScope, type DevframeViewHost, type DevframeWsOptions, type EventEmitter, type EventUnsubscribe, type EventsMap, type McpAuthorization, type McpRouteOptions, type RemoteAssets, type RemoteAssetsErrorMessage, type RemoteAssetsProvider, type RemoteAssetsProviderCustom, type RemoteAssetsStore, type RpcBroadcastOptions, type RpcFunctionAgentOptions, type RpcFunctionsHost, type RpcSharedStateGetOptions, type RpcSharedStateHost, type RpcStreamingChannel, type RpcStreamingChannelOptions, type RpcStreamingHost, type ScopedBroadcastOptions, type ScopedClientFunctions, type ScopedRpcFn, type ScopedServerFunctions, type ScopedSharedStates, type SettingsForNamespace, type StaticAssetsSource, defineDevframe, defineRpcFunction, resolveClientAssets };

package/dist/index.mjs

@@ -1,9 +1,9 @@
 import { t as createDefineWrapperWithContext } from "./define-BLWPsH6y.mjs";
-import { t as resolveClientAssets$1 } from "./client-assets-C7SXgTWY.mjs";
+import { t as resolveClientAssets$1 } from "./client-assets-DNdhagGm.mjs";
 //#region src/define.ts
 const defineRpcFunction = createDefineWrapperWithContext();
 /**
-* Identity helper that types a devframe definition — the primary authoring
+* Identity helper that types a devframe definition, the primary authoring
 * entry point. Import it from the package root: `import { defineDevframe } from 'devframe'`.
 */
 function defineDevframe(d) {

package/dist/{instance-registry-BjlMQbFB.mjs → instance-registry-C7-41RSp.mjs}

@@ -1,5 +1,5 @@
 import { n as __exportAll } from "./rolldown-runtime-B4iAMlE-.mjs";
-import { t as diagnostics } from "./diagnostics-BXWW3VK-.mjs";
+import { t as diagnostics } from "./diagnostics-BMfN8mb1.mjs";
 import process from "node:process";
 import { join } from "pathe";
 import { mkdirSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync } from "node:fs";
@@ -16,9 +16,9 @@ const DEVFRAME_INSTANCES_DIR_ENV = "DEVFRAME_INSTANCES_DIR";
 /** Environment variable disabling instance registration entirely. */
 const DEVFRAME_DISABLE_INSTANCE_REGISTRY_ENV = "DEVFRAME_DISABLE_INSTANCE_REGISTRY";
 /**
-* Resolve the registry directory: `~/.devframe/instances/` by default —
-* the framework's own global dir, deliberately outside the per-app
-* `~/.<appName>/devframe/` storage convention since the registry spans apps —
+* Resolve the registry directory: `~/.devframe/instances/` by default
+* (the framework's own global dir, deliberately outside the per-app
+* `~/.<appName>/devframe/` storage convention since the registry spans apps),
 * overridable via `DEVFRAME_INSTANCES_DIR`.
 */
 function resolveInstancesDir(override) {
@@ -40,7 +40,7 @@ function isRegistryDisabled() {
 * The record is written atomically to `<dir>/<pid>-<port>.json` and removed
 * by {@link DevframeInstanceRegistration.unregister}. Records surviving a
 * crash are pruned by readers whose liveness probe fails. Registration never
-* throws — a write failure degrades to a coded warning (`DF0045`), since a
+* throws; a write failure degrades to a coded warning (`DF0045`), since a
 * dev server must not die over discovery metadata.
 */
 function registerDevframeInstance(record, options = {}) {
@@ -75,7 +75,7 @@ function registerDevframeInstance(record, options = {}) {
 }
 /**
 * Read every record in the registry directory, dropping unparseable files.
-* Liveness is the caller's concern — see {@link probeDevframeInstance}.
+* Liveness is the caller's concern; see {@link probeDevframeInstance}.
 */
 function readDevframeInstances(options = {}) {
 	const dir = resolveInstancesDir(options.instancesDir);
@@ -94,8 +94,8 @@ function readDevframeInstances(options = {}) {
 }
 /**
 * Dialable-origin candidates for a recorded origin. A `localhost` bind is
-* ambiguous — the server may listen on `127.0.0.1`, `::1`, or both, and
-* HTTP clients differ in which family they try — so probe the explicit
+* ambiguous: the server may listen on `127.0.0.1`, `::1`, or both, and
+* HTTP clients differ in which family they try, so probe the explicit
 * addresses too and adopt whichever answers.
 */
 function originCandidates(origin) {