vfs-kit 1.0.1 → 1.0.3

package/dist/components/index.d.mts

@@ -0,0 +1,193 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { b as VfsFileNode, e as VfsNode } from '../VfsNode-D10gxL5W.mjs';
+import { a as VfsTab } from '../useVfsTabs-ZHDaLrM1.mjs';
+import { KeyboardEvent } from 'react';
+
+interface InlineInputProps {
+    initialValue?: string;
+    onSubmit: (value: string) => void;
+    onComplete: () => void;
+    validate?: (value: string) => string | null;
+    icon?: React.ReactNode;
+    className?: string;
+    selectOnMount?: boolean;
+    trim?: boolean;
+}
+declare function InlineInput({ initialValue, onSubmit, onComplete, validate, icon, className, selectOnMount, trim, }: InlineInputProps): react_jsx_runtime.JSX.Element;
+
+interface FileRendererRenderProps<TMeta = Record<string, unknown>> {
+    node: VfsFileNode<TMeta>;
+    content: Uint8Array | null;
+    loading: boolean;
+    error: Error | null;
+}
+interface FileRendererBaseProps<TMeta = Record<string, unknown>> {
+    node: VfsFileNode<TMeta> | null;
+    content?: Uint8Array | null;
+    children: (props: FileRendererRenderProps<TMeta>) => React.ReactNode;
+    fallback?: React.ReactNode;
+    onLoad?: (node: VfsFileNode<TMeta>, content: Uint8Array) => void;
+    onError?: (node: VfsFileNode<TMeta>, error: Error) => void;
+}
+declare function FileRendererBase<TMeta = Record<string, unknown>>({ node, content: externalContent, children, fallback, onLoad, onError, }: FileRendererBaseProps<TMeta>): react_jsx_runtime.JSX.Element;
+interface FileRendererProps<TMeta = Record<string, unknown>> extends Omit<FileRendererBaseProps<TMeta>, "node" | "content"> {
+    workspaceId?: string;
+}
+interface FileRendererProps<TMeta = Record<string, unknown>> extends Omit<FileRendererBaseProps<TMeta>, "node" | "content"> {
+    workspaceId?: string;
+    activeNodeId: string | null;
+}
+declare function FileRenderer<TMeta extends Record<string, unknown> | undefined = Record<string, unknown>>({ workspaceId, activeNodeId, children, fallback, onLoad, onError, }: FileRendererProps<TMeta>): react_jsx_runtime.JSX.Element;
+
+interface TabRenderProps {
+    tabs: VfsTab[];
+    activeTabId: string | null;
+    activeTab: VfsTab | null;
+    dragHandleProps: (tabId: string) => Record<string, unknown>;
+    onClose: (tabId: string) => void;
+    onSetActive: (tabId: string) => void;
+    onLock: (tabId: string) => void;
+    onUnlock: (tabId: string) => void;
+}
+interface TabListBaseProps {
+    tabs: VfsTab[];
+    activeTabId: string | null;
+    onReorder: (activeId: string, overId: string) => void;
+    onClose: (tabId: string) => void;
+    onSetActive: (tabId: string) => void;
+    onLock: (tabId: string) => void;
+    onUnlock: (tabId: string) => void;
+    sortable?: boolean;
+    children?: (props: TabRenderProps) => React.ReactNode;
+    className?: string;
+}
+interface TabListProps {
+    workspaceIds?: string[];
+    sortable?: boolean;
+    children?: (props: TabRenderProps) => React.ReactNode;
+    className?: string;
+}
+declare function TabListBase({ tabs, activeTabId, onReorder, onClose, onSetActive, onLock, onUnlock, sortable, children, className, }: TabListBaseProps): react_jsx_runtime.JSX.Element;
+declare function TabList({ workspaceIds, sortable, children, className, }: TabListProps): react_jsx_runtime.JSX.Element;
+
+interface FlatNode<TMeta = Record<string, unknown>> {
+    node: VfsNode<TMeta>;
+    level: number;
+    index: number;
+    isOpen: boolean;
+    hasChildren: boolean;
+}
+interface NodeRenderProps<TMeta = Record<string, unknown>> {
+    flatNode: FlatNode<TMeta>;
+    isSelected: boolean;
+    isActive: boolean;
+    isDragging: boolean;
+    isOver: boolean;
+    isOverBlocked: boolean;
+    isRenaming: boolean;
+    setRenaming: (v: boolean) => void;
+    dragHandleProps: Record<string, unknown>;
+    style: React.CSSProperties;
+    onClick: (e: React.MouseEvent) => void;
+    /** True while ANY drag is in progress — use to suppress hover styles */
+    isDragSession: boolean;
+}
+interface FileTreeRenderProps<TMeta = Record<string, unknown>> {
+    flatNodes: FlatNode<TMeta>[];
+    renderNode: (flatNode: FlatNode<TMeta>) => React.ReactNode;
+}
+interface KeyboardHandler<TMeta> {
+    (e: KeyboardEvent, node: VfsNode<TMeta>, defaultHandler: (e: KeyboardEvent, node: VfsNode<TMeta>) => void): void;
+}
+interface VirtualizerOverride {
+    itemHeight: number;
+    renderItems: (items: {
+        index: number;
+        start: number;
+        size: number;
+    }[], totalSize: number, renderItem: (index: number) => React.ReactNode) => React.ReactNode;
+}
+type FolderOverlayMode = "header" | "body" | "full";
+interface FolderOverlayRenderProps<TMeta = Record<string, unknown>> {
+    targetFolder: VfsNode<TMeta>;
+    visibleRowCount: number;
+    isEmpty: boolean;
+    mode: FolderOverlayMode;
+    isBlocked: boolean;
+}
+interface FolderOverlayProps<TMeta = Record<string, unknown>> {
+    mode: FolderOverlayMode;
+    renderOverlay?: (props: FolderOverlayRenderProps<TMeta>) => React.ReactNode;
+    emptyStateHeight?: number;
+}
+interface InlineCreateState {
+    kind: "file" | "folder";
+    /**
+     * The folder to create inside. null = root level.
+     * FileTree resolves this automatically from the active selection —
+     * consumers just pass { kind } and FileTree fills in parentId.
+     */
+    parentId: string | null;
+}
+interface FileTreeBaseProps<TMeta = Record<string, unknown>> {
+    nodes: Map<string, VfsNode<TMeta>>;
+    childIndex: Map<string, string[]>;
+    rootIds: string[];
+    expandedIds: Set<string>;
+    selection: string[];
+    activeNodeId: string | null;
+    renamingId: string | null;
+    onExpand: (id: string) => void;
+    onCollapse: (id: string) => void;
+    onSelect: (id: string) => void;
+    onToggle: (id: string) => void;
+    onRangeSelect: (orderedIds: string[], anchorId: string, targetId: string) => void;
+    onOpen: (node: VfsNode<TMeta>) => void;
+    onRename: (id: string, newName: string) => void;
+    onDelete: (ids: string[]) => void;
+    onMove: (ids: string[], targetId: string | null) => void;
+    onReorder: (parentId: string | null, orderedIds: string[]) => void;
+    onSetRenaming: (id: string | null) => void;
+    onCreate: (kind: "file" | "folder", parentId: string | null, name: string) => Promise<void>;
+    inlineCreate?: InlineCreateState | null;
+    onCancelCreate: () => void;
+    sortable?: boolean;
+    draggable?: boolean;
+    virtualized?: boolean;
+    virtualizer?: VirtualizerOverride;
+    itemHeight?: number;
+    renderNode?: (props: NodeRenderProps<TMeta>) => React.ReactNode;
+    renderActions?: (node: VfsNode<TMeta>) => React.ReactNode;
+    renderEmpty?: () => React.ReactNode;
+    children?: (props: FileTreeRenderProps<TMeta>) => React.ReactNode;
+    onKeyDown?: KeyboardHandler<TMeta>;
+    className?: string;
+    folderOverlay?: FolderOverlayProps<TMeta>;
+}
+interface FileTreeProps<TMeta = Record<string, unknown>> {
+    workspaceId?: string;
+    sortable?: boolean;
+    draggable?: boolean;
+    virtualized?: boolean;
+    virtualizer?: VirtualizerOverride;
+    itemHeight?: number;
+    renderNode?: (props: NodeRenderProps<TMeta>) => React.ReactNode;
+    renderActions?: (node: VfsNode<TMeta>) => React.ReactNode;
+    renderEmpty?: () => React.ReactNode;
+    children?: (props: FileTreeRenderProps<TMeta>) => React.ReactNode;
+    onKeyDown?: KeyboardHandler<TMeta>;
+    className?: string;
+    folderOverlay?: FolderOverlayProps<TMeta>;
+    /**
+     * Pass { kind } only — FileTree resolves parentId from the active
+     * selection automatically. Pass null to hide the input.
+     */
+    inlineCreate?: Pick<InlineCreateState, "kind"> | null;
+    onCancelCreate?: () => void;
+}
+
+declare function FileTree<TMeta extends Record<string, unknown> | undefined = Record<string, unknown>>({ workspaceId, inlineCreate: inlineCreateProp, onCancelCreate, ...rest }: FileTreeProps<TMeta>): react_jsx_runtime.JSX.Element;
+
+declare function FileTreeBase<TMeta = Record<string, unknown>>({ nodes, childIndex, rootIds, expandedIds, selection, activeNodeId, renamingId, onExpand, onCollapse, onSelect, onToggle, onRangeSelect, onOpen, onRename, onDelete, onMove, onReorder, onSetRenaming, onCreate, inlineCreate, onCancelCreate, sortable, draggable, virtualized, virtualizer: virtualizerOverride, itemHeight, renderNode, renderActions, renderEmpty, children, onKeyDown: customKeyDown, className, folderOverlay, }: FileTreeBaseProps<TMeta>): react_jsx_runtime.JSX.Element;
+
+export { FileRenderer, FileRendererBase, type FileRendererBaseProps, type FileRendererProps, type FileRendererRenderProps, FileTree, FileTreeBase, type FileTreeBaseProps, type FileTreeProps, type FileTreeRenderProps, type FlatNode, InlineInput, type InlineInputProps, type KeyboardHandler, type NodeRenderProps, TabList, TabListBase, type TabListBaseProps, type TabListProps, type TabRenderProps, type VirtualizerOverride };

package/dist/components/index.d.ts

@@ -0,0 +1,193 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { b as VfsFileNode, e as VfsNode } from '../VfsNode-D10gxL5W.js';
+import { a as VfsTab } from '../useVfsTabs-ZHDaLrM1.js';
+import { KeyboardEvent } from 'react';
+
+interface InlineInputProps {
+    initialValue?: string;
+    onSubmit: (value: string) => void;
+    onComplete: () => void;
+    validate?: (value: string) => string | null;
+    icon?: React.ReactNode;
+    className?: string;
+    selectOnMount?: boolean;
+    trim?: boolean;
+}
+declare function InlineInput({ initialValue, onSubmit, onComplete, validate, icon, className, selectOnMount, trim, }: InlineInputProps): react_jsx_runtime.JSX.Element;
+
+interface FileRendererRenderProps<TMeta = Record<string, unknown>> {
+    node: VfsFileNode<TMeta>;
+    content: Uint8Array | null;
+    loading: boolean;
+    error: Error | null;
+}
+interface FileRendererBaseProps<TMeta = Record<string, unknown>> {
+    node: VfsFileNode<TMeta> | null;
+    content?: Uint8Array | null;
+    children: (props: FileRendererRenderProps<TMeta>) => React.ReactNode;
+    fallback?: React.ReactNode;
+    onLoad?: (node: VfsFileNode<TMeta>, content: Uint8Array) => void;
+    onError?: (node: VfsFileNode<TMeta>, error: Error) => void;
+}
+declare function FileRendererBase<TMeta = Record<string, unknown>>({ node, content: externalContent, children, fallback, onLoad, onError, }: FileRendererBaseProps<TMeta>): react_jsx_runtime.JSX.Element;
+interface FileRendererProps<TMeta = Record<string, unknown>> extends Omit<FileRendererBaseProps<TMeta>, "node" | "content"> {
+    workspaceId?: string;
+}
+interface FileRendererProps<TMeta = Record<string, unknown>> extends Omit<FileRendererBaseProps<TMeta>, "node" | "content"> {
+    workspaceId?: string;
+    activeNodeId: string | null;
+}
+declare function FileRenderer<TMeta extends Record<string, unknown> | undefined = Record<string, unknown>>({ workspaceId, activeNodeId, children, fallback, onLoad, onError, }: FileRendererProps<TMeta>): react_jsx_runtime.JSX.Element;
+
+interface TabRenderProps {
+    tabs: VfsTab[];
+    activeTabId: string | null;
+    activeTab: VfsTab | null;
+    dragHandleProps: (tabId: string) => Record<string, unknown>;
+    onClose: (tabId: string) => void;
+    onSetActive: (tabId: string) => void;
+    onLock: (tabId: string) => void;
+    onUnlock: (tabId: string) => void;
+}
+interface TabListBaseProps {
+    tabs: VfsTab[];
+    activeTabId: string | null;
+    onReorder: (activeId: string, overId: string) => void;
+    onClose: (tabId: string) => void;
+    onSetActive: (tabId: string) => void;
+    onLock: (tabId: string) => void;
+    onUnlock: (tabId: string) => void;
+    sortable?: boolean;
+    children?: (props: TabRenderProps) => React.ReactNode;
+    className?: string;
+}
+interface TabListProps {
+    workspaceIds?: string[];
+    sortable?: boolean;
+    children?: (props: TabRenderProps) => React.ReactNode;
+    className?: string;
+}
+declare function TabListBase({ tabs, activeTabId, onReorder, onClose, onSetActive, onLock, onUnlock, sortable, children, className, }: TabListBaseProps): react_jsx_runtime.JSX.Element;
+declare function TabList({ workspaceIds, sortable, children, className, }: TabListProps): react_jsx_runtime.JSX.Element;
+
+interface FlatNode<TMeta = Record<string, unknown>> {
+    node: VfsNode<TMeta>;
+    level: number;
+    index: number;
+    isOpen: boolean;
+    hasChildren: boolean;
+}
+interface NodeRenderProps<TMeta = Record<string, unknown>> {
+    flatNode: FlatNode<TMeta>;
+    isSelected: boolean;
+    isActive: boolean;
+    isDragging: boolean;
+    isOver: boolean;
+    isOverBlocked: boolean;
+    isRenaming: boolean;
+    setRenaming: (v: boolean) => void;
+    dragHandleProps: Record<string, unknown>;
+    style: React.CSSProperties;
+    onClick: (e: React.MouseEvent) => void;
+    /** True while ANY drag is in progress — use to suppress hover styles */
+    isDragSession: boolean;
+}
+interface FileTreeRenderProps<TMeta = Record<string, unknown>> {
+    flatNodes: FlatNode<TMeta>[];
+    renderNode: (flatNode: FlatNode<TMeta>) => React.ReactNode;
+}
+interface KeyboardHandler<TMeta> {
+    (e: KeyboardEvent, node: VfsNode<TMeta>, defaultHandler: (e: KeyboardEvent, node: VfsNode<TMeta>) => void): void;
+}
+interface VirtualizerOverride {
+    itemHeight: number;
+    renderItems: (items: {
+        index: number;
+        start: number;
+        size: number;
+    }[], totalSize: number, renderItem: (index: number) => React.ReactNode) => React.ReactNode;
+}
+type FolderOverlayMode = "header" | "body" | "full";
+interface FolderOverlayRenderProps<TMeta = Record<string, unknown>> {
+    targetFolder: VfsNode<TMeta>;
+    visibleRowCount: number;
+    isEmpty: boolean;
+    mode: FolderOverlayMode;
+    isBlocked: boolean;
+}
+interface FolderOverlayProps<TMeta = Record<string, unknown>> {
+    mode: FolderOverlayMode;
+    renderOverlay?: (props: FolderOverlayRenderProps<TMeta>) => React.ReactNode;
+    emptyStateHeight?: number;
+}
+interface InlineCreateState {
+    kind: "file" | "folder";
+    /**
+     * The folder to create inside. null = root level.
+     * FileTree resolves this automatically from the active selection —
+     * consumers just pass { kind } and FileTree fills in parentId.
+     */
+    parentId: string | null;
+}
+interface FileTreeBaseProps<TMeta = Record<string, unknown>> {
+    nodes: Map<string, VfsNode<TMeta>>;
+    childIndex: Map<string, string[]>;
+    rootIds: string[];
+    expandedIds: Set<string>;
+    selection: string[];
+    activeNodeId: string | null;
+    renamingId: string | null;
+    onExpand: (id: string) => void;
+    onCollapse: (id: string) => void;
+    onSelect: (id: string) => void;
+    onToggle: (id: string) => void;
+    onRangeSelect: (orderedIds: string[], anchorId: string, targetId: string) => void;
+    onOpen: (node: VfsNode<TMeta>) => void;
+    onRename: (id: string, newName: string) => void;
+    onDelete: (ids: string[]) => void;
+    onMove: (ids: string[], targetId: string | null) => void;
+    onReorder: (parentId: string | null, orderedIds: string[]) => void;
+    onSetRenaming: (id: string | null) => void;
+    onCreate: (kind: "file" | "folder", parentId: string | null, name: string) => Promise<void>;
+    inlineCreate?: InlineCreateState | null;
+    onCancelCreate: () => void;
+    sortable?: boolean;
+    draggable?: boolean;
+    virtualized?: boolean;
+    virtualizer?: VirtualizerOverride;
+    itemHeight?: number;
+    renderNode?: (props: NodeRenderProps<TMeta>) => React.ReactNode;
+    renderActions?: (node: VfsNode<TMeta>) => React.ReactNode;
+    renderEmpty?: () => React.ReactNode;
+    children?: (props: FileTreeRenderProps<TMeta>) => React.ReactNode;
+    onKeyDown?: KeyboardHandler<TMeta>;
+    className?: string;
+    folderOverlay?: FolderOverlayProps<TMeta>;
+}
+interface FileTreeProps<TMeta = Record<string, unknown>> {
+    workspaceId?: string;
+    sortable?: boolean;
+    draggable?: boolean;
+    virtualized?: boolean;
+    virtualizer?: VirtualizerOverride;
+    itemHeight?: number;
+    renderNode?: (props: NodeRenderProps<TMeta>) => React.ReactNode;
+    renderActions?: (node: VfsNode<TMeta>) => React.ReactNode;
+    renderEmpty?: () => React.ReactNode;
+    children?: (props: FileTreeRenderProps<TMeta>) => React.ReactNode;
+    onKeyDown?: KeyboardHandler<TMeta>;
+    className?: string;
+    folderOverlay?: FolderOverlayProps<TMeta>;
+    /**
+     * Pass { kind } only — FileTree resolves parentId from the active
+     * selection automatically. Pass null to hide the input.
+     */
+    inlineCreate?: Pick<InlineCreateState, "kind"> | null;
+    onCancelCreate?: () => void;
+}
+
+declare function FileTree<TMeta extends Record<string, unknown> | undefined = Record<string, unknown>>({ workspaceId, inlineCreate: inlineCreateProp, onCancelCreate, ...rest }: FileTreeProps<TMeta>): react_jsx_runtime.JSX.Element;
+
+declare function FileTreeBase<TMeta = Record<string, unknown>>({ nodes, childIndex, rootIds, expandedIds, selection, activeNodeId, renamingId, onExpand, onCollapse, onSelect, onToggle, onRangeSelect, onOpen, onRename, onDelete, onMove, onReorder, onSetRenaming, onCreate, inlineCreate, onCancelCreate, sortable, draggable, virtualized, virtualizer: virtualizerOverride, itemHeight, renderNode, renderActions, renderEmpty, children, onKeyDown: customKeyDown, className, folderOverlay, }: FileTreeBaseProps<TMeta>): react_jsx_runtime.JSX.Element;
+
+export { FileRenderer, FileRendererBase, type FileRendererBaseProps, type FileRendererProps, type FileRendererRenderProps, FileTree, FileTreeBase, type FileTreeBaseProps, type FileTreeProps, type FileTreeRenderProps, type FlatNode, InlineInput, type InlineInputProps, type KeyboardHandler, type NodeRenderProps, TabList, TabListBase, type TabListBaseProps, type TabListProps, type TabRenderProps, type VirtualizerOverride };