@mdxeditor/editor 0.10.1 → 0.11.1-alpha.1

package/dist/plugins/jsx/index.d.ts

@@ -0,0 +1,598 @@
+import type { Options } from 'mdast-util-to-markdown';
+import type { Config } from 'mdast-util-from-markdown/lib';
+import type { Extension } from 'micromark-util-types';
+import type { Content } from 'mdast';
+import type { MdastImportVisitor, LexicalVisitor } from '../..';
+import type { EditorSubscription, EditorInFocus, BlockType } from '../core';
+import type { InitialEditorStateType } from '@lexical/react/LexicalComposer';
+import type { HistoryState } from '@lexical/history';
+import type { LexicalEditor, RangeSelection, Klass, LexicalNode, TextFormatType, ElementNode, DecoratorNode } from 'lexical';
+import type { SystemSpec, Realm, RealmNode, PluginConstructor, TypedRealm, ValueForKey, SystemKeys, ValuesForKeys, SystemDict } from '../../gurx';
+import type { MdxJsxFlowElement, MdxJsxTextElement } from 'mdast-util-mdx-jsx';
+import React from 'react';
+/**
+ * @internal
+ */
+export type MdastJsx = MdxJsxTextElement | MdxJsxFlowElement;
+/**
+ * Defines the structure of a JSX component property.
+ */
+export interface JsxPropertyDescriptor {
+    /**
+     * The name of the property
+     */
+    name: string;
+    /**
+     * The type of the property
+     */
+    type: 'string' | 'number';
+    /**
+     * Wether the property is required
+     */
+    required?: boolean;
+}
+/**
+ * Defines the structure of a JSX component that can be used within the markdown document.
+ */
+export interface JsxComponentDescriptor {
+    /**
+     * The tag name
+     */
+    name: string;
+    /**
+     * Wether the component is a flow or text component (inline or block)
+     */
+    kind: 'flow' | 'text';
+    /**
+     * The module path from which the component can be imported
+     */
+    source: string;
+    /**
+     * Wether the component is the default export of the module
+     */
+    defaultExport?: boolean;
+    /**
+     * The properties that can be applied to the component
+     */
+    props: JsxPropertyDescriptor[];
+    /**
+     * Wether or not the component has children
+     */
+    hasChildren?: boolean;
+    /**
+     * The editor to use for editing the component
+     */
+    Editor: React.ComponentType<JsxEditorProps>;
+}
+/**
+ * The properties passed to a JSX Editor component.
+ */
+export interface JsxEditorProps {
+    /** The MDAST node to edit */
+    mdastNode: MdastJsx;
+    descriptor: JsxComponentDescriptor;
+}
+interface InsertJsxPayload {
+    name: string;
+    kind: 'flow' | 'text';
+    props: Record<string, string>;
+}
+/** @internal */
+export declare const jsxSystem: SystemSpec<[SystemSpec<[], (r: Realm) => {
+    activeEditor: RealmNode<LexicalEditor | null>;
+    inFocus: RealmNode<boolean>;
+    historyState: RealmNode<HistoryState>;
+    currentSelection: RealmNode<RangeSelection | null>;
+    jsxIsAvailable: RealmNode<boolean>;
+    jsxComponentDescriptors: RealmNode<JsxComponentDescriptor[]>;
+    initialRootEditorState: RealmNode<InitialEditorStateType>;
+    rootEditor: RealmNode<LexicalEditor | null>;
+    createRootEditorSubscription: RealmNode<EditorSubscription>;
+    createActiveEditorSubscription: RealmNode<EditorSubscription>;
+    importVisitors: RealmNode<MdastImportVisitor<Content>[]>;
+    syntaxExtensions: RealmNode<Extension[]>;
+    mdastExtensions: RealmNode<(Partial<Config> | Partial<Config>[])[] | null | undefined>;
+    usedLexicalNodes: RealmNode<Klass<LexicalNode>[]>;
+    addImportVisitor: RealmNode<MdastImportVisitor<Content>>;
+    addLexicalNode: RealmNode<Klass<LexicalNode>>;
+    addSyntaxExtension: RealmNode<Extension>;
+    addMdastExtension: RealmNode<Partial<Config> | Partial<Config>[]>;
+    toMarkdownExtensions: RealmNode<Options[]>;
+    toMarkdownOptions: RealmNode<Options>;
+    addToMarkdownExtension: RealmNode<Options>;
+    addExportVisitor: RealmNode<LexicalVisitor>;
+    exportVisitors: RealmNode<LexicalVisitor[]>;
+    initialMarkdown: RealmNode<string>;
+    setMarkdown: RealmNode<string>;
+    markdown: RealmNode<string>;
+    editorRootElementRef: RealmNode<React.RefObject<HTMLDivElement> | null>;
+    contentEditableClassName: RealmNode<string>;
+    composerChildren: RealmNode<React.ComponentType<{}>[]>;
+    addComposerChild: RealmNode<React.ComponentType<{}>>;
+    topAreaChildren: RealmNode<React.ComponentType<{}>[]>;
+    addTopAreaChild: RealmNode<React.ComponentType<{}>>;
+    nestedEditorChildren: RealmNode<React.ComponentType<{}>[]>;
+    addNestedEditorChild: RealmNode<React.ComponentType<{}>>;
+    editorWrappers: RealmNode<React.ComponentType<{
+        children: React.ReactNode;
+    }>[]>;
+    addEditorWrapper: RealmNode<React.ComponentType<{
+        children: React.ReactNode;
+    }>>;
+    currentFormat: RealmNode<number>;
+    editorInFocus: RealmNode<EditorInFocus | null>;
+    applyFormat: RealmNode<TextFormatType>;
+    currentBlockType: RealmNode<BlockType>;
+    applyBlockType: RealmNode<BlockType>;
+    convertSelectionToNode: RealmNode<() => ElementNode>;
+    insertDecoratorNode: RealmNode<() => DecoratorNode<unknown>>;
+}>], (r: Realm, [{ insertDecoratorNode }]: [{
+    activeEditor: RealmNode<LexicalEditor | null>;
+    inFocus: RealmNode<boolean>;
+    historyState: RealmNode<HistoryState>;
+    currentSelection: RealmNode<RangeSelection | null>;
+    jsxIsAvailable: RealmNode<boolean>;
+    jsxComponentDescriptors: RealmNode<JsxComponentDescriptor[]>;
+    initialRootEditorState: RealmNode<InitialEditorStateType>;
+    rootEditor: RealmNode<LexicalEditor | null>;
+    createRootEditorSubscription: RealmNode<EditorSubscription>;
+    createActiveEditorSubscription: RealmNode<EditorSubscription>;
+    importVisitors: RealmNode<MdastImportVisitor<Content>[]>;
+    syntaxExtensions: RealmNode<Extension[]>;
+    mdastExtensions: RealmNode<(Partial<Config> | Partial<Config>[])[] | null | undefined>;
+    usedLexicalNodes: RealmNode<Klass<LexicalNode>[]>;
+    addImportVisitor: RealmNode<MdastImportVisitor<Content>>;
+    addLexicalNode: RealmNode<Klass<LexicalNode>>;
+    addSyntaxExtension: RealmNode<Extension>;
+    addMdastExtension: RealmNode<Partial<Config> | Partial<Config>[]>;
+    toMarkdownExtensions: RealmNode<Options[]>;
+    toMarkdownOptions: RealmNode<Options>;
+    addToMarkdownExtension: RealmNode<Options>;
+    addExportVisitor: RealmNode<LexicalVisitor>;
+    exportVisitors: RealmNode<LexicalVisitor[]>;
+    initialMarkdown: RealmNode<string>;
+    setMarkdown: RealmNode<string>;
+    markdown: RealmNode<string>;
+    editorRootElementRef: RealmNode<React.RefObject<HTMLDivElement> | null>;
+    contentEditableClassName: RealmNode<string>;
+    composerChildren: RealmNode<React.ComponentType<{}>[]>;
+    addComposerChild: RealmNode<React.ComponentType<{}>>;
+    topAreaChildren: RealmNode<React.ComponentType<{}>[]>;
+    addTopAreaChild: RealmNode<React.ComponentType<{}>>;
+    nestedEditorChildren: RealmNode<React.ComponentType<{}>[]>;
+    addNestedEditorChild: RealmNode<React.ComponentType<{}>>;
+    editorWrappers: RealmNode<React.ComponentType<{
+        children: React.ReactNode;
+    }>[]>;
+    addEditorWrapper: RealmNode<React.ComponentType<{
+        children: React.ReactNode;
+    }>>;
+    currentFormat: RealmNode<number>;
+    editorInFocus: RealmNode<EditorInFocus | null>;
+    applyFormat: RealmNode<TextFormatType>;
+    currentBlockType: RealmNode<BlockType>;
+    applyBlockType: RealmNode<BlockType>;
+    convertSelectionToNode: RealmNode<() => ElementNode>;
+    insertDecoratorNode: RealmNode<() => DecoratorNode<unknown>>;
+}]) => {
+    insertJsx: RealmNode<InsertJsxPayload>;
+}>;
+/**
+ * The parameters of the `jsxPlugin`.
+ */
+export interface JsxPluginParams {
+    /**
+     * A set of descriptors that document the JSX elements used in the document.
+     */
+    jsxComponentDescriptors: JsxComponentDescriptor[];
+}
+export declare const 
+/** @internal */
+jsxPlugin: PluginConstructor<SystemSpec<[SystemSpec<[], (r: Realm) => {
+    activeEditor: RealmNode<LexicalEditor | null>;
+    inFocus: RealmNode<boolean>;
+    historyState: RealmNode<HistoryState>;
+    currentSelection: RealmNode<RangeSelection | null>;
+    jsxIsAvailable: RealmNode<boolean>;
+    jsxComponentDescriptors: RealmNode<JsxComponentDescriptor[]>;
+    initialRootEditorState: RealmNode<InitialEditorStateType>;
+    rootEditor: RealmNode<LexicalEditor | null>;
+    createRootEditorSubscription: RealmNode<EditorSubscription>;
+    createActiveEditorSubscription: RealmNode<EditorSubscription>;
+    importVisitors: RealmNode<MdastImportVisitor<Content>[]>;
+    syntaxExtensions: RealmNode<Extension[]>;
+    mdastExtensions: RealmNode<(Partial<Config> | Partial<Config>[])[] | null | undefined>;
+    usedLexicalNodes: RealmNode<Klass<LexicalNode>[]>;
+    addImportVisitor: RealmNode<MdastImportVisitor<Content>>;
+    addLexicalNode: RealmNode<Klass<LexicalNode>>;
+    addSyntaxExtension: RealmNode<Extension>;
+    addMdastExtension: RealmNode<Partial<Config> | Partial<Config>[]>;
+    toMarkdownExtensions: RealmNode<Options[]>;
+    toMarkdownOptions: RealmNode<Options>;
+    addToMarkdownExtension: RealmNode<Options>;
+    addExportVisitor: RealmNode<LexicalVisitor>;
+    exportVisitors: RealmNode<LexicalVisitor[]>;
+    initialMarkdown: RealmNode<string>;
+    setMarkdown: RealmNode<string>;
+    markdown: RealmNode<string>;
+    editorRootElementRef: RealmNode<React.RefObject<HTMLDivElement> | null>;
+    contentEditableClassName: RealmNode<string>;
+    composerChildren: RealmNode<React.ComponentType<{}>[]>;
+    addComposerChild: RealmNode<React.ComponentType<{}>>;
+    topAreaChildren: RealmNode<React.ComponentType<{}>[]>;
+    addTopAreaChild: RealmNode<React.ComponentType<{}>>;
+    nestedEditorChildren: RealmNode<React.ComponentType<{}>[]>;
+    addNestedEditorChild: RealmNode<React.ComponentType<{}>>;
+    editorWrappers: RealmNode<React.ComponentType<{
+        children: React.ReactNode;
+    }>[]>;
+    addEditorWrapper: RealmNode<React.ComponentType<{
+        children: React.ReactNode;
+    }>>;
+    currentFormat: RealmNode<number>;
+    editorInFocus: RealmNode<EditorInFocus | null>;
+    applyFormat: RealmNode<TextFormatType>;
+    currentBlockType: RealmNode<BlockType>;
+    applyBlockType: RealmNode<BlockType>;
+    convertSelectionToNode: RealmNode<() => ElementNode>;
+    insertDecoratorNode: RealmNode<() => DecoratorNode<unknown>>;
+}>], (r: Realm, [{ insertDecoratorNode }]: [{
+    activeEditor: RealmNode<LexicalEditor | null>;
+    inFocus: RealmNode<boolean>;
+    historyState: RealmNode<HistoryState>;
+    currentSelection: RealmNode<RangeSelection | null>;
+    jsxIsAvailable: RealmNode<boolean>;
+    jsxComponentDescriptors: RealmNode<JsxComponentDescriptor[]>;
+    initialRootEditorState: RealmNode<InitialEditorStateType>;
+    rootEditor: RealmNode<LexicalEditor | null>;
+    createRootEditorSubscription: RealmNode<EditorSubscription>;
+    createActiveEditorSubscription: RealmNode<EditorSubscription>;
+    importVisitors: RealmNode<MdastImportVisitor<Content>[]>;
+    syntaxExtensions: RealmNode<Extension[]>;
+    mdastExtensions: RealmNode<(Partial<Config> | Partial<Config>[])[] | null | undefined>;
+    usedLexicalNodes: RealmNode<Klass<LexicalNode>[]>;
+    addImportVisitor: RealmNode<MdastImportVisitor<Content>>;
+    addLexicalNode: RealmNode<Klass<LexicalNode>>;
+    addSyntaxExtension: RealmNode<Extension>;
+    addMdastExtension: RealmNode<Partial<Config> | Partial<Config>[]>;
+    toMarkdownExtensions: RealmNode<Options[]>;
+    toMarkdownOptions: RealmNode<Options>;
+    addToMarkdownExtension: RealmNode<Options>;
+    addExportVisitor: RealmNode<LexicalVisitor>;
+    exportVisitors: RealmNode<LexicalVisitor[]>;
+    initialMarkdown: RealmNode<string>;
+    setMarkdown: RealmNode<string>;
+    markdown: RealmNode<string>;
+    editorRootElementRef: RealmNode<React.RefObject<HTMLDivElement> | null>;
+    contentEditableClassName: RealmNode<string>;
+    composerChildren: RealmNode<React.ComponentType<{}>[]>;
+    addComposerChild: RealmNode<React.ComponentType<{}>>;
+    topAreaChildren: RealmNode<React.ComponentType<{}>[]>;
+    addTopAreaChild: RealmNode<React.ComponentType<{}>>;
+    nestedEditorChildren: RealmNode<React.ComponentType<{}>[]>;
+    addNestedEditorChild: RealmNode<React.ComponentType<{}>>;
+    editorWrappers: RealmNode<React.ComponentType<{
+        children: React.ReactNode;
+    }>[]>;
+    addEditorWrapper: RealmNode<React.ComponentType<{
+        children: React.ReactNode;
+    }>>;
+    currentFormat: RealmNode<number>;
+    editorInFocus: RealmNode<EditorInFocus | null>;
+    applyFormat: RealmNode<TextFormatType>;
+    currentBlockType: RealmNode<BlockType>;
+    applyBlockType: RealmNode<BlockType>;
+    convertSelectionToNode: RealmNode<() => ElementNode>;
+    insertDecoratorNode: RealmNode<() => DecoratorNode<unknown>>;
+}]) => {
+    insertJsx: RealmNode<InsertJsxPayload>;
+}>, JsxPluginParams>, 
+/** @internal */
+jsxPluginHooks: {
+    useRealmContext: () => TypedRealm<{
+        insertJsx: RealmNode<InsertJsxPayload>;
+    } & {
+        activeEditor: RealmNode<LexicalEditor | null>;
+        inFocus: RealmNode<boolean>;
+        historyState: RealmNode<HistoryState>;
+        currentSelection: RealmNode<RangeSelection | null>;
+        jsxIsAvailable: RealmNode<boolean>;
+        jsxComponentDescriptors: RealmNode<JsxComponentDescriptor[]>;
+        initialRootEditorState: RealmNode<InitialEditorStateType>;
+        rootEditor: RealmNode<LexicalEditor | null>;
+        createRootEditorSubscription: RealmNode<EditorSubscription>;
+        createActiveEditorSubscription: RealmNode<EditorSubscription>;
+        importVisitors: RealmNode<MdastImportVisitor<Content>[]>;
+        syntaxExtensions: RealmNode<Extension[]>;
+        mdastExtensions: RealmNode<(Partial<Config> | Partial<Config>[])[] | null | undefined>;
+        usedLexicalNodes: RealmNode<Klass<LexicalNode>[]>;
+        addImportVisitor: RealmNode<MdastImportVisitor<Content>>;
+        addLexicalNode: RealmNode<Klass<LexicalNode>>;
+        addSyntaxExtension: RealmNode<Extension>;
+        addMdastExtension: RealmNode<Partial<Config> | Partial<Config>[]>;
+        toMarkdownExtensions: RealmNode<Options[]>;
+        toMarkdownOptions: RealmNode<Options>;
+        addToMarkdownExtension: RealmNode<Options>;
+        addExportVisitor: RealmNode<LexicalVisitor>;
+        exportVisitors: RealmNode<LexicalVisitor[]>;
+        initialMarkdown: RealmNode<string>;
+        setMarkdown: RealmNode<string>;
+        markdown: RealmNode<string>;
+        editorRootElementRef: RealmNode<React.RefObject<HTMLDivElement> | null>;
+        contentEditableClassName: RealmNode<string>;
+        composerChildren: RealmNode<React.ComponentType<{}>[]>;
+        addComposerChild: RealmNode<React.ComponentType<{}>>;
+        topAreaChildren: RealmNode<React.ComponentType<{}>[]>;
+        addTopAreaChild: RealmNode<React.ComponentType<{}>>;
+        nestedEditorChildren: RealmNode<React.ComponentType<{}>[]>;
+        addNestedEditorChild: RealmNode<React.ComponentType<{}>>;
+        editorWrappers: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>[]>;
+        addEditorWrapper: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>>;
+        currentFormat: RealmNode<number>;
+        editorInFocus: RealmNode<EditorInFocus | null>;
+        applyFormat: RealmNode<TextFormatType>;
+        currentBlockType: RealmNode<BlockType>;
+        applyBlockType: RealmNode<BlockType>;
+        convertSelectionToNode: RealmNode<() => ElementNode>;
+        insertDecoratorNode: RealmNode<() => DecoratorNode<unknown>>;
+    }>;
+    useEmitter: <K extends "jsxComponentDescriptors" | "jsxIsAvailable" | "toMarkdownOptions" | "toMarkdownExtensions" | "mdastExtensions" | "syntaxExtensions" | "markdown" | "activeEditor" | "inFocus" | "historyState" | "currentSelection" | "initialRootEditorState" | "rootEditor" | "createRootEditorSubscription" | "createActiveEditorSubscription" | "importVisitors" | "usedLexicalNodes" | "addImportVisitor" | "addLexicalNode" | "addSyntaxExtension" | "addMdastExtension" | "addToMarkdownExtension" | "addExportVisitor" | "exportVisitors" | "initialMarkdown" | "setMarkdown" | "editorRootElementRef" | "contentEditableClassName" | "composerChildren" | "addComposerChild" | "topAreaChildren" | "addTopAreaChild" | "nestedEditorChildren" | "addNestedEditorChild" | "editorWrappers" | "addEditorWrapper" | "currentFormat" | "editorInFocus" | "applyFormat" | "currentBlockType" | "applyBlockType" | "convertSelectionToNode" | "insertDecoratorNode" | "insertJsx">(key: K, callback: (value: ValueForKey<{
+        insertJsx: RealmNode<InsertJsxPayload>;
+    } & {
+        activeEditor: RealmNode<LexicalEditor | null>;
+        inFocus: RealmNode<boolean>;
+        historyState: RealmNode<HistoryState>;
+        currentSelection: RealmNode<RangeSelection | null>;
+        jsxIsAvailable: RealmNode<boolean>;
+        jsxComponentDescriptors: RealmNode<JsxComponentDescriptor[]>;
+        initialRootEditorState: RealmNode<InitialEditorStateType>;
+        rootEditor: RealmNode<LexicalEditor | null>;
+        createRootEditorSubscription: RealmNode<EditorSubscription>;
+        createActiveEditorSubscription: RealmNode<EditorSubscription>;
+        importVisitors: RealmNode<MdastImportVisitor<Content>[]>;
+        syntaxExtensions: RealmNode<Extension[]>;
+        mdastExtensions: RealmNode<(Partial<Config> | Partial<Config>[])[] | null | undefined>;
+        usedLexicalNodes: RealmNode<Klass<LexicalNode>[]>;
+        addImportVisitor: RealmNode<MdastImportVisitor<Content>>;
+        addLexicalNode: RealmNode<Klass<LexicalNode>>;
+        addSyntaxExtension: RealmNode<Extension>;
+        addMdastExtension: RealmNode<Partial<Config> | Partial<Config>[]>;
+        toMarkdownExtensions: RealmNode<Options[]>;
+        toMarkdownOptions: RealmNode<Options>;
+        addToMarkdownExtension: RealmNode<Options>;
+        addExportVisitor: RealmNode<LexicalVisitor>;
+        exportVisitors: RealmNode<LexicalVisitor[]>;
+        initialMarkdown: RealmNode<string>;
+        setMarkdown: RealmNode<string>;
+        markdown: RealmNode<string>;
+        editorRootElementRef: RealmNode<React.RefObject<HTMLDivElement> | null>;
+        contentEditableClassName: RealmNode<string>;
+        composerChildren: RealmNode<React.ComponentType<{}>[]>;
+        addComposerChild: RealmNode<React.ComponentType<{}>>;
+        topAreaChildren: RealmNode<React.ComponentType<{}>[]>;
+        addTopAreaChild: RealmNode<React.ComponentType<{}>>;
+        nestedEditorChildren: RealmNode<React.ComponentType<{}>[]>;
+        addNestedEditorChild: RealmNode<React.ComponentType<{}>>;
+        editorWrappers: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>[]>;
+        addEditorWrapper: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>>;
+        currentFormat: RealmNode<number>;
+        editorInFocus: RealmNode<EditorInFocus | null>;
+        applyFormat: RealmNode<TextFormatType>;
+        currentBlockType: RealmNode<BlockType>;
+        applyBlockType: RealmNode<BlockType>;
+        convertSelectionToNode: RealmNode<() => ElementNode>;
+        insertDecoratorNode: RealmNode<() => DecoratorNode<unknown>>;
+    }, K>) => void) => void;
+    useEmitterValues: <K_1 extends SystemKeys<{
+        insertJsx: RealmNode<InsertJsxPayload>;
+    } & {
+        activeEditor: RealmNode<LexicalEditor | null>;
+        inFocus: RealmNode<boolean>;
+        historyState: RealmNode<HistoryState>;
+        currentSelection: RealmNode<RangeSelection | null>;
+        jsxIsAvailable: RealmNode<boolean>;
+        jsxComponentDescriptors: RealmNode<JsxComponentDescriptor[]>;
+        initialRootEditorState: RealmNode<InitialEditorStateType>;
+        rootEditor: RealmNode<LexicalEditor | null>;
+        createRootEditorSubscription: RealmNode<EditorSubscription>;
+        createActiveEditorSubscription: RealmNode<EditorSubscription>;
+        importVisitors: RealmNode<MdastImportVisitor<Content>[]>;
+        syntaxExtensions: RealmNode<Extension[]>;
+        mdastExtensions: RealmNode<(Partial<Config> | Partial<Config>[])[] | null | undefined>;
+        usedLexicalNodes: RealmNode<Klass<LexicalNode>[]>;
+        addImportVisitor: RealmNode<MdastImportVisitor<Content>>;
+        addLexicalNode: RealmNode<Klass<LexicalNode>>;
+        addSyntaxExtension: RealmNode<Extension>;
+        addMdastExtension: RealmNode<Partial<Config> | Partial<Config>[]>;
+        toMarkdownExtensions: RealmNode<Options[]>;
+        toMarkdownOptions: RealmNode<Options>;
+        addToMarkdownExtension: RealmNode<Options>;
+        addExportVisitor: RealmNode<LexicalVisitor>;
+        exportVisitors: RealmNode<LexicalVisitor[]>;
+        initialMarkdown: RealmNode<string>;
+        setMarkdown: RealmNode<string>;
+        markdown: RealmNode<string>;
+        editorRootElementRef: RealmNode<React.RefObject<HTMLDivElement> | null>;
+        contentEditableClassName: RealmNode<string>;
+        composerChildren: RealmNode<React.ComponentType<{}>[]>;
+        addComposerChild: RealmNode<React.ComponentType<{}>>;
+        topAreaChildren: RealmNode<React.ComponentType<{}>[]>;
+        addTopAreaChild: RealmNode<React.ComponentType<{}>>;
+        nestedEditorChildren: RealmNode<React.ComponentType<{}>[]>;
+        addNestedEditorChild: RealmNode<React.ComponentType<{}>>;
+        editorWrappers: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>[]>;
+        addEditorWrapper: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>>;
+        currentFormat: RealmNode<number>;
+        editorInFocus: RealmNode<EditorInFocus | null>;
+        applyFormat: RealmNode<TextFormatType>;
+        currentBlockType: RealmNode<BlockType>;
+        applyBlockType: RealmNode<BlockType>;
+        convertSelectionToNode: RealmNode<() => ElementNode>;
+        insertDecoratorNode: RealmNode<() => DecoratorNode<unknown>>;
+    }>>(...keys: K_1) => ValuesForKeys<{
+        insertJsx: RealmNode<InsertJsxPayload>;
+    } & {
+        activeEditor: RealmNode<LexicalEditor | null>;
+        inFocus: RealmNode<boolean>;
+        historyState: RealmNode<HistoryState>;
+        currentSelection: RealmNode<RangeSelection | null>;
+        jsxIsAvailable: RealmNode<boolean>;
+        jsxComponentDescriptors: RealmNode<JsxComponentDescriptor[]>;
+        initialRootEditorState: RealmNode<InitialEditorStateType>;
+        rootEditor: RealmNode<LexicalEditor | null>;
+        createRootEditorSubscription: RealmNode<EditorSubscription>;
+        createActiveEditorSubscription: RealmNode<EditorSubscription>;
+        importVisitors: RealmNode<MdastImportVisitor<Content>[]>;
+        syntaxExtensions: RealmNode<Extension[]>;
+        mdastExtensions: RealmNode<(Partial<Config> | Partial<Config>[])[] | null | undefined>;
+        usedLexicalNodes: RealmNode<Klass<LexicalNode>[]>;
+        addImportVisitor: RealmNode<MdastImportVisitor<Content>>;
+        addLexicalNode: RealmNode<Klass<LexicalNode>>;
+        addSyntaxExtension: RealmNode<Extension>;
+        addMdastExtension: RealmNode<Partial<Config> | Partial<Config>[]>;
+        toMarkdownExtensions: RealmNode<Options[]>;
+        toMarkdownOptions: RealmNode<Options>;
+        addToMarkdownExtension: RealmNode<Options>;
+        addExportVisitor: RealmNode<LexicalVisitor>;
+        exportVisitors: RealmNode<LexicalVisitor[]>;
+        initialMarkdown: RealmNode<string>;
+        setMarkdown: RealmNode<string>;
+        markdown: RealmNode<string>;
+        editorRootElementRef: RealmNode<React.RefObject<HTMLDivElement> | null>;
+        contentEditableClassName: RealmNode<string>;
+        composerChildren: RealmNode<React.ComponentType<{}>[]>;
+        addComposerChild: RealmNode<React.ComponentType<{}>>;
+        topAreaChildren: RealmNode<React.ComponentType<{}>[]>;
+        addTopAreaChild: RealmNode<React.ComponentType<{}>>;
+        nestedEditorChildren: RealmNode<React.ComponentType<{}>[]>;
+        addNestedEditorChild: RealmNode<React.ComponentType<{}>>;
+        editorWrappers: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>[]>;
+        addEditorWrapper: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>>;
+        currentFormat: RealmNode<number>;
+        editorInFocus: RealmNode<EditorInFocus | null>;
+        applyFormat: RealmNode<TextFormatType>;
+        currentBlockType: RealmNode<BlockType>;
+        applyBlockType: RealmNode<BlockType>;
+        convertSelectionToNode: RealmNode<() => ElementNode>;
+        insertDecoratorNode: RealmNode<() => DecoratorNode<unknown>>;
+    }, K_1>;
+    usePubKeys: () => (values: SystemDict<{
+        insertJsx: RealmNode<InsertJsxPayload>;
+    } & {
+        activeEditor: RealmNode<LexicalEditor | null>;
+        inFocus: RealmNode<boolean>;
+        historyState: RealmNode<HistoryState>;
+        currentSelection: RealmNode<RangeSelection | null>;
+        jsxIsAvailable: RealmNode<boolean>;
+        jsxComponentDescriptors: RealmNode<JsxComponentDescriptor[]>;
+        initialRootEditorState: RealmNode<InitialEditorStateType>;
+        rootEditor: RealmNode<LexicalEditor | null>;
+        createRootEditorSubscription: RealmNode<EditorSubscription>;
+        createActiveEditorSubscription: RealmNode<EditorSubscription>;
+        importVisitors: RealmNode<MdastImportVisitor<Content>[]>;
+        syntaxExtensions: RealmNode<Extension[]>;
+        mdastExtensions: RealmNode<(Partial<Config> | Partial<Config>[])[] | null | undefined>;
+        usedLexicalNodes: RealmNode<Klass<LexicalNode>[]>;
+        addImportVisitor: RealmNode<MdastImportVisitor<Content>>;
+        addLexicalNode: RealmNode<Klass<LexicalNode>>;
+        addSyntaxExtension: RealmNode<Extension>;
+        addMdastExtension: RealmNode<Partial<Config> | Partial<Config>[]>;
+        toMarkdownExtensions: RealmNode<Options[]>;
+        toMarkdownOptions: RealmNode<Options>;
+        addToMarkdownExtension: RealmNode<Options>;
+        addExportVisitor: RealmNode<LexicalVisitor>;
+        exportVisitors: RealmNode<LexicalVisitor[]>;
+        initialMarkdown: RealmNode<string>;
+        setMarkdown: RealmNode<string>;
+        markdown: RealmNode<string>;
+        editorRootElementRef: RealmNode<React.RefObject<HTMLDivElement> | null>;
+        contentEditableClassName: RealmNode<string>;
+        composerChildren: RealmNode<React.ComponentType<{}>[]>;
+        addComposerChild: RealmNode<React.ComponentType<{}>>;
+        topAreaChildren: RealmNode<React.ComponentType<{}>[]>;
+        addTopAreaChild: RealmNode<React.ComponentType<{}>>;
+        nestedEditorChildren: RealmNode<React.ComponentType<{}>[]>;
+        addNestedEditorChild: RealmNode<React.ComponentType<{}>>;
+        editorWrappers: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>[]>;
+        addEditorWrapper: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>>;
+        currentFormat: RealmNode<number>;
+        editorInFocus: RealmNode<EditorInFocus | null>;
+        applyFormat: RealmNode<TextFormatType>;
+        currentBlockType: RealmNode<BlockType>;
+        applyBlockType: RealmNode<BlockType>;
+        convertSelectionToNode: RealmNode<() => ElementNode>;
+        insertDecoratorNode: RealmNode<() => DecoratorNode<unknown>>;
+    }>) => void;
+    usePublisher: <K_2 extends "jsxComponentDescriptors" | "jsxIsAvailable" | "toMarkdownOptions" | "toMarkdownExtensions" | "mdastExtensions" | "syntaxExtensions" | "markdown" | "activeEditor" | "inFocus" | "historyState" | "currentSelection" | "initialRootEditorState" | "rootEditor" | "createRootEditorSubscription" | "createActiveEditorSubscription" | "importVisitors" | "usedLexicalNodes" | "addImportVisitor" | "addLexicalNode" | "addSyntaxExtension" | "addMdastExtension" | "addToMarkdownExtension" | "addExportVisitor" | "exportVisitors" | "initialMarkdown" | "setMarkdown" | "editorRootElementRef" | "contentEditableClassName" | "composerChildren" | "addComposerChild" | "topAreaChildren" | "addTopAreaChild" | "nestedEditorChildren" | "addNestedEditorChild" | "editorWrappers" | "addEditorWrapper" | "currentFormat" | "editorInFocus" | "applyFormat" | "currentBlockType" | "applyBlockType" | "convertSelectionToNode" | "insertDecoratorNode" | "insertJsx">(key: K_2) => (value: ValueForKey<{
+        insertJsx: RealmNode<InsertJsxPayload>;
+    } & {
+        activeEditor: RealmNode<LexicalEditor | null>;
+        inFocus: RealmNode<boolean>;
+        historyState: RealmNode<HistoryState>;
+        currentSelection: RealmNode<RangeSelection | null>;
+        jsxIsAvailable: RealmNode<boolean>;
+        jsxComponentDescriptors: RealmNode<JsxComponentDescriptor[]>;
+        initialRootEditorState: RealmNode<InitialEditorStateType>;
+        rootEditor: RealmNode<LexicalEditor | null>;
+        createRootEditorSubscription: RealmNode<EditorSubscription>;
+        createActiveEditorSubscription: RealmNode<EditorSubscription>;
+        importVisitors: RealmNode<MdastImportVisitor<Content>[]>;
+        syntaxExtensions: RealmNode<Extension[]>;
+        mdastExtensions: RealmNode<(Partial<Config> | Partial<Config>[])[] | null | undefined>;
+        usedLexicalNodes: RealmNode<Klass<LexicalNode>[]>;
+        addImportVisitor: RealmNode<MdastImportVisitor<Content>>;
+        addLexicalNode: RealmNode<Klass<LexicalNode>>;
+        addSyntaxExtension: RealmNode<Extension>;
+        addMdastExtension: RealmNode<Partial<Config> | Partial<Config>[]>;
+        toMarkdownExtensions: RealmNode<Options[]>;
+        toMarkdownOptions: RealmNode<Options>;
+        addToMarkdownExtension: RealmNode<Options>;
+        addExportVisitor: RealmNode<LexicalVisitor>;
+        exportVisitors: RealmNode<LexicalVisitor[]>;
+        initialMarkdown: RealmNode<string>;
+        setMarkdown: RealmNode<string>;
+        markdown: RealmNode<string>;
+        editorRootElementRef: RealmNode<React.RefObject<HTMLDivElement> | null>;
+        contentEditableClassName: RealmNode<string>;
+        composerChildren: RealmNode<React.ComponentType<{}>[]>;
+        addComposerChild: RealmNode<React.ComponentType<{}>>;
+        topAreaChildren: RealmNode<React.ComponentType<{}>[]>;
+        addTopAreaChild: RealmNode<React.ComponentType<{}>>;
+        nestedEditorChildren: RealmNode<React.ComponentType<{}>[]>;
+        addNestedEditorChild: RealmNode<React.ComponentType<{}>>;
+        editorWrappers: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>[]>;
+        addEditorWrapper: RealmNode<React.ComponentType<{
+            children: React.ReactNode;
+        }>>;
+        currentFormat: RealmNode<number>;
+        editorInFocus: RealmNode<EditorInFocus | null>;
+        applyFormat: RealmNode<TextFormatType>;
+        currentBlockType: RealmNode<BlockType>;
+        applyBlockType: RealmNode<BlockType>;
+        convertSelectionToNode: RealmNode<() => ElementNode>;
+        insertDecoratorNode: RealmNode<() => DecoratorNode<unknown>>;
+    }, K_2>) => void;
+};
+export {};

package/dist/plugins/jsx/index.js

@@ -0,0 +1,59 @@
+import { mdxFromMarkdown, mdxToMarkdown } from "mdast-util-mdx";
+import { mdxjs } from "micromark-extension-mdxjs";
+import { coreSystem } from "../core/index.js";
+import { $createLexicalJsxNode, LexicalJsxNode } from "./LexicalJsxNode.js";
+import { LexicalJsxVisitor } from "./LexicalJsxVisitor.js";
+import { MdastMdxJsEsmVisitor } from "./MdastMdxJsEsmVisitor.js";
+import { MdastMdxJsxElementVisitor } from "./MdastMdxJsxElementVisitor.js";
+import { system } from "../../gurx/realmFactory.js";
+import { realmPlugin } from "../../gurx/react.js";
+const jsxSystem = system(
+  (r, [{ insertDecoratorNode }]) => {
+    const insertJsx = r.node();
+    r.link(
+      r.pipe(
+        insertJsx,
+        r.o.map(({ name, kind, props }) => {
+          return () => $createLexicalJsxNode({
+            name,
+            type: kind === "flow" ? "mdxJsxFlowElement" : "mdxJsxTextElement",
+            attributes: Object.entries(props).map(([name2, value]) => ({ type: "mdxJsxAttribute", name: name2, value })),
+            children: []
+          });
+        })
+      ),
+      insertDecoratorNode
+    );
+    return {
+      insertJsx
+    };
+  },
+  [coreSystem]
+);
+const [
+  /** @internal */
+  jsxPlugin,
+  /** @internal */
+  jsxPluginHooks
+] = realmPlugin({
+  id: "jsx",
+  systemSpec: jsxSystem,
+  applyParamsToSystem: (realm, params) => {
+    realm.pubKey("jsxComponentDescriptors", (params == null ? void 0 : params.jsxComponentDescriptors) || []);
+  },
+  init: (realm, _) => {
+    realm.pubKey("jsxIsAvailable", true);
+    realm.pubKey("addMdastExtension", mdxFromMarkdown());
+    realm.pubKey("addSyntaxExtension", mdxjs());
+    realm.pubKey("addImportVisitor", MdastMdxJsxElementVisitor);
+    realm.pubKey("addImportVisitor", MdastMdxJsEsmVisitor);
+    realm.pubKey("addLexicalNode", LexicalJsxNode);
+    realm.pubKey("addExportVisitor", LexicalJsxVisitor);
+    realm.pubKey("addToMarkdownExtension", mdxToMarkdown());
+  }
+});
+export {
+  jsxPlugin,
+  jsxPluginHooks,
+  jsxSystem
+};

package/dist/plugins/link/LexicalLinkVisitor.d.ts

@@ -0,0 +1,4 @@
+import { LinkNode } from '@lexical/link';
+import * as Mdast from 'mdast';
+import { LexicalExportVisitor } from '../../exportMarkdownFromLexical';
+export declare const LexicalLinkVisitor: LexicalExportVisitor<LinkNode, Mdast.Link>;