@umituz/web-dashboard 6.1.0 → 6.2.0

package/src/domains/calendar/types/calendar.types.ts

@@ -1,25 +1,9 @@
-/**
- * Calendar Domain Types
- */
-
-/**
- * Content item status
- */
 export type ContentStatus = 'draft' | 'scheduled' | 'published' | 'failed';
 
-/**
- * Content item type
- */
 export type ContentType = 'post' | 'story' | 'reel' | 'tweet' | 'article';
 
-/**
- * Calendar view type
- */
 export type CalendarView = 'month' | 'week' | 'day' | 'timeline';
 
-/**
- * Content item
- */
 export interface ContentItem {
   id: string;
   title: string;
@@ -36,9 +20,6 @@ export interface ContentItem {
   updated_at?: string;
 }
 
-/**
- * Calendar event
- */
 export interface CalendarEvent {
   id: string;
   title: string;
@@ -48,9 +29,6 @@ export interface CalendarEvent {
   color?: string;
 }
 
-/**
- * Calendar filter
- */
 export interface CalendarFilter {
   search?: string;
   platforms?: string[];
@@ -62,34 +40,18 @@ export interface CalendarFilter {
   };
 }
 
-/**
- * Calendar configuration
- */
 export interface CalendarConfig {
-  /** Default view */
-  defaultView?: CalendarView;
-  /** Show weekends */
-  showWeekends?: boolean;
-  /** Start of week (0-6, 0 = Sunday) */
-  startOfWeek?: number;
-  /** Hour range for day/week view */
-  hourRange?: {
-    start: number; // 0-23
-    end: number; // 0-23
-  };
-  /** Enable drag and drop */
-  enableDragDrop?: boolean;
-  /** Show platform filters */
-  showPlatformFilters?: boolean;
-  /** Available platforms */
-  platforms?: string[];
-  /** Time slot duration in minutes */
-  slotDuration?: number;
+    defaultView?: CalendarView;
+    showWeekends?: boolean;
+    startOfWeek?: number;
+    hourRange?: {
+    start: number;     end: number;   };
+    enableDragDrop?: boolean;
+    showPlatformFilters?: boolean;
+    platforms?: string[];
+    slotDuration?: number;
 }
 
-/**
- * Content item creation params
- */
 export interface CreateContentItemParams {
   title: string;
   description: string;
@@ -102,9 +64,6 @@ export interface CreateContentItemParams {
   tags?: string[];
 }
 
-/**
- * Content item update params
- */
 export interface UpdateContentItemParams {
   title?: string;
   description?: string;
@@ -116,9 +75,6 @@ export interface UpdateContentItemParams {
   tags?: string[];
 }
 
-/**
- * Calendar service interface
- */
 export interface ICalendarService {
   getContentItems(userId: string, filter?: CalendarFilter): Promise<ContentItem[]>;
   getContentItemById(id: string): Promise<ContentItem | null>;

package/src/domains/calendar/utils/contentItemMapper.test.ts

@@ -1,7 +1,3 @@
-/**
- * Tests for the calendar Firestore → ContentItem mappers.
- */
-
 import { describe, it, expect } from "vitest";
 import { mapCalendarDocument, mapPostDocument } from "./contentItemMapper";
 import type { FirestoreDocument } from "./contentItemMapper";

package/src/domains/calendar/utils/contentItemMapper.ts

@@ -1,14 +1,5 @@
-/**
- * Content Item Mapper
- *
- * Type-safe transformation between wire-format documents and domain ContentItem objects.
- */
-
 import type { ContentItem, ContentStatus, ContentType } from '../types/calendar.types';
 
-/**
- * Raw wire document shape for calendar_items records
- */
 interface CalendarItemDocument {
   title?: string;
   description?: string;
@@ -27,44 +18,27 @@ interface CalendarItemDocument {
   updated_at?: string | { toDate: () => Date };
 }
 
-/**
- * Firestore document with id
- */
 export interface FirestoreDocument<T = Record<string, unknown>> {
   id: string;
   data: () => T;
 }
 
-/**
- * Convert Firebase timestamp value to ISO string.
- * A missing value maps to the epoch rather than "now" — missing data
- * must not masquerade as freshly-scheduled content in date-sorted views.
- */
 const toIsoString = (value: string | { toDate: () => Date } | undefined): string => {
   if (!value) return new Date(0).toISOString();
   if (typeof value === 'string') return value;
   return value.toDate().toISOString();
 };
 
-/**
- * Normalize status string to ContentStatus union
- */
 const normalizeStatus = (status: string | undefined): ContentStatus => {
   const valid: ContentStatus[] = ['draft', 'scheduled', 'published', 'failed'];
   return valid.includes(status as ContentStatus) ? (status as ContentStatus) : 'draft';
 };
 
-/**
- * Normalize type string to ContentType union
- */
 const normalizeType = (type: string | undefined): ContentType => {
   const valid: ContentType[] = ['post', 'story', 'reel', 'tweet', 'article'];
   return valid.includes(type as ContentType) ? (type as ContentType) : 'post';
 };
 
-/**
- * Map calendar_items document to ContentItem
- */
 export const mapCalendarDocument = (doc: FirestoreDocument<CalendarItemDocument>): ContentItem => {
   const data = doc.data();
   return {
@@ -79,11 +53,6 @@ export const mapCalendarDocument = (doc: FirestoreDocument<CalendarItemDocument>
   };
 };
 
-/**
- * Map posts document to ContentItem.
- * Missing display fields fall back to empty strings so the consuming
- * UI can render its own (localized) placeholder — no package-side copy.
- */
 export const mapPostDocument = (doc: FirestoreDocument<CalendarItemDocument>): ContentItem => {
   const data = doc.data();
   return {

package/src/domains/calendar/utils/index.ts

@@ -1,15 +1,8 @@
-/**
- * Calendar Domain Utilities
- */
-
 import type { CalendarConfig } from '../types/calendar.types';
 
 export { mapCalendarDocument, mapPostDocument } from './contentItemMapper';
 export type { FirestoreDocument } from './contentItemMapper';
 
-/**
- * Get week dates for a given date
- */
 export function getWeekDates(date: Date, startOfWeek: number = 0): Date[] {
   const week: Date[] = [];
   const current = new Date(date);
@@ -26,9 +19,6 @@ export function getWeekDates(date: Date, startOfWeek: number = 0): Date[] {
   return week;
 }
 
-/**
- * Get month days
- */
 export function getMonthDays(date: Date): Date[] {
   const year = date.getFullYear();
   const month = date.getMonth();
@@ -44,17 +34,10 @@ export function getMonthDays(date: Date): Date[] {
   return days;
 }
 
-/**
- * Check if date is in range
- */
 export function isDateInRange(date: Date, range: { start: Date; end: Date }): boolean {
   return date >= range.start && date <= range.end;
 }
 
-/**
- * Format date for display.
- * The locale is taken as a parameter so the consumer can decide.
- */
 export function formatDate(
   date: Date,
   format: 'short' | 'long' | 'time' = 'short',
@@ -74,9 +57,6 @@ export function formatDate(
   });
 }
 
-/**
- * Check if dates are same day
- */
 export function isSameDay(date1: Date, date2: Date): boolean {
   return (
     date1.getFullYear() === date2.getFullYear() &&
@@ -85,9 +65,6 @@ export function isSameDay(date1: Date, date2: Date): boolean {
   );
 }
 
-/**
- * Get date range for a view
- */
 export function getViewRange(
   view: 'month' | 'week',
   date: Date,
@@ -106,9 +83,6 @@ export function getViewRange(
   return { start: firstDay, end: lastDay };
 }
 
-/**
- * Generate time slots
- */
 export function generateTimeSlots(
   startHour: number,
   endHour: number,

package/src/domains/layouts/components/index.ts

@@ -1,7 +1,3 @@
-/**
- * Layout Components Export
- */
-
 export { DashboardLayout } from './DashboardLayout';
 export { DashboardHeader } from './DashboardHeader';
 export { DashboardSidebar } from './DashboardSidebar';

package/src/domains/layouts/hooks/dashboard.ts

@@ -1,20 +1,6 @@
-/**
- * Dashboard Hooks
- *
- * Custom React hooks for dashboard functionality
- */
-
 import { useState, useCallback } from "react";
 import type { DashboardNotification } from "../types/notification";
 
-/**
- * Use Notifications Hook
- *
- * Manages notification state and actions
- *
- * @param initialNotifications - Initial notification list
- * @returns Notification state and actions
- */
 export function useNotifications(initialNotifications: DashboardNotification[] = []) {
   const [notifications, setNotifications] = useState<DashboardNotification[]>(initialNotifications);
 
@@ -46,13 +32,6 @@ export function useNotifications(initialNotifications: DashboardNotification[] =
   };
 }
 
-/**
- * Use Sidebar Hook
- *
- * Manages sidebar state
- *
- * @returns Sidebar state and actions
- */
 export function useSidebar(initialCollapsed = false) {
   const [collapsed, setCollapsed] = useState(initialCollapsed);
   const [mobileOpen, setMobileOpen] = useState(false);

package/src/domains/layouts/hooks/index.ts

@@ -1,7 +1,3 @@
-/**
- * Layout Hooks Export
- */
-
 export {
   useNotifications,
   useSidebar,

package/src/domains/layouts/index.ts

@@ -1,9 +1,3 @@
-/**
- * @umituz/web-dashboard - Layouts Domain
- *
- * Dashboard Layout System
- */
-
 export * from './components';
 export * from './hooks';
 export * from './utils';

package/src/domains/layouts/theme/default.ts

@@ -1,14 +1,5 @@
-/**
- * Dashboard Theme - Default Themes
- *
- * Default light and dark theme configurations
- */
-
 import type { DashboardTheme } from '../types/theme';
 
-/**
- * Default dashboard theme (light mode)
- */
 export const DEFAULT_DASHBOARD_THEME: DashboardTheme = {
   primary: "hsl(222.2 47.4% 11.2%)",
   secondary: "hsl(217.2 32.6% 17.5%)",
@@ -32,9 +23,6 @@ export const DEFAULT_DASHBOARD_THEME: DashboardTheme = {
   radius: "0.5rem",
 };
 
-/**
- * Default dashboard theme (dark mode)
- */
 export const DEFAULT_DASHBOARD_THEME_DARK: DashboardTheme = {
   primary: "hsl(217.2 91.2% 59.8%)",
   secondary: "hsl(217.2 32.6% 17.5%)",

package/src/domains/layouts/theme/index.ts

@@ -1,7 +1,3 @@
-/**
- * Layout Theme Export
- */
-
 export {
   DEFAULT_DASHBOARD_THEME,
   DEFAULT_DASHBOARD_THEME_DARK,

package/src/domains/layouts/theme/presets.ts

@@ -1,15 +1,6 @@
-/**
- * Dashboard Theme - Presets
- *
- * Pre-configured theme presets
- */
-
 import type { DashboardThemePreset } from '../types/theme';
 import { DEFAULT_DASHBOARD_THEME, DEFAULT_DASHBOARD_THEME_DARK } from './default';
 
-/**
- * Available theme presets
- */
 export const DASHBOARD_THEME_PRESETS: DashboardThemePreset[] = [
   {
     name: "default",

package/src/domains/layouts/theme/utils.ts

@@ -1,16 +1,7 @@
-/**
- * Dashboard Theme - Utilities
- *
- * Theme utility functions
- */
-
 import type { DashboardTheme, DashboardThemePreset } from '../types/theme';
 import { DEFAULT_DASHBOARD_THEME, DEFAULT_DASHBOARD_THEME_DARK } from './default';
 import { DASHBOARD_THEME_PRESETS } from './presets';
 
-/**
- * Apply theme to document root via CSS variables
- */
 export function applyDashboardTheme(theme: DashboardTheme): void {
   if (typeof document === "undefined") return;
 
@@ -45,16 +36,10 @@ export function applyDashboardTheme(theme: DashboardTheme): void {
   });
 }
 
-/**
- * Get theme preset by name
- */
 export function getDashboardThemePreset(name: string): DashboardThemePreset | undefined {
   return DASHBOARD_THEME_PRESETS.find((preset) => preset.name === name);
 }
 
-/**
- * Merge custom theme with default theme
- */
 export function mergeDashboardTheme(
   customTheme: Partial<DashboardTheme>,
   dark = false

package/src/domains/layouts/types/index.ts

@@ -1,7 +1,3 @@
-/**
- * Layout Types Export
- */
-
 export type { SidebarItem, SidebarGroup } from './sidebar';
 export type { DashboardHeaderProps, DashboardSidebarProps, DashboardLayoutConfig, HeaderProfileItem } from './layout';
 export type { DashboardTheme, DashboardThemePreset } from './theme';

package/src/domains/layouts/types/layout.ts

@@ -1,67 +1,29 @@
-/**
- * Dashboard Types - Layout
- *
- * Type definitions for layout components
- */
-
-/**
- * Dashboard header props
- */
 export 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;
-  /** Current resolved theme; defaults to "light" rendering when omitted */
-  theme?: "light" | "dark";
-  /** Theme toggle handler — the toggle button is hidden when omitted */
-  onToggleTheme?: () => void;
+    collapsed: boolean;
+    setCollapsed: (collapsed: boolean) => void;
+    setMobileOpen: (open: boolean) => void;
+    title: string;
+    theme?: "light" | "dark";
+    onToggleTheme?: () => void;
 }
 
-/**
- * Host-injected profile-menu entry — the extension seam for pages the
- * skeleton does not own (billing, referrals, anything). Rendered above
- * Settings; `to` navigates, `onSelect` runs, both close the menu.
- */
 export interface HeaderProfileItem {
-  /** Stable key for list rendering */
-  key: string;
-  /** Display label (already translated by the host) */
-  label: string;
-  /** Optional icon node — bring your own sizing (`udb-menu__item-icon`) */
-  icon?: React.ReactNode;
-  /** Route to navigate to */
-  to?: string;
-  /** Click handler (runs after navigation when both are set) */
-  onSelect?: () => void;
+    key: string;
+    label: string;
+    icon?: React.ReactNode;
+    to?: string;
+    onSelect?: () => void;
 }
 
-/**
- * Dashboard sidebar props
- */
 export interface DashboardSidebarProps {
-  /** Whether sidebar is collapsed */
-  collapsed: boolean;
-  /** Toggle sidebar collapsed state */
-  setCollapsed: (collapsed: boolean) => void;
+    collapsed: boolean;
+    setCollapsed: (collapsed: boolean) => void;
 }
 
-/**
- * Dashboard layout configuration
- */
 export interface DashboardLayoutConfig {
-  /** Sidebar groups */
-  sidebarGroups: import('./sidebar').SidebarGroup[];
-  /** Extra title mappings for routes — values may be i18n keys or literal strings */
-  extraTitleMap?: Record<string, string>;
-  /** Title used when no sidebar item or extra mapping matches the route (default: "Dashboard") */
-  defaultTitle?: string;
-  /** Brand name */
-  brandName?: string;
-  /** Brand tagline */
-  brandTagline?: string;
+    sidebarGroups: import('./sidebar').SidebarGroup[];
+    extraTitleMap?: Record<string, string>;
+    defaultTitle?: string;
+    brandName?: string;
+    brandTagline?: string;
 }

package/src/domains/layouts/types/notification.ts

@@ -1,19 +1,6 @@
-/**
- * Dashboard Types - Notification
- *
- * Type definitions for notification system
- */
-
-/**
- * Notification item
- */
 export interface DashboardNotification {
-  /** Unique ID */
-  id: string;
-  /** Notification text */
-  text: string;
-  /** Whether notification is read */
-  read: boolean;
-  /** Creation timestamp */
-  createdAt: Date | string | number;
+    id: string;
+    text: string;
+    read: boolean;
+    createdAt: Date | string | number;
 }

package/src/domains/layouts/types/sidebar.ts

@@ -1,35 +1,15 @@
-/**
- * Dashboard Types - Sidebar
- *
- * Type definitions for sidebar components
- */
-
 import type { LucideIcon } from "lucide-react";
 
-/**
- * Single sidebar menu item
- */
 export 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;
+    label: string;
+    icon: LucideIcon;
+    path: string;
+    requiredApp?: 'mobile' | 'web';
+    enabled?: boolean;
 }
 
-/**
- * Group of sidebar items with a title
- */
 export 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>;
+    title: string;
+    items: SidebarItem[];
+    titleMap?: Record<string, string>;
 }

package/src/domains/layouts/types/theme.ts

@@ -1,64 +1,28 @@
-/**
- * Dashboard Types - Theme
- *
- * Type definitions for theme system
- */
-
-/**
- * Dashboard theme configuration
- * Extends CSS variables for customization
- */
 export 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;
+    primary?: string;
+    secondary?: string;
+    sidebarBackground?: string;
+    sidebarForeground?: string;
+    sidebarBorder?: string;
+    headerBackground?: string;
+    background?: string;
+    foreground?: string;
+    border?: string;
+    accent?: string;
+    accentForeground?: string;
+    destructive?: string;
+    destructiveForeground?: string;
+    muted?: string;
+    mutedForeground?: string;
+    card?: string;
+    cardForeground?: string;
+    popover?: string;
+    popoverForeground?: string;
+    radius?: string;
 }
 
-/**
- * Theme preset for quick setup
- */
 export interface DashboardThemePreset {
-  /** Preset name */
-  name: string;
-  /** Theme configuration */
-  theme: DashboardTheme;
-  /** Whether this is a dark theme */
-  dark?: boolean;
+    name: string;
+    theme: DashboardTheme;
+    dark?: boolean;
 }