@mokly/mokly 0.8.0

package/dist/config/module_resolution.js.map

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

package/dist/config/path_validation.d.ts

@@ -0,0 +1,16 @@
+import { type MoklyErrorCode } from "../errors.js";
+interface ReviewOutBoundary {
+    entriesDir: string;
+    mockupsDir: string;
+    repoRoot: string;
+}
+/** Resolve an optional consumer module and require a regular file. */
+export declare function optionalModule(repoRoot: string, configDir: string, value: string | undefined, label: string): string | undefined;
+/** Require a configured directory to exist. */
+export declare function requireDirectory(value: string, label: string): void;
+/** Reject source roots whose ownership cannot be distinguished. */
+export declare function validateSourceRoots(repoRoot: string, entriesDir: string, mockupsDir: string): void;
+/** Keep destructive Review replacement away from source and output roots. */
+export declare function validateReviewOut(reviewOut: string, boundary: ReviewOutBoundary, label?: string, code?: MoklyErrorCode): void;
+export {};
+//# sourceMappingURL=path_validation.d.ts.map

package/dist/config/path_validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path_validation.d.ts","sourceRoot":"","sources":["../../src/config/path_validation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAc,KAAK,cAAc,EAAE,MAAM,cAAc,CAAC;AAI/D,UAAU,iBAAiB;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,sEAAsE;AACtE,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,KAAK,EAAE,MAAM,GACZ,MAAM,GAAG,SAAS,CAYpB;AAED,+CAA+C;AAC/C,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAOnE;AAED,mEAAmE;AACnE,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,GACjB,IAAI,CAQN;AAED,6EAA6E;AAC7E,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,iBAAiB,EAC3B,KAAK,SAAkB,EACvB,IAAI,GAAE,cAAiC,GACtC,IAAI,CAoCN"}

package/dist/config/path_validation.js

@@ -0,0 +1,60 @@
+import fs from "node:fs";
+import { MoklyError } from "../errors.js";
+import { isInside, projectRealPath, resolveInside } from "./paths.js";
+import { requireString } from "./rules.js";
+/** Resolve an optional consumer module and require a regular file. */
+export function optionalModule(repoRoot, configDir, value, label) {
+    if (value === undefined)
+        return undefined;
+    requireString(value, label);
+    const resolved = resolveInside(repoRoot, configDir, value, label);
+    if (!fs.existsSync(resolved) || !fs.statSync(resolved).isFile()) {
+        throw new MoklyError("config-invalid", `${label} does not name a file: ${value}`);
+    }
+    requireRealInside(repoRoot, resolved, label);
+    return resolved;
+}
+/** Require a configured directory to exist. */
+export function requireDirectory(value, label) {
+    if (!fs.existsSync(value) || !fs.statSync(value).isDirectory()) {
+        throw new MoklyError("config-invalid", `${label} does not name a directory: ${value}`);
+    }
+}
+/** Reject source roots whose ownership cannot be distinguished. */
+export function validateSourceRoots(repoRoot, entriesDir, mockupsDir) {
+    const realEntries = requireRealInside(repoRoot, entriesDir, "entriesDir");
+    const realMockups = requireRealInside(repoRoot, mockupsDir, "mockupsDir");
+    if (entriesDir === mockupsDir || realEntries === realMockups)
+        throw new MoklyError("config-invalid", "authored source directories must not equal mockupsDir");
+}
+/** Keep destructive Review replacement away from source and output roots. */
+export function validateReviewOut(reviewOut, boundary, label = "review.outDir", code = "config-invalid") {
+    const { entriesDir, mockupsDir, repoRoot } = boundary;
+    const protectedRoots = [mockupsDir, entriesDir];
+    const realRepoRoot = fs.realpathSync(repoRoot);
+    const realReviewOut = projectRealPath(reviewOut);
+    const realProtectedRoots = protectedRoots.map((root) => fs.realpathSync(root));
+    if (reviewOut === repoRoot ||
+        (!isInside(repoRoot, reviewOut) && !isInside(realRepoRoot, reviewOut)) ||
+        !isInside(realRepoRoot, realReviewOut) ||
+        protectedRoots.some((root) => reviewOut === root ||
+            isInside(reviewOut, root) ||
+            isInside(root, reviewOut)) ||
+        realProtectedRoots.some((root) => realReviewOut === root ||
+            isInside(realReviewOut, root) ||
+            isInside(root, realReviewOut))) {
+        if (!isInside(realRepoRoot, realReviewOut)) {
+            throw new MoklyError(code, `${label} resolves outside repoRoot through a symlink`);
+        }
+        throw new MoklyError(code, `${label} must not overlap repository, mockup, or source roots`);
+    }
+}
+function requireRealInside(repoRoot, candidate, label) {
+    const realRepoRoot = fs.realpathSync(repoRoot);
+    const realCandidate = fs.realpathSync(candidate);
+    if (!isInside(realRepoRoot, realCandidate)) {
+        throw new MoklyError("config-invalid", `${label} resolves outside repoRoot through a symlink`);
+    }
+    return realCandidate;
+}
+//# sourceMappingURL=path_validation.js.map

package/dist/config/path_validation.js.map

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

package/dist/config/paths.d.ts

@@ -0,0 +1,21 @@
+/** Convert a platform path to stable POSIX separators. */
+export declare function toPosixPath(value: string): string;
+/** Resolve a configured path and require it to stay inside the repository. */
+export declare function resolveInside(repoRoot: string, fromDir: string, value: string, label: string): string;
+/** Require a route-like value to be safe, relative, and POSIX-normalized. */
+export declare function validateRelativeRoute(value: string, label: string): string;
+/** Normalize and require a portable static catalogue `.html` route. */
+export declare function validateCatalogueRoute(value: string, label: string): string;
+/** Return whether a catalogue route is portable as both a path and a URL. */
+export declare function isSafeCatalogueRoute(value: string): boolean;
+/** Return whether every path segment is portable and URL-unreserved. */
+export declare function isPortableUrlPath(value: string): boolean;
+/** Percent-encode path segments while retaining their slash hierarchy. */
+export declare function encodeUrlPath(value: string): string;
+/** Return whether a value is a canonical, portable repository-relative path. */
+export declare function isSafeRepositoryPath(value: string): boolean;
+/** Return whether a candidate path is contained by a configured root. */
+export declare function isInside(root: string, candidate: string): boolean;
+/** Resolve existing symlinks while projecting a path that may not exist yet. */
+export declare function projectRealPath(candidate: string): string;
+//# sourceMappingURL=paths.d.ts.map

package/dist/config/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/config/paths.ts"],"names":[],"mappings":"AAQA,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED,8EAA8E;AAC9E,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GACZ,MAAM,CAiBR;AAED,6EAA6E;AAC7E,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAc1E;AAED,uEAAuE;AACvE,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAS3E;AAED,6EAA6E;AAC7E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wEAAwE;AACxE,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAYxD;AAED,0EAA0E;AAC1E,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAUnD;AAED,gFAAgF;AAChF,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAW3D;AAED,yEAAyE;AACzE,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAQjE;AAED,gFAAgF;AAChF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAUzD"}

package/dist/config/paths.js

@@ -0,0 +1,107 @@
+import fs from "node:fs";
+import path from "node:path";
+import { MoklyError } from "../errors.js";
+const PORTABLE_URL_SEGMENT = /^[A-Za-z0-9][A-Za-z0-9._~-]*$/;
+const WINDOWS_DEVICE = /^(?:aux|con|nul|prn|com[1-9]|lpt[1-9])$/i;
+/** Convert a platform path to stable POSIX separators. */
+export function toPosixPath(value) {
+    return value.split(path.sep).join("/");
+}
+/** Resolve a configured path and require it to stay inside the repository. */
+export function resolveInside(repoRoot, fromDir, value, label) {
+    if (value.trim().length === 0) {
+        throw new MoklyError("config-invalid", `${label} must not be empty`);
+    }
+    const resolved = path.resolve(fromDir, value);
+    const relative = path.relative(repoRoot, resolved);
+    if (relative === ".." ||
+        relative.startsWith(`..${path.sep}`) ||
+        path.isAbsolute(relative)) {
+        throw new MoklyError("config-invalid", `${label} resolves outside repoRoot: ${toPosixPath(relative)}`);
+    }
+    return resolved;
+}
+/** Require a route-like value to be safe, relative, and POSIX-normalized. */
+export function validateRelativeRoute(value, label) {
+    const normalized = value.replaceAll("\\", "/");
+    if (normalized.length === 0 ||
+        normalized.startsWith("/") ||
+        normalized.split("/").includes("..") ||
+        normalized.includes("\0")) {
+        throw new MoklyError("config-invalid", `${label} must be a safe relative path`);
+    }
+    return normalized.replace(/^\.\//, "");
+}
+/** Normalize and require a portable static catalogue `.html` route. */
+export function validateCatalogueRoute(value, label) {
+    const normalized = validateRelativeRoute(value, label);
+    if (!isSafeCatalogueRoute(normalized)) {
+        throw new MoklyError("config-invalid", `${label} must use portable URL-safe path segments and end in .html`);
+    }
+    return normalized;
+}
+/** Return whether a catalogue route is portable as both a path and a URL. */
+export function isSafeCatalogueRoute(value) {
+    return value.endsWith(".html") && isPortableUrlPath(value);
+}
+/** Return whether every path segment is portable and URL-unreserved. */
+export function isPortableUrlPath(value) {
+    return (isSafeRepositoryPath(value) &&
+        value.split("/").every((segment) => {
+            const stem = segment.split(".", 1)[0] ?? "";
+            return (PORTABLE_URL_SEGMENT.test(segment) &&
+                !segment.endsWith(".") &&
+                !WINDOWS_DEVICE.test(stem));
+        }));
+}
+/** Percent-encode path segments while retaining their slash hierarchy. */
+export function encodeUrlPath(value) {
+    return value
+        .split("/")
+        .map((segment) => encodeURIComponent(segment).replace(/[!'()*]/g, (character) => `%${character.charCodeAt(0).toString(16).toUpperCase()}`))
+        .join("/");
+}
+/** Return whether a value is a canonical, portable repository-relative path. */
+export function isSafeRepositoryPath(value) {
+    return (value.length > 0 &&
+        !value.startsWith("/") &&
+        !value.includes("\\") &&
+        !value.includes(":") &&
+        !value.includes("\0") &&
+        !value
+            .split("/")
+            .some((part) => part === "" || part === "." || part === ".."));
+}
+/** Return whether a candidate path is contained by a configured root. */
+export function isInside(root, candidate) {
+    const relative = path.relative(root, candidate);
+    return (relative === "" ||
+        (!path.isAbsolute(relative) &&
+            !relative.startsWith(`..${path.sep}`) &&
+            relative !== ".."));
+}
+/** Resolve existing symlinks while projecting a path that may not exist yet. */
+export function projectRealPath(candidate) {
+    const missingParts = [];
+    let existing = candidate;
+    while (!lexicallyExists(existing)) {
+        const parent = path.dirname(existing);
+        if (parent === existing)
+            return candidate;
+        missingParts.unshift(path.basename(existing));
+        existing = parent;
+    }
+    return path.resolve(fs.realpathSync.native(existing), ...missingParts);
+}
+function lexicallyExists(candidate) {
+    try {
+        fs.lstatSync(candidate);
+        return true;
+    }
+    catch (error) {
+        if (error.code === "ENOENT")
+            return false;
+        throw error;
+    }
+}
+//# sourceMappingURL=paths.js.map

package/dist/config/paths.js.map

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

package/dist/config/public_files.d.ts

@@ -0,0 +1,13 @@
+import { type FileLocation } from "./file_locations.js";
+import type { ResolvedConfig } from "./types.js";
+/** Catalogue manifests are internal even when requested through another path. */
+export declare function isInternalCatalogueFile(candidate: string, config: ResolvedConfig): boolean;
+/** Shared denial policy for generated references, HTTP, export, and Review. */
+export declare function isPrivateStaticPath(candidate: string, config: ResolvedConfig): boolean;
+/** Locate a public path, retaining confined missing paths for deletion handling. */
+export declare function publicPathLocation(candidate: string, config: ResolvedConfig): FileLocation | undefined;
+/** Locate a public regular file for readers that must use its validated target. */
+export declare function publicFileLocation(candidate: string, config: ResolvedConfig): FileLocation | undefined;
+/** Return whether a path names a public regular file beneath the output root. */
+export declare function isPublicStaticFile(candidate: string, config: ResolvedConfig): boolean;
+//# sourceMappingURL=public_files.d.ts.map

package/dist/config/public_files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_files.d.ts","sourceRoot":"","sources":["../../src/config/public_files.ts"],"names":[],"mappings":"AASA,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,iFAAiF;AACjF,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,OAAO,CAWT;AAED,+EAA+E;AAC/E,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,OAAO,CAKT;AAED,oFAAoF;AACpF,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,YAAY,GAAG,SAAS,CAQ1B;AAED,mFAAmF;AACnF,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,YAAY,GAAG,SAAS,CAQ1B;AAED,iFAAiF;AACjF,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,cAAc,GACrB,OAAO,CAET"}

package/dist/config/public_files.js

@@ -0,0 +1,51 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isAuthoringSource } from "../build/source_inventory.js";
+import { FORMER_MANIFEST_NAME, LEGACY_MANIFEST_NAME, MANIFEST_NAME, } from "../registry/manifest.js";
+import { locatePath } from "./file_locations.js";
+import { projectRealPath } from "./paths.js";
+/** Catalogue manifests are internal even when requested through another path. */
+export function isInternalCatalogueFile(candidate, config) {
+    const internal = [
+        MANIFEST_NAME,
+        FORMER_MANIFEST_NAME,
+        LEGACY_MANIFEST_NAME,
+    ].map((name) => path.join(config.mockupsDir, name));
+    if (internal.includes(candidate))
+        return true;
+    const realCandidate = projectRealPath(candidate);
+    return internal.some((file) => fs.existsSync(file) && realCandidate === fs.realpathSync(file));
+}
+/** Shared denial policy for generated references, HTTP, export, and Review. */
+export function isPrivateStaticPath(candidate, config) {
+    return (isInternalCatalogueFile(candidate, config) ||
+        isAuthoringSource(candidate, config));
+}
+/** Locate a public path, retaining confined missing paths for deletion handling. */
+export function publicPathLocation(candidate, config) {
+    try {
+        const location = locatePath(candidate, config.mockupsDir, config.repoRoot);
+        if (!location || isPrivateStaticPath(location.logicalPath, config))
+            return;
+        return location;
+    }
+    catch {
+        return;
+    }
+}
+/** Locate a public regular file for readers that must use its validated target. */
+export function publicFileLocation(candidate, config) {
+    const location = publicPathLocation(candidate, config);
+    try {
+        if (location && fs.statSync(location.physicalPath).isFile())
+            return location;
+    }
+    catch {
+        return;
+    }
+}
+/** Return whether a path names a public regular file beneath the output root. */
+export function isPublicStaticFile(candidate, config) {
+    return publicFileLocation(candidate, config) !== undefined;
+}
+//# sourceMappingURL=public_files.js.map

package/dist/config/public_files.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"public_files.js","sourceRoot":"","sources":["../../src/config/public_files.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EACL,oBAAoB,EACpB,oBAAoB,EACpB,aAAa,GACd,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,UAAU,EAAqB,MAAM,qBAAqB,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAG7C,iFAAiF;AACjF,MAAM,UAAU,uBAAuB,CACrC,SAAiB,EACjB,MAAsB;IAEtB,MAAM,QAAQ,GAAG;QACf,aAAa;QACb,oBAAoB;QACpB,oBAAoB;KACrB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC;IACpD,IAAI,QAAQ,CAAC,QAAQ,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC9C,MAAM,aAAa,GAAG,eAAe,CAAC,SAAS,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC,IAAI,CAClB,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,aAAa,KAAK,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CACzE,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,mBAAmB,CACjC,SAAiB,EACjB,MAAsB;IAEtB,OAAO,CACL,uBAAuB,CAAC,SAAS,EAAE,MAAM,CAAC;QAC1C,iBAAiB,CAAC,SAAS,EAAE,MAAM,CAAC,CACrC,CAAC;AACJ,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,MAAsB;IAEtB,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,UAAU,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAC3E,IAAI,CAAC,QAAQ,IAAI,mBAAmB,CAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;YAAE,OAAO;QAC3E,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,MAAsB;IAEtB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IACvD,IAAI,CAAC;QACH,IAAI,QAAQ,IAAI,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE;YACzD,OAAO,QAAQ,CAAC;IACpB,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;AACH,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,kBAAkB,CAChC,SAAiB,EACjB,MAAsB;IAEtB,OAAO,kBAAkB,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,SAAS,CAAC;AAC7D,CAAC"}

package/dist/config/rules.d.ts

@@ -0,0 +1,15 @@
+import type { ColorScheme } from "../authoring/types.js";
+import type { StylesheetRule, WatchRule } from "./types.js";
+/** Validate and normalize the configured color-scheme rendering targets. */
+export declare function validateColorSchemes(value: unknown): ColorScheme[];
+/** Validate ordered route-to-stylesheet rules. */
+export declare function validateStylesheets(rules: readonly StylesheetRule[]): StylesheetRule[];
+/** Validate explicit watch classifications and reject ambiguity. */
+export declare function validateWatchRules(rules: readonly WatchRule[]): WatchRule[];
+/** Normalize and bound the watch debounce duration. */
+export declare function validateDebounce(value: number | undefined): number;
+/** Require a non-empty string while narrowing runtime input. */
+export declare function requireString(value: unknown, label: string): asserts value is string;
+/** Validate a config list whose members must be non-empty strings. */
+export declare function validateStringArray(value: readonly string[], label: string): string[];
+//# sourceMappingURL=rules.d.ts.map

package/dist/config/rules.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rules.d.ts","sourceRoot":"","sources":["../../src/config/rules.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAGzD,OAAO,KAAK,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAI5D,4EAA4E;AAC5E,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,WAAW,EAAE,CA4BlE;AAED,kDAAkD;AAClD,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,cAAc,EAAE,GAC/B,cAAc,EAAE,CAuDlB;AAqED,oEAAoE;AACpE,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,SAAS,EAAE,GAAG,SAAS,EAAE,CAqC3E;AAMD,uDAAuD;AACvD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CASlE;AAED,gEAAgE;AAChE,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,EACd,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,KAAK,IAAI,MAAM,CAOzB;AAED,sEAAsE;AACtE,wBAAgB,mBAAmB,CACjC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,KAAK,EAAE,MAAM,GACZ,MAAM,EAAE,CAWV"}

package/dist/config/rules.js

@@ -0,0 +1,153 @@
+import { MoklyError } from "../errors.js";
+import { validateRelativeRoute } from "./paths.js";
+const WATCH_ACTIONS = new Set(["ignore", "rebuild", "reload", "restart"]);
+/** Validate and normalize the configured color-scheme rendering targets. */
+export function validateColorSchemes(value) {
+    if (value === undefined)
+        return ["light"];
+    if (!Array.isArray(value) || value.length === 0) {
+        throw new MoklyError("config-invalid", "colorSchemes must be a non-empty array");
+    }
+    const schemes = new Set();
+    for (const scheme of value) {
+        if (scheme !== "light" && scheme !== "dark") {
+            throw new MoklyError("config-invalid", `colorSchemes contains an unknown value: ${String(scheme)}`);
+        }
+        if (schemes.has(scheme)) {
+            throw new MoklyError("config-invalid", `duplicate colorSchemes value: ${scheme}`);
+        }
+        schemes.add(scheme);
+    }
+    if (!schemes.has("light")) {
+        throw new MoklyError("config-invalid", 'colorSchemes must include "light"');
+    }
+    return schemes.has("dark") ? ["light", "dark"] : ["light"];
+}
+/** Validate ordered route-to-stylesheet rules. */
+export function validateStylesheets(rules) {
+    if (!Array.isArray(rules)) {
+        throw new MoklyError("config-invalid", "stylesheets must be an array");
+    }
+    const seen = new Set();
+    return rules.map((rawRule, index) => {
+        if (!record(rawRule)) {
+            throw new MoklyError("config-invalid", `stylesheets[${index}] must be an object`);
+        }
+        const rule = rawRule;
+        requireString(rule.match, `stylesheets[${index}].match`);
+        if (seen.has(rule.match)) {
+            throw new MoklyError("config-invalid", `duplicate stylesheet match: ${rule.match}`);
+        }
+        seen.add(rule.match);
+        if (!Array.isArray(rule.stylesheets)) {
+            throw new MoklyError("config-invalid", `stylesheets[${index}].stylesheets must be an array`);
+        }
+        const normalized = {
+            match: rule.match,
+            stylesheets: validateStylesheetPaths(rule.stylesheets, `stylesheets[${index}] path`),
+            ...(rule.lightStylesheets !== undefined
+                ? {
+                    lightStylesheets: validateOptionalStylesheetPaths(rule.lightStylesheets, index, "lightStylesheets"),
+                }
+                : {}),
+            ...(rule.darkStylesheets !== undefined
+                ? {
+                    darkStylesheets: validateOptionalStylesheetPaths(rule.darkStylesheets, index, "darkStylesheets"),
+                }
+                : {}),
+        };
+        validateRuleStylesheetLinks(normalized, index);
+        return normalized;
+    });
+}
+function validateOptionalStylesheetPaths(value, index, field) {
+    if (!Array.isArray(value)) {
+        throw new MoklyError("config-invalid", `stylesheets[${index}].${field} must be an array`);
+    }
+    return validateStylesheetPaths(value, `stylesheets[${index}].${field} path`);
+}
+/**
+ * Reject stylesheet paths one rule would link twice into a single fragment.
+ * Every fragment links the shared list followed by the list for its own scheme,
+ * so a path repeated inside one list, or shared by the common list and a
+ * per-scheme list, double-links; the same path in both per-scheme lists is fine
+ * because no fragment links both. Separate rules may reuse a path freely.
+ */
+function validateRuleStylesheetLinks(rule, index) {
+    validateUniqueStylesheetPaths([], rule.stylesheets, index, "stylesheets");
+    validateUniqueStylesheetPaths(rule.stylesheets, rule.lightStylesheets ?? [], index, "lightStylesheets");
+    validateUniqueStylesheetPaths(rule.stylesheets, rule.darkStylesheets ?? [], index, "darkStylesheets");
+}
+function validateStylesheetPaths(value, label) {
+    return value.map((stylesheet) => {
+        requireString(stylesheet, label);
+        return /^https?:\/\//.test(stylesheet)
+            ? stylesheet
+            : validateRelativeRoute(stylesheet, label);
+    });
+}
+function validateUniqueStylesheetPaths(linked, paths, index, field) {
+    const seen = new Set(linked);
+    for (const stylesheet of paths) {
+        if (seen.has(stylesheet)) {
+            throw new MoklyError("config-invalid", `duplicate stylesheet path in stylesheets[${index}].${field}: ${stylesheet}`);
+        }
+        seen.add(stylesheet);
+    }
+}
+/** Validate explicit watch classifications and reject ambiguity. */
+export function validateWatchRules(rules) {
+    if (!Array.isArray(rules)) {
+        throw new MoklyError("config-invalid", "watch.rules must be an array");
+    }
+    const seen = new Set();
+    return rules.map((rawRule, index) => {
+        if (!record(rawRule)) {
+            throw new MoklyError("config-invalid", `watch.rules[${index}] must be an object`);
+        }
+        const rule = rawRule;
+        if (!WATCH_ACTIONS.has(rule.action)) {
+            throw new MoklyError("config-invalid", `watch.rules[${index}] has invalid action`);
+        }
+        if (!Array.isArray(rule.paths) || rule.paths.length === 0) {
+            throw new MoklyError("config-invalid", `watch.rules[${index}].paths must not be empty`);
+        }
+        const paths = rule.paths.map((glob) => {
+            requireString(glob, `watch.rules[${index}] path`);
+            return validateRelativeRoute(glob, `watch.rules[${index}] path`);
+        });
+        for (const glob of paths) {
+            if (seen.has(glob)) {
+                throw new MoklyError("config-invalid", `duplicate watch path: ${glob}`);
+            }
+            seen.add(glob);
+        }
+        return { action: rule.action, paths };
+    });
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Normalize and bound the watch debounce duration. */
+export function validateDebounce(value) {
+    const debounce = value ?? 75;
+    if (!Number.isInteger(debounce) || debounce < 0 || debounce > 10_000) {
+        throw new MoklyError("config-invalid", "watch.debounceMs must be an integer from 0 to 10000");
+    }
+    return debounce;
+}
+/** Require a non-empty string while narrowing runtime input. */
+export function requireString(value, label) {
+    if (typeof value !== "string" || value.trim().length === 0) {
+        throw new MoklyError("config-invalid", `${label} must be a non-empty string`);
+    }
+}
+/** Validate a config list whose members must be non-empty strings. */
+export function validateStringArray(value, label) {
+    if (!Array.isArray(value) ||
+        !value.every((item) => typeof item === "string" && item.trim().length > 0)) {
+        throw new MoklyError("config-invalid", `${label} must be an array of non-empty strings`);
+    }
+    return [...value];
+}
+//# sourceMappingURL=rules.js.map

package/dist/config/rules.js.map

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

package/dist/config/types.d.ts

@@ -0,0 +1,116 @@
+import type { ColorScheme } from "../authoring/types.js";
+/** Filesystem changes understood by the watched development runtime. */
+export type WatchAction = "ignore" | "rebuild" | "reload" | "restart";
+/** One glob-to-stylesheet mapping evaluated in declaration order. */
+export interface StylesheetRule {
+    /** POSIX glob matched against a screen route. */
+    match: string;
+    /** Paths relative to `mockupsDir`, or absolute HTTP(S) URLs. */
+    stylesheets: readonly string[];
+    /** Additional stylesheets appended for light fragments. */
+    lightStylesheets?: readonly string[];
+    /** Additional stylesheets appended for dark fragments. */
+    darkStylesheets?: readonly string[];
+}
+/** One additional consumer watch input. */
+export interface WatchRule {
+    action: WatchAction;
+    /** Repository-relative POSIX globs. */
+    paths: readonly string[];
+}
+/** Watched-development behavior. */
+export interface WatchConfig {
+    /** Debounce window applied to a burst of filesystem notifications. */
+    debounceMs?: number;
+    /** Additional classified consumer inputs. */
+    rules?: readonly WatchRule[];
+}
+/** Git comparison and artifact configuration. */
+export interface ReviewConfig {
+    /** Git ref whose merge base with HEAD is the comparison branch point. */
+    base?: string;
+    /** Config-relative artifact directory. */
+    outDir?: string;
+    /** Repository-relative POSIX globs whose changes can affect many screens. */
+    sharedImpact?: readonly string[];
+}
+/** Temporary compatibility accepted during a consumer cutover. */
+export interface CompatibilityConfig {
+    /** Read historical v2 Git output only when its canonical manifest is absent. */
+    readManifestV2?: boolean;
+    /** Config-relative module applying a temporary deterministic document bridge. */
+    transformer?: string;
+}
+/** Esbuild loaders allowed for consumer-authored module extensions. */
+export type ModuleLoader = "base64" | "binary" | "css" | "dataurl" | "empty" | "file" | "js" | "json" | "jsx" | "text" | "ts" | "tsx";
+/** Consumer-owned module resolution needed by cross-platform component trees. */
+export interface ModuleResolutionConfig {
+    /** Bare module aliases applied while bundling entries and renderers. */
+    aliases?: Readonly<Record<string, string>>;
+    /** Export conditions evaluated in declaration order. */
+    conditions?: readonly string[];
+    /** Extension-to-loader overrides for consumer modules. */
+    loaders?: Readonly<Record<string, ModuleLoader>>;
+    /** Package fields evaluated in declaration order. */
+    mainFields?: readonly string[];
+    /** Config-relative package roots whose node_modules directories are searched. */
+    packageRoots?: readonly string[];
+    /** Module extensions evaluated in declaration order. */
+    resolveExtensions?: readonly string[];
+}
+/** Public, serializable host configuration. */
+export interface MoklyConfig {
+    /** Color schemes rendered for screens; defaults to light only. */
+    colorSchemes?: readonly ColorScheme[];
+    /** Config-relative structured mockup source directory. */
+    entriesDir: string;
+    /** Config-relative generated catalogue/output root. */
+    mockupsDir: string;
+    /** Config-relative repository root; defaults to the config directory. */
+    repoRoot?: string;
+    /** Optional config-relative consumer renderer module. */
+    renderer?: string;
+    /** Optional consumer-specific module resolution for cross-platform sources. */
+    moduleResolution?: ModuleResolutionConfig;
+    /** Ordered route-to-stylesheet mappings. */
+    stylesheets?: readonly StylesheetRule[];
+    /** Review settings. */
+    review?: ReviewConfig;
+    /** Watch settings. */
+    watch?: WatchConfig;
+    /** Temporary manifest compatibility. */
+    compatibility?: CompatibilityConfig;
+}
+/** Absolute, validated configuration consumed by runtime engines. */
+export interface ResolvedConfig {
+    colorSchemes: readonly ColorScheme[];
+    compatibility: {
+        readManifestV2: boolean;
+        transformer?: string;
+    };
+    configPath: string;
+    /** Complete authoring inventory retained across compile and serving boundaries. */
+    sourceFiles?: readonly string[];
+    /** Inputs to the separately bundled configuration graph. */
+    configSourceFiles?: readonly string[];
+    entriesDir: string;
+    mockupsDir: string;
+    moduleResolution: ResolvedModuleResolutionConfig;
+    renderer?: string;
+    repoRoot: string;
+    review: Required<ReviewConfig>;
+    stylesheets: readonly StylesheetRule[];
+    watch: Required<Pick<WatchConfig, "debounceMs">> & {
+        rules: readonly WatchRule[];
+    };
+}
+/** Validated module resolution with absolute package roots. */
+export interface ResolvedModuleResolutionConfig {
+    aliases: Readonly<Record<string, string>>;
+    conditions?: readonly string[];
+    loaders: Readonly<Record<string, ModuleLoader>>;
+    mainFields?: readonly string[];
+    packageRoots: readonly string[];
+    resolveExtensions?: readonly string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/config/types.d.ts.map

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

package/dist/config/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map