@dfosco/storyboard 0.5.0-alpha.0

package/src/core/lib/components/ui/toggle/toggle.jsx

@@ -0,0 +1,36 @@
+import { forwardRef } from "react";
+import * as TogglePrimitive from "@radix-ui/react-toggle";
+import { cn } from "../../../utils/index.js";
+import { tv } from "tailwind-variants";
+
+export const toggleVariants = tv({
+base: "hover:text-foreground aria-pressed:bg-muted focus-visible:border-ring focus-visible:ring-ring/50 aria-invalid:ring-destructive/20 dark:aria-invalid:ring-destructive/40 aria-invalid:border-destructive data-[state=on]:bg-muted gap-1 rounded-lg text-sm font-medium transition-all [&_svg:not([class*='size-'])]:size-4 group/toggle hover:bg-muted inline-flex items-center justify-center whitespace-nowrap outline-none focus-visible:ring-[3px] disabled:pointer-events-none disabled:opacity-50 [&_svg]:pointer-events-none [&_svg]:shrink-0",
+variants: {
+variant: {
+default: "bg-transparent",
+outline: "border-input hover:bg-muted border bg-transparent",
+},
+size: {
+default: "h-8 min-w-8 px-2",
+sm: "h-7 min-w-7 rounded-[min(var(--sb--radius-md),12px)] px-1.5 text-[0.8rem]",
+lg: "h-9 min-w-9 px-2.5",
+},
+},
+defaultVariants: {
+variant: "default",
+size: "default",
+},
+});
+
+const Toggle = forwardRef(function Toggle({ className, variant = "default", size = "default", ...props }, ref) {
+return (
+<TogglePrimitive.Root
+ref={ref}
+data-slot="toggle"
+className={cn(toggleVariants({ variant, size }), className)}
+{...props}
+/>
+);
+});
+
+export default Toggle;

package/src/core/lib/components/ui/toggle-group/index.js

@@ -0,0 +1,10 @@
+import Root from "./toggle-group.jsx";
+import Item from "./toggle-group-item.jsx";
+
+export {
+Root,
+Item,
+//
+Root as ToggleGroup,
+Item as ToggleGroupItem,
+};

package/src/core/lib/components/ui/toggle-group/toggle-group-item.jsx

@@ -0,0 +1,29 @@
+import { forwardRef } from "react";
+import * as ToggleGroupPrimitive from "@radix-ui/react-toggle-group";
+import { useToggleGroupCtx } from "./toggle-group.jsx";
+import { cn } from "../../../utils/index.js";
+import { toggleVariants } from "../toggle/index.js";
+
+const ToggleGroupItem = forwardRef(function ToggleGroupItem({ className, variant, size, ...props }, ref) {
+const ctx = useToggleGroupCtx();
+
+return (
+<ToggleGroupPrimitive.Item
+ref={ref}
+data-slot="toggle-group-item"
+data-variant={ctx.variant || variant}
+data-size={ctx.size || size}
+data-spacing={ctx.spacing}
+className={cn(
+"group-data-[spacing=0]/toggle-group:rounded-none group-data-[spacing=0]/toggle-group:px-2 group-data-horizontal/toggle-group:data-[spacing=0]:first:rounded-l-lg group-data-vertical/toggle-group:data-[spacing=0]:first:rounded-t-lg group-data-horizontal/toggle-group:data-[spacing=0]:last:rounded-r-lg group-data-vertical/toggle-group:data-[spacing=0]:last:rounded-b-lg shrink-0 focus:z-10 focus-visible:z-10 group-data-horizontal/toggle-group:data-[spacing=0]:data-[variant=outline]:border-l-0 group-data-vertical/toggle-group:data-[spacing=0]:data-[variant=outline]:border-t-0 group-data-horizontal/toggle-group:data-[spacing=0]:data-[variant=outline]:first:border-l group-data-vertical/toggle-group:data-[spacing=0]:data-[variant=outline]:first:border-t",
+toggleVariants({
+variant: ctx.variant || variant,
+size: ctx.size || size,
+}),
+className
+)}
+{...props}
+/>
+);
+});
+export default ToggleGroupItem;

package/src/core/lib/components/ui/toggle-group/toggle-group.jsx

@@ -0,0 +1,43 @@
+import { forwardRef, createContext, useContext, useMemo } from "react";
+import * as ToggleGroupPrimitive from "@radix-ui/react-toggle-group";
+import { cn } from "../../../utils/index.js";
+
+export const ToggleGroupContext = createContext({
+variant: "default",
+size: "default",
+spacing: 0,
+orientation: "horizontal",
+});
+
+export function useToggleGroupCtx() {
+return useContext(ToggleGroupContext);
+}
+
+const ToggleGroup = forwardRef(function ToggleGroup(
+{ className, variant = "default", size = "default", spacing = 0, orientation = "horizontal", children, ...props },
+ref
+) {
+const ctx = useMemo(() => ({ variant, size, spacing, orientation }), [variant, size, spacing, orientation]);
+
+return (
+<ToggleGroupContext.Provider value={ctx}>
+<ToggleGroupPrimitive.Root
+ref={ref}
+orientation={orientation}
+data-slot="toggle-group"
+data-variant={variant}
+data-size={size}
+data-spacing={spacing}
+style={{ '--sb--gap': spacing }}
+className={cn(
+"rounded-lg data-[size=sm]:rounded-[min(var(--sb--radius-md),10px)] group/toggle-group flex w-fit flex-row items-center gap-[--spacing(var(--sb--gap))] data-vertical:flex-col data-vertical:items-stretch",
+className
+)}
+{...props}
+>
+{children}
+</ToggleGroupPrimitive.Root>
+</ToggleGroupContext.Provider>
+);
+});
+export default ToggleGroup;

package/src/core/lib/components/ui/tooltip/index.js

@@ -0,0 +1,3 @@
+export { default as Root } from "./tooltip.jsx";
+export { default as Trigger } from "./tooltip-trigger.jsx";
+export { default as Content } from "./tooltip-content.jsx";

package/src/core/lib/components/ui/tooltip/tooltip-content.jsx

@@ -0,0 +1,21 @@
+import { forwardRef } from "react";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+import { cn } from "../../../utils/index.js";
+
+const TooltipContent = forwardRef(function TooltipContent({ className, sideOffset = 8, ...props }, ref) {
+return (
+<TooltipPrimitive.Portal>
+<TooltipPrimitive.Content
+ref={ref}
+data-slot="tooltip-content"
+sideOffset={sideOffset}
+className={cn(
+"font-sans bg-slate-700 text-white text-xs px-2.5 py-1.5 rounded-lg shadow-lg z-[10001] animate-in fade-in-0 zoom-in-95 data-[side=bottom]:slide-in-from-top-2 data-[side=left]:slide-in-from-right-2 data-[side=right]:slide-in-from-left-2 data-[side=top]:slide-in-from-bottom-2",
+className
+)}
+{...props}
+/>
+</TooltipPrimitive.Portal>
+);
+});
+export default TooltipContent;

package/src/core/lib/components/ui/tooltip/tooltip-trigger.jsx

@@ -0,0 +1,23 @@
+import { forwardRef } from "react";
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+
+const TooltipTrigger = forwardRef(function TooltipTrigger({ asChild, children, ...props }, ref) {
+if (asChild) {
+return (
+<TooltipPrimitive.Trigger ref={ref} asChild {...props}>
+{children}
+</TooltipPrimitive.Trigger>
+);
+}
+return (
+<TooltipPrimitive.Trigger ref={ref} asChild {...props}>
+<span
+tabIndex={-1}
+style={{ display: "inline-flex" }}
+>
+{children}
+</span>
+</TooltipPrimitive.Trigger>
+);
+});
+export default TooltipTrigger;

package/src/core/lib/components/ui/tooltip/tooltip.jsx

@@ -0,0 +1,11 @@
+import * as TooltipPrimitive from "@radix-ui/react-tooltip";
+
+export default function Tooltip({ children, ...props }) {
+return (
+<TooltipPrimitive.Provider delayDuration={50}>
+<TooltipPrimitive.Root {...props}>
+{children}
+</TooltipPrimitive.Root>
+</TooltipPrimitive.Provider>
+);
+}

package/src/core/lib/components/ui/trigger-button/index.js

@@ -0,0 +1,6 @@
+import Root from "./trigger-button.jsx";
+
+export {
+Root,
+Root as TriggerButton,
+};

package/src/core/lib/components/ui/trigger-button/trigger-button.css

@@ -0,0 +1,38 @@
+[data-trigger-button] {
+  display: inline-flex;
+  position: relative;
+}
+[data-trigger-button] [data-slot="button-wrapper"] {
+  --sb--sc-border-color: var(--sb--trigger-border, var(--color-slate-400));
+  --sb--sc-border-width: var(--sb--trigger-border-width, 3px);
+}
+/* Accent-colored border/gap on focus — follows the superellipse shape */
+[data-trigger-button] [data-slot="button-wrapper"]:has([data-slot="button"]:focus-visible) {
+  --sb--sc-border-color: hsl(212 92% 45%);
+}
+[data-trigger-button] [data-slot="button"] {
+  background-color: var(--sb--trigger-bg, var(--color-slate-100));
+  color: var(--sb--trigger-text, var(--color-slate-600));
+}
+[data-trigger-button] [data-slot="button"]:hover,
+[data-trigger-button] [data-slot="button"]:focus-visible,
+[data-trigger-button] [data-slot="button"][aria-expanded="true"],
+[data-trigger-button][data-active] [data-slot="button"] {
+  background-color: var(--sb--trigger-bg-hover, var(--color-slate-300));
+}
+
+/* Inactive: disabled-looking, no interaction */
+[data-trigger-button][data-inactive] {
+  opacity: 0.45;
+  pointer-events: none;
+}
+
+/* Dimmed: reduced visibility, interactive on hover/focus */
+[data-trigger-button][data-dimmed] {
+  opacity: 0.3;
+  transition: opacity 200ms;
+}
+[data-trigger-button][data-dimmed]:hover,
+[data-trigger-button][data-dimmed]:focus-within {
+  opacity: 1;
+}

package/src/core/lib/components/ui/trigger-button/trigger-button.jsx

@@ -0,0 +1,63 @@
+import './trigger-button.css';
+import { useMemo, forwardRef } from "react";
+import { cn } from "../../../utils/index.js";
+import { registerSmoothCorners } from '../../../../utils/smoothCorners.js';
+import { Button } from '../button/index.js';
+
+registerSmoothCorners();
+
+const TriggerButton = forwardRef(function TriggerButton({
+className,
+wrapperClass = "",
+active = false,
+inactive = false,
+dimmed = false,
+localOnly = false,
+size = "icon-2xl",
+children,
+// Separate Radix trigger props from button props
+'aria-expanded': ariaExpanded,
+'data-state': dataState,
+'aria-haspopup': ariaHaspopup,
+...props
+}, ref) {
+const borderWidth = useMemo(
+() => ['icon-2xl', 'icon-xl', '2xl', 'xl'].includes(size) ? '3px' : '2px',
+[size]
+);
+
+return (
+<span
+ref={ref}
+data-trigger-button=""
+data-active={active || undefined}
+data-inactive={inactive || undefined}
+data-dimmed={dimmed || undefined}
+data-local-only={localOnly || undefined}
+style={{ '--sb--trigger-border-width': borderWidth }}
+aria-expanded={ariaExpanded}
+data-state={dataState}
+aria-haspopup={ariaHaspopup}
+>
+<Button
+variant="trigger"
+size={size}
+disabled={inactive}
+wrapperClass={cn(
+"smooth-corners [--sb--smooth-corners:4] hover:rotate-2 focus-visible:rotate-2 transition-transform",
+active && !inactive && "rotate-2",
+wrapperClass
+)}
+className={cn(
+"smooth-corners leading-none font-semibold",
+className
+)}
+{...props}
+>
+{children}
+</Button>
+</span>
+);
+});
+
+export default TriggerButton;

package/src/core/lib/utils/index.js

@@ -0,0 +1,6 @@
+import { clsx } from 'clsx'
+import { twMerge } from 'tailwind-merge'
+
+export function cn(...inputs) {
+  return twMerge(clsx(inputs))
+}

package/src/core/logger/devLogger.js

@@ -0,0 +1,238 @@
+/**
+ * Dev Logger — structured JSONL logging for storyboard dev server errors.
+ *
+ * Writes one JSONL file per day to `.storyboard/logs/{YYYY-MM-DD}.jsonl`.
+ * Automatically enriches log entries with context extracted from request URLs
+ * (canvas name, prototype, page, etc.).
+ *
+ * Usage:
+ *   import { createDevLogger } from './logger/devLogger.js'
+ *   const logger = createDevLogger({ root, devDomain, branch })
+ *   logger.logResponse({ status: 404, method: 'GET', url: '/...', route: 'canvas', error: '...' })
+ *   logger.logEvent('warn', 'Something happened', { extra: 'context' })
+ */
+
+import fs from 'node:fs'
+import path from 'node:path'
+
+const LOGS_DIR_NAME = 'logs'
+const STORYBOARD_DIR = '.storyboard'
+const MAX_AGE_DAYS = 7
+
+/**
+ * Format a Date as YYYY-MM-DD.
+ */
+function dateStamp(date = new Date()) {
+  return date.toISOString().slice(0, 10)
+}
+
+/**
+ * Extract contextual metadata from a request URL.
+ * Parses query params and path segments to find canvas, prototype, and page.
+ */
+function extractContext(url) {
+  const ctx = { canvas: null, prototype: null, page: null }
+  if (!url) return ctx
+
+  try {
+    const parsed = new URL(url, 'http://localhost')
+    const params = parsed.searchParams
+
+    // Canvas name from ?name= query param (used by canvas CRUD routes)
+    if (params.has('name')) ctx.canvas = params.get('name')
+
+    // Prototype from path: /PrototypeName/... or ?prototype=
+    if (params.has('prototype')) ctx.prototype = params.get('prototype')
+
+    // Page from path segments or ?page=
+    if (params.has('page')) ctx.page = params.get('page')
+
+    // Infer from path: /_storyboard/canvas/... → canvas route
+    const pathname = parsed.pathname
+    if (!ctx.canvas && pathname.includes('/canvas/')) {
+      const segments = pathname.split('/').filter(Boolean)
+      const canvasIdx = segments.indexOf('canvas')
+      if (canvasIdx >= 0 && segments[canvasIdx + 1]) {
+        const sub = segments[canvasIdx + 1]
+        // Skip known sub-routes
+        if (!['read', 'list', 'update', 'widget', 'create', 'folders',
+              'connector', 'stories', 'create-story', 'github', 'image',
+              'images', 'terminal-buffer', 'terminal-snapshot',
+              'rename-page', 'reorder-pages', 'page-order',
+              'update-folder-meta', 'duplicate', 'image-proxy'].includes(sub)) {
+          ctx.canvas = sub
+        }
+      }
+    }
+  } catch {
+    // URL parsing failed — return empty context
+  }
+
+  return ctx
+}
+
+/**
+ * Prune log files older than MAX_AGE_DAYS.
+ */
+function pruneOldLogs(logsDir) {
+  try {
+    const files = fs.readdirSync(logsDir)
+    const cutoff = Date.now() - MAX_AGE_DAYS * 24 * 60 * 60 * 1000
+
+    for (const file of files) {
+      if (!file.endsWith('.jsonl')) continue
+      const dateStr = file.replace('.jsonl', '')
+      const fileDate = new Date(dateStr + 'T00:00:00Z')
+      if (isNaN(fileDate.getTime())) continue
+      if (fileDate.getTime() < cutoff) {
+        try {
+          fs.unlinkSync(path.join(logsDir, file))
+        } catch { /* best-effort */ }
+      }
+    }
+  } catch {
+    // Directory might not exist yet — that's fine
+  }
+}
+
+/**
+ * Create a dev logger instance.
+ *
+ * @param {object} opts
+ * @param {string} opts.root — project root directory
+ * @param {string} [opts.devDomain] — dev domain from config (e.g. "storyboard-core")
+ * @param {string} [opts.branch] — current git branch
+ * @param {boolean} [opts.verbose] — also log to console (controlled by dev-logs flag)
+ * @returns {{ logResponse: Function, logEvent: Function, logsDir: string }}
+ */
+export function createDevLogger({ root, devDomain = null, branch = null, verbose = false } = {}) {
+  const logsDir = path.join(root, STORYBOARD_DIR, LOGS_DIR_NAME)
+  let dirEnsured = false
+
+  function ensureDir() {
+    if (dirEnsured) return true
+    try {
+      fs.mkdirSync(logsDir, { recursive: true })
+      dirEnsured = true
+      return true
+    } catch {
+      return false
+    }
+  }
+
+  // Prune old logs on startup (non-blocking, best-effort)
+  try { pruneOldLogs(logsDir) } catch { /* ignore */ }
+
+  function writeEntry(entry) {
+    if (!ensureDir()) return
+    const filename = `${dateStamp()}.jsonl`
+    const filepath = path.join(logsDir, filename)
+    const line = JSON.stringify(entry) + '\n'
+
+    try {
+      fs.appendFileSync(filepath, line, 'utf-8')
+    } catch {
+      // If we can't write logs, fail silently — never crash the server
+    }
+
+    if (verbose) {
+      const tag = entry.status ? `[${entry.status}]` : `[${entry.level}]`
+      const msg = entry.error || entry.message || ''
+      console.warn(`[storyboard-logs] ${tag} ${entry.method || ''} ${entry.url || ''} — ${msg}`)
+    }
+  }
+
+  /**
+   * Log an HTTP error response (4xx/5xx).
+   *
+   * @param {object} opts
+   * @param {number} opts.status — HTTP status code
+   * @param {string} opts.method — HTTP method (GET, POST, etc.)
+   * @param {string} opts.url — full request URL
+   * @param {string} [opts.route] — top-level route prefix (e.g. "canvas", "workshop")
+   * @param {string} [opts.subRoute] — sub-route path after prefix
+   * @param {string} [opts.error] — error message from the response body
+   * @param {object} [opts.context] — additional context (overrides auto-extracted)
+   */
+  function logResponse({ status, method, url, route = null, subRoute = null, error = null, context = {} }) {
+    if (status < 400) return
+
+    const autoContext = extractContext(url)
+    const mergedContext = { ...autoContext, ...context }
+
+    // Strip null values from context
+    for (const key of Object.keys(mergedContext)) {
+      if (mergedContext[key] == null) delete mergedContext[key]
+    }
+
+    const entry = {
+      ts: new Date().toISOString(),
+      level: status >= 500 ? 'error' : 'warn',
+      status,
+      method: method || 'UNKNOWN',
+      url: url || '',
+      route: route || null,
+      subRoute: subRoute || null,
+      error: error || null,
+      devDomain: devDomain || null,
+      branch: branch || null,
+    }
+
+    if (Object.keys(mergedContext).length > 0) {
+      entry.context = mergedContext
+    }
+
+    writeEntry(entry)
+  }
+
+  /**
+   * Log a general event (not tied to an HTTP response).
+   *
+   * @param {'info'|'warn'|'error'} level
+   * @param {string} message
+   * @param {object} [context] — arbitrary context data
+   */
+  function logEvent(level, message, context = {}) {
+    const entry = {
+      ts: new Date().toISOString(),
+      level,
+      message,
+      devDomain: devDomain || null,
+      branch: branch || null,
+    }
+    if (Object.keys(context).length > 0) {
+      entry.context = context
+    }
+    writeEntry(entry)
+  }
+
+  return { logResponse, logEvent, logsDir, _extractContext: extractContext }
+}
+
+// ─── Module-level singleton ───
+// Set once by server-plugin.js, then any server-side module can call devLog().
+
+let _instance = null
+
+/**
+ * Register the global dev logger instance.
+ * Called once during server startup (server-plugin.js configureServer).
+ */
+export function setDevLogger(logger) {
+  _instance = logger
+}
+
+/**
+ * Get the global dev logger. Returns a no-op logger if not yet initialized.
+ * Safe to call from any server-side module without constructor plumbing.
+ */
+export function devLog() {
+  return _instance || _noop
+}
+
+const _noop = {
+  logResponse() {},
+  logEvent() {},
+}
+
+export { extractContext, pruneOldLogs, dateStamp }