nv-log-bw 1.0.0

package/com.sh

@@ -0,0 +1,3 @@
+nv_cli_build -m -g nvlogbw -i ./index.js -o ./DIST/nv-log-bw.js
+cd ./TOOL
+node cli-creat-html.js

package/index.d.ts

@@ -0,0 +1,489 @@
+// Type definitions for nv-log-viewer
+// Project: nv-log-viewer
+// Definitions by: nv-log-viewer
+
+export as namespace NvLogViewer;
+
+export interface LogEntry {
+    /** 日志时间戳 */
+    time: number;
+    /** 日志类型 */
+    type: 'info' | 'success' | 'warning' | 'error' | 'ignore';
+    /** 日志消息 */
+    message: string;
+}
+
+export interface LogStats {
+    /** 总日志数量 */
+    total: number;
+    /** 信息日志数量 */
+    info: number;
+    /** 成功日志数量 */
+    success: number;
+    /** 警告日志数量 */
+    warning: number;
+    /** 错误日志数量 */
+    error: number;
+    /** 忽略日志数量 */
+    ignore: number;
+}
+
+export interface ImportResult {
+    /** 是否成功 */
+    success: boolean;
+    /** 导入的日志数量 */
+    count: number;
+    /** 导入的格式 */
+    format: 'json' | 'json-with-metadata' | 'text' | 'unknown';
+}
+
+export interface ExportData {
+    /** 导出时间 */
+    exportTime: string;
+    /** 总日志数量 */
+    totalLogs: number;
+    /** 日志数组 */
+    logs: LogEntry[];
+}
+
+export interface LogFilterOptions {
+    /** 是否显示信息日志 */
+    info?: boolean;
+    /** 是否显示成功日志 */
+    success?: boolean;
+    /** 是否显示警告日志 */
+    warning?: boolean;
+    /** 是否显示错误日志 */
+    error?: boolean;
+    /** 是否显示忽略日志 */
+    ignore?: boolean;
+}
+
+export interface LogViewerConfig {
+    /** 最大日志数量，默认 100 */
+    maxLogs?: number;
+    /** 主题，'dark' 或 'light'，默认 'dark' */
+    theme?: 'dark' | 'light';
+    /** 是否显示时间，默认 true */
+    showTime?: boolean;
+    /** 时间格式，可选：'HH:mm:ss' | 'HH:mm:ss.ms' | 'relative' | 完整格式，默认 'HH:mm:ss' */
+    timeFormat?: 'HH:mm:ss' | 'HH:mm:ss.ms' | 'relative' | string;
+    /** 是否自动滚动到底部，默认 true */
+    autoScroll?: boolean;
+    /** 是否显示统计信息，默认 true */
+    showStats?: boolean;
+    /** 是否隐藏浮动按钮，默认 false */
+    hideButton?: boolean;
+    /** 是否自动销毁组件，默认 false */
+    autoDestroy?: boolean;
+    /** 是否可拖拽，默认 true */
+    draggable?: boolean;
+}
+
+export interface LogAddEventDetail {
+    /** 添加的日志条目 */
+    log: LogEntry;
+    /** 总日志数量 */
+    total: number;
+    /** 统计信息 */
+    stats: LogStats;
+}
+
+export interface LogClearEventDetail {
+    /** 清除的日志数量 */
+    clearedCount: number;
+}
+
+export interface LogImportEventDetail {
+    /** 导入的日志数量 */
+    count: number;
+    /** 导入的格式 */
+    format: 'json' | 'json-with-metadata' | 'text' | 'unknown';
+    /** 导入的日志数组 */
+    logs: LogEntry[];
+}
+
+export interface LogToggleEventDetail {
+    /** 日志是否可见 */
+    visible: boolean;
+}
+
+/**
+ * 日志查看器自定义元素
+ * 
+ * @example
+ * ```html
+ * <nv-log-viewer></nv-log-viewer>
+ * 
+ * <script>
+ * const viewer = document.querySelector('nv-log-viewer');
+ * viewer.addLog('这是一条信息日志', 'info');
+ * viewer.addLog('这是一条成功日志', 'success');
+ * viewer.addLog('这是一条警告日志', 'warning');
+ * viewer.addLog('这是一条错误日志', 'error');
+ * </script>
+ * ```
+ * 
+ * @example
+ * ```javascript
+ * // 以编程方式创建
+ * const viewer = document.createElement('nv-log-viewer');
+ * viewer.setAttribute('theme', 'light');
+ * viewer.setAttribute('max-logs', '1000');
+ * document.body.appendChild(viewer);
+ * ```
+ */
+declare class NvLogViewer extends HTMLElement {
+    /**
+     * 创建日志查看器实例
+     */
+    constructor();
+
+    /**
+     * 添加日志条目
+     * 
+     * @param message 日志消息或日志对象
+     * @param type 日志类型，默认 'info'
+     * @param timestamp 时间戳，默认当前时间
+     * 
+     * @example
+     * ```javascript
+     * // 添加简单日志
+     * viewer.addLog('任务开始执行');
+     * viewer.addLog('任务执行成功', 'success');
+     * 
+     * // 添加对象日志
+     * viewer.addLog({
+     *     message: '任务完成',
+     *     type: 'success',
+     *     time: Date.now()
+     * });
+     * 
+     * // 添加带时间戳的日志
+     * viewer.addLog('定时日志', 'info', Date.now() - 3600000);
+     * ```
+     */
+    addLog(message: string | object, type?: 'info' | 'success' | 'warning' | 'error' | 'ignore', timestamp?: number): void;
+
+    /**
+     * 清空所有日志
+     * 
+     * @example
+     * ```javascript
+     * viewer.clearLogs();
+     * ```
+     */
+    clearLogs(): void;
+
+    /**
+     * 切换日志显示/隐藏
+     * 
+     * @example
+     * ```javascript
+     * viewer.toggleVisibility();
+     * ```
+     */
+    toggleVisibility(): void;
+
+    /**
+     * 打开日志查看器窗口
+     * 
+     * @example
+     * ```javascript
+     * viewer.open();
+     * ```
+     */
+    open(): void;
+
+    /**
+     * 关闭日志查看器窗口
+     * 
+     * @example
+     * ```javascript
+     * viewer.close();
+     * ```
+     */
+    clos(): void;
+
+    /**
+     * 导出日志到文件
+     * 
+     * @param format 导出格式，'json' 或 'text'，默认 'json'
+     * 
+     * @example
+     * ```javascript
+     * // 导出为 JSON
+     * viewer.exportLogs('json');
+     * 
+     * // 导出为文本
+     * viewer.exportLogs('text');
+     * ```
+     */
+    exportLogs(format?: 'json' | 'text'): void;
+
+    /**
+     * 从内容导入日志
+     * 
+     * @param content 日志内容
+     * @param format 日志格式，'auto' | 'json' | 'text'，默认 'auto'
+     * @returns 导入结果
+     * 
+     * @example
+     * ```javascript
+     * // 导入 JSON
+     * const jsonContent = JSON.stringify([
+     *     { time: Date.now(), type: 'info', message: '日志1' },
+     *     { time: Date.now(), type: 'error', message: '日志2' }
+     * ]);
+     * viewer.importLogs(jsonContent, 'json');
+     * 
+     * // 导入文本
+     * const textContent = `[2024-01-01 12:00:00] [INFO] 日志1
+     * [2024-01-01 12:00:01] [ERROR] 日志2`;
+     * viewer.importLogs(textContent, 'text');
+     * 
+     * // 自动检测格式
+     * viewer.importLogs(someContent);
+     * ```
+     */
+    importLogs(content: string, format?: 'auto' | 'json' | 'text'): Promise<ImportResult>;
+
+    /**
+     * 复制所有日志到剪贴板
+     * 
+     * @example
+     * ```javascript
+     * viewer.copyLogs();
+     * ```
+     */
+    copyLogs(): Promise<void>;
+
+    /**
+     * 获取所有日志
+     * 
+     * @returns 日志数组
+     * 
+     * @example
+     * ```javascript
+     * const logs = viewer.getLogs();
+     * console.log('当前日志数量:', logs.length);
+     * ```
+     */
+    getLogs(): LogEntry[];
+
+    /**
+     * 获取过滤后的日志
+     * 
+     * @param types 日志类型或类型数组
+     * @returns 过滤后的日志数组
+     * 
+     * @example
+     * ```javascript
+     * // 获取所有错误日志
+     * const errors = viewer.getLogsByType('error');
+     * 
+     * // 获取错误和警告日志
+     * const errorsAndWarnings = viewer.getLogsByType(['error', 'warning']);
+     * ```
+     */
+    getLogsByType(types: string | string[]): LogEntry[];
+
+    /**
+     * 设置最大日志数量
+     * 
+     * @param max 最大数量
+     * 
+     * @example
+     * ```javascript
+     * // 设置最大保存 1000 条日志
+     * viewer.setMaxLogs(1000);
+     * ```
+     */
+    setMaxLogs(max: number): void;
+
+    /**
+     * 设置主题
+     * 
+     * @param theme 主题，'dark' 或 'light'
+     * 
+     * @example
+     * ```javascript
+     * // 设置为亮色主题
+     * viewer.setTheme('light');
+     * 
+     * // 设置为暗色主题
+     * viewer.setTheme('dark');
+     * ```
+     */
+    setTheme(theme: 'dark' | 'light'): void;
+
+    /**
+     * 设置是否显示时间
+     * 
+     * @param show 是否显示
+     * 
+     * @example
+     * ```javascript
+     * // 显示时间
+     * viewer.setShowTime(true);
+     * 
+     * // 隐藏时间
+     * viewer.setShowTime(false);
+     * ```
+     */
+    setShowTime(show: boolean): void;
+
+    /**
+     * 设置时间格式
+     * 
+     * @param format 时间格式字符串
+     * 
+     * @example
+     * ```javascript
+     * // 设置只显示时间
+     * viewer.setTimeFormat('HH:mm:ss');
+     * 
+     * // 设置带毫秒的时间
+     * viewer.setTimeFormat('HH:mm:ss.ms');
+     * 
+     * // 设置相对时间
+     * viewer.setTimeFormat('relative');
+     * 
+     * // 设置完整时间
+     * viewer.setTimeFormat('YYYY-MM-DD HH:mm:ss');
+     * ```
+     */
+    setTimeFormat(format: string): void;
+
+    /**
+     * 设置是否自动滚动
+     * 
+     * @param autoScroll 是否自动滚动
+     * 
+     * @example
+     * ```javascript
+     * // 启用自动滚动
+     * viewer.setAutoScroll(true);
+     * 
+     * // 禁用自动滚动
+     * viewer.setAutoScroll(false);
+     * ```
+     */
+    setAutoScroll(autoScroll: boolean): void;
+
+    /**
+     * 设置是否显示统计信息
+     * 
+     * @param show 是否显示
+     * 
+     * @example
+     * ```javascript
+     * // 显示统计
+     * viewer.setShowStats(true);
+     * 
+     * // 隐藏统计
+     * viewer.setShowStats(false);
+     * ```
+     */
+    setShowStats(show: boolean): void;
+
+    /**
+     * 设置是否隐藏浮动按钮
+     * 
+     * @param hide 是否隐藏
+     * 
+     * @example
+     * ```javascript
+     * // 隐藏浮动按钮
+     * viewer.setHideButton(true);
+     * 
+     * // 显示浮动按钮
+     * viewer.setHideButton(false);
+     * ```
+     */
+    setHideButton(hide: boolean): void;
+
+    /**
+     * 设置是否自动销毁
+     * 
+     * @param autoDestroy 是否自动销毁
+     * 
+     * @example
+     * ```javascript
+     * // 启用自动销毁
+     * viewer.setAutoDestroy(true);
+     * 
+     * // 禁用自动销毁
+     * viewer.setAutoDestroy(false);
+     * ```
+     */
+    setAutoDestroy(autoDestroy: boolean): void;
+
+    /**
+     * 设置是否启用拖拽
+     * 
+     * @param draggable 是否启用
+     * 
+     * @example
+     * ```javascript
+     * // 启用拖拽
+     * viewer.setDraggable(true);
+     * 
+     * // 禁用拖拽
+     * viewer.setDraggable(false);
+     * ```
+     */
+    setDraggable(draggable: boolean): void;
+
+    // 事件处理
+    addEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+    addEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+    removeEventListener<K extends keyof HTMLElementEventMap>(type: K, listener: (this: HTMLElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+    removeEventListener(type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+}
+
+/**
+ * 日志添加事件
+ */
+export interface LogAddEvent extends CustomEvent<LogAddEventDetail> {
+    type: 'nv-log-add';
+}
+
+/**
+ * 日志清除事件
+ */
+export interface LogClearEvent extends CustomEvent<LogClearEventDetail> {
+    type: 'nv-log-clear';
+}
+
+/**
+ * 日志导入事件
+ */
+export interface LogImportEvent extends CustomEvent<LogImportEventDetail> {
+    type: 'nv-log-import';
+}
+
+/**
+ * 日志显示切换事件
+ */
+export interface LogToggleEvent extends CustomEvent<LogToggleEventDetail> {
+    type: 'nv-log-toggle';
+}
+
+/**
+ * 日志查看器事件映射
+ */
+export interface NvLogViewerEventMap extends HTMLElementEventMap {
+    'nv-log-add': LogAddEvent;
+    'nv-log-clear': LogClearEvent;
+    'nv-log-import': LogImportEvent;
+    'nv-log-toggle': LogToggleEvent;
+}
+
+declare global {
+    interface HTMLElementTagNameMap {
+        'nv-log-viewer': NvLogViewer;
+    }
+
+    interface HTMLElementEventMap extends NvLogViewerEventMap {}
+}