@pygmalionjs/pygmalion 0.2.38 → 0.2.39

package/node/route-dependency-digest.mjs

@@ -0,0 +1,62 @@
+function normalizedRoutePath(value) {
+  if (typeof value !== 'string' || !value.trim()) return null;
+  try {
+    const pathname = new URL(value.trim(), 'http://pygmalion.invalid').pathname;
+    return `/${pathname.split('/').filter(Boolean).join('/')}`;
+  } catch {
+    return null;
+  }
+}
+
+function matches(pattern, route) {
+  for (let index = 0; index < pattern.length; index += 1) {
+    const segment = pattern[index];
+    if (segment === '*' || (segment.startsWith(':') && segment.endsWith('*'))) {
+      return true;
+    }
+    if (route[index] == null) return false;
+    if (!segment.startsWith(':') && segment !== route[index]) return false;
+  }
+  return route.length === pattern.length;
+}
+
+/** Resolves a concrete route against exact, `:param`, and `*` manifest paths. */
+export function resolvePreviewRouteDependencyDigest(route, entries) {
+  const normalized = normalizedRoutePath(route);
+  if (!normalized || !Array.isArray(entries)) return undefined;
+  const routeSegments = normalized.split('/').filter(Boolean);
+  const candidates = [];
+  for (const [order, entry] of entries.entries()) {
+    if (
+      typeof entry?.path !== 'string' ||
+      typeof entry?.dependencyDigest !== 'string' ||
+      !entry.dependencyDigest
+    ) {
+      continue;
+    }
+    const pattern = normalizedRoutePath(entry.path);
+    if (!pattern) continue;
+    if (pattern === normalized) return entry.dependencyDigest;
+    const segments = pattern.split('/').filter(Boolean);
+    if (!matches(segments, routeSegments)) continue;
+    candidates.push({
+      digest: entry.dependencyDigest,
+      literalCount: segments.filter(
+        (segment) => !segment.startsWith(':') && segment !== '*',
+      ).length,
+      wildcardCount: segments.filter(
+        (segment) => segment === '*' || segment.endsWith('*'),
+      ).length,
+      length: segments.length,
+      order,
+    });
+  }
+  candidates.sort(
+    (left, right) =>
+      right.literalCount - left.literalCount ||
+      left.wildcardCount - right.wildcardCount ||
+      right.length - left.length ||
+      right.order - left.order,
+  );
+  return candidates[0]?.digest;
+}

package/node/route-preview-artifact-v3.mjs

@@ -626,7 +626,7 @@ function withFrames(bundle, frames) {
  * requested one. Requests without a fingerprint accept whatever is stored, which
  * keeps the whole-bundle callers of earlier versions working.
  */
-export function selectRoutePreviewArtifactFrames(bundle, wanted) {
+export function selectRoutePreviewArtifactFrames(bundle, wanted, options = {}) {
   if (!isPlainRecord(bundle) || !isPlainRecord(bundle.frames)) {
     throw new TypeError('Route preview artifact is invalid.');
   }
@@ -649,6 +649,7 @@ export function selectRoutePreviewArtifactFrames(bundle, wanted) {
     const fingerprint = isPlainRecord(request) ? request.fingerprint : undefined;
     if (fingerprint != null && frame.fingerprint !== fingerprint) {
       stale.push(id);
+      if (options.includeStale === true) frames[id] = frame;
       continue;
     }
     frames[id] = frame;

package/node/storyboard.mjs

@@ -42,9 +42,11 @@ export {
 export {
   ROUTE_PREVIEW_ARTIFACT_V3_LIMITS,
   createRoutePreviewArtifactV3,
+  mergeRoutePreviewArtifactV3,
   reconstructRoutePreviewArtifactScreenshotV3,
   reconstructRoutePreviewArtifactSnapshotV3,
   reconstructRoutePreviewArtifactSnapshotsV3,
+  selectRoutePreviewArtifactFrames,
   validateRoutePreviewArtifactBundle,
   validateRoutePreviewArtifactV3,
 } from './route-preview-artifact-v3.mjs';

package/node/vite.mjs

@@ -55,12 +55,15 @@ import {
 import {
   ROUTE_PREVIEW_ARTIFACT_V3_LIMITS,
   createRoutePreviewArtifactV3,
+  mergeRoutePreviewArtifactV3,
   reconstructRoutePreviewArtifactScreenshotV3,
   reconstructRoutePreviewArtifactSnapshotV3,
   reconstructRoutePreviewArtifactSnapshotsV3,
+  selectRoutePreviewArtifactFrames,
   validateRoutePreviewArtifactBundle,
   validateRoutePreviewArtifactV3,
 } from './route-preview-artifact-v3.mjs';
+import { resolvePreviewRouteDependencyDigest } from './route-dependency-digest.mjs';
 import {
   DEFAULT_PYGMALION_PREVIEW_ARTIFACT_FILE,
   PYGMALION_PREVIEW_ARTIFACT_ENDPOINT,
@@ -366,9 +369,12 @@ export {
   validateRoutePreviewArtifactV2,
   ROUTE_PREVIEW_ARTIFACT_V3_LIMITS,
   createRoutePreviewArtifactV3,
+  mergeRoutePreviewArtifactV3,
   reconstructRoutePreviewArtifactScreenshotV3,
   reconstructRoutePreviewArtifactSnapshotV3,
   reconstructRoutePreviewArtifactSnapshotsV3,
+  selectRoutePreviewArtifactFrames,
+  resolvePreviewRouteDependencyDigest,
   validateRoutePreviewArtifactBundle,
   validateRoutePreviewArtifactV3,
   DEFAULT_PYGMALION_PREVIEW_ARTIFACT_FILE,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pygmalionjs/pygmalion",
-  "version": "0.2.38",
+  "version": "0.2.39",
   "description": "Code-backed DOM design sandbox and visual QA editor",
   "license": "UNLICENSED",
   "publishConfig": {
@@ -37,9 +37,12 @@
     "node/dev-view.vite.mjs",
     "node/inspect-plugin.mjs",
     "node/preview-artifact-plugin.mjs",
+    "node/preview-artifact-store.mjs",
+    "node/preview-vite-cache.mjs",
     "node/qa-capture-plugin.mjs",
     "node/route-preview-artifact-v2.mjs",
     "node/route-preview-artifact-v3.mjs",
+    "node/route-dependency-digest.mjs",
     "node/source-revision.mjs",
     "node/source-diff.mjs",
     "node/source-graph.mjs",

package/storyboard.d.ts

@@ -318,6 +318,7 @@ export interface RoutePreviewArtifactFrameRequest {
 export declare function selectRoutePreviewArtifactFrames(
   bundle: unknown,
   wanted: readonly (RoutePreviewArtifactFrameRequest | string)[],
+  options?: { includeStale?: boolean },
 ): {
   bundle: RoutePreviewArtifactBundleV3;
   missing: string[];

package/vite.d.ts

@@ -76,6 +76,7 @@ export interface PygmalionPreviewConfig {
   generateArtifact?: (request: {
     namespace: string;
     sourceRevision: string;
+    frames?: readonly { id: string; fingerprint?: string }[];
     captureBaseUrl?: string;
   }) => unknown | Promise<unknown>;
 }
@@ -158,8 +159,15 @@ export declare function pygmalionPreviewArtifactPlugin(options?: {
   generateArtifact?: (request: {
     namespace: string;
     sourceRevision: string;
+    frames?: readonly { id: string; fingerprint?: string }[];
     captureBaseUrl?: string;
   }) => unknown | Promise<unknown>;
+  acquireLease?: (
+    reason: string,
+  ) =>
+    | { release(): void | Promise<void> }
+    | null
+    | Promise<{ release(): void | Promise<void> } | null>;
 }): PluginOption;
 export interface PygmalionGitSourceState {
   commit: string;
@@ -511,6 +519,10 @@ export {
   validateRoutePreviewArtifactBundle,
   validateRoutePreviewArtifactV3,
 } from './storyboard';
+export declare function resolvePreviewRouteDependencyDigest(
+  route: string,
+  entries: readonly { path?: string; dependencyDigest?: string }[],
+): string | undefined;
 export type {
   RoutePreviewArtifactBundleV3,
   RoutePreviewArtifactFrameRequest,