@pygmalionjs/pygmalion 0.2.18 → 0.2.20

package/storyboard.d.ts

@@ -66,6 +66,21 @@ export interface StoryboardCaptureOptions<
   contextOptions?: Record<string, unknown>;
   navigationOptions?: Record<string, unknown>;
   screenshotOptions?: Record<string, unknown>;
+  /** How long to wait for a still document, and what may keep moving. */
+  stability?: StoryboardStabilityOptions;
+}
+
+export interface StoryboardStabilityOptions {
+  /** Samples before giving up. Default 40 at 100ms, so a 4s ceiling. */
+  attempts?: number;
+  requiredStableSamples?: number;
+  intervalMs?: number;
+  minimumWaitMs?: number;
+  /**
+   * Regions that are expected to keep changing — an elapsed clock, a level
+   * meter, a marquee. Mutations confined to them do not count as churn.
+   */
+  volatileSelectors?: readonly string[];
 }
 
 export declare const STORYBOARD_CAPTURE_STATUSES: Readonly<{
@@ -132,14 +147,11 @@ export declare function assertFinalStoryboardState(
 ): Promise<void>;
 export declare function waitForStableStoryboardDocument(
   page: unknown,
-  options?: {
-    attempts?: number;
-    requiredStableSamples?: number;
-    intervalMs?: number;
-    minimumWaitMs?: number;
-  },
+  options?: StoryboardStabilityOptions,
 ): Promise<boolean>;
-export declare function storyboardDocumentStabilitySignature(): string;
+export declare function storyboardDocumentStabilitySignature(
+  volatileSelectors?: readonly string[],
+): string;
 export declare function storyboardCaptureCandidateTexts(
   element: Element,
 ): string[];

package/types.d.ts

@@ -161,6 +161,17 @@ export interface TokenDef {
   group?: string;
 }
 
+export interface ViewportPresetDef {
+  /** Button text. The panel column is narrow, so keep it to a few characters. */
+  label: string;
+  /** Frame width in CSS pixels. */
+  width: number;
+  /** Frame height. Omit to resize width only and leave the current height alone. */
+  height?: number;
+  /** Tooltip text. Defaults to the dimensions. */
+  description?: string;
+}
+
 export const DESIGN_IMPORT_KINDS: readonly [
   'icons',
   'design-tokens',
@@ -623,6 +634,12 @@ export declare function setComponentRegistry(r: ComponentRegistry): void;
 
 export declare function setTokens(t: TokenDef[]): void;
 
+/** Declares the frame widths the panel offers. A malformed entry throws at mount. */
+export declare function setViewportPresets(
+  presets: readonly ViewportPresetDef[],
+): void;
+export declare function getViewportPresets(): ViewportPresetDef[];
+
 /** Updates the standard route of the running route iframe. The existing editing status is maintained. */
 export declare function setPygmalionAppOrigin(origin: string): void;
 /** Update the static screen cache when a preview of the same URL points to a new code version. */
@@ -1620,6 +1637,8 @@ export declare function PygmalionEditor(props: {
   registry?: ComponentRegistry;
   tokens?: TokenDef[];
   initialPages?: InitialPageDef[];
+  /** Named frame widths the application supports — rendered as one-click buttons beside the W/H boxes. */
+  viewportPresets?: readonly ViewportPresetDef[];
   /** icons/tokens/atoms/components/screens Controller for getting inventory and full DOM layers. */
   designImport?: DesignImportController;
   /** Called with cumulative changes when editing asset panel tokens — Host is responsible for write-back (file saving). */