@pygmalionjs/pygmalion 0.2.39 → 0.2.41

package/README.md

@@ -178,6 +178,13 @@ Omit `height` to change width alone and leave the frame's height as it is. The
 button reads as active while the frame sits at that size, and **Reset to default
 size** still returns the frame to the viewport its manifest authored.
 
+If the first declared canvas is a large asset catalog, open the working canvas
+directly and avoid rendering that catalog during startup:
+
+```tsx
+<PygmalionEditor initialCanvas="Screens" />
+```
+
 ### Screens that never stop moving
 
 A capture waits for the document to hold still. A screen with an elapsed clock, a
@@ -217,6 +224,38 @@ Screen recipes support `click`, `fill`, `check`, `press`, `wait`, and `storage`
 steps. Use deterministic recipes and assertions so each frame represents a
 repeatable application state.
 
+Keep user journeys explicit instead of relying only on source navigation
+inference. Paths expand into adjacent graph edges, and source-discovered edges
+are still merged underneath them:
+
+```tsx
+const storyboard = {
+  startScreenIds: ['screen:entry'],
+  paths: [
+    {
+      id: 'checkout',
+      label: 'Checkout',
+      screenIds: ['screen:entry', 'screen:cart', 'screen:confirmation'],
+    },
+  ],
+};
+
+<PygmalionEditor storyboard={storyboard} />
+```
+
+Every id is checked against the resolved screen catalog. Unknown endpoints and
+unreachable screens stay visible as graph diagnostics instead of disappearing
+from the sidebar. Code-only redirects or fixtures can be classified through
+`nonVisualScenarioIds` with ids created by
+`createStoryboardRouteScenarioId(route)`.
+
+The editor shell and frame geometry mount before storyboard discovery finishes.
+Cached or live route content remains gated until baseline environment and source
+digests settle, so immediate canvas paint cannot consume a provisional preview
+identity. Selecting an already visible frame in the sidebar preserves the
+camera; an offscreen frame is revealed with the smallest pan possible and never
+changes the user's zoom.
+
 ## Capture artifact lifecycle
 
 Import the reusable capture primitives from