vinext 0.0.47 → 0.0.48

package/dist/shims/slot.js.map

@@ -1 +1 @@
-{"version":3,"file":"slot.js","names":["React"],"sources":["../../src/shims/slot.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport { UNMATCHED_SLOT, type AppElementValue, type AppElements } from \"../server/app-elements.js\";\nimport { notFound } from \"./navigation.js\";\n\nconst EMPTY_ELEMENTS: AppElements = Object.freeze({});\nconst warnedMissingEntryIds = new Set<string>();\n\nexport { UNMATCHED_SLOT };\n\n/**\n * Holds resolved AppElements (not a Promise). React 19's use(Promise) during\n * hydration triggers \"async Client Component\" for native Promises that lack\n * React's internal .status property. Storing resolved values sidesteps this.\n */\nexport const ElementsContext = React.createContext<AppElements>(EMPTY_ELEMENTS);\n\nexport const ChildrenContext = React.createContext<React.ReactNode>(null);\n\nexport const ParallelSlotsContext = React.createContext<Readonly<\n  Record<string, React.ReactNode>\n> | null>(null);\n\nexport function mergeElements(\n  prev: AppElements,\n  next: AppElements,\n  clearAbsentSlots = false,\n): AppElements {\n  const merged: Record<string, AppElementValue> = { ...prev, ...next };\n  // On soft navigation, unmatched parallel slots preserve their previous subtree\n  // instead of firing notFound(). Only hard navigation (full page load) should 404.\n  // This matches Next.js behavior for parallel route persistence.\n  for (const key of Object.keys(merged)) {\n    if (key.startsWith(\"slot:\") && merged[key] === UNMATCHED_SLOT && Object.hasOwn(prev, key)) {\n      merged[key] = prev[key];\n    }\n  }\n  // On traversal (browser back/forward), the server renders the full destination\n  // route tree. A slot absent from next means the destination route tree does not\n  // include it, so clear it rather than keeping the stale prev value. This only\n  // runs for traversals because soft forward navigations may omit parent layout\n  // slots that should be preserved.\n  if (clearAbsentSlots) {\n    for (const key of Object.keys(merged)) {\n      if (key.startsWith(\"slot:\") && !Object.hasOwn(next, key)) {\n        delete merged[key];\n      }\n    }\n  }\n  return merged;\n}\n\nexport function Slot({\n  id,\n  children,\n  parallelSlots,\n}: {\n  id: string;\n  children?: React.ReactNode;\n  parallelSlots?: Readonly<Record<string, React.ReactNode>>;\n}) {\n  const elements = React.useContext(ElementsContext);\n\n  if (!Object.hasOwn(elements, id)) {\n    if (process.env.NODE_ENV !== \"production\" && !id.startsWith(\"slot:\")) {\n      if (!warnedMissingEntryIds.has(id)) {\n        warnedMissingEntryIds.add(id);\n        console.warn(\"[vinext] Missing App Router element entry during render: \" + id);\n      }\n    }\n    return null;\n  }\n\n  const element = elements[id];\n  if (element === UNMATCHED_SLOT) {\n    notFound();\n  }\n\n  return (\n    <ParallelSlotsContext.Provider value={parallelSlots ?? null}>\n      <ChildrenContext.Provider value={children ?? null}>{element}</ChildrenContext.Provider>\n    </ParallelSlotsContext.Provider>\n  );\n}\n\nexport function Children() {\n  return React.useContext(ChildrenContext);\n}\n\nexport function ParallelSlot({ name }: { name: string }) {\n  const slots = React.useContext(ParallelSlotsContext);\n  return slots?.[name] ?? null;\n}\n"],"mappings":";;;;;;AAMA,MAAM,iBAA8B,OAAO,OAAO,EAAE,CAAC;AACrD,MAAM,wCAAwB,IAAI,KAAa;;;;;;AAS/C,MAAa,kBAAkBA,QAAM,cAA2B,eAAe;AAE/E,MAAa,kBAAkBA,QAAM,cAA+B,KAAK;AAEzE,MAAa,uBAAuBA,QAAM,cAEhC,KAAK;AAEf,SAAgB,cACd,MACA,MACA,mBAAmB,OACN;CACb,MAAM,SAA0C;EAAE,GAAG;EAAM,GAAG;EAAM;AAIpE,MAAK,MAAM,OAAO,OAAO,KAAK,OAAO,CACnC,KAAI,IAAI,WAAW,QAAQ,IAAI,OAAO,SAAS,kBAAkB,OAAO,OAAO,MAAM,IAAI,CACvF,QAAO,OAAO,KAAK;AAQvB,KAAI;OACG,MAAM,OAAO,OAAO,KAAK,OAAO,CACnC,KAAI,IAAI,WAAW,QAAQ,IAAI,CAAC,OAAO,OAAO,MAAM,IAAI,CACtD,QAAO,OAAO;;AAIpB,QAAO;;AAGT,SAAgB,KAAK,EACnB,IACA,UACA,iBAKC;CACD,MAAM,WAAWA,QAAM,WAAW,gBAAgB;AAElD,KAAI,CAAC,OAAO,OAAO,UAAU,GAAG,EAAE;AAChC,MAAI,QAAQ,IAAI,aAAa,gBAAgB,CAAC,GAAG,WAAW,QAAQ;OAC9D,CAAC,sBAAsB,IAAI,GAAG,EAAE;AAClC,0BAAsB,IAAI,GAAG;AAC7B,YAAQ,KAAK,8DAA8D,GAAG;;;AAGlF,SAAO;;CAGT,MAAM,UAAU,SAAS;AACzB,KAAI,YAAY,eACd,WAAU;AAGZ,QACE,oBAAC,qBAAqB,UAAtB;EAA+B,OAAO,iBAAiB;YACrD,oBAAC,gBAAgB,UAAjB;GAA0B,OAAO,YAAY;aAAO;GAAmC,CAAA;EACzD,CAAA;;AAIpC,SAAgB,WAAW;AACzB,QAAOA,QAAM,WAAW,gBAAgB;;AAG1C,SAAgB,aAAa,EAAE,QAA0B;AAEvD,QADcA,QAAM,WAAW,qBAAqB,GACrC,SAAS"}
+{"version":3,"file":"slot.js","names":["React"],"sources":["../../src/shims/slot.tsx"],"sourcesContent":["\"use client\";\n\nimport * as React from \"react\";\nimport {\n  AppElementsWire,\n  UNMATCHED_SLOT,\n  type AppElementValue,\n  type AppElements,\n} from \"../server/app-elements.js\";\nimport { notFound } from \"./navigation.js\";\n\nconst EMPTY_ELEMENTS: AppElements = Object.freeze({});\nconst warnedMissingEntryIds = new Set<string>();\n\nexport { UNMATCHED_SLOT };\n\n/**\n * Holds resolved AppElements (not a Promise). React 19's use(Promise) during\n * hydration triggers \"async Client Component\" for native Promises that lack\n * React's internal .status property. Storing resolved values sidesteps this.\n */\nexport const ElementsContext = React.createContext<AppElements>(EMPTY_ELEMENTS);\n\nexport const ChildrenContext = React.createContext<React.ReactNode>(null);\n\nexport const ParallelSlotsContext = React.createContext<Readonly<\n  Record<string, React.ReactNode>\n> | null>(null);\n\nexport function mergeElements(\n  prev: AppElements,\n  next: AppElements,\n  clearAbsentSlots = false,\n): AppElements {\n  const merged: Record<string, AppElementValue> = { ...prev, ...next };\n  // On soft navigation, unmatched parallel slots preserve their previous subtree\n  // instead of firing notFound(). Only hard navigation (full page load) should 404.\n  // This matches Next.js behavior for parallel route persistence.\n  for (const key of Object.keys(merged)) {\n    if (\n      AppElementsWire.isSlotId(key) &&\n      merged[key] === UNMATCHED_SLOT &&\n      Object.hasOwn(prev, key)\n    ) {\n      merged[key] = prev[key];\n    }\n  }\n  // On traversal (browser back/forward), the server renders the full destination\n  // route tree. A slot absent from next means the destination route tree does not\n  // include it, so clear it rather than keeping the stale prev value. This only\n  // runs for traversals because soft forward navigations may omit parent layout\n  // slots that should be preserved.\n  if (clearAbsentSlots) {\n    for (const key of Object.keys(merged)) {\n      if (AppElementsWire.isSlotId(key) && !Object.hasOwn(next, key)) {\n        delete merged[key];\n      }\n    }\n  }\n  return merged;\n}\n\nexport function Slot({\n  id,\n  children,\n  parallelSlots,\n}: {\n  id: string;\n  children?: React.ReactNode;\n  parallelSlots?: Readonly<Record<string, React.ReactNode>>;\n}) {\n  const elements = React.useContext(ElementsContext);\n\n  if (!Object.hasOwn(elements, id)) {\n    if (process.env.NODE_ENV !== \"production\" && !AppElementsWire.isSlotId(id)) {\n      if (!warnedMissingEntryIds.has(id)) {\n        warnedMissingEntryIds.add(id);\n        console.warn(\"[vinext] Missing App Router element entry during render: \" + id);\n      }\n    }\n    return null;\n  }\n\n  const element = elements[id];\n  if (element === UNMATCHED_SLOT) {\n    notFound();\n  }\n\n  return (\n    <ParallelSlotsContext.Provider value={parallelSlots ?? null}>\n      <ChildrenContext.Provider value={children ?? null}>{element}</ChildrenContext.Provider>\n    </ParallelSlotsContext.Provider>\n  );\n}\n\nexport function Children() {\n  return React.useContext(ChildrenContext);\n}\n\nexport function ParallelSlot({ name }: { name: string }) {\n  const slots = React.useContext(ParallelSlotsContext);\n  return slots?.[name] ?? null;\n}\n"],"mappings":";;;;;;;AAWA,MAAM,iBAA8B,OAAO,OAAO,EAAE,CAAC;AACrD,MAAM,wCAAwB,IAAI,KAAa;;;;;;AAS/C,MAAa,kBAAkBA,QAAM,cAA2B,eAAe;AAE/E,MAAa,kBAAkBA,QAAM,cAA+B,KAAK;AAEzE,MAAa,uBAAuBA,QAAM,cAEhC,KAAK;AAEf,SAAgB,cACd,MACA,MACA,mBAAmB,OACN;CACb,MAAM,SAA0C;EAAE,GAAG;EAAM,GAAG;EAAM;AAIpE,MAAK,MAAM,OAAO,OAAO,KAAK,OAAO,CACnC,KACE,gBAAgB,SAAS,IAAI,IAC7B,OAAO,SAAS,kBAChB,OAAO,OAAO,MAAM,IAAI,CAExB,QAAO,OAAO,KAAK;AAQvB,KAAI;OACG,MAAM,OAAO,OAAO,KAAK,OAAO,CACnC,KAAI,gBAAgB,SAAS,IAAI,IAAI,CAAC,OAAO,OAAO,MAAM,IAAI,CAC5D,QAAO,OAAO;;AAIpB,QAAO;;AAGT,SAAgB,KAAK,EACnB,IACA,UACA,iBAKC;CACD,MAAM,WAAWA,QAAM,WAAW,gBAAgB;AAElD,KAAI,CAAC,OAAO,OAAO,UAAU,GAAG,EAAE;AAChC,MAAI,QAAQ,IAAI,aAAa,gBAAgB,CAAC,gBAAgB,SAAS,GAAG;OACpE,CAAC,sBAAsB,IAAI,GAAG,EAAE;AAClC,0BAAsB,IAAI,GAAG;AAC7B,YAAQ,KAAK,8DAA8D,GAAG;;;AAGlF,SAAO;;CAGT,MAAM,UAAU,SAAS;AACzB,KAAI,YAAY,eACd,WAAU;AAGZ,QACE,oBAAC,qBAAqB,UAAtB;EAA+B,OAAO,iBAAiB;YACrD,oBAAC,gBAAgB,UAAjB;GAA0B,OAAO,YAAY;aAAO;GAAmC,CAAA;EACzD,CAAA;;AAIpC,SAAgB,WAAW;AACzB,QAAOA,QAAM,WAAW,gBAAgB;;AAG1C,SAAgB,aAAa,EAAE,QAA0B;AAEvD,QADcA,QAAM,WAAW,qBAAqB,GACrC,SAAS"}

package/dist/shims/thenable-params.d.ts

@@ -1,5 +1,8 @@
 //#region src/shims/thenable-params.d.ts
-declare function makeThenableParams<T extends Record<string, unknown>>(obj: T): Promise<Awaited<T>>;
+declare const WELL_KNOWN_PROPERTIES: readonly ["hasOwnProperty", "isPrototypeOf", "propertyIsEnumerable", "toString", "valueOf", "toLocaleString", "then", "catch", "finally", "status", "value", "error", "displayName", "_debugInfo", "toJSON", "$$typeof", "__esModule", "@@iterator"];
+type WellKnownProperty = (typeof WELL_KNOWN_PROPERTIES)[number];
+type ThenableParams<T extends Record<string, unknown>> = Promise<T> & Omit<T, WellKnownProperty>;
+declare function makeThenableParams<T extends Record<string, unknown>>(obj: T): ThenableParams<T>;
 //#endregion
-export { makeThenableParams };
+export { ThenableParams, makeThenableParams };
 //# sourceMappingURL=thenable-params.d.ts.map

package/dist/shims/thenable-params.js

@@ -2,20 +2,40 @@
 function hasParamProperty(obj, prop) {
 	return Object.prototype.hasOwnProperty.call(obj, prop);
 }
-function isPromiseMethod(prop) {
-	return prop === "then" || prop === "catch" || prop === "finally";
+const wellKnownProperties = new Set([
+	"hasOwnProperty",
+	"isPrototypeOf",
+	"propertyIsEnumerable",
+	"toString",
+	"valueOf",
+	"toLocaleString",
+	"then",
+	"catch",
+	"finally",
+	"status",
+	"value",
+	"error",
+	"displayName",
+	"_debugInfo",
+	"toJSON",
+	"$$typeof",
+	"__esModule",
+	"@@iterator"
+]);
+function isWellKnownProperty(prop) {
+	return wellKnownProperties.has(prop);
 }
 function makeThenableParams(obj) {
 	const plain = { ...obj };
 	const promise = Promise.resolve(plain);
 	return new Proxy(promise, {
 		get(target, prop, receiver) {
-			if (!isPromiseMethod(prop) && hasParamProperty(plain, prop)) return Reflect.get(plain, prop);
+			if (!isWellKnownProperty(prop) && hasParamProperty(plain, prop)) return Reflect.get(plain, prop);
 			const value = Reflect.get(target, prop, receiver);
 			return typeof value === "function" ? value.bind(target) : value;
 		},
 		getOwnPropertyDescriptor(target, prop) {
-			if (!isPromiseMethod(prop) && hasParamProperty(plain, prop)) return {
+			if (!isWellKnownProperty(prop) && hasParamProperty(plain, prop)) return {
 				configurable: true,
 				enumerable: true,
 				value: Reflect.get(plain, prop),
@@ -24,10 +44,10 @@ function makeThenableParams(obj) {
 			return Reflect.getOwnPropertyDescriptor(target, prop);
 		},
 		has(target, prop) {
-			return Reflect.has(target, prop) || hasParamProperty(plain, prop);
+			return Reflect.has(target, prop) || !isWellKnownProperty(prop) && hasParamProperty(plain, prop);
 		},
 		ownKeys() {
-			return Reflect.ownKeys(plain).filter((prop) => !isPromiseMethod(prop));
+			return Reflect.ownKeys(plain).filter((prop) => !isWellKnownProperty(prop));
 		}
 	});
 }

package/dist/shims/thenable-params.js.map

@@ -1 +1 @@
-{"version":3,"file":"thenable-params.js","names":[],"sources":["../../src/shims/thenable-params.ts"],"sourcesContent":["function hasParamProperty<T extends Record<string, unknown>>(obj: T, prop: PropertyKey): boolean {\n  return Object.prototype.hasOwnProperty.call(obj, prop);\n}\n\nfunction isPromiseMethod(prop: PropertyKey): boolean {\n  return prop === \"then\" || prop === \"catch\" || prop === \"finally\";\n}\n\nexport function makeThenableParams<T extends Record<string, unknown>>(obj: T) {\n  const plain = { ...obj };\n  const promise = Promise.resolve(plain);\n\n  return new Proxy(promise, {\n    get(target, prop, receiver) {\n      if (!isPromiseMethod(prop) && hasParamProperty(plain, prop)) {\n        return Reflect.get(plain, prop);\n      }\n\n      const value = Reflect.get(target, prop, receiver);\n      return typeof value === \"function\" ? value.bind(target) : value;\n    },\n    getOwnPropertyDescriptor(target, prop) {\n      if (!isPromiseMethod(prop) && hasParamProperty(plain, prop)) {\n        return {\n          configurable: true,\n          enumerable: true,\n          value: Reflect.get(plain, prop),\n          writable: true,\n        };\n      }\n\n      return Reflect.getOwnPropertyDescriptor(target, prop);\n    },\n    has(target, prop) {\n      return Reflect.has(target, prop) || hasParamProperty(plain, prop);\n    },\n    ownKeys() {\n      return Reflect.ownKeys(plain).filter((prop) => !isPromiseMethod(prop));\n    },\n  });\n}\n"],"mappings":";AAAA,SAAS,iBAAoD,KAAQ,MAA4B;AAC/F,QAAO,OAAO,UAAU,eAAe,KAAK,KAAK,KAAK;;AAGxD,SAAS,gBAAgB,MAA4B;AACnD,QAAO,SAAS,UAAU,SAAS,WAAW,SAAS;;AAGzD,SAAgB,mBAAsD,KAAQ;CAC5E,MAAM,QAAQ,EAAE,GAAG,KAAK;CACxB,MAAM,UAAU,QAAQ,QAAQ,MAAM;AAEtC,QAAO,IAAI,MAAM,SAAS;EACxB,IAAI,QAAQ,MAAM,UAAU;AAC1B,OAAI,CAAC,gBAAgB,KAAK,IAAI,iBAAiB,OAAO,KAAK,CACzD,QAAO,QAAQ,IAAI,OAAO,KAAK;GAGjC,MAAM,QAAQ,QAAQ,IAAI,QAAQ,MAAM,SAAS;AACjD,UAAO,OAAO,UAAU,aAAa,MAAM,KAAK,OAAO,GAAG;;EAE5D,yBAAyB,QAAQ,MAAM;AACrC,OAAI,CAAC,gBAAgB,KAAK,IAAI,iBAAiB,OAAO,KAAK,CACzD,QAAO;IACL,cAAc;IACd,YAAY;IACZ,OAAO,QAAQ,IAAI,OAAO,KAAK;IAC/B,UAAU;IACX;AAGH,UAAO,QAAQ,yBAAyB,QAAQ,KAAK;;EAEvD,IAAI,QAAQ,MAAM;AAChB,UAAO,QAAQ,IAAI,QAAQ,KAAK,IAAI,iBAAiB,OAAO,KAAK;;EAEnE,UAAU;AACR,UAAO,QAAQ,QAAQ,MAAM,CAAC,QAAQ,SAAS,CAAC,gBAAgB,KAAK,CAAC;;EAEzE,CAAC"}
+{"version":3,"file":"thenable-params.js","names":[],"sources":["../../src/shims/thenable-params.ts"],"sourcesContent":["function hasParamProperty<T extends Record<string, unknown>>(obj: T, prop: PropertyKey): boolean {\n  return Object.prototype.hasOwnProperty.call(obj, prop);\n}\n\n// Properties that cannot be shadowed by param names because they need to\n// remain the true underlying value for Promises / React to work correctly.\n//\n// Next.js comments out `value` and `error` in reflect-utils.ts because they\n// use `Promise.resolve(underlyingParams)` directly in production, so React\n// mutations on the promise object are never shadowed. vinext uses a Proxy\n// that intercepts sync reads through a separate `plain` object, which means\n// a param named `value` or `error` would shadow React's `.status`/`.value`\n// attachments that React adds to resolved promises for `use()` caching.\n// https://github.com/vercel/next.js/blob/canary/packages/next/src/shared/lib/utils/reflect-utils.ts\nconst WELL_KNOWN_PROPERTIES = [\n  // Object prototype\n  \"hasOwnProperty\",\n  \"isPrototypeOf\",\n  \"propertyIsEnumerable\",\n  \"toString\",\n  \"valueOf\",\n  \"toLocaleString\",\n\n  // Promise prototype\n  \"then\",\n  \"catch\",\n  \"finally\",\n\n  // React Promise extension (status is explicitly reserved by Next.js;\n  // value/error are reserved here because our Proxy-based approach creates\n  // a shadowing risk that native Promise does not have)\n  \"status\",\n  \"value\",\n  \"error\",\n\n  // React introspection\n  \"displayName\",\n  \"_debugInfo\",\n\n  // Common tested properties\n  \"toJSON\",\n  \"$$typeof\",\n  \"__esModule\",\n\n  // Tested by flight when checking for iterables\n  \"@@iterator\",\n] as const;\n\n// The type-level set of well-known properties is derived directly from the\n// runtime array above, so they can never drift out of sync. These properties\n// are omitted from the synchronous intersection because the Proxy returns\n// Promise/React internals for them, not the param value. After awaiting, the\n// resolved object contains the actual param values for all keys.\ntype WellKnownProperty = (typeof WELL_KNOWN_PROPERTIES)[number];\n\nconst wellKnownProperties = new Set<PropertyKey>(WELL_KNOWN_PROPERTIES);\n\nfunction isWellKnownProperty(prop: PropertyKey): boolean {\n  return wellKnownProperties.has(prop);\n}\n\nexport type ThenableParams<T extends Record<string, unknown>> = Promise<T> &\n  Omit<T, WellKnownProperty>;\n\nexport function makeThenableParams<T extends Record<string, unknown>>(obj: T): ThenableParams<T> {\n  const plain = { ...obj };\n  const promise = Promise.resolve(plain);\n\n  // The Proxy implements both Promise and plain-object behaviour so that\n  // `await params` and `params.id` both work. TypeScript's Proxy type\n  // cannot express this intersection precisely — the cast is isolated to\n  // the boundary so the handler above stays fully type-checked.\n  return new Proxy(promise, {\n    get(target, prop, receiver) {\n      if (!isWellKnownProperty(prop) && hasParamProperty(plain, prop)) {\n        return Reflect.get(plain, prop);\n      }\n\n      const value = Reflect.get(target, prop, receiver);\n      return typeof value === \"function\" ? value.bind(target) : value;\n    },\n    getOwnPropertyDescriptor(target, prop) {\n      if (!isWellKnownProperty(prop) && hasParamProperty(plain, prop)) {\n        return {\n          configurable: true,\n          enumerable: true,\n          value: Reflect.get(plain, prop),\n          writable: true,\n        };\n      }\n\n      return Reflect.getOwnPropertyDescriptor(target, prop);\n    },\n    has(target, prop) {\n      return (\n        Reflect.has(target, prop) || (!isWellKnownProperty(prop) && hasParamProperty(plain, prop))\n      );\n    },\n    ownKeys() {\n      return Reflect.ownKeys(plain).filter((prop) => !isWellKnownProperty(prop));\n    },\n  }) as unknown as ThenableParams<T>;\n}\n"],"mappings":";AAAA,SAAS,iBAAoD,KAAQ,MAA4B;AAC/F,QAAO,OAAO,UAAU,eAAe,KAAK,KAAK,KAAK;;AAsDxD,MAAM,sBAAsB,IAAI,IAzCF;CAE5B;CACA;CACA;CACA;CACA;CACA;CAGA;CACA;CACA;CAKA;CACA;CACA;CAGA;CACA;CAGA;CACA;CACA;CAGA;CACD,CASsE;AAEvE,SAAS,oBAAoB,MAA4B;AACvD,QAAO,oBAAoB,IAAI,KAAK;;AAMtC,SAAgB,mBAAsD,KAA2B;CAC/F,MAAM,QAAQ,EAAE,GAAG,KAAK;CACxB,MAAM,UAAU,QAAQ,QAAQ,MAAM;AAMtC,QAAO,IAAI,MAAM,SAAS;EACxB,IAAI,QAAQ,MAAM,UAAU;AAC1B,OAAI,CAAC,oBAAoB,KAAK,IAAI,iBAAiB,OAAO,KAAK,CAC7D,QAAO,QAAQ,IAAI,OAAO,KAAK;GAGjC,MAAM,QAAQ,QAAQ,IAAI,QAAQ,MAAM,SAAS;AACjD,UAAO,OAAO,UAAU,aAAa,MAAM,KAAK,OAAO,GAAG;;EAE5D,yBAAyB,QAAQ,MAAM;AACrC,OAAI,CAAC,oBAAoB,KAAK,IAAI,iBAAiB,OAAO,KAAK,CAC7D,QAAO;IACL,cAAc;IACd,YAAY;IACZ,OAAO,QAAQ,IAAI,OAAO,KAAK;IAC/B,UAAU;IACX;AAGH,UAAO,QAAQ,yBAAyB,QAAQ,KAAK;;EAEvD,IAAI,QAAQ,MAAM;AAChB,UACE,QAAQ,IAAI,QAAQ,KAAK,IAAK,CAAC,oBAAoB,KAAK,IAAI,iBAAiB,OAAO,KAAK;;EAG7F,UAAU;AACR,UAAO,QAAQ,QAAQ,MAAM,CAAC,QAAQ,SAAS,CAAC,oBAAoB,KAAK,CAAC;;EAE7E,CAAC"}

package/dist/shims/unified-request-context.js

@@ -1,20 +1,8 @@
-import { AsyncLocalStorage } from "node:async_hooks";
+import { getOrCreateAls } from "./internal/als-registry.js";
 //#region src/shims/unified-request-context.ts
-/**
-* Unified per-request context backed by a single AsyncLocalStorage.
-*
-* Consolidates the 5–6 nested ALS scopes that previously wrapped every
-* App Router request (headers, navigation, cache-state, private-cache,
-* fetch-cache, execution-context) into one flat store.
-*
-* Each shim module checks `isInsideUnifiedScope()` and reads its sub-fields
-* from the unified store, falling back to its own standalone ALS when
-* outside (SSR environment, Pages Router, tests).
-*/
-const _ALS_KEY = Symbol.for("vinext.unifiedRequestContext.als");
 const _REQUEST_CONTEXT_ALS_KEY = Symbol.for("vinext.requestContext.als");
 const _g = globalThis;
-const _als = _g[_ALS_KEY] ??= new AsyncLocalStorage();
+const _als = getOrCreateAls("vinext.unifiedRequestContext.als");
 function _getInheritedExecutionContext() {
 	const unifiedStore = _als.getStore();
 	if (unifiedStore) return unifiedStore.executionContext;

package/dist/shims/unified-request-context.js.map

@@ -1 +1 @@
-{"version":3,"file":"unified-request-context.js","names":[],"sources":["../../src/shims/unified-request-context.ts"],"sourcesContent":["/**\n * Unified per-request context backed by a single AsyncLocalStorage.\n *\n * Consolidates the 5–6 nested ALS scopes that previously wrapped every\n * App Router request (headers, navigation, cache-state, private-cache,\n * fetch-cache, execution-context) into one flat store.\n *\n * Each shim module checks `isInsideUnifiedScope()` and reads its sub-fields\n * from the unified store, falling back to its own standalone ALS when\n * outside (SSR environment, Pages Router, tests).\n */\n\nimport { AsyncLocalStorage } from \"node:async_hooks\";\nimport type {\n  CacheState,\n  ExecutionContextLike,\n  FetchCacheState,\n  HeadState,\n  I18nState,\n  NavigationState,\n  PrivateCacheState,\n  RouterState,\n  RootParamsState,\n  VinextHeadersShimState,\n} from \"./request-state-types.js\";\n\n// ---------------------------------------------------------------------------\n// Unified context shape\n// ---------------------------------------------------------------------------\n\n/**\n * Flat union of all per-request state previously spread across\n * VinextHeadersShimState, NavigationState, CacheState, PrivateCacheState,\n * FetchCacheState, and ExecutionContextLike.\n *\n * Each field group is documented with its source shim module.\n */\nexport type UnifiedRequestContext = {\n  // ── request-context.ts ─────────────────────────────────────────────\n  /** Cloudflare Workers ExecutionContext, or null on Node.js dev. */\n  executionContext: ExecutionContextLike | null;\n\n  // ── cache-for-request.ts ──────────────────────────────────────────\n  /** Per-request cache for cacheForRequest(). Keyed by factory function reference. */\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  requestCache: WeakMap<(...args: any[]) => any, unknown>;\n} & VinextHeadersShimState &\n  I18nState &\n  NavigationState &\n  CacheState &\n  PrivateCacheState &\n  FetchCacheState &\n  RouterState &\n  HeadState &\n  RootParamsState;\n\n// ---------------------------------------------------------------------------\n// ALS setup — stored on globalThis via Symbol.for so all Vite environments\n// (RSC/SSR/client) share the same instance.\n// ---------------------------------------------------------------------------\n\nconst _ALS_KEY = Symbol.for(\"vinext.unifiedRequestContext.als\");\nconst _REQUEST_CONTEXT_ALS_KEY = Symbol.for(\"vinext.requestContext.als\");\nconst _g = globalThis as unknown as Record<PropertyKey, unknown>;\nconst _als = (_g[_ALS_KEY] ??=\n  new AsyncLocalStorage<UnifiedRequestContext>()) as AsyncLocalStorage<UnifiedRequestContext>;\n\nfunction _getInheritedExecutionContext(): ExecutionContextLike | null {\n  const unifiedStore = _als.getStore();\n  if (unifiedStore) return unifiedStore.executionContext;\n\n  const executionContextAls = _g[_REQUEST_CONTEXT_ALS_KEY] as\n    | AsyncLocalStorage<ExecutionContextLike | null>\n    | undefined;\n  return executionContextAls?.getStore() ?? null;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Create a fresh `UnifiedRequestContext` with defaults for all fields.\n * Pass partial overrides for the fields you need to pre-populate.\n */\nexport function createRequestContext(opts?: Partial<UnifiedRequestContext>): UnifiedRequestContext {\n  return {\n    headersContext: null,\n    dynamicUsageDetected: false,\n    invalidDynamicUsageError: null,\n    pendingSetCookies: [],\n    draftModeCookieHeader: null,\n    phase: \"render\",\n    i18nContext: null,\n    serverContext: null,\n    serverInsertedHTMLCallbacks: [],\n    requestScopedCacheLife: null,\n    unstableCacheRevalidation: \"foreground\",\n    _privateCache: null,\n    currentRequestTags: [],\n    currentFetchSoftTags: [],\n    currentFetchCacheMode: null,\n    executionContext: _getInheritedExecutionContext(), // inherits from standalone ALS if present\n    requestCache: new WeakMap(),\n    ssrContext: null,\n    ssrHeadChildren: [],\n    rootParams: null,\n    ...opts,\n  };\n}\n\n/**\n * Run `fn` within a unified request context scope.\n * All shim modules will read/write their state from `ctx` for the\n * duration of the call, including async continuations.\n */\nexport function runWithRequestContext<T>(\n  ctx: UnifiedRequestContext,\n  fn: () => Promise<T>,\n): Promise<T>;\nexport function runWithRequestContext<T>(\n  ctx: UnifiedRequestContext,\n  fn: () => T | Promise<T>,\n): T | Promise<T>;\nexport function runWithRequestContext<T>(\n  ctx: UnifiedRequestContext,\n  fn: () => T | Promise<T>,\n): T | Promise<T> {\n  return _als.run(ctx, fn);\n}\n\n/**\n * Run `fn` in a nested unified scope derived from the current request context.\n * Used by legacy runWith* wrappers to reset or override one sub-state while\n * preserving proper async isolation for continuations created inside `fn`.\n * The child scope is a shallow clone of the parent store, so untouched fields\n * keep sharing their existing references while overridden slices can be reset.\n *\n * @internal\n */\nexport function runWithUnifiedStateMutation<T>(\n  mutate: (ctx: UnifiedRequestContext) => void,\n  fn: () => Promise<T>,\n): Promise<T>;\nexport function runWithUnifiedStateMutation<T>(\n  mutate: (ctx: UnifiedRequestContext) => void,\n  fn: () => T | Promise<T>,\n): T | Promise<T>;\nexport function runWithUnifiedStateMutation<T>(\n  mutate: (ctx: UnifiedRequestContext) => void,\n  fn: () => T | Promise<T>,\n): T | Promise<T> {\n  const parentCtx = _als.getStore();\n  if (!parentCtx) return fn();\n\n  const childCtx = { ...parentCtx };\n  // NOTE: This is a shallow clone. Array fields (pendingSetCookies,\n  // serverInsertedHTMLCallbacks, currentRequestTags, ssrHeadChildren), the\n  // _privateCache Map, requestCache WeakMap, and object fields (headersContext,\n  // i18nContext, serverContext, ssrContext, executionContext,\n  // requestScopedCacheLife) still share references with the parent until\n  // replaced. requestCache is intentionally shared — nested scopes within\n  // the same request should see the same cached values. The mutate\n  // callback must replace those reference-typed slices (for example\n  // `ctx.currentRequestTags = []`) rather than mutating them in-place (for\n  // example `ctx.currentRequestTags.push(...)`) or the parent scope will\n  // observe those changes too. Keep this enumeration in sync with\n  // UnifiedRequestContext: when adding a new reference-typed field, add it\n  // here too and verify callers still follow the replace-not-mutate rule.\n  mutate(childCtx);\n  return _als.run(childCtx, fn);\n}\n\n/**\n * Get the current unified request context.\n * Returns the ALS store when inside a `runWithRequestContext()` scope,\n * or a fresh detached context otherwise. Unlike the legacy per-shim fallback\n * singletons, this detached value is ephemeral — mutations do not persist\n * across calls. This is intentional to prevent state leakage outside request\n * scopes.\n *\n * Only direct callers observe this detached fallback. Shim `_getState()`\n * helpers should continue to gate on `isInsideUnifiedScope()` and fall back\n * to their standalone ALS/fallback singletons outside the unified scope.\n * If called inside a standalone `runWithExecutionContext()` scope, the\n * detached context still reflects that inherited `executionContext`.\n */\nexport function getRequestContext(): UnifiedRequestContext {\n  return _als.getStore() ?? createRequestContext();\n}\n\n/**\n * Check whether the current execution is inside a `runWithRequestContext()` scope.\n * Shim modules use this to decide whether to read from the unified store\n * or fall back to their own standalone ALS.\n */\nexport function isInsideUnifiedScope(): boolean {\n  return _als.getStore() != null;\n}\n"],"mappings":";;;;;;;;;;;;;AA6DA,MAAM,WAAW,OAAO,IAAI,mCAAmC;AAC/D,MAAM,2BAA2B,OAAO,IAAI,4BAA4B;AACxE,MAAM,KAAK;AACX,MAAM,OAAQ,GAAG,cACf,IAAI,mBAA0C;AAEhD,SAAS,gCAA6D;CACpE,MAAM,eAAe,KAAK,UAAU;AACpC,KAAI,aAAc,QAAO,aAAa;AAKtC,QAH4B,GAAG,2BAGH,UAAU,IAAI;;;;;;AAW5C,SAAgB,qBAAqB,MAA8D;AACjG,QAAO;EACL,gBAAgB;EAChB,sBAAsB;EACtB,0BAA0B;EAC1B,mBAAmB,EAAE;EACrB,uBAAuB;EACvB,OAAO;EACP,aAAa;EACb,eAAe;EACf,6BAA6B,EAAE;EAC/B,wBAAwB;EACxB,2BAA2B;EAC3B,eAAe;EACf,oBAAoB,EAAE;EACtB,sBAAsB,EAAE;EACxB,uBAAuB;EACvB,kBAAkB,+BAA+B;EACjD,8BAAc,IAAI,SAAS;EAC3B,YAAY;EACZ,iBAAiB,EAAE;EACnB,YAAY;EACZ,GAAG;EACJ;;AAgBH,SAAgB,sBACd,KACA,IACgB;AAChB,QAAO,KAAK,IAAI,KAAK,GAAG;;AAoB1B,SAAgB,4BACd,QACA,IACgB;CAChB,MAAM,YAAY,KAAK,UAAU;AACjC,KAAI,CAAC,UAAW,QAAO,IAAI;CAE3B,MAAM,WAAW,EAAE,GAAG,WAAW;AAcjC,QAAO,SAAS;AAChB,QAAO,KAAK,IAAI,UAAU,GAAG;;;;;;;;;;;;;;;;AAiB/B,SAAgB,oBAA2C;AACzD,QAAO,KAAK,UAAU,IAAI,sBAAsB;;;;;;;AAQlD,SAAgB,uBAAgC;AAC9C,QAAO,KAAK,UAAU,IAAI"}
+{"version":3,"file":"unified-request-context.js","names":[],"sources":["../../src/shims/unified-request-context.ts"],"sourcesContent":["/**\n * Unified per-request context backed by a single AsyncLocalStorage.\n *\n * Consolidates the 5–6 nested ALS scopes that previously wrapped every\n * App Router request (headers, navigation, cache-state, private-cache,\n * fetch-cache, execution-context) into one flat store.\n *\n * Each shim module checks `isInsideUnifiedScope()` and reads its sub-fields\n * from the unified store, falling back to its own standalone ALS when\n * outside (SSR environment, Pages Router, tests).\n */\n\nimport type { AsyncLocalStorage } from \"node:async_hooks\";\nimport { getOrCreateAls } from \"./internal/als-registry.js\";\nimport type {\n  CacheState,\n  ExecutionContextLike,\n  FetchCacheState,\n  HeadState,\n  I18nState,\n  NavigationState,\n  PrivateCacheState,\n  RouterState,\n  RootParamsState,\n  VinextHeadersShimState,\n} from \"./request-state-types.js\";\n\n// ---------------------------------------------------------------------------\n// Unified context shape\n// ---------------------------------------------------------------------------\n\n/**\n * Flat union of all per-request state previously spread across\n * VinextHeadersShimState, NavigationState, CacheState, PrivateCacheState,\n * FetchCacheState, and ExecutionContextLike.\n *\n * Each field group is documented with its source shim module.\n */\nexport type UnifiedRequestContext = {\n  // ── request-context.ts ─────────────────────────────────────────────\n  /** Cloudflare Workers ExecutionContext, or null on Node.js dev. */\n  executionContext: ExecutionContextLike | null;\n\n  // ── cache-for-request.ts ──────────────────────────────────────────\n  /** Per-request cache for cacheForRequest(). Keyed by factory function reference. */\n  // oxlint-disable-next-line @typescript-eslint/no-explicit-any\n  requestCache: WeakMap<(...args: any[]) => any, unknown>;\n} & VinextHeadersShimState &\n  I18nState &\n  NavigationState &\n  CacheState &\n  PrivateCacheState &\n  FetchCacheState &\n  RouterState &\n  HeadState &\n  RootParamsState;\n\n// ---------------------------------------------------------------------------\n// ALS setup — stored on globalThis via Symbol.for so all Vite environments\n// (RSC/SSR/client) share the same instance.\n// ---------------------------------------------------------------------------\n\nconst _REQUEST_CONTEXT_ALS_KEY = Symbol.for(\"vinext.requestContext.als\");\nconst _g = globalThis as unknown as Record<PropertyKey, unknown>;\nconst _als = getOrCreateAls<UnifiedRequestContext>(\"vinext.unifiedRequestContext.als\");\n\nfunction _getInheritedExecutionContext(): ExecutionContextLike | null {\n  const unifiedStore = _als.getStore();\n  if (unifiedStore) return unifiedStore.executionContext;\n\n  const executionContextAls = _g[_REQUEST_CONTEXT_ALS_KEY] as\n    | AsyncLocalStorage<ExecutionContextLike | null>\n    | undefined;\n  return executionContextAls?.getStore() ?? null;\n}\n\n// ---------------------------------------------------------------------------\n// Public API\n// ---------------------------------------------------------------------------\n\n/**\n * Create a fresh `UnifiedRequestContext` with defaults for all fields.\n * Pass partial overrides for the fields you need to pre-populate.\n */\nexport function createRequestContext(opts?: Partial<UnifiedRequestContext>): UnifiedRequestContext {\n  return {\n    headersContext: null,\n    dynamicUsageDetected: false,\n    invalidDynamicUsageError: null,\n    pendingSetCookies: [],\n    draftModeCookieHeader: null,\n    phase: \"render\",\n    i18nContext: null,\n    serverContext: null,\n    serverInsertedHTMLCallbacks: [],\n    requestScopedCacheLife: null,\n    unstableCacheRevalidation: \"foreground\",\n    _privateCache: null,\n    currentRequestTags: [],\n    currentFetchSoftTags: [],\n    currentFetchCacheMode: null,\n    executionContext: _getInheritedExecutionContext(), // inherits from standalone ALS if present\n    requestCache: new WeakMap(),\n    ssrContext: null,\n    ssrHeadChildren: [],\n    rootParams: null,\n    ...opts,\n  };\n}\n\n/**\n * Run `fn` within a unified request context scope.\n * All shim modules will read/write their state from `ctx` for the\n * duration of the call, including async continuations.\n */\nexport function runWithRequestContext<T>(\n  ctx: UnifiedRequestContext,\n  fn: () => Promise<T>,\n): Promise<T>;\nexport function runWithRequestContext<T>(\n  ctx: UnifiedRequestContext,\n  fn: () => T | Promise<T>,\n): T | Promise<T>;\nexport function runWithRequestContext<T>(\n  ctx: UnifiedRequestContext,\n  fn: () => T | Promise<T>,\n): T | Promise<T> {\n  return _als.run(ctx, fn);\n}\n\n/**\n * Run `fn` in a nested unified scope derived from the current request context.\n * Used by legacy runWith* wrappers to reset or override one sub-state while\n * preserving proper async isolation for continuations created inside `fn`.\n * The child scope is a shallow clone of the parent store, so untouched fields\n * keep sharing their existing references while overridden slices can be reset.\n *\n * @internal\n */\nexport function runWithUnifiedStateMutation<T>(\n  mutate: (ctx: UnifiedRequestContext) => void,\n  fn: () => Promise<T>,\n): Promise<T>;\nexport function runWithUnifiedStateMutation<T>(\n  mutate: (ctx: UnifiedRequestContext) => void,\n  fn: () => T | Promise<T>,\n): T | Promise<T>;\nexport function runWithUnifiedStateMutation<T>(\n  mutate: (ctx: UnifiedRequestContext) => void,\n  fn: () => T | Promise<T>,\n): T | Promise<T> {\n  const parentCtx = _als.getStore();\n  if (!parentCtx) return fn();\n\n  const childCtx = { ...parentCtx };\n  // NOTE: This is a shallow clone. Array fields (pendingSetCookies,\n  // serverInsertedHTMLCallbacks, currentRequestTags, ssrHeadChildren), the\n  // _privateCache Map, requestCache WeakMap, and object fields (headersContext,\n  // i18nContext, serverContext, ssrContext, executionContext,\n  // requestScopedCacheLife) still share references with the parent until\n  // replaced. requestCache is intentionally shared — nested scopes within\n  // the same request should see the same cached values. The mutate\n  // callback must replace those reference-typed slices (for example\n  // `ctx.currentRequestTags = []`) rather than mutating them in-place (for\n  // example `ctx.currentRequestTags.push(...)`) or the parent scope will\n  // observe those changes too. Keep this enumeration in sync with\n  // UnifiedRequestContext: when adding a new reference-typed field, add it\n  // here too and verify callers still follow the replace-not-mutate rule.\n  mutate(childCtx);\n  return _als.run(childCtx, fn);\n}\n\n/**\n * Get the current unified request context.\n * Returns the ALS store when inside a `runWithRequestContext()` scope,\n * or a fresh detached context otherwise. Unlike the legacy per-shim fallback\n * singletons, this detached value is ephemeral — mutations do not persist\n * across calls. This is intentional to prevent state leakage outside request\n * scopes.\n *\n * Only direct callers observe this detached fallback. Shim `_getState()`\n * helpers should continue to gate on `isInsideUnifiedScope()` and fall back\n * to their standalone ALS/fallback singletons outside the unified scope.\n * If called inside a standalone `runWithExecutionContext()` scope, the\n * detached context still reflects that inherited `executionContext`.\n */\nexport function getRequestContext(): UnifiedRequestContext {\n  return _als.getStore() ?? createRequestContext();\n}\n\n/**\n * Check whether the current execution is inside a `runWithRequestContext()` scope.\n * Shim modules use this to decide whether to read from the unified store\n * or fall back to their own standalone ALS.\n */\nexport function isInsideUnifiedScope(): boolean {\n  return _als.getStore() != null;\n}\n"],"mappings":";;AA8DA,MAAM,2BAA2B,OAAO,IAAI,4BAA4B;AACxE,MAAM,KAAK;AACX,MAAM,OAAO,eAAsC,mCAAmC;AAEtF,SAAS,gCAA6D;CACpE,MAAM,eAAe,KAAK,UAAU;AACpC,KAAI,aAAc,QAAO,aAAa;AAKtC,QAH4B,GAAG,2BAGH,UAAU,IAAI;;;;;;AAW5C,SAAgB,qBAAqB,MAA8D;AACjG,QAAO;EACL,gBAAgB;EAChB,sBAAsB;EACtB,0BAA0B;EAC1B,mBAAmB,EAAE;EACrB,uBAAuB;EACvB,OAAO;EACP,aAAa;EACb,eAAe;EACf,6BAA6B,EAAE;EAC/B,wBAAwB;EACxB,2BAA2B;EAC3B,eAAe;EACf,oBAAoB,EAAE;EACtB,sBAAsB,EAAE;EACxB,uBAAuB;EACvB,kBAAkB,+BAA+B;EACjD,8BAAc,IAAI,SAAS;EAC3B,YAAY;EACZ,iBAAiB,EAAE;EACnB,YAAY;EACZ,GAAG;EACJ;;AAgBH,SAAgB,sBACd,KACA,IACgB;AAChB,QAAO,KAAK,IAAI,KAAK,GAAG;;AAoB1B,SAAgB,4BACd,QACA,IACgB;CAChB,MAAM,YAAY,KAAK,UAAU;AACjC,KAAI,CAAC,UAAW,QAAO,IAAI;CAE3B,MAAM,WAAW,EAAE,GAAG,WAAW;AAcjC,QAAO,SAAS;AAChB,QAAO,KAAK,IAAI,UAAU,GAAG;;;;;;;;;;;;;;;;AAiB/B,SAAgB,oBAA2C;AACzD,QAAO,KAAK,UAAU,IAAI,sBAAsB;;;;;;;AAQlD,SAAgB,uBAAgC;AAC9C,QAAO,KAAK,UAAU,IAAI"}

package/dist/utils/base-path.d.ts

@@ -15,6 +15,12 @@ declare function hasBasePath(pathname: string, basePath: string): boolean;
  * boundary. Returns the original pathname when it is outside the basePath.
  */
 declare function stripBasePath(pathname: string, basePath: string): string;
+/**
+ * Remove trailing slashes from a pathname while preserving the root "/".
+ * Collapses any number of trailing slashes ("/a//" → "/a"). Used by the
+ * trailing-slash redirect path and route pattern normalization.
+ */
+declare function removeTrailingSlash(pathname: string): string;
 //#endregion
-export { hasBasePath, stripBasePath };
+export { hasBasePath, removeTrailingSlash, stripBasePath };
 //# sourceMappingURL=base-path.d.ts.map

package/dist/utils/base-path.js

@@ -21,7 +21,18 @@ function stripBasePath(pathname, basePath) {
 	if (!hasBasePath(pathname, basePath)) return pathname;
 	return pathname.slice(basePath.length) || "/";
 }
+/**
+* Remove trailing slashes from a pathname while preserving the root "/".
+* Collapses any number of trailing slashes ("/a//" → "/a"). Used by the
+* trailing-slash redirect path and route pattern normalization.
+*/
+function removeTrailingSlash(pathname) {
+	if (pathname === "/") return "/";
+	let end = pathname.length;
+	while (end > 0 && pathname.charCodeAt(end - 1) === 47) end--;
+	return end === 0 ? "/" : pathname.slice(0, end);
+}
 //#endregion
-export { hasBasePath, stripBasePath };
+export { hasBasePath, removeTrailingSlash, stripBasePath };
 
 //# sourceMappingURL=base-path.js.map

package/dist/utils/base-path.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-path.js","names":[],"sources":["../../src/utils/base-path.ts"],"sourcesContent":["/**\n * Shared basePath helpers.\n *\n * Next.js only treats a pathname as being under basePath when it is an exact\n * match (\"/app\") or starts with the basePath followed by a path separator\n * (\"/app/...\"). Prefix-only matches like \"/application\" must be left intact.\n */\n\n/**\n * Check whether a pathname is inside the configured basePath.\n */\nexport function hasBasePath(pathname: string, basePath: string): boolean {\n  if (!basePath) return false;\n  return pathname === basePath || pathname.startsWith(basePath + \"/\");\n}\n\n/**\n * Strip the basePath prefix from a pathname when it matches on a segment\n * boundary. Returns the original pathname when it is outside the basePath.\n */\nexport function stripBasePath(pathname: string, basePath: string): string {\n  if (!hasBasePath(pathname, basePath)) return pathname;\n  return pathname.slice(basePath.length) || \"/\";\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,YAAY,UAAkB,UAA2B;AACvE,KAAI,CAAC,SAAU,QAAO;AACtB,QAAO,aAAa,YAAY,SAAS,WAAW,WAAW,IAAI;;;;;;AAOrE,SAAgB,cAAc,UAAkB,UAA0B;AACxE,KAAI,CAAC,YAAY,UAAU,SAAS,CAAE,QAAO;AAC7C,QAAO,SAAS,MAAM,SAAS,OAAO,IAAI"}
+{"version":3,"file":"base-path.js","names":[],"sources":["../../src/utils/base-path.ts"],"sourcesContent":["/**\n * Shared basePath helpers.\n *\n * Next.js only treats a pathname as being under basePath when it is an exact\n * match (\"/app\") or starts with the basePath followed by a path separator\n * (\"/app/...\"). Prefix-only matches like \"/application\" must be left intact.\n */\n\n/**\n * Check whether a pathname is inside the configured basePath.\n */\nexport function hasBasePath(pathname: string, basePath: string): boolean {\n  if (!basePath) return false;\n  return pathname === basePath || pathname.startsWith(basePath + \"/\");\n}\n\n/**\n * Strip the basePath prefix from a pathname when it matches on a segment\n * boundary. Returns the original pathname when it is outside the basePath.\n */\nexport function stripBasePath(pathname: string, basePath: string): string {\n  if (!hasBasePath(pathname, basePath)) return pathname;\n  return pathname.slice(basePath.length) || \"/\";\n}\n\n/**\n * Remove trailing slashes from a pathname while preserving the root \"/\".\n * Collapses any number of trailing slashes (\"/a//\" → \"/a\"). Used by the\n * trailing-slash redirect path and route pattern normalization.\n */\nexport function removeTrailingSlash(pathname: string): string {\n  if (pathname === \"/\") return \"/\";\n  let end = pathname.length;\n  while (end > 0 && pathname.charCodeAt(end - 1) === 47 /* \"/\" */) end--;\n  return end === 0 ? \"/\" : pathname.slice(0, end);\n}\n"],"mappings":";;;;;;;;;;;AAWA,SAAgB,YAAY,UAAkB,UAA2B;AACvE,KAAI,CAAC,SAAU,QAAO;AACtB,QAAO,aAAa,YAAY,SAAS,WAAW,WAAW,IAAI;;;;;;AAOrE,SAAgB,cAAc,UAAkB,UAA0B;AACxE,KAAI,CAAC,YAAY,UAAU,SAAS,CAAE,QAAO;AAC7C,QAAO,SAAS,MAAM,SAAS,OAAO,IAAI;;;;;;;AAQ5C,SAAgB,oBAAoB,UAA0B;AAC5D,KAAI,aAAa,IAAK,QAAO;CAC7B,IAAI,MAAM,SAAS;AACnB,QAAO,MAAM,KAAK,SAAS,WAAW,MAAM,EAAE,KAAK,GAAc;AACjE,QAAO,QAAQ,IAAI,MAAM,SAAS,MAAM,GAAG,IAAI"}

package/dist/utils/safe-json-file.d.ts

@@ -0,0 +1,18 @@
+//#region src/utils/safe-json-file.d.ts
+/**
+ * Read and parse a JSON file, returning `null` if the file is missing,
+ * unreadable, or contains invalid JSON.
+ *
+ * Pass `onError` to log/observe failures while still receiving `null`. The
+ * callback is invoked for any thrown error from `readFileSync` or
+ * `JSON.parse` (e.g. `ENOENT`, syntax errors).
+ *
+ * Callers that need a default value other than `null` should map the result:
+ *   `readJsonFile<string[]>(p) ?? []`
+ */
+declare function readJsonFile<T>(filePath: string, options?: {
+  onError?: (err: unknown) => void;
+}): T | null;
+//#endregion
+export { readJsonFile };
+//# sourceMappingURL=safe-json-file.d.ts.map

package/dist/utils/safe-json-file.js

@@ -0,0 +1,25 @@
+import fs from "node:fs";
+//#region src/utils/safe-json-file.ts
+/**
+* Read and parse a JSON file, returning `null` if the file is missing,
+* unreadable, or contains invalid JSON.
+*
+* Pass `onError` to log/observe failures while still receiving `null`. The
+* callback is invoked for any thrown error from `readFileSync` or
+* `JSON.parse` (e.g. `ENOENT`, syntax errors).
+*
+* Callers that need a default value other than `null` should map the result:
+*   `readJsonFile<string[]>(p) ?? []`
+*/
+function readJsonFile(filePath, options) {
+	try {
+		return JSON.parse(fs.readFileSync(filePath, "utf-8"));
+	} catch (err) {
+		options?.onError?.(err);
+		return null;
+	}
+}
+//#endregion
+export { readJsonFile };
+
+//# sourceMappingURL=safe-json-file.js.map

package/dist/utils/safe-json-file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"safe-json-file.js","names":[],"sources":["../../src/utils/safe-json-file.ts"],"sourcesContent":["import fs from \"node:fs\";\n\n/**\n * Read and parse a JSON file, returning `null` if the file is missing,\n * unreadable, or contains invalid JSON.\n *\n * Pass `onError` to log/observe failures while still receiving `null`. The\n * callback is invoked for any thrown error from `readFileSync` or\n * `JSON.parse` (e.g. `ENOENT`, syntax errors).\n *\n * Callers that need a default value other than `null` should map the result:\n *   `readJsonFile<string[]>(p) ?? []`\n */\nexport function readJsonFile<T>(\n  filePath: string,\n  options?: { onError?: (err: unknown) => void },\n): T | null {\n  try {\n    return JSON.parse(fs.readFileSync(filePath, \"utf-8\")) as T;\n  } catch (err) {\n    options?.onError?.(err);\n    return null;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;AAaA,SAAgB,aACd,UACA,SACU;AACV,KAAI;AACF,SAAO,KAAK,MAAM,GAAG,aAAa,UAAU,QAAQ,CAAC;UAC9C,KAAK;AACZ,WAAS,UAAU,IAAI;AACvB,SAAO"}

package/dist/utils/text-stream.d.ts

@@ -0,0 +1,29 @@
+//#region src/utils/text-stream.d.ts
+/**
+ * Helpers for the repeated `new TextDecoder()` + `ReadableStream` chunk-loop
+ * pattern used across the server. Each helper handles the streaming-decode
+ * boundary correctly (final empty `decoder.decode()` flush so any incomplete
+ * trailing UTF-8 sequence is reported).
+ *
+ * Sites with additional load-bearing behaviour (line-buffered transforms,
+ * raw-byte accumulators, mixed string/Uint8Array streams, cache-key body
+ * canonicalisation) intentionally still inline their own decoder.
+ */
+/**
+ * Drain a UTF-8 byte stream and return the full decoded text. The stream
+ * reader is released on both success and failure.
+ */
+declare function readStreamAsText(stream: ReadableStream<Uint8Array>): Promise<string>;
+/**
+ * Drain a UTF-8 byte stream up to `maxBytes` of *raw* input, returning the
+ * decoded text. If the raw size limit is exceeded, the reader is cancelled
+ * and `onLimitExceeded` is invoked; it MUST throw — its return type is
+ * `never` to enforce that. Each caller passes its own error type.
+ *
+ * The size check is on raw bytes (pre-decode) to bound memory before
+ * paying the decoder cost.
+ */
+declare function readStreamAsTextWithLimit(stream: ReadableStream<Uint8Array>, maxBytes: number, onLimitExceeded: () => never): Promise<string>;
+//#endregion
+export { readStreamAsText, readStreamAsTextWithLimit };
+//# sourceMappingURL=text-stream.d.ts.map

package/dist/utils/text-stream.js

@@ -0,0 +1,66 @@
+//#region src/utils/text-stream.ts
+/**
+* Helpers for the repeated `new TextDecoder()` + `ReadableStream` chunk-loop
+* pattern used across the server. Each helper handles the streaming-decode
+* boundary correctly (final empty `decoder.decode()` flush so any incomplete
+* trailing UTF-8 sequence is reported).
+*
+* Sites with additional load-bearing behaviour (line-buffered transforms,
+* raw-byte accumulators, mixed string/Uint8Array streams, cache-key body
+* canonicalisation) intentionally still inline their own decoder.
+*/
+/**
+* Drain a UTF-8 byte stream and return the full decoded text. The stream
+* reader is released on both success and failure.
+*/
+async function readStreamAsText(stream) {
+	const reader = stream.getReader();
+	const decoder = new TextDecoder();
+	const chunks = [];
+	try {
+		for (;;) {
+			const { done, value } = await reader.read();
+			if (done) break;
+			chunks.push(decoder.decode(value, { stream: true }));
+		}
+		chunks.push(decoder.decode());
+		return chunks.join("");
+	} finally {
+		reader.releaseLock();
+	}
+}
+/**
+* Drain a UTF-8 byte stream up to `maxBytes` of *raw* input, returning the
+* decoded text. If the raw size limit is exceeded, the reader is cancelled
+* and `onLimitExceeded` is invoked; it MUST throw — its return type is
+* `never` to enforce that. Each caller passes its own error type.
+*
+* The size check is on raw bytes (pre-decode) to bound memory before
+* paying the decoder cost.
+*/
+async function readStreamAsTextWithLimit(stream, maxBytes, onLimitExceeded) {
+	const reader = stream.getReader();
+	const decoder = new TextDecoder();
+	const chunks = [];
+	let totalSize = 0;
+	try {
+		for (;;) {
+			const result = await reader.read();
+			if (result.done) break;
+			totalSize += result.value.byteLength;
+			if (totalSize > maxBytes) {
+				await reader.cancel();
+				onLimitExceeded();
+			}
+			chunks.push(decoder.decode(result.value, { stream: true }));
+		}
+		chunks.push(decoder.decode());
+		return chunks.join("");
+	} finally {
+		reader.releaseLock();
+	}
+}
+//#endregion
+export { readStreamAsText, readStreamAsTextWithLimit };
+
+//# sourceMappingURL=text-stream.js.map

package/dist/utils/text-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text-stream.js","names":[],"sources":["../../src/utils/text-stream.ts"],"sourcesContent":["/**\n * Helpers for the repeated `new TextDecoder()` + `ReadableStream` chunk-loop\n * pattern used across the server. Each helper handles the streaming-decode\n * boundary correctly (final empty `decoder.decode()` flush so any incomplete\n * trailing UTF-8 sequence is reported).\n *\n * Sites with additional load-bearing behaviour (line-buffered transforms,\n * raw-byte accumulators, mixed string/Uint8Array streams, cache-key body\n * canonicalisation) intentionally still inline their own decoder.\n */\n\n/**\n * Drain a UTF-8 byte stream and return the full decoded text. The stream\n * reader is released on both success and failure.\n */\nexport async function readStreamAsText(stream: ReadableStream<Uint8Array>): Promise<string> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  const chunks: string[] = [];\n\n  try {\n    for (;;) {\n      const { done, value } = await reader.read();\n      if (done) {\n        break;\n      }\n      chunks.push(decoder.decode(value, { stream: true }));\n    }\n    chunks.push(decoder.decode());\n    return chunks.join(\"\");\n  } finally {\n    reader.releaseLock();\n  }\n}\n\n/**\n * Drain a UTF-8 byte stream up to `maxBytes` of *raw* input, returning the\n * decoded text. If the raw size limit is exceeded, the reader is cancelled\n * and `onLimitExceeded` is invoked; it MUST throw — its return type is\n * `never` to enforce that. Each caller passes its own error type.\n *\n * The size check is on raw bytes (pre-decode) to bound memory before\n * paying the decoder cost.\n */\nexport async function readStreamAsTextWithLimit(\n  stream: ReadableStream<Uint8Array>,\n  maxBytes: number,\n  onLimitExceeded: () => never,\n): Promise<string> {\n  const reader = stream.getReader();\n  const decoder = new TextDecoder();\n  const chunks: string[] = [];\n  let totalSize = 0;\n\n  try {\n    for (;;) {\n      const result = await reader.read();\n      if (result.done) {\n        break;\n      }\n\n      totalSize += result.value.byteLength;\n      if (totalSize > maxBytes) {\n        await reader.cancel();\n        onLimitExceeded();\n      }\n\n      chunks.push(decoder.decode(result.value, { stream: true }));\n    }\n\n    chunks.push(decoder.decode());\n    return chunks.join(\"\");\n  } finally {\n    reader.releaseLock();\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;AAeA,eAAsB,iBAAiB,QAAqD;CAC1F,MAAM,SAAS,OAAO,WAAW;CACjC,MAAM,UAAU,IAAI,aAAa;CACjC,MAAM,SAAmB,EAAE;AAE3B,KAAI;AACF,WAAS;GACP,MAAM,EAAE,MAAM,UAAU,MAAM,OAAO,MAAM;AAC3C,OAAI,KACF;AAEF,UAAO,KAAK,QAAQ,OAAO,OAAO,EAAE,QAAQ,MAAM,CAAC,CAAC;;AAEtD,SAAO,KAAK,QAAQ,QAAQ,CAAC;AAC7B,SAAO,OAAO,KAAK,GAAG;WACd;AACR,SAAO,aAAa;;;;;;;;;;;;AAaxB,eAAsB,0BACpB,QACA,UACA,iBACiB;CACjB,MAAM,SAAS,OAAO,WAAW;CACjC,MAAM,UAAU,IAAI,aAAa;CACjC,MAAM,SAAmB,EAAE;CAC3B,IAAI,YAAY;AAEhB,KAAI;AACF,WAAS;GACP,MAAM,SAAS,MAAM,OAAO,MAAM;AAClC,OAAI,OAAO,KACT;AAGF,gBAAa,OAAO,MAAM;AAC1B,OAAI,YAAY,UAAU;AACxB,UAAM,OAAO,QAAQ;AACrB,qBAAiB;;AAGnB,UAAO,KAAK,QAAQ,OAAO,OAAO,OAAO,EAAE,QAAQ,MAAM,CAAC,CAAC;;AAG7D,SAAO,KAAK,QAAQ,QAAQ,CAAC;AAC7B,SAAO,OAAO,KAAK,GAAG;WACd;AACR,SAAO,aAAa"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vinext",
-  "version": "0.0.47",
+  "version": "0.0.48",
   "description": "Run Next.js apps on Vite. Drop-in replacement for the next CLI.",
   "license": "MIT",
   "repository": {
@@ -72,7 +72,7 @@
     "@types/react-dom": "^19.2.3",
     "@vitejs/plugin-react": "^6.0.1",
     "@vitejs/plugin-rsc": "^0.5.23",
-    "react-server-dom-webpack": "^19.2.5",
+    "react-server-dom-webpack": "^19.2.6",
     "vite": "npm:@voidzero-dev/vite-plus-core@0.1.17",
     "vite-plus": "0.1.17"
   },
@@ -80,9 +80,9 @@
     "@mdx-js/rollup": "^3.0.0",
     "@vitejs/plugin-react": "^5.1.4 || ^6.0.0",
     "@vitejs/plugin-rsc": "^0.5.23",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "react-server-dom-webpack": "^19.2.5",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "react-server-dom-webpack": "^19.2.6",
     "vite": "^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {