@mokly/mokly 0.8.0

package/dist/navigation/reserved_attributes.d.ts

@@ -0,0 +1,17 @@
+/** Raw HTML scanning for Mokly-owned navigation metadata. */
+/** A byte range within an HTML source string. */
+export interface HtmlSourceLocation {
+    readonly endOffset: number;
+    readonly startOffset: number;
+}
+/** An occurrence of a reserved navigation attribute in a start tag. */
+export interface ReservedAttributeOccurrence extends HtmlSourceLocation {
+    readonly name: ReservedAttributeName;
+}
+/** Attribute names whose values are owned by Mokly. */
+export type ReservedAttributeName = "data-mokly-link" | "data-mokly-target";
+/** Find every reserved attribute, including duplicates hidden by HTML parsing. */
+export declare function reservedAttributesInStartTag(content: string, startTag: HtmlSourceLocation | undefined): readonly ReservedAttributeOccurrence[];
+/** Return the first reserved name occurring more than once in one start tag. */
+export declare function duplicateReservedAttributeName(content: string, startTag: HtmlSourceLocation | undefined): ReservedAttributeName | undefined;
+//# sourceMappingURL=reserved_attributes.d.ts.map

package/dist/navigation/reserved_attributes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reserved_attributes.d.ts","sourceRoot":"","sources":["../../src/navigation/reserved_attributes.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAE7D,iDAAiD;AACjD,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,uEAAuE;AACvE,MAAM,WAAW,2BAA4B,SAAQ,kBAAkB;IACrE,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;CACtC;AAED,uDAAuD;AACvD,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,GAAG,mBAAmB,CAAC;AAO5E,kFAAkF;AAClF,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GACvC,SAAS,2BAA2B,EAAE,CAiDxC;AAED,gFAAgF;AAChF,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,kBAAkB,GAAG,SAAS,GACvC,qBAAqB,GAAG,SAAS,CAOnC"}

package/dist/navigation/reserved_attributes.js

@@ -0,0 +1,85 @@
+/** Raw HTML scanning for Mokly-owned navigation metadata. */
+const RESERVED_ATTRIBUTES = new Set([
+    "data-mokly-link",
+    "data-mokly-target",
+]);
+/** Find every reserved attribute, including duplicates hidden by HTML parsing. */
+export function reservedAttributesInStartTag(content, startTag) {
+    if (!startTag)
+        return [];
+    const occurrences = [];
+    let cursor = startTag.startOffset + 1;
+    while (cursor < startTag.endOffset && !isNameTerminator(content[cursor])) {
+        cursor += 1;
+    }
+    while (cursor < startTag.endOffset) {
+        while (isHtmlWhitespace(content[cursor]))
+            cursor += 1;
+        if (content[cursor] === ">")
+            break;
+        if (content[cursor] === "/") {
+            cursor += 1;
+            continue;
+        }
+        const startOffset = cursor;
+        while (cursor < startTag.endOffset && !isNameTerminator(content[cursor])) {
+            cursor += 1;
+        }
+        if (cursor === startOffset) {
+            cursor += 1;
+            continue;
+        }
+        const name = content.slice(startOffset, cursor).toLowerCase();
+        while (isHtmlWhitespace(content[cursor]))
+            cursor += 1;
+        if (content[cursor] === "=") {
+            cursor += 1;
+            while (isHtmlWhitespace(content[cursor]))
+                cursor += 1;
+            const quote = content[cursor];
+            if (quote === '"' || quote === "'") {
+                cursor += 1;
+                while (cursor < startTag.endOffset && content[cursor] !== quote) {
+                    cursor += 1;
+                }
+                if (content[cursor] === quote)
+                    cursor += 1;
+            }
+            else {
+                while (cursor < startTag.endOffset &&
+                    !isHtmlWhitespace(content[cursor]) &&
+                    content[cursor] !== ">") {
+                    cursor += 1;
+                }
+            }
+        }
+        if (isReservedAttributeName(name)) {
+            occurrences.push({ endOffset: cursor, name, startOffset });
+        }
+    }
+    return occurrences;
+}
+/** Return the first reserved name occurring more than once in one start tag. */
+export function duplicateReservedAttributeName(content, startTag) {
+    const seen = new Set();
+    for (const occurrence of reservedAttributesInStartTag(content, startTag)) {
+        if (seen.has(occurrence.name))
+            return occurrence.name;
+        seen.add(occurrence.name);
+    }
+    return undefined;
+}
+function isReservedAttributeName(value) {
+    return RESERVED_ATTRIBUTES.has(value);
+}
+function isHtmlWhitespace(value) {
+    return value !== undefined && /[\t\n\f\r ]/.test(value);
+}
+function isNameTerminator(value) {
+    return (value === undefined ||
+        isHtmlWhitespace(value) ||
+        value === "/" ||
+        value === ">" ||
+        value === "=");
+}
+//# sourceMappingURL=reserved_attributes.js.map

package/dist/navigation/reserved_attributes.js.map

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

package/dist/navigation/target.d.ts

@@ -0,0 +1,20 @@
+/** A strictly parsed browsing-context request. */
+export type BrowsingTarget = {
+    kind: "blank";
+} | {
+    kind: "invalid";
+} | {
+    kind: "named";
+    name: string;
+} | {
+    kind: "parent";
+} | {
+    kind: "self";
+} | {
+    kind: "top";
+};
+/** Parse a live or derived target without trimming or browser inference. */
+export declare function parseBrowsingTarget(value: string | null | undefined): BrowsingTarget;
+/** Serialize a valid non-self target for trusted inert metadata. */
+export declare function serializeBrowsingTarget(target: BrowsingTarget): string | undefined;
+//# sourceMappingURL=target.d.ts.map

package/dist/navigation/target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.d.ts","sourceRoot":"","sources":["../../src/navigation/target.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,MAAM,MAAM,cAAc,GACtB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,QAAQ,CAAA;CAAE,GAClB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,KAAK,CAAA;CAAE,CAAC;AAIpB,4EAA4E;AAC5E,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,cAAc,CAWhB;AAED,oEAAoE;AACpE,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,GACrB,MAAM,GAAG,SAAS,CAMpB"}

package/dist/navigation/target.js

@@ -0,0 +1,32 @@
+const NAMED_TARGET_PATTERN = /^[A-Za-z0-9][A-Za-z0-9._:-]*$/;
+/** Parse a live or derived target without trimming or browser inference. */
+export function parseBrowsingTarget(value) {
+    if (value === undefined || value === null || value === "") {
+        return { kind: "self" };
+    }
+    const keyword = value.toLowerCase();
+    if (keyword === "_self")
+        return { kind: "self" };
+    if (keyword === "_top")
+        return { kind: "top" };
+    if (keyword === "_parent")
+        return { kind: "parent" };
+    if (keyword === "_blank")
+        return { kind: "blank" };
+    if (NAMED_TARGET_PATTERN.test(value))
+        return { kind: "named", name: value };
+    return { kind: "invalid" };
+}
+/** Serialize a valid non-self target for trusted inert metadata. */
+export function serializeBrowsingTarget(target) {
+    if (target.kind === "top")
+        return "_top";
+    if (target.kind === "parent")
+        return "_parent";
+    if (target.kind === "blank")
+        return "_blank";
+    if (target.kind === "named")
+        return target.name;
+    return undefined;
+}
+//# sourceMappingURL=target.js.map

package/dist/navigation/target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target.js","sourceRoot":"","sources":["../../src/navigation/target.ts"],"names":[],"mappings":"AASA,MAAM,oBAAoB,GAAG,+BAA+B,CAAC;AAE7D,4EAA4E;AAC5E,MAAM,UAAU,mBAAmB,CACjC,KAAgC;IAEhC,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,EAAE,EAAE,CAAC;QAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IAC1B,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IACpC,IAAI,OAAO,KAAK,OAAO;QAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACjD,IAAI,OAAO,KAAK,MAAM;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC/C,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACrD,IAAI,OAAO,KAAK,QAAQ;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACnD,IAAI,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC5E,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC;AAC7B,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,uBAAuB,CACrC,MAAsB;IAEtB,IAAI,MAAM,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,MAAM,CAAC;IACzC,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC/C,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,QAAQ,CAAC;IAC7C,IAAI,MAAM,CAAC,IAAI,KAAK,OAAO;QAAE,OAAO,MAAM,CAAC,IAAI,CAAC;IAChD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/publication/files.d.ts

@@ -0,0 +1,24 @@
+import { type FileLocation } from "../config/file_locations.js";
+import type { ResolvedConfig } from "../config/types.js";
+/** A confined file, or link metadata whose target must not be read. */
+export type PublicationFile = {
+    kind: "file";
+    path: string;
+    location: FileLocation;
+    link?: string;
+} | {
+    kind: "link";
+    path: string;
+    link: string;
+};
+/** Enumerate logical routes while checking every target before reading or traversal. */
+export declare function publicationFiles(config: ResolvedConfig, root: string, excludedRoots: readonly string[], publicRoot?: boolean): Promise<PublicationFile[]>;
+/** Require explicit metadata and authoring inputs to be confined regular files. */
+export declare function publicationInput(file: string, repoRoot: string): Promise<PublicationFile & {
+    kind: "file";
+}>;
+/** Revalidate the captured identity and read only its confined physical location. */
+export declare function readPublicationFile(file: PublicationFile & {
+    kind: "file";
+}, repoRoot: string): Promise<Buffer>;
+//# sourceMappingURL=files.d.ts.map

package/dist/publication/files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/publication/files.ts"],"names":[],"mappings":"AAGA,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAE5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,uEAAuE;AACvE,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,GACrE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,wFAAwF;AACxF,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,SAAS,MAAM,EAAE,EAChC,UAAU,UAAQ,GACjB,OAAO,CAAC,eAAe,EAAE,CAAC,CA6D5B;AAED,mFAAmF;AACnF,wBAAsB,gBAAgB,CACpC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC,CAa7C;AAED,qFAAqF;AACrF,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,eAAe,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAQjB"}

package/dist/publication/files.js

@@ -0,0 +1,114 @@
+import fs from "node:fs";
+import path from "node:path";
+import { locatePath } from "../config/file_locations.js";
+import { isInside, projectRealPath } from "../config/paths.js";
+/** Enumerate logical routes while checking every target before reading or traversal. */
+export async function publicationFiles(config, root, excludedRoots, publicRoot = false) {
+    const excluded = excludedRoots.flatMap((file) => [
+        file,
+        projectRealPath(file),
+    ]);
+    const realRepoRoot = fs.realpathSync(config.repoRoot);
+    const files = [];
+    function excludedPath(file) {
+        const parts = path.relative(config.repoRoot, file).split(path.sep);
+        return (excluded.some((directory) => isInside(directory, file)) ||
+            parts.includes(".git") ||
+            (!publicRoot &&
+                parts.some((part) => [".context", "node_modules", "target"].includes(part))) ||
+            isComparisonPath(file, config));
+    }
+    async function visit(directory, ancestors) {
+        const location = locatePath(directory, config.repoRoot);
+        if (!location)
+            throw inputError(directory);
+        if (ancestors.has(location.physicalPath))
+            return;
+        const nextAncestors = new Set([...ancestors, location.physicalPath]);
+        const entries = await fs.promises.readdir(location.physicalPath, {
+            withFileTypes: true,
+        });
+        entries.sort((left, right) => left.name.localeCompare(right.name));
+        for (const entry of entries) {
+            const file = path.join(directory, entry.name);
+            if (excludedPath(file))
+                continue;
+            const target = locatePath(file, config.repoRoot);
+            if (target &&
+                (excludedPath(target.physicalPath) ||
+                    hasArtifactMarker(target.physicalPath, realRepoRoot)))
+                continue;
+            if (entry.isSymbolicLink()) {
+                const link = await fs.promises.readlink(file);
+                const stat = target
+                    ? await fs.promises.stat(target.physicalPath)
+                    : undefined;
+                if (target && stat?.isFile())
+                    files.push({ kind: "file", path: file, location: target, link });
+                else {
+                    files.push({ kind: "link", path: file, link });
+                    if (stat?.isDirectory())
+                        await visit(file, nextAncestors);
+                }
+            }
+            else if (entry.isDirectory())
+                await visit(file, nextAncestors);
+            else if (entry.isFile()) {
+                if (!target)
+                    throw inputError(file);
+                files.push({ kind: "file", path: file, location: target });
+            }
+        }
+    }
+    await visit(root, new Set());
+    return files;
+}
+/** Require explicit metadata and authoring inputs to be confined regular files. */
+export async function publicationInput(file, repoRoot) {
+    const location = locatePath(file, repoRoot);
+    if (!location || !(await fs.promises.stat(location.physicalPath)).isFile())
+        throw inputError(file);
+    const stat = await fs.promises.lstat(file);
+    return {
+        kind: "file",
+        path: file,
+        location,
+        ...(stat.isSymbolicLink()
+            ? { link: await fs.promises.readlink(file) }
+            : {}),
+    };
+}
+/** Revalidate the captured identity and read only its confined physical location. */
+export async function readPublicationFile(file, repoRoot) {
+    const current = await publicationInput(file.path, repoRoot);
+    if (current.location.physicalPath !== file.location.physicalPath ||
+        current.link !== file.link)
+        throw new Error(`publication input changed location: ${file.path}`);
+    return fs.promises.readFile(current.location.physicalPath);
+}
+/** Exclude previously generated artifacts from both logical and physical walks. */
+function isComparisonPath(file, config) {
+    if (isInside(config.review.outDir, file) ||
+        isInside(projectRealPath(config.review.outDir), file))
+        return true;
+    const parts = path.relative(config.mockupsDir, file).split(path.sep);
+    return (parts.includes(".comparisons") ||
+        (parts.includes("__mokly") && parts.includes("diffs")));
+}
+/** Inspect artifact ownership only after the path is physically confined. */
+function hasArtifactMarker(file, repoRoot) {
+    let directory = file;
+    while (isInside(repoRoot, directory)) {
+        if (fs.existsSync(path.join(directory, ".mokly-review-artifact")) ||
+            fs.existsSync(path.join(directory, ".mokly-preview-artifact")))
+            return true;
+        if (directory === repoRoot)
+            break;
+        directory = path.dirname(directory);
+    }
+    return false;
+}
+function inputError(file) {
+    return new Error(`publication input must be a confined regular file inside repoRoot: ${file}`);
+}
+//# sourceMappingURL=files.js.map

package/dist/publication/files.js.map

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

package/dist/publication/options.d.ts

@@ -0,0 +1,16 @@
+/** Explicit capability boundary for repository-owned static publication. */
+export type PublicationOptions = {
+    includeChanges?: false;
+    base?: never;
+} | {
+    includeChanges: true;
+    base?: string;
+};
+/** Validate JavaScript callers before loading or capturing consumer content. */
+export declare function publicationOptions(value?: unknown): PublicationOptions;
+/** Parse repository preview arguments independently of config evaluation. */
+export declare function publicationArguments(args: readonly string[]): {
+    options: PublicationOptions;
+    output?: string;
+};
+//# sourceMappingURL=options.d.ts.map

package/dist/publication/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/publication/options.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,MAAM,MAAM,kBAAkB,GAC1B;IAAE,cAAc,CAAC,EAAE,KAAK,CAAC;IAAC,IAAI,CAAC,EAAE,KAAK,CAAA;CAAE,GACxC;IAAE,cAAc,EAAE,IAAI,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5C,gFAAgF;AAChF,wBAAgB,kBAAkB,CAAC,KAAK,GAAE,OAAY,GAAG,kBAAkB,CA2B1E;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG;IAC7D,OAAO,EAAE,kBAAkB,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CA+BA"}

package/dist/publication/options.js

@@ -0,0 +1,59 @@
+/** Validate JavaScript callers before loading or capturing consumer content. */
+export function publicationOptions(value = {}) {
+    if (typeof value !== "object" || value === null || Array.isArray(value))
+        throw new Error("publication options must be an object");
+    const options = value;
+    if (Object.keys(options).some((key) => key !== "includeChanges" && key !== "base") ||
+        (Object.hasOwn(options, "includeChanges") &&
+            typeof options["includeChanges"] !== "boolean"))
+        throw new Error("invalid publication options");
+    if (options["includeChanges"] !== true) {
+        if (Object.hasOwn(options, "base"))
+            throw new Error("base requires includeChanges");
+        return { includeChanges: false };
+    }
+    const base = options["base"];
+    if (Object.hasOwn(options, "base") &&
+        (typeof base !== "string" || base.trim() === ""))
+        throw new Error("base must be a nonempty Git reference");
+    return {
+        includeChanges: true,
+        ...(typeof base === "string" ? { base } : {}),
+    };
+}
+/** Parse repository preview arguments independently of config evaluation. */
+export function publicationArguments(args) {
+    const seen = new Set();
+    let includeChanges = false;
+    let base;
+    let output;
+    const invalid = () => new Error("usage: node scripts/preview/build.mjs [--include-changes [--base <ref>]] [--out <path>]");
+    for (let index = 0; index < args.length; index += 1) {
+        const flag = args[index];
+        if (!flag || seen.has(flag))
+            throw invalid();
+        seen.add(flag);
+        if (flag === "--include-changes") {
+            includeChanges = true;
+            continue;
+        }
+        if (flag !== "--base" && flag !== "--out")
+            throw invalid();
+        const value = args[++index];
+        if (!value || value.startsWith("--") || value.trim() === "")
+            throw invalid();
+        if (flag === "--base")
+            base = value;
+        else
+            output = value;
+    }
+    if (base !== undefined && !includeChanges)
+        throw invalid();
+    return {
+        options: includeChanges
+            ? { includeChanges, ...(base === undefined ? {} : { base }) }
+            : {},
+        ...(output === undefined ? {} : { output }),
+    };
+}
+//# sourceMappingURL=options.js.map

package/dist/publication/options.js.map

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

package/dist/publication/resources.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedConfig } from "../config/types.js";
+import type { Catalogue } from "../server/catalogue.js";
+/** Materialize public aliases as regular files and validate their exported resources. */
+export declare function copyPublicFiles(config: ResolvedConfig, catalogue: Catalogue, stage: string, excludedRoots: readonly string[]): Promise<void>;
+//# sourceMappingURL=resources.d.ts.map

package/dist/publication/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../src/publication/resources.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGxD,yFAAyF;AACzF,wBAAsB,eAAe,CACnC,MAAM,EAAE,cAAc,EACtB,SAAS,EAAE,SAAS,EACpB,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,SAAS,MAAM,EAAE,GAC/B,OAAO,CAAC,IAAI,CAAC,CAsCf"}

package/dist/publication/resources.js

@@ -0,0 +1,73 @@
+import fs from "node:fs";
+import path from "node:path";
+import { adaptBrowseDocument } from "../browse/document_adapter.js";
+import { locatePath } from "../config/file_locations.js";
+import { publicFileLocation } from "../config/public_files.js";
+import { referencedRoutes } from "../review/asset_references.js";
+import { publicationFiles, readPublicationFile } from "./files.js";
+/** Materialize public aliases as regular files and validate their exported resources. */
+export async function copyPublicFiles(config, catalogue, stage, excludedRoots) {
+    const root = path.join(stage, "static");
+    const copied = new Set();
+    const files = await publicationFiles(config, config.mockupsDir, excludedRoots, true);
+    for (const file of files) {
+        if (file.kind !== "file")
+            continue;
+        const location = publicFileLocation(file.path, config);
+        if (!location)
+            continue;
+        const relative = location.relativePath;
+        const target = path.join(root, relative);
+        const content = await readPublicationFile(file, config.repoRoot);
+        const extension = path.extname(relative).toLowerCase();
+        const adapted = [".html", ".htm"].includes(extension)
+            ? Buffer.from(adaptBrowseDocument(content.toString("utf8"), relative, catalogue))
+            : content;
+        await fs.promises.mkdir(path.dirname(target), { recursive: true });
+        await fs.promises.writeFile(target, adapted);
+        copied.add(relative);
+    }
+    for (const route of catalogueDocuments(catalogue)) {
+        if (!copied.has(route))
+            throw resourceError(route, "catalogue");
+    }
+    for (const route of copied) {
+        const file = await exportedFile(root, stage, route);
+        if (!/\.(?:html?|css)$/i.test(route))
+            continue;
+        const content = await fs.promises.readFile(file);
+        for (const resource of referencedRoutes(route, content)) {
+            if (!copied.has(resource))
+                throw resourceError(resource, route);
+            await exportedFile(root, stage, resource, route);
+        }
+    }
+}
+/** Require current documents independently of the filesystem enumeration result. */
+function catalogueDocuments(catalogue) {
+    return catalogue.manifest.entries.flatMap((entry) => entry.kind === "page"
+        ? [entry.route]
+        : entry.kind === "screen"
+            ? [
+                ...Object.values(entry.fragments),
+                ...Object.values(entry.darkFragments ?? {}),
+            ]
+            : []);
+}
+async function exportedFile(root, stage, route, source) {
+    const location = locatePath(path.join(root, route), root, stage);
+    if (location) {
+        try {
+            if ((await fs.promises.lstat(location.physicalPath)).isFile())
+                return location.physicalPath;
+        }
+        catch {
+            throw resourceError(route, source);
+        }
+    }
+    throw resourceError(route, source);
+}
+function resourceError(route, source) {
+    return new Error(`exported resource is unavailable: ${route}${source ? ` (referenced by ${source})` : ""}`);
+}
+//# sourceMappingURL=resources.js.map

package/dist/publication/resources.js.map

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

package/dist/registry/catalogue_index.d.ts

@@ -0,0 +1,14 @@
+/** Live routing metadata is deliberately not a publishable manifest. */
+import type { ColorScheme, ResolvedRegistryEntry } from "../authoring/types.js";
+import type { Manifest, ManifestV5 } from "./types.js";
+export interface CatalogueIndex {
+    schemaVersion: "live-index-1";
+    generatedBy: "mokly";
+    sourceFiles: readonly string[];
+    entries: ManifestV5["entries"];
+}
+export type CatalogueMetadata = Manifest | CatalogueIndex;
+export declare function createCatalogueIndex(entries: readonly ResolvedRegistryEntry[], sourceFiles: readonly string[], schemes: readonly ColorScheme[]): CatalogueIndex;
+/** Reuse route/schema/source checks without inventing unrendered usage evidence. */
+export declare function parseCatalogueIndex(value: unknown): CatalogueIndex;
+//# sourceMappingURL=catalogue_index.d.ts.map

package/dist/registry/catalogue_index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue_index.d.ts","sourceRoot":"","sources":["../../src/registry/catalogue_index.ts"],"names":[],"mappings":"AAAA,wEAAwE;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAKhF,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,aAAa,EAAE,cAAc,CAAC;IAC9B,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/B,OAAO,EAAE,UAAU,CAAC,SAAS,CAAC,CAAC;CAChC;AAED,MAAM,MAAM,iBAAiB,GAAG,QAAQ,GAAG,cAAc,CAAC;AAE1D,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,OAAO,EAAE,SAAS,WAAW,EAAE,GAC9B,cAAc,CAKhB;AAED,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CA6BlE"}

package/dist/registry/catalogue_index.js

@@ -0,0 +1,32 @@
+import { MoklyError } from "../errors.js";
+import { validateDependencyDeclarations } from "../components/dependency_validation.js";
+import { createManifest } from "./manifest.js";
+import { validateManifestMetadata } from "./manifest_validation.js";
+export function createCatalogueIndex(entries, sourceFiles, schemes) {
+    return parseCatalogueIndex({
+        ...createManifest(entries, sourceFiles, schemes),
+        schemaVersion: "live-index-1",
+    });
+}
+/** Reuse route/schema/source checks without inventing unrendered usage evidence. */
+export function parseCatalogueIndex(value) {
+    if (!value ||
+        typeof value !== "object" ||
+        !("schemaVersion" in value) ||
+        value.schemaVersion !== "live-index-1")
+        throw new MoklyError("manifest-invalid", "expected a live catalogue index");
+    const metadata = validateManifestMetadata({
+        ...value,
+        schemaVersion: 5,
+    });
+    for (const entry of metadata.entries) {
+        validateDependencyDeclarations(entry);
+        if ((entry.kind === "screen" && entry.componentViews !== undefined) ||
+            (entry.kind === "component" &&
+                entry.variants.some((variant) => !Array.isArray(variant.componentViews) ||
+                    variant.componentViews.length > 0)))
+            throw new MoklyError("manifest-invalid", "live index cannot contain rendered usage");
+    }
+    return value;
+}
+//# sourceMappingURL=catalogue_index.js.map

package/dist/registry/catalogue_index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue_index.js","sourceRoot":"","sources":["../../src/registry/catalogue_index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC;AACxF,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAYpE,MAAM,UAAU,oBAAoB,CAClC,OAAyC,EACzC,WAA8B,EAC9B,OAA+B;IAE/B,OAAO,mBAAmB,CAAC;QACzB,GAAG,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,CAAC;QAChD,aAAa,EAAE,cAAc;KAC9B,CAAC,CAAC;AACL,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,mBAAmB,CAAC,KAAc;IAChD,IACE,CAAC,KAAK;QACN,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,CAAC,eAAe,IAAI,KAAK,CAAC;QAC3B,KAAK,CAAC,aAAa,KAAK,cAAc;QAEtC,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,iCAAiC,CAAC,CAAC;IAC9E,MAAM,QAAQ,GAAG,wBAAwB,CAAC;QACxC,GAAG,KAAK;QACR,aAAa,EAAE,CAAC;KACjB,CAAe,CAAC;IACjB,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,OAAO,EAAE,CAAC;QACrC,8BAA8B,CAAC,KAAK,CAAC,CAAC;QACtC,IACE,CAAC,KAAK,CAAC,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,cAAc,KAAK,SAAS,CAAC;YAC/D,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW;gBACzB,KAAK,CAAC,QAAQ,CAAC,IAAI,CACjB,CAAC,OAAO,EAAE,EAAE,CACV,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC;oBACtC,OAAO,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,CACpC,CAAC;YAEJ,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,0CAA0C,CAC3C,CAAC;IACN,CAAC;IACD,OAAO,KAAuB,CAAC;AACjC,CAAC"}

package/dist/registry/changed_routes.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedConfig } from "../config/types.js";
+import type { Manifest } from "./types.js";
+/** Match manifest entries against repository-relative changed paths. */
+export declare function changedManifestRoutes(manifest: Manifest, baseManifest: Manifest, config: ResolvedConfig, changedPaths: readonly string[]): readonly string[];
+//# sourceMappingURL=changed_routes.d.ts.map

package/dist/registry/changed_routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changed_routes.d.ts","sourceRoot":"","sources":["../../src/registry/changed_routes.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,QAAQ,EAAiB,MAAM,YAAY,CAAC;AAE1D,wEAAwE;AACxE,wBAAgB,qBAAqB,CACnC,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,QAAQ,EACtB,MAAM,EAAE,cAAc,EACtB,YAAY,EAAE,SAAS,MAAM,EAAE,GAC9B,SAAS,MAAM,EAAE,CAwCnB"}