@caratlogic/design-system 0.0.9 → 0.0.10

package/dist/components/layouts/AppShell/AppShell.types.d.ts

@@ -0,0 +1,84 @@
+import type { LucideIcon } from 'lucide-react';
+import type { ReactNode } from 'react';
+/** One breadcrumb segment. When `href` is set the crumb renders as a link. */
+export interface PageBreadcrumbCrumb {
+    label: string;
+    href?: string;
+}
+/** Page heading/breadcrumb metadata — the consuming app computes this
+ *  (e.g. via its own `usePageMeta`) and passes it in. */
+export interface PageMeta {
+    title?: string;
+    subtitle?: string;
+    breadcrumb?: PageBreadcrumbCrumb[];
+}
+export interface AppShellNavSubItem {
+    path: string;
+    label: string;
+    icon?: LucideIcon;
+    /** `false` hides the item. The app resolves permission/role gating to this. */
+    visible?: boolean;
+}
+export interface AppShellNavItem {
+    label: string;
+    /** Leaf items have a `path`; parent items have `children`. */
+    path?: string;
+    icon?: LucideIcon;
+    badge?: ReactNode;
+    /** `false` hides the item. The app resolves permission/role gating to this. */
+    visible?: boolean;
+    children?: AppShellNavSubItem[];
+}
+export interface AppShellNavGroup {
+    /** Optional section label rendered above the group. */
+    label?: string;
+    items: AppShellNavItem[];
+}
+export interface AppShellBrand {
+    /** Logo shown when the sidebar is expanded. */
+    full: ReactNode;
+    /** Compact mark shown when the sidebar is collapsed to icons. */
+    compact: ReactNode;
+}
+export interface AppShellUser {
+    name: string;
+    email?: string;
+    avatarSrc?: string;
+    showStatusDot?: boolean;
+}
+export interface AppShellMenuAction {
+    label: string;
+    icon?: LucideIcon;
+    onClick: () => void;
+    destructive?: boolean;
+}
+export type AppShellNotificationsIndicator = 'destructive' | 'success' | 'warning' | false;
+export interface DashboardShellProps {
+    brand: AppShellBrand;
+    /** Pre-gated, pre-grouped navigation. The app resolves `visible` + sections. */
+    navGroups: AppShellNavGroup[];
+    /** Current route path (app passes `location.pathname`) — drives active state. */
+    currentPath: string;
+    /** Called with an item's `path` on click. The app wires this to its router. */
+    onNavigate: (path: string) => void;
+    /** Header title/breadcrumb — the app computes it (route tables stay app-local). */
+    pageMeta?: PageMeta;
+    /** Overrides the last breadcrumb crumb's label (e.g. a dynamic entity name). */
+    breadcrumbLeafOverride?: string;
+    user: AppShellUser;
+    profileMenuItems?: AppShellMenuAction[];
+    onLogout: () => void;
+    showThemeToggle?: boolean;
+    isDark?: boolean;
+    onToggleTheme?: () => void;
+    showNotifications?: boolean;
+    notificationsIndicator?: AppShellNotificationsIndicator;
+    onNotificationsClick?: () => void;
+    /** App-specific header actions (e.g. a barcode scanner), rendered leftmost. */
+    headerActionsSlot?: ReactNode;
+    /** Sidebar width CSS value. @default '248px' */
+    sidebarWidth?: string;
+    /** Page content. Apps using nested routing pass their `<Outlet />` here. */
+    children: ReactNode;
+}
+//# sourceMappingURL=AppShell.types.d.ts.map

package/dist/components/layouts/AppShell/AppShell.types.d.ts.map

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

package/dist/components/layouts/AppShell/AppShell.utils.d.ts

@@ -0,0 +1,5 @@
+/** Active when the current path equals the target or is nested under it. */
+export declare function isPathActive(currentPath: string, target?: string): boolean;
+/** Up-to-two-letter initials from a name, for the profile-menu avatar. */
+export declare function getInitials(name: string): string;
+//# sourceMappingURL=AppShell.utils.d.ts.map

package/dist/components/layouts/AppShell/AppShell.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AppShell.utils.d.ts","sourceRoot":"","sources":["../../../../src/components/layouts/AppShell/AppShell.utils.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAG1E;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAUhD"}

package/dist/components/layouts/AppShell/DashboardShell.d.ts

@@ -0,0 +1,4 @@
+import type { FC } from 'react';
+import type { DashboardShellProps } from './AppShell.types';
+export declare const DashboardShell: FC<DashboardShellProps>;
+//# sourceMappingURL=DashboardShell.d.ts.map

package/dist/components/layouts/AppShell/DashboardShell.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DashboardShell.d.ts","sourceRoot":"","sources":["../../../../src/components/layouts/AppShell/DashboardShell.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiB,EAAE,EAAE,MAAM,OAAO,CAAC;AAsC/C,OAAO,KAAK,EAMV,mBAAmB,EAEpB,MAAM,kBAAkB,CAAC;AA6S1B,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CAkDlD,CAAC"}

package/dist/components/layouts/AppShell/index.d.ts

@@ -0,0 +1,4 @@
+export { DashboardShell } from './DashboardShell';
+export { isPathActive, getInitials } from './AppShell.utils';
+export type { PageBreadcrumbCrumb, PageMeta, AppShellNavSubItem, AppShellNavItem, AppShellNavGroup, AppShellBrand, AppShellUser, AppShellMenuAction, AppShellNotificationsIndicator, DashboardShellProps, } from './AppShell.types';
+//# sourceMappingURL=index.d.ts.map

package/dist/components/layouts/AppShell/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/components/layouts/AppShell/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC7D,YAAY,EACV,mBAAmB,EACnB,QAAQ,EACR,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,kBAAkB,EAClB,8BAA8B,EAC9B,mBAAmB,GACpB,MAAM,kBAAkB,CAAC"}