@dfosco/storyboard-react 4.2.0-beta.4 → 4.2.1

package/src/story/ComponentSetPage.module.css

@@ -0,0 +1,121 @@
+/* ComponentSetPage — grid layout for all exports of a story */
+
+.grid {
+  background-color: var(--bgColor-muted, #f6f8fa);
+  display: flex;
+  flex-wrap: nowrap;
+  gap: 12px;
+  padding: 12px;
+  min-height: 100vh;
+  width: max-content;
+  min-width: 100%;
+  box-sizing: border-box;
+}
+
+.grid[data-layout="horizontal"] {
+  flex-direction: row;
+}
+
+.grid[data-layout="vertical"] {
+  flex-direction: column;
+}
+
+.cell {
+  flex: 0 0 auto;
+  display: flex;
+  flex-direction: column;
+  border: 2px solid var(--borderColor-muted, #d8dee4);
+  border-radius: 2px;
+  overflow: hidden;
+  transition: border-color 120ms ease, box-shadow 120ms ease;
+  position: relative;
+  background: var(--bgColor-default, #ffffff);
+}
+
+/* In horizontal layout, each cell snaps to the widest component */
+.grid[data-layout="horizontal"] .cell {
+  min-width: var(--cell-snap-w, 200px);
+}
+
+/* In vertical layout, each cell snaps to the tallest component */
+.grid[data-layout="vertical"] .cell {
+  min-height: var(--cell-snap-h, 120px);
+  min-width: 100%;
+}
+
+.cell[data-selected] {
+  border-color: var(--fgColor-accent, #0969da);
+  box-shadow: 0 0 0 1px var(--fgColor-accent, #0969da);
+}
+
+.cellLabel {
+  all: unset;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+  padding: 6px 10px;
+  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Helvetica, Arial, sans-serif;
+  font-size: 11px;
+  font-weight: 600;
+  color: var(--fgColor-muted, #656d76);
+  background: var(--bgColor-muted, #f6f8fa);
+  border-bottom: 1px solid var(--borderColor-muted, #d8dee4);
+  cursor: pointer;
+  user-select: none;
+  transition: background 100ms ease, color 100ms ease;
+  flex-shrink: 0;
+  /* Round top corners to match cell */
+  border-radius: 6px 6px 0 0;
+}
+
+.cellLabel:hover {
+  background: var(--bgColor-neutral-muted, #eaeef2);
+  color: var(--fgColor-default, #1f2328);
+}
+
+.cellLabel[data-selected] {
+  color: var(--fgColor-accent, #0969da);
+  background: var(--bgColor-accent-muted, #ddf4ff);
+}
+
+.cellRadio {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  width: 12px;
+  height: 12px;
+  border-radius: 50%;
+  border: 2px solid var(--borderColor-accent, #d8dee4);
+  flex-shrink: 0;
+  transition: border-color 100ms ease, background 100ms ease;
+}
+
+.cellRadio[data-selected] {
+  border-color: var(--fgColor-accent, #0969da);
+  background: var(--fgColor-accent, #0969da);
+}
+
+.cellContent {
+  flex: 1;
+  overflow: visible;
+  position: relative;
+}
+
+.error {
+  display: flex;
+  flex-direction: column;
+  gap: 4px;
+  padding: 1rem;
+  color: var(--fgColor-danger, #cf222e);
+  font-size: 0.875rem;
+  line-height: 1.5;
+}
+
+.loading {
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 3rem;
+  color: var(--fgColor-muted, #656d76);
+  font-size: 0.875rem;
+}

package/src/story/StoryPage.jsx

@@ -5,12 +5,14 @@
  * When ?export=ExportName is present, renders that single export.
  * Without ?export, renders all named exports stacked.
  */
-import { useState, useEffect, useMemo } from 'react'
+import { useState, useEffect, useMemo, lazy, Suspense } from 'react'
 import { useLocation } from 'react-router-dom'
 import { getStoryData } from '@dfosco/storyboard-core'
 import { ThemeProvider, BaseStyles } from '@primer/react'
 import styles from './StoryPage.module.css'
 
+const ComponentSetPageLazy = lazy(() => import('./ComponentSetPage.jsx'))
+
 function StoryErrorFallback({ name, error }) {
   return (
     <div className={styles.error}>
@@ -25,12 +27,31 @@ export default function StoryPage({ name }) {
   const searchParams = new URLSearchParams(location.search)
   const exportFilter = searchParams.get('export')
   const isEmbed = searchParams.has('_sb_embed')
+  const isComponentSet = searchParams.has('_sb_component_set')
+
+  // When embedded as a canvas iframe, suppress HMR full-reloads.
+  // Story content updates via React Fast Refresh; a full-reload
+  // causes a visible flash and can create a reload loop when
+  // multiple story iframes are on the same canvas.
+  useEffect(() => {
+    if (!isEmbed || !import.meta.hot) return
+    const msg = { active: true }
+    import.meta.hot.send('storyboard:canvas-hmr-guard', msg)
+    const interval = setInterval(() => {
+      import.meta.hot.send('storyboard:canvas-hmr-guard', msg)
+    }, 3000)
+    return () => {
+      clearInterval(interval)
+      import.meta.hot.send('storyboard:canvas-hmr-guard', { active: false })
+    }
+  }, [isEmbed])
 
   const story = useMemo(() => getStoryData(name), [name])
   const [exports, setExports] = useState(null)
   const [error, setError] = useState(null)
 
   useEffect(() => {
+    if (isComponentSet) return
     if (!story?._storyImport) {
       Promise.resolve().then(() => setError(`Story "${name}" not found or missing import`))
       return
@@ -55,7 +76,7 @@ export default function StoryPage({ name }) {
       })
 
     return () => { cancelled = true }
-  }, [name, story])
+  }, [name, story, isComponentSet])
 
   // Signal snapshot-ready after story renders in embed mode.
   useEffect(() => {
@@ -67,6 +88,15 @@ export default function StoryPage({ name }) {
     })
   }, [isEmbed, exports])
 
+  // Delegate to ComponentSetPage for grid view (after all hooks)
+  if (isComponentSet) {
+    return (
+      <Suspense fallback={isEmbed ? null : <div className={styles.loading}>Loading component set…</div>}>
+        <ComponentSetPageLazy name={name} />
+      </Suspense>
+    )
+  }
+
   if (error) {
     return (
       <StoryErrorFallback name={name} error={error} />