@pygmalionjs/pygmalion 0.7.4 → 0.8.0

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

@@ -0,0 +1,70 @@
+import type { PageModel } from './store.js';
+import { type InteractiveStateDef, type ScreenStateAxisDef } from './interactiveStates.js';
+import type { PreviewEnvironmentControlDef } from './previewEnvironmentControls.js';
+/**
+ * One axis along which the selected screen can vary, whatever declared it.
+ * The panel renders every axis with the same row and asks the source-specific
+ * `ref` only when an option is chosen.
+ */
+export type VariantAxisSource = 'screen-state' | 'interaction' | 'pseudo' | 'condition';
+export interface VariantAxisOption {
+    id: string;
+    label: string;
+    /** Category tag a screen-state branch may declare (overlay, badge, layout, …). */
+    kind?: string;
+    description?: string;
+}
+export type VariantAxisRef = {
+    source: 'screen-state';
+    pages: readonly PageModel[];
+} | {
+    source: 'interaction';
+    def: InteractiveStateDef;
+} | {
+    source: 'pseudo';
+    def: ScreenStateAxisDef;
+} | {
+    source: 'condition';
+    control: PreviewEnvironmentControlDef;
+};
+export interface VariantAxis {
+    /** Unique across sources: `${source}:${declared id}`. */
+    id: string;
+    source: VariantAxisSource;
+    group: VariantGroup;
+    label: string;
+    options: readonly VariantAxisOption[];
+    /** Active option ids: one, or several on a combining axis. */
+    value: readonly string[];
+    defaultValue: string;
+    multiple: boolean;
+    /** The active value differs from the base this frame shows. */
+    changed: boolean;
+    ref: VariantAxisRef;
+}
+export type VariantGroup = 'Screen state' | 'Interaction' | 'Elements' | 'Condition';
+export declare const VARIANT_GROUP_ORDER: readonly VariantGroup[];
+export interface VariantAxisInput {
+    page: PageModel;
+    /** Sibling frames of the page's scenario on its canvas, base first. */
+    siblings?: readonly PageModel[];
+    /** Declared axes that apply to the page. */
+    declared?: readonly InteractiveStateDef[];
+    /** Element pseudo-state axes discovered on the page. */
+    pseudo?: readonly ScreenStateAxisDef[];
+    conditions?: readonly PreviewEnvironmentControlDef[];
+    conditionValue?: (controlId: string) => string | undefined;
+}
+/** Collects every axis the selected screen can vary along, in panel order. */
+export declare function collectVariantAxes(input: VariantAxisInput): VariantAxis[];
+/** Axes away from their base, for the identity chips. */
+export declare function changedVariantAxes(axes: readonly VariantAxis[]): VariantAxis[];
+/** Groups in panel order, empty groups dropped. */
+export declare function variantAxisGroups(axes: readonly VariantAxis[]): {
+    group: VariantGroup;
+    axes: VariantAxis[];
+}[];
+/** The labels of an axis's active options, in option order. */
+export declare function variantAxisValueLabels(axis: VariantAxis): string[];
+/** Rows with more options than fit one line fall back to a menu. */
+export declare const VARIANT_SEGMENT_LIMIT = 4;

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

@@ -1,15 +1,8 @@
-import { type FlowSessionRuntime } from './flowSessionScheduler';
-import type { InteractiveStateDef, InteractiveStateOption } from './interactiveStates';
-import type { PageModel } from './store';
-/**
- * Cheap kill switch, same shape as setCaptureSupplyMode: the host (or a
- * console session) can turn speculation off without touching anything else.
- * Disabling also drops any scheduled or in-progress round.
- */
-export declare function setInteractiveStatePrefetchEnabled(enabled: boolean): void;
-export declare function interactiveStatePrefetchEnabled(): boolean;
-/** Test/tuning hook for the trigger debounce. */
-export declare function setInteractiveStatePrefetchDebounceMs(ms: number): void;
+import type { FlowSessionRuntime, FlowSessionScheduler } from './flowSessionScheduler.js';
+import type { InteractiveStateDef, InteractiveStateOption } from './interactiveStates.js';
+import type { RoutePreviewCache } from './routePreview.js';
+import type { RoutePreviewKeyRuntime } from './framePreviewKeys.js';
+import type { PageModel } from './store.js';
 /**
  * The page identity the store's applyInteractiveState would produce for one
  * exclusive-axis option, computed WITHOUT mutating the page.
@@ -35,36 +28,26 @@ export interface InteractiveVariantPrefetchCandidate {
     variantPage: PageModel;
 }
 /**
- * The unproduced variants of one frame, in declaration order, capped at
- * `limit`. An option is skipped when it needs no work (base or captured),
- * its future key already has a snapshot, or the runner already tracks its
- * variant id (a prefetch or a real request is on it). Only declared
- * exclusive axes participate: combining axes hold sets with no single next
- * click to predict, and automatic pseudo axes are synthesized per element —
- * both stay on the on-demand path.
+ * One editor's speculative variant prefetch: the kill switch, the debounce,
+ * the active round, and the subscription to its interactive runner. Bound to
+ * one runtime and its flow-session scheduler.
  */
-export declare function planInteractiveStatePrefetch(page: PageModel, previewRevision: string, limit?: number): InteractiveVariantPrefetchCandidate[];
-/** Diagnostic counters for the headless debug surface and tests. */
-export declare const __variantPrefetchDebug: {
-    requested: number;
-    rounds: number;
-    queued: number;
-    exhausted: number;
-    unavailable: number;
+export declare function createVariantPrefetch(runtime: FlowSessionRuntime, flows: Pick<FlowSessionScheduler, 'interactiveSessionRunnerIsIdle' | 'interactiveSessionTracksVariant' | 'prefetchPageInteractiveVariant' | 'subscribeInteractiveSessions'>): {
+    planInteractiveStatePrefetch: (keyRuntime: RoutePreviewKeyRuntime & {
+        readonly previews: Pick<RoutePreviewCache, "hasRoutePreviewSnapshot">;
+    }, page: PageModel, previewRevision: string, limit?: number) => InteractiveVariantPrefetchCandidate[];
+    setInteractiveStatePrefetchEnabled: (enabled: boolean) => void;
+    interactiveStatePrefetchEnabled: () => boolean;
+    setInteractiveStatePrefetchDebounceMs: (ms: number) => void;
+    __variantPrefetchDebug: {
+        requested: number;
+        rounds: number;
+        queued: number;
+        exhausted: number;
+        unavailable: number;
+    };
+    startInteractiveStatePrefetch: (page: PageModel, previewRevision: string) => void;
+    cancelScheduledInteractiveStatePrefetch: () => void;
+    requestInteractiveStatePrefetch: (page: PageModel, previewRevision: string) => () => void;
 };
-/**
- * Starts a prefetch round for one frame immediately (no debounce): up to
- * 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(runtime: FlowSessionRuntime, page: PageModel, previewRevision: string): void;
-/** Drops the scheduled trigger and the in-progress round, if any. */
-export declare function cancelScheduledInteractiveStatePrefetch(): void;
-/**
- * Debounced trigger for the panel: called when a frame's axes become
- * visible. The debounce keeps a designer stepping across frames from
- * starting a round per keystroke of selection. Returns a cancel for the
- * effect cleanup — cancelling stops the round, so speculation only runs
- * while the frame is actually the selected one.
- */
-export declare function requestInteractiveStatePrefetch(runtime: FlowSessionRuntime, page: PageModel, previewRevision: string): () => void;
+export type VariantPrefetch = ReturnType<typeof createVariantPrefetch>;

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

@@ -8,14 +8,14 @@ export interface ViewportPresetDef {
     /** Tooltip text. Defaults to the dimensions. */
     description?: string;
 }
-/**
- * Declares the preset list. A malformed entry throws here rather than producing a
- * button that silently collapses a frame — the host configures this once at mount.
- */
-export declare function setViewportPresets(next: readonly ViewportPresetDef[]): void;
-export declare function getViewportPresets(): ViewportPresetDef[];
 /** Whether a frame currently sits at the preset, so the button can read as active. */
 export declare function matchesViewportPreset(preset: ViewportPresetDef, size: {
     width: number;
     height: number;
 }): boolean;
+/** One editor's declared viewport presets. */
+export declare function createViewportPresets(): {
+    setViewportPresets: (next: readonly ViewportPresetDef[]) => void;
+    getViewportPresets: () => ViewportPresetDef[];
+};
+export type ViewportPresets = ReturnType<typeof createViewportPresets>;

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

@@ -1,6 +1,6 @@
-import type { InspectApplyPayload } from './inspect';
+import type { InspectApplyPayload } from './inspect.js';
 import type { EditorTransport, TransportCallOptions } from '../contract/transport.js';
-import type { DesignCodegenData } from './designCompiler';
+import type { DesignCodegenData } from './designCompiler.js';
 export interface InspectQaArtifactHash {
     domStructureHash: string;
     screenshotHash: string;

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

@@ -1,110 +1,106 @@
-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, 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';
-import { type SurfaceClassification } from './editor/surfaceDemands';
-import { type ScreenDimensionDef } from './editor/screenDimensions';
-import { type FrameBranchKindDef, type FrameLabelLabels } from './editor/frameLabels';
-import { type ScreenCardDef } from './editor/screenCards';
-import { type SectionHeaderDef, type SectionHeaderLabels } from './editor/sectionHeaders';
-import { type ScreenLaneDef } from './editor/frameLanes';
-import { type ScreenListDef } from './editor/screenLists';
-import { type RoutePreviewArtifactBundle } from './editor/routePreview';
-import type { StoryboardDefinition } from './editor/storyboardGraph';
-import { type TokenDef } from './editor/tokens';
-import { type ViewportPresetDef } from './editor/viewportPresets';
-import { type PreviewEnvironmentControlDef } from './editor/previewEnvironmentControls';
-import type { DesignCodegenProjectManifest, DesignCodegenValidator } from './editor/designCompiler';
+import type { DesignImportController, DesignImportInitialPage, DesignScenarioSource } from './editor/designImport.js';
+import type { ComponentRegistry } from './editor/registry.js';
+import type { DesignComponentConnectionDef } from './editor/componentConnections.js';
+import type { ApplyPayload, DesignChangePayload, DesignChangeResult, InspectApplyResult, InspectImpactResult, InspectPreviewResult } from './editor/host.js';
+import type { InspectApplyPayload } from './editor/inspect.js';
+import type { EditorRuntime } from './core/runtime.js';
+import type { ScreenFlowPath } from './editor/screenFlows.js';
+import type { ScenarioCoverageClaim } from './editor/scenarioCoverage.js';
+import type { InteractiveStateDef, ScreenStateAxisDef } from './editor/interactiveStates.js';
+import type { SurfaceClassification } from './editor/surfaceDemands.js';
+import type { ScreenDimensionDef } from './editor/screenDimensions.js';
+import type { FrameBranchKindDef, FrameLabelLabels } from './editor/frameLabels.js';
+import type { ScreenCardDef } from './editor/screenCards.js';
+import type { SectionHeaderDef, SectionHeaderLabels } from './editor/sectionHeaders.js';
+import type { ScreenLaneDef } from './editor/frameLanes.js';
+import type { ScreenListDef } from './editor/screenLists.js';
+import { type RoutePreviewArtifactBundle } from './editor/routePreview.js';
+import type { StoryboardDefinition } from './editor/storyboardGraph.js';
+import type { TokenDef } from './editor/tokens.js';
+import type { ViewportPresetDef } from './editor/viewportPresets.js';
+import type { PreviewEnvironmentControlDef } from './editor/previewEnvironmentControls.js';
+import type { DesignCodegenProjectManifest, DesignCodegenValidator } from './editor/designCompiler.js';
 
-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';
-export type { FrameInteractionPhase, FrameInteractionScrollState, FrameInteractionSnapshot, } from './editor/frameInteraction';
-export type { ComponentRegistry, RegistryEntry, RegistryPropValue, } from './editor/registry';
-export { enumerateDesignComponentConnectionCases, getDesignComponentConnection, getDesignComponentConnectionForComponent, getDesignComponentConnections, setDesignComponentConnections, validateDesignComponentConnections, } from './editor/componentConnections';
-export type { DesignComponentConnectionCase, DesignComponentConnectionCases, DesignComponentConnectionDef, DesignComponentReference, DesignConnectionDiagnostic, DesignConnectionPropertyDef, DesignConnectionPropertyKind, } from './editor/componentConnections';
-export { compileDesignDocument, createDesignIntermediateDocument, DEFAULT_DESIGN_COMPILE_LIMITS, DESIGN_CODEGEN_PROJECT_SCHEMA, DESIGN_CODEGEN_PROJECT_VERSION, DESIGN_IR_SCHEMA, DESIGN_IR_VERSION, getDesignCodegenAdapters, registerDesignCodegenAdapter, } from './editor/designCompiler';
-export type { DesignCodegenAdapter, DesignCodegenAdapterContext, DesignCodegenAdapterOutput, DesignCodegenData, DesignCodegenFrameContract, DesignCodegenPageContext, DesignCodegenProjectManifest, DesignCodegenPromptReference, DesignCodegenRuntimeContext, DesignCodegenValidationArtifacts, DesignCodegenValidationRequest, DesignCodegenValidationResult, DesignCodegenValidationStatus, DesignCodegenValidator, DesignCompileDiagnostic, DesignCompileLimits, DesignCompileOptions, DesignCompilePurpose, DesignCompileResult, DesignCompileSeverity, DesignCompileStage, DesignCompileStatus, DesignIntermediateDocumentV1, DesignIRAsset, DesignIRComponent, DesignIRMetrics, } from './editor/designCompiler';
-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 { createEditorRuntime } from './core/runtime';
+export { loadPygmalionRevisionCatalog, PygmalionRevisionCatalogClient, PygmalionRevisionCatalogHttpError, PYGMALION_REVISION_CATALOG_VERSION, validatePygmalionRevisionCatalog, } from './editor/revisionCatalog.js';
+export type { PygmalionRevisionCatalog, PygmalionRevisionCatalogExpectation, PygmalionRevisionCatalogLoadOptions, PygmalionRevisionCatalogRequestResult, PygmalionRevisionCatalogValidation, PygmalionRevisionCatalogV1, PygmalionRevisionComponentRegistry, PygmalionRevisionScreenCatalog, PygmalionRevisionScreenPage, } from './editor/revisionCatalog.js';
+export { PYGMALION_PREVIEW_CAPTURE_PROGRESS_SUFFIX, previewCaptureProgressEndpoint, usePygmalionPreviewCaptureProgress, } from './editor/previewCaptureProgress.js';
+export type { PygmalionPreviewCaptureProgress, PygmalionPreviewCaptureProgressPhase, } from './editor/previewCaptureProgress.js';
+export type { FrameInteractionPhase, FrameInteractionScrollState, FrameInteractionSnapshot, } from './editor/frameInteraction.js';
+export type { ComponentRegistry, RegistryEntry, RegistryPropValue, } from './editor/registry.js';
+export type { DesignComponentConnectionCase, DesignComponentConnectionCases, DesignComponentConnectionDef, DesignComponentReference, DesignConnectionDiagnostic, DesignConnectionPropertyDef, DesignConnectionPropertyKind, } from './editor/componentConnections.js';
+export { compileDesignDocument, createDesignIntermediateDocument, DEFAULT_DESIGN_COMPILE_LIMITS, DESIGN_CODEGEN_PROJECT_SCHEMA, DESIGN_CODEGEN_PROJECT_VERSION, DESIGN_IR_SCHEMA, DESIGN_IR_VERSION, getDesignCodegenAdapters, registerDesignCodegenAdapter, } from './editor/designCompiler.js';
+export type { DesignCodegenAdapter, DesignCodegenAdapterContext, DesignCodegenAdapterOutput, DesignCodegenData, DesignCodegenFrameContract, DesignCodegenPageContext, DesignCodegenProjectManifest, DesignCodegenPromptReference, DesignCodegenRuntimeContext, DesignCodegenValidationArtifacts, DesignCodegenValidationRequest, DesignCodegenValidationResult, DesignCodegenValidationStatus, DesignCodegenValidator, DesignCompileDiagnostic, DesignCompileLimits, DesignCompileOptions, DesignCompilePurpose, DesignCompileResult, DesignCompileSeverity, DesignCompileStage, DesignCompileStatus, DesignIntermediateDocumentV1, DesignIRAsset, DesignIRComponent, DesignIRMetrics, } from './editor/designCompiler.js';
+export { VARIANT_SEGMENT_LIMIT, changedVariantAxes, collectVariantAxes, variantAxisGroups, variantAxisValueLabels, } from './editor/variantAxes.js';
+export type { VariantAxis, VariantAxisInput, VariantAxisOption, VariantAxisRef, VariantAxisSource, VariantGroup, } from './editor/variantAxes.js';
+export type { CodegenFrameOptions } from './editor/codegen.js';
+export { createDesignComponentCatalog, createDesignComponentVariantMatrix, createDesignGalleryCatalog, designCatalogKey, designCatalogRegistryName, PygmalionCatalogDocument, PygmalionCatalogMatrix, PygmalionCatalogSection, } from './editor/catalog.js';
+export type { DesignCatalogBuild, DesignCatalogFrame, DesignCatalogItem, DesignCatalogKind, DesignCatalogPageDescriptor, DesignComponentCatalogOptions, DesignComponentVariantMatrix, DesignGalleryCatalogOptions, PygmalionCatalogDocumentProps, PygmalionCatalogMatrixProps, PygmalionCatalogSectionProps, } from './editor/catalog.js';
+export { createEditorRuntime } from './core/runtime.js';
+export type { EditorDeclarations } from './editor/declarations.js';
+export type { EditorSchedulers } from './core/schedulers.js';
 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';
-export type { RoutePreviewArtifactBundleV3, RoutePreviewArtifactV3Diagnostic, RoutePreviewArtifactV3Frame, RoutePreviewArtifactV3ReconstructedScreenshot, RoutePreviewArtifactV3ScreenshotAsset, RoutePreviewArtifactV3ScreenshotMediaType, RoutePreviewArtifactV3ScreenshotReference, RoutePreviewArtifactV3Status, RoutePreviewArtifactV3ValidationResult, RoutePreviewArtifactV3Viewport, } from './editor/routePreviewArtifactV3';
-export { bootstrapPreviewArtifact, createPreviewArtifactHttpTransport, createPreviewCacheNamespace, createPreviewFrameFingerprint, createPreviewRecipeFingerprint, createStoryboardCaptureRecipeIdentity, PYGMALION_PREVIEW_CAPTURE_SCHEMA_VERSION, resolvePreviewArtifactFrames, validatePreviewArtifactBundle, } from './editor/previewBootstrap';
-export type { PreviewArtifactBootstrapResult, PreviewArtifactExpectation, PreviewArtifactFetch, PreviewArtifactFrameRequest, PreviewArtifactFrameResolution, PreviewArtifactHttpResponse, PreviewArtifactHttpTransportOptions, PreviewArtifactTransport, PreviewArtifactTransportRequest, PreviewArtifactValidationReason, PreviewArtifactValidationResult, PreviewCacheNamespaceOptions, PreviewRecipeIdentity, StoryboardCaptureRecipeInput, } from './editor/previewBootstrap';
-export { validateScreenStateGroups } from './editor/screenStateGroups';
-export type { ScreenStateGroupDiagnostic, ScreenStateGroupInput, } from './editor/screenStateGroups';
-export { validateScreenFlows } from './editor/screenFlows';
-export type { ScreenFlowDiagnostic, ScreenFlowPath, ScreenFlowWaypoint, } from './editor/screenFlows';
-export { applyScenarioCoverageClaim, validateScenarioCoverage, } from './editor/scenarioCoverage';
-export type { ApplyCoverageResult, ScenarioCoverageClaim, ScenarioCoverageContext, ScenarioCoverageDiagnostic, } from './editor/scenarioCoverage';
-export { enumerateControlCandidates, enumerateRequestCandidates, enumerateRouteCandidates, frameSurfaceDemands, getObservedRequests, getSurfaceClassifications, MIN_SURFACE_REASON_LENGTH, requestEndpointShape, setObservedRequests, setSurfaceClassifications, unclassifiedSurfaces, validateSurfaceDemands, } from './editor/surfaceDemands';
-export type { ControlNodeLike, FrameSurfaceDemands, ObservedRequest, RouteEnumerationInput, SurfaceCandidate, SurfaceClassification, SurfaceDemandDiagnostic, SurfaceDemandKind, SurfaceVerdict, } from './editor/surfaceDemands';
-export { validateInteractiveStates, validateScreenStateAxes, } from './editor/interactiveStates';
-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 type { FrameBranchKindDef, FrameBranchKindDiagnostic, FrameLabelLabels, } from './editor/frameLabels';
-export { validateSectionHeaders } from './editor/sectionHeaders';
-export type { SectionHeaderDef, SectionHeaderDiagnostic, SectionHeaderFacts, SectionHeaderLabels, } from './editor/sectionHeaders';
-export { validateScreenLanes } from './editor/frameLanes';
-export type { ScreenLaneDef, ScreenLaneDiagnostic } from './editor/frameLanes';
-export { validateScreenLists } from './editor/screenLists';
-export type { ScreenListDef, ScreenListDiagnostic } from './editor/screenLists';
-export type { NodeSelector } from './editor/nodeSelector';
-export { validateScreenDimensions } from './editor/screenDimensions';
-export type { ComponentBranch, ScreenDimensionDef, ScreenDimensionDiagnostic, ScreenDimensionOption, } from './editor/screenDimensions';
-export { createStoryboardPathEdges, createStoryboardGraph, storyboardScreenRecipeKey, } from './editor/storyboardGraph';
-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, 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';
-export { createStoryboardRouteUrl, getStoryboardBaselineEnvironment, mergeStoryboardEnvironment, setStoryboardBaselineEnvironment, STORYBOARD_ENVIRONMENT_CONTROL, STORYBOARD_ENVIRONMENT_QUERY, } from './editor/storyboardEnvironment';
-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 { usePygmalionProject } 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';
-export { getViewportPresets, setViewportPresets, } from './editor/viewportPresets';
-import { type SessionPresetDef } from './editor/sessionPresets';
-export type { ViewportPresetDef } from './editor/viewportPresets';
-export { getSelectedSessionPreset, getSessionPresets, selectSessionPreset, setSessionPresets, subscribeSessionPresets, } from './editor/sessionPresets';
-export type { SessionPresetDef } from './editor/sessionPresets';
-export { GENERIC_ASSERTION_SHARE, MIN_UNVERIFIED_REASON_LENGTH, detectStateGroupCandidates, hooksInSelector, summarizeConditionCoverage, validateHookTargeting, validateScreenConformance, } from './editor/screenConformance';
-export type { ConditionCoverageRoute, ConditionCoverageScreen, ConformanceScreen, HookTargetingFinding, HookTargetingInput, HookTargetingKind, ScreenConformanceFinding, ScreenConformanceKind, StateGroupFinding, StateGroupScreen, } from './editor/screenConformance';
-export { clearPreviewEnvironmentControlValues, getPreviewEnvironmentControlValue, getPreviewEnvironmentControls, getPreviewEnvironmentOverride, setPreviewEnvironmentControlValue, setPreviewEnvironmentControls, subscribePreviewEnvironmentControls, } from './editor/previewEnvironmentControls';
-export type { PreviewEnvironmentControlDef, PreviewEnvironmentControlOptionDef, } from './editor/previewEnvironmentControls';
-export { createDesignImportController, createDesignScreenCollection, DESIGN_IMPORT_KINDS, expandDesignScreenCasesViewports, expandDesignScreenCollectionViewports, mergeScreenPresets, } from './editor/designImport';
-export type { CreateDesignImportOptions, DesignBehaviorScenario, DesignImportAsset, DesignImportCollection, DesignImportController, DesignImportCoverage, DesignImportCoverageItem, DesignImportInitialPage, DesignImportKind, DesignImportManifest, DesignImportPage, DesignFrameHeightMode, DesignFrameSizeMode, DesignScenarioCoverage, DesignScenarioSource, DesignScreenCase, DesignScreenAssertion, DesignScreenAssertionReport, DesignScreenAssertionVisibility, DesignScreenAttributeAssertion, DesignScreenCaptureFailure, DesignScreenCaptureFailureCode, DesignScreenCaptureFailureStage, DesignScreenCaptureDefaults, DesignScreenCaptureRequirements, DesignScreenCaptureReport, DesignScreenCaptureSpec, DesignScreenCollectionResult, DesignScreenDesiredState, DesignScreenDesiredStateExecutor, DesignScreenDesiredStateRequest, DesignScreenInteraction, DesignScreenInteractionAction, DesignScreenInteractionRunOptions, DesignScreenInteractionReport, DesignScreenPreset, DesignScreenPresetContext, DesignScreenPresetExecutionResult, DesignScreenPresetExecutor, DesignScreenPresetRequest, DesignScreenViewport, DesignScreenViewportExpansionOptions, DesignScreenViewportPagePatch, DesignSerializable, StoryboardEnvironment, StoryboardMediaDevice, StoryboardMediaFailure, StoryboardNetwork, StoryboardPermissionState, StoryboardRequestCondition, StoryboardRequestOutcome, } from './editor/designImport';
-export type { DomImportDiagnostic, DomImportMetrics, DomImportOptions, DomImportResult, } from './editor/domImport';
-export type { SharedSourceEditScope, SharedSourceFrameSummary, SharedSourceImpact, } from './editor/sharedSource';
-export type { NodeJSON } from './editor/store';
+export type { EditorRuntime, EditorRuntimeOptions } from './core/runtime.js';
+export type { EditorRuntimeDebug, EditorRuntimeDiagnostics } from './core/debug.js';
+export type { HostBindings, HostBindingsInit, HostCallbacks, } from './core/hostBindings.js';
+export { EditorRuntimeProvider, useEditorRuntime, useEditorStore, useHostBindings, useHostCallbacks, } from './core/context.js';
+export { recommendedRoutePreviewConcurrency as getRecommendedPygmalionPreviewConcurrency } from './editor/routePreview.js';
+export type { RoutePreviewArtifactBundle } from './editor/routePreview.js';
+export { reconstructRoutePreviewArtifactScreenshotV3, reconstructRoutePreviewArtifactSnapshotV3, validateRoutePreviewArtifactV3Browser, } from './editor/routePreviewArtifactV3.js';
+export type { RoutePreviewArtifactBundleV3, RoutePreviewArtifactV3Diagnostic, RoutePreviewArtifactV3Frame, RoutePreviewArtifactV3ReconstructedScreenshot, RoutePreviewArtifactV3ScreenshotAsset, RoutePreviewArtifactV3ScreenshotMediaType, RoutePreviewArtifactV3ScreenshotReference, RoutePreviewArtifactV3Status, RoutePreviewArtifactV3ValidationResult, RoutePreviewArtifactV3Viewport, } from './editor/routePreviewArtifactV3.js';
+export { bootstrapPreviewArtifact, createPreviewArtifactHttpTransport, createPreviewCacheNamespace, createPreviewFrameFingerprint, createPreviewRecipeFingerprint, createStoryboardCaptureRecipeIdentity, PYGMALION_PREVIEW_CAPTURE_SCHEMA_VERSION, resolvePreviewArtifactFrames, validatePreviewArtifactBundle, } from './editor/previewBootstrap.js';
+export type { PreviewArtifactBootstrapResult, PreviewArtifactExpectation, PreviewArtifactFetch, PreviewArtifactFrameRequest, PreviewArtifactFrameResolution, PreviewArtifactHttpResponse, PreviewArtifactHttpTransportOptions, PreviewArtifactTransport, PreviewArtifactTransportRequest, PreviewArtifactValidationReason, PreviewArtifactValidationResult, PreviewCacheNamespaceOptions, PreviewRecipeIdentity, StoryboardCaptureRecipeInput, } from './editor/previewBootstrap.js';
+export { validateScreenStateGroups } from './editor/screenStateGroups.js';
+export type { ScreenStateGroupDiagnostic, ScreenStateGroupInput, } from './editor/screenStateGroups.js';
+export { validateScreenFlows, } from './editor/screenFlows.js';
+export type { ScreenFlowDiagnostic, ScreenFlowPath, ScreenFlowWaypoint, } from './editor/screenFlows.js';
+export { summarizeScenarioCoverage, validateScenarioCoverage, } from './editor/scenarioCoverage.js';
+export type { ApplyCoverageResult, ScenarioCoverageClaim, ScenarioCoverageContext, ScenarioCoverageDiagnostic, ScenarioCoverageDiagnosticCode, ScenarioCoverageSummary, } from './editor/scenarioCoverage.js';
+export { auditRouteCoverage, declaredCoverageTargets, enumerateControlCandidates, enumerateRequestCandidates, enumerateRouteCandidates, MIN_SURFACE_REASON_LENGTH, requestEndpointShape, summarizeSurfaceDemands, unclassifiedSurfaces, validateSurfaceDemands, } from './editor/surfaceDemands.js';
+export type { ControlNodeLike, CoverageTargetDeclarations, DeclaredScreenRoute, DiscoveredRoute, FrameSurfaceDemands, ObservedRequest, RouteCoverageAudit, RouteCoverageDiagnostic, RouteCoverageDiagnosticCode, RouteEnumerationInput, RouteRepresentation, RouteRepresentationKind, SurfaceCandidate, SurfaceClassification, SurfaceCoverageSummary, SurfaceDemandDiagnostic, SurfaceDemandDiagnosticCode, SurfaceDemandKind, SurfaceDemandOptions, SurfaceVerdict, } from './editor/surfaceDemands.js';
+export { validateInteractiveStates, validateScreenStateAxes, } from './editor/interactiveStates.js';
+export type { InteractiveStateDef, InteractiveStateDiagnostic, InteractiveStateOption, ScreenStateAxisDef, ScreenStateAxisDiagnostic, ScreenStateAxisKind, ScreenStateOption, } from './editor/interactiveStates.js';
+export { validateScreenCards, } from './editor/screenCards.js';
+export type { CardBadgeOption, CardSlotDef, ScreenCardDef, ScreenCardDiagnostic, } from './editor/screenCards.js';
+export { validateFrameBranchKinds, framesMissingScenario, } from './editor/frameLabels.js';
+export type { FrameBranchKindDef, FrameBranchKindDiagnostic, FrameLabelLabels, } from './editor/frameLabels.js';
+export { validateSectionHeaders, } from './editor/sectionHeaders.js';
+export type { SectionHeaderDef, SectionHeaderDiagnostic, SectionHeaderFacts, SectionHeaderLabels, } from './editor/sectionHeaders.js';
+export { validateScreenLanes, } from './editor/frameLanes.js';
+export type { ScreenLaneDef, ScreenLaneDiagnostic } from './editor/frameLanes.js';
+export { validateScreenLists, } from './editor/screenLists.js';
+export type { ScreenListDef, ScreenListDiagnostic } from './editor/screenLists.js';
+export type { NodeSelector } from './editor/nodeSelector.js';
+export { validateScreenDimensions, } from './editor/screenDimensions.js';
+export type { ComponentBranch, ScreenDimensionDef, ScreenDimensionDiagnostic, ScreenDimensionOption, } from './editor/screenDimensions.js';
+export { createStoryboardPathEdges, createStoryboardGraph, storyboardScreenRecipeKey, } from './editor/storyboardGraph.js';
+export { createAuthoredStoryboardGraph } from './editor/storyboardAuthored.js';
+export type { StoryboardDefinition, StoryboardGraph, StoryboardGraphBranch, StoryboardGraphBuildOptions, StoryboardGraphCoverage, StoryboardGraphEdge, StoryboardGraphEdgeInput, StoryboardGraphEdgeLabelScope, StoryboardGraphEdgeOrigin, StoryboardGraphNode, StoryboardGraphSourceGroup, StoryboardGraphWarning, StoryboardGraphWarningCode, StoryboardPathInput, } from './editor/storyboardGraph.js';
+export { createStoryboardRouteScenarioId, createStoryboardGraphFromDiscovery, getStoryboardDiscoveryBaselineEnvironment, loadStoryboardDiscovery, publishStoryboardDiscovery, resolveStoryboardScreenCases, } from './editor/storyboardDiscovery.js';
+export type { LoadStoryboardDiscoveryOptions, StoryboardDiscoveryCandidate, StoryboardDiscoveryEdge, StoryboardDiscoveryGraphOptions, StoryboardDiscoveryManifest, StoryboardDiscoveryResult, StoryboardDiscoveryRoute, StoryboardDiscoveryScenario, StoryboardResolvedPage, } from './editor/storyboardDiscovery.js';
+export { createStoryboardGraphViewModel } from './editor/storyboardGraphView.js';
+export type { StoryboardFrameReference, StoryboardGraphCanonicalView, StoryboardGraphFrameView, StoryboardGraphSourceView, StoryboardGraphTransitionView, StoryboardGraphViewModel, } from './editor/storyboardGraphView.js';
+export { createStoryboardRouteUrl, mergeStoryboardEnvironment, STORYBOARD_ENVIRONMENT_CONTROL, STORYBOARD_ENVIRONMENT_QUERY, } from './editor/storyboardEnvironment.js';
+export type { ApplyPayload, DesignChangePayload, DesignChangeResult, DesignCodeDocument, DesignElementChange, DesignElementDocument, DesignTokenDocument, InspectApplyResult, InspectImpactFrame, InspectImpactResult, InspectPreviewResult, } from './editor/host.js';
+export type { InspectApplyPayload, PrimitiveSourceValue, PrimitiveSourceValueType, SourceAffectedFrame, SourceEditOperation, SourceEditScope, SourceIdentity, SourceInsertComponent, } from './editor/inspect.js';
+export type { InspectQaArtifactHash, InspectQaCaptureRequest, InspectQaFailure, InspectQaFrameResult, InspectQaPixelDiff, InspectQaPixelDimensions, InspectQaResult, } from './editor/visualQa.js';
+export { inspectQaBaseUrl, requestInspectQaCapture } from './editor/visualQa.js';
+export { usePygmalionProject } from './editor/projectRuntime.js';
+export type { PygmalionDesignSessionStatus, PygmalionDevMirrorStatus, PygmalionIntegrationState, PygmalionProjectRuntime, PygmalionProjectRuntimeOptions, PygmalionRevertResult, PygmalionSessionOperation, PygmalionSourceRef, PygmalionSourceRefs, PygmalionVisualOperation, PygmalionVisualRevertOperation, } from './editor/projectRuntime.js';
+export { SourceRefControl } from './ui/SourceRefControl.js';
+export type { SourceRefControlProps } from './ui/SourceRefControl.js';
+export type { TokenDef } from './editor/tokens.js';
+import type { SessionPresetDef } from './editor/sessionPresets.js';
+export type { ViewportPresetDef } from './editor/viewportPresets.js';
+export type { SessionPresetDef } from './editor/sessionPresets.js';
+export { GENERIC_ASSERTION_SHARE, MIN_UNVERIFIED_REASON_LENGTH, detectStateGroupCandidates, hooksInSelector, summarizeConditionCoverage, validateHookTargeting, validateScreenConformance, } from './editor/screenConformance.js';
+export type { ConditionCoverageRoute, ConditionCoverageScreen, ConformanceScreen, HookTargetingFinding, HookTargetingInput, HookTargetingKind, ScreenConformanceFinding, ScreenConformanceKind, StateGroupFinding, StateGroupScreen, } from './editor/screenConformance.js';
+export type { PreviewEnvironmentControlDef, PreviewEnvironmentControlOptionDef, } from './editor/previewEnvironmentControls.js';
+export { createDesignImportController, createDesignScreenCollection, DESIGN_IMPORT_KINDS, expandDesignScreenCasesViewports, expandDesignScreenCollectionViewports, mergeScreenPresets, } from './editor/designImport.js';
+export type { CreateDesignImportOptions, DesignBehaviorScenario, DesignImportAsset, DesignImportCollection, DesignImportController, DesignImportCoverage, DesignImportCoverageItem, DesignImportInitialPage, DesignImportKind, DesignImportManifest, DesignImportPage, DesignFrameHeightMode, DesignFrameSizeMode, DesignScenarioCoverage, DesignScenarioSource, DesignScreenCase, DesignScreenAssertion, DesignScreenAssertionReport, DesignScreenAssertionVisibility, DesignScreenAttributeAssertion, DesignScreenCaptureFailure, DesignScreenCaptureFailureCode, DesignScreenCaptureFailureStage, DesignScreenCaptureDefaults, DesignScreenCaptureRequirements, DesignScreenCaptureReport, DesignScreenCaptureSpec, DesignScreenCollectionResult, DesignScreenDesiredState, DesignScreenDesiredStateExecutor, DesignScreenDesiredStateRequest, DesignScreenInteraction, DesignScreenInteractionAction, DesignScreenInteractionRunOptions, DesignScreenInteractionReport, DesignScreenPreset, DesignScreenPresetContext, DesignScreenPresetExecutionResult, DesignScreenPresetExecutor, DesignScreenPresetRequest, DesignScreenViewport, DesignScreenViewportExpansionOptions, DesignScreenViewportPagePatch, DesignSerializable, StoryboardEnvironment, StoryboardMediaDevice, StoryboardMediaFailure, StoryboardNetwork, StoryboardPermissionState, StoryboardRequestCondition, StoryboardRequestOutcome, } from './editor/designImport.js';
+export type { DomImportDiagnostic, DomImportMetrics, DomImportOptions, DomImportResult, } from './editor/domImport.js';
+export type { SharedSourceEditScope, SharedSourceFrameSummary, SharedSourceImpact, } from './editor/sharedSource.js';
+export type { NodeJSON } from './editor/store.js';
 export interface InitialPageDef extends DesignImportInitialPage {
 }
 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, }: {
@@ -272,10 +268,10 @@ export declare function PygmalionEditor({ runtime, registry, tokens, initialPage
     screenCards?: readonly ScreenCardDef[];
     /**
      * How many frames may render the running application instead of their
-     * capture. Default 0 — every frame is served from its capture, which is
-     * what keeps a canvas deterministic and quiet. Raise it to keep the
-     * frames a designer is working with interactive; the least recently
-     * activated holder gives its slot back.
+     * capture. Defaults to 3: the active frame and the two nearest the
+     * viewport run live; everything else is served from its capture, which is
+     * what keeps a canvas deterministic and quiet. Pass 0 for a capture-only
+     * canvas. The least recently activated holder gives its slot back.
      */
     liveScreenBudget?: number;
     /**

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

@@ -1,4 +1,4 @@
-import type { DesignImportAsset, DesignImportKind } from '../editor/designImport';
+import type { DesignImportAsset, DesignImportKind } from '../editor/designImport.js';
 export interface CatalogAssetGroup {
     section: string;
     assets: readonly DesignImportAsset[];

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

@@ -1,4 +1,4 @@
-import { type DesignCodegenProjectManifest, type DesignCodegenValidator } from '../editor/designCompiler';
+import { type DesignCodegenProjectManifest, type DesignCodegenValidator } from '../editor/designCompiler.js';
 export declare const CodePanel: import("react").FunctionComponent<{
     codegenProject?: DesignCodegenProjectManifest;
     codegenValidator?: DesignCodegenValidator;

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

@@ -1,11 +1,13 @@
 import { type ReactNode } from 'react';
-import { sourceWritableRegistryProps } from '../editor/componentInstances';
-import type { RegistryEntry, RegistryPropValue } from '../editor/registry';
-import type { NodeModel, PageModel } from '../editor/store';
+import { sourceWritableRegistryProps } from '../editor/componentInstances.js';
+import type { RegistryEntry, RegistryPropValue } from '../editor/registry.js';
+import type { NodeModel, PageModel } from '../editor/store.js';
 /** Property-panel section frame shared across the shell panels. */
-export declare function Sec({ title, description, action, children, }: {
+export declare function Sec({ title, description, hint, action, children, }: {
     title: string;
     description?: ReactNode;
+    /** One sentence for the title's tooltip, where help text goes instead of a paragraph. */
+    hint?: string;
     action?: ReactNode;
     children: ReactNode;
 }): import("react").JSX.Element;
@@ -25,30 +27,6 @@ export declare function ComponentPropControls({ node, entry, sourceWritableProps
     propBadges?: Readonly<Record<string, readonly string[]>>;
     onPatch: (prop: string, value: RegistryPropValue) => void;
 }): import("react").JSX.Element;
-/**
- * State variants of the active screen — a modal that may cover it, a
- * permission badge, an alternate panel layout. They live as sibling frames
- * (each is its own verified capture), but the designer flips between them
- * here instead of hunting the canvas; selection activates the sibling and
- * swaps it into the group's canvas slot.
- *
- * A pair of base + one declared branch reads as an On/Off toggle; larger
- * groups list their states as a radio. `stateKind` tags the control with the
- * branch's category when the host declares one.
- */
-export declare const FrameScreenStates: import("react").FunctionComponent<{
-    page: PageModel;
-}>;
-/**
- * QA scenarios the active screen verifies, as executable rows: clicking a
- * claim reproduces the exact reviewed state (frame activation, state reveal,
- * prop flip, or preset resize). The ledger is host-declared and core-
- * validated, so a renamed component or retired preset fails the gate instead
- * of silently orphaning the scenario.
- */
-export declare const FrameScenarioCoverage: import("react").FunctionComponent<{
-    page: PageModel;
-}>;
 /**
  * Curated per-screen dimension controls — "swap this piece's state". The
  * host declares the pieces (status bar states, row badge kinds); the
@@ -83,31 +61,7 @@ export declare const FrameCardBadges: import("react").FunctionComponent<{
     page: PageModel;
 }>;
 /** Keeps live input visible beside saved states without competing with them. */
-export declare function FrameLiveInteractionStatus({ pageId }: {
+export declare const FrameLiveInteractionStatus: import("react").FunctionComponent<{
     pageId: string;
-}): import("react").JSX.Element;
-/** Same-frame states, separated by the mechanism that reproduces them. */
-export declare const FrameInteractiveStates: import("react").FunctionComponent<{
-    page: PageModel;
-}>;
-/** Animation playback is a preview tool, not a saved interaction axis. */
-export declare const FrameMotionControls: import("react").FunctionComponent<{
-    page: PageModel;
-}>;
-/**
- * Surfaces this frame owes an answer to.
- *
- * The axes above are what the host remembered to declare, and for a long time
- * that was the whole story: an element nobody thought about produced no axis and
- * no complaint, because the ledger only ever compared declarations with each
- * other. This section is the other half — the editor lists the operable elements
- * of the tree it imported and the requests the frame made while booting, and the
- * host either points each one at a declaration or excludes it with a reason.
- *
- * It renders nothing once every surface has a verdict, so a finished frame stays
- * quiet and an unfinished one says exactly what is missing.
- */
-export declare const FrameSurfaceDemands: import("react").FunctionComponent<{
-    page: PageModel;
 }>;
 export { sourceWritableRegistryProps };

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

@@ -0,0 +1,17 @@
+import { type PageModel } from '../editor/store.js';
+export declare function FrameControlGroupHeading({ group, title, description, }: {
+    group: string;
+    title: string;
+    description: string;
+}): import("react").JSX.Element;
+export declare function FrameReadOnlyOverview({ page }: {
+    page: PageModel;
+}): import("react").JSX.Element;
+export type FrameFlow = 'free' | 'vertical' | 'horizontal' | 'grid';
+export declare function frameFlowOf(page: PageModel): FrameFlow;
+export declare function FrameFlowGlyph({ mode }: {
+    mode: FrameFlow;
+}): import("react").JSX.Element;
+export declare const FrameObjectPanel: import("react").FunctionComponent<{
+    page: PageModel;
+}>;

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

@@ -0,0 +1,28 @@
+import type { PageModel } from '../editor/store.js';
+/**
+ * QA scenarios the active screen verifies, as executable rows: clicking a
+ * claim reproduces the exact reviewed state (frame activation, state reveal,
+ * prop flip, or preset resize). The ledger is host-declared and core-
+ * validated, so a renamed component or retired preset fails the gate instead
+ * of silently orphaning the scenario.
+ */
+export declare const FrameScenarioCoverage: import("react").FunctionComponent<{
+    page: PageModel;
+}>;
+/**
+ * Surfaces this frame owes an answer to.
+ *
+ * The declared axes are what the host remembered to declare, and for a long
+ * time that was the whole story: an element nobody thought about produced no
+ * axis and no complaint, because the ledger only ever compared declarations
+ * with each other. This section is the other half — the editor lists the
+ * operable elements of the tree it imported and the requests the frame made
+ * while booting, and the host either points each one at a declaration or
+ * excludes it with a reason.
+ *
+ * It renders nothing once every surface has a verdict, so a finished frame stays
+ * quiet and an unfinished one says exactly what is missing.
+ */
+export declare const FrameSurfaceDemands: import("react").FunctionComponent<{
+    page: PageModel;
+}>;

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

@@ -1,4 +1,4 @@
-import { type DesignImportAsset, type DesignImportKind } from '../editor/designImport';
+import type { DesignImportAsset, DesignImportKind } from '../editor/designImport.js';
 export declare const LayerTree: import("react").FunctionComponent<{
     /**
      * Which half of the panel to draw. 'story' answers where am I going — the