@shbernal/ts-xlsx 3.1.0 → 3.2.0

package/dist/io/xlsx/read.js

@@ -3,20 +3,19 @@ import { Workbook } from '../../core/workbook.js';
 import { parseXmlPasses } from '../../xml/xml-read.js';
 import { UnsupportedFormatError } from '../opc/errors.js';
 import { contentTypeResolver, openSpreadsheetPackage, readPartRelationships, } from '../opc/read-opc.js';
+import { admitArrayRanges, admitting, repairedSheetNames } from '../read-policy/read-repair.js';
 import { readXlsbPackage } from '../xlsb/read.js';
-import { applyNotes } from './comments.js';
-import { conditionalFormattingPass } from './conditional-formatting.js';
+import { readCellMetadata } from './cell-metadata.js';
+import { applyConditionalFormattings, conditionalFormattingPass } from './conditional-formatting.js';
 import { applyDataValidations, dataValidationPass, extendedDataValidationPass, } from './data-validation.js';
 import { applyHyperlinks, sheetHyperlinkPass } from './hyperlinks.js';
 import { SHARED_STRINGS_PART, STYLES_PART } from './part-names.js';
+import { applyNotes } from './read-comments.js';
 import { readRootPreservedReferences, readSheetBackground, readSheetComments, readSheetCommentThreads, readSheetImages, readSheetPivotTables, readSheetPreservedReferences, readSheetPrinterSettings, readSheetTables, readWorkbookPersons, externalReferenceRegistrationsPass, pivotCacheRegistrationsPass, readWorkbookPreservedReferences, readWorkbookTheme, worksheetReferencePass, } from './read-parts.js';
-import { admitting, repairSheetName } from './read-repair.js';
 import { parseSharedStrings } from './read-shared-strings.js';
 import { parseStyleTable } from './read-styles.js';
 import { applyAppProperties, applyCoreProperties, definedNamesPass, workbookPropertiesPass, workbookProtectionPass, workbookSheetsPass, workbookViewPass, } from './read-workbook-xml.js';
 import { worksheetPass } from './read-worksheet.js';
-export { parseStyleTable } from './read-styles.js';
-export { workbookPropertiesPass, workbookSheetsPass, workbookViewPass, } from './read-workbook-xml.js';
 export function readXlsx(data, options = {}) {
     const { files, pkg, documentPath, workbookXml } = openSpreadsheetPackage(data, options.maxUncompressedBytes);
     const { partText, partBytes } = pkg;
@@ -37,6 +36,7 @@ export function readXlsx(data, options = {}) {
         contentTypeOf,
         sharedStrings,
         xfStyles,
+        cellMetadata: readCellMetadata(workbookRels),
         imageIdByMediaPath: new Map(),
     };
     workbook[INTERNAL].restoreDifferentialStyles([...preserved.dxfs]);
@@ -69,14 +69,13 @@ export function readXlsx(data, options = {}) {
     ]);
     workbook.protection = protection.result();
     readWorkbookPersons(context, workbookRels);
+    const sheetContext = { ...context, definedNames: definedNames.spellings() };
     const sheetOrder = [];
-    const takenSheetNames = new Set();
-    for (const { name, relId, state } of sheets.result()) {
+    for (const { name, relId, state } of repairedSheetNames(sheets.result())) {
         const target = workbookRels.byId(relId)?.target;
-        const sheet = workbook.addWorksheet(repairSheetName(name, takenSheetNames), state === undefined ? undefined : { state });
-        takenSheetNames.add(sheet.name.toLowerCase());
+        const sheet = workbook.addWorksheet(name, state === undefined ? undefined : { state });
         sheetOrder.push(sheet.name);
-        readSheet(sheet, target === undefined ? undefined : workbookRels.pathOf(target), context);
+        readSheet(sheet, target === undefined ? undefined : workbookRels.pathOf(target), sheetContext);
     }
     readWorkbookPreservedReferences(context, workbookRels, {
         cacheIdByRelId: pivotCaches.result(),
@@ -91,23 +90,24 @@ export function readXlsx(data, options = {}) {
     return workbook;
 }
 function readSheet(sheet, path, context) {
-    const { pkg, workbook, sharedStrings, xfStyles } = context;
+    const { pkg, workbook, sharedStrings, xfStyles, definedNames, cellMetadata } = context;
     const { partText } = pkg;
     const sheetXml = path === undefined ? undefined : partText(path);
     const hyperlinks = sheetHyperlinkPass();
-    const validations = dataValidationPass();
-    const extendedValidations = extendedDataValidationPass();
-    const formattings = conditionalFormattingPass();
+    const validations = dataValidationPass(definedNames);
+    const extendedValidations = extendedDataValidationPass(definedNames);
+    const formattings = conditionalFormattingPass(definedNames, (fragment) => workbook[INTERNAL].adoptDifferentialStyle(fragment));
     const references = worksheetReferencePass();
     if (sheetXml !== undefined) {
         parseXmlPasses(sheetXml, [
-            worksheetPass(sheet, sharedStrings, xfStyles, workbook.dateEpoch),
+            worksheetPass(sheet, sharedStrings, xfStyles, workbook.dateEpoch, definedNames, cellMetadata),
             hyperlinks,
             validations,
             extendedValidations,
             formattings,
             references,
         ]);
+        admitArrayRanges(sheet);
     }
     if (path === undefined)
         return;
@@ -115,11 +115,7 @@ function readSheet(sheet, path, context) {
     if (sheetXml !== undefined) {
         applyHyperlinks(sheet, hyperlinks.result(), (id) => sheetRels.byId(id)?.target);
         applyDataValidations(sheet, [...validations.result(), ...extendedValidations.result()]);
-        for (const cf of formattings.result()) {
-            admitting(() => {
-                sheet.addConditionalFormatting(cf);
-            });
-        }
+        applyConditionalFormattings(sheet, formattings.result());
     }
     const threads = readSheetCommentThreads(context, sheetRels);
     if (threads.length > 0)
@@ -132,7 +128,7 @@ function readSheet(sheet, path, context) {
     if (sheetXml !== undefined) {
         readSheetPreservedReferences(context, sheetRels, references.result(), sheet);
     }
-    readSheetTables(context, sheetRels, sheet);
+    readSheetTables(context, sheetRels, sheet, definedNames);
     readSheetPivotTables(context, sheetRels, sheet);
     const printerSettings = readSheetPrinterSettings(sheetRels);
     if (printerSettings !== undefined)

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

@@ -28,6 +28,9 @@ export declare const REL: {
     readonly pivotTable: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotTable";
     readonly pivotCacheDefinition: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheDefinition";
     readonly pivotCacheRecords: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/pivotCacheRecords";
+    readonly sheetMetadata: "http://schemas.openxmlformats.org/officeDocument/2006/relationships/sheetMetadata";
+    readonly rdRichValue: "http://schemas.microsoft.com/office/2017/06/relationships/rdRichValue";
+    readonly rdRichValueStructure: "http://schemas.microsoft.com/office/2017/06/relationships/rdRichValueStructure";
     readonly threadedComment: "http://schemas.microsoft.com/office/2017/10/relationships/threadedComment";
     readonly person: "http://schemas.microsoft.com/office/2017/10/relationships/person";
 };

package/dist/io/xlsx/relationships.js

@@ -13,6 +13,7 @@ export const NS = {
     xsi: 'http://www.w3.org/2001/XMLSchema-instance',
 };
 const MS_OFFICE_2017_RELS_NS = 'http://schemas.microsoft.com/office/2017/10/relationships';
+const RICH_DATA_RELS_NS = 'http://schemas.microsoft.com/office/2017/06/relationships';
 export const REL = {
     worksheet: `${NS.docRels}/worksheet`,
     styles: `${NS.docRels}/styles`,
@@ -31,6 +32,9 @@ export const REL = {
     pivotTable: `${NS.docRels}/pivotTable`,
     pivotCacheDefinition: `${NS.docRels}/pivotCacheDefinition`,
     pivotCacheRecords: `${NS.docRels}/pivotCacheRecords`,
+    sheetMetadata: `${NS.docRels}/sheetMetadata`,
+    rdRichValue: `${RICH_DATA_RELS_NS}/rdRichValue`,
+    rdRichValueStructure: `${RICH_DATA_RELS_NS}/rdRichValueStructure`,
     threadedComment: `${MS_OFFICE_2017_RELS_NS}/threadedComment`,
     person: `${MS_OFFICE_2017_RELS_NS}/person`,
 };

package/dist/io/xlsx/row-position.d.ts

@@ -6,7 +6,9 @@ export interface RowPosition {
     /**
      * Whether that number names a row the grid has. A row past the ceiling is dropped whole by both
      * readers rather than clamped: an `r` names one row, so there is nothing to fold it onto, and
-     * clamping would silently move its formatting to the last row of the sheet.
+     * clamping would silently move its formatting to the last row of the sheet. Its cells go with it,
+     * even one whose own `r` is in the grid, because `CellAccumulator` places no cell outside an
+     * in-grid row.
      */
     readonly inGrid: boolean;
 }

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

@@ -1,8 +1,9 @@
+import type { FormulaPlacement } from '../../core/array-formula-ranges.ts';
 import { type Cell } from '../../core/cell.ts';
 import { type DateEpoch } from '../../core/date.ts';
 import type { ColumnProperties, RowProperties, Worksheet } from '../../core/worksheet.ts';
+import type { WorkbookMetadataTable } from './cell-metadata.ts';
 import type { CommentCell } from './comments.ts';
-import type { CollectedHyperlink } from './hyperlinks.ts';
 import type { SharedFormulaRole } from './shared-formulas.ts';
 import type { SharedStringTable } from './shared-strings.ts';
 import type { StyleRegistry } from './styles.ts';
@@ -63,14 +64,18 @@ export interface FlushedSheet {
         readonly hidden: boolean;
     }>;
     /**
-     * The hyperlinks and notes the flushed rows carried, on the same terms and for the same reason.
-     * Both are serialised outside the `<row>`: a hyperlink into the sheet's `<hyperlinks>` element plus
-     * an external relationship, a note into the comments and VML parts. The buffered pass gathers them
-     * by walking the sheet's rows at commit time, which finds nothing on a row whose cells have already
-     * been evicted, so a streamed row's link kept its visible label and silently lost its destination.
+     * The notes the flushed rows carried, on the same terms and for the same reason. A note is
+     * serialised outside the `<row>`, into the comments and VML parts, and the buffered pass gathers
+     * notes by walking the sheet's rows at commit time, which finds nothing on a row whose cells have
+     * already been evicted. A hyperlink needs no such record: it lives beside the grid, on the sheet.
      */
-    readonly hyperlinks: readonly CollectedHyperlink[];
     readonly notes: readonly CommentCell[];
+    /**
+     * The formulas the flushed rows carried, on the same terms again: whether an array formula's range
+     * holds another formula, or shares a cell with another's, is a question about other rows, and the
+     * writer asks it of the whole sheet at commit.
+     */
+    readonly formulas: readonly FormulaPlacement[];
 }
 /**
  * A column's style facets are defaults its cells inherit unless they override them; the writer
@@ -91,6 +96,12 @@ export interface RowRenderContext {
     readonly collapsedSummaries: ReadonlySet<number>;
     /** The workbook's date system, which is what a `Date` cell's serial counts from. */
     readonly dateEpoch: DateEpoch;
+    /** The defined names a bare name in this sheet's formulas resolves to, as `formulaNamesInScope`
+     * gives them: a function passed as a value is written bare where one of them captures its name. */
+    readonly formulaNames: ReadonlySet<string>;
+    /** The workbook's metadata, which a dynamic-array formula's cell and a rich-value error's cell point
+     * into. Shared by every row of every sheet, since the parts it becomes are the workbook's. */
+    readonly cellMetadata: WorkbookMetadataTable;
 }
 /**
  * Serialise one row to its `<row>` element, or '' when the row has neither data nor its own

package/dist/io/xlsx/row-xml.js

@@ -1,11 +1,12 @@
+import { encodeRange, tryDecodeAnchoredRange } from '../../core/address.js';
 import { cellHasOwnStyle } from '../../core/cell.js';
 import { DEFAULT_DATE_NUMFMT, dateToSerial } from '../../core/date.js';
 import { mangleFormula } from '../../core/formula.js';
 import { NAMED_STYLE_ID } from '../../core/internal.js';
 import { CELL_STYLE_FACETS } from '../../core/style.js';
-import { detectValueType, isDataTableFormulaValue, isErrorValue, isFormulaValue, isHyperlinkValue, isRichTextValue, isSharedFormulaValue, } from '../../core/value.js';
-import { AuthoringError, InternalError } from '../../errors.js';
-import { boolAttr, escapeAttr, escapeSpreadsheetText, escapeText, numberText, textAttr, textElement, } from '../../xml/xml.js';
+import { detectValueType, isArrayFormulaValue, isDataTableFormulaValue, isErrorCode, isErrorValue, isFormulaValue, isRichTextValue, isSharedFormulaValue, } from '../../core/value.js';
+import { AuthoringError, InternalError, quoted } from '../../errors.js';
+import { boolAttr, checkedToken, escapeAttr, escapeSpreadsheetText, escapeText, numberText, nonDefaultNumAttr, textAttr, textElement, } from '../../xml/xml.js';
 import { richTextRunsXml } from './rich-text.js';
 export class Extent {
     top = Infinity;
@@ -53,7 +54,7 @@ export function renderRow(entry, ctx) {
     const cellsXml = rendered
         .map((cell) => {
         const style = ctx.styles.styleId(composeCellStyle(cell, rowFill, ctx.columnDefaults.get(cell.col)));
-        return cellXml(cell, style, ctx.sharedRoles.get(cell.address), ctx.sharedStrings, ctx.dateEpoch);
+        return cellXml(cell, style, ctx.sharedRoles.get(cell.address), ctx);
     })
         .join('');
     let minCol = Infinity;
@@ -104,18 +105,19 @@ function rowAttrs(properties, styles, collapsedSummary) {
 function dateDefaultNumFmt(value) {
     const date = value instanceof Date
         ? value
-        : (isFormulaValue(value) || isSharedFormulaValue(value)) && value.result instanceof Date
+        : (isFormulaValue(value) || isSharedFormulaValue(value) || isArrayFormulaValue(value)) &&
+            value.result instanceof Date
             ? value.result
             : undefined;
     return date !== undefined && !Number.isNaN(date.getTime()) ? DEFAULT_DATE_NUMFMT : undefined;
 }
-function cellElement(ref, s, type, body) {
-    const t = type === '' ? '' : ` t="${type}"`;
-    return body === '' ? `<c r="${ref}"${s}${t}/>` : `<c r="${ref}"${s}${t}>${body}</c>`;
+function cellElement(ref, s, type, body, cm = '', vm = '') {
+    const attrs = `${s}${type === '' ? '' : ` t="${type}"`}${cm}${vm}`;
+    return body === '' ? `<c r="${ref}"${attrs}/>` : `<c r="${ref}"${attrs}>${body}</c>`;
 }
 const UNWRITABLE = { type: '', v: null };
 const vElement = (v) => (v === null ? '' : `<v>${v}</v>`);
-function valueBody(value, epoch) {
+function valueBody(value, ctx) {
     if (typeof value === 'number') {
         return Number.isFinite(value) ? { type: '', v: numberText(value) } : UNWRITABLE;
     }
@@ -124,22 +126,28 @@ function valueBody(value, epoch) {
     if (value instanceof Date) {
         return Number.isNaN(value.getTime())
             ? UNWRITABLE
-            : { type: '', v: numberText(dateToSerial(value, epoch)) };
+            : { type: '', v: numberText(dateToSerial(value, ctx.dateEpoch)) };
+    }
+    if (isErrorValue(value)) {
+        checkedToken(value.error, isErrorCode, 'cell error value');
+        const vm = ctx.cellMetadata.markRichValueError(value.error);
+        return vm === undefined
+            ? { type: 'e', v: value.error }
+            : { type: 'e', v: '#VALUE!', vm: ` vm="${vm}"` };
     }
-    if (isErrorValue(value))
-        return { type: 'e', v: value.error };
     return undefined;
 }
-function cellXml(cell, style, shared, sharedStrings, epoch) {
+function cellXml(cell, style, shared, ctx) {
+    const { sharedStrings } = ctx;
     const ref = cell.address;
     const value = cell.value;
     const s = style !== 0 ? ` s="${style}"` : '';
-    const formula = cellFormulaXml(ref, s, value, shared, epoch);
+    const formula = cellFormulaXml(cell, s, shared, ctx);
     if (formula !== undefined)
         return formula;
-    const body = valueBody(value, epoch);
+    const body = valueBody(value, ctx);
     if (body !== undefined)
-        return cellElement(ref, s, body.type, vElement(body.v));
+        return cellElement(ref, s, body.type, vElement(body.v), '', body.vm);
     if (typeof value === 'string' || isRichTextValue(value)) {
         if (sharedStrings !== null) {
             return cellElement(ref, s, 's', vElement(`${sharedStrings.intern(value)}`));
@@ -147,46 +155,57 @@ function cellXml(cell, style, shared, sharedStrings, epoch) {
         const inline = typeof value === 'string' ? textElement(value) : richTextRunsXml(value.richText);
         return cellElement(ref, s, 'inlineStr', `<is>${inline}</is>`);
     }
-    if (isHyperlinkValue(value)) {
-        const label = typeof value.text === 'string'
-            ? textElement(value.text)
-            : richTextRunsXml(value.text.richText);
-        return cellElement(ref, s, 'inlineStr', `<is>${label}</is>`);
-    }
     if (value === null)
         return cellElement(ref, s, '', '');
     throw new InternalError(`writing a ${detectValueType(value)} cell value has no arm: every CellValue kind is handled above`);
 }
-function cellFormulaXml(ref, s, value, shared, epoch) {
+function cellFormulaXml(cell, s, shared, ctx) {
+    const { formulaNames } = ctx;
+    const { address: ref, value } = cell;
     if (shared !== undefined) {
         if (shared.ref !== undefined && isFormulaValue(value)) {
-            const f = `<f t="shared" ref="${shared.ref}" si="${shared.si}">${escapeText(mangleFormula(value.formula))}</f>`;
-            return formulaBodyXml(ref, s, f, value.result, epoch);
+            const f = `<f t="shared" ref="${shared.ref}" si="${shared.si}">${escapeText(mangleFormula(value.formula, formulaNames))}</f>`;
+            return formulaBodyXml(ref, s, f, value.result, ctx);
         }
         const result = isSharedFormulaValue(value) ? value.result : undefined;
-        return formulaBodyXml(ref, s, `<f t="shared" si="${shared.si}"/>`, result, epoch);
+        return formulaBodyXml(ref, s, `<f t="shared" si="${shared.si}"/>`, result, ctx);
     }
     if (isDataTableFormulaValue(value)) {
         const attrs = `ref="${escapeAttr(value.ref)}"` +
             boolAttr('dt2D', value.dataTable2D) +
             boolAttr('dtr', value.dataTableRow) +
+            (value.r1Deleted === true ? ' del1="1"' : '') +
+            (value.r2Deleted === true ? ' del2="1"' : '') +
             textAttr('r1', value.r1) +
             textAttr('r2', value.r2);
-        return formulaBodyXml(ref, s, `<f t="dataTable" ${attrs}/>`, value.result, epoch);
+        return formulaBodyXml(ref, s, `<f t="dataTable" ${attrs}/>`, value.result, ctx);
+    }
+    if (isArrayFormulaValue(value)) {
+        const cm = value.dynamic === true ? ` cm="${ctx.cellMetadata.markDynamicArray()}"` : '';
+        const f = `<f t="array" ref="${arrayFormulaRange(cell, value.ref)}">${escapeText(mangleFormula(value.formula, formulaNames))}</f>`;
+        return formulaBodyXml(ref, s, f, value.result, ctx, cm);
     }
     if (isFormulaValue(value)) {
-        return formulaBodyXml(ref, s, `<f>${escapeText(mangleFormula(value.formula))}</f>`, value.result, epoch);
+        return formulaBodyXml(ref, s, `<f>${escapeText(mangleFormula(value.formula, formulaNames))}</f>`, value.result, ctx);
     }
     return undefined;
 }
-function formulaBodyXml(ref, s, f, result, epoch) {
+function arrayFormulaRange(cell, ref) {
+    const range = tryDecodeAnchoredRange(ref, cell.col, cell.row);
+    if (range === undefined) {
+        throw new AuthoringError(`the array formula in ${cell.address} fills ${quoted(ref)}, which is not a range starting at ${cell.address}`);
+    }
+    return encodeRange(range);
+}
+function formulaBodyXml(ref, s, f, result, ctx, cm = '') {
     if (result === undefined)
-        return cellElement(ref, s, '', f);
-    const body = valueBody(result, epoch);
-    if (body !== undefined)
-        return cellElement(ref, s, body.type, f + vElement(body.v));
+        return cellElement(ref, s, '', f, cm);
+    const body = valueBody(result, ctx);
+    if (body !== undefined) {
+        return cellElement(ref, s, body.type, f + vElement(body.v), cm, body.vm);
+    }
     if (typeof result === 'string') {
-        return cellElement(ref, s, 'str', f + vElement(escapeSpreadsheetText(result)));
+        return cellElement(ref, s, 'str', f + vElement(escapeSpreadsheetText(result)), cm);
     }
     throw new InternalError('writing a non-primitive formula result has no arm: every FormulaResult kind is handled above');
 }
@@ -199,5 +218,5 @@ export function outlineAttr(name, level) {
     if (level === undefined)
         return '';
     assertWritableLevel(name, level);
-    return level > 0 ? ` ${name}="${numberText(level)}"` : '';
+    return nonDefaultNumAttr(name, level, 0);
 }

package/dist/io/xlsx/sheet-properties.js

@@ -1,19 +1,22 @@
-import { encodeAddress } from '../../core/address.js';
+import { encodeAddress, MAX_COLUMN, MAX_ROW } from '../../core/address.js';
 import { isCustomFilterOperator, } from '../../core/autofilter.js';
 import { HEADER_FOOTER_ELEMENTS, MARGIN_SIDES, PAGE_SETUP_FACETS, PRINT_OPTION_FLAGS, } from '../../core/page-setup.js';
-import { SHEET_PROTECTION_FLAGS, } from '../../core/protection.js';
+import { isLegacyPasswordHash, SHEET_PROTECTION_FLAGS, } from '../../core/protection.js';
+import { assertWritableNumber, AuthoringError } from '../../errors.js';
 import { numFinite, numInteger } from '../../xml/xml-attrs.js';
-import { boolPresent, boolStrict, boolTristate } from '../../xml/xml-scan.js';
+import { boolStrict, boolTristate } from '../../xml/xml-scan.js';
 import { boolAttr, checkedToken, escapeAttr, escapeSpreadsheetText, numAttr, numberText, } from '../../xml/xml.js';
 import { colorAttrs, parseColor } from './color-xml.js';
 export function sheetViewsXml(view, active) {
     const selected = active ? ' tabSelected="1"' : '';
     const gridLines = view.showGridLines === false ? ' showGridLines="0"' : '';
-    const xSplit = view.xSplit ?? 0;
-    const ySplit = view.ySplit ?? 0;
-    if (view.state !== 'frozen' || (xSplit === 0 && ySplit === 0)) {
-        return `<sheetViews><sheetView${gridLines}${selected} workbookViewId="0"/></sheetViews>`;
-    }
+    const normal = `<sheetViews><sheetView${gridLines}${selected} workbookViewId="0"/></sheetViews>`;
+    if (view.state !== 'frozen')
+        return normal;
+    const xSplit = frozenSplit('xSplit', view.xSplit, MAX_COLUMN);
+    const ySplit = frozenSplit('ySplit', view.ySplit, MAX_ROW);
+    if (xSplit === 0 && ySplit === 0)
+        return normal;
     const topLeftCell = view.topLeftCell ?? encodeAddress(xSplit + 1, ySplit + 1);
     const activePane = xSplit > 0 && ySplit > 0 ? 'bottomRight' : xSplit > 0 ? 'topRight' : 'bottomLeft';
     const pane = '<pane' +
@@ -23,6 +26,15 @@ export function sheetViewsXml(view, active) {
     const selection = `<selection pane="${activePane}" activeCell="${escapeAttr(topLeftCell)}" sqref="${escapeAttr(topLeftCell)}"/>`;
     return `<sheetViews><sheetView${gridLines}${selected} workbookViewId="0">${pane}${selection}</sheetView></sheetViews>`;
 }
+function frozenSplit(name, value, lines) {
+    if (value === undefined)
+        return 0;
+    assertWritableNumber(value);
+    if (!Number.isInteger(value) || value < 0 || value >= lines) {
+        throw new AuthoringError(`cannot write ${name}="${value}": a frozen split is a whole count from 0 to ${lines - 1}`);
+    }
+    return value;
+}
 export function sheetPrXml(sheet) {
     const attrs = sheet.codeName === undefined ? '' : ` codeName="${escapeAttr(sheet.codeName)}"`;
     const children = (sheet.tabColor !== undefined ? `<tabColor ${colorAttrs(sheet.tabColor)}/>` : '') +
@@ -42,8 +54,11 @@ function outlinePrXml(outline) {
 export function sheetProtectionXml(protection) {
     if (protection === undefined)
         return '';
-    const { flags, credential } = protection;
+    const { flags, credential, legacyPasswordHash } = protection;
     let attrs = '';
+    if (legacyPasswordHash !== undefined) {
+        attrs += ` password="${checkedToken(legacyPasswordHash, isLegacyPasswordHash, 'legacy sheet password hash')}"`;
+    }
     if (credential !== undefined) {
         attrs +=
             ` algorithmName="${escapeAttr(credential.algorithmName)}"` +
@@ -143,15 +158,15 @@ export function pageSetupXml(pageSetup, printerSettingsRelId) {
 export function pageBreaksXml(breaks, element) {
     if (breaks.length === 0)
         return '';
+    const manual = breaks.filter((brk) => brk.man !== false).length;
     const brks = breaks
-        .map((brk) => {
-        return `<brk${numAttr('id', brk.id)}${numAttr('max', brk.max)} man="1"/>`;
-    })
+        .map((brk) => `<brk${numAttr('id', brk.id)}${numAttr('min', brk.min)}${numAttr('max', brk.max)}` +
+        `${brk.man === false ? '' : ' man="1"'}/>`)
         .join('');
-    return `<${element} count="${breaks.length}" manualBreakCount="${breaks.length}">${brks}</${element}>`;
+    return `<${element} count="${breaks.length}" manualBreakCount="${manual}">${brks}</${element}>`;
 }
 export function parseSheetProtection(attrs) {
-    if (boolTristate(attrs.sheet) === false)
+    if (!boolStrict(attrs.sheet))
         return undefined;
     const flags = {};
     for (const { key } of SHEET_PROTECTION_FLAGS) {
@@ -171,9 +186,14 @@ export function parseSheetProtection(attrs) {
             saltValue,
             spinCount: spin,
         };
-        return { flags, credential };
+        return { flags, credential, ...legacyHash(attrs.password) };
     }
-    return { flags };
+    return { flags, ...legacyHash(attrs.password) };
+}
+function legacyHash(password) {
+    return password !== undefined && isLegacyPasswordHash(password)
+        ? { legacyPasswordHash: password }
+        : {};
 }
 export class PageBreakAccumulator {
     #target = null;
@@ -189,12 +209,16 @@ export class PageBreakAccumulator {
         const id = numInteger(attrs.id, 1);
         if (id === undefined)
             return;
-        const brk = { id };
+        const brk = {
+            id,
+            man: boolStrict(attrs.man),
+        };
+        const min = numInteger(attrs.min, 0);
+        if (min !== undefined)
+            brk.min = min;
         const max = numInteger(attrs.max, 0);
         if (max !== undefined)
             brk.max = max;
-        if (boolStrict(attrs.man))
-            brk.man = true;
         this.#target.push(brk);
     }
 }
@@ -208,13 +232,14 @@ export function applySheetProperties(local, attrs, sheet) {
             sheet.tabColor = parseColor(attrs);
             break;
         case 'outlinePr':
-            if (attrs.summaryBelow !== undefined)
-                sheet.outline.summaryBelow = boolPresent(attrs.summaryBelow);
-            if (attrs.summaryRight !== undefined)
-                sheet.outline.summaryRight = boolPresent(attrs.summaryRight);
+            for (const flag of ['summaryBelow', 'summaryRight']) {
+                const value = boolTristate(attrs[flag]);
+                if (value !== undefined)
+                    sheet.outline[flag] = value;
+            }
             break;
         case 'sheetView':
-            if (attrs.showGridLines !== undefined && !boolPresent(attrs.showGridLines)) {
+            if (boolTristate(attrs.showGridLines) === false) {
                 sheet.view.showGridLines = false;
             }
             break;
@@ -223,17 +248,18 @@ export function applySheetProperties(local, attrs, sheet) {
                 sheet.view.state = 'frozen';
                 const xSplit = numInteger(attrs.xSplit, 0);
                 const ySplit = numInteger(attrs.ySplit, 0);
-                if (xSplit !== undefined)
+                if (xSplit !== undefined && xSplit < MAX_COLUMN)
                     sheet.view.xSplit = xSplit;
-                if (ySplit !== undefined)
+                if (ySplit !== undefined && ySplit < MAX_ROW)
                     sheet.view.ySplit = ySplit;
                 if (attrs.topLeftCell !== undefined)
                     sheet.view.topLeftCell = attrs.topLeftCell;
             }
             break;
         case 'pageSetUpPr':
-            if (attrs.fitToPage !== undefined)
-                sheet.pageSetup.fitToPage = boolPresent(attrs.fitToPage);
+            if (boolTristate(attrs.fitToPage) !== undefined) {
+                sheet.pageSetup.fitToPage = boolStrict(attrs.fitToPage);
+            }
             break;
         case 'printOptions':
             applyPrintOptions(sheet.printOptions, attrs);
@@ -263,20 +289,20 @@ function applyMargins(margins, attrs) {
 function applyPageSetup(pageSetup, attrs) {
     for (const facet of PAGE_SETUP_FACETS) {
         const raw = attrs[facet.key];
-        switch (facet.kind) {
-            case 'count': {
-                const value = numInteger(raw, 0);
-                if (value !== undefined)
-                    pageSetup[facet.key] = value;
-                break;
-            }
-            case 'token':
-                if (raw !== undefined && facet.isValid(raw))
-                    assignPageSetupToken(pageSetup, facet.key, raw);
-                break;
+        if (facet.kind === 'count') {
+            const value = numInteger(raw, 0);
+            if (value !== undefined)
+                pageSetup[facet.key] = value;
+        }
+        else if (raw === undefined) {
+            continue;
+        }
+        else if (facet.key === 'pageOrder') {
+            if (facet.isValid(raw))
+                pageSetup.pageOrder = raw;
+        }
+        else if (facet.isValid(raw)) {
+            pageSetup.orientation = raw;
         }
     }
 }
-function assignPageSetupToken(pageSetup, key, raw) {
-    pageSetup[key] = raw;
-}

package/dist/io/xlsx/strict-parts.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A package part's bytes in Transitional: an XML part declaring a Strict namespace has its
+ * declarations and its percentages translated, and any other part is handed back as the same bytes.
+ * Only the opening tags that change are re-rendered, so everything else in the part rides through byte
+ * for byte. A part the scanner cannot read is left as it came, as it would have been carried.
+ */
+export declare function transitionalPart(bytes: Uint8Array, contentType: string): Uint8Array;