@mokly/mokly 0.8.0

package/dist/build/document_compiler.d.ts

@@ -0,0 +1,32 @@
+/** Shared single-view render/validation with generation-local route and resource indexes. */
+import type { ResolvedRegistryEntry } from "../authoring/types.js";
+import type { ComponentViewRecord } from "../components/manifest_types.js";
+import type { ArtifactView } from "../registry/views.js";
+import type { ComponentRuntime } from "./component_runtime.js";
+import type { LoadedGraph } from "./load_graph.js";
+export interface CompiledDocument {
+    route: string;
+    html: string;
+    view?: ComponentViewRecord;
+    watchDocuments?: readonly (readonly [string, string])[];
+}
+interface DocumentTarget extends ArtifactView {
+    entryId: string;
+    variantId?: string;
+}
+export declare class DocumentCompiler {
+    readonly runtime: ComponentRuntime;
+    private readonly graph;
+    readonly entries: readonly ResolvedRegistryEntry[];
+    readonly routes: Map<string, DocumentTarget>;
+    private readonly compatibility;
+    private readonly components;
+    private readonly prepared;
+    private readonly links;
+    constructor(runtime: ComponentRuntime, graph: LoadedGraph);
+    /** Render and validate just this view plus references required by its contract. */
+    render(route: string, componentProps?: Readonly<Record<string, unknown>>): CompiledDocument;
+    private prepare;
+}
+export {};
+//# sourceMappingURL=document_compiler.d.ts.map

package/dist/build/document_compiler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_compiler.d.ts","sourceRoot":"","sources":["../../src/build/document_compiler.ts"],"names":[],"mappings":"AAAA,6FAA6F;AAC7F,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AASnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAK3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAEzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAG/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAOnD,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,mBAAmB,CAAC;IAC3B,cAAc,CAAC,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;CACzD;AAKD,UAAU,cAAe,SAAQ,YAAY;IAC3C,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,gBAAgB;IAezB,QAAQ,CAAC,OAAO,EAAE,gBAAgB;IAClC,OAAO,CAAC,QAAQ,CAAC,KAAK;IAfxB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;IACnD,QAAQ,CAAC,MAAM,8BAAqC;IACpD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAuB;IACrD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAMvB;IACF,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAwB;gBAGnC,OAAO,EAAE,gBAAgB,EACjB,KAAK,EAAE,WAAW;IAiCrC,mFAAmF;IACnF,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACjD,gBAAgB;IAoCnB,OAAO,CAAC,OAAO;CA0EhB"}

package/dist/build/document_compiler.js

@@ -0,0 +1,130 @@
+import { transformCompatibilityDocuments, } from "../compatibility/transform.js";
+import { validateComponentResources } from "../components/output_validation.js";
+import { validateComponentRanges } from "../components/ranges.js";
+import { rebaseStyleOwnership } from "../components/style_ownership.js";
+import { validateComponentViewRecord } from "../components/view_validation.js";
+import { generatedViews } from "../components/views.js";
+import { MoklyError } from "../errors.js";
+import { extractHtmlReferences } from "../html_references.js";
+import { prepareRegistry } from "../registry/prepare.js";
+import { normalizeSingleDocument } from "../review/ignore.js";
+import { DocumentCache } from "./document_cache.js";
+import { validateHtmlLinks } from "./html_links.js";
+import { validateLogicalFragments } from "./logical_records.js";
+import { validateGeneratedOwnershipHeaders } from "./ownership.js";
+import { validateGeneratedOutputPaths } from "./output_paths.js";
+import { renderFragments } from "./render.js";
+export class DocumentCompiler {
+    runtime;
+    graph;
+    entries;
+    routes = new Map();
+    compatibility;
+    components;
+    prepared = new DocumentCache(32 * 1024 * 1024, (value) => Buffer.byteLength(JSON.stringify({ ...value, anchors: [...value.anchors] })));
+    links;
+    constructor(runtime, graph) {
+        this.runtime = runtime;
+        this.graph = graph;
+        const registry = prepareRegistry(graph.definitions, runtime.config);
+        this.entries = registry.entries;
+        this.compatibility = { byId: registry.byId, routeIndexes: new Map() };
+        this.components = new Map(runtime.manifest.entries.flatMap((entry) => entry.kind === "component" ? [[entry.id, entry]] : []));
+        for (const entry of runtime.manifest.entries) {
+            if (entry.kind === "page")
+                this.routes.set(entry.route, {
+                    entryId: entry.id,
+                    viewport: "desktop",
+                    colorScheme: "light",
+                });
+            for (const view of generatedViews(entry))
+                this.routes.set(view.path, {
+                    entryId: entry.id,
+                    viewport: view.viewport,
+                    colorScheme: view.colorScheme,
+                    ...(view.variantId ? { variantId: view.variantId } : {}),
+                });
+        }
+        this.links = {
+            generatedRoutes: new Set(this.routes.keys()),
+            pendingOrphans: new Set(),
+            parsed: new Map(),
+            readGenerated: (route) => this.prepare(route).html,
+        };
+    }
+    /** Render and validate just this view plus references required by its contract. */
+    render(route, componentProps) {
+        const document = componentProps
+            ? this.prepare(route, componentProps)
+            : this.prepare(route);
+        const outputs = new Map([[route, document.html]]);
+        const observed = new Map();
+        const read = (target) => {
+            const value = target === route ? document : this.prepare(target);
+            if (target !== route)
+                observed.set(target, value.html);
+            return value;
+        };
+        validateLogicalFragments(outputs, document.records, this.entries, this.runtime.config, (target) => read(target).anchors);
+        try {
+            validateHtmlLinks(outputs, this.runtime.config, {
+                ...this.links,
+                readGenerated: (target) => read(target).html,
+            });
+        }
+        finally {
+            // Generated views are resolved from the bounded document cache, never from stale prop edits.
+            for (const target of this.links.parsed.keys())
+                if (this.routes.has(target))
+                    this.links.parsed.delete(target);
+        }
+        return {
+            route,
+            html: document.html,
+            ...(document.view ? { view: document.view } : {}),
+            ...(observed.size ? { watchDocuments: [...observed] } : {}),
+        };
+    }
+    prepare(route, componentProps) {
+        const cached = !componentProps && this.prepared.get(route);
+        if (cached)
+            return cached;
+        const target = this.routes.get(route);
+        if (!target)
+            throw new MoklyError("build-invalid", `unknown generated document: ${route}`);
+        const config = this.runtime.config;
+        validateGeneratedOutputPaths([route], config);
+        const views = new Map();
+        const componentViews = new Map();
+        const outputs = renderFragments(this.entries, this.graph.renderer, config, views, (input, renderer, components) => this.graph.renderWithComponents({ ...input, ...(componentProps ? { componentProps } : {}) }, renderer, components), componentViews, target);
+        const original = outputs.get(route);
+        const records = transformCompatibilityDocuments(outputs, this.entries, config, this.graph, views, [...this.routes.keys()], this.compatibility);
+        const html = outputs.get(route);
+        const entry = this.compatibility.byId.get(target.entryId);
+        validateGeneratedOwnershipHeaders(outputs, new Map([[route, entry.sourceRelativePath]]));
+        normalizeSingleDocument(html, route);
+        const captured = componentViews.get(route);
+        const view = captured
+            ? {
+                ...captured,
+                styles: rebaseStyleOwnership(original, html, captured.styles),
+            }
+            : undefined;
+        if (view) {
+            validateComponentRanges(html, view.ranges);
+            validateComponentViewRecord(view, this.components, route, entry.kind === "component" ? entry.id : undefined);
+            validateComponentResources(new Map([[route, view]]), config);
+        }
+        const prepared = {
+            route,
+            html,
+            records,
+            anchors: extractHtmlReferences(html).anchors,
+            ...(view ? { view } : {}),
+        };
+        if (!componentProps)
+            this.prepared.set(route, prepared);
+        return prepared;
+    }
+}
+//# sourceMappingURL=document_compiler.js.map

package/dist/build/document_compiler.js.map

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

package/dist/build/html_links.d.ts

@@ -0,0 +1,12 @@
+import type { ResolvedConfig } from "../config/types.js";
+import { type ParsedResource } from "../html_link_validation.js";
+/** Generation-scoped lookup for validating a requested document and its resources. */
+export interface HtmlValidationContext {
+    generatedRoutes: ReadonlySet<string>;
+    readGenerated(route: string): string;
+    parsed: Map<string, ParsedResource>;
+    pendingOrphans: ReadonlySet<string>;
+}
+/** Validate navigation links and transitive local resources in generated HTML. */
+export declare function validateHtmlLinks(outputs: ReadonlyMap<string, string>, config: ResolvedConfig, context?: HtmlValidationContext): void;
+//# sourceMappingURL=html_links.d.ts.map

package/dist/build/html_links.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html_links.d.ts","sourceRoot":"","sources":["../../src/build/html_links.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAMzD,OAAO,EAGL,KAAK,cAAc,EAEpB,MAAM,4BAA4B,CAAC;AAQpC,sFAAsF;AACtF,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACrC,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IACrC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACpC,cAAc,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CACrC;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,EACpC,MAAM,EAAE,cAAc,EACtB,OAAO,CAAC,EAAE,qBAAqB,GAC9B,IAAI,CAyDN"}

package/dist/build/html_links.js

@@ -0,0 +1,144 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isPrivateStaticPath, isPublicStaticFile, } from "../config/public_files.js";
+import { isSafeRepositoryPath } from "../config/paths.js";
+import { MoklyError } from "../errors.js";
+import { extractCssReferences, extractHtmlReferences, } from "../html_references.js";
+import { fragmentViolation, htmlResource, } from "../html_link_validation.js";
+import { isOwned, pendingGeneratedOrphanRoutes } from "./ownership.js";
+/** Validate navigation links and transitive local resources in generated HTML. */
+export function validateHtmlLinks(outputs, config, context) {
+    const pendingOrphans = context?.pendingOrphans ??
+        new Set(pendingGeneratedOrphanRoutes(config, outputs.keys()));
+    const parsed = context?.parsed ?? new Map();
+    for (const [route, content] of outputs) {
+        if (isPrivateStaticPath(path.resolve(config.mockupsDir, route), config))
+            continue;
+        parsed.set(route, htmlResource(extractHtmlReferences(content)));
+    }
+    const pending = [...outputs.keys()]
+        .filter((route) => parsed.has(route))
+        .sort();
+    const visited = new Set();
+    const violations = [];
+    while (pending.length > 0) {
+        const route = pending.shift();
+        if (!route || visited.has(route))
+            continue;
+        visited.add(route);
+        const resource = parsed.get(route);
+        if (!resource)
+            continue;
+        for (const reference of resource.references) {
+            const result = validateReference(reference, route, resource, parsed, config, pendingOrphans, context);
+            if (result.violation)
+                violations.push(`${route}: ${result.violation}`);
+            if (result.target &&
+                !visited.has(result.target) &&
+                !pending.includes(result.target)) {
+                const targetResource = parsed.get(result.target) ??
+                    loadResource(result.target, outputs, config, pendingOrphans, context);
+                if (targetResource) {
+                    parsed.set(result.target, targetResource);
+                    pending.push(result.target);
+                    pending.sort();
+                }
+            }
+        }
+    }
+    if (violations.length > 0) {
+        throw new MoklyError("build-invalid", `document links and resources are invalid:\n${violations
+            .sort()
+            .map((item) => `- ${item}`)
+            .join("\n")}`);
+    }
+}
+function validateReference(item, sourceRoute, source, parsed, config, pendingOrphans, context) {
+    const reference = item.value;
+    if (reference === "" || /^(?:https?:|mailto:|tel:|data:)/i.test(reference)) {
+        return {};
+    }
+    if (reference.startsWith("mock:")) {
+        return { violation: `unresolved id link ${reference}` };
+    }
+    if (reference.startsWith("/")) {
+        return { violation: `root-absolute link is not portable: ${reference}` };
+    }
+    if (reference.startsWith("#") || reference.startsWith("?")) {
+        const violation = item.checkFragment
+            ? fragmentViolation(reference, source.anchors)
+            : undefined;
+        return violation ? { violation } : {};
+    }
+    const [withoutHash] = reference.split("#", 2);
+    const rawPath = (withoutHash ?? "").split("?", 1)[0] ?? "";
+    let decodedPath;
+    try {
+        decodedPath = decodeURIComponent(rawPath);
+    }
+    catch {
+        return { violation: `invalid URL encoding: ${reference}` };
+    }
+    if (decodedPath.startsWith("/") || decodedPath.startsWith("\\")) {
+        return { violation: `root-absolute link is not portable: ${reference}` };
+    }
+    const rawTarget = path.posix.normalize(path.posix.join(path.posix.dirname(sourceRoute), decodedPath));
+    if (rawTarget === ".." ||
+        rawTarget.startsWith("../") ||
+        !isSafeRepositoryPath(rawTarget)) {
+        return { violation: `link escapes mockupsDir: ${reference}` };
+    }
+    const target = rawTarget.replace(/^\.\//, "");
+    if (isPrivateStaticPath(path.resolve(config.mockupsDir, target), config))
+        return { violation: `missing target ${reference} (protected file)` };
+    let targetResource = parsed.get(target);
+    if (context?.generatedRoutes.has(target)) {
+        if (item.checkFragment && !reference.includes("#"))
+            return {};
+        targetResource ??= htmlResource(extractHtmlReferences(context.readGenerated(target)));
+        parsed.set(target, targetResource);
+    }
+    if (!targetResource) {
+        targetResource = loadResource(target, new Map(), config, pendingOrphans, context);
+        if (!targetResource)
+            return { violation: `missing target ${reference}` };
+        parsed.set(target, targetResource);
+    }
+    const violation = item.checkFragment
+        ? fragmentViolation(reference, targetResource.anchors)
+        : undefined;
+    if (violation)
+        return { violation };
+    return context && item.checkFragment ? {} : { target };
+}
+function loadResource(route, outputs, config, pendingOrphans, context) {
+    const candidate = path.resolve(config.mockupsDir, route);
+    if (isPrivateStaticPath(candidate, config))
+        return undefined;
+    if (context &&
+        !context.generatedRoutes.has(route) &&
+        isOwned(candidate, config))
+        return undefined;
+    const generated = outputs.get(route);
+    if (generated !== undefined)
+        return htmlResource(extractHtmlReferences(generated));
+    if (pendingOrphans.has(route))
+        return undefined;
+    if (!isPublicStaticFile(candidate, config))
+        return undefined;
+    const extension = path.posix.extname(route).toLowerCase();
+    if (extension !== ".css" && extension !== ".html" && extension !== ".htm") {
+        return { anchors: new Set(), references: [] };
+    }
+    const content = fs.readFileSync(candidate, "utf8");
+    return extension === ".css"
+        ? {
+            anchors: new Set(),
+            references: extractCssReferences(content).map((value) => ({
+                checkFragment: false,
+                value,
+            })),
+        }
+        : htmlResource(extractHtmlReferences(content));
+}
+//# sourceMappingURL=html_links.js.map

package/dist/build/html_links.js.map

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

package/dist/build/link_control_metadata.d.ts

@@ -0,0 +1,20 @@
+/** Parsed ownership rules shared by child adaptation and compatibility output. */
+import { type ControlElement, type ControlNode } from "./link_control_nodes.js";
+interface MetadataOwner {
+    inTemplate: boolean;
+    node: ControlElement;
+}
+interface ParsedControlMetadata {
+    document: ControlNode;
+    duplicateOffsets: readonly number[];
+    markers: readonly ControlElement[];
+    owners: readonly MetadataOwner[];
+}
+/** Locate real reserved attributes, ignoring matching text and attribute values. */
+export declare function parseControlMetadata(html: string, route: string): ParsedControlMetadata | undefined;
+/** Compatibility output must not reintroduce unresolved authoring markers. */
+export declare function assertNoChildLinkMarkers(html: string, route: string): void;
+/** Preserve generated metadata and its logical owner across migration edits. */
+export declare function validateControlMetadata(original: string, transformed: string, route: string): void;
+export {};
+//# sourceMappingURL=link_control_metadata.d.ts.map

package/dist/build/link_control_metadata.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link_control_metadata.d.ts","sourceRoot":"","sources":["../../src/build/link_control_metadata.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAIlF,OAAO,EAML,KAAK,cAAc,EACnB,KAAK,WAAW,EACjB,MAAM,yBAAyB,CAAC;AAEjC,UAAU,aAAa;IACrB,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,cAAc,CAAC;CACtB;AAED,UAAU,qBAAqB;IAC7B,QAAQ,EAAE,WAAW,CAAC;IACtB,gBAAgB,EAAE,SAAS,MAAM,EAAE,CAAC;IACpC,OAAO,EAAE,SAAS,cAAc,EAAE,CAAC;IACnC,MAAM,EAAE,SAAS,aAAa,EAAE,CAAC;CAClC;AAED,oFAAoF;AACpF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,qBAAqB,GAAG,SAAS,CAuCnC;AAED,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAG1E;AAED,gFAAgF;AAChF,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,MAAM,GACZ,IAAI,CASN"}

package/dist/build/link_control_metadata.js

@@ -0,0 +1,79 @@
+/** Parsed ownership rules shared by child adaptation and compatibility output. */
+import { parse } from "parse5";
+import { attribute, CHILD_MARKER, CONTROL_MARKER, controlError, isElement, } from "./link_control_nodes.js";
+/** Locate real reserved attributes, ignoring matching text and attribute values. */
+export function parseControlMetadata(html, route) {
+    if (!/data-mokly-link-(?:child-|control)/i.test(html))
+        return undefined;
+    const duplicateOffsets = [];
+    const document = parse(html, {
+        sourceCodeLocationInfo: true,
+        onParseError: (error) => {
+            if (error.code === "duplicate-attribute")
+                duplicateOffsets.push(error.startOffset);
+        },
+    });
+    const markers = [];
+    const owners = [];
+    const visit = (node, inTemplate = false) => {
+        if (isElement(node)) {
+            const hasMarker = node.attrs.some((attr) => attr.name.startsWith(CHILD_MARKER));
+            const ownsMetadata = node.attrs.some((attr) => attr.name.startsWith(CONTROL_MARKER));
+            const start = node.sourceCodeLocation?.startTag;
+            if ((hasMarker || ownsMetadata) &&
+                start &&
+                duplicateOffsets.some((offset) => offset >= start.startOffset && offset <= start.endOffset)) {
+                throw controlError(route, "contains duplicate reserved metadata");
+            }
+            if (hasMarker)
+                markers.push(node);
+            if (ownsMetadata)
+                owners.push({ inTemplate, node });
+            if ("content" in node)
+                visit(node.content, true);
+        }
+        if ("childNodes" in node)
+            node.childNodes.forEach((child) => visit(child, inTemplate));
+    };
+    visit(document);
+    return { document, duplicateOffsets, markers, owners };
+}
+/** Compatibility output must not reintroduce unresolved authoring markers. */
+export function assertNoChildLinkMarkers(html, route) {
+    if (parseControlMetadata(html, route)?.markers.length)
+        throw controlError(route, "has unconsumed markers");
+}
+/** Preserve generated metadata and its logical owner across migration edits. */
+export function validateControlMetadata(original, transformed, route) {
+    const expected = metadataRecords(original, route);
+    const actual = metadataRecords(transformed, route);
+    if (expected.length !== actual.length ||
+        expected.some((record, index) => record !== actual[index])) {
+        throw controlError(route, "changed reserved adaptation metadata records");
+    }
+}
+function metadataRecords(html, route) {
+    const parsed = parseControlMetadata(html, route);
+    if (parsed?.markers.length)
+        throw controlError(route, "has unconsumed markers");
+    return (parsed?.owners ?? [])
+        .map(({ node, inTemplate }) => JSON.stringify({
+        inTemplate,
+        namespace: node.namespaceURI,
+        tag: node.tagName,
+        attributes: node.attrs
+            .filter((attr) => attr.name.startsWith(CONTROL_MARKER) ||
+            ["id", "href", "data-nav-href", "data-mokly-link"].includes(attr.name))
+            .map(({ name, value }) => ({ name, value }))
+            .sort((left, right) => left.name.localeCompare(right.name)),
+        ...(attribute(node, `${CONTROL_MARKER}-styles`) === undefined
+            ? {}
+            : {
+                stylesheet: node.childNodes
+                    .map((child) => ("value" in child ? child.value : ""))
+                    .join(""),
+            }),
+    }))
+        .sort();
+}
+//# sourceMappingURL=link_control_metadata.js.map

package/dist/build/link_control_metadata.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"link_control_metadata.js","sourceRoot":"","sources":["../../src/build/link_control_metadata.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,KAAK,EAAE,MAAM,QAAQ,CAAC;AAE/B,OAAO,EACL,SAAS,EACT,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,SAAS,GAGV,MAAM,yBAAyB,CAAC;AAcjC,oFAAoF;AACpF,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,KAAa;IAEb,IAAI,CAAC,qCAAqC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACxE,MAAM,gBAAgB,GAAa,EAAE,CAAC;IACtC,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,EAAE;QAC3B,sBAAsB,EAAE,IAAI;QAC5B,YAAY,EAAE,CAAC,KAAK,EAAE,EAAE;YACtB,IAAI,KAAK,CAAC,IAAI,KAAK,qBAAqB;gBACtC,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;QAC7C,CAAC;KACF,CAAC,CAAC;IACH,MAAM,OAAO,GAAqB,EAAE,CAAC;IACrC,MAAM,MAAM,GAAoB,EAAE,CAAC;IACnC,MAAM,KAAK,GAAG,CAAC,IAAiB,EAAE,UAAU,GAAG,KAAK,EAAQ,EAAE;QAC5D,IAAI,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YACpB,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CACzC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,CACnC,CAAC;YACF,MAAM,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAC5C,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,CACrC,CAAC;YACF,MAAM,KAAK,GAAG,IAAI,CAAC,kBAAkB,EAAE,QAAQ,CAAC;YAChD,IACE,CAAC,SAAS,IAAI,YAAY,CAAC;gBAC3B,KAAK;gBACL,gBAAgB,CAAC,IAAI,CACnB,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,IAAI,KAAK,CAAC,WAAW,IAAI,MAAM,IAAI,KAAK,CAAC,SAAS,CACrE,EACD,CAAC;gBACD,MAAM,YAAY,CAAC,KAAK,EAAE,sCAAsC,CAAC,CAAC;YACpE,CAAC;YACD,IAAI,SAAS;gBAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,IAAI,YAAY;gBAAE,MAAM,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,IAAI,SAAS,IAAI,IAAI;gBAAE,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;QACnD,CAAC;QACD,IAAI,YAAY,IAAI,IAAI;YACtB,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC;IACF,KAAK,CAAC,QAAQ,CAAC,CAAC;IAChB,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC;AACzD,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,wBAAwB,CAAC,IAAY,EAAE,KAAa;IAClE,IAAI,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,MAAM;QACnD,MAAM,YAAY,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;AACxD,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,uBAAuB,CACrC,QAAgB,EAChB,WAAmB,EACnB,KAAa;IAEb,MAAM,QAAQ,GAAG,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IAClD,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;IACnD,IACE,QAAQ,CAAC,MAAM,KAAK,MAAM,CAAC,MAAM;QACjC,QAAQ,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,KAAK,CAAC,CAAC,EAC1D,CAAC;QACD,MAAM,YAAY,CAAC,KAAK,EAAE,8CAA8C,CAAC,CAAC;IAC5E,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,IAAY,EAAE,KAAa;IAClD,MAAM,MAAM,GAAG,oBAAoB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACjD,IAAI,MAAM,EAAE,OAAO,CAAC,MAAM;QACxB,MAAM,YAAY,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;IACtD,OAAO,CAAC,MAAM,EAAE,MAAM,IAAI,EAAE,CAAC;SAC1B,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,EAAE,CAC5B,IAAI,CAAC,SAAS,CAAC;QACb,UAAU;QACV,SAAS,EAAE,IAAI,CAAC,YAAY;QAC5B,GAAG,EAAE,IAAI,CAAC,OAAO;QACjB,UAAU,EAAE,IAAI,CAAC,KAAK;aACnB,MAAM,CACL,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC;YACpC,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,iBAAiB,CAAC,CAAC,QAAQ,CACzD,IAAI,CAAC,IAAI,CACV,CACJ;aACA,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;aAC3C,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7D,GAAG,CAAC,SAAS,CAAC,IAAI,EAAE,GAAG,cAAc,SAAS,CAAC,KAAK,SAAS;YAC3D,CAAC,CAAC,EAAE;YACJ,CAAC,CAAC;gBACE,UAAU,EAAE,IAAI,CAAC,UAAU;qBACxB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;qBACrD,IAAI,CAAC,EAAE,CAAC;aACZ,CAAC;KACP,CAAC,CACH;SACA,IAAI,EAAE,CAAC;AACZ,CAAC"}

package/dist/build/link_control_nodes.d.ts

@@ -0,0 +1,15 @@
+/** HTML structure and activation rules for explicitly adapted link controls. */
+import type { DefaultTreeAdapterMap } from "parse5";
+import { MoklyError } from "../errors.js";
+export type ControlNode = DefaultTreeAdapterMap["node"];
+export type ControlElement = DefaultTreeAdapterMap["element"];
+export declare const CHILD_MARKER = "data-mokly-link-child-";
+export declare const CONTROL_MARKER = "data-mokly-link-control";
+export declare function controlError(route: string, detail: string): MoklyError;
+export declare function attribute(node: ControlElement, name: string): string | undefined;
+export declare function isElement(node: ControlNode): node is ControlElement;
+export declare function isInteractive(node: ControlElement): boolean;
+export declare function isInactive(node: ControlElement, ownControl?: boolean): boolean;
+/** Require one supported root and no independent descendant interactions. */
+export declare function validateControl(node: ControlElement, target: string, route: string): void;
+//# sourceMappingURL=link_control_nodes.d.ts.map

package/dist/build/link_control_nodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link_control_nodes.d.ts","sourceRoot":"","sources":["../../src/build/link_control_nodes.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,QAAQ,CAAC;AAEpD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,MAAM,MAAM,WAAW,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;AACxD,MAAM,MAAM,cAAc,GAAG,qBAAqB,CAAC,SAAS,CAAC,CAAC;AAE9D,eAAO,MAAM,YAAY,2BAA2B,CAAC;AACrD,eAAO,MAAM,cAAc,4BAA4B,CAAC;AA2CxD,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAKtE;AAED,wBAAgB,SAAS,CACvB,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAEpB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,IAAI,IAAI,cAAc,CAEnE;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAY3D;AAED,wBAAgB,UAAU,CAAC,IAAI,EAAE,cAAc,EAAE,UAAU,UAAQ,GAAG,OAAO,CAQ5E;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAC7B,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,GACZ,IAAI,CAoCN"}

package/dist/build/link_control_nodes.js

@@ -0,0 +1,106 @@
+/** HTML structure and activation rules for explicitly adapted link controls. */
+import { MoklyError } from "../errors.js";
+export const CHILD_MARKER = "data-mokly-link-child-";
+export const CONTROL_MARKER = "data-mokly-link-control";
+const HTML_NAMESPACE = "http://www.w3.org/1999/xhtml";
+const INTERACTIVE_TAGS = new Set([
+    "a",
+    "area",
+    "button",
+    "input",
+    "select",
+    "textarea",
+    "summary",
+    "details",
+    "iframe",
+    "object",
+    "embed",
+    "label",
+]);
+const INTERACTIVE_ROLES = new Set([
+    "button",
+    "link",
+    "checkbox",
+    "combobox",
+    "gridcell",
+    "listbox",
+    "menu",
+    "menubar",
+    "menuitem",
+    "menuitemcheckbox",
+    "menuitemradio",
+    "option",
+    "radio",
+    "radiogroup",
+    "searchbox",
+    "slider",
+    "spinbutton",
+    "switch",
+    "tab",
+    "tablist",
+    "textbox",
+    "tree",
+    "treegrid",
+    "treeitem",
+]);
+export function controlError(route, detail) {
+    return new MoklyError("build-invalid", `${route}: MockLink child control ${detail}`);
+}
+export function attribute(node, name) {
+    return node.attrs.find((candidate) => candidate.name === name)?.value;
+}
+export function isElement(node) {
+    return "tagName" in node;
+}
+export function isInteractive(node) {
+    return (INTERACTIVE_TAGS.has(node.tagName) ||
+        attribute(node, "tabindex") !== undefined ||
+        (attribute(node, "contenteditable") !== undefined &&
+            attribute(node, "contenteditable") !== "false") ||
+        (attribute(node, "role") ?? "")
+            .split(/\s+/)
+            .some((role) => INTERACTIVE_ROLES.has(role)) ||
+        (["audio", "video"].includes(node.tagName) &&
+            attribute(node, "controls") !== undefined));
+}
+export function isInactive(node, ownControl = false) {
+    return (attribute(node, "inert") !== undefined ||
+        attribute(node, "aria-disabled")?.toLowerCase() === "true" ||
+        attribute(node, "aria-busy")?.toLowerCase() === "true" ||
+        ((ownControl || node.tagName === "fieldset") &&
+            attribute(node, "disabled") !== undefined));
+}
+/** Require one supported root and no independent descendant interactions. */
+export function validateControl(node, target, route) {
+    if (node.namespaceURI !== HTML_NAMESPACE ||
+        !["a", "button", "div", "span"].includes(node.tagName)) {
+        throw controlError(route, "requires an HTML a, button, div, or span root");
+    }
+    const role = attribute(node, "role");
+    if (role !== undefined && role !== "button" && role !== "link") {
+        throw controlError(route, `cannot replace role ${role}`);
+    }
+    if (attribute(node, "contenteditable") !== undefined &&
+        attribute(node, "contenteditable") !== "false") {
+        throw controlError(route, "cannot be editable");
+    }
+    for (const attr of node.attrs) {
+        if (attr.name.startsWith("on"))
+            throw controlError(route, "cannot have inline event handlers");
+        if (["href", "data-nav-href"].includes(attr.name) &&
+            attr.value !== target) {
+            throw controlError(route, "has conflicting destinations");
+        }
+    }
+    const inspect = (child) => {
+        if (!isElement(child))
+            return;
+        if (child.attrs.some((attr) => attr.name.startsWith("on")))
+            throw controlError(route, "contains inline event handlers");
+        if (isInteractive(child))
+            throw controlError(route, "contains another interactive control");
+        child.childNodes.forEach(inspect);
+    };
+    node.childNodes.forEach(inspect);
+}
+//# sourceMappingURL=link_control_nodes.js.map

package/dist/build/link_control_nodes.js.map

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

package/dist/build/link_control_patches.d.ts

@@ -0,0 +1,12 @@
+/** Source-preserving HTML patches and static focus styling for child links. */
+import { type ControlElement } from "./link_control_nodes.js";
+export interface ControlPatch {
+    end: number;
+    start: number;
+    text: string;
+}
+export declare const CONTROL_STYLES: string;
+export declare function applyControlPatches(html: string, patches: readonly ControlPatch[]): string;
+/** Replace only the control's tags; preserve all applicable original attributes. */
+export declare function controlPatches(html: string, node: ControlElement, target: string, inactive: boolean, route: string): ControlPatch[];
+//# sourceMappingURL=link_control_patches.d.ts.map

package/dist/build/link_control_patches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link_control_patches.d.ts","sourceRoot":"","sources":["../../src/build/link_control_patches.ts"],"names":[],"mappings":"AAAA,+EAA+E;AAE/E,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,eAAO,MAAM,cAAc,QAMf,CAAC;AAkBb,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,SAAS,YAAY,EAAE,GAC/B,MAAM,CASR;AAED,oFAAoF;AACpF,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,OAAO,EACjB,KAAK,EAAE,MAAM,GACZ,YAAY,EAAE,CAwChB"}