@lobehub/editor 1.29.0 → 1.30.0

package/es/plugins/litexml/data-source/litexml-data-source.js

@@ -0,0 +1,435 @@
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+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 _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 _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 _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 _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; }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+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 _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import { DOMParser } from '@xmldom/xmldom';
+import { $getRoot, $getSelection, $isElementNode, $isRangeSelection } from 'lexical';
+import { DataSource } from "../../../editor-kernel";
+import { INodeHelper } from "../../../editor-kernel/inode/helper";
+import { createDebugLogger } from "../../../utils/debug";
+import { LitexmlService } from "../service/litexml-service";
+var logger = createDebugLogger('plugin', 'litexml');
+var IXmlWriterContext = /*#__PURE__*/function () {
+  function IXmlWriterContext() {
+    _classCallCheck(this, IXmlWriterContext);
+  }
+  _createClass(IXmlWriterContext, [{
+    key: "createXmlNode",
+    value: function createXmlNode(tagName, attributes, textContent) {
+      return {
+        attributes: attributes || {},
+        children: [],
+        tagName: tagName,
+        textContent: textContent
+      };
+    }
+  }]);
+  return IXmlWriterContext;
+}();
+/**
+ * LitexmlDataSource - Handles conversion between Lexical editor state and XML format
+ * Provides read (parse XML to Lexical) and write (export Lexical to XML) capabilities
+ */
+var LitexmlDataSource = /*#__PURE__*/function (_DataSource) {
+  _inherits(LitexmlDataSource, _DataSource);
+  var _super = _createSuper(LitexmlDataSource);
+  function LitexmlDataSource() {
+    var _this;
+    var dataType = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 'litexml';
+    var service = arguments.length > 1 ? arguments[1] : undefined;
+    _classCallCheck(this, LitexmlDataSource);
+    _this = _super.call(this, dataType);
+    _defineProperty(_assertThisInitialized(_this), "litexmlService", void 0);
+    _defineProperty(_assertThisInitialized(_this), "ctx", new IXmlWriterContext());
+    _this.dataType = dataType;
+    _this.litexmlService = service || new LitexmlService();
+    return _this;
+  }
+  _createClass(LitexmlDataSource, [{
+    key: "readLiteXMLToInode",
+    value: function readLiteXMLToInode(litexml) {
+      if (typeof litexml !== 'string') {
+        throw new Error('Invalid data type. Expected string, got ' + _typeof(litexml));
+      }
+      var xml = this.parseXMLString(litexml);
+      var inode = this.xmlToLexical(xml);
+      logger.debug('Parsed XML to Lexical State:', inode);
+      return inode;
+    }
+
+    /**
+     * Parse XML string and set it to the editor
+     * @param editor - The Lexical editor instance
+     * @param data - XML string to parse
+     */
+  }, {
+    key: "read",
+    value: function read(editor, data) {
+      try {
+        var inode = this.readLiteXMLToInode(data);
+        editor.setEditorState(editor.parseEditorState(inode));
+      } catch (error) {
+        logger.error('Failed to parse XML:', error);
+        throw error;
+      }
+    }
+
+    /**
+     * Export editor content to XML format
+     * @param editor - The Lexical editor instance
+     * @param options - Write options (e.g., selection flag)
+     * @returns XML string representation of the editor content
+     */
+  }, {
+    key: "write",
+    value: function write(editor, options) {
+      var _this2 = this;
+      try {
+        if (options !== null && options !== void 0 && options.selection) {
+          return editor.read(function () {
+            var selection = $getSelection();
+            if (!selection) {
+              return null;
+            }
+            if ($isRangeSelection(selection)) {
+              var selectedNodes = selection.getNodes();
+              var rootNode = INodeHelper.createRootNode();
+
+              // Wrap inline nodes in a paragraph
+              if (selectedNodes.some(function (node) {
+                return node.isInline();
+              })) {
+                var p = INodeHelper.createParagraph();
+                INodeHelper.appendChild.apply(INodeHelper, [p].concat(_toConsumableArray(selectedNodes.map(function (node) {
+                  return node.exportJSON();
+                }))));
+                INodeHelper.appendChild(rootNode, p);
+              } else {
+                INodeHelper.appendChild.apply(INodeHelper, [rootNode].concat(_toConsumableArray(selectedNodes.map(function (node) {
+                  return node.exportJSON();
+                }))));
+              }
+              var editorState = editor.parseEditorState({
+                root: rootNode
+              });
+              return editorState.read(function () {
+                var lexicalRootNode = $getRoot();
+                return _this2.lexicalToXML(lexicalRootNode);
+              });
+            }
+            return null;
+          });
+        }
+        return editor.getEditorState().read(function () {
+          var rootNode = $getRoot();
+          return _this2.lexicalToXML(rootNode);
+        });
+      } catch (error) {
+        logger.error('Failed to export to XML:', error);
+        throw error;
+      }
+    }
+
+    /**
+     * Parse XML string using browser's built-in parser
+     */
+  }, {
+    key: "parseXMLString",
+    value: function parseXMLString(xmlString) {
+      var parser = new DOMParser();
+      var doc = parser.parseFromString(xmlString, 'text/xml');
+      if (doc.getElementsByTagName('parsererror').length > 0) {
+        throw new Error('Invalid XML: ' + xmlString);
+      }
+      return doc;
+    }
+
+    /**
+     * Convert XML document to Lexical node structure
+     */
+  }, {
+    key: "xmlToLexical",
+    value: function xmlToLexical(xml) {
+      var rootNode = INodeHelper.createRootNode();
+
+      // Process XML root element's children
+      var xmlRoot = xml.documentElement;
+      if (xmlRoot) {
+        this.processXMLElement(xmlRoot, rootNode);
+      }
+      return {
+        root: rootNode
+      };
+    }
+
+    /**
+     * Recursively process XML elements and convert to Lexical nodes
+     */
+  }, {
+    key: "processXMLElement",
+    value: function processXMLElement(xmlElement, parentNode) {
+      var _this3 = this;
+      var tagName = xmlElement.tagName.toLowerCase();
+      var customReaders = this.litexmlService.getXMLReaders();
+
+      // Check if there's a custom reader for this tag
+      if (customReaders[tagName]) {
+        var readerOrReaders = customReaders[tagName];
+        var readers = Array.isArray(readerOrReaders) ? readerOrReaders : [readerOrReaders];
+        var _iterator = _createForOfIteratorHelper(readers),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var reader = _step.value;
+            var children = [];
+            this.processXMLChildren(xmlElement, {
+              children: children
+            });
+            var result = reader(xmlElement, children);
+            if (result !== false) {
+              if (Array.isArray(result)) {
+                INodeHelper.appendChild.apply(INodeHelper, [parentNode].concat(_toConsumableArray(result)));
+              } else if (result) {
+                result.id = xmlElement.getAttribute('id') || undefined;
+                INodeHelper.appendChild(parentNode, result);
+              }
+              return; // Custom reader handled it
+            }
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+      }
+
+      // Fall back to built-in handlers
+      switch (tagName) {
+        case 'p':
+        case 'paragraph':
+          {
+            var paragraph = INodeHelper.createParagraph();
+            this.processXMLChildren(xmlElement, paragraph);
+            INodeHelper.appendChild(parentNode, paragraph);
+            break;
+          }
+        case 'h1':
+        case 'h2':
+        case 'h3':
+        case 'h4':
+        case 'h5':
+        case 'h6':
+          {
+            var level = parseInt(tagName.charAt(1));
+            var heading = INodeHelper.createElementNode('heading', {
+              children: [],
+              tag: "h".concat(level)
+            });
+            this.processXMLChildren(xmlElement, heading);
+            INodeHelper.appendChild(parentNode, heading);
+            break;
+          }
+        case 'ul':
+        case 'ol':
+          {
+            xmlElement.querySelectorAll(':scope > li').forEach(function (li) {
+              var listItem = INodeHelper.createElementNode('listitem', {
+                children: [],
+                value: 1
+              });
+              _this3.processXMLChildren(li, listItem);
+              INodeHelper.appendChild(parentNode, listItem);
+            });
+            break;
+          }
+        case 'blockquote':
+          {
+            var quote = INodeHelper.createElementNode('quote', {
+              children: []
+            });
+            this.processXMLChildren(xmlElement, quote);
+            INodeHelper.appendChild(parentNode, quote);
+            break;
+          }
+        case 'code':
+          {
+            var codeNode = INodeHelper.createElementNode('codeInline', {
+              children: [INodeHelper.createTextNode(xmlElement.textContent || '')]
+            });
+            INodeHelper.appendChild(parentNode, codeNode);
+            break;
+          }
+        case 'text':
+          {
+            var textContent = xmlElement.textContent || '';
+            if (textContent) {
+              var textNode = INodeHelper.createTextNode(textContent);
+              INodeHelper.appendChild(parentNode, textNode);
+            }
+            break;
+          }
+        default:
+          {
+            // Treat unknown tags as generic containers
+            this.processXMLChildren(xmlElement, parentNode);
+          }
+      }
+    }
+
+    /**
+     * Process XML element's children
+     */
+  }, {
+    key: "processXMLChildren",
+    value: function processXMLChildren(xmlElement, parentNode) {
+      var _this4 = this;
+      Array.from(xmlElement.childNodes).forEach(function (child) {
+        if (child.nodeType === 1) {
+          // Element node
+          _this4.processXMLElement(child, parentNode);
+        } else if (child.nodeType === 3) {
+          // Text node
+          var text = child.textContent || '';
+          if (text.trim()) {
+            var textNode = INodeHelper.createTextNode(text);
+            INodeHelper.appendChild(parentNode, textNode);
+          }
+        }
+      });
+    }
+
+    /**
+     * Convert Lexical node structure to XML string
+     */
+  }, {
+    key: "lexicalToXML",
+    value: function lexicalToXML(rootNode) {
+      var _this5 = this;
+      var xmlLines = ['<?xml version="1.0" encoding="UTF-8"?>'];
+      xmlLines.push('<root>');
+      var children = rootNode.getChildren();
+      children.forEach(function (child) {
+        _this5.nodesToXML(child, xmlLines);
+      });
+      xmlLines.push('</root>');
+      return xmlLines.join('\n');
+    }
+
+    /**
+     * Recursively convert Lexical nodes to XML elements
+     */
+  }, {
+    key: "nodesToXML",
+    value: function nodesToXML(node, lines) {
+      var _this6 = this;
+      var indent = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 1;
+      var indentStr = ' '.repeat(indent * 2);
+      var type = node.getType();
+      var customWriters = this.litexmlService.getXMLWriters();
+      var childLines = [];
+
+      // Check if there's a custom writer for this node type
+      if (customWriters[type]) {
+        var writerOrWriters = customWriters[type];
+        var writers = Array.isArray(writerOrWriters) ? writerOrWriters : [writerOrWriters];
+        var _iterator2 = _createForOfIteratorHelper(writers),
+          _step2;
+        try {
+          for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+            var writer = _step2.value;
+            var handled = writer(node, this.ctx, indent);
+            if (handled) {
+              var attrs = this.buildXMLAttributes(_objectSpread({
+                id: node.getKey()
+              }, handled.attributes));
+              var openTag = "".concat(indentStr, "<").concat(handled.tagName).concat(attrs, ">");
+              var closeTag = "</".concat(handled.tagName, ">");
+              if (handled.textContent) {
+                childLines.push(handled.textContent);
+                lines.push("".concat(openTag).concat(childLines.join('')).concat(closeTag));
+              } else if ($isElementNode(node)) {
+                var children = node.getChildren();
+                children.forEach(function (child) {
+                  _this6.nodesToXML(child, childLines, indent + 1);
+                });
+                lines.push.apply(lines, [openTag].concat(childLines, ["".concat(indentStr).concat(closeTag)]));
+              } else {
+                lines.push(openTag, "".concat(indentStr).concat(closeTag));
+              }
+              return; // Custom writer handled it
+            }
+          }
+        } catch (err) {
+          _iterator2.e(err);
+        } finally {
+          _iterator2.f();
+        }
+      }
+      if ($isElementNode(node)) {
+        var _children = node.getChildren();
+        _children.forEach(function (child) {
+          _this6.nodesToXML(child, childLines, indent + 1);
+        });
+      }
+      lines.push.apply(lines, childLines);
+    }
+
+    /**
+     * Build XML attribute string from attributes object
+     */
+  }, {
+    key: "buildXMLAttributes",
+    value: function buildXMLAttributes(attributes) {
+      var _this7 = this;
+      if (!attributes || _typeof(attributes) !== 'object') {
+        return '';
+      }
+      return Object.entries(attributes).filter(function (_ref) {
+        var _ref2 = _slicedToArray(_ref, 2),
+          value = _ref2[1];
+        return value !== undefined && value !== null && value !== '';
+      }).map(function (_ref3) {
+        var _ref4 = _slicedToArray(_ref3, 2),
+          key = _ref4[0],
+          value = _ref4[1];
+        var escapedValue = _this7.escapeXML(String(value));
+        return " ".concat(key, "=\"").concat(escapedValue, "\"");
+      }).join('');
+    }
+
+    /**
+     * Escape XML special characters
+     */
+  }, {
+    key: "escapeXML",
+    value: function escapeXML(text) {
+      return text.replaceAll('&', '&amp;').replaceAll('<', '&lt;').replaceAll('>', '&gt;').replaceAll('"', '&quot;').replaceAll("'", '&apos;');
+    }
+  }]);
+  return LitexmlDataSource;
+}(DataSource);
+export { LitexmlDataSource as default };

package/es/plugins/litexml/index.d.ts

@@ -0,0 +1,7 @@
+export { LITEXML_APPLY_COMMAND, LITEXML_INSERT_COMMAND, LITEXML_REMOVE_COMMAND } from './command';
+export { default as LitexmlDataSource } from './data-source/litexml-data-source';
+export type { LitexmlPluginOptions } from './plugin';
+export { LitexmlPlugin } from './plugin';
+export { ReactLiteXmlPlugin } from './react';
+export type { XMLReaderFunc, XMLReaderRecord, XMLWriterFunc, XMLWriterRecord, } from './service/litexml-service';
+export { ILitexmlService, LitexmlService } from './service/litexml-service';

package/es/plugins/litexml/index.js

@@ -0,0 +1,5 @@
+export { LITEXML_APPLY_COMMAND, LITEXML_INSERT_COMMAND, LITEXML_REMOVE_COMMAND } from "./command";
+export { default as LitexmlDataSource } from "./data-source/litexml-data-source";
+export { LitexmlPlugin } from "./plugin";
+export { ReactLiteXmlPlugin } from "./react";
+export { ILitexmlService, LitexmlService } from "./service/litexml-service";

package/es/plugins/litexml/plugin/index.d.ts

@@ -0,0 +1,16 @@
+import type { IEditorPluginConstructor } from "../../../types";
+/**
+ * LitexmlPluginOptions - Configuration options for the Litexml plugin
+ */
+export interface LitexmlPluginOptions {
+    /**
+     * Enable or disable the litexml data source
+     * @default true
+     */
+    enabled?: boolean;
+}
+/**
+ * LitexmlPlugin - A plugin that provides XML-based data source support
+ * Allows converting between Lexical editor state and XML format
+ */
+export declare const LitexmlPlugin: IEditorPluginConstructor<LitexmlPluginOptions>;

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

@@ -0,0 +1,59 @@
+var _class;
+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 _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _inherits(subClass, superClass) { if (typeof superClass !== "function" && superClass !== null) { throw new TypeError("Super expression must either be null or a function"); } subClass.prototype = Object.create(superClass && superClass.prototype, { constructor: { value: subClass, writable: true, configurable: true } }); Object.defineProperty(subClass, "prototype", { writable: false }); if (superClass) _setPrototypeOf(subClass, superClass); }
+function _setPrototypeOf(o, p) { _setPrototypeOf = Object.setPrototypeOf ? Object.setPrototypeOf.bind() : function _setPrototypeOf(o, p) { o.__proto__ = p; return o; }; return _setPrototypeOf(o, p); }
+function _createSuper(Derived) { var hasNativeReflectConstruct = _isNativeReflectConstruct(); return function _createSuperInternal() { var Super = _getPrototypeOf(Derived), result; if (hasNativeReflectConstruct) { var NewTarget = _getPrototypeOf(this).constructor; result = Reflect.construct(Super, arguments, NewTarget); } else { result = Super.apply(this, arguments); } return _possibleConstructorReturn(this, result); }; }
+function _possibleConstructorReturn(self, call) { if (call && (_typeof(call) === "object" || typeof call === "function")) { return call; } else if (call !== void 0) { throw new TypeError("Derived constructors may only return object or undefined"); } return _assertThisInitialized(self); }
+function _assertThisInitialized(self) { if (self === void 0) { throw new ReferenceError("this hasn't been initialised - super() hasn't been called"); } return self; }
+function _isNativeReflectConstruct() { if (typeof Reflect === "undefined" || !Reflect.construct) return false; if (Reflect.construct.sham) return false; if (typeof Proxy === "function") return true; try { Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); return true; } catch (e) { return false; } }
+function _getPrototypeOf(o) { _getPrototypeOf = Object.setPrototypeOf ? Object.getPrototypeOf.bind() : function _getPrototypeOf(o) { return o.__proto__ || Object.getPrototypeOf(o); }; return _getPrototypeOf(o); }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+import { KernelPlugin } from "../../../editor-kernel/plugin";
+import { registerLiteXMLCommand } from "../command";
+import LitexmlDataSource from "../data-source/litexml-data-source";
+import { ILitexmlService, LitexmlService } from "../service/litexml-service";
+
+/**
+ * LitexmlPluginOptions - Configuration options for the Litexml plugin
+ */
+
+/**
+ * LitexmlPlugin - A plugin that provides XML-based data source support
+ * Allows converting between Lexical editor state and XML format
+ */
+export var LitexmlPlugin = (_class = /*#__PURE__*/function (_KernelPlugin) {
+  _inherits(LitexmlPlugin, _KernelPlugin);
+  var _super = _createSuper(LitexmlPlugin);
+  function LitexmlPlugin(kernel, config) {
+    var _this;
+    _classCallCheck(this, LitexmlPlugin);
+    _this = _super.call(this);
+
+    // Create and register the Litexml service
+    _defineProperty(_assertThisInitialized(_this), "datasource", void 0);
+    _this.kernel = kernel;
+    _this.config = config;
+    var litexmlService = new LitexmlService();
+    kernel.registerService(ILitexmlService, litexmlService);
+    _this.datasource = new LitexmlDataSource('litexml', litexmlService);
+
+    // Register the litexml data source
+    if ((config === null || config === void 0 ? void 0 : config.enabled) !== false) {
+      kernel.registerDataSource(_this.datasource);
+    }
+    return _this;
+  }
+  _createClass(LitexmlPlugin, [{
+    key: "onInit",
+    value: function onInit(editor) {
+      // Plugin initialization logic can be added here if needed
+      registerLiteXMLCommand(editor, this.datasource);
+    }
+  }]);
+  return LitexmlPlugin;
+}(KernelPlugin), _defineProperty(_class, "pluginName", 'LitexmlPlugin'), _class);

package/es/plugins/litexml/react/index.d.ts

@@ -0,0 +1,3 @@
+import { type FC } from 'react';
+export declare const ReactLiteXmlPlugin: FC<void>;
+export default ReactLiteXmlPlugin;

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

@@ -0,0 +1,22 @@
+'use client';
+
+function _slicedToArray(arr, i) { return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _unsupportedIterableToArray(arr, i) || _nonIterableRest(); }
+function _nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
+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; }
+function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t.return && (u = t.return(), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
+function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
+import { useLayoutEffect } from 'react';
+import { useLexicalComposerContext } from "../../../editor-kernel/react";
+import { LitexmlPlugin } from "../plugin";
+export var ReactLiteXmlPlugin = function ReactLiteXmlPlugin() {
+  var _useLexicalComposerCo = useLexicalComposerContext(),
+    _useLexicalComposerCo2 = _slicedToArray(_useLexicalComposerCo, 1),
+    editor = _useLexicalComposerCo2[0];
+  useLayoutEffect(function () {
+    editor.registerPlugin(LitexmlPlugin);
+  }, [editor]);
+  return null;
+};
+ReactLiteXmlPlugin.displayName = 'ReactLiteXmlPlugin';
+export default ReactLiteXmlPlugin;

package/es/plugins/litexml/service/litexml-service.d.ts

@@ -0,0 +1,85 @@
+import type { LexicalNode } from 'lexical';
+/**
+ * XML Reader function type - converts XML element to Lexical node
+ */
+export type XMLReaderFunc = (xmlElement: Element, children: any[]) => any | any[] | false;
+/**
+ * XML Writer function type - converts Lexical node to XML string
+ */
+export type XMLWriterFunc = (node: LexicalNode, ctx: IWriterContext, indent: number) => IXmlNode | false;
+/**
+ * Record of XML readers indexed by tag name
+ */
+export type XMLReaderRecord = {
+    [tagName: string]: XMLReaderFunc | XMLReaderFunc[];
+};
+/**
+ * Record of XML writers indexed by node type
+ */
+export type XMLWriterRecord = {
+    [nodeType: string]: XMLWriterFunc | XMLWriterFunc[];
+};
+export interface IXmlNode {
+    attributes: {
+        [key: string]: string;
+    };
+    children?: IXmlNode[];
+    tagName: string;
+    textContent?: string;
+}
+export interface IWriterContext {
+    createXmlNode(tagName: string, attributes?: {
+        [key: string]: string;
+    }, textContent?: string): IXmlNode;
+}
+/**
+ * ILitexmlService - Service interface for extending Litexml plugin
+ * Allows other plugins to register custom XML readers and writers
+ */
+export interface ILitexmlService {
+    /**
+     * Get all registered XML readers
+     */
+    getXMLReaders(): XMLReaderRecord;
+    /**
+     * Get all registered XML writers
+     */
+    getXMLWriters(): XMLWriterRecord;
+    /**
+     * Check if a reader is registered for a tag
+     */
+    hasXMLReader(tagName: string): boolean;
+    /**
+     * Check if a writer is registered for a node type
+     */
+    hasXMLWriter(nodeType: string): boolean;
+    /**
+     * Register a custom XML reader for a specific tag name
+     * @param tagName - XML tag name to handle (case-insensitive)
+     * @param reader - Function that converts XML element to Lexical node
+     */
+    registerXMLReader(tagName: string, reader: XMLReaderFunc): void;
+    /**
+     * Register a custom XML writer for a specific Lexical node type
+     * @param nodeType - Lexical node type to handle
+     * @param writer - Function that converts Lexical node to XML string
+     */
+    registerXMLWriter(nodeType: string, writer: XMLWriterFunc): void;
+}
+/**
+ * Service ID for Litexml service
+ */
+export declare const ILitexmlService: import("../../../types").IServiceID<ILitexmlService>;
+/**
+ * Default implementation of ILitexmlService
+ */
+export declare class LitexmlService implements ILitexmlService {
+    private readers;
+    private writers;
+    registerXMLReader(tagName: string, reader: XMLReaderFunc): void;
+    registerXMLWriter(nodeType: string, writer: XMLWriterFunc): void;
+    getXMLReaders(): XMLReaderRecord;
+    getXMLWriters(): XMLWriterRecord;
+    hasXMLReader(tagName: string): boolean;
+    hasXMLWriter(nodeType: string): boolean;
+}