@contractspec/lib.surface-runtime 0.5.5 → 0.5.7

package/README.md

@@ -1,164 +1,78 @@
 # @contractspec/lib.surface-runtime
 
-AI-native surface specs and web runtime for adaptive ContractSpec surfaces.
+Website: https://contractspec.io
 
-## Overview
+**Surface runtime for AI-native ContractSpec experiences, including bundle specs, planners, overlays, patching, and React rendering support.**
 
-This library provides:
+## What It Provides
 
-- **ModuleBundleSpec** — TypeScript types for defining surface contracts (routes, slots, layouts, data recipes)
-- **defineModuleBundle** — Runtime validator for bundle specs
-- **resolveBundle** — Resolves a bundle spec + context into a ResolvedSurfacePlan
-- **resolvePreferenceProfile** — Resolves preferences by scope order (user → … → session)
-- **defaultPreferenceAdapter** — Stub `BundlePreferenceAdapter` (resolve + savePreferencePatch)
-- **applySurfacePatch** — Applies patch operations to a plan
-- **BundleProvider** / **BundleRenderer** — React components for rendering resolved plans
-- **RegionRenderer** / **SlotRenderer** — Layout tree and slot content rendering
-- **Adapters** — BlockNote, dnd-kit, Floating UI, Motion, resizable-panels, AI SDK (stubs)
+- Provides the runtime layer behind AI-planned surfaces, widget registries, overrides, and bundle resolution.
+- Supports React rendering, adapter boundaries, telemetry, evaluation harnesses, and planner tooling.
+- Recently expanded to better align with AI chat, i18n, workflow tools, and bundle export needs.
+- `src/adapters/` contains runtime, provider, or environment-specific adapters.
 
-## Terminology (Glossary)
+## Installation
 
-- **Bundle spec** / **Surface spec** (ModuleBundleSpec): A contract type defining a surface (routes, slots, layouts). Not an architectural layer. Use "surface spec" in prose to avoid confusion.
-- **Bundle** (architectural): A domain package in `packages/bundles/` (e.g. bundle.workspace). Contains business logic.
+`npm install @contractspec/lib.surface-runtime`
 
-### Preference vs layout vs view vs overlay
+or
 
-| Concept | Meaning | Storage |
-|---------|---------|---------|
-| **Preference** | Stable user intent (e.g. `density=dense`, `guidance=hints`). Orthogonal 7-dimension model. | User/workspace/surface scope via `BundlePreferenceAdapter`. |
-| **Layout snapshot** | Concrete arrangement (panel sizes, tab order, collapsed state). | Distinct from preferences; use `persistKey` + overlay-engine for durable layout. |
-| **View** | Data-shaping projection (filters, sort, visible columns). | Often session-scoped or view-state. |
-| **Overlay** | Durable mutation to the rendered contract (patches, field visibility). | `lib.overlay-engine` (OverlaySpec, merger). |
-
-Do not merge these into one blob. Preferences drive adaptation; layout snapshots persist geometry; overlays persist structural patches.
-
-### Preference scope resolution order
-
-Preferences are merged in this order (later overrides earlier):
-
-1. **user** — Global user defaults  
-2. **workspace-user** — Workspace-specific user defaults  
-3. **bundle** — Bundle-level defaults  
-4. **surface** — Surface-specific overrides  
-5. **entity** — Entity-context overrides  
-6. **session** — Session overrides (highest priority)
-
-### Dimension → runtime behavior (summary)
-
-| Dimension | Runtime effect |
-|-----------|----------------|
-| **guidance** | Hints, onboarding, progressive disclosure, assistant prompting style |
-| **density** | Spacing, panel expansion, table vs card layout, side rails |
-| **dataDepth** | Query shape, pagination size, inline expansion, raw payload access |
-| **control** | Visible toggles, advanced inspectors, batch ops, policy editor |
-| **media** | Text vs visual vs voice surfaces, charts vs prose, TTS |
-| **pace** | Animation duration, confirmation depth, skeleton persistence; respects `prefers-reduced-motion` |
-| **narrative** | Order of summary vs evidence, top-down vs bottom-up presentation |
-
-Every surface must declare `verification.dimensions` describing how it responds to each dimension. See [docs/verification-matrix.md](./docs/verification-matrix.md) for the verification matrix, review questions, and snapshot coverage.
-
-## Package Strategy
-
-### Hard dependencies
-
-- `@contractspec/lib.contracts-spec` — operations, capabilities, policies, presentations
-- `@contractspec/lib.overlay-engine` — typed, auditable overrides
-- `@contractspec/lib.observability` — tracing, metrics, lifecycle instrumentation
-- `zod` — schema validation
-
-### Interoperability (consumes or composes with)
-
-- `@contractspec/lib.contracts-runtime-client-react` — feature/form rendering
-- `@contractspec/lib.presentation-runtime-react` — workflow, list state
-- `@contractspec/lib.ai-agent` — agent orchestration (when assistant integration is added)
-- `@contractspec/lib.ai-providers` — planner model selection
-- `@contractspec/lib.metering` — when AI/chat features are used
-- `@contractspec/lib.personalization` — preference dimensions (or surface-runtime-owned until adopted)
-
-### Peer dependencies
-
-- `react`, `react-dom` — optional; required only for React renderer
-- UI libs (BlockNote, dnd-kit, Floating UI, Motion, resizable-panels) — optional; added as peers when adapters are implemented
+`bun add @contractspec/lib.surface-runtime`
 
 ## Usage
 
-```ts
-import { defineModuleBundle } from "@contractspec/lib.surface-runtime/spec";
-import { resolveBundle } from "@contractspec/lib.surface-runtime/runtime";
-
-const PmWorkbenchBundle = defineModuleBundle({
-  meta: { key: "pm.workbench", version: "0.1.0", title: "PM Workbench" },
-  routes: [{ routeId: "pm-issue", path: "/operate/pm/issues/:issueId", defaultSurface: "issue-workbench" }],
-  surfaces: {
-    "issue-workbench": {
-      surfaceId: "issue-workbench",
-      kind: "workbench",
-      title: "Issue Workbench",
-      slots: [...],
-      layouts: [...],
-      data: [],
-      verification: { dimensions: { guidance: "...", density: "...", ... } },
-    },
-  },
-});
-
-const plan = await resolveBundle(PmWorkbenchBundle, ctx);
-```
-
-## Dependencies
-
-See [Package Strategy](#package-strategy) above. Core: contracts-spec, overlay-engine, observability, zod.
-
-## AI Chat Integration (07_ai_native_chat_and_generative_ui)
-
-The assistant slot can render chat UI from `@contractspec/module.ai-chat`. Wire as follows:
-
-1. **Assistant slot**: Declare a slot with `role: 'assistant'` in the surface spec. Set `SurfaceAiSpec.assistantSlotId` to that slot's `slotId`.
-
-2. **BundleRenderer + assistant slot**: When `SlotRenderer` receives `slotId === assistantSlotId`, the bundle should render `ChatContainer` from `@contractspec/module.ai-chat` instead of default slot content. Pass `useChat` from the same module for thread state.
-
-3. **Provider config**: Use `createProvider` from `@contractspec/lib.ai-providers` to build the model config. Pass it to the planner (ContractSpecAgent) and to the chat UI (useChat options).
-
-4. **Planner integration**: Use `compilePlannerPrompt` and `proposePatchToolConfig` from this package. Wire the propose-patch tool handler to `validatePatchProposal` before returning. Map planner output to `PlannerResponse` (summary, intent, patchProposals, blockDrafts).
-
-5. **Patch approval flow**: On accept, emit `patch.approved` audit event, call `applySurfacePatch`, then promote to session overlay. On reject, emit `patch.rejected`. Use `PatchApprovalHandler` for the callback signature.
-
-## Policy, Audit, and Rollback (10_policy_audit_and_safety)
-
-### Policy hooks
-
-Pass `policy` and `audit` to `resolveBundle` options:
-
-- **evaluateNode**: Return `UiPolicyDecision` (allow/deny/redact) per node. Stub: allow all.
-- **redactBinding**: Redact binding values. Stub: pass-through.
-- **evaluatePatchProposal**: Return allow/deny/require-approval for patch ops. Stub: allow.
-
-Use `evaluateAndEmitPatchPolicy` before applying patches to gate on policy and emit `policy.denied` when blocked.
-
-### Audit events
-
-Implement `BundleAuditEmitter` and pass to `resolveBundle` and patch approval flow. Events: `surface.resolved`, `patch.proposed`, `patch.approved`, `patch.rejected`, `overlay.saved`, `overlay.applied`, `overlay.failed`, `policy.denied`, `policy.redacted`. Use `emitPatchProposed`, `emitPatchApproved`, etc. from `./runtime`.
-
-### Rollback
-
-`applySurfacePatch` returns `inverseOps` for reversible ops (insert/remove, replace, set-layout, reveal/hide-field). Store `OverlayApprovalMeta` (forwardOps, inverseOps, actorId, approvedAt) with each approved overlay. Use `rollbackSurfacePatches(plan, approvalStack, count)` to revert last N patches.
-
-**Rollback limits**: move-node, resize-panel, set-focus, promote-action require previous state for full inverse; currently return null inverse. Document when storing approval metadata.
-
-## Rollout Status
-
-See [ROLLOUT.md](./ROLLOUT.md) for the phased rollout plan, performance budgets, risks, and pilot route (`/operate/pm/issues/:issueId`).
-
-**Current:** Phase 0–2 complete (scaffold, resolver, renderer). Phase 3–7 pending.
-
-## Adapter Rule (Lint)
-
-**Rule**: No direct third-party UI imports outside `src/adapters/`. BlockNote, dnd-kit, Floating UI, Motion, resizable-panels, AI SDK UI—all must be behind adapter boundaries.
-
-**Enforcement**: Run `bun run lint:adapters` to detect violations. Integrate into CI if desired.
-
-## Phase 2 Status
-
-Types, defineModuleBundle, resolveBundle, applySurfacePatch, BundleProvider, BundleRenderer, RegionRenderer, SlotRenderer, and adapter stubs are implemented. ResolvedSurfacePlan includes layoutRoot for rendering. Motion tokens map pace to duration/entrance. Panel persistence (persistKey) via localStorage. Full BlockNote/dnd-kit/Floating UI integrations deferred to later phases. Planner prompt compiler, propose-patch tool schema, and patch proposal validator added for AI chat integration.
-
-**Observability (09):** Tracing (`traceAsync`), metrics (`resolution_duration_ms`, patch acceptance/rejection, policy denial, surface fallback, missing renderer), structured logging. Golden-context harness for resolver evals with snapshot tests. Performance budget: resolver p95 <100ms (server). See [docs/evals-runbook.md](./docs/evals-runbook.md) and `./telemetry`.
+Import the root entrypoint from `@contractspec/lib.surface-runtime`, or choose a documented subpath when you only need one part of the package surface.
+
+## Architecture
+
+- `src/spec/` defines module-bundle and surface-patch validation surfaces.
+- `src/runtime/` contains planners, registries, patch application, policy evaluation, and bundle resolution.
+- `src/react/` exports the React integration layer for bundle rendering and override handling.
+- `src/adapters/`, `src.telemetry/`, `src.evals/`, and `src.examples/` support integration and verification flows.
+- `src/index.ts` is the root public barrel and package entrypoint.
+
+## Public Entry Points
+
+- Exports runtime, spec, React integration, adapters, telemetry, eval, and example subpaths for AI-native surface composition.
+- Export `.` resolves through `./src/index.ts`.
+- Export `./adapters` resolves through `./src/adapters/index.ts`.
+- Export `./adapters/ai-sdk-stub` resolves through `./src/adapters/ai-sdk-stub.ts`.
+- Export `./adapters/blocknote-stub` resolves through `./src/adapters/blocknote-stub.tsx`.
+- Export `./adapters/dnd-kit-adapter` resolves through `./src/adapters/dnd-kit-adapter.tsx`.
+- Export `./adapters/dnd-kit-stub` resolves through `./src/adapters/dnd-kit-stub.ts`.
+- Export `./adapters/floating-ui-stub` resolves through `./src/adapters/floating-ui-stub.tsx`.
+- Export `./adapters/interfaces` resolves through `./src/adapters/interfaces.ts`.
+- Export `./adapters/motion-stub` resolves through `./src/adapters/motion-stub.ts`.
+- Export `./adapters/resizable-panels-stub` resolves through `./src/adapters/resizable-panels-stub.tsx`.
+- The package publishes 53 total export subpaths; keep docs aligned with `package.json`.
+
+## Local Commands
+
+- `bun run dev` — contractspec-bun-build dev
+- `bun run build` — bun run prebuild && bun run build:bundle && bun run build:types
+- `bun run test` — bun test --pass-with-no-tests
+- `bun run lint` — bun lint:fix
+- `bun run lint:check` — biome check .
+- `bun run lint:fix` — biome check --write --unsafe --only=nursery/useSortedClasses . && biome check --write .
+- `bun run typecheck` — tsc --noEmit
+- `bun run publish:pkg` — bun publish --tolerate-republish --ignore-scripts --verbose
+- `bun run publish:pkg:canary` — bun publish:pkg --tag canary
+- `bun run clean` — rimraf dist .turbo
+- `bun run build:bundle` — contractspec-bun-build transpile && node scripts/fix-use-client-directive.mjs
+- `bun run build:types` — contractspec-bun-build types
+- `bun run lint:adapters` — node scripts/lint-adapters.mjs
+- `bun run test:evals` — bun test src/evals/
+- `bun run prebuild` — contractspec-bun-build prebuild
+
+## Recent Updates
+
+- Replace eslint+prettier by biomejs to optimize speed.
+- Export, sidebar, workflow tools, slotContent.
+- Vercel AI SDK parity + surface-runtime i18n and bundle alignment.
+- Bundle spec alignment, i18n support, PM workbench pilot.
+
+## Notes
+
+- No direct third-party UI imports outside `src/adapters/` (when adapters are added).
+- Every surface must have verification.dimensions for all 7 preference dimensions.
+- Adapter rule: BlockNote, dnd-kit, etc. behind adapter boundaries only.

package/dist/adapters/dnd-kit-adapter.d.ts

@@ -1,7 +1,3 @@
-/**
- * dnd-kit adapter for customization mode. Wraps content in DndContext.
- * Requires @dnd-kit/core (optional peer). Falls back to stub when not installed.
- */
 import React from 'react';
 import type { SurfacePatchOp } from '../spec/types';
 import type { DragDropBundleAdapter } from './interfaces';

package/dist/adapters/index.d.ts

@@ -1,11 +1,11 @@
 /**
  * UI library adapters. No direct third-party imports outside this directory.
  */
-export type { AiSdkBundleAdapter, BlockNoteBundleAdapter, DragDropBundleAdapter, FieldRendererRegistry, FloatingBundleAdapter, MotionBundleAdapter, MotionTokens, PanelLayoutAdapter, RenderContext, RenderRegionFn, } from './interfaces';
 export { aiSdkAdapterStub } from './ai-sdk-stub';
 export { blocknoteAdapterStub } from './blocknote-stub';
-export { dndKitAdapterStub } from './dnd-kit-stub';
 export { dndKitAdapter } from './dnd-kit-adapter';
+export { dndKitAdapterStub } from './dnd-kit-stub';
 export { floatingUiAdapterStub } from './floating-ui-stub';
+export type { AiSdkBundleAdapter, BlockNoteBundleAdapter, DragDropBundleAdapter, FieldRendererRegistry, FloatingBundleAdapter, MotionBundleAdapter, MotionTokens, PanelLayoutAdapter, RenderContext, RenderRegionFn, } from './interfaces';
 export { motionAdapterStub } from './motion-stub';
 export { resizablePanelsAdapterStub } from './resizable-panels-stub';

package/dist/adapters/index.js

@@ -1,7 +1,7 @@
 export { aiSdkAdapterStub } from "./ai-sdk-stub";
 export { blocknoteAdapterStub } from "./blocknote-stub";
-export { dndKitAdapterStub } from "./dnd-kit-stub";
 export { dndKitAdapter } from "./dnd-kit-adapter";
+export { dndKitAdapterStub } from "./dnd-kit-stub";
 export { floatingUiAdapterStub } from "./floating-ui-stub";
 export { motionAdapterStub } from "./motion-stub";
 export { resizablePanelsAdapterStub } from "./resizable-panels-stub";

package/dist/browser/adapters/index.js

@@ -1,7 +1,7 @@
 export { aiSdkAdapterStub } from "./ai-sdk-stub";
 export { blocknoteAdapterStub } from "./blocknote-stub";
-export { dndKitAdapterStub } from "./dnd-kit-stub";
 export { dndKitAdapter } from "./dnd-kit-adapter";
+export { dndKitAdapterStub } from "./dnd-kit-stub";
 export { floatingUiAdapterStub } from "./floating-ui-stub";
 export { motionAdapterStub } from "./motion-stub";
 export { resizablePanelsAdapterStub } from "./resizable-panels-stub";

package/dist/browser/evals/golden-harness.js

@@ -1,5 +1,5 @@
-import { resolveBundle } from "../runtime/resolve-bundle";
 import { buildContext } from "../runtime/build-context";
+import { resolveBundle } from "../runtime/resolve-bundle";
 export function toSnapshotPlan(plan) {
   return {
     bundleKey: plan.bundleKey,

package/dist/browser/i18n/catalogs/index.js

@@ -1,3 +1,3 @@
 export { enMessages } from "./en";
-export { frMessages } from "./fr";
 export { esMessages } from "./es";
+export { frMessages } from "./fr";

package/dist/browser/i18n/index.js

@@ -1,8 +1,8 @@
-export { createSurfaceI18n, getDefaultSurfaceI18n } from "./messages";
-export { SURFACE_KEYS } from "./keys";
 export {
-  resolveLocale,
-  isSupportedLocale,
   DEFAULT_LOCALE,
+  isSupportedLocale,
+  resolveLocale,
   SUPPORTED_LOCALES
 } from "@contractspec/lib.contracts-spec/translations";
+export { SURFACE_KEYS } from "./keys";
+export { createSurfaceI18n, getDefaultSurfaceI18n } from "./messages";

package/dist/browser/i18n/messages.js

@@ -2,8 +2,8 @@ import {
   createI18nFactory
 } from "@contractspec/lib.contracts-spec/translations";
 import { enMessages } from "./catalogs/en";
-import { frMessages } from "./catalogs/fr";
 import { esMessages } from "./catalogs/es";
+import { frMessages } from "./catalogs/fr";
 const factory = createI18nFactory({
   specKey: "surface-runtime.messages",
   catalogs: [enMessages, frMessages, esMessages]

package/dist/browser/index.js

@@ -1,4 +1,4 @@
-export * from "./spec";
-export * from "./runtime";
-export * from "./react";
 export * from "./adapters";
+export * from "./react";
+export * from "./runtime";
+export * from "./spec";

package/dist/browser/react/BundleRenderer.js

@@ -1,11 +1,11 @@
 "use client";
 import { jsxDEV as jsxDEV_7x81h0kn, Fragment as Fragment_8vg9x3sq } from "react/jsx-dev-runtime";
+import { motionAdapterStub } from "../adapters/motion-stub";
 import { useBundlePlan } from "./BundleProvider";
+import { OverlayConflictResolver } from "./OverlayConflictResolver";
+import { PatchProposalCard } from "./PatchProposalCard";
 import { RegionRenderer } from "./RegionRenderer";
 import { SlotRenderer } from "./SlotRenderer";
-import { PatchProposalCard } from "./PatchProposalCard";
-import { OverlayConflictResolver } from "./OverlayConflictResolver";
-import { motionAdapterStub } from "../adapters/motion-stub";
 export function BundleRenderer({
   assistantSlotId,
   assistantSlotContent,

package/dist/browser/react/index.js

@@ -5,12 +5,12 @@ export {
   useIsEditing
 } from "./BundleProvider";
 export { BundleRenderer } from "./BundleRenderer";
-export {
-  PatchProposalCard
-} from "./PatchProposalCard";
-export { WidgetPalette } from "./WidgetPalette";
 export {
   OverlayConflictResolver
 } from "./OverlayConflictResolver";
+export {
+  PatchProposalCard
+} from "./PatchProposalCard";
 export { RegionRenderer } from "./RegionRenderer";
 export { SlotRenderer } from "./SlotRenderer";
+export { WidgetPalette } from "./WidgetPalette";

package/dist/browser/runtime/index.js

@@ -1,63 +1,63 @@
-export { buildContext } from "./build-context";
-export { resolvePreferenceProfile } from "./resolve-preferences";
-export { defaultPreferenceAdapter } from "./preference-adapter";
-export {
-  resolveBundle
-} from "./resolve-bundle";
 export {
   applySurfacePatch
 } from "./apply-surface-patch";
 export {
-  compilePlannerPrompt
-} from "./planner-prompt";
+  emitOverlayApplied,
+  emitOverlayFailed,
+  emitOverlaySaved,
+  emitPatchApproved,
+  emitPatchProposed,
+  emitPatchRejected,
+  emitPolicyDenied,
+  emitPolicyRedacted
+} from "./audit-events";
+export { buildContext } from "./build-context";
 export {
-  proposePatchToolConfig,
-  PROPOSE_PATCH_TOOL_SCHEMA,
-  buildSurfacePatchProposal
-} from "./planner-tools";
+  createActionRegistry,
+  createBundleExtensionRegistry,
+  createCommandRegistry
+} from "./extension-registry";
 export {
   createFieldRendererRegistry,
   createMutableFieldRendererRegistry,
   FALLBACK_FIELD_KIND
 } from "./field-renderer-registry";
 export {
-  createWidgetRegistry
-} from "./widget-registry";
-export {
-  createActionRegistry,
-  createCommandRegistry,
-  createBundleExtensionRegistry
-} from "./extension-registry";
-export {
-  createInMemoryOverrideStore,
-  createOverrideStoreWithApprovalGate,
-  buildOverrideTargetKey
-} from "./override-store";
-export {
-  toOverlayScopeContext,
-  toOverlayTargetRef,
-  toOverlayRenderableField,
+  applyEntityFieldOverlays,
   fromOverlayRenderableField,
-  toOverlayRenderable,
   mergeOverlayResultIntoFields,
-  applyEntityFieldOverlays
+  toOverlayRenderable,
+  toOverlayRenderableField,
+  toOverlayScopeContext,
+  toOverlayTargetRef
 } from "./overlay-alignment";
 export {
   signWorkspaceOverlay,
   verifyWorkspaceOverlay
 } from "./overlay-signer";
 export {
-  emitPatchProposed,
-  emitPatchApproved,
-  emitPatchRejected,
-  emitOverlaySaved,
-  emitOverlayApplied,
-  emitOverlayFailed,
-  emitPolicyDenied,
-  emitPolicyRedacted
-} from "./audit-events";
-export { rollbackSurfacePatches } from "./rollback";
+  buildOverrideTargetKey,
+  createInMemoryOverrideStore,
+  createOverrideStoreWithApprovalGate
+} from "./override-store";
+export {
+  compilePlannerPrompt
+} from "./planner-prompt";
 export {
-  evaluatePatchProposalPolicy,
-  evaluateAndEmitPatchPolicy
+  buildSurfacePatchProposal,
+  PROPOSE_PATCH_TOOL_SCHEMA,
+  proposePatchToolConfig
+} from "./planner-tools";
+export {
+  evaluateAndEmitPatchPolicy,
+  evaluatePatchProposalPolicy
 } from "./policy-eval";
+export { defaultPreferenceAdapter } from "./preference-adapter";
+export {
+  resolveBundle
+} from "./resolve-bundle";
+export { resolvePreferenceProfile } from "./resolve-preferences";
+export { rollbackSurfacePatches } from "./rollback";
+export {
+  createWidgetRegistry
+} from "./widget-registry";

package/dist/browser/runtime/resolve-bundle.js

@@ -1,9 +1,9 @@
-import { traceAsync } from "@contractspec/lib.observability/tracing";
 import { Logger } from "@contractspec/lib.observability";
+import { traceAsync } from "@contractspec/lib.observability/tracing";
 import { resolutionDurationMs, surfaceFallbackCounter } from "../telemetry";
-import { resolvePreferenceProfile } from "./resolve-preferences";
 import { applySurfacePatch } from "./apply-surface-patch";
 import { buildOverrideTargetKey } from "./override-store";
+import { resolvePreferenceProfile } from "./resolve-preferences";
 const logger = new Logger("@contractspec/lib.surface-runtime");
 function getOpTarget(op) {
   switch (op.op) {

package/dist/browser/spec/index.js

@@ -1,11 +1,11 @@
-export * from "./types";
 export { defineModuleBundle } from "./define-module-bundle";
+export * from "./types";
 export {
-  validateLayoutSlots,
-  validateBundleNodeKinds
+  validateBundleNodeKinds,
+  validateLayoutSlots
 } from "./validate-bundle";
 export {
+  validatePatchProposal,
   validateSurfacePatch,
-  validateSurfacePatchOp,
-  validatePatchProposal
+  validateSurfacePatchOp
 } from "./validate-surface-patch";

package/dist/browser/telemetry/index.js

@@ -1,8 +1,8 @@
 export {
-  resolutionDurationMs,
+  missingRendererCounter,
   patchAcceptanceCounter,
   patchRejectionCounter,
   policyDenialCounter,
-  surfaceFallbackCounter,
-  missingRendererCounter
+  resolutionDurationMs,
+  surfaceFallbackCounter
 } from "./surface-metrics";

package/dist/evals/golden-harness.d.ts

@@ -2,9 +2,8 @@
  * Golden-context harness for resolver evals.
  * Runs resolver with golden contexts and snapshots ResolvedSurfacePlan.
  */
-import type { ModuleBundleSpec } from '../spec/types';
-import type { BundleContext } from '../spec/types';
 import type { ResolvedSurfacePlan } from '../runtime/resolve-bundle';
+import type { BundleContext, ModuleBundleSpec } from '../spec/types';
 import type { GoldenContext } from './golden-context';
 /** Snapshot-friendly plan (deterministic fields only). */
 export interface SnapshotPlan {

package/dist/evals/golden-harness.js

@@ -1,5 +1,5 @@
-import { resolveBundle } from "../runtime/resolve-bundle";
 import { buildContext } from "../runtime/build-context";
+import { resolveBundle } from "../runtime/resolve-bundle";
 export function toSnapshotPlan(plan) {
   return {
     bundleKey: plan.bundleKey,

package/dist/i18n/catalogs/index.d.ts

@@ -1,3 +1,3 @@
 export { enMessages } from './en';
-export { frMessages } from './fr';
 export { esMessages } from './es';
+export { frMessages } from './fr';

package/dist/i18n/catalogs/index.js

@@ -1,3 +1,3 @@
 export { enMessages } from "./en";
-export { frMessages } from "./fr";
 export { esMessages } from "./es";
+export { frMessages } from "./fr";

package/dist/i18n/index.d.ts

@@ -1,5 +1,5 @@
-export { createSurfaceI18n, getDefaultSurfaceI18n } from './messages';
-export type { SurfaceI18n } from './messages';
-export { SURFACE_KEYS } from './keys';
+export { DEFAULT_LOCALE, isSupportedLocale, resolveLocale, SUPPORTED_LOCALES, } from '@contractspec/lib.contracts-spec/translations';
 export type { SurfaceMessageKey } from './keys';
-export { resolveLocale, isSupportedLocale, DEFAULT_LOCALE, SUPPORTED_LOCALES, } from '@contractspec/lib.contracts-spec/translations';
+export { SURFACE_KEYS } from './keys';
+export type { SurfaceI18n } from './messages';
+export { createSurfaceI18n, getDefaultSurfaceI18n } from './messages';

package/dist/i18n/index.js

@@ -1,8 +1,8 @@
-export { createSurfaceI18n, getDefaultSurfaceI18n } from "./messages";
-export { SURFACE_KEYS } from "./keys";
 export {
-  resolveLocale,
-  isSupportedLocale,
   DEFAULT_LOCALE,
+  isSupportedLocale,
+  resolveLocale,
   SUPPORTED_LOCALES
 } from "@contractspec/lib.contracts-spec/translations";
+export { SURFACE_KEYS } from "./keys";
+export { createSurfaceI18n, getDefaultSurfaceI18n } from "./messages";

package/dist/i18n/messages.js

@@ -2,8 +2,8 @@ import {
   createI18nFactory
 } from "@contractspec/lib.contracts-spec/translations";
 import { enMessages } from "./catalogs/en";
-import { frMessages } from "./catalogs/fr";
 import { esMessages } from "./catalogs/es";
+import { frMessages } from "./catalogs/fr";
 const factory = createI18nFactory({
   specKey: "surface-runtime.messages",
   catalogs: [enMessages, frMessages, esMessages]

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export * from './spec';
-export * from './runtime';
-export * from './react';
 export * from './adapters';
+export * from './react';
+export * from './runtime';
+export * from './spec';

package/dist/index.js

@@ -1,4 +1,4 @@
-export * from "./spec";
-export * from "./runtime";
-export * from "./react";
 export * from "./adapters";
+export * from "./react";
+export * from "./runtime";
+export * from "./spec";

package/dist/node/adapters/index.js

@@ -1,7 +1,7 @@
 export { aiSdkAdapterStub } from "./ai-sdk-stub";
 export { blocknoteAdapterStub } from "./blocknote-stub";
-export { dndKitAdapterStub } from "./dnd-kit-stub";
 export { dndKitAdapter } from "./dnd-kit-adapter";
+export { dndKitAdapterStub } from "./dnd-kit-stub";
 export { floatingUiAdapterStub } from "./floating-ui-stub";
 export { motionAdapterStub } from "./motion-stub";
 export { resizablePanelsAdapterStub } from "./resizable-panels-stub";

package/dist/node/evals/golden-harness.js

@@ -1,5 +1,5 @@
-import { resolveBundle } from "../runtime/resolve-bundle";
 import { buildContext } from "../runtime/build-context";
+import { resolveBundle } from "../runtime/resolve-bundle";
 export function toSnapshotPlan(plan) {
   return {
     bundleKey: plan.bundleKey,

package/dist/node/i18n/catalogs/index.js

@@ -1,3 +1,3 @@
 export { enMessages } from "./en";
-export { frMessages } from "./fr";
 export { esMessages } from "./es";
+export { frMessages } from "./fr";

package/dist/node/i18n/index.js

@@ -1,8 +1,8 @@
-export { createSurfaceI18n, getDefaultSurfaceI18n } from "./messages";
-export { SURFACE_KEYS } from "./keys";
 export {
-  resolveLocale,
-  isSupportedLocale,
   DEFAULT_LOCALE,
+  isSupportedLocale,
+  resolveLocale,
   SUPPORTED_LOCALES
 } from "@contractspec/lib.contracts-spec/translations";
+export { SURFACE_KEYS } from "./keys";
+export { createSurfaceI18n, getDefaultSurfaceI18n } from "./messages";