@contractspec/lib.surface-runtime 0.2.0

package/dist/runtime/extension-registry.js

@@ -0,0 +1,59 @@
+// @bun
+// src/runtime/extension-registry.ts
+function createActionRegistry() {
+  const entries = new Map;
+  return {
+    register(entry) {
+      entries.set(entry.actionId, entry);
+    },
+    get(actionId) {
+      return entries.get(actionId);
+    },
+    has(actionId) {
+      return entries.has(actionId);
+    },
+    list() {
+      return Array.from(entries.values());
+    }
+  };
+}
+function createCommandRegistry() {
+  const entries = new Map;
+  return {
+    register(entry) {
+      entries.set(entry.commandId, entry);
+    },
+    get(commandId) {
+      return entries.get(commandId);
+    },
+    has(commandId) {
+      return entries.has(commandId);
+    },
+    list() {
+      return Array.from(entries.values());
+    }
+  };
+}
+function createBundleExtensionRegistry(options) {
+  const actionRegistry = options.actionRegistry ?? createActionRegistry();
+  const commandRegistry = options.commandRegistry ?? createCommandRegistry();
+  return {
+    registerWidget(entry) {
+      options.widgetRegistry.register(entry);
+    },
+    registerFieldRenderer(kind, entry) {
+      options.fieldRendererRegistry.registerFieldRenderer(kind, entry);
+    },
+    registerAction(entry) {
+      actionRegistry.register(entry);
+    },
+    registerCommand(entry) {
+      commandRegistry.register(entry);
+    }
+  };
+}
+export {
+  createCommandRegistry,
+  createBundleExtensionRegistry,
+  createActionRegistry
+};

package/dist/runtime/field-renderer-registry.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Field renderer registry for entity surfaces.
+ * Registers core field kinds (text, number, date, select) and stubs for relation, rollup, formula, people.
+ * Aligns with 08_entity_surface_and_custom_fields.md.
+ */
+import type { FieldRendererSpec } from '../spec/types';
+/** Fallback field kind when unknown kind is requested. */
+export declare const FALLBACK_FIELD_KIND = "text";
+/** Registry interface for field renderers. */
+export interface FieldRendererRegistry {
+    get(kind: string): FieldRendererSpec | undefined;
+    has(kind: string): boolean;
+    /** Returns spec or fallback for unknown kinds. */
+    getOrFallback(kind: string): FieldRendererSpec;
+}
+/** Mutable registry that supports registerFieldRenderer. Aligns with 09_extension_and_override_model. */
+export interface MutableFieldRendererRegistry extends FieldRendererRegistry {
+    registerFieldRenderer(kind: string, entry: FieldRendererSpec): void;
+}
+/** Default field renderer registry with core kinds and stubs. */
+export declare function createFieldRendererRegistry(): FieldRendererRegistry;
+/** Creates a mutable field renderer registry. Extends base with registerFieldRenderer. */
+export declare function createMutableFieldRendererRegistry(): MutableFieldRendererRegistry;

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

@@ -0,0 +1,146 @@
+// @bun
+// src/runtime/field-renderer-registry.ts
+var FALLBACK_FIELD_KIND = "text";
+var CORE_FIELD_KINDS = {
+  text: {
+    fieldKind: "text",
+    viewer: "text-viewer",
+    editor: "text-editor",
+    summaryViewer: "text-summary",
+    tableCell: "text-cell",
+    filters: ["contains", "equals", "startsWith", "endsWith"],
+    validators: ["required", "maxLength", "regex"]
+  },
+  number: {
+    fieldKind: "number",
+    viewer: "number-viewer",
+    editor: "number-editor",
+    summaryViewer: "number-summary",
+    tableCell: "number-cell",
+    filters: ["equals", "gt", "gte", "lt", "lte", "between"],
+    validators: ["required", "min", "max", "integer"]
+  },
+  date: {
+    fieldKind: "date",
+    viewer: "date-viewer",
+    editor: "date-editor",
+    summaryViewer: "date-summary",
+    tableCell: "date-cell",
+    filters: ["equals", "before", "after", "between"],
+    validators: ["required", "min", "max"]
+  },
+  select: {
+    fieldKind: "select",
+    viewer: "select-viewer",
+    editor: "select-editor",
+    summaryViewer: "select-summary",
+    tableCell: "select-cell",
+    filters: ["equals", "in"],
+    validators: ["required", "oneOf"]
+  },
+  checkbox: {
+    fieldKind: "checkbox",
+    viewer: "checkbox-viewer",
+    editor: "checkbox-editor",
+    summaryViewer: "checkbox-summary",
+    tableCell: "checkbox-cell",
+    filters: ["equals"],
+    validators: ["required"]
+  }
+};
+var STUB_FIELD_KINDS = {
+  relation: {
+    fieldKind: "relation",
+    viewer: "relation-viewer-stub",
+    summaryViewer: "relation-chip-stub",
+    tableCell: "relation-chip-stub"
+  },
+  rollup: {
+    fieldKind: "rollup",
+    viewer: "rollup-viewer-stub",
+    summaryViewer: "rollup-chip-stub",
+    tableCell: "rollup-cell-stub"
+  },
+  formula: {
+    fieldKind: "formula",
+    viewer: "formula-viewer-stub",
+    summaryViewer: "formula-summary-stub",
+    tableCell: "formula-cell-stub"
+  },
+  people: {
+    fieldKind: "people",
+    viewer: "people-viewer-stub",
+    editor: "people-picker-stub",
+    summaryViewer: "people-chip-stub",
+    tableCell: "people-cell-stub"
+  },
+  options: {
+    fieldKind: "options",
+    viewer: "options-viewer-stub",
+    editor: "options-editor-stub",
+    summaryViewer: "options-chip-stub",
+    tableCell: "options-cell-stub"
+  },
+  instance: {
+    fieldKind: "instance",
+    viewer: "instance-viewer-stub",
+    summaryViewer: "instance-chip-stub",
+    tableCell: "instance-cell-stub"
+  },
+  url: {
+    fieldKind: "url",
+    viewer: "url-viewer",
+    editor: "url-editor",
+    summaryViewer: "url-summary",
+    tableCell: "url-cell",
+    validators: ["required", "regex"]
+  }
+};
+function createFieldRendererRegistry() {
+  const all = { ...CORE_FIELD_KINDS, ...STUB_FIELD_KINDS };
+  const fallback = CORE_FIELD_KINDS[FALLBACK_FIELD_KIND];
+  if (!fallback) {
+    throw new Error(`Fallback field kind "${FALLBACK_FIELD_KIND}" not found`);
+  }
+  return {
+    get(kind) {
+      return all[kind];
+    },
+    has(kind) {
+      return kind in all;
+    },
+    getOrFallback(kind) {
+      return all[kind] ?? fallback;
+    }
+  };
+}
+function createMutableFieldRendererRegistry() {
+  const base = { ...CORE_FIELD_KINDS, ...STUB_FIELD_KINDS };
+  const custom = new Map;
+  const fallback = CORE_FIELD_KINDS[FALLBACK_FIELD_KIND];
+  if (!fallback) {
+    throw new Error(`Fallback field kind "${FALLBACK_FIELD_KIND}" not found`);
+  }
+  return {
+    get(kind) {
+      return custom.get(kind) ?? base[kind];
+    },
+    has(kind) {
+      return custom.has(kind) || kind in base;
+    },
+    getOrFallback(kind) {
+      return custom.get(kind) ?? base[kind] ?? fallback;
+    },
+    registerFieldRenderer(kind, entry) {
+      if (entry.fieldKind !== kind) {
+        throw new Error(`Field renderer entry fieldKind "${entry.fieldKind}" must match kind "${kind}"`);
+      }
+      custom.set(kind, entry);
+    }
+  };
+}
+export {
+  createMutableFieldRendererRegistry,
+  createFieldRendererRegistry,
+  FALLBACK_FIELD_KIND
+};

package/dist/runtime/field-renderer-registry.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/runtime/index.d.ts

@@ -0,0 +1,16 @@
+export { buildContext } from './build-context';
+export { resolvePreferenceProfile } from './resolve-preferences';
+export { defaultPreferenceAdapter } from './preference-adapter';
+export { resolveBundle, type PolicyHooks, type ResolveBundleOptions, type OverlayMergeOptions, type OverlayConflict, type ResolvedSurfacePlan, } from './resolve-bundle';
+export { applySurfacePatch, type ApplySurfacePatchResult, } from './apply-surface-patch';
+export { compilePlannerPrompt, type PlannerPromptInput, } from './planner-prompt';
+export { proposePatchToolConfig, PROPOSE_PATCH_TOOL_SCHEMA, buildSurfacePatchProposal, type PlannerToolConfig, } from './planner-tools';
+export { createFieldRendererRegistry, createMutableFieldRendererRegistry, FALLBACK_FIELD_KIND, type FieldRendererRegistry, type MutableFieldRendererRegistry, } from './field-renderer-registry';
+export { createWidgetRegistry, type WidgetRegistry, type WidgetRegistryEntry, type WidgetTrust, } from './widget-registry';
+export { createActionRegistry, createCommandRegistry, createBundleExtensionRegistry, type ActionRegistry, type CommandRegistry, type BundleExtensionRegistry, } from './extension-registry';
+export { createInMemoryOverrideStore, createOverrideStoreWithApprovalGate, buildOverrideTargetKey, type BundleOverrideStore, type StoredOverride, type ApprovalGateOptions, } from './override-store';
+export { toOverlayScopeContext, toOverlayTargetRef, toOverlayRenderableField, fromOverlayRenderableField, toOverlayRenderable, mergeOverlayResultIntoFields, applyEntityFieldOverlays, type SurfaceOverlayTargetRef, } from './overlay-alignment';
+export { signWorkspaceOverlay, verifyWorkspaceOverlay, type OverlaySigningKey, } from './overlay-signer';
+export { emitPatchProposed, emitPatchApproved, emitPatchRejected, emitOverlaySaved, emitOverlayApplied, emitOverlayFailed, emitPolicyDenied, emitPolicyRedacted, } from './audit-events';
+export { rollbackSurfacePatches, type RollbackResult } from './rollback';
+export { evaluatePatchProposalPolicy, evaluateAndEmitPatchPolicy, } from './policy-eval';