@lobehub/editor 1.5.2 → 1.5.4

package/README.md

@@ -8,17 +8,17 @@
 
 A modern, extensible rich text editor built on Meta's Lexical framework with dual-architecture design, featuring both a powerful kernel and React integration. Optimized for AI applications and chat interfaces.
 
-[![][npm-release-shield]][npm-release-link]
-[![][github-releasedate-shield]][github-releasedate-link]
-[![][github-action-test-shield]][github-action-test-link]
-[![][github-action-release-shield]][github-action-release-link]<br/>
-[![][github-contributors-shield]][github-contributors-link]
-[![][github-forks-shield]][github-forks-link]
-[![][github-stars-shield]][github-stars-link]
-[![][github-issues-shield]][github-issues-link]
-[![][github-license-shield]][github-license-link]
-
-[Changelog](./CHANGELOG.md) · [Report Bug][github-issues-link] · [Request Feature][github-issues-link]
+\[!\[]\[npm-release-shield]]\[npm-release-link]
+\[!\[]\[github-releasedate-shield]]\[github-releasedate-link]
+\[!\[]\[github-action-test-shield]]\[github-action-test-link]
+\[!\[]\[github-action-release-shield]]\[github-action-release-link]<br/>
+\[!\[]\[github-contributors-shield]]\[github-contributors-link]
+\[!\[]\[github-forks-shield]]\[github-forks-link]
+\[!\[]\[github-stars-shield]]\[github-stars-link]
+\[!\[]\[github-issues-shield]]\[github-issues-link]
+\[!\[]\[github-license-shield]]\[github-license-link]
+
+[Changelog](./CHANGELOG.md) · \[Report Bug]\[github-issues-link] · \[Request Feature]\[github-issues-link]
 
 ![](https://github.com/user-attachments/assets/98c9a810-1c7d-4c33-acd7-ae9d4c0695da)
 
@@ -47,12 +47,7 @@ A modern, extensible rich text editor built on Meta's Lexical framework with dua
 - [🛠️ Development](#️-development)
   - [Setup](#setup)
   - [Available Scripts](#available-scripts)
-  - [Project Architecture](#project-architecture)
-- [🤝 Contributing](#-contributing)
-- [🔗 Links](#-links)
-  - [More Products](#more-products)
-  - [Design Resources](#design-resources)
-  - [Development Resources](#development-resources)
+  - [Debug Environment Variables](#debug-environment-variables)
 
 ####
 
@@ -75,7 +70,7 @@ A modern, extensible rich text editor built on Meta's Lexical framework with dua
 
 To install `@lobehub/editor`, run the following command:
 
-[![][bun-shield]][bun-link]
+\[!\[]\[bun-shield]]\[bun-link]
 
 ```bash
 $ bun add @lobehub/editor
@@ -87,7 +82,7 @@ $ pnpm add @lobehub/editor
 
 <div align="right">
 
-[![][back-to-top]](#readme-top)
+[!\[\]\[back-to-top\]](#readme-top)
 
 </div>
 
@@ -236,7 +231,7 @@ editor.dispatchCommand(INSERT_HEADING_COMMAND, { tag: 'h2' });
 
 <div align="right">
 
-[![][back-to-top]](#readme-top)
+[!\[\]\[back-to-top\]](#readme-top)
 
 </div>
 
@@ -395,7 +390,7 @@ CLEAR_FORMAT_COMMAND;
 
 <div align="right">
 
-[![][back-to-top]](#readme-top)
+[!\[\]\[back-to-top\]](#readme-top)
 
 </div>
 
@@ -405,11 +400,11 @@ CLEAR_FORMAT_COMMAND;
 
 You can use Github Codespaces for online development:
 
-[![][github-codespace-shield]][github-codespace-link]
+\[!\[]\[github-codespace-shield]]\[github-codespace-link]
 
 Or clone it for local development:
 
-[![][bun-shield]][bun-link]
+\[!\[]\[bun-shield]]\[bun-link]
 
 ```bash
 $ git clone https://github.com/lobehub/lobe-editor.git
@@ -434,6 +429,61 @@ This will start the Dumi documentation server with live playground at `http://lo
 | `pnpm docs:build`    | Build documentation for production            |
 | `pnpm release`       | Publish new version with semantic-release     |
 
+### Debug Environment Variables
+
+LobeHub Editor includes comprehensive debug logging that can be controlled via environment variables:
+
+#### Basic Debug Configuration
+
+```bash
+# Enable all LobeHub Editor debug output
+DEBUG=lobe-editor:*
+
+# Enable only important logs (recommended for development)
+DEBUG=lobe-editor:*:info,lobe-editor:*:warn,lobe-editor:*:error
+
+# Enable specific components
+DEBUG=lobe-editor:kernel,lobe-editor:plugin:*
+```
+
+#### Available Debug Categories
+
+| Category           | Description               | Example                              |
+| ------------------ | ------------------------- | ------------------------------------ |
+| `kernel`           | Core editor functionality | `DEBUG=lobe-editor:kernel`           |
+| `plugin:*`         | All plugins               | `DEBUG=lobe-editor:plugin:*`         |
+| `plugin:slash`     | Slash commands            | `DEBUG=lobe-editor:plugin:slash`     |
+| `plugin:mention`   | Mention system            | `DEBUG=lobe-editor:plugin:mention`   |
+| `plugin:image`     | Image handling            | `DEBUG=lobe-editor:plugin:image`     |
+| `plugin:file`      | File operations           | `DEBUG=lobe-editor:plugin:file`      |
+| `service:*`        | All services              | `DEBUG=lobe-editor:service:*`        |
+| `service:upload`   | Upload service            | `DEBUG=lobe-editor:service:upload`   |
+| `service:markdown` | Markdown processing       | `DEBUG=lobe-editor:service:markdown` |
+
+#### Debug Levels
+
+| Level   | Browser Display       | Usage               | Environment Variable        |
+| ------- | --------------------- | ------------------- | --------------------------- |
+| `debug` | Console.log (gray)    | Detailed tracing    | `DEBUG=lobe-editor:*:debug` |
+| `info`  | Console.log (blue)    | General information | `DEBUG=lobe-editor:*:info`  |
+| `warn`  | Console.warn (yellow) | Warnings            | `DEBUG=lobe-editor:*:warn`  |
+| `error` | Console.error (red)   | Errors              | `DEBUG=lobe-editor:*:error` |
+
+#### Development Usage
+
+````bash
+# Full debug during development
+DEBUG=lobe-editor:*
+
+# Only critical logs
+DEBUG=lobe-editor:*:error,lobe-editor:*:warn
+# Plugin debugging
+DEBUG=lobe-editor:plugin:*
+# Service debugging
+DEBUG=lobe-editor:service:*
+```
+
+
 ### Project Architecture
 
 ```
@@ -635,3 +685,4 @@ This project is [MIT](./LICENSE) licensed.
 [pr-welcome-link]: https://github.com/lobehub/lobe-editor/pulls
 [pr-welcome-shield]: https://img.shields.io/badge/%F0%9F%A4%AF%20PR%20WELCOME-%E2%86%92-ffcb47?labelColor=black&style=for-the-badge
 [profile-link]: https://github.com/lobehub
+````

package/es/editor-kernel/kernel.d.ts

@@ -14,6 +14,7 @@ export declare class Kernel extends EventEmitter implements IEditorKernel {
     private serviceMap;
     private localeMap;
     private hotReloadMode;
+    private logger;
     private editor?;
     constructor();
     private detectDevelopmentMode;

package/es/editor-kernel/kernel.js

@@ -1,8 +1,8 @@
-function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _toConsumableArray(arr) { return _arrayWithoutHoles(arr) || _iterableToArray(arr) || _unsupportedIterableToArray(arr) || _nonIterableSpread(); }
 function _nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function _iterableToArray(iter) { if (typeof Symbol !== "undefined" && iter[Symbol.iterator] != null || iter["@@iterator"] != null) return Array.from(iter); }
 function _arrayWithoutHoles(arr) { if (Array.isArray(arr)) return _arrayLikeToArray(arr); }
+function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
 function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
 function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
 function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
@@ -24,6 +24,7 @@ import { $getSelection, $isRangeSelection, COMMAND_PRIORITY_CRITICAL, createEdit
 import { get, merge, template, templateSettings } from 'lodash-es';
 import defaultLocale from "../locale";
 import { $isRootTextContentEmpty } from "../plugins/common/utils";
+import { createDebugLogger } from "../utils/debug";
 import { registerEvent } from "./event";
 import { KernelPlugin } from "./plugin";
 import { createEmptyEditorState } from "./utils";
@@ -45,12 +46,14 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
     _defineProperty(_assertThisInitialized(_this), "serviceMap", new Map());
     _defineProperty(_assertThisInitialized(_this), "localeMap", defaultLocale);
     _defineProperty(_assertThisInitialized(_this), "hotReloadMode", false);
+    _defineProperty(_assertThisInitialized(_this), "logger", createDebugLogger('kernel'));
     _defineProperty(_assertThisInitialized(_this), "editor", void 0);
     _defineProperty(_assertThisInitialized(_this), "_commands", new Map());
     _defineProperty(_assertThisInitialized(_this), "_commandsClean", new Map());
     _this.dataTypeMap = new Map();
     // Enable hot reload mode in development
     _this.hotReloadMode = _this.detectDevelopmentMode();
+    _this.logger.info("\uD83D\uDE80 Kernel initialized (hot reload: ".concat(_this.hotReloadMode, ")"));
     return _this;
   }
   _createClass(Kernel, [{
@@ -109,6 +112,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
     key: "destroy",
     value: function destroy() {
       var _this$editor;
+      this.logger.info("\uD83D\uDDD1\uFE0F Destroying editor with ".concat(this.pluginsInstances.length, " plugins"));
       (_this$editor = this.editor) === null || _this$editor === void 0 || _this$editor.setEditorState(createEmptyEditorState());
       this.dataTypeMap.clear();
       this.pluginsInstances.forEach(function (plugin) {
@@ -121,7 +125,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
       this.serviceMap.clear();
       // Clear decorators to prevent memory leaks
       this.decorators = {};
-      console.debug('[Editor] Cleared all decorators during destroy');
+      this.logger.info('✅ Editor destroyed');
     }
   }, {
     key: "getRootElement",
@@ -135,13 +139,14 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
       var _this2 = this;
       // Check if editor is already initialized to prevent re-initialization
       if (this.editor) {
-        console.warn('[Editor] Editor is already initialized, updating root element only');
+        this.logger.warn('[Editor] Editor is already initialized, updating root element only');
         this.editor.setRootElement(dom);
         return this.editor;
       }
 
       // Initialize plugins if not already done
       if (this.pluginsInstances.length === 0) {
+        this.logger.info("\uD83D\uDD0C Initializing ".concat(this.plugins.length, " plugins"));
         var _iterator = _createForOfIteratorHelper(this.plugins),
           _step;
         try {
@@ -156,12 +161,14 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
           _iterator.f();
         }
       }
+      this.logger.info("\uD83D\uDCDD Creating editor with ".concat(this.nodes.length, " nodes"));
       var editor = this.editor = createEditor({
         // @ts-expect-error Inject into lexical editor instance
         __kernel: this,
         namespace: 'lobehub',
         nodes: this.nodes,
         onError: function onError(error) {
+          _this2.logger.error('❌ Lexical editor error:', error);
           _this2.emit('error', error);
         },
         theme: this.themes
@@ -172,6 +179,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
         var _plugin$onInit;
         (_plugin$onInit = plugin.onInit) === null || _plugin$onInit === void 0 || _plugin$onInit.call(plugin, editor);
       });
+      this.logger.info("\u2705 Editor ready with ".concat(this.pluginsInstances.length, " plugins"));
       this.emit('initialized', editor);
       return this.editor;
     }
@@ -180,12 +188,15 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
     value: function setDocument(type, content) {
       var datasource = this.dataTypeMap.get(type);
       if (!datasource) {
+        this.logger.error("\u274C DataSource for type \"".concat(type, "\" not found"));
         throw new Error("DataSource for type \"".concat(type, "\" is not registered."));
       }
       if (!this.editor) {
+        this.logger.error('❌ Editor not initialized');
         throw new Error("Editor is not initialized.");
       }
       datasource.read(this.editor, content);
+      this.logger.debug("\uD83D\uDCE5 Set ".concat(type, " document"));
     }
   }, {
     key: "focus",
@@ -204,12 +215,15 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
     value: function getDocument(type) {
       var datasource = this.dataTypeMap.get(type);
       if (!datasource) {
+        this.logger.error("\u274C DataSource for type \"".concat(type, "\" not found"));
         throw new Error("DataSource for type \"".concat(type, "\" is not registered."));
       }
       if (!this.editor) {
+        this.logger.error('❌ Editor not initialized');
         throw new Error("Editor is not initialized.");
       }
-      return datasource.write(this.editor);
+      var result = datasource.write(this.editor);
+      return result;
     }
   }, {
     key: "getSelectionDocument",
@@ -231,7 +245,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
       if (this.decorators[name]) {
         if (this.hotReloadMode) {
           // In hot reload mode, allow decorator override with warning
-          console.warn("[Hot Reload] Overriding decorator \"".concat(name, "\""));
+          this.logger.warn("\uD83D\uDD04 Hot reload: decorator \"".concat(name, "\""));
           this.decorators[name] = decorator;
           return this;
         } else {
@@ -239,17 +253,17 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
           var existingDecorator = this.decorators[name];
           if (existingDecorator === decorator) {
             // Same decorator function, no need to re-register
-            console.warn("[Editor] Decorator \"".concat(name, "\" is already registered with the same function"));
+            this.logger.warn("[Editor] Decorator \"".concat(name, "\" is already registered with the same function"));
             return this;
           }
 
           // Different decorator function in production mode
-          console.error("[Editor] Attempting to register duplicate decorator \"".concat(name, "\". Enable hot reload mode if this is intended."));
+          this.logger.error("[Editor] Attempting to register duplicate decorator \"".concat(name, "\". Enable hot reload mode if this is intended."));
           throw new Error("Decorator with name \"".concat(name, "\" is already registered."));
         }
       }
       this.decorators[name] = decorator;
-      console.debug("[Editor] Registered decorator: ".concat(name));
+      this.logger.debug("\uD83C\uDFAD Decorator: ".concat(name));
       return this;
     }
   }, {
@@ -267,10 +281,10 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
     value: function unregisterDecorator(name) {
       if (this.decorators[name]) {
         delete this.decorators[name];
-        console.debug("[Editor] Unregistered decorator: ".concat(name));
+        this.logger.debug("\uD83D\uDDD1\uFE0F Removed decorator: ".concat(name));
         return true;
       }
-      console.warn("[Editor] Decorator \"".concat(name, "\" not found for unregistration"));
+      this.logger.warn("\u26A0\uFE0F Decorator \"".concat(name, "\" not found"));
       return false;
     }
 
@@ -291,6 +305,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
     key: "registerDataSource",
     value: function registerDataSource(dataSource) {
       this.dataTypeMap.set(dataSource.type, dataSource);
+      this.logger.debug("\uD83D\uDCC4 Data source: ".concat(dataSource.type));
     }
   }, {
     key: "registerThemes",
@@ -307,7 +322,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
         // Error if same name but different plugin
         if (findPlugin !== plugin) {
           if (this.hotReloadMode) {
-            console.warn("[Hot Reload] Replacing plugin \"".concat(plugin.pluginName, "\" with new implementation"));
+            this.logger.warn("\uD83D\uDD04 Hot reload: plugin \"".concat(plugin.pluginName, "\""));
             // Remove old plugin
             var index = this.plugins.findIndex(function (p) {
               return p.pluginName === plugin.pluginName;
@@ -329,7 +344,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
                     for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
                       var decoratorName = _step2.value;
                       this.unregisterDecorator(decoratorName);
-                      console.debug("[Hot Reload] Cleaned up decorator \"".concat(decoratorName, "\" from old plugin instance"));
+                      this.logger.debug("\uD83E\uDDE8 Cleanup: decorator \"".concat(decoratorName, "\""));
                     }
                   } catch (err) {
                     _iterator2.e(err);
@@ -359,6 +374,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
       plugin.__config = config || {};
       // @ts-expect-error not error
       this.plugins.push(plugin);
+      this.logger.debug("\uD83D\uDD0C Plugin: ".concat(plugin.pluginName));
       return this;
     }
   }, {
@@ -380,13 +396,30 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
       } finally {
         _iterator3.f();
       }
+      this.logger.debug("\uD83D\uDD0C Registered ".concat(plugins.length, " plugins"));
       return this;
     }
   }, {
     key: "registerNodes",
     value: function registerNodes(nodes) {
       var _this$nodes;
+      var nodeTypes = nodes.map(function (node) {
+        // Handle both node classes and node replacements
+        if (typeof node === 'function' && node.getType) {
+          return node.getType();
+        } else if (_typeof(node) === 'object' && node.replace && typeof node.replace === 'function' && node.replace.getType) {
+          return node.replace.getType();
+        }
+        return 'unknown';
+      }).filter(function (type) {
+        return type !== 'unknown';
+      });
       (_this$nodes = this.nodes).push.apply(_this$nodes, _toConsumableArray(nodes));
+      if (nodeTypes.length > 3) {
+        this.logger.debug("\uD83E\uDDE9 Nodes: ".concat(nodeTypes.length, " types"));
+      } else {
+        this.logger.debug("\uD83E\uDDE9 Nodes: ".concat(nodeTypes.join(', ')));
+      }
     }
   }, {
     key: "registerService",
@@ -395,7 +428,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
       if (this.serviceMap.has(serviceIdString)) {
         if (this.hotReloadMode) {
           // In hot reload mode, allow service override with warning
-          console.warn("[Hot Reload] Overriding service with ID \"".concat(serviceIdString, "\""));
+          this.logger.warn("\uD83D\uDD04 Hot reload: service \"".concat(serviceIdString, "\""));
           this.serviceMap.set(serviceIdString, service);
           return;
         } else {
@@ -403,17 +436,17 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
           var existingService = this.serviceMap.get(serviceIdString);
           if (existingService === service) {
             // Same service instance, no need to re-register
-            console.warn("[Editor] Service \"".concat(serviceIdString, "\" is already registered with the same instance"));
+            this.logger.warn("[Editor] Service \"".concat(serviceIdString, "\" is already registered with the same instance"));
             return;
           }
 
           // Different service instance in production mode
-          console.error("[Editor] Attempting to register duplicate service \"".concat(serviceIdString, "\". Enable hot reload mode if this is intended."));
+          this.logger.error("[Editor] Attempting to register duplicate service \"".concat(serviceIdString, "\". Enable hot reload mode if this is intended."));
           throw new Error("Service with ID \"".concat(serviceIdString, "\" is already registered."));
         }
       }
       this.serviceMap.set(serviceIdString, service);
-      console.debug("[Editor] Registered service: ".concat(serviceIdString));
+      this.logger.debug("\uD83D\uDD27 Service: ".concat(serviceIdString));
     }
 
     /**
@@ -425,6 +458,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
     key: "registerServiceHotReload",
     value: function registerServiceHotReload(serviceId, service) {
       this.serviceMap.set(serviceId.__serviceId, service);
+      this.logger.debug("\uD83D\uDD04 Hot-reload service: ".concat(serviceId.__serviceId));
     }
 
     /**
@@ -480,7 +514,9 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
   }, {
     key: "registerLocale",
     value: function registerLocale(locale) {
+      var localeKeys = Object.keys(locale);
       this.localeMap = merge(this.localeMap, locale);
+      this.logger.debug("\uD83C\uDF10 Locale: ".concat(localeKeys.length, " keys"));
     }
   }, {
     key: "t",
@@ -532,6 +568,7 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
       }
       var commandsMap = this._commands;
       if (!commandsMap.has(command)) {
+        var _command$type;
         commandsMap.set(command, [new Set(), new Set(), new Set(), new Set(), new Set()]);
         this._commandsClean.set(command, lexicalEditor.registerCommand(command, function (payload) {
           for (var i = 4; i >= 0; i--) {
@@ -556,6 +593,10 @@ export var Kernel = /*#__PURE__*/function (_EventEmitter) {
           }
           return false;
         }, COMMAND_PRIORITY_CRITICAL));
+        // Only log non-keyboard commands to reduce noise
+        if (!((_command$type = command.type) !== null && _command$type !== void 0 && _command$type.includes('KEY'))) {
+          this.logger.debug("\u26A1 Command: ".concat(command.type || 'unknown'));
+        }
       }
       var listenersInPriorityOrder = commandsMap.get(command);
       if (listenersInPriorityOrder === undefined) {

package/es/editor-kernel/react/useDecorators.js

@@ -25,16 +25,26 @@ export function useDecorators(editor, ErrorBoundary) {
   useLayoutEffectImpl(function () {
     var clears = [];
     var handleInit = function handleInit(editor) {
+      // Get initial decorators
+      var initialDecorators = editor.getDecorators();
+      setDecorators(initialDecorators);
       clears.push(editor.registerDecoratorListener(function (nextDecorators) {
         flushSync(function () {
           setDecorators(nextDecorators);
         });
       }));
     };
-    editor.on('initialized', handleInit);
-    clears.push(function () {
-      editor.off('initialized', handleInit);
-    });
+
+    // Check if editor is already initialized
+    var lexicalEditor = editor.getLexicalEditor();
+    if (lexicalEditor) {
+      handleInit(lexicalEditor);
+    } else {
+      editor.on('initialized', handleInit);
+      clears.push(function () {
+        editor.off('initialized', handleInit);
+      });
+    }
     return function () {
       clears.forEach(function (clear) {
         return clear();

package/es/index.d.ts

@@ -14,6 +14,7 @@ export * from './plugins/slash';
 export * from './plugins/table';
 export * from './plugins/upload';
 export type { IEditor } from './types';
+export { browserDebug, createDebugLogger, debugLogger, debugLoggers, devConsole, prodSafeLogger, } from './utils/debug';
 export { Kernel } from './editor-kernel/kernel';
 /**
  * Enable hot reload mode globally for all editor instances

package/es/index.js

@@ -13,6 +13,9 @@ export * from "./plugins/mention";
 export * from "./plugins/slash";
 export * from "./plugins/table";
 export * from "./plugins/upload";
+// Debug utilities
+export { browserDebug, createDebugLogger, debugLogger, debugLoggers, devConsole, prodSafeLogger } from "./utils/debug";
+
 // Hot reload utilities
 export { Kernel } from "./editor-kernel/kernel";
 
@@ -24,8 +27,10 @@ export function enableHotReload() {
   if (typeof window !== 'undefined') {
     var _require = require("./editor-kernel/kernel"),
       Kernel = _require.Kernel;
+    var _require2 = require("./utils/debug"),
+      debugLoggers = _require2.debugLoggers;
     Kernel.setGlobalHotReloadMode(true);
-    console.log('[LobeHub Editor] Hot reload mode enabled globally');
+    debugLoggers.kernel.info('[LobeHub Editor] Hot reload mode enabled globally');
   }
 }
 
@@ -34,9 +39,11 @@ export function enableHotReload() {
  */
 export function disableHotReload() {
   if (typeof window !== 'undefined') {
-    var _require2 = require("./editor-kernel/kernel"),
-      Kernel = _require2.Kernel;
+    var _require3 = require("./editor-kernel/kernel"),
+      Kernel = _require3.Kernel;
+    var _require4 = require("./utils/debug"),
+      debugLoggers = _require4.debugLoggers;
     Kernel.setGlobalHotReloadMode(false);
-    console.log('[LobeHub Editor] Hot reload mode disabled globally');
+    debugLoggers.kernel.info('[LobeHub Editor] Hot reload mode disabled globally');
   }
 }

package/es/plugins/common/node/cursor.js

@@ -20,6 +20,8 @@ function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Re
 function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
 import { mergeRegister } from '@lexical/utils';
 import { $createTextNode, $getNodeByKey, $getSelection, $isDecoratorNode, $isRangeSelection, $setSelection, COMMAND_PRIORITY_HIGH, DecoratorNode, ElementNode, KEY_ARROW_LEFT_COMMAND, KEY_ARROW_RIGHT_COMMAND, KEY_BACKSPACE_COMMAND, TextNode } from 'lexical';
+import { createDebugLogger } from "../../../utils/debug";
+var logger = createDebugLogger('common', 'cursor');
 export var CardLikeElementNode = /*#__PURE__*/function (_ElementNode) {
   _inherits(CardLikeElementNode, _ElementNode);
   var _super = _createSuper(CardLikeElementNode);
@@ -87,7 +89,7 @@ export function registerCursorNode(editor) {
                   key = _step2$value[0],
                   mutation = _step2$value[1];
                 var node = $getNodeByKey(key);
-                console.info('DecoratorNode mutated', node, mutation);
+                logger.debug('🎭 DecoratorNode mutated:', node === null || node === void 0 ? void 0 : node.getType(), mutation, node);
                 if (mutation === 'created' && node !== null && node !== void 0 && node.isInline() && node.getNextSibling() === null) {
                   needAddCursor.push(node);
                 }
@@ -237,7 +239,7 @@ export function registerCursorNode(editor) {
         $setSelection(sel);
         return true;
       } catch (error) {
-        console.error(error);
+        logger.error('❌ Cursor selection error:', error);
       }
     } else if ($isCursorNode(focusNode)) {
       try {
@@ -255,7 +257,7 @@ export function registerCursorNode(editor) {
         $setSelection(_sel);
         return true;
       } catch (error) {
-        console.error(error);
+        logger.error('❌ Cursor navigation error:', error);
       }
     }
     return false;

package/es/plugins/file/command/index.js

@@ -1,6 +1,8 @@
 import { $wrapNodeInElement } from '@lexical/utils';
 import { $createParagraphNode, $insertNodes, $isRootOrShadowRoot, COMMAND_PRIORITY_HIGH, createCommand } from 'lexical';
+import { createDebugLogger } from "../../../utils/debug";
 import { $createFileNode } from "../node/FileNode";
+var logger = createDebugLogger('plugin', 'file');
 export var INSERT_FILE_COMMAND = createCommand('INSERT_FILE_COMMAND');
 export function registerFileCommand(editor, handleUpload) {
   return editor.registerCommand(INSERT_FILE_COMMAND, function (payload) {
@@ -16,7 +18,7 @@ export function registerFileCommand(editor, handleUpload) {
           fileNode.setUploaded(url.url);
         });
       }).catch(function (error) {
-        console.error('File upload failed:', error);
+        logger.error('❌ File upload failed:', error);
         editor.update(function () {
           fileNode.setError('File upload failed : ' + error.message);
         });

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

@@ -21,6 +21,7 @@ import { $createParagraphNode, $createRangeSelection, $insertNodes, $isRootOrSha
 import { KernelPlugin } from "../../../editor-kernel/plugin";
 import { IMarkdownShortCutService } from "../../markdown";
 import { IUploadService } from "../../upload";
+import { createDebugLogger } from "../../../utils/debug";
 import { registerFileCommand } from "../command";
 import { $createFileNode, $isFileNode, FileNode } from "../node/FileNode";
 import { registerFileNodeSelectionObserver } from "../utils";
@@ -36,6 +37,7 @@ export var FilePlugin = (_class = /*#__PURE__*/function (_KernelPlugin) {
     _classCallCheck(this, FilePlugin);
     _this = _super.call(this);
     // Register the file node
+    _defineProperty(_assertThisInitialized(_this), "logger", createDebugLogger('plugin', 'file'));
     _this.kernel = kernel;
     _this.config = config;
     kernel.registerNodes([FileNode]);
@@ -91,7 +93,7 @@ export var FilePlugin = (_class = /*#__PURE__*/function (_KernelPlugin) {
                       fileNode.setUploaded(url.url);
                     });
                   }).catch(function (error) {
-                    console.error('File upload failed:', error);
+                    _this2.logger.error('File upload failed:', error);
                     editor.update(function () {
                       fileNode.setError('File upload failed : ' + error.message);
                     });

package/es/plugins/image/command/index.js

@@ -1,6 +1,8 @@
 import { $wrapNodeInElement } from '@lexical/utils';
 import { $createParagraphNode, $createRangeSelection, $insertNodes, $isRootOrShadowRoot, $setSelection, COMMAND_PRIORITY_EDITOR, createCommand } from 'lexical';
+import { createDebugLogger } from "../../../utils/debug";
 import { $createImageNode } from "../node/image-node";
+var logger = createDebugLogger('plugin', 'image');
 export var INSERT_IMAGE_COMMAND = createCommand('INSERT_IMAGE_COMMAND');
 function isImageFile(file) {
   return file.type.startsWith('image/');
@@ -34,7 +36,7 @@ export function registerImageCommand(editor, handleUpload) {
           imageNode.setUploaded(res.url);
         });
       }).catch(function (error) {
-        console.error('Image upload failed:', error);
+        logger.error('❌ Image upload failed:', error);
         editor.update(function () {
           imageNode.setError('Image upload failed : ' + error.message);
         });

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

@@ -71,4 +71,4 @@ export var ImagePlugin = (_class = /*#__PURE__*/function (_KernelPlugin) {
     }
   }]);
   return ImagePlugin;
-}(KernelPlugin), _defineProperty(_class, "pluginName", 'image'), _class);
+}(KernelPlugin), _defineProperty(_class, "pluginName", 'ImagePlugin'), _class);

package/es/plugins/markdown/service/shortcut.d.ts

@@ -90,6 +90,7 @@ export declare class MarkdownShortCutService implements IMarkdownShortCutService
     private elementTransformers;
     private textFormatTransformers;
     private textMatchTransformers;
+    private logger;
     private _markdownWriters;
     constructor(kernel?: import("../../../types/kernel").IEditorKernel | undefined);
     get markdownWriters(): Record<string, (ctx: IMarkdownWriterContext, node: LexicalNode) => boolean | void>;