@contractspec/lib.surface-runtime 0.3.0 → 0.3.3

package/dist/browser/runtime/apply-surface-patch.js

@@ -1,208 +1,6 @@
-// src/spec/validate-surface-patch.ts
-var VALID_OPS = [
-  "insert-node",
-  "replace-node",
-  "remove-node",
-  "move-node",
-  "resize-panel",
-  "set-layout",
-  "reveal-field",
-  "hide-field",
-  "promote-action",
-  "set-focus"
-];
-var VALID_NODE_KINDS = [
-  "metric-strip",
-  "data-view",
-  "entity-card",
-  "entity-header",
-  "entity-summary",
-  "entity-section",
-  "entity-field",
-  "entity-activity",
-  "entity-relations",
-  "entity-timeline",
-  "entity-comments",
-  "entity-attachments",
-  "entity-view-switcher",
-  "entity-automation-panel",
-  "rich-doc",
-  "chat-thread",
-  "assistant-panel",
-  "action-bar",
-  "timeline",
-  "board",
-  "table",
-  "calendar",
-  "form",
-  "chart",
-  "relation-graph",
-  "custom-widget"
-];
-function validateSurfaceNode(node, path) {
-  if (!node.nodeId || typeof node.nodeId !== "string") {
-    throw new Error(`${path}: nodeId must be a non-empty string`);
-  }
-  if (!node.kind || !VALID_NODE_KINDS.includes(node.kind)) {
-    throw new Error(`${path}: kind must be one of ${VALID_NODE_KINDS.join(", ")}`);
-  }
-  if (node.children) {
-    for (let i = 0;i < node.children.length; i++) {
-      const child = node.children[i];
-      if (child)
-        validateSurfaceNode(child, `${path}.children[${i}]`);
-    }
-  }
-}
-function validateSurfacePatchOp(op, index) {
-  const path = `ops[${index}]`;
-  if (!op || typeof op !== "object" || !("op" in op)) {
-    throw new Error(`${path}: must be an object with op field`);
-  }
-  const opType = op.op;
-  if (!VALID_OPS.includes(opType)) {
-    throw new Error(`${path}: op must be one of ${VALID_OPS.join(", ")}`);
-  }
-  switch (op.op) {
-    case "insert-node":
-      if (!op.slotId || typeof op.slotId !== "string") {
-        throw new Error(`${path}: insert-node requires slotId string`);
-      }
-      if (!op.node) {
-        throw new Error(`${path}: insert-node requires node`);
-      }
-      validateSurfaceNode(op.node, `${path}.node`);
-      if (op.index !== undefined && typeof op.index !== "number") {
-        throw new Error(`${path}: insert-node index must be number if present`);
-      }
-      break;
-    case "replace-node":
-      if (!op.nodeId || typeof op.nodeId !== "string") {
-        throw new Error(`${path}: replace-node requires nodeId string`);
-      }
-      if (!op.node) {
-        throw new Error(`${path}: replace-node requires node`);
-      }
-      validateSurfaceNode(op.node, `${path}.node`);
-      break;
-    case "remove-node":
-      if (!op.nodeId || typeof op.nodeId !== "string") {
-        throw new Error(`${path}: remove-node requires nodeId string`);
-      }
-      break;
-    case "move-node":
-      if (!op.nodeId || typeof op.nodeId !== "string") {
-        throw new Error(`${path}: move-node requires nodeId string`);
-      }
-      if (!op.toSlotId || typeof op.toSlotId !== "string") {
-        throw new Error(`${path}: move-node requires toSlotId string`);
-      }
-      if (op.index !== undefined && typeof op.index !== "number") {
-        throw new Error(`${path}: move-node index must be number if present`);
-      }
-      break;
-    case "resize-panel":
-      if (!op.persistKey || typeof op.persistKey !== "string") {
-        throw new Error(`${path}: resize-panel requires persistKey string`);
-      }
-      if (!Array.isArray(op.sizes) || op.sizes.some((s) => typeof s !== "number")) {
-        throw new Error(`${path}: resize-panel requires sizes number[]`);
-      }
-      break;
-    case "set-layout":
-      if (!op.layoutId || typeof op.layoutId !== "string") {
-        throw new Error(`${path}: set-layout requires layoutId string`);
-      }
-      break;
-    case "reveal-field":
-    case "hide-field":
-      if (!op.fieldId || typeof op.fieldId !== "string") {
-        throw new Error(`${path}: ${op.op} requires fieldId string`);
-      }
-      break;
-    case "promote-action": {
-      if (!op.actionId || typeof op.actionId !== "string") {
-        throw new Error(`${path}: promote-action requires actionId string`);
-      }
-      const validPlacements = ["header", "inline", "context", "assistant"];
-      if (!op.placement || !validPlacements.includes(op.placement)) {
-        throw new Error(`${path}: promote-action placement must be one of ${validPlacements.join(", ")}`);
-      }
-      break;
-    }
-    case "set-focus":
-      if (!op.targetId || typeof op.targetId !== "string") {
-        throw new Error(`${path}: set-focus requires targetId string`);
-      }
-      break;
-    default:
-      throw new Error(`${path}: unknown op "${opType}"`);
-  }
-}
-function validateSurfacePatch(ops) {
-  if (!Array.isArray(ops)) {
-    throw new Error("Patch ops must be an array");
-  }
-  for (let i = 0;i < ops.length; i++) {
-    const op = ops[i];
-    if (op)
-      validateSurfacePatchOp(op, i);
-  }
-}
-function validateSurfaceNodeAgainstKinds(node, allowedKinds, path) {
-  if (!allowedKinds.includes(node.kind)) {
-    throw new Error(`${path}: kind "${node.kind}" not in allowed list [${allowedKinds.join(", ")}]`);
-  }
-  if (node.children) {
-    for (let i = 0;i < node.children.length; i++) {
-      const child = node.children[i];
-      if (child)
-        validateSurfaceNodeAgainstKinds(child, allowedKinds, `${path}.children[${i}]`);
-    }
-  }
-}
-function validatePatchProposal(ops, constraints) {
-  if (!Array.isArray(ops)) {
-    throw new Error("Patch ops must be an array");
-  }
-  const { allowedOps, allowedSlots, allowedNodeKinds } = constraints;
-  for (let i = 0;i < ops.length; i++) {
-    const op = ops[i];
-    if (!op)
-      continue;
-    const path = `ops[${i}]`;
-    if (!allowedOps.includes(op.op)) {
-      throw new Error(`${path}: op "${op.op}" not in allowed list [${allowedOps.join(", ")}]`);
-    }
-    switch (op.op) {
-      case "insert-node":
-        if (!allowedSlots.includes(op.slotId)) {
-          throw new Error(`${path}: slotId "${op.slotId}" not in allowed slots [${allowedSlots.join(", ")}]`);
-        }
-        if (op.node) {
-          validateSurfaceNodeAgainstKinds(op.node, allowedNodeKinds, `${path}.node`);
-        }
-        break;
-      case "move-node":
-        if (!allowedSlots.includes(op.toSlotId)) {
-          throw new Error(`${path}: toSlotId "${op.toSlotId}" not in allowed slots [${allowedSlots.join(", ")}]`);
-        }
-        break;
-      case "replace-node":
-        if (op.node) {
-          validateSurfaceNodeAgainstKinds(op.node, allowedNodeKinds, `${path}.node`);
-        }
-        break;
-      default:
-        break;
-    }
-  }
-  validateSurfacePatch(ops);
-}
-
-// src/runtime/apply-surface-patch.ts
 import { Logger } from "@contractspec/lib.observability";
-var logger = new Logger("@contractspec/lib.surface-runtime");
+const logger = new Logger("@contractspec/lib.surface-runtime");
+import { validateSurfacePatch } from "../spec/validate-surface-patch";
 function findNode(nodes, nodeId) {
   for (const n of nodes) {
     if (n.nodeId === nodeId)
@@ -261,7 +59,7 @@ function produceInverse(op, plan) {
       return null;
   }
 }
-function applySurfacePatch(plan, ops) {
+export function applySurfacePatch(plan, ops) {
   if (ops.length === 0)
     return { plan, inverseOps: [] };
   validateSurfacePatch(ops);
@@ -317,6 +115,3 @@ function applySurfacePatch(plan, ops) {
   });
   return result;
 }
-export {
-  applySurfacePatch
-};

package/dist/browser/runtime/audit-events.js

@@ -1,8 +1,7 @@
-// src/runtime/audit-events.ts
 function generateEventId() {
   return `evt_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
 }
-function emitPatchProposed(audit, args) {
+export function emitPatchProposed(audit, args) {
   audit.emit({
     eventId: generateEventId(),
     at: new Date().toISOString(),
@@ -18,7 +17,7 @@ function emitPatchProposed(audit, args) {
     }
   });
 }
-function emitPatchApproved(audit, args) {
+export function emitPatchApproved(audit, args) {
   audit.emit({
     eventId: generateEventId(),
     at: new Date().toISOString(),
@@ -35,7 +34,7 @@ function emitPatchApproved(audit, args) {
     }
   });
 }
-function emitPatchRejected(audit, args) {
+export function emitPatchRejected(audit, args) {
   audit.emit({
     eventId: generateEventId(),
     at: new Date().toISOString(),
@@ -52,7 +51,7 @@ function emitPatchRejected(audit, args) {
     }
   });
 }
-function emitOverlaySaved(audit, args) {
+export function emitOverlaySaved(audit, args) {
   audit.emit({
     eventId: generateEventId(),
     at: new Date().toISOString(),
@@ -67,7 +66,7 @@ function emitOverlaySaved(audit, args) {
     }
   });
 }
-function emitOverlayApplied(audit, args) {
+export function emitOverlayApplied(audit, args) {
   audit.emit({
     eventId: generateEventId(),
     at: new Date().toISOString(),
@@ -81,7 +80,7 @@ function emitOverlayApplied(audit, args) {
     }
   });
 }
-function emitOverlayFailed(audit, args) {
+export function emitOverlayFailed(audit, args) {
   audit.emit({
     eventId: generateEventId(),
     at: new Date().toISOString(),
@@ -95,7 +94,7 @@ function emitOverlayFailed(audit, args) {
     }
   });
 }
-function emitPolicyDenied(audit, args) {
+export function emitPolicyDenied(audit, args) {
   audit.emit({
     eventId: generateEventId(),
     at: new Date().toISOString(),
@@ -110,7 +109,7 @@ function emitPolicyDenied(audit, args) {
     }
   });
 }
-function emitPolicyRedacted(audit, args) {
+export function emitPolicyRedacted(audit, args) {
   audit.emit({
     eventId: generateEventId(),
     at: new Date().toISOString(),
@@ -125,13 +124,3 @@ function emitPolicyRedacted(audit, args) {
     }
   });
 }
-export {
-  emitPolicyRedacted,
-  emitPolicyDenied,
-  emitPatchRejected,
-  emitPatchProposed,
-  emitPatchApproved,
-  emitOverlaySaved,
-  emitOverlayFailed,
-  emitOverlayApplied
-};

package/dist/browser/runtime/build-context.js

@@ -1,5 +1,4 @@
-// src/runtime/build-context.ts
-var DEFAULT_PREFERENCES = {
+const DEFAULT_PREFERENCES = {
   guidance: "hints",
   density: "standard",
   dataDepth: "detailed",
@@ -8,7 +7,7 @@ var DEFAULT_PREFERENCES = {
   pace: "balanced",
   narrative: "top-down"
 };
-function buildContext(params) {
+export function buildContext(params) {
   const {
     route,
     params: routeParams = {},
@@ -50,6 +49,3 @@ function buildContext(params) {
     featureFlags
   };
 }
-export {
-  buildContext
-};

package/dist/browser/runtime/extension-registry.js

@@ -1,5 +1,4 @@
-// src/runtime/extension-registry.ts
-function createActionRegistry() {
+export function createActionRegistry() {
   const entries = new Map;
   return {
     register(entry) {
@@ -16,7 +15,7 @@ function createActionRegistry() {
     }
   };
 }
-function createCommandRegistry() {
+export function createCommandRegistry() {
   const entries = new Map;
   return {
     register(entry) {
@@ -33,7 +32,7 @@ function createCommandRegistry() {
     }
   };
 }
-function createBundleExtensionRegistry(options) {
+export function createBundleExtensionRegistry(options) {
   const actionRegistry = options.actionRegistry ?? createActionRegistry();
   const commandRegistry = options.commandRegistry ?? createCommandRegistry();
   return {
@@ -51,8 +50,3 @@ function createBundleExtensionRegistry(options) {
     }
   };
 }
-export {
-  createCommandRegistry,
-  createBundleExtensionRegistry,
-  createActionRegistry
-};

package/dist/browser/runtime/field-renderer-registry.js

@@ -1,6 +1,5 @@
-// src/runtime/field-renderer-registry.ts
-var FALLBACK_FIELD_KIND = "text";
-var CORE_FIELD_KINDS = {
+export const FALLBACK_FIELD_KIND = "text";
+const CORE_FIELD_KINDS = {
   text: {
     fieldKind: "text",
     viewer: "text-viewer",
@@ -47,7 +46,7 @@ var CORE_FIELD_KINDS = {
     validators: ["required"]
   }
 };
-var STUB_FIELD_KINDS = {
+const STUB_FIELD_KINDS = {
   relation: {
     fieldKind: "relation",
     viewer: "relation-viewer-stub",
@@ -95,7 +94,7 @@ var STUB_FIELD_KINDS = {
     validators: ["required", "regex"]
   }
 };
-function createFieldRendererRegistry() {
+export function createFieldRendererRegistry() {
   const all = { ...CORE_FIELD_KINDS, ...STUB_FIELD_KINDS };
   const fallback = CORE_FIELD_KINDS[FALLBACK_FIELD_KIND];
   if (!fallback) {
@@ -113,7 +112,7 @@ function createFieldRendererRegistry() {
     }
   };
 }
-function createMutableFieldRendererRegistry() {
+export function createMutableFieldRendererRegistry() {
   const base = { ...CORE_FIELD_KINDS, ...STUB_FIELD_KINDS };
   const custom = new Map;
   const fallback = CORE_FIELD_KINDS[FALLBACK_FIELD_KIND];
@@ -138,8 +137,3 @@ function createMutableFieldRendererRegistry() {
     }
   };
 }
-export {
-  createMutableFieldRendererRegistry,
-  createFieldRendererRegistry,
-  FALLBACK_FIELD_KIND
-};