@usejunior/docx-core 0.19.1 → 0.21.2

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

package/dist/primitives/table_occupancy.js.map

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

package/dist/primitives/table_rows.d.ts

@@ -0,0 +1,56 @@
+import { type BookmarkReservation } from './bookmarks.js';
+import { type RevisionContext } from './track-changes-emitter.js';
+export type TableRowEditFeature = 'gridSpan' | 'hMerge' | 'vMerge' | 'gridBefore' | 'gridAfter' | 'nestedTable' | 'rowContainer' | 'cellContainer' | 'tblPrEx' | 'occupancy' | 'trailingParagraph' | 'topologyRevision' | 'lastRow' | 'nestedAnchor' | 'alreadyInserted' | 'alreadyDeleted';
+export type TableRowEditDetail = {
+    anchorId: string;
+    tableIndex: number;
+    rowIndex: number;
+    cellIndex?: number;
+    childIndex?: number;
+    feature: TableRowEditFeature;
+};
+export type InsertTableRowParams = {
+    positionalAnchorNodeId: string;
+    relativePosition: 'BEFORE' | 'AFTER';
+    cellTexts: string[];
+    /** @experimental Opt into validated horizontal spans; vertical merges still fail closed. */
+    mergeAware?: boolean;
+};
+export type InsertTableRowResult = {
+    rowIndex: number;
+    cellParagraphIds: string[];
+};
+export type DeleteTableRowParams = {
+    targetParagraphId: string;
+    /** @experimental Opt into validated horizontal spans; vertical merges still fail closed. */
+    mergeAware?: boolean;
+};
+export type DeleteTableRowResult = {
+    rowIndex: number;
+    deleted: true;
+};
+/** Remove the surviving half of any supported range cut by subtree removal. */
+export declare function removeOrphanedRangeEndpointsForSubtree(root: Element, subtree: Element): void;
+/**
+ * Resolve a deleted or rejected row without discarding surviving row containers.
+ * A table-level sdt/customXml child can hold rows even when no direct tr remains.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.5.17
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.5.12
+ * @see #1073
+ */
+export declare function removeTableRowAndEmptyTable(root: Element, row: Element): void;
+/**
+ * Remove a resolved row marker and its now-empty property container.
+ * An authored empty trPr is normalized to absence after row resolution.
+ *
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.5.17
+ * @conformance ECMA-376 edition 5, Part 1 § 17.13.5.12
+ * @see #1040
+ */
+export declare function removeResolvedRowMarker(marker: Element): void;
+/** Insert a rectangular unmerged row using an anchored row's safe formatting shell. */
+export declare function insertTableRow(doc: Document, params: InsertTableRowParams, ctx?: RevisionContext, bookmarkReservation?: BookmarkReservation): InsertTableRowResult;
+/** Delete or deletion-mark a rectangular unmerged row. */
+export declare function deleteTableRow(doc: Document, params: DeleteTableRowParams, ctx?: RevisionContext): DeleteTableRowResult;
+//# sourceMappingURL=table_rows.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"table_rows.d.ts","sourceRoot":"","sources":["../../src/primitives/table_rows.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,mBAAmB,EACzB,MAAM,gBAAgB,CAAC;AAKxB,OAAO,EAA+C,KAAK,eAAe,EAAE,MAAM,4BAA4B,CAAC;AAE/G,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GAAG,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,WAAW,GAC7D,aAAa,GAAG,cAAc,GAAG,eAAe,GAAG,SAAS,GAC5D,WAAW,GAAG,mBAAmB,GAAG,kBAAkB,GACtD,SAAS,GAAG,cAAc,GAAG,iBAAiB,GAAG,gBAAgB,CAAC;AAEtE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,mBAAmB,CAAC;CAC9B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,gBAAgB,EAAE,QAAQ,GAAG,OAAO,CAAC;IACrC,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC;AACpF,MAAM,MAAM,oBAAoB,GAAG;IACjC,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4FAA4F;IAC5F,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AACF,MAAM,MAAM,oBAAoB,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,CAAA;CAAE,CAAC;AAqCvE,+EAA+E;AAC/E,wBAAgB,sCAAsC,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAiB5F;AAED;;;;;;;GAOG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CA6B7E;AAED;;;;;;;GAOG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAO7D;AAoLD,uFAAuF;AACvF,wBAAgB,cAAc,CAC5B,GAAG,EAAE,QAAQ,EACb,MAAM,EAAE,oBAAoB,EAC5B,GAAG,CAAC,EAAE,eAAe,EACrB,mBAAmB,CAAC,EAAE,mBAAmB,GACxC,oBAAoB,CA8CtB;AAED,0DAA0D;AAC1D,wBAAgB,cAAc,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,oBAAoB,EAAE,GAAG,CAAC,EAAE,eAAe,GAAG,oBAAoB,CAmCvH"}