@pygmalionjs/pygmalion 0.6.31 → 0.6.32

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-D9J35QsM.js";
+import { F as s, N as a, e as r, s as i, a as t } from "./FrozenRoutePreview-BwkyYvUV.js";
 export {
   s as FrozenRoutePreviewView,
   a as NodeModel,

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

@@ -323,6 +323,12 @@ interface CanvasLayoutSnapshotV5 {
     sections: SectionRect[];
 }
 export declare const CANVAS_LAYOUT_VERSION = 5;
+export declare const ACTIVE_FRAME_STORAGE_VERSION = 1;
+interface ActiveFrameSnapshotV1 {
+    version: typeof ACTIVE_FRAME_STORAGE_VERSION;
+    frameId: string;
+}
+export declare function isActiveFrameSnapshot(value: unknown): value is ActiveFrameSnapshotV1;
 export declare function isCanvasLayoutSnapshot(value: unknown, scope: string): value is CanvasLayoutSnapshotV5;
 export type CanvasObjectSelection = {
     kind: 'frame';
@@ -457,6 +463,9 @@ export declare class EditorStore {
     private canvasLayoutScope;
     private canvasLayoutStorageKey;
     private canvasLayoutDisposer;
+    /** Same-tab reload restoration keyed by a host-provided workspace identity. */
+    private activeFrameStorageKey;
+    private activeFrameDisposer;
     /** 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. */
@@ -612,6 +621,15 @@ export declare class EditorStore {
    * Embeds without source revision do not enable persistence because projects cannot be safely distinguished.
    */
     private startCanvasLayoutPersistence;
+    /**
+     * Restores the last deliberately viewed frame after a same-tab reload.
+     *
+     * Internal page ids are allocation-order values (`p42`) and cannot survive a
+     * reload. The snapshot therefore stores the host's canonical import id, with
+     * route/path/name only as fallbacks for smaller embeds. Missing, malformed,
+     * or stale snapshots leave the configured initial frame in place.
+     */
+    configureActiveFramePersistence(scope: string | undefined): void;
     /** Called once when a direct-manipulation gesture starts. Subsequent pointer updates skip history. */
     beginFrameTransform(id: string, kind: 'move' | 'resize'): boolean;
     moveFrame(id: string, x: number, y: number, recordHistory?: boolean): void;

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

@@ -283,12 +283,19 @@ export declare function pygmalionOpenPreview(): void;
 export declare function pygmalionResetCurrentEdits(): boolean;
 export interface InitialPageDef extends DesignImportInitialPage {
 }
-export declare function PygmalionEditor({ registry, tokens, initialPages, initialCanvas, 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, 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[];
     /** Canvas shown on first mount. Useful when an earlier catalog canvas is expensive to render. */
     initialCanvas?: string;
+    /**
+     * Stable host/workspace identity used to restore the last active frame after
+     * a same-tab reload. Pygmalion namespaces and hashes this value before using
+     * sessionStorage; canonical `importPageId` values are stored, never transient
+     * internal page ids.
+     */
+    activeFramePersistenceKey?: string;
     /**
      * Mode the editor opens in. Defaults to 'edit'. A host whose editor is a
      * review surface declares 'view-only' so a reader is not one keystroke from

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pygmalionjs/pygmalion",
-  "version": "0.6.31",
+  "version": "0.6.32",
   "description": "Code-backed DOM design sandbox and visual QA editor",
   "license": "UNLICENSED",
   "publishConfig": {