@docx4j/core-ts 0.3.2 → 0.4.0

package/dist/html/elements.d.mts

@@ -0,0 +1,19 @@
+import type { PasteBlock } from './convert.mjs';
+/** Word's character style for a link's text, as `Range.hyperlink` gives it. */
+export declare const HYPERLINK_STYLE = "Hyperlink";
+/** What the blocks need from the document before they are built: a definition per list key, a relationship per link address. */
+export interface BuildNeeds {
+    lists: {
+        key: string;
+        bullet: boolean;
+    }[];
+    links: string[];
+}
+/** The document's answers: `w:numId` per list key, `r:id` per address; undefined drops the list or the link (its text kept). */
+export interface BuildResolvers {
+    numId?: (key: string) => string | undefined;
+    relId?: (address: string) => string | undefined;
+}
+export declare function needsOf(blocks: readonly PasteBlock[]): BuildNeeds;
+/** The blocks as a WordprocessingML fragment: `w:p` and `w:tbl` elements, the prefixes undeclared (`insertXml` declares them). */
+export declare function blocksToXml(blocks: readonly PasteBlock[], resolve?: BuildResolvers): string;

package/dist/html/elements.mjs

@@ -0,0 +1,182 @@
+import { highlightNameOf } from './convert.mjs';
+/** Word's character style for a link's text, as `Range.hyperlink` gives it. */
+export const HYPERLINK_STYLE = 'Hyperlink';
+function walkBlocks(blocks, onParagraph) {
+    for (const b of blocks) {
+        if (b.kind === 'paragraph')
+            onParagraph(b);
+        else
+            for (const row of b.rows)
+                for (const c of row)
+                    walkBlocks(c.blocks, onParagraph);
+    }
+}
+export function needsOf(blocks) {
+    const lists = new Map();
+    const links = new Set();
+    walkBlocks(blocks, (p) => {
+        if (p.list && !lists.has(p.list.key))
+            lists.set(p.list.key, p.list.bullet);
+        for (const i of p.inlines)
+            if ('text' in i && i.link !== undefined)
+                links.add(i.link);
+    });
+    return { lists: [...lists].map(([key, bullet]) => ({ key, bullet })), links: [...links] };
+}
+const esc = (text) => text.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/>/g, '&gt;');
+const attr = (value) => String(value).replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/"/g, '&quot;');
+function rPrXml(run, linked) {
+    const out = [];
+    // In the schema's order: rStyle, rFonts, b, i, strike, color, sz, szCs, highlight, u, vertAlign.
+    if (linked)
+        out.push(`<w:rStyle w:val="${HYPERLINK_STYLE}"/>`);
+    else if (run.style)
+        out.push(`<w:rStyle w:val="${attr(run.style)}"/>`);
+    if (run.fontName)
+        out.push(`<w:rFonts w:ascii="${attr(run.fontName)}" w:hAnsi="${attr(run.fontName)}" w:cs="${attr(run.fontName)}"/>`);
+    if (run.bold)
+        out.push('<w:b/>');
+    if (run.italic)
+        out.push('<w:i/>');
+    if (run.strike)
+        out.push('<w:strike/>');
+    // A link's colour is its style's, as `Range.hyperlink` leaves no direct colour on a link.
+    if (run.color && !linked)
+        out.push(`<w:color w:val="${attr(run.color === 'auto' ? 'auto' : run.color.replace(/^#/, ''))}"/>`);
+    if (run.fontSize !== undefined) {
+        const half = Math.round(run.fontSize * 2);
+        out.push(`<w:sz w:val="${half}"/><w:szCs w:val="${half}"/>`);
+    }
+    if (run.highlight) {
+        const name = highlightNameOf(run.highlight);
+        if (name)
+            out.push(`<w:highlight w:val="${name}"/>`);
+    }
+    if (run.underline)
+        out.push('<w:u w:val="single"/>');
+    if (run.vertAlign)
+        out.push(`<w:vertAlign w:val="${run.vertAlign}"/>`);
+    return out.length > 0 ? `<w:rPr>${out.join('')}</w:rPr>` : '';
+}
+function runXml(run, linked) {
+    if (run.text === '')
+        return '';
+    const space = /^\s|\s$|\s\s/.test(run.text) ? ' xml:space="preserve"' : '';
+    return `<w:r>${rPrXml(run, linked)}<w:t${space}>${esc(run.text)}</w:t></w:r>`;
+}
+function inlinesXml(inlines, resolve) {
+    var _a;
+    const out = [];
+    let i = 0;
+    while (i < inlines.length) {
+        const inline = inlines[i];
+        if ('br' in inline) {
+            out.push('<w:r><w:br/></w:r>');
+            i++;
+            continue;
+        }
+        if ('tab' in inline) {
+            out.push('<w:r><w:tab/></w:r>');
+            i++;
+            continue;
+        }
+        const rId = inline.link !== undefined ? (_a = resolve.relId) === null || _a === void 0 ? void 0 : _a.call(resolve, inline.link) : undefined;
+        if (rId === undefined) {
+            out.push(runXml(inline, false));
+            i++;
+            continue;
+        }
+        // The runs of one address under one w:hyperlink, in Word's look.
+        const runs = [];
+        while (i < inlines.length) {
+            const next = inlines[i];
+            if (!('text' in next) || next.link !== inline.link)
+                break;
+            runs.push(runXml(next, true));
+            i++;
+        }
+        out.push(`<w:hyperlink r:id="${attr(rId)}">${runs.join('')}</w:hyperlink>`);
+    }
+    return out.join('');
+}
+function pPrXml(p, resolve) {
+    var _a;
+    const out = [];
+    // In the schema's order: pStyle, numPr, spacing, ind, jc.
+    if (p.style)
+        out.push(`<w:pStyle w:val="${attr(p.style)}"/>`);
+    const numId = p.list ? (_a = resolve.numId) === null || _a === void 0 ? void 0 : _a.call(resolve, p.list.key) : undefined;
+    if (p.list && numId !== undefined)
+        out.push(`<w:numPr><w:ilvl w:val="${p.list.level}"/><w:numId w:val="${attr(numId)}"/></w:numPr>`);
+    if (p.spacing)
+        out.push(`<w:spacing w:before="${p.spacing.before}"/>`);
+    if (p.ind) {
+        const a = [];
+        if (p.ind.start !== undefined)
+            a.push(`w:left="${p.ind.start}"`);
+        if (p.ind.end !== undefined)
+            a.push(`w:right="${p.ind.end}"`);
+        if (p.ind.hanging !== undefined)
+            a.push(`w:hanging="${p.ind.hanging}"`);
+        else if (p.ind.firstLine !== undefined)
+            a.push(`w:firstLine="${p.ind.firstLine}"`);
+        if (a.length > 0)
+            out.push(`<w:ind ${a.join(' ')}/>`);
+    }
+    if (p.jc)
+        out.push(`<w:jc w:val="${attr(p.jc)}"/>`);
+    return out.length > 0 ? `<w:pPr>${out.join('')}</w:pPr>` : '';
+}
+function paragraphXml(p, resolve) {
+    return `<w:p>${pPrXml(p, resolve)}${inlinesXml(p.inlines, resolve)}</w:p>`;
+}
+/** Word's default text width shared equally where the table does not say (A4 or Letter with Word's margins: 9,026 twips). */
+const TEXT_WIDTH = 9026;
+function tableXml(t, resolve) {
+    const columns = Math.max(1, ...t.rows.map((r) => r.reduce((n, c) => n + c.colspan, 0)));
+    const widths = Array.from({ length: columns }, () => Math.floor(TEXT_WIDTH / columns));
+    const first = t.rows[0];
+    if (first && first.every((c) => c.width !== undefined && c.colspan === 1) && first.length === columns)
+        first.forEach((c, i) => { widths[i] = c.width; });
+    const widthOf = (col, span) => { var _a; let w = 0; for (let k = 0; k < span; k++)
+        w += (_a = widths[col + k]) !== null && _a !== void 0 ? _a : widths[0]; return w; };
+    const tcPr = (col, span, merge) => `<w:tcPr><w:tcW w:w="${widthOf(col, span)}" w:type="dxa"/>${span > 1 ? `<w:gridSpan w:val="${span}"/>` : ''}${merge === 'restart' ? '<w:vMerge w:val="restart"/>' : merge === 'continue' ? '<w:vMerge/>' : ''}</w:tcPr>`;
+    const cellXml = (c, col) => {
+        const blocks = c.blocks.length > 0 ? blocksToXml(c.blocks, resolve) : '<w:p/>';
+        return `<w:tc>${tcPr(col, c.colspan, c.rowspan > 1 ? 'restart' : undefined)}${blocks}</w:tc>`;
+    };
+    // A cell spanning rows holds its place in the rows below with a continuation cell, as WordprocessingML writes a vertical merge.
+    const pending = new Map();
+    const rows = t.rows.map((cells, r) => {
+        const out = [];
+        let col = 0;
+        const continuation = () => {
+            const p = pending.get(col);
+            if (!p)
+                return;
+            out.push(`<w:tc>${tcPr(col, p.span, 'continue')}<w:p/></w:tc>`);
+            if (--p.rows <= 0)
+                pending.delete(col);
+            col += p.span;
+        };
+        for (const c of cells) {
+            while (pending.has(col))
+                continuation();
+            out.push(cellXml(c, col));
+            if (c.rowspan > 1)
+                pending.set(col, { rows: c.rowspan - 1, span: c.colspan });
+            col += c.colspan;
+        }
+        while (col < columns && pending.has(col))
+            continuation();
+        const trPr = r === 0 && t.headerRow ? '<w:trPr><w:tblHeader/></w:trPr>' : '';
+        return `<w:tr>${trPr}${out.join('')}</w:tr>`;
+    });
+    const tblPr = `<w:tblPr>${t.style ? `<w:tblStyle w:val="${attr(t.style)}"/>` : ''}<w:tblW w:w="0" w:type="auto"/></w:tblPr>`;
+    const grid = `<w:tblGrid>${widths.map((w) => `<w:gridCol w:w="${w}"/>`).join('')}</w:tblGrid>`;
+    return `<w:tbl>${tblPr}${grid}${rows.join('')}</w:tbl>`;
+}
+/** The blocks as a WordprocessingML fragment: `w:p` and `w:tbl` elements, the prefixes undeclared (`insertXml` declares them). */
+export function blocksToXml(blocks, resolve = {}) {
+    return blocks.map((b) => (b.kind === 'table' ? tableXml(b, resolve) : paragraphXml(b, resolve))).join('');
+}

package/dist/html/index.d.mts

@@ -0,0 +1,2 @@
+export * from './convert.mjs';
+export * from './elements.mjs';

package/dist/html/index.mjs

@@ -0,0 +1,4 @@
+// SPDX-License-Identifier: Apache-2.0
+// `@docx4j/core-ts/html`: HTML to an intermediate form, and that form to WordprocessingML (CR-005 section 8).
+export * from './convert.mjs';
+export * from './elements.mjs';

package/dist/model/content/Body.mjs

@@ -239,11 +239,18 @@ export class Body {
      * `values` fills it row by row. The columns are equal over the section's text width.
      */
     insertTable(rowCount, columnCount, location, values) {
+        var _a;
+        var _b;
         if (rowCount < 1 || columnCount < 1)
             throw new Docx4JException(`A table needs at least one row and one column; got ${rowCount} by ${columnCount}`);
         const rows = Array.from({ length: rowCount }, (_, r) => Array.from({ length: columnCount }, (_, c) => { var _a, _b; return (_b = (_a = values === null || values === void 0 ? void 0 : values[r]) === null || _a === void 0 ? void 0 : _a[c]) !== null && _b !== void 0 ? _b : ''; }));
         const width = writableWidthTwips(this.container);
         const element = tableOf(rows, width ? { width } : {});
+        // Word's own default (Insert Table, fixed column width Auto; the editor's check 42, Word 365): an
+        // automatic table width, no w:tblLayout, the cells in twips sharing the text width - the grid and
+        // cells the builder wrote, the table's width made automatic (CR-002 section 42.5 item 7).
+        const tblPr = ((_a = (_b = element.value).tblPr) !== null && _a !== void 0 ? _a : (_b.tblPr = {}));
+        tblPr.tblW = { w: 0, type: 'auto' };
         this.insertElement(element, location);
         return new Table(element, this.content, this);
     }

package/dist/model/content/InlinePicture.d.mts

@@ -22,7 +22,9 @@ export interface ImageInfo {
  * The size and kind of an image, from its header: PNG (IHDR and pHYs), JPEG (SOFn and the JFIF
  * APP0 densities), GIF (the logical screen descriptor) and BMP (the DIB header, with its pixels
  * per metre). docx4j reads these through XML Graphics Commons' ImageInfo; this is the same
- * information, and the same 96 dpi default when a file declares none.
+ * information, and the same 96 dpi default when a file declares none. An SVG document is told by
+ * its root element and has no pixel size (both 0): it can be the part behind an existing picture
+ * (CR-005 section 9, a binding that keeps the drawing) but not be placed as a new one.
  */
 export declare function imageInfoOf(bytes: Uint8Array): ImageInfo;
 /** The natural size of an image in EMU: pixels over the resolution it declares. */
@@ -49,10 +51,23 @@ export interface NewPicture {
     imagePart: ImagePart;
     relId: string;
 }
+/** A new image part, its relationship from the part it was added to, and what its header says. */
+export interface NewImagePart {
+    imagePart: ImagePart;
+    relId: string;
+    info: ImageInfo;
+}
 /**
  * Adds the image as a part of `source` (the main document part, or the header or footer the body
- * belongs to) with a relationship, and builds the run that shows it. docx4j:
- * `BinaryPartAbstractImage.createImagePart` then `createImageInline`.
+ * belongs to) with a relationship, and nothing else: docx4j `BinaryPartAbstractImage.createImagePart`
+ * (`BindingTraverserXSLT.createImagePartReturnRelId`, where a picture binding replaces an `r:embed`
+ * and keeps the drawing, CR-005 section 9). Throws, and adds nothing, when the bytes are not an
+ * image this package reads.
+ */
+export declare function addImagePart(source: Part, base64: string): NewImagePart;
+/**
+ * Adds the image as a part of `source` with a relationship (`addImagePart`), and builds the run
+ * that shows it. docx4j: `BinaryPartAbstractImage.createImagePart` then `createImageInline`.
  */
 export declare function addImage(source: Part, base64: string, scope: object, maxCx: number | undefined, options?: InlinePictureOptions): NewPicture;
 /** The writable width of a section in EMU (page width less the margins), for scaling. */

package/dist/model/content/InlinePicture.mjs

@@ -1,7 +1,7 @@
 import { inlinePicture } from '@docx4j/generated-objects-ts/builders/wml';
 import { Docx4JException } from '../../opc/exceptions.mjs';
 import { ContentTypes, IMAGE_CONTENT_TYPES_BY_EXTENSION } from '../../opc/ContentTypes.mjs';
-import { base64Decode, base64Encode } from '../../xml/dom.mjs';
+import { base64Decode, base64Encode, decodeXmlText } from '../../xml/dom.mjs';
 import { ImagePart } from '../../parts/BinaryPart.mjs';
 import { PartName } from '../../opc/PartName.mjs';
 import { find, runOf } from './tree.mjs';
@@ -15,7 +15,9 @@ const EMU_PER_POINT = 12700;
  * The size and kind of an image, from its header: PNG (IHDR and pHYs), JPEG (SOFn and the JFIF
  * APP0 densities), GIF (the logical screen descriptor) and BMP (the DIB header, with its pixels
  * per metre). docx4j reads these through XML Graphics Commons' ImageInfo; this is the same
- * information, and the same 96 dpi default when a file declares none.
+ * information, and the same 96 dpi default when a file declares none. An SVG document is told by
+ * its root element and has no pixel size (both 0): it can be the part behind an existing picture
+ * (CR-005 section 9, a binding that keeps the drawing) but not be placed as a new one.
  */
 export function imageInfoOf(bytes) {
     const png = pngInfo(bytes);
@@ -30,8 +32,27 @@ export function imageInfoOf(bytes) {
     const bmp = bmpInfo(bytes);
     if (bmp)
         return bmp;
+    const svg = svgInfo(bytes);
+    if (svg)
+        return svg;
     const head = Array.from(bytes.subarray(0, 8)).map((b) => b.toString(16).padStart(2, '0')).join(' ');
-    throw new Docx4JException(`Unsupported image format (first bytes ${head}); PNG, JPEG, GIF and BMP are read here`);
+    throw new Docx4JException(`Unsupported image format (first bytes ${head}); PNG, JPEG, GIF, BMP and SVG are read here`);
+}
+/** An SVG document: an XML declaration, comments and a doctype allowed before the `svg` root. */
+function svgInfo(b) {
+    if (b.length < 5)
+        return undefined;
+    let head;
+    try {
+        head = decodeXmlText(b.subarray(0, Math.min(b.length, 4096)));
+    }
+    catch {
+        return undefined;
+    }
+    const body = head.replace(/^\uFEFF/, '').replace(/<\?xml[^>]*\?>/, '').replace(/<!--[\s\S]*?-->/g, '').replace(/<!DOCTYPE[^>]*>/i, '').trimStart();
+    if (!/^<(\w+:)?svg[\s>]/.test(body))
+        return undefined;
+    return { contentType: ContentTypes.IMAGE_SVG, extension: 'svg', widthPx: 0, heightPx: 0, dpiX: DEFAULT_DPI, dpiY: DEFAULT_DPI };
 }
 function be16(b, at) { return (b[at] << 8) | b[at + 1]; }
 function be32(b, at) { return ((b[at] << 24) >>> 0) + (b[at + 1] << 16) + (b[at + 2] << 8) + b[at + 3]; }
@@ -144,11 +165,12 @@ export function naturalSizeEmu(info) {
 }
 /**
  * Adds the image as a part of `source` (the main document part, or the header or footer the body
- * belongs to) with a relationship, and builds the run that shows it. docx4j:
- * `BinaryPartAbstractImage.createImagePart` then `createImageInline`.
+ * belongs to) with a relationship, and nothing else: docx4j `BinaryPartAbstractImage.createImagePart`
+ * (`BindingTraverserXSLT.createImagePartReturnRelId`, where a picture binding replaces an `r:embed`
+ * and keeps the drawing, CR-005 section 9). Throws, and adds nothing, when the bytes are not an
+ * image this package reads.
  */
-export function addImage(source, base64, scope, maxCx, options = {}) {
-    var _a, _b;
+export function addImagePart(source, base64) {
     const pkg = source.package;
     if (!pkg)
         throw new Docx4JException('This part is not in a package yet; add it before adding an image');
@@ -157,6 +179,21 @@ export function addImage(source, base64, scope, maxCx, options = {}) {
     const imagePart = new ImagePart(freeImageName(pkg, info.extension), info.contentType);
     imagePart.setBytes(bytes);
     const rel = source.addTargetPart(imagePart);
+    return { imagePart, relId: rel.id, info };
+}
+/**
+ * Adds the image as a part of `source` with a relationship (`addImagePart`), and builds the run
+ * that shows it. docx4j: `BinaryPartAbstractImage.createImagePart` then `createImageInline`.
+ */
+export function addImage(source, base64, scope, maxCx, options = {}) {
+    var _a, _b;
+    const bytes = base64Decode(base64);
+    const info = imageInfoOf(bytes);
+    if (info.widthPx === 0 || info.heightPx === 0) {
+        throw new Docx4JException(`A ${info.extension.toUpperCase()} image has no pixel size to place it at; PNG, JPEG, GIF and BMP can be placed`);
+    }
+    const { imagePart, relId } = addImagePart(source, base64);
+    const rel = { id: relId };
     let { cx, cy } = naturalSizeEmu(info);
     if (options.width !== undefined) {
         const wanted = Math.round(options.width * EMU_PER_POINT);

package/dist/model/content/Table.d.mts

@@ -4,6 +4,7 @@ import type { Body } from './Body.mjs';
 import type { Paragraph } from './Paragraph.mjs';
 import type { Range } from './Range.mjs';
 import { type ChangeTracker } from './tracking.mjs';
+import { type TableLayoutMode } from './tableColumns.mjs';
 /**
  * A subset of Office JS `Word.Table` over a `w:tbl`. Rows are read through row-level content
  * controls (an OpenDoPE repeat wraps its `w:tr` in a `w:sdt`), so `rows` is what Word shows.
@@ -51,6 +52,30 @@ export declare class Table {
      * tracks changes the rows stay and take a `w:trPr/w:del` instead (CR-002 phase F).
      */
     deleteRows(rowIndex: number, rowCount?: number): void;
+    /**
+     * Adds columns at the start or the end (Office JS `Table.addColumns`), the new cells taking the
+     * properties and width of the column beside them - the one to the right of the boundary when
+     * there is one, else the left - in the table's layout mode as Word 365 writes it (CR-002 section
+     * 42, checks 39 and 40): fixed copies the width and grows the table past the margin, AutoFit to
+     * window rescales the grid and writes the cells' percentages again, AutoFit to contents stays
+     * automatic. `values` is by row, then by new column. Returns the new cells per row, an extension
+     * (Office JS returns nothing); a row whose skipped columns grew instead has none. Tracked, the
+     * table change is recorded as Office JS records one and the new cells' text is an insertion.
+     */
+    addColumns(location: 'Start' | 'End', columnCount: number, values?: string[][]): TableCell[][];
+    /**
+     * Removes `columnCount` grid columns from `columnIndex` (one by default; Office JS
+     * `Table.deleteColumns`): a cell covering only those columns goes, one spanning further shrinks.
+     * Tracked, the cells still go and the table change is recorded, as Office JS's deletion leaves
+     * it (section 42.3; check 40c; Word's own is not tracked at all, known issues entry 2).
+     */
+    deleteColumns(columnIndex: number, columnCount?: number): void;
+    /** Which of Word's three layout modes the table is in: fixed, AutoFit to window, or AutoFit to contents (extension). */
+    get layoutMode(): TableLayoutMode;
+    /** The section's text width in twips, for the window mode and a percentage width. */
+    textWidth(): number;
+    /** Views of new cells, row by row. */
+    cellViewsOf(cells: Element<wml.Tc>[][]): TableCell[][];
     /** Removes the table from its container; tracked, every row is marked deleted instead. */
     delete(): void;
     /** The package's change tracker while `changeTrackingMode` is on (CR-002 phase F). */
@@ -118,7 +143,20 @@ export declare class TableCell {
     insertText(text: string, location: 'Start' | 'End' | 'Replace'): Range;
     /** The cell width in points (w:tcW in twips), as Office JS reports it; 0 when it is not a fixed width. */
     get width(): number;
+    /**
+     * Written in the form the cell states, else its table, else twips (CR-002 section 42.2 item 4): a
+     * cell in percent takes the points as a share of the section's text width; `auto` becomes twips,
+     * a stated width being what was asked for.
+     */
     set width(points: number);
+    /**
+     * New columns before or after this cell (Office JS `TableCell.insertColumns`), the new cells
+     * taking this cell's properties and width, as `Table.addColumns` does. Returns the new cells per
+     * row (extension).
+     */
+    insertColumns(location: 'Before' | 'After', columnCount: number, values?: string[][]): TableCell[][];
+    /** Removes the grid columns this cell covers (Office JS `TableCell.deleteColumn`); tracked as `Table.deleteColumns` is. */
+    deleteColumn(): void;
     /** Office JS TableCell.columnWidth, the same value. */
     get columnWidth(): number;
     set columnWidth(points: number);

package/dist/model/content/Table.mjs

@@ -4,6 +4,7 @@ import { Docx4JException } from '../../opc/exceptions.mjs';
 import { typeNameOf, childrenOf, linkParents, textOf, rowsOf, cellsOf } from './tree.mjs';
 import { builtInOf, idOfBuiltIn, styleNameOf, styleIdOf } from './styles.mjs';
 import { trackInsertedBlocks } from './tracking.mjs';
+import { insertGridColumns, deleteGridColumns, gridRangeOf, textWidthTwips, widthTypeOf, layoutModeOf } from './tableColumns.mjs';
 /** The default table width in twips (A4 with 2.54 cm margins), as the objects package's `tbl` builder uses. */
 const DEFAULT_WIDTH = 9026;
 const TWIPS_PER_POINT = 20;
@@ -128,6 +129,51 @@ export class Table {
                 row.container.splice(i, 1);
         }
     }
+    /**
+     * Adds columns at the start or the end (Office JS `Table.addColumns`), the new cells taking the
+     * properties and width of the column beside them - the one to the right of the boundary when
+     * there is one, else the left - in the table's layout mode as Word 365 writes it (CR-002 section
+     * 42, checks 39 and 40): fixed copies the width and grows the table past the margin, AutoFit to
+     * window rescales the grid and writes the cells' percentages again, AutoFit to contents stays
+     * automatic. `values` is by row, then by new column. Returns the new cells per row, an extension
+     * (Office JS returns nothing); a row whose skipped columns grew instead has none. Tracked, the
+     * table change is recorded as Office JS records one and the new cells' text is an insertion.
+     */
+    addColumns(location, columnCount, values) {
+        const at = location === 'Start' ? 0 : this.columnWidths().length;
+        const inserted = insertGridColumns(this.tbl, this.textWidth(), at, columnCount, values, this.changeTracker);
+        return this.cellViewsOf(inserted.cells);
+    }
+    /**
+     * Removes `columnCount` grid columns from `columnIndex` (one by default; Office JS
+     * `Table.deleteColumns`): a cell covering only those columns goes, one spanning further shrinks.
+     * Tracked, the cells still go and the table change is recorded, as Office JS's deletion leaves
+     * it (section 42.3; check 40c; Word's own is not tracked at all, known issues entry 2).
+     */
+    deleteColumns(columnIndex, columnCount = 1) {
+        var _a, _b, _c;
+        deleteGridColumns(this.tbl, this.textWidth(), columnIndex, columnCount, this.changeTracker);
+        if (((_c = (_b = (_a = this.tbl.tblGrid) === null || _a === void 0 ? void 0 : _a.gridCol) === null || _b === void 0 ? void 0 : _b.length) !== null && _c !== void 0 ? _c : 0) === 0 || rowsOf(this.tbl).every((row) => cellsOf(row.element.value).length === 0))
+            this.delete();
+    }
+    /** Which of Word's three layout modes the table is in: fixed, AutoFit to window, or AutoFit to contents (extension). */
+    get layoutMode() {
+        return layoutModeOf(this.tbl);
+    }
+    /** The section's text width in twips, for the window mode and a percentage width. */
+    textWidth() {
+        return textWidthTwips(this.parentBody.container);
+    }
+    /** Views of new cells, row by row. */
+    cellViewsOf(cells) {
+        const rows = this.rows;
+        return cells.map((rowCells, i) => {
+            const row = rows[i];
+            if (!row || rowCells.length === 0)
+                return [];
+            return row.cells.filter((cell) => rowCells.includes(cell.element));
+        });
+    }
     /** Removes the table from its container; tracked, every row is marked deleted instead. */
     delete() {
         const tracker = this.changeTracker;
@@ -311,12 +357,44 @@ export class TableCell {
         const w = (_a = this.tc.tcPr) === null || _a === void 0 ? void 0 : _a.tcW;
         return (w === null || w === void 0 ? void 0 : w.type) === 'dxa' ? ((_b = w.w) !== null && _b !== void 0 ? _b : 0) / TWIPS_PER_POINT : 0;
     }
+    /**
+     * Written in the form the cell states, else its table, else twips (CR-002 section 42.2 item 4): a
+     * cell in percent takes the points as a share of the section's text width; `auto` becomes twips,
+     * a stated width being what was asked for.
+     */
     set width(points) {
         var _a, _b;
         var _c, _d;
+        const twips = Math.round(points * TWIPS_PER_POINT);
         const tcW = ((_b = (_d = ((_a = (_c = this.tc).tcPr) !== null && _a !== void 0 ? _a : (_c.tcPr = {}))).tcW) !== null && _b !== void 0 ? _b : (_d.tcW = {}));
-        tcW.w = Math.round(points * TWIPS_PER_POINT);
-        tcW.type = 'dxa';
+        if (widthTypeOf(this.tc, this.parentTable.tbl) === 'pct') {
+            tcW.w = Math.round((twips * 5000) / this.parentTable.textWidth());
+            tcW.type = 'pct';
+        }
+        else {
+            tcW.w = twips;
+            tcW.type = 'dxa';
+        }
+    }
+    /**
+     * New columns before or after this cell (Office JS `TableCell.insertColumns`), the new cells
+     * taking this cell's properties and width, as `Table.addColumns` does. Returns the new cells per
+     * row (extension).
+     */
+    insertColumns(location, columnCount, values) {
+        const range = gridRangeOf(this.parentRow.tr, this.tc);
+        if (!range)
+            throw new Docx4JException('This cell is not in its row');
+        const table = this.parentTable;
+        const inserted = insertGridColumns(table.tbl, table.textWidth(), location === 'Before' ? range.start : range.end, columnCount, values, table.changeTracker);
+        return table.cellViewsOf(inserted.cells);
+    }
+    /** Removes the grid columns this cell covers (Office JS `TableCell.deleteColumn`); tracked as `Table.deleteColumns` is. */
+    deleteColumn() {
+        const range = gridRangeOf(this.parentRow.tr, this.tc);
+        if (!range)
+            throw new Docx4JException('This cell is not in its row');
+        this.parentTable.deleteColumns(range.start, range.end - range.start);
     }
     /** Office JS TableCell.columnWidth, the same value. */
     get columnWidth() {

package/dist/model/content/index.d.mts

@@ -7,7 +7,8 @@ export { List, ListItem, ListItemNotFoundError, NumberingFacade, listsOf, listLa
 export { type Author, type CommentContent, type CommentOptions, type CommentEntry, type CommentParts, type CommentPartsAccess, type CommentsExtensible, type CommentMarker, COMMENT_TEXT_STYLE, COMMENT_REFERENCE_STYLE, markersOf, markersOfParagraph, commentIdsOf } from './comments.mjs';
 export { Font, type UnderlineType, type RPrHolder, type FontTracking } from './Font.mjs';
 export { Table, TableRow, TableCell, cellOf } from './Table.mjs';
-export { InlinePicture, imageInfoOf, naturalSizeEmu, addImage, writableWidthEmu, type ImageFormat, type ImageInfo, type InlinePictureOptions, type NewPicture } from './InlinePicture.mjs';
+export { layoutModeOf, textWidthTwips, gridWidthsOf, widthTypeOf, insertGridColumns, deleteGridColumns, gridRangeOf, type TableLayoutMode, type ColumnInsertion } from './tableColumns.mjs';
+export { InlinePicture, imageInfoOf, naturalSizeEmu, addImage, addImagePart, writableWidthEmu, type ImageFormat, type ImageInfo, type InlinePictureOptions, type NewPicture, type NewImagePart } from './InlinePicture.mjs';
 export { ContentControl, collectControls, collectRunControls, W14_NS, W15_NS, type ContentControlType, type ContentControlForm, type ContentControlAppearance } from './ContentControl.mjs';
 export { contentOf, isFlatOpc, rewriteRelationshipIds, type OoxmlOptions } from './ooxml.mjs';
 export { type SearchOptions, searchPattern, findAll, matchesOf, expandReplacement } from './search.mjs';

package/dist/model/content/index.mjs

@@ -9,7 +9,8 @@ export { List, ListItem, ListItemNotFoundError, NumberingFacade, listsOf, listLa
 export { COMMENT_TEXT_STYLE, COMMENT_REFERENCE_STYLE, markersOf, markersOfParagraph, commentIdsOf } from './comments.mjs';
 export { Font } from './Font.mjs';
 export { Table, TableRow, TableCell, cellOf } from './Table.mjs';
-export { InlinePicture, imageInfoOf, naturalSizeEmu, addImage, writableWidthEmu } from './InlinePicture.mjs';
+export { layoutModeOf, textWidthTwips, gridWidthsOf, widthTypeOf, insertGridColumns, deleteGridColumns, gridRangeOf } from './tableColumns.mjs';
+export { InlinePicture, imageInfoOf, naturalSizeEmu, addImage, addImagePart, writableWidthEmu } from './InlinePicture.mjs';
 export { ContentControl, collectControls, collectRunControls, W14_NS, W15_NS } from './ContentControl.mjs';
 export { contentOf, isFlatOpc, rewriteRelationshipIds } from './ooxml.mjs';
 export { searchPattern, findAll, matchesOf, expandReplacement } from './search.mjs';

package/dist/model/content/stylesFacade.d.mts

@@ -23,8 +23,10 @@ export declare class StylesFacade {
      *
      * A style already in the document is left exactly as it is - the document's own definition wins
      * over the default, always, since a consumer must not silently restyle a document it was asked to
-     * add a footnote to. An id the defaults do not carry throws a `Docx4JException` naming it: the
-     * caller asked for a definition nothing here has, and inventing one would be worse than saying so.
+     * add a footnote to. An id none of the sources carry - the defaults, the nine spliceable styles,
+     * the comment and placeholder styles, and Word's built-ins from docx4j's `KnownStyles.xml`
+     * (section 41) - throws a `Docx4JException` naming it: the caller asked for a definition nothing
+     * here has, and inventing one would be worse than saying so.
      * The whole closure is worked out before anything is written, so a call that throws has changed
      * nothing (CR-002 section 31).
      *

package/dist/model/content/stylesFacade.mjs

@@ -5,13 +5,16 @@ import { DEFAULT_STYLES_XML } from '../../parts/wml/defaultStyles.mjs';
 import { SPLICEABLE_STYLES_XML } from '../../parts/wml/spliceableStyles.mjs';
 import { commentStyles } from '../../parts/wml/commentStyles.mjs';
 import { placeholderStyle } from '../../parts/wml/placeholderStyle.mjs';
+import { KNOWN_STYLES_XML } from '../../parts/wml/knownStyles.mjs';
 import { Docx4JException } from '../../opc/exceptions.mjs';
 /**
  * Where a definition is looked up, unmarshalled once and never handed out (a copy is spliced in):
  * the defaults `createPackage()` writes, and then the nine styles docx4j's own `styles.xml` carries
  * **commented out** - which is why a created document has no `FootnoteText` although the file
  * appears to contain one, and why this facade exists (CR-002 section 22.2) - with Word's two comment
- * styles and its `PlaceholderText` after them.
+ * styles and its `PlaceholderText` after them, and last Word's 164 built-ins as docx4j's
+ * `KnownStyles.xml` carries them (CR-002 section 41: `Heading5`, `Quote`, `HTMLCode`, ...), the
+ * list numbering some of them name dropped, since no numbering definition comes with them.
  */
 let sources;
 function styleSources() {
@@ -20,8 +23,17 @@ function styleSources() {
         const defaults = await read(DEFAULT_STYLES_XML);
         // and Word's two comment styles, which the comment parts add when they are made, for a caller
         // that makes the comment itself (CR-002 section 37), and Word's PlaceholderText, which a
-        // placeholder run names (CR-002 section 40)
-        return { defaults, all: [...defaults, ...(await read(SPLICEABLE_STYLES_XML)), ...commentStyles(), placeholderStyle()] };
+        // placeholder run names (CR-002 section 40); then the known styles (section 41), each without
+        // the w:numPr the file left on the headings and list styles: it names a w:numId of the document
+        // the file was taken from, which the document being spliced into need not have, and a heading
+        // spliced with it would join a list that is not there (the editor's copy drops it the same way)
+        const known = (await read(KNOWN_STYLES_XML)).map((style) => {
+            var _a;
+            if ((_a = style.pPr) === null || _a === void 0 ? void 0 : _a.numPr)
+                delete style.pPr.numPr;
+            return style;
+        });
+        return { defaults, all: [...defaults, ...(await read(SPLICEABLE_STYLES_XML)), ...commentStyles(), placeholderStyle(), ...known] };
     })()));
 }
 /**
@@ -42,8 +54,10 @@ export class StylesFacade {
      *
      * A style already in the document is left exactly as it is - the document's own definition wins
      * over the default, always, since a consumer must not silently restyle a document it was asked to
-     * add a footnote to. An id the defaults do not carry throws a `Docx4JException` naming it: the
-     * caller asked for a definition nothing here has, and inventing one would be worse than saying so.
+     * add a footnote to. An id none of the sources carry - the defaults, the nine spliceable styles,
+     * the comment and placeholder styles, and Word's built-ins from docx4j's `KnownStyles.xml`
+     * (section 41) - throws a `Docx4JException` naming it: the caller asked for a definition nothing
+     * here has, and inventing one would be worse than saying so.
      * The whole closure is worked out before anything is written, so a call that throws has changed
      * nothing (CR-002 section 31).
      *
@@ -105,7 +119,7 @@ function closureOf(wanted, present, source) {
         seen.add(id);
         const template = source.find((s) => s.styleId === id);
         if (template === undefined) {
-            throw new Docx4JException(`No definition to splice for the style ${id}: neither docx4j's default styles, the nine it comments out, the two comment styles nor PlaceholderText carry one. Define it yourself on the styles part.`);
+            throw new Docx4JException(`No definition to splice for the style ${id}: neither docx4j's default styles, the nine it comments out, the two comment styles, PlaceholderText nor Word's built-ins in docx4j's KnownStyles.xml carry one. Define it yourself on the styles part.`);
         }
         // what it is based on and linked to must be there too, and before it reads better in the part
         for (const dependency of [(_a = template.basedOn) === null || _a === void 0 ? void 0 : _a.val, (_b = template.link) === null || _b === void 0 ? void 0 : _b.val]) {