@app-studio/web 0.9.31 → 0.9.33

package/docs/components/DropdownMenu.mdx

@@ -0,0 +1,205 @@
+# DropdownMenu
+
+A dropdown menu component that appears when clicking on a trigger element.
+
+### **Import**
+  ```tsx
+  import { DropdownMenu } from '@app-studio/web';
+  ```
+
+### **Default**
+```tsx
+import React from 'react';
+import { DropdownMenu } from '../DropdownMenu';
+import { Button } from '../../Button/Button';
+import { CopyIcon, EditIcon, DeleteIcon } from '../../Icon/Icon';
+
+export const DefaultDropdownMenu = () => {
+  const items = [
+    {
+      id: 'copy',
+      label: 'Copy',
+      icon: <CopyIcon widthHeight={16} />,
+      onClick: () => alert('Copy clicked')
+    },
+    {
+      id: 'edit',
+      label: 'Edit',
+      icon: <EditIcon widthHeight={16} />,
+      onClick: () => alert('Edit clicked')
+    },
+    {
+      id: 'divider-1',
+      divider: true
+    },
+    {
+      id: 'delete',
+      label: 'Delete',
+      icon: <DeleteIcon widthHeight={16} />,
+      onClick: () => alert('Delete clicked')
+    }
+  ];
+
+  return (
+    <DropdownMenu 
+      trigger={<Button>Open Menu</Button>}
+      items={items}
+    />
+  );
+};
+```
+
+### **Submenu**
+Create nested dropdown menus with submenus.
+
+```tsx
+import React from 'react';
+import { DropdownMenu } from '../DropdownMenu';
+import { Button } from '../../Button/Button';
+import { 
+  CopyIcon, 
+  EditIcon, 
+  DownloadIcon, 
+  ShareIcon 
+} from '../../Icon/Icon';
+
+export const SubmenuDropdownMenu = () => {
+  const items = [
+    {
+      id: 'copy',
+      label: 'Copy',
+      icon: <CopyIcon widthHeight={16} />,
+      onClick: () => alert('Copy clicked')
+    },
+    {
+      id: 'edit',
+      label: 'Edit',
+      icon: <EditIcon widthHeight={16} />,
+      onClick: () => alert('Edit clicked')
+    },
+    {
+      id: 'more',
+      label: 'More Options',
+      items: [
+        {
+          id: 'download',
+          label: 'Download',
+          icon: <DownloadIcon widthHeight={16} />,
+          onClick: () => alert('Download clicked')
+        },
+        {
+          id: 'share',
+          label: 'Share',
+          icon: <ShareIcon widthHeight={16} />,
+          onClick: () => alert('Share clicked')
+        }
+      ]
+    }
+  ];
+
+  return (
+    <DropdownMenu 
+      trigger={<Button>Open Menu</Button>}
+      items={items}
+    />
+  );
+};
+```
+
+### **Positioning**
+Control the position and alignment of the dropdown menu.
+
+```tsx
+import React from 'react';
+import { DropdownMenu } from '../DropdownMenu';
+import { Button } from '../../Button/Button';
+import { CopyIcon, EditIcon } from '../../Icon/Icon';
+
+export const PositionedDropdownMenu = () => {
+  const items = [
+    {
+      id: 'copy',
+      label: 'Copy',
+      icon: <CopyIcon widthHeight={16} />,
+      onClick: () => alert('Copy clicked')
+    },
+    {
+      id: 'edit',
+      label: 'Edit',
+      icon: <EditIcon widthHeight={16} />,
+      onClick: () => alert('Edit clicked')
+    }
+  ];
+
+  return (
+    <>
+      <DropdownMenu 
+        trigger={<Button>Bottom (Default)</Button>}
+        items={items}
+        side="bottom"
+        align="start"
+      />
+      
+      <DropdownMenu 
+        trigger={<Button>Top Center</Button>}
+        items={items}
+        side="top"
+        align="center"
+      />
+      
+      <DropdownMenu 
+        trigger={<Button>Right End</Button>}
+        items={items}
+        side="right"
+        align="end"
+      />
+    </>
+  );
+};
+```
+
+### **Custom Styling**
+Customize the appearance of the dropdown menu.
+
+```tsx
+import React from 'react';
+import { DropdownMenu } from '../DropdownMenu';
+import { Button } from '../../Button/Button';
+import { CopyIcon, EditIcon } from '../../Icon/Icon';
+
+export const CustomDropdownMenu = () => {
+  const items = [
+    {
+      id: 'copy',
+      label: 'Copy',
+      icon: <CopyIcon widthHeight={16} />,
+      onClick: () => alert('Copy clicked')
+    },
+    {
+      id: 'edit',
+      label: 'Edit',
+      icon: <EditIcon widthHeight={16} />,
+      onClick: () => alert('Edit clicked')
+    }
+  ];
+
+  return (
+    <DropdownMenu 
+      trigger={<Button variant="outline">Custom Menu</Button>}
+      items={items}
+      views={{
+        menu: {
+          backgroundColor: 'color.blue',
+          color: 'color.white',
+          borderRadius: '8px',
+        },
+        item: {
+          _hover: {
+            backgroundColor: 'rgba(255, 255, 255, 0.1)',
+          }
+        }
+      }}
+    />
+  );
+};
+```

package/docs/components/File.mdx

@@ -0,0 +1,8 @@
+# File
+
+File component.
+
+### **Import**
+  \`\`\`tsx
+  import { File } from '@app-studio/web';
+  \`\`\`

package/docs/components/Flow.mdx

@@ -0,0 +1,257 @@
+# Flow
+
+A component for creating interactive workflow diagrams and flowcharts with support for node connections, drag-and-drop functionality, and viewport controls.
+
+### **Import**
+  ```tsx
+  import { Flow } from '@app-studio/web';
+  ```
+
+### **Basic Usage**
+```tsx
+import React, { useState } from 'react';
+import { Flow } from '@app-studio/web';
+import { View } from 'app-studio';
+
+export const BasicFlow = () => {
+  // Initial nodes and edges
+  const [nodes, setNodes] = useState([
+    {
+      id: 'node-1',
+      position: { x: 50, y: 50 },
+      data: { 
+        label: 'Start Node', 
+        subtitle: 'Begin here' 
+      },
+    },
+    {
+      id: 'node-2',
+      position: { x: 50, y: 200 },
+      data: { 
+        label: 'Process Node', 
+        subtitle: 'Do something' 
+      },
+    },
+  ]);
+
+  const [edges, setEdges] = useState([
+    { id: 'edge-1-2', source: 'node-1', target: 'node-2' },
+  ]);
+
+  return (
+    <View height="400px" border="1px solid" borderColor="color.gray.200" borderRadius={8}>
+      <Flow
+        nodes={nodes}
+        edges={edges}
+        onNodesChange={setNodes}
+        onEdgesChange={setEdges}
+      />
+    </View>
+  );
+};
+```
+
+### **With Node Addition**
+```tsx
+import React, { useState } from 'react';
+import { Flow } from '@app-studio/web';
+import { View } from 'app-studio';
+import { FlowNode } from '@app-studio/web';
+
+export const FlowWithNodeAddition = () => {
+  const [nodes, setNodes] = useState([
+    {
+      id: 'node-1',
+      position: { x: 50, y: 50 },
+      data: { label: 'Start', subtitle: 'Begin workflow' },
+    },
+    {
+      id: 'node-2',
+      position: { x: 50, y: 200 },
+      data: { label: 'Process', subtitle: 'Do something' },
+    },
+  ]);
+
+  const [edges, setEdges] = useState([
+    { id: 'edge-1-2', source: 'node-1', target: 'node-2' },
+  ]);
+
+  const [selectedNodeId, setSelectedNodeId] = useState(null);
+
+  return (
+    <View height="400px" border="1px solid" borderColor="color.gray.200" borderRadius={8}>
+      <Flow
+        nodes={nodes}
+        edges={edges}
+        onNodesChange={setNodes}
+        onEdgesChange={setEdges}
+        selectedNodeId={selectedNodeId}
+        onNodeSelect={setSelectedNodeId}
+        allowAddingNodes={true}
+        onNodeAdd={(newNode: FlowNode) => {
+          setNodes((prevNodes) => [...prevNodes, newNode]);
+        }}
+      />
+    </View>
+  );
+};
+```
+
+### **With Drag and Drop**
+```tsx
+import React, { useState } from 'react';
+import { Flow } from '@app-studio/web';
+import { View } from 'app-studio';
+import { FlowNode } from '@app-studio/web';
+
+export const FlowWithDragAndDrop = () => {
+  const [nodes, setNodes] = useState([
+    {
+      id: 'node-1',
+      position: { x: 250, y: 100 },
+      data: { label: 'Menu Item 1', subtitle: 'Drag to reorder' },
+      draggable: true,
+    },
+    {
+      id: 'node-2',
+      position: { x: 250, y: 250 },
+      data: { label: 'Menu Item 2', subtitle: 'Drag to reorder' },
+      draggable: true,
+    },
+  ]);
+
+  const [edges, setEdges] = useState([]);
+
+  return (
+    <View height="400px" border="1px solid" borderColor="color.gray.200" borderRadius={8}>
+      <Flow
+        nodes={nodes}
+        edges={edges}
+        onNodesChange={setNodes}
+        onEdgesChange={setEdges}
+        allowDraggingNodes={true}
+        onNodeDragStart={(nodeId) => console.log(`Started dragging: ${nodeId}`)}
+        onNodeDragEnd={(nodeId, position) => console.log(`Finished dragging: ${nodeId}`)}
+      />
+    </View>
+  );
+};
+```
+
+### **Props**
+
+| Prop | Type | Default | Description |
+| ---- | ---- | ------- | ----------- |
+| nodes | FlowNode[] | [] | Array of nodes in the flow |
+| edges | NodeConnection[] | [] | Array of edges/connections between nodes |
+| size | 'sm' \| 'md' \| 'lg' | 'md' | Size of the flow nodes |
+| variant | 'default' \| 'outline' \| 'filled' | 'default' | Visual variant of the flow nodes |
+| direction | 'horizontal' \| 'vertical' | 'vertical' | Direction of the flow layout |
+| showControls | boolean | true | Whether to show viewport controls (zoom in/out, reset) |
+| allowAddingNodes | boolean | true | Whether to allow adding new nodes |
+| allowDraggingNodes | boolean | true | Whether to allow dragging nodes |
+| selectedNodeId | string | undefined | ID of the currently selected node |
+| onNodeSelect | (nodeId: string \| null) => void | undefined | Callback when a node is selected |
+| onNodesChange | (nodes: FlowNode[]) => void | undefined | Callback when nodes change |
+| onEdgesChange | (edges: NodeConnection[]) => void | undefined | Callback when edges change |
+| onNodeAdd | (node: FlowNode) => void | undefined | Callback when a node is added |
+| onNodeDragStart | (nodeId: string) => void | undefined | Callback when node dragging starts |
+| onNodeDrag | (nodeId: string, position: NodePosition) => void | undefined | Callback during node dragging |
+| onNodeDragEnd | (nodeId: string, position: NodePosition) => void | undefined | Callback when node dragging ends |
+| viewport | FlowViewport | { zoom: 1, x: 0, y: 0 } | Current viewport state (zoom level and position) |
+| onViewportChange | (viewport: FlowViewport) => void | undefined | Callback when viewport changes |
+| views | object | {} | Custom styling for different parts of the component |
+
+### **Node Structure**
+
+The `FlowNode` interface defines the structure of nodes in the Flow component:
+
+```tsx
+interface FlowNode {
+  id: string;
+  type?: 'default' | 'start' | 'end' | 'decision' | 'process' | string;
+  position: { x: number; y: number };
+  data?: {
+    label?: string;
+    subtitle?: string;
+    icon?: React.ReactNode;
+    number?: number;
+    [key: string]: any;
+  };
+  selected?: boolean;
+  isDragging?: boolean;
+  draggable?: boolean;
+  style?: ViewProps;
+}
+```
+
+### **Edge Structure**
+
+The `NodeConnection` interface defines the structure of edges in the Flow component:
+
+```tsx
+interface NodeConnection {
+  id: string;
+  source: string;
+  target: string;
+  label?: string;
+  style?: ViewProps;
+}
+```
+
+### **Compound Components**
+
+The Flow component uses a compound component pattern with the following sub-components:
+
+```tsx
+// These are primarily for potential direct use or a more componentized future version
+Flow.Node       // Renders a single node
+Flow.Edge       // Renders a connection between nodes
+Flow.Controls   // Renders viewport controls
+Flow.AddNodeButton // Renders a button to add a new node
+```
+
+### **Customization**
+
+The Flow component can be customized using the `views` prop:
+
+```tsx
+<Flow
+  // ...other props
+  views={{
+    container: { /* styles for the main flow container */ },
+    node: {
+      container: { /* styles for the node's root View */ },
+      content: { /* styles for the content wrapper inside the node */ },
+      icon: { /* styles for the node's icon View */ },
+    },
+    edge: {
+      path: { /* styles for the SVG path */ },
+      label: { /* styles for the edge label */ },
+    },
+    controls: {
+      container: { /* styles for the controls container */ },
+      button: { /* styles for individual control buttons */ },
+    },
+    addNodeButton: { /* styles for the add node button */ },
+  }}
+/>
+```
+
+### **Accessibility**
+
+The Flow component implements the following accessibility features:
+
+- Keyboard navigation for selecting nodes
+- ARIA attributes for interactive elements
+- Focus management for controls and nodes
+- Proper contrast for node and edge colors
+
+### **Best Practices**
+
+- Provide clear labels and subtitles for nodes to improve understanding
+- Use consistent node types and styling for similar functionality
+- Implement proper error handling for node and edge operations
+- Consider viewport size when determining initial node positions
+- Use the `onNodeAdd` callback to validate new node positions
+- Implement undo/redo functionality for node operations when needed