@mokly/mokly 0.8.0

package/dist/registry/changed_routes.js

@@ -0,0 +1,91 @@
+/** Pure route membership from material paths and catalogue metadata. */
+import path from "node:path";
+import { isDeepStrictEqual } from "node:util";
+import { toPosixPath } from "../config/paths.js";
+import { analyzeHierarchy } from "./hierarchy.js";
+/** Match manifest entries against repository-relative changed paths. */
+export function changedManifestRoutes(manifest, baseManifest, config, changedPaths) {
+    const mockupsPrefix = toPosixPath(path.relative(config.repoRoot, config.mockupsDir));
+    const routes = new Set();
+    const changedScreenIds = new Set();
+    const baseEntries = new Map(baseManifest.entries.map((entry) => [entry.id, entry]));
+    const hierarchy = analyzeHierarchy(manifest.entries).hierarchy;
+    const baseHierarchy = analyzeHierarchy(baseManifest.entries).hierarchy;
+    for (const entry of manifest.entries) {
+        if (entry.kind === "collection")
+            continue;
+        const baseEntry = baseEntries.get(entry.id);
+        const candidates = changedPathCandidates(entry, baseEntry, mockupsPrefix);
+        if (isDeepStrictEqual(routeChangeProjection(entry, hierarchy), routeChangeProjection(baseEntry, baseHierarchy)) &&
+            !candidates.some((candidate) => changedPaths.some((changedPath) => candidate === changedPath))) {
+            continue;
+        }
+        routes.add(entry.route);
+        if (entry.kind === "screen")
+            changedScreenIds.add(entry.id);
+    }
+    for (const entry of manifest.entries) {
+        if (entry.kind === "use-case" &&
+            entry.steps.some((step) => changedScreenIds.has(step.screenId))) {
+            routes.add(entry.route);
+        }
+    }
+    return [...routes].sort();
+}
+/** Select manifest metadata whose changes can affect a routed Browse entry. */
+function routeChangeProjection(entry, hierarchy) {
+    if (!entry)
+        return undefined;
+    const common = {
+        ancestorCollections: (hierarchy.ancestorsById.get(entry.id) ?? []).map(({ id, title }) => ({ id, title })),
+        description: entry.description,
+        id: entry.id,
+        kind: entry.kind,
+        rationale: entry.rationale,
+        relatedDocs: entry.relatedDocs,
+        tags: entry.kind === "collection" ? undefined : entry.tags,
+        title: entry.title,
+    };
+    if (entry.kind === "collection") {
+        return { ...common, childIds: entry.childIds };
+    }
+    if (entry.kind === "page")
+        return { ...common, route: entry.route };
+    if (entry.kind === "use-case") {
+        return { ...common, route: entry.route, steps: entry.steps };
+    }
+    if (entry.kind === "component")
+        return {
+            ...common,
+            route: entry.route,
+            propSchema: entry.propSchema,
+            controls: entry.controls,
+            slots: entry.slots,
+            variants: entry.variants.map(({ componentViews: _views, ...variant }) => variant),
+        };
+    return {
+        ...common,
+        address: entry.address,
+        darkFragments: entry.darkFragments,
+        fragments: entry.fragments,
+        route: entry.route,
+        useCaseIds: entry.useCaseIds,
+        viewports: entry.viewports,
+    };
+}
+function changedPathCandidates(entry, baseEntry, mockupsPrefix) {
+    const candidates = [];
+    const prefix = mockupsPrefix ? `${mockupsPrefix}/` : "";
+    for (const candidate of [entry, baseEntry]) {
+        if (candidate?.kind === "page")
+            candidates.push(`${prefix}${candidate.route}`);
+        if (candidate?.kind !== "screen")
+            continue;
+        candidates.push(`${prefix}${candidate.fragments.mobile}`, `${prefix}${candidate.fragments.desktop}`);
+        if (candidate.darkFragments) {
+            candidates.push(`${prefix}${candidate.darkFragments.mobile}`, `${prefix}${candidate.darkFragments.desktop}`);
+        }
+    }
+    return [...new Set(candidates)];
+}
+//# sourceMappingURL=changed_routes.js.map

package/dist/registry/changed_routes.js.map

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

package/dist/registry/changes.d.ts

@@ -0,0 +1,22 @@
+import type { ManifestComponent } from "../components/manifest_types.js";
+import type { HistoricalManifest, ManifestPage, ManifestScreen } from "./types.js";
+/** Baseline context retained independently of current collection membership. */
+export interface RemovedEntrySnapshot {
+    entry: ManifestPage | ManifestScreen | ManifestComponent;
+    ancestors: readonly {
+        id: string;
+        title: string;
+    }[];
+}
+/** One pinned generation shared by Browse, watched updates and publication. */
+export interface CatalogueChangeSnapshot {
+    schemaVersion: 1;
+    baseRef: string;
+    baseCommit: string;
+    changedRoutes: readonly string[];
+    removedEntries: readonly RemovedEntrySnapshot[];
+}
+/** Only a free old route retains a baseline leaf; current ids and routes always win. */
+export declare function removedManifestEntries(manifest: CatalogueMetadata, baseline: HistoricalManifest): RemovedEntrySnapshot[];
+import type { CatalogueMetadata } from "./catalogue_index.js";
+//# sourceMappingURL=changes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"changes.d.ts","sourceRoot":"","sources":["../../src/registry/changes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AAEzE,OAAO,KAAK,EAEV,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,gFAAgF;AAChF,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,YAAY,GAAG,cAAc,GAAG,iBAAiB,CAAC;IACzD,SAAS,EAAE,SAAS;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACrD;AAED,+EAA+E;AAC/E,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,CAAC,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,cAAc,EAAE,SAAS,oBAAoB,EAAE,CAAC;CACjD;AAED,wFAAwF;AACxF,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,iBAAiB,EAC3B,QAAQ,EAAE,kBAAkB,GAC3B,oBAAoB,EAAE,CA6BxB;AACD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/registry/changes.js

@@ -0,0 +1,22 @@
+import { analyzeHierarchy } from "./hierarchy.js";
+/** Only a free old route retains a baseline leaf; current ids and routes always win. */
+export function removedManifestEntries(manifest, baseline) {
+    const routes = new Set(manifest.entries.flatMap((entry) => entry.kind === "collection" ? [] : [entry.route]));
+    const ids = new Set(manifest.entries.map((entry) => entry.id));
+    const hierarchy = analyzeHierarchy(baseline.entries).hierarchy;
+    return baseline.entries
+        .flatMap((entry) => (entry.kind === "page" ||
+        entry.kind === "screen" ||
+        (entry.kind === "component" && !ids.has(entry.id))) &&
+        !routes.has(entry.route)
+        ? [
+            {
+                entry,
+                ancestors: (hierarchy.ancestorsById.get(entry.id) ?? []).map(({ id, title }) => ({ id, title })),
+            },
+        ]
+        : [])
+        .sort((a, b) => a.entry.route.localeCompare(b.entry.route) ||
+        a.entry.id.localeCompare(b.entry.id));
+}
+//# sourceMappingURL=changes.js.map

package/dist/registry/changes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"changes.js","sourceRoot":"","sources":["../../src/registry/changes.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAuBlD,wFAAwF;AACxF,MAAM,UAAU,sBAAsB,CACpC,QAA2B,EAC3B,QAA4B;IAE5B,MAAM,MAAM,GAAG,IAAI,GAAG,CACpB,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE,CACjC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CACjD,CACF,CAAC;IACF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/D,MAAM,SAAS,GAAG,gBAAgB,CAAgB,QAAQ,CAAC,OAAO,CAAC,CAAC,SAAS,CAAC;IAC9E,OAAO,QAAQ,CAAC,OAAO;SACpB,OAAO,CAAC,CAAC,KAAK,EAA0B,EAAE,CACzC,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM;QACpB,KAAK,CAAC,IAAI,KAAK,QAAQ;QACvB,CAAC,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QACrD,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC;QACtB,CAAC,CAAC;YACE;gBACE,KAAK;gBACL,SAAS,EAAE,CAAC,SAAS,CAAC,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,GAAG,CAC1D,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,CACnC;aACF;SACF;QACH,CAAC,CAAC,EAAE,CACP;SACA,IAAI,CACH,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC;QAC1C,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CACvC,CAAC;AACN,CAAC"}

package/dist/registry/dependency_paths.d.ts

@@ -0,0 +1,4 @@
+/** Repository-path matching for declared mockup dependencies. */
+/** Return whether a changed path is the dependency itself or its descendant. */
+export declare function dependencyContainsChangedPath(dependency: string, changedPath: string): boolean;
+//# sourceMappingURL=dependency_paths.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dependency_paths.d.ts","sourceRoot":"","sources":["../../src/registry/dependency_paths.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,gFAAgF;AAChF,wBAAgB,6BAA6B,CAC3C,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,GAClB,OAAO,CAET"}

package/dist/registry/dependency_paths.js

@@ -0,0 +1,6 @@
+/** Repository-path matching for declared mockup dependencies. */
+/** Return whether a changed path is the dependency itself or its descendant. */
+export function dependencyContainsChangedPath(dependency, changedPath) {
+    return changedPath === dependency || changedPath.startsWith(`${dependency}/`);
+}
+//# sourceMappingURL=dependency_paths.js.map

package/dist/registry/dependency_paths.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dependency_paths.js","sourceRoot":"","sources":["../../src/registry/dependency_paths.ts"],"names":[],"mappings":"AAAA,iEAAiE;AAEjE,gFAAgF;AAChF,MAAM,UAAU,6BAA6B,CAC3C,UAAkB,EAClB,WAAmB;IAEnB,OAAO,WAAW,KAAK,UAAU,IAAI,WAAW,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,CAAC,CAAC;AAChF,CAAC"}

package/dist/registry/entry_validation.d.ts

@@ -0,0 +1,8 @@
+import type { ResolvedRegistryEntry } from "../authoring/types.js";
+import type { ResolvedConfig } from "../config/types.js";
+import type { RegistryViolation } from "./types.js";
+/** Validate metadata, routes, source attribution, and declared paths. */
+export declare function validateEntry(entry: ResolvedRegistryEntry, config: ResolvedConfig): RegistryViolation[];
+/** Create one source-attributed registry violation. */
+export declare function problem(entry: ResolvedRegistryEntry, code: string, message: string): RegistryViolation;
+//# sourceMappingURL=entry_validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"entry_validation.d.ts","sourceRoot":"","sources":["../../src/registry/entry_validation.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAMnE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,yEAAyE;AACzE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,qBAAqB,EAC5B,MAAM,EAAE,cAAc,GACrB,iBAAiB,EAAE,CAkJrB;AAED,uDAAuD;AACvD,wBAAgB,OAAO,CACrB,KAAK,EAAE,qBAAqB,EAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,iBAAiB,CAOnB"}

package/dist/registry/entry_validation.js

@@ -0,0 +1,171 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isInside, isSafeCatalogueRoute, isSafeRepositoryPath, } from "../config/paths.js";
+import { isCatalogueId } from "../navigation/logical.js";
+/** Validate metadata, routes, source attribution, and declared paths. */
+export function validateEntry(entry, config) {
+    const violations = [];
+    for (const field of ["id", "title", "description"]) {
+        if (!nonEmpty(entry[field])) {
+            violations.push(problem(entry, "missing-metadata", `${field} is required`));
+        }
+    }
+    if (!isCatalogueId(entry.id)) {
+        violations.push(problem(entry, "invalid-id", "id must be globally unique kebab-case"));
+    }
+    if (entry.__viaDefine !== true) {
+        violations.push(problem(entry, "missing-helper", "entry must be created with a define helper"));
+    }
+    if (entry.sourceRelativePath === "<unattributed>" ||
+        !isInside(config.entriesDir, entry.sourcePath)) {
+        violations.push(problem(entry, "invalid-source", "definition is not attributed to entriesDir"));
+    }
+    validatePaths(entry, "relatedDocs", entry.relatedDocs, config, violations);
+    validatePaths(entry, "dependencies", entry.dependencies, config, violations);
+    if (entry.rationale !== undefined && !nonEmpty(entry.rationale)) {
+        violations.push(problem(entry, "invalid-metadata", "rationale must be non-empty when supplied"));
+    }
+    validateTags(entry, violations);
+    if (entry.kind === "collection") {
+        validateTextList(entry, "childIds", entry.childIds, false, violations);
+    }
+    else {
+        validateRoute(entry, violations);
+    }
+    if (entry.kind === "page") {
+        if (typeof entry.render !== "function")
+            violations.push(problem(entry, "missing-render", "page render callback is required"));
+        for (const field of [
+            "mobile",
+            "desktop",
+            "colorSchemes",
+            "address",
+            "useCaseIds",
+            "steps",
+            "childIds",
+            "viewports",
+            "fragments",
+            "darkFragments",
+        ]) {
+            if (field in entry)
+                violations.push(problem(entry, "invalid-page-field", `pages do not support ${field}`));
+        }
+    }
+    if (entry.kind === "screen" || entry.kind === "component") {
+        if (entry.colorSchemes !== undefined) {
+            const validSchemes = validColorSchemes(entry.colorSchemes);
+            if (!validSchemes) {
+                violations.push(problem(entry, "invalid-color-schemes", 'colorSchemes must be a non-empty subset of ["light", "dark"] that includes "light"'));
+            }
+            else if (entry.colorSchemes.includes("dark") &&
+                !config.colorSchemes.includes("dark")) {
+                violations.push(problem(entry, "unsupported-color-scheme", 'screen declares "dark" but config colorSchemes is light-only'));
+            }
+        }
+    }
+    if (entry.kind === "screen") {
+        if (entry.mobile === null || entry.mobile === undefined) {
+            violations.push(problem(entry, "missing-render", "mobile render is required"));
+        }
+        if (entry.desktop === null || entry.desktop === undefined) {
+            violations.push(problem(entry, "missing-render", "desktop render is required"));
+        }
+        validateTextList(entry, "useCaseIds", entry.useCaseIds, true, violations);
+    }
+    if (entry.kind === "use-case" &&
+        (!Array.isArray(entry.steps) || entry.steps.length === 0)) {
+        violations.push(problem(entry, "missing-step", "use case needs at least one screen step"));
+    }
+    else if (entry.kind === "use-case") {
+        for (const [index, step] of entry.steps.entries()) {
+            if (!record(step) || !nonEmpty(step.screenId)) {
+                violations.push(problem(entry, "invalid-step", `step #${index + 1} needs a non-empty screenId`));
+                continue;
+            }
+            for (const field of ["title", "description"]) {
+                if (step[field] !== undefined && !nonEmpty(step[field])) {
+                    violations.push(problem(entry, "invalid-step", `step #${index + 1} ${field} must be non-empty when supplied`));
+                }
+            }
+        }
+    }
+    return violations;
+}
+/** Create one source-attributed registry violation. */
+export function problem(entry, code, message) {
+    return {
+        code,
+        id: entry.id,
+        message,
+        sourceRelativePath: entry.sourceRelativePath,
+    };
+}
+function validateRoute(entry, violations) {
+    const route = "route" in entry ? entry.route : "";
+    const invalid = !nonEmpty(route) || !isSafeCatalogueRoute(route);
+    if (invalid) {
+        violations.push(problem(entry, "invalid-route", "route must use portable URL-safe segments and end in .html"));
+    }
+    if (entry.kind === "screen" && route.endsWith("/index.html")) {
+        violations.push(problem(entry, "invalid-route", "screen routes must name the screen"));
+    }
+    if (entry.kind === "use-case" && !route.startsWith("user-flows/")) {
+        violations.push(problem(entry, "invalid-route", "use-case routes must live under user-flows/"));
+    }
+}
+function validateTags(entry, violations) {
+    if (entry.kind === "collection") {
+        if ("tags" in entry) {
+            violations.push(problem(entry, "invalid-tags", "tags are not supported on collections"));
+        }
+        return;
+    }
+    const tags = entry.tags;
+    if (tags === undefined)
+        return;
+    if (!Array.isArray(tags) || !tags.every(isCatalogueId)) {
+        violations.push(problem(entry, "invalid-tags", "tags must be an array of lowercase kebab-case strings"));
+        return;
+    }
+    if (new Set(tags).size !== tags.length) {
+        violations.push(problem(entry, "invalid-tags", "tags must not contain duplicates"));
+    }
+}
+function validatePaths(entry, field, values, config, violations) {
+    if (!validateTextList(entry, field, values, true, violations))
+        return;
+    for (const value of values) {
+        if (!isSafeRepositoryPath(value)) {
+            violations.push(problem(entry, `invalid-${field}`, `${field} path must be a safe repository-relative path: ${value}`));
+            continue;
+        }
+        const candidate = path.resolve(config.repoRoot, value);
+        if (!isInside(config.repoRoot, candidate) || !fs.existsSync(candidate)) {
+            violations.push(problem(entry, `missing-${field}`, `${field} path does not exist: ${value}`));
+        }
+    }
+}
+function validateTextList(entry, field, value, allowEmpty, violations) {
+    const invalid = !Array.isArray(value) ||
+        (!allowEmpty && value.length === 0) ||
+        !value.every(nonEmpty);
+    if (invalid) {
+        violations.push(problem(entry, "invalid-metadata", `${field} must be ${allowEmpty ? "an" : "a non-empty"} array of strings`));
+        return false;
+    }
+    return true;
+}
+function nonEmpty(value) {
+    return typeof value === "string" && value.trim().length > 0;
+}
+function validColorSchemes(value) {
+    return (Array.isArray(value) &&
+        value.length > 0 &&
+        value.every((scheme) => scheme === "light" || scheme === "dark") &&
+        new Set(value).size === value.length &&
+        value.includes("light"));
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=entry_validation.js.map

package/dist/registry/entry_validation.js.map

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

package/dist/registry/hierarchy.d.ts

@@ -0,0 +1,29 @@
+/** Entry fields needed to analyze collection membership. */
+export interface HierarchyEntry {
+    childIds?: unknown;
+    id: string;
+    kind: string;
+    title: string;
+}
+/** Structural collection-forest violation. */
+export interface HierarchyIssue<T extends HierarchyEntry> {
+    code: "collection-cycle" | "duplicate-child" | "missing-child" | "multiple-parents";
+    entry: T;
+    message: string;
+}
+/** Canonical collection forest derived from entry relationships. */
+export interface CatalogueHierarchy<T extends HierarchyEntry> {
+    ancestorsById: ReadonlyMap<string, readonly T[]>;
+    byId: ReadonlyMap<string, T>;
+    childrenById: ReadonlyMap<string, readonly T[]>;
+    parentById: ReadonlyMap<string, T>;
+    roots: readonly T[];
+}
+/** Hierarchy data plus any structural issues found while deriving it. */
+export interface HierarchyAnalysis<T extends HierarchyEntry> {
+    hierarchy: CatalogueHierarchy<T>;
+    issues: readonly HierarchyIssue<T>[];
+}
+/** Derive a cycle-guarded collection forest and deterministic diagnostics. */
+export declare function analyzeHierarchy<T extends HierarchyEntry>(entries: readonly T[]): HierarchyAnalysis<T>;
+//# sourceMappingURL=hierarchy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../src/registry/hierarchy.ts"],"names":[],"mappings":"AAAA,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,8CAA8C;AAC9C,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,cAAc;IACtD,IAAI,EACA,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,kBAAkB,CAAC;IACvB,KAAK,EAAE,CAAC,CAAC;IACT,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,oEAAoE;AACpE,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,cAAc;IAC1D,aAAa,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACjD,IAAI,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC7B,YAAY,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IAChD,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACnC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;CACrB;AAED,yEAAyE;AACzE,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,cAAc;IACzD,SAAS,EAAE,kBAAkB,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,EAAE,SAAS,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;CACtC;AAED,8EAA8E;AAC9E,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,cAAc,EACvD,OAAO,EAAE,SAAS,CAAC,EAAE,GACpB,iBAAiB,CAAC,CAAC,CAAC,CAkEtB"}

package/dist/registry/hierarchy.js

@@ -0,0 +1,155 @@
+/** Derive a cycle-guarded collection forest and deterministic diagnostics. */
+export function analyzeHierarchy(entries) {
+    const ordered = [...entries].sort(compareEntries);
+    const byId = new Map();
+    for (const entry of ordered) {
+        if (!byId.has(entry.id))
+            byId.set(entry.id, entry);
+    }
+    const collections = [...byId.values()].filter(isCollection);
+    const childrenById = new Map();
+    const parentById = new Map();
+    const collectionEdges = new Map();
+    const issues = [];
+    for (const collection of collections) {
+        const seen = new Set();
+        const children = [];
+        const collectionChildren = [];
+        for (const childId of validChildIds(collection)) {
+            if (seen.has(childId)) {
+                issues.push({
+                    code: "duplicate-child",
+                    entry: collection,
+                    message: `child id "${childId}" is listed more than once`,
+                });
+                continue;
+            }
+            seen.add(childId);
+            const child = byId.get(childId);
+            if (!child) {
+                issues.push({
+                    code: "missing-child",
+                    entry: collection,
+                    message: `unknown child id: ${childId}`,
+                });
+                continue;
+            }
+            children.push(child);
+            if (child.kind === "collection")
+                collectionChildren.push(childId);
+            const currentParent = parentById.get(childId);
+            if (currentParent && currentParent.id !== collection.id) {
+                issues.push({
+                    code: "multiple-parents",
+                    entry: collection,
+                    message: `child ${childId} is already claimed by collection ${currentParent.id}`,
+                });
+            }
+            else if (!currentParent) {
+                parentById.set(childId, collection);
+            }
+        }
+        childrenById.set(collection.id, children);
+        collectionEdges.set(collection.id, collectionChildren.sort());
+    }
+    issues.push(...cycleIssues(collections, collectionEdges, byId));
+    const ancestorsById = new Map();
+    for (const entry of byId.values()) {
+        ancestorsById.set(entry.id, ancestors(entry, parentById));
+    }
+    const roots = [...byId.values()]
+        .filter((entry) => !parentById.has(entry.id))
+        .sort(compareEntries);
+    return {
+        hierarchy: { ancestorsById, byId, childrenById, parentById, roots },
+        issues,
+    };
+}
+function ancestors(entry, parentById) {
+    const result = [];
+    const visited = new Set([entry.id]);
+    let parent = parentById.get(entry.id);
+    while (parent) {
+        if (visited.has(parent.id))
+            return [];
+        visited.add(parent.id);
+        result.push(parent);
+        parent = parentById.get(parent.id);
+    }
+    return result.reverse();
+}
+function cycleIssues(collections, edges, byId) {
+    const finished = new Set();
+    const issues = [];
+    const reported = new Set();
+    for (const collection of collections) {
+        if (finished.has(collection.id))
+            continue;
+        const stack = [
+            { id: collection.id, nextChild: 0 },
+        ];
+        const activeIndex = new Map();
+        while (stack.length > 0) {
+            const frame = stack.at(-1);
+            if (!frame)
+                break;
+            if (!activeIndex.has(frame.id)) {
+                activeIndex.set(frame.id, stack.length - 1);
+            }
+            const children = edges.get(frame.id) ?? [];
+            const childId = children[frame.nextChild];
+            if (childId === undefined) {
+                finished.add(frame.id);
+                activeIndex.delete(frame.id);
+                stack.pop();
+                continue;
+            }
+            frame.nextChild += 1;
+            const cycleStart = activeIndex.get(childId);
+            if (cycleStart !== undefined) {
+                const cycle = normalizeCycle([
+                    ...stack.slice(cycleStart).map(({ id }) => id),
+                    childId,
+                ]);
+                const signature = cycle.join(" -> ");
+                const owner = byId.get(frame.id);
+                if (owner && !reported.has(signature)) {
+                    reported.add(signature);
+                    issues.push({
+                        code: "collection-cycle",
+                        entry: owner,
+                        message: `collection cycle: ${signature}`,
+                    });
+                }
+            }
+            else if (!finished.has(childId)) {
+                stack.push({ id: childId, nextChild: 0 });
+            }
+        }
+    }
+    return issues;
+}
+function normalizeCycle(cycle) {
+    const nodes = cycle.slice(0, -1);
+    let first = 0;
+    for (let index = 1; index < nodes.length; index += 1) {
+        if ((nodes[index] ?? "").localeCompare(nodes[first] ?? "") < 0) {
+            first = index;
+        }
+    }
+    const rotated = [...nodes.slice(first), ...nodes.slice(0, first)];
+    return [...rotated, rotated[0] ?? ""];
+}
+function validChildIds(entry) {
+    return Array.isArray(entry.childIds) &&
+        entry.childIds.every((value) => typeof value === "string")
+        ? entry.childIds
+        : [];
+}
+function isCollection(entry) {
+    return entry.kind === "collection";
+}
+function compareEntries(left, right) {
+    return left.id.localeCompare(right.id);
+}
+//# sourceMappingURL=hierarchy.js.map

package/dist/registry/hierarchy.js.map

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

package/dist/registry/manifest.d.ts

@@ -0,0 +1,28 @@
+import type { ColorScheme, ResolvedRegistryEntry, Viewport } from "../authoring/types.js";
+import type { ResolvedConfig } from "../config/types.js";
+import type { ComponentViewRecord } from "../components/manifest_types.js";
+import type { ManifestV5, HistoricalManifest } from "./types.js";
+/** Canonical generated manifest filename. */
+export declare const MANIFEST_NAME = "mokly-manifest.json";
+/** Former package manifest filename accepted only from Git history. */
+export declare const FORMER_MANIFEST_NAME = "mokabook-manifest.json";
+/** Legacy version 2 manifest filename accepted only during migration. */
+export declare const LEGACY_MANIFEST_NAME = "mockbook-manifest.json";
+/** Derive one viewport and color-scheme fragment route from a screen route. */
+export declare function fragmentRoute(route: string, viewport: Viewport, colorScheme?: ColorScheme): string;
+/** Create deterministic manifest data from prepared entries and the source inventory. */
+export declare function createManifest(entries: readonly ResolvedRegistryEntry[], sourceFiles: readonly string[], catalogueSchemes: readonly ColorScheme[], componentViews?: ReadonlyMap<string, ComponentViewRecord>): ManifestV5;
+/** Serialize the current manifest with canonical object-key ordering. */
+export declare function serializeManifest(manifest: ManifestV5): string;
+/** Read strictly current schema-v5 canonical output. */
+export declare function readManifest(config: ResolvedConfig): ManifestV5;
+/** Select the strict canonical input or the explicitly enabled legacy input. */
+export declare function selectManifestInput(canonicalExists: boolean, formerExists: boolean, allowLegacyV2: boolean): {
+    allowV2: boolean;
+    filename: string;
+};
+/** Validate manifest-shaped JSON and normalize temporary version 2 input. */
+export declare function parseManifest(value: unknown): ManifestV5;
+/** Read old schemas only at the historical comparison boundary. */
+export declare function parseHistoricalManifest(value: unknown, allowV2?: boolean): HistoricalManifest;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/registry/manifest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,WAAW,EACX,qBAAqB,EACrB,QAAQ,EACT,MAAM,uBAAuB,CAAC;AAC/B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAIzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAGjE,6CAA6C;AAC7C,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,uEAAuE;AACvE,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAE7D,yEAAyE;AACzE,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAE7D,+EAA+E;AAC/E,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,WAAW,GAAE,WAAqB,GACjC,MAAM,CAGR;AAED,yFAAyF;AACzF,wBAAgB,cAAc,CAC5B,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,WAAW,EAAE,SAAS,MAAM,EAAE,EAC9B,gBAAgB,EAAE,SAAS,WAAW,EAAE,EACxC,cAAc,GAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAa,GACnE,UAAU,CAsBZ;AAED,yEAAyE;AACzE,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,UAAU,GAAG,MAAM,CAE9D;AAED,wDAAwD;AACxD,wBAAgB,YAAY,CAAC,MAAM,EAAE,cAAc,GAAG,UAAU,CAK/D;AAED,gFAAgF;AAChF,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,OAAO,EACxB,YAAY,EAAE,OAAO,EACrB,aAAa,EAAE,OAAO,GACrB;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CASxC;AAkBD,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAExD;AAED,mEAAmE;AACnE,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,EACd,OAAO,UAAQ,GACd,kBAAkB,CAEpB"}