react-native-fxview 1.0.2 → 1.0.3-beta2

package/logger/FXLogger.ts

@@ -0,0 +1,282 @@
+/* eslint-disable @typescript-eslint/no-explicit-any */
+// ========== Logger 类型定义 ==========
+
+/**
+ * 日志级别枚举
+ */
+export enum FXLogLevel {
+  DEBUG = 0, // 调试级别（最详细）
+  INFO = 1, // 信息级别
+  WARN = 2, // 警告级别
+  ERROR = 3, // 错误级别
+  SILENT = 4, // 静默模式（不输出任何日志）
+}
+
+/**
+ * Logger 配置接口
+ */
+export interface FXLoggerConfig {
+  debug: boolean; // 是否启用调试模式
+  level: FXLogLevel; // 日志级别
+  showTimestamp: boolean; // 是否显示时间戳
+  prefix: string; // 日志前缀
+}
+
+/**
+ * FX Logger - 专为 React Native 项目设计的调试日志系统
+ * 提供丰富的日志功能和灵活的配置选项
+ */
+export class FXLogger {
+  private static instance: FXLogger;
+  private config: FXLoggerConfig;
+
+  /**
+   * 私有构造函数，实现单例模式
+   */
+  private constructor() {
+    // 自动检测环境
+    const isDevelopment = this.isDevelopmentEnvironment();
+
+    // 根据环境设置默认配置
+    this.config = {
+      debug: isDevelopment, // 开发环境启用调试模式，生产环境禁用
+      level: isDevelopment ? FXLogLevel.DEBUG : FXLogLevel.ERROR, // 生产环境只显示错误日志
+      showTimestamp: true,
+      prefix: isDevelopment ? "[FX-DEV]" : "[FX-PROD]", // 不同环境使用不同前缀
+    };
+  }
+
+  /**
+   * 获取单例实例
+   */
+  public static getInstance(): FXLogger {
+    if (!FXLogger.instance) {
+      FXLogger.instance = new FXLogger();
+    }
+    return FXLogger.instance;
+  }
+
+  /**
+   * 检测当前是否为开发环境
+   */
+  private isDevelopmentEnvironment(): boolean {
+    try {
+      // 使用 Function 构造函数来安全地访问全局变量，避免 TypeScript 错误
+      const getGlobal = new Function("return this")();
+
+      // 检测 React Native 的 __DEV__ 变量
+      if (typeof getGlobal.__DEV__ !== "undefined" && getGlobal.__DEV__) {
+        return true;
+      }
+
+      // 检测 Node.js 环境变量
+      if (
+        typeof getGlobal.process !== "undefined" &&
+        getGlobal.process.env &&
+        getGlobal.process.env.NODE_ENV === "development"
+      ) {
+        return true;
+      }
+
+      // 检测 window 对象（浏览器环境）
+      if (typeof getGlobal.window !== "undefined" && getGlobal.window.__DEV__) {
+        return true;
+      }
+
+      // 检测全局对象属性
+      if (getGlobal.NODE_ENV === "development") {
+        return true;
+      }
+    } catch (error) {
+      // 如果检测过程中出错，默认返回 false（生产环境）
+      this.error("Environment detection failed", error);
+    }
+
+    // 默认返回 false（生产环境）
+    return false;
+  }
+
+  /**
+   * 获取当前配置
+   */
+  public getConfig(): FXLoggerConfig {
+    return { ...this.config };
+  }
+
+  /**
+   * 配置 Logger
+   */
+  public configure(config: Partial<FXLoggerConfig>): void {
+    this.config = { ...this.config, ...config };
+  }
+
+  /**
+   * 启用调试模式
+   */
+  public enableDebug(): void {
+    this.config.debug = true;
+  }
+
+  /**
+   * 禁用调试模式
+   */
+  public disableDebug(): void {
+    this.config.debug = false;
+  }
+
+  /**
+   * 获取时间戳（包含年月日）
+   */
+  private getTimestamp(): string {
+    const now = new Date();
+    const year = now.getFullYear();
+    const month = (now.getMonth() + 1).toString().padStart(2, "0");
+    const day = now.getDate().toString().padStart(2, "0");
+    const hours = now.getHours().toString().padStart(2, "0");
+    const minutes = now.getMinutes().toString().padStart(2, "0");
+    const seconds = now.getSeconds().toString().padStart(2, "0");
+    const milliseconds = now.getMilliseconds().toString().padStart(3, "0");
+    return `${year}-${month}-${day} ${hours}:${minutes}:${seconds}.${milliseconds}`;
+  }
+
+  /**
+   * 检查是否应该记录日志
+   */
+  private shouldLog(level: FXLogLevel): boolean {
+    if (!this.config.debug && level < FXLogLevel.ERROR) {
+      return false;
+    }
+    return level >= this.config.level;
+  }
+
+  /**
+   * 获取日志级别的颜色符号
+   */
+  private getLevelColor(level: FXLogLevel): string {
+    switch (level) {
+      case FXLogLevel.DEBUG:
+        return "🔵"; // 蓝色 - 调试
+      case FXLogLevel.INFO:
+        return "🟢"; // 绿色 - 信息
+      case FXLogLevel.WARN:
+        return "🟡"; // 黄色 - 警告
+      case FXLogLevel.ERROR:
+        return "🔴"; // 红色 - 错误
+      default:
+        return "⚪"; // 默认白色
+    }
+  }
+
+  /**
+   * 格式化日志消息
+   */
+  private formatMessage(level: string, message: string): string {
+    const parts: string[] = [];
+
+    if (this.config.prefix) {
+      parts.push(this.config.prefix);
+    }
+
+    if (this.config.showTimestamp) {
+      parts.push(`[${this.getTimestamp()}]`);
+    }
+
+    // 根据日志级别添加颜色符号
+    const levelEnum =
+      FXLogLevel[level.toUpperCase() as keyof typeof FXLogLevel];
+    const colorSymbol = this.getLevelColor(levelEnum);
+    parts.push(`[${colorSymbol}${level.toUpperCase()}]`);
+
+    return parts.join("") + " " + message;
+  }
+
+  /**
+   * 调试日志
+   */
+  log(message?: any, ...optionalParams: any[]): void {
+    if (!this.shouldLog(FXLogLevel.DEBUG)) return;
+
+    const formattedMessage = this.formatMessage("debug", message);
+    console.log(formattedMessage, ...optionalParams);
+  }
+
+  /**
+   * 信息日志
+   */
+  info(message?: any, ...optionalParams: any[]): void {
+    if (!this.shouldLog(FXLogLevel.INFO)) return;
+
+    const formattedMessage = this.formatMessage("info", message);
+    console.info(formattedMessage, ...optionalParams);
+  }
+
+  /**
+   * 警告日志
+   */
+  warn(message?: any, ...optionalParams: any[]): void {
+    if (!this.shouldLog(FXLogLevel.WARN)) return;
+
+    const formattedMessage = this.formatMessage("warn", message);
+    console.warn(formattedMessage, ...optionalParams);
+  }
+
+  /**
+   * 错误日志
+   */
+  error(message?: any, ...optionalParams: any[]): void {
+    if (!this.shouldLog(FXLogLevel.ERROR)) return;
+
+    const formattedMessage = this.formatMessage("error", message);
+    console.error(formattedMessage, ...optionalParams);
+  }
+
+  /**
+   * 追踪日志
+   */
+  trace(message?: any, ...optionalParams: any[]): void {
+    if (!this.shouldLog(FXLogLevel.DEBUG)) return;
+
+    const formattedMessage = this.formatMessage("trace", message);
+    console.trace(formattedMessage, ...optionalParams);
+  }
+
+  /**
+   * 表格日志
+   */
+  table(...data: any[]): void {
+    if (!this.shouldLog(FXLogLevel.DEBUG)) return;
+
+    console.table(...data);
+  }
+
+  /**
+   * 分组日志
+   */
+  group(label?: string): void {
+    if (!this.shouldLog(FXLogLevel.DEBUG)) return;
+
+    console.group(label);
+  }
+
+  /**
+   * 结束分组日志
+   */
+  groupEnd(): void {
+    console.groupEnd();
+  }
+
+  /**
+   * 折叠分组日志
+   */
+  groupCollapsed(label?: string): void {
+    if (!this.shouldLog(FXLogLevel.DEBUG)) return;
+
+    console.groupCollapsed(label);
+  }
+}
+
+// 创建全局实例
+const logger = FXLogger.getInstance();
+
+// 导出默认实例
+export default logger;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-fxview",
-  "version": "1.0.2",
+  "version": "1.0.3-beta2",
   "description": "A dynamic view component for React Native that allows runtime UI updates and component management",
   "main": "index.ts",
   "types": "index.d.ts",
@@ -8,6 +8,14 @@
     "*.js",
     "*.ts",
     "*.tsx",
+    "*.d.ts",
+    "queue/**/*.js",
+    "queue/**/*.ts",
+    "queue/**/*.d.ts",
+    "logger/**/*.js",
+    "logger/**/*.ts",
+    "logger/**/*.d.ts",
+    "logger/**/*.md",
     "README.md",
     "LICENSE"
   ],

package/queue/PriorityQueue.d.ts

@@ -0,0 +1,153 @@
+/**
+ * 通用的优先级队列 - 支持泛型存储，可切换大顶堆/小顶堆模式
+ * 支持优先级相同时的排序策略：先入先出(FIFO)或后入先出(LIFO)
+ */
+export declare enum HeapType {
+    MAX_HEAP = "max",// 大顶堆：优先级高的在前
+    MIN_HEAP = "min"
+}
+export declare enum PriorityOrder {
+    FIFO = "fifo",// 先入先出：优先级相同时，先入队的在前
+    LIFO = "lifo"
+}
+export declare class PriorityQueue<T> {
+    private items;
+    private heapType;
+    private priorityOrder;
+    constructor(heapType?: HeapType, priorityOrder?: PriorityOrder);
+    /**
+     * 设置堆类型（可选参数）
+     */
+    setHeapType(heapType?: HeapType): void;
+    /**
+     * 获取当前堆类型
+     */
+    getHeapType(): HeapType;
+    /**
+     * 设置优先级相同时的排序策略（可选参数）
+     */
+    setPriorityOrder(order?: PriorityOrder): void;
+    /**
+     * 获取当前优先级相同时的排序策略
+     */
+    getPriorityOrder(): PriorityOrder;
+    /**
+     * 入队 - 按当前堆类型和排序策略排序
+     */
+    enqueue(item: T, priority?: number, timestamp?: number): void;
+    /**
+     * 批量入队（可选参数）
+     */
+    enqueueMultiple(items: T[], priority?: number): void;
+    /**
+     * 出队 - 返回队首元素（最高或最低优先级）
+     */
+    dequeue(): T | null;
+    /**
+     * 批量出队（可选参数）
+     */
+    dequeueMultiple(count?: number): T[];
+    /**
+     * 查看队首元素（不移除）
+     */
+    peek(): T | null;
+    /**
+     * 查看队首元素的优先级
+     */
+    peekPriority(): number | null;
+    /**
+     * 查看前N个元素（可选参数）
+     */
+    peekMultiple(count?: number): T[];
+    /**
+     * 队列是否为空
+     */
+    isEmpty(): boolean;
+    /**
+     * 队列大小
+     */
+    size(): number;
+    /**
+     * 清空队列
+     */
+    clear(): void;
+    /**
+     * 获取所有元素（按当前堆类型排序）
+     */
+    getAll(): T[];
+    /**
+     * 获取所有元素及其优先级
+     */
+    getAllWithPriority(): Array<{
+        item: T;
+        priority: number;
+    }>;
+    /**
+     * 获取所有元素及其详细信息
+     */
+    getAllWithDetails(): Array<{
+        item: T;
+        priority: number;
+        timestamp: number;
+    }>;
+    /**
+     * 获取指定索引的元素（可选参数）
+     */
+    getAt(index?: number): T | null;
+    /**
+     * 获取指定范��的元素（可选参数）
+     */
+    getRange(start?: number, end?: number): T[];
+    /**
+     * 移除指定元素
+     */
+    remove(item: T): boolean;
+    /**
+     * 移除指定索引的元素（可选参数）
+     */
+    removeAt(index?: number): T | null;
+    /**
+     * 更新元素的优先级
+     */
+    updatePriority(item: T, newPriority?: number): boolean;
+    /**
+     * 查找指定元素
+     */
+    find(predicate: (item: T) => boolean): T | null;
+    /**
+     * 查找所有符合条件的元素
+     */
+    findAll(predicate: (item: T) => boolean): T[];
+    /**
+     * 过滤元素
+     */
+    filter(predicate: (item: T) => boolean): T[];
+    /**
+     * 遍历元素
+     */
+    forEach(callback: (item: T, priority: number, index: number) => void): void;
+    /**
+     * 映射元素
+     */
+    map<U>(callback: (item: T, priority: number, index: number) => U): U[];
+    /**
+     * 判断是否应该插入到指定元素之前
+     */
+    private shouldInsertBefore;
+    /**
+     * 重新排序所有元素
+     */
+    private resort;
+    /**
+     * 转换为数组
+     */
+    toArray(): T[];
+    /**
+     * 转换为JSON字符串
+     */
+    toJSON(): string;
+    /**
+     * 克隆队列
+     */
+    clone(): PriorityQueue<T>;
+}