@mokly/mokly 0.8.0

package/dist/components/view_validation.js

@@ -0,0 +1,128 @@
+import { reviewMaterialKey } from "../authoring/review_material.js";
+import { isCatalogueId } from "../navigation/logical.js";
+import { decodeProps, encodeProps } from "./codec.js";
+import { canonicalJson, exactKeys, invalidData } from "./data.js";
+import { instanceKey, isComponentKey, slotKey } from "./keys.js";
+import { sortedStrings, validateResourcePath } from "./validation_helpers.js";
+import { validateProps } from "./props.js";
+import { validateViewReferences } from "./view_references.js";
+export function validateComponentViews(value, dark, components, at, rootId) {
+    const axes = ["mobile", "desktop"].flatMap((viewport) => (dark ? ["light", "dark"] : ["light"]).map((scheme) => `${viewport}/${scheme}`));
+    if (!Array.isArray(value) || value.length !== axes.length)
+        invalidData(at, "componentViews must record every available view");
+    value.forEach((view, i) => {
+        exactKeys(view, [
+            "viewport",
+            "colorScheme",
+            "instances",
+            "slots",
+            "ranges",
+            "styles",
+            "resources",
+        ], at);
+        if (`${String(view.viewport)}/${String(view.colorScheme)}` !== axes[i])
+            invalidData(at, "view axes must be unique and ordered");
+        for (const field of ["instances", "slots", "ranges", "styles", "resources"])
+            if (!Array.isArray(view[field]))
+                invalidData(at, `missing ${field} array`);
+        validateComponentViewRecord(view, components, `${at} / ${axes[i]}`, rootId);
+    });
+}
+/** Validate one actual render without asserting completeness of other views. */
+export function validateComponentViewRecord(view, components, at, rootId) {
+    for (const instance of view.instances) {
+        exactKeys(instance, [
+            "key",
+            "id",
+            "componentId",
+            "owner",
+            "slotKey",
+            "order",
+            "props",
+            "propsKey",
+        ], at);
+        if (!isComponentKey(instance.key) ||
+            !isCatalogueId(instance.id) ||
+            !isCatalogueId(instance.componentId))
+            invalidData(at, "invalid component instance identity");
+        validateOwner(instance.owner, at);
+        if (instance.slotKey !== undefined && !isComponentKey(instance.slotKey))
+            invalidData(at, "invalid instance slot key");
+        if (instance.key !==
+            instanceKey(instance.owner, instance.slotKey, instance.id))
+            invalidData(at, "instance key mismatch");
+        if (!Number.isSafeInteger(instance.order) || instance.order < 0)
+            invalidData(at, "invalid instance order");
+        const component = components.get(instance.componentId);
+        if (!component)
+            invalidData(at, "instance names an unknown component");
+        const props = validateProps(component.propSchema, decodeProps(instance.props), `${at} / ${instance.id}`);
+        if (canonicalJson(encodeProps(props)) !== canonicalJson(instance.props) ||
+            reviewMaterialKey(props) !== instance.propsKey)
+            invalidData(at, "props key or canonical encoding mismatch");
+    }
+    sortedStrings(view.instances.map((instance) => instance.key), `${at}.instances`);
+    for (const slot of view.slots) {
+        exactKeys(slot, ["key", "instanceKey", "name", "owner", "sourceSlotKey"], at);
+        if (!isComponentKey(slot.key) ||
+            !isComponentKey(slot.instanceKey) ||
+            typeof slot.name !== "string" ||
+            slot.key !== slotKey(slot.instanceKey, slot.name))
+            invalidData(at, "invalid slot identity");
+        validateOwner(slot.owner, at);
+        if (slot.sourceSlotKey !== undefined && !isComponentKey(slot.sourceSlotKey))
+            invalidData(at, "invalid forwarded slot key");
+    }
+    sortedStrings(view.slots.map((slot) => slot.key), `${at}.slots`);
+    const instances = new Map(view.instances.map((item) => [item.key, item]));
+    const slots = new Map(view.slots.map((item) => [item.key, item]));
+    validateOrders(view.instances, at);
+    validateViewReferences(view, components, instances, slots, at);
+    const rendered = new Set([
+        ...view.instances.map((instance) => instance.componentId),
+        ...(rootId ? [rootId] : []),
+    ]);
+    let end = 0;
+    for (const style of view.styles) {
+        exactKeys(style, ["startOffset", "endOffset", "componentIds"], at);
+        if (!Number.isSafeInteger(style.startOffset) ||
+            !Number.isSafeInteger(style.endOffset) ||
+            style.startOffset < end ||
+            style.endOffset <= style.startOffset)
+            invalidData(at, "invalid or overlapping style range");
+        end = style.endOffset;
+        validateOwners(style.componentIds, rendered, at);
+    }
+    for (const resource of view.resources) {
+        exactKeys(resource, ["path", "componentIds"], at);
+        validateResourcePath(resource.path, at);
+        validateOwners(resource.componentIds, rendered, at);
+    }
+    sortedStrings(view.resources.map((resource) => resource.path), `${at}.resources`);
+}
+function validateOwner(owner, at) {
+    exactKeys(owner, ["kind", "instanceKey"], at);
+    if (owner.kind === "entry" && !Object.hasOwn(owner, "instanceKey"))
+        return;
+    if (owner.kind === "instance" && isComponentKey(owner.instanceKey))
+        return;
+    invalidData(at, "invalid input owner");
+}
+function validateOrders(instances, at) {
+    const groups = new Map();
+    for (const instance of instances) {
+        const key = canonicalJson([instance.owner, instance.slotKey ?? null]);
+        const group = groups.get(key) ?? [];
+        group.push(instance.order);
+        groups.set(key, group);
+    }
+    for (const group of groups.values())
+        if (group.sort((a, b) => a - b).some((value, i) => value !== i))
+            invalidData(at, "instance order must be contiguous and unique within each owner/slot scope");
+}
+function validateOwners(value, rendered, at) {
+    sortedStrings(value, at);
+    if (!value.length || !value.every((id) => rendered.has(id)))
+        invalidData(at, "style/resource owners must render in this view");
+}
+//# sourceMappingURL=view_validation.js.map

package/dist/components/view_validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"view_validation.js","sourceRoot":"","sources":["../../src/components/view_validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,WAAW,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAOjE,OAAO,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAE9D,MAAM,UAAU,sBAAsB,CACpC,KAAc,EACd,IAAa,EACb,UAAkD,EAClD,EAAU,EACV,MAAe;IAEf,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CACtD,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CACxC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,QAAQ,IAAI,MAAM,EAAE,CACpC,CACF,CAAC;IACF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM;QACvD,WAAW,CAAC,EAAE,EAAE,iDAAiD,CAAC,CAAC;IACrE,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACxB,SAAS,CACP,IAAI,EACJ;YACE,UAAU;YACV,aAAa;YACb,WAAW;YACX,OAAO;YACP,QAAQ;YACR,QAAQ;YACR,WAAW;SACZ,EACD,EAAE,CACH,CAAC;QACF,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC;YACpE,WAAW,CAAC,EAAE,EAAE,sCAAsC,CAAC,CAAC;QAC1D,KAAK,MAAM,KAAK,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC;YACzE,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBAC7B,WAAW,CAAC,EAAE,EAAE,WAAW,KAAK,QAAQ,CAAC,CAAC;QAC9C,2BAA2B,CACzB,IAAsC,EACtC,UAAU,EACV,GAAG,EAAE,MAAM,IAAI,CAAC,CAAC,CAAC,EAAE,EACpB,MAAM,CACP,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,MAAM,UAAU,2BAA2B,CACzC,IAAyB,EACzB,UAAkD,EAClD,EAAU,EACV,MAAe;IAEf,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,SAAS,CACP,QAAQ,EACR;YACE,KAAK;YACL,IAAI;YACJ,aAAa;YACb,OAAO;YACP,SAAS;YACT,OAAO;YACP,OAAO;YACP,UAAU;SACX,EACD,EAAE,CACH,CAAC;QACF,IACE,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC;YAC7B,CAAC,aAAa,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC3B,CAAC,aAAa,CAAC,QAAQ,CAAC,WAAW,CAAC;YAEpC,WAAW,CAAC,EAAE,EAAE,qCAAqC,CAAC,CAAC;QACzD,aAAa,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAClC,IAAI,QAAQ,CAAC,OAAO,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC;YACrE,WAAW,CAAC,EAAE,EAAE,2BAA2B,CAAC,CAAC;QAC/C,IACE,QAAQ,CAAC,GAAG;YACZ,WAAW,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,EAAE,CAAC;YAE1D,WAAW,CAAC,EAAE,EAAE,uBAAuB,CAAC,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC;YAC7D,WAAW,CAAC,EAAE,EAAE,wBAAwB,CAAC,CAAC;QAC5C,MAAM,SAAS,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;QACvD,IAAI,CAAC,SAAS;YAAE,WAAW,CAAC,EAAE,EAAE,qCAAqC,CAAC,CAAC;QACvE,MAAM,KAAK,GAAG,aAAa,CACzB,SAAS,CAAC,UAAU,EACpB,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAC3B,GAAG,EAAE,MAAM,QAAQ,CAAC,EAAE,EAAE,CACzB,CAAC;QACF,IACE,aAAa,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,KAAK,aAAa,CAAC,QAAQ,CAAC,KAAK,CAAC;YACnE,iBAAiB,CAAC,KAAK,CAAC,KAAK,QAAQ,CAAC,QAAQ;YAE9C,WAAW,CAAC,EAAE,EAAE,0CAA0C,CAAC,CAAC;IAChE,CAAC;IACD,aAAa,CACX,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAC9C,GAAG,EAAE,YAAY,CAClB,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QAC9B,SAAS,CACP,IAAI,EACJ,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,EACxD,EAAE,CACH,CAAC;QACF,IACE,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC;YACzB,CAAC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC;YACjC,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAC7B,IAAI,CAAC,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,IAAI,CAAC;YAEjD,WAAW,CAAC,EAAE,EAAE,uBAAuB,CAAC,CAAC;QAC3C,aAAa,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9B,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,aAAa,CAAC;YACzE,WAAW,CAAC,EAAE,EAAE,4BAA4B,CAAC,CAAC;IAClD,CAAC;IACD,aAAa,CACX,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,EAClC,GAAG,EAAE,QAAQ,CACd,CAAC;IACF,MAAM,SAAS,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1E,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;IAClE,cAAc,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACnC,sBAAsB,CAAC,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;IAC/D,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC;QACvB,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,WAAW,CAAC;QACzD,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC,CAAC;IACH,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChC,SAAS,CAAC,KAAK,EAAE,CAAC,aAAa,EAAE,WAAW,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;QACnE,IACE,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC;YACxC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,SAAS,CAAC;YACtC,KAAK,CAAC,WAAW,GAAG,GAAG;YACvB,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,WAAW;YAEpC,WAAW,CAAC,EAAE,EAAE,oCAAoC,CAAC,CAAC;QACxD,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;QACtB,cAAc,CAAC,KAAK,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IACnD,CAAC;IACD,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;QACtC,SAAS,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,EAAE,CAAC,CAAC;QAClD,oBAAoB,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACxC,cAAc,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;IACtD,CAAC;IACD,aAAa,CACX,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC/C,GAAG,EAAE,YAAY,CAClB,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CACpB,KAAc,EACd,EAAU;IAEV,SAAS,CAAC,KAAK,EAAE,CAAC,MAAM,EAAE,aAAa,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9C,IAAI,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC;QAAE,OAAO;IAC3E,IAAI,KAAK,CAAC,IAAI,KAAK,UAAU,IAAI,cAAc,CAAC,KAAK,CAAC,WAAW,CAAC;QAAE,OAAO;IAC3E,WAAW,CAAC,EAAE,EAAE,qBAAqB,CAAC,CAAC;AACzC,CAAC;AAED,SAAS,cAAc,CACrB,SAA6C,EAC7C,EAAU;IAEV,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,MAAM,GAAG,GAAG,aAAa,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACzB,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE;QACjC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC;YAC7D,WAAW,CACT,EAAE,EACF,2EAA2E,CAC5E,CAAC;AACR,CAAC;AAED,SAAS,cAAc,CACrB,KAAc,EACd,QAA6B,EAC7B,EAAU;IAEV,aAAa,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzB,IAAI,CAAC,KAAK,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACzD,WAAW,CAAC,EAAE,EAAE,gDAAgD,CAAC,CAAC;AACtE,CAAC"}

package/dist/components/views.d.ts

@@ -0,0 +1,16 @@
+import type { ColorScheme, Viewport } from "../authoring/types.js";
+import type { ManifestEntry, ManifestScreen } from "../registry/types.js";
+import type { ComponentViewRecord, ManifestComponentVariant } from "./manifest_types.js";
+export interface GeneratedComponentView {
+    viewport: Viewport;
+    colorScheme: ColorScheme;
+    path: string;
+    variantId?: string;
+    usage?: ComponentViewRecord;
+}
+/** Enumerate actual artifacts, preserving the distinction between absent and empty usage. */
+export declare function generatedViews(entry: ManifestEntry): GeneratedComponentView[];
+/** Present logical instances by their first actual DOM occurrence, including slot replay. */
+export declare function orderedInstances(usage?: ComponentViewRecord): import("./manifest_types.js").ComponentInstanceRecord[];
+export declare function fragmentViews(fragments: Pick<ManifestScreen, "fragments" | "darkFragments" | "componentViews"> | ManifestComponentVariant, variantId?: string): GeneratedComponentView[];
+//# sourceMappingURL=views.d.ts.map

package/dist/components/views.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.d.ts","sourceRoot":"","sources":["../../src/components/views.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE1E,OAAO,KAAK,EACV,mBAAmB,EACnB,wBAAwB,EACzB,MAAM,qBAAqB,CAAC;AAE7B,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,QAAQ,CAAC;IACnB,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,mBAAmB,CAAC;CAC7B;AAED,6FAA6F;AAC7F,wBAAgB,cAAc,CAAC,KAAK,EAAE,aAAa,GAAG,sBAAsB,EAAE,CAO7E;AAED,6FAA6F;AAC7F,wBAAgB,gBAAgB,CAAC,KAAK,CAAC,EAAE,mBAAmB,2DAY3D;AAED,wBAAgB,aAAa,CAC3B,SAAS,EACL,IAAI,CAAC,cAAc,EAAE,WAAW,GAAG,eAAe,GAAG,gBAAgB,CAAC,GACtE,wBAAwB,EAC5B,SAAS,CAAC,EAAE,MAAM,GACjB,sBAAsB,EAAE,CAyB1B"}

package/dist/components/views.js

@@ -0,0 +1,41 @@
+import { VIEWPORTS } from "../registry/views.js";
+/** Enumerate actual artifacts, preserving the distinction between absent and empty usage. */
+export function generatedViews(entry) {
+    if (entry.kind === "component")
+        return entry.variants.flatMap((variant) => fragmentViews(variant, variant.id));
+    if (entry.kind === "screen")
+        return fragmentViews(entry);
+    return [];
+}
+/** Present logical instances by their first actual DOM occurrence, including slot replay. */
+export function orderedInstances(usage) {
+    if (!usage)
+        return [];
+    const positions = new Map();
+    for (const range of usage.ranges)
+        if (range.target.kind === "instance" &&
+            !positions.has(range.target.instanceKey))
+            positions.set(range.target.instanceKey, positions.size);
+    return [...usage.instances].sort((a, b) => positions.get(a.key) - positions.get(b.key));
+}
+export function fragmentViews(fragments, variantId) {
+    return VIEWPORTS.flatMap((viewport) => {
+        const makeView = (colorScheme, path) => {
+            const usage = fragments.componentViews?.find((view) => view.viewport === viewport && view.colorScheme === colorScheme);
+            return {
+                viewport,
+                colorScheme,
+                path,
+                ...(usage ? { usage } : {}),
+                ...(variantId ? { variantId } : {}),
+            };
+        };
+        return [
+            makeView("light", fragments.fragments[viewport]),
+            ...(fragments.darkFragments
+                ? [makeView("dark", fragments.darkFragments[viewport])]
+                : []),
+        ];
+    });
+}
+//# sourceMappingURL=views.js.map

package/dist/components/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../../src/components/views.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAcjD,6FAA6F;AAC7F,MAAM,UAAU,cAAc,CAAC,KAAoB;IACjD,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW;QAC5B,OAAO,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CACxC,aAAa,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAAC,CACnC,CAAC;IACJ,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,aAAa,CAAC,KAAK,CAAC,CAAC;IACzD,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB,CAAC,KAA2B;IAC1D,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,KAAK,MAAM,KAAK,IAAI,KAAK,CAAC,MAAM;QAC9B,IACE,KAAK,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU;YAChC,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC;YAExC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAC5D,OAAO,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC,CAAC,IAAI,CAC9B,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAE,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAE,CACxD,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAC3B,SAE4B,EAC5B,SAAkB;IAElB,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QACpC,MAAM,QAAQ,GAAG,CACf,WAAwB,EACxB,IAAY,EACY,EAAE;YAC1B,MAAM,KAAK,GAAG,SAAS,CAAC,cAAc,EAAE,IAAI,CAC1C,CAAC,IAAI,EAAE,EAAE,CACP,IAAI,CAAC,QAAQ,KAAK,QAAQ,IAAI,IAAI,CAAC,WAAW,KAAK,WAAW,CACjE,CAAC;YACF,OAAO;gBACL,QAAQ;gBACR,WAAW;gBACX,IAAI;gBACJ,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC3B,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACpC,CAAC;QACJ,CAAC,CAAC;QACF,OAAO;YACL,QAAQ,CAAC,OAAO,EAAE,SAAS,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;YAChD,GAAG,CAAC,SAAS,CAAC,aAAa;gBACzB,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACvD,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/components/wrapper.d.ts

@@ -0,0 +1,5 @@
+import { type ReactNode } from "react";
+import type { ComponentDefinition } from "./types.js";
+/** The wrapper records real invocation, then gives its implementation a new owner. */
+export declare function renderInstance(definition: ComponentDefinition, rawProps: Readonly<Record<string, unknown>>): ReactNode;
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/components/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/components/wrapper.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA8B,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAWnE,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAQtD,sFAAsF;AACtF,wBAAgB,cAAc,CAC5B,UAAU,EAAE,mBAAmB,EAC/B,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC1C,SAAS,CAmEX"}

package/dist/components/wrapper.js

@@ -0,0 +1,67 @@
+import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { isValidElement, useContext } from "react";
+import { isCatalogueId } from "../navigation/logical.js";
+import { invalidData } from "./data.js";
+import { componentInputs } from "./inputs.js";
+import { slotKey } from "./keys.js";
+import { ComponentContext } from "./render_context.js";
+/** The wrapper records real invocation, then gives its implementation a new owner. */
+export function renderInstance(definition, rawProps) {
+    const scope = useContext(ComponentContext);
+    if (!scope)
+        invalidData(definition.id, "registered component requires a catalogue render and an exported entry");
+    const descriptors = Object.getOwnPropertyDescriptors(rawProps);
+    if (descriptors.key && !descriptors.key.enumerable)
+        delete descriptors.key;
+    const instanceDescriptor = descriptors.moklyInstance;
+    if (instanceDescriptor && !("value" in instanceDescriptor))
+        invalidData(scope.collector.label, "instance id cannot be an accessor");
+    const id = instanceDescriptor?.value === undefined
+        ? definition.id
+        : instanceDescriptor.value;
+    delete descriptors.moklyInstance;
+    if (!isCatalogueId(id))
+        invalidData(scope.collector.label, "moklyInstance must be a kebab-case id");
+    const input = Object.defineProperties({}, descriptors);
+    const { data, slots } = componentInputs(definition, input, `${scope.collector.label} / ${definition.id}`);
+    const instance = scope.collector.register(definition, id, data, scope);
+    const wrapped = {};
+    for (const [name, node] of Object.entries(slots)) {
+        const source = isValidElement(node) && node.type === OwnedSlot
+            ? node.props.capture
+            : undefined;
+        const record = {
+            key: slotKey(instance.key, name),
+            instanceKey: instance.key,
+            name,
+            owner: source?.record.owner ?? scope.owner,
+            ...(source ? { sourceSlotKey: source.record.key } : {}),
+        };
+        scope.collector.slot(record);
+        const capture = {
+            record,
+            node: source?.node ?? node,
+            scope: source?.scope ?? { ...scope, slotKey: record.key },
+        };
+        wrapped[name] = _jsx(OwnedSlot, { capture: capture });
+    }
+    const childScope = {
+        collector: scope.collector,
+        owner: { kind: "instance", instanceKey: instance.key },
+        placement: scope.placement,
+    };
+    const output = definition.render({ ...data, ...wrapped }, scope.collector.context);
+    return (_jsx(Boundary, { scope: childScope, target: { kind: "instance", instanceKey: instance.key }, children: output }));
+}
+function OwnedSlot({ capture }) {
+    const scope = {
+        ...capture.scope,
+        placement: capture.scope.collector.placement(),
+    };
+    return (_jsx(Boundary, { scope: scope, target: { kind: "slot", slotKey: capture.record.key }, children: capture.node }));
+}
+function Boundary({ scope, target, children, }) {
+    const token = scope.collector.boundary(target);
+    return (_jsxs(_Fragment, { children: [_jsx("template", { "data-mokly-component-start": token }), _jsx(ComponentContext, { value: scope, children: children }), _jsx("template", { "data-mokly-component-end": token })] }));
+}
+//# sourceMappingURL=wrapper.js.map

package/dist/components/wrapper.js.map

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

package/dist/config/define.d.ts

@@ -0,0 +1,4 @@
+import type { MoklyConfig } from "./types.js";
+/** Preserve inference while declaring a typed Mokly configuration. */
+export declare function defineConfig<const Config extends MoklyConfig>(config: Config): Config;
+//# sourceMappingURL=define.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define.d.ts","sourceRoot":"","sources":["../../src/config/define.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,sEAAsE;AACtE,wBAAgB,YAAY,CAAC,KAAK,CAAC,MAAM,SAAS,WAAW,EAC3D,MAAM,EAAE,MAAM,GACb,MAAM,CAER"}

package/dist/config/define.js

@@ -0,0 +1,5 @@
+/** Preserve inference while declaring a typed Mokly configuration. */
+export function defineConfig(config) {
+    return config;
+}
+//# sourceMappingURL=define.js.map

package/dist/config/define.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../../src/config/define.ts"],"names":[],"mappings":"AAEA,sEAAsE;AACtE,MAAM,UAAU,YAAY,CAC1B,MAAc;IAEd,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/config/file_locations.d.ts

@@ -0,0 +1,10 @@
+/** Logical and canonical identities confined to the same configured root. */
+export interface FileLocation {
+    readonly logicalPath: string;
+    readonly physicalPath: string;
+    readonly relativePath: string;
+    readonly physicalRelativePath: string;
+}
+/** Locate existing or missing paths without accepting escaping or dangling links. */
+export declare function locatePath(candidate: string, root: string, repoRoot?: string): FileLocation | undefined;
+//# sourceMappingURL=file_locations.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"file_locations.d.ts","sourceRoot":"","sources":["../../src/config/file_locations.ts"],"names":[],"mappings":"AAKA,6EAA6E;AAC7E,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;CACvC;AAED,qFAAqF;AACrF,wBAAgB,UAAU,CACxB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,QAAQ,SAAO,GACd,YAAY,GAAG,SAAS,CAkB1B"}

package/dist/config/file_locations.js

@@ -0,0 +1,26 @@
+import fs from "node:fs";
+import path from "node:path";
+import { isInside, projectRealPath, toPosixPath } from "./paths.js";
+/** Locate existing or missing paths without accepting escaping or dangling links. */
+export function locatePath(candidate, root, repoRoot = root) {
+    try {
+        const logicalPath = path.resolve(candidate);
+        if (!isInside(repoRoot, root) || !isInside(root, logicalPath))
+            return;
+        const realRepo = fs.realpathSync(repoRoot);
+        const realRoot = fs.realpathSync(root);
+        const physicalPath = projectRealPath(logicalPath);
+        if (!isInside(realRepo, realRoot) || !isInside(realRoot, physicalPath))
+            return;
+        return {
+            logicalPath,
+            physicalPath,
+            relativePath: toPosixPath(path.relative(root, logicalPath)),
+            physicalRelativePath: toPosixPath(path.relative(realRoot, physicalPath)),
+        };
+    }
+    catch {
+        return;
+    }
+}
+//# sourceMappingURL=file_locations.js.map

package/dist/config/file_locations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file_locations.js","sourceRoot":"","sources":["../../src/config/file_locations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAUpE,qFAAqF;AACrF,MAAM,UAAU,UAAU,CACxB,SAAiB,EACjB,IAAY,EACZ,QAAQ,GAAG,IAAI;IAEf,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;YAAE,OAAO;QACtE,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC3C,MAAM,QAAQ,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,CAAC;QACvC,MAAM,YAAY,GAAG,eAAe,CAAC,WAAW,CAAC,CAAC;QAClD,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC;YACpE,OAAO;QACT,OAAO;YACL,WAAW;YACX,YAAY;YACZ,YAAY,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;YAC3D,oBAAoB,EAAE,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;SACzE,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;IACT,CAAC;AACH,CAAC"}

package/dist/config/load.d.ts

@@ -0,0 +1,14 @@
+import type { ResolvedConfig } from "./types.js";
+/** Reloadable consumer-configuration boundary used by watched Serve. */
+export interface ConfigLoader {
+    load(configPath: string): Promise<ResolvedConfig>;
+}
+/** Filesystem-backed configuration loader. */
+export declare class FileSystemConfigLoader implements ConfigLoader {
+    load(configPath: string): Promise<ResolvedConfig>;
+}
+/** Find a Mokly config by explicit path or upward discovery. */
+export declare function discoverConfig(cwd: string, explicitPath?: string): string;
+/** Import and validate a TypeScript or JavaScript consumer config. */
+export declare function loadConfig(cwd: string, explicitPath?: string): Promise<ResolvedConfig>;
+//# sourceMappingURL=load.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"load.d.ts","sourceRoot":"","sources":["../../src/config/load.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAUjD,wEAAwE;AACxE,MAAM,WAAW,YAAY;IAC3B,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;CACnD;AAED,8CAA8C;AAC9C,qBAAa,sBAAuB,YAAW,YAAY;IACzD,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC;CAGlD;AAED,gEAAgE;AAChE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CA4BzE;AAED,sEAAsE;AACtE,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,cAAc,CAAC,CAgDzB"}

package/dist/config/load.js

@@ -0,0 +1,105 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { build } from "esbuild";
+import { graphSourceFiles } from "../build/source_inventory.js";
+import { MoklyError, errorMessage } from "../errors.js";
+import { resolveConfig } from "./validate.js";
+const CONFIG_NAMES = [
+    "mokly.config.ts",
+    "mokly.config.mts",
+    "mokly.config.js",
+    "mokly.config.mjs",
+];
+/** Filesystem-backed configuration loader. */
+export class FileSystemConfigLoader {
+    load(configPath) {
+        return loadConfig(path.dirname(configPath), configPath);
+    }
+}
+/** Find a Mokly config by explicit path or upward discovery. */
+export function discoverConfig(cwd, explicitPath) {
+    if (explicitPath) {
+        const candidate = path.resolve(cwd, explicitPath);
+        if (!isFile(candidate)) {
+            throw new MoklyError("config-missing", `config file does not exist: ${candidate}`);
+        }
+        return candidate;
+    }
+    const attempted = [];
+    let current = path.resolve(cwd);
+    while (true) {
+        for (const name of CONFIG_NAMES) {
+            const candidate = path.join(current, name);
+            attempted.push(candidate);
+            if (isFile(candidate))
+                return candidate;
+        }
+        const parent = path.dirname(current);
+        if (parent === current)
+            break;
+        current = parent;
+    }
+    throw new MoklyError("config-missing", `no Mokly config found; attempted:\n${attempted.map((item) => `- ${item}`).join("\n")}`);
+}
+/** Import and validate a TypeScript or JavaScript consumer config. */
+export async function loadConfig(cwd, explicitPath) {
+    const configPath = discoverConfig(cwd, explicitPath);
+    const temporaryDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), "mokly-config-"));
+    const outputPath = path.join(temporaryDir, "config.mjs");
+    try {
+        const result = await build({
+            metafile: true,
+            preserveSymlinks: true,
+            absWorkingDir: path.dirname(configPath),
+            bundle: true,
+            entryPoints: [configPath],
+            format: "esm",
+            logLevel: "silent",
+            outfile: outputPath,
+            platform: "node",
+            plugins: [configApiPlugin()],
+            target: "node22",
+        });
+        const loaded = (await import(`${pathToFileURL(outputPath).href}?v=${Date.now()}`));
+        if (loaded.default === undefined) {
+            throw new MoklyError("config-invalid", `${configPath} must have a default export`);
+        }
+        const config = resolveConfig(loaded.default, configPath);
+        config.configSourceFiles = graphSourceFiles(result.metafile, path.dirname(configPath), config.repoRoot);
+        return config;
+    }
+    catch (error) {
+        if (error instanceof MoklyError)
+            throw error;
+        throw new MoklyError("config-invalid", `could not load ${configPath}: ${errorMessage(error)}`, { cause: error });
+    }
+    finally {
+        await fs.promises.rm(temporaryDir, { force: true, recursive: true });
+    }
+}
+function configApiPlugin() {
+    return {
+        name: "mokly-config-api",
+        setup(pluginBuild) {
+            pluginBuild.onResolve({ filter: /^@mokly\/mokly$/ }, () => ({
+                namespace: "mokly-config-api",
+                path: "@mokly/mokly",
+            }));
+            pluginBuild.onLoad({ filter: /.*/, namespace: "mokly-config-api" }, () => ({
+                contents: "export const defineConfig = (value) => value;",
+                loader: "js",
+            }));
+        },
+    };
+}
+function isFile(candidate) {
+    try {
+        return fs.statSync(candidate).isFile();
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=load.js.map

package/dist/config/load.js.map

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

package/dist/config/module_resolution.d.ts

@@ -0,0 +1,4 @@
+import type { ModuleResolutionConfig, ResolvedModuleResolutionConfig } from "./types.js";
+/** Validate consumer module resolution without encoding any app defaults. */
+export declare function resolveModuleResolution(input: ModuleResolutionConfig | undefined, repoRoot: string, configDir: string): ResolvedModuleResolutionConfig;
+//# sourceMappingURL=module_resolution.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"module_resolution.d.ts","sourceRoot":"","sources":["../../src/config/module_resolution.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAEV,sBAAsB,EACtB,8BAA8B,EAC/B,MAAM,YAAY,CAAC;AAuBpB,6EAA6E;AAC7E,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,sBAAsB,GAAG,SAAS,EACzC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,8BAA8B,CAgChC"}

package/dist/config/module_resolution.js

@@ -0,0 +1,119 @@
+import fs from "node:fs";
+import path from "node:path";
+import { MoklyError } from "../errors.js";
+import { resolveInside } from "./paths.js";
+import { requireDirectory } from "./path_validation.js";
+const LOADERS = new Set([
+    "base64",
+    "binary",
+    "css",
+    "dataurl",
+    "empty",
+    "file",
+    "js",
+    "json",
+    "jsx",
+    "text",
+    "ts",
+    "tsx",
+]);
+const NAME_PATTERN = /^[a-zA-Z0-9@][a-zA-Z0-9@._/-]*$/;
+const FIELD_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
+const EXTENSION_PATTERN = /^\.[a-zA-Z0-9._-]+$/;
+const PATH_PATTERN = /^(?:\.|[a-zA-Z0-9][a-zA-Z0-9._/-]*)$/;
+/** Validate consumer module resolution without encoding any app defaults. */
+export function resolveModuleResolution(input, repoRoot, configDir) {
+    if (input !== undefined && !record(input)) {
+        throw invalid("moduleResolution must be an object");
+    }
+    const config = input;
+    const aliases = validateAliases(config?.aliases);
+    const loaders = validateLoaders(config?.loaders);
+    const packageRoots = validatePackageRoots(config?.packageRoots, repoRoot, configDir);
+    return {
+        aliases,
+        ...(config?.conditions
+            ? { conditions: validateList(config.conditions, "conditions") }
+            : {}),
+        loaders,
+        ...(config?.mainFields
+            ? { mainFields: validateList(config.mainFields, "mainFields") }
+            : {}),
+        packageRoots,
+        ...(config?.resolveExtensions
+            ? {
+                resolveExtensions: validateList(config.resolveExtensions, "resolveExtensions", EXTENSION_PATTERN),
+            }
+            : {}),
+    };
+}
+function validateAliases(aliases) {
+    if (aliases === undefined)
+        return {};
+    if (!record(aliases))
+        throw invalid("moduleResolution.aliases must be an object");
+    return Object.fromEntries(Object.entries(aliases).map(([source, target]) => {
+        if (!safeSpecifier(source) || !safeSpecifier(target)) {
+            throw invalid("moduleResolution aliases must map bare package specifiers without dot segments");
+        }
+        return [source, target];
+    }));
+}
+function validateLoaders(loaders) {
+    if (loaders === undefined)
+        return {};
+    if (!record(loaders))
+        throw invalid("moduleResolution.loaders must be an object");
+    return Object.fromEntries(Object.entries(loaders).map(([extension, loader]) => {
+        if (!EXTENSION_PATTERN.test(extension) ||
+            !LOADERS.has(loader)) {
+            throw invalid(`invalid moduleResolution loader: ${extension}`);
+        }
+        return [extension, loader];
+    }));
+}
+function validatePackageRoots(roots, repoRoot, configDir) {
+    if (roots === undefined)
+        return [];
+    const values = validateList(roots, "packageRoots", PATH_PATTERN);
+    if (values.some((value) => value.split("/").some((segment) => segment === ".."))) {
+        throw invalid("moduleResolution.packageRoots must not contain parent segments");
+    }
+    return values.map((value, index) => {
+        const root = resolveInside(repoRoot, configDir, value, `moduleResolution.packageRoots[${index}]`);
+        requireDirectory(root, `moduleResolution.packageRoots[${index}]`);
+        if (!fs
+            .statSync(path.join(root, "package.json"), { throwIfNoEntry: false })
+            ?.isFile()) {
+            throw invalid(`moduleResolution package root has no package.json: ${value}`);
+        }
+        return root;
+    });
+}
+function validateList(values, field, pattern = FIELD_PATTERN) {
+    if (!Array.isArray(values) || values.length === 0) {
+        throw invalid(`moduleResolution.${field} must be a non-empty array`);
+    }
+    const unique = new Set();
+    for (const value of values) {
+        if (typeof value !== "string" ||
+            !pattern.test(value) ||
+            unique.has(value)) {
+            throw invalid(`moduleResolution.${field} contains an invalid or duplicate value`);
+        }
+        unique.add(value);
+    }
+    return [...unique];
+}
+function safeSpecifier(value) {
+    return (typeof value === "string" &&
+        NAME_PATTERN.test(value) &&
+        !value.split("/").some((segment) => segment === "." || segment === ".."));
+}
+function record(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function invalid(message) {
+    return new MoklyError("config-invalid", message);
+}
+//# sourceMappingURL=module_resolution.js.map