@dfosco/storyboard-core 2.1.0 → 2.2.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dfosco/storyboard-core",
-  "version": "2.1.0",
+  "version": "2.2.0",
   "type": "module",
   "license": "MIT",
   "repository": {

package/src/devtools.js

@@ -181,7 +181,8 @@ const CHECK_ICON = '<svg viewBox="0 0 16 16"><path d="M13.78 4.22a.75.75 0 0 1 0
 const ZAP_ICON = '<svg viewBox="0 0 16 16"><path d="M9.504.43a1.516 1.516 0 0 1 2.437 1.713L10.415 5.5h2.123c1.57 0 2.346 1.909 1.22 3.004l-7.34 7.142a1.249 1.249 0 0 1-.871.354h-.302a1.25 1.25 0 0 1-1.157-1.723L5.633 10.5H3.462c-1.57 0-2.346-1.909-1.22-3.004Z"/></svg>'
 
 function getFlowName() {
-  return new URLSearchParams(window.location.search).get('scene') || 'default'
+  const p = new URLSearchParams(window.location.search)
+  return p.get('flow') || p.get('scene') || 'default'
 }
 
 /**

package/src/sceneDebug.js

@@ -56,13 +56,14 @@ let stylesInjected = false
  * Mount a flow debug panel into the DOM.
  *
  * @param {HTMLElement} [container=document.body] - Where to mount
- * @param {string} [flowName] - Flow name override (defaults to ?scene= param or "default")
+ * @param {string} [flowName] - Flow name override (defaults to ?flow= param or "default")
  * @returns {HTMLElement} The created debug element
  */
 export function mountFlowDebug(container, flowName) {
   const target = container || document.body
+  const sp = new URLSearchParams(window.location.search)
   const activeFlowName = flowName
-    || new URLSearchParams(window.location.search).get('scene')
+    || sp.get('flow') || sp.get('scene')
     || 'default'
 
   // Inject styles once

package/src/viewfinder.js

@@ -22,13 +22,13 @@ export function hash(str) {
  *
  * @param {string} flowName
  * @param {string[]} knownRoutes - Array of route names (e.g. ["Dashboard", "Repositories"])
- * @returns {string} Full path with ?scene= param
+ * @returns {string} Full path with ?flow= param
  */
 export function resolveFlowRoute(flowName, knownRoutes = []) {
   // Case-insensitive match against known routes
   for (const route of knownRoutes) {
     if (route.toLowerCase() === flowName.toLowerCase()) {
-      // Flow name matches the route — no ?scene= needed,
+      // Flow name matches the route — no ?flow= needed,
       // StoryboardProvider auto-matches by page name
       return `/${route}`
     }
@@ -40,13 +40,13 @@ export function resolveFlowRoute(flowName, knownRoutes = []) {
     const route = data?.route || data?.meta?.route || data?.flowMeta?.route || data?.sceneMeta?.route
     if (route) {
       const normalized = route.startsWith('/') ? route : `/${route}`
-      return `${normalized}?scene=${encodeURIComponent(flowName)}`
+      return `${normalized}?flow=${encodeURIComponent(flowName)}`
     }
   } catch {
     // ignore load errors
   }
 
-  return `/?scene=${encodeURIComponent(flowName)}`
+  return `/?flow=${encodeURIComponent(flowName)}`
 }
 
 /** @deprecated Use resolveFlowRoute() */

package/src/viewfinder.test.js

@@ -53,31 +53,31 @@ describe('resolveFlowRoute', () => {
   })
 
   it('uses route key from flow data when no route matches', () => {
-    expect(resolveFlowRoute('custom-route', routes)).toBe('/Overview?scene=custom-route')
+    expect(resolveFlowRoute('custom-route', routes)).toBe('/Overview?flow=custom-route')
   })
 
   it('handles absolute route key (with leading slash)', () => {
-    expect(resolveFlowRoute('absolute-route', routes)).toBe('/Forms?scene=absolute-route')
+    expect(resolveFlowRoute('absolute-route', routes)).toBe('/Forms?flow=absolute-route')
   })
 
   it('falls back to root when no match and no route key', () => {
-    expect(resolveFlowRoute('no-route', routes)).toBe('/?scene=no-route')
+    expect(resolveFlowRoute('no-route', routes)).toBe('/?flow=no-route')
   })
 
   it('falls back to root for default flow', () => {
-    expect(resolveFlowRoute('default', routes)).toBe('/?scene=default')
+    expect(resolveFlowRoute('default', routes)).toBe('/?flow=default')
   })
 
   it('falls back to root when flow does not exist', () => {
-    expect(resolveFlowRoute('nonexistent', routes)).toBe('/?scene=nonexistent')
+    expect(resolveFlowRoute('nonexistent', routes)).toBe('/?flow=nonexistent')
   })
 
   it('works with empty routes array', () => {
-    expect(resolveFlowRoute('Dashboard', [])).toBe('/?scene=Dashboard')
+    expect(resolveFlowRoute('Dashboard', [])).toBe('/?flow=Dashboard')
   })
 
   it('works with no routes argument', () => {
-    expect(resolveFlowRoute('custom-route')).toBe('/Overview?scene=custom-route')
+    expect(resolveFlowRoute('custom-route')).toBe('/Overview?flow=custom-route')
   })
 
   it('encodes special characters in flow name', () => {
@@ -86,15 +86,15 @@ describe('resolveFlowRoute', () => {
       objects: {},
       records: {},
     })
-    expect(resolveFlowRoute('has spaces', [])).toBe('/?scene=has%20spaces')
+    expect(resolveFlowRoute('has spaces', [])).toBe('/?flow=has%20spaces')
   })
 
   it('uses flowMeta.route when no route matches', () => {
-    expect(resolveFlowRoute('meta-route', routes)).toBe('/Repositories?scene=meta-route')
+    expect(resolveFlowRoute('meta-route', routes)).toBe('/Repositories?flow=meta-route')
   })
 
   it('uses flowMeta.route with absolute path', () => {
-    expect(resolveFlowRoute('meta-both', routes)).toBe('/Overview?scene=meta-both')
+    expect(resolveFlowRoute('meta-both', routes)).toBe('/Overview?flow=meta-both')
   })
 
   it('prefers top-level route over flowMeta.route', () => {
@@ -103,7 +103,7 @@ describe('resolveFlowRoute', () => {
       objects: {},
       records: {},
     })
-    expect(resolveFlowRoute('conflict', [])).toBe('/Forms?scene=conflict')
+    expect(resolveFlowRoute('conflict', [])).toBe('/Forms?flow=conflict')
   })
 })