@spacefast/common 0.0.11 → 0.0.13

package/dist/utils/pages.js

@@ -1,7 +1,39 @@
-import { CUSTOM_PAGE_IDS, PAGE_ELEMENTS, PAGE_LAYOUT_FILE, PAGE_SOURCE_MAX_BYTES, SITE_PAGE_IDS, } from "../contracts/pages.js";
+import { SPACEFAST_WORDMARK_PATH } from "../brand-assets.js";
+import { CUSTOM_PAGE_IDS, PAGE_CATALOG, PAGE_ELEMENTS, PAGE_LAYOUT_FILE, PAGE_SOURCE_MAX_BYTES, SITE_PAGE_IDS, } from "../contracts/pages.js";
+import { SPACE_CONFIG_ACCEPTED_FILES } from "../contracts/space-config.js";
+import { derivePageColors, PAGE_COLOR_DEFAULTS } from "./page-colors.js";
+import { PAGE_EMBEDDED_FONT_FACES, PAGE_FONT_FACES } from "./page-fonts.js";
+/**
+ * One URL, one representation. A file's bare path always serves its bytes;
+ * the preview page is reachable only under this query flag. The alternative —
+ * negotiating on `Accept` at the bare path — depends on `Vary`, which the edge
+ * ignores, so whichever client arrived first pinned that representation for
+ * everyone (an `<img>` could poison the human's link for a year).
+ */
+export const PAGE_PREVIEW_QUERY = "spacefast_view";
+/** The preview page for a file whose bytes live at `fileHref`. */
+export function previewPageHref(fileHref) {
+    return `${fileHref}${fileHref.includes("?") ? "&" : "?"}${PAGE_PREVIEW_QUERY}=1`;
+}
 const encoder = new TextEncoder();
 const knownElements = new Set(PAGE_ELEMENTS);
 const customPageIds = new Set(CUSTOM_PAGE_IDS);
+export function isPagePublicPath(path) {
+    const lower = path.toLowerCase();
+    if (lower === "theme.json" ||
+        lower === "_redirects" ||
+        lower === "_headers" ||
+        lower === "_config.json" ||
+        lower === "_routes.json" ||
+        SPACE_CONFIG_ACCEPTED_FILES.some((candidate) => candidate === lower) ||
+        lower.split("/").includes("_pages") ||
+        lower === "_layout.html" ||
+        lower.endsWith("/_layout.html"))
+        return false;
+    return !lower
+        .split("/")
+        .some((segment, index) => segment.startsWith(".") && !(index === 0 && segment === ".well-known"));
+}
 export function escapePageHtml(value) {
     return value
         .replaceAll("&", "&amp;")
@@ -10,38 +42,80 @@ export function escapePageHtml(value) {
         .replaceAll('"', "&quot;")
         .replaceAll("'", "&#039;");
 }
+// Pushed colors are intent; the readability engine (page-colors.ts) derives
+// what the templates actually paint with. A custom background pins a complete
+// scheme for both OS modes — emitting `--sf-bg` alone used to leave dark-mode
+// visitors with the dark foreground on the user's light background.
 function themeStyle(theme) {
-    const declarations = [
-        theme.accent ? `--sf-accent:${theme.accent}` : "",
-        theme.background ? `--sf-bg:${theme.background}` : "",
-        theme.font ? `--sf-font:${theme.font}` : "",
-    ].filter(Boolean);
-    return declarations.length > 0 ? `<style>:root{${declarations.join(";")}}</style>` : "";
+    const root = [];
+    const dark = [];
+    if (theme.accent || theme.background) {
+        const derived = derivePageColors(theme);
+        // `derived.accent` is the parse-validated input (or the default), never
+        // an arbitrary string straight from the theme.
+        if (theme.accent)
+            root.push(`--sf-accent:${derived.accent}`);
+        root.push(`--sf-on-accent:${derived.onAccent}`, `--sf-link:${derived.link}`);
+        if (derived.pinned) {
+            root.push(`--sf-bg:${derived.pinned.bg}`, `--sf-fg:${derived.pinned.fg}`, `--sf-muted:${derived.pinned.muted}`, `--sf-card:${derived.pinned.card}`, `--sf-border:${derived.pinned.border}`, `--sf-error:${derived.pinned.error}`, `color-scheme:${derived.scheme}`);
+        }
+        else if (derived.linkDark) {
+            dark.push(`--sf-link:${derived.linkDark}`);
+        }
+    }
+    if (theme.font)
+        root.push(`--sf-font:${theme.font}`, `--sf-display-font:${theme.font}`);
+    if (root.length === 0)
+        return "";
+    const darkBlock = dark.length > 0 ? `@media(prefers-color-scheme:dark){:root{${dark.join(";")}}}` : "";
+    return `<style>:root{${root.join(";")}}${darkBlock}</style>`;
 }
+const runtimeSlot = (name, fallback) => `<!--sf-runtime:${name}:start-->${fallback}<!--sf-runtime:${name}:end-->`;
 function renderFiles(files) {
     if (files.length === 0)
         return '<p class="sf-empty">Nothing here yet.</p>';
-    return `<ul class="sf-files">${files
-        .map((file) => `<li><a href="${escapePageHtml(file.href)}">${file.directory ? "↳ " : ""}${escapePageHtml(file.name)}</a>${file.size ? `<span>${escapePageHtml(file.size)}</span>` : ""}</li>`)
+    return `<ul class="sf-files" role="list">${files
+        .map((file) => `<li><a href="${escapePageHtml(file.href)}"><span class="sf-file-name">${escapePageHtml(file.name)}${file.directory ? '<span aria-hidden="true">/</span>' : ""}</span></a>${file.size ? `<span class="sf-file-size">${escapePageHtml(file.size)}</span>` : ""}</li>`)
         .join("")}</ul>`;
 }
 function renderFile(file) {
     if (!file)
         return '<p class="sf-empty">File unavailable.</p>';
+    // This page is itself the `?spacefast_view=1` representation, so the embed,
+    // the download and the raw link all point straight at the canonical path.
     const href = escapePageHtml(file.href);
-    const image = file.mime?.startsWith("image/")
-        ? `<img class="sf-preview" src="${href}" alt="${escapePageHtml(file.name)}">`
-        : `<iframe class="sf-preview" src="${href}" title="${escapePageHtml(file.name)}"></iframe>`;
-    return `${image}<dl class="sf-file-meta"><div><dt>Name</dt><dd>${escapePageHtml(file.name)}</dd></div>${file.size ? `<div><dt>Size</dt><dd>${escapePageHtml(file.size)}</dd></div>` : ""}${file.mime ? `<div><dt>Type</dt><dd>${escapePageHtml(file.mime)}</dd></div>` : ""}</dl><a class="sf-button" href="${escapePageHtml(file.downloadHref ?? file.href)}" download>Download</a>`;
+    const name = escapePageHtml(file.name);
+    const media = file.mime?.startsWith("image/")
+        ? `<img class="sf-preview" src="${href}" alt="">`
+        : `<iframe class="sf-preview" src="${href}" title="Preview of ${name}" loading="lazy" sandbox></iframe>`;
+    return `<div class="sf-preview-wrap">${media}</div><dl class="sf-file-meta"><div><dt>Name</dt><dd>${name}</dd></div>${file.size ? `<div><dt>Size</dt><dd>${escapePageHtml(file.size)}</dd></div>` : ""}${file.mime ? `<div><dt>Type</dt><dd>${escapePageHtml(file.mime)}</dd></div>` : ""}</dl><div class="sf-actions"><a class="sf-button" href="${href}" download>Download</a><a class="sf-ghost" href="${href}">View raw</a></div>`;
+}
+function renderSpacefastBranding(hidden) {
+    const wordmark = hidden
+        ? ""
+        : `<span class="sf-powered" tabindex="0"><svg class="sf-wordmark" viewBox="0 0 326 62" role="img" aria-label="Spacefast"><rect class="sf-wordmark-shadow" x="14" y="12" width="306" height="48"></rect><rect class="sf-wordmark-plate" x="10" y="8" width="306" height="48"></rect><path class="sf-wordmark-paper" d="${SPACEFAST_WORDMARK_PATH}"></path></svg><span class="sf-powered-line"><a href="https://spacefast.com">Best way to share what your agent made</a></span></span>`;
+    return `<footer class="sf-colophon"><div class="sf-colophon-row">${wordmark}<a class="sf-help" href="https://spacefast.com/help">Need help?</a></div></footer>`;
 }
 function renderElement(element, context) {
     switch (element) {
         case "sf-content":
             return context.content ?? "";
-        case "sf-password-form":
-            return `${context.passwordError ? `<p class="sf-error" role="alert">${escapePageHtml(context.passwordError)}</p>` : ""}<form class="sf-form" method="post" action="${escapePageHtml(context.passwordAction ?? "")}"><label>Password<input name="_pw" type="password" required autocomplete="current-password"></label><button type="submit">Continue</button></form>`;
-        case "sf-login":
-            return `<a class="sf-button" href="${escapePageHtml(context.loginHref ?? "/__spacefast/access/login")}">Log in</a>`;
+        case "sf-denial-context":
+            return runtimeSlot("denial", '<p class="sf-copy">This page is private.</p>');
+        case "sf-page-path":
+            return context.displayPath
+                ? escapePageHtml(context.displayPath)
+                : runtimeSlot("request-path", "this address");
+        case "sf-page-title":
+            return escapePageHtml(context.displayTitle ?? context.theme?.name ?? "This space");
+        case "sf-page-summary": {
+            const count = context.itemCount ?? context.files?.length ?? 0;
+            const visible = context.visibleItemCount ?? context.files?.length ?? count;
+            const label = `${count} ${count === 1 ? "item" : "items"}`;
+            return escapePageHtml(visible < count ? `${label} · showing first ${visible}` : label);
+        }
+        case "sf-spacefast-branding":
+            return renderSpacefastBranding(context.hideSpacefastBranding);
         case "sf-files":
             return renderFiles(context.files ?? []);
         case "sf-file":
@@ -61,6 +135,7 @@ export function expandPageHtml(source, context) {
         const name = (paired ?? unary)?.toLowerCase();
         return name && knownElements.has(name) ? renderElement(name, context) : _match;
     });
+    output = output.replaceAll("/*sf-default-fonts*/", context.embedPageFonts ? PAGE_EMBEDDED_FONT_FACES : PAGE_FONT_FACES);
     const tokens = themeStyle(context.theme ?? {});
     if (tokens) {
         output = /<\s*\/\s*head\s*>/i.test(output)
@@ -115,9 +190,16 @@ export function validatePageSources(input) {
                 });
             const allowed = element === "sf-logo" ||
                 element === "sf-name" ||
-                (id === "password" && element === "sf-password-form") ||
-                (id === "index" && element === "sf-files") ||
-                (id === "preview" && element === "sf-file");
+                element === "sf-spacefast-branding" ||
+                (id === "404" && element === "sf-page-path") ||
+                (id === "denied" && element === "sf-denial-context") ||
+                (id === "index" &&
+                    (element === "sf-files" ||
+                        element === "sf-page-path" ||
+                        element === "sf-page-title" ||
+                        element === "sf-page-summary")) ||
+                (id === "preview" &&
+                    (element === "sf-file" || element === "sf-page-path" || element === "sf-page-title"));
             if (knownElements.has(element) && !allowed)
                 diagnostics.push({
                     severity: "error",
@@ -126,16 +208,6 @@ export function validatePageSources(input) {
                     path,
                 });
         }
-        if (id === "password" &&
-            !/<\s*sf-password-form\b/i.test(source) &&
-            !/<\s*input\b[^>]*\bname\s*=\s*["']_pw["']/i.test(source)) {
-            diagnostics.push({
-                severity: "error",
-                code: "password_form_missing",
-                message: "The password page needs <sf-password-form> or a form input named _pw.",
-                path,
-            });
-        }
         if (id === "index" && !/<\s*sf-files\b/i.test(source))
             diagnostics.push({
                 severity: "warning",
@@ -143,7 +215,7 @@ export function validatePageSources(input) {
                 message: "The index page does not render <sf-files>.",
                 path,
             });
-        if ((id === "password" || id === "denied") &&
+        if (id === "denied" &&
             /<\s*meta\b[^>]*\bname\s*=\s*["']robots["'][^>]*\bcontent\s*=\s*["'][^"']*\bindex\b/i.test(source))
             diagnostics.push({
                 severity: "warning",
@@ -169,7 +241,11 @@ export function validatePageSources(input) {
                     message: `Unknown Pages element <${element}>.`,
                     path,
                 });
-            else if (element !== "sf-content" && element !== "sf-logo" && element !== "sf-name")
+            else if (element !== "sf-content" &&
+                element !== "sf-logo" &&
+                element !== "sf-name" &&
+                element !== "sf-page-title" &&
+                element !== "sf-spacefast-branding")
                 diagnostics.push({
                     severity: "error",
                     code: "page_element_not_allowed",
@@ -242,26 +318,23 @@ export function defaultPageBody(id) {
     const source = DEFAULT_PAGE_TEMPLATES[id];
     return source.match(/<body[^>]*>([\s\S]*?)<\/body>/i)?.[1] ?? source;
 }
-const sharedCss = `:root{color-scheme:light dark;--sf-accent:#ff603d;--sf-bg:#faf9f7;--sf-fg:#1c1b1a;--sf-muted:#6b6862;--sf-card:#fff;--sf-border:#e5e2dc;--sf-font:Inter,ui-sans-serif,system-ui,sans-serif}*{box-sizing:border-box}body{margin:0;background:var(--sf-bg);color:var(--sf-fg);font:16px/1.55 var(--sf-font);min-height:100vh;display:grid;place-items:center;padding:24px}.sf-shell{width:min(100%,640px)}.sf-card{background:var(--sf-card);border:1px solid var(--sf-border);border-radius:18px;padding:clamp(24px,5vw,48px);box-shadow:0 18px 55px #1c1b1a12}h1{font-size:clamp(2rem,7vw,3.5rem);line-height:1;letter-spacing:-.05em;margin:16px 0}p{color:var(--sf-muted)}a{color:var(--sf-accent)}.sf-brand{display:flex;align-items:center;gap:10px;font-weight:650}.sf-logo{width:28px;height:28px;object-fit:contain}.sf-badge{margin-top:28px;font-size:12px;color:var(--sf-muted)}.sf-badge a{text-decoration:none}.sf-form label{display:grid;gap:8px;font-weight:600}.sf-form input{width:100%;margin-top:6px;padding:12px 14px;border:1px solid var(--sf-border);border-radius:10px;background:transparent;color:inherit;font:inherit}.sf-form button,.sf-button{display:inline-block;border:0;border-radius:10px;background:var(--sf-accent);color:#fff;padding:12px 16px;font:600 14px/1 var(--sf-font);text-decoration:none;margin-top:14px;cursor:pointer}.sf-error{color:#b42318}.sf-files{list-style:none;padding:0;margin:24px 0}.sf-files li{display:flex;border-top:1px solid var(--sf-border)}.sf-files a{padding:12px 0;flex:1;text-decoration:none}.sf-files span{padding:12px 0;color:var(--sf-muted);font-size:13px}.sf-preview{width:100%;min-height:320px;border:1px solid var(--sf-border);border-radius:10px;object-fit:contain;background:#fff}.sf-file-meta div{display:flex;justify-content:space-between;border-bottom:1px solid var(--sf-border);padding:8px 0}.sf-file-meta dt{color:var(--sf-muted)}.sf-file-meta dd{margin:0}@media(prefers-color-scheme:dark){:root{--sf-bg:#16151a;--sf-fg:#e8e6e3;--sf-muted:#a8a49c;--sf-card:#1e1d23;--sf-border:#343239}.sf-card{box-shadow:0 18px 55px #0005}}`;
-function document(title, body, noindex = false) {
-    return `<!doctype html>\n<html lang="en">\n<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">${noindex ? '<meta name="robots" content="noindex">' : ""}<title>${title}</title><style>${sharedCss}</style></head>\n<body><main class="sf-shell"><section class="sf-card">${body}</section></main></body>\n</html>\n`;
+// The built-in palette runs through the same readability engine as pushed
+// themes, so buttons and links remain readable for every accepted accent.
+const defaultPageColors = derivePageColors({});
+const sharedCss = `/*sf-default-fonts*/:root{color-scheme:light dark;--sf-accent:${PAGE_COLOR_DEFAULTS.accent};--sf-bg:${PAGE_COLOR_DEFAULTS.bg};--sf-fg:${PAGE_COLOR_DEFAULTS.fg};--sf-muted:${PAGE_COLOR_DEFAULTS.muted};--sf-card:${PAGE_COLOR_DEFAULTS.card};--sf-border:${PAGE_COLOR_DEFAULTS.border};--sf-link:${defaultPageColors.link};--sf-on-accent:${defaultPageColors.onAccent};--sf-error:#a82d1a;--sf-font:"Haskoy",-apple-system,BlinkMacSystemFont,ui-sans-serif,"Segoe UI",sans-serif;--sf-display-font:"Merriweather",Georgia,serif;--sf-mono:ui-monospace,"SF Mono",Menlo,Consolas,monospace}*{box-sizing:border-box}html{min-width:320px;background:var(--sf-bg);-webkit-font-smoothing:antialiased}body{margin:0;min-height:100vh;background:var(--sf-bg);color:var(--sf-fg);font:14px/1.65 var(--sf-font)}a{color:inherit}.sf-page{min-height:100vh;display:flex;flex-direction:column;padding:clamp(22px,4vw,44px)}.sf-header{display:flex;align-items:center;min-height:32px}.sf-page-center .sf-header{justify-content:center}.sf-brand{display:inline-flex;min-width:0;align-items:center;gap:10px;color:var(--sf-fg);text-decoration:none}.sf-brand-mark{width:7px;height:7px;flex:none;background:var(--sf-accent)}.sf-logo{width:28px;height:28px;flex:none;object-fit:contain}.sf-brand strong{min-width:0;overflow-wrap:anywhere;font-size:13px;font-weight:600}.sf-main{flex:1;width:100%;padding:clamp(34px,9vh,84px) 0}.sf-page-plain .sf-main{max-width:680px}.sf-page-center .sf-main{max-width:620px;margin:auto;display:flex;flex-direction:column;align-items:center;text-align:center}.sf-eyebrow{margin:0 0 14px;color:var(--sf-muted);font:500 11px/1.5 var(--sf-mono);letter-spacing:.12em;text-transform:uppercase;overflow-wrap:anywhere}.sf-page-center .sf-eyebrow{margin-bottom:16px}h1{max-width:20ch;margin:0 0 12px;color:var(--sf-fg);font:430 clamp(1.9rem,5vw,2.8rem)/1.22 var(--sf-display-font);letter-spacing:-.012em;text-wrap:balance}.sf-copy,.sf-sub{max-width:52ch;margin:0;color:var(--sf-muted);text-wrap:pretty}.sf-inline-path{font-family:var(--sf-mono);font-size:.9em;color:var(--sf-fg);overflow-wrap:anywhere}.sf-actions{display:flex;flex-wrap:wrap;align-items:center;gap:14px;margin-top:22px}.sf-page-center .sf-actions{justify-content:center}.sf-button{display:inline-flex;min-height:44px;align-items:center;justify-content:center;border:0;background:var(--sf-accent);color:var(--sf-on-accent);padding:10px 16px;font:600 13px/1.4 var(--sf-font);text-decoration:none;cursor:pointer}.sf-ghost{color:var(--sf-muted);text-underline-offset:3px}.sf-button:hover{filter:brightness(1.06)}a:focus-visible,button:focus-visible{outline:2px solid var(--sf-link);outline-offset:2px}.sf-copy+.sf-copy{margin-top:12px}.sf-files{width:100%;margin:24px 0 0;padding:0;list-style:none}.sf-files li{display:flex;min-width:0;align-items:baseline;gap:18px;border-bottom:1px solid var(--sf-border)}.sf-files a{min-width:0;flex:1;padding:10px 2px;color:var(--sf-fg);font-weight:500;text-decoration:none}.sf-files a:hover{color:var(--sf-link)}.sf-file-name{overflow-wrap:anywhere}.sf-file-size{flex:none;padding:10px 2px;color:var(--sf-muted);font:12px/1.5 var(--sf-mono);white-space:nowrap}.sf-empty{max-width:420px;margin:24px 0 0;border:1px dashed var(--sf-border);padding:18px 20px;color:var(--sf-muted)}.sf-preview-wrap{width:min(100%,560px);aspect-ratio:16/9;margin:10px 0 18px;overflow:hidden;background:#fff;outline:1px solid color-mix(in srgb,var(--sf-fg) 10%,transparent);outline-offset:-1px}.sf-preview{display:block;width:100%;height:100%;border:0;object-fit:contain}.sf-file-meta{width:min(100%,560px);margin:0}.sf-file-meta div{display:flex;min-width:0;justify-content:space-between;gap:20px;border-bottom:1px solid var(--sf-border);padding:9px 2px}.sf-file-meta dt{color:var(--sf-fg);font-weight:600}.sf-file-meta dd{min-width:0;margin:0;color:var(--sf-muted);font-family:var(--sf-mono);overflow-wrap:anywhere;text-align:right}.sf-colophon{display:flex;flex-direction:column;align-items:center;gap:10px;padding:44px 0 26px;margin-top:auto;color:var(--sf-muted)}.sf-page-plain .sf-colophon{align-items:flex-start}.sf-colophon-row{display:flex;align-items:center;gap:20px;flex-wrap:wrap}.sf-powered{display:inline-flex;align-items:center;gap:10px;cursor:pointer;outline:none}.sf-powered-line{display:none;font-size:12px;color:var(--sf-muted)}.sf-powered:hover .sf-powered-line,.sf-powered:focus .sf-powered-line,.sf-powered:focus-within .sf-powered-line{display:inline}.sf-powered-line a{color:var(--sf-link);text-decoration:underline;text-underline-offset:3px}.sf-help{font-size:12px;color:var(--sf-muted);text-decoration:underline;text-underline-offset:3px}.sf-help:hover{color:var(--sf-fg)}.sf-wordmark{display:block;flex:none;width:auto;height:11px}.sf-wordmark-shadow{fill:var(--sf-accent)}.sf-wordmark-plate{fill:#141419}.sf-wordmark-paper{fill:#fbf8f1}@media(max-width:520px){.sf-page{padding:20px}.sf-button{min-height:48px}.sf-file-meta div{flex-direction:column;gap:2px}.sf-file-meta dd{text-align:left}.sf-colophon{padding-top:32px}}@media(prefers-color-scheme:dark){:root{--sf-bg:${PAGE_COLOR_DEFAULTS.darkBg};--sf-fg:${PAGE_COLOR_DEFAULTS.darkFg};--sf-muted:${PAGE_COLOR_DEFAULTS.darkMuted};--sf-card:${PAGE_COLOR_DEFAULTS.darkCard};--sf-border:${PAGE_COLOR_DEFAULTS.darkBorder};--sf-link:${defaultPageColors.linkDark};--sf-error:#ff8a7a}.sf-preview-wrap{outline-color:#ffffff1a}}@media(forced-colors:active){.sf-brand-mark{background:CanvasText}.sf-button{border:1px solid ButtonText}.sf-powered:focus{outline:1px solid CanvasText;outline-offset:3px}}`;
+const pageHeader = '<header class="sf-header"><a class="sf-brand" href="/" aria-label="Homepage"><span class="sf-brand-mark" aria-hidden="true"></span><sf-logo></sf-logo><strong><sf-name></sf-name></strong></a></header>';
+const pageFooter = "<sf-spacefast-branding></sf-spacefast-branding>";
+function document(id, title, body, layout) {
+    const noindex = PAGE_CATALOG[id].noindex ? '<meta name="robots" content="noindex">' : "";
+    return `<!doctype html>\n<html lang="en">\n<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1">${noindex}<title>${title}</title><style>${sharedCss}</style></head>\n<body><div class="sf-page sf-page-${layout}">${pageHeader}<main class="sf-main">${body}</main>${pageFooter}</div></body>\n</html>\n`;
 }
-const badge = '<p class="sf-badge">Hosted with <a href="https://spacefast.com">Spacefast</a></p>';
 export const DEFAULT_PAGE_TEMPLATES = {
-    "404": document("Page not found", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>Lost in space.</h1><p>This page doesn’t exist. Check the address or head back home.</p><a class="sf-button" href="/">Go home</a>' +
-        badge),
-    password: document("Password required", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>This one’s private.</h1><p>Enter the password to keep going.</p><sf-password-form></sf-password-form>' +
-        badge, true),
-    denied: document("Access denied", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>Not for this account.</h1><p>You don’t have access to this page.</p>' +
-        badge, true),
-    login: document("Log in", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>Log in to continue.</h1><p>This space knows its people.</p><sf-login></sf-login>' +
-        badge, true),
-    index: document("Files", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>Files</h1><sf-files></sf-files>' +
-        badge),
-    preview: document("File preview", '<div class="sf-brand"><sf-logo></sf-logo><sf-name></sf-name></div><h1>Preview</h1><sf-file></sf-file>' +
-        badge),
+    "404": document("404", "Page not found", '<p class="sf-eyebrow">404 · Not Found</p><h1>Page not found</h1><p class="sf-copy">There’s nothing at <span class="sf-inline-path"><sf-page-path></sf-page-path></span>.</p><div class="sf-actions"><a class="sf-button" href="/">Go to the homepage</a></div>', "center"),
+    denied: document("denied", "Access denied", "<h1>Access denied</h1><sf-denial-context></sf-denial-context>", "center"),
+    index: document("index", "<sf-page-title></sf-page-title>", '<p class="sf-eyebrow"><sf-page-path></sf-page-path></p><h1><sf-page-title></sf-page-title></h1><p class="sf-sub"><sf-page-summary></sf-page-summary></p><sf-files></sf-files>', "plain"),
+    preview: document("preview", "<sf-page-title></sf-page-title>", '<p class="sf-eyebrow"><sf-page-path></sf-page-path></p><h1><sf-page-title></sf-page-title></h1><sf-file></sf-file>', "plain"),
 };
-export const DEFAULT_LAYOUT_TEMPLATE = `<!doctype html>\n<html lang="en">\n<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title><sf-name></sf-name></title></head>\n<body>\n  <header><a href="/"><sf-logo></sf-logo><sf-name></sf-name></a></header>\n  <main><sf-content></sf-content></main>\n</body>\n</html>\n`;
+export const DEFAULT_LAYOUT_TEMPLATE = `<!doctype html>\n<html lang="en">\n<head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title><sf-page-title></sf-page-title></title><style>${sharedCss}</style></head>\n<body><sf-content></sf-content></body>\n</html>\n`;
 export function defaultPageTemplate(id) {
     return DEFAULT_PAGE_TEMPLATES[id];
 }

package/dist/utils/production-runtime.d.ts

@@ -0,0 +1,18 @@
+type RuntimeEnvironment = Record<string, string | undefined>;
+type RailwayRuntimeEvidence = {
+    kind: "railway";
+    runtimeEnvironment: string | undefined;
+    env: RuntimeEnvironment;
+};
+type BrowserRuntimeEvidence = {
+    kind: "browser";
+    currentUrl: string;
+    productionOrigin: string;
+};
+export type ProductionRuntimeEvidence = RailwayRuntimeEvidence | BrowserRuntimeEvidence;
+/**
+ * Proves that telemetry is executing in a deployed production runtime.
+ * Environment labels alone are configuration, not runtime evidence.
+ */
+export declare function isProductionRuntime(evidence: ProductionRuntimeEvidence): boolean;
+export {};

package/dist/utils/production-runtime.js

@@ -0,0 +1,28 @@
+const RAILWAY_RUNTIME_IDENTITY_KEYS = [
+    "RAILWAY_PROJECT_ID",
+    "RAILWAY_ENVIRONMENT_ID",
+    "RAILWAY_SERVICE_ID",
+    "RAILWAY_DEPLOYMENT_ID",
+];
+function present(value) {
+    return Boolean(value?.trim());
+}
+/**
+ * Proves that telemetry is executing in a deployed production runtime.
+ * Environment labels alone are configuration, not runtime evidence.
+ */
+export function isProductionRuntime(evidence) {
+    if (evidence.kind === "railway") {
+        return (evidence.runtimeEnvironment?.trim().toLowerCase() === "production" &&
+            evidence.env.RAILWAY_ENVIRONMENT_NAME?.trim().toLowerCase() === "production" &&
+            RAILWAY_RUNTIME_IDENTITY_KEYS.every((key) => present(evidence.env[key])));
+    }
+    try {
+        const current = new URL(evidence.currentUrl);
+        const production = new URL(evidence.productionOrigin);
+        return production.protocol === "https:" && current.origin === production.origin;
+    }
+    catch {
+        return false;
+    }
+}

package/dist/utils/publish-policy.d.ts

@@ -46,6 +46,40 @@ export type PublishManifestResult<T extends {
     files: T[];
     warnings: PublishManifestWarning[];
 };
+export type PublishRouteAnalysis = {
+    collisions: Array<{
+        route: string;
+        paths: string[];
+    }>;
+    caseCollisions: Array<{
+        route: string;
+        siblingRoute: string;
+        paths: string[];
+    }>;
+    routeOwnership: PublishRouteOwnership[];
+};
+export type PublishRouteOwnership = {
+    requestedRoute: string;
+    artifactPath: string;
+};
+/**
+ * Canonicalizes a route expanded from an already-canonical manifest path.
+ * Manifest intake has decoded percent escapes exactly once, so this must not
+ * decode again. It applies only the route-identity aliases shared with access.
+ */
+export declare function canonicalizePublishRequestedRoute(route: string): string;
+/**
+ * Expands artifact paths into the request routes they can serve. The runtime
+ * resolves literal files, directory indexes, and clean `.html` aliases; two
+ * different artifacts owning one request route is rejected at publish/finalize
+ * instead of depending on lookup order. `routeOwnership` exposes the same
+ * expansion in canonical access-route form so authorization and diagnostics
+ * never have to infer a route from an artifact path.
+ */
+export declare function analyzePublishRoutes(paths: readonly string[], options?: {
+    index?: string | false;
+    cleanUrls?: boolean;
+}): PublishRouteAnalysis;
 export declare function resolveManifestFileCap(maxFiles?: number | null): number;
 export declare function validatePublishManifest<T extends {
     path: string;
@@ -64,7 +98,3 @@ export declare function filterFreePlanManifest<T extends {
     allowed: T[];
     ignored: string[];
 };
-export declare function filterFreePlanHeaders(content: string): {
-    headers: string | undefined;
-    droppedBasicAuthCount: number;
-};

package/dist/utils/publish-policy.js

@@ -60,6 +60,10 @@ const STATIC_EXECUTION_CONTROL_FILES = new Set([".htaccess", ".user.ini"]);
 // (`/__stattic_probe` today, more `/__stattic/*` routes planned) stays
 // reserved the same way. Mid-segment occurrences are ordinary content.
 const STATIC_RUNTIME_CONTROL_SEGMENT_PREFIXES = ["__spacefast", "__stattic"];
+// Compact platform endpoints live below `/__sf`. Reserve the complete root
+// segment prefix before the first endpoint ships so uploaded content can never
+// shadow a later platform route. Nested `__sf*` directories remain content.
+const STATIC_RUNTIME_ROOT_SEGMENT_PREFIXES = ["__sf"];
 // Both the current and the legacy control-path spellings stay denied: spaces
 // published before the `.stattic` → `.spacefast` rename still serve from the
 // legacy on-disk layout, and user archives may carry either name.
@@ -76,6 +80,24 @@ const STATIC_RUNTIME_CONTROL_PREFIXES = [
 export function normalizePublishPath(relativePath) {
     return relativePath.replace(/\\/g, "/").replace(/^\/+/g, "");
 }
+/**
+ * The one subtree inside the runtime control prefix that a publish may write.
+ *
+ * `sf publish` compiles a version's worker into `__spacefast/functions/bundles/`
+ * so the bundle travels through the ordinary manifest and upload path instead of
+ * needing a parallel one. Keeping it under the control prefix is what makes it
+ * unservable as static content by default — the runtime answers it only behind a
+ * signature.
+ *
+ * Scoped to `bundles/` rather than the whole `__spacefast/functions/` directory
+ * on purpose: the sibling `config.json` holds the key those signatures are
+ * minted with, and a publish that could overwrite it would be a publish that
+ * could mint its own tokens.
+ */
+const PUBLISHABLE_BUILD_ARTIFACT_PREFIX = "__spacefast/functions/bundles/";
+function isPublishableBuildArtifactPath(lowerPath) {
+    return lowerPath.startsWith(PUBLISHABLE_BUILD_ARTIFACT_PREFIX);
+}
 export function publishPathIgnored(relativePath) {
     const path = normalizePublishPath(relativePath);
     // The agent state dirs hold one secret (state.json) plus committable tooling
@@ -101,27 +123,27 @@ export function publishPathIsConvention(relativePath) {
 // Headers", migration diagnostics): Cloudflare Pages `_worker.js`/`_routes.json`
 // and Pages/Netlify function directories publish as inert content with a
 // warning so migrations are never silent.
+function providerRuntimeFeatureForPath(path) {
+    if (path === "_worker.js") {
+        return "Cloudflare Pages _worker.js";
+    }
+    if (path === "_routes.json") {
+        return "Cloudflare Pages _routes.json";
+    }
+    if (path.startsWith("functions/")) {
+        return "Pages Functions (functions/)";
+    }
+    if (path.startsWith("netlify/functions/")) {
+        return "Netlify Functions (netlify/functions/)";
+    }
+    return null;
+}
 export function providerRuntimeFeatureWarnings(paths) {
     const warnings = [];
     const seen = new Set();
-    const featureForPath = (path) => {
-        if (path === "_worker.js") {
-            return "Cloudflare Pages _worker.js";
-        }
-        if (path === "_routes.json") {
-            return "Cloudflare Pages _routes.json";
-        }
-        if (path.startsWith("functions/")) {
-            return "Pages Functions (functions/)";
-        }
-        if (path.startsWith("netlify/functions/")) {
-            return "Netlify Functions (netlify/functions/)";
-        }
-        return null;
-    };
     for (const rawPath of paths) {
         const path = normalizePublishPath(rawPath);
-        const feature = featureForPath(path);
+        const feature = providerRuntimeFeatureForPath(path);
         if (!feature || seen.has(feature)) {
             continue;
         }
@@ -179,11 +201,15 @@ export function staticUploadPathViolation(path, options = {}) {
     if (reservedRuntimeControlFiles?.has(lowerName) && lowerPath === lowerName) {
         return pathViolation("static_runtime_control_path_not_supported", "Static deploys cannot upload runtime control paths.", normalizedPath);
     }
+    const lowerRootSegment = segments[0]?.toLowerCase() ?? "";
+    if (STATIC_RUNTIME_ROOT_SEGMENT_PREFIXES.some((prefix) => lowerRootSegment.startsWith(prefix))) {
+        return pathViolation("static_runtime_control_path_not_supported", "Static deploys cannot upload runtime control paths.", normalizedPath);
+    }
     const controlSegment = segments.find((segment) => {
         const lowerSegment = segment.toLowerCase();
         return STATIC_RUNTIME_CONTROL_SEGMENT_PREFIXES.some((prefix) => lowerSegment.startsWith(prefix));
     });
-    if (controlSegment) {
+    if (controlSegment && !isPublishableBuildArtifactPath(lowerPath)) {
         return pathViolation("static_runtime_control_path_not_supported", "Static deploys cannot upload runtime control paths.", normalizedPath);
     }
     if (STATIC_RUNTIME_CONTROL_PREFIXES.some((prefix) => lowerPath === prefix || lowerPath.startsWith(`${prefix}/`))) {
@@ -203,6 +229,95 @@ export function firstStaticUploadPathViolation(paths, options = {}) {
     }
     return null;
 }
+/**
+ * Canonicalizes a route expanded from an already-canonical manifest path.
+ * Manifest intake has decoded percent escapes exactly once, so this must not
+ * decode again. It applies only the route-identity aliases shared with access.
+ */
+export function canonicalizePublishRequestedRoute(route) {
+    if (!route.startsWith("/")) {
+        throw new TypeError("publish requested routes must be absolute");
+    }
+    const segments = route
+        .split("/")
+        .filter((segment) => segment !== "" && segment !== ".")
+        .map((segment) => segment.normalize("NFC"));
+    if (segments.at(-1) === "index.html")
+        segments.pop();
+    return segments.length === 0 ? "/" : `/${segments.join("/")}`;
+}
+/**
+ * Expands artifact paths into the request routes they can serve. The runtime
+ * resolves literal files, directory indexes, and clean `.html` aliases; two
+ * different artifacts owning one request route is rejected at publish/finalize
+ * instead of depending on lookup order. `routeOwnership` exposes the same
+ * expansion in canonical access-route form so authorization and diagnostics
+ * never have to infer a route from an artifact path.
+ */
+export function analyzePublishRoutes(paths, options = {}) {
+    const index = options.index === undefined ? "index.html" : options.index;
+    const cleanUrls = options.cleanUrls ?? true;
+    const routes = new Map();
+    const add = (route, path) => {
+        const owners = routes.get(route) ?? new Set();
+        owners.add(path);
+        routes.set(route, owners);
+    };
+    for (const path of paths) {
+        add(`/${path}`, path);
+        if (cleanUrls && path.endsWith(".html")) {
+            add(`/${path.slice(0, -".html".length)}`, path);
+        }
+        if (index !== false) {
+            if (path === index) {
+                add("/", path);
+            }
+            else if (path.endsWith(`/${index}`)) {
+                const directory = path.slice(0, -(index.length + 1));
+                add(`/${directory}`, path);
+                add(`/${directory}/`, path);
+            }
+        }
+    }
+    const collisions = [...routes.entries()]
+        .filter(([, owners]) => owners.size > 1)
+        .map(([route, owners]) => ({ route, paths: [...owners].toSorted() }))
+        .toSorted((left, right) => left.route.localeCompare(right.route));
+    const firstByFoldedRoute = new Map();
+    const caseCollisions = [];
+    for (const [route, owners] of routes) {
+        const folded = route.toLowerCase();
+        const pathsForRoute = [...owners].toSorted();
+        const sibling = firstByFoldedRoute.get(folded);
+        if (sibling && sibling.route !== route) {
+            caseCollisions.push({
+                route,
+                siblingRoute: sibling.route,
+                paths: [...new Set([...sibling.paths, ...pathsForRoute])].toSorted(),
+            });
+        }
+        else if (!sibling) {
+            firstByFoldedRoute.set(folded, { route, paths: pathsForRoute });
+        }
+    }
+    const canonicalOwnership = new Map();
+    for (const [route, owners] of routes) {
+        const canonicalRoute = canonicalizePublishRequestedRoute(route);
+        const canonicalOwners = canonicalOwnership.get(canonicalRoute) ?? new Set();
+        for (const owner of owners)
+            canonicalOwners.add(owner);
+        canonicalOwnership.set(canonicalRoute, canonicalOwners);
+    }
+    const routeOwnership = [...canonicalOwnership.entries()]
+        .flatMap(([requestedRoute, owners]) => [...owners].map((artifactPath) => ({ requestedRoute, artifactPath })))
+        .toSorted((left, right) => left.requestedRoute.localeCompare(right.requestedRoute) ||
+        left.artifactPath.localeCompare(right.artifactPath));
+    return {
+        collisions,
+        caseCollisions: caseCollisions.toSorted((left, right) => left.route.localeCompare(right.route)),
+        routeOwnership,
+    };
+}
 export function resolveManifestFileCap(maxFiles) {
     return Math.min(MANIFEST_MAX_FILES_CEILING, maxFiles && maxFiles > 0 ? maxFiles : MANIFEST_MAX_FILES_CEILING);
 }
@@ -374,8 +489,6 @@ export const ANONYMOUS_SERVE_CONTENT_TYPES = [
     "application/rss+xml",
     "application/atom+xml",
 ];
-const LINE_SPLIT_PATTERN = /\r?\n/;
-const BASIC_AUTH_HEADER_PATTERN = /^basic-auth\s*:/i;
 function extensionForPath(filePath) {
     const normalized = normalizePublishPath(filePath).toLowerCase();
     const fileName = normalized.split("/").at(-1) ?? normalized;
@@ -449,45 +562,3 @@ export function filterFreePlanManifest(files, options) {
     }
     return { allowed, ignored };
 }
-// Free-plan `_headers` compile policy (spec "Plans And Limits", amended
-// 2026-06-10): custom response headers stay FREE; the Basic-Auth header
-// MECHANISM is the paid feature. Basic-Auth operations are dropped from free
-// compiles with a `free_headers_basic_auth_disabled` warning; every other
-// header operation passes through untouched.
-export function filterFreePlanHeaders(content) {
-    const output = [];
-    let droppedBasicAuthCount = 0;
-    let pendingMatcher = null;
-    let matcherEmitted = false;
-    const emitOperation = (rawLine) => {
-        if (pendingMatcher !== null && !matcherEmitted) {
-            output.push(pendingMatcher);
-            matcherEmitted = true;
-        }
-        output.push(rawLine);
-    };
-    for (const rawLine of content.split(LINE_SPLIT_PATTERN)) {
-        const trimmed = rawLine.trim();
-        if (!trimmed || trimmed.startsWith("#")) {
-            continue;
-        }
-        if (!rawLine.startsWith(" ") && !rawLine.startsWith("\t")) {
-            pendingMatcher = trimmed;
-            matcherEmitted = false;
-            continue;
-        }
-        if (pendingMatcher === null) {
-            continue;
-        }
-        if (BASIC_AUTH_HEADER_PATTERN.test(trimmed)) {
-            droppedBasicAuthCount += 1;
-        }
-        else {
-            emitOperation(rawLine);
-        }
-    }
-    return {
-        headers: output.length > 0 ? `${output.join("\n")}\n` : undefined,
-        droppedBasicAuthCount,
-    };
-}