@datum-cloud/datum-ui 1.3.2 → 1.5.0

package/dist/components/base/select/select.d.ts

@@ -1,7 +1,7 @@
-import { SelectContent as ShadcnSelectContent, SelectGroup as ShadcnSelectGroup, SelectItem as ShadcnSelectItem, SelectLabel as ShadcnSelectLabel, SelectScrollDownButton as ShadcnSelectScrollDownButton, SelectScrollUpButton as ShadcnSelectScrollUpButton, SelectSeparator as ShadcnSelectSeparator, SelectTrigger as ShadcnSelectTrigger } from '../../../_shadcn/ui/select';
+import { Select as ShadcnSelect, SelectContent as ShadcnSelectContent, SelectGroup as ShadcnSelectGroup, SelectItem as ShadcnSelectItem, SelectLabel as ShadcnSelectLabel, SelectScrollDownButton as ShadcnSelectScrollDownButton, SelectScrollUpButton as ShadcnSelectScrollUpButton, SelectSeparator as ShadcnSelectSeparator, SelectTrigger as ShadcnSelectTrigger, SelectValue as ShadcnSelectValue } from '../../../_shadcn/ui/select';
 import * as React from 'react';
-declare const Select: ({ ...props }: React.ComponentProps<React.FC<import("@radix-ui/react-select").SelectProps>>) => React.JSX.Element;
-declare const SelectValue: ({ ...props }: React.ComponentProps<React.ForwardRefExoticComponent<import("@radix-ui/react-select").SelectValueProps & React.RefAttributes<HTMLSpanElement>>>) => React.JSX.Element;
+declare const Select: typeof ShadcnSelect;
+declare const SelectValue: typeof ShadcnSelectValue;
 declare function SelectGroup({ ref, className, ...props }: React.ComponentProps<typeof ShadcnSelectGroup> & {
     ref?: React.RefObject<React.ElementRef<typeof ShadcnSelectGroup> | null>;
 }): React.JSX.Element;
@@ -51,4 +51,3 @@ declare namespace SelectScrollDownButton {
     var displayName: string;
 }
 export { Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, };
-//# sourceMappingURL=select.d.ts.map

package/dist/components/base/separator/index.d.ts

@@ -1,2 +1 @@
 export * from '../../../_shadcn/ui/separator';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/sheet/index.d.ts

@@ -1,2 +1 @@
 export { Sheet, SheetClose, SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetTitle, SheetTrigger, } from './sheet';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/sheet/sheet.d.ts

@@ -20,4 +20,3 @@ interface SheetComponent extends React.FC<React.ComponentProps<typeof ShadcnShee
 }
 export declare const Sheet: SheetComponent;
 export { SheetContent, SheetDescription, SheetFooter, SheetHeader, SheetOverlay, SheetTitle, SheetTrigger, };
-//# sourceMappingURL=sheet.d.ts.map

package/dist/components/base/sidebar/context.d.ts

@@ -0,0 +1,32 @@
+import * as React from 'react';
+declare const SIDEBAR_WIDTH = "13rem";
+declare const SIDEBAR_WIDTH_MOBILE = "18rem";
+declare const SIDEBAR_WIDTH_ICON = "3rem";
+interface SidebarContext {
+    state: 'expanded' | 'collapsed';
+    open: boolean;
+    setOpen: (open: boolean) => void;
+    openMobile: boolean;
+    setOpenMobile: (open: boolean) => void;
+    isMobile: boolean;
+    toggleSidebar: () => void;
+    handleMouseEnter: () => void;
+    handleMouseLeave: () => void;
+    forceClose: () => void;
+    closeForNavigation: () => void;
+    hasSubLayout: boolean;
+    setHasSubLayout: (value: boolean) => void;
+    expandBehavior: 'push' | 'overlay';
+    showBackdrop: boolean;
+}
+declare const SidebarContext: React.Context<SidebarContext | null>;
+declare function useSidebar(): SidebarContext;
+declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: setOpenProp, expandOnHover, expandBehavior, showBackdrop, className, style, children, ...props }: React.ComponentProps<'div'> & {
+    defaultOpen?: boolean;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    expandOnHover?: boolean;
+    expandBehavior?: 'push' | 'overlay';
+    showBackdrop?: boolean;
+}): React.JSX.Element;
+export { SIDEBAR_WIDTH, SIDEBAR_WIDTH_ICON, SIDEBAR_WIDTH_MOBILE, SidebarProvider, useSidebar, };

package/dist/components/base/sidebar/group.d.ts

@@ -0,0 +1,10 @@
+import * as React from 'react';
+declare function SidebarGroup({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function SidebarGroupLabel({ className, asChild, ...props }: React.ComponentProps<'div'> & {
+    asChild?: boolean;
+}): React.JSX.Element;
+declare function SidebarGroupAction({ className, asChild, ...props }: React.ComponentProps<'button'> & {
+    asChild?: boolean;
+}): React.JSX.Element;
+declare function SidebarGroupContent({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+export { SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, };

package/dist/components/base/sidebar/index.d.ts

@@ -1,2 +1 @@
 export * from './sidebar';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/sidebar/menu.d.ts

@@ -0,0 +1,33 @@
+import type { VariantProps } from 'class-variance-authority';
+import * as React from 'react';
+declare function SidebarMenu({ className, ...props }: React.ComponentProps<'ul'>): React.JSX.Element;
+declare function SidebarMenuItem({ className, ...props }: React.ComponentProps<'li'>): React.JSX.Element;
+declare const sidebarMenuButtonVariants: (props?: ({
+    variant?: "default" | "outline" | null | undefined;
+    size?: "default" | "sm" | "lg" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+declare function SidebarMenuButton({ asChild, isActive, variant, size, tooltip, className, ...props }: React.ComponentProps<'button'> & {
+    asChild?: boolean;
+    isActive?: boolean;
+    tooltip?: string | React.ReactNode | {
+        message: string | React.ReactNode;
+        side?: 'top' | 'right' | 'bottom' | 'left';
+        align?: 'start' | 'center' | 'end';
+    };
+} & VariantProps<typeof sidebarMenuButtonVariants>): React.JSX.Element;
+declare function SidebarMenuAction({ className, asChild, showOnHover, ...props }: React.ComponentProps<'button'> & {
+    asChild?: boolean;
+    showOnHover?: boolean;
+}): React.JSX.Element;
+declare function SidebarMenuBadge({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function SidebarMenuSkeleton({ className, showIcon, ...props }: React.ComponentProps<'div'> & {
+    showIcon?: boolean;
+}): React.JSX.Element;
+declare function SidebarMenuSub({ className, ...props }: React.ComponentProps<'ul'>): React.JSX.Element;
+declare function SidebarMenuSubItem({ className, ...props }: React.ComponentProps<'li'>): React.JSX.Element;
+declare function SidebarMenuSubButton({ asChild, size, isActive, className, ...props }: React.ComponentProps<'a'> & {
+    asChild?: boolean;
+    size?: 'sm' | 'md';
+    isActive?: boolean;
+}): React.JSX.Element;
+export { SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, sidebarMenuButtonVariants, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, };

package/dist/components/base/sidebar/shell.d.ts

@@ -0,0 +1,18 @@
+import { Button } from '../../../_shadcn/ui/button';
+import { Separator } from '../../../_shadcn/ui/separator';
+import * as React from 'react';
+import { Input } from '../input/input';
+declare function Sidebar({ side, variant, collapsible, className, children, ...props }: React.ComponentProps<'div'> & {
+    side?: 'left' | 'right';
+    variant?: 'sidebar' | 'floating' | 'inset';
+    collapsible?: 'offcanvas' | 'icon' | 'none';
+}): React.JSX.Element;
+declare function SidebarTrigger({ className, onClick, ...props }: React.ComponentProps<typeof Button>): React.JSX.Element;
+declare function SidebarRail({ className, ...props }: React.ComponentProps<'button'>): React.JSX.Element;
+declare function SidebarInset({ className, ...props }: React.ComponentProps<'main'>): React.JSX.Element;
+declare function SidebarInput({ className, ...props }: React.ComponentProps<typeof Input>): React.JSX.Element;
+declare function SidebarHeader({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function SidebarFooter({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+declare function SidebarSeparator({ className, ...props }: React.ComponentProps<typeof Separator>): React.JSX.Element;
+declare function SidebarContent({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
+export { Sidebar, SidebarContent, SidebarFooter, SidebarHeader, SidebarInput, SidebarInset, SidebarRail, SidebarSeparator, SidebarTrigger, };

package/dist/components/base/sidebar/sidebar.d.ts

@@ -1,85 +1,5 @@
-import type { VariantProps } from 'class-variance-authority';
-import { Button } from '../../../_shadcn/ui/button';
-import { Separator } from '../../../_shadcn/ui/separator';
-import * as React from 'react';
-import { Input } from '../input/input';
-interface SidebarContext {
-    state: 'expanded' | 'collapsed';
-    open: boolean;
-    setOpen: (open: boolean) => void;
-    openMobile: boolean;
-    setOpenMobile: (open: boolean) => void;
-    isMobile: boolean;
-    toggleSidebar: () => void;
-    handleMouseEnter: () => void;
-    handleMouseLeave: () => void;
-    forceClose: () => void;
-    closeForNavigation: () => void;
-    hasSubLayout: boolean;
-    setHasSubLayout: (value: boolean) => void;
-    expandBehavior: 'push' | 'overlay';
-    showBackdrop: boolean;
-}
-declare const SidebarContext: React.Context<SidebarContext | null>;
-declare function useSidebar(): SidebarContext;
-declare function SidebarProvider({ defaultOpen, open: openProp, onOpenChange: setOpenProp, expandOnHover, expandBehavior, showBackdrop, className, style, children, ...props }: React.ComponentProps<'div'> & {
-    defaultOpen?: boolean;
-    open?: boolean;
-    onOpenChange?: (open: boolean) => void;
-    expandOnHover?: boolean;
-    expandBehavior?: 'push' | 'overlay';
-    showBackdrop?: boolean;
-}): React.JSX.Element;
-declare function Sidebar({ side, variant, collapsible, className, children, ...props }: React.ComponentProps<'div'> & {
-    side?: 'left' | 'right';
-    variant?: 'sidebar' | 'floating' | 'inset';
-    collapsible?: 'offcanvas' | 'icon' | 'none';
-}): React.JSX.Element;
-declare function SidebarTrigger({ className, onClick, ...props }: React.ComponentProps<typeof Button>): React.JSX.Element;
-declare function SidebarRail({ className, ...props }: React.ComponentProps<'button'>): React.JSX.Element;
-declare function SidebarInset({ className, ...props }: React.ComponentProps<'main'>): React.JSX.Element;
-declare function SidebarInput({ className, ...props }: React.ComponentProps<typeof Input>): React.JSX.Element;
-declare function SidebarHeader({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare function SidebarFooter({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare function SidebarSeparator({ className, ...props }: React.ComponentProps<typeof Separator>): React.JSX.Element;
-declare function SidebarContent({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare function SidebarGroup({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare function SidebarGroupLabel({ className, asChild, ...props }: React.ComponentProps<'div'> & {
-    asChild?: boolean;
-}): React.JSX.Element;
-declare function SidebarGroupAction({ className, asChild, ...props }: React.ComponentProps<'button'> & {
-    asChild?: boolean;
-}): React.JSX.Element;
-declare function SidebarGroupContent({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare function SidebarMenu({ className, ...props }: React.ComponentProps<'ul'>): React.JSX.Element;
-declare function SidebarMenuItem({ className, ...props }: React.ComponentProps<'li'>): React.JSX.Element;
-declare const sidebarMenuButtonVariants: (props?: ({
-    variant?: "default" | "outline" | null | undefined;
-    size?: "default" | "sm" | "lg" | null | undefined;
-} & import("class-variance-authority/types").ClassProp) | undefined) => string;
-declare function SidebarMenuButton({ asChild, isActive, variant, size, tooltip, className, ...props }: React.ComponentProps<'button'> & {
-    asChild?: boolean;
-    isActive?: boolean;
-    tooltip?: string | React.ReactNode | {
-        message: string | React.ReactNode;
-        side?: 'top' | 'right' | 'bottom' | 'left';
-        align?: 'start' | 'center' | 'end';
-    };
-} & VariantProps<typeof sidebarMenuButtonVariants>): React.JSX.Element;
-declare function SidebarMenuAction({ className, asChild, showOnHover, ...props }: React.ComponentProps<'button'> & {
-    asChild?: boolean;
-    showOnHover?: boolean;
-}): React.JSX.Element;
-declare function SidebarMenuBadge({ className, ...props }: React.ComponentProps<'div'>): React.JSX.Element;
-declare function SidebarMenuSkeleton({ className, showIcon, ...props }: React.ComponentProps<'div'> & {
-    showIcon?: boolean;
-}): React.JSX.Element;
-declare function SidebarMenuSub({ className, ...props }: React.ComponentProps<'ul'>): React.JSX.Element;
-declare function SidebarMenuSubItem({ className, ...props }: React.ComponentProps<'li'>): React.JSX.Element;
-declare function SidebarMenuSubButton({ asChild, size, isActive, className, ...props }: React.ComponentProps<'a'> & {
-    asChild?: boolean;
-    size?: 'sm' | 'md';
-    isActive?: boolean;
-}): React.JSX.Element;
+import { SidebarProvider, useSidebar } from './context';
+import { SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel } from './group';
+import { SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem } from './menu';
+import { Sidebar, SidebarContent, SidebarFooter, SidebarHeader, SidebarInput, SidebarInset, SidebarRail, SidebarSeparator, SidebarTrigger } from './shell';
 export { Sidebar, SidebarContent, SidebarFooter, SidebarGroup, SidebarGroupAction, SidebarGroupContent, SidebarGroupLabel, SidebarHeader, SidebarInput, SidebarInset, SidebarMenu, SidebarMenuAction, SidebarMenuBadge, SidebarMenuButton, SidebarMenuItem, SidebarMenuSkeleton, SidebarMenuSub, SidebarMenuSubButton, SidebarMenuSubItem, SidebarProvider, SidebarRail, SidebarSeparator, SidebarTrigger, useSidebar, };
-//# sourceMappingURL=sidebar.d.ts.map

package/dist/components/base/skeleton/index.d.ts

@@ -1,2 +1 @@
 export * from './skeleton';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/skeleton/skeleton.d.ts

@@ -19,4 +19,3 @@ declare namespace Skeleton {
     var displayName: string;
 }
 export { Skeleton };
-//# sourceMappingURL=skeleton.d.ts.map

package/dist/components/base/spinner/index.d.ts

@@ -1,2 +1 @@
 export * from '../../../_shadcn/ui/spinner';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/switch/index.d.ts

@@ -1,2 +1 @@
 export { Switch } from './switch';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/switch/switch.d.ts

@@ -7,4 +7,3 @@ declare namespace Switch {
     var displayName: string;
 }
 export { Switch };
-//# sourceMappingURL=switch.d.ts.map

package/dist/components/base/table/index.d.ts

@@ -1,2 +1 @@
 export * from '../../../_shadcn/ui/table';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/tabs/index.d.ts

@@ -1,2 +1 @@
 export * from './tabs';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/tabs/tabs.d.ts

@@ -19,4 +19,3 @@ interface TabsLinkTriggerProps extends React.ComponentProps<typeof TabsPrimitive
 declare function TabsLinkTrigger({ value, href, linkComponent: LinkComp, children, className, ...props }: TabsLinkTriggerProps): React.JSX.Element;
 export { Tabs, TabsContent, TabsLinkTrigger, TabsList, TabsTrigger };
 export type { TabsLinkTriggerProps };
-//# sourceMappingURL=tabs.d.ts.map

package/dist/components/base/textarea/index.d.ts

@@ -1,2 +1 @@
 export { Textarea } from './textarea';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/textarea/textarea.d.ts

@@ -6,4 +6,3 @@ declare namespace Textarea {
     var displayName: string;
 }
 export { Textarea };
-//# sourceMappingURL=textarea.d.ts.map

package/dist/components/base/tooltip/index.d.ts

@@ -1,2 +1 @@
 export { Tooltip } from './tooltip';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/tooltip/tooltip.d.ts

@@ -14,4 +14,3 @@ interface TooltipProps {
 }
 export declare function Tooltip({ message, children, delayDuration, side, align, sideOffset, hidden, open, onOpenChange, contentClassName, arrowClassName, }: TooltipProps): import("react").JSX.Element;
 export {};
-//# sourceMappingURL=tooltip.d.ts.map

package/dist/components/base/typography/index.d.ts

@@ -1,2 +1 @@
 export * from './typography';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/base/typography/typography.d.ts

@@ -1179,4 +1179,3 @@ interface CodeProps extends React.HTMLAttributes<HTMLElement> {
 declare function Code({ className, as, children, ...props }: CodeProps): React.JSX.Element;
 export { Blockquote, Code, Link, List, ListItem, Paragraph, paragraphVariants, Text, textVariants, Title, titleVariants, };
 export type { BlockquoteProps, CodeProps, LinkProps, ListItemProps, ListProps, ParagraphProps, TextProps, TitleProps };
-//# sourceMappingURL=typography.d.ts.map

package/dist/components/base/visuallyhidden/index.d.ts

@@ -1,2 +1 @@
 export * from '../../../_shadcn/ui/visuallyhidden';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/_shared/index.d.ts

@@ -0,0 +1,2 @@
+export { endOfDayInTz, startOfDayInTz } from './timezone';
+export { useDeprecationWarning } from './use-deprecation-warning';

package/dist/components/features/_shared/timezone.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Start of the calendar day (00:00:00.000) for `date`, interpreted in
+ * `timezone`, returned as a real UTC instant.
+ *
+ * Shared canonical implementation — preset engines (picker + legacy
+ * time-range-picker) build tz-aware day boundaries on top of this.
+ */
+export declare function startOfDayInTz(date: Date, timezone: string): Date;
+/**
+ * End of the calendar day (23:59:59.999) for `date`, interpreted in
+ * `timezone`, returned as a real UTC instant.
+ */
+export declare function endOfDayInTz(date: Date, timezone: string): Date;

package/dist/components/features/_shared/use-deprecation-warning.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Logs a one-time `console.warn` in development warning that the legacy
+ * component is deprecated and pointing the consumer at the replacement.
+ *
+ * No-op in `test` and `production` builds. Deduplicated by `legacyName`
+ * across the entire session.
+ */
+export declare function useDeprecationWarning(legacyName: string, replacement: string): void;

package/dist/components/features/app-navigation/app-navigation.d.ts

@@ -1,5 +1,5 @@
 import type { NavItem } from './nav-menu';
-import { Sidebar } from '../../base/sidebar/sidebar';
+import { Sidebar } from '../../base/sidebar';
 export declare function AppNavigation({ navItems, title, closeOnNavigation, defaultOpen, currentPath, linkComponent, loading, itemClassName, activeItemClassName, ...props }: React.ComponentProps<typeof Sidebar> & {
     navItems: NavItem[];
     title?: string | React.ReactNode;
@@ -17,4 +17,3 @@ export declare function AppNavigation({ navItems, title, closeOnNavigation, defa
     /** Class applied only to the active nav item button (e.g. `'font-bold text-primary'`). */
     activeItemClassName?: string;
 }): import("react").JSX.Element;
-//# sourceMappingURL=app-navigation.d.ts.map

package/dist/components/features/app-navigation/index.d.ts

@@ -1,4 +1,3 @@
 export * from '../../base/sidebar';
 export * from './app-navigation';
 export * from './nav-menu';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/app-navigation/nav-menu/active-path.d.ts

@@ -0,0 +1,33 @@
+import type { NavItem } from './types';
+/**
+ * Pure active-path predicates for the nav menu.
+ *
+ * These were previously trapped as closures inside the `NavMenu` render
+ * function. Extracted here as plain functions of `(item, currentPath)` so the
+ * routing logic can be unit-tested without rendering React.
+ */
+/**
+ * Normalise a pathname for comparison: ensure a leading slash and strip a
+ * trailing slash (except for the root path itself).
+ */
+export declare function normalizePath(p: string): string;
+/**
+ * Whether `item` itself should be rendered as the active nav entry for the
+ * given `currentPath`.
+ *
+ * Rules:
+ * - An item with no href is never directly active.
+ * - The root item (`/`) is active only on the exact root path.
+ * - A parent with children is active only on an exact match AND only when none
+ *   of its descendants match (the deepest match wins).
+ * - A leaf is active on exact match or a non-excluded sub-path, or when the
+ *   path matches one of its `tabChildLinks`.
+ */
+export declare function isNavItemActive(item: NavItem, currentPath: string): boolean;
+/**
+ * Whether `item` or any of its descendants is active for `currentPath`. Used to
+ * decide which collapsible groups should be expanded / kept open.
+ */
+export declare function hasActiveDescendant(item: NavItem, currentPath: string): boolean;
+/** Depth-first search for the first item whose href matches `href` exactly. */
+export declare function findItemByHref(items: NavItem[], href: string): NavItem | null;

package/dist/components/features/app-navigation/nav-menu/index.d.ts

@@ -0,0 +1,4 @@
+export { findItemByHref, hasActiveDescendant, isNavItemActive, normalizePath, } from './active-path';
+export { NavMenu } from './nav-menu';
+export { NavMenuItem } from './nav-menu-item';
+export type { NavItem } from './types';

package/dist/components/features/app-navigation/nav-menu/nav-menu-context.d.ts

@@ -0,0 +1,47 @@
+import type { Dispatch, ElementType, RefObject, SetStateAction } from 'react';
+/**
+ * Shared render state for the nav menu tree.
+ *
+ * `NavMenu` owns all state, refs and handlers and publishes them through this
+ * context so the recursive `NavMenuItem` (and its part components) can render
+ * themselves for children without prop-drilling ~15 values through every level.
+ */
+export interface NavMenuContextValue {
+    /** Current URL pathname. */
+    pathname: string;
+    /** Resolved sidebar state (override wins over the sidebar provider). */
+    state: 'expanded' | 'collapsed';
+    isMobile: boolean;
+    openItems: Record<string, boolean>;
+    setOpenItems: Dispatch<SetStateAction<Record<string, boolean>>>;
+    setOpen: (open: boolean) => void;
+    disableTooltip?: boolean;
+    /** Class applied to every nav item button. */
+    itemClassName?: string;
+    /** Class applied only to the active nav item button. */
+    activeItemClassName?: string;
+    /** Link component used to render navigation links. */
+    linkComponent: ElementType;
+    /** Build props for the configured link component (`href` vs `to`+`href`). */
+    getLinkProps: (href: string) => {
+        href: string;
+        to?: string;
+    };
+    handleNavigation: () => void;
+    isInitialMount: RefObject<boolean>;
+    previousOpenItems: RefObject<Record<string, boolean>>;
+    previousState: RefObject<'expanded' | 'collapsed'>;
+    previousPathname: RefObject<string>;
+}
+export declare const NavMenuProvider: import("react").Provider<NavMenuContextValue | null>;
+export declare function useNavMenuContext(): NavMenuContextValue;
+/**
+ * Stable identity key for a nav item's open/closed state.
+ * Uses type + title + href + level (not href alone) so that collapsible groups
+ * with href:null can still be toggled and duplicate hrefs never collide.
+ */
+export declare function getNavItemKey(item: {
+    type: string;
+    title: string;
+    href: string | null;
+}, level: number): string;

package/dist/components/features/app-navigation/nav-menu/nav-menu-item.d.ts

@@ -0,0 +1,13 @@
+import type { NavItem } from './types';
+/** Stable React key for a rendered nav item at a given depth. */
+declare function itemKeyOf(item: NavItem, level: number): string;
+/**
+ * Recursive nav row. Dispatches to the correct presentational part based on the
+ * item type and the current sidebar state, and renders itself for children.
+ * Memoized so unchanged subtrees skip re-rendering when their props are stable.
+ */
+export declare const NavMenuItem: import("react").MemoExoticComponent<({ item, level }: {
+    item: NavItem;
+    level?: number;
+}) => import("react").JSX.Element | null>;
+export { itemKeyOf };

package/dist/components/features/app-navigation/{nav-menu.d.ts → nav-menu/nav-menu.d.ts}

@@ -1,27 +1,15 @@
-import type { LucideIcon } from 'lucide-react';
 import type { ComponentProps, ElementType } from 'react';
-export interface NavItem {
-    title: string;
-    href: string | null;
-    type: 'link' | 'group' | 'collapsible' | 'externalLink';
-    disabled?: boolean;
-    count?: number;
-    icon?: LucideIcon;
-    children?: NavItem[];
-    open?: boolean;
-    hidden?: boolean;
-    showSeparatorAbove?: boolean;
-    showSeparatorBelow?: boolean;
-    excludePaths?: string[];
-    tabChildLinks?: string[];
-    /** Called when the user hovers over the link (e.g. to prefetch route data). */
-    onPrefetch?: () => void;
-}
+import type { NavItem } from './types';
+export type { NavItem } from './types';
 export declare function NavMenu({ ref, className, items, currentPath, linkComponent: LinkComp, overrideState, itemClassName, activeItemClassName, disableTooltip, closeOnNavigation, ...props }: ComponentProps<'ul'> & {
     items: NavItem[];
     /** Current URL pathname — replaces internal useLocation() */
     currentPath: string;
-    /** Link component to render navigation links (defaults to native `<a>`) */
+    /**
+     * Link component to render navigation links (defaults to native `<a>`).
+     * Custom components receive both `to` and `href` (set to the same destination)
+     * so router links (`to`, e.g. React Router) and href-based links (e.g. Next.js) both work.
+     */
     linkComponent?: ElementType;
     overrideState?: 'expanded' | 'collapsed';
     /** Class applied to every nav item button. */
@@ -36,4 +24,3 @@ export declare function NavMenu({ ref, className, items, currentPath, linkCompon
 export declare namespace NavMenu {
     var displayName: string;
 }
-//# sourceMappingURL=nav-menu.d.ts.map

package/dist/components/features/app-navigation/nav-menu/parts.d.ts

@@ -0,0 +1,31 @@
+import type { LucideIcon } from 'lucide-react';
+import type { ComponentProps } from 'react';
+import type { NavItem } from './types';
+import { SidebarMenuButton } from '../../../base/sidebar';
+export declare const NAV_STYLES: {
+    readonly menuButton: "rounded-xl h-8 font-normal text-xs transition-all px-2 py-1 data-[active=true]:bg-sidebar data-[active=true]:text-foreground data-[active=true]:text-sidebar-primary data-[active=true]:[&>svg]:text-primary hover:bg-sidebar hover:text-sidebar-primary hover:[&>svg]:text-sidebar-primary hover:bg-sidebar-accent data-[active=true]:bg-sidebar-accent hover:font-semibold data-[active=true]:hover:[&>svg]:text-sidebar-primary transition-colors duration-300 gap-2.5 text-foreground [&>svg]:text-icon-primary";
+    readonly disabled: "pointer-events-none opacity-50";
+    readonly icon: "duration-300 transition-all";
+    readonly iconSmall: "size-4 duration-300 transition-all";
+};
+export declare function NavIcon({ icon: IconComponent, className, size, }: {
+    icon?: LucideIcon;
+    className?: string;
+    size?: 'default' | 'small';
+}): import("react").JSX.Element | null;
+export declare namespace NavIcon {
+    var displayName: string;
+}
+export type NavSidebarMenuButtonProps = ComponentProps<typeof SidebarMenuButton> & {
+    item: Pick<NavItem, 'disabled' | 'icon' | 'title'>;
+    isActive?: boolean;
+    disableTooltip?: boolean;
+    /** Extra classes applied only when isActive is true. Composed after base + className. */
+    activeClassName?: string;
+};
+export declare function NavSidebarMenuButton({ ref, item, isActive, disableTooltip, className, activeClassName, children, asChild, ...props }: NavSidebarMenuButtonProps & {
+    ref?: React.RefObject<HTMLButtonElement | null>;
+}): import("react").JSX.Element;
+export declare namespace NavSidebarMenuButton {
+    var displayName: string;
+}

package/dist/components/features/app-navigation/nav-menu/types.d.ts

@@ -0,0 +1,18 @@
+import type { LucideIcon } from 'lucide-react';
+export interface NavItem {
+    title: string;
+    href: string | null;
+    type: 'link' | 'group' | 'collapsible' | 'externalLink';
+    disabled?: boolean;
+    count?: number;
+    icon?: LucideIcon;
+    children?: NavItem[];
+    open?: boolean;
+    hidden?: boolean;
+    showSeparatorAbove?: boolean;
+    showSeparatorBelow?: boolean;
+    excludePaths?: string[];
+    tabChildLinks?: string[];
+    /** Called when the user hovers over the link (e.g. to prefetch route data). */
+    onPrefetch?: () => void;
+}

package/dist/components/features/assistant/components/assistant-workspace.d.ts

@@ -0,0 +1,48 @@
+import type { Editor } from '@tiptap/react';
+import type { UIMessage } from 'ai';
+import type { MouseEvent as ReactMouseEvent, RefObject } from 'react';
+import type { AssistantConfig, ChatSummary, EffortId } from '../types';
+/**
+ * Presentational, props-driven assistant layout: left rail + collapsible
+ * history + (empty state | conversation) + composer. The host owns all state
+ * and transport (via its own chat hook) and feeds it in here, so staff and
+ * cloud reuse the exact same layout. Shell-agnostic — it fills its container.
+ */
+export interface AssistantWorkspaceProps {
+    /** Host-specific configuration (copy, suggestions, tool labels, models, …). */
+    config?: Partial<AssistantConfig>;
+    /** Display name for the greeting; the host reads it from its own user context. */
+    userName?: string;
+    /** Header title for the active conversation. */
+    title: string;
+    messages: UIMessage[];
+    status: string;
+    error?: Error;
+    isReady: boolean;
+    chatList: ChatSummary[];
+    currentChatId: string;
+    editor: Editor | null;
+    /** Sanitized HTML per user message index (for exact-render of the user's input). */
+    htmlByUserMsgIndex: RefObject<string[]>;
+    bottomRef: RefObject<HTMLDivElement | null>;
+    containerRef: (node: HTMLDivElement | null) => void;
+    userScrolledUpRef: RefObject<boolean>;
+    onSend: () => void;
+    onStop: () => void;
+    onRetry: () => void;
+    onNewChat: () => void;
+    onLoadChat: (chat: ChatSummary) => void;
+    onDeleteChat: (e: ReactMouseEvent, chatId: string) => void;
+    onSuggestion: (text: string) => void;
+    modelId: string;
+    effortId: EffortId;
+    onModelChange: (id: string) => void;
+    onEffortChange: (id: EffortId) => void;
+    micSupported?: boolean;
+    micListening?: boolean;
+    micFrequencyData?: number[];
+    onMicToggle?: () => void;
+    historyOpen: boolean;
+    onToggleHistory: () => void;
+}
+export declare function AssistantWorkspace({ config, userName, title, messages, status, error, isReady, chatList, currentChatId, editor, htmlByUserMsgIndex, bottomRef, containerRef, userScrolledUpRef, onSend, onStop, onRetry, onNewChat, onLoadChat, onDeleteChat, onSuggestion, modelId, effortId, onModelChange, onEffortChange, micSupported, micListening, micFrequencyData, onMicToggle, historyOpen, onToggleHistory, }: AssistantWorkspaceProps): import("react").JSX.Element;

package/dist/components/features/assistant/components/brain-glyph.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Decorative brain/sunburst glyph for the assistant empty-state greeting (per
+ * Figma). Follows the Datum logo's theming: canyon-clay (#bf9595) in light,
+ * aurora-moss (#e6f59f) in dark. Size is driven by the passed `className`.
+ */
+export declare function BrainGlyph({ className }: {
+    className?: string;
+}): import("react").JSX.Element;

package/dist/components/features/assistant/components/composer/equalizer.d.ts

@@ -0,0 +1,6 @@
+interface EqualizerProps {
+    frequencyData: number[];
+    className?: string;
+}
+export declare function Equalizer({ frequencyData, className }: EqualizerProps): import("react").JSX.Element;
+export {};

package/dist/components/features/assistant/components/composer/index.d.ts

@@ -0,0 +1,3 @@
+export * from './equalizer';
+export * from './model-selector';
+export * from './prompt-card';

package/dist/components/features/assistant/components/composer/model-selector.d.ts

@@ -0,0 +1,10 @@
+import type { EffortId } from '../../types';
+interface ModelSelectorProps {
+    modelId: string;
+    effortId: EffortId;
+    onModelChange: (id: string) => void;
+    onEffortChange: (id: EffortId) => void;
+    disabled?: boolean;
+}
+export declare function ModelSelector({ modelId, effortId, onModelChange, onEffortChange, disabled, }: ModelSelectorProps): import("react").JSX.Element | null;
+export {};