@datum-cloud/datum-ui 1.3.1 → 1.4.0

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/autocomplete/autocomplete.d.ts

@@ -32,4 +32,3 @@ export declare function Autocomplete<T extends AutocompleteOption = Autocomplete
 export declare namespace Autocomplete {
     var displayName: string;
 }
-//# sourceMappingURL=autocomplete.d.ts.map

package/dist/components/features/autocomplete/autocomplete.types.d.ts

@@ -61,4 +61,3 @@ export interface AutocompleteProps<T extends AutocompleteOption = AutocompleteOp
  * value/onValueChange/name/id which come from FieldContext + useInputControl.
  */
 export type FormAutocompleteProps<T extends AutocompleteOption = AutocompleteOption> = Omit<AutocompleteProps<T>, 'value' | 'onValueChange' | 'name' | 'id'>;
-//# sourceMappingURL=autocomplete.types.d.ts.map

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

@@ -1,3 +1,2 @@
 export { Autocomplete } from './autocomplete';
 export type { AutocompleteGroup, AutocompleteOption, AutocompleteProps, FormAutocompleteProps, } from './autocomplete.types';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/autocomplete/trigger.d.ts

@@ -2,6 +2,11 @@ import type { AutocompleteOption } from './autocomplete.types';
 import * as React from 'react';
 interface TriggerProps {
     selectedOption: AutocompleteOption | undefined;
+    /**
+     * Raw string for a creatable value not present in `options`. Rendered as plain
+     * text so `renderValue` is never called with a fabricated partial option.
+     */
+    createdValue?: string;
     renderValue?: (option: any) => React.ReactNode;
     placeholder: string;
     loading: boolean;
@@ -10,11 +15,10 @@ interface TriggerProps {
     id?: string;
     className?: string;
 }
-declare function Trigger({ ref, selectedOption, renderValue, placeholder, loading, disabled, open, id, className, ...rest }: TriggerProps & {
+declare function Trigger({ ref, selectedOption, createdValue, renderValue, placeholder, loading, disabled, open, id, className, ...rest }: TriggerProps & {
     ref?: React.RefObject<HTMLButtonElement | null>;
 }): React.JSX.Element;
 declare namespace Trigger {
     var displayName: string;
 }
 export { Trigger };
-//# sourceMappingURL=trigger.d.ts.map

package/dist/components/features/autosearch/autosearch.d.ts

@@ -33,4 +33,3 @@ export declare function Autosearch({ options, value, onValueChange, onSearch, se
 export declare namespace Autosearch {
     var displayName: string;
 }
-//# sourceMappingURL=autosearch.d.ts.map

package/dist/components/features/autosearch/autosearch.types.d.ts

@@ -1,5 +1,5 @@
 import type * as React from 'react';
-import type { AutocompleteOption } from '../autocomplete/autocomplete.types';
+import type { AutocompleteOption } from '../autocomplete';
 /**
  * Default function to extract searchable text from an option.
  * Combines label, description, and value for comprehensive searching.
@@ -52,4 +52,3 @@ export interface AutosearchProps {
  * value/onValueChange/name/id which come from FieldContext.
  */
 export type FormAutosearchProps = Omit<AutosearchProps, 'value' | 'onValueChange' | 'name' | 'id'>;
-//# sourceMappingURL=autosearch.types.d.ts.map

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

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

package/dist/components/features/avatar-stack/avatar-stack.d.ts

@@ -14,4 +14,3 @@ export interface AvatarStackProps extends React.HTMLAttributes<HTMLDivElement>,
 }
 declare function AvatarStack({ className, orientation, avatars, spacing, maxAvatarsAmount, avatarClassName, ...props }: AvatarStackProps): React.JSX.Element;
 export { AvatarStack, avatarStackVariants };
-//# sourceMappingURL=avatar-stack.d.ts.map

package/dist/components/features/avatar-stack/index.d.ts

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

package/dist/components/features/calendar-date-picker/calendar-date-picker.d.ts

@@ -8,4 +8,3 @@ export declare function CalendarDatePicker({ date, onDateSelect, closeOnSelect,
 export declare namespace CalendarDatePicker {
     var displayName: string;
 }
-//# sourceMappingURL=calendar-date-picker.d.ts.map

package/dist/components/features/calendar-date-picker/index.d.ts

@@ -1,3 +1,2 @@
 export { CalendarDatePicker } from './calendar-date-picker';
 export type { CalendarDatePickerProps, DateRangePreset } from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/calendar-date-picker/types.d.ts

@@ -2,13 +2,9 @@ import type { VariantProps } from 'class-variance-authority';
 import type * as React from 'react';
 import type { DateRange } from 'react-day-picker';
 /**
- * @deprecated Internal constant for the legacy CalendarDatePicker shim.
- * Removed in 1.0.0 alongside `@datum-cloud/datum-ui/calendar-date-picker`.
- */
-export declare const months: string[];
-/**
- * @deprecated Internal cva for the legacy CalendarDatePicker trigger.
- * Removed in 1.0.0 alongside `@datum-cloud/datum-ui/calendar-date-picker`.
+ * @deprecated Internal cva retained only to type the legacy
+ * `CalendarDatePicker` `variant` prop. Removed in 1.0.0 alongside
+ * `@datum-cloud/datum-ui/calendar-date-picker`.
  */
 export declare const multiSelectVariants: (props?: ({
     variant?: "default" | "secondary" | "outline" | "destructive" | "link" | "ghost" | null | undefined;
@@ -58,4 +54,3 @@ export interface CalendarDatePickerProps extends React.HTMLAttributes<HTMLButton
     /** Title shown in the mobile sheet header. Defaults to placeholder ?? 'Pick a date'. */
     sheetTitle?: string;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/components/features/code-editor/code-editor-tabs.d.ts

@@ -60,4 +60,3 @@ import type { CodeEditorTabsProps } from './types';
  * @returns Rendered tabbed editor with JSON/YAML conversion
  */
 export declare function CodeEditorTabs({ value, onChange, format, onFormatChange, error, id, name, minHeight, }: CodeEditorTabsProps): import("react").JSX.Element;
-//# sourceMappingURL=code-editor-tabs.d.ts.map

package/dist/components/features/code-editor/code-editor.d.ts

@@ -55,4 +55,3 @@ import type { CodeEditorProps } from './types';
  * @returns Rendered Monaco editor with form integration
  */
 export declare function CodeEditor({ value, onChange, language, placeholder, id, name, error, className, readOnly, minHeight, }: CodeEditorProps): import("react").JSX.Element;
-//# sourceMappingURL=code-editor.d.ts.map

package/dist/components/features/code-editor/index.d.ts

@@ -3,4 +3,3 @@ export { CodeEditorTabs } from './code-editor-tabs';
 export { formatJson, formatYaml, isValidJson, isValidYaml, jsonToYaml, yamlToJson } from './lib/editor';
 export { createCodeEditorSchema, jsonSchema, yamlSchema } from './types';
 export type { CodeEditorProps, CodeEditorTabsProps, EditorLanguage, MonacoLanguage } from './types';
-//# sourceMappingURL=index.d.ts.map

package/dist/components/features/code-editor/lib/editor.d.ts

@@ -4,4 +4,3 @@ export declare function formatJson(jsonStr: string): string;
 export declare function formatYaml(yamlStr: string): string;
 export declare function jsonToYaml(jsonStr: string): string;
 export declare function yamlToJson(yamlStr: string): string;
-//# sourceMappingURL=editor.d.ts.map

package/dist/components/features/code-editor/types.d.ts

@@ -118,4 +118,3 @@ export declare function createCodeEditorSchema(name?: string): z.ZodObject<{
         yaml: "yaml";
     }>;
 }, z.core.$strip>;
-//# sourceMappingURL=types.d.ts.map

package/dist/components/features/data-table/adapters/nuqs-adapter.d.ts

@@ -43,4 +43,3 @@ export interface UseNuqsAdapterOptions {
  */
 export declare function useNuqsAdapter(options?: UseNuqsAdapterOptions): StateAdapter;
 export {};
-//# sourceMappingURL=nuqs-adapter.d.ts.map