@haklex/rich-headless 0.0.11

package/LICENSE

@@ -0,0 +1,28 @@
+MIT License
+
+Copyright (c) 2024 Innei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+Additional Terms and Conditions
+
+----------------
+
+Use of this software is governed by the terms of MIT and, in addition, by the terms and conditions described in the additional file (ADDITIONAL_TERMS.md). By using this software, you agree to abide by these additional terms and conditions.

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+import { DecoratorNode, ElementNode, Klass, LexicalNode, NodeKey, SerializedElementNode, SerializedLexicalNode } from 'lexical';
+export declare const builtinNodes: Klass<LexicalNode>[];
+export declare class SpoilerNode extends ElementNode {
+    static getType(): string;
+    static clone(node: SpoilerNode): SpoilerNode;
+    constructor(key?: NodeKey);
+    static importJSON(_json: SerializedElementNode): SpoilerNode;
+    exportJSON(): SerializedElementNode;
+    createDOM(): HTMLElement;
+    updateDOM(): boolean;
+    isInline(): boolean;
+}
+export declare class DetailsNode extends ElementNode {
+    __summary: string;
+    __open: boolean;
+    static getType(): string;
+    static clone(node: DetailsNode): DetailsNode;
+    constructor(key?: NodeKey);
+    static importJSON(json: SerializedElementNode & {
+        summary?: string;
+        open?: boolean;
+    }): DetailsNode;
+    exportJSON(): SerializedElementNode & {
+        summary: string;
+        open: boolean;
+    };
+    createDOM(): HTMLElement;
+    updateDOM(): boolean;
+}
+export declare const ImageNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const VideoNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const LinkCardNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const KaTeXInlineNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const KaTeXBlockNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const MermaidNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const MentionNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const CodeBlockNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const FootnoteNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const FootnoteSectionNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const EmbedNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const CodeSnippetNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const GalleryNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare const TldrawNode: import('lexical').KlassConstructor<typeof LexicalNode>;
+export declare class BannerNode extends DecoratorNode<null> {
+    __bannerType: string;
+    __contentState: unknown;
+    static getType(): string;
+    constructor(key?: NodeKey);
+    static clone(node: BannerNode): BannerNode;
+    static importJSON(json: SerializedLexicalNode & {
+        bannerType?: string;
+        content?: unknown;
+    }): BannerNode;
+    exportJSON(): SerializedLexicalNode;
+    createDOM(): HTMLElement;
+    updateDOM(): boolean;
+    decorate(): null;
+    getTextContent(): string;
+}
+export declare class AlertQuoteNode extends DecoratorNode<null> {
+    __alertType: string;
+    __contentState: unknown;
+    static getType(): string;
+    constructor(key?: NodeKey);
+    static clone(node: AlertQuoteNode): AlertQuoteNode;
+    static importJSON(json: SerializedLexicalNode & {
+        alertType?: string;
+        content?: unknown;
+    }): AlertQuoteNode;
+    exportJSON(): SerializedLexicalNode;
+    createDOM(): HTMLElement;
+    updateDOM(): boolean;
+    decorate(): null;
+    getTextContent(): string;
+}
+export declare class GridContainerNode extends DecoratorNode<null> {
+    __cols: number;
+    __gap: string;
+    __cells: unknown[];
+    static getType(): string;
+    constructor(key?: NodeKey);
+    static clone(node: GridContainerNode): GridContainerNode;
+    static importJSON(json: SerializedLexicalNode & {
+        cols?: number;
+        gap?: string | number;
+        cells?: unknown[];
+    }): GridContainerNode;
+    exportJSON(): SerializedLexicalNode;
+    createDOM(): HTMLElement;
+    updateDOM(): boolean;
+    decorate(): null;
+    getTextContent(): string;
+}
+export declare const customHeadlessNodes: Klass<LexicalNode>[];
+export declare const allHeadlessNodes: Klass<LexicalNode>[];
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.mjs

@@ -0,0 +1,403 @@
+import { CodeNode, CodeHighlightNode } from "@lexical/code";
+import { HorizontalRuleNode } from "@lexical/extension";
+import { LinkNode, AutoLinkNode } from "@lexical/link";
+import { ListNode, ListItemNode } from "@lexical/list";
+import { HeadingNode, QuoteNode } from "@lexical/rich-text";
+import { TableNode, TableCellNode, TableRowNode } from "@lexical/table";
+import { ElementNode, DecoratorNode } from "lexical";
+const builtinNodes = [
+  HeadingNode,
+  QuoteNode,
+  ListNode,
+  ListItemNode,
+  LinkNode,
+  AutoLinkNode,
+  HorizontalRuleNode,
+  TableNode,
+  TableCellNode,
+  TableRowNode,
+  CodeNode,
+  CodeHighlightNode
+];
+function stubDOM() {
+  return document.createElement("span");
+}
+function extractText(state) {
+  if (!state || typeof state !== "object") return "";
+  const root = state.root;
+  if (!root) return "";
+  return walkChildren(root);
+}
+function walkChildren(node) {
+  const children = node.children;
+  if (!children) return node.text ?? "";
+  return children.map(walkChildren).join("\n");
+}
+class SpoilerNode extends ElementNode {
+  static getType() {
+    return "spoiler";
+  }
+  static clone(node) {
+    return new SpoilerNode(node.__key);
+  }
+  constructor(key) {
+    super(key);
+  }
+  static importJSON(_json) {
+    return new SpoilerNode();
+  }
+  exportJSON() {
+    return { ...super.exportJSON(), type: "spoiler", version: 1 };
+  }
+  createDOM() {
+    return stubDOM();
+  }
+  updateDOM() {
+    return false;
+  }
+  isInline() {
+    return true;
+  }
+}
+class DetailsNode extends ElementNode {
+  constructor(key) {
+    super(key);
+    this.__summary = "";
+    this.__open = false;
+  }
+  static getType() {
+    return "details";
+  }
+  static clone(node) {
+    const n = new DetailsNode(node.__key);
+    n.__summary = node.__summary;
+    n.__open = node.__open;
+    return n;
+  }
+  static importJSON(json) {
+    const node = new DetailsNode();
+    node.__summary = json.summary ?? "";
+    node.__open = json.open ?? false;
+    return node;
+  }
+  exportJSON() {
+    return {
+      ...super.exportJSON(),
+      type: "details",
+      summary: this.__summary,
+      open: this.__open
+    };
+  }
+  createDOM() {
+    return stubDOM();
+  }
+  updateDOM() {
+    return false;
+  }
+}
+function headlessDecorator(type, propKeys, defaults, inline = false) {
+  class Node extends DecoratorNode {
+    constructor(key) {
+      super(key);
+      for (const k of propKeys) {
+        this[`__${k}`] = defaults[k];
+      }
+    }
+    static getType() {
+      return type;
+    }
+    static clone(node) {
+      const n = new Node(node.__key);
+      for (const k of propKeys) {
+        n[`__${k}`] = node[`__${k}`];
+      }
+      return n;
+    }
+    static importJSON(json) {
+      const node = new Node();
+      for (const k of propKeys) {
+        node[`__${k}`] = json[k] ?? defaults[k];
+      }
+      return node;
+    }
+    exportJSON() {
+      const out = { type, version: 1 };
+      for (const k of propKeys) {
+        out[k] = this[`__${k}`];
+      }
+      return out;
+    }
+    createDOM(_config) {
+      return stubDOM();
+    }
+    updateDOM() {
+      return false;
+    }
+    decorate(_editor, _config) {
+      return null;
+    }
+    isInline() {
+      return inline;
+    }
+  }
+  return Node;
+}
+const ImageNode = headlessDecorator(
+  "image",
+  ["src", "altText", "width", "height", "caption", "thumbhash", "accent"],
+  {
+    src: "",
+    altText: "",
+    width: void 0,
+    height: void 0,
+    caption: void 0,
+    thumbhash: void 0,
+    accent: void 0
+  }
+);
+const VideoNode = headlessDecorator(
+  "video",
+  ["src", "poster", "width", "height"],
+  { src: "", poster: void 0, width: void 0, height: void 0 }
+);
+const LinkCardNode = headlessDecorator(
+  "link-card",
+  ["url", "source", "id", "title", "description", "favicon", "image"],
+  {
+    url: "",
+    source: void 0,
+    id: void 0,
+    title: void 0,
+    description: void 0,
+    favicon: void 0,
+    image: void 0
+  }
+);
+const KaTeXInlineNode = headlessDecorator(
+  "katex-inline",
+  ["equation"],
+  { equation: "" },
+  true
+);
+const KaTeXBlockNode = headlessDecorator("katex-block", ["equation"], {
+  equation: ""
+});
+const MermaidNode = headlessDecorator("mermaid", ["diagram"], {
+  diagram: ""
+});
+const MentionNode = headlessDecorator(
+  "mention",
+  ["platform", "handle", "displayName"],
+  { platform: "", handle: "", displayName: void 0 },
+  true
+);
+const CodeBlockNode = headlessDecorator(
+  "code-block",
+  ["code", "language"],
+  { code: "", language: "" }
+);
+const FootnoteNode = headlessDecorator(
+  "footnote",
+  ["identifier"],
+  { identifier: "" },
+  true
+);
+const FootnoteSectionNode = headlessDecorator(
+  "footnote-section",
+  ["definitions"],
+  { definitions: {} }
+);
+const EmbedNode = headlessDecorator("embed", ["url", "source"], {
+  url: "",
+  source: null
+});
+const CodeSnippetNode = headlessDecorator("code-snippet", ["files"], {
+  files: []
+});
+const GalleryNode = headlessDecorator("gallery", ["images", "layout"], {
+  images: [],
+  layout: "grid"
+});
+const TldrawNode = headlessDecorator("tldraw", ["snapshot"], {
+  snapshot: ""
+});
+class BannerNode extends DecoratorNode {
+  constructor(key) {
+    super(key);
+    this.__bannerType = "note";
+    this.__contentState = null;
+  }
+  static getType() {
+    return "banner";
+  }
+  static clone(node) {
+    const n = new BannerNode(node.__key);
+    n.__bannerType = node.__bannerType;
+    n.__contentState = node.__contentState;
+    return n;
+  }
+  static importJSON(json) {
+    const node = new BannerNode();
+    node.__bannerType = json.bannerType ?? "note";
+    node.__contentState = json.content ?? null;
+    return node;
+  }
+  exportJSON() {
+    return {
+      type: "banner",
+      version: 1,
+      bannerType: this.__bannerType,
+      content: this.__contentState
+    };
+  }
+  createDOM() {
+    return stubDOM();
+  }
+  updateDOM() {
+    return false;
+  }
+  decorate() {
+    return null;
+  }
+  getTextContent() {
+    return extractText(this.__contentState);
+  }
+}
+class AlertQuoteNode extends DecoratorNode {
+  constructor(key) {
+    super(key);
+    this.__alertType = "note";
+    this.__contentState = null;
+  }
+  static getType() {
+    return "alert-quote";
+  }
+  static clone(node) {
+    const n = new AlertQuoteNode(node.__key);
+    n.__alertType = node.__alertType;
+    n.__contentState = node.__contentState;
+    return n;
+  }
+  static importJSON(json) {
+    const node = new AlertQuoteNode();
+    node.__alertType = json.alertType ?? "note";
+    node.__contentState = json.content ?? null;
+    return node;
+  }
+  exportJSON() {
+    return {
+      type: "alert-quote",
+      version: 1,
+      alertType: this.__alertType,
+      content: this.__contentState
+    };
+  }
+  createDOM() {
+    return stubDOM();
+  }
+  updateDOM() {
+    return false;
+  }
+  decorate() {
+    return null;
+  }
+  getTextContent() {
+    return extractText(this.__contentState);
+  }
+}
+class GridContainerNode extends DecoratorNode {
+  constructor(key) {
+    super(key);
+    this.__cols = 2;
+    this.__gap = "16px";
+    this.__cells = [];
+  }
+  static getType() {
+    return "grid-container";
+  }
+  static clone(node) {
+    const n = new GridContainerNode(node.__key);
+    n.__cols = node.__cols;
+    n.__gap = node.__gap;
+    n.__cells = node.__cells;
+    return n;
+  }
+  static importJSON(json) {
+    const node = new GridContainerNode();
+    node.__cols = json.cols ?? 2;
+    const rawGap = json.gap;
+    node.__gap = typeof rawGap === "number" ? `${rawGap}px` : rawGap ?? "16px";
+    node.__cells = json.cells ?? [];
+    return node;
+  }
+  exportJSON() {
+    return {
+      type: "grid-container",
+      version: 1,
+      cols: this.__cols,
+      gap: this.__gap,
+      cells: this.__cells
+    };
+  }
+  createDOM() {
+    return stubDOM();
+  }
+  updateDOM() {
+    return false;
+  }
+  decorate() {
+    return null;
+  }
+  getTextContent() {
+    return this.__cells.map((cell) => extractText(cell)).join("\n");
+  }
+}
+const customHeadlessNodes = [
+  SpoilerNode,
+  DetailsNode,
+  ImageNode,
+  VideoNode,
+  LinkCardNode,
+  KaTeXInlineNode,
+  KaTeXBlockNode,
+  MermaidNode,
+  MentionNode,
+  CodeBlockNode,
+  FootnoteNode,
+  FootnoteSectionNode,
+  EmbedNode,
+  CodeSnippetNode,
+  GalleryNode,
+  TldrawNode,
+  BannerNode,
+  AlertQuoteNode,
+  GridContainerNode
+];
+const allHeadlessNodes = [
+  ...builtinNodes,
+  ...customHeadlessNodes
+];
+export {
+  AlertQuoteNode,
+  BannerNode,
+  CodeBlockNode,
+  CodeSnippetNode,
+  DetailsNode,
+  EmbedNode,
+  FootnoteNode,
+  FootnoteSectionNode,
+  GalleryNode,
+  GridContainerNode,
+  ImageNode,
+  KaTeXBlockNode,
+  KaTeXInlineNode,
+  LinkCardNode,
+  MentionNode,
+  MermaidNode,
+  SpoilerNode,
+  TldrawNode,
+  VideoNode,
+  allHeadlessNodes,
+  builtinNodes,
+  customHeadlessNodes
+};

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@haklex/rich-headless",
+  "version": "0.0.11",
+  "description": "Headless Lexical node registry for server-side parsing (no React)",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@lexical/code": "^0.40.0",
+    "@lexical/extension": "^0.40.0",
+    "@lexical/link": "^0.40.0",
+    "@lexical/list": "^0.40.0",
+    "@lexical/rich-text": "^0.40.0",
+    "@lexical/table": "^0.40.0"
+  },
+  "devDependencies": {
+    "lexical": "^0.40.0",
+    "typescript": "^5.9.0",
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.0"
+  },
+  "peerDependencies": {
+    "lexical": "^0.40.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "vite build",
+    "dev:build": "vite build --watch"
+  },
+  "types": "./dist/index.d.ts"
+}