@torpor/build 1.1.0 → 1.3.0

package/dist/SessionHelper-MaodMaLU.d.mts

@@ -0,0 +1,148 @@
+import { SerializeOptions } from "cookie";
+//#region src/server/CookieHelper.d.ts
+declare class CookieHelper {
+  request: Request;
+  cookies: Map<string, string>;
+  constructor(request: Request);
+  get(name: string): string | undefined;
+  set(name: string, value: string, options?: SerializeOptions): void;
+  delete(name: string, options?: SerializeOptions): void;
+}
+//#endregion
+//#region src/server/FlashHelper.d.ts
+/**
+ * A one-time values store set in a form action and shown on the next page
+ * render, which survives the redirect. Available as `event.flash`; the
+ * framework reads it into `$page.flash` when a page is rendered, so
+ * components display it reactively:
+ *
+ * ```ts
+ * actions: {
+ * 	save: async (event) => {
+ * 		// ...save...
+ * 		event.flash.set("Project saved"); // { message: "Project saved" }
+ * 		event.flash.set({ error: "Import failed", retryable: true });
+ * 		return seeOther(`/projects/${id}`);
+ * 	},
+ * }
+ * ```
+ *
+ * ```torp
+ * @if ($page.flash?.message) {
+ * 	<p class="flash">{$page.flash.message}</p>
+ * }
+ * ```
+ *
+ * The values ride in a (session-lifetime) cookie that is deleted when it is
+ * read, so a page refresh shows them once. No signing: the only person who
+ * can fake a flash is the one seeing it, and values are rendered as text.
+ * They must be JSON-safe and small enough to fit in the cookie (~4KB). A
+ * common shape for a styled banner is `{ type, message }`, for use e.g.
+ * with the Notification component -- but the framework only requires the
+ * values to be an object. Without cookies the message is simply lost --
+ * the action itself still completes.
+ */
+declare class FlashHelper {
+  #private;
+  constructor(cookies: CookieHelper);
+  /**
+   * Reads the flash values, if any, and clears them: the same response
+   * deletes the cookie, so the message shows exactly once. (When the
+   * message was set during this same request, e.g. a form action that
+   * re-renders instead of redirecting, the cookie is consumed without it
+   * ever reaching the browser.)
+   */
+  get(): Record<string, unknown> | undefined;
+  /**
+   * Sets the flash values. A string is stored as `{ message: value }`, an
+   * object as-is, e.g. `flash.set({ error: "Import failed" })`.
+   */
+  set(value: string | Record<string, unknown>): void;
+  /**
+   * Clears an unread flash message, e.g. so it isn't shown on a later
+   * re-render of the same page.
+   */
+  clear(): void;
+}
+//#endregion
+//#region src/server/HeaderHelper.d.ts
+declare class HeaderHelper {
+  request: Request;
+  headers: Map<string, string>;
+  constructor(request: Request);
+  get(name: string): string | undefined;
+  set(name: string, value: string): void;
+  delete(name: string): void;
+}
+//#endregion
+//#region src/server/SessionHelper.d.ts
+/**
+ * The data stored in the session. Must be JSON-safe, and small enough to
+ * fit in a cookie (4KB) along with the id, expiry and signature.
+ */
+type SessionData = Record<string, unknown>;
+/**
+ * A helper for reading and writing the signed session cookie, available as
+ * `event.session` in load functions, actions, +server endpoints and hooks.
+ *
+ * The value is signed with HMAC-SHA256 using `TORPOR_SESSION_SECRET` from
+ * the environment, so it can't be forged or tampered with -- but it is
+ * still client-side storage: everything rides in the cookie, it can't be
+ * revoked individually, and it is limited to ~4KB. When you need
+ * revocation, store `session.id` in your database, check it on each
+ * authed request (e.g. in a `_hook.server.ts`), and delete the row to
+ * revoke.
+ *
+ * ```ts
+ * // Login action
+ * const user = await checkPassword(event.form());
+ * await event.session.regenerate({ userId: user.id });
+ *
+ * // Root hook
+ * const session = await event.session.get();
+ * if (session) {
+ * 	event.appData.user = await getUser(session.userId);
+ * }
+ * ```
+ */
+declare class SessionHelper {
+  #private;
+  constructor(cookies: CookieHelper);
+  /**
+   * The id embedded in the current session cookie, or undefined when
+   * there is no valid session. Stable across `set` calls, so it can be
+   * used as a database key; `regenerate` mints a new one.
+   */
+  get id(): string | undefined;
+  /**
+   * Reads and verifies the session, returning its data, or undefined when
+   * there is no cookie, the signature doesn't match, or the session has
+   * expired.
+   */
+  get(): Promise<SessionData | undefined>;
+  /**
+   * Writes the session, signing the data and setting the cookie. Keeps
+   * the current session id, minting one when there isn't a valid session
+   * yet. Call `regenerate` instead when the session's identity should
+   * change (e.g. at login, to prevent session fixation).
+   */
+  set(data: SessionData, options?: {
+    maxAge?: number;
+  }): Promise<void>;
+  /**
+   * Writes the session with a fresh id, replacing any existing one. Use
+   * it when a session's privilege level changes (login, permission
+   * upgrade), so a cookie that was set before the change can't be reused.
+   */
+  regenerate(data?: SessionData, options?: {
+    maxAge?: number;
+  }): Promise<void>;
+  /**
+   * Deletes the session cookie. Note that a server-side record (if you
+   * keep one) must be deleted or revoked separately.
+   */
+  destroy(): Promise<void>;
+}
+//#endregion
+export { CookieHelper as i, HeaderHelper as n, FlashHelper as r, SessionHelper as t };
+//# sourceMappingURL=SessionHelper-MaodMaLU.d.mts.map

package/dist/SessionHelper-MaodMaLU.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SessionHelper-MaodMaLU.d.mts","names":[],"sources":["../src/server/CookieHelper.ts","../src/server/FlashHelper.ts","../src/server/HeaderHelper.ts","../src/server/SessionHelper.ts"],"mappings":";;cAEqB;EACpB,SAAS;EACT,SAAS;EAET,YAAY,SAAS;EAIrB,IAAI;EAaJ,IAAI,cAAc,eAAe,UAAU;EAU3C,OAAO,cAAc,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cCGX;;EAGpB,YAAY,SAAS;;;;;;;;EAWrB,OAAO;;;;;EAmBP,IAAI,gBAAgB;;;;;EASpB;;;;cC9EoB;EACpB,SAAS;EACT,SAAS;EAET,YAAY,SAAS;EAIrB,IAAI;EASJ,IAAI,cAAc;EAIlB,OAAO;;;;;;;;KCXH,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;cAqCE;;EAIpB,YAAY,SAAS;;;;;;MASjB;;;;;;EASJ,OAAa,QAAQ;;;;;;;EAerB,IAAU,MAAM,aAAa;IAAY;MAAoB;;;;;;EAW7D,WAAiB,OAAM,aAAkB;IAAY;MAAoB;;;;;EAUzE,WAAiB"}

package/dist/{Site-CTADVh7d.d.mts → Site-CWyj0R-l.d.mts}

@@ -1,9 +1,10 @@
-import { t as Server } from "./Server-Cler2w5O.mjs";
-import { a as RouteParamsOf, n as ParseRouteParams, t as ExactRouteParams } from "./ParseRouteParams-DBmqlmLh.mjs";
-import { i as ServerLoadEvent, n as FormDataRecord, r as QueryRecord, t as ServerHook } from "./ServerHook-BlLArueW.mjs";
-import { n as UntypedResponse, t as TypedResponse } from "./TypedResponse-6lznqN4U.mjs";
+import { t as MiddlewareFunction } from "./MiddlewareFunction-BZilnEei.mjs";
+import { t as Server } from "./Server-qn5Ws_d0.mjs";
+import { a as RouteParamsOf } from "./ParseRouteParams-DBmqlmLh.mjs";
+import { n as QueryRecord, r as ServerLoadEvent, t as FormDataRecord } from "./ServerLoadEvent-DzbxxkF8.mjs";
+import { t as ServerHook } from "./ServerHook-BTSGfLiJ.mjs";
+import { a as PageLoadReturn, i as PageEndPoint, t as SitemapOptions } from "./sitemap-BjqN4d4W.mjs";
 import { t as StandardSchemaV1 } from "./StandardSchema-D28L8_zZ.mjs";
-import { Component } from "@torpor/view";
 import { Plugin, UserConfig } from "vite";
 //#region src/types/Adapter.d.ts
 interface Adapter {
@@ -45,74 +46,6 @@ interface Adapter {
  */
 type SitePlugin = (site: Site) => void | Promise<void>;
 //#endregion
-//#region src/types/PageLoadEvent.d.ts
-/**
- * The event passed to client load functions. Annotate with a route path to
- * get typed params, e.g. `PageLoadEvent<"/posts/[id]">`, and with a data type
- * to type the data accumulated from the layouts above, e.g.
- * `PageLoadEvent<"/posts/[id]", PageData<typeof layoutServer>>`.
- */
-interface PageLoadEvent<Route extends string | undefined = undefined, Data = Record<string, any>> {
-  /**
-   * The URL for the server function.
-   */
-  url: URL;
-  /**
-   * Route params from the URL and route path.
-   */
-  params: RouteParamsOf<Route>;
-  /**
-   * Data loaded by the layouts above, accumulated top down. Loads may add to
-   * it, and the merged result is passed into the page as `$props.data`.
-   */
-  data: Data;
-}
-//#endregion
-//#region src/types/PageLoadReturn.d.ts
-/**
- * What a load function may return. When `Data` is provided, a typed response
- * (e.g. `ok({ ... })`) must only contain keys the page expects; untyped
- * responses (redirects, errors, plain text) are always allowed.
- */
-type PageLoadReturn<Data> = TypedResponse<Partial<Data>> | UntypedResponse | undefined | void;
-//#endregion
-//#region src/types/PageEndPoint.d.ts
-/**
- * For +page. Annotate with a route path to get typed params, and with a data
- * shape to flag loads that return keys the page doesn't expect, e.g.
- * `PageEndPoint<"/posts/[id]", PageData<typeof server>>`.
- */
-interface PageEndPoint<Route extends string | undefined = undefined, Data = Record<string, any>> {
-  /**
-   * Builds the route path for the page in a type-safe manner. The params
-   * object is checked for exact keys when `Route` is annotated.
-   *
-   * NOTE: The rest args conditional must stay INLINE — routing it through a
-   * type alias defeats `Params` inference, and excess keys stop being checked
-   */
-  route?: <Params extends RouteParamsOf<Route>>(...args: Route extends string ? string extends Route ? [params?: Record<string, string>] : keyof ParseRouteParams<Route> extends never ? [] : [params: Params & ExactRouteParams<Params, ParseRouteParams<Route>>] : [params?: Record<string, string>]) => string;
-  /**
-   * Loads data for the page.
-   */
-  load?: (event: PageLoadEvent<Route>) => PageLoadReturn<Data> | Promise<PageLoadReturn<Data>>;
-  /**
-   * The component that is displayed for the page.
-   */
-  component?: Component;
-  /**
-   * The head element data for the page, which may include a <title> and <meta> elements.
-   */
-  head?: HeadElement[] | ((event: PageLoadEvent<Route>) => HeadElement[]);
-}
-type HeadElement = TitleElement | MetaElement;
-interface TitleElement {
-  title: string;
-}
-interface MetaElement {
-  name: string;
-  content: string;
-}
-//#endregion
 //#region src/types/PageServerAction.d.ts
 type PageServerAction<Route extends string | undefined = undefined, FormBody = FormDataRecord, Params = RouteParamsOf<Route>> = (event: ServerLoadEvent<Route, unknown, FormBody, QueryRecord, Params>) => Response | undefined | void | Promise<Response | undefined | void>;
 //#endregion
@@ -198,6 +131,26 @@ interface PageServerEndPoint<Route extends string | undefined = undefined, Data
    * ```
    */
   schema?: Schemas | undefined;
+  /**
+   * Marks the page for prerendering. Set `true` for a static route, or
+   * `params` entries letting `tb build` render it once per entry for a
+   * dynamic route, e.g. `prerender: { params: [{ id: "1" }] }` under
+   * `/posts/[id]`. Params are typed by the route annotation (or the
+   * `params` schema), so the entries are checked.
+   *
+   * The load function runs at build time with a synthetic request, exactly
+   * as for a real GET.
+   */
+  prerender?: boolean | {
+    params: LoadParams<Schemas, Route>[];
+  };
+  /**
+   * Route middleware, run for this route's loads and actions after the
+   * global middleware (see `site.middleware`) and before folder hooks.
+   * `enter` may return a Response to short-circuit; `exit` hooks run in
+   * reverse. Middleware see the raw request url.
+   */
+  middleware?: MiddlewareFunction[];
 }
 //#endregion
 //#region src/types/ServerRequest.d.ts
@@ -303,6 +256,13 @@ type ServerEndPoint<Route extends string | undefined = undefined, Schemas extend
    * Performs a HEAD request. Its schema validates the query string.
    */
   head?: ServerRequest<Route, unknown, FormDataRecord, SchemaQuery<Schemas, "head">, ParamsOf<Schemas, Route>>;
+  /**
+   * Route middleware, run for this endpoint's handlers after the global
+   * middleware (see `site.middleware`). `enter` may return a Response to
+   * short-circuit; `exit` hooks run in reverse. Middleware see the raw
+   * request url.
+   */
+  middleware?: MiddlewareFunction[];
 };
 //#endregion
 //#region src/types/RouteType.d.ts
@@ -404,6 +364,60 @@ declare class Site {
    * instances, `Symbol()` ones are not.
    */
   pluginState: Map<PropertyKey, unknown>;
+  /**
+   * The path the site is mounted under, e.g. "/app". Incoming server
+   * requests that don't carry it are not found; everything the framework
+   * generates (HTML attributes, redirect locations, paths from `route()`)
+   * gets it added. Server code and markup stay base-free.
+   */
+  basePath: string;
+  /**
+   * Prerendering, applied to every page route that doesn't have (or
+   * inherit) a `prerender` flag of its own. `true` prerenders everything;
+   * a `Record<string, boolean>` maps route paths -- exact (`/about`) or
+   * prefix (`/blog/**` for a path and everything below it) -- to flags,
+   * with the most specific matching key winning. Route endpoint and
+   * layout flags always take precedence over this.
+   */
+  prerender?: boolean | Record<string, boolean>;
+  /**
+   * The site's absolute origin, e.g. "https://example.com". Required for
+   * a build-time sitemap (see `sitemap`), since there is no request to
+   * take the host from.
+   */
+  origin?: string;
+  /**
+   * Global middleware, run for every request before routing -- including
+   * requests that won't match a route (maintenance mode, legacy url
+   * redirects, etc). Each middleware's `enter` runs in order and may
+   * return a Response to short-circuit the request; `exit` hooks run in
+   * reverse after the handler. Middleware see the raw request url.
+   *
+   * Route middleware (scoped to a single route) is set on the route's
+   * server endpoint instead, e.g. `middleware: [...]` in
+   * `+page.server.ts` or `+server.ts`.
+   */
+  middleware: MiddlewareFunction[];
+  /**
+   * Writes a sitemap.xml listing the prerendered pages at build time
+   * (see `prerender`). Pass a custom path (e.g. "/blog/sitemap.xml") or
+   * `true` for "/sitemap.xml"; requires `origin` to be set.
+   *
+   * For a runtime sitemap -- one that reads the database and keeps up with
+   * content that isn't prerendered -- pass a config instead, e.g.
+   * `sitemap = { get: async () => ["/posts/a", "/posts/b"] }`, which serves
+   * the XML live at that path (customizable with `path`).
+   */
+  sitemap?: SitemapOptions | boolean | string;
+  /**
+   * A Standard Schema (zod, valibot, arktype, etc) used to validate (and
+   * parse) the server environment. When set, `env()` from
+   * `@torpor/build/env` checks the environment on first use per request and
+   * throws with the schema's issues -- so a missing or invalid key fails
+   * immediately instead of passing `undefined` along. The schema must
+   * validate synchronously.
+   */
+  env?: StandardSchemaV1<unknown, TorporEnv>;
   /**
    * Inline endpoints keyed by `"path:type"`. Populated by `addRoute` when
    * the user passes an inline endpoint object instead of a file path.
@@ -483,5 +497,5 @@ declare class Site {
   }, subFolder?: string): void;
 }
 //#endregion
-export { PageLoadEvent as _, ServerEndPoint as a, ActionBody as c, PageServerActionSchemas as d, PageServerEndPoint as f, PageLoadReturn as g, PageEndPoint as h, SchemaQuery as i, LoadParams as l, PageServerAction as m, ParamsOf as n, ServerEndPointSchemas as o, PageServerLoad as p, SchemaBody as r, ServerRequest as s, Site as t, LoadQuery as u, SitePlugin as v, Adapter as y };
-//# sourceMappingURL=Site-CTADVh7d.d.mts.map
+export { ServerEndPoint as a, ActionBody as c, PageServerActionSchemas as d, PageServerEndPoint as f, Adapter as g, SitePlugin as h, SchemaQuery as i, LoadParams as l, PageServerAction as m, ParamsOf as n, ServerEndPointSchemas as o, PageServerLoad as p, SchemaBody as r, ServerRequest as s, Site as t, LoadQuery as u };
+//# sourceMappingURL=Site-CWyj0R-l.d.mts.map

package/dist/Site-CWyj0R-l.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Site-CWyj0R-l.d.mts","names":[],"sources":["../src/types/Adapter.ts","../src/types/SitePlugin.ts","../src/types/PageServerAction.ts","../src/types/PageServerLoad.ts","../src/types/PageServerEndPoint.ts","../src/types/ServerRequest.ts","../src/types/ServerEndPoint.ts","../src/types/RouteType.ts","../src/types/Route.ts","../src/site/Site.ts"],"mappings":"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"}

package/dist/{_page-4cQKs_Dn.mjs → _page-CW6SLuT4.mjs}

@@ -5,9 +5,10 @@ const $page = globalThis[PAGE_SYMBOL] ??= $watch({
 	status: 404,
 	url: new URL("http://localhost"),
 	form: void 0,
+	flash: void 0,
 	error: { message: "" }
 }, { shallow: true });
 //#endregion
 export { $page as t };
 
-//# sourceMappingURL=_page-4cQKs_Dn.mjs.map
+//# sourceMappingURL=_page-CW6SLuT4.mjs.map

package/dist/{_page-4cQKs_Dn.mjs.map → _page-CW6SLuT4.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"_page-4cQKs_Dn.mjs","names":[],"sources":["../src/state/$page.ts"],"sourcesContent":["import { $watch } from \"@torpor/view\";\nimport type PageState from \"../types/PageState\";\n\nconst PAGE_SYMBOL: unique symbol = Symbol.for(\"torp.Page\");\n\nconst $page: PageState =\n\t// @ts-ignore\n\t(globalThis[PAGE_SYMBOL] ??=\n\t\t// The server request path uses `state/$serverPage`, which stores the\n\t\t// same state (same `globalThis` slot) without a reactive proxy\n\t\t$watch(\n\t\t\t{\n\t\t\t\tstatus: 404,\n\t\t\t\turl: new URL(\"http://localhost\"),\n\t\t\t\tform: undefined,\n\t\t\t\terror: {\n\t\t\t\t\tmessage: \"\",\n\t\t\t\t},\n\t\t\t},\n\t\t\t{\n\t\t\t\tshallow: true,\n\t\t\t},\n\t\t));\n\nexport default $page;\n"],"mappings":";;AAGA,MAAM,cAA6B,OAAO,IAAI,WAAW;AAEzD,MAAM,QAEJ,WAAW,iBAGX,OACC;CACC,QAAQ;CACR,KAAK,IAAI,IAAI,kBAAkB;CAC/B,MAAM,KAAA;CACN,OAAO,EACN,SAAS,GACV;AACD,GACA,EACC,SAAS,KACV,CACD"}
+{"version":3,"file":"_page-CW6SLuT4.mjs","names":[],"sources":["../src/state/$page.ts"],"sourcesContent":["import { $watch } from \"@torpor/view\";\nimport type PageState from \"../types/PageState\";\n\nconst PAGE_SYMBOL: unique symbol = Symbol.for(\"torp.Page\");\n\nconst $page: PageState =\n\t// @ts-ignore\n\t(globalThis[PAGE_SYMBOL] ??=\n\t\t// The server request path uses `state/$serverPage`, which stores the\n\t\t// same state (same `globalThis` slot) without a reactive proxy\n\t\t$watch(\n\t\t\t{\n\t\t\t\tstatus: 404,\n\t\t\t\turl: new URL(\"http://localhost\"),\n\t\t\t\tform: undefined,\n\t\t\t\tflash: undefined,\n\t\t\t\terror: {\n\t\t\t\t\tmessage: \"\",\n\t\t\t\t},\n\t\t\t},\n\t\t\t{\n\t\t\t\tshallow: true,\n\t\t\t},\n\t\t));\n\nexport default $page;\n"],"mappings":";;AAGA,MAAM,cAA6B,OAAO,IAAI,WAAW;AAEzD,MAAM,QAEJ,WAAW,iBAGX,OACC;CACC,QAAQ;CACR,KAAK,IAAI,IAAI,kBAAkB;CAC/B,MAAM,KAAA;CACN,OAAO,KAAA;CACP,OAAO,EACN,SAAS,GACV;AACD,GACA,EACC,SAAS,KACV,CACD"}

package/dist/basePath-DQnbHc7o.mjs

@@ -0,0 +1,99 @@
+//#region src/site/basePath.ts
+/**
+* The site's base path, e.g. "/app" when the site is mounted under a
+* subpath. Inherited from `site.basePath` through the manifest at startup
+* (see serverEntry and clientEntry); default "" when the site is served
+* from the root.
+*
+* Server code and user markup are written base-free: the server strips the
+* base from incoming URLs before routing (requests that don't carry it get
+* a 404), and adds it back to generated HTML attributes, redirect
+* locations and paths built with `route()`. The client router does the
+* mirror image: strips for matching, adds for data fetches.
+*/
+let basePath = "";
+/**
+* Validates and sets the site's base path: must be "", start with "/" and
+* not end with "/" (a trailing slash is stripped, "/" is normalized to "")
+*/
+function setBasePath(value) {
+	basePath = normalizeBasePath(value);
+}
+function getBasePath() {
+	return basePath;
+}
+/**
+* Normalizes a base path value, throwing a descriptive error when it
+* can't be one. Trailing slashes are stripped and "/" is normalized to "".
+*/
+function normalizeBasePath(value) {
+	const trimmed = (value ?? "").trim();
+	if (trimmed === "" || trimmed === "/") return "";
+	if (!trimmed.startsWith("/") || /\s/.test(trimmed)) throw new Error(`The base path must be an absolute path without spaces (e.g. "/app"), got "${value}"`);
+	return trimmed.replace(/\/+$/, "");
+}
+/**
+* Normalizes a site origin value, throwing a descriptive error when it
+* isn't an absolute http(s) origin without a path or spaces.
+*/
+function normalizeOrigin(value) {
+	const trimmed = (value ?? "").trim();
+	if (trimmed === "") throw new Error(`The site origin is empty (e.g. "https://example.com")`);
+	let url;
+	try {
+		url = new URL(trimmed);
+	} catch {
+		throw new Error(`The site origin must be an absolute url (e.g. "https://example.com"), got "${value}"`);
+	}
+	if (url.protocol !== "https:" && url.protocol !== "http:" || url.pathname !== "/" || /\s/.test(trimmed)) throw new Error(`The site origin must be an http(s) url without spaces or a path (e.g. "https://example.com"), got "${value}"`);
+	return url.origin;
+}
+/**
+* Strips the base from a URL's pathname, copying the URL so it can be used
+* for routing without disturbing the request. Returns undefined when there
+* is a base and the URL doesn't carry it -- the caller should then return
+* a not-found response, since the site only serves requests under its
+* mount point.
+*/
+function stripBaseFromUrl(url, base) {
+	const stripped = new URL(url);
+	if (!base) return stripped;
+	if (stripped.pathname === base) {
+		stripped.pathname = "/";
+		return stripped;
+	}
+	if (stripped.pathname.startsWith(base + "/")) {
+		stripped.pathname = stripped.pathname.slice(base.length) || "/";
+		return stripped;
+	}
+}
+/**
+* Adds the base to an absolute path, idempotent for paths that already
+* carry it. Relative paths ("other/page"), protocol-relative ("//...") and
+* full URLs are left alone.
+*/
+function addBaseToPath(path, base) {
+	if (!base || !path.startsWith("/") || path.startsWith("//")) return path;
+	if (path === "/") return base + "/";
+	if (path === base || path.startsWith(base + "/")) return path;
+	return base + path;
+}
+/**
+* Rewrites absolute-path `href`, `action` and `src` attribute values in
+* rendered HTML, so that markup can be written base-free. Values that
+* aren't absolute paths (relative, "//...", "http://...", "mailto:...")
+* are left alone, as are ones that already carry the base.
+*/
+function rewriteBaseInHtml(html, base) {
+	if (!base) return html;
+	return html.replace(/\s(href|action|src)\s*=\s*("([^"]*)"|'([^']*)')/g, (match, name, _quoted, double, single) => {
+		const value = double ?? single ?? "";
+		const rewritten = addBaseToPath(value, base);
+		if (rewritten === value) return match;
+		return ` ${name}="${rewritten}"`;
+	});
+}
+//#endregion
+export { rewriteBaseInHtml as a, normalizeOrigin as i, getBasePath as n, setBasePath as o, normalizeBasePath as r, stripBaseFromUrl as s, addBaseToPath as t };
+
+//# sourceMappingURL=basePath-DQnbHc7o.mjs.map

package/dist/basePath-DQnbHc7o.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"basePath-DQnbHc7o.mjs","names":[],"sources":["../src/site/basePath.ts"],"sourcesContent":["/**\n * The site's base path, e.g. \"/app\" when the site is mounted under a\n * subpath. Inherited from `site.basePath` through the manifest at startup\n * (see serverEntry and clientEntry); default \"\" when the site is served\n * from the root.\n *\n * Server code and user markup are written base-free: the server strips the\n * base from incoming URLs before routing (requests that don't carry it get\n * a 404), and adds it back to generated HTML attributes, redirect\n * locations and paths built with `route()`. The client router does the\n * mirror image: strips for matching, adds for data fetches.\n */\nlet basePath = \"\";\n\n/**\n * Validates and sets the site's base path: must be \"\", start with \"/\" and\n * not end with \"/\" (a trailing slash is stripped, \"/\" is normalized to \"\")\n */\nexport function setBasePath(value: string | undefined): void {\n\tbasePath = normalizeBasePath(value);\n}\n\nexport function getBasePath(): string {\n\treturn basePath;\n}\n\n/**\n * Normalizes a base path value, throwing a descriptive error when it\n * can't be one. Trailing slashes are stripped and \"/\" is normalized to \"\".\n */\nexport function normalizeBasePath(value: string | undefined): string {\n\tconst trimmed = (value ?? \"\").trim();\n\tif (trimmed === \"\" || trimmed === \"/\") return \"\";\n\tif (!trimmed.startsWith(\"/\") || /\\s/.test(trimmed)) {\n\t\tthrow new Error(\n\t\t\t`The base path must be an absolute path without spaces (e.g. \"/app\"), ` + `got \"${value}\"`,\n\t\t);\n\t}\n\treturn trimmed.replace(/\\/+$/, \"\");\n}\n\n/**\n * Normalizes a site origin value, throwing a descriptive error when it\n * isn't an absolute http(s) origin without a path or spaces.\n */\nexport function normalizeOrigin(value: string | undefined): string {\n\tconst trimmed = (value ?? \"\").trim();\n\tif (trimmed === \"\") {\n\t\tthrow new Error(`The site origin is empty (e.g. \"https://example.com\")`);\n\t}\n\tlet url: URL;\n\ttry {\n\t\turl = new URL(trimmed);\n\t} catch {\n\t\tthrow new Error(\n\t\t\t`The site origin must be an absolute url (e.g. \"https://example.com\"), got \"${value}\"`,\n\t\t);\n\t}\n\tif (\n\t\t(url.protocol !== \"https:\" && url.protocol !== \"http:\") ||\n\t\turl.pathname !== \"/\" ||\n\t\t/\\s/.test(trimmed)\n\t) {\n\t\tthrow new Error(\n\t\t\t`The site origin must be an http(s) url without spaces or a path ` +\n\t\t\t\t`(e.g. \"https://example.com\"), got \"${value}\"`,\n\t\t);\n\t}\n\t// A trailing slash is allowed\n\treturn url.origin;\n}\n\n/**\n * Strips the base from a URL's pathname, copying the URL so it can be used\n * for routing without disturbing the request. Returns undefined when there\n * is a base and the URL doesn't carry it -- the caller should then return\n * a not-found response, since the site only serves requests under its\n * mount point.\n */\nexport function stripBaseFromUrl(url: URL, base: string): URL | undefined {\n\tconst stripped = new URL(url);\n\tif (!base) return stripped;\n\tif (stripped.pathname === base) {\n\t\tstripped.pathname = \"/\";\n\t\treturn stripped;\n\t}\n\tif (stripped.pathname.startsWith(base + \"/\")) {\n\t\tstripped.pathname = stripped.pathname.slice(base.length) || \"/\";\n\t\treturn stripped;\n\t}\n\treturn undefined;\n}\n\n/**\n * Adds the base to an absolute path, idempotent for paths that already\n * carry it. Relative paths (\"other/page\"), protocol-relative (\"//...\") and\n * full URLs are left alone.\n */\nexport function addBaseToPath(path: string, base: string): string {\n\tif (!base || !path.startsWith(\"/\") || path.startsWith(\"//\")) return path;\n\tif (path === \"/\") return base + \"/\";\n\tif (path === base || path.startsWith(base + \"/\")) return path;\n\treturn base + path;\n}\n\n/**\n * Rewrites absolute-path `href`, `action` and `src` attribute values in\n * rendered HTML, so that markup can be written base-free. Values that\n * aren't absolute paths (relative, \"//...\", \"http://...\", \"mailto:...\")\n * are left alone, as are ones that already carry the base.\n */\nexport function rewriteBaseInHtml(html: string, base: string): string {\n\tif (!base) return html;\n\treturn html.replace(\n\t\t/\\s(href|action|src)\\s*=\\s*(\"([^\"]*)\"|'([^']*)')/g,\n\t\t(match, name: string, _quoted: string, double: string, single: string) => {\n\t\t\tconst value = double ?? single ?? \"\";\n\t\t\tconst rewritten = addBaseToPath(value, base);\n\t\t\tif (rewritten === value) return match;\n\t\t\treturn ` ${name}=\"${rewritten}\"`;\n\t\t},\n\t);\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,IAAI,WAAW;;;;;AAMf,SAAgB,YAAY,OAAiC;CAC5D,WAAW,kBAAkB,KAAK;AACnC;AAEA,SAAgB,cAAsB;CACrC,OAAO;AACR;;;;;AAMA,SAAgB,kBAAkB,OAAmC;CACpE,MAAM,WAAW,SAAS,GAAA,CAAI,KAAK;CACnC,IAAI,YAAY,MAAM,YAAY,KAAK,OAAO;CAC9C,IAAI,CAAC,QAAQ,WAAW,GAAG,KAAK,KAAK,KAAK,OAAO,GAChD,MAAM,IAAI,MACT,6EAAkF,MAAM,EACzF;CAED,OAAO,QAAQ,QAAQ,QAAQ,EAAE;AAClC;;;;;AAMA,SAAgB,gBAAgB,OAAmC;CAClE,MAAM,WAAW,SAAS,GAAA,CAAI,KAAK;CACnC,IAAI,YAAY,IACf,MAAM,IAAI,MAAM,uDAAuD;CAExE,IAAI;CACJ,IAAI;EACH,MAAM,IAAI,IAAI,OAAO;CACtB,QAAQ;EACP,MAAM,IAAI,MACT,8EAA8E,MAAM,EACrF;CACD;CACA,IACE,IAAI,aAAa,YAAY,IAAI,aAAa,WAC/C,IAAI,aAAa,OACjB,KAAK,KAAK,OAAO,GAEjB,MAAM,IAAI,MACT,sGACuC,MAAM,EAC9C;CAGD,OAAO,IAAI;AACZ;;;;;;;;AASA,SAAgB,iBAAiB,KAAU,MAA+B;CACzE,MAAM,WAAW,IAAI,IAAI,GAAG;CAC5B,IAAI,CAAC,MAAM,OAAO;CAClB,IAAI,SAAS,aAAa,MAAM;EAC/B,SAAS,WAAW;EACpB,OAAO;CACR;CACA,IAAI,SAAS,SAAS,WAAW,OAAO,GAAG,GAAG;EAC7C,SAAS,WAAW,SAAS,SAAS,MAAM,KAAK,MAAM,KAAK;EAC5D,OAAO;CACR;AAED;;;;;;AAOA,SAAgB,cAAc,MAAc,MAAsB;CACjE,IAAI,CAAC,QAAQ,CAAC,KAAK,WAAW,GAAG,KAAK,KAAK,WAAW,IAAI,GAAG,OAAO;CACpE,IAAI,SAAS,KAAK,OAAO,OAAO;CAChC,IAAI,SAAS,QAAQ,KAAK,WAAW,OAAO,GAAG,GAAG,OAAO;CACzD,OAAO,OAAO;AACf;;;;;;;AAQA,SAAgB,kBAAkB,MAAc,MAAsB;CACrE,IAAI,CAAC,MAAM,OAAO;CAClB,OAAO,KAAK,QACX,qDACC,OAAO,MAAc,SAAiB,QAAgB,WAAmB;EACzE,MAAM,QAAQ,UAAU,UAAU;EAClC,MAAM,YAAY,cAAc,OAAO,IAAI;EAC3C,IAAI,cAAc,OAAO,OAAO;EAChC,OAAO,IAAI,KAAK,IAAI,UAAU;CAC/B,CACD;AACD"}

package/dist/bin/index.js

@@ -1,5 +1,5 @@
 #! /usr/bin/env node
-import { n as loadSite, r as run, t as runOpenApi } from "../runOpenApi-yIzYasNN.mjs";
+import { n as loadSite, r as run, t as runOpenApi } from "../runOpenApi-6iKszj_5.mjs";
 //#region src/bin/index.ts
 const workingDir = process.cwd();
 if (process.argv.includes("--openapi")) {

package/dist/clientEntry.mjs

@@ -1,8 +1,10 @@
 import { t as Router } from "./Router-C4ADUfhv.mjs";
-import { t as $page } from "./_page-4cQKs_Dn.mjs";
-import { a as client, n as navigate, r as loadData } from "./load-C9RpS_4j.mjs";
+import { o as setBasePath } from "./basePath-DQnbHc7o.mjs";
+import { t as $page } from "./_page-CW6SLuT4.mjs";
+import { a as client, n as navigate, r as loadData } from "./load-CydkUApM.mjs";
 import manifest from "@torpor/build/manifest";
 //#region src/site/clientEntry.ts
+setBasePath(manifest.base);
 const router = new Router();
 router.addPages(manifest.routes);
 client.router = router;
@@ -13,8 +15,10 @@ window.addEventListener("click", async (e) => {
 		e.preventDefault();
 		const href = link.href;
 		const url = new URL(href);
-		if (await navigate(url)) window.history.pushState(null, "", url);
-		else window.location.href = href;
+		if (await navigate(url)) {
+			window.history.replaceState({ scroll: window.scrollY }, "", document.location.href);
+			window.history.pushState({ scroll: 0 }, "", url);
+		} else window.location.href = href;
 	}
 });
 window.addEventListener("mouseover", maybePrefetch);
@@ -47,7 +51,14 @@ function ignoreAnchorMouseEvent(link, e) {
 	return e.defaultPrevented || e.altKey || e.ctrlKey || e.metaKey || e.shiftKey || link.target && link.target !== "_self" || link.rel === "external" || link.hasAttribute("download") || link.isContentEditable;
 }
 window.addEventListener("popstate", async () => {
-	await navigateToLocation(document.location);
+	if (!await navigateToLocation(document.location)) {
+		window.location.reload();
+		return;
+	}
+	requestAnimationFrame(() => {
+		const state = window.history.state;
+		window.scrollTo(0, state?.scroll ?? 0);
+	});
 });
 await navigateToLocation(document.location, true);
 async function navigateToLocation(location, firstTime = false) {

package/dist/clientEntry.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"clientEntry.mjs","names":[],"sources":["../src/site/clientEntry.ts"],"sourcesContent":["import manifest from \"@torpor/build/manifest\";\nimport loadData from \"../nav/loadData.ts\";\nimport navigate from \"../nav/navigate.ts\";\nimport $page from \"../state/$page.ts\";\nimport client from \"../state/client\";\nimport type LayoutPath from \"../types/LayoutPath\";\nimport type PageEndPoint from \"../types/PageEndPoint\";\nimport type PageServerEndPoint from \"../types/PageServerEndPoint\";\nimport Router from \"./Router.ts\";\n\n// Build the router from the Site object created by the user\nconst router = new Router();\nrouter.addPages(manifest.routes);\n\n// Put it in client state so that it can be accessed from navigate. We can't\n// just import it to navigate because that gets built by tsdown, without Vite\n// and the manifest\nclient.router = router;\n\n// Intercept clicks on links\nwindow.addEventListener(\"click\", async (e) => {\n\tconst link = getLink(e.target);\n\tif (link) {\n\t\tif (ignoreAnchorMouseEvent(link, e)) {\n\t\t\treturn;\n\t\t}\n\n\t\te.preventDefault();\n\n\t\tconst href = link.href;\n\t\tconst url = new URL(href);\n\n\t\tif (await navigate(url)) {\n\t\t\twindow.history.pushState(null, \"\", url);\n\t\t} else {\n\t\t\twindow.location.href = href;\n\t\t}\n\t}\n});\n\n// Intercept mouseover/focus/touchstart on links for prefetching\n// TODO: settings e.g. <a href=\"\" data-tb-prefetch=\"eager\"/\"visible\"/\"hover\"/\"touch\">\nwindow.addEventListener(\"mouseover\", maybePrefetch);\nwindow.addEventListener(\"touchstart\", maybePrefetch);\n\nasync function maybePrefetch(e: MouseEvent | TouchEvent) {\n\tconst link = getLink(e.target);\n\tif (link) {\n\t\tif (ignoreAnchorMouseEvent(link, e)) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst href = link.href;\n\t\tconst url = new URL(href);\n\n\t\tconst path = url.pathname;\n\t\tconst query = url.searchParams;\n\t\tconst route = router.match(path, query);\n\t\tif (route) {\n\t\t\tconst handler = route.handler;\n\t\t\tconst params = route.params || {};\n\n\t\t\t// There should be a client endpoint\n\t\t\tconst clientEndPoint: PageEndPoint | undefined = (await handler.endPoint()).default;\n\n\t\t\t// There may be a server endpoint\n\t\t\tconst serverEndPoint: PageServerEndPoint | undefined =\n\t\t\t\thandler.serverEndPoint && (await handler.serverEndPoint())?.default;\n\n\t\t\t// Just dummy this up\n\t\t\tlet newStack: LayoutPath[] = [];\n\n\t\t\tawait loadData(handler, params, path, query, newStack, clientEndPoint, serverEndPoint, true);\n\t\t}\n\t}\n}\n\nfunction getLink(target: EventTarget | null): HTMLAnchorElement | undefined {\n\t// The target may be a child element of the link (e.g. an icon inside it),\n\t// so walk up to the nearest actual link. Fragment-only links (href=\"#...\")\n\t// are left to the browser's native jump-to-anchor behavior\n\tif (!(target instanceof Element)) return;\n\tconst link = target.closest(\"a[href]\");\n\tif (link?.getAttribute(\"href\")?.startsWith(\"#\")) return;\n\treturn (link as HTMLAnchorElement) ?? undefined;\n}\n\nfunction ignoreAnchorMouseEvent(link: HTMLAnchorElement, e: MouseEvent | TouchEvent) {\n\t// Ignore the event if it was already handled (e.g. a user handler calling\n\t// preventDefault), a modifier key is pressed, the target is not \"_self\"\n\t// (e.g. \"_blank\"), rel=\"external\", it's a download link, or it's in a\n\t// contenteditable region\n\treturn (\n\t\te.defaultPrevented ||\n\t\te.altKey ||\n\t\te.ctrlKey ||\n\t\te.metaKey ||\n\t\te.shiftKey ||\n\t\t(link.target && link.target !== \"_self\") ||\n\t\tlink.rel === \"external\" ||\n\t\tlink.hasAttribute(\"download\") ||\n\t\tlink.isContentEditable\n\t);\n}\n\n// Listen for changes to the URL that occur when the user navigates using the\n// back or forward buttons\nwindow.addEventListener(\"popstate\", async () => {\n\tawait navigateToLocation(document.location);\n});\n\n// Do the initial navigation and hydration\nawait navigateToLocation(document.location, true);\n\nasync function navigateToLocation(location: Location, firstTime = false) {\n\t// Reset $page on submit and link navigation\n\t// TODO: Should we put data in $page.data??\n\t$page.form = undefined;\n\n\treturn await navigate(new URL(location.toString()), firstTime);\n}\n"],"mappings":";;;;;AAWA,MAAM,SAAS,IAAI,OAAO;AAC1B,OAAO,SAAS,SAAS,MAAM;AAK/B,OAAO,SAAS;AAGhB,OAAO,iBAAiB,SAAS,OAAO,MAAM;CAC7C,MAAM,OAAO,QAAQ,EAAE,MAAM;CAC7B,IAAI,MAAM;EACT,IAAI,uBAAuB,MAAM,CAAC,GACjC;EAGD,EAAE,eAAe;EAEjB,MAAM,OAAO,KAAK;EAClB,MAAM,MAAM,IAAI,IAAI,IAAI;EAExB,IAAI,MAAM,SAAS,GAAG,GACrB,OAAO,QAAQ,UAAU,MAAM,IAAI,GAAG;OAEtC,OAAO,SAAS,OAAO;CAEzB;AACD,CAAC;AAID,OAAO,iBAAiB,aAAa,aAAa;AAClD,OAAO,iBAAiB,cAAc,aAAa;AAEnD,eAAe,cAAc,GAA4B;CACxD,MAAM,OAAO,QAAQ,EAAE,MAAM;CAC7B,IAAI,MAAM;EACT,IAAI,uBAAuB,MAAM,CAAC,GACjC;EAGD,MAAM,OAAO,KAAK;EAClB,MAAM,MAAM,IAAI,IAAI,IAAI;EAExB,MAAM,OAAO,IAAI;EACjB,MAAM,QAAQ,IAAI;EAClB,MAAM,QAAQ,OAAO,MAAM,MAAM,KAAK;EACtC,IAAI,OAAO;GACV,MAAM,UAAU,MAAM;GACtB,MAAM,SAAS,MAAM,UAAU,CAAC;GAGhC,MAAM,kBAA4C,MAAM,QAAQ,SAAS,EAAA,CAAG;GAG5E,MAAM,iBACL,QAAQ,mBAAmB,MAAM,QAAQ,eAAe,EAAA,EAAI;GAK7D,MAAM,SAAS,SAAS,QAAQ,MAAM,OAAO,CAAO,GAAG,gBAAgB,gBAAgB,IAAI;EAC5F;CACD;AACD;AAEA,SAAS,QAAQ,QAA2D;CAI3E,IAAI,EAAE,kBAAkB,UAAU;CAClC,MAAM,OAAO,OAAO,QAAQ,SAAS;CACrC,IAAI,MAAM,aAAa,MAAM,CAAC,EAAE,WAAW,GAAG,GAAG;CACjD,OAAQ,QAA8B,KAAA;AACvC;AAEA,SAAS,uBAAuB,MAAyB,GAA4B;CAKpF,OACC,EAAE,oBACF,EAAE,UACF,EAAE,WACF,EAAE,WACF,EAAE,YACD,KAAK,UAAU,KAAK,WAAW,WAChC,KAAK,QAAQ,cACb,KAAK,aAAa,UAAU,KAC5B,KAAK;AAEP;AAIA,OAAO,iBAAiB,YAAY,YAAY;CAC/C,MAAM,mBAAmB,SAAS,QAAQ;AAC3C,CAAC;AAGD,MAAM,mBAAmB,SAAS,UAAU,IAAI;AAEhD,eAAe,mBAAmB,UAAoB,YAAY,OAAO;CAGxE,MAAM,OAAO,KAAA;CAEb,OAAO,MAAM,SAAS,IAAI,IAAI,SAAS,SAAS,CAAC,GAAG,SAAS;AAC9D"}
+{"version":3,"file":"clientEntry.mjs","names":[],"sources":["../src/site/clientEntry.ts"],"sourcesContent":["import manifest from \"@torpor/build/manifest\";\nimport loadData from \"../nav/loadData.ts\";\nimport navigate from \"../nav/navigate.ts\";\nimport $page from \"../state/$page.ts\";\nimport client from \"../state/client\";\nimport type LayoutPath from \"../types/LayoutPath\";\nimport type PageEndPoint from \"../types/PageEndPoint\";\nimport type PageServerEndPoint from \"../types/PageServerEndPoint\";\nimport Router from \"./Router.ts\";\nimport { setBasePath } from \"./basePath.ts\";\n\nsetBasePath(manifest.base);\n\n// Build the router from the Site object created by the user\nconst router = new Router();\nrouter.addPages(manifest.routes);\n\n// Put it in client state so that it can be accessed from navigate. We can't\n// just import it to navigate because that gets built by tsdown, without Vite\n// and the manifest\nclient.router = router;\n\n// Intercept clicks on links\nwindow.addEventListener(\"click\", async (e) => {\n\tconst link = getLink(e.target);\n\tif (link) {\n\t\tif (ignoreAnchorMouseEvent(link, e)) {\n\t\t\treturn;\n\t\t}\n\n\t\te.preventDefault();\n\n\t\tconst href = link.href;\n\t\tconst url = new URL(href);\n\n\t\tif (await navigate(url)) {\n\t\t\t// Save the scroll position of the outgoing page on the current\n\t\t\t// history entry, so that going (or coming) back can restore it\n\t\t\twindow.history.replaceState({ scroll: window.scrollY }, \"\", document.location.href);\n\t\t\twindow.history.pushState({ scroll: 0 }, \"\", url);\n\t\t} else {\n\t\t\twindow.location.href = href;\n\t\t}\n\t}\n});\n\n// Intercept mouseover/focus/touchstart on links for prefetching\n// TODO: settings e.g. <a href=\"\" data-tb-prefetch=\"eager\"/\"visible\"/\"hover\"/\"touch\">\nwindow.addEventListener(\"mouseover\", maybePrefetch);\nwindow.addEventListener(\"touchstart\", maybePrefetch);\n\nasync function maybePrefetch(e: MouseEvent | TouchEvent) {\n\tconst link = getLink(e.target);\n\tif (link) {\n\t\tif (ignoreAnchorMouseEvent(link, e)) {\n\t\t\treturn;\n\t\t}\n\n\t\tconst href = link.href;\n\t\tconst url = new URL(href);\n\n\t\tconst path = url.pathname;\n\t\tconst query = url.searchParams;\n\t\tconst route = router.match(path, query);\n\t\tif (route) {\n\t\t\tconst handler = route.handler;\n\t\t\tconst params = route.params || {};\n\n\t\t\t// There should be a client endpoint\n\t\t\tconst clientEndPoint: PageEndPoint | undefined = (await handler.endPoint()).default;\n\n\t\t\t// There may be a server endpoint\n\t\t\tconst serverEndPoint: PageServerEndPoint | undefined =\n\t\t\t\thandler.serverEndPoint && (await handler.serverEndPoint())?.default;\n\n\t\t\t// Just dummy this up\n\t\t\tlet newStack: LayoutPath[] = [];\n\n\t\t\tawait loadData(handler, params, path, query, newStack, clientEndPoint, serverEndPoint, true);\n\t\t}\n\t}\n}\n\nfunction getLink(target: EventTarget | null): HTMLAnchorElement | undefined {\n\t// The target may be a child element of the link (e.g. an icon inside it),\n\t// so walk up to the nearest actual link. Fragment-only links (href=\"#...\")\n\t// are left to the browser's native jump-to-anchor behavior\n\tif (!(target instanceof Element)) return;\n\tconst link = target.closest(\"a[href]\");\n\tif (link?.getAttribute(\"href\")?.startsWith(\"#\")) return;\n\treturn (link as HTMLAnchorElement) ?? undefined;\n}\n\nfunction ignoreAnchorMouseEvent(link: HTMLAnchorElement, e: MouseEvent | TouchEvent) {\n\t// Ignore the event if it was already handled (e.g. a user handler calling\n\t// preventDefault), a modifier key is pressed, the target is not \"_self\"\n\t// (e.g. \"_blank\"), rel=\"external\", it's a download link, or it's in a\n\t// contenteditable region\n\treturn (\n\t\te.defaultPrevented ||\n\t\te.altKey ||\n\t\te.ctrlKey ||\n\t\te.metaKey ||\n\t\te.shiftKey ||\n\t\t(link.target && link.target !== \"_self\") ||\n\t\tlink.rel === \"external\" ||\n\t\tlink.hasAttribute(\"download\") ||\n\t\tlink.isContentEditable\n\t);\n}\n\n// Listen for changes to the URL that occur when the user navigates using the\n// back or forward buttons\nwindow.addEventListener(\"popstate\", async () => {\n\tconst navigated = await navigateToLocation(document.location);\n\tif (!navigated) {\n\t\twindow.location.reload();\n\t\treturn;\n\t}\n\t// Restore the scroll position that was saved on the history entry\n\trequestAnimationFrame(() => {\n\t\tconst state = window.history.state as { scroll?: number } | null;\n\t\twindow.scrollTo(0, state?.scroll ?? 0);\n\t});\n});\n\n// Do the initial navigation and hydration\nawait navigateToLocation(document.location, true);\n\nasync function navigateToLocation(location: Location, firstTime = false) {\n\t// Reset $page on submit and link navigation\n\t// TODO: Should we put data in $page.data??\n\t$page.form = undefined;\n\n\treturn await navigate(new URL(location.toString()), firstTime);\n}\n"],"mappings":";;;;;;AAWA,YAAY,SAAS,IAAI;AAGzB,MAAM,SAAS,IAAI,OAAO;AAC1B,OAAO,SAAS,SAAS,MAAM;AAK/B,OAAO,SAAS;AAGhB,OAAO,iBAAiB,SAAS,OAAO,MAAM;CAC7C,MAAM,OAAO,QAAQ,EAAE,MAAM;CAC7B,IAAI,MAAM;EACT,IAAI,uBAAuB,MAAM,CAAC,GACjC;EAGD,EAAE,eAAe;EAEjB,MAAM,OAAO,KAAK;EAClB,MAAM,MAAM,IAAI,IAAI,IAAI;EAExB,IAAI,MAAM,SAAS,GAAG,GAAG;GAGxB,OAAO,QAAQ,aAAa,EAAE,QAAQ,OAAO,QAAQ,GAAG,IAAI,SAAS,SAAS,IAAI;GAClF,OAAO,QAAQ,UAAU,EAAE,QAAQ,EAAE,GAAG,IAAI,GAAG;EAChD,OACC,OAAO,SAAS,OAAO;CAEzB;AACD,CAAC;AAID,OAAO,iBAAiB,aAAa,aAAa;AAClD,OAAO,iBAAiB,cAAc,aAAa;AAEnD,eAAe,cAAc,GAA4B;CACxD,MAAM,OAAO,QAAQ,EAAE,MAAM;CAC7B,IAAI,MAAM;EACT,IAAI,uBAAuB,MAAM,CAAC,GACjC;EAGD,MAAM,OAAO,KAAK;EAClB,MAAM,MAAM,IAAI,IAAI,IAAI;EAExB,MAAM,OAAO,IAAI;EACjB,MAAM,QAAQ,IAAI;EAClB,MAAM,QAAQ,OAAO,MAAM,MAAM,KAAK;EACtC,IAAI,OAAO;GACV,MAAM,UAAU,MAAM;GACtB,MAAM,SAAS,MAAM,UAAU,CAAC;GAGhC,MAAM,kBAA4C,MAAM,QAAQ,SAAS,EAAA,CAAG;GAG5E,MAAM,iBACL,QAAQ,mBAAmB,MAAM,QAAQ,eAAe,EAAA,EAAI;GAK7D,MAAM,SAAS,SAAS,QAAQ,MAAM,OAAO,CAAO,GAAG,gBAAgB,gBAAgB,IAAI;EAC5F;CACD;AACD;AAEA,SAAS,QAAQ,QAA2D;CAI3E,IAAI,EAAE,kBAAkB,UAAU;CAClC,MAAM,OAAO,OAAO,QAAQ,SAAS;CACrC,IAAI,MAAM,aAAa,MAAM,CAAC,EAAE,WAAW,GAAG,GAAG;CACjD,OAAQ,QAA8B,KAAA;AACvC;AAEA,SAAS,uBAAuB,MAAyB,GAA4B;CAKpF,OACC,EAAE,oBACF,EAAE,UACF,EAAE,WACF,EAAE,WACF,EAAE,YACD,KAAK,UAAU,KAAK,WAAW,WAChC,KAAK,QAAQ,cACb,KAAK,aAAa,UAAU,KAC5B,KAAK;AAEP;AAIA,OAAO,iBAAiB,YAAY,YAAY;CAE/C,IAAI,CAAC,MADmB,mBAAmB,SAAS,QAAQ,GAC5C;EACf,OAAO,SAAS,OAAO;EACvB;CACD;CAEA,4BAA4B;EAC3B,MAAM,QAAQ,OAAO,QAAQ;EAC7B,OAAO,SAAS,GAAG,OAAO,UAAU,CAAC;CACtC,CAAC;AACF,CAAC;AAGD,MAAM,mBAAmB,SAAS,UAAU,IAAI;AAEhD,eAAe,mBAAmB,UAAoB,YAAY,OAAO;CAGxE,MAAM,OAAO,KAAA;CAEb,OAAO,MAAM,SAAS,IAAI,IAAI,SAAS,SAAS,CAAC,GAAG,SAAS;AAC9D"}

package/dist/dev.d.mts

@@ -1,3 +1,3 @@
-import { t as Server } from "./Server-Cler2w5O.mjs";
-import { t as load } from "./serverEntry-DVv9YI3I.mjs";
+import { t as Server } from "./Server-qn5Ws_d0.mjs";
+import { t as load } from "./serverEntry-fj0XfTs4.mjs";
 export { Server, load };

package/dist/dev.mjs

@@ -1,3 +1,3 @@
-import { t as Server } from "./Server-Dr6yqVa5.mjs";
-import { t as load } from "./serverEntry-LyB5pl0E.mjs";
+import { t as Server } from "./Server-CSti9cvM.mjs";
+import { t as load } from "./serverEntry-CnCVNNjp.mjs";
 export { Server, load };

package/dist/discovery.d.mts

@@ -0,0 +1,43 @@
+import { n as sitemapResponse, r as HeadElement, t as SitemapOptions } from "./sitemap-BjqN4d4W.mjs";
+//#region src/discovery/seo.d.ts
+/**
+ * The elements to build head markup from: a page title, a description and
+ * (for social media) an image and a canonical URL.
+ */
+type SeoOptions = {
+  title?: string;
+  description?: string;
+  image?: string;
+  url?: string;
+};
+/**
+ * Builds head element data for a page: a title, a description, and Open
+ * Graph / Twitter (property metas) when an image or url is included, e.g.
+ *
+ * ```ts
+ * import { seo } from "@torpor/build/discovery";
+ *
+ * export default {
+ * 	component,
+ * 	head: (event) => seo({
+ * 		title: post.title,
+ * 		description: post.excerpt,
+ * 		image: post.coverImage,
+ * 		url: event.url.href,
+ * 	}),
+ * } satisfies PageEndPoint;
+ * ```
+ *
+ * The values are rendered into the document head at render time (with
+ * `@head` markup from the component around them), overriding any static
+ * `<title>` in the site template. A twitter:card is included only when an
+ * image is set, with `og:title`/`og:description`/`og:url` set from the
+ * other values.
+ *
+ * @param options The values to include
+ * @returns The head element data
+ */
+declare function seo(options: SeoOptions): HeadElement[];
+//#endregion
+export { type SeoOptions, type SitemapOptions, seo, sitemapResponse };
+//# sourceMappingURL=discovery.d.mts.map

package/dist/discovery.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.d.mts","names":[],"sources":["../src/discovery/seo.ts"],"mappings":";;;;;;KAMY;EACX;EACA;EACA;EACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BuB,IAAI,SAAS,aAAa"}