@astryxdesign/lab 0.2.0-canary.33d4e98 → 0.2.0-canary.4ffab6f

package/dist/RichTextEditor/RichTextEditor.d.ts

@@ -57,6 +57,12 @@ export interface RichTextEditorRef {
      * `$convertToMarkdownString` run in a read context.
      */
     getMarkdown: () => string;
+    /**
+     * Serialize the current content to an HTML string via
+     * `$generateHtmlFromNodes`. Requires a DOM (available in the browser and in
+     * jsdom-based tests). Useful for copy/paste, email, or non-Lexical consumers.
+     */
+    getHTML: () => string;
     /**
      * Access the underlying `LexicalEditor` instance for advanced use cases
      * (custom commands, listeners, node transforms).

package/dist/RichTextEditor/RichTextEditor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RichTextEditor.d.ts","sourceRoot":"","sources":["../../src/RichTextEditor/RichTextEditor.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAQL,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAgBf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AAkBxD,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAKnD,OAAO,KAAK,EACV,WAAW,EACX,KAAK,EACL,aAAa,EACb,WAAW,EAEZ,MAAM,SAAS,CAAC;AAoHjB,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,WAAW,CAAC;IAClC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B;;;OAGG;IACH,SAAS,EAAE,MAAM,aAAa,CAAC;CAChC;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,SAAS,EACT,UAAU,GAAG,cAAc,CAC5B;IACC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IACrE,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1C;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,cAAc,mHAuLzB,CAAC"}
+{"version":3,"file":"RichTextEditor.d.ts","sourceRoot":"","sources":["../../src/RichTextEditor/RichTextEditor.tsx"],"names":[],"mappings":"AAIA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAQL,KAAK,SAAS,EAEf,MAAM,OAAO,CAAC;AAgBf,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,oBAAoB,CAAC;AAElD,OAAO,KAAK,EAAC,SAAS,EAAC,MAAM,0BAA0B,CAAC;AAkBxD,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAC3B,YAAY,EAAC,WAAW,EAAC,MAAM,mBAAmB,CAAC;AAGnD,OAAO,KAAK,EACV,WAAW,EACX,KAAK,EACL,aAAa,EACb,WAAW,EAEZ,MAAM,SAAS,CAAC;AAwGjB,MAAM,MAAM,wBAAwB,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEvE,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAEpD,MAAM,WAAW,oBAAoB;IACnC,qCAAqC;IACrC,IAAI,EAAE,wBAAwB,CAAC;IAC/B,oDAAoD;IACpD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB;;;OAGG;IACH,KAAK,EAAE,MAAM,IAAI,CAAC;IAClB,6EAA6E;IAC7E,cAAc,EAAE,MAAM,WAAW,CAAC;IAClC;;;;;OAKG;IACH,WAAW,EAAE,MAAM,MAAM,CAAC;IAC1B;;;;OAIG;IACH,OAAO,EAAE,MAAM,MAAM,CAAC;IACtB;;;OAGG;IACH,SAAS,EAAE,MAAM,aAAa,CAAC;CAChC;AAED,MAAM,WAAW,mBAAoB,SAAQ,IAAI,CAC/C,SAAS,EACT,UAAU,GAAG,cAAc,CAC5B;IACC,qEAAqE;IACrE,KAAK,EAAE,MAAM,CAAC;IACd;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,+DAA+D;IAC/D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IACrE,uDAAuD;IACvD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B;;;OAGG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,uEAAuE;IACvE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,kBAAkB,CAAC;IAC1B;;;;OAIG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;IAC1C;;;;OAIG;IACH,OAAO,CAAC,EAAE,SAAS,CAAC;IACpB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B;;;;;;;;;;;;;;;;OAgBG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C,yEAAyE;IACzE,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,cAAc,mHAuLzB,CAAC"}

package/dist/RichTextEditor/RichTextEditor.js

@@ -44,10 +44,8 @@ import { TabIndentationPlugin } from '@lexical/react/LexicalTabIndentationPlugin
 import { MarkdownShortcutPlugin } from '@lexical/react/LexicalMarkdownShortcutPlugin';
 import { OnChangePlugin } from '@lexical/react/LexicalOnChangePlugin';
 import { TRANSFORMERS, $convertToMarkdownString } from '@lexical/markdown';
-import { ListNode, ListItemNode } from '@lexical/list';
-import { HeadingNode, QuoteNode } from '@lexical/rich-text';
-import { LinkNode, AutoLinkNode } from '@lexical/link';
-import { CodeNode, CodeHighlightNode } from '@lexical/code';
+import { $generateHtmlFromNodes } from '@lexical/html';
+import { DEFAULT_NODES } from "./editorNodes.js";
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
 /**
  * Serialized state for an empty editor: a root containing a single empty
@@ -106,9 +104,6 @@ const sizeStyles = {
   }
 };
 
-/** The default OSS node set registered with the editor. */
-const DEFAULT_NODES = [HeadingNode, QuoteNode, ListNode, ListItemNode, LinkNode, AutoLinkNode, CodeNode, CodeHighlightNode];
-
 /**
  * Fraction of `maxLength` at which the character counter begins announcing
  * remaining/over-limit characters to screen readers. Matches TextArea.
@@ -335,6 +330,11 @@ function EditorRefBridge({
     // transformers round-trip to Markdown. `@lexical/markdown` is a
     // subpackage (built dist) — safe, unlike a top-level `lexical` import.
     editor.getEditorState().read(() => $convertToMarkdownString(transformers)),
+    getHTML: () =>
+    // $generateHtmlFromNodes serializes the whole document (null selection)
+    // to HTML; must run in a read context and requires a DOM.
+    // `@lexical/html` is a subpackage (built dist) — safe.
+    editor.getEditorState().read(() => $generateHtmlFromNodes(editor, null)),
     getEditor: () => editor
   }), [editor, editable, transformers]);
   return null;

package/dist/RichTextEditor/editorNodes.d.ts

@@ -0,0 +1,8 @@
+import type { Klass, LexicalNode } from 'lexical';
+/**
+ * The default OSS node set registered with the editor: headings, quotes,
+ * lists, links, and code. Extend via the `nodes` prop / option rather than
+ * editing this list.
+ */
+export declare const DEFAULT_NODES: ReadonlyArray<Klass<LexicalNode>>;
+//# sourceMappingURL=editorNodes.d.ts.map

package/dist/RichTextEditor/editorNodes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"editorNodes.d.ts","sourceRoot":"","sources":["../../src/RichTextEditor/editorNodes.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EAAC,KAAK,EAAE,WAAW,EAAC,MAAM,SAAS,CAAC;AAEhD;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAS3D,CAAC"}

package/dist/RichTextEditor/editorNodes.js

@@ -0,0 +1,23 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file editorNodes.ts
+ * @input Imports the default Lexical node classes registered by the editor.
+ * @output Exports DEFAULT_NODES — the base OSS node set.
+ * @position Shared by RichTextEditor.tsx (editor config) and
+ *   markdownSerializers.ts (headless conversion), so both register the same
+ *   nodes and Markdown round-trips consistently.
+ *
+ * SYNC: When the default node set changes, both consumers pick it up here.
+ */
+
+import { ListNode, ListItemNode } from '@lexical/list';
+import { HeadingNode, QuoteNode } from '@lexical/rich-text';
+import { LinkNode, AutoLinkNode } from '@lexical/link';
+import { CodeNode, CodeHighlightNode } from '@lexical/code';
+/**
+ * The default OSS node set registered with the editor: headings, quotes,
+ * lists, links, and code. Extend via the `nodes` prop / option rather than
+ * editing this list.
+ */
+export const DEFAULT_NODES = [HeadingNode, QuoteNode, ListNode, ListItemNode, LinkNode, AutoLinkNode, CodeNode, CodeHighlightNode];

package/dist/RichTextEditor/index.d.ts

@@ -12,4 +12,6 @@ export type { RichTextEditorProps, RichTextEditorRef, RichTextEditorStatus, Rich
 export { RichTextView } from './RichTextView';
 export type { RichTextViewProps } from './RichTextView';
 export { sharedEditorTheme } from './editorTheme';
+export { markdownToEditorStateJSON, editorStateJSONToMarkdown, } from './markdownSerializers';
+export type { MarkdownSerializerOptions } from './markdownSerializers';
 //# sourceMappingURL=index.d.ts.map

package/dist/RichTextEditor/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/RichTextEditor/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,YAAY,EAAC,iBAAiB,EAAC,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/RichTextEditor/index.ts"],"names":[],"mappings":"AAIA;;;;;;;;GAQG;AAEH,OAAO,EAAC,cAAc,EAAC,MAAM,kBAAkB,CAAC;AAChD,YAAY,EACV,mBAAmB,EACnB,iBAAiB,EACjB,oBAAoB,EACpB,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,GACZ,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EAAC,YAAY,EAAC,MAAM,gBAAgB,CAAC;AAC5C,YAAY,EAAC,iBAAiB,EAAC,MAAM,gBAAgB,CAAC;AAEtD,OAAO,EAAC,iBAAiB,EAAC,MAAM,eAAe,CAAC;AAEhD,OAAO,EACL,yBAAyB,EACzB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAC,yBAAyB,EAAC,MAAM,uBAAuB,CAAC"}

package/dist/RichTextEditor/index.js

@@ -13,4 +13,5 @@
  */
 export { RichTextEditor } from "./RichTextEditor.js";
 export { RichTextView } from "./RichTextView.js";
-export { sharedEditorTheme } from "./editorTheme.js";
+export { sharedEditorTheme } from "./editorTheme.js";
+export { markdownToEditorStateJSON, editorStateJSONToMarkdown } from "./markdownSerializers.js";

package/dist/RichTextEditor/markdownSerializers.d.ts

@@ -0,0 +1,40 @@
+import { type Transformer } from '@lexical/markdown';
+import type { Klass, LexicalNode } from 'lexical';
+/** Options shared by the Markdown serializer helpers. */
+export interface MarkdownSerializerOptions {
+    /**
+     * Markdown transformers to use. Defaults to the standard `@lexical/markdown`
+     * `TRANSFORMERS`. Pass the same array you give `RichTextEditor`'s
+     * `transformers` prop so content round-trips consistently.
+     */
+    transformers?: ReadonlyArray<Transformer>;
+    /**
+     * Extra Lexical nodes to register beyond the default OSS set, mirroring the
+     * editor's `nodes` prop. Required for custom node types to serialize.
+     */
+    nodes?: ReadonlyArray<Klass<LexicalNode>>;
+}
+/**
+ * Convert a Markdown string to a serialized Lexical `EditorState` JSON string
+ * — the same shape `RichTextEditor`'s `defaultValue` expects. Runs headless
+ * (no DOM), so it is safe in Node / SSR.
+ *
+ * @example
+ * ```
+ * const value = markdownToEditorStateJSON('# Title\n\nHello');
+ * <RichTextEditor label="Notes" defaultValue={value} />
+ * ```
+ */
+export declare function markdownToEditorStateJSON(markdown: string, options?: MarkdownSerializerOptions): string;
+/**
+ * Convert a serialized Lexical `EditorState` JSON string (e.g. the value
+ * produced by `RichTextEditor`'s `onChange` or `defaultValue`) to a Markdown
+ * string. Runs headless (no DOM), so it is safe in Node / SSR.
+ *
+ * @example
+ * ```
+ * const md = editorStateJSONToMarkdown(savedJson);
+ * ```
+ */
+export declare function editorStateJSONToMarkdown(editorStateJSON: string, options?: MarkdownSerializerOptions): string;
+//# sourceMappingURL=markdownSerializers.d.ts.map

package/dist/RichTextEditor/markdownSerializers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"markdownSerializers.d.ts","sourceRoot":"","sources":["../../src/RichTextEditor/markdownSerializers.ts"],"names":[],"mappings":"AA0BA,OAAO,EAIL,KAAK,WAAW,EACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,KAAK,EAAC,KAAK,EAAE,WAAW,EAAC,MAAM,SAAS,CAAC;AAEhD,yDAAyD;AACzD,MAAM,WAAW,yBAAyB;IACxC;;;;OAIG;IACH,YAAY,CAAC,EAAE,aAAa,CAAC,WAAW,CAAC,CAAC;IAC1C;;;OAGG;IACH,KAAK,CAAC,EAAE,aAAa,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC;CAC3C;AAYD;;;;;;;;;;GAUG;AACH,wBAAgB,yBAAyB,CACvC,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE,yBAA8B,GACtC,MAAM,CAUR;AAED;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACvC,eAAe,EAAE,MAAM,EACvB,OAAO,GAAE,yBAA8B,GACtC,MAAM,CAKR"}

package/dist/RichTextEditor/markdownSerializers.js

@@ -0,0 +1,85 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file markdownSerializers.ts
+ * @input Uses @lexical/headless (createHeadlessEditor), @lexical/markdown
+ *   ($convertFromMarkdownString / $convertToMarkdownString), and the shared
+ *   DEFAULT_NODES set.
+ * @output Standalone Markdown <-> serialized EditorState helpers:
+ *   markdownToEditorStateJSON, editorStateJSONToMarkdown.
+ * @position Re-exported from RichTextEditor/index.ts and the @astryxdesign/lab
+ *   barrel. Complements the ref's getMarkdown() by working WITHOUT a mounted
+ *   editor (e.g. to produce a `defaultValue` from Markdown on the server).
+ *
+ * SYNC: When modified, update:
+ * - /packages/lab/src/RichTextEditor/index.ts (exports)
+ * - /packages/lab/src/index.ts (barrel re-export)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.doc.mjs (usage notes)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.test.tsx (tests)
+ *
+ * NOTE: `@lexical/headless`, `@lexical/markdown`, and `lexical` are OPTIONAL
+ * peer dependencies (this is a canary lab module). Install them to use these
+ * helpers. `@lexical/headless` runs Lexical without a DOM, so these work in
+ * Node / SSR contexts.
+ */
+
+import { createHeadlessEditor } from '@lexical/headless';
+import { TRANSFORMERS, $convertFromMarkdownString, $convertToMarkdownString } from '@lexical/markdown';
+import { DEFAULT_NODES } from "./editorNodes.js";
+
+/** Options shared by the Markdown serializer helpers. */
+
+function createSerializerEditor(nodes) {
+  return createHeadlessEditor({
+    namespace: 'astryx-editor-serializer',
+    nodes: nodes ? [...DEFAULT_NODES, ...nodes] : [...DEFAULT_NODES],
+    onError(error) {
+      throw error;
+    }
+  });
+}
+
+/**
+ * Convert a Markdown string to a serialized Lexical `EditorState` JSON string
+ * — the same shape `RichTextEditor`'s `defaultValue` expects. Runs headless
+ * (no DOM), so it is safe in Node / SSR.
+ *
+ * @example
+ * ```
+ * const value = markdownToEditorStateJSON('# Title\n\nHello');
+ * <RichTextEditor label="Notes" defaultValue={value} />
+ * ```
+ */
+export function markdownToEditorStateJSON(markdown, options = {}) {
+  const {
+    transformers = TRANSFORMERS,
+    nodes
+  } = options;
+  const editor = createSerializerEditor(nodes);
+  editor.update(() => {
+    $convertFromMarkdownString(markdown, [...transformers]);
+  }, {
+    discrete: true
+  });
+  return JSON.stringify(editor.getEditorState().toJSON());
+}
+
+/**
+ * Convert a serialized Lexical `EditorState` JSON string (e.g. the value
+ * produced by `RichTextEditor`'s `onChange` or `defaultValue`) to a Markdown
+ * string. Runs headless (no DOM), so it is safe in Node / SSR.
+ *
+ * @example
+ * ```
+ * const md = editorStateJSONToMarkdown(savedJson);
+ * ```
+ */
+export function editorStateJSONToMarkdown(editorStateJSON, options = {}) {
+  const {
+    transformers = TRANSFORMERS,
+    nodes
+  } = options;
+  const editor = createSerializerEditor(nodes);
+  const state = editor.parseEditorState(editorStateJSON);
+  return state.read(() => $convertToMarkdownString([...transformers]));
+}

package/dist/index.d.ts

@@ -28,5 +28,5 @@ export { SankeyChart, type SankeyChartProps, SankeyLink, type SankeyLinkProps, S
 export * from './Stepper';
 export * from './CircularProgress';
 export { LogStream, type LogStreamProps, type LogEntry, type LogStreamLevel, } from './LogStream';
-export { RichTextEditor, type RichTextEditorProps, type RichTextEditorRef, type RichTextEditorStatus, type RichTextEditorStatusType, type RichTextEditorSize, type Transformer, RichTextView, type RichTextViewProps, sharedEditorTheme, } from './RichTextEditor';
+export { RichTextEditor, type RichTextEditorProps, type RichTextEditorRef, type RichTextEditorStatus, type RichTextEditorStatusType, type RichTextEditorSize, type Transformer, RichTextView, type RichTextViewProps, sharedEditorTheme, markdownToEditorStateJSON, editorStateJSONToMarkdown, type MarkdownSerializerOptions, } from './RichTextEditor';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -64,4 +64,4 @@ export { LogStream } from "./LogStream/index.js";
 
 // RichTextEditor — experimental Lexical WYSIWYG editor (RFC facebook/astryx#3899)
 // Optional peer deps: lexical + @lexical/*. Read-only rendering via RichTextView.
-export { RichTextEditor, RichTextView, sharedEditorTheme } from "./RichTextEditor/index.js";
+export { RichTextEditor, RichTextView, sharedEditorTheme, markdownToEditorStateJSON, editorStateJSONToMarkdown } from "./RichTextEditor/index.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@astryxdesign/lab",
-  "version": "0.2.0-canary.33d4e98",
+  "version": "0.2.0-canary.4ffab6f",
   "description": "Experimental Astryx components — published to npm only under the @canary dist-tag for early testing; never released as a stable (latest) version.",
   "author": "Meta Open Source",
   "license": "MIT",
@@ -45,12 +45,14 @@
   },
   "peerDependencies": {
     "@stylexjs/stylex": ">=0.10.0",
-    "@astryxdesign/core": "0.2.0-canary.33d4e98",
+    "@astryxdesign/core": "0.2.0-canary.4ffab6f",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0",
     "lexical": "^0.46.0",
     "@lexical/react": "^0.46.0",
     "@lexical/markdown": "^0.46.0",
+    "@lexical/headless": "^0.46.0",
+    "@lexical/html": "^0.46.0",
     "@lexical/link": "^0.46.0",
     "@lexical/list": "^0.46.0",
     "@lexical/rich-text": "^0.46.0",
@@ -64,6 +66,8 @@
   },
   "devDependencies": {
     "@lexical/code": "^0.46.0",
+    "@lexical/headless": "^0.46.0",
+    "@lexical/html": "^0.46.0",
     "@lexical/link": "^0.46.0",
     "@lexical/list": "^0.46.0",
     "@lexical/markdown": "^0.46.0",
@@ -85,6 +89,12 @@
     "@lexical/markdown": {
       "optional": true
     },
+    "@lexical/headless": {
+      "optional": true
+    },
+    "@lexical/html": {
+      "optional": true
+    },
     "@lexical/link": {
       "optional": true
     },
@@ -102,7 +112,7 @@
     }
   },
   "scripts": {
-    "build": "rm -rf dist && pnpm build:esm && tsc --project tsconfig.build.json && pnpm build:css && node ../../scripts/check-no-dev-jsx.mjs",
+    "build": "rm -rf dist && pnpm build:esm && tsc --project tsconfig.build.json && pnpm build:css && node ../../scripts/check-no-dev-jsx.mjs && node ../../scripts/check-fully-specified.mjs",
     "build:esm": "babel src --out-dir dist --extensions .ts,.tsx --out-file-extension .js --ignore \"**/*.test.ts,**/*.test.tsx,**/__tests__/**,**/*.perf.test.*,**/*.doc.mjs,**/*.d.ts,**/*.css,**/*.css.d.ts\" --config-file ./babel.config.js",
     "build:css": "node ../../scripts/build-css.mjs --package lab",
     "dev": "babel src --watch --out-dir dist --extensions .ts,.tsx --out-file-extension .js --ignore \"**/*.test.*,**/*.doc.mjs,**/*.d.ts,**/*.css*\" --config-file ./babel.config.js",

package/src/RichTextEditor/RichTextEditor.doc.mjs

@@ -153,7 +153,12 @@ export const docs = {
       {
         guidance: true,
         description:
-          'Use a ref (RichTextEditorRef) to imperatively focus(), clear(), read the state via getEditorState(), serialize to Markdown via getMarkdown(), or reach the LexicalEditor via getEditor(). The handle is available after mount. getMarkdown() uses the same transformers prop the editor is configured with. focus() and clear() are no-ops when the editor is read-only or disabled, and clear() resets to a single empty paragraph.',
+          'Use a ref (RichTextEditorRef) to imperatively focus(), clear(), read the state via getEditorState(), serialize to Markdown via getMarkdown() or HTML via getHTML(), or reach the LexicalEditor via getEditor(). The handle is available after mount. getMarkdown() uses the same transformers prop the editor is configured with. focus() and clear() are no-ops when the editor is read-only or disabled, and clear() resets to a single empty paragraph.',
+      },
+      {
+        guidance: true,
+        description:
+          'To produce a defaultValue from Markdown without mounting an editor (e.g. on the server), use markdownToEditorStateJSON(markdown). Convert the other way with editorStateJSONToMarkdown(json). Both run headless via @lexical/headless and accept the same transformers/nodes options as the editor.',
       },
       {
         guidance: false,

package/src/RichTextEditor/RichTextEditor.test.tsx

@@ -22,6 +22,10 @@ import {
 } from '@lexical/markdown';
 import {RichTextEditor, type RichTextEditorRef} from './RichTextEditor';
 import {RichTextView} from './RichTextView';
+import {
+  markdownToEditorStateJSON,
+  editorStateJSONToMarkdown,
+} from './markdownSerializers';
 
 // Small plugin that captures the editor instance so tests can drive real
 // Lexical updates (jsdom does not implement contenteditable editing).
@@ -342,6 +346,7 @@ describe('RichTextEditor', () => {
     expect(typeof ref.current?.clear).toBe('function');
     expect(typeof ref.current?.getEditorState).toBe('function');
     expect(typeof ref.current?.getMarkdown).toBe('function');
+    expect(typeof ref.current?.getHTML).toBe('function');
     expect(typeof ref.current?.getEditor).toBe('function');
   });
 
@@ -426,6 +431,18 @@ describe('RichTextEditor', () => {
     await waitFor(() => expect(ref.current?.getMarkdown()).toBe('Title'));
   });
 
+  it('ref.getHTML() serializes content to an HTML string', () => {
+    const ref = createRef<RichTextEditorRef>();
+    render(
+      <RichTextEditor ref={ref} label="Notes" defaultValue={HELLO_STATE} />,
+    );
+    const html = ref.current?.getHTML();
+    expect(typeof html).toBe('string');
+    // A paragraph with the seeded text renders as a <p> containing "Hello world".
+    expect(html).toContain('<p');
+    expect(html).toContain('Hello world');
+  });
+
   it('ref.clear() resets the editor to a single empty paragraph', async () => {
     const ref = createRef<RichTextEditorRef>();
     render(
@@ -648,3 +665,42 @@ describe('RichTextView', () => {
     expect(screen.queryByRole('textbox')).not.toBeInTheDocument();
   });
 });
+
+describe('markdown serializers', () => {
+  it('markdownToEditorStateJSON produces a heading node from "# "', () => {
+    const json = markdownToEditorStateJSON('# Title');
+    const parsed = JSON.parse(json);
+    const first = parsed.root.children[0];
+    expect(first.type).toBe('heading');
+    expect(first.tag).toBe('h1');
+    expect(first.children[0].text).toBe('Title');
+  });
+
+  it('editorStateJSONToMarkdown round-trips a heading back to "# "', () => {
+    const json = markdownToEditorStateJSON('# Title');
+    expect(editorStateJSONToMarkdown(json)).toBe('# Title');
+  });
+
+  it('markdown round-trips through both helpers', () => {
+    const md = '# Heading\n\nSome **bold** text';
+    const json = markdownToEditorStateJSON(md);
+    expect(editorStateJSONToMarkdown(json)).toBe(md);
+  });
+
+  it('honors a custom (empty) transformers set — no heading syntax', () => {
+    // With no transformers, "# Title" is not recognized as a heading; it stays
+    // a plain paragraph, so serializing back yields the literal text.
+    const json = markdownToEditorStateJSON('# Title', {transformers: []});
+    const parsed = JSON.parse(json);
+    expect(parsed.root.children[0].type).toBe('paragraph');
+    expect(parsed.root.children[0].children[0].text).toBe('# Title');
+  });
+
+  it('produces JSON consumable as RichTextEditor defaultValue', async () => {
+    const value = markdownToEditorStateJSON('Hello world');
+    render(<RichTextEditor label="Notes" defaultValue={value} />);
+    await waitFor(() =>
+      expect(screen.getByRole('textbox').textContent).toContain('Hello world'),
+    );
+  });
+});

package/src/RichTextEditor/RichTextEditor.tsx

@@ -76,10 +76,8 @@ import {
   type Transformer,
 } from '@lexical/markdown';
 export type {Transformer} from '@lexical/markdown';
-import {ListNode, ListItemNode} from '@lexical/list';
-import {HeadingNode, QuoteNode} from '@lexical/rich-text';
-import {LinkNode, AutoLinkNode} from '@lexical/link';
-import {CodeNode, CodeHighlightNode} from '@lexical/code';
+import {$generateHtmlFromNodes} from '@lexical/html';
+import {DEFAULT_NODES} from './editorNodes';
 import type {
   EditorState,
   Klass,
@@ -184,18 +182,6 @@ const sizeStyles = stylex.create({
   },
 });
 
-/** The default OSS node set registered with the editor. */
-const DEFAULT_NODES: ReadonlyArray<Klass<LexicalNode>> = [
-  HeadingNode,
-  QuoteNode,
-  ListNode,
-  ListItemNode,
-  LinkNode,
-  AutoLinkNode,
-  CodeNode,
-  CodeHighlightNode,
-];
-
 /**
  * Fraction of `maxLength` at which the character counter begins announcing
  * remaining/over-limit characters to screen readers. Matches TextArea.
@@ -237,6 +223,12 @@ export interface RichTextEditorRef {
    * `$convertToMarkdownString` run in a read context.
    */
   getMarkdown: () => string;
+  /**
+   * Serialize the current content to an HTML string via
+   * `$generateHtmlFromNodes`. Requires a DOM (available in the browser and in
+   * jsdom-based tests). Useful for copy/paste, email, or non-Lexical consumers.
+   */
+  getHTML: () => string;
   /**
    * Access the underlying `LexicalEditor` instance for advanced use cases
    * (custom commands, listeners, node transforms).
@@ -633,6 +625,11 @@ function EditorRefBridge({
         editor
           .getEditorState()
           .read(() => $convertToMarkdownString(transformers)),
+      getHTML: () =>
+        // $generateHtmlFromNodes serializes the whole document (null selection)
+        // to HTML; must run in a read context and requires a DOM.
+        // `@lexical/html` is a subpackage (built dist) — safe.
+        editor.getEditorState().read(() => $generateHtmlFromNodes(editor, null)),
       getEditor: () => editor,
     }),
     [editor, editable, transformers],

package/src/RichTextEditor/editorNodes.ts

@@ -0,0 +1,34 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file editorNodes.ts
+ * @input Imports the default Lexical node classes registered by the editor.
+ * @output Exports DEFAULT_NODES — the base OSS node set.
+ * @position Shared by RichTextEditor.tsx (editor config) and
+ *   markdownSerializers.ts (headless conversion), so both register the same
+ *   nodes and Markdown round-trips consistently.
+ *
+ * SYNC: When the default node set changes, both consumers pick it up here.
+ */
+
+import {ListNode, ListItemNode} from '@lexical/list';
+import {HeadingNode, QuoteNode} from '@lexical/rich-text';
+import {LinkNode, AutoLinkNode} from '@lexical/link';
+import {CodeNode, CodeHighlightNode} from '@lexical/code';
+import type {Klass, LexicalNode} from 'lexical';
+
+/**
+ * The default OSS node set registered with the editor: headings, quotes,
+ * lists, links, and code. Extend via the `nodes` prop / option rather than
+ * editing this list.
+ */
+export const DEFAULT_NODES: ReadonlyArray<Klass<LexicalNode>> = [
+  HeadingNode,
+  QuoteNode,
+  ListNode,
+  ListItemNode,
+  LinkNode,
+  AutoLinkNode,
+  CodeNode,
+  CodeHighlightNode,
+];

package/src/RichTextEditor/index.ts

@@ -26,3 +26,9 @@ export {RichTextView} from './RichTextView';
 export type {RichTextViewProps} from './RichTextView';
 
 export {sharedEditorTheme} from './editorTheme';
+
+export {
+  markdownToEditorStateJSON,
+  editorStateJSONToMarkdown,
+} from './markdownSerializers';
+export type {MarkdownSerializerOptions} from './markdownSerializers';

package/src/RichTextEditor/markdownSerializers.ts

@@ -0,0 +1,105 @@
+// Copyright (c) Meta Platforms, Inc. and affiliates.
+
+/**
+ * @file markdownSerializers.ts
+ * @input Uses @lexical/headless (createHeadlessEditor), @lexical/markdown
+ *   ($convertFromMarkdownString / $convertToMarkdownString), and the shared
+ *   DEFAULT_NODES set.
+ * @output Standalone Markdown <-> serialized EditorState helpers:
+ *   markdownToEditorStateJSON, editorStateJSONToMarkdown.
+ * @position Re-exported from RichTextEditor/index.ts and the @astryxdesign/lab
+ *   barrel. Complements the ref's getMarkdown() by working WITHOUT a mounted
+ *   editor (e.g. to produce a `defaultValue` from Markdown on the server).
+ *
+ * SYNC: When modified, update:
+ * - /packages/lab/src/RichTextEditor/index.ts (exports)
+ * - /packages/lab/src/index.ts (barrel re-export)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.doc.mjs (usage notes)
+ * - /packages/lab/src/RichTextEditor/RichTextEditor.test.tsx (tests)
+ *
+ * NOTE: `@lexical/headless`, `@lexical/markdown`, and `lexical` are OPTIONAL
+ * peer dependencies (this is a canary lab module). Install them to use these
+ * helpers. `@lexical/headless` runs Lexical without a DOM, so these work in
+ * Node / SSR contexts.
+ */
+
+import {createHeadlessEditor} from '@lexical/headless';
+import {
+  TRANSFORMERS,
+  $convertFromMarkdownString,
+  $convertToMarkdownString,
+  type Transformer,
+} from '@lexical/markdown';
+import {DEFAULT_NODES} from './editorNodes';
+import type {Klass, LexicalNode} from 'lexical';
+
+/** Options shared by the Markdown serializer helpers. */
+export interface MarkdownSerializerOptions {
+  /**
+   * Markdown transformers to use. Defaults to the standard `@lexical/markdown`
+   * `TRANSFORMERS`. Pass the same array you give `RichTextEditor`'s
+   * `transformers` prop so content round-trips consistently.
+   */
+  transformers?: ReadonlyArray<Transformer>;
+  /**
+   * Extra Lexical nodes to register beyond the default OSS set, mirroring the
+   * editor's `nodes` prop. Required for custom node types to serialize.
+   */
+  nodes?: ReadonlyArray<Klass<LexicalNode>>;
+}
+
+function createSerializerEditor(nodes?: ReadonlyArray<Klass<LexicalNode>>) {
+  return createHeadlessEditor({
+    namespace: 'astryx-editor-serializer',
+    nodes: nodes ? [...DEFAULT_NODES, ...nodes] : [...DEFAULT_NODES],
+    onError(error: Error) {
+      throw error;
+    },
+  });
+}
+
+/**
+ * Convert a Markdown string to a serialized Lexical `EditorState` JSON string
+ * — the same shape `RichTextEditor`'s `defaultValue` expects. Runs headless
+ * (no DOM), so it is safe in Node / SSR.
+ *
+ * @example
+ * ```
+ * const value = markdownToEditorStateJSON('# Title\n\nHello');
+ * <RichTextEditor label="Notes" defaultValue={value} />
+ * ```
+ */
+export function markdownToEditorStateJSON(
+  markdown: string,
+  options: MarkdownSerializerOptions = {},
+): string {
+  const {transformers = TRANSFORMERS, nodes} = options;
+  const editor = createSerializerEditor(nodes);
+  editor.update(
+    () => {
+      $convertFromMarkdownString(markdown, [...transformers]);
+    },
+    {discrete: true},
+  );
+  return JSON.stringify(editor.getEditorState().toJSON());
+}
+
+/**
+ * Convert a serialized Lexical `EditorState` JSON string (e.g. the value
+ * produced by `RichTextEditor`'s `onChange` or `defaultValue`) to a Markdown
+ * string. Runs headless (no DOM), so it is safe in Node / SSR.
+ *
+ * @example
+ * ```
+ * const md = editorStateJSONToMarkdown(savedJson);
+ * ```
+ */
+export function editorStateJSONToMarkdown(
+  editorStateJSON: string,
+  options: MarkdownSerializerOptions = {},
+): string {
+  const {transformers = TRANSFORMERS, nodes} = options;
+  const editor = createSerializerEditor(nodes);
+  const state = editor.parseEditorState(editorStateJSON);
+  return state.read(() => $convertToMarkdownString([...transformers]));
+}

package/src/index.ts

@@ -246,4 +246,7 @@ export {
   RichTextView,
   type RichTextViewProps,
   sharedEditorTheme,
+  markdownToEditorStateJSON,
+  editorStateJSONToMarkdown,
+  type MarkdownSerializerOptions,
 } from './RichTextEditor';