@akinon/ui-editor 1.0.2 → 1.0.4

package/dist/cjs/tiptap/utils/__tests__/prettier-format.test.js

@@ -0,0 +1,33 @@
+import * as prettier from 'prettier/standalone';
+import { describe, expect, it, vi } from 'vitest';
+import { formatHtmlWithPrettier } from '../prettier-format';
+vi.mock('prettier/standalone', () => ({
+    format: vi.fn()
+}));
+vi.mock('prettier/plugins/html', async (importOriginal) => {
+    const mod = await importOriginal();
+    return Object.assign({}, mod);
+});
+describe('prettier-format', () => {
+    it('should format html successfully', async () => {
+        const input = '<div>  test  </div>';
+        const formatted = '<div>test</div>';
+        vi.mocked(prettier.format).mockResolvedValue(formatted);
+        const result = await formatHtmlWithPrettier(input);
+        expect(prettier.format).toHaveBeenCalledWith(input, expect.objectContaining({
+            parser: 'html',
+            printWidth: 60
+        }));
+        expect(result).toBe(formatted);
+    });
+    it('should return original html and warn when formatting fails', async () => {
+        const input = 'Invalid HTML';
+        const error = new Error('Parse error');
+        vi.mocked(prettier.format).mockRejectedValue(error);
+        const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => { });
+        const result = await formatHtmlWithPrettier(input);
+        expect(result).toBe(input);
+        expect(consoleSpy).not.toHaveBeenCalled();
+        consoleSpy.mockRestore();
+    });
+});

package/dist/cjs/tiptap/utils/__tests__/prettier-format.test.ts

@@ -0,0 +1,49 @@
+import * as prettier from 'prettier/standalone';
+import { describe, expect, it, vi } from 'vitest';
+
+import { formatHtmlWithPrettier } from '../prettier-format';
+
+vi.mock('prettier/standalone', () => ({
+  format: vi.fn()
+}));
+
+vi.mock('prettier/plugins/html', async importOriginal => {
+  const mod = await importOriginal<typeof import('prettier/plugins/html')>();
+  return { ...mod };
+});
+
+describe('prettier-format', () => {
+  it('should format html successfully', async () => {
+    const input = '<div>  test  </div>';
+    const formatted = '<div>test</div>';
+
+    vi.mocked(prettier.format).mockResolvedValue(formatted);
+
+    const result = await formatHtmlWithPrettier(input);
+
+    expect(prettier.format).toHaveBeenCalledWith(
+      input,
+      expect.objectContaining({
+        parser: 'html',
+        printWidth: 60
+      })
+    );
+    expect(result).toBe(formatted);
+  });
+
+  it('should return original html and warn when formatting fails', async () => {
+    const input = 'Invalid HTML';
+    const error = new Error('Parse error');
+
+    vi.mocked(prettier.format).mockRejectedValue(error);
+
+    const consoleSpy = vi.spyOn(console, 'warn').mockImplementation(() => {});
+
+    const result = await formatHtmlWithPrettier(input);
+
+    expect(result).toBe(input);
+    expect(consoleSpy).not.toHaveBeenCalled();
+
+    consoleSpy.mockRestore();
+  });
+});

package/dist/cjs/tiptap/utils/__tests__/tiptap-extensions.test.js

@@ -1,12 +1,30 @@
+import Blockquote from '@tiptap/extension-blockquote';
+import CodeBlock from '@tiptap/extension-code-block';
 import FileHandler from '@tiptap/extension-file-handler';
+import Heading from '@tiptap/extension-heading';
 import HorizontalRule from '@tiptap/extension-horizontal-rule';
+import { BulletList, ListItem, OrderedList } from '@tiptap/extension-list';
 import Paragraph from '@tiptap/extension-paragraph';
+import { Table, TableRow } from '@tiptap/extension-table';
 import { describe, expect, it, vi } from 'vitest';
 import { getExtensions, handleImageFile, validateAutoLink, validateLink } from '../tiptap-extensions';
 vi.mock('@tiptap/extension-document', () => ({ default: { extend: vi.fn() } }));
 vi.mock('@tiptap/extension-paragraph', () => ({
     default: { extend: vi.fn() }
 }));
+vi.mock('@tiptap/extension-blockquote', () => ({
+    default: { extend: vi.fn() }
+}));
+vi.mock('@tiptap/extension-heading', () => ({
+    default: {
+        extend: vi.fn(() => ({
+            configure: vi.fn()
+        }))
+    }
+}));
+vi.mock('@tiptap/extension-code-block', () => ({
+    default: { extend: vi.fn() }
+}));
 vi.mock('@tiptap/extension-horizontal-rule', () => ({
     default: {
         extend: vi.fn(config => (Object.assign(Object.assign({}, config), { name: 'horizontalRule' })))
@@ -24,6 +42,16 @@ vi.mock('@tiptap/extension-file-handler', () => ({
         }))
     }
 }));
+vi.mock('@tiptap/extension-table', async (importOriginal) => {
+    const actual = await importOriginal();
+    return Object.assign(Object.assign({}, actual), { Table: Object.assign(Object.assign({}, actual.Table), { extend: vi.fn(() => ({
+                configure: vi.fn()
+            })) }), TableRow: Object.assign(Object.assign({}, actual.TableRow), { extend: vi.fn(() => ({})) }) });
+});
+vi.mock('@tiptap/extension-list', async (importOriginal) => {
+    const actual = await importOriginal();
+    return Object.assign(Object.assign({}, actual), { OrderedList: Object.assign(Object.assign({}, actual.OrderedList), { extend: vi.fn() }), ListItem: Object.assign(Object.assign({}, actual.ListItem), { extend: vi.fn() }), BulletList: Object.assign(Object.assign({}, actual.BulletList), { extend: vi.fn() }), TaskItem: Object.assign(Object.assign({}, actual.TaskItem), { configure: vi.fn() }) });
+});
 describe('tiptap-extensions', () => {
     describe('getExtensions', () => {
         it('should return an array of extensions', () => {
@@ -39,6 +67,15 @@ describe('tiptap-extensions', () => {
             expect(attrs).toHaveProperty('style');
             expect(attrs).toHaveProperty('class');
             expect(attrs).toHaveProperty('id');
+            const render = config.renderHTML({
+                HTMLAttributes: { class: 'p-cls' },
+                node: { attrs: { dataAttributes: { 'data-test': 'val' } } }
+            });
+            expect(render[0]).toBe('p');
+            expect(render[1]).toEqual(expect.objectContaining({
+                class: 'p-cls',
+                'data-test': 'val'
+            }));
         });
         it('should configure HorizontalRule with addNodeView', () => {
             expect(HorizontalRule.extend).toHaveBeenCalled();
@@ -70,6 +107,126 @@ describe('tiptap-extensions', () => {
             options.onDrop(editor, files, 10);
             vi.stubGlobal('FileReader', undefined);
         });
+        it('should configure Table and TableRow extensions with attributes', () => {
+            getExtensions();
+            expect(Table.extend).toHaveBeenCalled();
+            // @ts-expect-error Mock implementation
+            const tableConfig = Table.extend.mock.calls[0][0];
+            const tableAttrs = tableConfig.addAttributes();
+            expect(tableAttrs).toHaveProperty('style');
+            expect(tableAttrs).toHaveProperty('class');
+            const tableRender = tableConfig.renderHTML({
+                HTMLAttributes: { class: 'test' },
+                node: { attrs: { dataAttributes: { 'data-foo': 'bar' } } }
+            });
+            // Expected: ['table', attrs, ['tbody', 0]]
+            expect(tableRender[0]).toBe('table');
+            expect(tableRender[1]).toEqual(expect.objectContaining({
+                'data-foo': 'bar',
+                class: 'test'
+            }));
+            expect(tableRender[2]).toBe(0);
+            expect(TableRow.extend).toHaveBeenCalled();
+            // @ts-expect-error Mock implementation
+            const rowConfig = TableRow.extend.mock.calls[0][0];
+            const rowAttrs = rowConfig.addAttributes();
+            expect(rowAttrs).toHaveProperty('id');
+            const rowRender = rowConfig.renderHTML({
+                HTMLAttributes: {},
+                node: { attrs: { dataAttributes: {} } }
+            });
+            expect(rowRender[0]).toBe('tr');
+        });
+        it('should configure List extensions with attributes', () => {
+            getExtensions();
+            expect(OrderedList.extend).toHaveBeenCalled();
+            // @ts-expect-error Mock implementation
+            const olConfig = OrderedList.extend.mock.calls[0][0];
+            const olAttrs = olConfig.addAttributes();
+            expect(olAttrs).toHaveProperty('class');
+            const olRender = olConfig.renderHTML({
+                HTMLAttributes: { style: 'list-style: none' },
+                node: { attrs: { dataAttributes: {}, otherAttrs: {} } }
+            });
+            expect(olRender[0]).toBe('ol');
+            expect(olRender[1]).toHaveProperty('style', 'list-style: none');
+            expect(ListItem.extend).toHaveBeenCalled();
+            // @ts-expect-error Mock implementation
+            const liConfig = ListItem.extend.mock.calls[0][0];
+            const liAttrs = liConfig.addAttributes();
+            expect(liAttrs).toHaveProperty('id');
+            const liRender = liConfig.renderHTML({
+                HTMLAttributes: { class: 'item' },
+                node: { attrs: { dataAttributes: { 'data-active': 'true' } } }
+            });
+            expect(liRender[0]).toBe('li');
+            expect(liRender[1]).toEqual(expect.objectContaining({
+                'data-active': 'true',
+                class: 'item'
+            }));
+        });
+        it('should configure BulletList and CodeBlock extensions with attributes', () => {
+            getExtensions();
+            expect(BulletList.extend).toHaveBeenCalled();
+            // @ts-expect-error Mock implementation
+            const blConfig = BulletList.extend.mock.calls[0][0];
+            const blAttrs = blConfig.addAttributes();
+            expect(blAttrs).toHaveProperty('class');
+            const blRender = blConfig.renderHTML({
+                HTMLAttributes: { class: 'ul-cls' },
+                node: { attrs: { dataAttributes: {} } }
+            });
+            expect(blRender[0]).toBe('ul');
+            expect(CodeBlock.extend).toHaveBeenCalled();
+            // @ts-expect-error Mock implementation
+            const cbConfig = CodeBlock.extend.mock.calls[0][0];
+            const cbAttrs = cbConfig.addAttributes();
+            expect(cbAttrs).toHaveProperty('style');
+            const cbRender = cbConfig.renderHTML({
+                HTMLAttributes: { class: 'code-block' },
+                node: { attrs: { dataAttributes: { 'data-lang': 'js' } } }
+            });
+            expect(cbRender[0]).toBe('pre');
+            expect(cbRender[1]).toHaveProperty('data-lang', 'js');
+            expect(cbRender[2][0]).toBe('code');
+        });
+        it('should configure Heading and Blockquote extensions with attributes', () => {
+            getExtensions();
+            expect(Heading.extend).toHaveBeenCalled();
+            // @ts-expect-error Mock implementation
+            const headingConfig = Heading.extend.mock.calls[0][0];
+            const headingAttrs = headingConfig.addAttributes();
+            expect(headingAttrs).toHaveProperty('class');
+            const context = { options: { levels: [1, 2, 3, 4, 5, 6] } };
+            const headingRender = headingConfig.renderHTML.call(context, {
+                HTMLAttributes: { style: 'heading-style' },
+                node: { attrs: { level: 1, dataAttributes: {}, otherAttrs: {} } }
+            });
+            expect(headingRender[0]).toBe('h1');
+            expect(headingRender[1]).toHaveProperty('style', 'heading-style');
+            // Test invalid level fallback
+            const invalidLevelRender = headingConfig.renderHTML.call(context, {
+                HTMLAttributes: {},
+                node: { attrs: { level: 99, dataAttributes: {} } }
+            });
+            // Should fallback to levels[0] which is 1
+            expect(invalidLevelRender[0]).toBe('h1');
+            expect(Blockquote.extend).toHaveBeenCalled();
+            // @ts-expect-error Mock implementation
+            const bqConfig = Blockquote.extend.mock.calls[0][0];
+            const bqAttrs = bqConfig.addAttributes();
+            expect(bqAttrs).toHaveProperty('id');
+            const bqRender = bqConfig.renderHTML({
+                HTMLAttributes: { class: 'bq' },
+                node: { attrs: { dataAttributes: { 'data-foo': 'bar' } } }
+            });
+            // Expected ['blockquote', attrs, TIPTAP_CONTENT_HOLE]
+            expect(bqRender[0]).toBe('blockquote');
+            expect(bqRender[1]).toEqual(expect.objectContaining({
+                'data-foo': 'bar',
+                class: 'bq'
+            }));
+        });
     });
     describe('validateLink', () => {
         const ctx = {

package/dist/cjs/tiptap/utils/__tests__/tiptap-extensions.test.ts

@@ -1,7 +1,12 @@
 import { ChainedCommands, Editor } from '@tiptap/core';
+import Blockquote from '@tiptap/extension-blockquote';
+import CodeBlock from '@tiptap/extension-code-block';
 import FileHandler from '@tiptap/extension-file-handler';
+import Heading from '@tiptap/extension-heading';
 import HorizontalRule from '@tiptap/extension-horizontal-rule';
+import { BulletList, ListItem, OrderedList } from '@tiptap/extension-list';
 import Paragraph from '@tiptap/extension-paragraph';
+import { Table, TableRow } from '@tiptap/extension-table';
 import { describe, expect, it, vi } from 'vitest';
 
 import {
@@ -17,6 +22,22 @@ vi.mock('@tiptap/extension-paragraph', () => ({
   default: { extend: vi.fn() }
 }));
 
+vi.mock('@tiptap/extension-blockquote', () => ({
+  default: { extend: vi.fn() }
+}));
+
+vi.mock('@tiptap/extension-heading', () => ({
+  default: {
+    extend: vi.fn(() => ({
+      configure: vi.fn()
+    }))
+  }
+}));
+
+vi.mock('@tiptap/extension-code-block', () => ({
+  default: { extend: vi.fn() }
+}));
+
 vi.mock('@tiptap/extension-horizontal-rule', () => ({
   default: {
     extend: vi.fn(config => ({ ...config, name: 'horizontalRule' }))
@@ -45,6 +66,48 @@ vi.mock('@tiptap/extension-file-handler', () => ({
   }
 }));
 
+vi.mock('@tiptap/extension-table', async importOriginal => {
+  const actual =
+    await importOriginal<typeof import('@tiptap/extension-table')>();
+  return {
+    ...actual,
+    Table: {
+      ...actual.Table,
+      extend: vi.fn(() => ({
+        configure: vi.fn()
+      }))
+    },
+    TableRow: {
+      ...actual.TableRow,
+      extend: vi.fn(() => ({}))
+    }
+  };
+});
+
+vi.mock('@tiptap/extension-list', async importOriginal => {
+  const actual =
+    await importOriginal<typeof import('@tiptap/extension-list')>();
+  return {
+    ...actual,
+    OrderedList: {
+      ...actual.OrderedList,
+      extend: vi.fn()
+    },
+    ListItem: {
+      ...actual.ListItem,
+      extend: vi.fn()
+    },
+    BulletList: {
+      ...actual.BulletList,
+      extend: vi.fn()
+    },
+    TaskItem: {
+      ...actual.TaskItem,
+      configure: vi.fn()
+    }
+  };
+});
+
 describe('tiptap-extensions', () => {
   describe('getExtensions', () => {
     it('should return an array of extensions', () => {
@@ -64,6 +127,18 @@ describe('tiptap-extensions', () => {
       expect(attrs).toHaveProperty('style');
       expect(attrs).toHaveProperty('class');
       expect(attrs).toHaveProperty('id');
+
+      const render = config.renderHTML({
+        HTMLAttributes: { class: 'p-cls' },
+        node: { attrs: { dataAttributes: { 'data-test': 'val' } } }
+      });
+      expect(render[0]).toBe('p');
+      expect(render[1]).toEqual(
+        expect.objectContaining({
+          class: 'p-cls',
+          'data-test': 'val'
+        })
+      );
     });
 
     it('should configure HorizontalRule with addNodeView', () => {
@@ -111,6 +186,165 @@ describe('tiptap-extensions', () => {
 
       vi.stubGlobal('FileReader', undefined);
     });
+
+    it('should configure Table and TableRow extensions with attributes', () => {
+      getExtensions();
+
+      expect(Table.extend).toHaveBeenCalled();
+      // @ts-expect-error Mock implementation
+      const tableConfig = Table.extend.mock.calls[0][0];
+
+      const tableAttrs = tableConfig.addAttributes();
+      expect(tableAttrs).toHaveProperty('style');
+      expect(tableAttrs).toHaveProperty('class');
+
+      const tableRender = tableConfig.renderHTML({
+        HTMLAttributes: { class: 'test' },
+        node: { attrs: { dataAttributes: { 'data-foo': 'bar' } } }
+      });
+
+      // Expected: ['table', attrs, ['tbody', 0]]
+      expect(tableRender[0]).toBe('table');
+      expect(tableRender[1]).toEqual(
+        expect.objectContaining({
+          'data-foo': 'bar',
+          class: 'test'
+        })
+      );
+      expect(tableRender[2]).toBe(0);
+
+      expect(TableRow.extend).toHaveBeenCalled();
+      // @ts-expect-error Mock implementation
+      const rowConfig = TableRow.extend.mock.calls[0][0];
+
+      const rowAttrs = rowConfig.addAttributes();
+      expect(rowAttrs).toHaveProperty('id');
+
+      const rowRender = rowConfig.renderHTML({
+        HTMLAttributes: {},
+        node: { attrs: { dataAttributes: {} } }
+      });
+      expect(rowRender[0]).toBe('tr');
+    });
+
+    it('should configure List extensions with attributes', () => {
+      getExtensions();
+
+      expect(OrderedList.extend).toHaveBeenCalled();
+      // @ts-expect-error Mock implementation
+      const olConfig = OrderedList.extend.mock.calls[0][0];
+
+      const olAttrs = olConfig.addAttributes();
+      expect(olAttrs).toHaveProperty('class');
+
+      const olRender = olConfig.renderHTML({
+        HTMLAttributes: { style: 'list-style: none' },
+        node: { attrs: { dataAttributes: {}, otherAttrs: {} } }
+      });
+
+      expect(olRender[0]).toBe('ol');
+      expect(olRender[1]).toHaveProperty('style', 'list-style: none');
+
+      expect(ListItem.extend).toHaveBeenCalled();
+      // @ts-expect-error Mock implementation
+      const liConfig = ListItem.extend.mock.calls[0][0];
+
+      const liAttrs = liConfig.addAttributes();
+      expect(liAttrs).toHaveProperty('id');
+
+      const liRender = liConfig.renderHTML({
+        HTMLAttributes: { class: 'item' },
+        node: { attrs: { dataAttributes: { 'data-active': 'true' } } }
+      });
+      expect(liRender[0]).toBe('li');
+      expect(liRender[1]).toEqual(
+        expect.objectContaining({
+          'data-active': 'true',
+          class: 'item'
+        })
+      );
+    });
+
+    it('should configure BulletList and CodeBlock extensions with attributes', () => {
+      getExtensions();
+
+      expect(BulletList.extend).toHaveBeenCalled();
+      // @ts-expect-error Mock implementation
+      const blConfig = BulletList.extend.mock.calls[0][0];
+
+      const blAttrs = blConfig.addAttributes();
+      expect(blAttrs).toHaveProperty('class');
+
+      const blRender = blConfig.renderHTML({
+        HTMLAttributes: { class: 'ul-cls' },
+        node: { attrs: { dataAttributes: {} } }
+      });
+      expect(blRender[0]).toBe('ul');
+
+      expect(CodeBlock.extend).toHaveBeenCalled();
+      // @ts-expect-error Mock implementation
+      const cbConfig = CodeBlock.extend.mock.calls[0][0];
+
+      const cbAttrs = cbConfig.addAttributes();
+      expect(cbAttrs).toHaveProperty('style');
+
+      const cbRender = cbConfig.renderHTML({
+        HTMLAttributes: { class: 'code-block' },
+        node: { attrs: { dataAttributes: { 'data-lang': 'js' } } }
+      });
+
+      expect(cbRender[0]).toBe('pre');
+      expect(cbRender[1]).toHaveProperty('data-lang', 'js');
+      expect(cbRender[2][0]).toBe('code');
+    });
+
+    it('should configure Heading and Blockquote extensions with attributes', () => {
+      getExtensions();
+
+      expect(Heading.extend).toHaveBeenCalled();
+      // @ts-expect-error Mock implementation
+      const headingConfig = Heading.extend.mock.calls[0][0];
+
+      const headingAttrs = headingConfig.addAttributes();
+      expect(headingAttrs).toHaveProperty('class');
+
+      const context = { options: { levels: [1, 2, 3, 4, 5, 6] } };
+      const headingRender = headingConfig.renderHTML.call(context, {
+        HTMLAttributes: { style: 'heading-style' },
+        node: { attrs: { level: 1, dataAttributes: {}, otherAttrs: {} } }
+      });
+
+      expect(headingRender[0]).toBe('h1');
+      expect(headingRender[1]).toHaveProperty('style', 'heading-style');
+
+      // Test invalid level fallback
+      const invalidLevelRender = headingConfig.renderHTML.call(context, {
+        HTMLAttributes: {},
+        node: { attrs: { level: 99, dataAttributes: {} } }
+      });
+      // Should fallback to levels[0] which is 1
+      expect(invalidLevelRender[0]).toBe('h1');
+
+      expect(Blockquote.extend).toHaveBeenCalled();
+      // @ts-expect-error Mock implementation
+      const bqConfig = Blockquote.extend.mock.calls[0][0];
+
+      const bqAttrs = bqConfig.addAttributes();
+      expect(bqAttrs).toHaveProperty('id');
+
+      const bqRender = bqConfig.renderHTML({
+        HTMLAttributes: { class: 'bq' },
+        node: { attrs: { dataAttributes: { 'data-foo': 'bar' } } }
+      });
+      // Expected ['blockquote', attrs, TIPTAP_CONTENT_HOLE]
+      expect(bqRender[0]).toBe('blockquote');
+      expect(bqRender[1]).toEqual(
+        expect.objectContaining({
+          'data-foo': 'bar',
+          class: 'bq'
+        })
+      );
+    });
   });
 
   describe('validateLink', () => {

package/dist/cjs/tiptap/utils/clean-html.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Cleans and normalizes HTML by merging duplicate nested spans with the same attributes.
+ * This prevents accumulation of wrapper spans during source ↔ preview mode switches.
+ *
+ * @param html - Raw HTML string
+ * @returns Cleaned HTML with merged duplicate spans
+ */
+export declare const cleanDuplicateSpans: (html: string) => string;
+//# sourceMappingURL=clean-html.d.ts.map

package/dist/cjs/tiptap/utils/clean-html.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean-html.d.ts","sourceRoot":"","sources":["../../../../src/tiptap/utils/clean-html.ts"],"names":[],"mappings":"AAEA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,MAgFlD,CAAC"}

package/dist/cjs/tiptap/utils/clean-html.js

@@ -0,0 +1,75 @@
+import { HTML_ELEMENTS } from '../constants';
+/**
+ * Cleans and normalizes HTML by merging duplicate nested spans with the same attributes.
+ * This prevents accumulation of wrapper spans during source ↔ preview mode switches.
+ *
+ * @param html - Raw HTML string
+ * @returns Cleaned HTML with merged duplicate spans
+ */
+export const cleanDuplicateSpans = (html) => {
+    // Only run in browser environment
+    if (typeof window === 'undefined' || typeof document === 'undefined') {
+        return html;
+    }
+    // Use template element to preserve script tags and other content
+    const template = document.createElement('template');
+    template.innerHTML = html;
+    const mergeNestedSpans = (element) => {
+        // Process children first (bottom-up)
+        Array.from(element.children).forEach(child => mergeNestedSpans(child));
+        if (element.tagName === HTML_ELEMENTS.SPAN.toUpperCase()) {
+            // 1. Remove empty spans (no attributes, no content or just whitespace)
+            if (!element.hasAttributes() &&
+                (!element.textContent || !element.textContent.trim())) {
+                element.remove();
+                return;
+            }
+            // 2. Unwrap spans with no attributes
+            if (!element.hasAttributes()) {
+                const parent = element.parentNode;
+                if (parent) {
+                    while (element.firstChild) {
+                        parent.insertBefore(element.firstChild, element);
+                    }
+                    parent.removeChild(element);
+                    return;
+                }
+            }
+            // 3. Merge with child span if it's the only child
+            if (element.children.length === 1 &&
+                element.children[0].tagName === HTML_ELEMENTS.SPAN.toUpperCase()) {
+                const child = element.children[0];
+                const parentStyle = element.getAttribute('style') || '';
+                const childStyle = child.getAttribute('style') || '';
+                // Simple check: if styles match exactly
+                if (parentStyle === childStyle) {
+                    while (child.firstChild) {
+                        element.insertBefore(child.firstChild, child);
+                    }
+                    element.removeChild(child);
+                }
+                // If parent has NO style, unwrap parent (keep child attributes)
+                else if (!parentStyle) {
+                    const parentNode = element.parentNode;
+                    if (parentNode) {
+                        while (element.firstChild) {
+                            parentNode.insertBefore(element.firstChild, element);
+                        }
+                        parentNode.removeChild(element);
+                    }
+                }
+            }
+        }
+    };
+    // Process each child element in the template content
+    Array.from(template.content.children).forEach(child => mergeNestedSpans(child));
+    // Return the cleaned HTML
+    return Array.from(template.content.childNodes)
+        .map(node => {
+        if (node.nodeType === Node.ELEMENT_NODE) {
+            return node.outerHTML;
+        }
+        return node.textContent || '';
+    })
+        .join('');
+};

package/dist/cjs/tiptap/utils/data-attributes-helper.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Data Attributes Helper for Tiptap Extensions
+ *
+ * This helper provides utilities for adding data-* attribute support to Tiptap extensions.
+ */
+export declare const createDataAttributesConfig: () => {
+    dataAttributes: {
+        default: {};
+        parseHTML: (element: HTMLElement) => Record<string, string>;
+        renderHTML: (attributes: Record<string, unknown>) => {};
+    };
+};
+export declare const extractDataAttributes: (nodeAttrs: Record<string, unknown>) => {
+    dataAttributes: Record<string, string>;
+    otherAttrs: {
+        [x: string]: unknown;
+    };
+};
+export declare const addDataAttributesToParent: (parent?: () => Record<string, unknown>) => Record<string, unknown>;
+//# sourceMappingURL=data-attributes-helper.d.ts.map

package/dist/cjs/tiptap/utils/data-attributes-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-attributes-helper.d.ts","sourceRoot":"","sources":["../../../../src/tiptap/utils/data-attributes-helper.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,0BAA0B;;;6BAGd,WAAW;iCAUP,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;CAIlD,CAAC;AAEH,eAAO,MAAM,qBAAqB,GAAI,WAAW,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;;;;CAOvE,CAAC;AAEF,eAAO,MAAM,yBAAyB,GACpC,SAAS,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KACrC,MAAM,CAAC,MAAM,EAAE,OAAO,CA+BxB,CAAC"}