silvery 0.3.0 → 0.4.1

package/examples/interactive/async-data.tsx

@@ -1,208 +0,0 @@
-/**
- * Async Data Example
- *
- * Demonstrates React Suspense for async data loading:
- * - Suspense boundaries with fallback UI
- * - Multiple independent suspending components
- * - Error handling with ErrorBoundary
- */
-
-import React, { Suspense, useState, use } from "react"
-import {
-  render,
-  Box,
-  Text,
-  H1,
-  Kbd,
-  Muted,
-  useInput,
-  useApp,
-  createTerm,
-  ErrorBoundary,
-  type Key,
-} from "../../src/index.js"
-import { ExampleBanner, type ExampleMeta } from "../_banner.js"
-
-export const meta: ExampleMeta = {
-  name: "Async Data",
-  description: "React Suspense with independent data sources and error boundaries",
-  features: ["React Suspense", "use() hook", "ErrorBoundary"],
-}
-
-// ============================================================================
-// Data Fetching (simulated)
-// ============================================================================
-
-// Cache for promises (React's use() requires stable promise references)
-const cache = new Map<string, Promise<unknown>>()
-
-function fetchData<T>(key: string, ms: number, data: T): Promise<T> {
-  if (!cache.has(key)) {
-    cache.set(key, new Promise<T>((resolve) => setTimeout(() => resolve(data), ms)))
-  }
-  return cache.get(key) as Promise<T>
-}
-
-function clearCache() {
-  cache.clear()
-}
-
-// ============================================================================
-// Async Components
-// ============================================================================
-
-interface UserData {
-  name: string
-  email: string
-  role: string
-}
-
-function UserProfile() {
-  const user = use(
-    fetchData<UserData>("user", 1500, {
-      name: "Alice Chen",
-      email: "alice@example.com",
-      role: "Developer",
-    }),
-  )
-
-  return (
-    <Box flexDirection="column" borderStyle="round" borderColor="$success" padding={1}>
-      <H1 color="$success">User Profile</H1>
-      <Text>Name: {user.name}</Text>
-      <Text>Email: {user.email}</Text>
-      <Text>Role: {user.role}</Text>
-    </Box>
-  )
-}
-
-interface StatsData {
-  projects: number
-  commits: number
-  reviews: number
-}
-
-function Statistics() {
-  const stats = use(
-    fetchData<StatsData>("stats", 2500, {
-      projects: 12,
-      commits: 847,
-      reviews: 156,
-    }),
-  )
-
-  return (
-    <Box flexDirection="column" borderStyle="round" borderColor="$primary" padding={1}>
-      <H1>Statistics</H1>
-      <Text>Projects: {stats.projects}</Text>
-      <Text>Commits: {stats.commits}</Text>
-      <Text>Reviews: {stats.reviews}</Text>
-    </Box>
-  )
-}
-
-interface Activity {
-  id: number
-  action: string
-  time: string
-}
-
-function RecentActivity() {
-  const activities = use(
-    fetchData<Activity[]>("activity", 3500, [
-      { id: 1, action: "Merged PR #423", time: "2h ago" },
-      { id: 2, action: "Reviewed PR #421", time: "4h ago" },
-      { id: 3, action: "Created issue #89", time: "1d ago" },
-    ]),
-  )
-
-  return (
-    <Box flexDirection="column" borderStyle="round" borderColor="$warning" padding={1}>
-      <H1 color="$warning">Recent Activity</H1>
-      {activities.map((a) => (
-        <Text key={a.id}>
-          <Text dim>{a.time}</Text> {a.action}
-        </Text>
-      ))}
-    </Box>
-  )
-}
-
-// Loading fallbacks
-function LoadingBox({ label, color }: { label: string; color: string }) {
-  return (
-    <Box borderStyle="round" borderColor="$border" padding={1}>
-      <Text color="$muted">Loading {label}...</Text>
-    </Box>
-  )
-}
-
-// ============================================================================
-// Main App
-// ============================================================================
-
-export function AsyncDataApp(): JSX.Element {
-  const { exit } = useApp()
-  const [refreshKey, setRefreshKey] = useState(0)
-
-  useInput((input: string, key: Key) => {
-    if (input === "q" || key.escape) {
-      exit()
-      return
-    }
-    if (input === "r") {
-      // Refresh: clear cache and force re-render
-      clearCache()
-      setRefreshKey((k) => k + 1)
-    }
-  })
-
-  return (
-    <Box flexDirection="column" padding={1} key={refreshKey}>
-      <Box flexGrow={1} flexDirection="row" gap={1}>
-        {/* Each Suspense boundary loads independently */}
-        <ErrorBoundary fallback={<Text color="$error">User error</Text>}>
-          <Suspense fallback={<LoadingBox label="user" color="green" />}>
-            <UserProfile />
-          </Suspense>
-        </ErrorBoundary>
-
-        <ErrorBoundary fallback={<Text color="$error">Stats error</Text>}>
-          <Suspense fallback={<LoadingBox label="stats" color="blue" />}>
-            <Statistics />
-          </Suspense>
-        </ErrorBoundary>
-
-        <ErrorBoundary fallback={<Text color="$error">Activity error</Text>}>
-          <Suspense fallback={<LoadingBox label="activity" color="yellow" />}>
-            <RecentActivity />
-          </Suspense>
-        </ErrorBoundary>
-      </Box>
-
-      <Muted>
-        {" "}
-        <Kbd>r</Kbd> refresh <Kbd>Esc/q</Kbd> quit
-      </Muted>
-    </Box>
-  )
-}
-
-// ============================================================================
-// Main
-// ============================================================================
-
-async function main() {
-  using term = createTerm()
-  const { waitUntilExit } = await render(
-    <ExampleBanner meta={meta} controls="r refresh  Esc/q quit">
-      <AsyncDataApp />
-    </ExampleBanner>,
-    term,
-  )
-  await waitUntilExit()
-}
-
-if (import.meta.main) {
-  main().catch(console.error)
-}

package/examples/interactive/cli-wizard.tsx

@@ -1,332 +0,0 @@
-/**
- * CLI Wizard Example
- *
- * A multi-step project scaffolding wizard demonstrating:
- * - SelectList for option selection with keyboard navigation
- * - TextInput for free-form text entry
- * - ProgressBar for visual progress feedback
- * - Step-by-step flow with state transitions
- *
- * Usage: bun run examples/interactive/cli-wizard.tsx
- *
- * Controls:
- *   j/k or Up/Down - Navigate options (step 1)
- *   Enter          - Confirm selection / submit input
- *   Type           - Enter project name (step 2)
- *   q or Esc       - Quit (when not typing)
- */
-
-import React, { useState, useCallback, useEffect } from "react"
-import {
-  render,
-  Box,
-  Text,
-  SelectList,
-  TextInput,
-  ProgressBar,
-  Spinner,
-  useInput,
-  useApp,
-  createTerm,
-  H1,
-  Muted,
-  Lead,
-  Kbd,
-  Code,
-  type Key,
-  type SelectOption,
-} from "../../src/index.js"
-import { ExampleBanner, type ExampleMeta } from "../_banner.js"
-
-export const meta: ExampleMeta = {
-  name: "CLI Wizard",
-  description: "Multi-step project scaffolding wizard with selection, input, and progress",
-  demo: true,
-  features: ["SelectList", "TextInput", "ProgressBar", "Spinner", "useInput()"],
-}
-
-// ============================================================================
-// Types
-// ============================================================================
-
-type WizardStep = "framework" | "name" | "installing" | "done"
-
-interface WizardState {
-  step: WizardStep
-  framework: string | null
-  projectName: string
-  progress: number
-}
-
-// ============================================================================
-// Data
-// ============================================================================
-
-const FRAMEWORKS: SelectOption[] = [
-  { label: "React      — A JavaScript library for building user interfaces", value: "react" },
-  { label: "Vue        — The progressive JavaScript framework", value: "vue" },
-  { label: "Svelte     — Cybernetically enhanced web apps", value: "svelte" },
-  { label: "Solid      — Simple and performant reactivity", value: "solid" },
-  {
-    label: "Angular    — Platform for building web applications",
-    value: "angular",
-    disabled: true,
-  },
-]
-
-const INSTALL_STEPS = [
-  "Resolving dependencies...",
-  "Downloading packages...",
-  "Linking dependencies...",
-  "Building project...",
-  "Generating types...",
-  "Setting up config...",
-  "Done!",
-]
-
-// ============================================================================
-// Components
-// ============================================================================
-
-/** Step indicator showing current position in the wizard */
-function StepIndicator({ current, total }: { current: number; total: number }): JSX.Element {
-  return (
-    <Box paddingX={1} marginBottom={1}>
-      {Array.from({ length: total }, (_, i) => {
-        const isDone = i < current
-        const isCurrent = i === current
-        const dot = isDone ? "\u25cf" : isCurrent ? "\u25cb" : "\u25cb"
-        const color = isDone ? "$success" : isCurrent ? "$primary" : "$muted"
-        return (
-          <Text key={i} color={color} bold={isCurrent}>
-            {dot}
-            {i < total - 1 ? " \u2500 " : ""}
-          </Text>
-        )
-      })}
-    </Box>
-  )
-}
-
-/** Step 1: Framework selection */
-function FrameworkStep({ onSelect }: { onSelect: (option: SelectOption) => void }): JSX.Element {
-  return (
-    <Box flexDirection="column" paddingX={1}>
-      <Box marginBottom={1}>
-        <H1>? Select a framework:</H1>
-      </Box>
-      <SelectList items={FRAMEWORKS} onSelect={onSelect} />
-      <Box marginTop={1}>
-        <Lead>(Angular is coming soon)</Lead>
-      </Box>
-    </Box>
-  )
-}
-
-/** Step 2: Project name input */
-function NameStep({
-  value,
-  onChange,
-  onSubmit,
-  framework,
-}: {
-  value: string
-  onChange: (v: string) => void
-  onSubmit: (v: string) => void
-  framework: string
-}): JSX.Element {
-  return (
-    <Box flexDirection="column" paddingX={1}>
-      <Box marginBottom={1}>
-        <H1>? Project name</H1>
-        <Muted> ({framework})</Muted>
-        <H1>:</H1>
-      </Box>
-      <Box>
-        <Text color="$muted">{"\u276f "}</Text>
-        <TextInput value={value} onChange={onChange} onSubmit={onSubmit} prompt="" />
-      </Box>
-      <Box marginTop={1}>
-        <Muted>Press Enter to confirm</Muted>
-      </Box>
-    </Box>
-  )
-}
-
-/** Step 3: Installation progress */
-function InstallStep({ progress, stepIndex }: { progress: number; stepIndex: number }): JSX.Element {
-  const currentStep = INSTALL_STEPS[Math.min(stepIndex, INSTALL_STEPS.length - 1)]!
-
-  return (
-    <Box flexDirection="column" paddingX={1}>
-      <Box marginBottom={1}>
-        <Spinner type="dots" />
-        <Text bold color="$warning">
-          {" "}
-          Installing dependencies...
-        </Text>
-      </Box>
-
-      <Box marginBottom={1}>
-        <ProgressBar value={progress} color="$primary" label="" />
-      </Box>
-
-      <Muted>{currentStep}</Muted>
-    </Box>
-  )
-}
-
-/** Step 4: Completion summary */
-function DoneStep({ framework, projectName }: { framework: string; projectName: string }): JSX.Element {
-  return (
-    <Box flexDirection="column" paddingX={1}>
-      <Box marginBottom={1}>
-        <H1 color="$success">{"\u2714"} Project created successfully!</H1>
-      </Box>
-
-      <Box flexDirection="column" borderStyle="round" borderColor="$success" paddingX={2} paddingY={1}>
-        <Box>
-          <Muted>Framework: </Muted>
-          <Text bold>{framework}</Text>
-        </Box>
-        <Box>
-          <Muted>Project: </Muted>
-          <Text bold>{projectName}</Text>
-        </Box>
-        <Box>
-          <Muted>Location: </Muted>
-          <Text bold>./{projectName}/</Text>
-        </Box>
-      </Box>
-
-      <Box flexDirection="column" marginTop={1}>
-        <Muted>Get started:</Muted>
-        <Code>
-          {"  "}cd {projectName}
-        </Code>
-        <Code>{"  "}bun install</Code>
-        <Code>{"  "}bun dev</Code>
-      </Box>
-
-      <Box marginTop={1}>
-        <Muted>
-          Press <Kbd>q</Kbd> or <Kbd>Esc</Kbd> to exit
-        </Muted>
-      </Box>
-    </Box>
-  )
-}
-
-// ============================================================================
-// Main App
-// ============================================================================
-
-export function CliWizard(): JSX.Element {
-  const { exit } = useApp()
-  const [state, setState] = useState<WizardState>({
-    step: "framework",
-    framework: null,
-    projectName: "",
-    progress: 0,
-  })
-
-  // Handle framework selection
-  const handleFrameworkSelect = useCallback((option: SelectOption) => {
-    setState((prev) => ({
-      ...prev,
-      step: "name",
-      framework: option.value,
-      projectName: `my-${option.value}-app`,
-    }))
-  }, [])
-
-  // Handle project name change
-  const handleNameChange = useCallback((value: string) => {
-    setState((prev) => ({ ...prev, projectName: value }))
-  }, [])
-
-  // Handle project name submission
-  const handleNameSubmit = useCallback((value: string) => {
-    if (value.trim()) {
-      setState((prev) => ({ ...prev, step: "installing", progress: 0 }))
-    }
-  }, [])
-
-  // Simulate installation progress
-  useEffect(() => {
-    if (state.step !== "installing") return
-
-    const timer = setInterval(() => {
-      setState((prev) => {
-        const next = prev.progress + 0.08 + Math.random() * 0.04
-        if (next >= 1) {
-          clearInterval(timer)
-          return { ...prev, step: "done", progress: 1 }
-        }
-        return { ...prev, progress: next }
-      })
-    }, 200)
-
-    return () => clearInterval(timer)
-  }, [state.step])
-
-  // Global quit handler (only when not in text input step)
-  useInput((input: string, key: Key) => {
-    if (state.step === "name") return // TextInput handles its own input
-    if (input === "q" || key.escape) {
-      exit()
-    }
-  })
-
-  // Map progress to step index for display
-  const installStepIndex = Math.floor(state.progress * (INSTALL_STEPS.length - 1))
-
-  const stepNumber = state.step === "framework" ? 0 : state.step === "name" ? 1 : state.step === "installing" ? 2 : 3
-
-  return (
-    <Box flexDirection="column" flexGrow={1}>
-      <Box borderStyle="single" borderColor="$primary" paddingX={2} marginBottom={1}>
-        <H1>create-app</H1>
-        <Muted> v1.0.0</Muted>
-      </Box>
-
-      <StepIndicator current={stepNumber} total={4} />
-
-      {state.step === "framework" && <FrameworkStep onSelect={handleFrameworkSelect} />}
-
-      {state.step === "name" && state.framework && (
-        <NameStep
-          value={state.projectName}
-          onChange={handleNameChange}
-          onSubmit={handleNameSubmit}
-          framework={state.framework}
-        />
-      )}
-
-      {state.step === "installing" && <InstallStep progress={state.progress} stepIndex={installStepIndex} />}
-
-      {state.step === "done" && state.framework && (
-        <DoneStep framework={state.framework} projectName={state.projectName} />
-      )}
-    </Box>
-  )
-}
-
-// ============================================================================
-// Main
-// ============================================================================
-
-async function main() {
-  using term = createTerm()
-  const { waitUntilExit } = await render(
-    <ExampleBanner meta={meta} controls="j/k navigate  Enter select  q/Esc quit">
-      <CliWizard />
-    </ExampleBanner>,
-    term,
-  )
-  await waitUntilExit()
-}
-
-if (import.meta.main) {
-  main().catch(console.error)
-}