@pygmalionjs/pygmalion 0.6.32 → 0.6.34

package/dist-lib/testing.js

@@ -1,4 +1,4 @@
-import { F as s, N as a, e as r, s as i, a as t } from "./FrozenRoutePreview-BwkyYvUV.js";
+import { F as s, N as a, e as r, s as i, a as t } from "./FrozenRoutePreview-BbF5Ov5K.js";
 export {
   s as FrozenRoutePreviewView,
   a as NodeModel,

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

@@ -27,6 +27,8 @@ export interface CaptureSupplyFrame {
     recipe?: RoutePreviewFrameRecipe;
 }
 export interface CaptureSupplyPlan {
+    /** Canvas that owned the viewport when this plan was built. */
+    activeCanvas?: string;
     /** Chunks of the active canvas, nearest first. */
     active: CaptureSupplyFrame[][];
     /** Chunks of the other canvases, in the order the frames were given. */

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

@@ -1,3 +1,4 @@
+import { getOnDesignChange } from './host';
 import type { EditorStore } from './store';
 type SyncStatus = 'idle' | 'saving' | 'saved' | 'error';
 declare class DesignSyncState {
@@ -10,11 +11,24 @@ declare class DesignSyncState {
 }
 /** General purpose status to show code autosave status in right panel. */
 export declare const designSyncState: DesignSyncState;
+export interface DocumentSyncOptions {
+    /** Exact checkout identity attached to every batch from this session. */
+    sourceRevision?: string;
+    /** Pin this session to its host callback instead of reading a later one. */
+    onDesignChange?: NonNullable<ReturnType<typeof getOnDesignChange>> | null;
+}
+/**
+ * Retire every queue, baseline, and in-flight result owned by the old catalog.
+ * The host receives an abort signal for cooperative cancellation; even when it
+ * ignores that signal, the retired request can no longer mutate this module's
+ * new queue or status.
+ */
+export declare function resetDocumentSync(): void;
 /**
  * It observes the entire edited document, but only sends the final state of changed elements to the host.
  * Continuous typing/dragging and undo/redo are combined with the same element key, so the save history and edit history are separated.
  */
-export declare function startDocumentSync(editor: EditorStore): () => void;
+export declare function startDocumentSync(editor: EditorStore, options?: DocumentSyncOptions): () => void;
 /** Tokens also use the same element change queue as canvas documents. */
 export declare function queueTokenDesignChange(tokens: {
     name: string;

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

@@ -77,6 +77,15 @@ export interface DesignElementChange {
 /** Successive edits of one element are combined into one final state and delivered to the host. */
 export interface DesignChangePayload {
     revision: number;
+    /** Exact source checkout that owned the edited document batch. */
+    sourceRevision?: string;
+    /**
+     * Aborted when that source checkout is retired before the host finishes.
+     * This property is intentionally non-enumerable at runtime so JSON
+     * transports keep their existing payload shape unless they explicitly read
+     * the signal.
+     */
+    signal?: AbortSignal;
     changes: DesignElementChange[];
 }
 export interface DesignChangeResult {

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

@@ -20,6 +20,8 @@ export interface PreviewEnvironmentControlDef {
 /** Configure the inspector controls once from the host application. */
 export declare function setPreviewEnvironmentControls(next: readonly PreviewEnvironmentControlDef[]): void;
 export declare function getPreviewEnvironmentControls(): readonly PreviewEnvironmentControlDef[];
+/** Explicit choices only; defaults stay implicit so they do not alter identity. */
+export declare function getPreviewEnvironmentControlSelections(): Readonly<Record<string, string>>;
 export declare function getPreviewEnvironmentControlValue(controlId: string): string | undefined;
 /**
  * Selects a condition. Defaults are visually selected but remain inert until a

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

@@ -27,6 +27,21 @@ export declare function mirrorBootRetryDelayMs(attempt: number): number;
 export interface MirrorGateStatus {
     state: string;
 }
+/** The idle status fields that can identify an immutable source before checkout. */
+export interface IdleMirrorSourceStatus extends MirrorGateStatus {
+    sourceRef: string | null;
+}
+/**
+ * Returns an immutable source revision that can safely create the first lazy
+ * preview demand.
+ *
+ * An idle mirror has no checked-out `commit` yet. When it was configured with
+ * a full Git object id, however, that ref already names the exact revision the
+ * catalog endpoint will verify after preparation. Named refs, worktree mode,
+ * and abbreviated ids can move or be ambiguous, so they remain pending until
+ * the server reports the resolved commit.
+ */
+export declare function idleMirrorSourceRevision(status: IdleMirrorSourceStatus): string | null;
 export interface SettleMirrorStatusOptions<S extends MirrorGateStatus> {
     /** Status of the initial request; returned as-is when already settled. */
     initial: S;

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

@@ -0,0 +1,135 @@
+import type { DesignComponentConnectionDef } from './componentConnections';
+import type { DesignCodegenProjectManifest } from './designCompiler';
+import type { DesignImportAsset, DesignImportInitialPage, DesignScenarioSource } from './designImport';
+import type { FrameBranchKindDef, FrameLabelLabels } from './frameLabels';
+import type { ScreenLaneDef } from './frameLanes';
+import { type ScreenStateAxisDef } from './interactiveStates';
+import type { PreviewEnvironmentControlDef } from './previewEnvironmentControls';
+import type { RegistryEntry } from './registry';
+import type { ScenarioCoverageClaim } from './scenarioCoverage';
+import type { ScreenCardDef } from './screenCards';
+import type { ScreenDimensionDef } from './screenDimensions';
+import type { ScreenFlowPath } from './screenFlows';
+import type { ScreenListDef } from './screenLists';
+import type { SectionHeaderDef, SectionHeaderLabels } from './sectionHeaders';
+import type { SessionPresetDef } from './sessionPresets';
+import type { StoryboardDefinition } from './storyboardGraph';
+import type { SurfaceClassification } from './surfaceDemands';
+import type { TokenDef } from './tokens';
+import type { ViewportPresetDef } from './viewportPresets';
+export declare const PYGMALION_REVISION_CATALOG_VERSION: 1;
+/** A routed page whose identity is complete at the JSON boundary. */
+export interface PygmalionRevisionScreenPage extends DesignImportInitialPage {
+    name: string;
+    canvas: string;
+    route: string;
+    importKind: 'screens';
+    importPageId: string;
+}
+/** Revision-owned registry metadata overlaid onto host-owned React components. */
+export type PygmalionRevisionComponentRegistry = Readonly<Record<string, Omit<RegistryEntry, 'component'>>>;
+/**
+ * The JSON-serializable part of a design import that belongs to one checkout.
+ * React component implementations stay in the editor host; routed screens and
+ * every declaration that decides what those screens mean travel together.
+ */
+export interface PygmalionRevisionScreenCatalog {
+    expectedCount: number;
+    assets: readonly DesignImportAsset[];
+    pages: readonly PygmalionRevisionScreenPage[];
+}
+export interface PygmalionRevisionCatalogV1 {
+    version: typeof PYGMALION_REVISION_CATALOG_VERSION;
+    namespace: string;
+    sourceRevision: string;
+    screens: PygmalionRevisionScreenCatalog;
+    /** JSON token inventory from the same source checkout. */
+    tokens?: readonly TokenDef[];
+    /** Serializable component metadata; the host still supplies each implementation. */
+    componentRegistry?: PygmalionRevisionComponentRegistry;
+    /** Repository-owned generated-code intent for the catalog's canonical frames. */
+    codegenProject?: DesignCodegenProjectManifest;
+    componentConnections?: readonly DesignComponentConnectionDef[];
+    viewportPresets?: readonly ViewportPresetDef[];
+    sessionPresets?: readonly SessionPresetDef[];
+    previewEnvironmentControls?: readonly PreviewEnvironmentControlDef[];
+    screenFlows?: readonly ScreenFlowPath[];
+    scenarioCoverage?: readonly ScenarioCoverageClaim[];
+    screenDimensions?: readonly ScreenDimensionDef[];
+    screenLists?: readonly ScreenListDef[];
+    sectionHeaders?: readonly SectionHeaderDef[];
+    sectionHeaderLabels?: SectionHeaderLabels;
+    screenLanes?: readonly ScreenLaneDef[];
+    frameBranchKinds?: readonly FrameBranchKindDef[];
+    frameLabelLabels?: FrameLabelLabels;
+    screenCards?: readonly ScreenCardDef[];
+    screenStateAxes?: readonly ScreenStateAxisDef[];
+    surfaceClassifications?: readonly SurfaceClassification[];
+    storyboard?: StoryboardDefinition;
+    storyboardScenarios?: readonly DesignScenarioSource[];
+    sessionStoryboards?: Readonly<Record<string, StoryboardDefinition>>;
+}
+export type PygmalionRevisionCatalog = PygmalionRevisionCatalogV1;
+export interface PygmalionRevisionCatalogExpectation {
+    namespace?: string;
+    sourceRevision?: string;
+}
+export type PygmalionRevisionCatalogValidation = {
+    valid: true;
+    catalog: PygmalionRevisionCatalog;
+} | {
+    valid: false;
+    errors: readonly string[];
+};
+/**
+ * Validates the cross-process boundary before any editor singleton is touched.
+ * Nested declaration semantics are validated by their existing installers;
+ * this gate proves the envelope, exact identity, and screen referential integrity.
+ */
+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 {
+    readonly status: number;
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly preparing: boolean;
+    constructor(options: {
+        status: number;
+        code: string;
+        retryable?: boolean;
+        preparing?: boolean;
+    });
+}
+/** Fetches and validates one exact revision catalog from the local Vite host. */
+export declare function loadPygmalionRevisionCatalog({ endpoint, namespace, sourceRevision, signal, fetcher, }: PygmalionRevisionCatalogLoadOptions): Promise<PygmalionRevisionCatalog>;
+export type PygmalionRevisionCatalogRequestResult = {
+    status: 'accepted';
+    catalog: PygmalionRevisionCatalog;
+} | {
+    status: 'stale';
+};
+/**
+ * Latest-request-wins loader with exact-revision caching.
+ *
+ * Abort is an optimization, not the correctness boundary: a host fetcher may
+ * ignore its signal. The monotonic generation also rejects an old dev request
+ * after the sequence dev -> qa -> dev, where comparing the revision string
+ * alone would incorrectly accept the first dev response.
+ */
+export declare class PygmalionRevisionCatalogClient {
+    private readonly loader;
+    private generation;
+    private activeAbortController;
+    private readonly cache;
+    constructor(loader: (sourceRevision: string, signal: AbortSignal) => Promise<PygmalionRevisionCatalog>);
+    request(sourceRevision: string): Promise<PygmalionRevisionCatalogRequestResult>;
+    invalidate(sourceRevision?: string): void;
+    dispose(): void;
+}

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

@@ -0,0 +1,62 @@
+import { type DesignComponentConnectionDef } from './componentConnections';
+import { type FrameBranchKindDef, type FrameLabelLabels } from './frameLabels';
+import { type ScreenLaneDef } from './frameLanes';
+import { type ScreenStateAxisDef } from './interactiveStates';
+import { type PreviewEnvironmentControlDef } from './previewEnvironmentControls';
+import { type ComponentRegistry, type RegistryEntry } from './registry';
+import { type ScenarioCoverageClaim } from './scenarioCoverage';
+import { type ScreenCardDef } from './screenCards';
+import { type ScreenDimensionDef } from './screenDimensions';
+import { type ScreenFlowPath } from './screenFlows';
+import { type ScreenListDef } from './screenLists';
+import { type SectionHeaderDef, type SectionHeaderLabels } from './sectionHeaders';
+import { type SessionPresetDef } from './sessionPresets';
+import { type SurfaceClassification } from './surfaceDemands';
+import { type TokenDef } from './tokens';
+import { type ViewportPresetDef } from './viewportPresets';
+/**
+ * Mutable declaration singletons that must move with one revision catalog.
+ * The component implementations remain supplied by the host bundle; the
+ * catalog owns their revision-specific JSON declarations and token values.
+ */
+export interface RevisionCatalogDeclarations {
+    registry?: ComponentRegistry;
+    tokens?: readonly TokenDef[];
+    componentConnections?: readonly DesignComponentConnectionDef[];
+    viewportPresets?: readonly ViewportPresetDef[];
+    sessionPresets?: readonly SessionPresetDef[];
+    previewEnvironmentControls?: readonly PreviewEnvironmentControlDef[];
+    screenFlows?: readonly ScreenFlowPath[];
+    scenarioCoverage?: readonly ScenarioCoverageClaim[];
+    screenDimensions?: readonly ScreenDimensionDef[];
+    screenLists?: readonly ScreenListDef[];
+    sectionHeaders?: readonly SectionHeaderDef[];
+    sectionHeaderLabels?: SectionHeaderLabels;
+    screenLanes?: readonly ScreenLaneDef[];
+    frameBranchKinds?: readonly FrameBranchKindDef[];
+    frameLabelLabels?: FrameLabelLabels;
+    screenCards?: readonly ScreenCardDef[];
+    screenStateAxes?: readonly ScreenStateAxisDef[];
+    surfaceClassifications?: readonly SurfaceClassification[];
+}
+/** A page commit that can undo mutations made before it throws. */
+export interface RevisionCatalogPageCommit {
+    commit: () => void;
+    rollback: () => void;
+}
+/**
+ * Binds revision-owned serializable metadata to implementations bundled by the
+ * editor host. Missing implementations fail closed: silently retaining the
+ * previous revision's entry would make adoption and code generation lie about
+ * which component the selected checkout contains.
+ */
+export declare function bindRevisionComponentRegistry(manifest: Readonly<Record<string, Omit<RegistryEntry, 'component'>>> | undefined, hostRegistry: ComponentRegistry | undefined): ComponentRegistry | undefined;
+/**
+ * Installs a catalog and its page commit as one recoverable boundary.
+ *
+ * Module stores do not participate in a MobX transaction, so `runInAction`
+ * alone cannot roll them back. Capture their last complete snapshot first and
+ * restore it if a declaration installer or the page commit rejects. A failed
+ * revision therefore never remains half-installed for the next render.
+ */
+export declare function installRevisionCatalogSnapshot(declarations: RevisionCatalogDeclarations, pageCommit: (() => void) | RevisionCatalogPageCommit): void;

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

@@ -184,7 +184,7 @@ export interface RoutePreviewFrameRequestOptions {
 }
 type RoutePreviewFrameRequester = (frames: readonly RoutePreviewArtifactFrameIdentity[], options?: RoutePreviewFrameRequestOptions) => RoutePreviewArtifactFrameRequestResult | Promise<RoutePreviewArtifactFrameRequestResult> | void;
 /** Installed by the host adapter, which owns the transport. */
-export declare function setRoutePreviewArtifactFrameRequester(requester: RoutePreviewFrameRequester | null): void;
+export declare function setRoutePreviewArtifactFrameRequester(requester: RoutePreviewFrameRequester | null): () => void;
 /**
  * When an exact artifact endpoint exists, background cache misses stay cheap:
  * only an active or deliberately hovered frame may boot the live application.

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

@@ -5,6 +5,7 @@ export interface RoutePreviewArtifactStatusInput {
     resolution: RoutePreviewArtifactResolution;
     captureStatus?: RoutePreviewArtifactV3Status;
     diagnostic?: string;
+    liveInteractionReady?: boolean;
 }
 export interface RoutePreviewArtifactStatusPresentation {
     title: string;
@@ -45,4 +46,4 @@ export declare function resolveStaticRoutePreviewSurface({ hasScreenshot, hasDom
     preferDom?: boolean;
 }): StaticRoutePreviewSurface;
 /** Turns artifact freshness and capture state into one unambiguous frame badge. */
-export declare function resolveRoutePreviewArtifactStatus({ stale, resolution, captureStatus, diagnostic, }: RoutePreviewArtifactStatusInput): RoutePreviewArtifactStatusPresentation | null;
+export declare function resolveRoutePreviewArtifactStatus({ stale, resolution, captureStatus, diagnostic, liveInteractionReady, }: RoutePreviewArtifactStatusInput): RoutePreviewArtifactStatusPresentation | null;

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

@@ -3,7 +3,7 @@ import { type InteractiveStateDef } from './interactiveStates';
 import { type ScreenDimensionDef } from './screenDimensions';
 import { type CardBadgeOption, type CardSlotDef, type ScreenCardDef } from './screenCards';
 import { type ScreenListDef } from './screenLists';
-import { type DesignImportAsset, type DesignImportKind, type DesignFrameSizeMode, type DesignScreenAssertion, type DesignScreenDesiredState, type DesignScreenInteraction, type DesignScreenPreset, type StoryboardEnvironment } from './designImport';
+import { type DesignImportAsset, type DesignImportInitialPage, type DesignImportKind, type DesignFrameSizeMode, type DesignScreenAssertion, type DesignScreenDesiredState, type DesignScreenInteraction, type DesignScreenPreset, type StoryboardEnvironment } from './designImport';
 import { type DomImportDiagnostic, type DomImportResult } from './domImport';
 import { type LayerImportFidelityReport, type MeasurableElement } from './importFidelity';
 import { type DesignFrameHeightMode } from './frameHeight';
@@ -466,6 +466,8 @@ export declare class EditorStore {
     /** Same-tab reload restoration keyed by a host-provided workspace identity. */
     private activeFrameStorageKey;
     private activeFrameDisposer;
+    private activeFramePersistenceScope;
+    private activeFramePersistenceCatalogKey;
     /** Explicit edit scope by sourceKey. Unspecified is shared like the existing operation. */
     private sharedSourceEditScopes;
     /** The final change that can be safely reflected to the original source during a regular canvas NodeModel patch. */
@@ -524,48 +526,45 @@ export declare class EditorStore {
     private sourceEditScopeForNode;
     setSharedSourceEditScope(node: NodeModel, scope: SharedSourceEditScope): void;
     private pagesInitialized;
+    private installedPageCatalogKey;
+    private installedHostPageSignature;
+    private pagesFromComponents;
+    private resetPageCatalogState;
+    private chooseInitialPage;
+    private installPagesFromComponents;
     /**
    * Host injects “real screen components” into editor pages — 1 component node per page (root fill).
    * StrictMode applies only once even to dual mounts (idempotent).
    */
-    initPagesFromComponents(defs: {
-        name: string;
-        componentName?: string;
-        /** Registry Name List — Created as a vertical gallery page (listing component nodes). */
-        gallery?: string[];
-        canvas?: string;
-        section?: string;
-        route?: string;
-        previewRoute?: string;
-        width?: number;
-        height?: number;
-        frameSizeMode?: DesignFrameSizeMode;
-        heightMode?: DesignFrameHeightMode;
-        maxHeight?: number;
-        path?: string;
-        publish?: boolean;
-        importLayers?: boolean;
-        importPageId?: string;
-        importKind?: string;
-        assetIds?: string[];
-        sourcePaths?: string[];
-        flow?: string;
-        scenario?: string;
-        state?: string;
-        stateKind?: string;
-        lane?: string;
-        runtimes?: readonly string[];
-        scenarioId?: string;
-        scenarioIds?: readonly string[];
-        interactions?: DesignScreenInteraction[];
-        desiredState?: DesignScreenDesiredState;
-        environment?: StoryboardEnvironment;
-        preset?: DesignScreenPreset;
-        assertions?: DesignScreenAssertion[];
-        session?: string;
-    }[], options?: {
+    initPagesFromComponents(defs: DesignImportInitialPage[], options?: {
         initialCanvas?: string;
     }): void;
+    /** True when replacing with this exact page catalog would be a no-op. */
+    hasInstalledPageCatalog(catalogKey: string): boolean;
+    /** Re-publishes component props after the host swaps registry functions. */
+    invalidateComponentRegistryBindings(): void;
+    /**
+     * Refreshes only pages supplied by the editor host while retaining routed
+     * pages and their revision-local edits. A runtime/session revision reuses the
+     * same definitions and therefore remains a strict no-op.
+     */
+    refreshHostPagesFromComponents(defs: readonly DesignImportInitialPage[], identity?: {
+        sourceRevision?: string;
+        appOrigin?: string;
+    }): boolean;
+    /**
+     * Replaces the complete page catalog for a different source revision.
+     * Canonical page ids, never allocation-order ids, are the only state allowed
+     * to cross the boundary. All edit and imported-preview state belongs to the
+     * checkout that produced it and is retired before the new pages publish.
+     */
+    replacePagesFromComponents(defs: readonly DesignImportInitialPage[], options: {
+        catalogKey: string;
+        initialCanvas?: string;
+        sourceRevision?: string;
+        appOrigin?: string;
+        hostPages?: readonly DesignImportInitialPage[];
+    }): boolean;
     /** Tree root of the active page — getter(computed) for compatibility with existing code. */
     get root(): NodeModel;
     addPage(): boolean;

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

@@ -20,6 +20,15 @@ export declare function getTokenOverrides(): {
     name: string;
     value: string;
 }[];
+/**
+ * Replaces revision-local token edits without reporting them as new user edits.
+ * Catalog installation uses this to retire one checkout's CSS overrides and to
+ * restore them if the surrounding atomic install fails.
+ */
+export declare function replaceTokenOverrides(next: readonly {
+    name: string;
+    value: string;
+}[]): void;
 /** Edit token value — Immediately override document root (live) + notify cumulative changes to host callback. */
 export declare function applyTokenOverride(name: string, value: string): void;
 /** Disable all overrides (return to original value). */

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

@@ -21,6 +21,8 @@ import { type PreviewEnvironmentControlDef } from './editor/previewEnvironmentCo
 import type { DesignCodegenProjectManifest, DesignCodegenValidator } from './editor/designCompiler';
 
 export { setComponentRegistry } from './editor/registry';
+export { loadPygmalionRevisionCatalog, PygmalionRevisionCatalogClient, PygmalionRevisionCatalogHttpError, PYGMALION_REVISION_CATALOG_VERSION, validatePygmalionRevisionCatalog, } from './editor/revisionCatalog';
+export type { PygmalionRevisionCatalog, PygmalionRevisionCatalogExpectation, PygmalionRevisionCatalogLoadOptions, PygmalionRevisionCatalogRequestResult, PygmalionRevisionCatalogValidation, PygmalionRevisionCatalogV1, PygmalionRevisionComponentRegistry, PygmalionRevisionScreenCatalog, PygmalionRevisionScreenPage, } from './editor/revisionCatalog';
 export { PYGMALION_PREVIEW_CAPTURE_PROGRESS_SUFFIX, previewCaptureProgressEndpoint, usePygmalionPreviewCaptureProgress, } from './editor/previewCaptureProgress';
 export type { PygmalionPreviewCaptureProgress, PygmalionPreviewCaptureProgressPhase, } from './editor/previewCaptureProgress';
 export { beginFrameInteraction, exitFrameInteraction, getFrameInteractionSnapshot, setFrameInteractionScroll, subscribeFrameInteraction, } from './editor/frameInteraction';
@@ -55,7 +57,7 @@ export { validateInteractiveStates, validateScreenStateAxes, } from './editor/in
 export type { InteractiveStateDef, InteractiveStateDiagnostic, InteractiveStateOption, ScreenStateAxisDef, ScreenStateAxisDiagnostic, ScreenStateAxisKind, ScreenStateOption, } from './editor/interactiveStates';
 export { validateScreenCards } from './editor/screenCards';
 export type { CardBadgeOption, CardSlotDef, ScreenCardDef, ScreenCardDiagnostic, } from './editor/screenCards';
-export { validateFrameBranchKinds, framesMissingScenario } from './editor/frameLabels';
+export { validateFrameBranchKinds, framesMissingScenario, } from './editor/frameLabels';
 export type { FrameBranchKindDef, FrameBranchKindDiagnostic, FrameLabelLabels, } from './editor/frameLabels';
 export { validateSectionHeaders } from './editor/sectionHeaders';
 export type { SectionHeaderDef, SectionHeaderDiagnostic, SectionHeaderFacts, SectionHeaderLabels, } from './editor/sectionHeaders';
@@ -78,7 +80,7 @@ export { createStoryboardRouteUrl, getStoryboardBaselineEnvironment, mergeStoryb
 export type { ApplyPayload, DesignChangePayload, DesignChangeResult, DesignCodeDocument, DesignElementChange, DesignElementDocument, DesignTokenDocument, InspectApplyResult, InspectImpactResult, InspectPreviewResult, } from './editor/host';
 export type { InspectApplyPayload, PrimitiveSourceValue, PrimitiveSourceValueType, SourceAffectedFrame, SourceEditOperation, SourceEditScope, SourceIdentity, SourceInsertComponent, } from './editor/inspect';
 export type { InspectQaArtifactHash, InspectQaCaptureRequest, InspectQaFailure, InspectQaFrameResult, InspectQaPixelDiff, InspectQaPixelDimensions, InspectQaResult, } from './editor/visualQa';
-export { inspectQaBaseUrl, requestInspectQaCapture, } 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 { SourceRefControl } from './ui/SourceRefControl';
@@ -283,7 +285,7 @@ export declare function pygmalionOpenPreview(): void;
 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, 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({ 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, }: {
     registry?: ComponentRegistry;
     tokens?: TokenDef[];
     initialPages?: InitialPageDef[];
@@ -341,6 +343,13 @@ export declare function PygmalionEditor({ registry, tokens, initialPages, initia
     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. */