@pygmalionjs/pygmalion 0.2.40 → 0.2.41

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

package/node/storyboard-environment.mjs

@@ -29,6 +29,31 @@ const MAX_SOURCE_BYTES = 1024 * 1024;
 const MAX_ENVIRONMENT_BYTES = 16 * 1024;
 const MAX_EXECUTION_RESULTS_BYTES = 64 * 1024 * 1024;
 
+function normalizeRoutePath(value) {
+  if (typeof value !== 'string' || !value.trim()) return null;
+  const pathname = value.trim().split(/[?#]/, 1)[0].replace(/\/{2,}/g, '/');
+  const rooted = pathname.startsWith('/') ? pathname : `/${pathname}`;
+  return rooted.length > 1 ? rooted.replace(/\/+$/, '') : rooted;
+}
+
+function routePatternMatches(pattern, concrete) {
+  const normalizedPattern = normalizeRoutePath(pattern);
+  const normalizedConcrete = normalizeRoutePath(concrete);
+  if (!normalizedPattern || !normalizedConcrete) return false;
+  const patternSegments = normalizedPattern.split('/').filter(Boolean);
+  const concreteSegments = normalizedConcrete.split('/').filter(Boolean);
+  let concreteIndex = 0;
+  for (const segment of patternSegments) {
+    if (segment === '*' || segment.startsWith('*')) return true;
+    const concreteSegment = concreteSegments[concreteIndex];
+    if (segment.endsWith('?') && concreteSegment == null) continue;
+    if (concreteSegment == null) return false;
+    if (!segment.startsWith(':') && segment !== concreteSegment) return false;
+    concreteIndex += 1;
+  }
+  return concreteIndex === concreteSegments.length;
+}
+
 function normalizedRelativePath(root, file) {
   return path.relative(root, file).split(path.sep).join('/');
 }
@@ -1151,12 +1176,14 @@ function associateRouteCandidates(manifest, graph, fileDigests = new Map()) {
     };
   });
 
-  const knownRoutes = new Set(routes.map((route) => route.path));
+  const knownRoutes = routes.map((route) => route.path);
+  const targetIsKnown = (target) =>
+    knownRoutes.some((route) => routePatternMatches(route, target));
   const uniqueEdges = [
     ...new Map(
       edges.map((edge) => [
         `${edge.from}:${edge.to}:${edge.kind}:${edge.evidence.sourcePath}:${edge.evidence.line}`,
-        { ...edge, unresolvedTarget: !knownRoutes.has(edge.to) },
+        { ...edge, unresolvedTarget: !targetIsKnown(edge.to) },
       ]),
     ).values(),
   ].sort((a, b) => a.id.localeCompare(b.id));

package/package.json

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

package/types.d.ts

@@ -1206,6 +1206,26 @@ export interface StoryboardGraphEdgeInput {
   label?: string;
 }
 
+export interface StoryboardPathInput {
+  /** Stable author-owned identity used as the edge id prefix. */
+  id: string;
+  /** Ordered screen ids visited by this path. */
+  screenIds: readonly string[];
+  kind?: string;
+  label?: string;
+}
+
+export interface StoryboardDefinition {
+  paths?: readonly StoryboardPathInput[];
+  edges?: readonly StoryboardGraphEdgeInput[];
+  startScreenIds?: readonly string[];
+  nonVisualScenarioIds?: readonly string[];
+}
+
+export declare function createStoryboardPathEdges(
+  paths: readonly StoryboardPathInput[],
+): StoryboardGraphEdgeInput[];
+
 export interface StoryboardGraphBuildOptions {
   screens: readonly DesignScreenCase[];
   assets?: readonly DesignImportAsset[];
@@ -1452,6 +1472,8 @@ export interface StoryboardDiscoveryGraphOptions {
   manifest: StoryboardDiscoveryManifest;
   pages: readonly StoryboardResolvedPage[];
   assets?: readonly DesignImportAsset[];
+  /** Host-authored user journeys layered over source-inferred transitions. */
+  storyboard?: StoryboardDefinition;
 }
 
 export interface StoryboardDiscoveryResult {
@@ -1488,6 +1510,7 @@ export declare function resolveStoryboardScreenCases(
   pages: readonly StoryboardResolvedPage[],
   manifest: StoryboardDiscoveryManifest,
 ): DesignScreenCase[];
+export declare function createStoryboardRouteScenarioId(route: string): string;
 export declare function getStoryboardDiscoveryBaselineEnvironment(
   manifest: StoryboardDiscoveryManifest,
 ): StoryboardEnvironment | undefined;
@@ -1993,6 +2016,8 @@ export declare function PygmalionEditor(props: {
   ) => Promise<InspectPreviewResult>;
   /** Check the reverse dependency closure of the changed source file. */
   onInspectImpact?: (componentFiles: string[]) => Promise<InspectImpactResult>;
+  /** Authored screen paths and starts merged with source-discovered navigation. */
+  storyboard?: StoryboardDefinition;
   /** Detect portable browser branches from source before route frames boot. Default true. */
   storyboardDiscovery?: boolean;
   /** Vite endpoint that returns the generated generic storyboard environment manifest. */