aural-ui 4.0.1 → 4.1.0

package/dist/components/resizable/Resizable.stories.tsx

@@ -1,6 +1,19 @@
 import React from "react"
+import {
+  AlertIcon,
+  HeartIcon,
+  MusicalNoteIcon,
+  PauseIcon,
+  SearchIcon,
+  SettingIcon,
+  SkipBackwardIcon,
+  SkipForwardIcon,
+  VolumeFullIcon,
+} from "@icons/index"
 import type { Meta, StoryObj } from "@storybook/react-vite"
 
+import { AuralComponentDocsPage } from "src/ui/story-spec/components/component-story-docs-page"
+
 import { ResizableHandle, ResizablePanel, ResizablePanelGroup } from "."
 
 const meta: Meta<typeof ResizablePanelGroup> = {
@@ -17,111 +30,27 @@ const meta: Meta<typeof ResizablePanelGroup> = {
     },
     docs: {
       description: {
-        component: `
-# Resizable Component
-
-A flexible resizable panel system built on top of react-resizable-panels, providing smooth panel resizing with customizable handles and layouts.
-
-## Components
-
-### Core Components
-- **ResizablePanelGroup**: Container that manages the resizable layout and direction
-- **ResizablePanel**: Individual panel that can be resized
-- **ResizableHandle**: The draggable handle between panels with optional visual indicator
-
-## Features
-
-- **Bi-directional**: Supports both horizontal and vertical panel layouts
-- **Smooth Resizing**: Fluid drag-to-resize interactions
-- **Visual Handles**: Optional drag handles with move icons
-- **Keyboard Accessible**: Full keyboard navigation support
-- **Flexible Sizing**: Supports percentage-based and minimum size constraints
-- **Auto-rotation**: Icons automatically rotate for vertical layouts
-- **Design System**: Integrated with design tokens for consistent styling
-- **Focus Management**: Proper focus indicators and keyboard navigation
-
-## Usage Examples
-
-### Basic Horizontal Layout
-\`\`\`tsx
-<ResizablePanelGroup direction="horizontal">
-  <ResizablePanel defaultSize={50}>
-    Left Panel Content
-  </ResizablePanel>
-  <ResizableHandle />
-  <ResizablePanel defaultSize={50}>
-    Right Panel Content
-  </ResizablePanel>
-</ResizablePanelGroup>
-\`\`\`
-
-### Vertical Layout with Handles
-\`\`\`tsx
-<ResizablePanelGroup direction="vertical" className="h-96">
-  <ResizablePanel defaultSize={30}>
-    Top Panel
-  </ResizablePanel>
-  <ResizableHandle withHandle />
-  <ResizablePanel defaultSize={70}>
-    Bottom Panel
-  </ResizablePanel>
-</ResizablePanelGroup>
-\`\`\`
-
-### Three Panel Layout
-\`\`\`tsx
-<ResizablePanelGroup direction="horizontal">
-  <ResizablePanel defaultSize={25} minSize={20}>
-    Sidebar
-  </ResizablePanel>
-  <ResizableHandle withHandle />
-  <ResizablePanel defaultSize={50}>
-    Main Content
-  </ResizablePanel>
-  <ResizableHandle withHandle />
-  <ResizablePanel defaultSize={25} minSize={15}>
-    Right Panel
-  </ResizablePanel>
-</ResizablePanelGroup>
-\`\`\`
-
-### Nested Resizable Layouts
-\`\`\`tsx
-<ResizablePanelGroup direction="horizontal">
-  <ResizablePanel defaultSize={30}>
-    Sidebar Content
-  </ResizablePanel>
-  <ResizableHandle withHandle />
-  <ResizablePanel defaultSize={70}>
-    <ResizablePanelGroup direction="vertical">
-      <ResizablePanel defaultSize={60}>
-        Main Content
-      </ResizablePanel>
-      <ResizableHandle withHandle />
-      <ResizablePanel defaultSize={40}>
-        Bottom Panel
-      </ResizablePanel>
-    </ResizablePanelGroup>
-  </ResizablePanel>
-</ResizablePanelGroup>
-\`\`\`
-
-## Accessibility
-
-- **Keyboard Navigation**: Handles can be focused and adjusted with arrow keys
-- **ARIA Support**: Proper ARIA roles and attributes for screen readers
-- **Focus Indicators**: Clear focus rings following design system patterns
-- **Semantic Structure**: Proper DOM structure for assistive technologies
-
-## Design Tokens
-
-The component uses design system tokens:
-- \`--color-fm-button-fill-secondary\`: Handle background color
-- \`--color-fm-primary\`: Focus ring color
-- \`--color-fm-contrast\`: Focus ring offset color
-- \`--radius-fm-xs\`: Handle border radius
-        `,
+        component:
+          "A layout primitive built on react-resizable-panels providing fluid drag-to-resize behaviour. Composed of three parts: ResizablePanelGroup (sets direction and manages layout), ResizablePanel (individual resizable area with optional min/default sizes), and ResizableHandle (the draggable divider with an optional visual grip). Supports horizontal and vertical directions and arbitrary nesting.",
       },
+      page: () => (
+        <AuralComponentDocsPage
+          features={[
+            {
+              title: "Drag to Resize",
+              description: "Fluid panel splitting",
+            },
+            {
+              title: "H & V Directions",
+              description: "Horizontal or vertical",
+            },
+            {
+              title: "Nestable",
+              description: "Groups within groups",
+            },
+          ]}
+        />
+      ),
     },
   },
   tags: ["autodocs"],
@@ -129,11 +58,7 @@ The component uses design system tokens:
     direction: {
       control: "select",
       options: ["horizontal", "vertical"],
-      description: "Direction of the panel group layout",
-    },
-    className: {
-      control: "text",
-      description: "Additional CSS classes",
+      description: "Layout direction for the panel group",
     },
   },
 }
@@ -141,548 +66,238 @@ The component uses design system tokens:
 export default meta
 type Story = StoryObj<typeof ResizablePanelGroup>
 
-// 1. Basic Horizontal Layout
-export const BasicHorizontal: Story = {
-  args: {
-    direction: "horizontal",
-  },
-  render: (args) => (
-    <div className="h-96 w-full p-8">
-      <h3 className="text-fm-primary mb-4 text-lg font-medium">
-        Basic Horizontal Layout
-      </h3>
-      <ResizablePanelGroup
-        {...args}
-        className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-      >
-        <ResizablePanel defaultSize={50}>
-          <div className="flex h-full items-center justify-center bg-blue-500/10 p-4">
-            <div className="text-center">
-              <h4 className="text-fm-primary text-lg font-medium">
-                Left Panel
-              </h4>
-              <p className="text-fm-secondary text-sm">Resize me!</p>
-            </div>
-          </div>
-        </ResizablePanel>
-        <ResizableHandle />
-        <ResizablePanel defaultSize={50}>
-          <div className="flex h-full items-center justify-center bg-purple-500/10 p-4">
-            <div className="text-center">
-              <h4 className="text-fm-primary text-lg font-medium">
-                Right Panel
-              </h4>
-              <p className="text-fm-secondary text-sm">I resize too!</p>
-            </div>
-          </div>
-        </ResizablePanel>
-      </ResizablePanelGroup>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Basic two-panel horizontal layout with a simple resize handle between panels.",
-      },
-    },
-  },
-}
-
-// 2. Vertical Layout with Handles
-export const VerticalWithHandles: Story = {
-  render: () => (
-    <div className="h-96 w-full p-8">
-      <h3 className="text-fm-primary mb-4 text-lg font-medium">
-        Vertical Layout with Visual Handles
-      </h3>
-      <ResizablePanelGroup
-        direction="vertical"
-        className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-      >
-        <ResizablePanel defaultSize={40}>
-          <div className="flex h-full items-center justify-center bg-green-500/10 p-4">
-            <div className="text-center">
-              <h4 className="text-fm-primary text-lg font-medium">Top Panel</h4>
-              <p className="text-fm-secondary text-sm">40% default size</p>
-            </div>
-          </div>
-        </ResizablePanel>
-        <ResizableHandle withHandle />
-        <ResizablePanel defaultSize={60}>
-          <div className="flex h-full items-center justify-center bg-orange-500/10 p-4">
-            <div className="text-center">
-              <h4 className="text-fm-primary text-lg font-medium">
-                Bottom Panel
-              </h4>
-              <p className="text-fm-secondary text-sm">60% default size</p>
-              <p className="text-fm-tertiary mt-2 text-xs">
-                Notice the rotated handle icon
-              </p>
-            </div>
-          </div>
-        </ResizablePanel>
-      </ResizablePanelGroup>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Vertical panel layout with visual drag handles. Notice how the move icon automatically rotates for vertical orientation.",
-      },
-    },
-  },
-}
-
-// 3. Three Panel Layout
-export const ThreePanel: Story = {
-  render: () => (
-    <div className="h-96 w-full p-8">
-      <h3 className="text-fm-primary mb-4 text-lg font-medium">
-        Three Panel Layout
-      </h3>
-      <ResizablePanelGroup
-        direction="horizontal"
-        className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-      >
-        <ResizablePanel defaultSize={25} minSize={15}>
-          <div className="flex h-full flex-col justify-center bg-red-500/10 p-4">
-            <h4 className="text-fm-primary text-sm font-medium">Sidebar</h4>
-            <p className="text-fm-secondary mt-1 text-xs">25% default</p>
-            <p className="text-fm-tertiary mt-1 text-xs">15% minimum</p>
-          </div>
-        </ResizablePanel>
-        <ResizableHandle withHandle />
-        <ResizablePanel defaultSize={50}>
-          <div className="flex h-full items-center justify-center bg-blue-500/10 p-4">
-            <div className="text-center">
-              <h4 className="text-fm-primary text-lg font-medium">
-                Main Content
-              </h4>
-              <p className="text-fm-secondary text-sm">50% default size</p>
-              <p className="text-fm-tertiary mt-2 text-xs">
-                Primary content area
-              </p>
-            </div>
-          </div>
-        </ResizablePanel>
-        <ResizableHandle withHandle />
-        <ResizablePanel defaultSize={25} minSize={20}>
-          <div className="flex h-full flex-col justify-center bg-purple-500/10 p-4">
-            <h4 className="text-fm-primary text-sm font-medium">Right Panel</h4>
-            <p className="text-fm-secondary mt-1 text-xs">25% default</p>
-            <p className="text-fm-tertiary mt-1 text-xs">20% minimum</p>
-          </div>
-        </ResizablePanel>
-      </ResizablePanelGroup>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Three-panel layout with minimum size constraints and visual drag handles between each panel.",
-      },
-    },
-  },
-}
+// ─── Configurations ───────────────────────────────────────────────────────────
 
-// 4. Nested Layouts
-export const NestedLayouts: Story = {
+export const Configurations: Story = {
   render: () => (
-    <div className="h-96 w-full p-8">
-      <h3 className="text-fm-primary mb-4 text-lg font-medium">
-        Nested Resizable Layouts
-      </h3>
-      <ResizablePanelGroup
-        direction="horizontal"
-        className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-      >
-        <ResizablePanel defaultSize={30} minSize={25}>
-          <div className="flex h-full flex-col justify-center bg-indigo-500/10 p-4">
-            <h4 className="text-fm-primary text-sm font-medium">Sidebar</h4>
-            <p className="text-fm-secondary mt-1 text-xs">Navigation & Tools</p>
-            <div className="mt-4 space-y-2">
-              <div className="bg-fm-surface-secondary h-2 rounded"></div>
-              <div className="bg-fm-surface-secondary h-2 rounded"></div>
-              <div className="bg-fm-surface-secondary h-2 rounded"></div>
-            </div>
-          </div>
-        </ResizablePanel>
-        <ResizableHandle withHandle />
-        <ResizablePanel defaultSize={70}>
-          <ResizablePanelGroup direction="vertical">
-            <ResizablePanel defaultSize={65}>
-              <div className="flex h-full items-center justify-center bg-green-500/10 p-4">
-                <div className="text-center">
-                  <h4 className="text-fm-primary text-lg font-medium">
-                    Main Content Area
-                  </h4>
-                  <p className="text-fm-secondary text-sm">Primary workspace</p>
-                  <p className="text-fm-tertiary mt-2 text-xs">
-                    This panel can be resized vertically
+    <div className="space-y-8 p-8">
+      {/* Horizontal split */}
+      <div className="space-y-3">
+        <h4 className="text-fm-secondary font-fm-text text-fm-md leading-fm-md font-medium">
+          Horizontal Split
+        </h4>
+        <div className="border-fm-divider-secondary h-48 overflow-hidden rounded-lg border">
+          <ResizablePanelGroup direction="horizontal">
+            <ResizablePanel defaultSize={50}>
+              <div className="bg-fm-surface-secondary flex h-full items-center justify-center p-4">
+                <div className="space-y-1 text-center">
+                  <p className="text-fm-primary font-fm-text text-fm-md leading-fm-md font-medium">
+                    Left Panel
+                  </p>
+                  <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                    50% default
                   </p>
                 </div>
               </div>
             </ResizablePanel>
             <ResizableHandle withHandle />
-            <ResizablePanel defaultSize={35} minSize={25}>
-              <div className="flex h-full items-center justify-center bg-orange-500/10 p-4">
-                <div className="text-center">
-                  <h4 className="text-md text-fm-primary font-medium">
-                    Bottom Panel
-                  </h4>
-                  <p className="text-fm-secondary text-sm">
-                    Console / Terminal
+            <ResizablePanel defaultSize={50}>
+              <div className="bg-fm-surface-primary flex h-full items-center justify-center p-4">
+                <div className="space-y-1 text-center">
+                  <p className="text-fm-primary font-fm-text text-fm-md leading-fm-md font-medium">
+                    Right Panel
                   </p>
-                  <p className="text-fm-tertiary mt-2 text-xs">
-                    Nested vertical layout
+                  <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                    50% default
                   </p>
                 </div>
               </div>
             </ResizablePanel>
           </ResizablePanelGroup>
-        </ResizablePanel>
-      </ResizablePanelGroup>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Complex nested layout demonstrating horizontal and vertical resizable panels within each other, similar to IDE layouts.",
-      },
-    },
-  },
-}
-
-// 5. Handle Variations
-export const HandleVariations: Story = {
-  render: () => (
-    <div className="space-y-8 p-8">
-      <h3 className="text-fm-primary text-center text-lg font-medium">
-        Handle Variations
-      </h3>
-
-      <div className="space-y-6">
-        {/* Without Visual Handle */}
-        <div className="space-y-2">
-          <h4 className="text-fm-secondary text-sm font-medium">
-            Without Visual Handle
-          </h4>
-          <div className="h-32">
-            <ResizablePanelGroup
-              direction="horizontal"
-              className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-            >
-              <ResizablePanel defaultSize={50}>
-                <div className="flex h-full items-center justify-center bg-blue-500/10 p-4">
-                  <span className="text-fm-primary text-sm">
-                    Minimal Handle
-                  </span>
-                </div>
-              </ResizablePanel>
-              <ResizableHandle />
-              <ResizablePanel defaultSize={50}>
-                <div className="flex h-full items-center justify-center bg-purple-500/10 p-4">
-                  <span className="text-fm-primary text-sm">Clean Look</span>
-                </div>
-              </ResizablePanel>
-            </ResizablePanelGroup>
-          </div>
         </div>
+      </div>
 
-        {/* With Visual Handle */}
-        <div className="space-y-2">
-          <h4 className="text-fm-secondary text-sm font-medium">
-            With Visual Handle
-          </h4>
-          <div className="h-32">
-            <ResizablePanelGroup
-              direction="horizontal"
-              className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-            >
-              <ResizablePanel defaultSize={50}>
-                <div className="flex h-full items-center justify-center bg-green-500/10 p-4">
-                  <span className="text-fm-primary text-sm">
-                    Clear Affordance
-                  </span>
+      {/* Vertical split */}
+      <div className="space-y-3">
+        <h4 className="text-fm-secondary font-fm-text text-fm-md leading-fm-md font-medium">
+          Vertical Split
+        </h4>
+        <div className="border-fm-divider-secondary h-48 overflow-hidden rounded-lg border">
+          <ResizablePanelGroup direction="vertical">
+            <ResizablePanel defaultSize={40}>
+              <div className="bg-fm-surface-secondary flex h-full items-center justify-center p-4">
+                <div className="space-y-1 text-center">
+                  <p className="text-fm-primary font-fm-text text-fm-md leading-fm-md font-medium">
+                    Top Panel
+                  </p>
+                  <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                    40% default
+                  </p>
                 </div>
-              </ResizablePanel>
-              <ResizableHandle withHandle />
-              <ResizablePanel defaultSize={50}>
-                <div className="flex h-full items-center justify-center bg-orange-500/10 p-4">
-                  <span className="text-fm-primary text-sm">Easy to Spot</span>
+              </div>
+            </ResizablePanel>
+            <ResizableHandle withHandle />
+            <ResizablePanel defaultSize={60}>
+              <div className="bg-fm-surface-primary flex h-full items-center justify-center p-4">
+                <div className="space-y-1 text-center">
+                  <p className="text-fm-primary font-fm-text text-fm-md leading-fm-md font-medium">
+                    Bottom Panel
+                  </p>
+                  <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                    60% default — handle icon rotates automatically
+                  </p>
                 </div>
-              </ResizablePanel>
-            </ResizablePanelGroup>
-          </div>
+              </div>
+            </ResizablePanel>
+          </ResizablePanelGroup>
         </div>
+      </div>
 
-        {/* Custom Styled Handle */}
-        <div className="space-y-2">
-          <h4 className="text-fm-secondary text-sm font-medium">
-            Custom Styled Handle
-          </h4>
-          <div className="h-32">
-            <ResizablePanelGroup
-              direction="horizontal"
-              className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-            >
-              <ResizablePanel defaultSize={50}>
-                <div className="flex h-full items-center justify-center bg-red-500/10 p-4">
-                  <span className="text-fm-primary text-sm">
-                    Custom Styling
-                  </span>
-                </div>
-              </ResizablePanel>
-              <ResizableHandle
-                withHandle
-                className="bg-blue-500/20 transition-colors hover:bg-blue-500/30"
-              />
-              <ResizablePanel defaultSize={50}>
-                <div className="flex h-full items-center justify-center bg-indigo-500/10 p-4">
-                  <span className="text-fm-primary text-sm">Themed Handle</span>
+      {/* Three-panel layout */}
+      <div className="space-y-3">
+        <h4 className="text-fm-secondary font-fm-text text-fm-md leading-fm-md font-medium">
+          Three-Panel Layout
+        </h4>
+        <div className="border-fm-divider-secondary h-48 overflow-hidden rounded-lg border">
+          <ResizablePanelGroup direction="horizontal">
+            <ResizablePanel defaultSize={25} minSize={15}>
+              <div className="bg-fm-surface-info-sec flex h-full flex-col justify-center space-y-1 p-4">
+                <p className="text-fm-primary font-fm-text text-fm-sm leading-fm-sm font-medium">
+                  Sidebar
+                </p>
+                <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                  25% · min 15%
+                </p>
+              </div>
+            </ResizablePanel>
+            <ResizableHandle withHandle />
+            <ResizablePanel defaultSize={50}>
+              <div className="bg-fm-surface-secondary flex h-full items-center justify-center p-4">
+                <div className="space-y-1 text-center">
+                  <p className="text-fm-primary font-fm-text text-fm-md leading-fm-md font-medium">
+                    Main Content
+                  </p>
+                  <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                    50% default
+                  </p>
                 </div>
-              </ResizablePanel>
-            </ResizablePanelGroup>
-          </div>
+              </div>
+            </ResizablePanel>
+            <ResizableHandle withHandle />
+            <ResizablePanel defaultSize={25} minSize={15}>
+              <div className="bg-fm-surface-positive-sec flex h-full flex-col justify-center space-y-1 p-4">
+                <p className="text-fm-primary font-fm-text text-fm-sm leading-fm-sm font-medium">
+                  Inspector
+                </p>
+                <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                  25% · min 15%
+                </p>
+              </div>
+            </ResizablePanel>
+          </ResizablePanelGroup>
         </div>
       </div>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Different handle variations showing minimal handles, visual handles with icons, and custom styled handles.",
-      },
-    },
-  },
-}
 
-// 6. Real-world Examples
-export const RealWorldExamples: Story = {
-  render: () => (
-    <div className="space-y-8 p-8">
-      <h3 className="text-fm-primary text-center text-lg font-medium">
-        Real-world Examples
-      </h3>
-
-      <div className="space-y-8">
-        {/* IDE Layout */}
-        <div className="space-y-4">
-          <h4 className="text-fm-secondary text-sm font-medium">
-            IDE / Code Editor Layout
-          </h4>
-          <div className="h-80">
-            <ResizablePanelGroup
-              direction="horizontal"
-              className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-            >
-              {/* File Explorer */}
-              <ResizablePanel defaultSize={20} minSize={15}>
-                <div className="bg-fm-surface-primary h-full p-3">
-                  <h5 className="text-fm-primary mb-3 text-xs font-medium">
-                    EXPLORER
-                  </h5>
-                  <div className="text-fm-secondary space-y-1 text-xs">
-                    <div className="flex items-center gap-1">
-                      <span>📁</span> src
-                    </div>
-                    <div className="ml-3 flex items-center gap-1">
-                      <span>📄</span> index.tsx
-                    </div>
-                    <div className="ml-3 flex items-center gap-1">
-                      <span>📄</span> App.tsx
-                    </div>
-                    <div className="flex items-center gap-1">
-                      <span>📁</span> components
-                    </div>
-                  </div>
+      {/* Nested layouts */}
+      <div className="space-y-3">
+        <h4 className="text-fm-secondary font-fm-text text-fm-md leading-fm-md font-medium">
+          Nested Layouts (horizontal + vertical)
+        </h4>
+        <div className="border-fm-divider-secondary h-64 overflow-hidden rounded-lg border">
+          <ResizablePanelGroup direction="horizontal">
+            <ResizablePanel defaultSize={28} minSize={20}>
+              <div className="bg-fm-surface-secondary flex h-full flex-col justify-center space-y-2 p-4">
+                <p className="text-fm-primary font-fm-text text-fm-sm leading-fm-sm font-medium">
+                  Sidebar
+                </p>
+                <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                  Navigation & tools
+                </p>
+                <div className="mt-3 space-y-2">
+                  <div className="bg-fm-surface-primary h-2 rounded" />
+                  <div className="bg-fm-surface-primary h-2 rounded" />
+                  <div className="bg-fm-surface-primary h-2 w-2/3 rounded" />
                 </div>
-              </ResizablePanel>
-              <ResizableHandle withHandle />
-
-              {/* Main Content */}
-              <ResizablePanel defaultSize={60}>
-                <ResizablePanelGroup direction="vertical">
-                  {/* Editor */}
-                  <ResizablePanel defaultSize={70}>
-                    <div className="bg-fm-surface-primary h-full p-4">
-                      <div className="border-fm-divider-secondary mb-4 flex items-center gap-2 border-b pb-2">
-                        <span className="text-fm-secondary text-xs">
-                          App.tsx
-                        </span>
-                        <span className="text-fm-tertiary text-xs">×</span>
-                      </div>
-                      <div className="text-fm-secondary space-y-2 font-mono text-xs">
-                        <div>
-                          <span className="text-fm-icon-brand-secondary">
-                            import
-                          </span>{" "}
-                          React{" "}
-                          <span className="text-fm-icon-brand-secondary">
-                            from
-                          </span>{" "}
-                          <span className="text-fm-positive">'react'</span>
-                        </div>
-                        <div></div>
-                        <div>
-                          <span className="text-fm-icon-brand-secondary">
-                            function
-                          </span>{" "}
-                          <span className="text-fm-info">App</span>() {"{"}
-                        </div>
-                        <div className="ml-4">
-                          <span className="text-fm-icon-brand-secondary">
-                            return
-                          </span>{" "}
-                          (
-                        </div>
-                        <div className="ml-8">
-                          &lt;<span className="text-fm-icon-negative">div</span>
-                          &gt;Hello World&lt;/
-                          <span className="text-fm-icon-negative">div</span>
-                          &gt;
-                        </div>
-                        <div className="ml-4">)</div>
-                        <div>{"}"}</div>
-                      </div>
+              </div>
+            </ResizablePanel>
+            <ResizableHandle withHandle />
+            <ResizablePanel defaultSize={72}>
+              <ResizablePanelGroup direction="vertical">
+                <ResizablePanel defaultSize={65}>
+                  <div className="bg-fm-surface-primary flex h-full items-center justify-center p-4">
+                    <div className="space-y-1 text-center">
+                      <p className="text-fm-primary font-fm-text text-fm-md leading-fm-md font-medium">
+                        Main Workspace
+                      </p>
+                      <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                        Primary content area — resizes vertically
+                      </p>
                     </div>
-                  </ResizablePanel>
-                  <ResizableHandle withHandle />
-
-                  {/* Terminal */}
-                  <ResizablePanel defaultSize={30} minSize={20}>
-                    <div className="h-full bg-black/50 p-3">
-                      <div className="mb-2 flex items-center gap-2">
-                        <h5 className="text-fm-primary text-xs font-medium">
-                          TERMINAL
-                        </h5>
-                        <span className="text-fm-tertiary text-xs">bash</span>
-                      </div>
-                      <div className="text-fm-positive font-mono text-xs">
-                        <div>$ npm start</div>
-                        <div className="text-fm-secondary">
-                          Starting development server...
-                        </div>
-                        <div className="text-fm-secondary">
-                          Local: http://localhost:3000
-                        </div>
-                        <div className="text-fm-positive">
-                          ✓ Compiled successfully!
-                        </div>
-                      </div>
+                  </div>
+                </ResizablePanel>
+                <ResizableHandle withHandle />
+                <ResizablePanel defaultSize={35} minSize={20}>
+                  <div className="bg-fm-surface-secondary flex h-full items-center justify-center p-4">
+                    <div className="space-y-1 text-center">
+                      <p className="text-fm-primary font-fm-text text-fm-md leading-fm-md font-medium">
+                        Console / Details
+                      </p>
+                      <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                        Nested vertical panel · min 20%
+                      </p>
                     </div>
-                  </ResizablePanel>
-                </ResizablePanelGroup>
-              </ResizablePanel>
-              <ResizableHandle withHandle />
-
-              {/* Right Sidebar */}
-              <ResizablePanel defaultSize={20} minSize={15}>
-                <div className="bg-fm-surface-primary h-full p-3">
-                  <h5 className="text-fm-primary mb-3 text-xs font-medium">
-                    OUTLINE
-                  </h5>
-                  <div className="text-fm-secondary space-y-1 text-xs">
-                    <div>📋 Components</div>
-                    <div className="ml-3">⚛️ App</div>
-                    <div className="ml-3">🎨 Header</div>
-                    <div className="ml-3">📝 Content</div>
-                    <div>🎯 Hooks</div>
-                    <div className="ml-3">🔄 useState</div>
                   </div>
-                </div>
-              </ResizablePanel>
-            </ResizablePanelGroup>
-          </div>
+                </ResizablePanel>
+              </ResizablePanelGroup>
+            </ResizablePanel>
+          </ResizablePanelGroup>
         </div>
+      </div>
 
-        {/* Dashboard Layout */}
+      {/* Handle variations */}
+      <div className="space-y-3">
+        <h4 className="text-fm-secondary font-fm-text text-fm-md leading-fm-md font-medium">
+          Handle Variations
+        </h4>
         <div className="space-y-4">
-          <h4 className="text-fm-secondary text-sm font-medium">
-            Dashboard Layout
-          </h4>
-          <div className="h-64">
-            <ResizablePanelGroup
-              direction="horizontal"
-              className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-            >
-              {/* Sidebar */}
-              <ResizablePanel defaultSize={25} minSize={20}>
-                <div className="h-full bg-blue-900/20 p-4">
-                  <h5 className="text-fm-primary mb-4 text-sm font-medium">
-                    Navigation
-                  </h5>
-                  <div className="space-y-3">
-                    <div className="text-fm-primary flex items-center gap-2 text-sm">
-                      <span>📊</span> Dashboard
-                    </div>
-                    <div className="text-fm-secondary flex items-center gap-2 text-sm">
-                      <span>👥</span> Users
-                    </div>
-                    <div className="text-fm-secondary flex items-center gap-2 text-sm">
-                      <span>⚙️</span> Settings
-                    </div>
+          <div className="space-y-1">
+            <p className="text-fm-tertiary font-fm-text text-fm-sm leading-fm-sm">
+              Without visual handle (minimal)
+            </p>
+            <div className="border-fm-divider-secondary h-24 overflow-hidden rounded-lg border">
+              <ResizablePanelGroup direction="horizontal">
+                <ResizablePanel defaultSize={50}>
+                  <div className="bg-fm-surface-secondary flex h-full items-center justify-center p-4">
+                    <span className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                      Minimal handle
+                    </span>
                   </div>
-                </div>
-              </ResizablePanel>
-              <ResizableHandle withHandle />
-
-              {/* Main Dashboard */}
-              <ResizablePanel defaultSize={75}>
-                <ResizablePanelGroup direction="vertical">
-                  {/* Top Metrics */}
-                  <ResizablePanel defaultSize={40}>
-                    <div className="h-full bg-green-900/20 p-4">
-                      <h5 className="text-fm-primary mb-3 text-sm font-medium">
-                        Key Metrics
-                      </h5>
-                      <div className="grid h-20 grid-cols-3 gap-4">
-                        <div className="bg-fm-surface-secondary rounded p-3 text-center">
-                          <div className="text-fm-primary text-lg font-bold">
-                            1,234
-                          </div>
-                          <div className="text-fm-secondary text-xs">Users</div>
-                        </div>
-                        <div className="bg-fm-surface-secondary rounded p-3 text-center">
-                          <div className="text-fm-primary text-lg font-bold">
-                            $12.3k
-                          </div>
-                          <div className="text-fm-secondary text-xs">
-                            Revenue
-                          </div>
-                        </div>
-                        <div className="bg-fm-surface-secondary rounded p-3 text-center">
-                          <div className="text-fm-primary text-lg font-bold">
-                            98.5%
-                          </div>
-                          <div className="text-fm-secondary text-xs">
-                            Uptime
-                          </div>
-                        </div>
-                      </div>
-                    </div>
-                  </ResizablePanel>
-                  <ResizableHandle withHandle />
+                </ResizablePanel>
+                <ResizableHandle />
+                <ResizablePanel defaultSize={50}>
+                  <div className="bg-fm-surface-primary flex h-full items-center justify-center p-4">
+                    <span className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                      Clean divider
+                    </span>
+                  </div>
+                </ResizablePanel>
+              </ResizablePanelGroup>
+            </div>
+          </div>
 
-                  {/* Bottom Charts */}
-                  <ResizablePanel defaultSize={60}>
-                    <div className="h-full bg-purple-900/20 p-4">
-                      <h5 className="text-fm-primary mb-3 text-sm font-medium">
-                        Analytics
-                      </h5>
-                      <div className="bg-fm-surface-secondary flex h-full items-center justify-center rounded p-4">
-                        <span className="text-fm-secondary">📈 Chart Area</span>
-                      </div>
-                    </div>
-                  </ResizablePanel>
-                </ResizablePanelGroup>
-              </ResizablePanel>
-            </ResizablePanelGroup>
+          <div className="space-y-1">
+            <p className="text-fm-tertiary font-fm-text text-fm-sm leading-fm-sm">
+              With visual handle (grip icon)
+            </p>
+            <div className="border-fm-divider-secondary h-24 overflow-hidden rounded-lg border">
+              <ResizablePanelGroup direction="horizontal">
+                <ResizablePanel defaultSize={50}>
+                  <div className="bg-fm-surface-secondary flex h-full items-center justify-center p-4">
+                    <span className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                      Clear affordance
+                    </span>
+                  </div>
+                </ResizablePanel>
+                <ResizableHandle withHandle />
+                <ResizablePanel defaultSize={50}>
+                  <div className="bg-fm-surface-primary flex h-full items-center justify-center p-4">
+                    <span className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                      Grip visible
+                    </span>
+                  </div>
+                </ResizablePanel>
+              </ResizablePanelGroup>
+            </div>
           </div>
         </div>
       </div>
@@ -692,222 +307,303 @@ export const RealWorldExamples: Story = {
     docs: {
       description: {
         story:
-          "Real-world application layouts including IDE/code editor interface and dashboard layout with multiple nested panels.",
+          "All layout configurations: horizontal split, vertical split, three-panel with minimum sizes, nested horizontal+vertical layouts, and both handle variants (minimal vs. grip icon).",
       },
     },
   },
 }
 
-// 7. Accessibility Demo
-export const AccessibilityDemo: Story = {
-  render: () => (
-    <div className="space-y-6 p-8">
-      <h3 className="text-fm-primary text-center text-lg font-medium">
-        Accessibility Features
-      </h3>
-
-      <div className="space-y-4">
-        <div className="rounded-lg border border-blue-500/30 bg-blue-900/10 p-4">
-          <h4 className="text-fm-info mb-2 text-sm font-medium">
-            Keyboard Navigation
-          </h4>
-          <p className="text-fm-info-sec mb-2 text-xs">
-            Try these keyboard interactions:
-          </p>
-          <ul className="text-fm-info-sec space-y-1 text-xs">
-            <li>
-              • <kbd className="bg-fm-surface-secondary rounded px-1">Tab</kbd>{" "}
-              to focus resize handles
-            </li>
-            <li>
-              •{" "}
-              <kbd className="bg-fm-surface-secondary rounded px-1">
-                Arrow Keys
-              </kbd>{" "}
-              to resize panels
-            </li>
-            <li>
-              •{" "}
-              <kbd className="bg-fm-surface-secondary rounded px-1">Enter</kbd>{" "}
-              to activate resize mode
-            </li>
-            <li>
-              •{" "}
-              <kbd className="bg-fm-surface-secondary rounded px-1">Escape</kbd>{" "}
-              to exit resize mode
-            </li>
-          </ul>
-        </div>
+// ─── UseCases ─────────────────────────────────────────────────────────────────
 
-        <div className="h-48">
-          <h4 className="text-fm-secondary mb-2 text-sm font-medium">
-            Keyboard Accessible Resizing
-          </h4>
-          <ResizablePanelGroup
-            direction="horizontal"
-            className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-          >
-            <ResizablePanel defaultSize={40}>
-              <div className="flex h-full items-center justify-center bg-blue-500/10 p-4">
-                <div className="text-center">
-                  <h5 className="text-md text-fm-primary font-medium">
-                    Left Panel
-                  </h5>
-                  <p className="text-fm-secondary mt-1 text-xs">
-                    Tab to the handle and use arrow keys
+export const UseCases: Story = {
+  render: () => (
+    <div className="mx-auto max-w-3xl space-y-8 p-8">
+      {/* Sidebar + Main — library browser */}
+      <div className="space-y-3">
+        <h4 className="text-fm-secondary font-fm-text text-fm-md leading-fm-md font-medium">
+          Sidebar + Main Content
+        </h4>
+        <div className="border-fm-divider-secondary h-72 overflow-hidden rounded-xl border">
+          <ResizablePanelGroup direction="horizontal">
+            {/* Sidebar */}
+            <ResizablePanel defaultSize={28} minSize={18}>
+              <div className="bg-fm-surface-secondary flex h-full flex-col">
+                <div className="border-fm-divider-secondary border-b px-4 py-3">
+                  <p className="text-fm-primary font-fm-brand text-fm-sm leading-fm-sm font-semibold tracking-widest uppercase">
+                    Library
                   </p>
                 </div>
+                <nav className="flex-1 space-y-1 p-3">
+                  {[
+                    { icon: MusicalNoteIcon, label: "Songs" },
+                    { icon: HeartIcon, label: "Favorites" },
+                    { icon: SearchIcon, label: "Discover" },
+                    { icon: SettingIcon, label: "Settings" },
+                  ].map(({ icon: Icon, label }) => (
+                    <button
+                      key={label}
+                      className="text-fm-secondary hover:text-fm-primary hover:bg-fm-surface-primary font-fm-text text-fm-sm leading-fm-sm flex w-full items-center gap-2 rounded-lg px-3 py-2 transition-colors"
+                    >
+                      <Icon className="h-4 w-4 shrink-0" />
+                      {label}
+                    </button>
+                  ))}
+                </nav>
               </div>
             </ResizablePanel>
             <ResizableHandle withHandle />
-            <ResizablePanel defaultSize={60}>
-              <div className="flex h-full items-center justify-center bg-purple-500/10 p-4">
-                <div className="text-center">
-                  <h5 className="text-md text-fm-primary font-medium">
-                    Right Panel
-                  </h5>
-                  <p className="text-fm-secondary mt-1 text-xs">
-                    Focus ring visible when handle is focused
+            {/* Main content */}
+            <ResizablePanel defaultSize={72}>
+              <div className="bg-fm-surface-primary flex h-full flex-col">
+                <div className="border-fm-divider-secondary border-b px-4 py-3">
+                  <p className="text-fm-primary font-fm-brand text-fm-sm leading-fm-sm font-semibold tracking-widest uppercase">
+                    Songs
                   </p>
                 </div>
+                <div className="flex-1 space-y-1 overflow-auto p-3">
+                  {[
+                    {
+                      title: "Midnight Drive",
+                      artist: "Nova Wave",
+                      duration: "3:42",
+                    },
+                    {
+                      title: "Electric Haze",
+                      artist: "The Circuits",
+                      duration: "4:15",
+                    },
+                    {
+                      title: "Neon Pulse",
+                      artist: "Synthcore",
+                      duration: "3:58",
+                    },
+                    {
+                      title: "Deep Current",
+                      artist: "Ocean Mind",
+                      duration: "5:02",
+                    },
+                  ].map((song) => (
+                    <div
+                      key={song.title}
+                      className="hover:bg-fm-surface-secondary flex items-center justify-between rounded-lg px-3 py-2 transition-colors"
+                    >
+                      <div className="flex items-center gap-3">
+                        <div className="bg-fm-surface-secondary border-fm-divider-secondary flex h-8 w-8 shrink-0 items-center justify-center rounded-md border">
+                          <MusicalNoteIcon className="text-fm-tertiary h-4 w-4" />
+                        </div>
+                        <div>
+                          <p className="text-fm-primary font-fm-text text-fm-sm leading-fm-sm">
+                            {song.title}
+                          </p>
+                          <p className="text-fm-tertiary font-fm-text text-fm-sm leading-fm-sm">
+                            {song.artist}
+                          </p>
+                        </div>
+                      </div>
+                      <span className="text-fm-tertiary font-fm-text text-fm-sm leading-fm-sm">
+                        {song.duration}
+                      </span>
+                    </div>
+                  ))}
+                </div>
               </div>
             </ResizablePanel>
           </ResizablePanelGroup>
         </div>
-
-        <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-4">
-          <h4 className="text-fm-secondary mb-3 text-sm font-medium">
-            Screen Reader Support
-          </h4>
-          <div className="text-fm-secondary space-y-1 text-xs">
-            <p>• Resize handles have proper ARIA labels</p>
-            <p>• Panel relationships are properly communicated</p>
-            <p>• Size changes are announced to screen readers</p>
-            <p>• Keyboard instructions are provided contextually</p>
-          </div>
-        </div>
       </div>
-    </div>
-  ),
-  parameters: {
-    docs: {
-      description: {
-        story:
-          "Demonstration of accessibility features including keyboard navigation, focus management, and screen reader support.",
-      },
-    },
-  },
-}
-
-// 8. Interactive Playground
-export const InteractivePlayground: Story = {
-  render: () => {
-    const [sizes, setSizes] = React.useState([25, 50, 25])
-
-    return (
-      <div className="space-y-6 p-8">
-        <h3 className="text-fm-primary text-center text-lg font-medium">
-          Interactive Playground
-        </h3>
-
-        <div className="border-fm-divider-secondary bg-fm-surface-secondary rounded-lg border p-4">
-          <h4 className="text-fm-secondary mb-2 text-sm font-medium">
-            Current Panel Sizes
-          </h4>
-          <div className="grid grid-cols-3 gap-4 text-xs">
-            <div className="text-center">
-              <div className="text-fm-primary">Left Panel</div>
-              <div className="text-fm-info font-mono">
-                {sizes[0].toFixed(1)}%
-              </div>
-            </div>
-            <div className="text-center">
-              <div className="text-fm-primary">Center Panel</div>
-              <div className="text-fm-positive font-mono">
-                {sizes[1].toFixed(1)}%
-              </div>
-            </div>
-            <div className="text-center">
-              <div className="text-fm-primary">Right Panel</div>
-              <div className="text-fm-icon-brand-secondary font-mono">
-                {sizes[2].toFixed(1)}%
-              </div>
-            </div>
-          </div>
-        </div>
 
-        <div className="h-64">
-          <ResizablePanelGroup
-            direction="horizontal"
-            className="border-fm-divider-secondary overflow-hidden rounded-lg border"
-            onLayout={(newSizes) => setSizes(newSizes)}
-          >
-            <ResizablePanel defaultSize={25} minSize={15}>
-              <div className="flex h-full items-center justify-center bg-blue-500/10 p-4">
-                <div className="text-center">
-                  <h5 className="text-md text-fm-primary font-medium">
-                    Panel 1
-                  </h5>
-                  <p className="text-fm-secondary mt-1 text-xs">Min: 15%</p>
-                  <div className="mx-auto mt-3 flex h-16 w-16 items-center justify-center rounded-full bg-blue-500/20">
-                    <span className="text-fm-info font-mono text-xs">
-                      {sizes[0]?.toFixed(0)}%
-                    </span>
-                  </div>
+      {/* Inspector panel — track detail */}
+      <div className="space-y-3">
+        <h4 className="text-fm-secondary font-fm-text text-fm-md leading-fm-md font-medium">
+          Inspector Panel
+        </h4>
+        <div className="border-fm-divider-secondary h-64 overflow-hidden rounded-xl border">
+          <ResizablePanelGroup direction="horizontal">
+            {/* Track list */}
+            <ResizablePanel defaultSize={55}>
+              <div className="bg-fm-surface-primary flex h-full flex-col">
+                <div className="border-fm-divider-secondary border-b px-4 py-3">
+                  <p className="text-fm-primary font-fm-brand text-fm-sm leading-fm-sm font-semibold tracking-widest uppercase">
+                    Track List
+                  </p>
                 </div>
-              </div>
-            </ResizablePanel>
-            <ResizableHandle withHandle />
-
-            <ResizablePanel defaultSize={50}>
-              <div className="flex h-full items-center justify-center bg-green-500/10 p-4">
-                <div className="text-center">
-                  <h5 className="text-md text-fm-primary font-medium">
-                    Panel 2
-                  </h5>
-                  <p className="text-fm-secondary mt-1 text-xs">Flexible</p>
-                  <div className="mx-auto mt-3 flex h-16 w-16 items-center justify-center rounded-full bg-green-500/20">
-                    <span className="text-fm-positive font-mono text-xs">
-                      {sizes[1]?.toFixed(0)}%
-                    </span>
-                  </div>
+                <div className="flex-1 space-y-1 p-3">
+                  {["Midnight Drive", "Electric Haze", "Neon Pulse"].map(
+                    (title, i) => (
+                      <div
+                        key={title}
+                        className={`flex items-center gap-3 rounded-lg px-3 py-2 transition-colors ${i === 0 ? "bg-fm-surface-secondary" : "hover:bg-fm-surface-secondary"}`}
+                      >
+                        <span className="text-fm-tertiary font-fm-text text-fm-sm leading-fm-sm w-4">
+                          {i + 1}
+                        </span>
+                        <p
+                          className={`font-fm-text text-fm-sm leading-fm-sm ${i === 0 ? "text-fm-primary" : "text-fm-secondary"}`}
+                        >
+                          {title}
+                        </p>
+                      </div>
+                    )
+                  )}
                 </div>
               </div>
             </ResizablePanel>
             <ResizableHandle withHandle />
-
-            <ResizablePanel defaultSize={25} minSize={20}>
-              <div className="flex h-full items-center justify-center bg-purple-500/10 p-4">
-                <div className="text-center">
-                  <h5 className="text-md text-fm-primary font-medium">
-                    Panel 3
-                  </h5>
-                  <p className="text-fm-secondary mt-1 text-xs">Min: 20%</p>
-                  <div className="mx-auto mt-3 flex h-16 w-16 items-center justify-center rounded-full bg-purple-500/20">
-                    <span className="text-fm-icon-brand-secondary font-mono text-xs">
-                      {sizes[2]?.toFixed(0)}%
-                    </span>
-                  </div>
+            {/* Inspector */}
+            <ResizablePanel defaultSize={45} minSize={30}>
+              <div className="bg-fm-surface-secondary flex h-full flex-col">
+                <div className="border-fm-divider-secondary border-b px-4 py-3">
+                  <p className="text-fm-primary font-fm-brand text-fm-sm leading-fm-sm font-semibold tracking-widest uppercase">
+                    Inspector
+                  </p>
+                </div>
+                <div className="flex-1 space-y-3 p-4">
+                  {[
+                    { label: "Title", value: "Midnight Drive" },
+                    { label: "Artist", value: "Nova Wave" },
+                    { label: "Duration", value: "3:42" },
+                    { label: "BPM", value: "128" },
+                    { label: "Key", value: "A minor" },
+                  ].map(({ label, value }) => (
+                    <div
+                      key={label}
+                      className="flex items-center justify-between"
+                    >
+                      <span className="text-fm-tertiary font-fm-text text-fm-sm leading-fm-sm">
+                        {label}
+                      </span>
+                      <span className="text-fm-primary font-fm-text text-fm-sm leading-fm-sm">
+                        {value}
+                      </span>
+                    </div>
+                  ))}
                 </div>
               </div>
             </ResizablePanel>
           </ResizablePanelGroup>
         </div>
+      </div>
 
-        <div className="text-fm-secondary text-center text-xs">
-          <p>
-            Drag the handles to resize panels and see the live size updates
-            above!
-          </p>
+      {/* Waveform editor layout */}
+      <div className="space-y-3">
+        <h4 className="text-fm-secondary font-fm-text text-fm-md leading-fm-md font-medium">
+          Waveform Editor Layout
+        </h4>
+        <div className="border-fm-divider-secondary h-80 overflow-hidden rounded-xl border">
+          <ResizablePanelGroup direction="horizontal">
+            {/* Tools sidebar */}
+            <ResizablePanel defaultSize={20} minSize={15}>
+              <div className="bg-fm-surface-secondary flex h-full flex-col items-center gap-3 px-2 py-4">
+                <p className="text-fm-tertiary font-fm-text text-fm-sm leading-fm-sm writing-mode-vertical-lr hidden rotate-180">
+                  Tools
+                </p>
+                {[MusicalNoteIcon, HeartIcon, AlertIcon, SettingIcon].map(
+                  (Icon, i) => (
+                    <button
+                      key={i}
+                      className="text-fm-secondary hover:text-fm-primary hover:bg-fm-surface-primary rounded-lg p-2 transition-colors"
+                    >
+                      <Icon className="h-4 w-4" />
+                    </button>
+                  )
+                )}
+              </div>
+            </ResizablePanel>
+            <ResizableHandle withHandle />
+            {/* Main editor area */}
+            <ResizablePanel defaultSize={80}>
+              <ResizablePanelGroup direction="vertical">
+                {/* Waveform */}
+                <ResizablePanel defaultSize={60}>
+                  <div className="bg-fm-surface-primary flex h-full flex-col">
+                    <div className="border-fm-divider-secondary flex items-center gap-3 border-b px-4 py-2">
+                      <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                        Waveform — Midnight Drive.flac
+                      </p>
+                    </div>
+                    <div className="flex flex-1 items-center justify-center gap-1 px-6">
+                      {Array.from({ length: 48 }, (_, i) => {
+                        const h = 20 + Math.abs(Math.sin(i * 0.4 + 1) * 60)
+                        return (
+                          <div
+                            key={i}
+                            className="bg-fm-surface-info-sec w-1 shrink-0 rounded-full"
+                            style={{ height: `${h}%` }}
+                          />
+                        )
+                      })}
+                    </div>
+                    {/* Transport bar */}
+                    <div className="border-fm-divider-secondary flex items-center justify-center gap-4 border-t px-4 py-2">
+                      <button className="text-fm-secondary hover:text-fm-primary transition-colors outline-none">
+                        <SkipBackwardIcon className="h-4 w-4" />
+                      </button>
+                      <button className="text-fm-primary hover:text-fm-secondary transition-colors outline-none">
+                        <PauseIcon className="h-4 w-4" />
+                      </button>
+                      <button className="text-fm-secondary hover:text-fm-primary transition-colors outline-none">
+                        <SkipForwardIcon className="h-4 w-4" />
+                      </button>
+                      <button className="text-fm-secondary hover:text-fm-primary transition-colors outline-none">
+                        <VolumeFullIcon className="h-4 w-4" />
+                      </button>
+                    </div>
+                  </div>
+                </ResizablePanel>
+                <ResizableHandle withHandle />
+                {/* Timeline / markers */}
+                <ResizablePanel defaultSize={40} minSize={20}>
+                  <div className="bg-fm-surface-secondary flex h-full flex-col">
+                    <div className="border-fm-divider-secondary border-b px-4 py-2">
+                      <p className="text-fm-secondary font-fm-text text-fm-sm leading-fm-sm">
+                        Markers &amp; Regions
+                      </p>
+                    </div>
+                    <div className="flex-1 space-y-2 p-4">
+                      {[
+                        {
+                          label: "Intro",
+                          time: "0:00",
+                          color: "bg-fm-surface-info-sec",
+                        },
+                        {
+                          label: "Verse",
+                          time: "0:32",
+                          color: "bg-fm-surface-positive-sec",
+                        },
+                        {
+                          label: "Chorus",
+                          time: "1:12",
+                          color: "bg-fm-surface-warning-sec",
+                        },
+                      ].map(({ label, time, color }) => (
+                        <div key={label} className="flex items-center gap-3">
+                          <div
+                            className={`h-3 w-3 rounded-sm ${color} shrink-0`}
+                          />
+                          <span className="text-fm-primary font-fm-text text-fm-sm leading-fm-sm">
+                            {label}
+                          </span>
+                          <span className="text-fm-tertiary font-fm-text text-fm-sm leading-fm-sm ml-auto">
+                            {time}
+                          </span>
+                        </div>
+                      ))}
+                    </div>
+                  </div>
+                </ResizablePanel>
+              </ResizablePanelGroup>
+            </ResizablePanel>
+          </ResizablePanelGroup>
         </div>
       </div>
-    )
-  },
+    </div>
+  ),
   parameters: {
     docs: {
       description: {
         story:
-          "Interactive playground showing real-time panel size updates and demonstrating the onLayout callback functionality.",
+          "Real audio app split views: a collapsible sidebar + main library browser, a track list + inspector panel pair, and a waveform editor with tool sidebar, waveform canvas, transport controls, and a resizable marker region below.",
       },
     },
   },