@databricks/appkit-ui 0.17.0 → 0.19.0

package/dist/react/index.js

@@ -18,14 +18,27 @@ import { DonutChart, PieChart } from "./charts/pie/index.js";
 import { RadarChart } from "./charts/radar/index.js";
 import { ScatterChart } from "./charts/scatter/index.js";
 import "./charts/index.js";
+import { formatFileSize } from "./lib/format.js";
 import { cn } from "./lib/utils.js";
 import { Button, buttonVariants } from "./ui/button.js";
+import { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "./ui/card.js";
+import { Skeleton } from "./ui/skeleton.js";
+import { FileEntry } from "./file-browser/file-entry.js";
+import { DirectoryList } from "./file-browser/directory-list.js";
+import { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from "./ui/breadcrumb.js";
+import { FileBreadcrumb } from "./file-browser/file-breadcrumb.js";
+import { FilePreviewPanel } from "./file-browser/file-preview-panel.js";
+import { NewFolderInput } from "./file-browser/new-folder-input.js";
+import "./file-browser/index.js";
+import { inferChartType } from "./genie/genie-chart-inference.js";
 import { GenieChatInput } from "./genie/genie-chat-input.js";
 import { ScrollArea, ScrollBar } from "./ui/scroll-area.js";
-import { Skeleton } from "./ui/skeleton.js";
 import { Spinner } from "./ui/spinner.js";
 import { Avatar, AvatarFallback, AvatarImage } from "./ui/avatar.js";
-import { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "./ui/card.js";
+import { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from "./ui/table.js";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "./ui/tabs.js";
+import { transformGenieData } from "./genie/genie-query-transform.js";
+import { GenieQueryVisualization } from "./genie/genie-query-visualization.js";
 import { GenieChatMessage } from "./genie/genie-chat-message.js";
 import { GenieChatMessageList } from "./genie/genie-chat-message-list.js";
 import { useGenieChat } from "./genie/use-genie-chat.js";
@@ -36,7 +49,6 @@ import { PortalContainerContext, PortalContainerProvider, usePortalContainer, us
 import { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from "./ui/dropdown-menu.js";
 import { Input } from "./ui/input.js";
 import { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue } from "./ui/select.js";
-import { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from "./ui/table.js";
 import { Checkbox } from "./ui/checkbox.js";
 import { DataTable } from "./table/data-table.js";
 import "./table/index.js";
@@ -45,7 +57,6 @@ import { Alert, AlertDescription, AlertTitle } from "./ui/alert.js";
 import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger } from "./ui/alert-dialog.js";
 import { AspectRatio } from "./ui/aspect-ratio.js";
 import { Badge, badgeVariants } from "./ui/badge.js";
-import { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from "./ui/breadcrumb.js";
 import { Separator } from "./ui/separator.js";
 import { ButtonGroup, ButtonGroupSeparator, ButtonGroupText, buttonGroupVariants } from "./ui/button-group.js";
 import { Calendar, CalendarDayButton } from "./ui/calendar.js";
@@ -79,9 +90,8 @@ import { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupActio
 import { Slider } from "./ui/slider.js";
 import { Toaster } from "./ui/sonner.js";
 import { Switch } from "./ui/switch.js";
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "./ui/tabs.js";
 import { Toggle, toggleVariants } from "./ui/toggle.js";
 import { ToggleGroup, ToggleGroupItem } from "./ui/toggle-group.js";
 import "./ui/index.js";
 
-export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AreaChart, AspectRatio, Avatar, AvatarFallback, AvatarImage, Badge, BarChart, BaseChart, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CHART_COLOR_VARS, CHART_COLOR_VARS_CATEGORICAL, CHART_COLOR_VARS_DIVERGING, CHART_COLOR_VARS_SEQUENTIAL, Calendar, CalendarDayButton, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, ChartWrapper, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DATE_FIELD_PATTERNS, DataTable, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DonutChart, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, FALLBACK_COLORS, FALLBACK_COLORS_CATEGORICAL, FALLBACK_COLORS_DIVERGING, FALLBACK_COLORS_SEQUENTIAL, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, GenieChat, GenieChatInput, GenieChatMessage, GenieChatMessageList, HeatmapChart, HoverCard, HoverCardContent, HoverCardTrigger, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle, Kbd, KbdGroup, Label, LineChart, METADATA_DATE_PATTERNS, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, NAME_FIELD_PATTERNS, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PieChart, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PortalContainerContext, PortalContainerProvider, Progress, RadarChart, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScatterChart, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, Spinner, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buildCartesianOption, buildHeatmapOption, buildHorizontalBarOption, buildPieOption, buildRadarOption, buttonGroupVariants, buttonVariants, cn, createChart, createTimeSeriesData, formatLabel, isArrowTable, isDataProps, isQueryProps, navigationMenuTriggerStyle, normalizeChartData, normalizeHeatmapData, sortTimeSeriesAscending, toChartArray, toChartValue, toggleVariants, truncateLabel, useAllThemeColors, useAnalyticsQuery, useChartData, useFormField, useGenieChat, usePortalContainer, useResolvedPortalContainer, useSidebar, useThemeColors };
+export { Accordion, AccordionContent, AccordionItem, AccordionTrigger, Alert, AlertDescription, AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, AlertTitle, AreaChart, AspectRatio, Avatar, AvatarFallback, AvatarImage, Badge, BarChart, BaseChart, Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator, Button, ButtonGroup, ButtonGroupSeparator, ButtonGroupText, CHART_COLOR_VARS, CHART_COLOR_VARS_CATEGORICAL, CHART_COLOR_VARS_DIVERGING, CHART_COLOR_VARS_SEQUENTIAL, Calendar, CalendarDayButton, Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Carousel, CarouselContent, CarouselItem, CarouselNext, CarouselPrevious, ChartContainer, ChartLegend, ChartLegendContent, ChartStyle, ChartTooltip, ChartTooltipContent, ChartWrapper, Checkbox, Collapsible, CollapsibleContent, CollapsibleTrigger, Command, CommandDialog, CommandEmpty, CommandGroup, CommandInput, CommandItem, CommandList, CommandSeparator, CommandShortcut, ContextMenu, ContextMenuCheckboxItem, ContextMenuContent, ContextMenuGroup, ContextMenuItem, ContextMenuLabel, ContextMenuPortal, ContextMenuRadioGroup, ContextMenuRadioItem, ContextMenuSeparator, ContextMenuShortcut, ContextMenuSub, ContextMenuSubContent, ContextMenuSubTrigger, ContextMenuTrigger, DATE_FIELD_PATTERNS, DataTable, Dialog, DialogClose, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogOverlay, DialogPortal, DialogTitle, DialogTrigger, DirectoryList, DonutChart, Drawer, DrawerClose, DrawerContent, DrawerDescription, DrawerFooter, DrawerHeader, DrawerOverlay, DrawerPortal, DrawerTitle, DrawerTrigger, DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger, Empty, EmptyContent, EmptyDescription, EmptyHeader, EmptyMedia, EmptyTitle, FALLBACK_COLORS, FALLBACK_COLORS_CATEGORICAL, FALLBACK_COLORS_DIVERGING, FALLBACK_COLORS_SEQUENTIAL, Field, FieldContent, FieldDescription, FieldError, FieldGroup, FieldLabel, FieldLegend, FieldSeparator, FieldSet, FieldTitle, FileBreadcrumb, FileEntry, FilePreviewPanel, Form, FormControl, FormDescription, FormField, FormItem, FormLabel, FormMessage, GenieChat, GenieChatInput, GenieChatMessage, GenieChatMessageList, GenieQueryVisualization, HeatmapChart, HoverCard, HoverCardContent, HoverCardTrigger, Input, InputGroup, InputGroupAddon, InputGroupButton, InputGroupInput, InputGroupText, InputGroupTextarea, InputOTP, InputOTPGroup, InputOTPSeparator, InputOTPSlot, Item, ItemActions, ItemContent, ItemDescription, ItemFooter, ItemGroup, ItemHeader, ItemMedia, ItemSeparator, ItemTitle, Kbd, KbdGroup, Label, LineChart, METADATA_DATE_PATTERNS, Menubar, MenubarCheckboxItem, MenubarContent, MenubarGroup, MenubarItem, MenubarLabel, MenubarMenu, MenubarPortal, MenubarRadioGroup, MenubarRadioItem, MenubarSeparator, MenubarShortcut, MenubarSub, MenubarSubContent, MenubarSubTrigger, MenubarTrigger, NAME_FIELD_PATTERNS, NavigationMenu, NavigationMenuContent, NavigationMenuIndicator, NavigationMenuItem, NavigationMenuLink, NavigationMenuList, NavigationMenuTrigger, NavigationMenuViewport, NewFolderInput, Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PieChart, Popover, PopoverAnchor, PopoverContent, PopoverTrigger, PortalContainerContext, PortalContainerProvider, Progress, RadarChart, RadioGroup, RadioGroupItem, ResizableHandle, ResizablePanel, ResizablePanelGroup, ScatterChart, ScrollArea, ScrollBar, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, Separator, Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetTitle, SheetTrigger, Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, Skeleton, Slider, Spinner, Switch, Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow, Tabs, TabsContent, TabsList, TabsTrigger, Textarea, Toaster, Toggle, ToggleGroup, ToggleGroupItem, Tooltip, TooltipContent, TooltipProvider, TooltipTrigger, badgeVariants, buildCartesianOption, buildHeatmapOption, buildHorizontalBarOption, buildPieOption, buildRadarOption, buttonGroupVariants, buttonVariants, cn, createChart, createTimeSeriesData, formatFileSize, formatLabel, inferChartType, isArrowTable, isDataProps, isQueryProps, navigationMenuTriggerStyle, normalizeChartData, normalizeHeatmapData, sortTimeSeriesAscending, toChartArray, toChartValue, toggleVariants, transformGenieData, truncateLabel, useAllThemeColors, useAnalyticsQuery, useChartData, useFormField, useGenieChat, usePortalContainer, useResolvedPortalContainer, useSidebar, useThemeColors };

package/dist/react/lib/format.d.ts

@@ -0,0 +1,14 @@
+//#region src/react/lib/format.d.ts
+/**
+ * Formats byte values into human-readable file sizes
+ * @param bytes - The file size in bytes
+ * @returns Formatted string (e.g., "1.5 KB", "3.2 MB")
+ * @example
+ * formatFileSize(512) // "512 B"
+ * formatFileSize(1536) // "1.5 KB"
+ * formatFileSize(2621440) // "2.5 MB"
+ */
+declare function formatFileSize(bytes: number | undefined): string;
+//#endregion
+export { formatFileSize };
+//# sourceMappingURL=format.d.ts.map

package/dist/react/lib/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","names":[],"sources":["../../../src/react/lib/format.ts"],"mappings":";;;;;;;;;;iBAiEgB,cAAA,CAAe,KAAA"}

package/dist/react/lib/format.js

@@ -34,9 +34,25 @@ function formatChartValue(value, fieldName) {
 function formatFieldLabel(field) {
 	return field.replace(/[^a-zA-Z0-9_-]/g, "").replace(/([A-Z])/g, " $1").replace(/_/g, " ").replace(/\b\w/g, (l) => l.toUpperCase()).trim();
 }
+/**
+* Formats byte values into human-readable file sizes
+* @param bytes - The file size in bytes
+* @returns Formatted string (e.g., "1.5 KB", "3.2 MB")
+* @example
+* formatFileSize(512) // "512 B"
+* formatFileSize(1536) // "1.5 KB"
+* formatFileSize(2621440) // "2.5 MB"
+*/
+function formatFileSize(bytes) {
+	if (bytes === void 0 || bytes === null) return "Unknown";
+	if (bytes < 1024) return `${bytes} B`;
+	if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;
+	if (bytes < 1024 * 1024 * 1024) return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+	return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;
+}
 /** Regex for validating field names */
 const SAFE_KEY_REGEX = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
 
 //#endregion
-export { SAFE_KEY_REGEX, formatChartValue, formatFieldLabel };
+export { SAFE_KEY_REGEX, formatChartValue, formatFieldLabel, formatFileSize };
 //# sourceMappingURL=format.js.map

package/dist/react/lib/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","names":[],"sources":["../../../src/react/lib/format.ts"],"sourcesContent":["/**\n * Formats numeric values based on field name context\n * @param value - The numeric value to format\n * @param fieldName - The field name to determine formatting\n * @returns Formatted string representation\n * @example\n * formatChartValue(1234.56, \"cost\") // \"$1,234.56\"\n * formatChartValue(5000, \"users\") // \"5.0k\"\n * formatChartValue(42.7, \"percentage\") // \"42.7\"\n */\nexport function formatChartValue(value: number, fieldName: string): string {\n  if (\n    fieldName.toLowerCase().includes(\"cost\") ||\n    fieldName.toLowerCase().includes(\"price\") ||\n    fieldName.toLowerCase().includes(\"spend\") ||\n    fieldName.toLowerCase().includes(\"revenue\") ||\n    fieldName.toLowerCase().includes(\"usd\")\n  ) {\n    return new Intl.NumberFormat(\"en-US\", {\n      style: \"currency\",\n      currency: \"USD\",\n      minimumFractionDigits: 2,\n      maximumFractionDigits: 2,\n    }).format(value);\n  }\n\n  if (value >= 1000) {\n    return new Intl.NumberFormat(\"en-US\", {\n      notation: \"compact\",\n      maximumFractionDigits: 1,\n    }).format(value);\n  }\n\n  return value.toLocaleString(\"en-US\", {\n    maximumFractionDigits: 2,\n  });\n}\n\n/**\n * Converts field names to human-readable labels\n * @param field - Field name in camelCase or snake_case\n * @returns Formatted label with proper capitalization\n * @example\n * formatFieldLabel(\"totalCost\") // \"Total Cost\"\n * formatFieldLabel(\"user_name\") // \"User Name\"\n * formatFieldLabel(\"revenue\") // \"Revenue\"\n */\nexport function formatFieldLabel(field: string): string {\n  const safe = field.replace(/[^a-zA-Z0-9_-]/g, \"\");\n  return safe\n    .replace(/([A-Z])/g, \" $1\")\n    .replace(/_/g, \" \")\n    .replace(/\\b\\w/g, (l) => l.toUpperCase())\n    .trim();\n}\n\n/** Regex for validating field names */\nexport const SAFE_KEY_REGEX = /^[a-zA-Z_][a-zA-Z0-9_]*$/;\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,iBAAiB,OAAe,WAA2B;AACzE,KACE,UAAU,aAAa,CAAC,SAAS,OAAO,IACxC,UAAU,aAAa,CAAC,SAAS,QAAQ,IACzC,UAAU,aAAa,CAAC,SAAS,QAAQ,IACzC,UAAU,aAAa,CAAC,SAAS,UAAU,IAC3C,UAAU,aAAa,CAAC,SAAS,MAAM,CAEvC,QAAO,IAAI,KAAK,aAAa,SAAS;EACpC,OAAO;EACP,UAAU;EACV,uBAAuB;EACvB,uBAAuB;EACxB,CAAC,CAAC,OAAO,MAAM;AAGlB,KAAI,SAAS,IACX,QAAO,IAAI,KAAK,aAAa,SAAS;EACpC,UAAU;EACV,uBAAuB;EACxB,CAAC,CAAC,OAAO,MAAM;AAGlB,QAAO,MAAM,eAAe,SAAS,EACnC,uBAAuB,GACxB,CAAC;;;;;;;;;;;AAYJ,SAAgB,iBAAiB,OAAuB;AAEtD,QADa,MAAM,QAAQ,mBAAmB,GAAG,CAE9C,QAAQ,YAAY,MAAM,CAC1B,QAAQ,MAAM,IAAI,CAClB,QAAQ,UAAU,MAAM,EAAE,aAAa,CAAC,CACxC,MAAM;;;AAIX,MAAa,iBAAiB"}
+{"version":3,"file":"format.js","names":[],"sources":["../../../src/react/lib/format.ts"],"sourcesContent":["/**\n * Formats numeric values based on field name context\n * @param value - The numeric value to format\n * @param fieldName - The field name to determine formatting\n * @returns Formatted string representation\n * @example\n * formatChartValue(1234.56, \"cost\") // \"$1,234.56\"\n * formatChartValue(5000, \"users\") // \"5.0k\"\n * formatChartValue(42.7, \"percentage\") // \"42.7\"\n */\nexport function formatChartValue(value: number, fieldName: string): string {\n  if (\n    fieldName.toLowerCase().includes(\"cost\") ||\n    fieldName.toLowerCase().includes(\"price\") ||\n    fieldName.toLowerCase().includes(\"spend\") ||\n    fieldName.toLowerCase().includes(\"revenue\") ||\n    fieldName.toLowerCase().includes(\"usd\")\n  ) {\n    return new Intl.NumberFormat(\"en-US\", {\n      style: \"currency\",\n      currency: \"USD\",\n      minimumFractionDigits: 2,\n      maximumFractionDigits: 2,\n    }).format(value);\n  }\n\n  if (value >= 1000) {\n    return new Intl.NumberFormat(\"en-US\", {\n      notation: \"compact\",\n      maximumFractionDigits: 1,\n    }).format(value);\n  }\n\n  return value.toLocaleString(\"en-US\", {\n    maximumFractionDigits: 2,\n  });\n}\n\n/**\n * Converts field names to human-readable labels\n * @param field - Field name in camelCase or snake_case\n * @returns Formatted label with proper capitalization\n * @example\n * formatFieldLabel(\"totalCost\") // \"Total Cost\"\n * formatFieldLabel(\"user_name\") // \"User Name\"\n * formatFieldLabel(\"revenue\") // \"Revenue\"\n */\nexport function formatFieldLabel(field: string): string {\n  const safe = field.replace(/[^a-zA-Z0-9_-]/g, \"\");\n  return safe\n    .replace(/([A-Z])/g, \" $1\")\n    .replace(/_/g, \" \")\n    .replace(/\\b\\w/g, (l) => l.toUpperCase())\n    .trim();\n}\n\n/**\n * Formats byte values into human-readable file sizes\n * @param bytes - The file size in bytes\n * @returns Formatted string (e.g., \"1.5 KB\", \"3.2 MB\")\n * @example\n * formatFileSize(512) // \"512 B\"\n * formatFileSize(1536) // \"1.5 KB\"\n * formatFileSize(2621440) // \"2.5 MB\"\n */\nexport function formatFileSize(bytes: number | undefined): string {\n  if (bytes === undefined || bytes === null) return \"Unknown\";\n  if (bytes < 1024) return `${bytes} B`;\n  if (bytes < 1024 * 1024) return `${(bytes / 1024).toFixed(1)} KB`;\n  if (bytes < 1024 * 1024 * 1024)\n    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;\n  return `${(bytes / (1024 * 1024 * 1024)).toFixed(1)} GB`;\n}\n\n/** Regex for validating field names */\nexport const SAFE_KEY_REGEX = /^[a-zA-Z_][a-zA-Z0-9_]*$/;\n"],"mappings":";;;;;;;;;;;AAUA,SAAgB,iBAAiB,OAAe,WAA2B;AACzE,KACE,UAAU,aAAa,CAAC,SAAS,OAAO,IACxC,UAAU,aAAa,CAAC,SAAS,QAAQ,IACzC,UAAU,aAAa,CAAC,SAAS,QAAQ,IACzC,UAAU,aAAa,CAAC,SAAS,UAAU,IAC3C,UAAU,aAAa,CAAC,SAAS,MAAM,CAEvC,QAAO,IAAI,KAAK,aAAa,SAAS;EACpC,OAAO;EACP,UAAU;EACV,uBAAuB;EACvB,uBAAuB;EACxB,CAAC,CAAC,OAAO,MAAM;AAGlB,KAAI,SAAS,IACX,QAAO,IAAI,KAAK,aAAa,SAAS;EACpC,UAAU;EACV,uBAAuB;EACxB,CAAC,CAAC,OAAO,MAAM;AAGlB,QAAO,MAAM,eAAe,SAAS,EACnC,uBAAuB,GACxB,CAAC;;;;;;;;;;;AAYJ,SAAgB,iBAAiB,OAAuB;AAEtD,QADa,MAAM,QAAQ,mBAAmB,GAAG,CAE9C,QAAQ,YAAY,MAAM,CAC1B,QAAQ,MAAM,IAAI,CAClB,QAAQ,UAAU,MAAM,EAAE,aAAa,CAAC,CACxC,MAAM;;;;;;;;;;;AAYX,SAAgB,eAAe,OAAmC;AAChE,KAAI,UAAU,UAAa,UAAU,KAAM,QAAO;AAClD,KAAI,QAAQ,KAAM,QAAO,GAAG,MAAM;AAClC,KAAI,QAAQ,OAAO,KAAM,QAAO,IAAI,QAAQ,MAAM,QAAQ,EAAE,CAAC;AAC7D,KAAI,QAAQ,OAAO,OAAO,KACxB,QAAO,IAAI,SAAS,OAAO,OAAO,QAAQ,EAAE,CAAC;AAC/C,QAAO,IAAI,SAAS,OAAO,OAAO,OAAO,QAAQ,EAAE,CAAC;;;AAItD,MAAa,iBAAiB"}

package/dist/react/table/data-table.js

@@ -1,9 +1,9 @@
-import { Button } from "../ui/button.js";
 import { formatFieldLabel } from "../lib/format.js";
+import { Button } from "../ui/button.js";
+import { Table as Table$1, TableBody, TableCell, TableHead, TableHeader, TableRow } from "../ui/table.js";
 import { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuTrigger } from "../ui/dropdown-menu.js";
 import { Input } from "../ui/input.js";
 import { Select, SelectContent, SelectItem, SelectTrigger, SelectValue } from "../ui/select.js";
-import { Table as Table$1, TableBody, TableCell, TableHead, TableHeader, TableRow } from "../ui/table.js";
 import { TableWrapper } from "./table-wrapper.js";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { ChevronDown } from "lucide-react";

package/dist/react/table/table-wrapper.js

@@ -1,6 +1,6 @@
 import { useAnalyticsQuery } from "../hooks/use-analytics-query.js";
-import { Button } from "../ui/button.js";
 import { SAFE_KEY_REGEX, formatChartValue, formatFieldLabel } from "../lib/format.js";
+import { Button } from "../ui/button.js";
 import { Checkbox } from "../ui/checkbox.js";
 import { EmptyState } from "./empty.js";
 import { ErrorState } from "./error.js";

package/dist/react/ui/breadcrumb.js

@@ -1,7 +1,7 @@
 import { cn } from "../lib/utils.js";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { Slot } from "@radix-ui/react-slot";
 import { ChevronRight, MoreHorizontal } from "lucide-react";
+import { Slot } from "@radix-ui/react-slot";
 
 //#region src/react/ui/breadcrumb.tsx
 /** Navigation component showing the current page's location in the site hierarchy */

package/dist/react/ui/index.js

@@ -1,20 +1,21 @@
 import { Button, buttonVariants } from "./button.js";
-import { ScrollArea, ScrollBar } from "./scroll-area.js";
+import { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "./card.js";
 import { Skeleton } from "./skeleton.js";
+import { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from "./breadcrumb.js";
+import { ScrollArea, ScrollBar } from "./scroll-area.js";
 import { Spinner } from "./spinner.js";
 import { Avatar, AvatarFallback, AvatarImage } from "./avatar.js";
-import { Card, CardAction, CardContent, CardDescription, CardFooter, CardHeader, CardTitle } from "./card.js";
+import { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from "./table.js";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "./tabs.js";
 import { DropdownMenu, DropdownMenuCheckboxItem, DropdownMenuContent, DropdownMenuGroup, DropdownMenuItem, DropdownMenuLabel, DropdownMenuPortal, DropdownMenuRadioGroup, DropdownMenuRadioItem, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuTrigger } from "./dropdown-menu.js";
 import { Input } from "./input.js";
 import { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue } from "./select.js";
-import { Table, TableBody, TableCaption, TableCell, TableFooter, TableHead, TableHeader, TableRow } from "./table.js";
 import { Checkbox } from "./checkbox.js";
 import { Accordion, AccordionContent, AccordionItem, AccordionTrigger } from "./accordion.js";
 import { Alert, AlertDescription, AlertTitle } from "./alert.js";
 import { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger } from "./alert-dialog.js";
 import { AspectRatio } from "./aspect-ratio.js";
 import { Badge, badgeVariants } from "./badge.js";
-import { Breadcrumb, BreadcrumbEllipsis, BreadcrumbItem, BreadcrumbLink, BreadcrumbList, BreadcrumbPage, BreadcrumbSeparator } from "./breadcrumb.js";
 import { Separator } from "./separator.js";
 import { ButtonGroup, ButtonGroupSeparator, ButtonGroupText, buttonGroupVariants } from "./button-group.js";
 import { Calendar, CalendarDayButton } from "./calendar.js";
@@ -48,6 +49,5 @@ import { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupActio
 import { Slider } from "./slider.js";
 import { Toaster } from "./sonner.js";
 import { Switch } from "./switch.js";
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "./tabs.js";
 import { Toggle, toggleVariants } from "./toggle.js";
 import { ToggleGroup, ToggleGroupItem } from "./toggle-group.js";

package/dist/react/ui/navigation-menu.js

@@ -1,7 +1,7 @@
 import { cn } from "../lib/utils.js";
 import { jsx, jsxs } from "react/jsx-runtime";
-import { cva } from "class-variance-authority";
 import { ChevronDownIcon } from "lucide-react";
+import { cva } from "class-variance-authority";
 import * as NavigationMenuPrimitive from "@radix-ui/react-navigation-menu";
 
 //#region src/react/ui/navigation-menu.tsx

package/dist/react/ui/sidebar.js

@@ -10,9 +10,9 @@ import { useIsMobile } from "../hooks/use-mobile.js";
 import { Tooltip, TooltipContent, TooltipProvider, TooltipTrigger } from "./tooltip.js";
 import * as React$1 from "react";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { PanelLeftIcon } from "lucide-react";
 import { Slot } from "@radix-ui/react-slot";
 import { cva } from "class-variance-authority";
-import { PanelLeftIcon } from "lucide-react";
 
 //#region src/react/ui/sidebar.tsx
 const SIDEBAR_COOKIE_NAME = "sidebar_state";

package/dist/shared/src/genie.d.ts

@@ -15,7 +15,7 @@ type GenieStreamEvent = {
   type: "query_result";
   attachmentId: string;
   statementId: string;
-  data: unknown;
+  data: GenieStatementResponse;
 } | {
   type: "error";
   error: string;
@@ -26,6 +26,20 @@ type GenieStreamEvent = {
   nextPageToken: string | null; /** Total messages returned in this initial load */
   loadedCount: number;
 };
+/** Shape of the Databricks SQL statement_response returned by Genie queries */
+interface GenieStatementResponse {
+  manifest: {
+    schema: {
+      columns: Array<{
+        name: string;
+        type_name: string;
+      }>;
+    };
+  };
+  result: {
+    data_array: (string | null)[][];
+  };
+}
 /** Cleaned response — subset of SDK GenieMessage */
 interface GenieMessageResponse {
   messageId: string;
@@ -50,5 +64,5 @@ interface GenieAttachmentResponse {
   suggestedQuestions?: string[];
 }
 //#endregion
-export { GenieAttachmentResponse, GenieMessageResponse, GenieStreamEvent };
+export { GenieAttachmentResponse, GenieMessageResponse, GenieStatementResponse, GenieStreamEvent };
 //# sourceMappingURL=genie.d.ts.map

package/dist/shared/src/genie.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"genie.d.ts","names":[],"sources":["../../../../shared/src/genie.ts"],"mappings":";;KACY,gBAAA;EAEN,IAAA;EACA,cAAA;EACA,SAAA;EACA,OAAA;AAAA;EAEA,IAAA;EAAgB,MAAA;AAAA;EAChB,IAAA;EAAwB,OAAA,EAAS,oBAAA;AAAA;EAEjC,IAAA;EACA,YAAA;EACA,WAAA;EACA,IAAA;AAAA;EAEA,IAAA;EAAe,KAAA;AAAA;EAEf,IAAA;EACA,cAAA;EACA,OAAA,UAIA;EAFA,aAAA,iBAEW;EAAX,WAAA;AAAA;;UAIW,oBAAA;EACf,SAAA;EACA,cAAA;EACA,OAAA;EACA,MAAA;EACA,OAAA;EACA,WAAA,GAAc,uBAAA;EACd,KAAA;AAAA;AAAA,UAGe,uBAAA;EACf,YAAA;EACA,KAAA;IACE,KAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;EAAA;EAEF,IAAA;IAAS,OAAA;EAAA;EACT,kBAAA;AAAA"}
+{"version":3,"file":"genie.d.ts","names":[],"sources":["../../../../shared/src/genie.ts"],"mappings":";;KACY,gBAAA;EAEN,IAAA;EACA,cAAA;EACA,SAAA;EACA,OAAA;AAAA;EAEA,IAAA;EAAgB,MAAA;AAAA;EAChB,IAAA;EAAwB,OAAA,EAAS,oBAAA;AAAA;EAEjC,IAAA;EACA,YAAA;EACA,WAAA;EACA,IAAA,EAAM,sBAAA;AAAA;EAEN,IAAA;EAAe,KAAA;AAAA;EAEf,IAAA;EACA,cAAA;EACA,OAAA,UAEA;EAAA,aAAA,iBAEW;EAAX,WAAA;AAAA;;UAIW,sBAAA;EACf,QAAA;IACE,MAAA;MACE,OAAA,EAAS,KAAA;QAAQ,IAAA;QAAc,SAAA;MAAA;IAAA;EAAA;EAGnC,MAAA;IACE,UAAA;EAAA;AAAA;;UAKa,oBAAA;EACf,SAAA;EACA,cAAA;EACA,OAAA;EACA,MAAA;EACA,OAAA;EACA,WAAA,GAAc,uBAAA;EACd,KAAA;AAAA;AAAA,UAGe,uBAAA;EACf,YAAA;EACA,KAAA;IACE,KAAA;IACA,WAAA;IACA,KAAA;IACA,WAAA;EAAA;EAEF,IAAA;IAAS,OAAA;EAAA;EACT,kBAAA;AAAA"}

package/dist/shared/src/index.d.ts

@@ -1,7 +1,7 @@
 import "./plugin.js";
 import "./cache.js";
 import "./execute.js";
-import { GenieAttachmentResponse, GenieMessageResponse, GenieStreamEvent } from "./genie.js";
+import { GenieAttachmentResponse, GenieMessageResponse, GenieStatementResponse, GenieStreamEvent } from "./genie.js";
 import { SQLBinaryMarker, SQLBooleanMarker, SQLDateMarker, SQLNumberMarker, SQLStringMarker, SQLTimestampMarker, SQLTypeMarker } from "./sql/types.js";
 import { isSQLTypeMarker, sql } from "./sql/helpers.js";
 import "./tunnel.js";

package/docs/api/appkit/Class.Plugin.md

@@ -32,7 +32,6 @@ const myManifest: PluginManifest = {
 
 class MyPlugin extends Plugin<MyConfig> {
   static manifest = myManifest;
-  name = 'myPlugin';
 }
 
 ```
@@ -56,8 +55,7 @@ const myManifest: PluginManifest = {
 };
 
 class MyPlugin extends Plugin<MyConfig> {
-  static manifest = myManifest;
-  name = 'myPlugin';
+  static manifest = myManifest<"myPlugin">;
 
   // Runtime method: converts optional resources to required based on config
   static getResourceRequirements(config: MyConfig) {
@@ -253,7 +251,7 @@ A proxied plugin instance that executes as the user
 
 #### Throws[​](#throws "Direct link to Throws")
 
-Error if user token is not available in request headers
+AuthenticationError if user token is not available in request headers (production only). In development mode (`NODE_ENV=development`), falls back to the service principal instead of throwing.
 
 ***
 
@@ -267,6 +265,10 @@ userKey?: string): Promise<T | undefined>;
 
 ```
 
+Execute a function with the plugin's interceptor chain.
+
+All errors are caught and `undefined` is returned (production-safe). Route handlers should check for `undefined` and respond with an appropriate error status.
+
 #### Type Parameters[​](#type-parameters-1 "Direct link to Type Parameters")
 
 | Type Parameter |
@@ -338,7 +340,6 @@ The returned object becomes the plugin's public API on the AppKit instance (e.g.
 
 ```ts
 class MyPlugin extends Plugin {
-  name = "myPlugin";
   private getData() { return []; }
 
   exports() {
@@ -381,6 +382,26 @@ BasePlugin.getEndpoints
 
 ***
 
+### getSkipBodyParsingPaths()[​](#getskipbodyparsingpaths "Direct link to getSkipBodyParsingPaths()")
+
+```ts
+getSkipBodyParsingPaths(): ReadonlySet<string>;
+
+```
+
+#### Returns[​](#returns-7 "Direct link to Returns")
+
+`ReadonlySet`<`string`>
+
+#### Implementation of[​](#implementation-of-4 "Direct link to Implementation of")
+
+```ts
+BasePlugin.getSkipBodyParsingPaths
+
+```
+
+***
+
 ### injectRoutes()[​](#injectroutes "Direct link to injectRoutes()")
 
 ```ts
@@ -394,11 +415,11 @@ injectRoutes(_: Router): void;
 | --------- | -------- |
 | `_`       | `Router` |
 
-#### Returns[​](#returns-7 "Direct link to Returns")
+#### Returns[​](#returns-8 "Direct link to Returns")
 
 `void`
 
-#### Implementation of[​](#implementation-of-4 "Direct link to Implementation of")
+#### Implementation of[​](#implementation-of-5 "Direct link to Implementation of")
 
 ```ts
 BasePlugin.injectRoutes
@@ -421,12 +442,39 @@ protected registerEndpoint(name: string, path: string): void;
 | `name`    | `string` |
 | `path`    | `string` |
 
-#### Returns[​](#returns-8 "Direct link to Returns")
+#### Returns[​](#returns-9 "Direct link to Returns")
 
 `void`
 
 ***
 
+### resolveUserId()[​](#resolveuserid "Direct link to resolveUserId()")
+
+```ts
+protected resolveUserId(req: Request): string;
+
+```
+
+Resolve the effective user ID from a request.
+
+Returns the `x-forwarded-user` header when present. In development mode (`NODE_ENV=development`) falls back to the current context user ID so that callers outside an active `runInUserContext` scope still get a consistent value.
+
+#### Parameters[​](#parameters-6 "Direct link to Parameters")
+
+| Parameter | Type      |
+| --------- | --------- |
+| `req`     | `Request` |
+
+#### Returns[​](#returns-10 "Direct link to Returns")
+
+`string`
+
+#### Throws[​](#throws-1 "Direct link to Throws")
+
+AuthenticationError in production when no user header is present.
+
+***
+
 ### route()[​](#route "Direct link to route()")
 
 ```ts
@@ -440,14 +488,14 @@ protected route<_TResponse>(router: Router, config: RouteConfig): void;
 | -------------- |
 | `_TResponse`   |
 
-#### Parameters[​](#parameters-6 "Direct link to Parameters")
+#### Parameters[​](#parameters-7 "Direct link to Parameters")
 
 | Parameter | Type          |
 | --------- | ------------- |
 | `router`  | `Router`      |
 | `config`  | `RouteConfig` |
 
-#### Returns[​](#returns-9 "Direct link to Returns")
+#### Returns[​](#returns-11 "Direct link to Returns")
 
 `void`
 
@@ -460,11 +508,11 @@ setup(): Promise<void>;
 
 ```
 
-#### Returns[​](#returns-10 "Direct link to Returns")
+#### Returns[​](#returns-12 "Direct link to Returns")
 
 `Promise`<`void`>
 
-#### Implementation of[​](#implementation-of-5 "Direct link to Implementation of")
+#### Implementation of[​](#implementation-of-6 "Direct link to Implementation of")
 
 ```ts
 BasePlugin.setup

package/docs/api/appkit/Class.ResourceRegistry.md

@@ -43,9 +43,9 @@ Collects and registers resource requirements from an array of plugins. For each
 
 #### Parameters[​](#parameters "Direct link to Parameters")
 
-| Parameter    | Type                                                      | Description                                               |
-| ------------ | --------------------------------------------------------- | --------------------------------------------------------- |
-| `rawPlugins` | `PluginData`<`PluginConstructor`, `unknown`, `string`>\[] | Array of plugin data entries from createApp configuration |
+| Parameter    | Type                                                                                                         | Description                                               |
+| ------------ | ------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------- |
+| `rawPlugins` | [`PluginData`](./docs/api/appkit/TypeAlias.PluginData.md)<`PluginConstructor`, `unknown`, `string`>\[] | Array of plugin data entries from createApp configuration |
 
 #### Returns[​](#returns-2 "Direct link to Returns")
 

package/docs/api/appkit/Function.createApp.md

@@ -16,9 +16,9 @@ Initializes telemetry, cache, and service context, then registers plugins in pha
 
 ## Type Parameters[​](#type-parameters "Direct link to Type Parameters")
 
-| Type Parameter                                                          |
-| ----------------------------------------------------------------------- |
-| `T` *extends* `PluginData`<`PluginConstructor`, `unknown`, `string`>\[] |
+| Type Parameter                                                                                                             |
+| -------------------------------------------------------------------------------------------------------------------------- |
+| `T` *extends* [`PluginData`](./docs/api/appkit/TypeAlias.PluginData.md)<`PluginConstructor`, `unknown`, `string`>\[] |
 
 ## Parameters[​](#parameters "Direct link to Parameters")
 

package/docs/api/appkit/Interface.PluginManifest.md

@@ -1,7 +1,13 @@
-# Interface: PluginManifest
+# Interface: PluginManifest\<TName>
 
 Plugin manifest that declares metadata and resource requirements. Attached to plugin classes as a static property.
 
+## Type Parameters[​](#type-parameters "Direct link to Type Parameters")
+
+| Type Parameter             | Default type |
+| -------------------------- | ------------ |
+| `TName` *extends* `string` | `string`     |
+
 ## Properties[​](#properties "Direct link to Properties")
 
 ### author?[​](#author "Direct link to author?")
@@ -89,11 +95,11 @@ optional license: string;
 ### name[​](#name "Direct link to name")
 
 ```ts
-name: string;
+name: TName;
 
 ```
 
-Plugin identifier (matches plugin.name)
+Plugin identifier — the single source of truth for the plugin's name
 
 ***
 

package/docs/api/appkit/TypeAlias.PluginData.md

@@ -0,0 +1,45 @@
+# Type Alias: PluginData\<T, U, N>
+
+```ts
+type PluginData<T, U, N> = {
+  config: U;
+  name: N;
+  plugin: T;
+};
+
+```
+
+## Type Parameters[​](#type-parameters "Direct link to Type Parameters")
+
+| Type Parameter |
+| -------------- |
+| `T`            |
+| `U`            |
+| `N`            |
+
+## Properties[​](#properties "Direct link to Properties")
+
+### config[​](#config "Direct link to config")
+
+```ts
+config: U;
+
+```
+
+***
+
+### name[​](#name "Direct link to name")
+
+```ts
+name: N;
+
+```
+
+***
+
+### plugin[​](#plugin "Direct link to plugin")
+
+```ts
+plugin: T;
+
+```

package/docs/api/appkit/TypeAlias.ToPlugin.md

@@ -21,4 +21,4 @@ type ToPlugin<T, U, N> = (config?: U) => PluginData<T, U, N>;
 
 ## Returns[​](#returns "Direct link to Returns")
 
-`PluginData`<`T`, `U`, `N`>
+[`PluginData`](./docs/api/appkit/TypeAlias.PluginData.md)<`T`, `U`, `N`>

package/docs/api/appkit-ui/files/DirectoryList.md

@@ -0,0 +1,36 @@
+# DirectoryList
+
+Card-wrapped directory listing with loading, error, and empty states
+
+## DirectoryList[​](#directorylist-1 "Direct link to DirectoryList")
+
+Card-wrapped directory listing with loading, error, and empty states
+
+**Source:** [`packages/appkit-ui/src/react/file-browser/directory-list.tsx`](https://github.com/databricks/appkit/blob/main/packages/appkit-ui/src/react/file-browser/directory-list.tsx)
+
+### Props[​](#props "Direct link to Props")
+
+| Prop                 | Type                                                                                             | Required | Default | Description                                                                        |
+| -------------------- | ------------------------------------------------------------------------------------------------ | -------- | ------- | ---------------------------------------------------------------------------------- |
+| `entries`            | `DirectoryEntry[]`                                                                               | ✓        | -       | Directory entries to display                                                       |
+| `loading`            | `boolean`                                                                                        |          | -       | Whether the directory is currently loading                                         |
+| `error`              | `string \| null`                                                                                 |          | -       | Error message to display                                                           |
+| `onEntryClick`       | `(entry: DirectoryEntry) => void`                                                                | ✓        | -       | Called when an entry is clicked                                                    |
+| `onNavigateToParent` | `(() => void)`                                                                                   |          | -       | Called when the back/parent button is clicked                                      |
+| `onRetry`            | `(() => void)`                                                                                   |          | -       | Called when the retry button is clicked                                            |
+| `isAtRoot`           | `boolean`                                                                                        |          | -       | Whether the user is at the root directory (hides back button)                      |
+| `selectedPath`       | `string \| null`                                                                                 |          | -       | Currently selected file path for highlighting                                      |
+| `resolveEntryPath`   | `(entry: DirectoryEntry) => string`                                                              | ✓        | -       | Resolves a DirectoryEntry to its full path                                         |
+| `headerContent`      | `ReactNode`                                                                                      |          | -       | Content rendered between the back button and the entry list (e.g., NewFolderInput) |
+| `hasCurrentPath`     | `boolean`                                                                                        |          | -       | Whether a current path is set (affects empty state message)                        |
+| `formatSize`         | `((bytes: number) => string)`                                                                    |          | -       | Custom file size formatter                                                         |
+| `labels`             | `Pick<FileBrowserLabels, "backToParent" \| "emptyDirectory" \| "noVolumeConfigured" \| "retry">` |          | -       | Customizable labels                                                                |
+
+### Usage[​](#usage "Direct link to Usage")
+
+```tsx
+import { DirectoryList } from '@databricks/appkit-ui';
+
+<DirectoryList /* props */ />
+
+```

package/docs/api/appkit-ui/files/FileBreadcrumb.md

@@ -0,0 +1,27 @@
+# FileBreadcrumb
+
+Path-aware breadcrumb navigation built on top of Breadcrumb primitives
+
+## FileBreadcrumb[​](#filebreadcrumb-1 "Direct link to FileBreadcrumb")
+
+Path-aware breadcrumb navigation built on top of Breadcrumb primitives
+
+**Source:** [`packages/appkit-ui/src/react/file-browser/file-breadcrumb.tsx`](https://github.com/databricks/appkit/blob/main/packages/appkit-ui/src/react/file-browser/file-breadcrumb.tsx)
+
+### Props[​](#props "Direct link to Props")
+
+| Prop                  | Type                      | Required | Default | Description                                                          |
+| --------------------- | ------------------------- | -------- | ------- | -------------------------------------------------------------------- |
+| `rootLabel`           | `string`                  | ✓        | -       | Label for the root breadcrumb item                                   |
+| `segments`            | `string[]`                | ✓        | -       | Path segments after the root                                         |
+| `onNavigateToRoot`    | `() => void`              | ✓        | -       | Called when the root breadcrumb is clicked                           |
+| `onNavigateToSegment` | `(index: number) => void` | ✓        | -       | Called when a segment breadcrumb is clicked (receives segment index) |
+
+### Usage[​](#usage "Direct link to Usage")
+
+```tsx
+import { FileBreadcrumb } from '@databricks/appkit-ui';
+
+<FileBreadcrumb /* props */ />
+
+```