@umituz/web-dashboard 1.0.2 → 1.0.7

package/dist/index.d.ts

@@ -1,8 +1,403 @@
-export { BrandLogo, DashboardHeader, DashboardLayout, DashboardLayout as DashboardLayoutDefault, DashboardSidebar } from './presentation/index.js';
-export { DashboardHeaderProps, DashboardLayoutConfig, DashboardNotification, DashboardSidebarProps, DashboardTheme, DashboardThemePreset, DashboardUser, SidebarGroup, SidebarItem, UserNavMenuItem } from './domain/types/index.js';
-export { DASHBOARD_THEME_PRESETS, DEFAULT_DASHBOARD_THEME, DEFAULT_DASHBOARD_THEME_DARK, applyDashboardTheme, getDashboardThemePreset, mergeDashboardTheme } from './domain/theme/index.js';
-export { useNotifications, useSidebar } from './infrastructure/hooks/index.js';
-export { filterSidebarItems, formatNotificationTime, generateNotificationId, getPageTitle, isPathActive } from './infrastructure/utils/index.js';
-import 'react/jsx-runtime';
-import 'lucide-react';
-import 'react';
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import { LucideIcon } from 'lucide-react';
+import * as react from 'react';
+
+/**
+ * Dashboard Types
+ *
+ * Core type definitions for the dashboard layout system
+ */
+
+/**
+ * Single sidebar menu item
+ */
+interface SidebarItem {
+    /** Display label (can be i18n key) */
+    label: string;
+    /** Icon from lucide-react */
+    icon: LucideIcon;
+    /** Route path */
+    path: string;
+    /** Filter by app type (optional) */
+    requiredApp?: 'mobile' | 'web';
+    /** Enable/disable this item (default: true) */
+    enabled?: boolean;
+}
+/**
+ * Group of sidebar items with a title
+ */
+interface SidebarGroup {
+    /** Group title (can be i18n key) */
+    title: string;
+    /** Items in this group */
+    items: SidebarItem[];
+    /** Optional: Route to title mapping for page headers */
+    titleMap?: Record<string, string>;
+}
+/**
+ * Dashboard header props
+ */
+interface DashboardHeaderProps {
+    /** Whether sidebar is collapsed */
+    collapsed: boolean;
+    /** Toggle sidebar collapsed state */
+    setCollapsed: (collapsed: boolean) => void;
+    /** Toggle mobile menu open state */
+    setMobileOpen: (open: boolean) => void;
+    /** Current page title */
+    title: string;
+}
+/**
+ * Dashboard sidebar props
+ */
+interface DashboardSidebarProps {
+    /** Whether sidebar is collapsed */
+    collapsed: boolean;
+    /** Toggle sidebar collapsed state */
+    setCollapsed: (collapsed: boolean) => void;
+}
+/**
+ * Dashboard layout configuration
+ */
+interface DashboardLayoutConfig {
+    /** Sidebar groups */
+    sidebarGroups: SidebarGroup[];
+    /** Extra title mappings for routes */
+    extraTitleMap?: Record<string, string>;
+    /** Brand name */
+    brandName?: string;
+    /** Brand tagline */
+    brandTagline?: string;
+}
+/**
+ * Dashboard theme configuration
+ * Extends CSS variables for customization
+ */
+interface DashboardTheme {
+    /** Primary color (CSS variable compatible) */
+    primary?: string;
+    /** Secondary color */
+    secondary?: string;
+    /** Sidebar background */
+    sidebarBackground?: string;
+    /** Sidebar foreground */
+    sidebarForeground?: string;
+    /** Sidebar border */
+    sidebarBorder?: string;
+    /** Header background */
+    headerBackground?: string;
+    /** Background color */
+    background?: string;
+    /** Foreground color */
+    foreground?: string;
+    /** Border color */
+    border?: string;
+    /** Accent color */
+    accent?: string;
+    /** Accent foreground */
+    accentForeground?: string;
+    /** Destructive color */
+    destructive?: string;
+    /** Destructive foreground */
+    destructiveForeground?: string;
+    /** Muted background */
+    muted?: string;
+    /** Muted foreground */
+    mutedForeground?: string;
+    /** Card background */
+    card?: string;
+    /** Card foreground */
+    cardForeground?: string;
+    /** Popover background */
+    popover?: string;
+    /** Popover foreground */
+    popoverForeground?: string;
+    /** Radius (border-radius) */
+    radius?: string;
+}
+/**
+ * Theme preset for quick setup
+ */
+interface DashboardThemePreset {
+    /** Preset name */
+    name: string;
+    /** Theme configuration */
+    theme: DashboardTheme;
+    /** Whether this is a dark theme */
+    dark?: boolean;
+}
+/**
+ * Notification item
+ */
+interface DashboardNotification {
+    /** Unique ID */
+    id: string;
+    /** Notification text */
+    text: string;
+    /** Whether notification is read */
+    read: boolean;
+    /** Creation timestamp */
+    createdAt: Date | string | number;
+}
+/**
+ * User profile info for header
+ */
+interface DashboardUser {
+    /** User ID */
+    id: string;
+    /** Display name */
+    name?: string;
+    /** Email address */
+    email?: string;
+    /** Avatar URL */
+    avatar?: string;
+    /** Whether user has mobile app access */
+    hasMobileApp?: boolean;
+    /** Whether user has web app access */
+    hasWebApp?: boolean;
+}
+/**
+ * Navigation item for user menu
+ */
+interface UserNavMenuItem {
+    /** Display label */
+    label: string;
+    /** Icon component */
+    icon: React.ComponentType<{
+        className?: string;
+    }>;
+    /** Route path */
+    path: string;
+}
+
+interface DashboardLayoutProps {
+    /** Layout configuration */
+    config: DashboardLayoutConfig;
+    /** Auth user */
+    user?: DashboardUser;
+    /** Auth loading state */
+    authLoading?: boolean;
+    /** Authenticated state */
+    isAuthenticated?: boolean;
+    /** Notifications */
+    notifications?: DashboardNotification[];
+    /** Logout function */
+    onLogout?: () => Promise<void>;
+    /** Mark all as read function */
+    onMarkAllRead?: () => void;
+    /** Dismiss notification function */
+    onDismissNotification?: (id: string) => void;
+    /** Login route for redirect */
+    loginRoute?: string;
+}
+/**
+ * Dashboard Layout Component
+ *
+ * Main layout wrapper for dashboard pages.
+ * Provides sidebar, header, and content area with responsive design.
+ *
+ * Features:
+ * - Collapsible sidebar
+ * - Mobile menu overlay
+ * - Breadcrumb page titles
+ * - Loading skeletons
+ * - Auth protection
+ *
+ * @param props - Dashboard layout props
+ */
+declare const DashboardLayout: ({ config, user, authLoading, isAuthenticated, notifications, onLogout, onMarkAllRead, onDismissNotification, loginRoute, }: DashboardLayoutProps) => react_jsx_runtime.JSX.Element | null;
+
+interface DashboardHeaderPropsExtended extends DashboardHeaderProps {
+    /** Auth user */
+    user?: DashboardUser;
+    /** Notifications */
+    notifications?: DashboardNotification[];
+    /** Logout function */
+    onLogout?: () => Promise<void>;
+    /** Mark all as read function */
+    onMarkAllRead?: () => void;
+    /** Dismiss notification function */
+    onDismissNotification?: (id: string) => void;
+    /** Settings route */
+    settingsRoute?: string;
+    /** Profile route */
+    profileRoute?: string;
+    /** Billing route */
+    billingRoute?: string;
+}
+/**
+ * Dashboard Header Component
+ *
+ * Displays top navigation bar with theme toggle, notifications,
+ * user menu, and organisation selector.
+ *
+ * @param props - Dashboard header props
+ */
+declare const DashboardHeader: ({ collapsed, setCollapsed, setMobileOpen, title, user, notifications, onLogout, onMarkAllRead, onDismissNotification, settingsRoute, profileRoute, billingRoute, }: DashboardHeaderPropsExtended) => react_jsx_runtime.JSX.Element;
+
+interface DashboardSidebarPropsExtended extends DashboardSidebarProps {
+    /** Sidebar groups configuration */
+    sidebarGroups: SidebarGroup[];
+    /** Brand name */
+    brandName?: string;
+    /** Brand tagline */
+    brandTagline?: string;
+    /** Create post route */
+    createPostRoute?: string;
+    /** Auth user */
+    user?: DashboardUser;
+}
+/**
+ * Dashboard Sidebar Component
+ *
+ * Displays collapsible sidebar with navigation menu items.
+ * Supports app-based filtering (mobile/web) and collapsible groups.
+ *
+ * @param props - Dashboard sidebar props
+ */
+declare const DashboardSidebar: ({ collapsed, setCollapsed, sidebarGroups, brandName, brandTagline, createPostRoute, user, }: DashboardSidebarPropsExtended) => react_jsx_runtime.JSX.Element;
+
+interface BrandLogoProps {
+    className?: string;
+    size?: number;
+}
+/**
+ * BrandLogo Component
+ *
+ * Displays the application brand logo as an SVG.
+ * Supports custom sizing and styling through className.
+ *
+ * @param className - Optional CSS classes for styling
+ * @param size - Width and height in pixels (default: 32)
+ */
+declare const BrandLogo: ({ className, size }: BrandLogoProps) => react_jsx_runtime.JSX.Element;
+
+/**
+ * Dashboard Theme System
+ *
+ * Provides theme configuration and presets for the dashboard layout.
+ * Themes are applied via CSS variables, allowing runtime customization.
+ */
+
+/**
+ * Default dashboard theme (light mode)
+ */
+declare const DEFAULT_DASHBOARD_THEME: DashboardTheme;
+/**
+ * Default dashboard theme (dark mode)
+ */
+declare const DEFAULT_DASHBOARD_THEME_DARK: DashboardTheme;
+/**
+ * Available theme presets
+ */
+declare const DASHBOARD_THEME_PRESETS: DashboardThemePreset[];
+/**
+ * Apply theme to document root via CSS variables
+ *
+ * @param theme - Theme configuration to apply
+ */
+declare function applyDashboardTheme(theme: DashboardTheme): void;
+/**
+ * Get theme preset by name
+ *
+ * @param name - Preset name
+ * @returns Theme preset or undefined
+ */
+declare function getDashboardThemePreset(name: string): DashboardThemePreset | undefined;
+/**
+ * Merge custom theme with default theme
+ *
+ * @param customTheme - Custom theme configuration
+ * @param dark - Whether to use dark mode base
+ * @returns Merged theme configuration
+ */
+declare function mergeDashboardTheme(customTheme: Partial<DashboardTheme>, dark?: boolean): DashboardTheme;
+
+/**
+ * Use Notifications Hook
+ *
+ * Manages notification state and actions
+ *
+ * @param initialNotifications - Initial notification list
+ * @returns Notification state and actions
+ */
+declare function useNotifications(initialNotifications?: DashboardNotification[]): {
+    notifications: DashboardNotification[];
+    markAllRead: () => void;
+    dismiss: (id: string) => void;
+    add: (notification: Omit<DashboardNotification, "id">) => void;
+};
+/**
+ * Use Sidebar Hook
+ *
+ * Manages sidebar state
+ *
+ * @returns Sidebar state and actions
+ */
+declare function useSidebar(initialCollapsed?: boolean): {
+    collapsed: boolean;
+    setCollapsed: react.Dispatch<react.SetStateAction<boolean>>;
+    toggle: () => void;
+    mobileOpen: boolean;
+    setMobileOpen: react.Dispatch<react.SetStateAction<boolean>>;
+    openMobile: () => void;
+    closeMobile: () => void;
+};
+
+/**
+ * Dashboard Utilities
+ *
+ * Utility functions for dashboard operations
+ */
+/**
+ * Format notification timestamp to relative time
+ *
+ * @param createdAt - Notification creation timestamp
+ * @param t - i18n translation function
+ * @returns Formatted time string
+ */
+declare function formatNotificationTime(createdAt: Date | string | number, t: (key: string, params?: Record<string, unknown>) => string): string;
+/**
+ * Check if a path is active
+ *
+ * @param currentPath - Current location pathname
+ * @param targetPath - Target path to check
+ * @returns True if paths match
+ */
+declare function isPathActive(currentPath: string, targetPath: string): boolean;
+/**
+ * Get page title from sidebar configuration
+ *
+ * @param pathname - Current pathname
+ * @param sidebarGroups - Sidebar groups configuration
+ * @param extraTitleMap - Extra title mappings
+ * @returns Page title or null
+ */
+declare function getPageTitle(pathname: string, sidebarGroups: Array<{
+    items: Array<{
+        path: string;
+        label: string;
+    }>;
+}>, extraTitleMap?: Record<string, string>): string | null;
+/**
+ * Filter sidebar items by app type and enabled status
+ *
+ * @param items - Sidebar items to filter
+ * @param user - Current user object
+ * @returns Filtered items
+ */
+declare function filterSidebarItems<T extends {
+    enabled?: boolean;
+    requiredApp?: "mobile" | "web";
+}>(items: T[], user?: {
+    hasMobileApp?: boolean;
+    hasWebApp?: boolean;
+}): T[];
+/**
+ * Generate notification ID
+ *
+ * @returns Unique notification ID
+ */
+declare function generateNotificationId(): string;
+
+export { BrandLogo, DASHBOARD_THEME_PRESETS, DEFAULT_DASHBOARD_THEME, DEFAULT_DASHBOARD_THEME_DARK, DashboardHeader, type DashboardHeaderProps, DashboardLayout, type DashboardLayoutConfig, type DashboardNotification, DashboardSidebar, type DashboardSidebarProps, type DashboardTheme, type DashboardThemePreset, type DashboardUser, type SidebarGroup, type SidebarItem, type UserNavMenuItem, applyDashboardTheme, filterSidebarItems, formatNotificationTime, generateNotificationId, getDashboardThemePreset, getPageTitle, isPathActive, mergeDashboardTheme, useNotifications, useSidebar };

package/dist/index.js

@@ -1,17 +1,17 @@
 "use client";
 
-// src/presentation/organisms/DashboardLayout.tsx
+// src/domains/layouts/components/DashboardLayout.tsx
 import { useState as useState3, useEffect } from "react";
 import { useLocation as useLocation2, Outlet, Navigate } from "react-router-dom";
 import { Skeleton } from "@umituz/web-design-system/atoms";
 
-// src/presentation/molecules/DashboardSidebar.tsx
+// src/domains/layouts/components/DashboardSidebar.tsx
 import { useState } from "react";
 import { Link, useLocation } from "react-router-dom";
 import { useTranslation } from "react-i18next";
 import { Button } from "@umituz/web-design-system/atoms";
 
-// src/presentation/molecules/BrandLogo.tsx
+// src/domains/layouts/components/BrandLogo.tsx
 import { cn } from "@umituz/web-design-system/utils";
 import { jsx, jsxs } from "react/jsx-runtime";
 var BrandLogo = ({ className, size = 32 }) => {
@@ -94,8 +94,45 @@ var BrandLogo = ({ className, size = 32 }) => {
   );
 };
 
-// src/presentation/molecules/DashboardSidebar.tsx
+// src/domains/layouts/components/DashboardSidebar.tsx
 import { PenTool, Menu, ChevronLeft, ChevronDown, ChevronRight } from "lucide-react";
+
+// src/domains/layouts/utils/dashboard.ts
+function formatNotificationTime(createdAt, t) {
+  const date = new Date(createdAt);
+  const secs = Math.floor((Date.now() - date.getTime()) / 1e3);
+  if (secs < 60) return t("dashboard.activityFeed.times.justNow");
+  if (secs < 3600) return t("dashboard.activityFeed.times.minutesAgo", { val: Math.floor(secs / 60) });
+  if (secs < 86400) return t("dashboard.activityFeed.times.hoursAgo", { val: Math.floor(secs / 3600) });
+  return t("dashboard.activityFeed.times.daysAgo", { val: Math.floor(secs / 86400) });
+}
+function isPathActive(currentPath, targetPath) {
+  return currentPath === targetPath;
+}
+function getPageTitle(pathname, sidebarGroups, extraTitleMap) {
+  for (const group of sidebarGroups) {
+    const item = group.items.find((i) => i.path === pathname);
+    if (item) return item.label;
+  }
+  if (extraTitleMap?.[pathname]) {
+    return extraTitleMap[pathname];
+  }
+  return null;
+}
+function filterSidebarItems(items, user) {
+  return items.filter((item) => {
+    if (item.enabled === false) return false;
+    if (!item.requiredApp) return true;
+    if (item.requiredApp === "mobile") return user?.hasMobileApp ?? false;
+    if (item.requiredApp === "web") return user?.hasWebApp ?? false;
+    return true;
+  });
+}
+function generateNotificationId() {
+  return crypto.randomUUID();
+}
+
+// src/domains/layouts/components/DashboardSidebar.tsx
 import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 var DashboardSidebar = ({
   collapsed,
@@ -136,13 +173,7 @@ var DashboardSidebar = ({
       }
     ) }) }),
     /* @__PURE__ */ jsx2("nav", { className: "flex-1 overflow-y-auto px-2 py-3 scrollbar-hide", children: /* @__PURE__ */ jsx2("div", { className: "space-y-6", children: sidebarGroups.map((group) => {
-      const filteredItems = group.items.filter((item) => {
-        if (item.enabled === false) return false;
-        if (!item.requiredApp) return true;
-        if (item.requiredApp === "mobile") return user?.hasMobileApp;
-        if (item.requiredApp === "web") return user?.hasWebApp;
-        return true;
-      });
+      const filteredItems = filterSidebarItems(group.items, user);
       if (filteredItems.length === 0) return null;
       const isGroupCollapsed = collapsedGroups[group.title];
       return /* @__PURE__ */ jsxs2("div", { className: "space-y-1", children: [
@@ -182,8 +213,8 @@ var DashboardSidebar = ({
   ] });
 };
 
-// src/presentation/organisms/DashboardHeader.tsx
-import React, { useState as useState2, useCallback } from "react";
+// src/domains/layouts/components/DashboardHeader.tsx
+import React, { useState as useState2 } from "react";
 import {
   Bell,
   X,
@@ -210,7 +241,6 @@ var DashboardHeader = ({
   onLogout,
   onMarkAllRead,
   onDismissNotification,
-  formatDate,
   settingsRoute = "/dashboard/settings",
   profileRoute = "/dashboard/profile",
   billingRoute = "/dashboard/billing"
@@ -223,20 +253,11 @@ var DashboardHeader = ({
   const markAllRead = () => {
     onMarkAllRead?.();
   };
-  const formatTimeAgo = useCallback((createdAt) => {
-    if (!formatDate) return "";
-    const date = new Date(createdAt);
-    const secs = Math.floor((Date.now() - date.getTime()) / 1e3);
-    if (secs < 60) return t("dashboard.activityFeed.times.justNow");
-    if (secs < 3600) return t("dashboard.activityFeed.times.minutesAgo", { val: Math.floor(secs / 60) });
-    if (secs < 86400) return t("dashboard.activityFeed.times.hoursAgo", { val: Math.floor(secs / 3600) });
-    return t("dashboard.activityFeed.times.daysAgo", { val: Math.floor(secs / 86400) });
-  }, [t, formatDate]);
   const handleLogout = async () => {
     try {
       await onLogout?.();
       navigate("/login");
-    } catch (error) {
+    } catch {
     }
   };
   const ThemeToggle = () => {
@@ -294,7 +315,7 @@ var DashboardHeader = ({
                   /* @__PURE__ */ jsx3("p", { className: "text-sm text-foreground leading-snug", children: n.text }),
                   /* @__PURE__ */ jsxs3("p", { className: "text-[10px] text-muted-foreground mt-1 flex items-center gap-1", children: [
                     /* @__PURE__ */ jsx3("span", { className: "inline-block w-1 h-1 rounded-full bg-muted-foreground/30" }),
-                    formatTimeAgo(n.createdAt)
+                    formatNotificationTime(n.createdAt, t)
                   ] })
                 ] }),
                 /* @__PURE__ */ jsx3(
@@ -400,7 +421,7 @@ var DashboardHeader = ({
   ] });
 };
 
-// src/presentation/organisms/DashboardLayout.tsx
+// src/domains/layouts/components/DashboardLayout.tsx
 import { jsx as jsx4, jsxs as jsxs4 } from "react/jsx-runtime";
 var DashboardLayout = ({
   config,
@@ -488,9 +509,8 @@ var DashboardLayout = ({
     ] })
   ] });
 };
-var DashboardLayout_default = DashboardLayout;
 
-// src/domain/theme/index.ts
+// src/domains/layouts/theme/index.ts
 var DEFAULT_DASHBOARD_THEME = {
   primary: "hsl(222.2 47.4% 11.2%)",
   secondary: "hsl(217.2 32.6% 17.5%)",
@@ -660,22 +680,22 @@ function mergeDashboardTheme(customTheme, dark = false) {
   };
 }
 
-// src/infrastructure/hooks/index.ts
-import { useState as useState4, useCallback as useCallback2 } from "react";
+// src/domains/layouts/hooks/dashboard.ts
+import { useState as useState4, useCallback } from "react";
 function useNotifications(initialNotifications = []) {
   const [notifications, setNotifications] = useState4(initialNotifications);
-  const markAllRead = useCallback2(() => {
+  const markAllRead = useCallback(() => {
     setNotifications(
       (prev) => prev.map((n) => ({ ...n, read: true }))
     );
   }, []);
-  const dismiss = useCallback2((id) => {
+  const dismiss = useCallback((id) => {
     setNotifications((prev) => prev.filter((n) => n.id !== id));
   }, []);
-  const add = useCallback2((notification) => {
+  const add = useCallback((notification) => {
     const newNotification = {
       ...notification,
-      id: Math.random().toString(36).substring(7),
+      id: crypto.randomUUID(),
       read: false,
       createdAt: /* @__PURE__ */ new Date()
     };
@@ -691,13 +711,13 @@ function useNotifications(initialNotifications = []) {
 function useSidebar(initialCollapsed = false) {
   const [collapsed, setCollapsed] = useState4(initialCollapsed);
   const [mobileOpen, setMobileOpen] = useState4(false);
-  const toggle = useCallback2(() => {
+  const toggle = useCallback(() => {
     setCollapsed((prev) => !prev);
   }, []);
-  const openMobile = useCallback2(() => {
+  const openMobile = useCallback(() => {
     setMobileOpen(true);
   }, []);
-  const closeMobile = useCallback2(() => {
+  const closeMobile = useCallback(() => {
     setMobileOpen(false);
   }, []);
   return {
@@ -710,41 +730,6 @@ function useSidebar(initialCollapsed = false) {
     closeMobile
   };
 }
-
-// src/infrastructure/utils/index.ts
-function formatNotificationTime(createdAt, t) {
-  const date = new Date(createdAt);
-  const secs = Math.floor((Date.now() - date.getTime()) / 1e3);
-  if (secs < 60) return t("dashboard.activityFeed.times.justNow");
-  if (secs < 3600) return t("dashboard.activityFeed.times.minutesAgo", { val: Math.floor(secs / 60) });
-  if (secs < 86400) return t("dashboard.activityFeed.times.hoursAgo", { val: Math.floor(secs / 3600) });
-  return t("dashboard.activityFeed.times.daysAgo", { val: Math.floor(secs / 86400) });
-}
-function isPathActive(currentPath, targetPath) {
-  return currentPath === targetPath;
-}
-function getPageTitle(pathname, sidebarGroups, extraTitleMap) {
-  for (const group of sidebarGroups) {
-    const item = group.items.find((i) => i.path === pathname);
-    if (item) return item.label;
-  }
-  if (extraTitleMap?.[pathname]) {
-    return extraTitleMap[pathname];
-  }
-  return null;
-}
-function filterSidebarItems(items, user) {
-  return items.filter((item) => {
-    if (item.enabled === false) return false;
-    if (!item.requiredApp) return true;
-    if (item.requiredApp === "mobile") return user?.hasMobileApp ?? false;
-    if (item.requiredApp === "web") return user?.hasWebApp ?? false;
-    return true;
-  });
-}
-function generateNotificationId() {
-  return `${Date.now()}-${Math.random().toString(36).substring(7)}`;
-}
 export {
   BrandLogo,
   DASHBOARD_THEME_PRESETS,
@@ -752,7 +737,6 @@ export {
   DEFAULT_DASHBOARD_THEME_DARK,
   DashboardHeader,
   DashboardLayout,
-  DashboardLayout_default as DashboardLayoutDefault,
   DashboardSidebar,
   applyDashboardTheme,
   filterSidebarItems,