@omnitron-dev/prism 0.1.3 → 0.3.0

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

@@ -0,0 +1,144 @@
+/**
+ * Menu Component
+ *
+ * Dropdown menu with various item types.
+ *
+ * @module components/menu
+ */
+import type { ReactNode, MouseEvent } from 'react';
+/**
+ * Menu item types.
+ */
+export type MenuItemType = 'item' | 'divider' | 'header';
+/**
+ * Menu item definition.
+ */
+export interface MenuItemDef {
+    /** Item type */
+    type?: MenuItemType;
+    /** Unique key (required for items) */
+    key?: string;
+    /** Item label */
+    label?: string;
+    /** Optional icon */
+    icon?: ReactNode;
+    /** Click handler */
+    onClick?: () => void;
+    /** Disabled state */
+    disabled?: boolean;
+    /** Danger/destructive action styling */
+    danger?: boolean;
+    /** Shortcut hint text */
+    shortcut?: string;
+}
+/**
+ * Props for Menu component.
+ */
+export interface MenuProps {
+    /** Menu items */
+    items: MenuItemDef[];
+    /** Anchor element */
+    anchorEl: HTMLElement | null;
+    /** Open state */
+    open: boolean;
+    /** Close handler */
+    onClose: () => void;
+    /** Minimum width */
+    minWidth?: number;
+    /** Anchor origin */
+    anchorOrigin?: {
+        vertical: 'top' | 'center' | 'bottom';
+        horizontal: 'left' | 'center' | 'right';
+    };
+    /** Transform origin */
+    transformOrigin?: {
+        vertical: 'top' | 'center' | 'bottom';
+        horizontal: 'left' | 'center' | 'right';
+    };
+}
+/**
+ * Menu - Dropdown menu component.
+ *
+ * @example
+ * ```tsx
+ * const { anchorEl, open, handleOpen, handleClose } = useMenu();
+ *
+ * <Button onClick={handleOpen}>Open Menu</Button>
+ * <Menu
+ *   anchorEl={anchorEl}
+ *   open={open}
+ *   onClose={handleClose}
+ *   items={[
+ *     { key: 'edit', label: 'Edit', icon: <EditIcon /> },
+ *     { key: 'duplicate', label: 'Duplicate', icon: <CopyIcon /> },
+ *     { type: 'divider' },
+ *     { key: 'delete', label: 'Delete', icon: <DeleteIcon />, danger: true },
+ *   ]}
+ * />
+ * ```
+ */
+export declare function Menu({ items, anchorEl, open, onClose, minWidth, anchorOrigin, transformOrigin, }: MenuProps): ReactNode;
+/**
+ * Return type for useMenu hook.
+ */
+export interface UseMenuReturn {
+    /** Anchor element for menu positioning */
+    anchorEl: HTMLElement | null;
+    /** Whether menu is open */
+    open: boolean;
+    /** Open menu handler (pass as onClick) */
+    handleOpen: (event: MouseEvent<HTMLElement>) => void;
+    /** Close menu handler */
+    handleClose: () => void;
+    /** Toggle menu handler */
+    handleToggle: (event: MouseEvent<HTMLElement>) => void;
+    /** Props to spread on Menu component */
+    menuProps: {
+        anchorEl: HTMLElement | null;
+        open: boolean;
+        onClose: () => void;
+    };
+}
+/**
+ * useMenu - Hook for managing menu state.
+ *
+ * @example
+ * ```tsx
+ * const menu = useMenu();
+ *
+ * return (
+ *   <>
+ *     <IconButton onClick={menu.handleOpen}>
+ *       <MoreVertIcon />
+ *     </IconButton>
+ *     <Menu {...menu.menuProps} items={menuItems} />
+ *   </>
+ * );
+ * ```
+ */
+export declare function useMenu(): UseMenuReturn;
+/**
+ * Props for ContextMenu component.
+ */
+export interface ContextMenuProps extends Omit<MenuProps, 'anchorEl' | 'open' | 'onClose'> {
+    /** Children to wrap with context menu */
+    children: ReactNode;
+}
+/**
+ * ContextMenu - Right-click context menu wrapper.
+ *
+ * @example
+ * ```tsx
+ * <ContextMenu
+ *   items={[
+ *     { key: 'cut', label: 'Cut', shortcut: '⌘X' },
+ *     { key: 'copy', label: 'Copy', shortcut: '⌘C' },
+ *     { key: 'paste', label: 'Paste', shortcut: '⌘V' },
+ *   ]}
+ * >
+ *   <div>Right-click me!</div>
+ * </ContextMenu>
+ * ```
+ */
+export declare function ContextMenu({ items, children, ...menuProps }: ContextMenuProps): ReactNode;
+//# sourceMappingURL=menu.d.ts.map

package/dist/components/menu/menu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"menu.d.ts","sourceRoot":"","sources":["../../../src/components/menu/menu.tsx"],"names":[],"mappings":"AAEA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AAqEnD;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,SAAS,GAAG,QAAQ,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,IAAI,CAAC,EAAE,YAAY,CAAC;IACpB,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,iBAAiB;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oBAAoB;IACpB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qBAAqB;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wCAAwC;IACxC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,yBAAyB;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,iBAAiB;IACjB,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,qBAAqB;IACrB,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,iBAAiB;IACjB,IAAI,EAAE,OAAO,CAAC;IACd,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,oBAAoB;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oBAAoB;IACpB,YAAY,CAAC,EAAE;QACb,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACtC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;KACzC,CAAC;IACF,uBAAuB;IACvB,eAAe,CAAC,EAAE;QAChB,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;QACtC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,CAAC;KACzC,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,IAAI,CAAC,EACnB,KAAK,EACL,QAAQ,EACR,IAAI,EACJ,OAAO,EACP,QAAc,EACd,YAA0D,EAC1D,eAA0D,GAC3D,EAAE,SAAS,GAAG,SAAS,CAyBvB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;IAC7B,2BAA2B;IAC3B,IAAI,EAAE,OAAO,CAAC;IACd,0CAA0C;IAC1C,UAAU,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACrD,yBAAyB;IACzB,WAAW,EAAE,MAAM,IAAI,CAAC;IACxB,0BAA0B;IAC1B,YAAY,EAAE,CAAC,KAAK,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK,IAAI,CAAC;IACvD,wCAAwC;IACxC,SAAS,EAAE;QACT,QAAQ,EAAE,WAAW,GAAG,IAAI,CAAC;QAC7B,IAAI,EAAE,OAAO,CAAC;QACd,OAAO,EAAE,MAAM,IAAI,CAAC;KACrB,CAAC;CACH;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,IAAI,aAAa,CA6BvC;AAED;;GAEG;AACH,MAAM,WAAW,gBAAiB,SAAQ,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;IACxF,yCAAyC;IACzC,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,WAAW,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,SAAS,EAAE,EAAE,gBAAgB,GAAG,SAAS,CA4C1F"}

package/dist/components/nav-card/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Nav Card Component Exports
+ *
+ * @module components/nav-card
+ */
+export { NavCard, type NavCardProps } from './nav-card.js';
+export { NavCardGrid, type NavCardGridProps } from './nav-card-grid.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/nav-card/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/nav-card/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/components/nav-card/nav-card-grid.d.ts

@@ -0,0 +1,57 @@
+/**
+ * NavCardGrid
+ *
+ * Canonical container for `<NavCard>` rows on admin/dashboard
+ * overview pages. Replaces the ad-hoc `<Grid container spacing={3}>`
+ * + `<Grid size={{md:3}}>` pattern, which has two failure modes
+ * when the tile count is uneven against the column count:
+ *
+ *   1. The empty trailing cells visually extend the row above's
+ *      column borders into nothing — reading as orphan vertical
+ *      "sticks" between cards on dark themes.
+ *   2. Cards across rows can end up with different heights when
+ *      their descriptions wrap differently.
+ *
+ * NavCardGrid solves both with a CSS Grid:
+ *
+ *   - `auto-fit` (not `auto-fill`) collapses empty trailing tracks,
+ *     so the last row's cards expand to fill the width and their
+ *     right edges no longer align with the row above.
+ *   - `minmax(<min>, 1fr)` caps the column count on wide viewports
+ *     (otherwise 5+ tiny tiles can pack a row).
+ *   - `grid-auto-rows: 1fr` guarantees equal card height across
+ *     rows regardless of per-card content length.
+ *
+ * Use as a drop-in replacement for the Grid wrapper around NavCards
+ * in admin dashboards. The contained `<NavCard>` should typically
+ * use `orientation="vertical"` so the tiles work at narrow widths.
+ *
+ * @example
+ * ```tsx
+ * <NavCardGrid>
+ *   <NavCard title="Users" icon={<UsersIcon />} to="/admin/users" />
+ *   <NavCard title="Shops" icon={<ShopsIcon />} to="/admin/shops" />
+ *   ...
+ * </NavCardGrid>
+ * ```
+ *
+ * @module components/nav-card
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme } from '@mui/material/styles';
+export interface NavCardGridProps {
+    children: ReactNode;
+    /**
+     * Minimum tile width before wrap. Effectively caps the column
+     * count via `minmax`. Default 260px which gives 4 columns on a
+     * typical 1200px content area, 3 on tablet, 2 on small laptops,
+     * and 1 on mobile.
+     */
+    minTileWidth?: number;
+    /** Gap between tiles in spacing units. Default 3 (24px). */
+    gap?: number;
+    /** Custom sx overrides. */
+    sx?: SxProps<Theme>;
+}
+export declare function NavCardGrid({ children, minTileWidth, gap, sx, }: NavCardGridProps): import("react").JSX.Element;
+//# sourceMappingURL=nav-card-grid.d.ts.map

package/dist/components/nav-card/nav-card-grid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-card-grid.d.ts","sourceRoot":"","sources":["../../../src/components/nav-card/nav-card-grid.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,SAAS,CAAC;IACpB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,2BAA2B;IAC3B,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,EAC1B,QAAQ,EACR,YAAkB,EAClB,GAAO,EACP,EAAE,GACH,EAAE,gBAAgB,+BAmBlB"}

package/dist/components/nav-card/nav-card.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Nav Card
+ *
+ * Horizontal navigation tile used on admin/dashboard overview pages:
+ * colored icon on the left, title + description in the middle, and a
+ * trailing chevron on the right. Renders as a router link when `to`
+ * is supplied, otherwise as a button-like Card with `onClick`.
+ *
+ * Equal-height rows are guaranteed by `height: 100%` — pair the card
+ * with a `<Grid container>` whose items share the same column span.
+ *
+ * @module components/nav-card
+ */
+import type { ElementType, ReactNode } from 'react';
+import { type SxProps, type Theme } from '@mui/material/styles';
+export interface NavCardProps {
+    /** Card title (rendered as subtitle1, weight 600). */
+    title: ReactNode;
+    /** Secondary line below the title. */
+    description?: ReactNode;
+    /** Icon element rendered inside a colored square on the left. */
+    icon?: ReactNode;
+    /**
+     * `'horizontal'` (default) — icon left, text right; works well in
+     * 2-column rows (`md: 6`) where each card is wide.
+     * `'vertical'` — icon top, text below; required when the card lives
+     * in 4-column rows (`md: 3`) or narrower, because the horizontal
+     * variant runs out of room for the text and starts breaking letters.
+     * Pick orientation per row, not per card.
+     */
+    orientation?: 'horizontal' | 'vertical';
+    /**
+     * Palette key for the icon background (e.g. `'primary'`, `'error'`,
+     * `'warning.dark'`). Defaults to `'primary'`. The hover border picks
+     * up the same color.
+     */
+    color?: string;
+    /**
+     * Optional counter shown as a small chip next to the title. Falsy
+     * values (`0`, `undefined`, `null`) hide the chip.
+     */
+    badge?: number | string | null;
+    /** Palette key for the badge chip (defaults to `'warning'`). */
+    badgeColor?: 'default' | 'primary' | 'secondary' | 'error' | 'info' | 'success' | 'warning';
+    /**
+     * Navigate to this route. When set, the card renders as the
+     * supplied `linkComponent` (e.g. `RouterLink` from react-router) and
+     * the whole card becomes a real anchor — Cmd/Ctrl-click opens a new
+     * tab, screen readers expose link semantics.
+     */
+    to?: string;
+    /** Custom router link component. Required when `to` is used. */
+    linkComponent?: ElementType;
+    /** Click handler — used when `to` is not supplied. */
+    onClick?: () => void;
+    /**
+     * Trailing chevron. Pass `false` to suppress, or a ReactNode to
+     * substitute (e.g. a status indicator). Default `true`.
+     */
+    arrow?: boolean | ReactNode;
+    /** Square icon size in pixels (default 48). */
+    iconSize?: number;
+    /** Extra styles applied to the outer Card. */
+    sx?: SxProps<Theme>;
+    /** Accessible label override. Defaults to `${title} — ${description}`. */
+    ariaLabel?: string;
+}
+export declare function NavCard({ title, description, icon, color, badge, badgeColor, orientation, to, linkComponent, onClick, arrow, iconSize, sx, ariaLabel, }: NavCardProps): import("react").JSX.Element;
+//# sourceMappingURL=nav-card.d.ts.map

package/dist/components/nav-card/nav-card.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-card.d.ts","sourceRoot":"","sources":["../../../src/components/nav-card/nav-card.tsx"],"names":[],"mappings":"AAEA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOpD,OAAO,EAAS,KAAK,OAAO,EAAE,KAAK,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAEvE,MAAM,WAAW,YAAY;IAC3B,sDAAsD;IACtD,KAAK,EAAE,SAAS,CAAC;IACjB,sCAAsC;IACtC,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB,iEAAiE;IACjE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB;;;;;;;OAOG;IACH,WAAW,CAAC,EAAE,YAAY,GAAG,UAAU,CAAC;IACxC;;;;OAIG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC/B,gEAAgE;IAChE,UAAU,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IAC5F;;;;;OAKG;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,gEAAgE;IAChE,aAAa,CAAC,EAAE,WAAW,CAAC;IAC5B,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,8CAA8C;IAC9C,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACpB,0EAA0E;IAC1E,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,OAAO,CAAC,EACtB,KAAK,EACL,WAAW,EACX,IAAI,EACJ,KAAiB,EACjB,KAAK,EACL,UAAsB,EACtB,WAA0B,EAC1B,EAAE,EACF,aAAa,EACb,OAAO,EACP,KAAY,EACZ,QAAa,EACb,EAAE,EACF,SAAS,GACV,EAAE,YAAY,+BAkNd"}

package/dist/components/nav-section/components.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Navigation Base Components
+ *
+ * Foundational components for building navigation sections.
+ *
+ * @module components/nav-section
+ */
+import type { Ref } from 'react';
+import ButtonBase from '@mui/material/ButtonBase';
+import type { SxProps, Theme } from '@mui/material/styles';
+/**
+ * Props for Nav component.
+ */
+export interface NavProps extends Omit<React.ComponentPropsWithoutRef<'nav'>, 'sx'> {
+    children: React.ReactNode;
+    sx?: SxProps<Theme>;
+}
+/**
+ * Nav - Root navigation element for navigation sections.
+ */
+export declare function Nav({ className, sx, ref, ...other }: NavProps & {
+    ref?: Ref<HTMLElement>;
+}): import("react").JSX.Element;
+/**
+ * Props for NavUl component.
+ */
+export interface NavUlProps extends Omit<React.ComponentPropsWithoutRef<'ul'>, 'sx'> {
+    children: React.ReactNode;
+    sx?: SxProps<Theme>;
+}
+/**
+ * NavUl - Styled unordered list for navigation.
+ */
+export declare function NavUl({ className, sx, ref, ...other }: NavUlProps & {
+    ref?: Ref<HTMLUListElement>;
+}): import("react").JSX.Element;
+/**
+ * Props for NavLi component.
+ */
+export interface NavLiProps extends React.ComponentPropsWithoutRef<'li'> {
+    children: React.ReactNode;
+}
+/**
+ * NavLi - Styled list item for navigation.
+ */
+export declare function NavLi({ className, ref, ...other }: NavLiProps & {
+    ref?: Ref<HTMLLIElement>;
+}): import("react").JSX.Element;
+/**
+ * Props for NavSubheader component.
+ */
+export interface NavSubheaderProps extends React.ComponentPropsWithoutRef<typeof ButtonBase> {
+    /** Whether the section is open */
+    open?: boolean;
+    /** Click handler for toggle */
+    onClick?: () => void;
+    children: React.ReactNode;
+}
+/**
+ * NavSubheader - Section header with collapse toggle.
+ */
+export declare function NavSubheader({ className, open, onClick, children, ref, ...other }: NavSubheaderProps & {
+    ref?: Ref<HTMLButtonElement>;
+}): import("react").JSX.Element;
+/**
+ * Props for NavItemBase component.
+ */
+export interface NavItemBaseProps extends React.ComponentPropsWithoutRef<typeof ButtonBase> {
+    /** Whether the item is active */
+    active?: boolean;
+    /** Whether the item is disabled */
+    disabled?: boolean;
+    /** Whether the submenu is open */
+    open?: boolean;
+    /** Item depth level */
+    depth?: number;
+    /** Whether item has children */
+    hasChild?: boolean;
+    children: React.ReactNode;
+}
+/**
+ * NavItemBase - Base button component for nav items.
+ */
+export declare function NavItemBase({ className, active, disabled, open, depth, hasChild, ref, ...other }: NavItemBaseProps & {
+    ref?: Ref<HTMLButtonElement>;
+}): import("react").JSX.Element;
+/**
+ * Props for NavIcon component.
+ */
+export interface NavIconProps {
+    /** Icon element */
+    icon?: React.ReactNode;
+    /** Custom className */
+    className?: string;
+}
+/**
+ * NavIcon - Icon wrapper for nav items.
+ */
+export declare function NavIcon({ icon, className }: NavIconProps): React.ReactNode;
+/**
+ * Props for NavTexts component.
+ */
+export interface NavTextsProps {
+    /** Title text */
+    title: string;
+    /** Caption text */
+    caption?: string;
+    /** Custom className */
+    className?: string;
+}
+/**
+ * NavTexts - Text content for nav items.
+ */
+export declare function NavTexts({ title, caption, className }: NavTextsProps): React.ReactNode;
+/**
+ * Props for NavArrow component.
+ */
+export interface NavArrowProps {
+    /** Whether submenu is open */
+    open?: boolean;
+    /** Arrow direction */
+    direction?: 'down' | 'right';
+    /** Custom className */
+    className?: string;
+}
+/**
+ * NavArrow - Arrow indicator for items with children.
+ */
+export declare function NavArrow({ open, direction, className }: NavArrowProps): React.ReactNode;
+/**
+ * Props for NavInfo component.
+ */
+export interface NavInfoProps {
+    /** Info content */
+    info?: React.ReactNode;
+    /** Custom className */
+    className?: string;
+}
+/**
+ * NavInfo - Info badge/content for nav items.
+ */
+export declare function NavInfo({ info, className }: NavInfoProps): React.ReactNode;
+//# sourceMappingURL=components.d.ts.map

package/dist/components/nav-section/components.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"components.d.ts","sourceRoot":"","sources":["../../../src/components/nav-section/components.tsx"],"names":[],"mappings":"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"}

package/dist/components/nav-section/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Navigation Section Exports
+ *
+ * @module components/nav-section
+ */
+export type { NavItemRenderProps, NavItemStateProps, NavItemSlotProps, NavSlotProps, NavItemOptionsProps, NavItemDataProps, NavItemProps, NavListProps, NavSubListProps, NavGroupProps, NavSectionData, NavSectionProps, NavVariant, NavCommonProps, } from './types.js';
+export { navSectionClasses, navSectionCssVars, getNavCssVars } from './styles.js';
+export { Nav, NavUl, NavLi, NavSubheader, NavItemBase, NavIcon, NavTexts, NavArrow, NavInfo, type NavUlProps, type NavLiProps, type NavSubheaderProps, type NavItemBaseProps, type NavIconProps, type NavTextsProps, type NavArrowProps, type NavInfoProps, } from './components.js';
+export { NavItem } from './nav-item.js';
+export { NavList, NavSubList } from './nav-list.js';
+export { NavSectionVertical } from './nav-section-vertical.js';
+export { NavSectionHorizontal } from './nav-section-horizontal.js';
+export { NavSectionMini } from './nav-section-mini.js';
+export { NavSectionVertical as NavSection } from './nav-section-vertical.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/nav-section/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/components/nav-section/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,YAAY,EAEV,kBAAkB,EAClB,iBAAiB,EACjB,gBAAgB,EAChB,YAAY,EACZ,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EAEZ,YAAY,EACZ,eAAe,EACf,aAAa,EAEb,cAAc,EACd,eAAe,EAEf,UAAU,EACV,cAAc,GACf,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAGlF,OAAO,EACL,GAAG,EACH,KAAK,EACL,KAAK,EACL,YAAY,EACZ,WAAW,EACX,OAAO,EACP,QAAQ,EACR,QAAQ,EACR,OAAO,EACP,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,aAAa,EAClB,KAAK,YAAY,GAClB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,kBAAkB,IAAI,UAAU,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/components/nav-section/nav-context.d.ts

@@ -0,0 +1,80 @@
+import type { ReactNode } from 'react';
+/**
+ * Router functions for navigation.
+ */
+export interface NavRouter {
+    /** Navigate to a path */
+    push: (path: string) => void;
+    /** Replace current path */
+    replace?: (path: string) => void;
+}
+/**
+ * Navigation context value.
+ */
+export interface NavContextValue {
+    /** Current pathname */
+    pathname: string;
+    /** Optional router */
+    router?: NavRouter;
+}
+/**
+ * Props for NavProvider.
+ */
+export interface NavProviderProps {
+    /** Current pathname */
+    pathname: string;
+    /** Optional router */
+    router?: NavRouter;
+    children: ReactNode;
+}
+/**
+ * NavProvider - Provides navigation context to nav components.
+ *
+ * @example
+ * ```tsx
+ * // With Next.js
+ * import { usePathname, useRouter } from 'next/navigation';
+ *
+ * function App() {
+ *   const pathname = usePathname();
+ *   const router = useRouter();
+ *
+ *   return (
+ *     <NavProvider pathname={pathname} router={router}>
+ *       <NavSection data={navConfig} />
+ *     </NavProvider>
+ *   );
+ * }
+ *
+ * // With React Router
+ * import { useLocation, useNavigate } from 'react-router-dom';
+ *
+ * function App() {
+ *   const { pathname } = useLocation();
+ *   const navigate = useNavigate();
+ *
+ *   return (
+ *     <NavProvider pathname={pathname} router={{ push: navigate }}>
+ *       <NavSection data={navConfig} />
+ *     </NavProvider>
+ *   );
+ * }
+ * ```
+ */
+export declare function NavProvider({ pathname, router, children }: NavProviderProps): ReactNode;
+/**
+ * useNav - Hook to access navigation context.
+ */
+export declare function useNav(): NavContextValue;
+/**
+ * useNavPathname - Hook to get current pathname with fallback.
+ *
+ * Returns pathname from context if available, otherwise returns '/'.
+ * This allows components to work without NavProvider for simpler use cases.
+ */
+export declare function useNavPathname(): string;
+/**
+ * useNavRouter - Hook to get router from context.
+ */
+export declare function useNavRouter(): NavRouter | undefined;
+//# sourceMappingURL=nav-context.d.ts.map

package/dist/components/nav-section/nav-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-context.d.ts","sourceRoot":"","sources":["../../../src/components/nav-section/nav-context.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAMvC;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,yBAAyB;IACzB,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,2BAA2B;IAC3B,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,uBAAuB;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,sBAAsB;IACtB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,QAAQ,EAAE,SAAS,CAAC;CACrB;AAQD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,wBAAgB,WAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,gBAAgB,GAAG,SAAS,CAIvF;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,eAAe,CAMxC;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAGvC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,GAAG,SAAS,CAGpD"}

package/dist/components/nav-section/nav-item.d.ts

@@ -0,0 +1,20 @@
+import type { Ref } from 'react';
+import type { NavItemProps } from './types.js';
+/**
+ * NavItem - Individual navigation item.
+ *
+ * @example
+ * ```tsx
+ * <NavItem
+ *   title="Dashboard"
+ *   path="/dashboard"
+ *   icon={<DashboardIcon />}
+ *   active={pathname === '/dashboard'}
+ * />
+ * ```
+ */
+export declare function NavItem(props: NavItemProps & {
+    ref?: Ref<HTMLButtonElement>;
+}): import("react").JSX.Element;
+export type { NavItemProps };
+//# sourceMappingURL=nav-item.d.ts.map

package/dist/components/nav-section/nav-item.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-item.d.ts","sourceRoot":"","sources":["../../../src/components/nav-section/nav-item.tsx"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,OAAO,CAAC;AAIjC,OAAO,KAAK,EAAE,YAAY,EAAsB,MAAM,YAAY,CAAC;AAiDnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG;IAAE,GAAG,CAAC,EAAE,GAAG,CAAC,iBAAiB,CAAC,CAAA;CAAE,+BA4E7E;AAKD,YAAY,EAAE,YAAY,EAAE,CAAC"}

package/dist/components/nav-section/nav-list.d.ts

@@ -0,0 +1,25 @@
+import type { NavListProps, NavSubListProps } from './types.js';
+/**
+ * NavList - Renders a navigation item with its children.
+ *
+ * @example
+ * ```tsx
+ * <NavList
+ *   data={{
+ *     title: 'Users',
+ *     path: '/users',
+ *     children: [
+ *       { title: 'List', path: '/users/list' },
+ *       { title: 'Create', path: '/users/create' },
+ *     ],
+ *   }}
+ *   depth={1}
+ * />
+ * ```
+ */
+export declare function NavList({ data, depth, render, slotProps, cssVars, checkPermissions, enabledRootRedirect, }: NavListProps): React.ReactNode;
+/**
+ * NavSubList - Renders a list of child navigation items.
+ */
+export declare function NavSubList({ data, depth, render, slotProps, cssVars, checkPermissions, enabledRootRedirect, }: NavSubListProps): React.ReactNode;
+//# sourceMappingURL=nav-list.d.ts.map

package/dist/components/nav-section/nav-list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-list.d.ts","sourceRoot":"","sources":["../../../src/components/nav-section/nav-list.tsx"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,YAAY,EAAE,eAAe,EAAoB,MAAM,YAAY,CAAC;AA+BlF;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,KAAS,EACT,MAAM,EACN,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,mBAAmB,GACpB,EAAE,YAAY,GAAG,KAAK,CAAC,SAAS,CAuFhC;AAMD;;GAEG;AACH,wBAAgB,UAAU,CAAC,EACzB,IAAI,EACJ,KAAK,EACL,MAAM,EACN,SAAS,EACT,OAAO,EACP,gBAAgB,EAChB,mBAAmB,GACpB,EAAE,eAAe,GAAG,KAAK,CAAC,SAAS,CAiBnC"}

package/dist/components/nav-section/nav-section-horizontal.d.ts

@@ -0,0 +1,29 @@
+import type { NavSectionProps } from './types.js';
+/**
+ * NavSectionHorizontal - Horizontal navigation section for header layouts.
+ *
+ * @example
+ * ```tsx
+ * const navConfig = [
+ *   {
+ *     items: [
+ *       { title: 'Home', path: '/', icon: <HomeIcon /> },
+ *       {
+ *         title: 'Products',
+ *         path: '/products',
+ *         children: [
+ *           { title: 'All', path: '/products' },
+ *           { title: 'New', path: '/products/new' },
+ *         ],
+ *       },
+ *     ],
+ *   },
+ * ];
+ *
+ * <NavProvider pathname={pathname}>
+ *   <NavSectionHorizontal data={navConfig} />
+ * </NavProvider>
+ * ```
+ */
+export declare function NavSectionHorizontal({ sx, data, render, className, slotProps, checkPermissions, enabledRootRedirect, cssVars: overridesVars, ...other }: NavSectionProps): React.ReactNode;
+//# sourceMappingURL=nav-section-horizontal.d.ts.map

package/dist/components/nav-section/nav-section-horizontal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nav-section-horizontal.d.ts","sourceRoot":"","sources":["../../../src/components/nav-section/nav-section-horizontal.tsx"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAkC,eAAe,EAAE,MAAM,YAAY,CAAC;AA+LlF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,oBAAoB,CAAC,EACnC,EAAE,EACF,IAAI,EACJ,MAAM,EACN,SAAS,EACT,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,OAAO,EAAE,aAAa,EACtB,GAAG,KAAK,EACT,EAAE,eAAe,GAAG,KAAK,CAAC,SAAS,CA4BnC"}