@pygmalionjs/pygmalion 0.6.22 → 0.6.23

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

@@ -349,10 +349,14 @@ export interface DesignImportInitialPage {
      */
     runtimes?: readonly string[];
     scenarioId?: string;
+    /** Every authored scenario this initial screen demonstrates. */
+    scenarioIds?: readonly string[];
     interactions?: DesignScreenInteraction[];
     environment?: StoryboardEnvironment;
     preset?: DesignScreenPreset;
     assertions?: DesignScreenAssertion[];
+    /** Warm preview group declared by the host for this complete screen state. */
+    session?: string;
 }
 export interface DesignImportCoverageItem {
     expected: number;

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

@@ -0,0 +1,15 @@
+import { type StoryboardDefinition, type StoryboardGraph } from './storyboardGraph';
+import type { DesignImportAsset, DesignImportInitialPage, DesignScenarioSource } from './designImport';
+export type AuthoredStoryboardGraphOptions = {
+    pages: readonly DesignImportInitialPage[];
+    assets?: readonly DesignImportAsset[];
+    scenarios?: readonly DesignScenarioSource[];
+    storyboard?: StoryboardDefinition;
+};
+/**
+ * Builds a graph from host-owned screen declarations when source discovery is
+ * intentionally disabled. The authored graph must not depend on a Vite
+ * discovery endpoint: a Next host, or any runtime with its own route catalog,
+ * already has the canonical frame identities and workflow paths.
+ */
+export declare function createAuthoredStoryboardGraph(options: AuthoredStoryboardGraphOptions): StoryboardGraph | null;

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

@@ -1,4 +1,4 @@
-import { type DesignImportController, type DesignImportInitialPage } from './editor/designImport';
+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';
@@ -66,6 +66,7 @@ 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, StoryboardDiscoveryFetch, StoryboardDiscoveryGraphOptions, StoryboardDiscoveryManifest, StoryboardDiscoveryResponse, StoryboardDiscoveryResult, StoryboardDiscoveryRoute, StoryboardDiscoveryScenario, StoryboardResolvedPage, } from './editor/storyboardDiscovery';
@@ -214,7 +215,7 @@ 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, 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, sessionStoryboards, storyboardDiscovery, storyboardDiscoveryEndpoint, }: {
+export declare function PygmalionEditor({ registry, tokens, initialPages, initialCanvas, initialEditMode, componentConnections, 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[];
@@ -398,6 +399,8 @@ export declare function PygmalionEditor({ registry, tokens, initialPages, initia
     onInspectImpact?: (componentFiles: string[]) => Promise<InspectImpactResult>;
     /** Authored paths, starts, and primary journey merged with discovered navigation. */
     storyboard?: StoryboardDefinition;
+    /** Code-owned scenario inventory for hosts that declare their own route catalog. */
+    storyboardScenarios?: readonly DesignScenarioSource[];
     /**
      * Runtime-specific storyboards keyed by `SessionPresetDef.id`.
      *

package/package.json

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