void 0.21.9 → 0.23.0

package/dist/{operator-cmd-03819ATr.mjs → operator-cmd-DBA6dl0m.mjs}

@@ -1,8 +1,8 @@
 import { n as OperatorClient, r as OperatorClientError } from "./operator-client-DUwumHpQ.mjs";
 import { a as resolveOperatorOrigin, i as removeOperatorToken, n as readOperatorApiTokenStdin, o as saveOperatorToken, r as readOperatorToken, t as exchangeOperatorSession } from "./operator-auth-8KnOVXVd.mjs";
 import { createHash } from "node:crypto";
-import { createInterface } from "node:readline/promises";
 import { setTimeout } from "node:timers/promises";
+import { createInterface } from "node:readline/promises";
 //#region src/cli/operator-cmd.ts
 const MAX_RUNTIME_FOLLOW_ROWS = 1e4;
 function printable(value) {
@@ -137,9 +137,9 @@ async function runAuth(origin, args) {
 	if (args.action === "login" || args.action === "token" && args.tokenStdin) {
 		if (!args.tokenStdin && !process.stdin.isTTY) throw new OperatorClientError("Browser login requires an interactive terminal. Use --token-stdin to exchange an API session.", "interactive_login_required");
 		const apiToken = args.tokenStdin ? await readOperatorApiTokenStdin() : await (async () => {
-			const { discoverPlatform } = await import("./platform-cmd-C4ZV3Vpy.mjs");
-			const { selectPlatformLoginMethod } = await import("./login-DFQk7rbW.mjs");
-			const { runPlatformLogin } = await import("./auth-CZuiVsFh.mjs");
+			const { discoverPlatform } = await import("./platform-cmd-Bt-1w6pY.mjs");
+			const { selectPlatformLoginMethod } = await import("./login-DYt_An22.mjs");
+			const { runPlatformLogin } = await import("./auth-CCjt0hcq.mjs");
 			return runPlatformLogin(origin, (await selectPlatformLoginMethod(await discoverPlatform(origin), args.providerExplicit ? args.provider : void 0)).id, (url) => process.stderr.write(`Sign in at ${url}\n`));
 		})();
 		const session = await exchangeOperatorSession(origin, apiToken);
@@ -199,8 +199,6 @@ async function followOperatorLogs(client, args, signal, pollIntervalMs = 2e3) {
 	const combined = signal ? AbortSignal.any([signal, controller.signal]) : controller.signal;
 	const query = { ...args.query };
 	let terminalBuildSince = null;
-	let legacyQuietSince = null;
-	let legacyQuietSeq = null;
 	let previousRuntimeRows = /* @__PURE__ */ new Map();
 	let currentRuntimeRows = /* @__PURE__ */ new Map();
 	let currentRuntimeRowCount = 0;
@@ -238,23 +236,11 @@ async function followOperatorLogs(client, args, signal, pollIntervalMs = 2e3) {
 				if (result.logsComplete !== void 0 && result.logsComplete !== null && typeof result.logsComplete !== "boolean") throw new OperatorClientError("Build log response has an invalid completion state.", "invalid_response");
 				if (result.terminal === true) {
 					if (result.logsComplete === true) return;
+					if (result.logsComplete === null || result.logsComplete === void 0) throw new OperatorClientError("This platform cannot confirm that the final build logs were captured. Upgrade the platform runtime, or read the retained logs without --follow.", "log_completion_unavailable");
 					const now = Date.now();
 					terminalBuildSince ??= now;
 					if (now - terminalBuildSince >= 12e4) throw new OperatorClientError("Build finished, but its log producer did not confirm completion. Retry the command to recover the final log tail.", "invalid_response");
-					if (result.logsComplete === null || result.logsComplete === void 0) {
-						if (legacyQuietSeq !== result.lastSeq) {
-							legacyQuietSeq = result.lastSeq;
-							legacyQuietSince = now;
-						} else {
-							legacyQuietSince ??= now;
-							if (now - legacyQuietSince >= 3e4) return;
-						}
-					}
-				} else {
-					terminalBuildSince = null;
-					legacyQuietSince = null;
-					legacyQuietSeq = null;
-				}
+				} else terminalBuildSince = null;
 			} else {
 				if (typeof result.nextCursor === "string" && result.nextCursor) {
 					if (result.nextCursor === query.cursor) throw new OperatorClientError("Runtime log pagination did not advance.", "invalid_response");
@@ -277,9 +263,57 @@ async function followOperatorLogs(client, args, signal, pollIntervalMs = 2e3) {
 		process.removeListener("SIGINT", stop);
 	}
 }
+async function migrateDeploymentAssets(client, origin, args) {
+	const target = decodeURIComponent(args.path.slice(13, -15));
+	const seenCursors = /* @__PURE__ */ new Set();
+	let body = { ...args.body };
+	if (typeof body.cursor === "string") seenCursors.add(body.cursor);
+	let authorized = false;
+	while (true) {
+		const preview = await client.request(args.path, {
+			method: "POST",
+			body: {
+				...body,
+				dryRun: true
+			},
+			timeoutMs: args.timeoutMs
+		});
+		if (preview.dryRun !== true || preview.action !== "deployment.migrate-assets" || preview.target !== target || typeof preview.expected !== "string" || !preview.expected.trim()) throw new OperatorClientError("The server did not return a valid asset migration preview. No asset batch was requested.", "invalid_preview");
+		if (!await confirmOperatorMutation(origin, {
+			...preview,
+			scope: "Copy and verify all remaining asset batches for this deployment; keep original assets."
+		}, authorized ? {
+			...args,
+			yes: true
+		} : args)) return;
+		authorized = true;
+		const result = await client.request(args.path, {
+			method: "POST",
+			body: {
+				...body,
+				expected: preview.expected
+			},
+			timeoutMs: args.timeoutMs
+		});
+		const nextCursor = result.nextCursor;
+		if (result.dryRun !== false || result.action !== "deployment.migrate-assets" || result.target !== target || typeof result.complete !== "boolean" || (result.complete ? nextCursor !== null : typeof nextCursor !== "string" || !nextCursor.trim() || seenCursors.has(nextCursor))) throw new OperatorClientError("The server returned an invalid asset migration continuation. Inspect the deployment before resuming; no batch was retried.", "invalid_response", void 0, {
+			target,
+			lastSuccessfulCursor: body.cursor ?? null,
+			result
+		});
+		output(result, args.json);
+		if (result.complete) return;
+		const cursor = nextCursor;
+		seenCursors.add(cursor);
+		body = {
+			...args.body,
+			cursor
+		};
+	}
+}
 async function runOperatorCommand(args) {
 	if (!args.action) {
-		const { printHelpPage } = await import("./help-DQMfeKMz.mjs");
+		const { printHelpPage } = await import("./help-DofyZuY7.mjs");
 		printHelpPage(["platform", args.group]);
 		return;
 	}
@@ -288,7 +322,8 @@ async function runOperatorCommand(args) {
 	const client = new OperatorClient(origin, readOperatorToken(origin));
 	if (args.method === "POST") {
 		if (!args.plan && !args.yes && (!process.stdin.isTTY || !process.stderr.isTTY)) throw new OperatorClientError("Mutations in non-interactive mode require --yes or --plan.", "confirmation_required");
-		if (args.tokenStdin && args.group === "email" && (args.action === "domain-add" || args.action === "domain-remove")) args = {
+		if (args.group === "deployment" && args.action === "migrate-assets") return migrateDeploymentAssets(client, origin, args);
+		if (args.tokenStdin && (args.group === "email" && (args.action === "domain-add" || args.action === "domain-remove") || args.group === "zero-trust" && args.action === "configure")) args = {
 			...args,
 			body: {
 				...args.body,
@@ -304,11 +339,17 @@ async function runOperatorCommand(args) {
 			timeoutMs: args.timeoutMs
 		});
 		if (preview.dryRun !== true || typeof preview.action !== "string" || !Object.hasOwn(preview, "target")) throw new OperatorClientError("The server did not return a valid mutation preview. No change was requested.", "invalid_preview");
-		const recoveryFence = args.group === "email" && args.action === "operation-resolve" ? operationRecoveryFence(preview.target) : {};
+		let recoveryFence = args.group === "email" && args.action === "operation-resolve" ? operationRecoveryFence(preview.target) : {};
+		if (args.group === "email" && args.action === "shared-recipient-resolve") {
+			const target = preview.target;
+			if (!target || typeof target.recoveryFence !== "string" || !/^[a-f0-9]{64}$/.test(target.recoveryFence)) throw new OperatorClientError("The server did not return a valid shared recipient recovery fence. No change was requested.", "invalid_preview");
+			recoveryFence = { recoveryFence: target.recoveryFence };
+		}
 		if (!await confirmOperatorMutation(origin, preview, args)) return;
 		const body = {
 			...args.body,
 			...args.group === "worker" && args.action === "rollback-all" ? { versions: preview.versions } : {},
+			...args.group === "project" && args.action === "normalize" ? { expected: preview.changes } : {},
 			...recoveryFence
 		};
 		output(await client.request(args.path, {
@@ -320,6 +361,11 @@ async function runOperatorCommand(args) {
 	else {
 		const result = await client.request(args.path, { query: args.query });
 		if (args.action === "logs" && args.group !== "email") outputLogs(result, args.json);
+		else if (args.group === "system" && args.action === "asset-migrations" && !args.json && Array.isArray(result.deployments)) console.log([
+			...humanLines({ pagination: result.pagination }),
+			"deployments:",
+			...eventLines(result.deployments, "  ")
+		].join("\n"));
 		else output(result, args.json);
 		if (result.allOk === false) process.exitCode = 1;
 	}

package/dist/output-Dm_A4Tbv.mjs

@@ -0,0 +1,81 @@
+import { n as __toESM } from "./rolldown-runtime-DXIUcv95.mjs";
+import { t as require_picocolors } from "./picocolors-BTps1_gs.mjs";
+import { L as spinner, j as log, k as isCI } from "./dist-CTBk70IR.mjs";
+//#region src/cli/output.ts
+var import_picocolors = /* @__PURE__ */ __toESM(require_picocolors(), 1);
+/** Keep recovery commands on the same CLI when using the local checkout launcher. */
+function cliCommandName() {
+	const entryName = process.argv[1]?.split(/[\\/]/).at(-1);
+	return entryName === "void-dev" || entryName === "void-dev.cmd" ? "void-dev" : "void";
+}
+/**
+* Terminal-safe spinner wrapper. In CI and redirected output,
+* `@clack/prompts` spinner emits DEC Private Mode cursor hide/show codes
+* (`\x1b[?25l` / `\x1b[?25h`) that render as text artifacts. This wrapper
+* replaces the spinner with plain log output.
+*/
+function createSpinner(options, isTerminal = process.stdout.isTTY === true) {
+	if (!isCI() && isTerminal) return spinner(options);
+	let currentMessage = "";
+	return {
+		start(msg = "") {
+			currentMessage = msg;
+			if (msg) log.step(msg);
+		},
+		stop(msg = "") {
+			if (msg) log.info(msg);
+		},
+		message(msg = "") {
+			if (msg && msg !== currentMessage) {
+				currentMessage = msg;
+				log.step(msg);
+			}
+		},
+		cancel(msg = "") {
+			if (msg) log.warn(msg);
+		},
+		error(msg = "") {
+			if (msg) log.error(msg);
+		},
+		clear() {},
+		get isCancelled() {
+			return false;
+		}
+	};
+}
+function cliTitle(command) {
+	return import_picocolors.default.blue(`void ${command}`);
+}
+function sectionTitle(title) {
+	return import_picocolors.default.reset(import_picocolors.default.blue(title));
+}
+function categoryTitle(title) {
+	return import_picocolors.default.reset(import_picocolors.default.bold(import_picocolors.default.cyan(title)));
+}
+function dim(text) {
+	return import_picocolors.default.dim(text);
+}
+function tablePrefix() {
+	return `${import_picocolors.default.gray("│")}  `;
+}
+/** Strip terminal control characters from text received from a platform. */
+function sanitizeTerminalText(value) {
+	return value.replace(/[\u0000-\u001f\u007f-\u009f]/g, " ");
+}
+function helpLine(command, description) {
+	return `${import_picocolors.default.reset(command.padEnd(34))} ${import_picocolors.default.dim(description)}`;
+}
+/**
+* Ensure a timestamp string will be parsed as UTC by `new Date()`.
+* DB timestamps lack timezone info — appends 'Z' only when no
+* existing indicator (Z, z, or numeric offset) is present.
+*/
+function ensureUtc(s) {
+	const last = s.at(-1);
+	if (last === "Z" || last === "z") return s;
+	if (s.includes("+", 10)) return s;
+	if (s.lastIndexOf("-") > 9) return s;
+	return s + "Z";
+}
+//#endregion
+export { dim as a, import_picocolors as c, tablePrefix as d, createSpinner as i, sanitizeTerminalText as l, cliCommandName as n, ensureUtc as o, cliTitle as r, helpLine as s, categoryTitle as t, sectionTitle as u };

package/dist/pages/client.d.mts

@@ -1,5 +1,7 @@
-import { t as PageObject } from "../protocol-ZH3jP4a7.mjs";
+import { t as PageObject } from "../protocol-CjF_iI9X.mjs";
 import { n as CacheForInput, r as CacheForResult } from "../prefetch-Ce6la4EI.mjs";
+import { UsageLimitData } from "@void/edge";
+import { ActionUrl, ResolveActionBody, ResolveActionParams } from "void/routes";
 //#region src/pages/action-result.d.ts
 type ActionErrorHandlingScope = "callSite" | "boundary";
 type ActionResult<T = PageObject | undefined> = {
@@ -11,6 +13,7 @@ type ActionResult<T = PageObject | undefined> = {
 };
 export declare class VoidActionError extends Error {
   readonly body: unknown;
+  readonly limit: UsageLimitData | null;
   readonly status: number;
   readonly statusText: string;
   readonly url: string;
@@ -109,6 +112,19 @@ export declare function createPageNavigationEngine(config: PageNavigationEngineC
 //#region src/pages/form-value-equality.d.ts
 export declare function isEqualFormValue(a: unknown, b: unknown): boolean;
 //#endregion
+//#region src/pages/form-presentation.d.ts
+type FormMethod = "post" | "put" | "patch" | "delete";
+type FormModel<Args extends Array<unknown> = []> = {
+  readonly pending: boolean;
+  readonly error: VoidActionError | null;
+  readonly errors: Readonly<Record<string, string | undefined>>;
+} & { [K in FormMethod]: (...args: Args) => void | Promise<void>; };
+export declare function formErrorMessage(form: Pick<FormModel, "error" | "errors">): string | null;
+export declare function formRetryMessage(error: VoidActionError | null): string | null;
+export declare function formSubmissionBlocked(form: Pick<FormModel, "pending" | "error">, now?: number): boolean;
+/** One deadline, capped for browser timers; no polling and no automatic submission. */
+export declare function scheduleFormRetry(error: VoidActionError | null, ready: () => void): () => void;
+//#endregion
 //#region src/pages/client.d.ts
 export type VisitOptions = {
   method?: string;
@@ -185,6 +201,22 @@ export declare function hasFiles(data: unknown): boolean;
 export declare function objectToFormData(source: Record<string, unknown>, form?: FormData, parentKey?: string): FormData;
 export declare const ssrProxy: VoidRouter;
 export declare function submitAction(router: VoidRouter, url: string, options: VisitOptions): Promise<ActionResult>;
+type ActionMethod = "POST" | "PUT" | "PATCH" | "DELETE";
+type HasParams<U extends string> = [ResolveActionParams<U>] extends [never] ? false : true;
+type ActionOptions<U extends string> = {
+  data?: ResolveActionBody<U>;
+  method?: ActionMethod;
+} & (HasParams<U> extends true ? {
+  params: ResolveActionParams<U>;
+} : {
+  params?: never;
+});
+export type ActionClient = {
+  setActionRouter(router: VoidRouter): void;
+  action<U extends ActionUrl & string>(url: U, ...args: HasParams<U> extends true ? [options: ActionOptions<U>] : [options?: ActionOptions<U>]): Promise<ActionResult>;
+};
+/** Creates an action client with its own router for each framework adapter. */
+export declare function createActionClient(): ActionClient;
 export declare function createVoidRouter(config: VoidRouterConfig): Promise<{
   router: VoidRouter;
   initialPageData: PageData;
@@ -195,4 +227,4 @@ export declare function createVoidRouter(config: VoidRouterConfig): Promise<{
 export declare function scheduleHydration(el: Element, loader: () => Promise<unknown>, props: Record<string, unknown>, strategy: string, hydrateFn: (el: Element, mod: unknown, props: Record<string, unknown>) => void | Promise<void>): void;
 export declare function initIslands(islands: Record<string, () => Promise<unknown>>, hydrateFn: (el: Element, mod: unknown, props: Record<string, unknown>) => void | Promise<void>): void;
 //#endregion
-export type { ActionErrorHandlingScope, ActionResult, PageNavigationEngine, PageNavigationResource, PageNavigationResult };
+export type { ActionErrorHandlingScope, ActionResult, FormMethod, FormModel, PageNavigationEngine, PageNavigationResource, PageNavigationResult };

package/dist/pages/client.mjs

@@ -1,15 +1,20 @@
+import { t as interpolateRouteParams } from "../route-url-CG7U-cRN.mjs";
 import { n as initClientHead, t as applyClientHead } from "../head-client-DzmJGN4C.mjs";
 import { n as parseCacheFor, t as PrefetchCache } from "../prefetch-Bsc_Pb6c.mjs";
+import { readUsageLimit } from "@void/edge";
 //#region src/pages/action-result.ts
 var VoidActionError = class extends Error {
 	body;
+	limit;
 	status;
 	statusText;
 	url;
 	constructor({ body, status, statusText, url }) {
-		super(statusText ? `Action failed with ${status} ${statusText}` : `Action failed with ${status}`);
+		const limit = status === 429 ? readUsageLimit(body) : null;
+		super(limit?.message ?? (statusText ? `Action failed with ${status} ${statusText}` : `Action failed with ${status}`));
 		this.name = "VoidActionError";
 		this.body = body;
+		this.limit = limit;
 		this.status = status;
 		this.statusText = statusText;
 		this.url = url;
@@ -377,7 +382,7 @@ async function createPageNavigationEngine(config) {
 				window.location.href = url;
 				return;
 			}
-			pageData = _staticPageDataCacheKeys.has(getPageDataCacheKey(fetchUrl, method)) ? clonePageData(cachedPageData) : cachedPageData;
+			pageData = clonePageData(cachedPageData);
 			deferredRegistry.setupResolved(pageData);
 			if (!_prefetchCache.isFresh(cacheEntry)) {
 				const bgHeaders = {
@@ -732,6 +737,33 @@ function isEqualFormValue(a, b) {
 	return false;
 }
 //#endregion
+//#region src/pages/form-presentation.ts
+function formErrorMessage(form) {
+	return form.error?.message ?? (Object.values(form.errors).filter(Boolean).join(". ") || null);
+}
+function formRetryMessage(error) {
+	return error?.limit?.retryAt ? `Try again after ${new Date(error.limit.retryAt).toUTCString()}.` : null;
+}
+function formSubmissionBlocked(form, now = Date.now()) {
+	return form.pending || (form.error?.limit?.retryAt ? Date.parse(form.error.limit.retryAt) > now : false);
+}
+/** One deadline, capped for browser timers; no polling and no automatic submission. */
+function scheduleFormRetry(error, ready) {
+	const retryAt = error?.limit?.retryAt;
+	if (!retryAt) return () => {};
+	let timer;
+	const schedule = () => {
+		const remaining = Date.parse(retryAt) - Date.now();
+		if (remaining <= 0) {
+			ready();
+			return;
+		}
+		timer = setTimeout(schedule, Math.min(remaining, 2147483647));
+	};
+	schedule();
+	return () => clearTimeout(timer);
+}
+//#endregion
 //#region src/pages/client.ts
 function currentUrl() {
 	return window.location.pathname + window.location.search + window.location.hash;
@@ -883,6 +915,30 @@ async function submitAction(router, url, options) {
 		throw error;
 	}
 }
+/** Creates an action client with its own router for each framework adapter. */
+function createActionClient() {
+	let _router = null;
+	/** Called during app initialization to store the router instance */
+	function setActionRouter(router) {
+		_router = router;
+	}
+	/** Programmatic page action call with a router update */
+	async function action(url, ...args) {
+		if (!_router) throw new Error("action(): called before router initialization.");
+		const options = args[0];
+		const data = options?.data;
+		const method = options?.method || "POST";
+		const resolvedUrl = interpolateRouteParams(url, options?.params);
+		return submitAction(_router, resolvedUrl, {
+			method,
+			data
+		});
+	}
+	return {
+		action,
+		setActionRouter
+	};
+}
 async function createVoidRouter(config) {
 	{
 		const engine = await createPageNavigationEngine(config);
@@ -1003,4 +1059,4 @@ function initIslands(islands, hydrateFn) {
 	});
 }
 //#endregion
-export { VoidActionError, categorizeActionError, createPageNavigationEngine, createRouterFacade, createSsrRouter, createVoidRouter, hasFiles, idleNavigationState, initIslands, isAbortError, isCallSiteActionError, isEqualFormValue, isFile, objectToFormData, scheduleHydration, ssrProxy, submitAction };
+export { VoidActionError, categorizeActionError, createActionClient, createPageNavigationEngine, createRouterFacade, createSsrRouter, createVoidRouter, formErrorMessage, formRetryMessage, formSubmissionBlocked, hasFiles, idleNavigationState, initIslands, isAbortError, isCallSiteActionError, isEqualFormValue, isFile, objectToFormData, scheduleFormRetry, scheduleHydration, ssrProxy, submitAction };

package/dist/pages/index.d.mts

@@ -1,5 +1,5 @@
 import { a as renderHtmlAttrs, i as renderHeadToString, n as HeadDescriptor, o as resolveHead, r as renderBodyAttrs, t as HeadConfig } from "../head-Do8P4puT.mjs";
-import "../config-CF69HgXc.mjs";
+import "../config-BMHb8RCj.mjs";
 import { i as PageDefinition, n as LayoutDefinition, o as PageScanResult, r as NamedLayoutDefinition } from "../types-BAp5AEBU.mjs";
 import { t as serializePageData } from "../serialize-CfSwWfF2.mjs";
 //#region src/project-paths.d.ts

package/dist/pages/index.mjs

@@ -1,8 +1,8 @@
 import { a as join } from "../dist-BVqXeR_h.mjs";
 import { r as resolvePagesDir } from "../project-paths-GgcMozYz.mjs";
-import { m as readConfig } from "../config-CafTW6Cz.mjs";
-import { i as parseRedirectsFile } from "../headers-BOg_velo.mjs";
-import { a as resolveNamedLayout, i as resolveLayoutIds, n as resolveEffectiveLayoutChain, r as resolveLayoutChain, t as scanPages } from "../scan-4tfN-PSn.mjs";
+import { m as readConfig } from "../config-Br_JZD6u.mjs";
+import { a as resolveNamedLayout, i as resolveLayoutIds, n as resolveEffectiveLayoutChain, r as resolveLayoutChain, t as scanPages } from "../scan-C7okrLyM.mjs";
+import { i as parseRedirectsFile } from "../headers-DWi2IXWx.mjs";
 import { i as resolveHead, n as renderHeadToString, r as renderHtmlAttrs, t as renderBodyAttrs } from "../head-D_QRR5Yd.mjs";
 import { t as serializePageData } from "../serialize-BPvnNQuA.mjs";
 //#region src/pages/manifest.ts

package/dist/pages/islands-plugin.d.mts

@@ -1,6 +1,6 @@
 import { o as PageScanResult } from "../types-BAp5AEBU.mjs";
 import { ResolvedConfig, ViteDevServer } from "vite";
-//#region ../../node_modules/.pnpm/magic-string@1.3.1/node_modules/magic-string/dist/index.d.mts
+//#region ../../node_modules/.pnpm/magic-string@1.4.2/node_modules/magic-string/dist/index.d.mts
 //#region src/SourceMap.d.ts
 interface SourceMapOptions {
   /**
@@ -56,7 +56,9 @@ declare class SourceMap {
   x_google_ignoreList: number[] | undefined;
   debugId: string | undefined;
   rangeMappings: string | undefined;
-  constructor(properties: DecodedSourceMap);
+  constructor(properties: DecodedSourceMap | (Omit<DecodedSourceMap, "mappings"> & {
+    mappings: string;
+  }));
   /**
    * Returns the equivalent of `JSON.stringify(map)`
    */
@@ -90,8 +92,7 @@ interface UpdateOptions {
 }
 type ReplacementFunction = (substring: string, ...args: any[]) => string;
 declare class MagicString {
-  original: string;
-  indentExclusionRanges: MagicStringOptions["indentExclusionRanges"];
+  readonly original: string;
   offset: number;
   constructor(string: string, options?: MagicStringOptions);
   /**
@@ -143,8 +144,14 @@ declare class MagicString {
   indent(indentStr?: string, options?: IndentOptions): this;
   /**
    * Moves the characters from `start` and `end` to `index`.
+   *
+   * `affinity` controls where the range is anchored at `index`. With the
+   * default `'right'`, it is inserted before the content that starts at `index`;
+   * with `'left'`, it is inserted after the content that ends at `index`. The
+   * two differ only when other content has already been moved to that boundary,
+   * mirroring the `appendLeft`/`appendRight` distinction.
    */
-  move(start: number, end: number, index: number): this;
+  move(start: number, end: number, index: number, affinity?: "left" | "right"): this;
   /**
    * Replaces the characters from `start` to `end` with `content`, along with the appended/prepended content in
    * that range. The same restrictions as `s.remove()` apply.
@@ -178,7 +185,10 @@ declare class MagicString {
   prependRight(index: number, content: string): this;
   /**
    * Removes the characters from `start` to `end` (of the original string, **not** the generated string).
-   * Removing the same content twice, or making removals that partially overlap, will cause an error.
+   * Content appended or prepended at positions strictly inside the range is removed with it, while
+   * content attached at `start` or `end` is preserved — use `s.overwrite(start, end, '')` to remove
+   * the range including its edge inserts.
+   * Repeated removals and removals with partially overlapping ranges are allowed.
    */
   remove(start: number, end: number): this;
   /**

package/dist/pages/islands-plugin.mjs

@@ -1,7 +1,7 @@
 import { n as dirname, u as resolve } from "../dist-BVqXeR_h.mjs";
 import { n as isIdentifier, r as isLiteral } from "../ast-CPGPjb0V.mjs";
-import { n as resolveEffectiveLayoutChain, t as scanPages } from "../scan-4tfN-PSn.mjs";
-import { t as MagicString } from "../dist-BR1quN_w.mjs";
+import { n as resolveEffectiveLayoutChain, t as scanPages } from "../scan-C7okrLyM.mjs";
+import { t as MagicString } from "../dist-AoCzRTJE.mjs";
 import { existsSync, readFileSync, readdirSync } from "node:fs";
 import { normalizePath, parseSync } from "vite";
 //#region src/pages/island-imports.ts

package/dist/pages/protocol.d.mts

@@ -1,3 +1,3 @@
-import { w as ValidationError } from "../handler-BXJTXd02.mjs";
-import { a as handlePageMutation, i as handlePageGet, n as PageRenderResult, o as safeJsonStringify, r as flattenValidationErrors, t as PageObject } from "../protocol-ZH3jP4a7.mjs";
+import { w as ValidationError } from "../handler-CZ4nAylQ.mjs";
+import { a as handlePageMutation, i as handlePageGet, n as PageRenderResult, o as safeJsonStringify, r as flattenValidationErrors, t as PageObject } from "../protocol-CjF_iI9X.mjs";
 export { PageObject, PageRenderResult, ValidationError, flattenValidationErrors, handlePageGet, handlePageMutation, safeJsonStringify };