@pygmalionjs/pygmalion 0.2.31 → 0.2.33

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

package/package.json

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

package/types.d.ts

@@ -835,6 +835,8 @@ export interface PreviewArtifactTransportRequest extends PreviewArtifactExpectat
   captureBaseUrl?: string;
   /** Frames to fetch. Omitted asks for the whole bundle, as earlier versions did. */
   frames?: readonly PreviewArtifactFrameRequest[];
+  /** Set false to seed only what exists instead of capturing what is absent. */
+  generate?: boolean;
 }
 
 export type PreviewArtifactTransport = (
@@ -843,6 +845,8 @@ export type PreviewArtifactTransport = (
 
 export interface PreviewArtifactHttpResponse {
   readonly ok: boolean;
+  readonly status?: number;
+  readonly statusText?: string;
   json(): Promise<unknown>;
 }
 
@@ -865,6 +869,12 @@ export interface PreviewArtifactHttpTransportOptions {
 export type PreviewArtifactValidationReason =
   'invalid-bundle' | 'namespace-mismatch' | 'revision-mismatch';
 
+export interface PreviewArtifactFrameResolution {
+  exact: readonly string[];
+  missing: readonly string[];
+  stale: readonly string[];
+}
+
 export type PreviewArtifactValidationResult =
   | {
       valid: true;
@@ -882,6 +892,7 @@ export type PreviewArtifactBootstrapResult =
   | {
       status: 'accepted';
       artifact: RoutePreviewArtifactBundle;
+      frameResolution?: PreviewArtifactFrameResolution;
     }
   | {
       status: 'unavailable';
@@ -914,11 +925,19 @@ export declare function createPreviewArtifactHttpTransport(
 export declare function validatePreviewArtifactBundle(
   value: unknown,
   expectation?: PreviewArtifactExpectation,
+  options?: { perFrameIdentity?: boolean },
 ): PreviewArtifactValidationResult;
+export declare function resolvePreviewArtifactFrames(
+  artifact: RoutePreviewArtifactBundle,
+  expectation: PreviewArtifactExpectation,
+  frames: readonly PreviewArtifactFrameRequest[],
+): PreviewArtifactFrameResolution;
 export declare function bootstrapPreviewArtifact(
   options: PreviewArtifactExpectation & {
     transport: PreviewArtifactTransport;
     signal?: AbortSignal;
+    frames?: readonly PreviewArtifactFrameRequest[];
+    generate?: boolean;
   },
 ): Promise<PreviewArtifactBootstrapResult>;
 
@@ -1664,7 +1683,7 @@ export declare function PygmalionEditor(props: {
   previewCacheNamespace?: string;
   /** A canonical screen snapshot created during build. When the namespace matches, it is injected into the cache before the first render. */
   previewArtifacts?: RoutePreviewArtifactBundle;
-  /** Same-origin endpoint that resolves an exact namespace and source revision. */
+  /** Same-origin endpoint that resolves an exact namespace and source revision. Stale embedded previews remain visibly last-known until this endpoint returns an exact frame. */
   previewArtifactEndpoint?: string;
   /** Number of actual app previews to run simultaneously. Defaults to an adaptive 12–32 lanes. */
   previewConcurrency?: number;