void 0.20.2 → 0.21.0

package/dist/head-D_QRR5Yd.mjs

@@ -0,0 +1,112 @@
+//#region src/pages/head.ts
+/**
+* Merge head descriptors with precedence: page > middleware > config.
+*
+* - `title`: page wins; `titleTemplate` from config wraps it (`%s` replaced)
+* - `meta`: page overrides entries with same `name`/`property`; others appended
+* - `link`/`script`: concatenated (config first, then middleware, then page)
+* - `htmlAttrs`/`bodyAttrs`: shallow merge, page wins conflicts
+*/
+function resolveHead(configHead, middlewareHead, pageHead) {
+	if (!configHead && !middlewareHead && !pageHead) return;
+	const result = {};
+	const title = pageHead?.title ?? middlewareHead?.title ?? configHead?.title;
+	if (title !== void 0) {
+		const template = configHead?.titleTemplate;
+		result.title = template ? template.replace("%s", title) : title;
+	}
+	const metaMap = /* @__PURE__ */ new Map();
+	const metaOrder = [];
+	for (const layer of [
+		configHead,
+		middlewareHead,
+		pageHead
+	]) {
+		if (!layer?.meta) continue;
+		for (const entry of layer.meta) {
+			const key = entry.charset ? "charset" : entry.property ? `property:${entry.property}` : `name:${entry.name ?? ""}`;
+			if (!metaMap.has(key)) metaOrder.push(key);
+			metaMap.set(key, entry);
+		}
+	}
+	if (metaMap.size > 0) result.meta = metaOrder.map((key) => metaMap.get(key));
+	const links = [];
+	for (const layer of [
+		configHead,
+		middlewareHead,
+		pageHead
+	]) if (layer?.link) links.push(...layer.link);
+	if (links.length > 0) result.link = links;
+	const scripts = [];
+	for (const layer of [
+		configHead,
+		middlewareHead,
+		pageHead
+	]) if (layer?.script) scripts.push(...layer.script);
+	if (scripts.length > 0) result.script = scripts;
+	const htmlAttrs = {};
+	let hasHtmlAttrs = false;
+	for (const layer of [
+		configHead,
+		middlewareHead,
+		pageHead
+	]) if (layer?.htmlAttrs) {
+		Object.assign(htmlAttrs, layer.htmlAttrs);
+		hasHtmlAttrs = true;
+	}
+	if (hasHtmlAttrs) result.htmlAttrs = htmlAttrs;
+	const bodyAttrs = {};
+	let hasBodyAttrs = false;
+	for (const layer of [
+		configHead,
+		middlewareHead,
+		pageHead
+	]) if (layer?.bodyAttrs) {
+		Object.assign(bodyAttrs, layer.bodyAttrs);
+		hasBodyAttrs = true;
+	}
+	if (hasBodyAttrs) result.bodyAttrs = bodyAttrs;
+	if (result.title === void 0 && !result.meta && !result.link && !result.script && !result.htmlAttrs && !result.bodyAttrs) return;
+	return result;
+}
+function escapeHtml(s) {
+	return s.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+}
+/** Serialize a HeadDescriptor to HTML tags for injection into `<head>`. */
+function renderHeadToString(head) {
+	const parts = [];
+	if (head.title !== void 0) parts.push(`<title>${escapeHtml(head.title)}</title>`);
+	if (head.meta) for (const entry of head.meta) {
+		const attrs = [];
+		if (entry.charset) attrs.push(`charset="${escapeHtml(entry.charset)}"`);
+		if (entry.name) attrs.push(`name="${escapeHtml(entry.name)}"`);
+		if (entry.property) attrs.push(`property="${escapeHtml(entry.property)}"`);
+		if (entry.content !== void 0) attrs.push(`content="${escapeHtml(entry.content)}"`);
+		parts.push(`<meta ${attrs.join(" ")}>`);
+	}
+	if (head.link) for (const entry of head.link) {
+		const attrs = Object.entries(entry).filter(([, value]) => value != null).map(([key, value]) => `${key}="${escapeHtml(value)}"`).join(" ");
+		parts.push(`<link ${attrs}>`);
+	}
+	if (head.script) for (const entry of head.script) {
+		const { innerHTML, ...rest } = entry;
+		const attrs = Object.entries(rest).filter(([, value]) => value != null).map(([key, value]) => `${key}="${escapeHtml(value)}"`).join(" ");
+		if (innerHTML) parts.push(`<script${attrs ? " " + attrs : ""}>${innerHTML}<\/script>`);
+		else if (attrs) parts.push(`<script ${attrs}><\/script>`);
+	}
+	return parts.join("\n");
+}
+/** Serialize htmlAttrs to an attribute string (includes leading space). */
+function renderHtmlAttrs(head) {
+	if (!head.htmlAttrs) return "";
+	const attrs = Object.entries(head.htmlAttrs).map(([key, value]) => `${key}="${escapeHtml(value)}"`).join(" ");
+	return attrs ? " " + attrs : "";
+}
+/** Serialize bodyAttrs to an attribute string (includes leading space). */
+function renderBodyAttrs(head) {
+	if (!head.bodyAttrs) return "";
+	const attrs = Object.entries(head.bodyAttrs).map(([key, value]) => `${key}="${escapeHtml(value)}"`).join(" ");
+	return attrs ? " " + attrs : "";
+}
+//#endregion
+export { resolveHead as i, renderHeadToString as n, renderHtmlAttrs as r, renderBodyAttrs as t };

package/dist/head-client-DzmJGN4C.mjs

@@ -0,0 +1,90 @@
+//#region src/pages/head-client.ts
+const ATTR = "data-void-head";
+function elementDescriptorSignature(descriptor) {
+	const attrs = Object.entries(descriptor.attrs).sort(([a], [b]) => a.localeCompare(b));
+	return `${encodeURIComponent(descriptor.tag)}:${attrs.map(([key, value]) => `${encodeURIComponent(key)}=${encodeURIComponent(value)}`).join("&")}`;
+}
+function elementSignature(el) {
+	const attrs = {};
+	for (const attr of Array.from(el.attributes)) if (attr.name !== ATTR) attrs[attr.name] = attr.value;
+	return elementDescriptorSignature({
+		tag: el.tagName.toLowerCase(),
+		attrs
+	});
+}
+function createHeadElement(descriptor) {
+	const el = document.createElement(descriptor.tag);
+	for (const [key, value] of Object.entries(descriptor.attrs)) el.setAttribute(key, value);
+	el.setAttribute(ATTR, "");
+	return el;
+}
+function collectDesiredHeadElements(head) {
+	const desired = [];
+	if (head.meta) for (const entry of head.meta) {
+		const attrs = {};
+		if (entry.charset) attrs.charset = entry.charset;
+		if (entry.name) attrs.name = entry.name;
+		if (entry.property) attrs.property = entry.property;
+		if (entry.content !== void 0) attrs.content = entry.content;
+		desired.push({
+			tag: "meta",
+			attrs
+		});
+	}
+	if (head.link) for (const entry of head.link) {
+		const attrs = {};
+		for (const [key, value] of Object.entries(entry)) if (value != null) attrs[key] = value;
+		desired.push({
+			tag: "link",
+			attrs
+		});
+	}
+	return desired;
+}
+/**
+* Mark SSR-rendered head tags so they are cleaned up on the first SPA navigation.
+* Call once after hydration with the initial page's head descriptor.
+*/
+function initClientHead(head) {
+	if (!head) return;
+	if (head.meta) for (const entry of head.meta) {
+		const selector = entry.charset ? "meta[charset]" : entry.property ? `meta[property="${entry.property}"]` : entry.name ? `meta[name="${entry.name}"]` : null;
+		if (!selector) continue;
+		const el = document.head.querySelector(selector);
+		if (el) el.setAttribute(ATTR, "");
+	}
+	if (head.link) for (const entry of head.link) {
+		const el = document.head.querySelector(`link[rel="${entry.rel}"][href="${entry.href}"]`);
+		if (el) el.setAttribute(ATTR, "");
+	}
+}
+/**
+* Apply head changes on SPA navigation.
+* Preserves existing managed tags when their final attributes are unchanged.
+*/
+function applyClientHead(head) {
+	const existing = /* @__PURE__ */ new Map();
+	for (const el of document.head.querySelectorAll(`[${ATTR}]`)) {
+		const signature = elementSignature(el);
+		const elements = existing.get(signature);
+		if (elements) elements.push(el);
+		else existing.set(signature, [el]);
+	}
+	const desiredElements = [];
+	for (const descriptor of head ? collectDesiredHeadElements(head) : []) {
+		const signature = elementDescriptorSignature(descriptor);
+		const elements = existing.get(signature);
+		const preserved = elements?.shift();
+		if (elements && elements.length === 0) existing.delete(signature);
+		desiredElements.push(preserved ?? createHeadElement(descriptor));
+	}
+	for (const elements of existing.values()) for (const el of elements) el.remove();
+	let cursor = document.head.querySelector(`[${ATTR}]`);
+	for (const el of desiredElements) {
+		if (el !== cursor) document.head.insertBefore(el, cursor);
+		cursor = el.nextSibling;
+	}
+	if (head?.title !== void 0) document.title = head.title;
+}
+//#endregion
+export { initClientHead as n, applyClientHead as t };

package/dist/{headers-BAHwgHdW.mjs → headers-B_HBMgi0.mjs}

@@ -1,5 +1,5 @@
-import { o as join } from "./dist-BrsS7cai.mjs";
-import { a as convertRedirectsConfig, d as parseHostPrefixedSource, i as convertHeadersConfig, o as convertRewritesConfig, r as convertFallbacksConfig, s as countSplats, t as VALID_REDIRECT_STATUSES, u as isProtocolRelative } from "./config-uNGuFsI2.mjs";
+import { a as join } from "./dist-4WkAWhWx.mjs";
+import { a as convertFallbacksConfig, c as convertRewritesConfig, f as isProtocolRelative, l as countSplats, n as VALID_REDIRECT_STATUSES, o as convertHeadersConfig, p as parseHostPrefixedSource, s as convertRedirectsConfig } from "./config-Dxr6cTXn.mjs";
 import { i as voidWarn } from "./log-ChfPKsVd.mjs";
 import { existsSync, readFileSync } from "node:fs";
 //#region src/cli/headers.ts

package/dist/{help-CwOX-zmI.mjs → help-C46mnlUS.mjs}

@@ -1,7 +1,8 @@
-import { n as __exportAll } from "./rolldown-runtime-rQ84J-ij.mjs";
-import { o as join } from "./dist-BrsS7cai.mjs";
-import { A as outro, c as import_picocolors, k as note, l as sectionTitle, p as getPackageDir, s as helpLine, t as categoryTitle } from "./output-B0cfNSx5.mjs";
-import { t as OPERATOR_MAX_TIMEOUT_MS } from "./operator-client-LUZnlnYk.mjs";
+import { a as join } from "./dist-4WkAWhWx.mjs";
+import { c as import_picocolors, l as sectionTitle, s as helpLine, t as categoryTitle } from "./output-urU86XeT.mjs";
+import { N as note, P as outro } from "./dist-Dn6nn2IU.mjs";
+import { n as getPackageDir } from "./agents-gni4eqBu.mjs";
+import { t as OPERATOR_MAX_TIMEOUT_MS } from "./operator-client-A0iex2yi.mjs";
 import { readFileSync } from "node:fs";
 //#region src/cli/ascii.ts
 const asciiArts = [
@@ -583,12 +584,6 @@ function parseOperatorArgs(args) {
 }
 //#endregion
 //#region src/cli/help.ts
-var help_exports = /* @__PURE__ */ __exportAll({
-	getHelpPath: () => getHelpPath,
-	printGlobalHelp: () => printGlobalHelp,
-	printHelpPage: () => printHelpPage,
-	printVoidHeader: () => printVoidHeader
-});
 function operatorHelpTree() {
 	return Object.fromEntries(operatorGroups.map((group) => {
 		const commands = operatorCommands.filter((entry) => entry.group === group);
@@ -716,6 +711,14 @@ const HELP_TREE = {
 			}
 		]
 	},
+	migrate: {
+		summary: "Move legacy Void project settings into void.config.ts.",
+		usage: ["void migrate"],
+		examples: [{
+			command: "void migrate",
+			description: "Convert void.json to void.config.ts"
+		}]
+	},
 	deploy: {
 		summary: "Build and deploy. Offers to link an existing Cloudflare Worker when no destination is configured.",
 		usage: ["void deploy [options]"],
@@ -1546,7 +1549,7 @@ const HELP_TREE = {
 				}]
 			},
 			setup: {
-				summary: "Set email up on your own Cloudflare account: enable Email Routing, onboard Email Sending, write send_email + addresses into wrangler.jsonc. Asks once before changing the account.",
+				summary: "Set email up on your own Cloudflare account: enable Email Routing, onboard Email Sending, and record send_email + addresses in the Cloudflare config managed by Void. Asks once before changing the account.",
 				usage: ["void email setup --platform cloudflare"],
 				options: [{
 					command: "--platform cloudflare",
@@ -2073,6 +2076,8 @@ function printGlobalHelp() {
 		globalCommandLine(["init"], "void init"),
 		...globalOptionLines(["init"]),
 		"",
+		globalCommandLine(["migrate"], "void migrate"),
+		"",
 		globalCommandLine(["connect"], "void connect [url]"),
 		...globalOptionLines(["connect"]),
 		"",
@@ -2213,4 +2218,4 @@ function formatHelpPath(path) {
 	return path.length === 0 ? "help" : path.join(" ");
 }
 //#endregion
-export { printVoidHeader as a, printHelpPage as i, help_exports as n, operatorGroups as o, printGlobalHelp as r, parseOperatorArgs as s, getHelpPath as t };
+export { operatorGroups as a, printVoidHeader as i, printGlobalHelp as n, parseOperatorArgs as o, printHelpPage as r, getHelpPath as t };

package/dist/help-CS_nAsWu.mjs

@@ -0,0 +1,2 @@
+import { r as printHelpPage } from "./help-C46mnlUS.mjs";
+export { printHelpPage };

package/dist/index.d.mts

@@ -1,7 +1,7 @@
 import { n as HeadDescriptor } from "./head-Do8P4puT.mjs";
 import { r as AuthUser } from "./auth-DkcFflXV.mjs";
-import { C as defer, E as ValidatorSlots, S as InferProps, T as HandlerInput, _ as defineQueue, a as CloudEnv, b as Deferred, c as QueueRetryOptions, d as TypedQueueHandler, f as VoidAssetRewriteError, g as defineMiddleware, h as defineHead, i as CloudContextVariables, l as RenderAssetTags, m as defineHandler, o as QueueBatch, p as basicAuth, r as CloudContext, s as QueueMessage, t as BasicAuthOptions, u as TypedHandler, v as defineRender, x as DeferredState, y as defineScheduled } from "./handler-D1hLsObx.mjs";
-import { QueueMap } from "./runtime/queues.mjs";
+import { C as defer, E as ValidatorSlots, S as InferProps, T as HandlerInput, _ as defineQueue, a as CloudEnv, b as Deferred, c as QueueRetryOptions, d as TypedQueueHandler, f as VoidAssetRewriteError, g as defineMiddleware, h as defineHead, i as CloudContextVariables, l as RenderAssetTags, m as defineHandler, o as QueueBatch, p as basicAuth, r as CloudContext, s as QueueMessage, t as BasicAuthOptions, u as TypedHandler, v as defineRender, x as DeferredState, y as defineScheduled } from "./handler-BXJTXd02.mjs";
+import { t as QueueMap } from "./queues-BWKt1Xo4.mjs";
 import { PluginConfig } from "@cloudflare/vite-plugin";
 import { Plugin } from "vite";
 //#region src/router/parse-filename.d.ts
@@ -45,24 +45,6 @@ export declare function shouldBindWorkersAi(command: string, needsAI: boolean, r
 export declare function shouldInjectEmailDevInboxVar(routeEnvironment: RouteEnvironment, needsEmail: boolean | undefined, assetsBinding: string | undefined): boolean;
 /** Resolve the runtime Workers AI binding, preserving a root Wrangler declaration. */
 export declare function resolveWorkersAiBindingName(resolvedAi: unknown, configuredName?: string): string;
-/**
- * Void plugin — the main entry point.
- *
- * Composes:
- * 1. Routing plugin (file-based routing from routes/ and middleware/)
- * 2. Migration plugin (auto-apply .sql migrations on dev startup)
- * 3. @cloudflare/vite-plugin (workerd runtime, HMR, builds)
- *
- * Binding inference runs synchronously here so results are available
- * before the Cloudflare plugin initializes.
- *
- * If the user has a `wrangler.jsonc` / `wrangler.json` in their project root,
- * the Cloudflare plugin reads it and provides the resolved config to our
- * config function. Bindings already defined there (with real IDs for
- * production deployment) are preserved — we only add inferred bindings
- * that are missing. This allows `vite build && wrangler deploy` to work
- * for deploying directly to Cloudflare without the Void platform.
- */
 export declare function voidPlugin(options?: {
   persistTo?: string;
   auxiliaryWorkers?: PluginConfig["auxiliaryWorkers"];