@threadlabs/markupkit 0.0.0-stage → 0.1.0

package/dist/providers.js

@@ -0,0 +1,127 @@
+import { createHash, randomUUID } from "node:crypto";
+import { mkdir, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { join } from "node:path";
+import { pathToFileURL } from "node:url";
+import { bundleServer } from "./bundle.js";
+import ts from "typescript-compiler";
+function surface(file, source) {
+    if (/\.d\.[cm]?ts$/i.test(file))
+        return { provider: false, stars: [] };
+    // Use compiler erasure rather than mistaking an exported local type for a runtime value.
+    const emitted = ts.transpileModule(source, { fileName: file,
+        compilerOptions: { target: ts.ScriptTarget.ESNext, module: ts.ModuleKind.ESNext, jsx: ts.JsxEmit.Preserve } }).outputText;
+    const parsed = ts.createSourceFile(file, emitted, ts.ScriptTarget.Latest);
+    const names = new Set(["props", "create"]);
+    const binding = (name) => ts.isIdentifier(name) ? names.has(name.text)
+        : name.elements.some(element => ts.isBindingElement(element) && binding(element.name));
+    let provider = false;
+    const stars = [];
+    for (const statement of parsed.statements) {
+        if (ts.isExportDeclaration(statement)) {
+            const clause = statement.exportClause;
+            if (clause === undefined) {
+                if (statement.moduleSpecifier !== undefined && ts.isStringLiteral(statement.moduleSpecifier))
+                    stars.push(statement.moduleSpecifier.text);
+            }
+            else if (ts.isNamedExports(clause))
+                provider ||= clause.elements.some(element => names.has(element.name.text));
+            else
+                provider ||= names.has(clause.name.text);
+            continue;
+        }
+        const modifiers = ts.canHaveModifiers(statement) ? ts.getModifiers(statement) : undefined;
+        if (!modifiers?.some(modifier => modifier.kind === ts.SyntaxKind.ExportKeyword) ||
+            modifiers.some(modifier => modifier.kind === ts.SyntaxKind.DefaultKeyword))
+            continue;
+        if (ts.isVariableStatement(statement))
+            provider ||= statement.declarationList.declarations.some(declaration => binding(declaration.name));
+        else if (ts.isFunctionDeclaration(statement) || ts.isClassDeclaration(statement))
+            provider ||= statement.name !== undefined && names.has(statement.name.text);
+    }
+    return { provider, stars };
+}
+export function createProviderModules(root, host) {
+    const revision = randomUUID();
+    const abort = new AbortController();
+    const cache = new Map();
+    const surfaces = new Map();
+    const provider = async (file, seen = new Set()) => {
+        if (seen.has(file))
+            return false;
+        seen.add(file);
+        let parsed = surfaces.get(file);
+        if (parsed === undefined) {
+            host.watch(file);
+            parsed = readFile(file, { encoding: "utf8", signal: abort.signal }).then(source => surface(file, source));
+            surfaces.set(file, parsed);
+        }
+        const found = await parsed;
+        if (found.provider)
+            return true;
+        for (const specifier of found.stars) {
+            const resolved = await host.resolve(specifier, file);
+            if (resolved !== undefined && await provider(resolved, seen))
+                return true;
+        }
+        return false;
+    };
+    let temporary;
+    let batch = 0;
+    let closing;
+    return {
+        async resolve(components) {
+            abort.signal.throwIfAborted();
+            const missing = [...new Set(components.flatMap(component => component.module === undefined ? [] : [component.module]))].filter(file => !cache.has(file));
+            if (missing.length > 0) {
+                const id = batch++;
+                // Keep native package resolution rooted in the app; Vite excludes its cache from watching.
+                const directory = () => (temporary ??= (async () => {
+                    await mkdir(host.cacheDir, { recursive: true });
+                    const directory = await mkdtemp(join(host.cacheDir, "markupkit-providers-"));
+                    try {
+                        await writeFile(join(directory, "package.json"), '{"type":"module"}');
+                    }
+                    catch (error) {
+                        await rm(directory, { recursive: true, force: true });
+                        throw error;
+                    }
+                    return directory;
+                })()).then(path => join(path, String(id)));
+                const eligible = Promise.all(missing.map(file => provider(file)));
+                const bundled = (async () => {
+                    const selected = (await eligible).flatMap((include, i) => include ? [[`provider-${i}`, missing[i]]] : []);
+                    const result = selected.length === 0 ? undefined : await bundleServer({ root, outDir: await directory(), inputs: Object.fromEntries(selected) }, abort.signal);
+                    for (const file of result?.inputs ?? [])
+                        host.watch(file);
+                    return result;
+                })();
+                for (const [i, file] of missing.entries())
+                    cache.set(file, (async () => {
+                        const result = await bundled;
+                        const entry = result?.entries[`provider-${i}`];
+                        if (entry === undefined || !entry.exports.some(name => name === "props" || name === "create"))
+                            return undefined;
+                        return { module: pathToFileURL(join(await directory(), entry.file)).href, source: `${revision}:${id}:${i}` };
+                    })());
+            }
+            return Promise.all(components.map(async (component) => {
+                const provider = component.module === undefined ? undefined : await cache.get(component.module);
+                if (provider === undefined && component.server !== undefined)
+                    throw new TypeError(`${component.server}: private readers require a common provider module.`);
+                const identity = createHash("sha256").update(`${component.definition.source.file}\0${component.definition.contract.tag}`).digest("hex").slice(0, 16);
+                return provider === undefined ? component : { ...component, binding: { ...provider, source: `${provider.source}:${identity}`,
+                        ...component.client === undefined ? {} : { client: true }, ...component.privateReaderNames === undefined ? {} : { readers: component.privateReaderNames } } };
+            }));
+        },
+        close() {
+            return closing ??= (async () => {
+                abort.abort(new Error("MarkupKit provider modules are closed."));
+                await Promise.allSettled([...cache.values(), ...surfaces.values()]);
+                const directory = await temporary?.catch(() => undefined);
+                if (directory !== undefined)
+                    await rm(directory, { recursive: true, force: true });
+            })();
+        },
+    };
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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

package/dist/read-channel.d.ts

@@ -0,0 +1,30 @@
+import type { MessagePort } from "node:worker_threads";
+import type { BindingOperation, HydrationValue } from "@nextwebwg/html-next/bindings";
+export interface ReadCodec {
+    encodeHydrationValue(value: unknown): HydrationValue;
+    decodeHydrationValue(value: unknown): unknown;
+}
+export interface ReadCall {
+    readonly kind: "read";
+    readonly id: number;
+    readonly tag: string;
+    readonly name: string;
+    readonly input: HydrationValue;
+    readonly sample: HydrationValue;
+}
+export interface ReadReply {
+    readonly id: number;
+    readonly value?: HydrationValue;
+    readonly error?: {
+        readonly name: string;
+        readonly message: string;
+        readonly status?: number;
+    };
+}
+export declare function sendRead(port: MessagePort, message: unknown): void;
+/** One render's existing transferred port; no application-global request or value cache. */
+export declare function readChannel(port: MessagePort, codec: ReadCodec): {
+    read(tag: string, name: string, input: unknown, operation: BindingOperation): Promise<unknown>;
+    close: () => void;
+};
+//# sourceMappingURL=read-channel.d.ts.map

package/dist/read-channel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-channel.d.ts","sourceRoot":"","sources":["../src/read-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAEtF,MAAM,WAAW,SAAS;IAAG,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAAC;IAAC,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAA;CAAE;AAClI,MAAM,WAAW,QAAQ;IAAG,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAAE;AACtL,MAAM,WAAW,SAAS;IAAG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE;AACnL,wBAAgB,QAAQ,CAAC,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAGlE;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,SAAS;cAajD,MAAM,QAAQ,MAAM,SAAS,OAAO,aAAa,gBAAgB,GAAG,OAAO,CAAC,OAAO,CAAC;iBAT9E,IAAI;EA+BvB"}

package/dist/read-channel.js

@@ -0,0 +1,65 @@
+export function sendRead(port, message) {
+    // oxlint-disable-next-line unicorn/require-post-message-target-origin -- Native Node MessagePort has no origin.
+    port.postMessage(message);
+}
+/** One render's existing transferred port; no application-global request or value cache. */
+export function readChannel(port, codec) {
+    let next = 0;
+    let closed = false;
+    const pending = new Map();
+    const receive = (reply) => { pending.get(reply.id)?.accept(reply); };
+    const close = () => {
+        if (closed)
+            return;
+        closed = true;
+        port.off("message", receive);
+        for (const request of pending.values())
+            request.reject(new DOMException("The render's private read channel closed.", "AbortError"));
+        pending.clear();
+    };
+    port.on("message", receive);
+    port.once("close", close);
+    return {
+        read(tag, name, input, operation) {
+            if (closed || operation.signal.aborted)
+                return Promise.reject(operation.signal.reason ?? new DOMException("Private reads are closed.", "AbortError"));
+            const id = next++;
+            return new Promise((resolve, reject) => {
+                const done = (error, reply) => {
+                    pending.delete(id);
+                    operation.signal.removeEventListener("abort", abort);
+                    if (error !== undefined)
+                        reject(error);
+                    else if (reply?.error !== undefined)
+                        reject(Object.assign(new Error(reply.error.message), { name: reply.error.name }));
+                    else {
+                        try {
+                            resolve(codec.decodeHydrationValue(reply.value));
+                        }
+                        catch (error) {
+                            reject(error);
+                        }
+                    }
+                };
+                const abort = () => {
+                    try {
+                        if (!closed)
+                            sendRead(port, { kind: "cancel", id });
+                    }
+                    catch { /* A closed peer needs no cancellation frame. */ }
+                    done(operation.signal.reason ?? new DOMException("Private read aborted.", "AbortError"));
+                };
+                pending.set(id, { accept: reply => done(undefined, reply), reject: error => done(error) });
+                operation.signal.addEventListener("abort", abort, { once: true });
+                try {
+                    sendRead(port, { kind: "read", id, tag, name, input: codec.encodeHydrationValue(input), sample: codec.encodeHydrationValue(operation.sample) });
+                }
+                catch (error) {
+                    done(error);
+                }
+            });
+        },
+        close,
+    };
+}
+//# sourceMappingURL=read-channel.js.map

package/dist/read-channel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"read-channel.js","sourceRoot":"","sources":["../src/read-channel.ts"],"names":[],"mappings":"AAMA,MAAM,UAAU,QAAQ,CAAC,IAAiB,EAAE,OAAgB;IAC1D,gHAAgH;IAChH,IAAI,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;AAC5B,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,WAAW,CAAC,IAAiB,EAAE,KAAgB;IAC7D,IAAI,IAAI,GAAG,CAAC,CAAC;IAAC,IAAI,MAAM,GAAG,KAAK,CAAC;IACjC,MAAM,OAAO,GAAG,IAAI,GAAG,EAA4E,CAAC;IACpG,MAAM,OAAO,GAAG,CAAC,KAAgB,EAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtF,MAAM,KAAK,GAAG,GAAS,EAAE;QACvB,IAAI,MAAM;YAAE,OAAO;QACnB,MAAM,GAAG,IAAI,CAAC;QACd,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC7B,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,MAAM,EAAE;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,YAAY,CAAC,2CAA2C,EAAE,YAAY,CAAC,CAAC,CAAC;QACpI,OAAO,CAAC,KAAK,EAAE,CAAC;IAClB,CAAC,CAAC;IACF,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACvD,OAAO;QACL,IAAI,CAAC,GAAW,EAAE,IAAY,EAAE,KAAc,EAAE,SAA2B;YACzE,IAAI,MAAM,IAAI,SAAS,CAAC,MAAM,CAAC,OAAO;gBAAE,OAAO,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,YAAY,CAAC,2BAA2B,EAAE,YAAY,CAAC,CAAC,CAAC;YACtJ,MAAM,EAAE,GAAG,IAAI,EAAE,CAAC;YAClB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;gBACrC,MAAM,IAAI,GAAG,CAAC,KAAe,EAAE,KAAiB,EAAQ,EAAE;oBACxD,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;oBAAC,SAAS,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;oBACzE,IAAI,KAAK,KAAK,SAAS;wBAAE,MAAM,CAAC,KAAK,CAAC,CAAC;yBAClC,IAAI,KAAK,EAAE,KAAK,KAAK,SAAS;wBAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;yBAClH,CAAC;wBAAC,IAAI,CAAC;4BAAC,OAAO,CAAC,KAAK,CAAC,oBAAoB,CAAC,KAAM,CAAC,KAAK,CAAC,CAAC,CAAC;wBAAC,CAAC;wBAAC,OAAO,KAAK,EAAE,CAAC;4BAAC,MAAM,CAAC,KAAK,CAAC,CAAC;wBAAC,CAAC;oBAAC,CAAC;gBACtG,CAAC,CAAC;gBACF,MAAM,KAAK,GAAG,GAAS,EAAE;oBACvB,IAAI,CAAC;wBAAC,IAAI,CAAC,MAAM;4BAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC;oBAAC,CAAC;oBAAC,MAAM,CAAC,CAAC,gDAAgD,CAAC,CAAC;oBACvH,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,YAAY,CAAC,uBAAuB,EAAE,YAAY,CAAC,CAAC,CAAC;gBAC3F,CAAC,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBAC3F,SAAS,CAAC,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;gBAClE,IAAI,CAAC;oBAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,oBAAoB,CAAC,SAAS,CAAC,MAAM,CAAC,EAAqB,CAAC,CAAC;gBAAC,CAAC;gBAC3K,OAAO,KAAK,EAAE,CAAC;oBAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAAC,CAAC;YAChC,CAAC,CAAC,CAAC;QACL,CAAC;QACD,KAAK;KACN,CAAC;AACJ,CAAC"}

package/dist/resource.d.ts

@@ -0,0 +1,31 @@
+import { type ComponentDefinition } from "@nextwebwg/html-next";
+interface ComponentMetadata {
+    readonly layout?: string;
+    readonly label?: string;
+    /** hk:order, the page's place among its neighbours, as a number-and-dot prefix gives it. */
+    readonly order?: string;
+    readonly hidden?: boolean;
+    /** hk:render: "server" renders the page on each request; "prerender", the default, at build time. */
+    readonly render?: "prerender" | "server";
+    /** Extra route patterns for a page, relative to its page directory's prefix. */
+    readonly aliases: readonly string[];
+    /** hk:redirect-from: old route paths, relative to its page directory's prefix, that redirect to the page. */
+    readonly redirectsFrom: readonly string[];
+    /** The text of a <title> without expressions. */
+    readonly title?: string;
+}
+/** Native HTML parsing determines resource nodes; HTML Next owns component syntax. */
+export declare function applicationResource(source: string, file: string): {
+    definitions: ComponentDefinition[];
+    dependencies: readonly string[];
+    configuration: Map<string, string>;
+    components: Map<string, ComponentMetadata>;
+};
+export declare function pageDefinition(resource: ReturnType<typeof applicationResource>, file: string): ComponentDefinition;
+/**
+ * A definition without its hk: settings, which MarkupKit reads as configuration, so the runtime never
+ * adds them to the document head.
+ */
+export declare function withoutSettings(definition: ComponentDefinition): ComponentDefinition;
+export {};
+//# sourceMappingURL=resource.d.ts.map

package/dist/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AAAA,OAAO,EAA0B,KAAK,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAIxF,UAAU,iBAAiB;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,4FAA4F;IAC5F,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,qGAAqG;IACrG,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,QAAQ,CAAC;IACzC,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,6GAA6G;IAC7G,QAAQ,CAAC,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IAC1C,iDAAiD;IACjD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAOD,sFAAsF;AACtF,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;;;EA4D/D;AAED,wBAAgB,cAAc,CAAC,QAAQ,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,mBAAmB,CAQlH;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,mBAAmB,GAAG,mBAAmB,CAMpF"}

package/dist/resource.js

@@ -0,0 +1,117 @@
+import { parseComponentResource } from "@nextwebwg/html-next";
+import { parseFragment } from "parse5";
+import { MarkupKitError } from "./config.js";
+// MarkupKit metadata was spelled htmlkit:*; name the new spelling rather than ignore it.
+function renamed(name, file) {
+    if (name?.startsWith("htmlkit:"))
+        throw new MarkupKitError(`MarkupKit metadata uses the hk: prefix; write ${"hk:" + name.slice(name.indexOf(":") + 1)} instead of ${name}.`, file);
+}
+/** Native HTML parsing determines resource nodes; HTML Next owns component syntax. */
+export function applicationResource(source, file) {
+    const configuration = new Map();
+    const components = new Map();
+    const fragment = parseFragment(source);
+    for (const node of fragment.childNodes) {
+        if (!("tagName" in node) || !["meta", "title", "link"].includes(node.tagName))
+            continue;
+        const name = node.attrs.find(attribute => attribute.name === "name")?.value;
+        renamed(name, file);
+        if (node.tagName === "meta" && name === "hk:page") {
+            const content = node.attrs.find(attribute => attribute.name === "content")?.value;
+            if (!content || configuration.has(name))
+                throw new MarkupKitError(`Declare ${name} once with nonempty content.`, file);
+            configuration.set(name, content);
+        }
+        else if (node.tagName !== "link" || !node.attrs.find(attribute => attribute.name === "rel")?.value.toLowerCase().split(/\s+/).includes("component")) {
+            throw new MarkupKitError("Page and layout metadata belongs in its <template component>'s <defs>; only hk:page, which selects the file's page, is outside it.", file);
+        }
+    }
+    for (const node of fragment.childNodes) {
+        if (!("tagName" in node))
+            continue;
+        const tag = node.attrs.find(attribute => attribute.name === "component")?.value;
+        if (node.tagName !== "template" || tag === undefined)
+            continue;
+        const children = node.content.childNodes;
+        const configuration = {};
+        const aliases = [], redirectsFrom = [];
+        for (const child of children) {
+            if ("tagName" in child && ["meta", "title", "link"].includes(child.tagName)) {
+                throw new MarkupKitError(`<${child.tagName}> belongs in <${tag}>'s <defs>, where head content and hk: settings are declared.`, file);
+            }
+        }
+        const defs = children.find(child => "tagName" in child && child.tagName === "defs");
+        for (const child of defs !== undefined && "childNodes" in defs ? defs.childNodes : []) {
+            if (!("tagName" in child))
+                continue;
+            // A static <title> labels the page's folder in navigation trees when hk:label doesn't.
+            if (child.tagName === "title") {
+                const text = child.childNodes.map(text => "value" in text ? text.value : "").join("").trim();
+                if (text !== "" && !text.includes("{"))
+                    configuration.title = text;
+                continue;
+            }
+            if (child.tagName !== "meta")
+                continue;
+            const name = child.attrs.find(attribute => attribute.name === "name")?.value;
+            renamed(name, file);
+            if (!name?.startsWith("hk:"))
+                continue;
+            const content = child.attrs.find(attribute => attribute.name === "content")?.value;
+            if (!content)
+                throw new MarkupKitError(`Declare ${name} with nonempty content.`, file);
+            if (name === "hk:alias") {
+                aliases.push(content);
+                continue;
+            }
+            if (name === "hk:redirect-from") {
+                redirectsFrom.push(content);
+                continue;
+            }
+            const key = { "hk:layout": "layout", "hk:label": "label", "hk:order": "order", "hk:navigation": "hidden", "hk:render": "render" }[name];
+            if (key === undefined)
+                throw new MarkupKitError(`Component configuration is hk:layout, hk:label, hk:order, hk:navigation, hk:render, hk:alias, or hk:redirect-from; hk:page belongs outside the carrier (${name}).`, file);
+            if (configuration[key] !== undefined)
+                throw new MarkupKitError(`Declare ${name} once per component.`, file);
+            if (key === "hidden" && content !== "hidden")
+                throw new MarkupKitError('hk:navigation accepts only content="hidden".', file);
+            if (key === "order" && !/^\d+$/.test(content))
+                throw new MarkupKitError("hk:order needs a whole number, such as content=\"3\".", file);
+            if (key === "render" && content !== "prerender" && content !== "server")
+                throw new MarkupKitError('hk:render accepts content="prerender" or content="server".', file);
+            if (key === "hidden")
+                configuration.hidden = true;
+            else if (key === "render")
+                configuration.render = content;
+            else
+                configuration[key] = content;
+        }
+        components.set(tag, { ...configuration, aliases, redirectsFrom });
+    }
+    // MarkupKit's own rules first, so their diagnostics name what MarkupKit expects.
+    const parsed = parseComponentResource(source, file);
+    return { definitions: parsed.definitions.map(withoutSettings), dependencies: parsed.dependencies, configuration, components };
+}
+export function pageDefinition(resource, file) {
+    const selected = resource.configuration.get("hk:page");
+    if (selected === undefined && resource.definitions.length !== 1) {
+        throw new MarkupKitError("Multiple components require <meta name=\"hk:page\" content=\"page-name\">.", file);
+    }
+    const definition = selected === undefined ? resource.definitions[0] : resource.definitions.find(value => value.contract.tag === selected);
+    if (definition === undefined)
+        throw new MarkupKitError(`Unknown page component ${selected}.`, file);
+    return definition;
+}
+/**
+ * A definition without its hk: settings, which MarkupKit reads as configuration, so the runtime never
+ * adds them to the document head.
+ */
+export function withoutSettings(definition) {
+    const head = definition.head?.filter(declaration => declaration.kind !== "meta" ||
+        !declaration.attributes.some(attribute => attribute.kind === "literal" && attribute.name === "name" && attribute.value.startsWith("hk:")));
+    if (head === undefined || head.length === definition.head.length)
+        return definition;
+    const { head: _head, ...rest } = definition;
+    return Object.freeze(head.length === 0 ? rest : { ...rest, head: Object.freeze(head) });
+}
+//# sourceMappingURL=resource.js.map

package/dist/resource.js.map

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

package/dist/routes.d.ts

@@ -0,0 +1,90 @@
+import { applicationResource } from "./resource.js";
+import type { ApplicationOptions, ApplicationRoute, EndpointRoute } from "./types.js";
+/** The name of a [name], [...name] catch-all, or [[...name]] optional catch-all segment. */
+export declare function parameter(segment: string): string | undefined;
+/** How broadly a segment matches: 0 a literal, 1 [name], 2 [...name], 3 [[...name]]. A missing segment is -1. */
+export declare function breadth(segment: string | undefined): number;
+export declare function validSegment(value: unknown): value is string;
+export declare const redirectStatuses: readonly number[];
+/** A redirect's Location: an application path, under base, or an absolute http(s) URL. */
+export declare function redirectLocation(base: string, to: unknown, source: string): string;
+/** The redirects option by deployment pathname, each to its Location. */
+export declare function redirectTable(base: string, redirects?: Readonly<Record<string, string>>): ReadonlyMap<string, string>;
+type DiscoveryOptions = Pick<ApplicationOptions, "base" | "routes" | "fileRoutes" | "pages" | "layout" | "layouts" | "layoutDefaults" | "plugins">;
+export declare function discoverRoutes(root?: string, options?: DiscoveryOptions): Promise<readonly ApplicationRoute[]>;
+/**
+ * Routes plus what plugins produced: compiled page sources by component path, the files pages
+ * reference by deployment-relative path, and the files plugins watch.
+ */
+export declare function discover(root: string, options: DiscoveryOptions): Promise<{
+    routes: ApplicationRoute[];
+    notFound?: ApplicationRoute;
+    error?: ApplicationRoute;
+    redirects: {
+        readonly from: string;
+        readonly to: string;
+        readonly component: string;
+    }[];
+    sources: Map<string, string>;
+    files: Map<string, string>;
+    watched: Set<string>;
+    resourceOf: (component: string) => Promise<{
+        source: string;
+        resource: ReturnType<typeof applicationResource>;
+        identity: string;
+    }>;
+}>;
+/**
+ * The request-time files: each app/api/**\/*.server.ts endpoint, which answers its folder path without
+ * a trailing slash (index.server.ts answers the folder's own), and app/middleware.server.ts.
+ */
+export declare function discoverServerFiles(root: string): Promise<{
+    readonly endpoints: readonly EndpointRoute[];
+    readonly middleware?: string;
+}>;
+export declare function matchRoute<Route extends Pick<ApplicationRoute, "pattern" | "segments">>(routes: readonly Route[], pathname: string, base: string): {
+    route: Route;
+    params: Readonly<Record<string, string | readonly string[]>>;
+} | undefined;
+/** Shared declaration discovery for rendering and independent build targets; no application modules execute. */
+export declare function discoverApplication(input?: ApplicationOptions): Promise<{
+    options: ApplicationOptions;
+    config: {
+        root: string;
+        base: string;
+        origin: string;
+        outDir: string;
+        prefetch: import("./types.js").PrefetchPolicy;
+        csp: false | import("./types.js").ContentSecurityPolicyOptions;
+    };
+    discovery: {
+        routes: ApplicationRoute[];
+        notFound?: ApplicationRoute;
+        error?: ApplicationRoute;
+        redirects: {
+            readonly from: string;
+            readonly to: string;
+            readonly component: string;
+        }[];
+        sources: Map<string, string>;
+        files: Map<string, string>;
+        watched: Set<string>;
+        resourceOf: (component: string) => Promise<{
+            source: string;
+            resource: ReturnType<typeof applicationResource>;
+            identity: string;
+        }>;
+    };
+    server: {
+        readonly endpoints: readonly EndpointRoute[];
+        readonly middleware?: string;
+    };
+    redirects: Map<string, string>;
+    pageRedirects: Map<string, {
+        readonly from: string;
+        readonly component: string;
+    }>;
+    canonicalOrigin: string;
+}>;
+export {};
+//# sourceMappingURL=routes.d.ts.map

package/dist/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../src/routes.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,mBAAmB,EAAkB,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,aAAa,EAAuD,MAAM,YAAY,CAAC;AAE3I,4FAA4F;AAC5F,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7D;AACD,iHAAiH;AACjH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAG3D;AACD,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE5D;AACD,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAA8B,CAAC;AAC7E,0FAA0F;AAC1F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAIlF;AACD,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,GAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAM,GAAG,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAUzH;AACD,KAAK,gBAAgB,GAAG,IAAI,CAAC,kBAAkB,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,GAAG,SAAS,GAAG,gBAAgB,GAAG,SAAS,CAAC,CAAC;AAEnJ,wBAAsB,cAAc,CAAC,IAAI,SAAgB,EAAE,OAAO,GAAE,gBAAqB,GAAG,OAAO,CAAC,SAAS,gBAAgB,EAAE,CAAC,CAE/H;AAED;;;GAGG;AACH,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,gBAAgB;;;;;uBA4KlC,MAAM;qBAAe,MAAM;4BAAsB,MAAM;;;;;4BAjCpD,MAAM;gBADU,MAAM;kBAAqB,UAAU,CAAC,OAAO,mBAAmB,CAAC;;;GAyJvH;AACD;;;GAGG;AACH,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,QAAQ,CAAC,SAAS,EAAE,SAAS,aAAa,EAAE,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA+B/I;AAED,wBAAgB,UAAU,CAAC,KAAK,SAAS,IAAI,CAAC,gBAAgB,EAAE,SAAS,GAAG,UAAU,CAAC,EAAE,MAAM,EAAE,SAAS,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;;;cAgChJ;AAED,gHAAgH;AAChH,wBAAsB,mBAAmB,CAAC,KAAK,GAAE,kBAAuB;;;;;;;;;;;;;;;2BAhMpC,MAAM;yBAAe,MAAM;gCAAsB,MAAM;;;;;gCAjCpD,MAAM;oBADU,MAAM;sBAAqB,UAAU,CAAC,OAAO,mBAAmB,CAAC;;;;;4BA8JjC,SAAS,aAAa,EAAE;8BAAwB,MAAM;;;;uBA6EpF,MAAM;4BAAsB,MAAM;;;GAc1F"}