@omnitron-dev/prism 0.2.0 → 0.3.0

package/dist/layouts/dashboard/layout.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Dashboard Layout
+ *
+ * Main dashboard layout component that orchestrates navigation, header, and content.
+ * Implements WCAG 2.1 accessibility guidelines with proper landmarks and keyboard navigation.
+ *
+ * @module layouts/dashboard/layout
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme, Breakpoint } from '@mui/material';
+import { HeaderSection } from '../core/header-section.js';
+import { type LayoutNavData, type HeaderSlots, type LayoutConfig } from '../types.js';
+export interface DashboardLayoutProps {
+    /** Child content */
+    children?: ReactNode;
+    /** Layout breakpoint for responsive behavior */
+    layoutQuery?: Breakpoint;
+    /** Navigation data */
+    navData?: LayoutNavData;
+    /** Header slot content */
+    headerSlots?: HeaderSlots;
+    /** Logo component */
+    logo?: ReactNode;
+    /** Footer component */
+    footer?: ReactNode;
+    /** Sidenav footer content */
+    sidenavFooter?: ReactNode;
+    /** Initial layout configuration */
+    initialConfig?: Partial<LayoutConfig>;
+    /**
+     * Persistence key for sidebar collapsed state.
+     * When provided, sidebar collapsed state persists to localStorage.
+     * Use unique keys per layout (e.g., 'main', 'admin').
+     */
+    persistKey?: string;
+    /** Props for layout sections */
+    slotProps?: {
+        header?: Partial<React.ComponentProps<typeof HeaderSection>>;
+        main?: {
+            sx?: SxProps<Theme>;
+            disablePadding?: boolean;
+            maxWidth?: Breakpoint | false;
+        };
+    };
+}
+/**
+ * Dashboard Layout - Complete dashboard layout with navigation.
+ *
+ * Features:
+ * - Configurable navigation type (sidenav, topnav, combo)
+ * - Multiple sidenav variants (default, mini, stacked)
+ * - Responsive mobile drawer
+ * - Slot-based header customization
+ * - CSS variables for theming
+ *
+ * @example
+ * ```tsx
+ * <DashboardLayout
+ *   logo={<Logo />}
+ *   navData={navigationConfig}
+ *   headerSlots={{
+ *     leftArea: <MenuButton />,
+ *     rightArea: <UserMenu />,
+ *   }}
+ *   initialConfig={{
+ *     navigationMenuType: 'sidenav',
+ *     sidenavVariant: 'default',
+ *   }}
+ * >
+ *   <Outlet />
+ * </DashboardLayout>
+ * ```
+ */
+export declare function DashboardLayout({ children, layoutQuery, navData, headerSlots, logo, footer, sidenavFooter, initialConfig, persistKey, slotProps, }: DashboardLayoutProps): ReactNode;
+export interface DashboardContentProps {
+    /** Child content */
+    children?: ReactNode;
+    /** Disable padding */
+    disablePadding?: boolean;
+    /** Container max width */
+    maxWidth?: Breakpoint | false;
+    /** MUI sx prop */
+    sx?: SxProps<Theme>;
+}
+/**
+ * Dashboard content wrapper with optional container.
+ * Use for consistent content padding within dashboard.
+ */
+export declare function DashboardContent({ children, disablePadding, maxWidth, sx }: DashboardContentProps): ReactNode;
+//# sourceMappingURL=layout.d.ts.map

package/dist/layouts/dashboard/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/layouts/dashboard/layout.tsx"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAOvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEhE,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAI1D,OAAO,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,YAAY,EAAE,MAAM,aAAa,CAAC;AA6MtF,MAAM,WAAW,oBAAoB;IACnC,oBAAoB;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,gDAAgD;IAChD,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,sBAAsB;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,0BAA0B;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qBAAqB;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,uBAAuB;IACvB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,6BAA6B;IAC7B,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,mCAAmC;IACnC,aAAa,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACtC;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gCAAgC;IAChC,SAAS,CAAC,EAAE;QACV,MAAM,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,OAAO,aAAa,CAAC,CAAC,CAAC;QAC7D,IAAI,CAAC,EAAE;YACL,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,cAAc,CAAC,EAAE,OAAO,CAAC;YACzB,QAAQ,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;SAC/B,CAAC;KACH,CAAC;CACH;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,eAAe,CAAC,EAC9B,QAAQ,EACR,WAAkB,EAClB,OAAO,EACP,WAAW,EACX,IAAI,EACJ,MAAM,EACN,aAAa,EACb,aAAa,EACb,UAAU,EACV,SAAS,GACV,EAAE,oBAAoB,GAAG,SAAS,CAgBlC;AAMD,MAAM,WAAW,qBAAqB;IACpC,oBAAoB;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,sBAAsB;IACtB,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0BAA0B;IAC1B,QAAQ,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC;IAC9B,kBAAkB;IAClB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,QAAQ,EAAE,cAAsB,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,qBAAqB,GAAG,SAAS,CAyBrH"}

package/dist/layouts/dashboard/sidenav.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Dashboard Sidenav
+ *
+ * Sidebar navigation for dashboard layouts.
+ * Supports multiple variants: default, mini, and stacked.
+ * Implements WCAG 2.1 accessibility with proper ARIA attributes.
+ *
+ * @module layouts/dashboard/sidenav
+ */
+import { type ReactNode } from 'react';
+import type { SxProps, Theme, Breakpoint } from '@mui/material';
+import { type LayoutNavData } from '../types.js';
+export interface SidenavProps {
+    /** Logo component */
+    logo?: ReactNode;
+    /** Navigation data */
+    navData?: LayoutNavData;
+    /** Navigation item renderer */
+    renderNavItem?: (item: LayoutNavData[number]['items'][number], depth: number) => ReactNode;
+    /** Footer content (above collapse button) */
+    footer?: ReactNode;
+    /** Show collapse toggle button */
+    showCollapseButton?: boolean;
+    /** Layout breakpoint (hides on mobile) */
+    layoutQuery?: Breakpoint;
+    /** Accessible label for the navigation */
+    'aria-label'?: string;
+    /** MUI sx prop */
+    sx?: SxProps<Theme>;
+}
+/**
+ * Dashboard Sidenav - Sidebar navigation component.
+ *
+ * Supports three variants:
+ * - `default`: Full-width sidebar with text labels
+ * - `mini`: Icon-only collapsed sidebar
+ * - `stacked`: Two-panel design with icon nav + content panel
+ *
+ * @example
+ * ```tsx
+ * <Sidenav
+ *   logo={<Logo />}
+ *   navData={navigationConfig}
+ *   showCollapseButton
+ * />
+ * ```
+ */
+export declare function Sidenav({ logo, navData, renderNavItem, footer, showCollapseButton, layoutQuery, 'aria-label': ariaLabel, sx, }: SidenavProps): ReactNode;
+export interface MobileSidenavProps extends Omit<SidenavProps, 'showCollapseButton' | 'layoutQuery'> {
+    /** Layout breakpoint (shows only below this) */
+    layoutQuery?: Breakpoint;
+}
+/**
+ * Mobile Sidenav - Drawer-based navigation for mobile.
+ * Implements WCAG 2.1 accessibility with proper ARIA attributes.
+ */
+export declare function MobileSidenav({ logo, navData, renderNavItem, footer, layoutQuery, 'aria-label': ariaLabel, sx, }: MobileSidenavProps): ReactNode;
+//# sourceMappingURL=sidenav.d.ts.map

package/dist/layouts/dashboard/sidenav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sidenav.d.ts","sourceRoot":"","sources":["../../../src/layouts/dashboard/sidenav.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAY,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAYjD,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhE,OAAO,EAAkD,KAAK,aAAa,EAAuB,MAAM,aAAa,CAAC;AAqFtH,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,sBAAsB;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAC3F,6CAA6C;IAC7C,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,kCAAkC;IAClC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,0CAA0C;IAC1C,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,OAAO,CAAC,EACtB,IAAI,EACJ,OAAO,EACP,aAAa,EACb,MAAM,EACN,kBAAyB,EACzB,WAAkB,EAClB,YAAY,EAAE,SAA+B,EAC7C,EAAE,GACH,EAAE,YAAY,GAAG,SAAS,CAmG1B;AAMD,MAAM,WAAW,kBAAmB,SAAQ,IAAI,CAAC,YAAY,EAAE,oBAAoB,GAAG,aAAa,CAAC;IAClG,gDAAgD;IAChD,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,EAC5B,IAAI,EACJ,OAAO,EACP,aAAa,EACb,MAAM,EACN,WAAkB,EAClB,YAAY,EAAE,SAA+B,EAC7C,EAAE,GACH,EAAE,kBAAkB,GAAG,SAAS,CAwEhC"}

package/dist/layouts/dashboard/topnav.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Dashboard Topnav
+ *
+ * Horizontal top navigation bar for dashboard layouts.
+ * Used in 'topnav' and 'combo' navigation modes.
+ * Implements WCAG 2.1 accessibility with proper ARIA attributes.
+ *
+ * @module layouts/dashboard/topnav
+ */
+import type { ReactNode } from 'react';
+import type { SxProps, Theme, Breakpoint } from '@mui/material';
+import { type LayoutNavData, type LayoutNavItem } from '../types.js';
+export interface TopnavProps {
+    /** Navigation data */
+    navData?: LayoutNavData;
+    /** Navigation item renderer */
+    renderNavItem?: (item: LayoutNavItem, depth: number) => ReactNode;
+    /** Layout breakpoint (hides below this on combo mode) */
+    layoutQuery?: Breakpoint;
+    /** Accessible label */
+    'aria-label'?: string;
+    /** MUI sx prop */
+    sx?: SxProps<Theme>;
+}
+/**
+ * Dashboard Topnav - Horizontal navigation bar.
+ *
+ * Renders navigation sections as a horizontal list.
+ * For 'combo' mode, visible only on desktop alongside the sidenav.
+ * For 'topnav' mode, always visible.
+ *
+ * @example
+ * ```tsx
+ * <Topnav
+ *   navData={navigationConfig}
+ *   renderNavItem={(item) => <NavLink key={item.id} to={item.path}>{item.title}</NavLink>}
+ * />
+ * ```
+ */
+export declare function Topnav({ navData, renderNavItem, layoutQuery, 'aria-label': ariaLabel, sx, }: TopnavProps): ReactNode;
+//# sourceMappingURL=topnav.d.ts.map

package/dist/layouts/dashboard/topnav.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topnav.d.ts","sourceRoot":"","sources":["../../../src/layouts/dashboard/topnav.tsx"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGvC,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAIhE,OAAO,EAAmB,KAAK,aAAa,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AA0BtF,MAAM,WAAW,WAAW;IAC1B,sBAAsB;IACtB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,+BAA+B;IAC/B,aAAa,CAAC,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,KAAK,SAAS,CAAC;IAClE,yDAAyD;IACzD,WAAW,CAAC,EAAE,UAAU,CAAC;IACzB,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,EAAE,CAAC,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,MAAM,CAAC,EACrB,OAAO,EACP,aAAa,EACb,WAAkB,EAClB,YAAY,EAAE,SAA+B,EAC7C,EAAE,GACH,EAAE,WAAW,GAAG,SAAS,CAUzB"}