@dfosco/storyboard 0.5.0-alpha.0

package/src/core/workshop/features/createCanvas/CreateCanvasForm.jsx

@@ -0,0 +1,260 @@
+import { useState, useMemo, useEffect } from 'react'
+import { Button } from '../../../lib/components/ui/button/index.js'
+import { Input } from '../../../lib/components/ui/input/index.js'
+import { Label } from '../../../lib/components/ui/label/index.js'
+import { Checkbox } from '../../../lib/components/ui/checkbox/index.js'
+import * as Panel from '../../../lib/components/ui/panel/index.js'
+import * as Alert from '../../../lib/components/ui/alert/index.js'
+
+const CANVAS_SUCCESS_KEY = 'sb-canvas-created'
+
+function getApiUrl() {
+  const basePath = window.__STORYBOARD_BASE_PATH__ || '/'
+  return basePath.replace(/\/$/, '') + '/_storyboard/canvas'
+}
+
+export default function CreateCanvasForm({ onClose }) {
+  const [name, setName] = useState('')
+  const [title, setTitle] = useState('')
+  const [titleTouched, setTitleTouched] = useState(false)
+  const [description, setDescription] = useState('')
+  const [folder, setFolder] = useState('')
+  const [grid, setGrid] = useState(true)
+  const [folders, setFolders] = useState([])
+  const [loading, setLoading] = useState(true)
+  const [submitting, setSubmitting] = useState(false)
+  const [error, setError] = useState(null)
+  const [success, setSuccess] = useState(null)
+  const [createdRoute, setCreatedRoute] = useState(null)
+
+  const kebabName = useMemo(
+    () =>
+      name
+        .replace(/[^a-zA-Z0-9\s_-]/g, '')
+        .trim()
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase()
+        .replace(/-+/g, '-')
+        .replace(/^-|-$/g, ''),
+    [name],
+  )
+
+  const autoTitle = useMemo(
+    () =>
+      kebabName
+        ? kebabName
+            .split('-')
+            .map((s) => s.charAt(0).toUpperCase() + s.slice(1))
+            .join(' ')
+        : '',
+    [kebabName],
+  )
+
+  const displayTitle = useMemo(
+    () => (titleTouched ? title : autoTitle),
+    [titleTouched, title, autoTitle],
+  )
+
+  const routePreview = useMemo(
+    () => (kebabName ? `/canvas/${kebabName}` : ''),
+    [kebabName],
+  )
+
+  const nameError = useMemo(() => {
+    if (name.trim() && !kebabName)
+      return 'Name must contain at least one alphanumeric character'
+    if (name.trim() && !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(kebabName))
+      return 'Name must be kebab-case'
+    return null
+  }, [name, kebabName])
+
+  const canSubmit = useMemo(
+    () => !!kebabName && !nameError && !submitting,
+    [kebabName, nameError, submitting],
+  )
+
+  useEffect(() => {
+    // Restore success state after Vite's full-reload on file creation
+    try {
+      const saved = sessionStorage.getItem(CANVAS_SUCCESS_KEY)
+      if (saved) {
+        const parsed = JSON.parse(saved)
+        setSuccess(parsed.success)
+        setCreatedRoute(parsed.route)
+        sessionStorage.removeItem(CANVAS_SUCCESS_KEY)
+      }
+    } catch { /* empty */ }
+
+    async function fetchFolders() {
+      try {
+        const res = await fetch(getApiUrl() + '/folders')
+        if (res.ok) {
+          const data = await res.json()
+          setFolders(data.folders || [])
+        }
+      } catch { /* empty */ } finally {
+        setLoading(false)
+      }
+    }
+    fetchFolders()
+  }, [])
+
+  function handleTitleInput(e) {
+    setTitle(e.target.value)
+    setTitleTouched(true)
+  }
+
+  function handleTitleBlur() {
+    if (!title.trim()) setTitleTouched(false)
+  }
+
+  async function submit() {
+    if (!canSubmit) return
+    setSubmitting(true)
+    setError(null)
+    setSuccess(null)
+    setCreatedRoute(null)
+    try {
+      const res = await fetch(getApiUrl() + '/create', {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          name: kebabName,
+          title: displayTitle,
+          description: description || undefined,
+          folder: folder || undefined,
+          grid,
+        }),
+      })
+      const data = await res.json()
+      if (!res.ok) {
+        setError(data.error || 'Failed to create canvas')
+        return
+      }
+      const msg = `Created ${data.path}`
+      setSuccess(msg)
+      setCreatedRoute(data.route)
+      try {
+        sessionStorage.setItem(
+          CANVAS_SUCCESS_KEY,
+          JSON.stringify({ success: msg, route: data.route }),
+        )
+      } catch { /* empty */ }
+    } catch (err) {
+      setError(err.message || 'Network error')
+    } finally {
+      setSubmitting(false)
+    }
+  }
+
+  function handleKeydown(e) {
+    if (e.key === 'Enter' && canSubmit) submit()
+  }
+
+  return (
+    <div onKeyDown={handleKeydown}>
+      <Panel.Header>
+        <Panel.Title>Create canvas</Panel.Title>
+        <Panel.Close onClick={onClose} />
+      </Panel.Header>
+
+      <div style={{ display: 'flex', flexDirection: 'column', gap: '1rem', padding: '1rem' }}>
+        <div>
+          <Label htmlFor="canvas-name">Name</Label>
+          <Input
+            id="canvas-name"
+            value={name}
+            onChange={(e) => setName(e.target.value)}
+            placeholder="my-canvas"
+          />
+          {nameError && (
+            <p style={{ color: 'var(--color-danger-fg, red)', fontSize: '0.875rem', marginTop: '0.25rem' }}>
+              {nameError}
+            </p>
+          )}
+          {routePreview && (
+            <p style={{ color: 'var(--color-fg-muted, #666)', fontSize: '0.875rem', marginTop: '0.25rem' }}>
+              {routePreview}
+            </p>
+          )}
+        </div>
+
+        <div>
+          <Label htmlFor="canvas-title">Title</Label>
+          <Input
+            id="canvas-title"
+            value={displayTitle}
+            onChange={handleTitleInput}
+            onBlur={handleTitleBlur}
+            placeholder="Auto-generated from name"
+          />
+        </div>
+
+        <div>
+          <Label htmlFor="canvas-description">Description</Label>
+          <Input
+            id="canvas-description"
+            value={description}
+            onChange={(e) => setDescription(e.target.value)}
+            placeholder="Optional description"
+          />
+        </div>
+
+        <div>
+          <Label htmlFor="canvas-folder">Folder</Label>
+          <select
+            id="canvas-folder"
+            value={folder}
+            onChange={(e) => setFolder(e.target.value)}
+            disabled={loading}
+          >
+            <option value="">No folder</option>
+            {folders.map((f) => (
+              <option key={f} value={f}>
+                {f}
+              </option>
+            ))}
+          </select>
+        </div>
+
+        <div style={{ display: 'flex', alignItems: 'center', gap: '0.5rem' }}>
+          <Checkbox
+            id="canvas-grid"
+            checked={grid}
+            onCheckedChange={setGrid}
+          />
+          <Label htmlFor="canvas-grid">Show grid</Label>
+        </div>
+
+        {error && (
+          <Alert.Root variant="destructive">
+            <Alert.Description>{error}</Alert.Description>
+          </Alert.Root>
+        )}
+
+        {success && (
+          <Alert.Root>
+            <Alert.Description>
+              {success}
+              {createdRoute && (
+                <>
+                  {' — '}
+                  <a href={createdRoute}>Open canvas</a>
+                </>
+              )}
+            </Alert.Description>
+          </Alert.Root>
+        )}
+      </div>
+
+      <Panel.Footer>
+        <Button variant="outline" onClick={onClose}>
+          Cancel
+        </Button>
+        <Button onClick={submit} disabled={!canSubmit}>
+          {submitting ? 'Creating…' : 'Create'}
+        </Button>
+      </Panel.Footer>
+    </div>
+  )
+}

package/src/core/workshop/features/createCanvas/index.js

@@ -0,0 +1,14 @@
+/**
+ * Create Canvas feature — create new canvases from the Workshop panel.
+ *
+ * Server routes are handled by the dedicated canvas handler at /_storyboard/canvas/.
+ * This feature only provides the workshop UI overlay.
+ */
+
+import CreateCanvasForm from './CreateCanvasForm.jsx'
+
+export const name = 'createCanvas'
+export const label = 'Create canvas'
+export const icon = '🎨'
+export const overlayId = 'createCanvas'
+export const overlay = CreateCanvasForm

package/src/core/workshop/features/createFlow/CreateFlowForm.jsx

@@ -0,0 +1,334 @@
+import { useState, useEffect, useMemo, useRef, useCallback } from 'react'
+import { Button } from '../../../lib/components/ui/button/index.js'
+import { Input } from '../../../lib/components/ui/input/index.js'
+import { Label } from '../../../lib/components/ui/label/index.js'
+import * as Panel from '../../../lib/components/ui/panel/index.js'
+import * as Alert from '../../../lib/components/ui/alert/index.js'
+
+const CREATE_NEW_PAGE_VALUE = '__create_new_page__'
+
+const selectClass =
+  'flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-sm shadow-xs transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50'
+
+function getApiUrl() {
+  const basePath = window.__STORYBOARD_BASE_PATH__ || '/'
+  return basePath.replace(/\/$/, '') + '/_storyboard/workshop/flows'
+}
+
+export default function CreateFlowForm({ onClose }) {
+  const [name, setName] = useState('')
+  const [title, setTitle] = useState('')
+  const [titleTouched, setTitleTouched] = useState(false)
+  const [selectedPrototype, setSelectedPrototype] = useState('')
+  const [description, setDescription] = useState('')
+  const [copyFrom, setCopyFrom] = useState('')
+  const [startingPage, setStartingPage] = useState('')
+  const [newPagePath, setNewPagePath] = useState('')
+  const [newPageTemplate, setNewPageTemplate] = useState('')
+
+  const [prototypes, setPrototypes] = useState([])
+  const [flows, setFlows] = useState([])
+  const [partials, setPartials] = useState([])
+  const [loading, setLoading] = useState(true)
+  const [submitting, setSubmitting] = useState(false)
+  const [error, setError] = useState(null)
+  const [success, setSuccess] = useState(null)
+
+  // Derived values
+  const kebabName = useMemo(
+    () => name.replace(/[^a-zA-Z0-9\s_-]/g, '').trim().replace(/[\s_]+/g, '-').toLowerCase().replace(/-+/g, '-').replace(/^-|-$/g, ''),
+    [name]
+  )
+  const autoTitle = useMemo(
+    () => kebabName ? kebabName.split('-').map(s => s.charAt(0).toUpperCase() + s.slice(1)).join(' ') : '',
+    [kebabName]
+  )
+  const displayTitle = titleTouched ? title : autoTitle
+  const filePreview = kebabName ? `${kebabName}.flow.json` : ''
+  const nameError = useMemo(() => {
+    if (name.trim() && !kebabName) return 'Name must contain at least one alphanumeric character'
+    if (name.trim() && !/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(kebabName)) return 'Name must be kebab-case'
+    return null
+  }, [name, kebabName])
+
+  const selectedProtoEntry = useMemo(
+    () => selectedPrototype ? prototypes.find(p => p.name === selectedPrototype) : null,
+    [selectedPrototype, prototypes]
+  )
+  const copyFromFlows = useMemo(
+    () => selectedPrototype
+      ? flows.filter(f => {
+          if (f.prototype !== selectedPrototype) return false
+          return (f.folder || '') === (selectedProtoEntry?.folder || '')
+        })
+      : [],
+    [selectedPrototype, flows, selectedProtoEntry]
+  )
+  const prototypeRoutes = useMemo(() => selectedProtoEntry?.routes || [], [selectedProtoEntry])
+  const showNewPageFields = startingPage === CREATE_NEW_PAGE_VALUE
+  const newPagePrefix = selectedPrototype ? `/${selectedPrototype}/` : '/prototype-name/'
+  const templateChoices = useMemo(
+    () => selectedPrototype
+      ? partials.filter(p => p.scope === 'global' || (p.prototype === selectedPrototype && (p.folder || '') === (selectedProtoEntry?.folder || '')))
+      : partials.filter(p => p.scope === 'global'),
+    [selectedPrototype, partials, selectedProtoEntry]
+  )
+  const globalTemplateChoices = useMemo(() => templateChoices.filter(p => p.scope === 'global'), [templateChoices])
+  const localTemplateChoices = useMemo(() => templateChoices.filter(p => p.scope === 'prototype'), [templateChoices])
+  const localTemplateHeading = selectedPrototype || ''
+  const startingPageError = showNewPageFields && !newPagePath.trim() ? 'Please provide a new page path' : null
+  const canSubmit = !!kebabName && !!selectedPrototype && !nameError && !startingPageError && !submitting
+
+  // Fetch data on mount
+  useEffect(() => {
+    let cancelled = false
+    ;(async () => {
+      try {
+        const res = await fetch(getApiUrl())
+        if (res.ok && !cancelled) {
+          const data = await res.json()
+          setPrototypes(data.prototypes || [])
+          setFlows(data.flows || [])
+          setPartials(data.partials || [])
+        }
+      } catch { /* defaults */ } finally {
+        if (!cancelled) setLoading(false)
+      }
+    })()
+    return () => { cancelled = true }
+  }, [])
+
+  // Effect 1: when selectedPrototype changes, reset/cascade fields
+  const prevProtoRef = useRef(selectedPrototype)
+  useEffect(() => {
+    if (!selectedPrototype) {
+      setCopyFrom('')
+      setStartingPage('')
+      setNewPagePath('')
+      setNewPageTemplate('')
+      prevProtoRef.current = selectedPrototype
+      return
+    }
+
+    const routes = selectedProtoEntry?.routes || []
+
+    setStartingPage(prev => {
+      if (!prev || (prev !== CREATE_NEW_PAGE_VALUE && !routes.includes(prev))) {
+        return routes[0] || ''
+      }
+      return prev
+    })
+
+    setNewPagePath(prev => {
+      const prefix = `/${selectedPrototype}/`
+      if (startingPage === CREATE_NEW_PAGE_VALUE && !prev.startsWith(prefix)) {
+        return `${prefix}new-page`
+      }
+      return prev
+    })
+
+    setCopyFrom(prev => {
+      const activeStillValid = prev && copyFromFlows.some(f => f.path === prev)
+      if (activeStillValid) return prev
+      const matchPage = startingPage && startingPage !== CREATE_NEW_PAGE_VALUE
+        ? copyFromFlows.find(f => f.route === startingPage)
+        : null
+      return matchPage?.path || ''
+    })
+
+    prevProtoRef.current = selectedPrototype
+  // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [selectedPrototype])
+
+  // Effect 2: clear template if no longer available
+  useEffect(() => {
+    if (!newPageTemplate) return
+    if (!templateChoices.some(c => c.id === newPageTemplate)) {
+      setNewPageTemplate('')
+    }
+  }, [templateChoices, newPageTemplate])
+
+  function handleTitleInput(e) {
+    setTitle(e.target.value)
+    setTitleTouched(true)
+  }
+  function handleTitleBlur() {
+    if (!title.trim()) setTitleTouched(false)
+  }
+
+  const submit = useCallback(async () => {
+    if (!canSubmit) return
+    setSubmitting(true)
+    setError(null)
+    setSuccess(null)
+    try {
+      const res = await fetch(getApiUrl(), {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/json' },
+        body: JSON.stringify({
+          name: kebabName,
+          title: displayTitle,
+          prototype: selectedPrototype,
+          folder: selectedProtoEntry?.folder || undefined,
+          description: description.trim() || undefined,
+          copyFrom: copyFrom || undefined,
+          startingPage: showNewPageFields ? newPagePath.trim() : (startingPage || undefined),
+          createPage: showNewPageFields ? {
+            path: newPagePath.trim(),
+            template: newPageTemplate || undefined,
+          } : undefined,
+        }),
+      })
+      const data = await res.json()
+      if (!res.ok) { setError(data.error || 'Failed to create flow'); return }
+      setSuccess(`Created ${data.path}`)
+    } catch (err) {
+      setError(err.message || 'Network error')
+    } finally {
+      setSubmitting(false)
+    }
+  }, [canSubmit, kebabName, displayTitle, selectedPrototype, selectedProtoEntry, description, copyFrom, showNewPageFields, newPagePath, startingPage, newPageTemplate])
+
+  function handleKeydown(e) {
+    if (e.key === 'Enter' && canSubmit) submit()
+  }
+
+  return (
+    <>
+      <Panel.Header>
+        <Panel.Title>Create flow</Panel.Title>
+        <Panel.Close />
+      </Panel.Header>
+
+      <div className="p-4 pt-2 space-y-5" onKeyDown={handleKeydown}>
+        {/* Name */}
+        <div className="space-y-1">
+          <Label htmlFor="sb-flow-name">Name</Label>
+          <Input id="sb-flow-name" placeholder="e.g. empty-state" autoComplete="off" spellCheck={false} value={name} onChange={e => setName(e.target.value)} />
+          {nameError && <p className="text-sm text-destructive">{nameError}</p>}
+          {filePreview && (
+            <p className="text-xs text-muted-foreground">
+              File: <code className="px-1 py-0.5 bg-muted rounded font-mono text-foreground text-xs">{filePreview}</code>
+            </p>
+          )}
+        </div>
+
+        {/* Title */}
+        <div className="space-y-1">
+          <Label htmlFor="sb-flow-title">Title</Label>
+          <Input id="sb-flow-title" placeholder={autoTitle || 'Auto-derived from name'} value={displayTitle} onChange={handleTitleInput} onBlur={handleTitleBlur} />
+        </div>
+
+        {/* Prototype */}
+        <div className="space-y-1">
+          <Label htmlFor="sb-flow-prototype">Prototype</Label>
+          <select className={selectClass} id="sb-flow-prototype" value={selectedPrototype} onChange={e => setSelectedPrototype(e.target.value)} disabled={loading}>
+            <option value="">Select prototype</option>
+            {prototypes.map(p => (
+              <option key={p.name} value={p.name}>{p.folder ? `${p.folder} / ${p.name}` : p.name}</option>
+            ))}
+          </select>
+        </div>
+
+        {/* Copy from existing flow */}
+        <div className="space-y-1">
+          <Label htmlFor="sb-flow-copy">Copy from existing flow <span className="text-muted-foreground">(optional)</span></Label>
+          <select className={selectClass} id="sb-flow-copy" value={copyFrom} onChange={e => setCopyFrom(e.target.value)} disabled={loading || !selectedPrototype}>
+            {!selectedPrototype
+              ? <option value="">Select a prototype first</option>
+              : <>
+                  <option value="">None</option>
+                  {copyFromFlows.map(f => (
+                    <option key={f.path} value={f.path}>{f.title} ({f.name})</option>
+                  ))}
+                </>
+            }
+          </select>
+        </div>
+
+        {/* Starting page */}
+        <div className="space-y-1">
+          <Label htmlFor="sb-flow-starting-page">Starting page <span className="text-muted-foreground">(optional)</span></Label>
+          <select className={selectClass} id="sb-flow-starting-page" value={startingPage} onChange={e => setStartingPage(e.target.value)} disabled={loading || !selectedPrototype}>
+            {!selectedPrototype
+              ? <option value="">Select a prototype first</option>
+              : <>
+                  <option value="">None</option>
+                  {prototypeRoutes.map(route => (
+                    <option key={route} value={route}>{route}</option>
+                  ))}
+                  <option value={CREATE_NEW_PAGE_VALUE}>Create new page</option>
+                </>
+            }
+          </select>
+          <p className="text-xs text-muted-foreground">Users will be redirected to this page</p>
+        </div>
+
+        {/* New page fields */}
+        {showNewPageFields && (
+          <>
+            <div className="space-y-1">
+              <Label htmlFor="sb-flow-new-page-path">New page path</Label>
+              <div className="flex items-center gap-2">
+                <span className="text-xs text-muted-foreground font-mono">{newPagePrefix}</span>
+                <Input
+                  id="sb-flow-new-page-path"
+                  placeholder="new-page"
+                  value={newPagePath.startsWith(newPagePrefix) ? newPagePath.slice(newPagePrefix.length) : ''}
+                  onChange={e => {
+                    const suffix = e.target.value.replace(/^\/+/, '')
+                    setNewPagePath(`${newPagePrefix}${suffix}`)
+                  }}
+                />
+              </div>
+            </div>
+            <div className="space-y-1">
+              <Label htmlFor="sb-flow-new-page-template">Template / recipe</Label>
+              <select className={selectClass} id="sb-flow-new-page-template" value={newPageTemplate} onChange={e => setNewPageTemplate(e.target.value)} disabled={!selectedPrototype}>
+                <option value="">Blank page</option>
+                {globalTemplateChoices.length > 0 && (
+                  <optgroup label="Global">
+                    {globalTemplateChoices.map(p => (
+                      <option key={p.id} value={p.id}>{p.name}</option>
+                    ))}
+                  </optgroup>
+                )}
+                {localTemplateChoices.length > 0 && (
+                  <optgroup label={localTemplateHeading}>
+                    {localTemplateChoices.map(p => (
+                      <option key={p.id} value={p.id}>{p.name}</option>
+                    ))}
+                  </optgroup>
+                )}
+              </select>
+            </div>
+            {startingPageError && <p className="text-sm text-destructive">{startingPageError}</p>}
+          </>
+        )}
+
+        {/* Description */}
+        <div className="space-y-1">
+          <Label htmlFor="sb-flow-desc">Description</Label>
+          <Input id="sb-flow-desc" placeholder="Optional description" value={description} onChange={e => setDescription(e.target.value)} />
+        </div>
+
+        {/* Alerts */}
+        {error && (
+          <Alert.Root variant="destructive">
+            <Alert.Description>{error}</Alert.Description>
+          </Alert.Root>
+        )}
+        {success && (
+          <Alert.Root>
+            <Alert.Description className="text-success">{success}</Alert.Description>
+          </Alert.Root>
+        )}
+      </div>
+
+      <Panel.Footer>
+        <Button variant="outline" onClick={onClose}>Cancel</Button>
+        <Button onClick={submit} disabled={!canSubmit}>{submitting ? 'Creating\u2026' : 'Create'}</Button>
+      </Panel.Footer>
+    </>
+  )
+}

package/src/core/workshop/features/createFlow/index.js

@@ -0,0 +1,19 @@
+/**
+ * Create Flow feature — create new flow data files from the Workshop panel.
+ *
+ * Each workshop feature exports a standard interface:
+ *   - name:          Feature identifier (matches config key in workshop.features)
+ *   - label:         Display name for the menu item
+ *   - icon:          Emoji or HTML for the menu icon
+ *   - overlayId:     Unique ID for the overlay
+ *   - overlay:       Component rendered in the overlay
+ *   - serverSetup:   Called by the server plugin to register API routes
+ */
+
+import CreateFlowForm from './CreateFlowForm.jsx'
+
+export const name = 'createFlow'
+export const label = 'Create flow'
+export const icon = '🔀'
+export const overlayId = 'createFlow'
+export const overlay = CreateFlowForm