@contractspec/lib.overlay-engine 1.57.0 → 1.58.0

package/dist/types.d.ts

@@ -1,33 +1,30 @@
-import { OverlayScopeContext, OverlayTargetRef, SignedOverlaySpec } from "./spec.js";
-
-//#region src/types.d.ts
-interface OverlayRenderableField {
-  key: string;
-  label?: string;
-  visible?: boolean;
-  required?: boolean;
-  helpText?: string;
-  defaultValue?: unknown;
-  metadata?: Record<string, unknown>;
-  order?: number;
+import type { SignedOverlaySpec, OverlayScopeContext, OverlayTargetRef } from './spec';
+export interface OverlayRenderableField {
+    key: string;
+    label?: string;
+    visible?: boolean;
+    required?: boolean;
+    helpText?: string;
+    defaultValue?: unknown;
+    metadata?: Record<string, unknown>;
+    order?: number;
 }
-interface OverlayLayoutConfig {
-  kind?: 'form' | 'list' | 'table' | 'grid';
-  columns?: number;
-  density?: 'comfortable' | 'compact';
-  [key: string]: unknown;
+export interface OverlayLayoutConfig {
+    kind?: 'form' | 'list' | 'table' | 'grid';
+    columns?: number;
+    density?: 'comfortable' | 'compact';
+    [key: string]: unknown;
 }
-interface OverlayRenderable<TField extends OverlayRenderableField = OverlayRenderableField> {
-  fields: TField[];
-  layout?: OverlayLayoutConfig;
-  metadata?: Record<string, unknown>;
+export interface OverlayRenderable<TField extends OverlayRenderableField = OverlayRenderableField> {
+    fields: TField[];
+    layout?: OverlayLayoutConfig;
+    metadata?: Record<string, unknown>;
 }
-interface OverlayMatchContext extends OverlayScopeContext, OverlayTargetRef {}
-interface OverlayAuditEvent {
-  overlay: Pick<SignedOverlaySpec, 'overlayId' | 'version'>;
-  context: OverlayScopeContext;
-  timestamp: string;
+export interface OverlayMatchContext extends OverlayScopeContext, OverlayTargetRef {
+}
+export interface OverlayAuditEvent {
+    overlay: Pick<SignedOverlaySpec, 'overlayId' | 'version'>;
+    context: OverlayScopeContext;
+    timestamp: string;
 }
-//#endregion
-export { OverlayAuditEvent, OverlayLayoutConfig, OverlayMatchContext, OverlayRenderable, OverlayRenderableField };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","names":[],"sources":["../src/types.ts"],"mappings":";;;UAMiB,sBAAA;EACf,GAAA;EACA,KAAA;EACA,OAAA;EACA,QAAA;EACA,QAAA;EACA,YAAA;EACA,QAAA,GAAW,MAAA;EACX,KAAA;AAAA;AAAA,UAGe,mBAAA;EACf,IAAA;EACA,OAAA;EACA,OAAA;EAAA,CACC,GAAA;AAAA;AAAA,UAGc,iBAAA,gBACA,sBAAA,GAAyB,sBAAA;EAExC,MAAA,EAAQ,MAAA;EACR,MAAA,GAAS,mBAAA;EACT,QAAA,GAAW,MAAA;AAAA;AAAA,UAGI,mBAAA,SACP,mBAAA,EAAqB,gBAAA;AAAA,UAEd,iBAAA;EACf,OAAA,EAAS,IAAA,CAAK,iBAAA;EACd,OAAA,EAAS,mBAAA;EACT,SAAA;AAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,mBAAmB,EACnB,gBAAgB,EACjB,MAAM,QAAQ,CAAC;AAEhB,MAAM,WAAW,sBAAsB;IACrC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;IAC1C,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB,CAChC,MAAM,SAAS,sBAAsB,GAAG,sBAAsB;IAE9D,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,mBACf,SAAQ,mBAAmB,EAAE,gBAAgB;CAAG;AAElD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,IAAI,CAAC,iBAAiB,EAAE,WAAW,GAAG,SAAS,CAAC,CAAC;IAC1D,OAAO,EAAE,mBAAmB,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types.js

@@ -0,0 +1 @@
+// @bun

package/dist/validator.d.ts

@@ -1,19 +1,15 @@
-import { OverlaySpec } from "./spec.js";
-
-//#region src/validator.d.ts
-interface OverlayValidationIssue {
-  code: string;
-  message: string;
-  path?: string[];
+import type { OverlaySpec } from './spec';
+export interface OverlayValidationIssue {
+    code: string;
+    message: string;
+    path?: string[];
 }
-interface OverlayValidationResult {
-  valid: boolean;
-  issues: OverlayValidationIssue[];
+export interface OverlayValidationResult {
+    valid: boolean;
+    issues: OverlayValidationIssue[];
 }
-type OverlayValidator = (spec: OverlaySpec) => OverlayValidationResult;
-declare const defaultOverlayValidator: OverlayValidator;
-declare function validateOverlaySpec(spec: OverlaySpec): OverlayValidationResult;
-declare function assertOverlayValid(spec: OverlaySpec, validator?: OverlayValidator): void;
-//#endregion
-export { OverlayValidationIssue, OverlayValidationResult, OverlayValidator, assertOverlayValid, defaultOverlayValidator, validateOverlaySpec };
+export type OverlayValidator = (spec: OverlaySpec) => OverlayValidationResult;
+export declare const defaultOverlayValidator: OverlayValidator;
+export declare function validateOverlaySpec(spec: OverlaySpec): OverlayValidationResult;
+export declare function assertOverlayValid(spec: OverlaySpec, validator?: OverlayValidator): void;
 //# sourceMappingURL=validator.d.ts.map

package/dist/validator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"validator.d.ts","names":[],"sources":["../src/validator.ts"],"mappings":";;;UAEiB,sBAAA;EACf,IAAA;EACA,OAAA;EACA,IAAA;AAAA;AAAA,UAGe,uBAAA;EACf,KAAA;EACA,MAAA,EAAQ,sBAAA;AAAA;AAAA,KAGE,gBAAA,IAAoB,IAAA,EAAM,WAAA,KAAgB,uBAAA;AAAA,cAUzC,uBAAA,EAAyB,gBAAA;AAAA,iBAGtB,mBAAA,CACd,IAAA,EAAM,WAAA,GACL,uBAAA;AAAA,iBA6Ia,kBAAA,CACd,IAAA,EAAM,WAAA,EACN,SAAA,GAAW,gBAAA"}
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../src/validator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE/D,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,sBAAsB,EAAE,CAAC;CAClC;AAED,MAAM,MAAM,gBAAgB,GAAG,CAAC,IAAI,EAAE,WAAW,KAAK,uBAAuB,CAAC;AAU9E,eAAO,MAAM,uBAAuB,EAAE,gBACX,CAAC;AAE5B,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,WAAW,GAChB,uBAAuB,CAkDzB;AA2FD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,WAAW,EACjB,SAAS,GAAE,gBAA0C,QAStD"}

package/dist/validator.js

@@ -1,101 +1,132 @@
-//#region src/validator.ts
-const TARGET_KEYS = [
-	"capability",
-	"workflow",
-	"dataView",
-	"presentation",
-	"operation"
+// @bun
+// src/validator.ts
+var TARGET_KEYS = [
+  "capability",
+  "workflow",
+  "dataView",
+  "presentation",
+  "operation"
 ];
-const defaultOverlayValidator = (spec) => validateOverlaySpec(spec);
+var defaultOverlayValidator = (spec) => validateOverlaySpec(spec);
 function validateOverlaySpec(spec) {
-	const issues = [];
-	if (!spec.overlayId?.trim()) issues.push({
-		code: "overlay.id",
-		message: "overlayId is required",
-		path: ["overlayId"]
-	});
-	if (!spec.version?.trim()) issues.push({
-		code: "overlay.version",
-		message: "version is required",
-		path: ["version"]
-	});
-	if (!TARGET_KEYS.some((key) => {
-		const value = spec.appliesTo?.[key];
-		return typeof value === "string" && value.trim().length > 0;
-	})) issues.push({
-		code: "overlay.target",
-		message: "Overlay must specify at least one target (capability, workflow, dataView, presentation, or operation).",
-		path: ["appliesTo"]
-	});
-	if (!spec.modifications?.length) issues.push({
-		code: "overlay.modifications.empty",
-		message: "Overlay must include at least one modification.",
-		path: ["modifications"]
-	});
-	else spec.modifications.forEach((mod, idx) => {
-		validateModification(mod, ["modifications", String(idx)], issues);
-	});
-	return {
-		valid: issues.length === 0,
-		issues
-	};
+  const issues = [];
+  if (!spec.overlayId?.trim()) {
+    issues.push({
+      code: "overlay.id",
+      message: "overlayId is required",
+      path: ["overlayId"]
+    });
+  }
+  if (!spec.version?.trim()) {
+    issues.push({
+      code: "overlay.version",
+      message: "version is required",
+      path: ["version"]
+    });
+  }
+  const hasTarget = TARGET_KEYS.some((key) => {
+    const value = spec.appliesTo?.[key];
+    return typeof value === "string" && value.trim().length > 0;
+  });
+  if (!hasTarget) {
+    issues.push({
+      code: "overlay.target",
+      message: "Overlay must specify at least one target (capability, workflow, dataView, presentation, or operation).",
+      path: ["appliesTo"]
+    });
+  }
+  if (!spec.modifications?.length) {
+    issues.push({
+      code: "overlay.modifications.empty",
+      message: "Overlay must include at least one modification.",
+      path: ["modifications"]
+    });
+  } else {
+    spec.modifications.forEach((mod, idx) => {
+      const path = ["modifications", String(idx)];
+      validateModification(mod, path, issues);
+    });
+  }
+  return {
+    valid: issues.length === 0,
+    issues
+  };
 }
 function validateModification(modification, path, issues) {
-	const push = (code, message, extraPath) => {
-		issues.push({
-			code,
-			message,
-			path: extraPath ? [...path, ...extraPath] : path
-		});
-	};
-	if (isFieldModification(modification)) {
-		if (!modification.field?.trim()) push("overlay.mod.field", "field is required for this modification", ["field"]);
-	}
-	switch (modification.type) {
-		case "renameLabel":
-			if (!modification.newLabel?.trim()) push("overlay.mod.renameLabel.newLabel", "newLabel is required", ["newLabel"]);
-			break;
-		case "reorderFields": {
-			if (!modification.fields?.length) push("overlay.mod.reorderFields.fields", "fields list cannot be empty", ["fields"]);
-			const seen = /* @__PURE__ */ new Set();
-			for (const field of modification.fields ?? []) {
-				if (!field?.trim()) {
-					push("overlay.mod.reorderFields.fields.blank", "fields entries must be non-empty");
-					break;
-				}
-				if (seen.has(field)) {
-					push("overlay.mod.reorderFields.fields.duplicate", `field "${field}" was listed multiple times`);
-					break;
-				}
-				seen.add(field);
-			}
-			break;
-		}
-		case "setDefault":
-			if (modification.value === void 0) push("overlay.mod.setDefault.value", "value is required", ["value"]);
-			break;
-		case "addHelpText":
-			if (!modification.text?.trim()) push("overlay.mod.addHelpText.text", "text is required", ["text"]);
-			break;
-		case "makeRequired":
-		case "hideField": break;
-		default: {
-			const exhaustive = modification;
-			throw new Error(`Unsupported overlay modification ${exhaustive?.type ?? "unknown"}`);
-		}
-	}
+  const push = (code, message, extraPath) => {
+    issues.push({
+      code,
+      message,
+      path: extraPath ? [...path, ...extraPath] : path
+    });
+  };
+  if (isFieldModification(modification)) {
+    if (!modification.field?.trim()) {
+      push("overlay.mod.field", "field is required for this modification", [
+        "field"
+      ]);
+    }
+  }
+  switch (modification.type) {
+    case "renameLabel": {
+      if (!modification.newLabel?.trim()) {
+        push("overlay.mod.renameLabel.newLabel", "newLabel is required", [
+          "newLabel"
+        ]);
+      }
+      break;
+    }
+    case "reorderFields": {
+      if (!modification.fields?.length) {
+        push("overlay.mod.reorderFields.fields", "fields list cannot be empty", ["fields"]);
+      }
+      const seen = new Set;
+      for (const field of modification.fields ?? []) {
+        if (!field?.trim()) {
+          push("overlay.mod.reorderFields.fields.blank", "fields entries must be non-empty");
+          break;
+        }
+        if (seen.has(field)) {
+          push("overlay.mod.reorderFields.fields.duplicate", `field "${field}" was listed multiple times`);
+          break;
+        }
+        seen.add(field);
+      }
+      break;
+    }
+    case "setDefault": {
+      if (modification.value === undefined) {
+        push("overlay.mod.setDefault.value", "value is required", ["value"]);
+      }
+      break;
+    }
+    case "addHelpText": {
+      if (!modification.text?.trim()) {
+        push("overlay.mod.addHelpText.text", "text is required", ["text"]);
+      }
+      break;
+    }
+    case "makeRequired":
+    case "hideField":
+      break;
+    default: {
+      const exhaustive = modification;
+      throw new Error(`Unsupported overlay modification ${exhaustive?.type ?? "unknown"}`);
+    }
+  }
 }
 function isFieldModification(mod) {
-	return "field" in mod;
+  return "field" in mod;
 }
 function assertOverlayValid(spec, validator = defaultOverlayValidator) {
-	const result = validator(spec);
-	if (!result.valid) {
-		const message = result.issues.map((issue) => `${issue.code}: ${issue.message}`).join("; ");
-		throw new Error(`Invalid OverlaySpec "${spec.overlayId}": ${message}`);
-	}
+  const result = validator(spec);
+  if (!result.valid) {
+    const message = result.issues.map((issue) => `${issue.code}: ${issue.message}`).join("; ");
+    throw new Error(`Invalid OverlaySpec "${spec.overlayId}": ${message}`);
+  }
 }
-
-//#endregion
-export { assertOverlayValid, defaultOverlayValidator, validateOverlaySpec };
-//# sourceMappingURL=validator.js.map
+export {
+  validateOverlaySpec,
+  defaultOverlayValidator,
+  assertOverlayValid
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contractspec/lib.overlay-engine",
-  "version": "1.57.0",
+  "version": "1.58.0",
   "description": "Runtime overlay engine for ContractSpec personalization and adaptive UI rendering.",
   "keywords": [
     "contractspec",
@@ -19,18 +19,20 @@
   "scripts": {
     "publish:pkg": "bun publish --tolerate-republish --ignore-scripts --verbose",
     "publish:pkg:canary": "bun publish:pkg --tag canary",
-    "build": "bun build:types && bun build:bundle",
-    "build:bundle": "tsdown",
-    "build:types": "tsc --noEmit",
-    "dev": "bun build:bundle --watch",
+    "build": "bun run prebuild && bun run build:bundle && bun run build:types",
+    "build:bundle": "contractspec-bun-build transpile",
+    "build:types": "contractspec-bun-build types",
+    "dev": "contractspec-bun-build dev",
     "clean": "rimraf dist .turbo",
     "lint": "bun lint:fix",
     "lint:fix": "eslint src --fix",
     "lint:check": "eslint src",
-    "test": "bun test"
+    "test": "bun test",
+    "prebuild": "contractspec-bun-build prebuild",
+    "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@contractspec/lib.contracts": "1.57.0",
+    "@contractspec/lib.contracts": "1.58.0",
     "fast-json-stable-stringify": "^2.1.0"
   },
   "peerDependencies": {
@@ -42,36 +44,78 @@
     }
   },
   "devDependencies": {
-    "@contractspec/tool.tsdown": "1.57.0",
-    "@contractspec/tool.typescript": "1.57.0",
-    "tsdown": "^0.20.3",
-    "typescript": "^5.9.3"
+    "@contractspec/tool.typescript": "1.58.0",
+    "typescript": "^5.9.3",
+    "@contractspec/tool.bun": "1.57.0"
   },
   "exports": {
-    ".": "./dist/index.js",
-    "./merger": "./dist/merger.js",
-    "./react": "./dist/react.js",
-    "./registry": "./dist/registry.js",
-    "./runtime": "./dist/runtime.js",
-    "./signer": "./dist/signer.js",
-    "./spec": "./dist/spec.js",
-    "./types": "./dist/types.js",
-    "./validator": "./dist/validator.js",
-    "./*": "./*"
+    ".": "./src/index.ts",
+    "./merger": "./src/merger.ts",
+    "./react": "./src/react.ts",
+    "./registry": "./src/registry.ts",
+    "./runtime": "./src/runtime.ts",
+    "./signer": "./src/signer.ts",
+    "./spec": "./src/spec.ts",
+    "./types": "./src/types.ts",
+    "./validator": "./src/validator.ts"
   },
   "publishConfig": {
     "access": "public",
     "exports": {
-      ".": "./dist/index.js",
-      "./merger": "./dist/merger.js",
-      "./react": "./dist/react.js",
-      "./registry": "./dist/registry.js",
-      "./runtime": "./dist/runtime.js",
-      "./signer": "./dist/signer.js",
-      "./spec": "./dist/spec.js",
-      "./types": "./dist/types.js",
-      "./validator": "./dist/validator.js",
-      "./*": "./*"
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "node": "./dist/node/index.mjs",
+        "default": "./dist/index.js"
+      },
+      "./merger": {
+        "types": "./dist/merger.d.ts",
+        "bun": "./dist/merger.js",
+        "node": "./dist/node/merger.mjs",
+        "default": "./dist/merger.js"
+      },
+      "./react": {
+        "types": "./dist/react.d.ts",
+        "bun": "./dist/react.js",
+        "node": "./dist/node/react.mjs",
+        "default": "./dist/react.js"
+      },
+      "./registry": {
+        "types": "./dist/registry.d.ts",
+        "bun": "./dist/registry.js",
+        "node": "./dist/node/registry.mjs",
+        "default": "./dist/registry.js"
+      },
+      "./runtime": {
+        "types": "./dist/runtime.d.ts",
+        "bun": "./dist/runtime.js",
+        "node": "./dist/node/runtime.mjs",
+        "default": "./dist/runtime.js"
+      },
+      "./signer": {
+        "types": "./dist/signer.d.ts",
+        "bun": "./dist/signer.js",
+        "node": "./dist/node/signer.mjs",
+        "default": "./dist/signer.js"
+      },
+      "./spec": {
+        "types": "./dist/spec.d.ts",
+        "bun": "./dist/spec.js",
+        "node": "./dist/node/spec.mjs",
+        "default": "./dist/spec.js"
+      },
+      "./types": {
+        "types": "./dist/types.d.ts",
+        "bun": "./dist/types.js",
+        "node": "./dist/node/types.mjs",
+        "default": "./dist/types.js"
+      },
+      "./validator": {
+        "types": "./dist/validator.d.ts",
+        "bun": "./dist/validator.js",
+        "node": "./dist/node/validator.mjs",
+        "default": "./dist/validator.js"
+      }
     },
     "registry": "https://registry.npmjs.org/"
   },

package/dist/merger.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"merger.js","names":[],"sources":["../src/merger.ts"],"sourcesContent":["import type { SignedOverlaySpec } from './spec';\nimport type { OverlayRenderable, OverlayRenderableField } from './types';\n\nexport interface ApplyOverlayOptions {\n  strict?: boolean;\n}\n\ninterface FieldState<TField extends OverlayRenderableField> {\n  key: string;\n  field: TField;\n  hidden: boolean;\n}\n\nexport function applyOverlayModifications<T extends OverlayRenderable>(\n  target: T,\n  overlays: SignedOverlaySpec[],\n  options: ApplyOverlayOptions = {}\n): T {\n  if (!overlays.length) {\n    return target;\n  }\n\n  const states = target.fields.map<FieldState<OverlayRenderableField>>(\n    (field) => ({\n      key: field.key,\n      field: { ...field },\n      hidden: field.visible === false,\n    })\n  );\n\n  const fieldMap = new Map(states.map((state) => [state.key, state]));\n  let orderSequence = target.fields.map((field) => field.key);\n\n  const handleMissing = (field: string, overlayId: string) => {\n    if (options.strict) {\n      throw new Error(\n        `Overlay \"${overlayId}\" referenced unknown field \"${field}\".`\n      );\n    }\n  };\n\n  overlays.forEach((overlay) => {\n    overlay.modifications.forEach((modification) => {\n      switch (modification.type) {\n        case 'hideField': {\n          const state = fieldMap.get(modification.field);\n          if (!state)\n            return handleMissing(modification.field, overlay.overlayId);\n          state.hidden = true;\n          state.field.visible = false;\n          break;\n        }\n        case 'renameLabel': {\n          const state = fieldMap.get(modification.field);\n          if (!state)\n            return handleMissing(modification.field, overlay.overlayId);\n          state.field.label = modification.newLabel;\n          break;\n        }\n        case 'setDefault': {\n          const state = fieldMap.get(modification.field);\n          if (!state)\n            return handleMissing(modification.field, overlay.overlayId);\n          state.field.defaultValue = modification.value;\n          break;\n        }\n        case 'addHelpText': {\n          const state = fieldMap.get(modification.field);\n          if (!state)\n            return handleMissing(modification.field, overlay.overlayId);\n          state.field.helpText = modification.text;\n          break;\n        }\n        case 'makeRequired': {\n          const state = fieldMap.get(modification.field);\n          if (!state)\n            return handleMissing(modification.field, overlay.overlayId);\n          state.field.required = modification.required ?? true;\n          break;\n        }\n        case 'reorderFields': {\n          const { filtered, missing } = normalizeOrderList(\n            modification.fields,\n            fieldMap\n          );\n          if (missing.length && options.strict) {\n            missing.forEach((field) => handleMissing(field, overlay.overlayId));\n          }\n          orderSequence = applyReorder(orderSequence, filtered);\n          break;\n        }\n        default:\n          break;\n      }\n    });\n  });\n\n  const visibleFields: OverlayRenderableField[] = [];\n  const seen = new Set<string>();\n  orderSequence.forEach((key) => {\n    const state = fieldMap.get(key);\n    if (!state || state.hidden) {\n      return;\n    }\n    seen.add(key);\n    visibleFields.push(state.field);\n  });\n\n  // Handle any fields introduced dynamically that were not part of the original sequence.\n  states.forEach((state) => {\n    if (state.hidden || seen.has(state.key)) {\n      return;\n    }\n    visibleFields.push(state.field);\n  });\n\n  visibleFields.forEach((field, index) => {\n    field.order = index;\n    field.visible = true;\n  });\n\n  return {\n    ...(target as T),\n    fields: visibleFields as T['fields'],\n  };\n}\n\nfunction normalizeOrderList(\n  fields: string[],\n  fieldMap: Map<string, FieldState<OverlayRenderableField>>\n): { filtered: string[]; missing: string[] } {\n  const filtered: string[] = [];\n  const missing: string[] = [];\n  const seen = new Set<string>();\n\n  fields.forEach((field) => {\n    if (!field?.trim()) {\n      return;\n    }\n    if (!fieldMap.has(field)) {\n      missing.push(field);\n      return;\n    }\n    if (seen.has(field)) {\n      return;\n    }\n    seen.add(field);\n    filtered.push(field);\n  });\n\n  return { filtered, missing };\n}\n\nfunction applyReorder(sequence: string[], orderedFields: string[]): string[] {\n  if (!orderedFields.length) {\n    return sequence;\n  }\n  const orderedSet = new Set(orderedFields);\n  const remainder = sequence.filter((key) => !orderedSet.has(key));\n  return [...orderedFields, ...remainder];\n}\n"],"mappings":"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"}

package/dist/react.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"react.js","names":[],"sources":["../src/react.ts"],"sourcesContent":["import { useMemo, type DependencyList } from 'react';\nimport type { OverlayRenderable } from './types';\nimport type { OverlayApplyParams, OverlayRuntimeResult } from './runtime';\nimport { OverlayEngine } from './runtime';\n\nexport function useOverlay<T extends OverlayRenderable>(\n  engine: OverlayEngine | undefined,\n  params: OverlayApplyParams<T>,\n  deps: DependencyList = []\n): OverlayRuntimeResult<T> {\n  return useMemo(() => {\n    if (!engine) {\n      return {\n        target: params.target,\n        overlaysApplied: [],\n      };\n    }\n    return engine.apply(params);\n  }, [engine, params, ...deps]);\n}\n\nexport function useOverlayFields<T extends OverlayRenderable>(\n  engine: OverlayEngine | undefined,\n  params: OverlayApplyParams<T>,\n  deps: DependencyList = []\n): T['fields'] {\n  const result = useOverlay(engine, params, deps);\n  return result.target.fields;\n}\n"],"mappings":";;;AAKA,SAAgB,WACd,QACA,QACA,OAAuB,EAAE,EACA;AACzB,QAAO,cAAc;AACnB,MAAI,CAAC,OACH,QAAO;GACL,QAAQ,OAAO;GACf,iBAAiB,EAAE;GACpB;AAEH,SAAO,OAAO,MAAM,OAAO;IAC1B;EAAC;EAAQ;EAAQ,GAAG;EAAK,CAAC;;AAG/B,SAAgB,iBACd,QACA,QACA,OAAuB,EAAE,EACZ;AAEb,QADe,WAAW,QAAQ,QAAQ,KAAK,CACjC,OAAO"}

package/dist/registry.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"registry.js","names":[],"sources":["../src/registry.ts"],"sourcesContent":["import type {\n  OverlayInput,\n  OverlayAppliesTo,\n  OverlayScopeContext,\n  OverlayTargetRef,\n  SignedOverlaySpec,\n} from './spec';\nimport type { OverlayValidator } from './validator';\nimport { defaultOverlayValidator } from './validator';\n\nexport interface OverlayRegistryOptions {\n  validator?: OverlayValidator;\n  allowUnsigned?: boolean;\n}\n\nexport interface OverlayLookup extends OverlayScopeContext, OverlayTargetRef {}\n\ninterface StoredOverlay {\n  overlay: SignedOverlaySpec;\n  specificity: number;\n  registeredAt: number;\n}\n\nconst TARGET_KEYS: (keyof OverlayTargetRef)[] = [\n  'capability',\n  'workflow',\n  'dataView',\n  'presentation',\n  'operation',\n];\n\nconst SCOPE_WEIGHTS: Record<keyof OverlayScopeContext, number> = {\n  tenantId: 8,\n  role: 4,\n  userId: 16,\n  device: 2,\n  tags: 1,\n};\n\nexport class OverlayRegistry {\n  private readonly overlays = new Map<string, StoredOverlay>();\n\n  constructor(private readonly options: OverlayRegistryOptions = {}) {}\n\n  register(\n    overlay: OverlayInput,\n    options?: { skipValidation?: boolean }\n  ): SignedOverlaySpec {\n    if (!options?.skipValidation) {\n      const validator = this.options.validator ?? defaultOverlayValidator;\n      const result = validator(overlay as SignedOverlaySpec);\n      if (!result.valid) {\n        const reason = result.issues\n          .map((issue) => `${issue.code}: ${issue.message}`)\n          .join('; ');\n        throw new Error(\n          `Overlay \"${overlay.overlayId}\" failed validation: ${reason}`\n        );\n      }\n    }\n\n    const normalized = this.ensureSigned(overlay);\n    const key = this.getKey(normalized.overlayId, normalized.version);\n    const stored: StoredOverlay = {\n      overlay: normalized,\n      specificity: computeSpecificity(normalized.appliesTo),\n      registeredAt: Date.now(),\n    };\n    this.overlays.set(key, stored);\n    return normalized;\n  }\n\n  unregister(overlayId: string, version?: string) {\n    if (version) {\n      this.overlays.delete(this.getKey(overlayId, version));\n      return;\n    }\n\n    for (const key of Array.from(this.overlays.keys())) {\n      if (key.startsWith(`${overlayId}@`)) {\n        this.overlays.delete(key);\n      }\n    }\n  }\n\n  list(): SignedOverlaySpec[] {\n    return Array.from(this.overlays.values()).map((entry) => entry.overlay);\n  }\n\n  get(overlayId: string, version: string): SignedOverlaySpec | undefined {\n    return this.overlays.get(this.getKey(overlayId, version))?.overlay;\n  }\n\n  forContext(query: OverlayLookup): SignedOverlaySpec[] {\n    return Array.from(this.overlays.values())\n      .filter((entry) => matches(entry.overlay.appliesTo, query))\n      .sort((a, b) => {\n        if (a.specificity !== b.specificity) {\n          return a.specificity - b.specificity;\n        }\n        return a.registeredAt - b.registeredAt;\n      })\n      .map((entry) => entry.overlay);\n  }\n\n  clear() {\n    this.overlays.clear();\n  }\n\n  size(): number {\n    return this.overlays.size;\n  }\n\n  private ensureSigned(input: OverlayInput): SignedOverlaySpec {\n    if (isSignedOverlay(input)) {\n      if (!input.signature?.signature && !this.options.allowUnsigned) {\n        throw new Error(`Overlay \"${input.overlayId}\" is missing a signature.`);\n      }\n      return input;\n    }\n\n    if (!this.options.allowUnsigned) {\n      throw new Error(\n        `Overlay \"${input.overlayId}\" must be signed before registration.`\n      );\n    }\n\n    return input as SignedOverlaySpec;\n  }\n\n  private getKey(overlayId: string, version: string) {\n    return `${overlayId}@${version}`;\n  }\n}\n\nfunction isSignedOverlay(spec: OverlayInput): spec is SignedOverlaySpec {\n  return Boolean((spec as SignedOverlaySpec).signature);\n}\n\nfunction computeSpecificity(appliesTo: OverlayAppliesTo): number {\n  let score = 0;\n  (Object.keys(SCOPE_WEIGHTS) as (keyof OverlayScopeContext)[]).forEach(\n    (key) => {\n      const hasValue =\n        key === 'tags'\n          ? Array.isArray(appliesTo.tags) && appliesTo.tags.length > 0\n          : Boolean(appliesTo[key]);\n      if (hasValue) {\n        score += SCOPE_WEIGHTS[key];\n      }\n    }\n  );\n  return score;\n}\n\nfunction matches(appliesTo: OverlayAppliesTo, ctx: OverlayLookup): boolean {\n  for (const key of TARGET_KEYS) {\n    const expected = appliesTo[key];\n    if (expected && expected !== ctx[key]) {\n      return false;\n    }\n  }\n\n  if (appliesTo.tenantId && appliesTo.tenantId !== ctx.tenantId) {\n    return false;\n  }\n  if (appliesTo.role && appliesTo.role !== ctx.role) {\n    return false;\n  }\n  if (appliesTo.userId && appliesTo.userId !== ctx.userId) {\n    return false;\n  }\n  if (appliesTo.device && appliesTo.device !== ctx.device) {\n    return false;\n  }\n  if (appliesTo.tags?.length) {\n    if (!ctx.tags?.length) {\n      return false;\n    }\n    const ctxTags = new Set(ctx.tags);\n    const satisfies = appliesTo.tags.every((tag) => ctxTags.has(tag));\n    if (!satisfies) {\n      return false;\n    }\n  }\n\n  return true;\n}\n"],"mappings":"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"}

package/dist/runtime.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime.ts"],"sourcesContent":["import { applyOverlayModifications, type ApplyOverlayOptions } from './merger';\nimport { OverlayRegistry, type OverlayLookup } from './registry';\nimport type { SignedOverlaySpec } from './spec';\nimport type { OverlayRenderable, OverlayAuditEvent } from './types';\n\nexport interface OverlayEngineOptions {\n  registry: OverlayRegistry;\n  audit?: (event: OverlayAuditEvent) => void;\n}\n\nexport interface OverlayApplyParams<\n  T extends OverlayRenderable,\n> extends OverlayLookup {\n  target: T;\n  overlays?: SignedOverlaySpec[];\n  strict?: ApplyOverlayOptions['strict'];\n}\n\nexport interface OverlayRuntimeResult<T extends OverlayRenderable> {\n  target: T;\n  overlaysApplied: SignedOverlaySpec[];\n}\n\nexport class OverlayEngine {\n  private readonly registry: OverlayRegistry;\n  private readonly audit?: (event: OverlayAuditEvent) => void;\n\n  constructor(options: OverlayEngineOptions) {\n    this.registry = options.registry;\n    this.audit = options.audit;\n  }\n\n  apply<T extends OverlayRenderable>(\n    params: OverlayApplyParams<T>\n  ): OverlayRuntimeResult<T> {\n    const overlays =\n      params.overlays ??\n      this.registry.forContext({\n        capability: params.capability,\n        workflow: params.workflow,\n        dataView: params.dataView,\n        presentation: params.presentation,\n        operation: params.operation,\n        tenantId: params.tenantId,\n        role: params.role,\n        userId: params.userId,\n        device: params.device,\n        tags: params.tags,\n      });\n\n    const merged = applyOverlayModifications(params.target, overlays, {\n      strict: params.strict,\n    });\n\n    const context = extractContext(params);\n    overlays.forEach((overlay) => {\n      this.audit?.({\n        overlay: {\n          overlayId: overlay.overlayId,\n          version: overlay.version,\n        },\n        context,\n        timestamp: new Date().toISOString(),\n      });\n    });\n\n    return {\n      target: merged,\n      overlaysApplied: overlays,\n    };\n  }\n}\n\nfunction extractContext(params: OverlayLookup): OverlayAuditEvent['context'] {\n  return {\n    tenantId: params.tenantId,\n    role: params.role,\n    userId: params.userId,\n    device: params.device,\n    tags: params.tags,\n  };\n}\n"],"mappings":";;;AAuBA,IAAa,gBAAb,MAA2B;CACzB,AAAiB;CACjB,AAAiB;CAEjB,YAAY,SAA+B;AACzC,OAAK,WAAW,QAAQ;AACxB,OAAK,QAAQ,QAAQ;;CAGvB,MACE,QACyB;EACzB,MAAM,WACJ,OAAO,YACP,KAAK,SAAS,WAAW;GACvB,YAAY,OAAO;GACnB,UAAU,OAAO;GACjB,UAAU,OAAO;GACjB,cAAc,OAAO;GACrB,WAAW,OAAO;GAClB,UAAU,OAAO;GACjB,MAAM,OAAO;GACb,QAAQ,OAAO;GACf,QAAQ,OAAO;GACf,MAAM,OAAO;GACd,CAAC;EAEJ,MAAM,SAAS,0BAA0B,OAAO,QAAQ,UAAU,EAChE,QAAQ,OAAO,QAChB,CAAC;EAEF,MAAM,UAAU,eAAe,OAAO;AACtC,WAAS,SAAS,YAAY;AAC5B,QAAK,QAAQ;IACX,SAAS;KACP,WAAW,QAAQ;KACnB,SAAS,QAAQ;KAClB;IACD;IACA,4BAAW,IAAI,MAAM,EAAC,aAAa;IACpC,CAAC;IACF;AAEF,SAAO;GACL,QAAQ;GACR,iBAAiB;GAClB;;;AAIL,SAAS,eAAe,QAAqD;AAC3E,QAAO;EACL,UAAU,OAAO;EACjB,MAAM,OAAO;EACb,QAAQ,OAAO;EACf,QAAQ,OAAO;EACf,MAAM,OAAO;EACd"}

package/dist/signer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"signer.js","names":[],"sources":["../src/signer.ts"],"sourcesContent":["import stringify from 'fast-json-stable-stringify';\nimport {\n  constants,\n  createPrivateKey,\n  createPublicKey,\n  type KeyLike,\n  sign,\n  verify,\n} from 'crypto';\nimport type {\n  OverlaySignatureAlgorithm,\n  OverlaySpec,\n  SignedOverlaySpec,\n} from './spec';\n\nexport interface SignOverlayOptions {\n  algorithm?: OverlaySignatureAlgorithm;\n  keyId?: string;\n  issuedAt?: Date | string;\n  expiresAt?: Date | string;\n  metadata?: Record<string, unknown>;\n  publicKey?: string;\n}\n\nexport function signOverlay(\n  spec: OverlaySpec,\n  privateKey: KeyLike | string | Buffer,\n  options: SignOverlayOptions = {}\n): SignedOverlaySpec {\n  const algorithm = options.algorithm ?? 'ed25519';\n  const keyObject =\n    typeof privateKey === 'string' || Buffer.isBuffer(privateKey)\n      ? createPrivateKey(privateKey)\n      : privateKey;\n  const payload = Buffer.from(canonicalizeOverlay(spec), 'utf8');\n\n  let rawSignature: Buffer;\n  if (algorithm === 'ed25519') {\n    rawSignature = sign(null, payload, keyObject);\n  } else if (algorithm === 'rsa-pss-sha256') {\n    rawSignature = sign('sha256', payload, {\n      key: keyObject,\n      padding: constants.RSA_PKCS1_PSS_PADDING,\n      saltLength: 32,\n    });\n  } else {\n    throw new Error(`Unsupported overlay signature algorithm: ${algorithm}`);\n  }\n\n  const publicKey =\n    options.publicKey ??\n    createPublicKey(keyObject)\n      .export({ format: 'pem', type: 'spki' })\n      .toString();\n\n  return {\n    ...spec,\n    signature: {\n      algorithm,\n      signature: rawSignature.toString('base64'),\n      publicKey,\n      keyId: options.keyId,\n      issuedAt: toIso(options.issuedAt) ?? new Date().toISOString(),\n      expiresAt: toIso(options.expiresAt),\n      metadata: options.metadata,\n    },\n  };\n}\n\nexport function verifyOverlaySignature(overlay: SignedOverlaySpec): boolean {\n  if (!overlay.signature?.signature) {\n    throw new Error(\n      `Overlay \"${overlay.overlayId}\" is missing signature metadata.`\n    );\n  }\n  const payload = Buffer.from(canonicalizeOverlay(overlay), 'utf8');\n  const signature = Buffer.from(overlay.signature.signature, 'base64');\n  const publicKey = createPublicKey(overlay.signature.publicKey);\n\n  if (overlay.signature.algorithm === 'ed25519') {\n    return verify(null, payload, publicKey, signature);\n  }\n\n  if (overlay.signature.algorithm === 'rsa-pss-sha256') {\n    return verify(\n      'sha256',\n      payload,\n      {\n        key: publicKey,\n        padding: constants.RSA_PKCS1_PSS_PADDING,\n        saltLength: 32,\n      },\n      signature\n    );\n  }\n\n  throw new Error(\n    `Unsupported overlay signature algorithm: ${overlay.signature.algorithm}`\n  );\n}\n\nexport function canonicalizeOverlay(\n  spec: OverlaySpec | SignedOverlaySpec\n): string {\n  const { signature, ...rest } = spec as SignedOverlaySpec;\n  return stringify(rest);\n}\n\nexport function stripSignature<T extends OverlaySpec | SignedOverlaySpec>(\n  spec: T\n): OverlaySpec {\n  const { signature, ...rest } = spec as SignedOverlaySpec;\n  return { ...rest };\n}\n\nfunction toIso(value?: Date | string): string | undefined {\n  if (!value) {\n    return undefined;\n  }\n  if (typeof value === 'string') {\n    return new Date(value).toISOString();\n  }\n  return value.toISOString();\n}\n"],"mappings":";;;;AAwBA,SAAgB,YACd,MACA,YACA,UAA8B,EAAE,EACb;CACnB,MAAM,YAAY,QAAQ,aAAa;CACvC,MAAM,YACJ,OAAO,eAAe,YAAY,OAAO,SAAS,WAAW,GACzD,iBAAiB,WAAW,GAC5B;CACN,MAAM,UAAU,OAAO,KAAK,oBAAoB,KAAK,EAAE,OAAO;CAE9D,IAAI;AACJ,KAAI,cAAc,UAChB,gBAAe,KAAK,MAAM,SAAS,UAAU;UACpC,cAAc,iBACvB,gBAAe,KAAK,UAAU,SAAS;EACrC,KAAK;EACL,SAAS,UAAU;EACnB,YAAY;EACb,CAAC;KAEF,OAAM,IAAI,MAAM,4CAA4C,YAAY;CAG1E,MAAM,YACJ,QAAQ,aACR,gBAAgB,UAAU,CACvB,OAAO;EAAE,QAAQ;EAAO,MAAM;EAAQ,CAAC,CACvC,UAAU;AAEf,QAAO;EACL,GAAG;EACH,WAAW;GACT;GACA,WAAW,aAAa,SAAS,SAAS;GAC1C;GACA,OAAO,QAAQ;GACf,UAAU,MAAM,QAAQ,SAAS,qBAAI,IAAI,MAAM,EAAC,aAAa;GAC7D,WAAW,MAAM,QAAQ,UAAU;GACnC,UAAU,QAAQ;GACnB;EACF;;AAGH,SAAgB,uBAAuB,SAAqC;AAC1E,KAAI,CAAC,QAAQ,WAAW,UACtB,OAAM,IAAI,MACR,YAAY,QAAQ,UAAU,kCAC/B;CAEH,MAAM,UAAU,OAAO,KAAK,oBAAoB,QAAQ,EAAE,OAAO;CACjE,MAAM,YAAY,OAAO,KAAK,QAAQ,UAAU,WAAW,SAAS;CACpE,MAAM,YAAY,gBAAgB,QAAQ,UAAU,UAAU;AAE9D,KAAI,QAAQ,UAAU,cAAc,UAClC,QAAO,OAAO,MAAM,SAAS,WAAW,UAAU;AAGpD,KAAI,QAAQ,UAAU,cAAc,iBAClC,QAAO,OACL,UACA,SACA;EACE,KAAK;EACL,SAAS,UAAU;EACnB,YAAY;EACb,EACD,UACD;AAGH,OAAM,IAAI,MACR,4CAA4C,QAAQ,UAAU,YAC/D;;AAGH,SAAgB,oBACd,MACQ;CACR,MAAM,EAAE,WAAW,GAAG,SAAS;AAC/B,QAAO,UAAU,KAAK;;AAGxB,SAAgB,eACd,MACa;CACb,MAAM,EAAE,WAAW,GAAG,SAAS;AAC/B,QAAO,EAAE,GAAG,MAAM;;AAGpB,SAAS,MAAM,OAA2C;AACxD,KAAI,CAAC,MACH;AAEF,KAAI,OAAO,UAAU,SACnB,QAAO,IAAI,KAAK,MAAM,CAAC,aAAa;AAEtC,QAAO,MAAM,aAAa"}

package/dist/spec.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"spec.js","names":[],"sources":["../src/spec.ts"],"sourcesContent":["import type { AnyOperationSpec } from '@contractspec/lib.contracts';\n\nexport type OverlayScopeKey =\n  | 'tenantId'\n  | 'role'\n  | 'userId'\n  | 'device'\n  | 'tags';\n\nexport interface OverlayScopeContext {\n  tenantId?: string;\n  role?: string;\n  userId?: string;\n  device?: string;\n  tags?: string[];\n}\n\nexport interface OverlayTargetRef {\n  capability?: string;\n  workflow?: string;\n  dataView?: string;\n  presentation?: string;\n  operation?: AnyOperationSpec['meta']['key'];\n}\n\nexport interface OverlayAppliesTo\n  extends OverlayScopeContext, OverlayTargetRef {\n  /**\n   * Optional label to describe why this overlay exists (displayed in tooling).\n   */\n  label?: string;\n}\n\nexport type OverlayModification =\n  | HideFieldModification\n  | RenameLabelModification\n  | ReorderFieldsModification\n  | SetDefaultModification\n  | AddHelpTextModification\n  | MakeRequiredModification;\n\nexport interface OverlayFieldModificationBase {\n  field: string;\n  description?: string;\n}\n\nexport interface HideFieldModification extends OverlayFieldModificationBase {\n  type: 'hideField';\n  reason?: string;\n}\n\nexport interface RenameLabelModification extends OverlayFieldModificationBase {\n  type: 'renameLabel';\n  newLabel: string;\n}\n\nexport interface ReorderFieldsModification {\n  type: 'reorderFields';\n  fields: string[];\n  description?: string;\n}\n\nexport interface SetDefaultModification extends OverlayFieldModificationBase {\n  type: 'setDefault';\n  value: unknown;\n}\n\nexport interface AddHelpTextModification extends OverlayFieldModificationBase {\n  type: 'addHelpText';\n  text: string;\n}\n\nexport interface MakeRequiredModification extends OverlayFieldModificationBase {\n  type: 'makeRequired';\n  required?: boolean;\n}\n\nexport interface OverlaySpec {\n  overlayId: string;\n  version: string;\n  description?: string;\n  appliesTo: OverlayAppliesTo;\n  modifications: OverlayModification[];\n  metadata?: Record<string, unknown>;\n  createdBy?: string;\n  createdAt?: string;\n}\n\nexport type OverlaySignatureAlgorithm = 'ed25519' | 'rsa-pss-sha256';\n\nexport interface OverlaySignatureBlock {\n  algorithm: OverlaySignatureAlgorithm;\n  signature: string;\n  publicKey: string;\n  keyId?: string;\n  issuedAt?: string;\n  expiresAt?: string;\n  metadata?: Record<string, unknown>;\n}\n\nexport type SignedOverlaySpec = OverlaySpec & {\n  signature: OverlaySignatureBlock;\n};\n\nexport type OverlayInput = OverlaySpec | SignedOverlaySpec;\n\nexport const OVERLAY_SCOPE_ORDER: OverlayScopeKey[] = [\n  'tenantId',\n  'role',\n  'userId',\n  'device',\n  'tags',\n];\n\nexport function defineOverlay<T extends OverlaySpec>(spec: T): T {\n  return spec;\n}\n"],"mappings":";AA0GA,MAAa,sBAAyC;CACpD;CACA;CACA;CACA;CACA;CACD;AAED,SAAgB,cAAqC,MAAY;AAC/D,QAAO"}

package/dist/validator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validator.js","names":[],"sources":["../src/validator.ts"],"sourcesContent":["import type { OverlayModification, OverlaySpec } from './spec';\n\nexport interface OverlayValidationIssue {\n  code: string;\n  message: string;\n  path?: string[];\n}\n\nexport interface OverlayValidationResult {\n  valid: boolean;\n  issues: OverlayValidationIssue[];\n}\n\nexport type OverlayValidator = (spec: OverlaySpec) => OverlayValidationResult;\n\nconst TARGET_KEYS = [\n  'capability',\n  'workflow',\n  'dataView',\n  'presentation',\n  'operation',\n] as const;\n\nexport const defaultOverlayValidator: OverlayValidator = (spec) =>\n  validateOverlaySpec(spec);\n\nexport function validateOverlaySpec(\n  spec: OverlaySpec\n): OverlayValidationResult {\n  const issues: OverlayValidationIssue[] = [];\n\n  if (!spec.overlayId?.trim()) {\n    issues.push({\n      code: 'overlay.id',\n      message: 'overlayId is required',\n      path: ['overlayId'],\n    });\n  }\n\n  if (!spec.version?.trim()) {\n    issues.push({\n      code: 'overlay.version',\n      message: 'version is required',\n      path: ['version'],\n    });\n  }\n\n  const hasTarget = TARGET_KEYS.some((key) => {\n    const value = spec.appliesTo?.[key as keyof typeof spec.appliesTo];\n    return typeof value === 'string' && value.trim().length > 0;\n  });\n\n  if (!hasTarget) {\n    issues.push({\n      code: 'overlay.target',\n      message:\n        'Overlay must specify at least one target (capability, workflow, dataView, presentation, or operation).',\n      path: ['appliesTo'],\n    });\n  }\n\n  if (!spec.modifications?.length) {\n    issues.push({\n      code: 'overlay.modifications.empty',\n      message: 'Overlay must include at least one modification.',\n      path: ['modifications'],\n    });\n  } else {\n    spec.modifications.forEach((mod, idx) => {\n      const path = ['modifications', String(idx)];\n      validateModification(mod, path, issues);\n    });\n  }\n\n  return {\n    valid: issues.length === 0,\n    issues,\n  };\n}\n\nfunction validateModification(\n  modification: OverlayModification,\n  path: string[],\n  issues: OverlayValidationIssue[]\n) {\n  const push = (code: string, message: string, extraPath?: string[]) => {\n    issues.push({\n      code,\n      message,\n      path: extraPath ? [...path, ...extraPath] : path,\n    });\n  };\n\n  if (isFieldModification(modification)) {\n    if (!modification.field?.trim()) {\n      push('overlay.mod.field', 'field is required for this modification', [\n        'field',\n      ]);\n    }\n  }\n\n  switch (modification.type) {\n    case 'renameLabel': {\n      if (!modification.newLabel?.trim()) {\n        push('overlay.mod.renameLabel.newLabel', 'newLabel is required', [\n          'newLabel',\n        ]);\n      }\n      break;\n    }\n    case 'reorderFields': {\n      if (!modification.fields?.length) {\n        push(\n          'overlay.mod.reorderFields.fields',\n          'fields list cannot be empty',\n          ['fields']\n        );\n      }\n      const seen = new Set<string>();\n      for (const field of modification.fields ?? []) {\n        if (!field?.trim()) {\n          push(\n            'overlay.mod.reorderFields.fields.blank',\n            'fields entries must be non-empty'\n          );\n          break;\n        }\n        if (seen.has(field)) {\n          push(\n            'overlay.mod.reorderFields.fields.duplicate',\n            `field \"${field}\" was listed multiple times`\n          );\n          break;\n        }\n        seen.add(field);\n      }\n      break;\n    }\n    case 'setDefault': {\n      if (modification.value === undefined) {\n        push('overlay.mod.setDefault.value', 'value is required', ['value']);\n      }\n      break;\n    }\n    case 'addHelpText': {\n      if (!modification.text?.trim()) {\n        push('overlay.mod.addHelpText.text', 'text is required', ['text']);\n      }\n      break;\n    }\n    case 'makeRequired':\n    case 'hideField':\n      // no extra validation\n      break;\n    default: {\n      const exhaustive: never = modification;\n      throw new Error(\n        `Unsupported overlay modification ${(exhaustive as { type: string })?.type ?? 'unknown'}`\n      );\n    }\n  }\n}\n\nfunction isFieldModification(\n  mod: OverlayModification\n): mod is Extract<OverlayModification, { field: string }> {\n  return 'field' in mod;\n}\n\nexport function assertOverlayValid(\n  spec: OverlaySpec,\n  validator: OverlayValidator = defaultOverlayValidator\n) {\n  const result = validator(spec);\n  if (!result.valid) {\n    const message = result.issues\n      .map((issue) => `${issue.code}: ${issue.message}`)\n      .join('; ');\n    throw new Error(`Invalid OverlaySpec \"${spec.overlayId}\": ${message}`);\n  }\n}\n"],"mappings":";AAeA,MAAM,cAAc;CAClB;CACA;CACA;CACA;CACA;CACD;AAED,MAAa,2BAA6C,SACxD,oBAAoB,KAAK;AAE3B,SAAgB,oBACd,MACyB;CACzB,MAAM,SAAmC,EAAE;AAE3C,KAAI,CAAC,KAAK,WAAW,MAAM,CACzB,QAAO,KAAK;EACV,MAAM;EACN,SAAS;EACT,MAAM,CAAC,YAAY;EACpB,CAAC;AAGJ,KAAI,CAAC,KAAK,SAAS,MAAM,CACvB,QAAO,KAAK;EACV,MAAM;EACN,SAAS;EACT,MAAM,CAAC,UAAU;EAClB,CAAC;AAQJ,KAAI,CALc,YAAY,MAAM,QAAQ;EAC1C,MAAM,QAAQ,KAAK,YAAY;AAC/B,SAAO,OAAO,UAAU,YAAY,MAAM,MAAM,CAAC,SAAS;GAC1D,CAGA,QAAO,KAAK;EACV,MAAM;EACN,SACE;EACF,MAAM,CAAC,YAAY;EACpB,CAAC;AAGJ,KAAI,CAAC,KAAK,eAAe,OACvB,QAAO,KAAK;EACV,MAAM;EACN,SAAS;EACT,MAAM,CAAC,gBAAgB;EACxB,CAAC;KAEF,MAAK,cAAc,SAAS,KAAK,QAAQ;AAEvC,uBAAqB,KADR,CAAC,iBAAiB,OAAO,IAAI,CAAC,EACX,OAAO;GACvC;AAGJ,QAAO;EACL,OAAO,OAAO,WAAW;EACzB;EACD;;AAGH,SAAS,qBACP,cACA,MACA,QACA;CACA,MAAM,QAAQ,MAAc,SAAiB,cAAyB;AACpE,SAAO,KAAK;GACV;GACA;GACA,MAAM,YAAY,CAAC,GAAG,MAAM,GAAG,UAAU,GAAG;GAC7C,CAAC;;AAGJ,KAAI,oBAAoB,aAAa,EACnC;MAAI,CAAC,aAAa,OAAO,MAAM,CAC7B,MAAK,qBAAqB,2CAA2C,CACnE,QACD,CAAC;;AAIN,SAAQ,aAAa,MAArB;EACE,KAAK;AACH,OAAI,CAAC,aAAa,UAAU,MAAM,CAChC,MAAK,oCAAoC,wBAAwB,CAC/D,WACD,CAAC;AAEJ;EAEF,KAAK,iBAAiB;AACpB,OAAI,CAAC,aAAa,QAAQ,OACxB,MACE,oCACA,+BACA,CAAC,SAAS,CACX;GAEH,MAAM,uBAAO,IAAI,KAAa;AAC9B,QAAK,MAAM,SAAS,aAAa,UAAU,EAAE,EAAE;AAC7C,QAAI,CAAC,OAAO,MAAM,EAAE;AAClB,UACE,0CACA,mCACD;AACD;;AAEF,QAAI,KAAK,IAAI,MAAM,EAAE;AACnB,UACE,8CACA,UAAU,MAAM,6BACjB;AACD;;AAEF,SAAK,IAAI,MAAM;;AAEjB;;EAEF,KAAK;AACH,OAAI,aAAa,UAAU,OACzB,MAAK,gCAAgC,qBAAqB,CAAC,QAAQ,CAAC;AAEtE;EAEF,KAAK;AACH,OAAI,CAAC,aAAa,MAAM,MAAM,CAC5B,MAAK,gCAAgC,oBAAoB,CAAC,OAAO,CAAC;AAEpE;EAEF,KAAK;EACL,KAAK,YAEH;EACF,SAAS;GACP,MAAM,aAAoB;AAC1B,SAAM,IAAI,MACR,oCAAqC,YAAiC,QAAQ,YAC/E;;;;AAKP,SAAS,oBACP,KACwD;AACxD,QAAO,WAAW;;AAGpB,SAAgB,mBACd,MACA,YAA8B,yBAC9B;CACA,MAAM,SAAS,UAAU,KAAK;AAC9B,KAAI,CAAC,OAAO,OAAO;EACjB,MAAM,UAAU,OAAO,OACpB,KAAK,UAAU,GAAG,MAAM,KAAK,IAAI,MAAM,UAAU,CACjD,KAAK,KAAK;AACb,QAAM,IAAI,MAAM,wBAAwB,KAAK,UAAU,KAAK,UAAU"}