@reckona/mreact-router 0.0.160 → 0.0.161

package/dist/stream-list.js

@@ -1,3 +1,6 @@
+/**
+ * Splits an input list into pending batches that load their items asynchronously.
+ */
 export function streamList(items, options) {
     const requestedBatchSize = Math.floor(options.batchSize);
     const batchSize = Number.isFinite(requestedBatchSize) ? Math.max(1, requestedBatchSize) : 1;

package/dist/stream-list.js.map

@@ -1 +1 @@
-{"version":3,"file":"stream-list.js","sourceRoot":"","sources":["../src/stream-list.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,UAAU,CACxB,KAAwB,EACxB,OAAyC;IAEzC,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAyC,EAAE,CAAC;IAEzD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,SAAS,EAAE,CAAC;QAC7D,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,IAAI;YACP,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC5E,GAAG,IAAI;gBACP,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC;aACnB,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["export interface StreamListBatch<TItem> {\n  index: number;\n  items: TItem[];\n  size: number;\n  start: number;\n}\n\nexport interface StreamListPendingBatch<TItem> {\n  index: number;\n  size: number;\n  start: number;\n  value: Promise<StreamListBatch<TItem>>;\n}\n\nexport interface StreamListOptions<TInput, TItem> {\n  batchSize: number;\n  loadBatch: (\n    items: readonly TInput[],\n    batch: { index: number; size: number; start: number },\n  ) => PromiseLike<readonly TItem[]> | readonly TItem[];\n}\n\nexport function streamList<TInput, TItem = TInput>(\n  items: readonly TInput[],\n  options: StreamListOptions<TInput, TItem>,\n): Array<StreamListPendingBatch<TItem>> {\n  const requestedBatchSize = Math.floor(options.batchSize);\n  const batchSize = Number.isFinite(requestedBatchSize) ? Math.max(1, requestedBatchSize) : 1;\n  const batches: Array<StreamListPendingBatch<TItem>> = [];\n\n  for (let start = 0; start < items.length; start += batchSize) {\n    const batchItems = items.slice(start, start + batchSize);\n    const index = batches.length;\n    const meta = { index, size: batchItems.length, start };\n    batches.push({\n      ...meta,\n      value: Promise.resolve(options.loadBatch(batchItems, meta)).then((loaded) => ({\n        ...meta,\n        items: [...loaded],\n      })),\n    });\n  }\n\n  return batches;\n}\n"]}
+{"version":3,"file":"stream-list.js","sourceRoot":"","sources":["../src/stream-list.ts"],"names":[],"mappings":"AA+BA;;GAEG;AACH,MAAM,UAAU,UAAU,CACxB,KAAwB,EACxB,OAAyC;IAEzC,MAAM,kBAAkB,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACzD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5F,MAAM,OAAO,GAAyC,EAAE,CAAC;IAEzD,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,SAAS,EAAE,CAAC;QAC7D,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC,CAAC;QACzD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,MAAM,IAAI,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC;QACvD,OAAO,CAAC,IAAI,CAAC;YACX,GAAG,IAAI;YACP,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;gBAC5E,GAAG,IAAI;gBACP,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC;aACnB,CAAC,CAAC;SACJ,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["/**\n * Represents one resolved batch emitted by `streamList()`.\n */\nexport interface StreamListBatch<TItem> {\n  index: number;\n  items: TItem[];\n  size: number;\n  start: number;\n}\n\n/**\n * Represents one pending batch and its eventual loaded items.\n */\nexport interface StreamListPendingBatch<TItem> {\n  index: number;\n  size: number;\n  start: number;\n  value: Promise<StreamListBatch<TItem>>;\n}\n\n/**\n * Configures how a list is divided into asynchronous batches.\n */\nexport interface StreamListOptions<TInput, TItem> {\n  batchSize: number;\n  loadBatch: (\n    items: readonly TInput[],\n    batch: { index: number; size: number; start: number },\n  ) => PromiseLike<readonly TItem[]> | readonly TItem[];\n}\n\n/**\n * Splits an input list into pending batches that load their items asynchronously.\n */\nexport function streamList<TInput, TItem = TInput>(\n  items: readonly TInput[],\n  options: StreamListOptions<TInput, TItem>,\n): Array<StreamListPendingBatch<TItem>> {\n  const requestedBatchSize = Math.floor(options.batchSize);\n  const batchSize = Number.isFinite(requestedBatchSize) ? Math.max(1, requestedBatchSize) : 1;\n  const batches: Array<StreamListPendingBatch<TItem>> = [];\n\n  for (let start = 0; start < items.length; start += batchSize) {\n    const batchItems = items.slice(start, start + batchSize);\n    const index = batches.length;\n    const meta = { index, size: batchItems.length, start };\n    batches.push({\n      ...meta,\n      value: Promise.resolve(options.loadBatch(batchItems, meta)).then((loaded) => ({\n        ...meta,\n        items: [...loaded],\n      })),\n    });\n  }\n\n  return batches;\n}\n"]}

package/dist/trace.d.ts

@@ -1,3 +1,6 @@
+/**
+ * Represents parsed W3C trace context headers for router instrumentation.
+ */
 export interface RouterTraceContext {
     parentSpanId: string;
     sampled: boolean;
@@ -5,28 +8,49 @@ export interface RouterTraceContext {
     traceparent: string;
     tracestate?: string;
 }
+/**
+ * Describes a router request lifecycle instrumentation event.
+ */
 export interface RouterRequestInstrumentationEvent {
     method: string;
     path: string;
     request: Request;
     trace?: RouterTraceContext;
 }
+/**
+ * Describes completion of a router request lifecycle event.
+ */
 export interface RouterRequestEndInstrumentationEvent extends RouterRequestInstrumentationEvent {
     status: number;
 }
+/**
+ * Describes a route-level loader or render instrumentation event.
+ */
 export interface RouterRouteInstrumentationEvent extends RouterRequestInstrumentationEvent {
     routeId: string;
     routePath: string;
 }
+/**
+ * Describes completion of a route-level instrumentation event.
+ */
 export interface RouterRouteEndInstrumentationEvent extends RouterRouteInstrumentationEvent {
     error?: unknown;
 }
+/**
+ * Describes a middleware instrumentation event.
+ */
 export interface RouterMiddlewareInstrumentationEvent extends RouterRequestInstrumentationEvent {
     name: string;
 }
+/**
+ * Describes completion of a middleware instrumentation event.
+ */
 export interface RouterMiddlewareEndInstrumentationEvent extends RouterMiddlewareInstrumentationEvent {
     error?: unknown;
 }
+/**
+ * Registers optional hooks for app-router request, middleware, and route instrumentation.
+ */
 export interface RouterInstrumentation {
     onLoaderEnd?: (event: RouterRouteEndInstrumentationEvent) => void | Promise<void>;
     onLoaderStart?: (event: RouterRouteInstrumentationEvent) => void | Promise<void>;
@@ -35,7 +59,13 @@ export interface RouterInstrumentation {
     onRequestEnd?: (event: RouterRequestEndInstrumentationEvent) => void | Promise<void>;
     onRequestStart?: (event: RouterRequestInstrumentationEvent) => void | Promise<void>;
 }
+/**
+ * Parses W3C trace context header values for router instrumentation.
+ */
 export declare function parseTraceContext(traceparent: string | null | undefined, tracestate: string | null | undefined): RouterTraceContext | undefined;
+/**
+ * Reads trace context headers from a request.
+ */
 export declare function traceContextFromRequest(request: Request): RouterTraceContext | undefined;
 export declare function invokeRouterInstrumentation<Event>(callback: ((event: Event) => void | Promise<void>) | undefined, event: Event): void;
 //# sourceMappingURL=trace.d.ts.map

package/dist/trace.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED,MAAM,WAAW,oCACf,SAAQ,iCAAiC;IACzC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,+BACf,SAAQ,iCAAiC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kCACf,SAAQ,+BAA+B;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,oCACf,SAAQ,iCAAiC;IACzC,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,uCACf,SAAQ,oCAAoC;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,uCAAuC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,oCAAoC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,oCAAoC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF;AAED,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACpC,kBAAkB,GAAG,SAAS,CA4BhC;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAExF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAC/C,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,EAC9D,KAAK,EAAE,KAAK,GACX,IAAI,CAcN"}
+{"version":3,"file":"trace.d.ts","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iCAAiC;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oCACf,SAAQ,iCAAiC;IACzC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,+BACf,SAAQ,iCAAiC;IACzC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,kCACf,SAAQ,+BAA+B;IACvC,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oCACf,SAAQ,iCAAiC;IACzC,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;GAEG;AACH,MAAM,WAAW,uCACf,SAAQ,oCAAoC;IAC5C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,kCAAkC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClF,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,+BAA+B,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACjF,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,uCAAuC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3F,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,oCAAoC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1F,YAAY,CAAC,EAAE,CAAC,KAAK,EAAE,oCAAoC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE,iCAAiC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,WAAW,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACtC,UAAU,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACpC,kBAAkB,GAAG,SAAS,CA4BhC;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,kBAAkB,GAAG,SAAS,CAExF;AAED,wBAAgB,2BAA2B,CAAC,KAAK,EAC/C,QAAQ,EAAE,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,SAAS,EAC9D,KAAK,EAAE,KAAK,GACX,IAAI,CAcN"}

package/dist/trace.js

@@ -1,3 +1,6 @@
+/**
+ * Parses W3C trace context header values for router instrumentation.
+ */
 export function parseTraceContext(traceparent, tracestate) {
     if (traceparent === null || traceparent === undefined) {
         return undefined;
@@ -20,6 +23,9 @@ export function parseTraceContext(traceparent, tracestate) {
         ...(tracestate === null || tracestate === undefined ? {} : { tracestate }),
     };
 }
+/**
+ * Reads trace context headers from a request.
+ */
 export function traceContextFromRequest(request) {
     return parseTraceContext(request.headers.get("traceparent"), request.headers.get("tracestate"));
 }

package/dist/trace.js.map

@@ -1 +1 @@
-{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AAkDA,MAAM,UAAU,iBAAiB,CAC/B,WAAsC,EACtC,UAAqC;IAErC,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,8DAA8D,CAAC,IAAI,CAC/E,WAAW,CACZ,CAAC;IAEF,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC9C,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,YAAY;QACZ,OAAO,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAC1B,OAAO;QACP,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE;QACtC,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,QAA8D,EAC9D,KAAY;IAEZ,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAE/B,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QAChB,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,CAClC,CAAC;AACJ,CAAC","sourcesContent":["export interface RouterTraceContext {\n  parentSpanId: string;\n  sampled: boolean;\n  traceId: string;\n  traceparent: string;\n  tracestate?: string;\n}\n\nexport interface RouterRequestInstrumentationEvent {\n  method: string;\n  path: string;\n  request: Request;\n  trace?: RouterTraceContext;\n}\n\nexport interface RouterRequestEndInstrumentationEvent\n  extends RouterRequestInstrumentationEvent {\n  status: number;\n}\n\nexport interface RouterRouteInstrumentationEvent\n  extends RouterRequestInstrumentationEvent {\n  routeId: string;\n  routePath: string;\n}\n\nexport interface RouterRouteEndInstrumentationEvent\n  extends RouterRouteInstrumentationEvent {\n  error?: unknown;\n}\n\nexport interface RouterMiddlewareInstrumentationEvent\n  extends RouterRequestInstrumentationEvent {\n  name: string;\n}\n\nexport interface RouterMiddlewareEndInstrumentationEvent\n  extends RouterMiddlewareInstrumentationEvent {\n  error?: unknown;\n}\n\nexport interface RouterInstrumentation {\n  onLoaderEnd?: (event: RouterRouteEndInstrumentationEvent) => void | Promise<void>;\n  onLoaderStart?: (event: RouterRouteInstrumentationEvent) => void | Promise<void>;\n  onMiddlewareEnd?: (event: RouterMiddlewareEndInstrumentationEvent) => void | Promise<void>;\n  onMiddlewareStart?: (event: RouterMiddlewareInstrumentationEvent) => void | Promise<void>;\n  onRequestEnd?: (event: RouterRequestEndInstrumentationEvent) => void | Promise<void>;\n  onRequestStart?: (event: RouterRequestInstrumentationEvent) => void | Promise<void>;\n}\n\nexport function parseTraceContext(\n  traceparent: string | null | undefined,\n  tracestate: string | null | undefined,\n): RouterTraceContext | undefined {\n  if (traceparent === null || traceparent === undefined) {\n    return undefined;\n  }\n\n  const match = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/i.exec(\n    traceparent,\n  );\n\n  if (match === null) {\n    return undefined;\n  }\n\n  const traceId = match[2]?.toLowerCase() ?? \"\";\n  const parentSpanId = match[3]?.toLowerCase() ?? \"\";\n  const flags = Number.parseInt(match[4] ?? \"00\", 16);\n\n  if (/^0+$/.test(traceId) || /^0+$/.test(parentSpanId)) {\n    return undefined;\n  }\n\n  return {\n    parentSpanId,\n    sampled: (flags & 1) === 1,\n    traceId,\n    traceparent: traceparent.toLowerCase(),\n    ...(tracestate === null || tracestate === undefined ? {} : { tracestate }),\n  };\n}\n\nexport function traceContextFromRequest(request: Request): RouterTraceContext | undefined {\n  return parseTraceContext(request.headers.get(\"traceparent\"), request.headers.get(\"tracestate\"));\n}\n\nexport function invokeRouterInstrumentation<Event>(\n  callback: ((event: Event) => void | Promise<void>) | undefined,\n  event: Event,\n): void {\n  if (callback === undefined) {\n    return;\n  }\n\n  try {\n    const result = callback(event);\n\n    if (isPromiseLike(result)) {\n      result.catch(() => {});\n    }\n  } catch {\n    // Instrumentation is best-effort and must never affect request handling.\n  }\n}\n\nfunction isPromiseLike(value: unknown): value is Promise<void> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"catch\" in value &&\n    typeof value.catch === \"function\"\n  );\n}\n"]}
+{"version":3,"file":"trace.js","sourceRoot":"","sources":["../src/trace.ts"],"names":[],"mappings":"AA0EA;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAC/B,WAAsC,EACtC,UAAqC;IAErC,IAAI,WAAW,KAAK,IAAI,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,KAAK,GAAG,8DAA8D,CAAC,IAAI,CAC/E,WAAW,CACZ,CAAC;IAEF,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,MAAM,OAAO,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAC9C,MAAM,YAAY,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IACnD,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,EAAE,CAAC,CAAC;IAEpD,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,EAAE,CAAC;QACtD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,OAAO;QACL,YAAY;QACZ,OAAO,EAAE,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAC1B,OAAO;QACP,WAAW,EAAE,WAAW,CAAC,WAAW,EAAE;QACtC,GAAG,CAAC,UAAU,KAAK,IAAI,IAAI,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC;KAC3E,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO,iBAAiB,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;AAClG,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,QAA8D,EAC9D,KAAY;IAEZ,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;QAE/B,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,yEAAyE;IAC3E,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CACL,OAAO,KAAK,KAAK,QAAQ;QACzB,KAAK,KAAK,IAAI;QACd,OAAO,IAAI,KAAK;QAChB,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,CAClC,CAAC;AACJ,CAAC","sourcesContent":["/**\n * Represents parsed W3C trace context headers for router instrumentation.\n */\nexport interface RouterTraceContext {\n  parentSpanId: string;\n  sampled: boolean;\n  traceId: string;\n  traceparent: string;\n  tracestate?: string;\n}\n\n/**\n * Describes a router request lifecycle instrumentation event.\n */\nexport interface RouterRequestInstrumentationEvent {\n  method: string;\n  path: string;\n  request: Request;\n  trace?: RouterTraceContext;\n}\n\n/**\n * Describes completion of a router request lifecycle event.\n */\nexport interface RouterRequestEndInstrumentationEvent\n  extends RouterRequestInstrumentationEvent {\n  status: number;\n}\n\n/**\n * Describes a route-level loader or render instrumentation event.\n */\nexport interface RouterRouteInstrumentationEvent\n  extends RouterRequestInstrumentationEvent {\n  routeId: string;\n  routePath: string;\n}\n\n/**\n * Describes completion of a route-level instrumentation event.\n */\nexport interface RouterRouteEndInstrumentationEvent\n  extends RouterRouteInstrumentationEvent {\n  error?: unknown;\n}\n\n/**\n * Describes a middleware instrumentation event.\n */\nexport interface RouterMiddlewareInstrumentationEvent\n  extends RouterRequestInstrumentationEvent {\n  name: string;\n}\n\n/**\n * Describes completion of a middleware instrumentation event.\n */\nexport interface RouterMiddlewareEndInstrumentationEvent\n  extends RouterMiddlewareInstrumentationEvent {\n  error?: unknown;\n}\n\n/**\n * Registers optional hooks for app-router request, middleware, and route instrumentation.\n */\nexport interface RouterInstrumentation {\n  onLoaderEnd?: (event: RouterRouteEndInstrumentationEvent) => void | Promise<void>;\n  onLoaderStart?: (event: RouterRouteInstrumentationEvent) => void | Promise<void>;\n  onMiddlewareEnd?: (event: RouterMiddlewareEndInstrumentationEvent) => void | Promise<void>;\n  onMiddlewareStart?: (event: RouterMiddlewareInstrumentationEvent) => void | Promise<void>;\n  onRequestEnd?: (event: RouterRequestEndInstrumentationEvent) => void | Promise<void>;\n  onRequestStart?: (event: RouterRequestInstrumentationEvent) => void | Promise<void>;\n}\n\n/**\n * Parses W3C trace context header values for router instrumentation.\n */\nexport function parseTraceContext(\n  traceparent: string | null | undefined,\n  tracestate: string | null | undefined,\n): RouterTraceContext | undefined {\n  if (traceparent === null || traceparent === undefined) {\n    return undefined;\n  }\n\n  const match = /^([0-9a-f]{2})-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/i.exec(\n    traceparent,\n  );\n\n  if (match === null) {\n    return undefined;\n  }\n\n  const traceId = match[2]?.toLowerCase() ?? \"\";\n  const parentSpanId = match[3]?.toLowerCase() ?? \"\";\n  const flags = Number.parseInt(match[4] ?? \"00\", 16);\n\n  if (/^0+$/.test(traceId) || /^0+$/.test(parentSpanId)) {\n    return undefined;\n  }\n\n  return {\n    parentSpanId,\n    sampled: (flags & 1) === 1,\n    traceId,\n    traceparent: traceparent.toLowerCase(),\n    ...(tracestate === null || tracestate === undefined ? {} : { tracestate }),\n  };\n}\n\n/**\n * Reads trace context headers from a request.\n */\nexport function traceContextFromRequest(request: Request): RouterTraceContext | undefined {\n  return parseTraceContext(request.headers.get(\"traceparent\"), request.headers.get(\"tracestate\"));\n}\n\nexport function invokeRouterInstrumentation<Event>(\n  callback: ((event: Event) => void | Promise<void>) | undefined,\n  event: Event,\n): void {\n  if (callback === undefined) {\n    return;\n  }\n\n  try {\n    const result = callback(event);\n\n    if (isPromiseLike(result)) {\n      result.catch(() => {});\n    }\n  } catch {\n    // Instrumentation is best-effort and must never affect request handling.\n  }\n}\n\nfunction isPromiseLike(value: unknown): value is Promise<void> {\n  return (\n    typeof value === \"object\" &&\n    value !== null &&\n    \"catch\" in value &&\n    typeof value.catch === \"function\"\n  );\n}\n"]}

package/dist/typed-routes.d.ts

@@ -1,12 +1,33 @@
+/**
+ * Represents a value accepted in generated route search params.
+ */
 export type RouteSearchValue = boolean | number | string | null | undefined;
+/**
+ * Represents search params accepted by typed route href helpers.
+ */
 export type RouteSearchParams = Record<string, RouteSearchValue | readonly RouteSearchValue[]>;
+/**
+ * Extracts dynamic and catch-all params from an app route path pattern.
+ */
 export type RouteParamsFor<Path extends `/${string}`> = Simplify<ExtractRouteParams<Path>>;
+/**
+ * Builds the callable `href()` helper type for a specific app route path.
+ */
 export type AppRouteHref<Path extends `/${string}`> = keyof RouteParamsFor<Path> extends never ? (options?: StaticHrefOptions) => string : (options: DynamicHrefOptions<Path>) => string;
+/**
+ * Builds the Link `href` string type accepted for a specific app route path.
+ */
 export type AppRouteLinkHref<Path extends `/${string}`> = `${AppRouteLinkPathname<Path>}${AppRouteLinkHrefSuffix}`;
+/**
+ * Configures a static href with optional search params and hash.
+ */
 export interface StaticHrefOptions {
     hash?: string | undefined;
     search?: RouteSearchParams | undefined;
 }
+/**
+ * Configures a dynamic href with route params, optional search params, and hash.
+ */
 export interface DynamicHrefOptions<Path extends `/${string}`> extends StaticHrefOptions {
     params: RouteParamsFor<Path>;
 }
@@ -20,9 +41,21 @@ type SegmentRouteParam<Segment extends string> = Segment extends `:...${infer Na
 type Simplify<T> = {
     [Key in keyof T]: T[Key];
 } & {};
+/**
+ * Represents the search and hash suffix portion of a typed route href.
+ */
 export type AppRouteLinkHrefSuffix = "" | `?${string}` | `#${string}` | `?${string}#${string}`;
+/**
+ * Builds the pathname string type for a typed route href.
+ */
 export type AppRouteLinkPathname<Path extends `/${string}`> = Path extends "/" ? "/" : Path extends `/${infer Segments}` ? `/${AppRouteLinkSegments<Segments>}` : never;
+/**
+ * Builds the joined path segment string type for a typed route href.
+ */
 export type AppRouteLinkSegments<Segments extends string> = Segments extends `${infer Segment}/${infer Rest}` ? `${AppRouteLinkSegment<Segment>}/${AppRouteLinkSegments<Rest>}` : AppRouteLinkSegment<Segments>;
+/**
+ * Builds the string type for one static or dynamic route segment.
+ */
 export type AppRouteLinkSegment<Segment extends string> = Segment extends `:${string}` ? string : Segment;
 /**
  * Builds an internal app-route URL from a route pattern and typed params/search options.

package/dist/typed-routes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-routes.d.ts","sourceRoot":"","sources":["../src/typed-routes.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;AAC5E,MAAM,MAAM,iBAAiB,GAAG,MAAM,CACpC,MAAM,EACN,gBAAgB,GAAG,SAAS,gBAAgB,EAAE,CAC/C,CAAC;AAEF,MAAM,MAAM,cAAc,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,IAAI,QAAQ,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AAE3F,MAAM,MAAM,YAAY,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,IAAI,MAAM,cAAc,CAAC,IAAI,CAAC,SAAS,KAAK,GAC1F,CAAC,OAAO,CAAC,EAAE,iBAAiB,KAAK,MAAM,GACvC,CAAC,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,KAAK,MAAM,CAAC;AAElD,MAAM,MAAM,gBAAgB,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,IACpD,GAAG,oBAAoB,CAAC,IAAI,CAAC,GAAG,sBAAsB,EAAE,CAAC;AAE3D,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;CACxC;AAED,MAAM,WAAW,kBAAkB,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,CAAE,SAAQ,iBAAiB;IACtF,MAAM,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;CAC9B;AAED,KAAK,cAAc,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,IAAI,MAAM,cAAc,CAAC,IAAI,CAAC,SAAS,KAAK,GACrF,KAAK,GACL,IAAI,CAAC;AAET,KAAK,kBAAkB,CAAC,IAAI,SAAS,MAAM,IAAI,IAAI,SAAS,GAAG,MAAM,OAAO,IAAI,MAAM,IAAI,EAAE,GACxF,iBAAiB,CAAC,OAAO,CAAC,GAAG,kBAAkB,CAAC,IAAI,CAAC,GACrD,iBAAiB,CAAC,IAAI,CAAC,CAAC;AAE5B,KAAK,iBAAiB,CAAC,OAAO,SAAS,MAAM,IAAI,OAAO,SAAS,OAAO,MAAM,IAAI,EAAE,GAChF;KAAG,GAAG,IAAI,IAAI,GAAG,SAAS,MAAM,EAAE;CAAE,GACpC,OAAO,SAAS,IAAI,MAAM,IAAI,EAAE,GAC9B;KAAG,GAAG,IAAI,IAAI,GAAG,MAAM;CAAE,GACzB,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAE3B,KAAK,QAAQ,CAAC,CAAC,IAAI;KAAG,GAAG,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC;CAAE,GAAG,EAAE,CAAC;AAErD,MAAM,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,GAAG,IAAI,MAAM,IAAI,MAAM,EAAE,CAAC;AAE/F,MAAM,MAAM,oBAAoB,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,IAAI,IAAI,SAAS,GAAG,GAC1E,GAAG,GACH,IAAI,SAAS,IAAI,MAAM,QAAQ,EAAE,GAC/B,IAAI,oBAAoB,CAAC,QAAQ,CAAC,EAAE,GACpC,KAAK,CAAC;AAEZ,MAAM,MAAM,oBAAoB,CAAC,QAAQ,SAAS,MAAM,IAAI,QAAQ,SAAS,GAAG,MAAM,OAAO,IAAI,MAAM,IAAI,EAAE,GACzG,GAAG,mBAAmB,CAAC,OAAO,CAAC,IAAI,oBAAoB,CAAC,IAAI,CAAC,EAAE,GAC/D,mBAAmB,CAAC,QAAQ,CAAC,CAAC;AAElC,MAAM,MAAM,mBAAmB,CAAC,OAAO,SAAS,MAAM,IAAI,OAAO,SAAS,IAAI,MAAM,EAAE,GAClF,MAAM,GACN,OAAO,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,IAAI,CAAC,KAAK,CAAC,IAAI,SAAS,IAAI,MAAM,EAAE,EAClD,IAAI,EAAE,IAAI,EACV,GAAG,IAAI,EAAE,cAAc,CAAC,IAAI,CAAC,SAAS,IAAI,GACtC,CAAC,OAAO,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC,GACnC,CAAC,OAAO,CAAC,EAAE,iBAAiB,CAAC,GAChC,MAAM,CA0CR"}
+{"version":3,"file":"typed-routes.d.ts","sourceRoot":"","sources":["../src/typed-routes.ts"],"names":[],"mappings":"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"}

package/dist/typed-routes.js.map

@@ -1 +1 @@
-{"version":3,"file":"typed-routes.js","sourceRoot":"","sources":["../src/typed-routes.ts"],"names":[],"mappings":"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","sourcesContent":["export type RouteSearchValue = boolean | number | string | null | undefined;\nexport type RouteSearchParams = Record<\n  string,\n  RouteSearchValue | readonly RouteSearchValue[]\n>;\n\nexport type RouteParamsFor<Path extends `/${string}`> = Simplify<ExtractRouteParams<Path>>;\n\nexport type AppRouteHref<Path extends `/${string}`> = keyof RouteParamsFor<Path> extends never\n  ? (options?: StaticHrefOptions) => string\n  : (options: DynamicHrefOptions<Path>) => string;\n\nexport type AppRouteLinkHref<Path extends `/${string}`> =\n  `${AppRouteLinkPathname<Path>}${AppRouteLinkHrefSuffix}`;\n\nexport interface StaticHrefOptions {\n  hash?: string | undefined;\n  search?: RouteSearchParams | undefined;\n}\n\nexport interface DynamicHrefOptions<Path extends `/${string}`> extends StaticHrefOptions {\n  params: RouteParamsFor<Path>;\n}\n\ntype HasRouteParams<Path extends `/${string}`> = keyof RouteParamsFor<Path> extends never\n  ? false\n  : true;\n\ntype ExtractRouteParams<Path extends string> = Path extends `${infer Segment}/${infer Rest}`\n  ? SegmentRouteParam<Segment> & ExtractRouteParams<Rest>\n  : SegmentRouteParam<Path>;\n\ntype SegmentRouteParam<Segment extends string> = Segment extends `:...${infer Name}`\n  ? { [Key in Name]: readonly string[] }\n  : Segment extends `:${infer Name}`\n    ? { [Key in Name]: string }\n    : Record<never, never>;\n\ntype Simplify<T> = { [Key in keyof T]: T[Key] } & {};\n\nexport type AppRouteLinkHrefSuffix = \"\" | `?${string}` | `#${string}` | `?${string}#${string}`;\n\nexport type AppRouteLinkPathname<Path extends `/${string}`> = Path extends \"/\"\n  ? \"/\"\n  : Path extends `/${infer Segments}`\n    ? `/${AppRouteLinkSegments<Segments>}`\n    : never;\n\nexport type AppRouteLinkSegments<Segments extends string> = Segments extends `${infer Segment}/${infer Rest}`\n  ? `${AppRouteLinkSegment<Segment>}/${AppRouteLinkSegments<Rest>}`\n  : AppRouteLinkSegment<Segments>;\n\nexport type AppRouteLinkSegment<Segment extends string> = Segment extends `:${string}`\n  ? string\n  : Segment;\n\n/**\n * Builds an internal app-route URL from a route pattern and typed params/search options.\n *\n * Dynamic `:param` and `:...catchAll` segments are URL-encoded, search values are serialized with `URLSearchParams`, and protocol-relative or external paths are rejected.\n */\nexport function href<const Path extends `/${string}`>(\n  path: Path,\n  ...args: HasRouteParams<Path> extends true\n    ? [options: DynamicHrefOptions<Path>]\n    : [options?: StaticHrefOptions]\n): string {\n  assertInternalRoutePath(path);\n\n  const options = args[0] as\n    | (StaticHrefOptions & { params?: Record<string, readonly string[] | string> | undefined })\n    | undefined;\n  const params =\n    options !== undefined && \"params\" in options && options.params !== undefined\n      ? (options.params as Record<string, readonly string[] | string>)\n      : {};\n  const pathname = path\n    .split(\"/\")\n    .map((segment) => {\n      if (segment.startsWith(\":...\")) {\n        const name = segment.slice(4);\n        const value = params[name];\n\n        if (!Array.isArray(value)) {\n          throw new Error(`Missing catch-all route param ${JSON.stringify(name)} for ${path}.`);\n        }\n\n        return value.map((part) => encodeURIComponent(part)).join(\"/\");\n      }\n\n      if (segment.startsWith(\":\")) {\n        const name = segment.slice(1);\n        const value = params[name];\n\n        if (typeof value !== \"string\") {\n          throw new Error(`Missing route param ${JSON.stringify(name)} for ${path}.`);\n        }\n\n        return encodeURIComponent(value);\n      }\n\n      return segment;\n    })\n    .join(\"/\");\n  const search = searchString(options?.search);\n  const hash = options?.hash === undefined ? \"\" : `#${encodeURIComponent(options.hash)}`;\n\n  return `${pathname}${search}${hash}`;\n}\n\nfunction assertInternalRoutePath(path: string): void {\n  if (!path.startsWith(\"/\") || path.startsWith(\"//\")) {\n    throw new Error(`href() expected an internal route path, received ${JSON.stringify(path)}.`);\n  }\n\n  for (let index = 0; index < path.length; index += 1) {\n    const code = path.charCodeAt(index);\n\n    if (code <= 0x1f || code === 0x7f) {\n      throw new Error(\"href() route paths must not contain control characters.\");\n    }\n  }\n}\n\nfunction searchString(search: RouteSearchParams | undefined): string {\n  if (search === undefined) {\n    return \"\";\n  }\n\n  const params = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(search)) {\n    const values = Array.isArray(value) ? value : [value];\n\n    for (const entry of values) {\n      if (entry !== undefined && entry !== null) {\n        params.append(key, String(entry));\n      }\n    }\n  }\n\n  const value = params.toString();\n\n  return value === \"\" ? \"\" : `?${value}`;\n}\n"]}
+{"version":3,"file":"typed-routes.js","sourceRoot":"","sources":["../src/typed-routes.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Represents a value accepted in generated route search params.\n */\nexport type RouteSearchValue = boolean | number | string | null | undefined;\n/**\n * Represents search params accepted by typed route href helpers.\n */\nexport type RouteSearchParams = Record<\n  string,\n  RouteSearchValue | readonly RouteSearchValue[]\n>;\n\n/**\n * Extracts dynamic and catch-all params from an app route path pattern.\n */\nexport type RouteParamsFor<Path extends `/${string}`> = Simplify<ExtractRouteParams<Path>>;\n\n/**\n * Builds the callable `href()` helper type for a specific app route path.\n */\nexport type AppRouteHref<Path extends `/${string}`> = keyof RouteParamsFor<Path> extends never\n  ? (options?: StaticHrefOptions) => string\n  : (options: DynamicHrefOptions<Path>) => string;\n\n/**\n * Builds the Link `href` string type accepted for a specific app route path.\n */\nexport type AppRouteLinkHref<Path extends `/${string}`> =\n  `${AppRouteLinkPathname<Path>}${AppRouteLinkHrefSuffix}`;\n\n/**\n * Configures a static href with optional search params and hash.\n */\nexport interface StaticHrefOptions {\n  hash?: string | undefined;\n  search?: RouteSearchParams | undefined;\n}\n\n/**\n * Configures a dynamic href with route params, optional search params, and hash.\n */\nexport interface DynamicHrefOptions<Path extends `/${string}`> extends StaticHrefOptions {\n  params: RouteParamsFor<Path>;\n}\n\ntype HasRouteParams<Path extends `/${string}`> = keyof RouteParamsFor<Path> extends never\n  ? false\n  : true;\n\ntype ExtractRouteParams<Path extends string> = Path extends `${infer Segment}/${infer Rest}`\n  ? SegmentRouteParam<Segment> & ExtractRouteParams<Rest>\n  : SegmentRouteParam<Path>;\n\ntype SegmentRouteParam<Segment extends string> = Segment extends `:...${infer Name}`\n  ? { [Key in Name]: readonly string[] }\n  : Segment extends `:${infer Name}`\n    ? { [Key in Name]: string }\n    : Record<never, never>;\n\ntype Simplify<T> = { [Key in keyof T]: T[Key] } & {};\n\n/**\n * Represents the search and hash suffix portion of a typed route href.\n */\nexport type AppRouteLinkHrefSuffix = \"\" | `?${string}` | `#${string}` | `?${string}#${string}`;\n\n/**\n * Builds the pathname string type for a typed route href.\n */\nexport type AppRouteLinkPathname<Path extends `/${string}`> = Path extends \"/\"\n  ? \"/\"\n  : Path extends `/${infer Segments}`\n    ? `/${AppRouteLinkSegments<Segments>}`\n    : never;\n\n/**\n * Builds the joined path segment string type for a typed route href.\n */\nexport type AppRouteLinkSegments<Segments extends string> = Segments extends `${infer Segment}/${infer Rest}`\n  ? `${AppRouteLinkSegment<Segment>}/${AppRouteLinkSegments<Rest>}`\n  : AppRouteLinkSegment<Segments>;\n\n/**\n * Builds the string type for one static or dynamic route segment.\n */\nexport type AppRouteLinkSegment<Segment extends string> = Segment extends `:${string}`\n  ? string\n  : Segment;\n\n/**\n * Builds an internal app-route URL from a route pattern and typed params/search options.\n *\n * Dynamic `:param` and `:...catchAll` segments are URL-encoded, search values are serialized with `URLSearchParams`, and protocol-relative or external paths are rejected.\n */\nexport function href<const Path extends `/${string}`>(\n  path: Path,\n  ...args: HasRouteParams<Path> extends true\n    ? [options: DynamicHrefOptions<Path>]\n    : [options?: StaticHrefOptions]\n): string {\n  assertInternalRoutePath(path);\n\n  const options = args[0] as\n    | (StaticHrefOptions & { params?: Record<string, readonly string[] | string> | undefined })\n    | undefined;\n  const params =\n    options !== undefined && \"params\" in options && options.params !== undefined\n      ? (options.params as Record<string, readonly string[] | string>)\n      : {};\n  const pathname = path\n    .split(\"/\")\n    .map((segment) => {\n      if (segment.startsWith(\":...\")) {\n        const name = segment.slice(4);\n        const value = params[name];\n\n        if (!Array.isArray(value)) {\n          throw new Error(`Missing catch-all route param ${JSON.stringify(name)} for ${path}.`);\n        }\n\n        return value.map((part) => encodeURIComponent(part)).join(\"/\");\n      }\n\n      if (segment.startsWith(\":\")) {\n        const name = segment.slice(1);\n        const value = params[name];\n\n        if (typeof value !== \"string\") {\n          throw new Error(`Missing route param ${JSON.stringify(name)} for ${path}.`);\n        }\n\n        return encodeURIComponent(value);\n      }\n\n      return segment;\n    })\n    .join(\"/\");\n  const search = searchString(options?.search);\n  const hash = options?.hash === undefined ? \"\" : `#${encodeURIComponent(options.hash)}`;\n\n  return `${pathname}${search}${hash}`;\n}\n\nfunction assertInternalRoutePath(path: string): void {\n  if (!path.startsWith(\"/\") || path.startsWith(\"//\")) {\n    throw new Error(`href() expected an internal route path, received ${JSON.stringify(path)}.`);\n  }\n\n  for (let index = 0; index < path.length; index += 1) {\n    const code = path.charCodeAt(index);\n\n    if (code <= 0x1f || code === 0x7f) {\n      throw new Error(\"href() route paths must not contain control characters.\");\n    }\n  }\n}\n\nfunction searchString(search: RouteSearchParams | undefined): string {\n  if (search === undefined) {\n    return \"\";\n  }\n\n  const params = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(search)) {\n    const values = Array.isArray(value) ? value : [value];\n\n    for (const entry of values) {\n      if (entry !== undefined && entry !== null) {\n        params.append(key, String(entry));\n      }\n    }\n  }\n\n  const value = params.toString();\n\n  return value === \"\" ? \"\" : `?${value}`;\n}\n"]}

package/dist/types.d.ts

@@ -1,11 +1,26 @@
 import type { ReactCompatNode } from "@reckona/mreact-compat";
 import type { QueryClient } from "@reckona/mreact-query";
+/**
+ * Represents an app-router loader function.
+ */
 export type RouteLoader = (...args: never[]) => unknown;
+/**
+ * Infers resolved data returned by a route loader.
+ */
 export type InferLoaderData<TLoader extends RouteLoader> = Awaited<ReturnType<TLoader>>;
+/**
+ * Represents dynamic route params passed to loaders, pages, and handlers.
+ */
 export type RouteParams = Record<string, readonly string[] | string>;
+/**
+ * Infers route params from a loader context parameter.
+ */
 export type InferLoaderParams<TLoader extends RouteLoader> = TLoader extends (context: infer TContext, ...args: never[]) => unknown ? TContext extends {
     params: infer TParams;
 } ? TParams extends RouteParams ? TParams : RouteParams : RouteParams : RouteParams;
+/**
+ * Provides request, params, environment, and query client data to route loaders.
+ */
 export interface LoaderContext<TParams extends RouteParams = RouteParams> {
     env?: unknown;
     params: TParams;
@@ -22,15 +37,24 @@ export interface GenerateMetadataContext<TData = unknown, TParams extends RouteP
     params: TParams;
     request: Request;
 }
+/**
+ * Provides request and params to server route handlers.
+ */
 export interface RouteHandlerContext<TParams extends RouteParams = RouteParams> {
     params: TParams;
     request: Request;
 }
+/**
+ * Provides loader data, params, and request context to page components.
+ */
 export interface PageProps<TData = unknown, TParams extends RouteParams = RouteParams> {
     data: TData;
     params: TParams;
     request: Request;
 }
+/**
+ * Represents a page component whose props are inferred from a route loader.
+ */
 export type PageComponent<TLoader extends RouteLoader> = (props: PageProps<InferLoaderData<TLoader>, InferLoaderParams<TLoader>>) => ReactCompatNode;
 /**
  * Preserves the relationship between a page component and its loader when authoring route files.
@@ -38,13 +62,25 @@ export type PageComponent<TLoader extends RouteLoader> = (props: PageProps<Infer
  * Wrap a default page export with `definePage<typeof loader>(...)` to infer `data` and `params` props from the route loader without changing runtime behavior.
  */
 export declare function definePage<TLoader extends RouteLoader>(component: PageComponent<TLoader>): PageComponent<TLoader>;
+/**
+ * Provides children, params, and request context to layout components.
+ */
 export interface LayoutProps<TParams extends RouteParams = RouteParams> {
     children: ReactCompatNode;
     params: TParams;
     request: Request;
 }
+/**
+ * Re-exports the node type accepted by mreact-compatible components.
+ */
 export type MReactNode = ReactCompatNode;
+/**
+ * Represents scalar metadata values rendered into head tags and headers.
+ */
 export type MetadataScalar = boolean | number | string;
+/**
+ * Describes an image value used by route metadata.
+ */
 export interface MetadataImage {
     alt?: MetadataScalar;
     height?: MetadataScalar;
@@ -90,17 +126,29 @@ export interface RouteMetadata {
     title?: MetadataScalar;
     viewport?: MetadataScalar | MetadataViewport;
 }
+/**
+ * Describes viewport metadata key-value pairs.
+ */
 export type MetadataViewport = Record<string, MetadataScalar | null | undefined>;
+/**
+ * Describes a theme-color metadata entry with an optional media query.
+ */
 export interface MetadataThemeColor {
     color?: MetadataScalar;
     media?: MetadataScalar;
 }
+/**
+ * Describes an extra head element emitted by route metadata.
+ */
 export interface RouteHeadDescriptor {
     attrs?: Record<string, boolean | number | string | undefined>;
     content?: string;
     nonce?: boolean | string;
     tag: "base" | "link" | "meta" | "script" | "style";
 }
+/**
+ * Configures security-related response headers from route metadata.
+ */
 export interface RouteSecurityHeaders {
     contentTypeOptions?: "nosniff" | null | undefined;
     frameOptions?: "DENY" | "SAMEORIGIN" | null | undefined;
@@ -108,41 +156,65 @@ export interface RouteSecurityHeaders {
     permissionsPolicy?: Record<string, readonly string[] | null | undefined> | null | undefined;
     referrerPolicy?: string | null | undefined;
 }
+/**
+ * Configures the Strict-Transport-Security header from route metadata.
+ */
 export interface RouteStrictTransportSecurity {
     includeSubDomains?: boolean | undefined;
     maxAge: number;
     preload?: boolean | undefined;
 }
+/**
+ * Provides request context to a robots metadata route.
+ */
 export interface RobotsContext {
     baseUrl: string;
     host: string;
     request: Request;
 }
+/**
+ * Describes the robots.txt metadata route result.
+ */
 export interface RobotsManifest {
     host?: string | undefined;
     rules?: RobotsRule | readonly RobotsRule[] | undefined;
     sitemap?: string | readonly string[] | undefined;
 }
+/**
+ * Describes one robots.txt user-agent rule.
+ */
 export interface RobotsRule {
     allow?: string | readonly string[] | undefined;
     disallow?: string | readonly string[] | undefined;
     userAgent: string | readonly string[];
 }
+/**
+ * Provides request context to a sitemap metadata route.
+ */
 export interface SitemapContext {
     baseUrl: string;
     host: string;
     request: Request;
 }
+/**
+ * Describes one URL entry returned by a sitemap metadata route.
+ */
 export interface SitemapEntry {
     changeFrequency?: string | undefined;
     lastModified?: Date | string | number | undefined;
     priority?: number | undefined;
     url: string;
 }
+/**
+ * Provides request context to a web app manifest metadata route.
+ */
 export interface ManifestContext {
     baseUrl: string;
     host: string;
     request: Request;
 }
+/**
+ * Represents an arbitrary web app manifest descriptor.
+ */
 export type ManifestDescriptor = Record<string, unknown>;
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAwDA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,SAAiC;IAEjC,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { ReactCompatNode } from \"@reckona/mreact-compat\";\nimport type { QueryClient } from \"@reckona/mreact-query\";\n\nexport type RouteLoader = (...args: never[]) => unknown;\n\nexport type InferLoaderData<TLoader extends RouteLoader> = Awaited<ReturnType<TLoader>>;\n\nexport type RouteParams = Record<string, readonly string[] | string>;\n\nexport type InferLoaderParams<TLoader extends RouteLoader> = TLoader extends (\n  context: infer TContext,\n  ...args: never[]\n) => unknown\n  ? TContext extends { params: infer TParams }\n    ? TParams extends RouteParams\n      ? TParams\n      : RouteParams\n    : RouteParams\n  : RouteParams;\n\nexport interface LoaderContext<TParams extends RouteParams = RouteParams> {\n  env?: unknown;\n  params: TParams;\n  queryClient: QueryClient;\n  request: Request;\n}\n\n/**\n * Context passed to a route `generateMetadata` export.\n *\n * Metadata is evaluated on the server after loader data is available, so it can derive head tags, robots data, sitemap entries, and security header directives from the same request and route params as the page.\n */\nexport interface GenerateMetadataContext<\n  TData = unknown,\n  TParams extends RouteParams = RouteParams,\n> {\n  data: TData;\n  params: TParams;\n  request: Request;\n}\n\nexport interface RouteHandlerContext<TParams extends RouteParams = RouteParams> {\n  params: TParams;\n  request: Request;\n}\n\nexport interface PageProps<TData = unknown, TParams extends RouteParams = RouteParams> {\n  data: TData;\n  params: TParams;\n  request: Request;\n}\n\nexport type PageComponent<TLoader extends RouteLoader> = (\n  props: PageProps<InferLoaderData<TLoader>, InferLoaderParams<TLoader>>,\n) => ReactCompatNode;\n\n/**\n * Preserves the relationship between a page component and its loader when authoring route files.\n *\n * Wrap a default page export with `definePage<typeof loader>(...)` to infer `data` and `params` props from the route loader without changing runtime behavior.\n */\nexport function definePage<TLoader extends RouteLoader>(\n  component: PageComponent<TLoader>,\n): PageComponent<TLoader> {\n  return component;\n}\n\nexport interface LayoutProps<TParams extends RouteParams = RouteParams> {\n  children: ReactCompatNode;\n  params: TParams;\n  request: Request;\n}\n\nexport type MReactNode = ReactCompatNode;\n\nexport type MetadataScalar = boolean | number | string;\n\nexport interface MetadataImage {\n  alt?: MetadataScalar;\n  height?: MetadataScalar;\n  type?: MetadataScalar;\n  url: MetadataScalar;\n  width?: MetadataScalar;\n}\n\n/**\n * Declarative metadata returned by route metadata exports.\n *\n * Values are rendered into the document head and response headers by the app router; use `generateMetadata` when the values depend on loader data, params, or the current request.\n */\nexport interface RouteMetadata {\n  alternates?: {\n    canonical?: MetadataScalar;\n  };\n  csp?: {\n    disable?: boolean;\n    directives?: Record<string, readonly string[] | string>;\n    nonce?: string;\n    remove?: readonly string[];\n    replace?: Record<string, readonly string[] | string>;\n  };\n  description?: MetadataScalar;\n  head?: readonly RouteHeadDescriptor[];\n  icons?: {\n    apple?: MetadataScalar;\n    icon?: MetadataScalar;\n  };\n  openGraph?: {\n    description?: MetadataScalar;\n    image?: MetadataImage | MetadataScalar;\n    images?: readonly (MetadataImage | MetadataScalar)[];\n    title?: MetadataScalar;\n  };\n  lang?: MetadataScalar;\n  robots?:\n    | string\n    | {\n        follow?: boolean;\n        index?: boolean;\n      };\n  security?: RouteSecurityHeaders;\n  themeColor?: MetadataScalar | MetadataThemeColor;\n  title?: MetadataScalar;\n  viewport?: MetadataScalar | MetadataViewport;\n}\n\nexport type MetadataViewport = Record<string, MetadataScalar | null | undefined>;\n\nexport interface MetadataThemeColor {\n  color?: MetadataScalar;\n  media?: MetadataScalar;\n}\n\nexport interface RouteHeadDescriptor {\n  attrs?: Record<string, boolean | number | string | undefined>;\n  content?: string;\n  nonce?: boolean | string;\n  tag: \"base\" | \"link\" | \"meta\" | \"script\" | \"style\";\n}\n\nexport interface RouteSecurityHeaders {\n  contentTypeOptions?: \"nosniff\" | null | undefined;\n  frameOptions?: \"DENY\" | \"SAMEORIGIN\" | null | undefined;\n  hsts?: RouteStrictTransportSecurity | false | null | undefined;\n  permissionsPolicy?: Record<string, readonly string[] | null | undefined> | null | undefined;\n  referrerPolicy?: string | null | undefined;\n}\n\nexport interface RouteStrictTransportSecurity {\n  includeSubDomains?: boolean | undefined;\n  maxAge: number;\n  preload?: boolean | undefined;\n}\n\nexport interface RobotsContext {\n  baseUrl: string;\n  host: string;\n  request: Request;\n}\n\nexport interface RobotsManifest {\n  host?: string | undefined;\n  rules?: RobotsRule | readonly RobotsRule[] | undefined;\n  sitemap?: string | readonly string[] | undefined;\n}\n\nexport interface RobotsRule {\n  allow?: string | readonly string[] | undefined;\n  disallow?: string | readonly string[] | undefined;\n  userAgent: string | readonly string[];\n}\n\nexport interface SitemapContext {\n  baseUrl: string;\n  host: string;\n  request: Request;\n}\n\nexport interface SitemapEntry {\n  changeFrequency?: string | undefined;\n  lastModified?: Date | string | number | undefined;\n  priority?: number | undefined;\n  url: string;\n}\n\nexport interface ManifestContext {\n  baseUrl: string;\n  host: string;\n  request: Request;\n}\n\nexport type ManifestDescriptor = Record<string, unknown>;\n"]}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAgFA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CACxB,SAAiC;IAEjC,OAAO,SAAS,CAAC;AACnB,CAAC","sourcesContent":["import type { ReactCompatNode } from \"@reckona/mreact-compat\";\nimport type { QueryClient } from \"@reckona/mreact-query\";\n\n/**\n * Represents an app-router loader function.\n */\nexport type RouteLoader = (...args: never[]) => unknown;\n\n/**\n * Infers resolved data returned by a route loader.\n */\nexport type InferLoaderData<TLoader extends RouteLoader> = Awaited<ReturnType<TLoader>>;\n\n/**\n * Represents dynamic route params passed to loaders, pages, and handlers.\n */\nexport type RouteParams = Record<string, readonly string[] | string>;\n\n/**\n * Infers route params from a loader context parameter.\n */\nexport type InferLoaderParams<TLoader extends RouteLoader> = TLoader extends (\n  context: infer TContext,\n  ...args: never[]\n) => unknown\n  ? TContext extends { params: infer TParams }\n    ? TParams extends RouteParams\n      ? TParams\n      : RouteParams\n    : RouteParams\n  : RouteParams;\n\n/**\n * Provides request, params, environment, and query client data to route loaders.\n */\nexport interface LoaderContext<TParams extends RouteParams = RouteParams> {\n  env?: unknown;\n  params: TParams;\n  queryClient: QueryClient;\n  request: Request;\n}\n\n/**\n * Context passed to a route `generateMetadata` export.\n *\n * Metadata is evaluated on the server after loader data is available, so it can derive head tags, robots data, sitemap entries, and security header directives from the same request and route params as the page.\n */\nexport interface GenerateMetadataContext<\n  TData = unknown,\n  TParams extends RouteParams = RouteParams,\n> {\n  data: TData;\n  params: TParams;\n  request: Request;\n}\n\n/**\n * Provides request and params to server route handlers.\n */\nexport interface RouteHandlerContext<TParams extends RouteParams = RouteParams> {\n  params: TParams;\n  request: Request;\n}\n\n/**\n * Provides loader data, params, and request context to page components.\n */\nexport interface PageProps<TData = unknown, TParams extends RouteParams = RouteParams> {\n  data: TData;\n  params: TParams;\n  request: Request;\n}\n\n/**\n * Represents a page component whose props are inferred from a route loader.\n */\nexport type PageComponent<TLoader extends RouteLoader> = (\n  props: PageProps<InferLoaderData<TLoader>, InferLoaderParams<TLoader>>,\n) => ReactCompatNode;\n\n/**\n * Preserves the relationship between a page component and its loader when authoring route files.\n *\n * Wrap a default page export with `definePage<typeof loader>(...)` to infer `data` and `params` props from the route loader without changing runtime behavior.\n */\nexport function definePage<TLoader extends RouteLoader>(\n  component: PageComponent<TLoader>,\n): PageComponent<TLoader> {\n  return component;\n}\n\n/**\n * Provides children, params, and request context to layout components.\n */\nexport interface LayoutProps<TParams extends RouteParams = RouteParams> {\n  children: ReactCompatNode;\n  params: TParams;\n  request: Request;\n}\n\n/**\n * Re-exports the node type accepted by mreact-compatible components.\n */\nexport type MReactNode = ReactCompatNode;\n\n/**\n * Represents scalar metadata values rendered into head tags and headers.\n */\nexport type MetadataScalar = boolean | number | string;\n\n/**\n * Describes an image value used by route metadata.\n */\nexport interface MetadataImage {\n  alt?: MetadataScalar;\n  height?: MetadataScalar;\n  type?: MetadataScalar;\n  url: MetadataScalar;\n  width?: MetadataScalar;\n}\n\n/**\n * Declarative metadata returned by route metadata exports.\n *\n * Values are rendered into the document head and response headers by the app router; use `generateMetadata` when the values depend on loader data, params, or the current request.\n */\nexport interface RouteMetadata {\n  alternates?: {\n    canonical?: MetadataScalar;\n  };\n  csp?: {\n    disable?: boolean;\n    directives?: Record<string, readonly string[] | string>;\n    nonce?: string;\n    remove?: readonly string[];\n    replace?: Record<string, readonly string[] | string>;\n  };\n  description?: MetadataScalar;\n  head?: readonly RouteHeadDescriptor[];\n  icons?: {\n    apple?: MetadataScalar;\n    icon?: MetadataScalar;\n  };\n  openGraph?: {\n    description?: MetadataScalar;\n    image?: MetadataImage | MetadataScalar;\n    images?: readonly (MetadataImage | MetadataScalar)[];\n    title?: MetadataScalar;\n  };\n  lang?: MetadataScalar;\n  robots?:\n    | string\n    | {\n        follow?: boolean;\n        index?: boolean;\n      };\n  security?: RouteSecurityHeaders;\n  themeColor?: MetadataScalar | MetadataThemeColor;\n  title?: MetadataScalar;\n  viewport?: MetadataScalar | MetadataViewport;\n}\n\n/**\n * Describes viewport metadata key-value pairs.\n */\nexport type MetadataViewport = Record<string, MetadataScalar | null | undefined>;\n\n/**\n * Describes a theme-color metadata entry with an optional media query.\n */\nexport interface MetadataThemeColor {\n  color?: MetadataScalar;\n  media?: MetadataScalar;\n}\n\n/**\n * Describes an extra head element emitted by route metadata.\n */\nexport interface RouteHeadDescriptor {\n  attrs?: Record<string, boolean | number | string | undefined>;\n  content?: string;\n  nonce?: boolean | string;\n  tag: \"base\" | \"link\" | \"meta\" | \"script\" | \"style\";\n}\n\n/**\n * Configures security-related response headers from route metadata.\n */\nexport interface RouteSecurityHeaders {\n  contentTypeOptions?: \"nosniff\" | null | undefined;\n  frameOptions?: \"DENY\" | \"SAMEORIGIN\" | null | undefined;\n  hsts?: RouteStrictTransportSecurity | false | null | undefined;\n  permissionsPolicy?: Record<string, readonly string[] | null | undefined> | null | undefined;\n  referrerPolicy?: string | null | undefined;\n}\n\n/**\n * Configures the Strict-Transport-Security header from route metadata.\n */\nexport interface RouteStrictTransportSecurity {\n  includeSubDomains?: boolean | undefined;\n  maxAge: number;\n  preload?: boolean | undefined;\n}\n\n/**\n * Provides request context to a robots metadata route.\n */\nexport interface RobotsContext {\n  baseUrl: string;\n  host: string;\n  request: Request;\n}\n\n/**\n * Describes the robots.txt metadata route result.\n */\nexport interface RobotsManifest {\n  host?: string | undefined;\n  rules?: RobotsRule | readonly RobotsRule[] | undefined;\n  sitemap?: string | readonly string[] | undefined;\n}\n\n/**\n * Describes one robots.txt user-agent rule.\n */\nexport interface RobotsRule {\n  allow?: string | readonly string[] | undefined;\n  disallow?: string | readonly string[] | undefined;\n  userAgent: string | readonly string[];\n}\n\n/**\n * Provides request context to a sitemap metadata route.\n */\nexport interface SitemapContext {\n  baseUrl: string;\n  host: string;\n  request: Request;\n}\n\n/**\n * Describes one URL entry returned by a sitemap metadata route.\n */\nexport interface SitemapEntry {\n  changeFrequency?: string | undefined;\n  lastModified?: Date | string | number | undefined;\n  priority?: number | undefined;\n  url: string;\n}\n\n/**\n * Provides request context to a web app manifest metadata route.\n */\nexport interface ManifestContext {\n  baseUrl: string;\n  host: string;\n  request: Request;\n}\n\n/**\n * Represents an arbitrary web app manifest descriptor.\n */\nexport type ManifestDescriptor = Record<string, unknown>;\n"]}

package/dist/upgrade.d.ts

@@ -1,4 +1,7 @@
 import type { IncomingMessage } from "node:http";
 import type { Duplex } from "node:stream";
+/**
+ * Handles an HTTP upgrade request on the app-router Node server.
+ */
 export type HttpUpgradeHandler = (request: IncomingMessage, socket: Duplex, head: Buffer) => void;
 //# sourceMappingURL=upgrade.d.ts.map

package/dist/upgrade.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,KACT,IAAI,CAAC"}
+{"version":3,"file":"upgrade.d.ts","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,OAAO,EAAE,eAAe,EACxB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,KACT,IAAI,CAAC"}

package/dist/upgrade.js.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"","sourcesContent":["import type { IncomingMessage } from \"node:http\";\nimport type { Duplex } from \"node:stream\";\n\nexport type HttpUpgradeHandler = (\n  request: IncomingMessage,\n  socket: Duplex,\n  head: Buffer,\n) => void;\n"]}
+{"version":3,"file":"upgrade.js","sourceRoot":"","sources":["../src/upgrade.ts"],"names":[],"mappings":"","sourcesContent":["import type { IncomingMessage } from \"node:http\";\nimport type { Duplex } from \"node:stream\";\n\n/**\n * Handles an HTTP upgrade request on the app-router Node server.\n */\nexport type HttpUpgradeHandler = (\n  request: IncomingMessage,\n  socket: Duplex,\n  head: Buffer,\n) => void;\n"]}

package/dist/vite.d.ts

@@ -4,6 +4,9 @@ import type { AppRouterCache } from "./cache.js";
 import { type AppRouterProjectOptions, type ResolvedAppRouterProject } from "./config.js";
 import type { AppRouterImportPolicy } from "./import-policy.js";
 import { type RequestHostPolicy } from "./serve.js";
+/**
+ * Configures the app-router Vite middleware used by development servers.
+ */
 export interface AppRouterViteMiddlewareOptions extends AppRouterProjectOptions {
     allowedHosts?: readonly string[] | undefined;
     define?: UserConfig["define"] | undefined;
@@ -13,6 +16,9 @@ export interface AppRouterViteMiddlewareOptions extends AppRouterProjectOptions
     serverActions?: AppRouterServerActionOptions | undefined;
     vitePlugins?: readonly PluginOption[] | undefined;
 }
+/**
+ * Configures the app-router Vite plugin.
+ */
 export interface AppRouterVitePluginOptions extends AppRouterProjectOptions {
     allowedHosts?: readonly string[] | undefined;
     hostPolicy?: RequestHostPolicy | undefined;
@@ -20,10 +26,25 @@ export interface AppRouterVitePluginOptions extends AppRouterProjectOptions {
     routeCache?: AppRouterCache | undefined;
     serverActions?: AppRouterServerActionOptions | undefined;
 }
+/**
+ * Creates the app-router Vite plugin for route compilation and development middleware.
+ */
 export declare function createAppRouterVitePlugin(options: AppRouterVitePluginOptions): Plugin;
+/**
+ * Alias for `createAppRouterVitePlugin()` used by Vite config files.
+ */
 export declare const mreactRouter: typeof createAppRouterVitePlugin;
+/**
+ * Reads resolved app-router project config from a Vite plugin list.
+ */
 export declare function mreactRouterConfigFromPlugins(plugins: readonly unknown[]): ResolvedAppRouterProject | undefined;
+/**
+ * Creates Connect middleware that renders app-router requests during Vite development.
+ */
 export declare function createAppRouterViteMiddleware(options: AppRouterViteMiddlewareOptions): Connect.NextHandleFunction;
+/**
+ * Renders a development client asset generated by the app-router Vite integration.
+ */
 export declare function renderAppRouterClientAsset(appDir: string, pathname: string, options?: {
     dev?: boolean;
     vitePlugins?: readonly PluginOption[] | undefined;

package/dist/vite.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,UAAU,EAEhB,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AA0BhE,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKxE,MAAM,WAAW,8BAA+B,SAAQ,uBAAuB;IAC7E,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7C,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC3C,YAAY,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACjD,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACxC,aAAa,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;IACzD,WAAW,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAC;CACnD;AAQD,MAAM,WAAW,0BAA2B,SAAQ,uBAAuB;IACzE,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7C,UAAU,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC3C,YAAY,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACjD,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACxC,aAAa,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;CAC1D;AAmBD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CA0SrF;AAqBD,eAAO,MAAM,YAAY,kCAA4B,CAAC;AAoCtD,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,SAAS,OAAO,EAAE,GAC1B,wBAAwB,GAAG,SAAS,CActC;AAED,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,kBAAkB,CAc5B;AA0FD,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAA;CAAO,GACjF,OAAO,CAAC,QAAQ,CAAC,CAuEnB"}
+{"version":3,"file":"vite.d.ts","sourceRoot":"","sources":["../src/vite.ts"],"names":[],"mappings":"AAQA,OAAO,EAEL,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,KAAK,YAAY,EACjB,KAAK,UAAU,EAEhB,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAEL,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC9B,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AA0BhE,OAAO,EAAsB,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAKxE;;GAEG;AACH,MAAM,WAAW,8BAA+B,SAAQ,uBAAuB;IAC7E,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7C,MAAM,CAAC,EAAE,UAAU,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;IAC1C,UAAU,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC3C,YAAY,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACjD,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACxC,aAAa,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;IACzD,WAAW,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAC;CACnD;AAQD;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,uBAAuB;IACzE,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC;IAC7C,UAAU,CAAC,EAAE,iBAAiB,GAAG,SAAS,CAAC;IAC3C,YAAY,CAAC,EAAE,qBAAqB,GAAG,SAAS,CAAC;IACjD,UAAU,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACxC,aAAa,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;CAC1D;AAmBD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,0BAA0B,GAAG,MAAM,CA0SrF;AAqBD;;GAEG;AACH,eAAO,MAAM,YAAY,kCAA4B,CAAC;AAoCtD;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,SAAS,OAAO,EAAE,GAC1B,wBAAwB,GAAG,SAAS,CActC;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,kBAAkB,CAc5B;AA0FD;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IAAE,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,SAAS,YAAY,EAAE,GAAG,SAAS,CAAA;CAAO,GACjF,OAAO,CAAC,QAAQ,CAAC,CAuEnB"}

package/dist/vite.js

@@ -23,6 +23,9 @@ const virtualClientPrefix = "\0mreact-router-client:";
 const virtualReactiveCoreId = "\0mreact-router-reactive-core";
 const virtualReactiveDevtoolsId = "\0mreact-router-reactive-devtools";
 const mreactRouterConfigKey = "__mreactRouterConfig";
+/**
+ * Creates the app-router Vite plugin for route compilation and development middleware.
+ */
 export function createAppRouterVitePlugin(options) {
     const project = resolveAppRouterProjectOptions(options);
     const normalizedSourceDirs = project.allowedSourceDirs.map((directory) => normalizePath(directory));
@@ -290,6 +293,9 @@ function isMreactClientSourceDependency(filename, normalizedSourceDirs) {
 function isCompatSourcePath(filename) {
     return /\.compat(?:\.mreact)?(?:\.[cm]?[jt]sx?)?$/.test(filename);
 }
+/**
+ * Alias for `createAppRouterVitePlugin()` used by Vite config files.
+ */
 export const mreactRouter = createAppRouterVitePlugin;
 function routeTransformUserVitePlugins(pluginOptions) {
     const plugins = [];
@@ -316,6 +322,9 @@ function routeTransformUserVitePlugins(pluginOptions) {
     }
     return plugins;
 }
+/**
+ * Reads resolved app-router project config from a Vite plugin list.
+ */
 export function mreactRouterConfigFromPlugins(plugins) {
     for (const plugin of plugins.flat(Infinity)) {
         if (plugin !== null && typeof plugin === "object" && mreactRouterConfigKey in plugin) {
@@ -328,6 +337,9 @@ export function mreactRouterConfigFromPlugins(plugins) {
     }
     return undefined;
 }
+/**
+ * Creates Connect middleware that renders app-router requests during Vite development.
+ */
 export function createAppRouterViteMiddleware(options) {
     // Reused across requests so dev navigation-script detection memoizes module
     // contexts/analyses instead of re-walking every route's import graph per
@@ -403,6 +415,9 @@ async function handleAppRouterViteRequest(options, incoming, outgoing, next) {
         next(error);
     }
 }
+/**
+ * Renders a development client asset generated by the app-router Vite integration.
+ */
 export async function renderAppRouterClientAsset(appDir, pathname, options = {}) {
     if (pathname === `/_mreact/client/${navigationRuntimeScriptForDev()}`) {
         const output = await buildNavigationRuntimeBundle();