@doist/typist 10.0.0-next.1 → 10.0.0-next.2

package/dist/factories/create-suggestion-extension.js

@@ -1,164 +1,142 @@
-import { mergeAttributes, Node } from '@tiptap/core';
-import { PluginKey } from '@tiptap/pm/state';
-import { Suggestion as TiptapSuggestion } from '@tiptap/suggestion';
-import { camelCase, kebabCase } from 'lodash-es';
-import { SUGGESTION_EXTENSION_PRIORITY } from '../constants/extension-priorities';
-import { canInsertNodeAt } from '../utilities/can-insert-node-at';
-import { canInsertSuggestion } from '../utilities/can-insert-suggestion';
+import { SUGGESTION_EXTENSION_PRIORITY } from "../constants/extension-priorities.js";
+import { canInsertNodeAt } from "../utilities/can-insert-node-at.js";
+import { canInsertSuggestion } from "../utilities/can-insert-suggestion.js";
+import { Node, mergeAttributes } from "@tiptap/core";
+import { PluginKey } from "@tiptap/pm/state";
+import { camelCase, kebabCase } from "lodash-es";
+import { Suggestion } from "@tiptap/suggestion";
+//#region src/factories/create-suggestion-extension.ts
 /**
- * A factory function responsible for creating different types of suggestion extensions with
- * flexibility and customizability in mind.
- *
- * Extensions created by this factory function render editor nodes with internal `data-id` and
- * `data-label` attributes (as a way to save and restore the editor nodes data) based on properties
- * of the same name (minus the `data-` prefix) from the source item type. However, in the event of
- * unmatched properties between the internal attributes and the source item type, you should
- * specify the source item type, and use the optional `attributesMapping` option to map the
- * source properties to the internal `data-id` and `data-label` attributes.
- *
- * This factory function also stores the suggestion items internally in the editor storage (as-is,
- * and indexed by an identifier), as a way to make sure that if a previously referenced suggestion
- * changes its label, the editor will always render the most up-to-date label for the suggestion by
- * reading it from the storage. An example use case for this is when a user mention is added to the
- * editor, and the user changed its name afterwards, the editor will always render the most
- * up-to-date user name for the mention.
- *
- * @param type A unique identifier for the suggestion extension type.
- * @param items An array of suggestion items to be stored in the editor storage.
- * @param attributesMapping An object to map the `data-id` and `data-label` attributes with the
- * source item type properties.
- *
- * @returns A new suggestion extension tailored to a specific use case.
- */
-function createSuggestionExtension(type, items = [], 
-// This type makes sure that if a generic type variable is specified, the `attributesMapping`
-// is also defined (and vice versa) along with making sure that at least one attribute is
-// specified, and that all constraints are satisfied.
-...attributesMapping) {
-    // Normalize the node type and add the `Suggestion` suffix so that it can be easily identified
-    // when parsing the editor schema programatically (useful for Markdown/HTML serialization)
-    const nodeType = `${camelCase(type)}Suggestion`;
-    // Normalize the node type to kebab-case to be used as a `data-*` HTML attribute
-    const attributeType = kebabCase(type);
-    // Get the specified attributes, if available, or use the defaults
-    const idAttribute = String(attributesMapping[0]?.id ?? 'id');
-    const labelAttribute = String(attributesMapping[0]?.label ?? 'label');
-    // Create a personalized suggestion extension
-    return Node.create({
-        name: nodeType,
-        priority: SUGGESTION_EXTENSION_PRIORITY,
-        inline: true,
-        group: 'inline',
-        selectable: false,
-        atom: true,
-        addOptions() {
-            return {
-                triggerChar: '@',
-                // Disable option by default until the following Tiptap issue is fixed:
-                // https://github.com/ueberdosis/tiptap/issues/2159
-                allowSpaces: false,
-                allowedPrefixes: [' '],
-                startOfLine: false,
-            };
-        },
-        addStorage() {
-            return {
-                items,
-                itemsById: items.reduce((acc, item) => ({ ...acc, [String(item[idAttribute])]: item }), {}),
-            };
-        },
-        addAttributes() {
-            return {
-                id: {
-                    default: null,
-                    parseHTML: (element) => element.getAttribute('data-id'),
-                    renderHTML: (attributes) => ({
-                        'data-id': String(attributes.id),
-                    }),
-                },
-                label: {
-                    default: null,
-                    parseHTML: (element) => {
-                        const id = String(element.getAttribute('data-id'));
-                        const item = this.storage.itemsById[id];
-                        // Attempt to read the item label from the storage first (as a way to make
-                        // sure that a previously referenced suggestion always renders the most
-                        // up-to-date label for the suggestion), and fallback to the `data-label`
-                        // attribute if the item is not found in the storage
-                        const labelValue = item?.[labelAttribute] ?? element.getAttribute('data-label');
-                        return typeof labelValue === 'string' ? labelValue : '';
-                    },
-                    renderHTML: (attributes) => ({
-                        'data-label': String(attributes.label),
-                    }),
-                },
-            };
-        },
-        parseHTML() {
-            return [{ tag: `span[data-${attributeType}]` }];
-        },
-        renderHTML({ node, HTMLAttributes }) {
-            return [
-                'span',
-                mergeAttributes({
-                    [`data-${attributeType}`]: '',
-                    'aria-label': this.options.renderAriaLabel?.({
-                        id: String(node.attrs.id),
-                        label: String(node.attrs.label),
-                    }),
-                }, HTMLAttributes),
-                `${String(this.options.triggerChar)}${String(node.attrs.label)}`,
-            ];
-        },
-        renderText({ node }) {
-            return `${String(this.options.triggerChar)}${String(node.attrs.label)}`;
-        },
-        addProseMirrorPlugins() {
-            const { options: { triggerChar, allowSpaces, allowedPrefixes, startOfLine, onSearchChange, onItemSelect, dropdownRenderFn, }, storage, } = this;
-            return [
-                TiptapSuggestion({
-                    pluginKey: new PluginKey(nodeType),
-                    editor: this.editor,
-                    char: triggerChar,
-                    allowedPrefixes,
-                    allowSpaces,
-                    startOfLine,
-                    items({ query, editor }) {
-                        return (onSearchChange?.(query, editor.storage[nodeType]) || []);
-                    },
-                    allow({ editor, range, state }) {
-                        return (canInsertNodeAt({ editor, nodeType, range }) &&
-                            canInsertSuggestion({ editor, state }));
-                    },
-                    command({ editor, range, props }) {
-                        const nodeAfter = editor.view.state.selection.$to.nodeAfter;
-                        const overrideSpace = nodeAfter?.text?.startsWith(' ');
-                        if (overrideSpace) {
-                            range.to += 1;
-                        }
-                        editor
-                            .chain()
-                            .focus()
-                            .insertContentAt(range, [
-                            {
-                                type: nodeType,
-                                attrs: props,
-                            },
-                            {
-                                type: 'text',
-                                text: ' ',
-                            },
-                        ])
-                            .run();
-                        const item = storage.itemsById[props.id];
-                        if (item) {
-                            onItemSelect?.(item);
-                        }
-                    },
-                    render: dropdownRenderFn,
-                }),
-            ];
-        },
-    });
+* A factory function responsible for creating different types of suggestion extensions with
+* flexibility and customizability in mind.
+*
+* Extensions created by this factory function render editor nodes with internal `data-id` and
+* `data-label` attributes (as a way to save and restore the editor nodes data) based on properties
+* of the same name (minus the `data-` prefix) from the source item type. However, in the event of
+* unmatched properties between the internal attributes and the source item type, you should
+* specify the source item type, and use the optional `attributesMapping` option to map the
+* source properties to the internal `data-id` and `data-label` attributes.
+*
+* This factory function also stores the suggestion items internally in the editor storage (as-is,
+* and indexed by an identifier), as a way to make sure that if a previously referenced suggestion
+* changes its label, the editor will always render the most up-to-date label for the suggestion by
+* reading it from the storage. An example use case for this is when a user mention is added to the
+* editor, and the user changed its name afterwards, the editor will always render the most
+* up-to-date user name for the mention.
+*
+* @param type A unique identifier for the suggestion extension type.
+* @param items An array of suggestion items to be stored in the editor storage.
+* @param attributesMapping An object to map the `data-id` and `data-label` attributes with the
+* source item type properties.
+*
+* @returns A new suggestion extension tailored to a specific use case.
+*/
+function createSuggestionExtension(type, items = [], ...attributesMapping) {
+	const nodeType = `${camelCase(type)}Suggestion`;
+	const attributeType = kebabCase(type);
+	const idAttribute = String(attributesMapping[0]?.id ?? "id");
+	const labelAttribute = String(attributesMapping[0]?.label ?? "label");
+	return Node.create({
+		name: nodeType,
+		priority: SUGGESTION_EXTENSION_PRIORITY,
+		inline: true,
+		group: "inline",
+		selectable: false,
+		atom: true,
+		addOptions() {
+			return {
+				triggerChar: "@",
+				allowSpaces: false,
+				allowedPrefixes: [" "],
+				startOfLine: false
+			};
+		},
+		addStorage() {
+			return {
+				items,
+				itemsById: items.reduce((acc, item) => ({
+					...acc,
+					[String(item[idAttribute])]: item
+				}), {})
+			};
+		},
+		addAttributes() {
+			return {
+				id: {
+					default: null,
+					parseHTML: (element) => element.getAttribute("data-id"),
+					renderHTML: (attributes) => ({ "data-id": String(attributes.id) })
+				},
+				label: {
+					default: null,
+					parseHTML: (element) => {
+						const id = String(element.getAttribute("data-id"));
+						const labelValue = this.storage.itemsById[id]?.[labelAttribute] ?? element.getAttribute("data-label");
+						return typeof labelValue === "string" ? labelValue : "";
+					},
+					renderHTML: (attributes) => ({ "data-label": String(attributes.label) })
+				}
+			};
+		},
+		parseHTML() {
+			return [{ tag: `span[data-${attributeType}]` }];
+		},
+		renderHTML({ node, HTMLAttributes }) {
+			return [
+				"span",
+				mergeAttributes({
+					[`data-${attributeType}`]: "",
+					"aria-label": this.options.renderAriaLabel?.({
+						id: String(node.attrs.id),
+						label: String(node.attrs.label)
+					})
+				}, HTMLAttributes),
+				`${String(this.options.triggerChar)}${String(node.attrs.label)}`
+			];
+		},
+		renderText({ node }) {
+			return `${String(this.options.triggerChar)}${String(node.attrs.label)}`;
+		},
+		addProseMirrorPlugins() {
+			const { options: { triggerChar, allowSpaces, allowedPrefixes, startOfLine, onSearchChange, onItemSelect, dropdownRenderFn }, storage } = this;
+			return [Suggestion({
+				pluginKey: new PluginKey(nodeType),
+				editor: this.editor,
+				char: triggerChar,
+				allowedPrefixes,
+				allowSpaces,
+				startOfLine,
+				items({ query, editor }) {
+					return onSearchChange?.(query, editor.storage[nodeType]) || [];
+				},
+				allow({ editor, range, state }) {
+					return canInsertNodeAt({
+						editor,
+						nodeType,
+						range
+					}) && canInsertSuggestion({
+						editor,
+						state
+					});
+				},
+				command({ editor, range, props }) {
+					if (editor.view.state.selection.$to.nodeAfter?.text?.startsWith(" ")) range.to += 1;
+					editor.chain().focus().insertContentAt(range, [{
+						type: nodeType,
+						attrs: props
+					}, {
+						type: "text",
+						text: " "
+					}]).run();
+					const item = storage.itemsById[props.id];
+					if (item) onItemSelect?.(item);
+				},
+				render: dropdownRenderFn
+			})];
+		}
+	});
 }
+//#endregion
 export { createSuggestionExtension };
+
+//# sourceMappingURL=create-suggestion-extension.js.map

package/dist/factories/create-suggestion-extension.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-suggestion-extension.js","names":["TiptapSuggestion"],"sources":["../../src/factories/create-suggestion-extension.ts"],"sourcesContent":["import { mergeAttributes, Node } from '@tiptap/core'\nimport { PluginKey } from '@tiptap/pm/state'\nimport { Suggestion as TiptapSuggestion } from '@tiptap/suggestion'\nimport { camelCase, kebabCase } from 'lodash-es'\n\nimport { SUGGESTION_EXTENSION_PRIORITY } from '../constants/extension-priorities'\nimport { canInsertNodeAt } from '../utilities/can-insert-node-at'\nimport { canInsertSuggestion } from '../utilities/can-insert-suggestion'\n\nimport type {\n    SuggestionKeyDownProps as CoreSuggestionKeyDownProps,\n    SuggestionOptions as CoreSuggestionOptions,\n    SuggestionProps as CoreSuggestionProps,\n} from '@tiptap/suggestion'\nimport type { ConditionalKeys, RequireAtLeastOne } from 'type-fest'\n\n/**\n * A type that describes the suggestion node attributes.\n */\ntype SuggestionNodeAttributes = {\n    /**\n     * The suggestion node unique identifier to be rendered by the editor as a `data-id` attribute.\n     */\n    id: number | string\n\n    /**\n     * The suggestion node label to be rendered by the editor as a `data-label` attribute and the\n     * display text itself.\n     */\n    label: string\n}\n\n/**\n * A type that describes the minimal props that an autocomplete dropdown must receive.\n */\ntype SuggestionRendererProps<TSuggestionItem> = {\n    /**\n     * The list of suggestion items to be rendered by the autocomplete dropdown.\n     */\n    items: CoreSuggestionProps<TSuggestionItem>['items']\n\n    /**\n     * The function that must be invoked when a suggestion item is selected.\n     */\n    command: CoreSuggestionProps<TSuggestionItem, SuggestionNodeAttributes>['command']\n}\n\n/**\n * A type that describes the forwarded ref that an autocomplete dropdown must implement with\n * `useImperativeHandle` to handle `keydown` events in the dropdown render function.\n */\ntype SuggestionRendererRef = {\n    onKeyDown: (props: CoreSuggestionKeyDownProps) => boolean\n}\n\n/**\n * The options available to customize the extension created by the factory function.\n */\ntype SuggestionOptions<TSuggestionItem> = {\n    /**\n     * The character that triggers the autocomplete dropdown.\n     */\n    triggerChar: string\n\n    /**\n     * Allows or disallows spaces in suggested items.\n     */\n    allowSpaces: CoreSuggestionOptions['allowSpaces']\n\n    /**\n     * The prefix characters that are allowed to trigger a suggestion.\n     */\n    allowedPrefixes: CoreSuggestionOptions['allowedPrefixes']\n\n    /**\n     * Trigger the autocomplete dropdown at the start of a line only.\n     */\n    startOfLine: CoreSuggestionOptions['startOfLine']\n\n    /**\n     * Define how the suggestion item `aria-label` attribute should be rendered.\n     */\n    renderAriaLabel?: (attrs: SuggestionNodeAttributes) => string\n\n    /**\n     * A render function for the autocomplete dropdown.\n     */\n    dropdownRenderFn?: CoreSuggestionOptions<TSuggestionItem>['render']\n\n    /**\n     * The event handler that is fired when the search string has changed.\n     */\n    onSearchChange?: (\n        query: string,\n        storage: SuggestionStorage<TSuggestionItem>,\n    ) => TSuggestionItem[] | Promise<TSuggestionItem[]>\n\n    /**\n     * The event handler that is fired when a suggestion item is selected.\n     */\n    onItemSelect?: (item: TSuggestionItem) => void\n}\n\n/**\n * The storage holding the suggestion items original array, and a collection indexed by the item id.\n */\ntype SuggestionStorage<TSuggestionItem> = Readonly<{\n    /**\n     * The original array of suggestion items.\n     */\n    items: TSuggestionItem[]\n\n    /**\n     * A collection of suggestion items indexed by the item id.\n     */\n    itemsById: { readonly [id: SuggestionNodeAttributes['id']]: TSuggestionItem | undefined }\n}>\n\n/**\n * The return type for a suggestion extension created by the factory function.\n */\ntype SuggestionExtensionResult<TSuggestionItem> = Node<SuggestionOptions<TSuggestionItem>>\n\n/**\n * A factory function responsible for creating different types of suggestion extensions with\n * flexibility and customizability in mind.\n *\n * Extensions created by this factory function render editor nodes with internal `data-id` and\n * `data-label` attributes (as a way to save and restore the editor nodes data) based on properties\n * of the same name (minus the `data-` prefix) from the source item type. However, in the event of\n * unmatched properties between the internal attributes and the source item type, you should\n * specify the source item type, and use the optional `attributesMapping` option to map the\n * source properties to the internal `data-id` and `data-label` attributes.\n *\n * This factory function also stores the suggestion items internally in the editor storage (as-is,\n * and indexed by an identifier), as a way to make sure that if a previously referenced suggestion\n * changes its label, the editor will always render the most up-to-date label for the suggestion by\n * reading it from the storage. An example use case for this is when a user mention is added to the\n * editor, and the user changed its name afterwards, the editor will always render the most\n * up-to-date user name for the mention.\n *\n * @param type A unique identifier for the suggestion extension type.\n * @param items An array of suggestion items to be stored in the editor storage.\n * @param attributesMapping An object to map the `data-id` and `data-label` attributes with the\n * source item type properties.\n *\n * @returns A new suggestion extension tailored to a specific use case.\n */\nfunction createSuggestionExtension<\n    TSuggestionItem extends {\n        [id: SuggestionNodeAttributes['id']]: unknown\n    } = SuggestionNodeAttributes,\n>(\n    type: string,\n    items: TSuggestionItem[] = [],\n\n    // This type makes sure that if a generic type variable is specified, the `attributesMapping`\n    // is also defined (and vice versa) along with making sure that at least one attribute is\n    // specified, and that all constraints are satisfied.\n    ...attributesMapping: TSuggestionItem extends SuggestionNodeAttributes\n        ? []\n        : [\n              RequireAtLeastOne<{\n                  id: ConditionalKeys<TSuggestionItem, SuggestionNodeAttributes['id']>\n                  label: ConditionalKeys<TSuggestionItem, SuggestionNodeAttributes['label']>\n              }>,\n          ]\n): SuggestionExtensionResult<TSuggestionItem> {\n    // Normalize the node type and add the `Suggestion` suffix so that it can be easily identified\n    // when parsing the editor schema programatically (useful for Markdown/HTML serialization)\n    const nodeType = `${camelCase(type)}Suggestion`\n\n    // Normalize the node type to kebab-case to be used as a `data-*` HTML attribute\n    const attributeType = kebabCase(type)\n\n    // Get the specified attributes, if available, or use the defaults\n    const idAttribute = String(attributesMapping[0]?.id ?? 'id')\n    const labelAttribute = String(attributesMapping[0]?.label ?? 'label')\n\n    // Create a personalized suggestion extension\n    return Node.create<SuggestionOptions<TSuggestionItem>, SuggestionStorage<TSuggestionItem>>({\n        name: nodeType,\n        priority: SUGGESTION_EXTENSION_PRIORITY,\n        inline: true,\n        group: 'inline',\n        selectable: false,\n        atom: true,\n        addOptions() {\n            return {\n                triggerChar: '@',\n                // Disable option by default until the following Tiptap issue is fixed:\n                // https://github.com/ueberdosis/tiptap/issues/2159\n                allowSpaces: false,\n                allowedPrefixes: [' '],\n                startOfLine: false,\n            }\n        },\n        addStorage() {\n            return {\n                items,\n                itemsById: items.reduce(\n                    (acc, item) => ({ ...acc, [String(item[idAttribute])]: item }),\n                    {},\n                ),\n            }\n        },\n        addAttributes() {\n            return {\n                id: {\n                    default: null,\n                    parseHTML: (element) => element.getAttribute('data-id'),\n                    renderHTML: (attributes) => ({\n                        'data-id': String(attributes.id),\n                    }),\n                },\n                label: {\n                    default: null,\n                    parseHTML: (element: Element) => {\n                        const id = String(element.getAttribute('data-id'))\n                        const item = this.storage.itemsById[id]\n\n                        // Attempt to read the item label from the storage first (as a way to make\n                        // sure that a previously referenced suggestion always renders the most\n                        // up-to-date label for the suggestion), and fallback to the `data-label`\n                        // attribute if the item is not found in the storage\n                        const labelValue =\n                            item?.[labelAttribute] ?? element.getAttribute('data-label')\n                        return typeof labelValue === 'string' ? labelValue : ''\n                    },\n                    renderHTML: (attributes) => ({\n                        'data-label': String(attributes.label),\n                    }),\n                },\n            }\n        },\n        parseHTML() {\n            return [{ tag: `span[data-${attributeType}]` }]\n        },\n        renderHTML({ node, HTMLAttributes }) {\n            return [\n                'span',\n                mergeAttributes(\n                    {\n                        [`data-${attributeType}`]: '',\n                        'aria-label': this.options.renderAriaLabel?.({\n                            id: String(node.attrs.id),\n                            label: String(node.attrs.label),\n                        }),\n                    },\n                    HTMLAttributes,\n                ),\n                `${String(this.options.triggerChar)}${String(node.attrs.label)}`,\n            ]\n        },\n        renderText({ node }) {\n            return `${String(this.options.triggerChar)}${String(node.attrs.label)}`\n        },\n        addProseMirrorPlugins() {\n            const {\n                options: {\n                    triggerChar,\n                    allowSpaces,\n                    allowedPrefixes,\n                    startOfLine,\n                    onSearchChange,\n                    onItemSelect,\n                    dropdownRenderFn,\n                },\n                storage,\n            } = this\n\n            return [\n                TiptapSuggestion<TSuggestionItem, SuggestionNodeAttributes>({\n                    pluginKey: new PluginKey(nodeType),\n                    editor: this.editor,\n                    char: triggerChar,\n                    allowedPrefixes,\n                    allowSpaces,\n                    startOfLine,\n                    items({ query, editor }) {\n                        return (\n                            onSearchChange?.(\n                                query,\n                                editor.storage[nodeType] as SuggestionStorage<TSuggestionItem>,\n                            ) || []\n                        )\n                    },\n                    allow({ editor, range, state }) {\n                        return (\n                            canInsertNodeAt({ editor, nodeType, range }) &&\n                            canInsertSuggestion({ editor, state })\n                        )\n                    },\n                    command({ editor, range, props }) {\n                        const nodeAfter = editor.view.state.selection.$to.nodeAfter\n                        const overrideSpace = nodeAfter?.text?.startsWith(' ')\n\n                        if (overrideSpace) {\n                            range.to += 1\n                        }\n\n                        editor\n                            .chain()\n                            .focus()\n                            .insertContentAt(range, [\n                                {\n                                    type: nodeType,\n                                    attrs: props,\n                                },\n                                {\n                                    type: 'text',\n                                    text: ' ',\n                                },\n                            ])\n                            .run()\n\n                        const item = storage.itemsById[props.id]\n\n                        if (item) {\n                            onItemSelect?.(item)\n                        }\n                    },\n                    render: dropdownRenderFn,\n                }),\n            ]\n        },\n    })\n}\n\nexport { createSuggestionExtension }\n\nexport type {\n    SuggestionExtensionResult,\n    SuggestionOptions,\n    SuggestionRendererProps,\n    SuggestionRendererRef,\n    SuggestionStorage,\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoJA,SAAS,0BAKL,MACA,QAA2B,EAAE,EAK7B,GAAG,mBAQuC;CAG1C,MAAM,WAAW,GAAG,UAAU,KAAK,CAAC;CAGpC,MAAM,gBAAgB,UAAU,KAAK;CAGrC,MAAM,cAAc,OAAO,kBAAkB,IAAI,MAAM,KAAK;CAC5D,MAAM,iBAAiB,OAAO,kBAAkB,IAAI,SAAS,QAAQ;AAGrE,QAAO,KAAK,OAA+E;EACvF,MAAM;EACN,UAAU;EACV,QAAQ;EACR,OAAO;EACP,YAAY;EACZ,MAAM;EACN,aAAa;AACT,UAAO;IACH,aAAa;IAGb,aAAa;IACb,iBAAiB,CAAC,IAAI;IACtB,aAAa;IAChB;;EAEL,aAAa;AACT,UAAO;IACH;IACA,WAAW,MAAM,QACZ,KAAK,UAAU;KAAE,GAAG;MAAM,OAAO,KAAK,aAAa,GAAG;KAAM,GAC7D,EAAE,CACL;IACJ;;EAEL,gBAAgB;AACZ,UAAO;IACH,IAAI;KACA,SAAS;KACT,YAAY,YAAY,QAAQ,aAAa,UAAU;KACvD,aAAa,gBAAgB,EACzB,WAAW,OAAO,WAAW,GAAG,EACnC;KACJ;IACD,OAAO;KACH,SAAS;KACT,YAAY,YAAqB;MAC7B,MAAM,KAAK,OAAO,QAAQ,aAAa,UAAU,CAAC;MAOlD,MAAM,aANO,KAAK,QAAQ,UAAU,MAOzB,mBAAmB,QAAQ,aAAa,aAAa;AAChE,aAAO,OAAO,eAAe,WAAW,aAAa;;KAEzD,aAAa,gBAAgB,EACzB,cAAc,OAAO,WAAW,MAAM,EACzC;KACJ;IACJ;;EAEL,YAAY;AACR,UAAO,CAAC,EAAE,KAAK,aAAa,cAAc,IAAI,CAAC;;EAEnD,WAAW,EAAE,MAAM,kBAAkB;AACjC,UAAO;IACH;IACA,gBACI;MACK,QAAQ,kBAAkB;KAC3B,cAAc,KAAK,QAAQ,kBAAkB;MACzC,IAAI,OAAO,KAAK,MAAM,GAAG;MACzB,OAAO,OAAO,KAAK,MAAM,MAAM;MAClC,CAAC;KACL,EACD,eACH;IACD,GAAG,OAAO,KAAK,QAAQ,YAAY,GAAG,OAAO,KAAK,MAAM,MAAM;IACjE;;EAEL,WAAW,EAAE,QAAQ;AACjB,UAAO,GAAG,OAAO,KAAK,QAAQ,YAAY,GAAG,OAAO,KAAK,MAAM,MAAM;;EAEzE,wBAAwB;GACpB,MAAM,EACF,SAAS,EACL,aACA,aACA,iBACA,aACA,gBACA,cACA,oBAEJ,YACA;AAEJ,UAAO,CACHA,WAA4D;IACxD,WAAW,IAAI,UAAU,SAAS;IAClC,QAAQ,KAAK;IACb,MAAM;IACN;IACA;IACA;IACA,MAAM,EAAE,OAAO,UAAU;AACrB,YACI,iBACI,OACA,OAAO,QAAQ,UAClB,IAAI,EAAE;;IAGf,MAAM,EAAE,QAAQ,OAAO,SAAS;AAC5B,YACI,gBAAgB;MAAE;MAAQ;MAAU;MAAO,CAAC,IAC5C,oBAAoB;MAAE;MAAQ;MAAO,CAAC;;IAG9C,QAAQ,EAAE,QAAQ,OAAO,SAAS;AAI9B,SAHkB,OAAO,KAAK,MAAM,UAAU,IAAI,WACjB,MAAM,WAAW,IAAI,CAGlD,OAAM,MAAM;AAGhB,YACK,OAAO,CACP,OAAO,CACP,gBAAgB,OAAO,CACpB;MACI,MAAM;MACN,OAAO;MACV,EACD;MACI,MAAM;MACN,MAAM;MACT,CACJ,CAAC,CACD,KAAK;KAEV,MAAM,OAAO,QAAQ,UAAU,MAAM;AAErC,SAAI,KACA,gBAAe,KAAK;;IAG5B,QAAQ;IACX,CAAC,CACL;;EAER,CAAC"}

package/dist/helpers/dom.js

@@ -1,9 +1,13 @@
+//#region src/helpers/dom.ts
 /**
- * Parse a given HTML string and returns the `HTMLElement` for the document body.
- *
- * @param html The HTML string to parse.
- */
+* Parse a given HTML string and returns the `HTMLElement` for the document body.
+*
+* @param html The HTML string to parse.
+*/
 function parseHtmlToElement(html) {
-    return new DOMParser().parseFromString(html, 'text/html').body;
+	return new DOMParser().parseFromString(html, "text/html").body;
 }
+//#endregion
 export { parseHtmlToElement };
+
+//# sourceMappingURL=dom.js.map

package/dist/helpers/dom.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dom.js","names":[],"sources":["../../src/helpers/dom.ts"],"sourcesContent":["/**\n * Parse a given HTML string and returns the `HTMLElement` for the document body.\n *\n * @param html The HTML string to parse.\n */\nfunction parseHtmlToElement(html: string) {\n    return new DOMParser().parseFromString(html, 'text/html').body\n}\n\nexport { parseHtmlToElement }\n"],"mappings":";;;;;;AAKA,SAAS,mBAAmB,MAAc;AACtC,QAAO,IAAI,WAAW,CAAC,gBAAgB,MAAM,YAAY,CAAC"}

package/dist/helpers/schema.d.ts

@@ -1,4 +1,6 @@
-import type { Schema } from '@tiptap/pm/model';
+import { Schema } from "@tiptap/pm/model";
+
+//#region src/helpers/schema.d.ts
 /**
  * Check if the document schema accepts multiple lines of input.
  *
@@ -22,6 +24,6 @@ declare function isPlainTextDocument(schema: Schema): boolean;
  *
  * @returns A string ID matching the editor schema.
  */
-declare function computeSchemaId(schema: Schema): string;
-export { computeSchemaId, isMultilineDocument, isPlainTextDocument };
+//#endregion
+export { isMultilineDocument, isPlainTextDocument };
 //# sourceMappingURL=schema.d.ts.map

package/dist/helpers/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/helpers/schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE9C;;;;;;GAMG;AACH,iBAAS,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,iBAAS,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED;;;;;;GAMG;AACH,iBAAS,eAAe,CAAC,MAAM,EAAE,MAAM,UAEtC;AAED,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,CAAA"}
+{"version":3,"file":"schema.d.ts","names":[],"sources":["../../src/helpers/schema.ts"],"mappings":";;;;;AAA8C;;;;;iBASrC,mBAAA,CAAoB,MAAA,EAAQ,MAAA;;;;;;;;iBAW5B,mBAAA,CAAoB,MAAA,EAAQ,MAAA"}

package/dist/helpers/schema.js

@@ -1,31 +1,35 @@
+//#region src/helpers/schema.ts
 /**
- * Check if the document schema accepts multiple lines of input.
- *
- * @param schema The current editor document schema.
- *
- * @returns True if the schema accepts multiple lines of input, false otherwise.
- */
+* Check if the document schema accepts multiple lines of input.
+*
+* @param schema The current editor document schema.
+*
+* @returns True if the schema accepts multiple lines of input, false otherwise.
+*/
 function isMultilineDocument(schema) {
-    return /(?:\+|\*)$/.test(schema.topNodeType.spec.content || '');
+	return /(?:\+|\*)$/.test(schema.topNodeType.spec.content || "");
 }
 /**
- * Check if a document schema contains a plain-text document top node.
- *
- * @param schema The current editor document schema.
- *
- * @returns True if the schema contains a plain-text document, false otherwise.
- */
+* Check if a document schema contains a plain-text document top node.
+*
+* @param schema The current editor document schema.
+*
+* @returns True if the schema contains a plain-text document, false otherwise.
+*/
 function isPlainTextDocument(schema) {
-    return Boolean(schema.topNodeType.spec.content?.startsWith('paragraph'));
+	return Boolean(schema.topNodeType.spec.content?.startsWith("paragraph"));
 }
 /**
- * Computes a string ID that identifies a given editor schema which can be used for object mapping.
- *
- * @param schema The current editor document schema.
- *
- * @returns A string ID matching the editor schema.
- */
+* Computes a string ID that identifies a given editor schema which can be used for object mapping.
+*
+* @param schema The current editor document schema.
+*
+* @returns A string ID matching the editor schema.
+*/
 function computeSchemaId(schema) {
-    return [...Object.keys(schema.marks), ...Object.keys(schema.nodes)].join();
+	return [...Object.keys(schema.marks), ...Object.keys(schema.nodes)].join();
 }
+//#endregion
 export { computeSchemaId, isMultilineDocument, isPlainTextDocument };
+
+//# sourceMappingURL=schema.js.map

package/dist/helpers/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","names":[],"sources":["../../src/helpers/schema.ts"],"sourcesContent":["import type { Schema } from '@tiptap/pm/model'\n\n/**\n * Check if the document schema accepts multiple lines of input.\n *\n * @param schema The current editor document schema.\n *\n * @returns True if the schema accepts multiple lines of input, false otherwise.\n */\nfunction isMultilineDocument(schema: Schema): boolean {\n    return /(?:\\+|\\*)$/.test(schema.topNodeType.spec.content || '')\n}\n\n/**\n * Check if a document schema contains a plain-text document top node.\n *\n * @param schema The current editor document schema.\n *\n * @returns True if the schema contains a plain-text document, false otherwise.\n */\nfunction isPlainTextDocument(schema: Schema): boolean {\n    return Boolean(schema.topNodeType.spec.content?.startsWith('paragraph'))\n}\n\n/**\n * Computes a string ID that identifies a given editor schema which can be used for object mapping.\n *\n * @param schema The current editor document schema.\n *\n * @returns A string ID matching the editor schema.\n */\nfunction computeSchemaId(schema: Schema) {\n    return [...Object.keys(schema.marks), ...Object.keys(schema.nodes)].join()\n}\n\nexport { computeSchemaId, isMultilineDocument, isPlainTextDocument }\n"],"mappings":";;;;;;;;AASA,SAAS,oBAAoB,QAAyB;AAClD,QAAO,aAAa,KAAK,OAAO,YAAY,KAAK,WAAW,GAAG;;;;;;;;;AAUnE,SAAS,oBAAoB,QAAyB;AAClD,QAAO,QAAQ,OAAO,YAAY,KAAK,SAAS,WAAW,YAAY,CAAC;;;;;;;;;AAU5E,SAAS,gBAAgB,QAAgB;AACrC,QAAO,CAAC,GAAG,OAAO,KAAK,OAAO,MAAM,EAAE,GAAG,OAAO,KAAK,OAAO,MAAM,CAAC,CAAC,MAAM"}

package/dist/helpers/serializer.js

@@ -1,35 +1,31 @@
-import { kebabCase } from 'lodash-es';
+import { kebabCase } from "lodash-es";
+//#region src/helpers/serializer.ts
 /**
- * Builds a partial regular expression that includes valid URL schemas used by all the available
- * suggestion nodes from the given editor schema.
- *
- * @param schema The editor schema to be used for suggestion nodes detection.
- *
- * @returns A partial regular expression with valid URL schemas for the available suggestion nodes,
- * `null` if there are no suggestion nodes in the editor schema.
- */
+* Builds a partial regular expression that includes valid URL schemas used by all the available
+* suggestion nodes from the given editor schema.
+*
+* @param schema The editor schema to be used for suggestion nodes detection.
+*
+* @returns A partial regular expression with valid URL schemas for the available suggestion nodes,
+* `null` if there are no suggestion nodes in the editor schema.
+*/
 function buildSuggestionSchemaPartialRegex(schema) {
-    const suggestionNodes = Object.values(schema.nodes).filter((node) => node.name.endsWith('Suggestion'));
-    if (suggestionNodes.length === 0) {
-        return null;
-    }
-    return `(?:${suggestionNodes
-        .map((suggestionNode) => kebabCase(suggestionNode.name.replace(/Suggestion$/, '')))
-        .join('|')})://`;
+	const suggestionNodes = Object.values(schema.nodes).filter((node) => node.name.endsWith("Suggestion"));
+	if (suggestionNodes.length === 0) return null;
+	return `(?:${suggestionNodes.map((suggestionNode) => kebabCase(suggestionNode.name.replace(/Suggestion$/, ""))).join("|")})://`;
 }
 /**
- * Extract all tags from the given parse rules argument, and returns an array of said tags.
- *
- * @param parseRules The parse rules for a DOM node or inline style.
- *
- * @returns An array of tags extracted from the parse rules.
- */
+* Extract all tags from the given parse rules argument, and returns an array of said tags.
+*
+* @param parseRules The parse rules for a DOM node or inline style.
+*
+* @returns An array of tags extracted from the parse rules.
+*/
 function extractTagsFromParseRules(parseRules) {
-    if (!parseRules || parseRules.length === 0) {
-        return [];
-    }
-    return parseRules
-        .filter((rule) => rule.tag)
-        .map((rule) => rule.tag);
+	if (!parseRules || parseRules.length === 0) return [];
+	return parseRules.filter((rule) => rule.tag).map((rule) => rule.tag);
 }
+//#endregion
 export { buildSuggestionSchemaPartialRegex, extractTagsFromParseRules };
+
+//# sourceMappingURL=serializer.js.map

package/dist/helpers/serializer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializer.js","names":[],"sources":["../../src/helpers/serializer.ts"],"sourcesContent":["import { kebabCase } from 'lodash-es'\n\nimport type { ParseRule, Schema } from '@tiptap/pm/model'\n\n/**\n * Builds a partial regular expression that includes valid URL schemas used by all the available\n * suggestion nodes from the given editor schema.\n *\n * @param schema The editor schema to be used for suggestion nodes detection.\n *\n * @returns A partial regular expression with valid URL schemas for the available suggestion nodes,\n * `null` if there are no suggestion nodes in the editor schema.\n */\nfunction buildSuggestionSchemaPartialRegex(schema: Schema) {\n    const suggestionNodes = Object.values(schema.nodes).filter((node) =>\n        node.name.endsWith('Suggestion'),\n    )\n\n    if (suggestionNodes.length === 0) {\n        return null\n    }\n\n    return `(?:${suggestionNodes\n        .map((suggestionNode) => kebabCase(suggestionNode.name.replace(/Suggestion$/, '')))\n        .join('|')})://`\n}\n\n/**\n * Extract all tags from the given parse rules argument, and returns an array of said tags.\n *\n * @param parseRules The parse rules for a DOM node or inline style.\n *\n * @returns An array of tags extracted from the parse rules.\n */\nfunction extractTagsFromParseRules(\n    parseRules?: readonly ParseRule[],\n): (keyof HTMLElementTagNameMap)[] {\n    if (!parseRules || parseRules.length === 0) {\n        return []\n    }\n\n    return parseRules\n        .filter((rule) => rule.tag)\n        .map((rule) => rule.tag as keyof HTMLElementTagNameMap)\n}\n\nexport { buildSuggestionSchemaPartialRegex, extractTagsFromParseRules }\n"],"mappings":";;;;;;;;;;;AAaA,SAAS,kCAAkC,QAAgB;CACvD,MAAM,kBAAkB,OAAO,OAAO,OAAO,MAAM,CAAC,QAAQ,SACxD,KAAK,KAAK,SAAS,aAAa,CACnC;AAED,KAAI,gBAAgB,WAAW,EAC3B,QAAO;AAGX,QAAO,MAAM,gBACR,KAAK,mBAAmB,UAAU,eAAe,KAAK,QAAQ,eAAe,GAAG,CAAC,CAAC,CAClF,KAAK,IAAI,CAAC;;;;;;;;;AAUnB,SAAS,0BACL,YAC+B;AAC/B,KAAI,CAAC,cAAc,WAAW,WAAW,EACrC,QAAO,EAAE;AAGb,QAAO,WACF,QAAQ,SAAS,KAAK,IAAI,CAC1B,KAAK,SAAS,KAAK,IAAmC"}

package/dist/helpers/unified.js

@@ -1,24 +1,31 @@
-import { is } from 'unist-util-is';
+import { is } from "unist-util-is";
+//#region src/helpers/unified.ts
 /**
- * Determines whether a given hast node is an element node with a specific tag name.
- *
- * @param node The hast node to check.
- * @param tagName The tag name to check for.
- *
- * @returns `true` if the hast node is an element node with the specified tag name, `false`
- * otherwise.
- */
+* Determines whether a given hast node is an element node with a specific tag name.
+*
+* @param node The hast node to check.
+* @param tagName The tag name to check for.
+*
+* @returns `true` if the hast node is an element node with the specified tag name, `false`
+* otherwise.
+*/
 function isHastElementNode(node, tagName) {
-    return is(node, { type: 'element', tagName });
+	return is(node, {
+		type: "element",
+		tagName
+	});
 }
 /**
- * Determines whether a given hast node is a text node.
- *
- * @param node The hast node to check.
- *
- * @returns `true` if the hast node is a text node, `false` otherwise.
- */
+* Determines whether a given hast node is a text node.
+*
+* @param node The hast node to check.
+*
+* @returns `true` if the hast node is a text node, `false` otherwise.
+*/
 function isHastTextNode(node) {
-    return is(node, { type: 'text' });
+	return is(node, { type: "text" });
 }
+//#endregion
 export { isHastElementNode, isHastTextNode };
+
+//# sourceMappingURL=unified.js.map

package/dist/helpers/unified.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unified.js","names":[],"sources":["../../src/helpers/unified.ts"],"sourcesContent":["import { is } from 'unist-util-is'\n\nimport type { Element, Node as HastNode, Text } from 'hast'\n\n/**\n * Determines whether a given hast node is an element node with a specific tag name.\n *\n * @param node The hast node to check.\n * @param tagName The tag name to check for.\n *\n * @returns `true` if the hast node is an element node with the specified tag name, `false`\n * otherwise.\n */\nfunction isHastElementNode(node: HastNode, tagName: Element['tagName']): node is Element {\n    return is(node, { type: 'element', tagName })\n}\n\n/**\n * Determines whether a given hast node is a text node.\n *\n * @param node The hast node to check.\n *\n * @returns `true` if the hast node is a text node, `false` otherwise.\n */\nfunction isHastTextNode(node: HastNode): node is Text {\n    return is(node, { type: 'text' })\n}\n\nexport { isHastElementNode, isHastTextNode }\n"],"mappings":";;;;;;;;;;;AAaA,SAAS,kBAAkB,MAAgB,SAA8C;AACrF,QAAO,GAAG,MAAM;EAAE,MAAM;EAAW;EAAS,CAAC;;;;;;;;;AAUjD,SAAS,eAAe,MAA8B;AAClD,QAAO,GAAG,MAAM,EAAE,MAAM,QAAQ,CAAC"}