entangle-ui 0.9.0 → 0.10.0

package/dist/types/components/controls/FileTree/FileTree.d.ts

@@ -0,0 +1,34 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { FileTreeProps } from './FileTree.types.js';
+
+/**
+ * A file-system-flavored specialization of {@link TreeView}: it maps a
+ * file/folder model onto the tree, auto-assigns file-type icons (by extension)
+ * and open/closed folder glyphs, and adds drag-and-drop import of OS files onto
+ * a folder (or the root). Expansion, selection, keyboard navigation, and sizing
+ * are inherited from TreeView unchanged.
+ *
+ * @example
+ * ```tsx
+ * const nodes: FileTreeNode[] = [
+ *   { id: 'src', name: 'src', kind: 'folder', children: [
+ *     { id: 'btn', name: 'Button.tsx', kind: 'file' },
+ *     { id: 'logo', name: 'logo.svg', kind: 'file' },
+ *   ]},
+ * ];
+ *
+ * <FileTree
+ *   nodes={nodes}
+ *   defaultExpandedIds={['src']}
+ *   onImport={({ files, targetFolder }) =>
+ *     uploadInto(targetFolder?.id ?? 'root', files)
+ *   }
+ * />
+ * ```
+ */
+declare const FileTree: {
+    ({ nodes, expandedIds, defaultExpandedIds, onExpandedChange, selectedIds, defaultSelectedIds, selectionMode, onSelectionChange, size, indent, showChevrons, showGuideLines, expandOnClick, maxHeight, resolveIcon, renderNode, renderActions, emptyContent, onImport, onNodeClick, onNodeDoubleClick, onNodeContextMenu, labels: labelsProp, className, style, testId, ref, "aria-label": ariaLabel, "aria-labelledby": ariaLabelledby, ...rest }: FileTreeProps): react_jsx_runtime.JSX.Element;
+    displayName: string;
+};
+
+export { FileTree };

package/dist/types/components/controls/FileTree/FileTree.types.d.ts

@@ -0,0 +1,133 @@
+import { FileTreeLabels } from './fileTreeLabels.js';
+import { TreeSelectionMode, TreeViewSize, TreeNodeState } from '../TreeView/TreeView.types.js';
+import { BaseComponent } from '../../../types/common.js';
+import { Prettify } from '../../../types/utilities.js';
+import React from 'react';
+
+/** Whether an entry is a leaf file or a navigable folder. */
+type FileTreeNodeKind = 'file' | 'folder';
+/**
+ * A single file or folder in the tree. The file-system-flavored counterpart of
+ * TreeView's `TreeNodeData`: `name` instead of `label`, an explicit `kind`, and
+ * an optional `ext` that drives the auto-assigned file-type icon.
+ */
+interface FileTreeNode {
+    /** Stable unique id within the tree. */
+    id: string;
+    /** Display name, e.g. `"Button.tsx"` or `"components"`. */
+    name: string;
+    /** File vs. folder. Folders accept dropped files; files do not. */
+    kind: FileTreeNodeKind;
+    /**
+     * Extension override **without** the leading dot (e.g. `"tsx"`). Inferred from
+     * `name` when omitted. Drives the built-in file-type icon.
+     */
+    ext?: string;
+    /** Optional path (informational; surfaced unchanged to consumers). */
+    path?: string;
+    /** Child entries. Present on folders; ignored on files. */
+    children?: FileTreeNode[];
+    /** Dim + non-interactive. */
+    disabled?: boolean;
+    /** Arbitrary consumer payload (size, modified date, GUID, …). */
+    data?: Record<string, unknown>;
+}
+/** Per-node state handed to FileTree render/resolve props. */
+interface FileTreeNodeState extends TreeNodeState {
+    /** Convenience flag — `true` when the node is a folder. */
+    isFolder: boolean;
+}
+/** Payload for {@link FileTreeBaseProps.onImport}. */
+interface FileTreeImportPayload {
+    /** The OS files extracted from the drop's `DataTransfer`. */
+    files: File[];
+    /**
+     * The folder the files were dropped onto, or `null` for the tree root (a drop
+     * on empty space, or on a top-level file).
+     */
+    targetFolder: FileTreeNode | null;
+}
+interface FileTreeBaseProps extends Omit<BaseComponent, 'onChange'> {
+    /** Tree data — array of root-level files/folders. */
+    nodes: FileTreeNode[];
+    /** Expanded node IDs (controlled). */
+    expandedIds?: string[];
+    /** Default expanded node IDs (uncontrolled). */
+    defaultExpandedIds?: string[];
+    /** Fired when expanded nodes change. */
+    onExpandedChange?: (expandedIds: string[]) => void;
+    /** Selected node IDs (controlled). */
+    selectedIds?: string[];
+    /** Default selected node IDs (uncontrolled). */
+    defaultSelectedIds?: string[];
+    /**
+     * Selection mode.
+     * @default "single"
+     */
+    selectionMode?: TreeSelectionMode;
+    /** Fired when selected nodes change. */
+    onSelectionChange?: (selectedIds: string[]) => void;
+    /**
+     * Row size.
+     * @default "md"
+     */
+    size?: TreeViewSize;
+    /**
+     * Indentation per depth level in pixels.
+     * @default 16
+     */
+    indent?: number;
+    /**
+     * Whether to show expand/collapse chevrons for folders.
+     * @default true
+     */
+    showChevrons?: boolean;
+    /**
+     * Whether to show connecting guide lines.
+     * @default false
+     */
+    showGuideLines?: boolean;
+    /**
+     * Whether clicking anywhere on a folder row toggles it open/closed (not just
+     * the chevron). Files are unaffected.
+     * @default true
+     */
+    expandOnClick?: boolean;
+    /** Maximum height before the tree scrolls. */
+    maxHeight?: number | string;
+    /**
+     * Override the icon for a node. Return `undefined`/`null` to fall back to the
+     * built-in extension→icon map. Receives the live expansion state so folder
+     * open/closed glyphs can differ.
+     */
+    resolveIcon?: (node: FileTreeNode, state: {
+        expanded: boolean;
+    }) => React.ReactNode;
+    /** Fully replace a node's inner content (icon + label). */
+    renderNode?: (node: FileTreeNode, state: FileTreeNodeState) => React.ReactNode;
+    /** Render trailing actions on the right of a row. */
+    renderActions?: (node: FileTreeNode, state: FileTreeNodeState) => React.ReactNode;
+    /** Content shown when `nodes` is empty. */
+    emptyContent?: React.ReactNode;
+    /**
+     * Fired when OS files are dropped onto a folder (or the root). Presence of
+     * this callback enables the import drop zone. FileTree only reports intent —
+     * apply the change to your data and pass back fresh `nodes`.
+     */
+    onImport?: (payload: FileTreeImportPayload) => void;
+    /** Fired when a node is clicked. */
+    onNodeClick?: (node: FileTreeNode, event: React.MouseEvent) => void;
+    /** Fired when a node is double-clicked. */
+    onNodeDoubleClick?: (node: FileTreeNode, event: React.MouseEvent) => void;
+    /** Fired when a node is right-clicked. */
+    onNodeContextMenu?: (node: FileTreeNode, event: React.MouseEvent) => void;
+    /**
+     * Override the built-in English strings (the tree's accessible name and the
+     * empty-state text). Merged onto the defaults, so you can localize a subset.
+     * @see DEFAULT_FILE_TREE_LABELS
+     */
+    labels?: Partial<FileTreeLabels>;
+}
+type FileTreeProps = Prettify<FileTreeBaseProps>;
+
+export type { FileTreeBaseProps, FileTreeImportPayload, FileTreeNode, FileTreeNodeKind, FileTreeNodeState, FileTreeProps };

package/dist/types/components/controls/FileTree/fileTreeIcons.d.ts

@@ -0,0 +1,29 @@
+import { FileTreeNode } from './FileTree.types.js';
+
+/**
+ * The icon categories FileTree resolves a node to. Folders get an open/closed
+ * pair; files collapse to a small set of type buckets backed by the existing
+ * icon set. Rendering a kind into an actual icon element lives in the client
+ * component — this module is pure classification so it can be unit-tested
+ * without React.
+ */
+type FileIconKind = 'folder' | 'folder-open' | 'image' | 'media' | 'code' | 'archive' | 'text' | 'file';
+/**
+ * Extracts the lowercased extension (without the dot) from a file name, or
+ * `undefined` when there isn't one. Dotfiles such as `.env` / `.gitignore` are
+ * treated as having no extension (the leading dot is not a separator).
+ */
+declare function getFileExtension(name: string): string | undefined;
+/**
+ * Classifies an extension into an icon bucket. `undefined` / unknown → `file`.
+ */
+declare function classifyExtension(ext: string | undefined): FileIconKind;
+/**
+ * Resolves the icon kind for a node. Folders return `folder-open` when
+ * `expanded`, else `folder`. Files use the explicit `ext` when provided, falling
+ * back to the extension parsed from `name`.
+ */
+declare function getFileIconKind(node: Pick<FileTreeNode, 'kind' | 'name' | 'ext'>, expanded?: boolean): FileIconKind;
+
+export { classifyExtension, getFileExtension, getFileIconKind };
+export type { FileIconKind };

package/dist/types/components/controls/FileTree/fileTreeLabels.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Localizable strings for {@link FileTree}. Every user-facing / screen-reader
+ * string the component renders on its own goes through here so the whole
+ * component can be localized in one place (file and folder names come from your
+ * data, so they are already yours to localize).
+ *
+ * @see DEFAULT_FILE_TREE_LABELS for the English defaults.
+ */
+interface FileTreeLabels {
+    /** Accessible name for the tree region (`role="tree"` `aria-label`). */
+    treeLabel: string;
+    /** Text shown when the tree is empty (unless `emptyContent` is provided). */
+    emptyLabel: string;
+}
+/** English defaults for {@link FileTreeLabels}. Spread-and-tweak to localize. */
+declare const DEFAULT_FILE_TREE_LABELS: FileTreeLabels;
+
+export { DEFAULT_FILE_TREE_LABELS };
+export type { FileTreeLabels };

package/dist/types/components/controls/FileUploader/FileUploader.types.d.ts

@@ -1,6 +1,6 @@
-import React from 'react';
 import { BaseComponent, Size } from '../../../types/common.js';
 import { Prettify } from '../../../types/utilities.js';
+import React from 'react';
 
 type FileUploaderSize = Size;
 type FileUploaderItemStatus = 'pending' | 'uploading' | 'done' | 'error';
@@ -23,7 +23,7 @@ interface FileUploaderRenderItemState {
     remove: () => void;
     disabled: boolean;
 }
-interface FileUploaderBaseProps extends Omit<BaseComponent<HTMLDivElement>, 'onChange' | 'children' | 'defaultValue'> {
+interface FileUploaderBaseProps extends Omit<BaseComponent, 'onChange' | 'children' | 'defaultValue'> {
     /** Controlled list of items */
     value?: FileUploaderItem[];
     /** Default list (uncontrolled) */

package/dist/types/components/controls/MultiSelect/MultiSelect.types.d.ts

@@ -1,6 +1,6 @@
-import React from 'react';
 import { BaseComponent, Size } from '../../../types/common.js';
 import { Prettify } from '../../../types/utilities.js';
+import React from 'react';
 
 type MultiSelectSize = Size;
 type MultiSelectVariant = 'default' | 'ghost' | 'filled';

package/dist/types/components/controls/NumberInput/NumberInput.d.ts

@@ -1,8 +1,8 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-import { Prettify } from '../../../types/utilities.js';
-import { BaseComponent, Size } from '../../../types/common.js';
 import { UseNumberInputOptions } from './useNumberInput.js';
+import { BaseComponent, Size } from '../../../types/common.js';
+import { Prettify } from '../../../types/utilities.js';
 
 /**
  * Props specific to NumberInput component

package/dist/types/components/controls/Select/Select.types.d.ts

@@ -1,6 +1,6 @@
-import React from 'react';
-import { Prettify } from '../../../types/utilities.js';
 import { BaseComponent, Size } from '../../../types/common.js';
+import { Prettify } from '../../../types/utilities.js';
+import React from 'react';
 
 type SelectSize = Size;
 type SelectVariant = 'default' | 'ghost' | 'filled';

package/dist/types/components/controls/Slider/Slider.d.ts

@@ -1,6 +1,6 @@
 import React from 'react';
-import { Prettify } from '../../../types/utilities.js';
 import { BaseComponent, Size } from '../../../types/common.js';
+import { Prettify } from '../../../types/utilities.js';
 
 /**
  * Props specific to Slider component

package/dist/types/components/controls/TagInput/TagInput.types.d.ts

@@ -1,6 +1,6 @@
-import React from 'react';
 import { BaseComponent, Size } from '../../../types/common.js';
 import { Prettify } from '../../../types/utilities.js';
+import React from 'react';
 
 type TagInputSize = Size;
 type TagInputVariant = 'default' | 'ghost' | 'filled';
@@ -16,7 +16,7 @@ interface TagInputRenderTagState {
     /** Remove this tag */
     remove: () => void;
 }
-interface TagInputBaseProps extends Omit<BaseComponent<HTMLDivElement>, 'onChange' | 'defaultValue' | 'children'> {
+interface TagInputBaseProps extends Omit<BaseComponent, 'onChange' | 'defaultValue' | 'children'> {
     /** Controlled list of tags */
     value?: string[];
     /** Default tags (uncontrolled) */

package/dist/types/components/controls/TreeView/TreeView.d.ts

@@ -20,7 +20,7 @@ import { TreeViewProps } from './TreeView.types.js';
  * ```
  */
 declare const TreeView: {
-    ({ nodes, expandedIds, defaultExpandedIds, selectedIds, defaultSelectedIds, selectionMode, renamable, size, indent, showChevrons, showGuideLines, expandOnSelect, maxHeight, renderNode, renderActions, emptyContent, onExpandedChange, onSelectionChange, onNodeClick, onNodeDoubleClick, onNodeContextMenu, onNodeRename, className, testId, ...rest }: TreeViewProps): react_jsx_runtime.JSX.Element;
+    ({ nodes, expandedIds, defaultExpandedIds, selectedIds, defaultSelectedIds, selectionMode, renamable, size, indent, showChevrons, showGuideLines, expandOnSelect, expandOnClick, maxHeight, renderNode, renderActions, emptyContent, dropTargetId, onExpandedChange, onSelectionChange, onNodeClick, onNodeDoubleClick, onNodeContextMenu, onNodeRename, onNodeDragOver, onNodeDragLeave, onNodeDrop, className, testId, ...rest }: TreeViewProps): react_jsx_runtime.JSX.Element;
     displayName: string;
 };
 

package/dist/types/components/controls/TreeView/TreeView.types.d.ts

@@ -1,6 +1,6 @@
-import React from 'react';
+import { Size, BaseComponent } from '../../../types/common.js';
 import { Prettify } from '../../../types/utilities.js';
-import { BaseComponent, Size } from '../../../types/common.js';
+import React from 'react';
 
 type TreeViewSize = Size;
 /**
@@ -101,6 +101,12 @@ interface TreeViewBaseProps extends Omit<BaseComponent, 'onChange'> {
      * @default false
      */
     expandOnSelect?: boolean;
+    /**
+     * Whether clicking anywhere on a parent node's row toggles its expansion
+     * (not just the chevron). Leaf nodes are unaffected.
+     * @default false
+     */
+    expandOnClick?: boolean;
     /**
      * Maximum height before scrolling.
      */
@@ -129,6 +135,22 @@ interface TreeViewBaseProps extends Omit<BaseComponent, 'onChange'> {
     onNodeContextMenu?: (node: TreeNodeData, event: React.MouseEvent) => void;
     /** Fired when a node is renamed. */
     onNodeRename?: (nodeId: string, newLabel: string) => void;
+    /**
+     * Id of the node currently highlighted as an active drop target. The matching
+     * row gets a `data-drop-target="true"` attribute and an accent highlight. Pair
+     * with the `onNodeDrag*` / `onNodeDrop` callbacks to build drag-and-drop on top
+     * of the tree (see `FileTree`). `null`/`undefined` means no active target.
+     */
+    dropTargetId?: string | null;
+    /**
+     * Fired on `dragover` over a node row. Call `event.preventDefault()` to mark
+     * the row as a valid drop target (so a subsequent `drop` fires).
+     */
+    onNodeDragOver?: (node: TreeNodeData, event: React.DragEvent) => void;
+    /** Fired on `dragleave` from a node row. */
+    onNodeDragLeave?: (node: TreeNodeData, event: React.DragEvent) => void;
+    /** Fired on `drop` onto a node row. */
+    onNodeDrop?: (node: TreeNodeData, event: React.DragEvent) => void;
 }
 type TreeViewProps = Prettify<TreeViewBaseProps>;
 

package/dist/types/components/controls/VectorInput/VectorInput.types.d.ts

@@ -1,5 +1,5 @@
-import { Prettify } from '../../../types/utilities.js';
 import { BaseComponent, Size } from '../../../types/common.js';
+import { Prettify } from '../../../types/utilities.js';
 
 type VectorInputSize = Size;
 /**

package/dist/types/components/data/DataTable/DataTable.types.d.ts

@@ -1,6 +1,6 @@
-import React from 'react';
 import { BaseComponent } from '../../../types/common.js';
 import { Prettify } from '../../../types/utilities.js';
+import React from 'react';
 
 /** Visual density. Affects row height and cell padding. */
 type DataTableDensity = 'comfortable' | 'compact' | 'dense';
@@ -79,7 +79,7 @@ interface DataTableRowRenderInfo<R> {
 }
 /** Virtualization mode. `'auto'` enables virtualization above the threshold. */
 type DataTableVirtualizationMode = boolean | 'auto';
-interface DataTableBaseProps<R> extends Omit<BaseComponent<HTMLDivElement>, 'onSelect' | 'children' | 'onChange'> {
+interface DataTableBaseProps<R> extends Omit<BaseComponent, 'onSelect' | 'children' | 'onChange'> {
     /** Row data. */
     rows: readonly R[];
     /** Column definitions. */

package/dist/types/components/editor/AssetBrowser/AssetBrowser.d.ts

@@ -0,0 +1,13 @@
+import React from 'react';
+import { AssetBrowserProps } from './AssetBrowser.types.js';
+
+declare function AssetBrowserRoot(props: AssetBrowserProps): React.ReactElement;
+declare namespace AssetBrowserRoot {
+    var displayName: string;
+}
+declare const AssetBrowser: typeof AssetBrowserRoot & {
+    Toolbar: () => null;
+    Sidebar: () => null;
+};
+
+export { AssetBrowser };

package/dist/types/components/editor/AssetBrowser/AssetBrowser.types.d.ts

@@ -0,0 +1,241 @@
+import { AssetBrowserLabels } from './assetBrowserLabels.js';
+import { TreeNodeData } from '../../controls/TreeView/TreeView.types.js';
+import React from 'react';
+import { DataTableDensity, DataTableColumn } from '../../data/DataTable/DataTable.types.js';
+import { BaseComponent } from '../../../types/common.js';
+import { Prettify, LiteralUnion } from '../../../types/utilities.js';
+
+/** Whether an entry is a file/asset or a navigable folder. */
+type AssetKind = 'file' | 'folder';
+/** Well-known asset types. Extensible — consumers may pass any string. */
+type AssetType = LiteralUnion<'image' | 'model' | 'material' | 'audio' | 'video' | 'text' | 'scene' | 'unknown'>;
+/** A single entry shown in the current folder (file OR sub-folder). */
+interface AssetItem {
+    /** Stable unique id within the browser. */
+    id: string;
+    /** Display name. */
+    name: string;
+    /** Drives navigation vs. open behaviour. */
+    kind: AssetKind;
+    /** Consumer-defined category; drives the fallback icon and the type filter. */
+    assetType?: AssetType;
+    /** Image thumbnail URL for grid view. */
+    thumbnailUrl?: string;
+    /** Explicit icon override (files without a thumbnail, and folders). */
+    icon?: React.ReactNode;
+    /** Size in bytes — feeds the list "Size" column and size sort. */
+    size?: number;
+    /** Last-modified timestamp — feeds the list "Modified" column and date sort. */
+    modifiedAt?: number | Date;
+    /** Arbitrary consumer payload (dimensions, tags, GUID, …). */
+    meta?: Record<string, unknown>;
+    /** Default `true`. When `false`, the item cannot be selected. */
+    selectable?: boolean;
+    /** Default `true`. When `false`, the item cannot be dragged. */
+    draggable?: boolean;
+    /** Default: `true` for folders, `false` for files. Can items be dropped onto it? */
+    droppable?: boolean;
+    /** Dim + non-interactive. */
+    disabled?: boolean;
+}
+/** One hop in the current location, oldest → newest. Drives the breadcrumb bar. */
+interface AssetPathSegment {
+    id: string;
+    name: string;
+}
+type AssetView = 'grid' | 'list';
+type AssetSortField = LiteralUnion<'name' | 'type' | 'size' | 'modified'>;
+interface AssetSortState {
+    field: AssetSortField;
+    direction: 'asc' | 'desc';
+}
+/** Active filters. `types: []` or `undefined` means "no type filter". */
+interface AssetFilterState {
+    types?: AssetType[];
+}
+type AssetThumbnailSize = 'sm' | 'md' | 'lg' | number;
+/** Why a selection change fired — useful for analytics & undo. */
+type AssetSelectionReason = 'click' | 'keyboard' | 'marquee' | 'selectAll' | 'clear' | 'contextMenu';
+type AssetNavigationSource = 'breadcrumb' | 'sidebar' | 'open' | 'back' | 'forward';
+/** Per-item state handed to render props. */
+interface AssetItemState {
+    selected: boolean;
+    focused: boolean;
+    /** Index within the displayed (filtered + sorted) list. */
+    index: number;
+    view: AssetView;
+    /** A drag is currently hovering this item as a drop target. */
+    dropTarget: boolean;
+}
+/** Imperative handle exposed via `ref`. */
+interface AssetBrowserHandle {
+    focus: () => void;
+    getElement: () => HTMLDivElement | null;
+    selectAll: () => void;
+    clearSelection: () => void;
+    scrollToItem: (id: string) => void;
+    getSelectedItems: () => AssetItem[];
+    /**
+     * Put the item into inline-rename mode (scrolls it into view + focuses the
+     * field). No-op when `onItemRename` isn't set. Use after inserting a new
+     * folder/file to immediately let the user name it.
+     */
+    beginRename: (id: string) => void;
+}
+/**
+ * Return value of `onItemRename`. Return / resolve `false` to reject the new
+ * name and keep the inline editor open; anything else — including returning
+ * nothing — accepts it. `void` is a member so the common "just apply it"
+ * handler needs no `return`; TS's void-assignability special case does not
+ * fire when a union also contains a `Promise`, so it must be explicit here.
+ */
+type AssetRenameResult = boolean | void | Promise<boolean | undefined>;
+/**
+ * Mutation actions handed to `renderItemContextMenu`, so a custom menu can wire
+ * the built-in flows without juggling a ref. Each is a no-op when its backing
+ * callback (`onItemRename` / `onItemsDelete` / `onItemsDuplicate`) is absent.
+ */
+interface AssetItemActions {
+    /** The items the action applies to (the right-clicked selection). */
+    items: AssetItem[];
+    /** Enter inline-rename on the first item. */
+    rename: () => void;
+    /** Delete `items` via `onItemsDelete`. */
+    delete: () => void;
+    /** Duplicate `items` via `onItemsDuplicate`. */
+    duplicate: () => void;
+}
+interface AssetBrowserBaseProps extends Omit<BaseComponent, 'ref' | 'onChange'> {
+    ref?: React.Ref<AssetBrowserHandle>;
+    /** Direct children of the current folder (files + sub-folders). */
+    items: readonly AssetItem[];
+    /** Current location, oldest → newest. Drives the breadcrumb bar. */
+    path?: readonly AssetPathSegment[];
+    /** Folder hierarchy for the sidebar. Reuses TreeView's node shape. Omit to hide the sidebar. */
+    folderTree?: readonly TreeNodeData[];
+    /** Id of the folder currently shown. Highlights the sidebar node. */
+    currentFolderId?: string;
+    view?: AssetView;
+    defaultView?: AssetView;
+    onViewChange?: (view: AssetView) => void;
+    thumbnailSize?: AssetThumbnailSize;
+    defaultThumbnailSize?: AssetThumbnailSize;
+    onThumbnailSizeChange?: (size: AssetThumbnailSize) => void;
+    /** List-view row density (passthrough to DataTable). @default "comfortable" */
+    density?: DataTableDensity;
+    /** Show the "N items · M selected" footer + thumbnail-size control. @default false */
+    showStatusBar?: boolean;
+    selectionMode?: 'single' | 'multiple' | false;
+    selection?: readonly string[];
+    defaultSelection?: readonly string[];
+    onSelectionChange?: (ids: string[], meta: {
+        reason: AssetSelectionReason;
+    }) => void;
+    /** Rubber-band marquee selection in grid empty space. @default true for 'multiple' */
+    marquee?: boolean;
+    search?: string;
+    defaultSearch?: string;
+    onSearchChange?: (query: string) => void;
+    /** When true, the consumer pre-filters `items` by name. @default false */
+    manualSearch?: boolean;
+    filters?: AssetFilterState;
+    defaultFilters?: AssetFilterState;
+    onFiltersChange?: (filters: AssetFilterState) => void;
+    manualFilter?: boolean;
+    /** Type values offered in the filter menu. Defaults to distinct `assetType`s in `items`. */
+    filterableTypes?: AssetType[];
+    sort?: AssetSortState;
+    defaultSort?: AssetSortState;
+    manualSort?: boolean;
+    onSortChange?: (sort: AssetSortState) => void;
+    /** Fires when the user enters a folder (open / breadcrumb / sidebar / history). */
+    onNavigate?: (folderId: string, source: AssetNavigationSource) => void;
+    /** Fires when a FILE is activated (double-click / Enter). Folders go through onNavigate. */
+    onItemOpen?: (item: AssetItem) => void;
+    /** Enable Back/Forward + Backspace-to-parent. @default false */
+    history?: boolean;
+    /** Override the default list columns. When omitted, a name/type/size/modified set is used. */
+    columns?: readonly DataTableColumn<AssetItem>[];
+    /** Internal move: items dropped onto a folder. Presence enables internal DnD. */
+    onItemsMove?: (payload: {
+        itemIds: string[];
+        targetFolderId: string;
+    }) => void;
+    /** External import: OS files dropped onto the surface (or a folder). Presence enables external drop. */
+    onFilesImport?: (payload: {
+        files: File[];
+        targetFolderId: string | null;
+    }) => void;
+    /** MIME type used when dragging items out. @default 'application/x-entangle-asset' */
+    dragOutMimeType?: string;
+    /** Override the drag-out dataTransfer payload. */
+    getDragData?: (items: AssetItem[]) => Record<string, string>;
+    onItemDragStart?: (items: AssetItem[], event: React.DragEvent) => void;
+    onItemDragEnd?: (items: AssetItem[], event: React.DragEvent) => void;
+    /**
+     * Inline-rename commit. Fires when the user confirms a new name (Enter / blur
+     * with a changed, non-empty value). Presence enables the rename affordance
+     * (F2, double-click-to-rename, the `Rename` default action, and
+     * `handle.beginRename`). Return / resolve `false` to reject the name and keep
+     * the editor open (e.g. failed validation); `void` / `true` accepts it. Apply
+     * the rename to your data source — AssetBrowser only reports intent.
+     */
+    onItemRename?: (item: AssetItem, newName: string) => AssetRenameResult;
+    /** Delete intent for the acted-on items (the selection). Enables Delete key + default action. */
+    onItemsDelete?: (items: AssetItem[]) => void;
+    /** Create-folder intent in the current folder. Enables the empty-area `New folder` default action. */
+    onCreateFolder?: (parentFolderId: string | null) => void;
+    /** Duplicate intent for the acted-on items. Enables Ctrl/Cmd+D + default action. */
+    onItemsDuplicate?: (items: AssetItem[]) => void;
+    /**
+     * Auto-populate the item / empty-area context menus with Rename / Duplicate /
+     * Delete / New folder entries for whichever mutation callbacks are present.
+     * Ignored for a menu you supply yourself via `renderItemContextMenu` /
+     * `renderEmptyContextMenu`. @default false
+     */
+    defaultItemActions?: boolean;
+    loading?: boolean;
+    /** Number of skeleton cells shown in grid view while `loading`. @default 12 */
+    loadingItemCount?: number;
+    emptyState?: React.ReactNode;
+    /**
+     * Error state. `true` renders the built-in error message (with a Retry button
+     * when `onErrorRetry` is set); any other `ReactNode` fully replaces it;
+     * `false` / `undefined` means no error. Takes precedence over `loading` and
+     * the empty state. (Typed as `ReactNode`, which subsumes `boolean`.)
+     */
+    error?: React.ReactNode;
+    /** Retry handler shown as a button in the built-in error state (`error={true}`). */
+    onErrorRetry?: () => void;
+    /** Custom thumbnail (e.g. canvas 3D preview). Falls back to thumbnailUrl → icon → type icon. */
+    renderThumbnail?: (item: AssetItem, ctx: {
+        size: number;
+        selected: boolean;
+    }) => React.ReactNode;
+    /** Fully replace a grid cell's inner content (advanced). */
+    renderItem?: (item: AssetItem, state: AssetItemState) => React.ReactNode;
+    /**
+     * Returns the body of the item context menu (`Menu.*` children). Receives the
+     * acted-on items (the whole selection when right-clicking a selected item,
+     * else just that item) plus an `actions` object wiring the built-in
+     * rename / delete / duplicate flows.
+     */
+    renderItemContextMenu?: (items: AssetItem[], actions: AssetItemActions) => React.ReactNode;
+    /** Returns the body of the empty-area context menu. */
+    renderEmptyContextMenu?: () => React.ReactNode;
+    virtualized?: boolean | 'auto';
+    virtualizationThreshold?: number;
+    overscanRows?: number;
+    'aria-label'?: string;
+    /**
+     * Override any of the built-in English UI strings (search placeholder, sort /
+     * filter menus, empty / loading / error messages, column headers, the live
+     * announcement, …). Merged onto the defaults, so you can translate a subset.
+     */
+    labels?: Partial<AssetBrowserLabels>;
+    /** Compound slots only (`AssetBrowser.Toolbar`, `AssetBrowser.Sidebar`). */
+    children?: React.ReactNode;
+}
+type AssetBrowserProps = Prettify<AssetBrowserBaseProps>;
+
+export type { AssetBrowserBaseProps, AssetBrowserHandle, AssetBrowserProps, AssetFilterState, AssetItem, AssetItemActions, AssetItemState, AssetKind, AssetNavigationSource, AssetPathSegment, AssetRenameResult, AssetSelectionReason, AssetSortField, AssetSortState, AssetThumbnailSize, AssetType, AssetView };