@djangocfg/ui-core 2.1.89 → 2.1.91

package/src/lib/logger/logStore.ts

@@ -0,0 +1,122 @@
+/**
+ * Log Store
+ *
+ * Zustand store for log accumulation and filtering.
+ * Keeps logs in memory for Console panel display.
+ */
+
+'use client';
+
+import { create } from 'zustand';
+import type { LogStore, LogEntry, LogFilter } from './types';
+
+const DEFAULT_FILTER: LogFilter = {
+  levels: ['debug', 'info', 'warn', 'error', 'success'],
+  component: undefined,
+  search: undefined,
+  since: undefined,
+};
+
+const MAX_LOGS = 1000;
+
+function generateId(): string {
+  return `log-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+}
+
+function matchesFilter(entry: LogEntry, filter: LogFilter): boolean {
+  // Level filter
+  if (!filter.levels.includes(entry.level)) {
+    return false;
+  }
+
+  // Component filter (case-insensitive partial match)
+  if (filter.component) {
+    const comp = filter.component.toLowerCase();
+    if (!entry.component.toLowerCase().includes(comp)) {
+      return false;
+    }
+  }
+
+  // Search filter (case-insensitive, searches message and data)
+  if (filter.search) {
+    const search = filter.search.toLowerCase();
+    const inMessage = entry.message.toLowerCase().includes(search);
+    const inData = entry.data
+      ? JSON.stringify(entry.data).toLowerCase().includes(search)
+      : false;
+    if (!inMessage && !inData) {
+      return false;
+    }
+  }
+
+  // Time filter
+  if (filter.since && entry.timestamp < filter.since) {
+    return false;
+  }
+
+  return true;
+}
+
+export const useLogStore = create<LogStore>((set, get) => ({
+  logs: [],
+  filter: DEFAULT_FILTER,
+  maxLogs: MAX_LOGS,
+
+  addLog: (entry) => {
+    const newEntry: LogEntry = {
+      ...entry,
+      id: generateId(),
+      timestamp: new Date(),
+    };
+
+    set((state) => {
+      const newLogs = [...state.logs, newEntry];
+      // Trim to max size
+      if (newLogs.length > state.maxLogs) {
+        return { logs: newLogs.slice(-state.maxLogs) };
+      }
+      return { logs: newLogs };
+    });
+  },
+
+  clearLogs: () => {
+    set({ logs: [] });
+  },
+
+  setFilter: (filter) => {
+    set((state) => ({
+      filter: { ...state.filter, ...filter },
+    }));
+  },
+
+  resetFilter: () => {
+    set({ filter: DEFAULT_FILTER });
+  },
+
+  getFilteredLogs: () => {
+    const { logs, filter } = get();
+    return logs.filter((entry) => matchesFilter(entry, filter));
+  },
+
+  exportLogs: () => {
+    const { logs } = get();
+    return JSON.stringify(logs, null, 2);
+  },
+}));
+
+// Selector hooks for performance
+export const useFilteredLogs = () => {
+  const logs = useLogStore((state) => state.logs);
+  const filter = useLogStore((state) => state.filter);
+  return logs.filter((entry) => matchesFilter(entry, filter));
+};
+
+export const useLogCount = () => {
+  return useLogStore((state) => state.logs.length);
+};
+
+export const useErrorCount = () => {
+  return useLogStore((state) =>
+    state.logs.filter((log) => log.level === 'error').length
+  );
+};

package/src/lib/logger/logger.ts

@@ -0,0 +1,175 @@
+/**
+ * Logger
+ *
+ * Universal logger with consola + zustand store integration.
+ * Logs are accumulated for Console panel display.
+ * In production, only logs to store (no console output).
+ */
+
+'use client';
+
+import { consola, type ConsolaInstance } from 'consola';
+import { useLogStore } from './logStore';
+import type { Logger, LogLevel, MediaLogger } from './types';
+
+// Check environment
+const isDev = process.env.NODE_ENV !== 'production';
+const isBrowser = typeof window !== 'undefined';
+
+// Create base consola instance
+const baseConsola = consola.create({
+  level: isDev ? 4 : 2, // 4 = debug, 2 = warn
+});
+
+/**
+ * Extract error details from unknown error type
+ */
+function extractErrorData(data?: Record<string, unknown>): {
+  cleanData: Record<string, unknown> | undefined;
+  stack: string | undefined;
+} {
+  if (!data) return { cleanData: undefined, stack: undefined };
+
+  const cleanData = { ...data };
+  let stack: string | undefined;
+
+  // Extract stack from error object
+  if (data.error instanceof Error) {
+    stack = data.error.stack;
+    cleanData.error = {
+      name: data.error.name,
+      message: data.error.message,
+    };
+  } else if (typeof data.error === 'object' && data.error !== null) {
+    const errObj = data.error as Record<string, unknown>;
+    if (typeof errObj.stack === 'string') {
+      stack = errObj.stack;
+    }
+    if (typeof errObj.message === 'string') {
+      cleanData.error = errObj.message;
+    }
+  }
+
+  return { cleanData, stack };
+}
+
+/**
+ * Format buffer ranges for logging
+ */
+function formatBufferRanges(buffered: TimeRanges, duration: number): string {
+  if (buffered.length === 0) return 'empty';
+
+  const ranges: string[] = [];
+  for (let i = 0; i < buffered.length; i++) {
+    const start = buffered.start(i);
+    const end = buffered.end(i);
+    const percent = ((end - start) / duration * 100).toFixed(1);
+    ranges.push(`${start.toFixed(1)}-${end.toFixed(1)}s (${percent}%)`);
+  }
+  return ranges.join(', ');
+}
+
+/**
+ * Create a logger for a specific component/module
+ */
+export function createLogger(component: string): Logger {
+  const consolaTagged = baseConsola.withTag(component);
+
+  const log = (level: LogLevel, message: string, data?: Record<string, unknown>) => {
+    const { cleanData, stack } = extractErrorData(data);
+
+    // Add to store (for Console panel)
+    if (isBrowser) {
+      useLogStore.getState().addLog({
+        level,
+        component,
+        message,
+        data: cleanData,
+        stack,
+      });
+    }
+
+    // Log to console via consola (in dev mode)
+    if (isDev) {
+      const consolaMethod = level === 'success' ? 'success' : level;
+      if (cleanData) {
+        consolaTagged[consolaMethod](message, cleanData);
+      } else {
+        consolaTagged[consolaMethod](message);
+      }
+    }
+  };
+
+  return {
+    debug: (message, data) => log('debug', message, data),
+    info: (message, data) => log('info', message, data),
+    warn: (message, data) => log('warn', message, data),
+    error: (message, data) => log('error', message, data),
+    success: (message, data) => log('success', message, data),
+  };
+}
+
+/**
+ * Create a media-specific logger with helper methods
+ * for AudioPlayer, VideoPlayer, ImageViewer
+ */
+export function createMediaLogger(component: string): MediaLogger {
+  const baseLogger = createLogger(component);
+
+  return {
+    ...baseLogger,
+
+    load: (src: string, type?: string) => {
+      const typeStr = type ? ` (${type})` : '';
+      baseLogger.info(`LOAD: ${src}${typeStr}`);
+    },
+
+    state: (state: string, details?: Record<string, unknown>) => {
+      baseLogger.debug(`STATE: ${state}`, details);
+    },
+
+    seek: (from: number, to: number, duration: number) => {
+      baseLogger.debug(`SEEK: ${from.toFixed(2)}s -> ${to.toFixed(2)}s`, {
+        from,
+        to,
+        duration,
+        progress: `${((to / duration) * 100).toFixed(1)}%`,
+      });
+    },
+
+    buffer: (buffered: TimeRanges, duration: number) => {
+      if (buffered.length > 0) {
+        baseLogger.debug(`BUFFER: ${formatBufferRanges(buffered, duration)}`);
+      }
+    },
+
+    event: (name: string, data?: unknown) => {
+      if (data !== undefined) {
+        baseLogger.debug(`EVENT: ${name}`, { data });
+      } else {
+        baseLogger.debug(`EVENT: ${name}`);
+      }
+    },
+  };
+}
+
+/**
+ * Global logger for non-component code
+ */
+export const logger = createLogger('App');
+
+/**
+ * Quick access for one-off logs
+ */
+export const log = {
+  debug: (component: string, message: string, data?: Record<string, unknown>) =>
+    createLogger(component).debug(message, data),
+  info: (component: string, message: string, data?: Record<string, unknown>) =>
+    createLogger(component).info(message, data),
+  warn: (component: string, message: string, data?: Record<string, unknown>) =>
+    createLogger(component).warn(message, data),
+  error: (component: string, message: string, data?: Record<string, unknown>) =>
+    createLogger(component).error(message, data),
+  success: (component: string, message: string, data?: Record<string, unknown>) =>
+    createLogger(component).success(message, data),
+};

package/src/lib/logger/types.ts

@@ -0,0 +1,82 @@
+/**
+ * Logger Types
+ *
+ * Type definitions for the universal logging system.
+ * Compatible with Console panel in FileWorkspace IDE layout.
+ */
+
+export type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'success';
+
+export interface LogEntry {
+  /** Unique log ID */
+  id: string;
+  /** Timestamp when log was created */
+  timestamp: Date;
+  /** Log level */
+  level: LogLevel;
+  /** Component/module name that created the log */
+  component: string;
+  /** Log message */
+  message: string;
+  /** Additional data (objects, errors, etc.) */
+  data?: Record<string, unknown>;
+  /** Error stack trace (for error level) */
+  stack?: string;
+}
+
+export interface LogFilter {
+  /** Filter by log levels */
+  levels: LogLevel[];
+  /** Filter by component name (partial match) */
+  component?: string;
+  /** Filter by message text (partial match) */
+  search?: string;
+  /** Filter by time range */
+  since?: Date;
+}
+
+export interface LogStore {
+  /** All accumulated logs */
+  logs: LogEntry[];
+  /** Current filter settings */
+  filter: LogFilter;
+  /** Maximum logs to keep */
+  maxLogs: number;
+
+  /** Add new log entry */
+  addLog: (entry: Omit<LogEntry, 'id' | 'timestamp'>) => void;
+  /** Clear all logs */
+  clearLogs: () => void;
+  /** Update filter settings */
+  setFilter: (filter: Partial<LogFilter>) => void;
+  /** Reset filter to defaults */
+  resetFilter: () => void;
+  /** Get filtered logs */
+  getFilteredLogs: () => LogEntry[];
+  /** Export logs as JSON string */
+  exportLogs: () => string;
+}
+
+export interface Logger {
+  debug: (message: string, data?: Record<string, unknown>) => void;
+  info: (message: string, data?: Record<string, unknown>) => void;
+  warn: (message: string, data?: Record<string, unknown>) => void;
+  error: (message: string, data?: Record<string, unknown>) => void;
+  success: (message: string, data?: Record<string, unknown>) => void;
+}
+
+/**
+ * Media-specific log helper methods
+ */
+export interface MediaLogger extends Logger {
+  /** Log source load event */
+  load: (src: string, type?: string) => void;
+  /** Log state change */
+  state: (state: string, details?: Record<string, unknown>) => void;
+  /** Log seek event */
+  seek: (from: number, to: number, duration: number) => void;
+  /** Log buffer ranges */
+  buffer: (buffered: TimeRanges, duration: number) => void;
+  /** Log generic event */
+  event: (name: string, data?: unknown) => void;
+}

package/src/utils/LazyComponent.tsx

@@ -0,0 +1,116 @@
+/**
+ * LazyComponent - Universal lazy loading wrapper
+ *
+ * Provides consistent Suspense handling for lazy-loaded components
+ * Works in any React environment: Next.js, Vite, Wails, CRA
+ */
+
+'use client';
+
+import React, { Suspense, ReactNode, ComponentType, lazy } from 'react';
+
+// Default loading spinner
+export const DefaultLoader = () => (
+  <div className="flex items-center justify-center p-8">
+    <div className="flex flex-col items-center gap-2">
+      <div className="h-8 w-8 animate-spin rounded-full border-4 border-muted border-t-primary" />
+      <span className="text-sm text-muted-foreground">Loading...</span>
+    </div>
+  </div>
+);
+
+// Minimal loader for inline components
+export const InlineLoader = () => (
+  <span className="inline-flex items-center gap-1">
+    <span className="h-3 w-3 animate-spin rounded-full border-2 border-muted border-t-primary" />
+    <span className="text-xs text-muted-foreground">Loading...</span>
+  </span>
+);
+
+// Full-screen loader
+export const FullScreenLoader = () => (
+  <div className="flex items-center justify-center min-h-screen">
+    <div className="text-center">
+      <div className="inline-block h-8 w-8 animate-spin rounded-full border-4 border-solid border-current border-r-transparent" />
+      <p className="mt-4 text-sm text-muted-foreground">Loading...</p>
+    </div>
+  </div>
+);
+
+export interface LazyWrapperProps {
+  children: ReactNode;
+  fallback?: ReactNode;
+}
+
+/**
+ * Suspense wrapper with default fallback
+ */
+export function LazyWrapper({ children, fallback }: LazyWrapperProps) {
+  return (
+    <Suspense fallback={fallback ?? <DefaultLoader />}>
+      {children}
+    </Suspense>
+  );
+}
+
+/**
+ * Create a lazy-loaded component with Suspense wrapper built-in
+ *
+ * @example
+ * ```tsx
+ * const HeavyComponent = createLazyComponent(
+ *   () => import('./HeavyComponent'),
+ *   <CustomLoader />
+ * );
+ *
+ * // Usage - no need to wrap in Suspense
+ * <HeavyComponent someProps={value} />
+ * ```
+ */
+export function createLazyComponent<T extends ComponentType<any>>(
+  importFn: () => Promise<{ default: T }>,
+  fallback?: ReactNode
+) {
+  const LazyComponent = lazy(importFn);
+
+  return function WrappedLazyComponent(props: React.ComponentProps<T>) {
+    return (
+      <Suspense fallback={fallback ?? <DefaultLoader />}>
+        <LazyComponent {...props} />
+      </Suspense>
+    );
+  };
+}
+
+/**
+ * Create a lazy-loaded component from a named export
+ *
+ * @example
+ * ```tsx
+ * const NamedComponent = createLazyNamedComponent(
+ *   () => import('./module'),
+ *   'NamedExport',
+ *   <CustomLoader />
+ * );
+ * ```
+ */
+export function createLazyNamedComponent<
+  T extends Record<string, ComponentType<any>>,
+  K extends keyof T
+>(
+  importFn: () => Promise<T>,
+  exportName: K,
+  fallback?: ReactNode
+) {
+  const LazyComponent = lazy(() =>
+    importFn().then((mod) => ({ default: mod[exportName] }))
+  );
+
+  return function WrappedLazyComponent(props: React.ComponentProps<T[K]>) {
+    return (
+      <Suspense fallback={fallback ?? <DefaultLoader />}>
+        <LazyComponent {...props} />
+      </Suspense>
+    );
+  };
+}

package/src/utils/index.ts

@@ -0,0 +1,9 @@
+export {
+  LazyWrapper,
+  DefaultLoader,
+  InlineLoader,
+  FullScreenLoader,
+  createLazyComponent,
+  createLazyNamedComponent,
+} from './LazyComponent';
+export type { LazyWrapperProps } from './LazyComponent';

package/src/components/toast.tsx

@@ -1,144 +0,0 @@
-"use client"
-
-import { cva, type VariantProps } from 'class-variance-authority';
-import { X } from 'lucide-react';
-import * as React from 'react';
-
-import * as ToastPrimitives from '@radix-ui/react-toast';
-
-import { cn } from '../lib/utils';
-
-const ToastProvider = ToastPrimitives.Provider
-
-const ToastViewport = React.forwardRef<
-  React.ElementRef<typeof ToastPrimitives.Viewport>,
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Viewport>
->(({ className, ...props }, ref) => (
-  <ToastPrimitives.Viewport
-    ref={ref}
-    className={cn(
-      "fixed bottom-0 right-0 z-9999 flex max-h-screen w-full flex-col p-4 md:max-w-md",
-      className
-    )}
-    {...props}
-  />
-))
-ToastViewport.displayName = ToastPrimitives.Viewport.displayName
-
-const toastVariants = cva(
-  "group pointer-events-auto relative flex w-full items-center justify-between space-x-4 overflow-hidden rounded-md border p-6 pr-8 shadow-lg transition-all data-[swipe=cancel]:translate-x-0 data-[swipe=end]:translate-x-[var(--radix-toast-swipe-end-x)] data-[swipe=move]:translate-x-[var(--radix-toast-swipe-move-x)] data-[swipe=move]:transition-none data-[state=open]:animate-in data-[state=closed]:animate-out data-[swipe=end]:animate-out data-[state=closed]:fade-out-80 data-[state=closed]:slide-out-to-right-full data-[state=open]:slide-in-from-bottom-full",
-  {
-    variants: {
-      variant: {
-        default: "border bg-background text-foreground",
-        destructive:
-          "destructive group border-destructive bg-destructive text-destructive-foreground",
-        success:
-          "success group border-green-600 bg-green-500 text-white",
-        warning:
-          "warning group border-yellow-600 bg-yellow-500 text-black",
-        info:
-          "info group border-blue-600 bg-blue-500 text-white",
-      },
-    },
-    defaultVariants: {
-      variant: "default",
-    },
-  }
-)
-
-const Toast = React.forwardRef<
-  React.ElementRef<typeof ToastPrimitives.Root>,
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Root> &
-    VariantProps<typeof toastVariants>
->(({ className, variant, ...props }, ref) => {
-  return (
-    <ToastPrimitives.Root
-      ref={ref}
-      className={cn(toastVariants({ variant }), className)}
-      {...props}
-    />
-  )
-})
-Toast.displayName = ToastPrimitives.Root.displayName
-
-const ToastAction = React.forwardRef<
-  React.ElementRef<typeof ToastPrimitives.Action>,
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Action>
->(({ className, ...props }, ref) => (
-  <ToastPrimitives.Action
-    ref={ref}
-    className={cn(
-      "inline-flex h-8 shrink-0 items-center justify-center rounded-md border bg-transparent px-3 text-sm font-medium ring-offset-background transition-colors hover:bg-secondary focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2 disabled:pointer-events-none disabled:opacity-50",
-      "group-[.destructive]:border-muted/40 group-[.destructive]:hover:border-destructive/30 group-[.destructive]:hover:bg-destructive group-[.destructive]:hover:text-destructive-foreground group-[.destructive]:focus:ring-destructive",
-      "group-[.success]:border-green-300/40 group-[.success]:hover:bg-green-600 group-[.success]:hover:text-white group-[.success]:focus:ring-green-400",
-      "group-[.warning]:border-yellow-600/40 group-[.warning]:hover:bg-yellow-600 group-[.warning]:hover:text-black group-[.warning]:focus:ring-yellow-400",
-      "group-[.info]:border-blue-300/40 group-[.info]:hover:bg-blue-600 group-[.info]:hover:text-white group-[.info]:focus:ring-blue-400",
-      className
-    )}
-    {...props}
-  />
-))
-ToastAction.displayName = ToastPrimitives.Action.displayName
-
-const ToastClose = React.forwardRef<
-  React.ElementRef<typeof ToastPrimitives.Close>,
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Close>
->(({ className, ...props }, ref) => (
-  <ToastPrimitives.Close
-    ref={ref}
-    className={cn(
-      "absolute right-2 top-2 rounded-md p-1 text-foreground/50 opacity-0 transition-opacity hover:text-foreground focus:opacity-100 focus:outline-none focus:ring-2 group-hover:opacity-100",
-      "group-[.destructive]:text-red-300 group-[.destructive]:hover:text-red-50 group-[.destructive]:focus:ring-red-400 group-[.destructive]:focus:ring-offset-red-600",
-      "group-[.success]:text-green-100 group-[.success]:hover:text-white group-[.success]:focus:ring-green-300",
-      "group-[.warning]:text-yellow-800 group-[.warning]:hover:text-black group-[.warning]:focus:ring-yellow-600",
-      "group-[.info]:text-blue-100 group-[.info]:hover:text-white group-[.info]:focus:ring-blue-300",
-      className
-    )}
-    toast-close=""
-    {...props}
-  >
-    <X className="h-4 w-4" />
-  </ToastPrimitives.Close>
-))
-ToastClose.displayName = ToastPrimitives.Close.displayName
-
-const ToastTitle = React.forwardRef<
-  React.ElementRef<typeof ToastPrimitives.Title>,
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Title>
->(({ className, ...props }, ref) => (
-  <ToastPrimitives.Title
-    ref={ref}
-    className={cn("text-sm font-semibold", className)}
-    {...props}
-  />
-))
-ToastTitle.displayName = ToastPrimitives.Title.displayName
-
-const ToastDescription = React.forwardRef<
-  React.ElementRef<typeof ToastPrimitives.Description>,
-  React.ComponentPropsWithoutRef<typeof ToastPrimitives.Description>
->(({ className, ...props }, ref) => (
-  <ToastPrimitives.Description
-    ref={ref}
-    className={cn("text-sm opacity-90", className)}
-    {...props}
-  />
-))
-ToastDescription.displayName = ToastPrimitives.Description.displayName
-
-type ToastProps = React.ComponentPropsWithoutRef<typeof Toast>
-
-type ToastActionElement = React.ReactElement<typeof ToastAction>
-
-export {
-  type ToastProps,
-  type ToastActionElement,
-  ToastProvider,
-  ToastViewport,
-  Toast,
-  ToastTitle,
-  ToastDescription,
-  ToastClose,
-  ToastAction,
-}

package/src/components/toaster.tsx

@@ -1,41 +0,0 @@
-"use client"
-
-import { useEffect, useState } from 'react';
-
-import { useToast } from '../hooks/useToast';
-import {
-    Toast, ToastClose, ToastDescription, ToastProvider, ToastTitle, ToastViewport
-} from './toast';
-
-export function Toaster() {
-  const { toasts } = useToast()
-  const [isMounted, setIsMounted] = useState(false)
-
-  useEffect(() => {
-    setIsMounted(true)
-  }, [])
-
-  if (!isMounted) {
-    return null
-  }
-
-  return (
-    <ToastProvider>
-      {toasts.map(function ({ id, title, description, action, ...props }) {
-        return (
-          <Toast key={id} {...props}>
-            <div className="grid gap-1">
-              {title && <ToastTitle>{title}</ToastTitle>}
-              {description && (
-                <ToastDescription>{description}</ToastDescription>
-              )}
-            </div>
-            {action}
-            <ToastClose />
-          </Toast>
-        )
-      })}
-      <ToastViewport />
-    </ToastProvider>
-  )
-}