@timber-js/app 0.2.0-alpha.197 → 0.2.0-alpha.199

package/dist/client/segment-cache.d.ts

@@ -20,14 +20,6 @@ export interface PrefetchResult {
     params?: PublishedParams | Promise<PublishedParams>;
     /** Segment paths skipped by the server (for client-side merging). */
     skippedSegments?: string[] | null;
-    /**
-     * HTTP status of the prefetched response. A deny payload is an ordinary
-     * Flight response carrying a 4xx, so it prefetches and caches like any
-     * other — and the tree it renders is one the segment cache must not learn
-     * from. Absent on entries that predate the field, and on the negative
-     * sentinel. See TIM-1356.
-     */
-    status?: number;
 }
 /**
  * A node in the client-side segment tree. Each node represents a mounted
@@ -173,6 +165,7 @@ export declare class PrefetchCache {
     private static readonly TTL_MS;
     private entries;
     private flights;
+    private evictionGen;
     set(key: PrefetchKey, result: PrefetchResult): void;
     get(key: PrefetchKey): PrefetchResult | undefined;
     /** True if a ready or negative entry exists for this key. */
@@ -212,5 +205,27 @@ export declare class PrefetchCache {
     setNegative(key: PrefetchKey): void;
     /** Check if the entry is a negative cache entry (URL is not a route). */
     isNegative(key: PrefetchKey): boolean;
+    /**
+     * Invalidate all entries whose destination URL matches (TIM-1454).
+     * Used by `revalidatePath` on a non-current route so the next navigation
+     * fetches fresh data instead of replaying a stale prefetch.
+     */
+    invalidateUrl(url: string): void;
+    /**
+     * Evict all ready entries and fence in-flight singleflights (TIM-1476).
+     * Called after a server action that revalidated data — the mutation may
+     * affect any route, not just the paths the server named. In-flight
+     * singleflights are not aborted (they may carry post-mutation data),
+     * but their results are discarded if they complete after eviction:
+     * `fetchOrCoalesce` captures the generation before the flight and
+     * skips the store when it has been bumped.
+     *
+     * Consumers that join an in-flight flight via `joinInflight` must
+     * check `getEvictionGen()` before and after the await: if the gen
+     * changed, the result predates the eviction and must be discarded
+     * (codex on #1131 round 2).
+     */
+    clearReady(): void;
+    getEvictionGen(): number;
 }
 //# sourceMappingURL=segment-cache.d.ts.map

package/dist/client/segment-cache.d.ts.map

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

package/dist/client/state.d.ts

@@ -39,4 +39,20 @@ export declare function _setCachedSearch(search: string, params: URLSearchParams
 /** Whether the page is currently being unloaded. */
 export declare let unloading: boolean;
 export declare function _setUnloading(value: boolean): void;
+/**
+ * Whether a status page for the main route has rendered since the last
+ * navigation was prepared. Raised by `StatusPageMarker`, consumed by the
+ * navigation's commit. See navigation-commit.ts §"What a status page
+ * teaches the cache".
+ */
+export declare let statusPageRendered: boolean;
+export declare function _setStatusPageRendered(value: boolean): void;
+/**
+ * What a status page report does beyond raising the flag: registered by the
+ * router's committer so the report can clear the segment cache at once, for
+ * the commits no navigation consumes (a row arriving inside Suspense after
+ * its navigation published, a status document being hydrated).
+ */
+export declare let onStatusPageRendered: (() => void) | undefined;
+export declare function _setOnStatusPageRendered(handler: (() => void) | undefined): void;
 //# sourceMappingURL=state.d.ts.map

package/dist/client/state.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/client/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,+DAA+D;AAC/D,eAAO,IAAI,YAAY,EAAE,cAAc,GAAG,IAAW,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAEpE;AAID;;;GAGG;AACH,eAAO,IAAI,eAAe,EAAE,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAEpE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAE3F;AAED,gEAAgE;AAChE,eAAO,IAAI,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;AAE/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAElE;AAID,uEAAuE;AACvE,eAAO,IAAI,YAAY,QAAK,CAAC;AAC7B,eAAO,IAAI,kBAAkB,iBAAwB,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAG9E;AAID,oDAAoD;AACpD,eAAO,IAAI,SAAS,SAAQ,CAAC;AAE7B,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAElD"}
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../../src/client/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,+DAA+D;AAC/D,eAAO,IAAI,YAAY,EAAE,cAAc,GAAG,IAAW,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI,GAAG,IAAI,CAEpE;AAID;;;GAGG;AACH,eAAO,IAAI,eAAe,EAAE,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,CAAC;AAEpE,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,CAAC,MAAM,OAAO,GAAG,SAAS,CAAC,GAAG,SAAS,GAAG,IAAI,CAE3F;AAED,gEAAgE;AAChE,eAAO,IAAI,cAAc,EAAE,OAAO,GAAG,SAAS,CAAC;AAE/C,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAElE;AAID,uEAAuE;AACvE,eAAO,IAAI,YAAY,QAAK,CAAC;AAC7B,eAAO,IAAI,kBAAkB,iBAAwB,CAAC;AAEtD,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,IAAI,CAG9E;AAID,oDAAoD;AACpD,eAAO,IAAI,SAAS,SAAQ,CAAC;AAE7B,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAElD;AAID;;;;;GAKG;AACH,eAAO,IAAI,kBAAkB,SAAQ,CAAC;AAEtC,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAE3D;AAED;;;;;GAKG;AACH,eAAO,IAAI,oBAAoB,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,CAAC;AAE1D,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAEhF"}

package/dist/client/status-page-marker.d.ts

@@ -0,0 +1,25 @@
+/**
+ * The one way a status page tells the router it is on screen.
+ *
+ * A status page replaces a subtree, and the segment cache must not learn a
+ * chain that never mounted (see `navigation-commit.ts` §"What a status page
+ * teaches the cache"). Status pages are produced in three places — an
+ * in-tree catch site rendering the page it owns, the server's fallback
+ * renderers, and a client boundary rendering its fallback for a Flight row —
+ * and every one of them wraps the page in this marker, so the report does
+ * not depend on which producer it was. In particular the in-tree case, the
+ * common `access.ts` deny, never involves a client boundary at all.
+ *
+ * A layout effect, on every commit that renders the marker rather than on
+ * mount only: React reuses the fiber when one status page is replaced by
+ * another at the same position, and the second one must report too. Layout
+ * effects run child-before-parent, so the report lands before the ancestor
+ * `NavigationRoot` publishes the same commit, and never for a render React
+ * discards. Idempotent, so StrictMode's double invocation and a status page
+ * re-rendering on its own state are harmless. See TIM-1495.
+ */
+import { type ReactNode } from 'react';
+export declare function StatusPageMarker({ children }: {
+    children: ReactNode;
+}): ReactNode;
+//# sourceMappingURL=status-page-marker.d.ts.map

package/dist/client/status-page-marker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status-page-marker.d.ts","sourceRoot":"","sources":["../../src/client/status-page-marker.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAmB,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGxD,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,EAAE,SAAS,CAAA;CAAE,GAAG,SAAS,CAKjF"}

package/dist/cookies/index.js

@@ -1,6 +1,6 @@
 import { i as assertValidCookieName, r as stringifySetCookie, t as parseCookie } from "../_chunks/dist-DtrJyBbw.js";
-import { n as getSsrData } from "../_chunks/ssr-data-BQGhTPAK.js";
 import { a as resolveCodecOrSchema } from "../_chunks/schema-bridge-C83xa9lT.js";
+import { n as getSsrData } from "../_chunks/ssr-data-D6T6Y3ef.js";
 import * as React$1 from "react";
 import { getCookieJar } from "@timber-js/app/server";
 //#region src/client/use-cookie.ts

package/dist/dev-tools/holding-server.d.ts

@@ -14,7 +14,7 @@
  * The holding server is started in rootSync's config() hook (the
  * earliest Vite plugin lifecycle point where we know the port) and
  * closed directly in timber-dev-server's configureServer() hook
- * (the last plugin, fire-and-forget). configureServer runs during
+ * (the last plugin, awaited). configureServer runs during
  * createServer(), well before Vite's port probe and bind, so the
  * port is free by the time httpServerStart() runs. (TIM-1419)
  *
@@ -38,22 +38,9 @@ export interface HoldingServer {
 /**
  * Create a holding HTTP server that serves a loading page during startup.
  *
- * Usage (inside Vite plugin):
- * ```ts
- * // In config() hook — earliest point where port is known.
- * // Use bindWithBump() to honor the default-3000 + auto-bump policy
- * // (see ../server/port-resolution.ts and TIM-842).
- * const holding = createHoldingServer();
- * await bindWithBump((p) => holding.listen(p), { startPort: 3000, autoBump: true });
- *
- * // In last plugin's configureServer() — close directly so Vite 8's
- * // isPortAvailable() probe and httpServer.listen() both see a free
- * // port. SO_REUSEADDR allows immediate rebind. (TIM-1419)
- * if (ctx.holdingServer) {
- *   ctx.holdingServer.close().catch(() => {});
- *   ctx.holdingServer = null;
- * }
- * ```
+ * The config hook attempts one bind on the requested port. If it fails,
+ * startup continues without the holding page; Vite owns port selection.
+ * The last configureServer hook awaits close() before Vite probes/binds.
  */
 export declare function createHoldingServer(): HoldingServer;
 //# sourceMappingURL=holding-server.d.ts.map

package/dist/dev-tools/holding-server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"holding-server.d.ts","sourceRoot":"","sources":["../../src/dev-tools/holding-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAErD,kEAAkE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA8ED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAyDnD"}
+{"version":3,"file":"holding-server.d.ts","sourceRoot":"","sources":["../../src/dev-tools/holding-server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH,MAAM,WAAW,aAAa;IAC5B;;;;;OAKG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAErD,kEAAkE;IAClE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA8ED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,IAAI,aAAa,CAyDnD"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,MAAM,CAAC;AAyCjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAa1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQ1D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElG;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,MAAM;CAAG;AAE1B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAEvE;AAyGD,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAqYhE;eAEc,MAAM"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,MAAM,CAAC;AAyCjD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAa1D,YAAY,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAQ1D,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAElG;;;;;;;;;;;;GAYG;AAEH,MAAM,WAAW,MAAM;CAAG;AAE1B;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,gBAAgB,GAAG,gBAAgB,CAEvE;AAyGD,wBAAgB,MAAM,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,YAAY,EAAE,CAqXhE;eAEc,MAAM"}

package/dist/index.js

@@ -1,13 +1,13 @@
 import { l as registerDevDiscovery } from "./_chunks/graph-cache-CP4GEmf9.js";
 import { n as isScannableSourceFile, t as buildSourceExtensions } from "./_chunks/scan-BoP17W3w.js";
 import { t as RSC_CONTENT_TYPE } from "./_chunks/rsc-media-type-DDc7duTD.js";
-import { a as canonicalize, d as isMetadataRouteServePath, u as isDynamicMetadataExtension } from "./_chunks/segment-keys-BhqoHiLc.js";
-import { i as matchUrlParts, n as scanRoutes, r as collectInterceptionRewrites } from "./_chunks/scanner-tdFPvDYi.js";
-import { t as MDX_EXTENSIONS } from "./_chunks/mdx-file-CXyHGUpS.js";
-import { h as swallow } from "./_chunks/logger-DDirEsn7.js";
-import { c as writeRouteCodegen, i as getPrerenderExport, l as buildDirToRouteMap, n as formatConventionWarnings, r as lintConventions, s as flushCodegenWrites, t as checkAppDirExists } from "./_chunks/convention-lint-n3RJLgww.js";
+import { M as isSsrStreamError, h as swallow } from "./_chunks/logger-uLBuGKDI.js";
+import { c as isMetadataRouteServePath, s as isDynamicMetadataExtension } from "./_chunks/segment-keys-lqtdookO.js";
+import { r as canonicalize } from "./_chunks/canonicalize-CgHoscYO.js";
+import { i as matchUrlParts, n as scanRoutes, r as collectInterceptionRewrites } from "./_chunks/scanner-AiazgH_f.js";
+import { c as writeRouteCodegen, i as getPrerenderExport, l as buildDirToRouteMap, n as formatConventionWarnings, r as lintConventions, s as flushCodegenWrites, t as checkAppDirExists, u as MDX_EXTENSIONS } from "./_chunks/convention-lint-fRkwVwEH.js";
 import { c as resolveClientJavascript, i as mergeFileConfig, l as createNoopTimer, o as resolveAppDir, r as loadTimberConfigFile, s as resolveBuildDir, t as createPluginContext } from "./_chunks/plugin-context-8idfR3UZ.js";
-import { r as validateSchemaAgainstRoutes, t as collectLeafRoutes } from "./_chunks/walkers-DNX05dC0.js";
+import { r as validateSchemaAgainstRoutes, t as collectLeafRoutes } from "./_chunks/walkers-B6XUtmqK.js";
 import { i as poisonPillSource, r as markerFor, t as EXPLICIT_MARKERS } from "./_chunks/poison-rules-DoEhbqaY.js";
 import { i as withBasePath, n as normalizeBasePath, t as isRelativeBase } from "./_chunks/base-path-DaQrzbez.js";
 import { t as EMPTY_BUILD_MANIFEST } from "./_chunks/build-manifest-DTmSGLRz.js";
@@ -117,7 +117,7 @@ function timberContent(ctx) {
 	};
 }
 //#endregion
-//#region ../../node_modules/.pnpm/srvx@0.12.7/node_modules/srvx/dist/adapters/node.mjs
+//#region ../../node_modules/.pnpm/srvx@1.0.4/node_modules/srvx/dist/adapters/node.mjs
 function sendNodeResponse(nodeRes, webRes) {
 	try {
 		return _sendNodeResponse(nodeRes, webRes, false) || Promise.resolve();
@@ -1524,7 +1524,7 @@ function createGraphEndpointMiddleware(server, ctx) {
 		}
 		reflectCors(res, origin);
 		try {
-			const { classifyLiveFile, classifyLiveProject } = await import("./_chunks/live-graph-BXDsdzBv.js");
+			const { classifyLiveFile, classifyLiveProject } = await import("./_chunks/live-graph-D_2D32Ad.js");
 			const preserveSymlinks = server.config.resolve.preserveSymlinks;
 			const root = normalizePath(preserveSymlinks ? ctx.root : await realpath(ctx.root));
 			const appDir = normalizePath(preserveSymlinks ? ctx.appDir : await realpath(ctx.appDir).catch(() => join(root, relative(ctx.root, ctx.appDir))));
@@ -2013,7 +2013,7 @@ function createTimberMiddleware(server, ctx) {
 			await sendNodeResponse(res, finalResponse);
 		} catch (error) {
 			if (error instanceof Error) {
-				const displayError = error.name === "SsrStreamError" && error.cause instanceof Error ? error.cause : error;
+				const displayError = isSsrStreamError(error) && error.cause instanceof Error ? error.cause : error;
 				const phase = classifyErrorPhase(displayError, projectRoot);
 				sendErrorToOverlay(server, displayError, phase, projectRoot);
 				respond500(res, displayError, phase, projectRoot, hmrOptions);
@@ -4809,7 +4809,7 @@ function renderEntryCss(entry, urlPrefix) {
 	return cssParts.join("\n\n");
 }
 //#endregion
-//#region ../../node_modules/.pnpm/@jridgewell+sourcemap-codec@1.5.5/node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.mjs
+//#region ../../node_modules/.pnpm/@jridgewell+sourcemap-codec@1.6.0/node_modules/@jridgewell/sourcemap-codec/dist/sourcemap-codec.mjs
 var comma = ",".charCodeAt(0);
 var semicolon = ";".charCodeAt(0);
 var chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
@@ -4820,16 +4820,16 @@ for (let i = 0; i < chars.length; i++) {
 	intToChar[i] = c;
 	charToInt[c] = i;
 }
-function encodeInteger(builder, num, relative) {
-	let delta = num - relative;
-	delta = delta < 0 ? -delta << 1 | 1 : delta << 1;
+function encodeInteger(builder, num) {
 	do {
-		let clamped = delta & 31;
-		delta >>>= 5;
-		if (delta > 0) clamped |= 32;
+		let clamped = num & 31;
+		num >>>= 5;
+		if (num > 0) clamped |= 32;
 		builder.write(intToChar[clamped]);
-	} while (delta > 0);
-	return num;
+	} while (num > 0);
+}
+function encodeSign(num) {
+	return num < 0 ? -num << 1 | 1 : num << 1;
 }
 var bufLength = 16384;
 var td = typeof TextDecoder !== "undefined" ? /* @__PURE__ */ new TextDecoder() : typeof Buffer !== "undefined" ? { decode(buf) {
@@ -4872,19 +4872,24 @@ function encode(decoded) {
 		for (let j = 0; j < line.length; j++) {
 			const segment = line[j];
 			if (j > 0) writer.write(comma);
-			genColumn = encodeInteger(writer, segment[0], genColumn);
+			encodeInteger(writer, encodeSign(segment[0] - genColumn));
+			genColumn = segment[0];
 			if (segment.length === 1) continue;
-			sourcesIndex = encodeInteger(writer, segment[1], sourcesIndex);
-			sourceLine = encodeInteger(writer, segment[2], sourceLine);
-			sourceColumn = encodeInteger(writer, segment[3], sourceColumn);
+			encodeInteger(writer, encodeSign(segment[1] - sourcesIndex));
+			encodeInteger(writer, encodeSign(segment[2] - sourceLine));
+			encodeInteger(writer, encodeSign(segment[3] - sourceColumn));
+			sourcesIndex = segment[1];
+			sourceLine = segment[2];
+			sourceColumn = segment[3];
 			if (segment.length === 4) continue;
-			namesIndex = encodeInteger(writer, segment[4], namesIndex);
+			encodeInteger(writer, encodeSign(segment[4] - namesIndex));
+			namesIndex = segment[4];
 		}
 	}
 	return writer.flush();
 }
 //#endregion
-//#region ../../node_modules/.pnpm/magic-string@1.2.2/node_modules/magic-string/dist/index.mjs
+//#region ../../node_modules/.pnpm/magic-string@1.2.3/node_modules/magic-string/dist/index.mjs
 var BitSet = class BitSet {
 	constructor(arg) {
 		this.bits = arg instanceof BitSet ? arg.bits.slice() : [];
@@ -5585,8 +5590,8 @@ var MagicString = class MagicString {
 		end = end + this.offset;
 		if (typeof content !== "string") throw new MagicStringError(`content must be a string, got ${typeof content}`);
 		if (this.original.length !== 0) {
-			while (start < 0) start += this.original.length;
-			while (end < 0) end += this.original.length;
+			if (start < 0) start = Math.max(0, start + this.original.length);
+			if (end < 0) end = Math.max(0, end + this.original.length);
 		}
 		if (start < 0) throw new MagicStringError(`start ${start} is out of bounds`);
 		if (end > this.original.length) throw new MagicStringError(`end ${end} is out of bounds`);
@@ -5669,8 +5674,8 @@ var MagicString = class MagicString {
 		start = start + this.offset;
 		end = end + this.offset;
 		if (this.original.length !== 0) {
-			while (start < 0) start += this.original.length;
-			while (end < 0) end += this.original.length;
+			if (start < 0) start = Math.max(0, start + this.original.length);
+			if (end < 0) end = Math.max(0, end + this.original.length);
 		}
 		if (start === end) return this;
 		if (start < 0 || end > this.original.length) throw new MagicStringError(`range ${start}–${end} is out of bounds`);
@@ -5693,8 +5698,8 @@ var MagicString = class MagicString {
 		start = start + this.offset;
 		end = end + this.offset;
 		if (this.original.length !== 0) {
-			while (start < 0) start += this.original.length;
-			while (end < 0) end += this.original.length;
+			if (start < 0) start = Math.max(0, start + this.original.length);
+			if (end < 0) end = Math.max(0, end + this.original.length);
 		}
 		if (start === end) return this;
 		if (start < 0 || end > this.original.length) throw new MagicStringError(`range ${start}–${end} is out of bounds`);
@@ -5755,8 +5760,8 @@ var MagicString = class MagicString {
 		start = start + this.offset;
 		end = end + this.offset;
 		if (this.original.length !== 0) {
-			while (start < 0) start += this.original.length;
-			while (end < 0) end += this.original.length;
+			if (start < 0) start = Math.max(0, start + this.original.length);
+			if (end < 0) end = Math.max(0, end + this.original.length);
 		}
 		let result = "";
 		let chunk = this.firstChunk;
@@ -5942,27 +5947,19 @@ var MagicString = class MagicString {
 			});
 			else return replacement(match[0], ...match.slice(1), match.index, str, match.groups);
 		}
-		function matchAll(re, str) {
-			const matches = [];
-			while (true) {
-				const match = re.exec(str);
-				if (!match) break;
-				matches.push(match);
-			}
-			return matches;
-		}
-		if (searchValue.global) matchAll(searchValue, this.original).forEach((match) => {
-			if (match.index != null) {
-				const replacement = getReplacement(match, this.original);
-				if (replacement !== match[0]) this.overwrite(match.index, match.index + match[0].length, replacement);
-			}
-		});
-		else {
+		const replaceMatch = (match) => {
+			if (match.index == null) return;
+			const replacement = getReplacement(match, this.original);
+			if (replacement === match[0]) return;
+			if (match[0].length === 0) this.appendRight(match.index, replacement);
+			else this.overwrite(match.index, match.index + match[0].length, replacement);
+		};
+		if (searchValue.global) {
+			searchValue.lastIndex = 0;
+			for (const match of this.original.matchAll(searchValue)) replaceMatch(match);
+		} else {
 			const match = this.original.match(searchValue);
-			if (match && match.index != null) {
-				const replacement = getReplacement(match, this.original);
-				if (replacement !== match[0]) this.overwrite(match.index, match.index + match[0].length, replacement);
-			}
+			if (match) replaceMatch(match);
 		}
 		return this;
 	}
@@ -5972,7 +5969,8 @@ var MagicString = class MagicString {
 		const index = original.indexOf(string);
 		if (index !== -1) {
 			if (typeof replacement === "function") replacement = replacement(string, index, original);
-			if (string !== replacement) this.overwrite(index, index + string.length, replacement);
+			if (string !== replacement) if (string.length === 0) this.appendRight(index, replacement);
+			else this.overwrite(index, index + string.length, replacement);
 		}
 		return this;
 	}
@@ -5987,6 +5985,13 @@ var MagicString = class MagicString {
 	_replaceAllString(string, replacement) {
 		const { original } = this;
 		const stringLength = string.length;
+		if (stringLength === 0) {
+			for (let index = 0; index <= original.length; index += 1) {
+				const _replacement = typeof replacement === "function" ? replacement("", index, original) : replacement;
+				if (_replacement !== "") this.appendRight(index, _replacement);
+			}
+			return this;
+		}
 		for (let index = original.indexOf(string); index !== -1; index = original.indexOf(string, index + stringLength)) {
 			const previous = original.slice(index, index + stringLength);
 			const _replacement = typeof replacement === "function" ? replacement(previous, index, original) : replacement;
@@ -10797,7 +10802,7 @@ function validateKeyFormat(key) {
 * The holding server is started in rootSync's config() hook (the
 * earliest Vite plugin lifecycle point where we know the port) and
 * closed directly in timber-dev-server's configureServer() hook
-* (the last plugin, fire-and-forget). configureServer runs during
+* (the last plugin, awaited). configureServer runs during
 * createServer(), well before Vite's port probe and bind, so the
 * port is free by the time httpServerStart() runs. (TIM-1419)
 *
@@ -10881,22 +10886,9 @@ var HOLDING_PAGE_HTML = [
 /**
 * Create a holding HTTP server that serves a loading page during startup.
 *
-* Usage (inside Vite plugin):
-* ```ts
-* // In config() hook — earliest point where port is known.
-* // Use bindWithBump() to honor the default-3000 + auto-bump policy
-* // (see ../server/port-resolution.ts and TIM-842).
-* const holding = createHoldingServer();
-* await bindWithBump((p) => holding.listen(p), { startPort: 3000, autoBump: true });
-*
-* // In last plugin's configureServer() — close directly so Vite 8's
-* // isPortAvailable() probe and httpServer.listen() both see a free
-* // port. SO_REUSEADDR allows immediate rebind. (TIM-1419)
-* if (ctx.holdingServer) {
-*   ctx.holdingServer.close().catch(() => {});
-*   ctx.holdingServer = null;
-* }
-* ```
+* The config hook attempts one bind on the requested port. If it fails,
+* startup continues without the holding page; Vite owns port selection.
+* The last configureServer hook awaits close() before Vite probes/binds.
 */
 function createHoldingServer() {
 	const server = nodeHTTP.createServer((req, res) => {
@@ -10942,33 +10934,10 @@ function createHoldingServer() {
 		}
 	};
 }
-//#endregion
-//#region src/server/port-resolution.ts
-/**
-* Port resolution for the dev server, Vite preview, and the Node
-* production preview server.
-*
-* Behavior (see TIM-842):
-*
-*   1. Default port is **3000** for both dev and prod.
-*   2. If the user did NOT set an explicit port, auto-bump from 3000
-*      until a free port is found (3000 → 3001 → 3002 → …).
-*   3. If the user DID set an explicit port (via `--port`, `PORT` env
-*      var, or `vite.config.ts` `server.port`), use it as-is and let
-*      the bind fail loudly on conflict (`strictPort: true`).
-*
-* The port-bump probe is performed by binding the **actual** server
-* (e.g. the dev holding server) — not a throwaway probe — so there is
-* no time-of-check / time-of-use race between probing and listening.
-*
-* Design doc: 21-dev-server.md §"Default Port and Auto-Bump".
-*/
-/** Default port used by `timber dev` and `timber preview`. */
-var DEFAULT_PORT = 3e3;
 /**
 * Pure: compute the starting port from config / env / defaults.
 *
-* Performs no I/O — pair with {@link bindWithBump} to actually listen.
+* Performs no I/O.
 */
 function resolveStartPort(input) {
 	const defaultPort = input.defaultPort ?? 3e3;
@@ -10988,76 +10957,6 @@ function resolveStartPort(input) {
 		explicit: false
 	};
 }
-/**
-* Bind a server starting at `startPort`, optionally bumping the port
-* on `EADDRINUSE` until a free one is found.
-*
-* Use this with the actual server you intend to keep listening (e.g.
-* the dev holding server). Pairing the probe with the real listen
-* eliminates the TOCTOU race that a throwaway probe would introduce.
-*/
-async function bindWithBump(listen, options) {
-	const maxAttempts = options.autoBump ? options.maxAttempts ?? 100 : 1;
-	let lastErr = null;
-	for (let i = 0; i < maxAttempts; i++) {
-		const port = options.startPort + i;
-		try {
-			return {
-				port: await listen(port),
-				bumped: i > 0
-			};
-		} catch (err) {
-			lastErr = err;
-			if (!isAddrInUse(err)) throw err;
-		}
-	}
-	throw lastErr ?? /* @__PURE__ */ new Error(`Could not bind to a free port starting at ${options.startPort}`);
-}
-/** True if `err` is a Node `EADDRINUSE` error from `server.listen()`. */
-function isAddrInUse(err) {
-	return typeof err === "object" && err !== null && err.code === "EADDRINUSE";
-}
-/**
-* Run the full dev-server port resolution + holding-server bind sequence.
-*
-* Resolves the port from config / env / default, attempts to bind the
-* holding server (auto-bumping when the port came from the default),
-* and logs the chosen URL. On a clean failure for an explicit port, it
-* warns and falls back to the requested port so Vite can surface the
-* conflict via `strictPort: true`.
-*
-* Extracted from `index.ts` so the rootSync `config()` hook stays
-* focused on plugin assembly.
-*/
-async function startDevServerPort(input) {
-	const log = input.log ?? ((msg) => console.log(msg));
-	const warn = input.warn ?? ((msg) => console.warn(msg));
-	const start = resolveStartPort({
-		configPort: input.configPort,
-		envPort: input.envPort,
-		defaultPort: DEFAULT_PORT
-	});
-	try {
-		const result = await bindWithBump(input.listen, {
-			startPort: start.port,
-			autoBump: !start.explicit
-		});
-		if (result.bumped) log(`\n  \x1b[33m[timber]\x1b[0m Port ${start.port} in use, using ${result.port}\n`);
-		log(`\n  \x1b[2m\u{1FAB5} timber.js dev server starting at\x1b[0m \x1b[36mhttp://localhost:${result.port}\x1b[0m\n`);
-		return {
-			port: result.port,
-			explicit: start.explicit,
-			bound: true
-		};
-	} catch (err) {
-		if (start.explicit && isAddrInUse(err)) warn(`\n  \x1b[33m[timber]\x1b[0m Port ${start.port} is already in use. Set PORT (or remove the override) to pick another port.\n`);
-		return {
-			port: start.port,
-			explicit: start.explicit,
-			bound: false
-		};
-	}
-}
 //#endregion
 //#region src/index.ts
 /**
@@ -11178,18 +11077,18 @@ function timber(config) {
 			const isMiddlewareMode = Boolean(userConfig.server?.middlewareMode);
 			const resolvedHost = typeof userConfig.server?.host === "string" ? userConfig.server.host : userConfig.server?.host === true ? void 0 : "localhost";
 			if (command === "serve" && !isPreview && !isMiddlewareMode) {
-				ctx.holdingServer = createHoldingServer();
-				const holdingRef = ctx.holdingServer;
-				const result = await startDevServerPort({
-					configPort: typeof userConfig.server?.port === "number" ? userConfig.server.port : void 0,
-					envPort: process.env.PORT,
-					listen: (p) => holdingRef.listen(p, resolvedHost)
+				const start = resolveStartPort({
+					configPort: userConfig.server?.port,
+					envPort: process.env.PORT
 				});
-				if (!result.bound) ctx.holdingServer = null;
-				if (result.bound) {
-					resolvedDevPort = result.port;
-					resolvedDevPortExplicit = result.explicit;
-				} else if (result.explicit) resolvedDevPort = result.port;
+				resolvedDevPort = start.port;
+				resolvedDevPortExplicit = userConfig.server?.strictPort ?? false;
+				if (start.port !== 0) {
+					ctx.holdingServer = createHoldingServer();
+					await ctx.holdingServer.listen(start.port, resolvedHost).catch(() => {
+						ctx.holdingServer = null;
+					});
+				}
 			} else if (command === "serve" && isPreview) {
 				const start = resolveStartPort({
 					configPort: typeof userConfig.preview?.port === "number" ? userConfig.preview.port : typeof userConfig.server?.port === "number" ? userConfig.server.port : void 0,