@tiptap/extension-table 3.27.4 → 3.29.0

package/dist/cell/index.cjs

@@ -75,6 +75,23 @@ function parseColwidth(element) {
   return parseColgroupWidth(element);
 }
 
+// src/utils/fillEmptyCellContent.ts
+var COLLAPSIBLE_WHITESPACE = /[ \t\r\n\f]+/g;
+function isEmptyCellElement(element) {
+  var _a;
+  if (element.children.length > 0) {
+    return false;
+  }
+  return ((_a = element.textContent) != null ? _a : "").replace(COLLAPSIBLE_WHITESPACE, "") === "";
+}
+function fillEmptyCellContent(cellType) {
+  const filled = cellType.createAndFill();
+  if (!filled) {
+    throw new Error(`[tiptap error]: "${cellType.name}" has no default content to backfill.`);
+  }
+  return filled.content;
+}
+
 // src/cell/table-cell.ts
 var TableCell = import_core.Node.create({
   name: "tableCell",
@@ -102,7 +119,15 @@ var TableCell = import_core.Node.create({
   tableRole: "cell",
   isolating: true,
   parseHTML() {
-    return [{ tag: "td" }];
+    return [
+      {
+        // Backfill empty cells; non-empty cells fall through to the rule below.
+        tag: "td",
+        getAttrs: (node) => isEmptyCellElement(node) ? {} : false,
+        getContent: (_node, schema) => fillEmptyCellContent(schema.nodes[this.name])
+      },
+      { tag: "td" }
+    ];
   },
   renderHTML({ HTMLAttributes }) {
     return ["td", (0, import_core.mergeAttributes)(this.options.HTMLAttributes, HTMLAttributes), 0];

package/dist/cell/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cell/index.ts","../../src/cell/table-cell.ts","../../src/utils/parseAlign.ts","../../src/utils/parseColwidth.ts"],"sourcesContent":["export * from './table-cell.js'\n","import '../types.js'\n\nimport { mergeAttributes, Node } from '@tiptap/core'\n\nimport { createAlignAttribute } from '../utils/parseAlign.js'\nimport { parseColwidth } from '../utils/parseColwidth.js'\n\nexport interface TableCellOptions {\n  /**\n   * The HTML attributes for a table cell node.\n   * @default {}\n   * @example { class: 'foo' }\n   */\n  HTMLAttributes: Record<string, any>\n}\n\n/**\n * This extension allows you to create table cells.\n * @see https://www.tiptap.dev/api/nodes/table-cell\n */\nexport const TableCell = Node.create<TableCellOptions>({\n  name: 'tableCell',\n\n  addOptions() {\n    return {\n      HTMLAttributes: {},\n    }\n  },\n\n  content: 'block+',\n\n  addAttributes() {\n    return {\n      colspan: {\n        default: 1,\n      },\n      rowspan: {\n        default: 1,\n      },\n      colwidth: {\n        default: null,\n        parseHTML: parseColwidth,\n      },\n      align: createAlignAttribute(),\n    }\n  },\n\n  tableRole: 'cell',\n\n  isolating: true,\n\n  parseHTML() {\n    return [{ tag: 'td' }]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['td', mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0]\n  },\n})\n","import type { Attribute } from '@tiptap/core'\n\n/**\n * Supported table cell alignment values\n */\nexport enum TableCellAlign {\n  Left = 'left',\n  Right = 'right',\n  Center = 'center',\n}\n\n/**\n * Normalize unknown input into a supported table alignment\n *\n * @param value - A potential alignment value\n * @returns A valid TableCellAlign value or null\n */\nexport function normalizeTableCellAlign(value: unknown): TableCellAlign | null {\n  if (\n    value === TableCellAlign.Left ||\n    value === TableCellAlign.Right ||\n    value === TableCellAlign.Center\n  ) {\n    return value\n  }\n\n  return null\n}\n\n/**\n * Parse table cell alignment from an HTML element\n *\n * Prefers inline style (${\"`\"}text-align${\"`\"}) and falls back to the legacy\n * ${\"`\"}align${\"`\"} attribute.\n *\n * @param element - The table cell/header DOM element\n * @returns A valid TableCellAlign value or null\n */\nexport function parseAlign(element: HTMLElement): TableCellAlign | null {\n  const styleAlign = (element.style.textAlign || '').trim().toLowerCase()\n  const attrAlign = (element.getAttribute('align') || '').trim().toLowerCase()\n  const align = styleAlign || attrAlign\n\n  return normalizeTableCellAlign(align)\n}\n\n/**\n * Normalize alignment from a generic attrs object that may include an align field\n *\n * @param attributes - A node attrs-like object with an optional align field\n * @returns A valid TableCellAlign value or null.\n */\nexport function normalizeTableCellAlignFromAttributes(\n  attributes: { align?: TableCellAlign } | null | undefined,\n): TableCellAlign | null {\n  return normalizeTableCellAlign(attributes?.align)\n}\n\n/**\n * Create a reusable Tiptap attribute config for table alignment\n *\n * @returns A Tiptap Attribute definition that parses and renders table alignment\n */\nexport function createAlignAttribute(): Attribute {\n  return {\n    default: null,\n    parseHTML: (element: HTMLElement) => parseAlign(element),\n    renderHTML: (attributes: { align?: TableCellAlign | null }) => {\n      if (!attributes.align) {\n        return {}\n      }\n\n      return {\n        style: `text-align: ${attributes.align}`,\n      }\n    },\n  }\n}\n","/**\n * reads the width of the `<col>` element matching a cell's column from the table's `<colgroup>`\n *\n * @param element - The table cell/header DOM element\n * @returns - An array with the column width in pixels or null\n */\nfunction parseColgroupWidth(element: HTMLElement): number[] | null {\n  const row = element.parentElement\n  const table = element.closest('table')\n\n  if (!row || !table) {\n    return null\n  }\n\n  const cellIndex = Array.from(row.children).indexOf(element)\n  const width = table.querySelectorAll('colgroup > col')[cellIndex]?.getAttribute('width')\n\n  return width ? [parseInt(width, 10)] : null\n}\n\n/**\n * Parse the column width/s of a table cell/header from an HTML element.\n * it prefers the `colwidth` attribute and if not-provided falls back to the `width` attribute\n * of the matching `<col>` element in the table's `<colgroup>`.\n *\n * @param element - The table cell/header DOM element\n * @returns - An array of column widths in pixels or null\n */\nexport function parseColwidth(element: HTMLElement): number[] | null {\n  const colwidth = element.getAttribute('colwidth')\n\n  if (colwidth) {\n    return colwidth.split(',').map(width => parseInt(width, 10))\n  }\n\n  return parseColgroupWidth(element)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,kBAAsC;;;ACe/B,SAAS,wBAAwB,OAAuC;AAC7E,MACE,UAAU,qBACV,UAAU,uBACV,UAAU,uBACV;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAWO,SAAS,WAAW,SAA6C;AACtE,QAAM,cAAc,QAAQ,MAAM,aAAa,IAAI,KAAK,EAAE,YAAY;AACtE,QAAM,aAAa,QAAQ,aAAa,OAAO,KAAK,IAAI,KAAK,EAAE,YAAY;AAC3E,QAAM,QAAQ,cAAc;AAE5B,SAAO,wBAAwB,KAAK;AACtC;AAmBO,SAAS,uBAAkC;AAChD,SAAO;AAAA,IACL,SAAS;AAAA,IACT,WAAW,CAAC,YAAyB,WAAW,OAAO;AAAA,IACvD,YAAY,CAAC,eAAkD;AAC7D,UAAI,CAAC,WAAW,OAAO;AACrB,eAAO,CAAC;AAAA,MACV;AAEA,aAAO;AAAA,QACL,OAAO,eAAe,WAAW,KAAK;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AACF;;;ACvEA,SAAS,mBAAmB,SAAuC;AANnE;AAOE,QAAM,MAAM,QAAQ;AACpB,QAAM,QAAQ,QAAQ,QAAQ,OAAO;AAErC,MAAI,CAAC,OAAO,CAAC,OAAO;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,MAAM,KAAK,IAAI,QAAQ,EAAE,QAAQ,OAAO;AAC1D,QAAM,SAAQ,WAAM,iBAAiB,gBAAgB,EAAE,SAAS,MAAlD,mBAAqD,aAAa;AAEhF,SAAO,QAAQ,CAAC,SAAS,OAAO,EAAE,CAAC,IAAI;AACzC;AAUO,SAAS,cAAc,SAAuC;AACnE,QAAM,WAAW,QAAQ,aAAa,UAAU;AAEhD,MAAI,UAAU;AACZ,WAAO,SAAS,MAAM,GAAG,EAAE,IAAI,WAAS,SAAS,OAAO,EAAE,CAAC;AAAA,EAC7D;AAEA,SAAO,mBAAmB,OAAO;AACnC;;;AFhBO,IAAM,YAAY,iBAAK,OAAyB;AAAA,EACrD,MAAM;AAAA,EAEN,aAAa;AACX,WAAO;AAAA,MACL,gBAAgB,CAAC;AAAA,IACnB;AAAA,EACF;AAAA,EAEA,SAAS;AAAA,EAET,gBAAgB;AACd,WAAO;AAAA,MACL,SAAS;AAAA,QACP,SAAS;AAAA,MACX;AAAA,MACA,SAAS;AAAA,QACP,SAAS;AAAA,MACX;AAAA,MACA,UAAU;AAAA,QACR,SAAS;AAAA,QACT,WAAW;AAAA,MACb;AAAA,MACA,OAAO,qBAAqB;AAAA,IAC9B;AAAA,EACF;AAAA,EAEA,WAAW;AAAA,EAEX,WAAW;AAAA,EAEX,YAAY;AACV,WAAO,CAAC,EAAE,KAAK,KAAK,CAAC;AAAA,EACvB;AAAA,EAEA,WAAW,EAAE,eAAe,GAAG;AAC7B,WAAO,CAAC,UAAM,6BAAgB,KAAK,QAAQ,gBAAgB,cAAc,GAAG,CAAC;AAAA,EAC/E;AACF,CAAC;","names":[]}
+{"version":3,"sources":["../../src/cell/index.ts","../../src/cell/table-cell.ts","../../src/utils/parseAlign.ts","../../src/utils/parseColwidth.ts","../../src/utils/fillEmptyCellContent.ts"],"sourcesContent":["export * from './table-cell.js'\n","import '../types.js'\n\nimport { mergeAttributes, Node } from '@tiptap/core'\n\nimport { createAlignAttribute } from '../utils/parseAlign.js'\nimport { parseColwidth } from '../utils/parseColwidth.js'\nimport { fillEmptyCellContent, isEmptyCellElement } from '../utils/fillEmptyCellContent.js'\n\nexport interface TableCellOptions {\n  /**\n   * The HTML attributes for a table cell node.\n   * @default {}\n   * @example { class: 'foo' }\n   */\n  HTMLAttributes: Record<string, any>\n}\n\n/**\n * This extension allows you to create table cells.\n * @see https://www.tiptap.dev/api/nodes/table-cell\n */\nexport const TableCell = Node.create<TableCellOptions>({\n  name: 'tableCell',\n\n  addOptions() {\n    return {\n      HTMLAttributes: {},\n    }\n  },\n\n  content: 'block+',\n\n  addAttributes() {\n    return {\n      colspan: {\n        default: 1,\n      },\n      rowspan: {\n        default: 1,\n      },\n      colwidth: {\n        default: null,\n        parseHTML: parseColwidth,\n      },\n      align: createAlignAttribute(),\n    }\n  },\n\n  tableRole: 'cell',\n\n  isolating: true,\n\n  parseHTML() {\n    return [\n      {\n        // Backfill empty cells; non-empty cells fall through to the rule below.\n        tag: 'td',\n        getAttrs: node => (isEmptyCellElement(node) ? {} : false),\n        getContent: (_node, schema) => fillEmptyCellContent(schema.nodes[this.name]),\n      },\n      { tag: 'td' },\n    ]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['td', mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0]\n  },\n})\n","import type { Attribute } from '@tiptap/core'\n\n/**\n * Supported table cell alignment values\n */\nexport enum TableCellAlign {\n  Left = 'left',\n  Right = 'right',\n  Center = 'center',\n}\n\n/**\n * Normalize unknown input into a supported table alignment\n *\n * @param value - A potential alignment value\n * @returns A valid TableCellAlign value or null\n */\nexport function normalizeTableCellAlign(value: unknown): TableCellAlign | null {\n  if (\n    value === TableCellAlign.Left ||\n    value === TableCellAlign.Right ||\n    value === TableCellAlign.Center\n  ) {\n    return value\n  }\n\n  return null\n}\n\n/**\n * Parse table cell alignment from an HTML element\n *\n * Prefers inline style (${\"`\"}text-align${\"`\"}) and falls back to the legacy\n * ${\"`\"}align${\"`\"} attribute.\n *\n * @param element - The table cell/header DOM element\n * @returns A valid TableCellAlign value or null\n */\nexport function parseAlign(element: HTMLElement): TableCellAlign | null {\n  const styleAlign = (element.style.textAlign || '').trim().toLowerCase()\n  const attrAlign = (element.getAttribute('align') || '').trim().toLowerCase()\n  const align = styleAlign || attrAlign\n\n  return normalizeTableCellAlign(align)\n}\n\n/**\n * Normalize alignment from a generic attrs object that may include an align field\n *\n * @param attributes - A node attrs-like object with an optional align field\n * @returns A valid TableCellAlign value or null.\n */\nexport function normalizeTableCellAlignFromAttributes(\n  attributes: { align?: TableCellAlign } | null | undefined,\n): TableCellAlign | null {\n  return normalizeTableCellAlign(attributes?.align)\n}\n\n/**\n * Create a reusable Tiptap attribute config for table alignment\n *\n * @returns A Tiptap Attribute definition that parses and renders table alignment\n */\nexport function createAlignAttribute(): Attribute {\n  return {\n    default: null,\n    parseHTML: (element: HTMLElement) => parseAlign(element),\n    renderHTML: (attributes: { align?: TableCellAlign | null }) => {\n      if (!attributes.align) {\n        return {}\n      }\n\n      return {\n        style: `text-align: ${attributes.align}`,\n      }\n    },\n  }\n}\n","/**\n * reads the width of the `<col>` element matching a cell's column from the table's `<colgroup>`\n *\n * @param element - The table cell/header DOM element\n * @returns - An array with the column width in pixels or null\n */\nfunction parseColgroupWidth(element: HTMLElement): number[] | null {\n  const row = element.parentElement\n  const table = element.closest('table')\n\n  if (!row || !table) {\n    return null\n  }\n\n  const cellIndex = Array.from(row.children).indexOf(element)\n  const width = table.querySelectorAll('colgroup > col')[cellIndex]?.getAttribute('width')\n\n  return width ? [parseInt(width, 10)] : null\n}\n\n/**\n * Parse the column width/s of a table cell/header from an HTML element.\n * it prefers the `colwidth` attribute and if not-provided falls back to the `width` attribute\n * of the matching `<col>` element in the table's `<colgroup>`.\n *\n * @param element - The table cell/header DOM element\n * @returns - An array of column widths in pixels or null\n */\nexport function parseColwidth(element: HTMLElement): number[] | null {\n  const colwidth = element.getAttribute('colwidth')\n\n  if (colwidth) {\n    return colwidth.split(',').map(width => parseInt(width, 10))\n  }\n\n  return parseColgroupWidth(element)\n}\n","import type { NodeType } from '@tiptap/pm/model'\nimport { Fragment } from '@tiptap/pm/model'\n\n// ASCII whitespace only, so a non-breaking-space cell is not treated as empty.\nconst COLLAPSIBLE_WHITESPACE = /[ \\t\\r\\n\\f]+/g\n\n/** Whether a cell/header element has no child elements and only collapsible whitespace. */\nexport function isEmptyCellElement(element: HTMLElement): boolean {\n  if (element.children.length > 0) {\n    return false\n  }\n\n  return (element.textContent ?? '').replace(COLLAPSIBLE_WHITESPACE, '') === ''\n}\n\n/** Builds a cell/header's minimal `block+` content, derived from the node type. */\nexport function fillEmptyCellContent(cellType: NodeType): Fragment {\n  const filled = cellType.createAndFill()\n\n  if (!filled) {\n    throw new Error(`[tiptap error]: \"${cellType.name}\" has no default content to backfill.`)\n  }\n\n  return filled.content\n}\n"],"mappings":"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","names":[]}

package/dist/cell/index.js

@@ -49,6 +49,23 @@ function parseColwidth(element) {
   return parseColgroupWidth(element);
 }
 
+// src/utils/fillEmptyCellContent.ts
+var COLLAPSIBLE_WHITESPACE = /[ \t\r\n\f]+/g;
+function isEmptyCellElement(element) {
+  var _a;
+  if (element.children.length > 0) {
+    return false;
+  }
+  return ((_a = element.textContent) != null ? _a : "").replace(COLLAPSIBLE_WHITESPACE, "") === "";
+}
+function fillEmptyCellContent(cellType) {
+  const filled = cellType.createAndFill();
+  if (!filled) {
+    throw new Error(`[tiptap error]: "${cellType.name}" has no default content to backfill.`);
+  }
+  return filled.content;
+}
+
 // src/cell/table-cell.ts
 var TableCell = Node.create({
   name: "tableCell",
@@ -76,7 +93,15 @@ var TableCell = Node.create({
   tableRole: "cell",
   isolating: true,
   parseHTML() {
-    return [{ tag: "td" }];
+    return [
+      {
+        // Backfill empty cells; non-empty cells fall through to the rule below.
+        tag: "td",
+        getAttrs: (node) => isEmptyCellElement(node) ? {} : false,
+        getContent: (_node, schema) => fillEmptyCellContent(schema.nodes[this.name])
+      },
+      { tag: "td" }
+    ];
   },
   renderHTML({ HTMLAttributes }) {
     return ["td", mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0];

package/dist/cell/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cell/table-cell.ts","../../src/utils/parseAlign.ts","../../src/utils/parseColwidth.ts"],"sourcesContent":["import '../types.js'\n\nimport { mergeAttributes, Node } from '@tiptap/core'\n\nimport { createAlignAttribute } from '../utils/parseAlign.js'\nimport { parseColwidth } from '../utils/parseColwidth.js'\n\nexport interface TableCellOptions {\n  /**\n   * The HTML attributes for a table cell node.\n   * @default {}\n   * @example { class: 'foo' }\n   */\n  HTMLAttributes: Record<string, any>\n}\n\n/**\n * This extension allows you to create table cells.\n * @see https://www.tiptap.dev/api/nodes/table-cell\n */\nexport const TableCell = Node.create<TableCellOptions>({\n  name: 'tableCell',\n\n  addOptions() {\n    return {\n      HTMLAttributes: {},\n    }\n  },\n\n  content: 'block+',\n\n  addAttributes() {\n    return {\n      colspan: {\n        default: 1,\n      },\n      rowspan: {\n        default: 1,\n      },\n      colwidth: {\n        default: null,\n        parseHTML: parseColwidth,\n      },\n      align: createAlignAttribute(),\n    }\n  },\n\n  tableRole: 'cell',\n\n  isolating: true,\n\n  parseHTML() {\n    return [{ tag: 'td' }]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['td', mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0]\n  },\n})\n","import type { Attribute } from '@tiptap/core'\n\n/**\n * Supported table cell alignment values\n */\nexport enum TableCellAlign {\n  Left = 'left',\n  Right = 'right',\n  Center = 'center',\n}\n\n/**\n * Normalize unknown input into a supported table alignment\n *\n * @param value - A potential alignment value\n * @returns A valid TableCellAlign value or null\n */\nexport function normalizeTableCellAlign(value: unknown): TableCellAlign | null {\n  if (\n    value === TableCellAlign.Left ||\n    value === TableCellAlign.Right ||\n    value === TableCellAlign.Center\n  ) {\n    return value\n  }\n\n  return null\n}\n\n/**\n * Parse table cell alignment from an HTML element\n *\n * Prefers inline style (${\"`\"}text-align${\"`\"}) and falls back to the legacy\n * ${\"`\"}align${\"`\"} attribute.\n *\n * @param element - The table cell/header DOM element\n * @returns A valid TableCellAlign value or null\n */\nexport function parseAlign(element: HTMLElement): TableCellAlign | null {\n  const styleAlign = (element.style.textAlign || '').trim().toLowerCase()\n  const attrAlign = (element.getAttribute('align') || '').trim().toLowerCase()\n  const align = styleAlign || attrAlign\n\n  return normalizeTableCellAlign(align)\n}\n\n/**\n * Normalize alignment from a generic attrs object that may include an align field\n *\n * @param attributes - A node attrs-like object with an optional align field\n * @returns A valid TableCellAlign value or null.\n */\nexport function normalizeTableCellAlignFromAttributes(\n  attributes: { align?: TableCellAlign } | null | undefined,\n): TableCellAlign | null {\n  return normalizeTableCellAlign(attributes?.align)\n}\n\n/**\n * Create a reusable Tiptap attribute config for table alignment\n *\n * @returns A Tiptap Attribute definition that parses and renders table alignment\n */\nexport function createAlignAttribute(): Attribute {\n  return {\n    default: null,\n    parseHTML: (element: HTMLElement) => parseAlign(element),\n    renderHTML: (attributes: { align?: TableCellAlign | null }) => {\n      if (!attributes.align) {\n        return {}\n      }\n\n      return {\n        style: `text-align: ${attributes.align}`,\n      }\n    },\n  }\n}\n","/**\n * reads the width of the `<col>` element matching a cell's column from the table's `<colgroup>`\n *\n * @param element - The table cell/header DOM element\n * @returns - An array with the column width in pixels or null\n */\nfunction parseColgroupWidth(element: HTMLElement): number[] | null {\n  const row = element.parentElement\n  const table = element.closest('table')\n\n  if (!row || !table) {\n    return null\n  }\n\n  const cellIndex = Array.from(row.children).indexOf(element)\n  const width = table.querySelectorAll('colgroup > col')[cellIndex]?.getAttribute('width')\n\n  return width ? [parseInt(width, 10)] : null\n}\n\n/**\n * Parse the column width/s of a table cell/header from an HTML element.\n * it prefers the `colwidth` attribute and if not-provided falls back to the `width` attribute\n * of the matching `<col>` element in the table's `<colgroup>`.\n *\n * @param element - The table cell/header DOM element\n * @returns - An array of column widths in pixels or null\n */\nexport function parseColwidth(element: HTMLElement): number[] | null {\n  const colwidth = element.getAttribute('colwidth')\n\n  if (colwidth) {\n    return colwidth.split(',').map(width => parseInt(width, 10))\n  }\n\n  return parseColgroupWidth(element)\n}\n"],"mappings":";AAEA,SAAS,iBAAiB,YAAY;;;ACe/B,SAAS,wBAAwB,OAAuC;AAC7E,MACE,UAAU,qBACV,UAAU,uBACV,UAAU,uBACV;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAWO,SAAS,WAAW,SAA6C;AACtE,QAAM,cAAc,QAAQ,MAAM,aAAa,IAAI,KAAK,EAAE,YAAY;AACtE,QAAM,aAAa,QAAQ,aAAa,OAAO,KAAK,IAAI,KAAK,EAAE,YAAY;AAC3E,QAAM,QAAQ,cAAc;AAE5B,SAAO,wBAAwB,KAAK;AACtC;AAmBO,SAAS,uBAAkC;AAChD,SAAO;AAAA,IACL,SAAS;AAAA,IACT,WAAW,CAAC,YAAyB,WAAW,OAAO;AAAA,IACvD,YAAY,CAAC,eAAkD;AAC7D,UAAI,CAAC,WAAW,OAAO;AACrB,eAAO,CAAC;AAAA,MACV;AAEA,aAAO;AAAA,QACL,OAAO,eAAe,WAAW,KAAK;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AACF;;;ACvEA,SAAS,mBAAmB,SAAuC;AANnE;AAOE,QAAM,MAAM,QAAQ;AACpB,QAAM,QAAQ,QAAQ,QAAQ,OAAO;AAErC,MAAI,CAAC,OAAO,CAAC,OAAO;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,MAAM,KAAK,IAAI,QAAQ,EAAE,QAAQ,OAAO;AAC1D,QAAM,SAAQ,WAAM,iBAAiB,gBAAgB,EAAE,SAAS,MAAlD,mBAAqD,aAAa;AAEhF,SAAO,QAAQ,CAAC,SAAS,OAAO,EAAE,CAAC,IAAI;AACzC;AAUO,SAAS,cAAc,SAAuC;AACnE,QAAM,WAAW,QAAQ,aAAa,UAAU;AAEhD,MAAI,UAAU;AACZ,WAAO,SAAS,MAAM,GAAG,EAAE,IAAI,WAAS,SAAS,OAAO,EAAE,CAAC;AAAA,EAC7D;AAEA,SAAO,mBAAmB,OAAO;AACnC;;;AFhBO,IAAM,YAAY,KAAK,OAAyB;AAAA,EACrD,MAAM;AAAA,EAEN,aAAa;AACX,WAAO;AAAA,MACL,gBAAgB,CAAC;AAAA,IACnB;AAAA,EACF;AAAA,EAEA,SAAS;AAAA,EAET,gBAAgB;AACd,WAAO;AAAA,MACL,SAAS;AAAA,QACP,SAAS;AAAA,MACX;AAAA,MACA,SAAS;AAAA,QACP,SAAS;AAAA,MACX;AAAA,MACA,UAAU;AAAA,QACR,SAAS;AAAA,QACT,WAAW;AAAA,MACb;AAAA,MACA,OAAO,qBAAqB;AAAA,IAC9B;AAAA,EACF;AAAA,EAEA,WAAW;AAAA,EAEX,WAAW;AAAA,EAEX,YAAY;AACV,WAAO,CAAC,EAAE,KAAK,KAAK,CAAC;AAAA,EACvB;AAAA,EAEA,WAAW,EAAE,eAAe,GAAG;AAC7B,WAAO,CAAC,MAAM,gBAAgB,KAAK,QAAQ,gBAAgB,cAAc,GAAG,CAAC;AAAA,EAC/E;AACF,CAAC;","names":[]}
+{"version":3,"sources":["../../src/cell/table-cell.ts","../../src/utils/parseAlign.ts","../../src/utils/parseColwidth.ts","../../src/utils/fillEmptyCellContent.ts"],"sourcesContent":["import '../types.js'\n\nimport { mergeAttributes, Node } from '@tiptap/core'\n\nimport { createAlignAttribute } from '../utils/parseAlign.js'\nimport { parseColwidth } from '../utils/parseColwidth.js'\nimport { fillEmptyCellContent, isEmptyCellElement } from '../utils/fillEmptyCellContent.js'\n\nexport interface TableCellOptions {\n  /**\n   * The HTML attributes for a table cell node.\n   * @default {}\n   * @example { class: 'foo' }\n   */\n  HTMLAttributes: Record<string, any>\n}\n\n/**\n * This extension allows you to create table cells.\n * @see https://www.tiptap.dev/api/nodes/table-cell\n */\nexport const TableCell = Node.create<TableCellOptions>({\n  name: 'tableCell',\n\n  addOptions() {\n    return {\n      HTMLAttributes: {},\n    }\n  },\n\n  content: 'block+',\n\n  addAttributes() {\n    return {\n      colspan: {\n        default: 1,\n      },\n      rowspan: {\n        default: 1,\n      },\n      colwidth: {\n        default: null,\n        parseHTML: parseColwidth,\n      },\n      align: createAlignAttribute(),\n    }\n  },\n\n  tableRole: 'cell',\n\n  isolating: true,\n\n  parseHTML() {\n    return [\n      {\n        // Backfill empty cells; non-empty cells fall through to the rule below.\n        tag: 'td',\n        getAttrs: node => (isEmptyCellElement(node) ? {} : false),\n        getContent: (_node, schema) => fillEmptyCellContent(schema.nodes[this.name]),\n      },\n      { tag: 'td' },\n    ]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['td', mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0]\n  },\n})\n","import type { Attribute } from '@tiptap/core'\n\n/**\n * Supported table cell alignment values\n */\nexport enum TableCellAlign {\n  Left = 'left',\n  Right = 'right',\n  Center = 'center',\n}\n\n/**\n * Normalize unknown input into a supported table alignment\n *\n * @param value - A potential alignment value\n * @returns A valid TableCellAlign value or null\n */\nexport function normalizeTableCellAlign(value: unknown): TableCellAlign | null {\n  if (\n    value === TableCellAlign.Left ||\n    value === TableCellAlign.Right ||\n    value === TableCellAlign.Center\n  ) {\n    return value\n  }\n\n  return null\n}\n\n/**\n * Parse table cell alignment from an HTML element\n *\n * Prefers inline style (${\"`\"}text-align${\"`\"}) and falls back to the legacy\n * ${\"`\"}align${\"`\"} attribute.\n *\n * @param element - The table cell/header DOM element\n * @returns A valid TableCellAlign value or null\n */\nexport function parseAlign(element: HTMLElement): TableCellAlign | null {\n  const styleAlign = (element.style.textAlign || '').trim().toLowerCase()\n  const attrAlign = (element.getAttribute('align') || '').trim().toLowerCase()\n  const align = styleAlign || attrAlign\n\n  return normalizeTableCellAlign(align)\n}\n\n/**\n * Normalize alignment from a generic attrs object that may include an align field\n *\n * @param attributes - A node attrs-like object with an optional align field\n * @returns A valid TableCellAlign value or null.\n */\nexport function normalizeTableCellAlignFromAttributes(\n  attributes: { align?: TableCellAlign } | null | undefined,\n): TableCellAlign | null {\n  return normalizeTableCellAlign(attributes?.align)\n}\n\n/**\n * Create a reusable Tiptap attribute config for table alignment\n *\n * @returns A Tiptap Attribute definition that parses and renders table alignment\n */\nexport function createAlignAttribute(): Attribute {\n  return {\n    default: null,\n    parseHTML: (element: HTMLElement) => parseAlign(element),\n    renderHTML: (attributes: { align?: TableCellAlign | null }) => {\n      if (!attributes.align) {\n        return {}\n      }\n\n      return {\n        style: `text-align: ${attributes.align}`,\n      }\n    },\n  }\n}\n","/**\n * reads the width of the `<col>` element matching a cell's column from the table's `<colgroup>`\n *\n * @param element - The table cell/header DOM element\n * @returns - An array with the column width in pixels or null\n */\nfunction parseColgroupWidth(element: HTMLElement): number[] | null {\n  const row = element.parentElement\n  const table = element.closest('table')\n\n  if (!row || !table) {\n    return null\n  }\n\n  const cellIndex = Array.from(row.children).indexOf(element)\n  const width = table.querySelectorAll('colgroup > col')[cellIndex]?.getAttribute('width')\n\n  return width ? [parseInt(width, 10)] : null\n}\n\n/**\n * Parse the column width/s of a table cell/header from an HTML element.\n * it prefers the `colwidth` attribute and if not-provided falls back to the `width` attribute\n * of the matching `<col>` element in the table's `<colgroup>`.\n *\n * @param element - The table cell/header DOM element\n * @returns - An array of column widths in pixels or null\n */\nexport function parseColwidth(element: HTMLElement): number[] | null {\n  const colwidth = element.getAttribute('colwidth')\n\n  if (colwidth) {\n    return colwidth.split(',').map(width => parseInt(width, 10))\n  }\n\n  return parseColgroupWidth(element)\n}\n","import type { NodeType } from '@tiptap/pm/model'\nimport { Fragment } from '@tiptap/pm/model'\n\n// ASCII whitespace only, so a non-breaking-space cell is not treated as empty.\nconst COLLAPSIBLE_WHITESPACE = /[ \\t\\r\\n\\f]+/g\n\n/** Whether a cell/header element has no child elements and only collapsible whitespace. */\nexport function isEmptyCellElement(element: HTMLElement): boolean {\n  if (element.children.length > 0) {\n    return false\n  }\n\n  return (element.textContent ?? '').replace(COLLAPSIBLE_WHITESPACE, '') === ''\n}\n\n/** Builds a cell/header's minimal `block+` content, derived from the node type. */\nexport function fillEmptyCellContent(cellType: NodeType): Fragment {\n  const filled = cellType.createAndFill()\n\n  if (!filled) {\n    throw new Error(`[tiptap error]: \"${cellType.name}\" has no default content to backfill.`)\n  }\n\n  return filled.content\n}\n"],"mappings":"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","names":[]}

package/dist/header/index.cjs

@@ -75,6 +75,23 @@ function parseColwidth(element) {
   return parseColgroupWidth(element);
 }
 
+// src/utils/fillEmptyCellContent.ts
+var COLLAPSIBLE_WHITESPACE = /[ \t\r\n\f]+/g;
+function isEmptyCellElement(element) {
+  var _a;
+  if (element.children.length > 0) {
+    return false;
+  }
+  return ((_a = element.textContent) != null ? _a : "").replace(COLLAPSIBLE_WHITESPACE, "") === "";
+}
+function fillEmptyCellContent(cellType) {
+  const filled = cellType.createAndFill();
+  if (!filled) {
+    throw new Error(`[tiptap error]: "${cellType.name}" has no default content to backfill.`);
+  }
+  return filled.content;
+}
+
 // src/header/table-header.ts
 var TableHeader = import_core.Node.create({
   name: "tableHeader",
@@ -102,7 +119,15 @@ var TableHeader = import_core.Node.create({
   tableRole: "header_cell",
   isolating: true,
   parseHTML() {
-    return [{ tag: "th" }];
+    return [
+      {
+        // Backfill empty cells; non-empty cells fall through to the rule below.
+        tag: "th",
+        getAttrs: (node) => isEmptyCellElement(node) ? {} : false,
+        getContent: (_node, schema) => fillEmptyCellContent(schema.nodes[this.name])
+      },
+      { tag: "th" }
+    ];
   },
   renderHTML({ HTMLAttributes }) {
     return ["th", (0, import_core.mergeAttributes)(this.options.HTMLAttributes, HTMLAttributes), 0];

package/dist/header/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/header/index.ts","../../src/header/table-header.ts","../../src/utils/parseAlign.ts","../../src/utils/parseColwidth.ts"],"sourcesContent":["export * from './table-header.js'\n","import '../types.js'\n\nimport { mergeAttributes, Node } from '@tiptap/core'\n\nimport { createAlignAttribute } from '../utils/parseAlign.js'\nimport { parseColwidth } from '../utils/parseColwidth.js'\n\nexport interface TableHeaderOptions {\n  /**\n   * The HTML attributes for a table header node.\n   * @default {}\n   * @example { class: 'foo' }\n   */\n  HTMLAttributes: Record<string, any>\n}\n\n/**\n * This extension allows you to create table headers.\n * @see https://www.tiptap.dev/api/nodes/table-header\n */\nexport const TableHeader = Node.create<TableHeaderOptions>({\n  name: 'tableHeader',\n\n  addOptions() {\n    return {\n      HTMLAttributes: {},\n    }\n  },\n\n  content: 'block+',\n\n  addAttributes() {\n    return {\n      colspan: {\n        default: 1,\n      },\n      rowspan: {\n        default: 1,\n      },\n      colwidth: {\n        default: null,\n        parseHTML: parseColwidth,\n      },\n      align: createAlignAttribute(),\n    }\n  },\n\n  tableRole: 'header_cell',\n\n  isolating: true,\n\n  parseHTML() {\n    return [{ tag: 'th' }]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['th', mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0]\n  },\n})\n","import type { Attribute } from '@tiptap/core'\n\n/**\n * Supported table cell alignment values\n */\nexport enum TableCellAlign {\n  Left = 'left',\n  Right = 'right',\n  Center = 'center',\n}\n\n/**\n * Normalize unknown input into a supported table alignment\n *\n * @param value - A potential alignment value\n * @returns A valid TableCellAlign value or null\n */\nexport function normalizeTableCellAlign(value: unknown): TableCellAlign | null {\n  if (\n    value === TableCellAlign.Left ||\n    value === TableCellAlign.Right ||\n    value === TableCellAlign.Center\n  ) {\n    return value\n  }\n\n  return null\n}\n\n/**\n * Parse table cell alignment from an HTML element\n *\n * Prefers inline style (${\"`\"}text-align${\"`\"}) and falls back to the legacy\n * ${\"`\"}align${\"`\"} attribute.\n *\n * @param element - The table cell/header DOM element\n * @returns A valid TableCellAlign value or null\n */\nexport function parseAlign(element: HTMLElement): TableCellAlign | null {\n  const styleAlign = (element.style.textAlign || '').trim().toLowerCase()\n  const attrAlign = (element.getAttribute('align') || '').trim().toLowerCase()\n  const align = styleAlign || attrAlign\n\n  return normalizeTableCellAlign(align)\n}\n\n/**\n * Normalize alignment from a generic attrs object that may include an align field\n *\n * @param attributes - A node attrs-like object with an optional align field\n * @returns A valid TableCellAlign value or null.\n */\nexport function normalizeTableCellAlignFromAttributes(\n  attributes: { align?: TableCellAlign } | null | undefined,\n): TableCellAlign | null {\n  return normalizeTableCellAlign(attributes?.align)\n}\n\n/**\n * Create a reusable Tiptap attribute config for table alignment\n *\n * @returns A Tiptap Attribute definition that parses and renders table alignment\n */\nexport function createAlignAttribute(): Attribute {\n  return {\n    default: null,\n    parseHTML: (element: HTMLElement) => parseAlign(element),\n    renderHTML: (attributes: { align?: TableCellAlign | null }) => {\n      if (!attributes.align) {\n        return {}\n      }\n\n      return {\n        style: `text-align: ${attributes.align}`,\n      }\n    },\n  }\n}\n","/**\n * reads the width of the `<col>` element matching a cell's column from the table's `<colgroup>`\n *\n * @param element - The table cell/header DOM element\n * @returns - An array with the column width in pixels or null\n */\nfunction parseColgroupWidth(element: HTMLElement): number[] | null {\n  const row = element.parentElement\n  const table = element.closest('table')\n\n  if (!row || !table) {\n    return null\n  }\n\n  const cellIndex = Array.from(row.children).indexOf(element)\n  const width = table.querySelectorAll('colgroup > col')[cellIndex]?.getAttribute('width')\n\n  return width ? [parseInt(width, 10)] : null\n}\n\n/**\n * Parse the column width/s of a table cell/header from an HTML element.\n * it prefers the `colwidth` attribute and if not-provided falls back to the `width` attribute\n * of the matching `<col>` element in the table's `<colgroup>`.\n *\n * @param element - The table cell/header DOM element\n * @returns - An array of column widths in pixels or null\n */\nexport function parseColwidth(element: HTMLElement): number[] | null {\n  const colwidth = element.getAttribute('colwidth')\n\n  if (colwidth) {\n    return colwidth.split(',').map(width => parseInt(width, 10))\n  }\n\n  return parseColgroupWidth(element)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACEA,kBAAsC;;;ACe/B,SAAS,wBAAwB,OAAuC;AAC7E,MACE,UAAU,qBACV,UAAU,uBACV,UAAU,uBACV;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAWO,SAAS,WAAW,SAA6C;AACtE,QAAM,cAAc,QAAQ,MAAM,aAAa,IAAI,KAAK,EAAE,YAAY;AACtE,QAAM,aAAa,QAAQ,aAAa,OAAO,KAAK,IAAI,KAAK,EAAE,YAAY;AAC3E,QAAM,QAAQ,cAAc;AAE5B,SAAO,wBAAwB,KAAK;AACtC;AAmBO,SAAS,uBAAkC;AAChD,SAAO;AAAA,IACL,SAAS;AAAA,IACT,WAAW,CAAC,YAAyB,WAAW,OAAO;AAAA,IACvD,YAAY,CAAC,eAAkD;AAC7D,UAAI,CAAC,WAAW,OAAO;AACrB,eAAO,CAAC;AAAA,MACV;AAEA,aAAO;AAAA,QACL,OAAO,eAAe,WAAW,KAAK;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AACF;;;ACvEA,SAAS,mBAAmB,SAAuC;AANnE;AAOE,QAAM,MAAM,QAAQ;AACpB,QAAM,QAAQ,QAAQ,QAAQ,OAAO;AAErC,MAAI,CAAC,OAAO,CAAC,OAAO;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,MAAM,KAAK,IAAI,QAAQ,EAAE,QAAQ,OAAO;AAC1D,QAAM,SAAQ,WAAM,iBAAiB,gBAAgB,EAAE,SAAS,MAAlD,mBAAqD,aAAa;AAEhF,SAAO,QAAQ,CAAC,SAAS,OAAO,EAAE,CAAC,IAAI;AACzC;AAUO,SAAS,cAAc,SAAuC;AACnE,QAAM,WAAW,QAAQ,aAAa,UAAU;AAEhD,MAAI,UAAU;AACZ,WAAO,SAAS,MAAM,GAAG,EAAE,IAAI,WAAS,SAAS,OAAO,EAAE,CAAC;AAAA,EAC7D;AAEA,SAAO,mBAAmB,OAAO;AACnC;;;AFhBO,IAAM,cAAc,iBAAK,OAA2B;AAAA,EACzD,MAAM;AAAA,EAEN,aAAa;AACX,WAAO;AAAA,MACL,gBAAgB,CAAC;AAAA,IACnB;AAAA,EACF;AAAA,EAEA,SAAS;AAAA,EAET,gBAAgB;AACd,WAAO;AAAA,MACL,SAAS;AAAA,QACP,SAAS;AAAA,MACX;AAAA,MACA,SAAS;AAAA,QACP,SAAS;AAAA,MACX;AAAA,MACA,UAAU;AAAA,QACR,SAAS;AAAA,QACT,WAAW;AAAA,MACb;AAAA,MACA,OAAO,qBAAqB;AAAA,IAC9B;AAAA,EACF;AAAA,EAEA,WAAW;AAAA,EAEX,WAAW;AAAA,EAEX,YAAY;AACV,WAAO,CAAC,EAAE,KAAK,KAAK,CAAC;AAAA,EACvB;AAAA,EAEA,WAAW,EAAE,eAAe,GAAG;AAC7B,WAAO,CAAC,UAAM,6BAAgB,KAAK,QAAQ,gBAAgB,cAAc,GAAG,CAAC;AAAA,EAC/E;AACF,CAAC;","names":[]}
+{"version":3,"sources":["../../src/header/index.ts","../../src/header/table-header.ts","../../src/utils/parseAlign.ts","../../src/utils/parseColwidth.ts","../../src/utils/fillEmptyCellContent.ts"],"sourcesContent":["export * from './table-header.js'\n","import '../types.js'\n\nimport { mergeAttributes, Node } from '@tiptap/core'\n\nimport { createAlignAttribute } from '../utils/parseAlign.js'\nimport { parseColwidth } from '../utils/parseColwidth.js'\nimport { fillEmptyCellContent, isEmptyCellElement } from '../utils/fillEmptyCellContent.js'\n\nexport interface TableHeaderOptions {\n  /**\n   * The HTML attributes for a table header node.\n   * @default {}\n   * @example { class: 'foo' }\n   */\n  HTMLAttributes: Record<string, any>\n}\n\n/**\n * This extension allows you to create table headers.\n * @see https://www.tiptap.dev/api/nodes/table-header\n */\nexport const TableHeader = Node.create<TableHeaderOptions>({\n  name: 'tableHeader',\n\n  addOptions() {\n    return {\n      HTMLAttributes: {},\n    }\n  },\n\n  content: 'block+',\n\n  addAttributes() {\n    return {\n      colspan: {\n        default: 1,\n      },\n      rowspan: {\n        default: 1,\n      },\n      colwidth: {\n        default: null,\n        parseHTML: parseColwidth,\n      },\n      align: createAlignAttribute(),\n    }\n  },\n\n  tableRole: 'header_cell',\n\n  isolating: true,\n\n  parseHTML() {\n    return [\n      {\n        // Backfill empty cells; non-empty cells fall through to the rule below.\n        tag: 'th',\n        getAttrs: node => (isEmptyCellElement(node) ? {} : false),\n        getContent: (_node, schema) => fillEmptyCellContent(schema.nodes[this.name]),\n      },\n      { tag: 'th' },\n    ]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['th', mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0]\n  },\n})\n","import type { Attribute } from '@tiptap/core'\n\n/**\n * Supported table cell alignment values\n */\nexport enum TableCellAlign {\n  Left = 'left',\n  Right = 'right',\n  Center = 'center',\n}\n\n/**\n * Normalize unknown input into a supported table alignment\n *\n * @param value - A potential alignment value\n * @returns A valid TableCellAlign value or null\n */\nexport function normalizeTableCellAlign(value: unknown): TableCellAlign | null {\n  if (\n    value === TableCellAlign.Left ||\n    value === TableCellAlign.Right ||\n    value === TableCellAlign.Center\n  ) {\n    return value\n  }\n\n  return null\n}\n\n/**\n * Parse table cell alignment from an HTML element\n *\n * Prefers inline style (${\"`\"}text-align${\"`\"}) and falls back to the legacy\n * ${\"`\"}align${\"`\"} attribute.\n *\n * @param element - The table cell/header DOM element\n * @returns A valid TableCellAlign value or null\n */\nexport function parseAlign(element: HTMLElement): TableCellAlign | null {\n  const styleAlign = (element.style.textAlign || '').trim().toLowerCase()\n  const attrAlign = (element.getAttribute('align') || '').trim().toLowerCase()\n  const align = styleAlign || attrAlign\n\n  return normalizeTableCellAlign(align)\n}\n\n/**\n * Normalize alignment from a generic attrs object that may include an align field\n *\n * @param attributes - A node attrs-like object with an optional align field\n * @returns A valid TableCellAlign value or null.\n */\nexport function normalizeTableCellAlignFromAttributes(\n  attributes: { align?: TableCellAlign } | null | undefined,\n): TableCellAlign | null {\n  return normalizeTableCellAlign(attributes?.align)\n}\n\n/**\n * Create a reusable Tiptap attribute config for table alignment\n *\n * @returns A Tiptap Attribute definition that parses and renders table alignment\n */\nexport function createAlignAttribute(): Attribute {\n  return {\n    default: null,\n    parseHTML: (element: HTMLElement) => parseAlign(element),\n    renderHTML: (attributes: { align?: TableCellAlign | null }) => {\n      if (!attributes.align) {\n        return {}\n      }\n\n      return {\n        style: `text-align: ${attributes.align}`,\n      }\n    },\n  }\n}\n","/**\n * reads the width of the `<col>` element matching a cell's column from the table's `<colgroup>`\n *\n * @param element - The table cell/header DOM element\n * @returns - An array with the column width in pixels or null\n */\nfunction parseColgroupWidth(element: HTMLElement): number[] | null {\n  const row = element.parentElement\n  const table = element.closest('table')\n\n  if (!row || !table) {\n    return null\n  }\n\n  const cellIndex = Array.from(row.children).indexOf(element)\n  const width = table.querySelectorAll('colgroup > col')[cellIndex]?.getAttribute('width')\n\n  return width ? [parseInt(width, 10)] : null\n}\n\n/**\n * Parse the column width/s of a table cell/header from an HTML element.\n * it prefers the `colwidth` attribute and if not-provided falls back to the `width` attribute\n * of the matching `<col>` element in the table's `<colgroup>`.\n *\n * @param element - The table cell/header DOM element\n * @returns - An array of column widths in pixels or null\n */\nexport function parseColwidth(element: HTMLElement): number[] | null {\n  const colwidth = element.getAttribute('colwidth')\n\n  if (colwidth) {\n    return colwidth.split(',').map(width => parseInt(width, 10))\n  }\n\n  return parseColgroupWidth(element)\n}\n","import type { NodeType } from '@tiptap/pm/model'\nimport { Fragment } from '@tiptap/pm/model'\n\n// ASCII whitespace only, so a non-breaking-space cell is not treated as empty.\nconst COLLAPSIBLE_WHITESPACE = /[ \\t\\r\\n\\f]+/g\n\n/** Whether a cell/header element has no child elements and only collapsible whitespace. */\nexport function isEmptyCellElement(element: HTMLElement): boolean {\n  if (element.children.length > 0) {\n    return false\n  }\n\n  return (element.textContent ?? '').replace(COLLAPSIBLE_WHITESPACE, '') === ''\n}\n\n/** Builds a cell/header's minimal `block+` content, derived from the node type. */\nexport function fillEmptyCellContent(cellType: NodeType): Fragment {\n  const filled = cellType.createAndFill()\n\n  if (!filled) {\n    throw new Error(`[tiptap error]: \"${cellType.name}\" has no default content to backfill.`)\n  }\n\n  return filled.content\n}\n"],"mappings":"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","names":[]}

package/dist/header/index.js

@@ -49,6 +49,23 @@ function parseColwidth(element) {
   return parseColgroupWidth(element);
 }
 
+// src/utils/fillEmptyCellContent.ts
+var COLLAPSIBLE_WHITESPACE = /[ \t\r\n\f]+/g;
+function isEmptyCellElement(element) {
+  var _a;
+  if (element.children.length > 0) {
+    return false;
+  }
+  return ((_a = element.textContent) != null ? _a : "").replace(COLLAPSIBLE_WHITESPACE, "") === "";
+}
+function fillEmptyCellContent(cellType) {
+  const filled = cellType.createAndFill();
+  if (!filled) {
+    throw new Error(`[tiptap error]: "${cellType.name}" has no default content to backfill.`);
+  }
+  return filled.content;
+}
+
 // src/header/table-header.ts
 var TableHeader = Node.create({
   name: "tableHeader",
@@ -76,7 +93,15 @@ var TableHeader = Node.create({
   tableRole: "header_cell",
   isolating: true,
   parseHTML() {
-    return [{ tag: "th" }];
+    return [
+      {
+        // Backfill empty cells; non-empty cells fall through to the rule below.
+        tag: "th",
+        getAttrs: (node) => isEmptyCellElement(node) ? {} : false,
+        getContent: (_node, schema) => fillEmptyCellContent(schema.nodes[this.name])
+      },
+      { tag: "th" }
+    ];
   },
   renderHTML({ HTMLAttributes }) {
     return ["th", mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0];

package/dist/header/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/header/table-header.ts","../../src/utils/parseAlign.ts","../../src/utils/parseColwidth.ts"],"sourcesContent":["import '../types.js'\n\nimport { mergeAttributes, Node } from '@tiptap/core'\n\nimport { createAlignAttribute } from '../utils/parseAlign.js'\nimport { parseColwidth } from '../utils/parseColwidth.js'\n\nexport interface TableHeaderOptions {\n  /**\n   * The HTML attributes for a table header node.\n   * @default {}\n   * @example { class: 'foo' }\n   */\n  HTMLAttributes: Record<string, any>\n}\n\n/**\n * This extension allows you to create table headers.\n * @see https://www.tiptap.dev/api/nodes/table-header\n */\nexport const TableHeader = Node.create<TableHeaderOptions>({\n  name: 'tableHeader',\n\n  addOptions() {\n    return {\n      HTMLAttributes: {},\n    }\n  },\n\n  content: 'block+',\n\n  addAttributes() {\n    return {\n      colspan: {\n        default: 1,\n      },\n      rowspan: {\n        default: 1,\n      },\n      colwidth: {\n        default: null,\n        parseHTML: parseColwidth,\n      },\n      align: createAlignAttribute(),\n    }\n  },\n\n  tableRole: 'header_cell',\n\n  isolating: true,\n\n  parseHTML() {\n    return [{ tag: 'th' }]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['th', mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0]\n  },\n})\n","import type { Attribute } from '@tiptap/core'\n\n/**\n * Supported table cell alignment values\n */\nexport enum TableCellAlign {\n  Left = 'left',\n  Right = 'right',\n  Center = 'center',\n}\n\n/**\n * Normalize unknown input into a supported table alignment\n *\n * @param value - A potential alignment value\n * @returns A valid TableCellAlign value or null\n */\nexport function normalizeTableCellAlign(value: unknown): TableCellAlign | null {\n  if (\n    value === TableCellAlign.Left ||\n    value === TableCellAlign.Right ||\n    value === TableCellAlign.Center\n  ) {\n    return value\n  }\n\n  return null\n}\n\n/**\n * Parse table cell alignment from an HTML element\n *\n * Prefers inline style (${\"`\"}text-align${\"`\"}) and falls back to the legacy\n * ${\"`\"}align${\"`\"} attribute.\n *\n * @param element - The table cell/header DOM element\n * @returns A valid TableCellAlign value or null\n */\nexport function parseAlign(element: HTMLElement): TableCellAlign | null {\n  const styleAlign = (element.style.textAlign || '').trim().toLowerCase()\n  const attrAlign = (element.getAttribute('align') || '').trim().toLowerCase()\n  const align = styleAlign || attrAlign\n\n  return normalizeTableCellAlign(align)\n}\n\n/**\n * Normalize alignment from a generic attrs object that may include an align field\n *\n * @param attributes - A node attrs-like object with an optional align field\n * @returns A valid TableCellAlign value or null.\n */\nexport function normalizeTableCellAlignFromAttributes(\n  attributes: { align?: TableCellAlign } | null | undefined,\n): TableCellAlign | null {\n  return normalizeTableCellAlign(attributes?.align)\n}\n\n/**\n * Create a reusable Tiptap attribute config for table alignment\n *\n * @returns A Tiptap Attribute definition that parses and renders table alignment\n */\nexport function createAlignAttribute(): Attribute {\n  return {\n    default: null,\n    parseHTML: (element: HTMLElement) => parseAlign(element),\n    renderHTML: (attributes: { align?: TableCellAlign | null }) => {\n      if (!attributes.align) {\n        return {}\n      }\n\n      return {\n        style: `text-align: ${attributes.align}`,\n      }\n    },\n  }\n}\n","/**\n * reads the width of the `<col>` element matching a cell's column from the table's `<colgroup>`\n *\n * @param element - The table cell/header DOM element\n * @returns - An array with the column width in pixels or null\n */\nfunction parseColgroupWidth(element: HTMLElement): number[] | null {\n  const row = element.parentElement\n  const table = element.closest('table')\n\n  if (!row || !table) {\n    return null\n  }\n\n  const cellIndex = Array.from(row.children).indexOf(element)\n  const width = table.querySelectorAll('colgroup > col')[cellIndex]?.getAttribute('width')\n\n  return width ? [parseInt(width, 10)] : null\n}\n\n/**\n * Parse the column width/s of a table cell/header from an HTML element.\n * it prefers the `colwidth` attribute and if not-provided falls back to the `width` attribute\n * of the matching `<col>` element in the table's `<colgroup>`.\n *\n * @param element - The table cell/header DOM element\n * @returns - An array of column widths in pixels or null\n */\nexport function parseColwidth(element: HTMLElement): number[] | null {\n  const colwidth = element.getAttribute('colwidth')\n\n  if (colwidth) {\n    return colwidth.split(',').map(width => parseInt(width, 10))\n  }\n\n  return parseColgroupWidth(element)\n}\n"],"mappings":";AAEA,SAAS,iBAAiB,YAAY;;;ACe/B,SAAS,wBAAwB,OAAuC;AAC7E,MACE,UAAU,qBACV,UAAU,uBACV,UAAU,uBACV;AACA,WAAO;AAAA,EACT;AAEA,SAAO;AACT;AAWO,SAAS,WAAW,SAA6C;AACtE,QAAM,cAAc,QAAQ,MAAM,aAAa,IAAI,KAAK,EAAE,YAAY;AACtE,QAAM,aAAa,QAAQ,aAAa,OAAO,KAAK,IAAI,KAAK,EAAE,YAAY;AAC3E,QAAM,QAAQ,cAAc;AAE5B,SAAO,wBAAwB,KAAK;AACtC;AAmBO,SAAS,uBAAkC;AAChD,SAAO;AAAA,IACL,SAAS;AAAA,IACT,WAAW,CAAC,YAAyB,WAAW,OAAO;AAAA,IACvD,YAAY,CAAC,eAAkD;AAC7D,UAAI,CAAC,WAAW,OAAO;AACrB,eAAO,CAAC;AAAA,MACV;AAEA,aAAO;AAAA,QACL,OAAO,eAAe,WAAW,KAAK;AAAA,MACxC;AAAA,IACF;AAAA,EACF;AACF;;;ACvEA,SAAS,mBAAmB,SAAuC;AANnE;AAOE,QAAM,MAAM,QAAQ;AACpB,QAAM,QAAQ,QAAQ,QAAQ,OAAO;AAErC,MAAI,CAAC,OAAO,CAAC,OAAO;AAClB,WAAO;AAAA,EACT;AAEA,QAAM,YAAY,MAAM,KAAK,IAAI,QAAQ,EAAE,QAAQ,OAAO;AAC1D,QAAM,SAAQ,WAAM,iBAAiB,gBAAgB,EAAE,SAAS,MAAlD,mBAAqD,aAAa;AAEhF,SAAO,QAAQ,CAAC,SAAS,OAAO,EAAE,CAAC,IAAI;AACzC;AAUO,SAAS,cAAc,SAAuC;AACnE,QAAM,WAAW,QAAQ,aAAa,UAAU;AAEhD,MAAI,UAAU;AACZ,WAAO,SAAS,MAAM,GAAG,EAAE,IAAI,WAAS,SAAS,OAAO,EAAE,CAAC;AAAA,EAC7D;AAEA,SAAO,mBAAmB,OAAO;AACnC;;;AFhBO,IAAM,cAAc,KAAK,OAA2B;AAAA,EACzD,MAAM;AAAA,EAEN,aAAa;AACX,WAAO;AAAA,MACL,gBAAgB,CAAC;AAAA,IACnB;AAAA,EACF;AAAA,EAEA,SAAS;AAAA,EAET,gBAAgB;AACd,WAAO;AAAA,MACL,SAAS;AAAA,QACP,SAAS;AAAA,MACX;AAAA,MACA,SAAS;AAAA,QACP,SAAS;AAAA,MACX;AAAA,MACA,UAAU;AAAA,QACR,SAAS;AAAA,QACT,WAAW;AAAA,MACb;AAAA,MACA,OAAO,qBAAqB;AAAA,IAC9B;AAAA,EACF;AAAA,EAEA,WAAW;AAAA,EAEX,WAAW;AAAA,EAEX,YAAY;AACV,WAAO,CAAC,EAAE,KAAK,KAAK,CAAC;AAAA,EACvB;AAAA,EAEA,WAAW,EAAE,eAAe,GAAG;AAC7B,WAAO,CAAC,MAAM,gBAAgB,KAAK,QAAQ,gBAAgB,cAAc,GAAG,CAAC;AAAA,EAC/E;AACF,CAAC;","names":[]}
+{"version":3,"sources":["../../src/header/table-header.ts","../../src/utils/parseAlign.ts","../../src/utils/parseColwidth.ts","../../src/utils/fillEmptyCellContent.ts"],"sourcesContent":["import '../types.js'\n\nimport { mergeAttributes, Node } from '@tiptap/core'\n\nimport { createAlignAttribute } from '../utils/parseAlign.js'\nimport { parseColwidth } from '../utils/parseColwidth.js'\nimport { fillEmptyCellContent, isEmptyCellElement } from '../utils/fillEmptyCellContent.js'\n\nexport interface TableHeaderOptions {\n  /**\n   * The HTML attributes for a table header node.\n   * @default {}\n   * @example { class: 'foo' }\n   */\n  HTMLAttributes: Record<string, any>\n}\n\n/**\n * This extension allows you to create table headers.\n * @see https://www.tiptap.dev/api/nodes/table-header\n */\nexport const TableHeader = Node.create<TableHeaderOptions>({\n  name: 'tableHeader',\n\n  addOptions() {\n    return {\n      HTMLAttributes: {},\n    }\n  },\n\n  content: 'block+',\n\n  addAttributes() {\n    return {\n      colspan: {\n        default: 1,\n      },\n      rowspan: {\n        default: 1,\n      },\n      colwidth: {\n        default: null,\n        parseHTML: parseColwidth,\n      },\n      align: createAlignAttribute(),\n    }\n  },\n\n  tableRole: 'header_cell',\n\n  isolating: true,\n\n  parseHTML() {\n    return [\n      {\n        // Backfill empty cells; non-empty cells fall through to the rule below.\n        tag: 'th',\n        getAttrs: node => (isEmptyCellElement(node) ? {} : false),\n        getContent: (_node, schema) => fillEmptyCellContent(schema.nodes[this.name]),\n      },\n      { tag: 'th' },\n    ]\n  },\n\n  renderHTML({ HTMLAttributes }) {\n    return ['th', mergeAttributes(this.options.HTMLAttributes, HTMLAttributes), 0]\n  },\n})\n","import type { Attribute } from '@tiptap/core'\n\n/**\n * Supported table cell alignment values\n */\nexport enum TableCellAlign {\n  Left = 'left',\n  Right = 'right',\n  Center = 'center',\n}\n\n/**\n * Normalize unknown input into a supported table alignment\n *\n * @param value - A potential alignment value\n * @returns A valid TableCellAlign value or null\n */\nexport function normalizeTableCellAlign(value: unknown): TableCellAlign | null {\n  if (\n    value === TableCellAlign.Left ||\n    value === TableCellAlign.Right ||\n    value === TableCellAlign.Center\n  ) {\n    return value\n  }\n\n  return null\n}\n\n/**\n * Parse table cell alignment from an HTML element\n *\n * Prefers inline style (${\"`\"}text-align${\"`\"}) and falls back to the legacy\n * ${\"`\"}align${\"`\"} attribute.\n *\n * @param element - The table cell/header DOM element\n * @returns A valid TableCellAlign value or null\n */\nexport function parseAlign(element: HTMLElement): TableCellAlign | null {\n  const styleAlign = (element.style.textAlign || '').trim().toLowerCase()\n  const attrAlign = (element.getAttribute('align') || '').trim().toLowerCase()\n  const align = styleAlign || attrAlign\n\n  return normalizeTableCellAlign(align)\n}\n\n/**\n * Normalize alignment from a generic attrs object that may include an align field\n *\n * @param attributes - A node attrs-like object with an optional align field\n * @returns A valid TableCellAlign value or null.\n */\nexport function normalizeTableCellAlignFromAttributes(\n  attributes: { align?: TableCellAlign } | null | undefined,\n): TableCellAlign | null {\n  return normalizeTableCellAlign(attributes?.align)\n}\n\n/**\n * Create a reusable Tiptap attribute config for table alignment\n *\n * @returns A Tiptap Attribute definition that parses and renders table alignment\n */\nexport function createAlignAttribute(): Attribute {\n  return {\n    default: null,\n    parseHTML: (element: HTMLElement) => parseAlign(element),\n    renderHTML: (attributes: { align?: TableCellAlign | null }) => {\n      if (!attributes.align) {\n        return {}\n      }\n\n      return {\n        style: `text-align: ${attributes.align}`,\n      }\n    },\n  }\n}\n","/**\n * reads the width of the `<col>` element matching a cell's column from the table's `<colgroup>`\n *\n * @param element - The table cell/header DOM element\n * @returns - An array with the column width in pixels or null\n */\nfunction parseColgroupWidth(element: HTMLElement): number[] | null {\n  const row = element.parentElement\n  const table = element.closest('table')\n\n  if (!row || !table) {\n    return null\n  }\n\n  const cellIndex = Array.from(row.children).indexOf(element)\n  const width = table.querySelectorAll('colgroup > col')[cellIndex]?.getAttribute('width')\n\n  return width ? [parseInt(width, 10)] : null\n}\n\n/**\n * Parse the column width/s of a table cell/header from an HTML element.\n * it prefers the `colwidth` attribute and if not-provided falls back to the `width` attribute\n * of the matching `<col>` element in the table's `<colgroup>`.\n *\n * @param element - The table cell/header DOM element\n * @returns - An array of column widths in pixels or null\n */\nexport function parseColwidth(element: HTMLElement): number[] | null {\n  const colwidth = element.getAttribute('colwidth')\n\n  if (colwidth) {\n    return colwidth.split(',').map(width => parseInt(width, 10))\n  }\n\n  return parseColgroupWidth(element)\n}\n","import type { NodeType } from '@tiptap/pm/model'\nimport { Fragment } from '@tiptap/pm/model'\n\n// ASCII whitespace only, so a non-breaking-space cell is not treated as empty.\nconst COLLAPSIBLE_WHITESPACE = /[ \\t\\r\\n\\f]+/g\n\n/** Whether a cell/header element has no child elements and only collapsible whitespace. */\nexport function isEmptyCellElement(element: HTMLElement): boolean {\n  if (element.children.length > 0) {\n    return false\n  }\n\n  return (element.textContent ?? '').replace(COLLAPSIBLE_WHITESPACE, '') === ''\n}\n\n/** Builds a cell/header's minimal `block+` content, derived from the node type. */\nexport function fillEmptyCellContent(cellType: NodeType): Fragment {\n  const filled = cellType.createAndFill()\n\n  if (!filled) {\n    throw new Error(`[tiptap error]: \"${cellType.name}\" has no default content to backfill.`)\n  }\n\n  return filled.content\n}\n"],"mappings":"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","names":[]}

package/dist/index.cjs

@@ -90,6 +90,23 @@ function parseColwidth(element) {
   return parseColgroupWidth(element);
 }
 
+// src/utils/fillEmptyCellContent.ts
+var COLLAPSIBLE_WHITESPACE = /[ \t\r\n\f]+/g;
+function isEmptyCellElement(element) {
+  var _a;
+  if (element.children.length > 0) {
+    return false;
+  }
+  return ((_a = element.textContent) != null ? _a : "").replace(COLLAPSIBLE_WHITESPACE, "") === "";
+}
+function fillEmptyCellContent(cellType) {
+  const filled = cellType.createAndFill();
+  if (!filled) {
+    throw new Error(`[tiptap error]: "${cellType.name}" has no default content to backfill.`);
+  }
+  return filled.content;
+}
+
 // src/cell/table-cell.ts
 var TableCell = import_core.Node.create({
   name: "tableCell",
@@ -117,7 +134,15 @@ var TableCell = import_core.Node.create({
   tableRole: "cell",
   isolating: true,
   parseHTML() {
-    return [{ tag: "td" }];
+    return [
+      {
+        // Backfill empty cells; non-empty cells fall through to the rule below.
+        tag: "td",
+        getAttrs: (node) => isEmptyCellElement(node) ? {} : false,
+        getContent: (_node, schema) => fillEmptyCellContent(schema.nodes[this.name])
+      },
+      { tag: "td" }
+    ];
   },
   renderHTML({ HTMLAttributes }) {
     return ["td", (0, import_core.mergeAttributes)(this.options.HTMLAttributes, HTMLAttributes), 0];
@@ -152,7 +177,15 @@ var TableHeader = import_core2.Node.create({
   tableRole: "header_cell",
   isolating: true,
   parseHTML() {
-    return [{ tag: "th" }];
+    return [
+      {
+        // Backfill empty cells; non-empty cells fall through to the rule below.
+        tag: "th",
+        getAttrs: (node) => isEmptyCellElement(node) ? {} : false,
+        getContent: (_node, schema) => fillEmptyCellContent(schema.nodes[this.name])
+      },
+      { tag: "th" }
+    ];
   },
   renderHTML({ HTMLAttributes }) {
     return ["th", (0, import_core2.mergeAttributes)(this.options.HTMLAttributes, HTMLAttributes), 0];
@@ -465,7 +498,9 @@ function renderTableToMarkdown(node, h, options = {}) {
         } else {
           raw = cellNode.content ? h.renderChildren(cellNode.content) : "";
         }
-        const text = collapseWhitespace(raw);
+        const text = collapseWhitespace(
+          raw.split(cellSep).join("\n").replace(/[ \t]*\r?\n[ \t]*/g, "<br>")
+        );
         const isHeader = cellNode.type === "tableHeader";
         const align = normalizeTableCellAlignFromAttributes(cellNode.attrs);
         cells.push({ text, isHeader, align });