smoodly 0.0.47 → 0.0.49

package/dist/admin/handler.d.ts

@@ -7,7 +7,7 @@ import type { PageStore } from "../store.ts";
 import type { Projector } from "../project.ts";
 import { type AdminAuth } from "./auth.ts";
 import { type AdminFiles } from "./files.ts";
-import { type AdminEffects } from "./ops-impl.ts";
+import { type AdminEffects, type DeployDeps } from "./ops-impl.ts";
 import type { AuthConfig } from "./auth-config.ts";
 export type AdminHandlerDeps = {
     config: ResolvedConfig;
@@ -29,6 +29,10 @@ export type AdminHandlerDeps = {
     effects?: AdminEffects;
     /** Where drafts are served, when not at the page's own address (page-data.ts). */
     previewBase?: string;
+    /** Static mode (spec 2026-10-09): the deploy operations' deps and the mode the page data names; absent = live. */
+    deploy?: DeployDeps & {
+        mode: "live" | "static";
+    };
     /** The prebuilt files; default: the ones the package's build wrote. Tests pass their own. */
     files?: AdminFiles;
 };

package/dist/admin/handler.js

@@ -80,6 +80,7 @@ export function createAdminHandler(deps) {
             opUrl: `${base}/${ADMIN_INTERNAL}/op`,
             filesBase: `${base}/${ADMIN_INTERNAL}/${files.hash}`,
             previewBase: d.previewBase ?? "",
+            delivery: d.deploy?.mode ?? "live",
         };
         return html(200, adminPageHtml(data));
     }
@@ -112,7 +113,7 @@ export function createAdminHandler(deps) {
         if (Number(request.headers.get("content-length") ?? 0) > MAX_BODY_BYTES) {
             return json(413, refused("validation", "smoodly: the operation is larger than 4 MB."));
         }
-        const base = { config: d.config, pages: d.pages, entries: d.entries, href: d.href, assets: d.assets, members: d.members, projector: d.projector, effects: d.effects };
+        const base = { config: d.config, pages: d.pages, entries: d.entries, href: d.href, assets: d.assets, members: d.members, projector: d.projector, effects: d.effects, deploy: d.deploy };
         let status = 200;
         // The gate needs the token alone; the call is read once it has admitted the session.
         const result = await gateAdminOp(d.auth, { path: "", args: [], token }, async (_gate, session) => {

package/dist/admin/ops-impl.d.ts

@@ -4,6 +4,7 @@ import type { AssetStore } from "../asset-store.ts";
 import type { MemberStore } from "../member-store.ts";
 import type { PageStore } from "../store.ts";
 import type { AdminOpCall, AdminOps, OpResult } from "./ops.ts";
+import type { PublishedStore } from "../published.ts";
 import type { AdminSession } from "./auth.ts";
 import type { Projector } from "../project.ts";
 export type AdminEffects = {
@@ -32,7 +33,19 @@ export declare function createAdminOps(deps: {
      *  the new document — a draft save excepted (R17). The truth is written before; a projection that throws is
      *  logged, its targets marked stale to heal on read, and the op succeeds. */
     projector: Projector;
+    /** Static mode's Deploy tile (spec 2026-10-09 static mode §5–§7); absent on a live site, where the group answers not_found. */
+    deploy?: DeployDeps;
 }): AdminOps;
+/** What the deploy operations need (spec 2026-10-09 static mode §7): the live site's origin, where the marker is
+ *  read from; the host's hook from SMOODLY_DEPLOY_HOOK (absent = Deploy disabled); the delivery store's reads. */
+export type DeployDeps = {
+    siteUrl: string;
+    hook?: string;
+    store: Pick<PublishedStore, "newestPublishedAt" | "countPublishedAfter" | "deployRequest" | "requestDeploy" | "lastRemovalAt">;
+    /** Test seams. */
+    fetch?: typeof fetch;
+    now?: () => number;
+};
 /** Path-dispatch for the one-endpoint seam. Own-property checks only —
  * "constructor.constructor" and prototype paths must not resolve. */
 export declare function runAdminOp(ops: AdminOps, call: AdminOpCall): Promise<OpResult<unknown>>;

package/dist/admin/ops-impl.js

@@ -17,6 +17,7 @@ import { CUSTOM_NODE_TYPE, customSchema } from "../custom/index.js";
 import { SETTINGS_KEY, CSS_KEY } from "../global.js";
 import { withDefaults } from "../field-defaults.js";
 import { elementSchemas } from "../richtext-walk.js";
+import { deployState, parseMarker, MARKER_PATH } from "../deploy-state.js";
 import { REDIRECT_PATH_MESSAGE, normalizeRedirectPath, redirectPathProblem } from "./redirect-path.js";
 import { SCHEMA_VERSION } from "../schema-version.js";
 import { draftToken, isDraftToken, StaleDraftError } from "../draft-token.js";
@@ -1322,6 +1323,51 @@ export function createAdminOps(deps) {
             enable: () => guard(async () => (await effects?.draft?.enable(), ok(null))),
             disable: () => guard(async () => (await effects?.draft?.disable(), ok(null))),
         },
+        deploy: deployOps(deps.deploy, by, guard),
+    };
+}
+/** The marker is fetched with a throwaway query and no-store, so no cache between answers with the old
+ *  file (§5). A site that does not answer is "unreachable", never a throw; a 404 (a site built before this
+ *  version, or live mode by mistake) is reachable with no marker, so every row counts as waiting. */
+function deployOps(d, by, guard) {
+    const notConfigured = () => err("not_found", "smoodly: this site has no deploy step (live mode).");
+    if (!d)
+        return { status: async () => notConfigured(), trigger: async () => notConfigured() };
+    const get = d.fetch ?? fetch;
+    const now = () => d.now?.() ?? Date.now();
+    const read = async () => {
+        const at = now();
+        let marker = null;
+        let reachable = true;
+        try {
+            // A hanging address is "unreachable" after five seconds, never a held operation.
+            const res = await get(`${d.siteUrl.replace(/\/$/, "")}/${MARKER_PATH}?t=${at}`, { cache: "no-store", signal: AbortSignal.timeout(5000) });
+            marker = res.ok ? parseMarker(await res.text()) : null;
+            reachable = res.ok || res.status === 404;
+        }
+        catch {
+            reachable = false;
+        }
+        const through = marker?.publishedThrough ?? 0;
+        const [press, newer, removedAt] = await Promise.all([d.store.deployRequest(), d.store.countPublishedAfter(through), d.store.lastRemovalAt()]);
+        // An unpublish or a delete after the build is a change too: one the count of newer rows cannot see.
+        const waiting = newer + (removedAt !== null && removedAt > through ? 1 : 0);
+        return { ...deployState({ marker, reachable, press, waiting, now: at }), hook: Boolean(d.hook) };
+    };
+    return {
+        status: () => guard(async () => ok(await read())),
+        trigger: () => guard(async () => {
+            if (!d.hook)
+                return err("blocked", "smoodly: SMOODLY_DEPLOY_HOOK is not set — see the deploying guide.");
+            const current = await read();
+            if (current.state === "building")
+                return err("blocked", "smoodly: a build is already in flight.");
+            const res = await get(d.hook, { method: "POST", signal: AbortSignal.timeout(10000) });
+            if (!res.ok)
+                return err("blocked", `smoodly: the deploy hook answered ${res.status}.`);
+            await d.store.requestDeploy(by ?? null, now());
+            return ok(await read());
+        }),
     };
 }
 /** Path-dispatch for the one-endpoint seam. Own-property checks only —

package/dist/admin/ops.d.ts

@@ -6,6 +6,7 @@ import type { AssetPage, AssetQuery, FinishInput, UploadTicket } from "../asset-
 import type { InviteInput, InviteResult, MemberRecord } from "../member-store.ts";
 import type { MemberRole } from "../permissions.ts";
 import type { FieldError } from "./validate.ts";
+import type { DeployState } from "../deploy-state.ts";
 import type { DraftToken } from "../draft-token.ts";
 import type { PathTarget } from "../paths.ts";
 import type { Finding } from "./drift.ts";
@@ -124,6 +125,10 @@ export type SchemaStatus = {
     database: number | null;
     required: number;
 };
+/** The Deploy tile's state (spec 2026-10-09 static mode §6); `hook` false = SMOODLY_DEPLOY_HOOK is unset, Deploy disabled. */
+export type DeployStatus = DeployState & {
+    hook: boolean;
+};
 /** A redirect row with its target joined (spec 2026-09-26 redirects §6): `currentPath`/`url` null when the target has no live path in the locale. */
 export type RedirectItem = {
     locale: string;
@@ -287,6 +292,12 @@ export type AdminOps = {
         enable(): Promise<OpResult<null>>;
         disable(): Promise<OpResult<null>>;
     };
+    /** Static mode's Deploy tile (spec 2026-10-09 static mode §5–§7); on a live site both answer not_found. */
+    deploy: {
+        status(): Promise<OpResult<DeployStatus>>;
+        /** Calls the host's hook and records the press; refused while a build is in flight or without a hook. */
+        trigger(): Promise<OpResult<DeployStatus>>;
+    };
 };
 /** `token`: the editor's Supabase Auth session token, attached by the
  *  client facade, sent as the Authorization header and verified by the

package/dist/admin/page-data.d.ts

@@ -14,6 +14,8 @@ export type AdminPageData = {
     /** What the editor puts before a page's address to load its draft: "" where the framework serves drafts
      *  at the page's own address (Next), the preview address's base where it does not (Astro). */
     previewBase: string;
+    /** Static mode shows the Deploy tile (spec 2026-10-09 static mode §6); live by default. */
+    delivery: "live" | "static";
 };
 export declare const ADMIN_DATA_ID = "smoodly-admin-data";
 export declare const ADMIN_ROOT_ID = "smoodly-admin-root";

package/dist/admin/shell/AdminApp.js

@@ -25,6 +25,7 @@ import { SetPasswordView } from "./SetPasswordView.js";
 import { useAdminSession } from "./session.js";
 import { IconRail } from "./IconRail.js";
 import { ConfirmHost } from "../ui/ConfirmDialog.js";
+import { notify } from "../ui/confirm.js";
 import { useRoute } from "./router.js";
 import { AdminPathProvider } from "./base.js";
 import { mountMismatch } from "../../admin-path.js";
@@ -36,6 +37,8 @@ import { ElementsProvider } from "../forms/elements-context.js";
 import { TimeZoneProvider } from "../forms/time-zone-context.js";
 import { SchemaNotice } from "./SchemaNotice.js";
 import { schemaBehind } from "../../schema-version.js";
+import { delivery, onPublished } from "../delivery-mode.js";
+import { pollEvery } from "./deploy-tile.js";
 import { createPresence, followTokenRefresh } from "./presence.js";
 import { connectRealtime } from "./presence-realtime.js";
 import { PresenceProvider } from "./presence-context.js";
@@ -80,6 +83,49 @@ export function AdminApp({ registry, op, auth, presenceConfig }) {
             .catch(() => { });
         return () => { live = false; };
     }, [signedIn, ops]);
+    // The Deploy tile (spec 2026-10-09 static mode §6): on a static site, deploy.status every 30 s, every 5 s
+    // while a build is in flight, and at once after any publish; the press records and re-reads.
+    const [deploy, setDeploy] = useState(null);
+    const [deployBusy, setDeployBusy] = useState(false);
+    const [publishes, setPublishes] = useState(0);
+    useEffect(() => onPublished(() => setPublishes((n) => n + 1)), []);
+    useEffect(() => {
+        if (!signedIn || delivery() !== "static")
+            return;
+        let live = true;
+        let timer;
+        const tick = async () => {
+            let state = "live";
+            try {
+                const r = await ops.deploy.status();
+                if (!live)
+                    return;
+                if (r.ok) {
+                    setDeploy(r.data);
+                    state = r.data.state;
+                }
+            }
+            catch { /* the next tick asks again */ }
+            if (live)
+                timer = setTimeout(tick, pollEvery(state));
+        };
+        void tick();
+        return () => { live = false; if (timer)
+            clearTimeout(timer); };
+    }, [signedIn, ops, publishes]);
+    const onDeploy = async () => {
+        setDeployBusy(true);
+        try {
+            const r = await ops.deploy.trigger();
+            if (r.ok)
+                setDeploy(r.data);
+            else
+                await notify({ title: "Deploy", message: r.message });
+        }
+        finally {
+            setDeployBusy(false);
+        }
+    };
     const userId = session.state.status === "signed_in" ? session.state.session.user.id : "";
     // Presence (spec 2026-09-26 concurrency §5; gated 2026-09-26 security pass §1):
     // one channel per signed-in session, the content project's public config as the
@@ -144,5 +190,5 @@ export function AdminApp({ registry, op, auth, presenceConfig }) {
         main = _jsx(MediaScreen, {});
     else
         main = _jsx(ErrorPane, { message: "Not found." });
-    return (_jsx(AdminPathProvider, { value: registry.adminPath, children: _jsx(PresenceProvider, { value: presence, children: _jsx(ElementsProvider, { elements: registry.elements, children: _jsx(TimeZoneProvider, { zone: registry.timeZone, children: _jsxs(AssetsProvider, { ops: ops, media: registry.media, children: [_jsxs("div", { className: "sm-shell", children: [_jsx(IconRail, { registry: registry, active: head, email: email, settings: role !== null, onSignOut: () => session.client.auth.signOut() }), _jsx("main", { className: "sm-main", children: main }, `${head}/${tail ?? ""}`)] }), _jsx(ConfirmHost, {})] }) }) }) }) }));
+    return (_jsx(AdminPathProvider, { value: registry.adminPath, children: _jsx(PresenceProvider, { value: presence, children: _jsx(ElementsProvider, { elements: registry.elements, children: _jsx(TimeZoneProvider, { zone: registry.timeZone, children: _jsxs(AssetsProvider, { ops: ops, media: registry.media, children: [_jsxs("div", { className: "sm-shell", children: [_jsx(IconRail, { registry: registry, active: head, email: email, settings: role !== null, deploy: deploy ? { status: deploy, busy: deployBusy, onDeploy: () => { void onDeploy(); } } : undefined, onSignOut: () => session.client.auth.signOut() }), _jsx("main", { className: "sm-main", children: main }, `${head}/${tail ?? ""}`)] }), _jsx(ConfirmHost, {})] }) }) }) }) }));
 }

package/dist/admin/shell/EntryForm.js

@@ -17,6 +17,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 // renders verbatim — it is product surface.
 import { Eye } from "lucide-react";
 import { useEffect, useMemo, useRef, useState } from "react";
+import { notePublished } from "../delivery-mode.js";
 import { stillFailing, validateFields } from "../validate.js";
 import { elementSchemas } from "../../richtext-walk.js";
 import { FieldWidget } from "../forms/FieldWidget.js";
@@ -287,6 +288,7 @@ export function EntryForm({ ops, registry, collection, id }) {
         setFieldErrors({});
         void reloadIndexes();
         setPublished(true);
+        notePublished();
         setTimeout(() => setPublished(false), 1600);
     };
     const unpublish = async () => {
@@ -303,6 +305,7 @@ export function EntryForm({ ops, registry, collection, id }) {
         if (r.ok) {
             setRecord(r.data);
             void reloadIndexes();
+            notePublished();
         }
         else
             fail(r);

package/dist/admin/shell/GlobalForm.js

@@ -12,6 +12,7 @@ import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-run
 // validates the draft and lists the fields in an amber banner. "Used on
 // N pages" is the refs index's answer.
 import { useEffect, useMemo, useRef, useState } from "react";
+import { notePublished } from "../delivery-mode.js";
 import { stillFailing, validateNode } from "../validate.js";
 import { elementSchemas } from "../../richtext-walk.js";
 import { CSS_KEY, SETTINGS_KEY, STYLES_KEY } from "../../global.js";
@@ -183,6 +184,7 @@ export function GlobalForm({ ops, registry, name }) {
         presence?.announce(target, r.data.locales[locale]?.draftSavedAt ?? null);
         setFieldErrors({});
         setPublished(true);
+        notePublished();
         setTimeout(() => setPublished(false), 1600);
     };
     const unpublish = async () => {
@@ -196,8 +198,10 @@ export function GlobalForm({ ops, registry, name }) {
             r = { ok: false, code: "internal", message: "Couldn't reach the server." };
         }
         setBusy(null);
-        if (r.ok)
+        if (r.ok) {
             setRecord(r.data);
+            notePublished();
+        }
         else
             fail(r);
     };

package/dist/admin/shell/IconRail.d.ts

@@ -1,9 +1,16 @@
+import type { DeployStatus } from "../ops.ts";
 import type { AdminRegistry } from "../serialize.ts";
-export declare function IconRail({ registry, active, email, settings, onSignOut }: {
+export declare function IconRail({ registry, active, email, settings, deploy, onSignOut }: {
     registry: AdminRegistry;
     active: string;
     email?: string;
     /** Whether the Settings tile shows — once the role is known, in the shell (every member has a Settings page). */
     settings?: boolean;
+    /** The Deploy tile (spec 2026-10-09 static mode §6), above the avatar on a static site; absent on a live one. */
+    deploy?: {
+        status: DeployStatus;
+        busy: boolean;
+        onDeploy: () => void;
+    };
     onSignOut: () => void;
 }): import("react").JSX.Element;

package/dist/admin/shell/IconRail.js

@@ -20,7 +20,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 // ↑/↓ move between entries, a pointer down outside closes. A child being
 // active highlights its parent tile and the entry inside the menu.
 import { useEffect, useId, useRef, useState } from "react";
-import { Globe, Image, LibraryBig, PanelTop, Settings } from "lucide-react";
+import { Globe, Image, LibraryBig, PanelTop, RadioTower, Settings } from "lucide-react";
+import { tileCopy } from "./deploy-tile.js";
 import { ThemeToggle } from "../ui/primitives.js";
 import { useAdminHref } from "./base.js";
 import { RouteLink } from "./RouteLink.js";
@@ -33,7 +34,7 @@ const ICON = { size: 18, strokeWidth: 2, "aria-hidden": true };
 function AppIcon() {
     return (_jsxs("svg", { className: "sm-rail__logo", viewBox: "0 0 28 27", fill: "none", xmlns: "http://www.w3.org/2000/svg", role: "img", "aria-label": "Smoodly", children: [_jsx("path", { style: { fill: "var(--logo-outer)" }, d: "M0 16.1859C0 7.6335 7.88106 0 16.5324 0H16.6037C23.429 0 28 4.59428 28 10.8141C28 19.3666 20.2618 27 11.3279 27C4.43425 27 0 22.2645 0 16.1859Z" }), _jsx("path", { style: { fill: "var(--logo-inner)" }, d: "M7 14.7932C7 10.6754 10.6591 7 14.6757 7H14.7089C17.8777 7 20 9.21206 20 12.2068C20 16.3247 16.4072 20 12.2594 20C9.05876 20 7 17.7199 7 14.7932Z" })] }));
 }
-export function IconRail({ registry, active, email, settings = true, onSignOut }) {
+export function IconRail({ registry, active, email, settings = true, deploy, onSignOut }) {
     const adminHref = useAdminHref();
     const root = useRef(null);
     const uid = useId();
@@ -89,5 +90,9 @@ export function IconRail({ registry, active, email, settings = true, onSignOut }
     const collectionsOpen = open === "collections" || (hovered && open === null);
     const name = email?.split("@")[0] ?? "Editor";
     const initials = name.slice(0, 2).toUpperCase();
-    return (_jsxs("nav", { className: "sm-rail", "aria-label": "Primary", ref: root, onKeyDown: onKeyDown, children: [_jsx(AppIcon, {}), _jsxs("ul", { className: "sm-rail__list", children: [link("pages", "Pages", _jsx(PanelTop, { ...ICON }), adminHref("/pages")), collections.length > 0 && (_jsxs("li", { className: "sm-rail__item", onMouseEnter: () => setHovered(true), onMouseLeave: hoverLeave, children: [_jsxs("button", { type: "button", className: "sm-rail__btn", "aria-current": collectionActive ? "page" : undefined, "aria-haspopup": "menu", "aria-expanded": collectionsOpen, "aria-controls": menuId("collections"), onClick: () => toggle("collections"), children: [_jsx("span", { className: "sm-rail__tile", children: _jsx(LibraryBig, { ...ICON }) }), _jsx("span", { className: "sm-rail__label", children: "Collections" })] }), _jsx("ul", { className: "sm-rail__menu sm-rail__menu--collections", role: "menu", id: menuId("collections"), "data-open": collectionsOpen, children: collections.map((c) => (_jsx("li", { role: "none", children: _jsx(RouteLink, { role: "menuitem", className: "sm-rail__menu-item", href: adminHref(`/${c.name}`), "aria-current": c.name === active ? "page" : undefined, onClick: () => { close(); hoverLeave(); }, children: _jsx("span", { children: c.title }) }) }, c.name))) })] })), link("media", "Media", _jsx(Image, { ...ICON }), adminHref("/media")), registry.globals.length > 0 && link("globals", "Site", _jsx(Globe, { ...ICON }), adminHref("/globals")), settings && link("settings", "Settings", _jsx(Settings, { ...ICON }), adminHref("/settings"))] }), _jsxs("div", { className: "sm-rail__item sm-rail__foot", children: [_jsx("button", { type: "button", className: "sm-rail__user", title: name, "aria-haspopup": "menu", "aria-expanded": open === "user", "aria-controls": menuId("user"), onClick: () => toggle("user"), children: initials }), _jsxs("ul", { className: "sm-rail__menu sm-rail__menu--up", role: "menu", id: menuId("user"), "data-open": open === "user", children: [_jsx("li", { className: "sm-rail__menu-title", role: "presentation", children: name }), _jsx("li", { role: "none", children: _jsx(ThemeToggle, {}) }), _jsx("li", { role: "none", children: _jsx("button", { type: "button", role: "menuitem", className: "sm-rail__menu-item", onClick: () => { close(); onSignOut(); }, children: "Sign out" }) })] })] })] }));
+    return (_jsxs("nav", { className: "sm-rail", "aria-label": "Primary", ref: root, onKeyDown: onKeyDown, children: [_jsx(AppIcon, {}), _jsxs("ul", { className: "sm-rail__list", children: [link("pages", "Pages", _jsx(PanelTop, { ...ICON }), adminHref("/pages")), collections.length > 0 && (_jsxs("li", { className: "sm-rail__item", onMouseEnter: () => setHovered(true), onMouseLeave: hoverLeave, children: [_jsxs("button", { type: "button", className: "sm-rail__btn", "aria-current": collectionActive ? "page" : undefined, "aria-haspopup": "menu", "aria-expanded": collectionsOpen, "aria-controls": menuId("collections"), onClick: () => toggle("collections"), children: [_jsx("span", { className: "sm-rail__tile", children: _jsx(LibraryBig, { ...ICON }) }), _jsx("span", { className: "sm-rail__label", children: "Collections" })] }), _jsx("ul", { className: "sm-rail__menu sm-rail__menu--collections", role: "menu", id: menuId("collections"), "data-open": collectionsOpen, children: collections.map((c) => (_jsx("li", { role: "none", children: _jsx(RouteLink, { role: "menuitem", className: "sm-rail__menu-item", href: adminHref(`/${c.name}`), "aria-current": c.name === active ? "page" : undefined, onClick: () => { close(); hoverLeave(); }, children: _jsx("span", { children: c.title }) }) }, c.name))) })] })), link("media", "Media", _jsx(Image, { ...ICON }), adminHref("/media")), registry.globals.length > 0 && link("globals", "Site", _jsx(Globe, { ...ICON }), adminHref("/globals")), settings && link("settings", "Settings", _jsx(Settings, { ...ICON }), adminHref("/settings"))] }), deploy && (() => {
+                const copy = tileCopy(deploy.status, Date.now());
+                const id = menuId("deploy");
+                return (_jsxs("div", { className: "sm-rail__item sm-rail__deploy", "data-state": deploy.status.state, children: [_jsxs("button", { type: "button", className: "sm-rail__btn", "aria-haspopup": "menu", "aria-expanded": open === "deploy", "aria-controls": id, onClick: () => toggle("deploy"), title: copy.detail, children: [_jsxs("span", { className: `sm-rail__tile${copy.lit ? " sm-rail__tile--lit" : ""}${copy.warn ? " sm-rail__tile--warn" : ""}`, children: [_jsx(RadioTower, { ...ICON }), copy.badge && _jsx("span", { className: "sm-rail__badge", "aria-label": `${copy.badge} changes waiting`, children: copy.badge })] }), _jsx("span", { className: "sm-rail__label", children: copy.label })] }), _jsxs("ul", { className: "sm-rail__menu sm-rail__menu--up", role: "menu", id: id, "data-open": open === "deploy", children: [_jsx("li", { className: "sm-rail__menu-detail", role: "presentation", children: copy.detail }), _jsx("li", { role: "none", children: _jsx("button", { type: "button", role: "menuitem", className: "sm-rail__menu-item", disabled: copy.action === null || deploy.busy, title: copy.disabledReason ?? undefined, onClick: () => { close(); deploy.onDeploy(); }, children: copy.action === "retry" ? "Deploy again" : "Deploy now" }) }), copy.disabledReason && _jsx("li", { className: "sm-rail__menu-note", role: "presentation", children: copy.disabledReason })] })] }));
+            })(), _jsxs("div", { className: "sm-rail__item sm-rail__foot", children: [_jsx("button", { type: "button", className: "sm-rail__user", title: name, "aria-haspopup": "menu", "aria-expanded": open === "user", "aria-controls": menuId("user"), onClick: () => toggle("user"), children: initials }), _jsxs("ul", { className: "sm-rail__menu sm-rail__menu--up", role: "menu", id: menuId("user"), "data-open": open === "user", children: [_jsx("li", { className: "sm-rail__menu-title", role: "presentation", children: name }), _jsx("li", { role: "none", children: _jsx(ThemeToggle, {}) }), _jsx("li", { role: "none", children: _jsx("button", { type: "button", role: "menuitem", className: "sm-rail__menu-item", onClick: () => { close(); onSignOut(); }, children: "Sign out" }) })] })] })] }));
 }

package/dist/admin/shell/deploy-tile.d.ts

@@ -0,0 +1,20 @@
+import type { DeployStatus } from "../ops.ts";
+export type TileCopy = {
+    label: string;
+    /** The count of changes waiting, on the tile; null = no badge. */
+    badge: string | null;
+    /** The icon lit: a build in flight. */
+    lit: boolean;
+    /** The icon as a warning: the build has not landed, or the site did not answer. */
+    warn: boolean;
+    /** The flyout's first line. */
+    detail: string;
+    /** What the flyout's button does; null = disabled, with the reason. */
+    action: "deploy" | "retry" | null;
+    disabledReason: string | null;
+};
+export declare function tileCopy(status: DeployStatus, now: number): TileCopy;
+/** How often the shell asks deploy.status: every 5 s while a build is in flight, every 30 s otherwise. */
+export declare const pollEvery: (state: DeployStatus["state"]) => number;
+/** The publish button's word the moment after a publish: on a static site, that it is not live yet (§6). */
+export declare const publishFlashWord: (delivery: "live" | "static") => string;

package/dist/admin/shell/deploy-tile.js

@@ -0,0 +1,35 @@
+const ago = (from, now) => {
+    const s = Math.max(0, Math.round((now - from) / 1000));
+    if (s < 60)
+        return `${s} s ago`;
+    const m = Math.round(s / 60);
+    if (m < 60)
+        return `${m} min ago`;
+    const h = Math.round(m / 60);
+    if (h < 48)
+        return `${h} hour${h === 1 ? "" : "s"} ago`;
+    return `${Math.round(h / 24)} days ago`;
+};
+const NO_HOOK = "SMOODLY_DEPLOY_HOOK is not set. See the deploying guide.";
+export function tileCopy(status, now) {
+    const noHook = status.hook ? null : NO_HOOK;
+    const offer = (action) => ({ action: noHook ? null : action, disabledReason: noHook });
+    const changes = `${status.waiting} change${status.waiting === 1 ? "" : "s"}`;
+    const since = status.builtAt === null ? "never deployed" : `since the last deploy, ${ago(status.builtAt, now)}`;
+    switch (status.state) {
+        case "live":
+            return { label: "Deploy", badge: null, lit: false, warn: false, detail: `The site is live. ${status.builtAt === null ? "Never deployed" : `Last deploy ${ago(status.builtAt, now)}`}.`, ...offer("deploy") };
+        case "waiting":
+            return { label: "Deploy", badge: String(status.waiting), lit: false, warn: false, detail: `${changes}${status.builtAt === null ? ", " : " "}${since}.`, ...offer("deploy") };
+        case "building":
+            return { label: "Deploy", badge: null, lit: true, warn: false, detail: `Building… started ${ago(status.pressedAt ?? now, now)}.`, action: null, disabledReason: "A build is in flight." };
+        case "not-landed":
+            return { label: "Deploy", badge: null, lit: false, warn: true, detail: "The build has not landed. Check your host.", ...offer("retry") };
+        case "unreachable":
+            return { label: "Deploy", badge: status.waiting > 0 ? String(status.waiting) : null, lit: false, warn: true, detail: "The live site did not answer. Check SITE_URL.", ...offer("deploy") };
+    }
+}
+/** How often the shell asks deploy.status: every 5 s while a build is in flight, every 30 s otherwise. */
+export const pollEvery = (state) => (state === "building" ? 5000 : 30000);
+/** The publish button's word the moment after a publish: on a static site, that it is not live yet (§6). */
+export const publishFlashWord = (delivery) => (delivery === "static" ? "Published ✓ · not live until you deploy" : "Published ✓");

package/dist/admin/ui/PublishControl.js

@@ -3,6 +3,8 @@ import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 import { ActionMenu } from "./ActionMenu.js";
 import { Button, StatusBadge } from "./primitives.js";
 import { publishActions, statusLabel } from "./status-label.js";
+import { delivery } from "../delivery-mode.js";
+import { publishFlashWord } from "../shell/deploy-tile.js";
 const BUSY_WORD = {
     publish: "Publishing…", discard: "Discarding…", unpublish: "Unpublishing…",
 };
@@ -19,6 +21,6 @@ export function publishMenu(opts) {
 export function PublishControl({ status, pending = false, busy = null, flash = false, disabled = false, compact = false, onPublish, onDiscard, onUnpublish, onHistory, }) {
     const can = publishActions(status, pending);
     const inert = disabled || busy !== null;
-    const word = busy ? BUSY_WORD[busy] : flash ? "Published ✓" : "Publish";
+    const word = busy ? BUSY_WORD[busy] : flash ? publishFlashWord(delivery()) : "Publish";
     return (_jsxs("span", { style: { display: "inline-flex", alignItems: "center", gap: 8 }, children: [status && _jsx(StatusBadge, { status: statusLabel(status) }), _jsx(Button, { variant: flash && !busy ? "ok" : "primary", size: compact ? "sm" : "md", disabled: inert || !can.publish, onClick: onPublish, children: word }), _jsx(ActionMenu, { label: "More actions", disabled: inert || status === null, small: compact, items: publishMenu({ can, onDiscard, onUnpublish, onHistory }) })] }));
 }

package/dist/admin/ui/theme.js

@@ -226,6 +226,18 @@ body:has(.sm-admin){margin:0}
    the unavailable ones only by being inert (no pointer, no hover). */
 .sm-rail__btn[aria-disabled="true"]{cursor:default}
 .sm-rail__btn[aria-disabled="true"]:hover .sm-rail__tile{background:transparent}
+/* The Deploy tile (spec 2026-10-09 static mode §6): above the avatar; the badge is the count waiting, the
+   lit tile a build in flight, the warning tile a build that has not landed or a site that did not answer. */
+.sm-rail__deploy{margin-top:auto}
+.sm-rail__deploy+.sm-rail__foot{margin-top:0}
+.sm-rail__badge{position:absolute;top:-4px;right:-6px;min-width:16px;height:16px;padding:0 4px;border-radius:var(--radius-round);background:var(--accent);color:#fff;font-size:10px;font-weight:600;line-height:16px;text-align:center}
+.sm-rail__tile--lit{background:var(--accent-soft);color:var(--accent);animation:sm-rail-pulse 1.6s ease-in-out infinite}
+.sm-rail__tile--warn{background:var(--warn-soft);color:var(--warn)}
+@keyframes sm-rail-pulse{0%,100%{opacity:1}50%{opacity:.55}}
+.sm-rail__menu-detail{font-size:var(--text-sm);color:var(--text);padding:6px 8px 4px;white-space:normal}
+.sm-rail__menu-note{font-size:var(--text-xs);color:var(--text-muted);padding:4px 8px 6px;white-space:normal}
+.sm-rail__menu-item:disabled{cursor:default;color:var(--text-muted)}
+.sm-rail__menu-item:disabled:hover{background:none}
 .sm-rail__foot{margin-top:auto;display:flex;flex-direction:column;align-items:center}
 .sm-rail__user{
   width:28px;height:28px;border-radius:var(--radius-round);background:var(--accent-soft);color:var(--accent);

package/dist/astro/deploy-deps.d.ts

@@ -0,0 +1,10 @@
+import type { DeployDeps } from "../admin/ops-impl.ts";
+export declare function deployDepsOf(input: {
+    output: "static" | "server";
+    /** astro.config's `site` (SITE_URL), the live address the marker is read from. */
+    site: string | undefined;
+    env: Record<string, string | undefined>;
+    store: DeployDeps["store"];
+}): (DeployDeps & {
+    mode: "live" | "static";
+}) | undefined;

package/dist/astro/deploy-deps.js

@@ -0,0 +1,8 @@
+export function deployDepsOf(input) {
+    if (input.output !== "static")
+        return undefined;
+    if (!input.site)
+        throw new Error("smoodly: static output needs `site` (SITE_URL) — the Deploy tile reads the build marker from the live address.");
+    const hook = input.env.SMOODLY_DEPLOY_HOOK?.trim() || undefined;
+    return { mode: "static", siteUrl: input.site.replace(/\/$/, ""), hook, store: input.store };
+}

package/dist/astro/index.d.ts

@@ -2,23 +2,28 @@ import type { AstroIntegration } from "astro";
 import type { ResolvedConfig } from "../config.ts";
 import { type SmoodlyContent } from "../content/content-api.ts";
 import { type AstroI18n } from "./locale-paths.ts";
+export type AstroOutput = "static" | "server";
 export type SmoodlyOptions = {
     /** Where the admin is mounted: the same value as `admin.path` in smoodly.config.ts. Default "/admin". */
     adminPath?: string;
     /** The config file, from the project root. Default "smoodly.config.ts". */
     config?: string;
 };
-/** The three routes, most specific first; a page file of the project's own wins over the shell for its address. */
-export declare function routes(adminPath: string): {
+/** The three routes, most specific first; a page file of the project's own wins over the shell for its address.
+ *  The admin and the preview address are always on demand; the page shell is the prerendered one in static
+ *  output (spec 2026-10-09 static mode §3) and the on-demand one in server output. */
+export declare function routes(adminPath: string, output?: AstroOutput): {
     pattern: string;
     entrypoint: string;
+    prerender: boolean;
 }[];
 /** The views by file name, under the project's source dir (root-relative, "/src" by default): a section's
  *  is sections/<section name>.astro, an element's elements/<element name>.astro, a page type's
  *  page-types/<page type name>.astro, an entry page's entry-pages/<collection name>.astro. */
 export declare function viewsModule(srcDir: string): string;
-/** `root` is the project's directory; `srcDir` its source dir relative to the root, with a leading slash. */
-export declare function virtualModules(root: string, configFile: string, srcDir?: string): {
+/** `root` is the project's directory; `srcDir` its source dir relative to the root, with a leading slash;
+ *  `output` astro.config's, which `smoodly:build` tells the preview route and the server. */
+export declare function virtualModules(root: string, configFile: string, srcDir?: string, output?: AstroOutput): {
     name: string;
     resolveId(id: string): string | undefined;
     load(id: string): string | undefined;