laif-ds 0.2.91 → 1.0.0

package/dist/index.d.ts

@@ -146,6 +146,32 @@ declare const alertVariants: (props?: ({
 
 declare type Animation_2 = VariantProps<typeof chatBubbleVariants>["animation"];
 
+export declare function AppBottomNav({ items, showMenu, menuLabel, ariaLabel, menuIconName, linkComponent: LinkComponent, linkProps, className, ...props }: AppBottomNavProps): JSX.Element | null;
+
+export declare interface AppBottomNavProps extends Omit<React_2.ComponentProps<"div">, "children"> {
+    /** Already filtered, sorted and route-matched by the consuming app. */
+    items: BottomNavItem[];
+    /**
+     * `false` drops the Menu cell and spends the slot it frees on a sixth
+     * destination — the bar is six cells wide either way.
+     *
+     * Only for an app that opens the mobile panel somewhere else, typically a
+     * `SidebarTrigger` in its own header: with no Menu cell and no item carrying
+     * `subItems`, nothing in the bar reaches `AppSidebar`'s mobile panel any
+     * more. Turning it off is a claim that the app provides that way itself, so
+     * it is not warned about — the component cannot see the header.
+     */
+    showMenu?: boolean;
+    menuLabel?: string;
+    ariaLabel?: string;
+    menuIconName?: IconName;
+    linkComponent?: React_2.ComponentType<React_2.AnchorHTMLAttributes<HTMLAnchorElement> & {
+        href: string;
+    }>;
+    linkProps?: Record<string, unknown>;
+    className?: string;
+}
+
 export declare function AppCard({ header, title, description, body, actions, footer, variant, size, isLoading, showHeaderBorder, showFooterBorder, className, headerClassName, bodyClassName, footerClassName, children, ...props }: Readonly<AppCardProps>): JSX.Element;
 
 export declare interface AppCardProps extends Omit<React_2.ComponentProps<"div">, "title"> {
@@ -563,11 +589,19 @@ export declare interface AppSelectOption {
 
 export declare type AppSelectProps = SingleSelectProps | MultiSelectProps;
 
-export declare function AppSidebar({ navigation, navigationFooter, headerContent, footerContent, showRail, collapsible, linkComponent: LinkComponent, linkProps, ...props }: AppSidebarProps): JSX.Element;
+export declare function AppSidebar({ navigation, navigationFooter, navigationDisplay, headerContent, footerContent, showRail, collapsible, linkComponent: LinkComponent, linkProps, ...props }: AppSidebarProps): JSX.Element;
+
+/**
+ * How the `navigation` groups are laid out. `"list"` stacks every group under
+ * its own label; `"tab"` turns the groups into a tab bar and shows one at a
+ * time. `navigationFooter` is never tabbed.
+ */
+export declare type AppSidebarNavigationDisplay = "list" | "tab";
 
 declare interface AppSidebarProps extends React_2.ComponentProps<typeof Sidebar> {
     navigation: NavGroup[];
     navigationFooter?: NavGroup[];
+    navigationDisplay?: AppSidebarNavigationDisplay;
     versions?: string[];
     defaultVersion?: string;
     headerContent?: React_2.ReactNode;
@@ -832,6 +866,33 @@ declare type BaseProps = {
     "data-testid"?: string;
 };
 
+export declare interface BottomNavItem {
+    /**
+     * Must equal the sidebar `NavItem.title` of the same destination: it is what
+     * resolves the drill target when the cell opens the mobile menu. Both lists
+     * come from the same app-side source, so this is a naming discipline, not a
+     * lookup the app has to maintain.
+     */
+    title: string;
+    /** Ignored when the item has `subItems`: the cell opens the menu instead. */
+    url: string;
+    /**
+     * Required, with no fallback — but not because the glyph carries recognition
+     * on its own any more: at 16px it reads level with its label, not above it
+     * (the trade is argued on `renderCellInner`). What keeps it mandatory is the
+     * row: a cell missing its icon breaks the rhythm of the other five and reads
+     * as a failed image, and there is no room here for the initial-letter
+     * fallback the desktop sidebar uses in icon mode.
+     */
+    iconName: IconName;
+    /** Leaf-level only — the subtree state is derived from `subItems`. */
+    isActive?: boolean;
+    /** Presence (not length) is what makes the cell open the menu at this level. */
+    subItems?: NavSubItem[];
+    /** Only when the spoken name must differ; it must still contain the label. */
+    ariaLabel?: string;
+}
+
 export declare function Breadcrumb({ ...props }: React_2.ComponentProps<"nav">): JSX.Element;
 
 export declare function BreadcrumbEllipsis({ className, ...props }: React_2.ComponentProps<"span">): JSX.Element;
@@ -2640,8 +2701,27 @@ export declare interface NavGroup {
     title: string;
     url?: string;
     items: NavItem[];
+    /** Only read in `navigationDisplay="tab"`, where it is the tab's icon. */
+    iconName?: IconName;
+    /**
+     * Only read in `navigationDisplay="tab"`. Escape hatch from lucide, taking
+     * precedence over `iconName`.
+     */
+    icon?: NavIcon;
 }
 
+/**
+ * A third-party or custom icon: any component accepting `className`. The
+ * sidebar renders the same icon at more than one size (20px in a row, 16px in a
+ * collapsed dropdown, and whatever the tab bar imposes), so it passes a size
+ * *class* instead of a `size` prop — `className` is the one contract every icon
+ * library honours, and a CSS width/height overrides the `width`/`height`
+ * attributes libraries like react-icons put on their `<svg>`.
+ */
+export declare type NavIcon = React_2.ComponentType<{
+    className?: string;
+}>;
+
 export declare function NavigationMenu({ className, children, viewport, ...props }: React_2.ComponentProps<typeof NavigationMenuPrimitive.Root> & {
     viewport?: boolean;
 }): JSX.Element;
@@ -2666,6 +2746,8 @@ export declare interface NavItem {
     url: string;
     isActive?: boolean;
     iconName?: IconName;
+    /** Escape hatch from lucide. Takes precedence over `iconName`. */
+    icon?: NavIcon;
     subItems?: NavSubItem[];
 }
 
@@ -2674,6 +2756,8 @@ export declare interface NavSubItem {
     url: string;
     isActive?: boolean;
     iconName?: IconName;
+    /** Escape hatch from lucide. Takes precedence over `iconName`. */
+    icon?: NavIcon;
 }
 
 declare type NoRepeatDataType = {
@@ -2965,6 +3049,13 @@ declare type SidebarContextProps = {
     setOpen: (open: boolean) => void;
     openMobile: boolean;
     setOpenMobile: (open: boolean) => void;
+    /**
+     * `NavItem.title` the mobile panel must open already drilled into — set by
+     * whatever opens the sheet (`AppBottomNav`) right before `setOpenMobile`, and
+     * read once, at mount, by `AppSidebarMobile`. `null` means level 0.
+     */
+    mobileNavTarget: string | null;
+    setMobileNavTarget: (target: string | null) => void;
     isMobile: boolean;
     toggleSidebar: () => void;
 };