@usejunior/docx-core 0.20.1 → 0.21.3

package/dist/primitives/table_columns.d.ts

@@ -0,0 +1,50 @@
+import { type BookmarkReservation } from './bookmarks.js';
+import { type TableEditDetail } from './table_edit_common.js';
+import type { RevisionContext } from './track-changes-emitter.js';
+export type ColumnInsertRowAction = {
+    kind: 'cell';
+    text: string;
+} | {
+    kind: 'growCell';
+    side: 'left' | 'right';
+};
+export type InsertTableColumnParams = {
+    anchorParagraphId: string;
+    columnIndex: number;
+    widthTwips: number;
+    rowActions: ColumnInsertRowAction[];
+};
+export type DeleteTableColumnParams = {
+    anchorParagraphId: string;
+    columnIndex: number;
+};
+export type InsertTableColumnResult = {
+    gridColumns: number;
+    cellParagraphIds: string[];
+};
+export type DeleteTableColumnResult = {
+    gridColumns: number;
+    deleted: true;
+};
+export type TableColumnEditDetail = TableEditDetail;
+/**
+ * Insert a clean logical table-grid column, leaving source XML untouched on failure.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.48
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.16
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.17
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.71
+ * @see #1041
+ */
+export declare function insertTableColumn(doc: Document, params: InsertTableColumnParams, ctx?: RevisionContext, reservation?: BookmarkReservation): InsertTableColumnResult;
+/**
+ * Delete a clean logical table-grid column, removing width-one physical cells.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.48
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.16
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.17
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.71
+ * @see #1041
+ */
+export declare function deleteTableColumn(doc: Document, params: DeleteTableColumnParams, ctx?: RevisionContext): DeleteTableColumnResult;
+//# sourceMappingURL=table_columns.d.ts.map

package/dist/primitives/table_columns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table_columns.d.ts","sourceRoot":"","sources":["../../src/primitives/table_columns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAiC,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAGzF,OAAO,EAWL,KAAK,eAAe,EAErB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAElE,MAAM,MAAM,qBAAqB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAClH,MAAM,MAAM,uBAAuB,GAAG;IACpC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,qBAAqB,EAAE,CAAC;CACrC,CAAC;AACF,MAAM,MAAM,uBAAuB,GAAG;IAAE,iBAAiB,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAA;CAAE,CAAC;AACzF,MAAM,MAAM,uBAAuB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AAC1F,MAAM,MAAM,uBAAuB,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAC7E,MAAM,MAAM,qBAAqB,GAAG,eAAe,CAAC;AAEpD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,GAAG,CAAC,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,mBAAmB,GAAG,uBAAuB,CAuDnK;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,uBAAuB,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,uBAAuB,CAgDhI"}

package/dist/primitives/table_columns.js

@@ -0,0 +1,138 @@
+import { insertSingleParagraphBookmark } from './bookmarks.js';
+import { createWmlElement } from './dom-helpers.js';
+import { inventoryTableOccupancy } from './table_occupancy.js';
+import { applyWidthUpdates, createTableCell, failTableEdit as fail, hasPendingRevision, plannedCellWidthChange, plannedTableWidthChange, setCellSpan, setTableAttr as setAttr, tableAttr as attr, tableEditTarget as target, } from './table_edit_common.js';
+import { removeOrphanedRangeEndpointsForSubtree } from './table_rows.js';
+/**
+ * Insert a clean logical table-grid column, leaving source XML untouched on failure.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.48
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.16
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.17
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.71
+ * @see #1041
+ */
+export function insertTableColumn(doc, params, ctx, reservation) {
+    const { anchorParagraphId: anchorId, columnIndex, widthTwips: width, rowActions } = params;
+    const initial = { anchorId, tableIndex: -1, rowIndex: -1, columnIndex, feature: 'argument' };
+    if (ctx)
+        fail('UNSUPPORTED_EDIT', 'Tracked column edits are not supported', { ...initial, feature: 'revisionContext' });
+    const shape = target(doc, anchorId, columnIndex);
+    if (!Number.isSafeInteger(columnIndex) || columnIndex < 0 || columnIndex > shape.columns.length) {
+        fail('INVALID_ARGUMENT', 'Column boundary is outside the table grid', initial);
+    }
+    if (!Number.isSafeInteger(width) || width <= 0)
+        fail('INVALID_ARGUMENT', 'widthTwips must be a positive integer', { ...initial, feature: 'width' });
+    if (!Array.isArray(rowActions) || rowActions.length !== shape.rows.length) {
+        fail('INVALID_ARGUMENT', 'One row action is required per physical row', { ...initial, feature: 'rowActions' });
+    }
+    const plans = [];
+    for (const row of shape.rows) {
+        const action = rowActions[row.rowIndex];
+        const info = { ...initial, tableIndex: shape.tableIndex, rowIndex: row.rowIndex, feature: 'rowAction' };
+        if (!action || !['cell', 'growCell'].includes(action.kind))
+            fail('INVALID_ARGUMENT', 'Unsupported row action', info);
+        if (action.kind === 'growCell') {
+            if (!['left', 'right'].includes(action.side))
+                fail('INVALID_ARGUMENT', 'Invalid growCell side', info);
+            const owner = action.side === 'left'
+                ? row.cells.find((cell) => cell.start < columnIndex && cell.end >= columnIndex)
+                : row.cells.find((cell) => cell.start <= columnIndex && cell.end > columnIndex);
+            if (!owner)
+                fail('INVALID_ARGUMENT', 'No cell on requested side of column boundary', info);
+            const widthUpdate = plannedCellWidthChange(owner.element, width, { ...info, cellIndex: owner.cellIndex });
+            plans.push({ kind: 'growCell', owner, widthUpdate });
+        }
+        else {
+            if (typeof action.text !== 'string')
+                fail('INVALID_ARGUMENT', 'Cell text must be a string', info);
+            const next = row.cells.find((cell) => cell.start === columnIndex);
+            if (!next && columnIndex !== shape.columns.length)
+                fail('INVALID_ARGUMENT', 'Cannot insert a cell inside a horizontal span', info);
+            const source = next?.element ?? row.cells.at(-1).element;
+            plans.push({ kind: 'cell', row, next, source, text: action.text });
+        }
+    }
+    const tableWidthUpdate = plannedTableWidthChange(shape.table, width, { ...initial, tableIndex: shape.tableIndex });
+    const newParagraphs = [];
+    for (const plan of plans) {
+        if (plan.kind === 'growCell') {
+            applyWidthUpdates([plan.widthUpdate]);
+            setCellSpan(plan.owner, plan.owner.end - plan.owner.start + 1);
+        }
+        else {
+            const created = createTableCell(doc, plan.source, plan.text, width);
+            plan.row.element.insertBefore(created.cell, plan.next?.element ?? null);
+            newParagraphs.push(created.paragraph);
+        }
+    }
+    applyWidthUpdates([tableWidthUpdate]);
+    const gridCol = createWmlElement(doc, 'gridCol');
+    setAttr(gridCol, 'w', width);
+    shape.grid.insertBefore(gridCol, shape.columns[columnIndex] ?? null);
+    inventoryTableOccupancy(shape.table);
+    const cellParagraphIds = newParagraphs.map((paragraph) => insertSingleParagraphBookmark(doc, paragraph, reservation));
+    return { gridColumns: shape.columns.length + 1, cellParagraphIds };
+}
+/**
+ * Delete a clean logical table-grid column, removing width-one physical cells.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.48
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.16
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.17
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.71
+ * @see #1041
+ */
+export function deleteTableColumn(doc, params, ctx) {
+    const { anchorParagraphId: anchorId, columnIndex } = params;
+    const initial = { anchorId, tableIndex: -1, rowIndex: -1, columnIndex, feature: 'argument' };
+    if (ctx)
+        fail('UNSUPPORTED_EDIT', 'Tracked column edits are not supported', { ...initial, feature: 'revisionContext' });
+    const shape = target(doc, anchorId, columnIndex);
+    if (!Number.isSafeInteger(columnIndex) || columnIndex < 0 || columnIndex >= shape.columns.length) {
+        fail('INVALID_ARGUMENT', 'Column is outside the table grid', initial);
+    }
+    if (shape.columns.length === 1)
+        fail('INVALID_ARGUMENT', 'Cannot remove the final table column', { ...initial, feature: 'lastColumn' });
+    const rawWidth = attr(shape.columns[columnIndex], 'w');
+    if (rawWidth === null || !/^\d+$/.test(rawWidth) || !Number.isSafeInteger(Number(rawWidth))) {
+        fail('UNSUPPORTED_EDIT', 'Deleted grid column needs an integer twip width', { ...initial, feature: 'width' });
+    }
+    const width = Number(rawWidth);
+    const plans = [];
+    for (const row of shape.rows) {
+        const owner = row.slots[columnIndex];
+        if (!owner)
+            fail('UNSUPPORTED_EDIT', 'Missing physical cell at column', { ...initial, rowIndex: row.rowIndex, feature: 'occupancy' });
+        const info = { ...initial, tableIndex: shape.tableIndex, rowIndex: row.rowIndex, cellIndex: owner.cellIndex };
+        const span = owner.end - owner.start;
+        if (span === 1) {
+            if (row.cells.length === 1)
+                fail('INVALID_ARGUMENT', 'Deleting this column would leave a row empty', { ...info, feature: 'lastCell' });
+            if (hasPendingRevision(owner.element)) {
+                fail('UNSUPPORTED_EDIT', 'Cannot discard pending revisions inside a removed cell', { ...info, feature: 'contentRevision' });
+            }
+            plans.push({ kind: 'remove', row, owner });
+        }
+        else {
+            const widthUpdate = plannedCellWidthChange(owner.element, -width, { ...info, feature: 'width' });
+            plans.push({ kind: 'shrink', owner, nextSpan: span - 1, widthUpdate });
+        }
+    }
+    const tableWidthUpdate = plannedTableWidthChange(shape.table, -width, { ...initial, tableIndex: shape.tableIndex });
+    for (const plan of plans) {
+        if (plan.kind === 'remove') {
+            removeOrphanedRangeEndpointsForSubtree(doc.documentElement, plan.owner.element);
+            plan.row.element.removeChild(plan.owner.element);
+        }
+        else {
+            applyWidthUpdates([plan.widthUpdate]);
+            setCellSpan(plan.owner, plan.nextSpan);
+        }
+    }
+    applyWidthUpdates([tableWidthUpdate]);
+    shape.grid.removeChild(shape.columns[columnIndex]);
+    inventoryTableOccupancy(shape.table);
+    return { gridColumns: shape.columns.length - 1, deleted: true };
+}
+//# sourceMappingURL=table_columns.js.map

package/dist/primitives/table_columns.js.map

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

package/dist/primitives/table_edit_common.d.ts

@@ -0,0 +1,39 @@
+import { type OccupiedCell, type OccupiedRow } from './table_occupancy.js';
+export type TableEditDetail = {
+    anchorId: string;
+    tableIndex: number;
+    rowIndex: number;
+    columnIndex: number;
+    cellIndex?: number;
+    feature: string;
+};
+export declare function failTableEdit(code: 'INVALID_ARGUMENT' | 'UNSUPPORTED_EDIT', message: string, detail: TableEditDetail): never;
+export declare function tableAncestor(node: Node | null, name: string): Element | null;
+export declare function tableAttr(element: Element, name: string): string | null;
+export declare function setTableAttr(element: Element, name: string, value: number | string): void;
+export type TableEditTarget = {
+    table: Element;
+    tableIndex: number;
+    rows: OccupiedRow[];
+    grid: Element;
+    columns: Element[];
+    anchorCell: OccupiedCell;
+    anchorRow: OccupiedRow;
+};
+/** Resolve a body-level table and reject geometry unsupported by the clean edit phase. */
+export declare function tableEditTarget(doc: Document, anchorId: string, columnIndex: number, operation?: string): TableEditTarget;
+export type WidthUpdate = {
+    element: Element;
+    next: number;
+};
+export declare function plannedWidthChange(element: Element | undefined, delta: number, detail: TableEditDetail): WidthUpdate | null;
+export declare function plannedCellWidthChange(cell: Element, delta: number, detail: TableEditDetail): WidthUpdate | null;
+export declare function plannedTableWidthChange(table: Element, delta: number, detail: TableEditDetail): WidthUpdate | null;
+export declare function applyWidthUpdates(updates: Array<WidthUpdate | null>): void;
+export declare function setCellSpan(cell: Pick<OccupiedCell, 'element'>, next: number): void;
+export declare function createTableCell(doc: Document, source: Element, text: string, width: number): {
+    cell: Element;
+    paragraph: Element;
+};
+export declare function hasPendingRevision(element: Element): boolean;
+//# sourceMappingURL=table_edit_common.d.ts.map

package/dist/primitives/table_edit_common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table_edit_common.d.ts","sourceRoot":"","sources":["../../src/primitives/table_edit_common.ts"],"names":[],"mappings":"AAKA,OAAO,EAAgD,KAAK,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEzH,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,CAAC;IAC5E,SAAS,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;CACrC,CAAC;AAEF,wBAAgB,aAAa,CAAC,IAAI,EAAE,kBAAkB,GAAG,kBAAkB,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,KAAK,CAE5H;AAED,wBAAgB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAK7E;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEvE;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEzF;AAED,MAAM,MAAM,eAAe,GAAG;IAC5B,KAAK,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAC;IAAC,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,OAAO,EAAE,CAAC;IAC3F,UAAU,EAAE,YAAY,CAAC;IAAC,SAAS,EAAE,WAAW,CAAC;CAClD,CAAC;AAEF,0FAA0F;AAC1F,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,SAAW,GAAG,eAAe,CA4C3H;AAED,MAAM,MAAM,WAAW,GAAG;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAE7D,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI,CAc3H;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI,CAGhH;AAED,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,WAAW,GAAG,IAAI,CAGlH;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,WAAW,GAAG,IAAI,CAAC,GAAG,IAAI,CAE1E;AAmBD,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAKnF;AAOD,wBAAgB,eAAe,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAuBlI;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAG5D"}

package/dist/primitives/table_edit_common.js

@@ -0,0 +1,163 @@
+import { findParagraphByBookmarkId } from './bookmarks.js';
+import { childElements, createWmlElement, getDirectChildrenByName, isW } from './dom-helpers.js';
+import { SafeDocxError } from './errors.js';
+import { OOXML } from './namespaces.js';
+import { REVISION_ID_ELEMENT_NAME_SET } from './revision-vocabulary.js';
+import { inventoryTableOccupancy, TableOccupancyError } from './table_occupancy.js';
+export function failTableEdit(code, message, detail) {
+    throw new SafeDocxError(code, message, undefined, detail);
+}
+export function tableAncestor(node, name) {
+    for (let parent = node?.parentNode; parent; parent = parent.parentNode) {
+        if (parent.nodeType === 1 && isW(parent, name))
+            return parent;
+    }
+    return null;
+}
+export function tableAttr(element, name) {
+    return element.getAttributeNS(OOXML.W_NS, name) ?? element.getAttribute(`w:${name}`);
+}
+export function setTableAttr(element, name, value) {
+    element.setAttributeNS(OOXML.W_NS, `w:${name}`, String(value));
+}
+/** Resolve a body-level table and reject geometry unsupported by the clean edit phase. */
+export function tableEditTarget(doc, anchorId, columnIndex, operation = 'column') {
+    const base = { anchorId, tableIndex: -1, rowIndex: -1, columnIndex, feature: 'anchor' };
+    const paragraph = findParagraphByBookmarkId(doc, anchorId);
+    if (!paragraph)
+        failTableEdit('INVALID_ARGUMENT', `Paragraph anchor not found: ${anchorId}`, base);
+    const cell = tableAncestor(paragraph, 'tc');
+    const row = tableAncestor(paragraph, 'tr');
+    const table = tableAncestor(paragraph, 'tbl');
+    const body = tableAncestor(table, 'body');
+    if (!cell || !row || !table || !body || row.parentNode !== table || table.parentNode !== body) {
+        failTableEdit('UNSUPPORTED_EDIT', `${operation === 'column' ? 'Column' : 'Cell'} anchor must be in a direct row of a body-level table`, base);
+    }
+    const tableIndex = childElements(body).filter((part) => isW(part, 'tbl')).indexOf(table);
+    const detail = { ...base, tableIndex };
+    if (table.getElementsByTagNameNS(OOXML.W_NS, 'tbl').length > 0) {
+        failTableEdit('UNSUPPORTED_EDIT', `Nested tables are unsupported for ${operation} edits`, { ...detail, feature: 'nestedTable' });
+    }
+    let occupancy;
+    try {
+        occupancy = inventoryTableOccupancy(table);
+    }
+    catch (error) {
+        if (error instanceof TableOccupancyError) {
+            failTableEdit('UNSUPPORTED_EDIT', error.message, { ...detail, rowIndex: error.rowIndex, cellIndex: error.cellIndex, feature: error.feature });
+        }
+        throw error;
+    }
+    const { rows } = occupancy;
+    for (const occupiedRow of rows) {
+        if (occupiedRow.before || occupiedRow.after) {
+            failTableEdit('UNSUPPORTED_EDIT', `Offset rows are unsupported for ${operation} edits`, { ...detail, rowIndex: occupiedRow.rowIndex, feature: 'gridBefore/gridAfter' });
+        }
+        for (const occupiedCell of occupiedRow.cells) {
+            if (occupiedCell.merge !== 'none') {
+                failTableEdit('UNSUPPORTED_EDIT', `Vertical merges are unsupported for ${operation} edits`, { ...detail, rowIndex: occupiedRow.rowIndex, cellIndex: occupiedCell.cellIndex, feature: 'vMerge' });
+            }
+            const cellContent = childElements(occupiedCell.element).filter((element) => isW(element, 'p') || isW(element, 'tbl'));
+            if (!cellContent.length || !isW(cellContent.at(-1), 'p')) {
+                failTableEdit('UNSUPPORTED_EDIT', 'Every surviving cell must end in a direct paragraph', { ...detail, rowIndex: occupiedRow.rowIndex, cellIndex: occupiedCell.cellIndex, feature: 'trailingParagraph' });
+            }
+        }
+    }
+    const anchorRow = rows.find((candidate) => candidate.element === row);
+    const anchorCell = anchorRow?.cells.find((candidate) => candidate.element === cell);
+    if (!anchorRow || !anchorCell)
+        failTableEdit('UNSUPPORTED_EDIT', 'Anchor cell is not in the table occupancy inventory', { ...detail, feature: 'occupancy' });
+    const grid = getDirectChildrenByName(table, 'tblGrid')[0];
+    return { table, tableIndex, rows, grid, columns: getDirectChildrenByName(grid, 'gridCol'), anchorRow, anchorCell };
+}
+export function plannedWidthChange(element, delta, detail) {
+    if (!element)
+        return null;
+    const type = tableAttr(element, 'type');
+    const raw = tableAttr(element, 'w');
+    if (!type || !['dxa', 'pct', 'auto', 'nil'].includes(type)) {
+        failTableEdit('UNSUPPORTED_EDIT', 'Unresolvable width', { ...detail, feature: 'width' });
+    }
+    if (type !== 'dxa')
+        return null;
+    if (raw === null || !/^\d+$/.test(raw))
+        failTableEdit('UNSUPPORTED_EDIT', 'Non-integer dxa width', { ...detail, feature: 'width' });
+    const next = Number(raw) + delta;
+    if (!Number.isSafeInteger(next) || next < 0) {
+        failTableEdit('UNSUPPORTED_EDIT', 'Width arithmetic exceeds supported range', { ...detail, feature: 'width' });
+    }
+    return { element, next };
+}
+export function plannedCellWidthChange(cell, delta, detail) {
+    const tcPr = getDirectChildrenByName(cell, 'tcPr')[0];
+    return plannedWidthChange(tcPr ? getDirectChildrenByName(tcPr, 'tcW')[0] : undefined, delta, detail);
+}
+export function plannedTableWidthChange(table, delta, detail) {
+    const tblPr = getDirectChildrenByName(table, 'tblPr')[0];
+    return plannedWidthChange(tblPr ? getDirectChildrenByName(tblPr, 'tblW')[0] : undefined, delta, detail);
+}
+export function applyWidthUpdates(updates) {
+    for (const update of updates)
+        if (update)
+            setTableAttr(update.element, 'w', update.next);
+}
+function spanElement(cell) {
+    let tcPr = getDirectChildrenByName(cell, 'tcPr')[0];
+    if (!tcPr) {
+        tcPr = createWmlElement(cell.ownerDocument, 'tcPr');
+        cell.insertBefore(tcPr, cell.firstChild);
+    }
+    let span = getDirectChildrenByName(tcPr, 'gridSpan')[0];
+    if (!span) {
+        span = createWmlElement(cell.ownerDocument, 'gridSpan');
+        const tcW = getDirectChildrenByName(tcPr, 'tcW')[0];
+        const cnfStyle = getDirectChildrenByName(tcPr, 'cnfStyle')[0];
+        const preceding = tcW ?? cnfStyle;
+        tcPr.insertBefore(span, preceding ? preceding.nextSibling : tcPr.firstChild);
+    }
+    return span;
+}
+export function setCellSpan(cell, next) {
+    const tcPr = getDirectChildrenByName(cell.element, 'tcPr')[0];
+    const span = tcPr ? getDirectChildrenByName(tcPr, 'gridSpan')[0] : undefined;
+    if (next === 1)
+        span?.parentNode?.removeChild(span);
+    else
+        setTableAttr(spanElement(cell.element), 'val', next);
+}
+const NEW_CELL_EXCLUDED_PROPERTIES = new Set([
+    'tcW', 'gridSpan', 'vMerge', 'hMerge', 'cellIns', 'cellDel', 'cellMerge', 'tcPrChange',
+    'cnfStyle', 'hideMark', 'headers',
+]);
+export function createTableCell(doc, source, text, width) {
+    const cell = createWmlElement(doc, 'tc');
+    const tcPr = createWmlElement(doc, 'tcPr');
+    const sourcePr = getDirectChildrenByName(source, 'tcPr')[0];
+    if (sourcePr)
+        for (const property of childElements(sourcePr)) {
+            if (!NEW_CELL_EXCLUDED_PROPERTIES.has(property.localName))
+                tcPr.appendChild(property.cloneNode(true));
+        }
+    const tcW = createWmlElement(doc, 'tcW');
+    setTableAttr(tcW, 'w', width);
+    setTableAttr(tcW, 'type', 'dxa');
+    tcPr.insertBefore(tcW, tcPr.firstChild);
+    cell.appendChild(tcPr);
+    const paragraph = createWmlElement(doc, 'p');
+    if (text) {
+        const run = createWmlElement(doc, 'r');
+        const leaf = createWmlElement(doc, 't');
+        if (/^\s|\s$/.test(text))
+            leaf.setAttributeNS('http://www.w3.org/XML/1998/namespace', 'xml:space', 'preserve');
+        leaf.appendChild(doc.createTextNode(text));
+        run.appendChild(leaf);
+        paragraph.appendChild(run);
+    }
+    cell.appendChild(paragraph);
+    return { cell, paragraph };
+}
+export function hasPendingRevision(element) {
+    return Array.from(element.getElementsByTagNameNS(OOXML.W_NS, '*'))
+        .some((descendant) => REVISION_ID_ELEMENT_NAME_SET.has(descendant.localName));
+}
+//# sourceMappingURL=table_edit_common.js.map

package/dist/primitives/table_edit_common.js.map

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

package/dist/primitives/table_occupancy.d.ts

@@ -0,0 +1,39 @@
+export type MergeState = 'none' | 'restart' | 'continue';
+export type OccupiedCell = {
+    element: Element;
+    cellIndex: number;
+    start: number;
+    end: number;
+    merge: MergeState;
+    owner: OccupiedCell;
+};
+export type OccupiedRow = {
+    element: Element;
+    rowIndex: number;
+    before: number;
+    after: number;
+    cells: OccupiedCell[];
+    slots: Array<OccupiedCell | null>;
+};
+export type TableOccupancy = {
+    gridColumns: number;
+    rows: OccupiedRow[];
+};
+export declare class TableOccupancyError extends Error {
+    readonly feature: 'occupancy' | 'gridSpan' | 'hMerge' | 'vMerge' | 'gridBefore' | 'gridAfter' | 'topologyRevision';
+    readonly rowIndex: number;
+    readonly cellIndex: number | undefined;
+    constructor(feature: 'occupancy' | 'gridSpan' | 'hMerge' | 'vMerge' | 'gridBefore' | 'gridAfter' | 'topologyRevision', rowIndex: number, cellIndex: number | undefined, message: string);
+}
+/**
+ * Inventory direct physical cells in logical grid coordinates without rewriting XML.
+ * Each continuation points to the restart cell owning the exact same interval.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.48
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.17
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.23
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.84
+ * @see #1040
+ */
+export declare function inventoryTableOccupancy(table: Element): TableOccupancy;
+//# sourceMappingURL=table_occupancy.d.ts.map

package/dist/primitives/table_occupancy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table_occupancy.d.ts","sourceRoot":"","sources":["../../src/primitives/table_occupancy.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAAC;AAEzD,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,UAAU,CAAC;IAClB,KAAK,EAAE,YAAY,CAAC;CACrB,CAAC;AAEF,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,KAAK,EAAE,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;CACnC,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAE1E,qBAAa,mBAAoB,SAAQ,KAAK;IAE1C,QAAQ,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,kBAAkB;IAClH,QAAQ,CAAC,QAAQ,EAAE,MAAM;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS;gBAF7B,OAAO,EAAE,WAAW,GAAG,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAAG,kBAAkB,EACzG,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAAG,SAAS,EACtC,OAAO,EAAE,MAAM;CAKlB;AA6CD;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,CAqEtE"}

package/dist/primitives/table_occupancy.js

@@ -0,0 +1,145 @@
+import { childElements, getDirectChildrenByName, isW } from './dom-helpers.js';
+import { OOXML } from './namespaces.js';
+export class TableOccupancyError extends Error {
+    feature;
+    rowIndex;
+    cellIndex;
+    constructor(feature, rowIndex, cellIndex, message) {
+        super(message);
+        this.feature = feature;
+        this.rowIndex = rowIndex;
+        this.cellIndex = cellIndex;
+        this.name = 'TableOccupancyError';
+    }
+}
+const RANGE_MARKERS = new Set([
+    'bookmarkStart', 'bookmarkEnd', 'commentRangeStart', 'commentRangeEnd',
+    'permStart', 'permEnd', 'proofErr', 'moveFromRangeStart', 'moveFromRangeEnd',
+    'moveToRangeStart', 'moveToRangeEnd', 'customXmlInsRangeStart',
+    'customXmlInsRangeEnd', 'customXmlDelRangeStart', 'customXmlDelRangeEnd',
+    'customXmlMoveFromRangeStart', 'customXmlMoveFromRangeEnd',
+    'customXmlMoveToRangeStart', 'customXmlMoveToRangeEnd',
+]);
+function oneChild(parent, name, rowIndex, cellIndex) {
+    if (!parent)
+        return undefined;
+    const children = getDirectChildrenByName(parent, name);
+    if (children.length > 1) {
+        throw new TableOccupancyError('occupancy', rowIndex, cellIndex, `Duplicate ${name}`);
+    }
+    return children[0];
+}
+function value(element) {
+    return element.getAttributeNS(OOXML.W_NS, 'val') ?? element.getAttribute('w:val');
+}
+function width(element, feature, rowIndex, cellIndex) {
+    if (!element)
+        return feature === 'gridSpan' ? 1 : 0;
+    const raw = value(element);
+    const parsed = raw === null ? NaN : Number(raw);
+    if (!Number.isSafeInteger(parsed) || parsed < (feature === 'gridSpan' ? 1 : 0)) {
+        throw new TableOccupancyError(feature, rowIndex, cellIndex, `Invalid ${feature} value`);
+    }
+    return parsed;
+}
+function verticalState(cell, rowIndex, cellIndex) {
+    const tcPr = getDirectChildrenByName(cell, 'tcPr')[0];
+    const markers = tcPr ? getDirectChildrenByName(tcPr, 'vMerge') : [];
+    if (markers.length > 1)
+        throw new TableOccupancyError('vMerge', rowIndex, cellIndex, 'Duplicate vMerge');
+    if (!markers.length)
+        return 'none';
+    const raw = value(markers[0]);
+    if (raw === null || raw === 'continue')
+        return 'continue';
+    if (raw === 'restart')
+        return 'restart';
+    throw new TableOccupancyError('vMerge', rowIndex, cellIndex, `Invalid vMerge value: ${raw}`);
+}
+/**
+ * Inventory direct physical cells in logical grid coordinates without rewriting XML.
+ * Each continuation points to the restart cell owning the exact same interval.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.48
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.17
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.23
+ * @conformance ECMA-376 edition 5, Part 1 § 17.4.84
+ * @see #1040
+ */
+export function inventoryTableOccupancy(table) {
+    const grids = getDirectChildrenByName(table, 'tblGrid');
+    const gridColumns = grids.length === 1 ? getDirectChildrenByName(grids[0], 'gridCol').length : 0;
+    if (gridColumns < 1)
+        throw new TableOccupancyError('occupancy', -1, undefined, 'Table must have one nonempty tblGrid');
+    if (grids[0].getElementsByTagNameNS(OOXML.W_NS, 'tblGridChange').length) {
+        throw new TableOccupancyError('topologyRevision', -1, undefined, 'Tracked grid changes are unsupported');
+    }
+    const rows = [];
+    let previousActive = new Map();
+    for (const rowElement of childElements(table)) {
+        if (isW(rowElement, 'tblPr') || isW(rowElement, 'tblGrid') || RANGE_MARKERS.has(rowElement.localName))
+            continue;
+        const rowIndex = rows.length;
+        if (!isW(rowElement, 'tr'))
+            throw new TableOccupancyError('occupancy', rowIndex, undefined, 'Unsupported row container');
+        if (getDirectChildrenByName(rowElement, 'tblPrEx').length) {
+            throw new TableOccupancyError('topologyRevision', rowIndex, undefined, 'Row table-property exceptions are unsupported');
+        }
+        const trPr = oneChild(rowElement, 'trPr', rowIndex);
+        if (trPr && getDirectChildrenByName(trPr, 'trPrChange').length) {
+            throw new TableOccupancyError('topologyRevision', rowIndex, undefined, 'Pending row-property changes are unsupported');
+        }
+        const before = width(oneChild(trPr, 'gridBefore', rowIndex), 'gridBefore', rowIndex);
+        const after = width(oneChild(trPr, 'gridAfter', rowIndex), 'gridAfter', rowIndex);
+        if (before + after >= gridColumns) {
+            throw new TableOccupancyError('occupancy', rowIndex, undefined, 'Row offsets leave no physical cell slots');
+        }
+        const cells = [];
+        const slots = Array(gridColumns).fill(null);
+        const currentActive = new Map();
+        let column = before;
+        for (const cellElement of childElements(rowElement)) {
+            if (isW(cellElement, 'trPr') || RANGE_MARKERS.has(cellElement.localName))
+                continue;
+            const cellIndex = cells.length;
+            if (!isW(cellElement, 'tc')) {
+                throw new TableOccupancyError('occupancy', rowIndex, cellIndex, 'Unsupported cell container');
+            }
+            const tcPr = oneChild(cellElement, 'tcPr', rowIndex, cellIndex);
+            if (tcPr && getDirectChildrenByName(tcPr, 'hMerge').length) {
+                throw new TableOccupancyError('hMerge', rowIndex, cellIndex, 'Legacy hMerge is unsupported');
+            }
+            if (tcPr && ['cellIns', 'cellDel', 'cellMerge', 'tcPrChange'].some((name) => getDirectChildrenByName(tcPr, name).length > 0)) {
+                throw new TableOccupancyError('topologyRevision', rowIndex, cellIndex, 'Pending cell topology changes are unsupported');
+            }
+            const span = width(oneChild(tcPr, 'gridSpan', rowIndex, cellIndex), 'gridSpan', rowIndex, cellIndex);
+            const end = column + span;
+            if (end > gridColumns - after) {
+                throw new TableOccupancyError('occupancy', rowIndex, cellIndex, 'Cell extends beyond effective grid');
+            }
+            const merge = verticalState(cellElement, rowIndex, cellIndex);
+            const interval = `${column}:${end}`;
+            const previousOwner = previousActive.get(interval);
+            if (merge === 'continue' && !previousOwner) {
+                throw new TableOccupancyError('vMerge', rowIndex, cellIndex, 'Orphan or changed-width continuation');
+            }
+            const occupied = { element: cellElement, cellIndex, start: column, end, merge, owner: null };
+            occupied.owner = merge === 'continue' ? previousOwner : occupied;
+            cells.push(occupied);
+            for (let slot = column; slot < end; slot++)
+                slots[slot] = occupied;
+            if (merge !== 'none')
+                currentActive.set(interval, occupied.owner);
+            column = end;
+        }
+        if (column !== gridColumns - after || cells.length === 0) {
+            throw new TableOccupancyError('occupancy', rowIndex, undefined, 'Row occupancy does not match tblGrid and offsets');
+        }
+        rows.push({ element: rowElement, rowIndex, before, after, cells, slots });
+        previousActive = currentActive;
+    }
+    if (!rows.length)
+        throw new TableOccupancyError('occupancy', -1, undefined, 'Table has no direct rows');
+    return { gridColumns, rows };
+}
+//# sourceMappingURL=table_occupancy.js.map