@shbernal/ts-xlsx 2.1.0 → 3.1.0

package/dist/io/xlsx/style-elements.d.ts

@@ -0,0 +1,43 @@
+import { type Alignment, type Border, type Fill, type Protection } from '../../core/style.ts';
+import type { DifferentialStyle } from '../../core/workbook-styles.ts';
+export declare const CUSTOM_NUMFMT_BASE = 164;
+export declare const DEFAULT_FONT_BODY = "<sz val=\"11\"/><color theme=\"1\"/><name val=\"Calibri\"/><family val=\"2\"/><scheme val=\"minor\"/>";
+export declare const DEFAULT_BORDER = "<border><left/><right/><top/><bottom/><diagonal/></border>";
+export interface CellFormat {
+    readonly fillId: number;
+    readonly numFmtId: number;
+    readonly fontId: number;
+    readonly borderId: number;
+    readonly alignment: string;
+    readonly protection: string;
+    readonly quotePrefix: boolean;
+    readonly xfId: number;
+}
+export declare const DEFAULT_FORMAT: CellFormat;
+export declare function formatSignature(format: CellFormat): string;
+/**
+ * Whether a format is the do-nothing default: no facet, General number format, no quote prefix, and
+ * linked to the Normal named style. Such a cellXfs entry adds nothing, so its owner needs no `s`.
+ *
+ * Asked of the signature rather than field by field, because the two questions have to be answered
+ * from the same field set and both answer silently when they are not. A facet the signature forgets
+ * makes two distinct formats intern to one entry, and every cell carrying the facet quietly loses it;
+ * a facet *this* forgets forces a spurious entry and an `s` attribute onto every cell in the book.
+ * Neither is a type error, and neither is visible in the file until someone compares two of them.
+ */
+export declare function isDefaultFormat(format: CellFormat): boolean;
+export declare function xfXml(format: CellFormat, xfId: number | null): string;
+export declare function cellStyleTag(entry: {
+    name: string;
+    builtinId?: number;
+    xfId: number;
+}): string;
+export declare function alignmentAttrs(alignment: Alignment): string;
+export declare function protectionAttrs(protection: Protection): string;
+export declare function tableStyleName(fragment: string): string;
+export declare function dxfXml(style: DifferentialStyle): string;
+export declare function borderXml(border: Border): string;
+export declare function fillSignature(fill: Fill): string;
+export declare function patternFillXml(fill: Fill, { solidBgFallback }: {
+    solidBgFallback: boolean;
+}): string;

package/dist/io/xlsx/style-elements.js

@@ -0,0 +1,156 @@
+import { ALIGNMENT_FACETS, isBorderStyle, isFillPatternType, } from '../../core/style.js';
+import { decodeEntities } from '../../xml/xml-scan.js';
+import { checkedToken, escapeAttr, escapeFormatCode, numberText } from '../../xml/xml.js';
+import { colorAttrs } from './color-xml.js';
+import { fontXml } from './font-xml.js';
+export const CUSTOM_NUMFMT_BASE = 164;
+export const DEFAULT_FONT_BODY = '<sz val="11"/><color theme="1"/><name val="Calibri"/><family val="2"/><scheme val="minor"/>';
+export const DEFAULT_BORDER = '<border><left/><right/><top/><bottom/><diagonal/></border>';
+export const DEFAULT_FORMAT = {
+    fillId: 0,
+    numFmtId: 0,
+    fontId: 0,
+    borderId: 0,
+    alignment: '',
+    protection: '',
+    quotePrefix: false,
+    xfId: 0,
+};
+export function formatSignature(format) {
+    return (`fill:${format.fillId}|numFmt:${format.numFmtId}|font:${format.fontId}|border:${format.borderId}|` +
+        `align:${format.alignment}|protect:${format.protection}|quote:${format.quotePrefix}|xfId:${format.xfId}`);
+}
+const DEFAULT_FORMAT_SIGNATURE = formatSignature(DEFAULT_FORMAT);
+export function isDefaultFormat(format) {
+    return formatSignature(format) === DEFAULT_FORMAT_SIGNATURE;
+}
+export function xfXml(format, xfId) {
+    const applyNumberFormat = format.numFmtId !== 0 ? ' applyNumberFormat="1"' : '';
+    const applyFont = format.fontId !== 0 ? ' applyFont="1"' : '';
+    const applyFill = format.fillId !== 0 ? ' applyFill="1"' : '';
+    const applyBorder = format.borderId !== 0 ? ' applyBorder="1"' : '';
+    const applyAlignment = format.alignment !== '' ? ' applyAlignment="1"' : '';
+    const applyProtection = format.protection !== '' ? ' applyProtection="1"' : '';
+    const quotePrefix = format.quotePrefix ? ' quotePrefix="1"' : '';
+    const xfIdAttr = xfId === null ? '' : ` xfId="${xfId}"`;
+    const open = `<xf numFmtId="${format.numFmtId}" fontId="${format.fontId}" fillId="${format.fillId}" ` +
+        `borderId="${format.borderId}"${xfIdAttr}${quotePrefix}` +
+        `${applyNumberFormat}${applyFont}${applyFill}${applyBorder}${applyAlignment}${applyProtection}`;
+    const body = (format.alignment === '' ? '' : `<alignment ${format.alignment}/>`) +
+        (format.protection === '' ? '' : `<protection ${format.protection}/>`);
+    return body === '' ? `${open}/>` : `${open}>${body}</xf>`;
+}
+export function cellStyleTag(entry) {
+    const builtin = entry.builtinId === undefined ? '' : ` builtinId="${entry.builtinId}"`;
+    return `<cellStyle name="${escapeAttr(entry.name)}" xfId="${entry.xfId}"${builtin}/>`;
+}
+export function alignmentAttrs(alignment) {
+    const parts = [];
+    for (const facet of ALIGNMENT_FACETS) {
+        switch (facet.kind) {
+            case 'token': {
+                const value = alignment[facet.key];
+                if (value === undefined || value === facet.omit)
+                    break;
+                parts.push(`${facet.key}="${checkedToken(value, facet.isValid, facet.label)}"`);
+                break;
+            }
+            case 'number': {
+                const value = alignment[facet.key];
+                if (value === undefined || value === 0)
+                    break;
+                parts.push(`${facet.key}="${numberText(value)}"`);
+                break;
+            }
+            case 'flag':
+                if (alignment[facet.key])
+                    parts.push(`${facet.key}="1"`);
+                break;
+        }
+    }
+    return parts.join(' ');
+}
+export function protectionAttrs(protection) {
+    const parts = [];
+    if (protection.locked === false)
+        parts.push('locked="0"');
+    if (protection.hidden === true)
+        parts.push('hidden="1"');
+    return parts.join(' ');
+}
+export function tableStyleName(fragment) {
+    return decodeEntities(/<tableStyle\b[^>]*\bname="([^"]*)"/.exec(fragment)?.[1] ?? '');
+}
+export function dxfXml(style) {
+    const parts = [];
+    if (style.font !== undefined) {
+        const font = fontXml(style.font);
+        if (font !== '')
+            parts.push(`<font>${font}</font>`);
+    }
+    if (typeof style.numFmt === 'string' && style.numFmt !== '') {
+        parts.push(`<numFmt numFmtId="${CUSTOM_NUMFMT_BASE}" formatCode="${escapeFormatCode(style.numFmt)}"/>`);
+    }
+    if (style.fill !== undefined)
+        parts.push(patternFillXml(style.fill, { solidBgFallback: false }));
+    if (style.border !== undefined)
+        parts.push(borderXml(style.border));
+    return `<dxf>${parts.join('')}</dxf>`;
+}
+function gradientFillXml(fill) {
+    const attrs = (fill.gradient === 'path' ? ' type="path"' : '') +
+        (fill.degree ? ` degree="${numberText(fill.degree)}"` : '') +
+        insetAttr('left', fill.left) +
+        insetAttr('right', fill.right) +
+        insetAttr('top', fill.top) +
+        insetAttr('bottom', fill.bottom);
+    const stops = fill.stops
+        .map((stop) => `<stop position="${numberText(stop.position)}"><color ${colorAttrs(stop.color)}/></stop>`)
+        .join('');
+    return `<gradientFill${attrs}>${stops}</gradientFill>`;
+}
+function insetAttr(name, value) {
+    return value ? ` ${name}="${numberText(value)}"` : '';
+}
+export function borderXml(border) {
+    const attrs = (border.diagonalUp ? ' diagonalUp="1"' : '') + (border.diagonalDown ? ' diagonalDown="1"' : '');
+    return (`<border${attrs}>` +
+        edgeXml('left', border.left) +
+        edgeXml('right', border.right) +
+        edgeXml('top', border.top) +
+        edgeXml('bottom', border.bottom) +
+        edgeXml('diagonal', border.diagonal) +
+        '</border>');
+}
+function edgeXml(tag, edge) {
+    if (edge === undefined)
+        return `<${tag}/>`;
+    const style = checkedToken(edge.style, isBorderStyle, 'border style');
+    if (edge.color === undefined)
+        return `<${tag} style="${style}"/>`;
+    return `<${tag} style="${style}"><color ${colorAttrs(edge.color)}/></${tag}>`;
+}
+export function fillSignature(fill) {
+    if (fill.type === 'gradient') {
+        const stops = fill.stops.map((s) => `${s.position}:${colorSignature(s.color)}`).join(',');
+        return `grad|${fill.gradient}|${fill.degree ?? ''}|${fill.left ?? ''}/${fill.right ?? ''}/${fill.top ?? ''}/${fill.bottom ?? ''}|${stops}`;
+    }
+    return `${fill.pattern}|${colorSignature(fill.fgColor)}|${colorSignature(fill.bgColor)}`;
+}
+function colorSignature(color) {
+    if (color === undefined)
+        return '';
+    return `${color.argb ?? ''}/${color.theme ?? ''}/${color.tint ?? ''}/${color.indexed ?? ''}`;
+}
+export function patternFillXml(fill, { solidBgFallback }) {
+    if (fill.type === 'gradient')
+        return `<fill>${gradientFillXml(fill)}</fill>`;
+    const fg = fill.fgColor ? `<fgColor ${colorAttrs(fill.fgColor)}/>` : '';
+    const bg = fill.bgColor
+        ? `<bgColor ${colorAttrs(fill.bgColor)}/>`
+        : solidBgFallback && fill.pattern === 'solid'
+            ? '<bgColor indexed="64"/>'
+            : '';
+    const pattern = checkedToken(fill.pattern, isFillPatternType, 'fill pattern');
+    return `<fill><patternFill patternType="${pattern}">${fg}${bg}</patternFill></fill>`;
+}

package/dist/io/xlsx/styles.d.ts

@@ -1,7 +1,9 @@
-import { type DifferentialStyle, type Font, type NamedCellStyle, type TableStyleTable } from '../../core/style.ts';
+import { type Font } from '../../core/style.ts';
 import { type TableStyle } from '../../core/table-style.ts';
+import type { DifferentialStyle, NamedCellStyle, TableStyleTable } from '../../core/workbook-styles.ts';
 import type { XfStyle } from '../style/xf-style.ts';
-/** What a {@link StyleRegistry} needs from its workbook before any style is interned. */
+/** What a {@link StyleRegistry} needs from its workbook before any style is interned.
+ */
 export interface StyleRegistryOptions {
     /**
      * The font every cell naming none of its own renders in, emitted as id 0. Take it from
@@ -22,6 +24,14 @@ export interface StyleRegistryOptions {
      */
     readonly declaredDefaultFont?: Font;
 }
+/**
+ * The interned style table one written package is built against: every distinct fill, number format,
+ * font, border and xf, each handed back as the stable index a cell's `s` attribute names.
+ *
+ * One workbook, one registry. The streaming writer is why that is worth saying: it interns a row's
+ * styles at the moment the row is flushed, long before `xl/styles.xml` is emitted, so the ids already
+ * baked into those rows are only correct if the very same registry emits the part.
+ */
 export declare class StyleRegistry {
     #private;
     constructor(options?: StyleRegistryOptions);
@@ -94,4 +104,3 @@ export declare class StyleRegistry {
     /** Serialise the accumulated table into a complete, valid styles.xml part. */
     toXml(): string;
 }
-export declare function fontXml(font: Font, nameTag?: 'name' | 'rFont'): string;

package/dist/io/xlsx/styles.js

@@ -1,25 +1,12 @@
-import { isBorderStyle, isFillPatternType, isFontScheme, isFontVerticalAlignment, isHorizontalAlignment, isNamedUnderlineStyle, isVerticalAlignment, } from '../../core/style.js';
+import {} from '../../core/style.js';
 import { TABLE_STYLE_ELEMENT_TYPES } from '../../core/table-style.js';
-import { decodeEntities } from '../../xml/xml-read.js';
-import { assertRepresentable, checkedToken, escapeAttr, numberText, XML_DECLARATION, } from '../../xml/xml.js';
-import { colorAttrs } from './color-xml.js';
+import { escapeAttr, escapeFormatCode, numAttr, XML_DECLARATION } from '../../xml/xml.js';
+import { fontXml } from './font-xml.js';
 import { MARKUP_COMPATIBILITY_NS, SPREADSHEETML_NS } from './namespaces.js';
+import { alignmentAttrs, borderXml, cellStyleTag, CUSTOM_NUMFMT_BASE, DEFAULT_BORDER, DEFAULT_FONT_BODY, DEFAULT_FORMAT, dxfXml, fillSignature, formatSignature, isDefaultFormat, patternFillXml, protectionAttrs, tableStyleName, xfXml, } from './style-elements.js';
 const RESERVED_FILL_COUNT = 2;
 const RESERVED_FONT_COUNT = 1;
-const CUSTOM_NUMFMT_BASE = 164;
 const RESERVED_BORDER_COUNT = 1;
-const DEFAULT_FONT_BODY = '<sz val="11"/><color theme="1"/><name val="Calibri"/><family val="2"/><scheme val="minor"/>';
-const DEFAULT_BORDER = '<border><left/><right/><top/><bottom/><diagonal/></border>';
-const DEFAULT_FORMAT = {
-    fillId: 0,
-    numFmtId: 0,
-    fontId: 0,
-    borderId: 0,
-    alignment: '',
-    protection: '',
-    quotePrefix: false,
-    xfId: 0,
-};
 class InternTable {
     #entries = [];
     #idByKey = new Map();
@@ -137,7 +124,7 @@ export class StyleRegistry {
             const element = style.elements[type];
             if (element === undefined)
                 return [];
-            const size = element.size !== undefined && element.size !== 1 ? ` size="${element.size}"` : '';
+            const size = element.size === 1 ? '' : numAttr('size', element.size);
             return [
                 `<tableStyleElement type="${type}"${size} dxfId="${this.differentialStyleId(element)}"/>`,
             ];
@@ -245,189 +232,3 @@ export class StyleRegistry {
         return `<numFmts count="${this.#numFmts.size}">${entries}</numFmts>`;
     }
 }
-function isDefaultFormat(format) {
-    return (format.fillId === 0 &&
-        format.numFmtId === 0 &&
-        format.fontId === 0 &&
-        format.borderId === 0 &&
-        format.alignment === '' &&
-        format.protection === '' &&
-        !format.quotePrefix &&
-        format.xfId === 0);
-}
-function formatSignature(format) {
-    return (`fill:${format.fillId}|numFmt:${format.numFmtId}|font:${format.fontId}|border:${format.borderId}|` +
-        `align:${format.alignment}|protect:${format.protection}|quote:${format.quotePrefix}|xfId:${format.xfId}`);
-}
-function xfXml(format, xfId) {
-    const applyNumberFormat = format.numFmtId !== 0 ? ' applyNumberFormat="1"' : '';
-    const applyFont = format.fontId !== 0 ? ' applyFont="1"' : '';
-    const applyFill = format.fillId !== 0 ? ' applyFill="1"' : '';
-    const applyBorder = format.borderId !== 0 ? ' applyBorder="1"' : '';
-    const applyAlignment = format.alignment !== '' ? ' applyAlignment="1"' : '';
-    const applyProtection = format.protection !== '' ? ' applyProtection="1"' : '';
-    const quotePrefix = format.quotePrefix ? ' quotePrefix="1"' : '';
-    const xfIdAttr = xfId === null ? '' : ` xfId="${xfId}"`;
-    const open = `<xf numFmtId="${format.numFmtId}" fontId="${format.fontId}" fillId="${format.fillId}" ` +
-        `borderId="${format.borderId}"${xfIdAttr}${quotePrefix}` +
-        `${applyNumberFormat}${applyFont}${applyFill}${applyBorder}${applyAlignment}${applyProtection}`;
-    const body = (format.alignment === '' ? '' : `<alignment ${format.alignment}/>`) +
-        (format.protection === '' ? '' : `<protection ${format.protection}/>`);
-    return body === '' ? `${open}/>` : `${open}>${body}</xf>`;
-}
-function cellStyleTag(entry) {
-    const builtin = entry.builtinId === undefined ? '' : ` builtinId="${entry.builtinId}"`;
-    return `<cellStyle name="${escapeAttr(entry.name)}" xfId="${entry.xfId}"${builtin}/>`;
-}
-function alignmentAttrs(alignment) {
-    const parts = [];
-    if (alignment.horizontal !== undefined && alignment.horizontal !== 'general') {
-        parts.push(`horizontal="${checkedToken(alignment.horizontal, isHorizontalAlignment, 'horizontal alignment')}"`);
-    }
-    if (alignment.vertical !== undefined) {
-        parts.push(`vertical="${checkedToken(alignment.vertical, isVerticalAlignment, 'vertical alignment')}"`);
-    }
-    if (alignment.textRotation !== undefined && alignment.textRotation !== 0) {
-        parts.push(`textRotation="${numberText(alignment.textRotation)}"`);
-    }
-    if (alignment.wrapText)
-        parts.push('wrapText="1"');
-    if (alignment.indent !== undefined && alignment.indent !== 0) {
-        parts.push(`indent="${numberText(alignment.indent)}"`);
-    }
-    if (alignment.shrinkToFit)
-        parts.push('shrinkToFit="1"');
-    if (alignment.readingOrder !== undefined && alignment.readingOrder !== 0) {
-        parts.push(`readingOrder="${numberText(alignment.readingOrder)}"`);
-    }
-    return parts.join(' ');
-}
-function protectionAttrs(protection) {
-    const parts = [];
-    if (protection.locked === false)
-        parts.push('locked="0"');
-    if (protection.hidden === true)
-        parts.push('hidden="1"');
-    return parts.join(' ');
-}
-function tableStyleName(fragment) {
-    return decodeEntities(/<tableStyle\b[^>]*\bname="([^"]*)"/.exec(fragment)?.[1] ?? '');
-}
-export function fontXml(font, nameTag = 'name') {
-    const parts = [];
-    if (font.bold)
-        parts.push('<b/>');
-    if (font.italic)
-        parts.push('<i/>');
-    if (font.strike)
-        parts.push('<strike/>');
-    if (font.outline)
-        parts.push('<outline/>');
-    const underline = underlineXml(font.underline);
-    if (underline !== '')
-        parts.push(underline);
-    if (font.vertAlign !== undefined) {
-        parts.push(`<vertAlign val="${checkedToken(font.vertAlign, isFontVerticalAlignment, 'font vertical alignment')}"/>`);
-    }
-    if (font.size !== undefined)
-        parts.push(`<sz val="${numberText(font.size)}"/>`);
-    if (font.color !== undefined)
-        parts.push(`<color ${colorAttrs(font.color)}/>`);
-    if (font.name !== undefined)
-        parts.push(`<${nameTag} val="${escapeAttr(font.name)}"/>`);
-    if (font.family !== undefined)
-        parts.push(`<family val="${numberText(font.family)}"/>`);
-    if (font.charset !== undefined)
-        parts.push(`<charset val="${numberText(font.charset)}"/>`);
-    if (font.scheme !== undefined && font.scheme !== 'none')
-        parts.push(`<scheme val="${checkedToken(font.scheme, isFontScheme, 'font scheme')}"/>`);
-    return parts.join('');
-}
-function dxfXml(style) {
-    const parts = [];
-    if (style.font !== undefined) {
-        const font = fontXml(style.font);
-        if (font !== '')
-            parts.push(`<font>${font}</font>`);
-    }
-    if (typeof style.numFmt === 'string' && style.numFmt !== '') {
-        parts.push(`<numFmt numFmtId="${CUSTOM_NUMFMT_BASE}" formatCode="${escapeFormatCode(style.numFmt)}"/>`);
-    }
-    if (style.fill !== undefined)
-        parts.push(patternFillXml(style.fill, { solidBgFallback: false }));
-    if (style.border !== undefined)
-        parts.push(borderXml(style.border));
-    return `<dxf>${parts.join('')}</dxf>`;
-}
-function gradientFillXml(fill) {
-    const attrs = (fill.gradient === 'path' ? ' type="path"' : '') +
-        (fill.degree ? ` degree="${numberText(fill.degree)}"` : '') +
-        insetAttr('left', fill.left) +
-        insetAttr('right', fill.right) +
-        insetAttr('top', fill.top) +
-        insetAttr('bottom', fill.bottom);
-    const stops = fill.stops
-        .map((stop) => `<stop position="${numberText(stop.position)}"><color ${colorAttrs(stop.color)}/></stop>`)
-        .join('');
-    return `<gradientFill${attrs}>${stops}</gradientFill>`;
-}
-function insetAttr(name, value) {
-    return value ? ` ${name}="${numberText(value)}"` : '';
-}
-function underlineXml(underline) {
-    if (underline === undefined || underline === false || underline === 'none')
-        return '';
-    if (underline === true || underline === 'single')
-        return '<u/>';
-    return `<u val="${checkedToken(underline, isNamedUnderlineStyle, 'underline style')}"/>`;
-}
-function borderXml(border) {
-    const attrs = (border.diagonalUp ? ' diagonalUp="1"' : '') + (border.diagonalDown ? ' diagonalDown="1"' : '');
-    return (`<border${attrs}>` +
-        edgeXml('left', border.left) +
-        edgeXml('right', border.right) +
-        edgeXml('top', border.top) +
-        edgeXml('bottom', border.bottom) +
-        edgeXml('diagonal', border.diagonal) +
-        '</border>');
-}
-function edgeXml(tag, edge) {
-    if (edge === undefined)
-        return `<${tag}/>`;
-    const style = checkedToken(edge.style, isBorderStyle, 'border style');
-    if (edge.color === undefined)
-        return `<${tag} style="${style}"/>`;
-    return `<${tag} style="${style}"><color ${colorAttrs(edge.color)}/></${tag}>`;
-}
-function escapeFormatCode(code) {
-    assertRepresentable(code);
-    return code
-        .replace(/&/g, '&amp;')
-        .replace(/</g, '&lt;')
-        .replace(/>/g, '&gt;')
-        .replace(/"/g, '&quot;');
-}
-function fillSignature(fill) {
-    if (fill.type === 'gradient') {
-        const stops = fill.stops.map((s) => `${s.position}:${colorSignature(s.color)}`).join(',');
-        return `grad|${fill.gradient}|${fill.degree ?? ''}|${fill.left ?? ''}/${fill.right ?? ''}/${fill.top ?? ''}/${fill.bottom ?? ''}|${stops}`;
-    }
-    return `${fill.pattern}|${colorSignature(fill.fgColor)}|${colorSignature(fill.bgColor)}`;
-}
-function colorSignature(color) {
-    if (color === undefined)
-        return '';
-    return `${color.argb ?? ''}/${color.theme ?? ''}/${color.tint ?? ''}/${color.indexed ?? ''}`;
-}
-function patternFillXml(fill, { solidBgFallback }) {
-    if (fill.type === 'gradient')
-        return `<fill>${gradientFillXml(fill)}</fill>`;
-    const fg = fill.fgColor ? `<fgColor ${colorAttrs(fill.fgColor)}/>` : '';
-    const bg = fill.bgColor
-        ? `<bgColor ${colorAttrs(fill.bgColor)}/>`
-        : solidBgFallback && fill.pattern === 'solid'
-            ? '<bgColor indexed="64"/>'
-            : '';
-    const pattern = checkedToken(fill.pattern, isFillPatternType, 'fill pattern');
-    return `<fill><patternFill patternType="${pattern}">${fg}${bg}</patternFill></fill>`;
-}

package/dist/io/xlsx/tables.js

@@ -1,22 +1,17 @@
-import { encodeAddress, tryDecodeRange } from '../../core/address.js';
+import { encodeAddress, MAX_COLUMN, tryDecodeRange } from '../../core/address.js';
 import { isTotalsRowFunction, } from '../../core/table.js';
-import { boolPresent, localName, numInteger, parseXml, TextCapture } from '../../xml/xml-read.js';
-import { boolAttr, escapeAttr, escapeText, XML_DECLARATION } from '../../xml/xml.js';
+import { numInteger } from '../../xml/xml-attrs.js';
+import { parseXml, TextCapture } from '../../xml/xml-read.js';
+import { boolPresent, localName } from '../../xml/xml-scan.js';
+import { boolAttr, checkedToken, escapeAttr, escapeText, XML_DECLARATION } from '../../xml/xml.js';
 import { NS } from './relationships.js';
 export function tableXml(table, id) {
     const name = escapeAttr(table.name);
     const displayName = escapeAttr(table.displayName);
     const headerRowCount = table.headerRow ? '' : ' headerRowCount="0"';
-    let totals;
-    if (table.totalsRow) {
-        totals = ' totalsRowCount="1"';
-    }
-    else if (table.totalsRowShown !== undefined) {
-        totals = ` totalsRowShown="${table.totalsRowShown ? '1' : '0'}"`;
-    }
-    else {
-        totals = '';
-    }
+    const totals = table.totalsRow
+        ? ' totalsRowCount="1"'
+        : boolAttr('totalsRowShown', table.totalsRowShown);
     const autoFilter = table.autoFilterRef !== undefined ? `<autoFilter ref="${table.autoFilterRef}"/>` : '';
     const columns = table.columns.map((column, i) => tableColumnXml(column, i + 1)).join('');
     return (XML_DECLARATION +
@@ -48,7 +43,7 @@ function tableColumnXml(column, id) {
         attrs += ` totalsRowLabel="${escapeAttr(column.totalsRowLabel)}"`;
     }
     if (column.totalsRowFunction !== undefined) {
-        attrs += ` totalsRowFunction="${escapeAttr(column.totalsRowFunction)}"`;
+        attrs += ` totalsRowFunction="${checkedToken(column.totalsRowFunction, isTotalsRowFunction, 'totals row function')}"`;
     }
     if (column.totalsRowFormula !== undefined) {
         return `<tableColumn ${attrs}><totalsRowFormula>${escapeText(column.totalsRowFormula)}</totalsRowFormula></tableColumn>`;
@@ -135,6 +130,8 @@ export function parseTable(xml) {
     const { top, left, bottom } = decoded;
     if (top === undefined || left === undefined || bottom === undefined)
         return undefined;
+    if (left + columns.length - 1 > MAX_COLUMN)
+        return undefined;
     const headerRow = headerRowCount !== 0;
     const totalsRow = totalsRowCount > 0;
     const dataRows = bottom - top + 1 - (headerRow ? 1 : 0) - (totalsRow ? 1 : 0);

package/dist/io/xlsx/theme-xml.d.ts

@@ -1,16 +1,29 @@
-import { type ThemeColorScheme, type ThemeFontScheme, type ThemeOverrides } from '../../core/theme.ts';
+import type { AssertNever } from '../../core/internal.ts';
+import { type ThemeColorScheme, type ThemeColorSlot, type ThemeFontScheme, type ThemeOverrides } from '../../core/theme.ts';
 /**
  * Extract the colour scheme from a theme part. Returns only the slots the part actually declares in a
  * colour model this reader understands; an unrecognised one is dropped rather than guessed at, so a
  * caller can tell "the theme says nothing here" from "the theme says black".
  *
- * Reads the `<a:clrScheme>` block alone. A theme carries a font scheme and a format scheme too, but
- * neither participates in resolving a colour, and scanning the whole part would let a `<a:srgbClr>`
+ * Reads the `<clrScheme>` block alone. A theme carries a font scheme and a format scheme too, but
+ * neither participates in resolving a colour, and scanning the whole part would let an `<srgbClr>`
  * buried in a gradient stop masquerade as a scheme slot.
  */
 export declare function parseThemeColorScheme(themeXml: string): ThemeColorScheme;
-/** Extract the major/minor latin typefaces from a theme part's `<a:fontScheme>`. */
+/** Extract the major/minor latin typefaces from a theme part's `<fontScheme>`. */
 export declare function parseThemeFontScheme(themeXml: string): ThemeFontScheme;
+declare const SCHEME_ELEMENT_ORDER: readonly ["dk1", "lt1", "dk2", "lt2", "accent1", "accent2", "accent3", "accent4", "accent5", "accent6", "hlink", "folHlink"];
+/**
+ * The half of the proof the list above owes: `satisfies` covers "no invented slot", this covers "no
+ * omission". A slot missing here is not a slot written in the wrong place -- it is a slot dropped
+ * from every rewritten `<a:clrScheme>`, verbatim source element and all, so a caller who authored it
+ * gets back a theme that silently does not carry it.
+ *
+ * This is the one list in the library where the schema order and the index order differ, which makes
+ * it the one a new slot is least likely to be added to by hand. `DEFAULT_THEME_COLOR_SCHEME` proves
+ * the same completeness on the model side.
+ */
+export type EverySlotIsInSchemaOrder = AssertNever<Exclude<ThemeColorSlot, (typeof SCHEME_ELEMENT_ORDER)[number]>>;
 /**
  * Apply authored colour/font overrides to a theme part, returning the new part text.
  *
@@ -24,6 +37,14 @@ export declare function parseThemeFontScheme(themeXml: string): ThemeFontScheme;
  * its value. That matters for `dk1`/`lt1`, which Excel writes as `<a:sysClr val="windowText"
  * lastClr="000000"/>`: rewriting those as `<a:srgbClr>` would pin them to one machine's resolved
  * window colours and break dark-mode following.
+ *
+ * The edit is made by *offset*, not by pattern. What it replaces was three container-scanning regular
+ * expressions in the one file whose own header condemns that pattern, on a path a preserved source
+ * theme's bytes reach: `[\s\S]*?` terminated on a `</clrScheme>` inside a comment, `[^>]*` missed a
+ * `<latin typeface="X"></latin>` and dropped the override silently, and the DrawingML prefix -- read
+ * out of the part's own root element, where an NCName may legally contain `.` and `-` -- was
+ * interpolated into the pattern unescaped. {@link elementRange} answers the same question with the
+ * scanner, and splicing at its offsets is what makes an unoverridden part come back byte for byte.
  */
 export declare function applyThemeOverrides(baseXml: string, overrides: ThemeOverrides): string;
 /**
@@ -35,3 +56,4 @@ export declare function applyThemeOverrides(baseXml: string, overrides: ThemeOve
  * built from scratch rather than read from a file.
  */
 export declare const DEFAULT_THEME_XML: string;
+export {};