@lobehub/editor 1.5.2 → 1.5.3

package/es/plugins/math/react/index.js

@@ -35,7 +35,7 @@ export var ReactMathPlugin = function ReactMathPlugin(_ref) {
       },
       theme: theme || styles
     });
-  }, [editor]);
+  }, [editor, className, theme, styles]);
   return /*#__PURE__*/_jsx(MathEdit, {
     renderComp: renderComp
   });

package/es/plugins/mention/react/ReactMentionPlugin.js

@@ -35,7 +35,7 @@ var ReactMentionPlugin = function ReactMentionPlugin(_ref) {
       markdownWriter: markdownWriter,
       theme: theme || styles
     });
-  }, [editor]);
+  }, [editor, className, markdownWriter, theme, styles]);
   return null;
 };
 ReactMentionPlugin.displayName = 'ReactMentionPlugin';

package/es/plugins/slash/service/i-slash-service.d.ts

@@ -30,6 +30,7 @@ export declare class SlashService implements ISlashService {
     private triggerMap;
     private triggerFnMap;
     private triggerFuseMap;
+    private logger;
     constructor(kernel: IEditorKernel);
     registerSlash(options: SlashOptions): void;
     getSlashOptions(trigger: string): SlashOptions | undefined;

package/es/plugins/slash/service/i-slash-service.js

@@ -10,6 +10,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 
 import Fuse from 'fuse.js';
 import { genServiceId } from "../../../editor-kernel";
+import { createDebugLogger } from "../../../utils/debug";
 import { getBasicTypeaheadTriggerMatch } from "../utils/utils";
 export var ISlashService = genServiceId('SlashService');
 export var SlashService = /*#__PURE__*/function () {
@@ -18,6 +19,7 @@ export var SlashService = /*#__PURE__*/function () {
     _defineProperty(this, "triggerMap", new Map());
     _defineProperty(this, "triggerFnMap", new Map());
     _defineProperty(this, "triggerFuseMap", new Map());
+    _defineProperty(this, "logger", createDebugLogger('service', 'slash'));
     this.kernel = kernel;
   }
   // Specific service methods can be added here
@@ -26,7 +28,7 @@ export var SlashService = /*#__PURE__*/function () {
     value: function registerSlash(options) {
       if (this.triggerMap.has(options.trigger)) {
         if (this.kernel.isHotReloadMode()) {
-          console.warn("[Hot Reload] Overriding slash trigger \"".concat(options.trigger, "\""));
+          this.logger.warn("\uD83D\uDD04 Overriding slash trigger \"".concat(options.trigger, "\""));
         } else {
           throw new Error("Slash trigger \"".concat(options.trigger, "\" is already registered."));
         }
@@ -38,6 +40,7 @@ export var SlashService = /*#__PURE__*/function () {
         minLength: options.minLength,
         punctuation: options.punctuation
       }));
+      this.logger.debug("\u26A1 Slash trigger: ".concat(options.trigger));
       if (Array.isArray(options.items)) {
         // Filter out divider items for search functionality
         var searchableItems = options.items.filter(function (item) {

package/es/plugins/upload/plugin/index.js

@@ -19,6 +19,7 @@ function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e
 import { DRAG_DROP_PASTE } from '@lexical/rich-text';
 import { COMMAND_PRIORITY_HIGH, DROP_COMMAND } from 'lexical';
 import { KernelPlugin } from "../../../editor-kernel/plugin";
+import { createDebugLogger } from "../../../utils/debug";
 import { IUploadService, UploadService } from "../service/i-upload-service";
 import { getDragSelection } from "../utils";
 
@@ -32,6 +33,7 @@ export var UploadPlugin = (_class = /*#__PURE__*/function (_KernelPlugin) {
     _classCallCheck(this, UploadPlugin);
     _this = _super.call(this);
     // Register the upload service
+    _defineProperty(_assertThisInitialized(_this), "logger", createDebugLogger('plugin', 'upload'));
     _this.kernel = kernel;
     _this.config = config;
     kernel.registerService(IUploadService, new UploadService());
@@ -50,7 +52,7 @@ export var UploadPlugin = (_class = /*#__PURE__*/function (_KernelPlugin) {
           var uploadService = _this2.kernel.requireService(IUploadService);
           if (uploadService) {
             uploadService.uploadFile(file, 'drop', getDragSelection(event)).catch(function (error) {
-              console.error('Upload failed:', error);
+              _this2.logger.error('Upload failed:', error);
             });
           }
         }
@@ -65,7 +67,7 @@ export var UploadPlugin = (_class = /*#__PURE__*/function (_KernelPlugin) {
             var uploadService = _this2.kernel.requireService(IUploadService);
             if (uploadService) {
               uploadService.uploadFile(file, 'drag-drop-paste', null).catch(function (error) {
-                console.error('Upload failed:', error);
+                _this2.logger.error('Upload failed:', error);
               });
             }
           }

package/es/react/Editor/Editor.js

@@ -63,9 +63,10 @@ var Editor = /*#__PURE__*/memo(function (_ref) {
   var memoMention = useMemo(function () {
     if (!enableMention) return;
     return /*#__PURE__*/_jsx(ReactMentionPlugin, {
+      className: className,
       markdownWriter: markdownWriter
     });
-  }, [enableMention, markdownWriter]);
+  }, [enableMention, markdownWriter, className]);
   var memoSlash = useMemo(function () {
     if (!enableSlash && !enableMention) return null;
     return /*#__PURE__*/_jsxs(ReactSlashPlugin, {

package/es/utils/debug.d.ts

@@ -0,0 +1,396 @@
+import createDebug from 'debug';
+/**
+ * Debug utility factory for LobeHub Editor
+ * Creates namespaced debug functions following the pattern: lobe-editor:category
+ */
+export declare class DebugLogger {
+    private debuggers;
+    /**
+     * Get or create a debug function for a specific namespace
+     * @param category - The debug category (e.g., 'kernel', 'plugin', 'upload')
+     * @param subcategory - Optional subcategory for more specific debugging
+     * @returns Debug function
+     */
+    getDebugger(category: string, subcategory?: string): createDebug.Debugger;
+    /**
+     * Create a scoped debug logger for a specific component/service
+     * @param category - Main category
+     * @param subcategory - Optional subcategory
+     * @returns Object with debug methods
+     */
+    createLogger(category: string, subcategory?: string): {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    /**
+     * Enable debug for specific namespaces
+     * @param namespaces - Comma-separated list of namespaces to enable
+     */
+    enable(namespaces: string): void;
+    /**
+     * Disable all debug output
+     */
+    disable(): void;
+    /**
+     * Check if a namespace is enabled
+     * @param namespace - The namespace to check
+     * @returns Whether the namespace is enabled
+     */
+    enabled(namespace: string): boolean;
+}
+/**
+ * Global debug logger instance
+ */
+export declare const debugLogger: DebugLogger;
+/**
+ * Convenience function to create a debug logger for a specific category
+ * @param category - Main category (e.g., 'kernel', 'plugin', 'upload')
+ * @param subcategory - Optional subcategory
+ * @returns Logger object with debug methods
+ */
+export declare function createDebugLogger(category: string, subcategory?: string): {
+    /**
+     * General debug logging
+     */
+    debug: createDebug.Debugger;
+    /**
+     * Error level logging - uses console.error for proper browser dev tool support
+     */
+    error: (...args: any[]) => void;
+    /**
+     * Info level logging
+     */
+    info: createDebug.Debugger;
+    /**
+     * Log function - alias for debug for compatibility
+     */
+    log: createDebug.Debugger;
+    /**
+     * Warning level logging - uses console.warn for proper browser dev tool support
+     */
+    warn: (...args: any[]) => void;
+};
+/**
+ * Pre-configured debug loggers for common categories
+ */
+export declare const debugLoggers: {
+    demo: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    file: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    image: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    kernel: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    markdown: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    math: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    mention: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    plugin: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    react: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    service: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    slash: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+    upload: {
+        /**
+         * General debug logging
+         */
+        debug: createDebug.Debugger;
+        /**
+         * Error level logging - uses console.error for proper browser dev tool support
+         */
+        error: (...args: any[]) => void;
+        /**
+         * Info level logging
+         */
+        info: createDebug.Debugger;
+        /**
+         * Log function - alias for debug for compatibility
+         */
+        log: createDebug.Debugger;
+        /**
+         * Warning level logging - uses console.warn for proper browser dev tool support
+         */
+        warn: (...args: any[]) => void;
+    };
+};
+/**
+ * Development mode utilities
+ */
+export declare const isDev: boolean;
+/**
+ * Conditional console logging - only logs in development mode
+ * Use this for demo files and development-only logging
+ */
+export declare const devConsole: {
+    error: (...args: any[]) => void;
+    info: (...args: any[]) => void;
+    log: (...args: any[]) => void;
+    warn: (...args: any[]) => void;
+};
+/**
+ * Production-safe error logging
+ * Always logs errors and warnings regardless of environment using native console methods
+ * for proper browser dev tool support. Debug/info uses debug package.
+ */
+export declare const prodSafeLogger: {
+    /**
+     * Debug info - only shown when debug is enabled
+     */
+    debug: createDebug.Debugger;
+    /**
+     * Log critical errors that should always be visible (uses console.error)
+     */
+    error: (...args: any[]) => void;
+    /**
+     * Info logging - only shown when debug is enabled
+     */
+    info: createDebug.Debugger;
+    /**
+     * Log warnings that should always be visible (uses console.warn)
+     */
+    warn: (...args: any[]) => void;
+};