@markless/router 0.5.0 → 0.7.0

package/dist/index-BjxpxRL7.d.ts

@@ -0,0 +1,248 @@
+import { createExternalDelegateStructureTokens, createExternalDelegateView } from "@markless/web/fns/external-delegate";
+//#region src/route-dom.d.ts
+declare const HTML_ATTRIBUTES_SLOT = "__marklessRouterHtmlAttributes";
+//#endregion
+//#region src/route-manifest.d.ts
+interface RouteManifestRoute {
+  readonly pathname: string;
+  readonly pattern: string;
+  readonly file: string;
+  readonly params: readonly RouteManifestParam[];
+}
+interface RouteManifestParam {
+  readonly name: string;
+  readonly kind: 'dynamic' | 'catch-all';
+}
+interface RouteManifestStatusPages {
+  readonly notFound?: string;
+  readonly error?: string;
+}
+interface RouteManifest {
+  readonly routes: readonly RouteManifestRoute[];
+  readonly statusPages: RouteManifestStatusPages;
+}
+interface RouteManifestMatch {
+  readonly route: RouteManifestRoute;
+  readonly params: Readonly<Record<string, string>>;
+}
+declare function buildRouteManifestFromFileIds(fileIds: readonly string[]): RouteManifest;
+declare function normalizeRequestPathname(pathname: string): string;
+declare function normalizeRouteFileId(fileId: string): string;
+declare function matchRouteManifest(pathname: string, manifest: RouteManifest): RouteManifestMatch | undefined;
+//#endregion
+//#region src/request-files.d.ts
+type RequestFileDiagnosticCode = 'http-method-export' | 'invalid-cache-metadata' | 'missing-default-function';
+interface RequestFileDiagnostic {
+  readonly code: RequestFileDiagnosticCode;
+  readonly message: string;
+}
+interface RequestFileDefaultExport {
+  readonly kind: 'function';
+  readonly parameterName?: string;
+}
+interface RequestFileParam {
+  readonly name: string;
+  readonly kind: 'dynamic' | 'catch-all';
+}
+interface ApiRequestFileRoute {
+  readonly pathname: string;
+  readonly pattern: string;
+  readonly params: readonly RequestFileParam[];
+}
+interface ApiRequestFileCache {
+  readonly maxAge: number;
+}
+interface RequestFileTransformResult {
+  readonly code: string;
+  readonly file: string;
+  readonly kind: 'api' | 'middleware';
+}
+type ApiRequestFileMethod = 'all' | 'connect' | 'delete' | 'get' | 'head' | 'options' | 'patch' | 'post' | 'put' | 'trace';
+type RequestFileParseResult = {
+  readonly diagnostics: readonly [];
+  readonly file: string;
+  readonly kind: 'none';
+} | {
+  readonly cache?: ApiRequestFileCache;
+  readonly defaultExport?: RequestFileDefaultExport;
+  readonly diagnostics: readonly RequestFileDiagnostic[];
+  readonly file: string;
+  readonly kind: 'api';
+  readonly method: ApiRequestFileMethod;
+  readonly route: ApiRequestFileRoute;
+} | {
+  readonly defaultExport?: RequestFileDefaultExport;
+  readonly diagnostics: readonly RequestFileDiagnostic[];
+  readonly file: string;
+  readonly kind: 'middleware';
+};
+declare function parseRequestFile(fileId: string, sourceText: string): RequestFileParseResult;
+declare function normalizeRequestFileId(fileId: string): string;
+declare function transformRequestFileSource(fileId: string, sourceText: string): RequestFileTransformResult | undefined;
+//#endregion
+//#region src/navigate.d.ts
+interface NavigateOptions {
+  /** Replace the current history entry instead of adding one. */
+  readonly replace?: boolean;
+  /** `false` keeps the scroll position. */
+  readonly scroll?: boolean;
+}
+/**
+ * Navigates to `href` exactly as a click on `<Link href={href}>` would: a page of this app swaps in
+ * place, anything else loads as a document. The promise resolves once the new page is in place; a
+ * navigation that loads a new document leaves this page, so its promise never settles.
+ * Runs in the browser only.
+ */
+declare function navigate(href: string | URL, options?: NavigateOptions): Promise<void>;
+//#endregion
+//#region src/route-renderer.d.ts
+declare function startRouteUpdateRenderer(document?: Document): void;
+//#endregion
+//#region src/spa-navigation.d.ts
+type MarklessRouterNavigationRuntime = Pick<Navigation, 'addEventListener' | 'navigate'>;
+interface MarklessRouterNavigationWindow {
+  readonly document: Document;
+  readonly location: Location;
+  navigation?: MarklessRouterNavigationRuntime;
+  addEventListener(type: 'click', listener: (event: MouseEvent) => void, options?: boolean | AddEventListenerOptions): void;
+}
+interface MarklessRouterNavigationPolyfillModule {
+  applyPolyfill(options: {
+    readonly interceptEvents: boolean;
+    readonly window: MarklessRouterNavigationWindow;
+  }): unknown;
+}
+interface StartSpaNavigationOptions {
+  readonly documentModuleLoader?: () => Promise<unknown>;
+  readonly documentNavigation?: 'client' | 'document';
+  readonly loadPolyfill?: () => Promise<MarklessRouterNavigationPolyfillModule>;
+  readonly pageModuleLoaders: Record<string, () => Promise<unknown>>;
+  readonly preloadRouteModule?: (file: string) => unknown;
+  readonly routeFileIds: readonly string[];
+  readonly window?: MarklessRouterNavigationWindow;
+}
+declare function __marklessRouterStartSpaNavigation(options: StartSpaNavigationOptions): Promise<void>;
+declare function ensureNavigationRuntime(runtimeWindow?: MarklessRouterNavigationWindow, loadPolyfill?: () => Promise<MarklessRouterNavigationPolyfillModule>): Promise<MarklessRouterNavigationRuntime>;
+//#endregion
+//#region src/route-state.d.ts
+declare const MARKLESS_ROUTER_ROUTE_EVENT = "marklessrouternavigate";
+declare const MARKLESS_ROUTER_RENDERED_EVENT = "marklessrouterrendered";
+interface RouteState {
+  readonly file: string;
+  readonly params: Readonly<Record<string, string>>;
+  readonly status: number;
+  readonly url: string;
+}
+interface RoutePageModule {
+  readonly default?: unknown;
+}
+interface RouteDocumentModule {
+  readonly default?: unknown;
+}
+interface RouteUpdate {
+  readonly document?: RouteDocumentModule;
+  readonly page: RoutePageModule;
+  readonly route: RouteState;
+  readonly signal?: AbortSignal;
+  readonly onRendered?: () => void;
+}
+declare function routePageProps(route: RouteState): Omit<PageProps, 'http'>;
+declare function dispatchRouteUpdate(document: Document, update: RouteUpdate): void;
+//#endregion
+//#region src/index.d.ts
+interface PageProps<Params extends object = Readonly<Record<string, string>>, Locals extends object = AppLocals> {
+  /**
+   * The request and the response being written, the same object API routes and middleware get.
+   * It exists only while the page renders on the server: the compiler refuses any read of it from
+   * code that runs in the browser. Set `http.response.status` and `http.response.headers` before the
+   * first byte is sent; a later write that changes them throws `MARKLESS_ROUTER_RESPONSE_COMMITTED`.
+   */
+  readonly http: HttpContext<Locals>;
+  readonly params: Readonly<Params>;
+  readonly url: {
+    readonly href: string;
+    readonly pathname: string;
+    readonly search: string;
+  };
+  readonly status: number;
+}
+interface MarklessRouterGeneratedRoutes {}
+interface LinkNavigationProps {
+  /**
+   * `false`: nothing for this link downloads before it is clicked. Only page routes are ever
+   * prefetched (with a `Purpose: prefetch` header), never `/api` endpoints; set `false` on a link to
+   * a page whose GET has side effects (a one-time token, a counter) so only the click requests it.
+   */
+  readonly prefetch?: boolean;
+  readonly replace?: boolean;
+  readonly scroll?: boolean;
+}
+type DefaultLinkProps = {
+  readonly href?: string;
+  readonly children?: __MarklessTypeService.Child;
+  readonly class?: string;
+  readonly id?: string;
+  readonly target?: string;
+  readonly rel?: string;
+  readonly [prop: string]: unknown;
+} & LinkNavigationProps;
+type LinkProps = MarklessRouterGeneratedRoutes extends {
+  readonly link: infer Props;
+} ? Props & Pick<DefaultLinkProps, 'children' | 'class' | 'id' | 'target' | 'rel'> & {
+  readonly [prop: string]: unknown;
+} : DefaultLinkProps;
+interface AppLocals {}
+interface HttpResponse {
+  readonly headers: Headers;
+  status?: number;
+  statusText?: string;
+}
+interface HttpContext<Locals extends object = AppLocals> {
+  readonly locals: Locals;
+  readonly request: Request;
+  readonly response: HttpResponse;
+  readonly url: URL;
+}
+interface EndpointHttpContext<Params extends object = Readonly<Record<string, string>>, Locals extends object = AppLocals> extends HttpContext<Locals> {
+  readonly params: Readonly<Params>;
+}
+interface MiddlewareHttpContext<Locals extends object = AppLocals> extends HttpContext<Locals> {}
+type RuntimeHttpEvent = {
+  readonly context?: Record<string, unknown>;
+  readonly req?: Request;
+  readonly res?: HttpResponse;
+  readonly url?: URL;
+};
+declare function __marklessCreateHttpContext<Params extends object = Readonly<Record<string, string>>, Locals extends object = AppLocals>(event: RuntimeHttpEvent): EndpointHttpContext<Params, Locals>;
+declare const Html: ((props: {
+  readonly children?: __MarklessTypeService.Child;
+}) => unknown) & {
+  renderSsr(props?: {
+    readonly children?: __MarklessTypeService.Child;
+    readonly [name: string]: unknown;
+  }, renderContext?: {
+    readonly [HTML_ATTRIBUTES_SLOT]?: Record<string, unknown>;
+  }): {
+    html: string;
+    elementCount: number;
+  };
+};
+type LinkComponent = {
+  (props?: LinkProps): unknown;
+  renderCsr(props?: LinkProps): {
+    root: HTMLAnchorElement;
+    view: ReturnType<typeof createExternalDelegateView>;
+    liveHostNodes: Map<string, HTMLAnchorElement>;
+  };
+  renderSsr(props?: LinkProps, renderContext?: {
+    readonly idPrefix?: string;
+  }): {
+    html: string;
+    elementCount: number;
+    structureTokens: ReturnType<typeof createExternalDelegateStructureTokens>;
+    view: ReturnType<typeof createExternalDelegateView>;
+  };
+};
+declare const Link: LinkComponent;
+//#endregion
+export { RequestFileDefaultExport as A, RouteManifestMatch as B, ensureNavigationRuntime as C, ApiRequestFileCache as D, navigate as E, RequestFileTransformResult as F, matchRouteManifest as G, RouteManifestRoute as H, normalizeRequestFileId as I, normalizeRequestPathname as K, parseRequestFile as L, RequestFileDiagnosticCode as M, RequestFileParam as N, ApiRequestFileMethod as O, RequestFileParseResult as P, transformRequestFileSource as R, __marklessRouterStartSpaNavigation as S, NavigateOptions as T, RouteManifestStatusPages as U, RouteManifestParam as V, buildRouteManifestFromFileIds as W, RoutePageModule as _, HttpContext as a, dispatchRouteUpdate as b, LinkNavigationProps as c, MiddlewareHttpContext as d, PageProps as f, RouteDocumentModule as g, MARKLESS_ROUTER_ROUTE_EVENT as h, Html as i, RequestFileDiagnostic as j, ApiRequestFileRoute as k, LinkProps as l, MARKLESS_ROUTER_RENDERED_EVENT as m, DefaultLinkProps as n, HttpResponse as o, __marklessCreateHttpContext as p, normalizeRouteFileId as q, EndpointHttpContext as r, Link as s, AppLocals as t, MarklessRouterGeneratedRoutes as u, RouteState as v, startRouteUpdateRenderer as w, routePageProps as x, RouteUpdate as y, RouteManifest as z };

package/dist/index.d.ts

@@ -1,233 +1,2 @@
-import { createExternalDelegateStructureTokens, createExternalDelegateView } from "@markless/web/fns/external-delegate";
-//#region src/route-dom.d.ts
-declare const HTML_ATTRIBUTES_SLOT = "__marklessRouterHtmlAttributes";
-//#endregion
-//#region src/route-manifest.d.ts
-interface RouteManifestRoute {
-  readonly pathname: string;
-  readonly pattern: string;
-  readonly file: string;
-  readonly params: readonly RouteManifestParam[];
-}
-interface RouteManifestParam {
-  readonly name: string;
-  readonly kind: 'dynamic' | 'catch-all';
-}
-interface RouteManifestStatusPages {
-  readonly notFound?: string;
-  readonly error?: string;
-}
-interface RouteManifest {
-  readonly routes: readonly RouteManifestRoute[];
-  readonly statusPages: RouteManifestStatusPages;
-}
-interface RouteManifestMatch {
-  readonly route: RouteManifestRoute;
-  readonly params: Readonly<Record<string, string>>;
-}
-export declare function buildRouteManifestFromFileIds(fileIds: readonly string[]): RouteManifest;
-export declare function normalizeRequestPathname(pathname: string): string;
-export declare function normalizeRouteFileId(fileId: string): string;
-export declare function matchRouteManifest(pathname: string, manifest: RouteManifest): RouteManifestMatch | undefined;
-//#endregion
-//#region src/request-files.d.ts
-type RequestFileDiagnosticCode = 'http-method-export' | 'invalid-cache-metadata' | 'missing-default-function';
-interface RequestFileDiagnostic {
-  readonly code: RequestFileDiagnosticCode;
-  readonly message: string;
-}
-interface RequestFileDefaultExport {
-  readonly kind: 'function';
-  readonly parameterName?: string;
-}
-interface RequestFileParam {
-  readonly name: string;
-  readonly kind: 'dynamic' | 'catch-all';
-}
-interface ApiRequestFileRoute {
-  readonly pathname: string;
-  readonly pattern: string;
-  readonly params: readonly RequestFileParam[];
-}
-interface ApiRequestFileCache {
-  readonly maxAge: number;
-}
-interface RequestFileTransformResult {
-  readonly code: string;
-  readonly file: string;
-  readonly kind: 'api' | 'middleware';
-}
-type ApiRequestFileMethod = 'all' | 'connect' | 'delete' | 'get' | 'head' | 'options' | 'patch' | 'post' | 'put' | 'trace';
-type RequestFileParseResult = {
-  readonly diagnostics: readonly [];
-  readonly file: string;
-  readonly kind: 'none';
-} | {
-  readonly cache?: ApiRequestFileCache;
-  readonly defaultExport?: RequestFileDefaultExport;
-  readonly diagnostics: readonly RequestFileDiagnostic[];
-  readonly file: string;
-  readonly kind: 'api';
-  readonly method: ApiRequestFileMethod;
-  readonly route: ApiRequestFileRoute;
-} | {
-  readonly defaultExport?: RequestFileDefaultExport;
-  readonly diagnostics: readonly RequestFileDiagnostic[];
-  readonly file: string;
-  readonly kind: 'middleware';
-};
-export declare function parseRequestFile(fileId: string, sourceText: string): RequestFileParseResult;
-export declare function normalizeRequestFileId(fileId: string): string;
-export declare function transformRequestFileSource(fileId: string, sourceText: string): RequestFileTransformResult | undefined;
-//#endregion
-//#region src/route-renderer.d.ts
-export declare function startRouteUpdateRenderer(document?: Document): void;
-//#endregion
-//#region src/spa-navigation.d.ts
-type MarklessRouterNavigationRuntime = Pick<Navigation, 'addEventListener' | 'navigate'>;
-interface MarklessRouterNavigationWindow {
-  readonly document: Document;
-  readonly location: Location;
-  navigation?: MarklessRouterNavigationRuntime;
-  addEventListener(type: 'click', listener: (event: MouseEvent) => void, options?: boolean | AddEventListenerOptions): void;
-}
-interface MarklessRouterNavigationPolyfillModule {
-  applyPolyfill(options: {
-    readonly interceptEvents: boolean;
-    readonly window: MarklessRouterNavigationWindow;
-  }): unknown;
-}
-interface StartSpaNavigationOptions {
-  readonly documentModuleLoader?: () => Promise<unknown>;
-  readonly documentNavigation?: 'client' | 'document';
-  readonly loadPolyfill?: () => Promise<MarklessRouterNavigationPolyfillModule>;
-  readonly pageModuleLoaders: Record<string, () => Promise<unknown>>;
-  readonly preloadRouteModule?: (file: string) => unknown;
-  readonly routeFileIds: readonly string[];
-  readonly window?: MarklessRouterNavigationWindow;
-}
-export declare function __marklessRouterStartSpaNavigation(options: StartSpaNavigationOptions): Promise<void>;
-export declare function ensureNavigationRuntime(runtimeWindow?: MarklessRouterNavigationWindow, loadPolyfill?: () => Promise<MarklessRouterNavigationPolyfillModule>): Promise<MarklessRouterNavigationRuntime>;
-//#endregion
-//#region src/route-state.d.ts
-export declare const MARKLESS_ROUTER_ROUTE_EVENT = "marklessrouternavigate";
-export declare const MARKLESS_ROUTER_RENDERED_EVENT = "marklessrouterrendered";
-interface RouteState {
-  readonly file: string;
-  readonly params: Readonly<Record<string, string>>;
-  readonly status: number;
-  readonly url: string;
-}
-interface RoutePageModule {
-  readonly default?: unknown;
-}
-interface RouteDocumentModule {
-  readonly default?: unknown;
-}
-interface RouteUpdate {
-  readonly document?: RouteDocumentModule;
-  readonly page: RoutePageModule;
-  readonly route: RouteState;
-  readonly signal?: AbortSignal;
-  readonly onRendered?: () => void;
-}
-export declare function routePageProps(route: RouteState): Omit<PageProps, 'http'>;
-export declare function dispatchRouteUpdate(document: Document, update: RouteUpdate): void;
-//#endregion
-//#region src/index.d.ts
-export interface PageProps<Params extends object = Readonly<Record<string, string>>, Locals extends object = AppLocals> {
-  /**
-   * The request and the response being written, the same object API routes and middleware get.
-   * It exists only while the page renders on the server: the compiler refuses any read of it from
-   * code that runs in the browser. Set `http.response.status` and `http.response.headers` before the
-   * first byte is sent; a later write that changes them throws `MARKLESS_ROUTER_RESPONSE_COMMITTED`.
-   */
-  readonly http: HttpContext<Locals>;
-  readonly params: Readonly<Params>;
-  readonly url: {
-    readonly href: string;
-    readonly pathname: string;
-    readonly search: string;
-  };
-  readonly status: number;
-}
-export interface MarklessRouterGeneratedRoutes {}
-export interface LinkNavigationProps {
-  /**
-   * `false`: nothing for this link downloads before it is clicked. Only page routes are ever
-   * prefetched (with a `Purpose: prefetch` header), never `/api` endpoints; set `false` on a link to
-   * a page whose GET has side effects (a one-time token, a counter) so only the click requests it.
-   */
-  readonly prefetch?: boolean;
-  readonly replace?: boolean;
-  readonly scroll?: boolean;
-}
-export type DefaultLinkProps = {
-  readonly href?: string;
-  readonly children?: __MarklessTypeService.Child;
-  readonly class?: string;
-  readonly id?: string;
-  readonly target?: string;
-  readonly rel?: string;
-  readonly [prop: string]: unknown;
-} & LinkNavigationProps;
-export type LinkProps = MarklessRouterGeneratedRoutes extends {
-  readonly link: infer Props;
-} ? Props & Pick<DefaultLinkProps, 'children' | 'class' | 'id' | 'target' | 'rel'> & {
-  readonly [prop: string]: unknown;
-} : DefaultLinkProps;
-export interface AppLocals {}
-export interface HttpResponse {
-  readonly headers: Headers;
-  status?: number;
-  statusText?: string;
-}
-export interface HttpContext<Locals extends object = AppLocals> {
-  readonly locals: Locals;
-  readonly request: Request;
-  readonly response: HttpResponse;
-  readonly url: URL;
-}
-export interface EndpointHttpContext<Params extends object = Readonly<Record<string, string>>, Locals extends object = AppLocals> extends HttpContext<Locals> {
-  readonly params: Readonly<Params>;
-}
-export interface MiddlewareHttpContext<Locals extends object = AppLocals> extends HttpContext<Locals> {}
-type RuntimeHttpEvent = {
-  readonly context?: Record<string, unknown>;
-  readonly req?: Request;
-  readonly res?: HttpResponse;
-  readonly url?: URL;
-};
-export declare function __marklessCreateHttpContext<Params extends object = Readonly<Record<string, string>>, Locals extends object = AppLocals>(event: RuntimeHttpEvent): EndpointHttpContext<Params, Locals>;
-export declare const Html: ((props: {
-  readonly children?: __MarklessTypeService.Child;
-}) => unknown) & {
-  renderSsr(props?: {
-    readonly children?: __MarklessTypeService.Child;
-    readonly [name: string]: unknown;
-  }, renderContext?: {
-    readonly [HTML_ATTRIBUTES_SLOT]?: Record<string, unknown>;
-  }): {
-    html: string;
-    elementCount: number;
-  };
-};
-type LinkComponent = {
-  (props?: LinkProps): unknown;
-  renderCsr(props?: LinkProps): {
-    root: HTMLAnchorElement;
-    view: ReturnType<typeof createExternalDelegateView>;
-    liveHostNodes: Map<string, HTMLAnchorElement>;
-  };
-  renderSsr(props?: LinkProps, renderContext?: {
-    readonly idPrefix?: string;
-  }): {
-    html: string;
-    elementCount: number;
-    structureTokens: ReturnType<typeof createExternalDelegateStructureTokens>;
-    view: ReturnType<typeof createExternalDelegateView>;
-  };
-};
-export declare const Link: LinkComponent;
-//#endregion
-export type { ApiRequestFileCache, ApiRequestFileMethod, ApiRequestFileRoute, RequestFileDefaultExport, RequestFileDiagnostic, RequestFileDiagnosticCode, RequestFileParam, RequestFileParseResult, RequestFileTransformResult, RouteDocumentModule, RouteManifest, RouteManifestMatch, RouteManifestParam, RouteManifestRoute, RouteManifestStatusPages, RoutePageModule, RouteState, RouteUpdate };
+import { A as RequestFileDefaultExport, B as RouteManifestMatch, C as ensureNavigationRuntime, D as ApiRequestFileCache, E as navigate, F as RequestFileTransformResult, G as matchRouteManifest, H as RouteManifestRoute, I as normalizeRequestFileId, K as normalizeRequestPathname, L as parseRequestFile, M as RequestFileDiagnosticCode, N as RequestFileParam, O as ApiRequestFileMethod, P as RequestFileParseResult, R as transformRequestFileSource, S as __marklessRouterStartSpaNavigation, T as NavigateOptions, U as RouteManifestStatusPages, V as RouteManifestParam, W as buildRouteManifestFromFileIds, _ as RoutePageModule, a as HttpContext, b as dispatchRouteUpdate, c as LinkNavigationProps, d as MiddlewareHttpContext, f as PageProps, g as RouteDocumentModule, h as MARKLESS_ROUTER_ROUTE_EVENT, i as Html, j as RequestFileDiagnostic, k as ApiRequestFileRoute, l as LinkProps, m as MARKLESS_ROUTER_RENDERED_EVENT, n as DefaultLinkProps, o as HttpResponse, p as __marklessCreateHttpContext, q as normalizeRouteFileId, r as EndpointHttpContext, s as Link, t as AppLocals, u as MarklessRouterGeneratedRoutes, v as RouteState, w as startRouteUpdateRenderer, x as routePageProps, y as RouteUpdate, z as RouteManifest } from "./index-BjxpxRL7.js";
+export { type ApiRequestFileCache, type ApiRequestFileMethod, type ApiRequestFileRoute, AppLocals, DefaultLinkProps, EndpointHttpContext, Html, HttpContext, HttpResponse, Link, LinkNavigationProps, LinkProps, MARKLESS_ROUTER_RENDERED_EVENT, MARKLESS_ROUTER_ROUTE_EVENT, MarklessRouterGeneratedRoutes, MiddlewareHttpContext, type NavigateOptions, PageProps, type RequestFileDefaultExport, type RequestFileDiagnostic, type RequestFileDiagnosticCode, type RequestFileParam, type RequestFileParseResult, type RequestFileTransformResult, type RouteDocumentModule, type RouteManifest, type RouteManifestMatch, type RouteManifestParam, type RouteManifestRoute, type RouteManifestStatusPages, type RoutePageModule, type RouteState, type RouteUpdate, __marklessCreateHttpContext, __marklessRouterStartSpaNavigation, buildRouteManifestFromFileIds, dispatchRouteUpdate, ensureNavigationRuntime, matchRouteManifest, navigate, normalizeRequestFileId, normalizeRequestPathname, normalizeRouteFileId, parseRequestFile, routePageProps, startRouteUpdateRenderer, transformRequestFileSource };

package/dist/index.js

@@ -1,19 +1,8 @@
-import { i as SCROLL_ATTRIBUTE, n as PREFETCH_ATTRIBUTE, r as REPLACE_ATTRIBUTE, t as LINK_ATTRIBUTE } from "./link-attributes-nY1Qkmx2.js";
-import { a as routeMountTarget, r as HTML_ATTRIBUTES_SLOT, t as rememberRequestLocals } from "./request-locals-BFPF6Vdm.js";
-import { a as normalizeRouteFileId, i as normalizeRequestPathname, r as matchRouteManifest, t as buildRouteManifestFromFileIds } from "./route-manifest-Bw_nFohL.js";
-import { n as parseRequestFile, r as transformRequestFileSource, t as normalizeRequestFileId } from "./request-files-Ca8E0FOo.js";
+import { d as REPLACE_ATTRIBUTE, f as SCROLL_ATTRIBUTE, i as HTML_ATTRIBUTES_SLOT, l as LINK_ATTRIBUTE, s as routeMountTarget, t as rememberRequestLocals, u as PREFETCH_ATTRIBUTE } from "./request-locals-BDAhNpEa.js";
+import { a as normalizeRequestPathname, c as parseRequestFile, i as matchRouteManifest, l as transformRequestFileSource, n as buildRouteManifestFromFileIds, o as normalizeRouteFileId, s as normalizeRequestFileId } from "./route-manifest-DMizh42B.js";
 import { createExternalDelegateStructureTokens, createExternalDelegateView } from "@markless/web/fns/external-delegate";
 import { render } from "@markless/web/render";
 import { MARKLESS_PENDING_MIN_VISIBLE_MS as MARKLESS_NAV_PENDING_MIN_MS, settleOrPendingDeadline } from "@markless/web/fns/pending-timing";
-//#region src/navigation-hold.ts
-async function holdNavigationSwapUntilSettled(input) {
-	const settled = input.runtime.whenAsyncBoundariesSettled?.();
-	if (settled) {
-		if (await settleOrPendingDeadline(settled, input.clock?.wait) === "deadline") await input.runtime.holdPendingSettleCommits?.(MARKLESS_NAV_PENDING_MIN_MS);
-	}
-	if (input.signal?.aborted) return false;
-}
-//#endregion
 //#region src/route-state.ts
 const MARKLESS_ROUTER_ROUTE_EVENT = "marklessrouternavigate";
 const MARKLESS_ROUTER_RENDERED_EVENT = "marklessrouterrendered";
@@ -34,6 +23,66 @@ function dispatchRouteUpdate(document, update) {
 	document.dispatchEvent(new CustomEvent(MARKLESS_ROUTER_ROUTE_EVENT, { detail: update }));
 }
 //#endregion
+//#region src/navigate.ts
+/**
+* Navigates to `href` exactly as a click on `<Link href={href}>` would: a page of this app swaps in
+* place, anything else loads as a document. The promise resolves once the new page is in place; a
+* navigation that loads a new document leaves this page, so its promise never settles.
+* Runs in the browser only.
+*/
+function navigate(href, options = {}) {
+	if (typeof document === "undefined") throw new Error("MARKLESS_ROUTER_NAVIGATE_SERVER: navigate() runs in the browser. Call it from an event handler or other browser code, not while the page renders on the server.");
+	const d = document;
+	const w = d.defaultView ?? window;
+	const url = new URL(href, d.baseURI);
+	const rendered = new Promise((resolve) => d.addEventListener(MARKLESS_ROUTER_RENDERED_EVENT, () => resolve(), { once: true }));
+	const anchor = d.createElement("a");
+	anchor.href = url.href;
+	anchor.hidden = true;
+	anchor.setAttribute(LINK_ATTRIBUTE, "");
+	if (options.replace) anchor.setAttribute(REPLACE_ATTRIBUTE, "");
+	if (options.scroll === false) anchor.setAttribute(SCROLL_ATTRIBUTE, "manual");
+	let reached = false;
+	let routed = false;
+	const last = (event) => {
+		if (event.target !== anchor) return;
+		reached = true;
+		routed = event.defaultPrevented;
+		event.preventDefault();
+	};
+	w.addEventListener("click", last);
+	d.body.append(anchor);
+	try {
+		anchor.dispatchEvent(new MouseEvent("click", {
+			bubbles: true,
+			cancelable: true,
+			composed: true,
+			button: 0
+		}));
+	} finally {
+		anchor.remove();
+		w.removeEventListener("click", last);
+	}
+	if (routed || !reached) return rendered;
+	const inPage = url.hash !== "" && withoutHash(url.href) === withoutHash(w.location.href);
+	if (options.replace) w.location.replace(url.href);
+	else w.location.assign(url.href);
+	return inPage ? Promise.resolve() : new Promise(() => {});
+}
+function withoutHash(href) {
+	const at = href.indexOf("#");
+	return at === -1 ? href : href.slice(0, at);
+}
+//#endregion
+//#region src/navigation-hold.ts
+async function holdNavigationSwapUntilSettled(input) {
+	const settled = input.runtime.whenAsyncBoundariesSettled?.();
+	if (settled) {
+		if (await settleOrPendingDeadline(settled, input.clock?.wait) === "deadline") await input.runtime.holdPendingSettleCommits?.(MARKLESS_NAV_PENDING_MIN_MS);
+	}
+	if (input.signal?.aborted) return false;
+}
+//#endregion
 //#region src/route-renderer.ts
 const CURRENT_ROUTE_CONTAINER = "__marklessRouterCurrentRouteContainer";
 function startRouteUpdateRenderer(document = window.document) {
@@ -241,7 +290,7 @@ function browserWindow() {
 function __marklessCreateHttpContext(event) {
 	const context = event.context ?? {};
 	const url = event.url ?? new URL("http://localhost/");
-	if (event.req) rememberRequestLocals(event.req, context);
+	if (event.req) rememberRequestLocals(event.req, context, event.res?.headers);
 	return {
 		locals: context,
 		params: context.params ?? {},
@@ -325,4 +374,4 @@ function escapeHtml(value) {
 	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll("\"", "&quot;");
 }
 //#endregion
-export { Html, Link, MARKLESS_ROUTER_RENDERED_EVENT, MARKLESS_ROUTER_ROUTE_EVENT, __marklessCreateHttpContext, __marklessRouterStartSpaNavigation, buildRouteManifestFromFileIds, dispatchRouteUpdate, ensureNavigationRuntime, matchRouteManifest, normalizeRequestFileId, normalizeRequestPathname, normalizeRouteFileId, parseRequestFile, routePageProps, startRouteUpdateRenderer, transformRequestFileSource };
+export { Html, Link, MARKLESS_ROUTER_RENDERED_EVENT, MARKLESS_ROUTER_ROUTE_EVENT, __marklessCreateHttpContext, __marklessRouterStartSpaNavigation, buildRouteManifestFromFileIds, dispatchRouteUpdate, ensureNavigationRuntime, matchRouteManifest, navigate, normalizeRequestFileId, normalizeRequestPathname, normalizeRouteFileId, parseRequestFile, routePageProps, startRouteUpdateRenderer, transformRequestFileSource };