@pygmalionjs/pygmalion 0.5.22 → 0.5.25

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

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

@@ -0,0 +1,46 @@
+import type { StoryboardEnvironment } from './designImport';
+/**
+ * One runtime the whole catalog can be seen under.
+ *
+ * Some products are not one product. The same build runs embedded in a host
+ * application and on its own, and the difference is not a state inside a screen
+ * — it decides which screens exist and what each one is allowed to show. A host
+ * that declared such a runtime had nowhere to put it: an axis belongs to a
+ * frame, and a preview control only dresses the live preview, so the catalog
+ * could only ever be captured under whichever runtime happened to be the
+ * default. The other one was invisible.
+ *
+ * A session preset is that choice, made once for everything. Selecting one
+ * rewrites the storyboard baseline, which every frame's identity already folds
+ * in, so the catalog re-resolves under the new runtime instead of showing
+ * frames captured under the old one.
+ */
+export interface SessionPresetDef {
+    /** Button text. The panel column is narrow, so keep it short. */
+    label: string;
+    /**
+     * The runtime, as boot conditions. Merged UNDER each frame's own declared
+     * environment: a screen that states a condition outright keeps it.
+     */
+    environment?: StoryboardEnvironment;
+    /** Tooltip text. */
+    description?: string;
+}
+/**
+ * Declares the preset list. A malformed entry throws here rather than producing
+ * a button that silently captures the catalog under nothing — the host
+ * configures this once at mount.
+ */
+export declare function setSessionPresets(next: readonly SessionPresetDef[]): void;
+export declare function getSessionPresets(): SessionPresetDef[];
+export declare function getSelectedSessionPreset(): number | null;
+/**
+ * Puts the catalog under one preset, or back under the product's default.
+ *
+ * The baseline is what every frame's identity is derived from, so changing it
+ * is what makes the catalog re-resolve rather than keep showing what was
+ * captured under the previous runtime — setting it already retires the frames
+ * held from the runtime before.
+ */
+export declare function selectSessionPreset(index: number | null): void;
+export declare function subscribeSessionPresets(listener: () => void): () => void;

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

@@ -78,7 +78,10 @@ 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 { 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';
@@ -205,7 +208,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, 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, interactiveStates, surfaceClassifications, onApply, onDesignChange, onInspectApply, onInspectPreview, onInspectImpact, storyboard, 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, interactiveStates, surfaceClassifications, onApply, onDesignChange, onInspectApply, onInspectPreview, onInspectImpact, storyboard, storyboardDiscovery, storyboardDiscoveryEndpoint, }: {
     registry?: ComponentRegistry;
     tokens?: TokenDef[];
     initialPages?: InitialPageDef[];
@@ -222,6 +225,12 @@ export declare function PygmalionEditor({ registry, tokens, initialPages, initia
     componentConnections?: readonly DesignComponentConnectionDef[];
     /** Named frame widths the application supports — rendered as one-click buttons beside the W/H boxes. */
     viewportPresets?: readonly ViewportPresetDef[];
+    /**
+     * Runtimes the whole catalog can be seen under — an embedded host build and a
+     * standalone one, for instance. Unlike an axis, which belongs to a frame,
+     * choosing one re-resolves every frame: it decides which screens exist.
+     */
+    sessionPresets?: readonly SessionPresetDef[];
     /** Host-declared browser conditions shown in the active frame's Preview inspector. */
     previewEnvironmentControls?: readonly PreviewEnvironmentControlDef[];
     /** A public importer that provides unified control over code inventory and importing of entire DOM layers. */

package/package.json

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