@mokly/mokly 0.8.0

package/dist/registry/manifest.js

@@ -0,0 +1,145 @@
+import fs from "node:fs";
+import path from "node:path";
+import { MoklyError, errorMessage } from "../errors.js";
+import { canonicalJson } from "../components/data.js";
+import { componentManifestEntry } from "../components/manifest_build.js";
+import { analyzeHierarchy } from "./hierarchy.js";
+import { validateManifest } from "./manifest_validation.js";
+import { effectiveColorSchemes } from "./views.js";
+/** Canonical generated manifest filename. */
+export const MANIFEST_NAME = "mokly-manifest.json";
+/** Former package manifest filename accepted only from Git history. */
+export const FORMER_MANIFEST_NAME = "mokabook-manifest.json";
+/** Legacy version 2 manifest filename accepted only during migration. */
+export const LEGACY_MANIFEST_NAME = "mockbook-manifest.json";
+/** Derive one viewport and color-scheme fragment route from a screen route. */
+export function fragmentRoute(route, viewport, colorScheme = "light") {
+    const schemeSuffix = colorScheme === "dark" ? ".dark" : "";
+    return route.replace(/\.html$/, `.${viewport}${schemeSuffix}.html`);
+}
+/** Create deterministic manifest data from prepared entries and the source inventory. */
+export function createManifest(entries, sourceFiles, catalogueSchemes, componentViews = new Map()) {
+    const hierarchy = analyzeHierarchy(entries).hierarchy;
+    return {
+        entries: entries.map((entry) => toManifestEntry(entry, catalogueSchemes, componentViews, hierarchy.ancestorsById
+            .get(entry.id)
+            ?.map((ancestor) => ancestor.title) ?? [])),
+        generatedBy: "mokly",
+        sourceFiles: [
+            ...new Set([
+                ...sourceFiles,
+                ...entries.map((entry) => entry.sourceRelativePath),
+            ]),
+        ].sort(),
+        schemaVersion: 5,
+    };
+}
+/** Serialize the current manifest with canonical object-key ordering. */
+export function serializeManifest(manifest) {
+    return `${canonicalJson(manifest, 2)}\n`;
+}
+/** Read strictly current schema-v5 canonical output. */
+export function readManifest(config) {
+    const canonicalPath = path.join(config.mockupsDir, MANIFEST_NAME);
+    const manifest = readManifestFile(canonicalPath);
+    config.sourceFiles = manifest.sourceFiles;
+    return manifest;
+}
+/** Select the strict canonical input or the explicitly enabled legacy input. */
+export function selectManifestInput(canonicalExists, formerExists, allowLegacyV2) {
+    if (canonicalExists) {
+        return { allowV2: false, filename: MANIFEST_NAME };
+    }
+    if (formerExists) {
+        return { allowV2: false, filename: FORMER_MANIFEST_NAME };
+    }
+    if (!allowLegacyV2)
+        return { allowV2: false, filename: MANIFEST_NAME };
+    return { allowV2: true, filename: LEGACY_MANIFEST_NAME };
+}
+function readManifestFile(candidate) {
+    let value;
+    try {
+        value = JSON.parse(fs.readFileSync(candidate, "utf8"));
+    }
+    catch (error) {
+        throw new MoklyError("manifest-invalid", `could not read ${candidate}: ${errorMessage(error)}`, {
+            cause: error,
+        });
+    }
+    return parseManifest(value);
+}
+/** Validate manifest-shaped JSON and normalize temporary version 2 input. */
+export function parseManifest(value) {
+    return validateManifest(value, false, false);
+}
+/** Read old schemas only at the historical comparison boundary. */
+export function parseHistoricalManifest(value, allowV2 = false) {
+    return validateManifest(value, allowV2, true);
+}
+function toManifestEntry(entry, catalogueSchemes, componentViews, navPath) {
+    const common = {
+        declaredDependencies: [...new Set(entry.dependencies)].sort(),
+        dependencies: [
+            ...new Set([entry.sourceRelativePath, ...entry.dependencies]),
+        ].sort(),
+        description: entry.description,
+        id: entry.id,
+        kind: entry.kind,
+        navPath: [...navPath],
+        ...(entry.rationale ? { rationale: entry.rationale } : {}),
+        relatedDocs: [...entry.relatedDocs],
+        sourcePath: entry.sourceRelativePath,
+        title: entry.title,
+    };
+    if (entry.kind === "component")
+        return {
+            ...componentManifestEntry(entry, common, catalogueSchemes, componentViews),
+            declaredDependencies: common.declaredDependencies,
+        };
+    if (entry.kind === "collection")
+        return { ...common, childIds: [...entry.childIds], kind: "collection" };
+    if (entry.kind === "page")
+        return {
+            ...common,
+            kind: "page",
+            route: entry.route,
+            ...(entry.tags?.length ? { tags: [...entry.tags] } : {}),
+        };
+    if (entry.kind === "use-case") {
+        return {
+            ...common,
+            kind: "use-case",
+            route: entry.route,
+            steps: entry.steps.map((step) => ({ ...step })),
+            ...(entry.tags && entry.tags.length > 0 ? { tags: [...entry.tags] } : {}),
+        };
+    }
+    return {
+        ...common,
+        ...(entry.address ? { address: entry.address } : {}),
+        ...(effectiveColorSchemes(entry, catalogueSchemes).includes("dark")
+            ? {
+                darkFragments: {
+                    desktop: fragmentRoute(entry.route, "desktop", "dark"),
+                    mobile: fragmentRoute(entry.route, "mobile", "dark"),
+                },
+            }
+            : {}),
+        fragments: {
+            desktop: fragmentRoute(entry.route, "desktop"),
+            mobile: fragmentRoute(entry.route, "mobile"),
+        },
+        kind: "screen",
+        ...(componentViews.size
+            ? {
+                componentViews: ["mobile", "desktop"].flatMap((viewport) => effectiveColorSchemes(entry, catalogueSchemes).map((scheme) => componentViews.get(fragmentRoute(entry.route, viewport, scheme)))),
+            }
+            : {}),
+        route: entry.route,
+        ...(entry.tags && entry.tags.length > 0 ? { tags: [...entry.tags] } : {}),
+        useCaseIds: [...entry.useCaseIds],
+        viewports: ["mobile", "desktop"],
+    };
+}
+//# sourceMappingURL=manifest.js.map

package/dist/registry/manifest.js.map

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

package/dist/registry/manifest_capabilities.d.ts

@@ -0,0 +1,4 @@
+import type { Manifest } from "./types.js";
+/** Component-aware attribution is selected by recorded components, not version alone. */
+export declare function hasRegisteredComponents(manifest: Manifest): boolean;
+//# sourceMappingURL=manifest_capabilities.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest_capabilities.d.ts","sourceRoot":"","sources":["../../src/registry/manifest_capabilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,yFAAyF;AACzF,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAEnE"}

package/dist/registry/manifest_capabilities.js

@@ -0,0 +1,5 @@
+/** Component-aware attribution is selected by recorded components, not version alone. */
+export function hasRegisteredComponents(manifest) {
+    return manifest.entries.some((entry) => entry.kind === "component");
+}
+//# sourceMappingURL=manifest_capabilities.js.map

package/dist/registry/manifest_capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest_capabilities.js","sourceRoot":"","sources":["../../src/registry/manifest_capabilities.ts"],"names":[],"mappings":"AAEA,yFAAyF;AACzF,MAAM,UAAU,uBAAuB,CAAC,QAAkB;IACxD,OAAO,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;AACtE,CAAC"}

package/dist/registry/manifest_entries.d.ts

@@ -0,0 +1,5 @@
+/** Validate the public fields for one historical or current entry. */
+export declare function validateEntry(entry: Record<string, unknown>, components?: boolean): void;
+/** Reject fields outside the source-inventoried entry contract. */
+export declare function validateCurrentFields(entry: Record<string, unknown>, components?: boolean): void;
+//# sourceMappingURL=manifest_entries.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest_entries.d.ts","sourceRoot":"","sources":["../../src/registry/manifest_entries.ts"],"names":[],"mappings":"AAWA,sEAAsE;AACtE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,UAAU,UAAQ,GACjB,IAAI,CAsEN;AAuFD,mEAAmE;AACnE,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,UAAU,UAAQ,GACjB,IAAI,CAyDN"}

package/dist/registry/manifest_entries.js

@@ -0,0 +1,155 @@
+import { MoklyError } from "../errors.js";
+import { validateManifestComponent } from "../components/manifest_validation.js";
+import { isCatalogueId } from "../navigation/logical.js";
+import { nonEmptyString, record, stringArray, validateRepoPath, validateRoute, } from "./manifest_values.js";
+/** Validate the public fields for one historical or current entry. */
+export function validateEntry(entry, components = false) {
+    const kind = entry.kind;
+    if (kind !== "collection" &&
+        kind !== "screen" &&
+        kind !== "page" &&
+        kind !== "use-case" &&
+        !(components && kind === "component")) {
+        throw new MoklyError("manifest-invalid", `invalid manifest kind for ${String(entry.id)}`);
+    }
+    for (const field of ["title", "description", "sourcePath"]) {
+        if (typeof entry[field] !== "string" || entry[field].length === 0) {
+            throw new MoklyError("manifest-invalid", `${String(entry.id)} is missing ${field}`);
+        }
+    }
+    validateRepoPath(entry.sourcePath, `${String(entry.id)} sourcePath`);
+    if (entry.rationale !== undefined && !nonEmptyString(entry.rationale)) {
+        throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid rationale`);
+    }
+    for (const field of ["navPath", "relatedDocs", "dependencies"]) {
+        if (!stringArray(entry[field])) {
+            throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid ${field}`);
+        }
+    }
+    for (const field of ["relatedDocs", "dependencies"]) {
+        for (const value of entry[field]) {
+            validateRepoPath(value, `${String(entry.id)} ${field}`);
+        }
+    }
+    if (kind === "collection") {
+        if (!stringArray(entry.childIds)) {
+            throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid childIds`);
+        }
+        return;
+    }
+    if (typeof entry.route !== "string") {
+        throw new MoklyError("manifest-invalid", `${String(entry.id)} has no route`);
+    }
+    validateRoute(entry.route, String(entry.id));
+    if (entry.tags !== undefined && !stringArray(entry.tags)) {
+        throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid tags`);
+    }
+    if (kind === "component")
+        validateManifestComponent(entry);
+    else if (kind === "screen")
+        validateScreen(entry);
+    else if (kind === "use-case")
+        validateUseCase(entry);
+}
+function validateScreen(entry) {
+    if (!record(entry.fragments)) {
+        throw new MoklyError("manifest-invalid", `${String(entry.id)} has no fragments`);
+    }
+    for (const viewport of ["mobile", "desktop"]) {
+        const fragment = entry.fragments[viewport];
+        if (typeof fragment !== "string") {
+            throw new MoklyError("manifest-invalid", `${String(entry.id)} has no ${viewport} fragment`);
+        }
+        validateRoute(fragment, `${String(entry.id)} ${viewport} fragment`);
+    }
+    if (entry.darkFragments !== undefined) {
+        if (!record(entry.darkFragments)) {
+            throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid darkFragments`);
+        }
+        for (const viewport of ["mobile", "desktop"]) {
+            const fragment = entry.darkFragments[viewport];
+            if (typeof fragment !== "string") {
+                throw new MoklyError("manifest-invalid", `${String(entry.id)} has no ${viewport} dark fragment`);
+            }
+            validateRoute(fragment, `${String(entry.id)} ${viewport} dark fragment`);
+        }
+    }
+    if (!stringArray(entry.useCaseIds)) {
+        throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid useCaseIds`);
+    }
+    if (!Array.isArray(entry.viewports) ||
+        entry.viewports.length !== 2 ||
+        entry.viewports[0] !== "mobile" ||
+        entry.viewports[1] !== "desktop") {
+        throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid viewports`);
+    }
+    if (entry.address !== undefined && !nonEmptyString(entry.address)) {
+        throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid address`);
+    }
+}
+function validateUseCase(entry) {
+    if (!Array.isArray(entry.steps) || entry.steps.length === 0) {
+        throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid steps`);
+    }
+    for (const [index, step] of entry.steps.entries()) {
+        if (!record(step) || !nonEmptyString(step.screenId)) {
+            throw new MoklyError("manifest-invalid", `${String(entry.id)} step #${index + 1} has invalid screenId`);
+        }
+        for (const field of ["title", "description"]) {
+            if (step[field] !== undefined && !nonEmptyString(step[field])) {
+                throw new MoklyError("manifest-invalid", `${String(entry.id)} step #${index + 1} has invalid ${field}`);
+            }
+        }
+    }
+}
+/** Reject fields outside the source-inventoried entry contract. */
+export function validateCurrentFields(entry, components = false) {
+    const common = [
+        "dependencies",
+        "description",
+        "id",
+        "kind",
+        "navPath",
+        "rationale",
+        "relatedDocs",
+        "sourcePath",
+        "title",
+        ...(components ? ["declaredDependencies"] : []),
+    ];
+    const specific = entry.kind === "collection"
+        ? ["childIds"]
+        : entry.kind === "page"
+            ? ["route", "tags"]
+            : entry.kind === "component" && components
+                ? [
+                    "route",
+                    "tags",
+                    "viewports",
+                    "propSchema",
+                    "slots",
+                    "controls",
+                    "ownedDependencies",
+                    "variants",
+                ]
+                : entry.kind === "screen"
+                    ? [
+                        "route",
+                        "tags",
+                        "address",
+                        "darkFragments",
+                        "fragments",
+                        "useCaseIds",
+                        "viewports",
+                        ...(components ? ["componentViews"] : []),
+                    ]
+                    : ["route", "tags", "steps"];
+    for (const field of Object.keys(entry))
+        if (![...common, ...specific].includes(field))
+            throw new MoklyError("manifest-invalid", `${String(entry.id)} has unsupported ${field}`);
+    if (entry.tags !== undefined &&
+        (!Array.isArray(entry.tags) ||
+            !entry.tags.every(isCatalogueId) ||
+            new Set(entry.tags).size !== entry.tags.length))
+        throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid tags`);
+}
+//# sourceMappingURL=manifest_entries.js.map

package/dist/registry/manifest_entries.js.map

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

package/dist/registry/manifest_relationships.d.ts

@@ -0,0 +1,3 @@
+/** Validate manifest relationship targets and reciprocal memberships. */
+export declare function validateManifestRelationships(entries: readonly Record<string, unknown>[], byId: ReadonlyMap<string, Record<string, unknown>>): void;
+//# sourceMappingURL=manifest_relationships.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest_relationships.d.ts","sourceRoot":"","sources":["../../src/registry/manifest_relationships.ts"],"names":[],"mappings":"AAKA,yEAAyE;AACzE,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAC3C,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACjD,IAAI,CAUN"}

package/dist/registry/manifest_relationships.js

@@ -0,0 +1,44 @@
+import { MoklyError } from "../errors.js";
+import { analyzeHierarchy } from "./hierarchy.js";
+/** Validate manifest relationship targets and reciprocal memberships. */
+export function validateManifestRelationships(entries, byId) {
+    const hierarchyEntries = entries;
+    const hierarchyIssue = analyzeHierarchy(hierarchyEntries).issues[0];
+    if (hierarchyIssue) {
+        relationshipError(hierarchyIssue.entry, hierarchyIssue.message);
+    }
+    for (const entry of entries) {
+        if (entry.kind === "screen")
+            validateScreen(entry, byId);
+        else if (entry.kind === "use-case")
+            validateUseCase(entry, byId);
+    }
+}
+function validateScreen(entry, byId) {
+    for (const useCaseId of entry.useCaseIds) {
+        const useCase = byId.get(useCaseId);
+        if (useCase?.kind !== "use-case") {
+            relationshipError(entry, `use-case target is not a use case: ${useCaseId}`);
+        }
+        const steps = useCase.steps;
+        if (!steps.some((step) => step.screenId === entry.id)) {
+            relationshipError(entry, `use case ${useCaseId} does not reference this screen`);
+        }
+    }
+}
+function validateUseCase(entry, byId) {
+    for (const step of entry.steps) {
+        const screenId = step.screenId;
+        const screen = byId.get(screenId);
+        if (screen?.kind !== "screen") {
+            relationshipError(entry, `step target is not a screen: ${screenId}`);
+        }
+        if (!screen.useCaseIds.includes(entry.id)) {
+            relationshipError(entry, `screen ${screenId} does not list this use case`);
+        }
+    }
+}
+function relationshipError(entry, detail) {
+    throw new MoklyError("manifest-invalid", `${String(entry.id)} has an invalid relationship: ${detail}`);
+}
+//# sourceMappingURL=manifest_relationships.js.map

package/dist/registry/manifest_relationships.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest_relationships.js","sourceRoot":"","sources":["../../src/registry/manifest_relationships.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,gBAAgB,EAAuB,MAAM,gBAAgB,CAAC;AAIvE,yEAAyE;AACzE,MAAM,UAAU,6BAA6B,CAC3C,OAA2C,EAC3C,IAAkD;IAElD,MAAM,gBAAgB,GAAG,OAA4C,CAAC;IACtE,MAAM,cAAc,GAAG,gBAAgB,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACpE,IAAI,cAAc,EAAE,CAAC;QACnB,iBAAiB,CAAC,cAAc,CAAC,KAAK,EAAE,cAAc,CAAC,OAAO,CAAC,CAAC;IAClE,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;YAAE,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;aACpD,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU;YAAE,eAAe,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACnE,CAAC;AACH,CAAC;AAED,SAAS,cAAc,CACrB,KAA8B,EAC9B,IAAkD;IAElD,KAAK,MAAM,SAAS,IAAI,KAAK,CAAC,UAAsB,EAAE,CAAC;QACrD,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpC,IAAI,OAAO,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;YACjC,iBAAiB,CACf,KAAK,EACL,sCAAsC,SAAS,EAAE,CAClD,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAuC,CAAC;QAC9D,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,KAAK,KAAK,CAAC,EAAE,CAAC,EAAE,CAAC;YACtD,iBAAiB,CACf,KAAK,EACL,YAAY,SAAS,iCAAiC,CACvD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CACtB,KAA8B,EAC9B,IAAkD;IAElD,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAuC,EAAE,CAAC;QACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAkB,CAAC;QACzC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAClC,IAAI,MAAM,EAAE,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC9B,iBAAiB,CAAC,KAAK,EAAE,gCAAgC,QAAQ,EAAE,CAAC,CAAC;QACvE,CAAC;QACD,IAAI,CAAE,MAAM,CAAC,UAAuB,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAY,CAAC,EAAE,CAAC;YAClE,iBAAiB,CACf,KAAK,EACL,UAAU,QAAQ,8BAA8B,CACjD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CACxB,KAA8B,EAC9B,MAAc;IAEd,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,GAAG,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,iCAAiC,MAAM,EAAE,CAC7D,CAAC;AACJ,CAAC"}

package/dist/registry/manifest_validation.d.ts

@@ -0,0 +1,6 @@
+import type { HistoricalManifest } from "./types.js";
+/** Validate unknown manifest JSON and normalize temporary schema version 2. */
+export declare function validateManifest(value: unknown, allowV2: boolean, historical?: boolean): HistoricalManifest;
+/** Shared metadata validation; only the live index omits rendered-view validation. */
+export declare function validateManifestMetadata(value: unknown, allowV2?: boolean, historical?: boolean): HistoricalManifest;
+//# sourceMappingURL=manifest_validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest_validation.d.ts","sourceRoot":"","sources":["../../src/registry/manifest_validation.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAErD,+EAA+E;AAC/E,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,EAChB,UAAU,UAAQ,GACjB,kBAAkB,CAIpB;AAED,sFAAsF;AACtF,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,OAAO,EACd,OAAO,UAAQ,EACf,UAAU,UAAQ,GACjB,kBAAkB,CA2GpB"}

package/dist/registry/manifest_validation.js

@@ -0,0 +1,132 @@
+import { componentFragmentPaths, validateManifestComponentUsage, } from "../components/manifest_validation.js";
+import { MoklyError } from "../errors.js";
+import { isCatalogueId } from "../navigation/logical.js";
+import { validateManifestRelationships } from "./manifest_relationships.js";
+import { validateEntry, validateCurrentFields } from "./manifest_entries.js";
+import { record, stringArray, validateRepoPath, validateRoute, } from "./manifest_values.js";
+/** Validate unknown manifest JSON and normalize temporary schema version 2. */
+export function validateManifest(value, allowV2, historical = false) {
+    const manifest = validateManifestMetadata(value, allowV2, historical);
+    validateManifestComponentUsage(manifest);
+    return manifest;
+}
+/** Shared metadata validation; only the live index omits rendered-view validation. */
+export function validateManifestMetadata(value, allowV2 = false, historical = false) {
+    if (!record(value) || !Array.isArray(value.entries))
+        throw new MoklyError("manifest-invalid", "manifest must contain an entries array");
+    let normalized = value;
+    if (value.schemaVersion === 2 && allowV2 && historical) {
+        normalized = { ...value, generatedBy: "mokly", schemaVersion: 3 };
+    }
+    else if (historical && value.generatedBy === "mokabook") {
+        normalized = { ...value, generatedBy: "mokly" };
+    }
+    const current = normalized.schemaVersion === 5;
+    const pages = current || (normalized.schemaVersion === 4 && "sourceFiles" in normalized);
+    if ((!current &&
+        !(historical && [3, 4].includes(normalized.schemaVersion))) ||
+        normalized.generatedBy !== "mokly")
+        throw new MoklyError("manifest-invalid", "expected Mokly manifest schema version 5; run mokly build");
+    if (pages) {
+        if (Object.keys(normalized).some((key) => !["entries", "generatedBy", "schemaVersion", "sourceFiles"].includes(key)))
+            throw new MoklyError("manifest-invalid", "unexpected manifest field");
+        if (!stringArray(normalized.sourceFiles) ||
+            JSON.stringify(normalized.sourceFiles) !==
+                JSON.stringify([...new Set(normalized.sourceFiles)].sort()))
+            throw new MoklyError("manifest-invalid", "sourceFiles must be a sorted unique array");
+        for (const source of normalized.sourceFiles)
+            validateRepoPath(source, "sourceFiles");
+    }
+    else if (!Array.isArray(normalized.legacyPages))
+        throw new MoklyError("manifest-invalid", "historical manifest needs legacyPages");
+    const entries = [];
+    const byId = new Map();
+    const routes = new Set();
+    for (const rawEntry of value.entries) {
+        if (!record(rawEntry) ||
+            typeof rawEntry.id !== "string" ||
+            typeof rawEntry.kind !== "string") {
+            throw new MoklyError("manifest-invalid", "every manifest entry needs string id and kind");
+        }
+        const entry = rawEntry;
+        const id = rawEntry.id;
+        if (!isCatalogueId(id)) {
+            throw new MoklyError("manifest-invalid", `invalid manifest id: ${id}`);
+        }
+        if (pages) {
+            validateCurrentFields(entry, current);
+            if (!normalized.sourceFiles.includes(entry.sourcePath))
+                throw new MoklyError("manifest-invalid", `sourceFiles omits ${String(entry.sourcePath)}`);
+        }
+        else if (entry.kind === "page")
+            throw new MoklyError("manifest-invalid", "pages require the registered-page manifest format");
+        validateEntry(entry, current || (normalized.schemaVersion === 4 && !pages));
+        if (byId.has(id)) {
+            throw new MoklyError("manifest-invalid", `duplicate manifest id: ${id}`);
+        }
+        entries.push(entry);
+        byId.set(id, entry);
+        if (entry.kind !== "collection") {
+            if (typeof entry.route !== "string" || routes.has(entry.route)) {
+                throw new MoklyError("manifest-invalid", `invalid or duplicate manifest route for ${entry.id}`);
+            }
+            routes.add(entry.route);
+        }
+    }
+    const outputRoutes = validateFragmentRoutes(entries, routes);
+    if (!pages)
+        validateLegacyPages(normalized.legacyPages, outputRoutes);
+    validateManifestRelationships(entries, byId);
+    const manifest = normalized;
+    return manifest;
+}
+function validateFragmentRoutes(entries, routedEntries) {
+    const outputRoutes = new Set(routedEntries);
+    for (const entry of entries) {
+        if (entry.kind === "component") {
+            for (const fragment of componentFragmentPaths(entry)) {
+                if (outputRoutes.has(fragment))
+                    throw new MoklyError("manifest-invalid", `colliding component fragment: ${fragment}`);
+                outputRoutes.add(fragment);
+            }
+            continue;
+        }
+        if (entry.kind !== "screen" || !record(entry.fragments))
+            continue;
+        for (const viewport of ["mobile", "desktop"]) {
+            const fragment = entry.fragments[viewport];
+            const expected = entry.route.replace(/\.html$/, `.${viewport}.html`);
+            if (fragment !== expected || outputRoutes.has(fragment)) {
+                throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid or colliding ${viewport} fragment`);
+            }
+            outputRoutes.add(fragment);
+        }
+        if (!record(entry.darkFragments))
+            continue;
+        for (const viewport of ["mobile", "desktop"]) {
+            const fragment = entry.darkFragments[viewport];
+            const expected = entry.route.replace(/\.html$/, `.${viewport}.dark.html`);
+            if (fragment !== expected || outputRoutes.has(fragment)) {
+                throw new MoklyError("manifest-invalid", `${String(entry.id)} has invalid or colliding ${viewport} dark fragment`);
+            }
+            outputRoutes.add(fragment);
+        }
+    }
+    return outputRoutes;
+}
+function validateLegacyPages(pages, routes) {
+    for (const page of pages) {
+        if (!record(page) ||
+            typeof page.route !== "string" ||
+            typeof page.sourcePath !== "string") {
+            throw new MoklyError("manifest-invalid", "every legacy page needs route and sourcePath");
+        }
+        validateRoute(page.route, "legacy page");
+        validateRepoPath(page.sourcePath, "legacy page sourcePath");
+        if (routes.has(page.route)) {
+            throw new MoklyError("manifest-invalid", `duplicate manifest route: ${page.route}`);
+        }
+        routes.add(page.route);
+    }
+}
+//# sourceMappingURL=manifest_validation.js.map

package/dist/registry/manifest_validation.js.map

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

package/dist/registry/manifest_values.d.ts

@@ -0,0 +1,11 @@
+/** Validate a portable routed catalogue URL. */
+export declare function validateRoute(route: string, label: string): void;
+/** Narrow a manifest string-array field. */
+export declare function stringArray(value: unknown): value is string[];
+/** Narrow a required text field. */
+export declare function nonEmptyString(value: unknown): value is string;
+/** Validate one repository-relative inventory or metadata path. */
+export declare function validateRepoPath(value: string, label: string): void;
+/** Narrow an object boundary before reading manifest fields. */
+export declare function record(value: unknown): value is Record<string, unknown>;
+//# sourceMappingURL=manifest_values.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest_values.d.ts","sourceRoot":"","sources":["../../src/registry/manifest_values.ts"],"names":[],"mappings":"AAGA,gDAAgD;AAChD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAIhE;AAED,4CAA4C;AAC5C,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,EAAE,CAK7D;AAED,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOnE;AAED,gEAAgE;AAChE,wBAAgB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEvE"}

package/dist/registry/manifest_values.js

@@ -0,0 +1,28 @@
+import { MoklyError } from "../errors.js";
+import { isSafeCatalogueRoute, isSafeRepositoryPath } from "../config/paths.js";
+/** Validate a portable routed catalogue URL. */
+export function validateRoute(route, label) {
+    if (!isSafeCatalogueRoute(route)) {
+        throw new MoklyError("manifest-invalid", `${label} has an unsafe route`);
+    }
+}
+/** Narrow a manifest string-array field. */
+export function stringArray(value) {
+    return (Array.isArray(value) &&
+        value.every((item) => typeof item === "string" && item.length > 0));
+}
+/** Narrow a required text field. */
+export function nonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+/** Validate one repository-relative inventory or metadata path. */
+export function validateRepoPath(value, label) {
+    if (!isSafeRepositoryPath(value)) {
+        throw new MoklyError("manifest-invalid", `${label} must be a safe repository-relative path`);
+    }
+}
+/** Narrow an object boundary before reading manifest fields. */
+export function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=manifest_values.js.map

package/dist/registry/manifest_values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest_values.js","sourceRoot":"","sources":["../../src/registry/manifest_values.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAEhF,gDAAgD;AAChD,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,KAAa;IACxD,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,UAAU,CAAC,kBAAkB,EAAE,GAAG,KAAK,sBAAsB,CAAC,CAAC;IAC3E,CAAC;AACH,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,OAAO,CACL,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACpB,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CACnE,CAAC;AACJ,CAAC;AAED,oCAAoC;AACpC,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,KAAa,EAAE,KAAa;IAC3D,IAAI,CAAC,oBAAoB,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,UAAU,CAClB,kBAAkB,EAClB,GAAG,KAAK,0CAA0C,CACnD,CAAC;IACJ,CAAC;AACH,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,MAAM,CAAC,KAAc;IACnC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC"}

package/dist/registry/prepare.d.ts

@@ -0,0 +1,5 @@
+import type { ResolvedConfig } from "../config/types.js";
+import type { PreparedRegistry } from "./types.js";
+/** Validate loaded values and prepare stable source-attributed entries. */
+export declare function prepareRegistry(values: readonly unknown[], config: ResolvedConfig): PreparedRegistry;
+//# sourceMappingURL=prepare.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../src/registry/prepare.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AASzD,OAAO,KAAK,EAAE,gBAAgB,EAAqB,MAAM,YAAY,CAAC;AAEtE,2EAA2E;AAC3E,wBAAgB,eAAe,CAC7B,MAAM,EAAE,SAAS,OAAO,EAAE,EAC1B,MAAM,EAAE,cAAc,GACrB,gBAAgB,CAsDlB"}