@contractspec/lib.surface-runtime 0.2.0

package/dist/react/SlotRenderer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Renders content for a slot. Maps plan.nodes to slot by sourceBinding/slot assignment.
+ * Phase 2: Renders nodes that belong to this slot; placeholder when empty.
+ */
+import type { SurfaceNode } from '../spec/types';
+import type { RenderContext } from '../adapters/interfaces';
+export interface SlotRendererProps {
+    slotId: string;
+    ctx: RenderContext;
+    /** Nodes assigned to this slot. From plan or slot-to-nodes mapping. */
+    nodes: SurfaceNode[];
+}
+export declare function SlotRenderer({ slotId, ctx, nodes }: SlotRendererProps): import("react/jsx-runtime").JSX.Element;

package/dist/react/SlotRenderer.js

@@ -0,0 +1,119 @@
+// @bun
+// src/adapters/blocknote-stub.tsx
+import { jsxDEV } from "react/jsx-dev-runtime";
+var blocknoteAdapterStub = {
+  supportsNode(_kind) {
+    return false;
+  },
+  createSchema(_registry) {
+    return {};
+  },
+  renderNode(node, _ctx) {
+    return /* @__PURE__ */ jsxDEV("div", {
+      "data-blocknote-stub": true,
+      "data-node-id": node.nodeId,
+      children: node.title ?? node.kind
+    }, undefined, false, undefined, this);
+  },
+  async serialize(node) {
+    return { nodeId: node.nodeId, kind: node.kind };
+  },
+  async deserialize(input) {
+    const o = input;
+    return {
+      nodeId: o?.nodeId ?? "stub",
+      kind: o?.kind ?? "custom-widget"
+    };
+  }
+};
+
+// src/telemetry/surface-metrics.ts
+import {
+  createCounter,
+  createHistogram
+} from "@contractspec/lib.observability/metrics";
+var METER_NAME = "@contractspec/lib.surface-runtime";
+var resolutionDurationMs = createHistogram("bundle_surface_resolution_duration_ms", "Time to resolve bundle spec to surface plan in milliseconds", METER_NAME);
+var patchAcceptanceCounter = createCounter("bundle_surface_patch_acceptance_total", "Total AI patch proposals accepted by user", METER_NAME);
+var patchRejectionCounter = createCounter("bundle_surface_patch_rejection_total", "Total AI patch proposals rejected by user", METER_NAME);
+var policyDenialCounter = createCounter("bundle_surface_policy_denial_total", "Total policy denials (actions denied by policy)", METER_NAME);
+var surfaceFallbackCounter = createCounter("bundle_surface_fallback_total", "Total surface or layout fallbacks during resolution", METER_NAME);
+var missingRendererCounter = createCounter("bundle_surface_renderer_missing_total", "Total slots with no renderer for requested node kind", METER_NAME);
+
+// src/react/SlotRenderer.tsx
+import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+function SlotRenderer({ slotId, ctx, nodes }) {
+  if (nodes.length === 0) {
+    return /* @__PURE__ */ jsxDEV2("div", {
+      "data-slot-placeholder": true,
+      "data-slot-id": slotId
+    }, undefined, false, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV2("div", {
+    "data-slot": slotId,
+    children: nodes.map((node) => /* @__PURE__ */ jsxDEV2(SlotNodeRenderer, {
+      node,
+      ctx,
+      slotId
+    }, node.nodeId, false, undefined, this))
+  }, undefined, false, undefined, this);
+}
+function SlotNodeRenderer({
+  node,
+  ctx,
+  slotId
+}) {
+  if (blocknoteAdapterStub.supportsNode(node.kind)) {
+    return blocknoteAdapterStub.renderNode(node, ctx);
+  }
+  if (node.kind === "entity-section") {
+    return /* @__PURE__ */ jsxDEV2("section", {
+      "data-node-id": node.nodeId,
+      "data-kind": "entity-section",
+      children: [
+        /* @__PURE__ */ jsxDEV2("header", {
+          "data-entity-section-header": true,
+          children: node.title ?? "Section"
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV2("div", {
+          "data-entity-section-content": true,
+          children: node.children?.map((child) => child ? /* @__PURE__ */ jsxDEV2(SlotNodeRenderer, {
+            node: child,
+            ctx,
+            slotId
+          }, child.nodeId, false, undefined, this) : null)
+        }, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this);
+  }
+  if (node.kind === "entity-field") {
+    const fieldId = node.sourceBinding?.fieldId;
+    return /* @__PURE__ */ jsxDEV2("div", {
+      "data-node-id": node.nodeId,
+      "data-kind": "entity-field",
+      "data-field-id": fieldId,
+      children: [
+        /* @__PURE__ */ jsxDEV2("span", {
+          "data-entity-field-label": true,
+          children: node.title ?? fieldId ?? "Field"
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV2("span", {
+          "data-entity-field-value": true
+        }, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this);
+  }
+  missingRendererCounter.add(1, {
+    nodeKind: node.kind,
+    slotId
+  });
+  return /* @__PURE__ */ jsxDEV2("div", {
+    "data-node-id": node.nodeId,
+    "data-kind": node.kind,
+    "data-renderer-missing": true,
+    children: node.title ?? node.kind
+  }, undefined, false, undefined, this);
+}
+export {
+  SlotRenderer
+};

package/dist/react/WidgetPalette.d.ts

@@ -0,0 +1,12 @@
+import type { WidgetRegistry } from '../runtime/widget-registry';
+import type { BundleNodeKind } from '../spec/types';
+export interface WidgetPaletteProps {
+    registry: WidgetRegistry;
+    allowedNodeKinds?: BundleNodeKind[];
+    onInsert?: (widgetKey: string, slotId: string) => void;
+}
+/**
+ * Lists available widgets from the registry for customization mode.
+ * Filtered by allowedNodeKinds when provided. Each item can be dragged to a slot.
+ */
+export declare function WidgetPalette({ registry, allowedNodeKinds, onInsert, }: WidgetPaletteProps): import("react/jsx-runtime").JSX.Element;

package/dist/react/WidgetPalette.js

@@ -0,0 +1,60 @@
+// @bun
+// src/react/WidgetPalette.tsx
+import { jsxDEV } from "react/jsx-dev-runtime";
+"use client";
+function WidgetPalette({
+  registry,
+  allowedNodeKinds,
+  onInsert
+}) {
+  const widgets = registry.listByTrust("core");
+  const filtered = !allowedNodeKinds || allowedNodeKinds.includes("custom-widget") ? widgets : [];
+  return /* @__PURE__ */ jsxDEV("div", {
+    "data-widget-palette": true,
+    style: {
+      padding: "12px",
+      minWidth: "180px",
+      borderRight: "1px solid var(--border, #e5e7eb)",
+      backgroundColor: "var(--muted, #f9fafb)"
+    },
+    children: [
+      /* @__PURE__ */ jsxDEV("div", {
+        style: {
+          fontSize: "12px",
+          fontWeight: 600,
+          marginBottom: "8px",
+          textTransform: "uppercase",
+          color: "var(--muted-foreground, #6b7280)"
+        },
+        children: "Widgets"
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV("ul", {
+        style: { listStyle: "none", margin: 0, padding: 0 },
+        children: filtered.map((w) => /* @__PURE__ */ jsxDEV("li", {
+          "data-widget-key": w.widgetKey,
+          role: onInsert ? "button" : undefined,
+          tabIndex: onInsert ? 0 : undefined,
+          style: {
+            padding: "8px 12px",
+            marginBottom: "4px",
+            borderRadius: "6px",
+            cursor: onInsert ? "grab" : "default",
+            backgroundColor: "white",
+            border: "1px solid var(--border, #e5e7eb)"
+          },
+          onClick: onInsert ? () => onInsert(w.widgetKey, "primary") : undefined,
+          onKeyDown: onInsert ? (e) => {
+            if (e.key === "Enter" || e.key === " ") {
+              e.preventDefault();
+              onInsert(w.widgetKey, "primary");
+            }
+          } : undefined,
+          children: w.title
+        }, w.widgetKey, false, undefined, this))
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+export {
+  WidgetPalette
+};

package/dist/react/index.d.ts

@@ -0,0 +1,7 @@
+export { BundleProvider, useBundlePlan, useBundlePreferences, useIsEditing, type BundleProviderProps, } from './BundleProvider';
+export { BundleRenderer, type BundleRendererProps } from './BundleRenderer';
+export { PatchProposalCard, type PatchProposalCardProps, } from './PatchProposalCard';
+export { WidgetPalette, type WidgetPaletteProps } from './WidgetPalette';
+export { OverlayConflictResolver, type OverlayConflictResolverProps, } from './OverlayConflictResolver';
+export { RegionRenderer, type RegionRendererProps } from './RegionRenderer';
+export { SlotRenderer, type SlotRendererProps } from './SlotRenderer';