chesai-ui 0.9.0 → 0.9.2

package/dist/components/appbar/index.d.ts

@@ -43,20 +43,11 @@ export interface AppBarProps extends Omit<React.HTMLAttributes<HTMLElement>, "ti
     routeKey?: string;
     topRowContent?: React.ReactNode;
     expandedContent?: React.ReactNode;
-    /** Controls if the expandedContent should use the default fade/slide exit animation, or "none" for manual morphing */
     expandedAnimation?: "default" | "none";
-    /**
-     * If false, the expanded variants (medium, large) will not collapse to the small size on scroll.
-     * @default true
-     */
     collapsible?: boolean;
-    /** Override the default collapsed height (default is 64px). */
     collapsedHeight?: number;
-    /** Override the expanded area height (skips MD3 presets and automatic measurements). */
     expandedHeight?: number;
-    /** Scroll distance in pixels required to trigger the scrolled color and shadow effects. (default 5px) */
     effectScrollThreshold?: number;
-    /** Scroll distance in pixels required to fully collapse the App Bar. Defaults to the measured expanded area height. */
     collapseScrollDistance?: number;
 }
 export declare const AppBar: React.ForwardRefExoticComponent<AppBarProps & React.RefAttributes<HTMLElement>>;

package/dist/components/breadcrumb/breadcrumb-context.d.ts

@@ -6,7 +6,7 @@ export interface BreadcrumbItemType {
     icon?: React.ReactNode;
     isCurrent?: boolean;
 }
-interface BreadcrumbContextType {
+export interface BreadcrumbContextType {
     items: BreadcrumbItemType[];
     setItems: (items: BreadcrumbItemType[]) => void;
     addItem: (item: Omit<BreadcrumbItemType, "id">) => void;
@@ -19,4 +19,3 @@ export declare const BreadcrumbProvider: ({ children, defaultItems, }: {
     children: React.ReactNode;
     defaultItems?: BreadcrumbItemType[];
 }) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/components/breadcrumb/index.d.ts

@@ -0,0 +1,52 @@
+import { default as React } from 'react';
+declare const BreadcrumbRoot: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    separator?: React.ReactNode;
+} & React.RefAttributes<HTMLElement>>;
+declare const BreadcrumbList: React.ForwardRefExoticComponent<Omit<Omit<import('framer-motion').HTMLMotionProps<"ol">, "ref"> & React.RefAttributes<HTMLOListElement>, "ref"> & React.RefAttributes<HTMLOListElement>>;
+declare const BreadcrumbItem: React.ForwardRefExoticComponent<Omit<Omit<import('framer-motion').HTMLMotionProps<"li">, "ref"> & React.RefAttributes<HTMLLIElement>, "ref"> & React.RefAttributes<HTMLLIElement>>;
+declare const BreadcrumbLink: React.ForwardRefExoticComponent<React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+    asChild?: boolean;
+} & React.RefAttributes<HTMLAnchorElement>>;
+declare const BreadcrumbPage: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
+declare const BreadcrumbSeparator: {
+    ({ children, className, ...props }: React.HTMLAttributes<HTMLLIElement>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+declare const BreadcrumbEllipsis: {
+    ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};
+export interface DynamicBreadcrumbProps {
+    separator?: React.ReactNode;
+    /** Maximum number of items to display before collapsing into an ellipsis */
+    maxItems?: number;
+    /** Number of items to show before the ellipsis (Default: 1) */
+    itemsBeforeCollapse?: number;
+    /** Number of items to show after the ellipsis (Default: 2) */
+    itemsAfterCollapse?: number;
+}
+export declare const Breadcrumb: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLElement> & {
+    separator?: React.ReactNode;
+} & React.RefAttributes<HTMLElement>> & {
+    Provider: ({ children, defaultItems, }: {
+        children: React.ReactNode;
+        defaultItems?: import('./breadcrumb-context').BreadcrumbItemType[];
+    }) => import("react/jsx-runtime").JSX.Element;
+    Dynamic: ({ separator, maxItems, itemsBeforeCollapse, itemsAfterCollapse, }: DynamicBreadcrumbProps) => import("react/jsx-runtime").JSX.Element;
+    List: React.ForwardRefExoticComponent<Omit<Omit<import('framer-motion').HTMLMotionProps<"ol">, "ref"> & React.RefAttributes<HTMLOListElement>, "ref"> & React.RefAttributes<HTMLOListElement>>;
+    Item: React.ForwardRefExoticComponent<Omit<Omit<import('framer-motion').HTMLMotionProps<"li">, "ref"> & React.RefAttributes<HTMLLIElement>, "ref"> & React.RefAttributes<HTMLLIElement>>;
+    Link: React.ForwardRefExoticComponent<React.AnchorHTMLAttributes<HTMLAnchorElement> & {
+        asChild?: boolean;
+    } & React.RefAttributes<HTMLAnchorElement>>;
+    Page: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
+    Separator: {
+        ({ children, className, ...props }: React.HTMLAttributes<HTMLLIElement>): import("react/jsx-runtime").JSX.Element;
+        displayName: string;
+    };
+    Ellipsis: {
+        ({ className, ...props }: React.HTMLAttributes<HTMLSpanElement>): import("react/jsx-runtime").JSX.Element;
+        displayName: string;
+    };
+    useBreadcrumbs: () => import('./breadcrumb-context').BreadcrumbContextType;
+};
+export { BreadcrumbRoot, BreadcrumbList, BreadcrumbItem, BreadcrumbLink, BreadcrumbPage, BreadcrumbSeparator, BreadcrumbEllipsis, };

package/dist/components/charts/area-chart.d.ts

@@ -3,9 +3,10 @@ export interface ChartProps {
     categories: string[];
     index: string;
     variant?: "primary" | "secondary" | "ghost";
+    shape?: "full" | "minimal" | "sharp";
     colors?: string[];
     height?: number | string;
     className?: string;
     valueFormatter?: (value: number) => string;
 }
-export declare const AreaChart: ({ data, categories, index, variant, colors, height, className, valueFormatter, }: ChartProps) => import("react/jsx-runtime").JSX.Element;
+export declare const AreaChart: ({ data, categories, index, variant, shape, colors, height, className, valueFormatter, }: ChartProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/charts/bar-chart.d.ts

@@ -1,2 +1,2 @@
 import { ChartProps } from './area-chart';
-export declare const BarChart: ({ data, categories, index, variant, colors, height, className, valueFormatter, }: ChartProps) => import("react/jsx-runtime").JSX.Element;
+export declare const BarChart: ({ data, categories, index, variant, shape, colors, height, className, valueFormatter, }: ChartProps) => import("react/jsx-runtime").JSX.Element;

package/dist/components/charts/pie-chart.d.ts

@@ -3,10 +3,11 @@ interface PieChartProps {
     category: string;
     index: string;
     variant?: "primary" | "secondary" | "ghost";
+    shape?: "full" | "minimal" | "sharp";
     colors?: string[];
     height?: number | string;
     className?: string;
     donut?: boolean;
 }
-export declare const PieChart: ({ data, category, index, variant, colors, height, className, donut, }: PieChartProps) => import("react/jsx-runtime").JSX.Element;
+export declare const PieChart: ({ data, category, index, variant, shape, colors, height, className, donut, }: PieChartProps) => import("react/jsx-runtime").JSX.Element;
 export {};

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

@@ -4,9 +4,7 @@ export type DatePickerInputVariant = "filled" | "filled-inverted" | "outlined" |
 export interface DatePickerProps {
     value?: Date;
     onChange?: (date: Date | undefined) => void;
-    /** Controls the display mode of the picker (popover vs dialog) */
     variant?: DatePickerVariant;
-    /** Controls the visual style of the input trigger */
     inputVariant?: DatePickerInputVariant;
     label?: string;
     placeholder?: string;

package/dist/components/index.d.ts

@@ -85,4 +85,5 @@ export * from './toolbar';
 export * from './tooltip';
 export * from './typography';
 export * from './video-player';
+export * from './virtual-list';
 export * from './window-controls';

package/dist/components/item/index.d.ts

@@ -1,6 +1,5 @@
 import { VariantProps } from 'class-variance-authority';
 import * as React from "react";
-export * from './virtual-item-list';
 declare const itemVariants: (props?: ({
     variant?: "primary" | "secondary" | "tertiary" | "ghost" | "high-contrast" | "surface" | "surface-container-lowest" | "surface-container-low" | "surface-container" | "surface-container-high" | "surface-container-highest" | null | undefined;
     bordered?: boolean | null | undefined;
@@ -10,7 +9,15 @@ declare const itemVariants: (props?: ({
     shape?: "full" | "minimal" | "sharp" | null | undefined;
     direction?: "horizontal" | "vertical" | null | undefined;
 } & import('class-variance-authority/dist/types').ClassProp) | undefined) => string;
-declare const ItemGroup: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
+export type ItemGroupShape = "full" | "minimal" | "sharp";
+export type ItemGroupDirection = "horizontal" | "vertical";
+export type ItemGroupGap = "none" | "xs" | "sm" | "md" | "lg";
+export interface ItemGroupProps extends React.HTMLAttributes<HTMLDivElement> {
+    shape?: ItemGroupShape;
+    direction?: ItemGroupDirection;
+    gap?: ItemGroupGap;
+}
+declare const ItemGroup: React.ForwardRefExoticComponent<ItemGroupProps & React.RefAttributes<HTMLDivElement>>;
 declare const ItemSeparator: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLDivElement> & React.RefAttributes<HTMLDivElement>>;
 export interface ItemProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof itemVariants> {
     asChild?: boolean;

package/dist/components/navigation-rail/index.d.ts

@@ -26,6 +26,8 @@ interface NavigatorProps extends React.HTMLAttributes<HTMLElement> {
     forceExpanded?: boolean;
     /** Allow the rail to expand on hover (Desktop only). Defaults to false. */
     expandOnHover?: boolean;
+    /** Forces the rail to act as an overlay (drawer) on desktop viewports. */
+    overlay?: boolean;
 }
 export declare const NavigationRail: {
     Navigator: React.FC<NavigatorProps>;

package/dist/components/stack-router/index.d.ts

@@ -9,15 +9,7 @@ interface StackNavigatorProps<T extends Record<string, object | undefined>> {
         route: RouteProp<T, keyof T>;
         navigation: NavigationProp<T>;
     }) => StackScreenOptions);
-    /**
-     * 'memory': Routes are stored in memory/history state. The URL bar does not change path (default).
-     * 'path': Routes update the browser URL path.
-     */
     mode?: "memory" | "path";
-    /**
-     * The base URL path for 'path' mode.
-     * e.g., "/app" if your router is mounted at mydomain.com/app
-     */
     basePath?: string;
 }
 export declare function createStackNavigator<T extends Record<string, object | undefined>>(): {

package/dist/components/stack-router/types.d.ts

@@ -1,5 +1,4 @@
 import { Transition, Variants } from 'framer-motion';
-import { ForwardedRef } from 'react';
 import { AppBarColor, AppBarProps } from '../appbar';
 export interface StackScreenOptions {
     title?: string;
@@ -11,6 +10,15 @@ export interface StackScreenOptions {
     headerRight?: (props: {
         canGoBack: boolean;
     }) => React.ReactNode;
+    headerBottom?: (props: {
+        canGoBack: boolean;
+    }) => React.ReactNode;
+    headerTopRow?: (props: {
+        canGoBack: boolean;
+    }) => React.ReactNode;
+    headerExpanded?: (props: {
+        canGoBack: boolean;
+    }) => React.ReactNode;
     headerStyle?: {
         backgroundColor?: AppBarColor | 'card' | 'background';
     };
@@ -59,7 +67,7 @@ export interface NavigationProp<T extends Record<string, object | undefined>> {
     canGoBack: () => boolean;
     addListener: (event: NavigationEvent, callback: NavigationEventCallback) => () => void;
     removeListener: (event: NavigationEvent, callback: NavigationEventCallback) => void;
-    scrollContainerRef: ForwardedRef<any | null>;
+    scrollContainerRef: React.RefCallback<HTMLElement | null> | React.MutableRefObject<HTMLElement | null>;
 }
 export interface StackAnimation {
     transition?: Transition;

package/dist/components/virtual-list/index.d.ts

@@ -0,0 +1,48 @@
+import { VirtualizerOptions, Virtualizer } from '@tanstack/react-virtual';
+import { default as React } from 'react';
+export interface VirtualListProps<T> {
+    /** The data to render */
+    data: T[];
+    /** The render function for each item */
+    renderItem: (item: T, index: number) => React.ReactNode;
+    /** Scroll direction of the virtual list. @default "vertical" */
+    direction?: "vertical" | "horizontal";
+    /**
+     * The component used as the outer scrollable container viewport.
+     * Useful for passing ElasticScrollArea or customizing tags.
+     * @default "div"
+     */
+    as?: React.ElementType;
+    /**
+     * The component used as the sizer (defines total scroll width/height).
+     * @default "div"
+     */
+    contentAs?: React.ElementType;
+    /**
+     * An optional wrapper component directly around the array of absolute items.
+     * Extremely useful if you need to wrap the items in a <ul/>, <ol/>, or an <AnimatePresence/>.
+     */
+    itemsWrapper?: React.ElementType | React.FC<any>;
+    /** Spacing between items in pixels. @default 8 */
+    gap?: number;
+    /** Initial estimated size of items. @default 72 */
+    estimateSize?: number;
+    /** Items to render outside the visible viewport. @default 5 */
+    overscan?: number;
+    /** Props passed to the outer scrollable container */
+    containerProps?: any;
+    /** Props passed to the inner sizer div */
+    contentProps?: React.HTMLAttributes<HTMLDivElement> & Record<string, any>;
+    /**
+     * Access to the raw TanStack Virtual options for advanced logic
+     * (e.g., initialOffset, scrollMargin, etc.)
+     */
+    virtualOptions?: Partial<VirtualizerOptions<any, any>>;
+    /** Ref to access the virtualizer instance from parent (for scroll controls) */
+    virtualizerRef?: React.Ref<Virtualizer<any, any>>;
+}
+declare function VirtualListInner<T>({ data, renderItem, direction, as: Component, contentAs: ContentComponent, itemsWrapper: ItemsWrapper, gap, estimateSize, overscan, containerProps, contentProps, virtualOptions, virtualizerRef, }: VirtualListProps<T>, ref: React.ForwardedRef<HTMLElement>): import("react/jsx-runtime").JSX.Element;
+export declare const VirtualList: <T>(props: VirtualListProps<T> & {
+    ref?: React.ForwardedRef<HTMLElement>;
+}) => ReturnType<typeof VirtualListInner>;
+export {};