@pygmalionjs/pygmalion 0.6.35 → 0.7.2

package/dist-lib/types/editor/projectRuntime.d.ts

@@ -1,109 +1,22 @@
+import type { EditorTransport } from '../contract/transport.js';
+import type { PygmalionDesignSessionStatus, PygmalionDevMirrorStatus, PygmalionRevertResult, PygmalionSourceRefs } from '../contract/types.js';
 import type { InspectApplyPayload } from './inspect';
 import type { InspectApplyResult, InspectImpactResult, InspectPreviewResult } from './host';
-export type PygmalionIntegrationState = 'up_to_date' | 'auto_merged' | 'review_required' | 'conflict' | 'offline';
-export interface PygmalionDevMirrorStatus {
-    /** 'drifted' means another server moved the shared mirror checkout; a refresh resyncs it. */
-    state: 'idle' | 'syncing' | 'ready' | 'error' | 'drifted';
-    commit: string | null;
-    shortCommit: string | null;
-    /** Git ref the mirror is tracking, or null when it follows the source branch. */
-    sourceRef: string | null;
-    syncedAt: string | null;
-    updated: boolean;
-    warning: string | null;
-    error: string | null;
-    appOrigin: string | null;
-    /** Present when the proxy child is absent or serves another ref's checkout. */
-    runtimeDrift?: {
-        expectedAppRoot: string;
-        actualAppRoot: string | null;
-    };
-}
-/** One revision the mirror can be repointed at. */
-export interface PygmalionSourceRef {
-    name: string;
-    /** Abbreviated commit used for compact branch-tip labels. */
-    commit: string;
-    /** Full immutable object id used for preview and artifact identity. */
-    sourceRevision?: string;
-    fullName: string;
-    kind: 'local' | 'remote';
-}
-/** Revisions available to `switchSource`, listed from the mirror repository. */
-export interface PygmalionSourceRefs {
-    refs: readonly PygmalionSourceRef[];
-    /** Revision followed when none is pinned. */
-    defaultRef: string | null;
-    /** Ref that renders uncommitted work. */
-    worktreeRef: string | null;
-}
-export interface PygmalionVisualOperation {
-    id: string;
-    revision: number;
-    kind: 'visual';
-    createdAt: string;
-    commitSha: string;
-    files: string[];
-    integrationState: PygmalionIntegrationState;
-}
-export interface PygmalionVisualRevertOperation {
-    id: string;
-    revision: number;
-    kind: 'visual-revert';
-    createdAt: string;
-    commitSha: string;
-    revertsOperationId: string;
-    revertsRevision: number;
-    revertsCommitSha: string;
-    recordedCommitSha: string;
-    files: string[];
-    integrationState: PygmalionIntegrationState;
-}
-export type PygmalionSessionOperation = PygmalionVisualOperation | PygmalionVisualRevertOperation;
-export interface PygmalionDesignSessionStatus {
-    id: string;
-    createdAt: string;
-    updatedAt: string;
-    createdFromSha: string;
-    baseDevSha: string;
-    branchName: string | null;
-    headSha: string | null;
-    revision: number;
-    integration: {
-        state: PygmalionIntegrationState;
-        latestDevSha: string;
-        checkedAt: string;
-        affectedFiles: string[];
-        conflictFiles: string[];
-        error?: string;
-    };
-    lastOperation: PygmalionSessionOperation | null;
-    canRevert: boolean;
-    lastRevertableOperation: PygmalionVisualOperation | null;
-    lastRevert: PygmalionVisualRevertOperation | null;
-    appOrigin: string | null;
-    previewError: string | null;
-}
-export interface PygmalionRevertResult {
-    reverted: true;
-    operation: PygmalionVisualRevertOperation;
-    session: PygmalionDesignSessionStatus;
-}
-export interface PygmalionProjectEndpoints {
-    mirror: string;
-    sessions: string;
-    inspect: string;
-}
+export type { PygmalionDesignSessionStatus, PygmalionDevMirrorStatus, PygmalionIntegrationState, PygmalionRevertResult, PygmalionSessionOperation, PygmalionSourceRef, PygmalionSourceRefs, PygmalionVisualOperation, PygmalionVisualRevertOperation, } from '../contract/types.js';
 export interface PygmalionProjectRuntimeOptions {
-    endpoints?: Partial<PygmalionProjectEndpoints>;
+    /**
+     * The transport every request goes through. Defaults to the enclosing
+     * editor runtime's transport when the hook renders inside one, and to a
+     * same-origin Vite transport otherwise. Pass the same transport to
+     * `createEditorRuntime` so the editor and this hook talk to one service.
+     */
+    transport?: EditorTransport;
     sessionId?: string;
     sessionStorageKey?: string;
     autoStart?: boolean;
-    fetcher?: typeof fetch;
     formatApplyMessage?: (session: PygmalionDesignSessionStatus, applied: number) => string | undefined;
-    /** Compare the canonical impact screen before and after application using the host Playwright capture endpoint. */
+    /** Compare the canonical impact screen before and after application using the transport's QA capture service. */
     visualQa?: {
-        endpoint?: string;
         eligibleFrameIds: readonly string[];
     };
 }

package/dist-lib/types/editor/revisionCatalog.d.ts

@@ -1,4 +1,6 @@
 import type { DesignComponentConnectionDef } from './componentConnections';
+import { TransportError } from '../contract/errors.js';
+import type { EditorTransport } from '../contract/transport.js';
 import type { DesignCodegenProjectManifest } from './designCompiler';
 import type { DesignImportAsset, DesignImportInitialPage, DesignScenarioSource } from './designImport';
 import type { FrameBranchKindDef, FrameLabelLabels } from './frameLabels';
@@ -88,27 +90,24 @@ export type PygmalionRevisionCatalogValidation = {
  */
 export declare function validatePygmalionRevisionCatalog(value: unknown, expectation?: PygmalionRevisionCatalogExpectation): PygmalionRevisionCatalogValidation;
 export interface PygmalionRevisionCatalogLoadOptions {
-    endpoint: string;
     namespace: string;
     sourceRevision: string;
     signal?: AbortSignal;
-    fetcher?: typeof fetch;
 }
-/** A non-success HTTP response from the exact revision catalog endpoint. */
-export declare class PygmalionRevisionCatalogHttpError extends Error {
+/** A non-success response from the exact revision catalog endpoint. */
+export declare class PygmalionRevisionCatalogHttpError extends TransportError {
     readonly status: number;
-    readonly code: string;
-    readonly retryable: boolean;
-    readonly preparing: boolean;
     constructor(options: {
         status: number;
         code: string;
         retryable?: boolean;
         preparing?: boolean;
+        payload?: unknown;
+        cause?: unknown;
     });
 }
-/** Fetches and validates one exact revision catalog from the local Vite host. */
-export declare function loadPygmalionRevisionCatalog({ endpoint, namespace, sourceRevision, signal, fetcher, }: PygmalionRevisionCatalogLoadOptions): Promise<PygmalionRevisionCatalog>;
+/** Fetches and validates one exact revision catalog through the transport. */
+export declare function loadPygmalionRevisionCatalog(transport: EditorTransport, { namespace, sourceRevision, signal }: PygmalionRevisionCatalogLoadOptions): Promise<PygmalionRevisionCatalog>;
 export type PygmalionRevisionCatalogRequestResult = {
     status: 'accepted';
     catalog: PygmalionRevisionCatalog;

package/dist-lib/types/editor/scenarioCoverage.d.ts

@@ -1,4 +1,5 @@
 import type { RegistryPropValue } from './registry';
+import type { EditorStore } from './store';
 export type ScenarioCoverageClaim = {
     scenarioId: string;
     kind: 'frame';
@@ -155,7 +156,7 @@ export interface ApplyCoverageResult {
  * edit the imported tree, and component-state claims flip the registry prop
  * on the imported instance.
  */
-export declare function applyScenarioCoverageClaim(claim: ScenarioCoverageClaim): ApplyCoverageResult;
+export declare function applyScenarioCoverageClaim(editor: EditorStore, claim: ScenarioCoverageClaim): ApplyCoverageResult;
 export declare function setScenarioCoverageClaims(claims: readonly ScenarioCoverageClaim[]): void;
 export declare function getScenarioCoverageClaims(): readonly ScenarioCoverageClaim[];
 /** Claims verified on one screen — the right panel's coverage section. */

package/dist-lib/types/editor/store.d.ts

@@ -337,7 +337,21 @@ export type CanvasObjectSelection = {
     kind: 'section';
     name: string;
 } | null;
+/**
+ * What the store needs from its host: read live, never copied, so a value the
+ * host installs later (an origin once the mirror is up, a preview-open
+ * callback from props) is seen on the next read. A runtime's `HostBindings`
+ * satisfies it; a store created on its own gets a detached host.
+ */
+export interface EditorStoreHost {
+    readonly appOrigin: string;
+    readonly previewRevision: string;
+    readonly flowCanvas: string;
+    readonly onPreviewOpenChange: ((open: boolean) => void) | null;
+}
 export declare class EditorStore {
+    /** Host bindings this store reads; excluded from MobX so the bindings object stays plain. */
+    readonly host: EditorStoreHost;
     /** Multi-page — each page has an independent tree. */
     pages: PageModel[];
     activePageId: string;
@@ -492,7 +506,9 @@ export declare class EditorStore {
     private previewMotionStates;
     private contentLayoutScheduled;
     private contentLayoutCanvases;
-    constructor();
+    constructor(host?: EditorStoreHost);
+    /** Releases the reactions this store owns. A runtime calls it when its editor unmounts. */
+    dispose(): void;
     get activePage(): PageModel;
     get selectedFrame(): PageModel | null;
     get selectedSection(): SectionRect | null;
@@ -1014,5 +1030,4 @@ export declare class EditorStore {
 }
 export declare function findNode(from: NodeModel, id: string): NodeModel | null;
 export declare function findParent(from: NodeModel, id: string): NodeModel | null;
-export declare const editor: EditorStore;
 export {};

package/dist-lib/types/editor/storyboardComposition.d.ts

@@ -60,11 +60,7 @@ export interface StoryboardCompositionModel {
      */
     unplacedFrameIds: readonly string[];
 }
-/**
- * Mirror of PYGMALION_SOURCE_USAGE_CONTROL in node/storyboard-environment.mjs;
- * a test pins the pair so the browser cannot drift from the server.
- */
-export declare const SOURCE_USAGE_CONTROL = "/__pygmalion-storyboard/source-usage";
+export declare const SOURCE_USAGE_CONTROL: "/__pygmalion-storyboard/source-usage";
 /**
  * Reads what a frame rendered out of its imported tree. Only frames that have
  * been imported carry stamps, which is why the static graph still matters.

package/dist-lib/types/editor/storyboardDiscovery.d.ts

@@ -1,4 +1,5 @@
 import type { DesignImportAsset, DesignImportKind, DesignScreenCase, StoryboardEnvironment } from './designImport';
+import type { EditorTransport } from '../contract/transport.js';
 import { type StoryboardGraph, type StoryboardDefinition } from './storyboardGraph';
 export interface StoryboardDiscoveryScenario {
     id?: string;
@@ -74,23 +75,11 @@ export interface StoryboardDiscoveryResult {
     baselineEnvironment?: StoryboardEnvironment;
     graph: StoryboardGraph;
 }
-export interface StoryboardDiscoveryResponse {
-    ok: boolean;
-    status: number;
-    json(): Promise<unknown>;
-}
-export type StoryboardDiscoveryFetch = (endpoint: string, init: {
-    headers: {
-        accept: 'application/json';
-    };
-    cache: 'no-store';
-    signal?: AbortSignal;
-}) => Promise<StoryboardDiscoveryResponse>;
 export interface LoadStoryboardDiscoveryOptions extends Omit<StoryboardDiscoveryGraphOptions, 'manifest'> {
-    endpoint: string;
     signal?: AbortSignal;
-    fetcher?: StoryboardDiscoveryFetch;
 }
+/** The shape check the transport leaves to this module: a manifest is a plain object. */
+export declare function isDiscoveryManifest(value: unknown): value is StoryboardDiscoveryManifest;
 export declare function createStoryboardRouteScenarioId(route: string): string;
 /**
  * Converts the editor's resolved screen frames into graph screen cases.
@@ -99,9 +88,10 @@ export declare function createStoryboardRouteScenarioId(route: string): string;
 export declare function resolveStoryboardScreenCases(pages: readonly StoryboardResolvedPage[], manifest: StoryboardDiscoveryManifest): DesignScreenCase[];
 export declare function getStoryboardDiscoveryBaselineEnvironment(manifest: StoryboardDiscoveryManifest): StoryboardEnvironment | undefined;
 export declare function createStoryboardGraphFromDiscovery(options: StoryboardDiscoveryGraphOptions): StoryboardGraph;
-export declare function loadStoryboardDiscovery(options: LoadStoryboardDiscoveryOptions): Promise<StoryboardDiscoveryResult>;
+/** Reads the storyboard environment manifest through the transport and builds the graph from it. */
+export declare function loadStoryboardDiscovery(transport: EditorTransport, options: LoadStoryboardDiscoveryOptions): Promise<StoryboardDiscoveryResult>;
 /**
  * Replaces the editor graph atomically from source discovery. A stale graph is
  * cleared both before the request and after any transport or parsing failure.
  */
-export declare function publishStoryboardDiscovery(options: LoadStoryboardDiscoveryOptions): Promise<StoryboardDiscoveryResult>;
+export declare function publishStoryboardDiscovery(transport: EditorTransport, options: LoadStoryboardDiscoveryOptions): Promise<StoryboardDiscoveryResult>;

package/dist-lib/types/editor/storyboardEnvironment.d.ts

@@ -1,8 +1,8 @@
 import type { StoryboardEnvironment } from './designImport';
 export declare function bumpPreviewIdentityEpoch(): void;
 export declare function getPreviewIdentityEpoch(): number;
-export declare const STORYBOARD_ENVIRONMENT_QUERY = "__pygmalion_environment";
-export declare const STORYBOARD_ENVIRONMENT_CONTROL = "/__pygmalion-storyboard/environment";
+export declare const STORYBOARD_ENVIRONMENT_QUERY: "__pygmalion_environment";
+export declare const STORYBOARD_ENVIRONMENT_CONTROL: "/__pygmalion-storyboard/environment";
 export declare function setStoryboardBaselineEnvironment(environment?: StoryboardEnvironment): void;
 export declare function getStoryboardBaselineEnvironment(): StoryboardEnvironment | undefined;
 export declare function mergeStoryboardEnvironment(base?: StoryboardEnvironment, override?: StoryboardEnvironment): StoryboardEnvironment | undefined;

package/dist-lib/types/editor/variantPrefetch.d.ts

@@ -1,3 +1,4 @@
+import { type FlowSessionRuntime } from './flowSessionScheduler';
 import type { InteractiveStateDef, InteractiveStateOption } from './interactiveStates';
 import type { PageModel } from './store';
 /**
@@ -56,7 +57,7 @@ export declare const __variantPrefetchDebug: {
  * MAX_PREFETCH_WALKS_PER_ROUND idle-time walks, one at a time. Replaces any
  * round already in progress — the newest selection is the best prediction.
  */
-export declare function startInteractiveStatePrefetch(page: PageModel, previewRevision: string): void;
+export declare function startInteractiveStatePrefetch(runtime: FlowSessionRuntime, page: PageModel, previewRevision: string): void;
 /** Drops the scheduled trigger and the in-progress round, if any. */
 export declare function cancelScheduledInteractiveStatePrefetch(): void;
 /**
@@ -66,4 +67,4 @@ export declare function cancelScheduledInteractiveStatePrefetch(): void;
  * effect cleanup — cancelling stops the round, so speculation only runs
  * while the frame is actually the selected one.
  */
-export declare function requestInteractiveStatePrefetch(page: PageModel, previewRevision: string): () => void;
+export declare function requestInteractiveStatePrefetch(runtime: FlowSessionRuntime, page: PageModel, previewRevision: string): () => void;

package/dist-lib/types/editor/visualQa.d.ts

@@ -1,4 +1,5 @@
 import type { InspectApplyPayload } from './inspect';
+import type { EditorTransport, TransportCallOptions } from '../contract/transport.js';
 import type { DesignCodegenData } from './designCompiler';
 export interface InspectQaArtifactHash {
     domStructureHash: string;
@@ -55,5 +56,9 @@ export interface InspectQaCaptureRequest {
 export declare function inspectQaBaseUrl(basePath: string, origin: string): string;
 /** Among all change impact frames calculated by the source graph, only the canonical screen that the host can capture is selected. */
 export declare function inspectQaFrameIds(payload: InspectApplyPayload, eligibleFrameIds?: readonly string[]): string[];
-/** Host Vite middleware strictly normalizes DOM·PNG hashes created with Playwright. */
-export declare function requestInspectQaCapture(fetcher: typeof fetch, endpoint: string, request: InspectQaCaptureRequest): Promise<InspectQaResult>;
+/**
+ * Asks the transport's QA service for DOM and PNG hashes of the given frames
+ * and strictly normalizes its answer. Artifact paths are accepted only under
+ * the transport's QA artifact prefix and come back resolved for the document.
+ */
+export declare function requestInspectQaCapture(transport: EditorTransport, request: InspectQaCaptureRequest, options?: TransportCallOptions): Promise<InspectQaResult>;

package/dist-lib/types/lib.d.ts

@@ -1,8 +1,9 @@
 import { type DesignImportController, type DesignImportInitialPage, type DesignScenarioSource } from './editor/designImport';
 import { type ComponentRegistry } from './editor/registry';
 import { type DesignComponentConnectionDef } from './editor/componentConnections';
-import { type ApplyPayload, type DesignChangePayload, type DesignChangeResult, type InspectApplyResult, type InspectImpactResult, type InspectPreviewResult } from './editor/host';
-import { type InspectApplyPayload } from './editor/inspect';
+import type { ApplyPayload, DesignChangePayload, DesignChangeResult, InspectApplyResult, InspectImpactResult, InspectPreviewResult } from './editor/host';
+import type { InspectApplyPayload } from './editor/inspect';
+import type { EditorRuntime } from './core/runtime';
 import { type ScreenFlowPath } from './editor/screenFlows';
 import { type ScenarioCoverageClaim } from './editor/scenarioCoverage';
 import { type InteractiveStateDef, type ScreenStateAxisDef } from './editor/interactiveStates';
@@ -36,9 +37,13 @@ export type { CodegenFrameOptions } from './editor/codegen';
 export { createDesignComponentCatalog, createDesignComponentVariantMatrix, createDesignGalleryCatalog, designCatalogKey, designCatalogRegistryName, PygmalionCatalogDocument, PygmalionCatalogMatrix, PygmalionCatalogSection, } from './editor/catalog';
 export type { DesignCatalogBuild, DesignCatalogFrame, DesignCatalogItem, DesignCatalogKind, DesignCatalogPageDescriptor, DesignComponentCatalogOptions, DesignComponentVariantMatrix, DesignGalleryCatalogOptions, PygmalionCatalogDocumentProps, PygmalionCatalogMatrixProps, PygmalionCatalogSectionProps, } from './editor/catalog';
 export { setTokens, applyTokenOverride, resetTokenOverrides, } from './editor/tokens';
-export { setAppOrigin as setPygmalionAppOrigin } from './editor/host';
-export { setArtifactOrigin as setPygmalionArtifactOrigin } from './editor/host';
-export { setPreviewRevision as setPygmalionPreviewRevision } from './editor/host';
+export { createEditorRuntime } from './core/runtime';
+export { createViteTransport, resolvePygmalionEndpoints, PYGMALION_ENDPOINTS, TransportError, } from './contract/index.js';
+export type { ComponentBranchesRequest, EditorTransport, InspectImpactRequest, MirrorRefreshRequest, PreviewCatalogRequest, PygmalionEndpointOverrides, PygmalionEndpoints, QaCaptureEnvelope, SessionApplyVisualRequest, SessionApplyVisualResponse, SessionCheckRequest, SessionMutationRequest, SessionOpenRequest, SessionPreviewVisualRequest, SessionPreviewVisualResponse, SessionRevertVisualRequest, SessionRevertVisualResponse, SourceUsageRequest, TransportCallOptions, TransportErrorInit, TransportFetch, TransportRequestInit, TransportResponse, ViteTransportOptions, } from './contract/index.js';
+export type { EditorRuntime, EditorRuntimeOptions } from './core/runtime';
+export type { EditorRuntimeDebug, EditorRuntimeDiagnostics } from './core/debug';
+export type { HostBindings, HostBindingsInit, HostCallbacks, } from './core/hostBindings';
+export { EditorRuntimeProvider, useEditorRuntime, useEditorStore, useHostBindings, useHostCallbacks, } from './core/context';
 export { clearRoutePreviewSnapshots as clearPygmalionPreviewCache, recommendedRoutePreviewConcurrency as getRecommendedPygmalionPreviewConcurrency, setRoutePreviewConcurrency as setPygmalionPreviewConcurrency, } from './editor/routePreview';
 export type { RoutePreviewArtifactBundle } from './editor/routePreview';
 export { reconstructRoutePreviewArtifactScreenshotV3, reconstructRoutePreviewArtifactSnapshotV3, validateRoutePreviewArtifactV3Browser, } from './editor/routePreviewArtifactV3';
@@ -72,7 +77,7 @@ export { createStoryboardPathEdges, createStoryboardGraph, storyboardScreenRecip
 export { createAuthoredStoryboardGraph } from './editor/storyboardAuthored';
 export type { StoryboardDefinition, StoryboardGraph, StoryboardGraphBranch, StoryboardGraphBuildOptions, StoryboardGraphCoverage, StoryboardGraphEdge, StoryboardGraphEdgeInput, StoryboardGraphEdgeLabelScope, StoryboardGraphEdgeOrigin, StoryboardGraphNode, StoryboardGraphSourceGroup, StoryboardGraphWarning, StoryboardGraphWarningCode, StoryboardPathInput, } from './editor/storyboardGraph';
 export { createStoryboardRouteScenarioId, createStoryboardGraphFromDiscovery, getStoryboardDiscoveryBaselineEnvironment, loadStoryboardDiscovery, publishStoryboardDiscovery, resolveStoryboardScreenCases, } from './editor/storyboardDiscovery';
-export type { LoadStoryboardDiscoveryOptions, StoryboardDiscoveryCandidate, StoryboardDiscoveryEdge, StoryboardDiscoveryFetch, StoryboardDiscoveryGraphOptions, StoryboardDiscoveryManifest, StoryboardDiscoveryResponse, StoryboardDiscoveryResult, StoryboardDiscoveryRoute, StoryboardDiscoveryScenario, StoryboardResolvedPage, } from './editor/storyboardDiscovery';
+export type { LoadStoryboardDiscoveryOptions, StoryboardDiscoveryCandidate, StoryboardDiscoveryEdge, StoryboardDiscoveryGraphOptions, StoryboardDiscoveryManifest, StoryboardDiscoveryResult, StoryboardDiscoveryRoute, StoryboardDiscoveryScenario, StoryboardResolvedPage, } from './editor/storyboardDiscovery';
 export { getStoryboardGraph, setStoryboardGraph, subscribeStoryboardGraph, } from './editor/storyboardGraphRuntime';
 export { createStoryboardGraphViewModel } from './editor/storyboardGraphView';
 export type { StoryboardFrameReference, StoryboardGraphCanonicalView, StoryboardGraphFrameView, StoryboardGraphSourceView, StoryboardGraphTransitionView, StoryboardGraphViewModel, } from './editor/storyboardGraphView';
@@ -82,7 +87,7 @@ export type { InspectApplyPayload, PrimitiveSourceValue, PrimitiveSourceValueTyp
 export type { InspectQaArtifactHash, InspectQaCaptureRequest, InspectQaFailure, InspectQaFrameResult, InspectQaPixelDiff, InspectQaPixelDimensions, InspectQaResult, } from './editor/visualQa';
 export { inspectQaBaseUrl, requestInspectQaCapture } from './editor/visualQa';
 export { usePygmalionProject } from './editor/projectRuntime';
-export type { PygmalionDesignSessionStatus, PygmalionDevMirrorStatus, PygmalionIntegrationState, PygmalionProjectEndpoints, PygmalionProjectRuntime, PygmalionProjectRuntimeOptions, PygmalionRevertResult, PygmalionSessionOperation, PygmalionSourceRef, PygmalionSourceRefs, PygmalionVisualOperation, PygmalionVisualRevertOperation, } from './editor/projectRuntime';
+export type { PygmalionDesignSessionStatus, PygmalionDevMirrorStatus, PygmalionIntegrationState, PygmalionProjectRuntime, PygmalionProjectRuntimeOptions, PygmalionRevertResult, PygmalionSessionOperation, PygmalionSourceRef, PygmalionSourceRefs, PygmalionVisualOperation, PygmalionVisualRevertOperation, } from './editor/projectRuntime';
 export { SourceRefControl } from './ui/SourceRefControl';
 export type { SourceRefControlProps } from './ui/SourceRefControl';
 export type { TokenDef } from './editor/tokens';
@@ -100,192 +105,15 @@ export type { CreateDesignImportOptions, DesignBehaviorScenario, DesignImportAss
 export type { DomImportDiagnostic, DomImportMetrics, DomImportOptions, DomImportResult, } from './editor/domImport';
 export type { SharedSourceEditScope, SharedSourceFrameSummary, SharedSourceImpact, } from './editor/sharedSource';
 export type { NodeJSON } from './editor/store';
-import { getObserverTree, isObservableProp } from 'mobx';
-export declare const __debug: {
-    editor: import("./editor/store").EditorStore;
-    getObserverTree: typeof getObserverTree;
-    isObservableProp: typeof isObservableProp;
-    /** Preview-surface introspection for headless diagnosis of frame surfaces. */
-    preview(frameId: string): Promise<{
-        key: string;
-        hasOutcome: boolean;
-        screenshot: {
-            width: number;
-            height: number;
-        } | null;
-        hasShadowArtifact: boolean;
-        hasSnapshot: boolean;
-        keys: {
-            which: "active" | "inactive";
-            sameAsDebugKey: boolean;
-            hasShadowArtifact: boolean;
-            hasSnapshot: boolean;
-        }[];
-        isActivePage: boolean;
-        snapshotShape: {
-            length: number;
-            bodyLength: number;
-            elements: number;
-            basePlaceholderLeft: boolean;
-            baseHref: string | null;
-            head: string;
-        } | null;
-        previewIdentityReady: boolean;
-        seedRevision: string;
-        hostRevision: string;
-        staticSurface: import("./editor/routePreviewStatus").StaticRoutePreviewSurface;
-        tier: import("./editor/frameLod").FrameLifecycleTier;
-        magnified: boolean;
-        promotion: {
-            mounted: boolean;
-            stamped: boolean | null;
-        };
-        lodState: {
-            tiers: [string, import("./editor/frameLod").FrameLifecycleTier][];
-            magnified: [string, boolean][];
-            lastRecompute: {
-                displayDensity?: number;
-                overview?: boolean;
-                frames?: {
-                    id: string;
-                    screenshotDensity: number | null | undefined;
-                    tier: string;
-                }[];
-            };
-        };
-        readFramesNow: (import("./editor/frameLod").FrameLodFrame & {
-            memoKey?: string;
-        }) | undefined;
-    } | null>;
-    /** Flow-session delivery states for headless diagnosis of the captureless supply. */
-    flowSessions(): Promise<{
-        declaredPaths: number;
-        scheduler: {
-            calls: number;
-            lastCanvas: string;
-            lastFlows: number;
-            lastCandidates: number;
-            lastQueued: number;
-        };
-        states: Record<string, import("./editor/flowSessions").FlowScreenState>;
-        viewport: {
-            commit: {
-                requested: number;
-                resolvedNull: number;
-                controllerMissing: number;
-                markerGone: number;
-                editsWon: number;
-                captureNull: number;
-                committed: number;
-            };
-            states: Record<string, unknown>;
-        };
-        interactive: {
-            requests: {
-                requested: number;
-                noPath: number;
-                resolvedNull: number;
-                queued: number;
-                reparkQueued: number;
-                reparkAlreadyParked: number;
-                reparkNoExtraSteps: number;
-            };
-            states: Record<string, unknown>;
-        };
-        warming: {
-            requested: number;
-            noPath: number;
-            resolvedNull: number;
-            alreadyWarm: number;
-            queued: number;
-        };
-        warm: {
-            bootsByRunner: {
-                [x: string]: number;
-            };
-            parked: number;
-            boots: number;
-            reuses: number;
-            parks: number;
-            evictions: number;
-            refreshes: number;
-        };
-    }>;
-    /**
-     * State-switch instrumentation: phase timings of recent flow-session walks
-     * (boot/replay/settle/stability/serialize/publish, per runner label, warm
-     * reuse vs cold boot) plus route-preview producer-gate counters. JSON-safe.
-     */
-    stateSwitchMetrics(): Promise<{
-        walks: {
-            byRunner: {
-                [k: string]: {
-                    count: number;
-                    completed: number;
-                    coldBoots: number;
-                    warmReuses: number;
-                    stabilityTimeouts: number;
-                    phases: Record<import("./editor/stateSwitchMetrics").StateSwitchPhase, import("./editor/stateSwitchMetrics").PhaseAggregate>;
-                };
-            };
-            recent: {
-                totals: {
-                    replayMs: number;
-                    settleMs: number;
-                    stabilityMs: number;
-                    serializeMs: number;
-                    publishMs: number;
-                };
-                waypoints: {
-                    screenId: string;
-                    replayMs: number | null;
-                    settleMs: number | null;
-                    stabilityMs: number | null;
-                    stabilityTimedOut: boolean;
-                    serializeMs: number | null;
-                    publishMs: number | null;
-                }[];
-                runner: string;
-                pathId: string;
-                reused: boolean;
-                completed: boolean;
-                startedAtEpochMs: number;
-                totalMs: number;
-                bootMs: number | null;
-            }[];
-            count: number;
-            completed: number;
-            coldBoots: number;
-            warmReuses: number;
-            stabilityTimeouts: number;
-            phases: Record<import("./editor/stateSwitchMetrics").StateSwitchPhase, import("./editor/stateSwitchMetrics").PhaseAggregate>;
-        };
-        routePreviewProducer: {
-            evaluations: number;
-            allowed: number;
-            suppressed: number;
-            byTrigger: {
-                endpointNotConfigured: number;
-                detailActive: number;
-                previewIntended: number;
-            };
-        };
-    }>;
-    /** Clears the state-switch metrics between headless audit scenarios. */
-    resetStateSwitchMetrics(): Promise<void>;
-};
-/**
- * Called from the actual button handler of the host screen fixture — Switches to the name matching page (common in editor and preview).
- * Example: SettingsPage card onSelect: () => pygmalionNavigate('Settings panel')
- */
-export declare function pygmalionNavigate(pageName: string): void;
-/** Open the prototype preview (▶) in the code — used when the host places its own entry button. */
-export declare function pygmalionOpenPreview(): void;
-/** Discard unapplied canvas and inspection edits created after the latest source load or apply. */
-export declare function pygmalionResetCurrentEdits(): boolean;
 export interface InitialPageDef extends DesignImportInitialPage {
 }
-export declare function PygmalionEditor({ registry, tokens, initialPages, initialCanvas, activeFramePersistenceKey, initialEditMode, componentConnections, codegenProject, codegenValidator, codegenValidationScope, viewportPresets, sessionPresets, previewEnvironmentControls, designImport, onTokensChange, appOrigin, previewRevision, previewCacheNamespace, previewArtifacts, previewArtifactEndpoint, previewCatalogEndpoint, previewConcurrency, previewOpen, onPreviewOpenChange, flowCanvas, frameSurface, captureSupply, screenFlows, screenFlowConcurrency, scenarioCoverage, screenDimensions, screenLists, sectionHeaders, sectionHeaderLabels, screenLanes, frameBranchKinds, frameLabelLabels, screenCards, liveScreenBudget, screenStateAxes, interactiveStates, surfaceClassifications, onApply, onDesignChange, onInspectApply, onInspectPreview, onInspectImpact, storyboard, storyboardScenarios, sessionStoryboards, storyboardDiscovery, storyboardDiscoveryEndpoint, }: {
+export declare function PygmalionEditor({ runtime, registry, tokens, initialPages, initialCanvas, activeFramePersistenceKey, initialEditMode, componentConnections, codegenProject, codegenValidator, codegenValidationScope, viewportPresets, sessionPresets, previewEnvironmentControls, designImport, onTokensChange, appOrigin, previewRevision, previewCacheNamespace, previewArtifacts, previewConcurrency, previewOpen, onPreviewOpenChange, flowCanvas, frameSurface, captureSupply, screenFlows, screenFlowConcurrency, scenarioCoverage, screenDimensions, screenLists, sectionHeaders, sectionHeaderLabels, screenLanes, frameBranchKinds, frameLabelLabels, screenCards, liveScreenBudget, screenStateAxes, interactiveStates, surfaceClassifications, onApply, onDesignChange, onInspectApply, onInspectPreview, onInspectImpact, storyboard, storyboardScenarios, sessionStoryboards, storyboardDiscovery, }: {
+    /**
+     * The runtime this editor renders. Create one with `createEditorRuntime()`
+     * and keep it for the editor's lifetime; two editors on one page each take
+     * their own. Omitted, the editor uses the process-wide default runtime.
+     */
+    runtime?: EditorRuntime;
     registry?: ComponentRegistry;
     tokens?: TokenDef[];
     initialPages?: InitialPageDef[];
@@ -341,15 +169,6 @@ export declare function PygmalionEditor({ registry, tokens, initialPages, initia
     previewCacheNamespace?: string;
     /** A canonical screen snapshot created during build. When the namespace matches, it is injected into the cache before the first render. */
     previewArtifacts?: RoutePreviewArtifactBundle;
-    /** Same-origin endpoint that resolves an exact namespace and source revision, generating it on demand when configured by the Vite plugin. */
-    previewArtifactEndpoint?: string;
-    /**
-     * Same-origin endpoint for the exact checkout's serialized screen catalog.
-     * When configured, routed pages and their declarations never fall back to
-     * the editor bundle: the previous coherent revision stays visible until the
-     * requested catalog has been validated and installed as one snapshot.
-     */
-    previewCatalogEndpoint?: string;
     /** Number of actual app previews to run simultaneously. Defaults to an adaptive 12–32 lanes. */
     previewConcurrency?: number;
     /** Controlled by external status such as host route ▶ Whether the preview is opened or not. */
@@ -368,7 +187,7 @@ export declare function PygmalionEditor({ registry, tokens, initialPages, initia
     frameSurface?: 'bitmap' | 'dom';
     /**
      * Who fills a canvas first. `worker-first` asks the capture worker behind
-     * `previewArtifactEndpoint` for the active canvas in batches (nearest the
+     * the transport's preview artifact endpoint for the active canvas in batches (nearest the
      * viewport first, other canvases after, in the background) and keeps the
      * walking sessions and per-screen sweep as the fallback for what the worker
      * cannot answer. `browser-first` fills the canvas inside the editor — the
@@ -502,8 +321,10 @@ export declare function PygmalionEditor({ registry, tokens, initialPages, initia
      * single runtime and for the brief state before a required preset is chosen.
      */
     sessionStoryboards?: Readonly<Record<string, StoryboardDefinition>>;
-    /** Detect portable browser branches from source before route frames boot. Default true. */
+    /**
+     * Detect portable browser branches from source before route frames boot.
+     * Default true. The manifest comes from the transport's storyboard
+     * environment service.
+     */
     storyboardDiscovery?: boolean;
-    /** Vite endpoint that returns the generated generic storyboard environment manifest. */
-    storyboardDiscoveryEndpoint?: string;
 }): import("react").JSX.Element;

package/dist-lib/types/shell/ComponentStateControls.d.ts

@@ -1,7 +1,7 @@
 import { type ReactNode } from 'react';
 import { sourceWritableRegistryProps } from '../editor/componentInstances';
 import type { RegistryEntry, RegistryPropValue } from '../editor/registry';
-import { type NodeModel, type PageModel } from '../editor/store';
+import type { NodeModel, PageModel } from '../editor/store';
 /** Property-panel section frame shared across the shell panels. */
 export declare function Sec({ title, description, action, children, }: {
     title: string;

package/dist-lib/types/testing.d.ts

@@ -4,5 +4,9 @@
  * repository's source tree or depending on private internal file paths.
  */
 export { FrozenRoutePreviewView } from './canvas/FrozenRoutePreview';
-export { NodeModel, editor, serializeNode } from './editor/store';
+export { EditorStore, NodeModel, serializeNode } from './editor/store';
 export { setComponentRegistry } from './editor/registry';
+export { createEditorRuntime } from './core/runtime';
+export type { EditorRuntime } from './core/runtime';
+export { EditorRuntimeProvider } from './core/context';
+export { createMemoryTransport, type MemoryTransport, type MemoryTransportCall, type MemoryTransportHandlers, } from './contract/memoryTransport.js';