@nextwebwg/htmlkit 1.0.0-alpha.40 → 1.0.0-alpha.42

package/dist/client.js

@@ -0,0 +1,322 @@
+const definitions = new Map();
+const controllers = {};
+const styleStates = {};
+const compiledStyles = (_css, definition) => ({ css: "", stateNames: styleStates[definition.contract.tag] ?? [] });
+let started = false;
+/** Each page module calls this once, when it is first imported. */
+export function page(runtime, options, pageDefinitions, pageControllers, pageStyleStates) {
+    // A document keeps one definition and controller per tag (HTML Next's HR001). A page that
+    // redefines a tag fails here, before its DOM is inserted, and loads as a document instead.
+    for (const [tag, controller] of Object.entries(pageControllers)) {
+        if ((controllers[tag] ?? controller) !== controller)
+            throw new Error(`HTMLKit: <${tag}> already has another controller in this document.`);
+    }
+    Object.assign(styleStates, pageStyleStates);
+    runtime.registerComponentDefinitions(pageDefinitions, document, compiledStyles);
+    for (const definition of pageDefinitions)
+        definitions.set(definition.contract.tag, definition);
+    Object.assign(controllers, pageControllers);
+    if (started)
+        return;
+    started = true;
+    const initialized = new WeakSet();
+    runtime.observeDocument(document, { onConnect(element, definition) {
+            const controller = controllers[definition.contract.tag];
+            if (!controller)
+                return;
+            if (typeof controller.default !== "function")
+                throw new Error(`Controller for ${definition.contract.tag} must export a default function`);
+            const host = runtime.getComponentHost(element);
+            if (initialized.has(host))
+                return;
+            initialized.add(host);
+            return controller.default(host);
+        } });
+    // ponytail: links stay document navigations without NavigateEvent.sourceElement (Chrome 135, Firefox 147,
+    // Safari 26.2), which carries the per-link opt-outs; earlier Navigation API versions would skip them.
+    if ("navigation" in window && "sourceElement" in NavigateEvent.prototype)
+        navigate(runtime, options);
+    document.dispatchEvent(new Event("hk:ready"));
+}
+const layer = (root, index) => root.getElementById(`hk-layer-${index}`);
+const fresh = (time) => performance.now() - time < 30_000;
+const loaded = async (url, signal) => {
+    const response = await fetch(url, signal === undefined ? {} : { signal });
+    if (!response.ok || response.redirected)
+        throw new Error(`HTMLKit cannot load ${url} (${response.status}).`);
+    return response;
+};
+/**
+ * Renders a payload's layers as the server does (application.ts and HTML Next's server worker):
+ * the same invocations, lowered without connecting, with each loader's state, then serialized. The
+ * live document adopts the result as it adopts server HTML. Every layer renders, kept layouts
+ * included, so a page reads its layouts' context and kept layouts get their new props.
+ */
+async function render(runtime, payload, url) {
+    if (payload.version !== 1 || payload.layers.length === 0)
+        throw new Error("HTMLKit cannot read this page payload.");
+    const next = document.implementation.createHTMLDocument("");
+    const append = (parent, tag, attributes) => {
+        const element = parent.appendChild(next.createElement(tag));
+        for (const [name, value] of Object.entries(attributes))
+            element.setAttribute(name, value);
+        return element;
+    };
+    append(next.head, "base", { href: url.href });
+    for (const element of payload.head.elements)
+        append(next.head, element.tag, element.attributes);
+    if (payload.head.description !== undefined)
+        append(next.head, "meta", { name: "description", content: payload.head.description });
+    for (const href of payload.styles)
+        append(next.head, "link", { rel: "stylesheet", href });
+    for (const src of payload.modules)
+        append(next.head, "script", { type: "module", src });
+    runtime.registerComponentDefinitions([...definitions.values()], next, compiledStyles);
+    let parent = next.body;
+    payload.layers.forEach((layer, index) => {
+        parent = append(parent, layer.component, { id: `hk-layer-${index}`, ...index === 0 ? {} : { slot: "page" }, ...layer.attributes });
+    });
+    runtime.lowerDocument(next, { connect: false });
+    payload.layers.forEach(({ state }, index) => {
+        if (state === undefined)
+            return;
+        const root = layer(next, index);
+        const host = root === null ? undefined : runtime.getComponentHost(root);
+        if (host === undefined)
+            throw new Error(`HTMLKit cannot give layer ${index} its state.`);
+        Object.assign(host.state, state);
+    });
+    // As the server does: let structural updates settle, then lower what they added.
+    await new Promise(done => setTimeout(done));
+    runtime.lowerDocument(next, { connect: false });
+    next.body.innerHTML = runtime.serializeRenderedForm(next.body);
+    next.title = payload.head.title;
+    next.documentElement.lang = payload.head.lang;
+    return next;
+}
+function navigate(runtime, { base, prefetch: policy, manifest }) {
+    /** The pathname whose layers the document shows. A navigation's URL commits before its layers arrive. */
+    let rendered = location.pathname;
+    /** Head metadata from server documents. Elements that scripts add are never removed. */
+    let owned = [...document.head.querySelectorAll("meta, link")];
+    const announcer = document.createElement("div");
+    announcer.id = "hk-announcer";
+    announcer.setAttribute("aria-live", "polite");
+    announcer.setAttribute("aria-atomic", "true");
+    announcer.style.cssText = "position:absolute;width:1px;height:1px;margin:-1px;overflow:hidden;clip-path:inset(50%);white-space:nowrap";
+    document.body.append(announcer);
+    /**
+     * Same-origin page URLs under base. Page URLs end in a slash; files and other sites load natively.
+     * Firefox 155 follows a download link's navigate event with a second one that has no downloadRequest.
+     */
+    const local = (url, source) => url.origin === location.origin && url.pathname.startsWith(base) &&
+        url.pathname.endsWith("/") && !source?.closest("[data-hk-reload]") && !source?.hasAttribute("download");
+    const payloadURL = (url) => `${base}_htmlkit/pages/${url.pathname.slice(base.length)}payload.json`;
+    // Prefetching never runs anything: payloads are data, and modules and stylesheets are only hinted.
+    const hinted = new Set();
+    const hint = (rel, href) => {
+        if (hinted.has(href) || document.querySelector(`[src="${CSS.escape(href)}"], [href="${CSS.escape(href)}"]`) !== null)
+            return;
+        hinted.add(href);
+        const link = document.createElement("link");
+        link.rel = rel;
+        link.href = href;
+        document.head.append(link);
+    };
+    const prefetched = new Map();
+    const payloadOf = (url, signal) => loaded(payloadURL(url), signal).then(response => response.json());
+    /** The page an HTML link would visit in place, if any. An unparsable href is not a page. */
+    const target = (anchor) => {
+        const url = anchor instanceof HTMLAnchorElement ? URL.parse(anchor.href) : null;
+        return url !== null && local(url, anchor) && ["", "_self"].includes(anchor.target) && url.pathname !== rendered ? url : undefined;
+    };
+    const prefetchPage = (url) => {
+        const cached = prefetched.get(url.pathname);
+        if (cached !== undefined && fresh(cached.time))
+            return;
+        const payload = payloadOf(url);
+        prefetched.set(url.pathname, { time: performance.now(), payload });
+        payload.then(({ modules, styles }) => {
+            for (const src of modules)
+                hint("modulepreload", src);
+            for (const href of styles)
+                hint("prefetch", href);
+        }).catch(() => { prefetched.delete(url.pathname); });
+    };
+    // Links on screen prefetch only the shared chunks their page needs: a page's own module holds its
+    // content, so a long menu would otherwise download every page.
+    let chunks;
+    const prefetchShared = (url) => {
+        if (manifest === undefined)
+            return;
+        chunks ??= loaded(manifest).then(response => response.json())
+            .then((data) => new Map(data.pages.map(page => [page.pathname, page.chunks ?? []])))
+            .catch(() => new Map());
+        void chunks.then(map => { for (const src of map.get(url.pathname) ?? [])
+            hint("modulepreload", src); });
+    };
+    /** A link's policy: its own or an ancestor's data-hk-prefetch, else the site's. */
+    const mode = (anchor) => {
+        const value = anchor.closest("[data-hk-prefetch]")?.getAttribute("data-hk-prefetch");
+        return value === "interaction" || value === "visible" || value === "none" ? value : policy;
+    };
+    // Intent: touch at once; a link that keeps the pointer or focus briefly, so sweeping across a menu
+    // or tabbing through it fetches nothing.
+    let intended;
+    const intent = (event) => {
+        clearTimeout(intended);
+        const anchor = event.target instanceof Element ? event.target.closest("a[href]") : null;
+        const url = anchor !== null && mode(anchor) !== "none" ? target(anchor) : undefined;
+        if (url !== undefined)
+            intended = setTimeout(prefetchPage, event.type === "touchstart" ? 0 : 80, url);
+    };
+    document.addEventListener("pointerover", intent);
+    document.addEventListener("focusin", intent);
+    document.addEventListener("touchstart", intent, { passive: true });
+    // At idle, or within 2 s on a busy page; a timer where requestIdleCallback is missing.
+    const idle = (run) => "requestIdleCallback" in window ? requestIdleCallback(run, { timeout: 2000 }) : setTimeout(run, 1);
+    const visible = new IntersectionObserver(entries => {
+        for (const { isIntersecting, target: anchor } of entries) {
+            if (!isIntersecting)
+                continue;
+            visible.unobserve(anchor);
+            const url = target(anchor);
+            const policy = mode(anchor);
+            if (url !== undefined && policy !== "none")
+                idle(() => (policy === "visible" ? prefetchPage : prefetchShared)(url));
+        }
+    });
+    // ponytail: links that controllers add later are not watched; they still prefetch on interaction.
+    const watch = () => { for (const anchor of document.querySelectorAll("a[href]"))
+        visible.observe(anchor); };
+    watch();
+    const html = async (url, signal) => {
+        const response = await loaded(url.pathname + url.search, signal);
+        if (!response.headers.get("content-type")?.startsWith("text/html"))
+            throw new Error(`HTMLKit cannot render ${url.href} in place.`);
+        return new DOMParser().parseFromString(await response.text(), "text/html");
+    };
+    const payload = async (url, signal) => {
+        const cached = prefetched.get(url.pathname);
+        prefetched.delete(url.pathname);
+        const data = await (cached !== undefined && fresh(cached.time) ? cached.payload : payloadOf(url, signal));
+        // The page's module registers its definitions before anything renders. An absolute URL is the
+        // module's identity everywhere: Vite's development server adds ?import to a path, a second URL.
+        await Promise.all(data.modules.map(src => import(/* @vite-ignore */ new URL(src, location.href).href)));
+        signal.throwIfAborted();
+        return render(runtime, data, url);
+    };
+    const visit = async (url, event) => {
+        const { signal } = event;
+        const sheets = [];
+        let committed = false;
+        clearTimeout(intended);
+        try {
+            // The payload carries data, not markup; a page it cannot render loads from its HTML.
+            const next = await payload(url, signal).catch(error => {
+                if (signal.aborted)
+                    throw error;
+                console.warn("HTMLKit renders this page from its HTML:", error);
+                return html(url, signal);
+            });
+            if (layer(next, 0) === null || layer(document, 0) === null)
+                throw new Error(`HTMLKit cannot render ${url.href} in place: it has no layers.`);
+            // Head metadata both documents share stays; the rest is removed or added at the swap.
+            const kept = new Set();
+            const added = [];
+            for (const element of next.head.querySelectorAll("meta, link")) {
+                const same = owned.find(candidate => !kept.has(candidate) && candidate.isEqualNode(element));
+                if (same === undefined)
+                    added.push(element);
+                else
+                    kept.add(same);
+            }
+            // New stylesheets load before the swap, so the next page never paints unstyled. Component styles
+            // are scoped, so only the next page's global rules apply to this one meanwhile.
+            for (const element of added)
+                if (element instanceof HTMLLinkElement && element.relList.contains("stylesheet"))
+                    sheets.push(element);
+            const loading = sheets.map(sheet => new Promise(done => { sheet.addEventListener("load", done); sheet.addEventListener("error", done); }));
+            document.head.append(...sheets);
+            // The next page's components register before its DOM arrives; a conflicting one falls back below.
+            const modules = [...next.head.querySelectorAll('script[type="module"][src]')].map(script => import(/* @vite-ignore */ script.src));
+            await Promise.all([...loading, ...modules]);
+            const commit = () => {
+                signal.throwIfAborted();
+                committed = true;
+                for (const element of owned)
+                    if (!kept.has(element))
+                        element.remove();
+                document.head.append(...added.filter(element => !sheets.includes(element)));
+                owned = [...kept, ...added];
+                document.title = next.title;
+                document.documentElement.lang = next.documentElement.lang;
+                // Layouts persist while each depth renders the same component: they keep their DOM, state,
+                // and controllers, and take the new rendering's props. The page layer is always replaced.
+                let index = 0;
+                let incoming = layer(next, 0);
+                let deeper = layer(next, 1);
+                while (deeper !== null && layer(document, index)?.getAttribute("data-component") === incoming.getAttribute("data-component")) {
+                    runtime.adoptRenderedProps(layer(document, index), incoming);
+                    incoming = deeper;
+                    deeper = layer(next, ++index + 1);
+                }
+                // A page sits in its layout's slot; the layout projects the new page as it did the old one.
+                runtime.replaceProjectedNode(layer(document, index), incoming);
+                rendered = url.pathname;
+                announcer.textContent = document.title;
+                watch();
+            };
+            signal.throwIfAborted();
+            if (typeof document.startViewTransition !== "function" || !transitions(document.styleSheets))
+                commit();
+            else
+                await document.startViewTransition(commit).updateCallbackDone;
+            const saved = event.navigationType === "traverse" ? positions.get(event.destination.key) : undefined;
+            if (saved === undefined)
+                event.scroll();
+            else
+                scrollTo(...saved);
+        }
+        catch (error) {
+            if (!committed)
+                for (const sheet of sheets)
+                    sheet.remove();
+            if (signal.aborted)
+                return;
+            // Anything this document cannot render in place loads as a document instead.
+            console.error(error);
+            location.reload();
+        }
+    };
+    // ponytail: WebKit 26.6 sometimes restores no position for an intercepted back or forward
+    // navigation, so HTMLKit records where each entry was left. Other scrolling stays native.
+    const positions = new Map();
+    navigation.addEventListener("navigate", event => {
+        if (navigation.currentEntry !== null)
+            positions.set(navigation.currentEntry.key, [scrollX, scrollY]);
+        const url = new URL(event.destination.url);
+        // Reloads, downloads, form posts, fragment and history.pushState changes, and other documents
+        // stay native. Modified clicks and link targets open other browsing contexts without this event.
+        if (!event.canIntercept || event.navigationType === "reload" || event.downloadRequest !== null || event.formData !== null ||
+            !local(url, event.sourceElement) || event.destination.sameDocument && (event.navigationType !== "traverse" || url.pathname === rendered))
+            return;
+        // After the swap, a new entry scrolls to its fragment or the top, back and forward return to
+        // where the entry was left, and focus resets as after a document load.
+        event.intercept({ scroll: "manual", handler: () => visit(url, event) });
+    });
+}
+/** Authors animate navigation with @view-transition { navigation: auto }, as for document navigation. */
+function transitions(rules) {
+    return Array.prototype.some.call(rules, (rule) => {
+        try {
+            return rule instanceof CSSStyleSheet ? transitions(rule.cssRules) :
+                typeof CSSViewTransitionRule === "function" && rule instanceof CSSViewTransitionRule ? rule.navigation === "auto" :
+                    rule instanceof CSSGroupingRule && (!(rule instanceof CSSMediaRule) || matchMedia(rule.conditionText).matches) && transitions(rule.cssRules);
+        }
+        catch {
+            return false;
+        } // A cross-origin stylesheet hides its rules.
+    });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.d.ts

@@ -9,5 +9,15 @@ export declare function configure(options: ApplicationOptions): {
     base: string;
     origin: string;
     outDir: string;
+    prefetch: import("./types.js").PrefetchPolicy;
 };
+/** Merge each plugin's config() once; options already merged pass through, so nested entry points don't repeat hooks. */
+export declare function withPlugins(options: ApplicationOptions): Promise<ApplicationOptions>;
+/** Vite's side of the import map's @/ entry, for loaders, controllers, and stylesheets. */
+export declare function rootAlias(root: string): {
+    find: RegExp;
+    replacement: string;
+}[];
+/** The application's global stylesheets as absolute paths. */
+export declare function globalStylesheets(options: ApplicationOptions, root: string): readonly string[];
 //# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,YAAa,SAAQ,KAAK;IACR,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAArD,YAAY,OAAO,EAAE,MAAM,EAAW,MAAM,CAAC,EAAE,MAAM,YAAA,EAGpD;CACF;AACD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAG7D;AACD,wBAAgB,SAAS,CAAC,OAAO,EAAE,kBAAkB;;;;;EAcpD"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,qBAAa,YAAa,SAAQ,KAAK;IACR,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM;IAArD,YAAY,OAAO,EAAE,MAAM,EAAW,MAAM,CAAC,EAAE,MAAM,YAAA,EAGpD;CACF;AACD,wBAAgB,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAG7D;AACD,wBAAgB,SAAS,CAAC,OAAO,EAAE,kBAAkB;;;;;;EAkBpD;AAGD,yHAAyH;AACzH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAc1F;AAED,2FAA2F;AAC3F,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM;;;IAErC;AAED,8DAA8D;AAC9D,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAE9F"}

package/dist/config.js

@@ -1,4 +1,5 @@
 import { isAbsolute, relative, resolve, sep } from "node:path";
+import { normalizePath } from "vite";
 export class HtmlKitError extends Error {
     source;
     constructor(message, source) {
@@ -12,6 +13,9 @@ export function within(parent, child) {
     return path === "" || (!isAbsolute(path) && path !== ".." && !path.startsWith(`..${sep}`));
 }
 export function configure(options) {
+    // Removed with the always-on 01. ordering; name that rather than quietly move pages to /01-guide/.
+    if ("routeOrdering" in options)
+        throw new HtmlKitError("The routeOrdering option was removed: a number and a dot (01.guide/) always orders pages.");
     const root = resolve(options.root ?? process.cwd());
     const base = options.base ?? "/";
     if (!/^\/(?:[A-Za-z0-9_-]+\/)*$/.test(base))
@@ -25,6 +29,35 @@ export function configure(options) {
     if (within(outDir, root) || ["app", "src", "public", "node_modules", ".git"].some(path => within(resolve(root, path), outDir))) {
         throw new HtmlKitError("Unsafe output directory; choose dist or a separate deployment directory.", outDir);
     }
-    return { root, base, origin: origin.origin, outDir };
+    const prefetch = options.prefetch ?? "interaction";
+    if (!["interaction", "visible", "none"].includes(prefetch))
+        throw new HtmlKitError('prefetch must be "interaction", "visible", or "none".');
+    return { root, base, origin: origin.origin, outDir, prefetch };
+}
+const pluginsApplied = new WeakSet();
+/** Merge each plugin's config() once; options already merged pass through, so nested entry points don't repeat hooks. */
+export async function withPlugins(options) {
+    if (pluginsApplied.has(options) || options.plugins === undefined)
+        return options;
+    let merged = options;
+    for (const plugin of options.plugins) {
+        const added = await plugin.config?.(merged) ?? {};
+        // Page folders, stylesheets, and routes add to the application's own; app/pages stays the default folder.
+        merged = { ...merged, ...added, plugins: options.plugins,
+            ...(added.pages === undefined ? {} : { pages: [...merged.pages ?? [{ dir: "app/pages", optional: true }], ...added.pages] }),
+            ...(added.css === undefined ? {} : { css: [...merged.css ?? [], ...added.css] }),
+            ...(added.routes === undefined ? {} : { routes: [...merged.routes ?? [], ...added.routes] }) };
+    }
+    merged = { ...merged };
+    pluginsApplied.add(merged);
+    return merged;
+}
+/** Vite's side of the import map's @/ entry, for loaders, controllers, and stylesheets. */
+export function rootAlias(root) {
+    return [{ find: /^@\//, replacement: normalizePath(root) + "/" }];
+}
+/** The application's global stylesheets as absolute paths. */
+export function globalStylesheets(options, root) {
+    return (options.css ?? []).map(path => resolve(root, path.startsWith("@/") ? path.slice(2) : path));
 }
 //# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAG/D,MAAM,OAAO,YAAa,SAAQ,KAAK;IACC,MAAM;IAA5C,YAAY,OAAe,EAAW,MAAe;QACnD,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;sBAD5B,MAAM;QAE1C,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AACD,MAAM,UAAU,MAAM,CAAC,MAAc,EAAE,KAAa;IAClD,MAAM,IAAI,GAAG,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,IAAI,KAAK,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,GAAG,EAAE,CAAC,CAAC,CAAC;AAC7F,CAAC;AACD,MAAM,UAAU,SAAS,CAAC,OAA2B;IACnD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,GAAG,CAAC;IACjC,IAAI,CAAC,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,MAAM,IAAI,YAAY,CAAC,0EAA0E,CAAC,CAAC;IAChJ,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,kBAAkB,CAAC,CAAC;IAC7D,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,QAAQ,KAAK,GAAG,IAAI,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC;QACxI,MAAM,IAAI,YAAY,CAAC,mFAAmF,CAAC,CAAC;IAC9G,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,CAAC;IACvD,gFAAgF;IAChF,IAAI,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QAC/H,MAAM,IAAI,YAAY,CAAC,0EAA0E,EAAE,MAAM,CAAC,CAAC;IAC7G,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;AACvD,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/dist/document.d.ts

@@ -1,5 +1,33 @@
-import type { HeadElement, RenderedHead } from "./types.js";
+import type { HeadElement, RenderedHead, RenderedPage } from "./types.js";
 export declare const defaultHeadElements: readonly HeadElement[];
+/** A page's browser delivery: stylesheet and module URLs, which the serving adapter supplies. */
+export interface PageAssets {
+    readonly styles: readonly string[];
+    readonly modules: readonly string[];
+}
 export declare function escapeHTML(value: string): string;
-export declare function documentHTML(body: string, head: RenderedHead, assets?: string): string;
+export declare function documentHTML(body: string, head: RenderedHead, assets?: PageAssets): string;
+/**
+ * A page's payload URL: its route path under the reserved _htmlkit/pages/ tree, which no route or
+ * public file may use, so it never collides with an application's own files.
+ */
+export declare function payloadPath(base: string, pathname: string): string;
+/**
+ * What the browser needs to render a page in place: the document's head, its delivery, and each
+ * layer's invocation and initial state, exactly as the server rendered them. The page's component
+ * definitions are in its module. Undefined when JSON cannot carry the state exactly; such a page
+ * navigates by its HTML instead.
+ */
+export declare function pagePayload(page: RenderedPage, assets: PageAssets): {
+    version: number;
+    head: {
+        lang: string;
+        title: string;
+        description?: string;
+        elements: readonly HeadElement[];
+    };
+    styles: readonly string[];
+    modules: readonly string[];
+    layers: readonly import("./types.js").RenderedLayer[];
+} | undefined;
 //# sourceMappingURL=document.d.ts.map

package/dist/document.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAGrD,CAAC;AACF,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AACD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,SAAK,GAAG,MAAM,CASlF"}
+{"version":3,"file":"document.d.ts","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1E,eAAO,MAAM,mBAAmB,EAAE,SAAS,WAAW,EAGrD,CAAC;AACF,iGAAiG;AACjG,MAAM,WAAW,UAAU;IAAG,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE;AACvG,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEhD;AACD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,GAAE,UAAwC,GAAG,MAAM,CAavH;AAED;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAElE;AAYD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU;;;;;;;;;;;cAKjE"}

package/dist/document.js

@@ -5,14 +5,49 @@ export const defaultHeadElements = [
 export function escapeHTML(value) {
     return value.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;").replace(/'/g, "&#39;");
 }
-export function documentHTML(body, head, assets = "") {
+export function documentHTML(body, head, assets = { styles: [], modules: [] }) {
     const elements = head.elements ?? defaultHeadElements;
-    const metadata = [...elements.filter(element => element.tag === "meta" && element.attributes.charset !== undefined),
-        ...elements.filter(element => element.tag !== "meta" || element.attributes.charset === undefined)]
-        .map(element => `<${element.tag}${Object.entries(element.attributes).map(([name, value]) => ` ${name}="${escapeHTML(value)}"`).join("")}>`).join("");
-    return `<!doctype html>\n<html lang="${escapeHTML(head.lang ?? "en")}"><head>${metadata}` +
+    const charset = elements.filter(element => element.tag === "meta" && element.attributes.charset !== undefined);
+    const html = (list) => list.map(element => `<${element.tag}${Object.entries(element.attributes).map(([name, value]) => ` ${name}="${escapeHTML(value)}"`).join("")}>`).join("");
+    // Head scripts precede stylesheets, which would otherwise delay it until they load.
+    return `<!doctype html>\n<html lang="${escapeHTML(head.lang ?? "en")}"><head>${html(charset)}` +
+        (head.scripts ?? []).map(script => `<script>${script}</script>`).join("") + html(elements.filter(element => !charset.includes(element))) +
         `<title>${escapeHTML(head.title ?? "HTMLKit")}</title>` +
         (head.description === undefined ? "" : `<meta name="description" content="${escapeHTML(head.description)}">`) +
-        `${assets}</head><body>${body}</body></html>`;
+        assets.styles.map(href => `<link rel="stylesheet" href="${escapeHTML(href)}">`).join("") +
+        assets.modules.map(src => `<script type="module" src="${escapeHTML(src)}"></script>`).join("") +
+        `</head><body>${body}</body></html>`;
+}
+/**
+ * A page's payload URL: its route path under the reserved _htmlkit/pages/ tree, which no route or
+ * public file may use, so it never collides with an application's own files.
+ */
+export function payloadPath(base, pathname) {
+    return `${base}_htmlkit/pages/${pathname.slice(base.length)}payload.json`;
+}
+/** Whether JSON carries a value exactly: no undefined, -0, non-finite numbers, or shared or opaque objects. */
+function exact(value, seen) {
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return true;
+    if (typeof value === "number")
+        return Number.isFinite(value) && !Object.is(value, -0);
+    if (typeof value !== "object" || seen.has(value) ||
+        !Array.isArray(value) && ![Object.prototype, null].includes(Object.getPrototypeOf(value)))
+        return false;
+    seen.add(value);
+    return (Array.isArray(value) ? Array.from(value) : Object.values(value)).every(item => exact(item, seen));
+}
+/**
+ * What the browser needs to render a page in place: the document's head, its delivery, and each
+ * layer's invocation and initial state, exactly as the server rendered them. The page's component
+ * definitions are in its module. Undefined when JSON cannot carry the state exactly; such a page
+ * navigates by its HTML instead.
+ */
+export function pagePayload(page, assets) {
+    if (page.status !== 200 || !page.layers.every(layer => layer.state === undefined || exact(layer.state, new Set())))
+        return undefined;
+    const { lang = "en", title = "HTMLKit", description, elements = defaultHeadElements } = page.head;
+    return { version: 1, head: { lang, title, ...(description === undefined ? {} : { description }), elements },
+        styles: assets.styles, modules: assets.modules, layers: page.layers };
 }
 //# sourceMappingURL=document.js.map

package/dist/document.js.map

@@ -1 +1 @@
-{"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"AACA,MAAM,CAAC,MAAM,mBAAmB,GAA2B;IACzD,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EAAE;IACjD,EAAE,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,qCAAqC,EAAE,EAAE;CAClG,CAAC;AACF,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,OAAO,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACjI,CAAC;AACD,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,IAAkB,EAAE,MAAM,GAAG,EAAE;IACxE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,IAAI,mBAAmB,CAAC;IACtD,MAAM,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,KAAK,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC;QACjH,GAAG,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,KAAK,MAAM,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC;SACjG,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,OAAO,CAAC,GAAG,GAAG,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,KAAK,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACvJ,OAAO,gCAAgC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW,QAAQ,EAAE;QACvF,UAAU,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,SAAS,CAAC,UAAU;QACvD,CAAC,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,qCAAqC,UAAU,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAC7G,GAAG,MAAM,gBAAgB,IAAI,gBAAgB,CAAC;AAClD,CAAC"}
+{"version":3,"file":"document.js","sourceRoot":"","sources":["../src/document.ts"],"names":[],"mappings":"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"}

package/dist/head.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../src/head.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAKhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAe,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiB1E,wBAAsB,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAAE,UAAU,EAAE,mBAAmB,EAChH,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EACzD,MAAM,EAAE,CAAC,UAAU,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,KAAK,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAgDlG"}
+{"version":3,"file":"head.d.ts","sourceRoot":"","sources":["../src/head.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAKhF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,KAAK,EAAe,YAAY,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAiB1E,wBAAsB,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAAE,UAAU,EAAE,mBAAmB,EAChH,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,EAAE,MAAM,EACzD,MAAM,EAAE,CAAC,UAAU,EAAE,mBAAmB,EAAE,MAAM,EAAE,YAAY,KAAK,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAkDlG"}

package/dist/head.js

@@ -35,11 +35,11 @@ export async function renderHead(resource, definition, result, previous, url, in
         for (const node of fragment.childNodes) {
             if (!("tagName" in node))
                 continue;
-            node.attrs.push({ name: "data-htmlkit-head", value: node.tagName });
+            node.attrs.push({ name: "data-hk-head", value: node.tagName });
             node.tagName = "span";
             node.nodeName = "span";
         }
-        const headDefinition = parseComponent(`<template component="htmlkit-head"><defs>${metadata.propDeclarations}</defs><div>${serialize(fragment)}</div></template>`, definition.source.file);
+        const headDefinition = parseComponent(`<template component="hk-head"><defs>${metadata.propDeclarations}</defs><div>${serialize(fragment)}</div></template>`, definition.source.file);
         const rendered = await renderComponents(invoke(headDefinition, { props: result.props ?? {} }), { definitions: [headDefinition], url });
         const root = parseFragment(rendered.html).childNodes.find(node => "tagName" in node);
         if (root === undefined || !("childNodes" in root))
@@ -49,14 +49,14 @@ export async function renderHead(resource, definition, result, previous, url, in
         for (const node of root.childNodes) {
             if (!("tagName" in node))
                 continue;
-            const tag = node.attrs.find(attribute => attribute.name === "data-htmlkit-head")?.value;
+            const tag = node.attrs.find(attribute => attribute.name === "data-hk-head")?.value;
             if (tag === "title") {
                 title = text(node);
                 continue;
             }
             if (tag !== "meta" && tag !== "link")
                 throw new HtmlKitError("Head content must render title, meta, or link elements.", definition.source.file);
-            const attributes = Object.fromEntries(node.attrs.filter(attribute => attribute.name !== "data-htmlkit-head").map(attribute => [attribute.name, attribute.value]));
+            const attributes = Object.fromEntries(node.attrs.filter(attribute => attribute.name !== "data-hk-head").map(attribute => [attribute.name, attribute.value]));
             if (Object.keys(attributes).some(name => name.startsWith("on")) || (tag === "meta" && attributes["http-equiv"] !== undefined)) {
                 throw new HtmlKitError("Head metadata cannot activate event handlers or http-equiv policies.", definition.source.file);
             }
@@ -82,7 +82,9 @@ export async function renderHead(resource, definition, result, previous, url, in
                 elements.splice(i, 1);
         elements.push(...current);
     }
-    return { ...previous, ...(title === undefined ? {} : { title }), ...(description === undefined ? {} : { description }), ...result.head,
+    // Only PageHead fields: an untyped loader's extra head keys must not reach the document assembler.
+    const loaded = Object.entries(result.head ?? {}).filter(([name]) => name === "title" || name === "description" || name === "lang");
+    return { ...previous, ...(title === undefined ? {} : { title }), ...(description === undefined ? {} : { description }), ...Object.fromEntries(loaded),
         elements };
 }
 //# sourceMappingURL=head.js.map