@office-kit/xlsx 0.8.0

package/dist/worksheet.mjs

@@ -0,0 +1,247 @@
+import { $ as iterRows, $t as makeRowDimension, A as getCellsInRow, An as unionRange, At as setRangeValues, B as getPopulatedRowIndices, Bt as unhideColumns, C as getAutoFilter, Ct as setColumnWidth, Dt as setDefaultRowHeight, En as rangeContainsRange, Et as setDefaultColumnWidth, F as getMaxRow, Ft as setSheetViewMode, G as groupRows, Gt as writeRange, H as getRowDimension, Ht as unhideRows, I as getMergedCells, It as setSheetZoom, J as hideRow, Jt as freezePaneRef, K as hideColumn, Kt as makeSheetProperties, L as getMergedRangeAt, Lt as ungroupColumns, M as getDataExtent, Mt as setRowHeight, N as getFreezePanes, Nt as setRowHeights, O as getCellsInColumn, On as rangesOverlap, Ot as setFreezePanes, P as getMaxCol, Pt as setSheetTabColor, Q as iterCells, Qt as makeColumnDimension, R as getNonEmptyCellCount, Rt as ungroupRows, S as freezePanes, St as setColumnDimension, T as getCellByCoord, Tn as rangeContainsCell, Tt as setComment, U as getTable, Ut as unmergeCells, V as getRangeValues, Vt as unhideRow, W as groupColumns, Wt as unmergeCellsAt, X as isMergedCell, Xt as makeSheetView, Y as hideRows, Yt as makeFreezePane, Z as isWorksheetEmpty, Zt as makeHyperlink, _ as countCellsByKind, _n as intersectionRange, _t as removeIgnoredErrors, a as addTable, at as makeWorksheet, b as expandRowGroup, bt as setCell, c as applyToRange, ct as removeAllComments, d as clearAllCells, dt as removeAllHyperlinks, et as iterValues, f as clearRange, ft as removeAllMergedRanges, g as countCells, gn as expandRangeStr, gt as removeHyperlink, h as copyRange, ht as removeDataValidations, i as addIgnoredError, it as listTables, j as getColumnDimension, jt as setRowDimension, k as getCellsInRange, kn as shiftRange, kt as setHyperlink, l as autofitColumns, lt as removeAllConditionalFormatting, m as collapseRowGroup, mt as removeCellWatches, n as addConditionalFormatting, nt as listDataValidations, o as appendRow, ot as mergeCells, p as collapseColumnGroup, pt as removeAllTables, q as hideColumns, qt as makeLegacyComment, r as addDataValidation, rt as listHyperlinks, s as appendRows, st as moveRange, t as addCellWatch, tt as listComments, ut as removeAllDataValidations, v as deleteCell, vn as isCellInRange, vt as removeTable, w as getCell, wn as rangeArea, wt as setColumnWidths, x as findCells, xt as setCellByCoord, y as expandColumnGroup, yn as isRangeInRange, yt as setAutoFilter, z as getPopulatedColumnIndices, zt as unhideColumn } from "./worksheet-CmCNoIgD.mjs";
+import { a as makeCfRule, i as makeDataValidation, n as makeTableColumn, o as makeConditionalFormatting, r as makeTableDefinition, t as addExcelTable } from "./table-DkX6UniA.mjs";
+//#region src/worksheet/auto-filter.ts
+function makeAutoFilter(opts) {
+	return {
+		ref: opts.ref,
+		filterColumns: opts.filterColumns ?? []
+	};
+}
+function makeFilterColumn(opts) {
+	return {
+		kind: "filters",
+		colId: opts.colId,
+		values: [...opts.values],
+		...opts.blank !== void 0 ? { blank: opts.blank } : {}
+	};
+}
+//#endregion
+//#region src/worksheet/errors.ts
+const makeCellWatch = (ref) => ({ ref });
+function makeIgnoredError(opts) {
+	return {
+		sqref: opts.sqref,
+		...opts.evalError !== void 0 ? { evalError: opts.evalError } : {},
+		...opts.twoDigitTextYear !== void 0 ? { twoDigitTextYear: opts.twoDigitTextYear } : {},
+		...opts.numberStoredAsText !== void 0 ? { numberStoredAsText: opts.numberStoredAsText } : {},
+		...opts.formula !== void 0 ? { formula: opts.formula } : {},
+		...opts.formulaRange !== void 0 ? { formulaRange: opts.formulaRange } : {},
+		...opts.unlockedFormula !== void 0 ? { unlockedFormula: opts.unlockedFormula } : {},
+		...opts.emptyCellReference !== void 0 ? { emptyCellReference: opts.emptyCellReference } : {},
+		...opts.listDataValidation !== void 0 ? { listDataValidation: opts.listDataValidation } : {},
+		...opts.calculatedColumn !== void 0 ? { calculatedColumn: opts.calculatedColumn } : {}
+	};
+}
+//#endregion
+//#region src/worksheet/protection.ts
+const makeSheetProtection = (opts = {}) => {
+	const out = {};
+	for (const k of [
+		"sheet",
+		"objects",
+		"scenarios",
+		"formatCells",
+		"formatColumns",
+		"formatRows",
+		"insertColumns",
+		"insertRows",
+		"insertHyperlinks",
+		"deleteColumns",
+		"deleteRows",
+		"selectLockedCells",
+		"selectUnlockedCells",
+		"sort",
+		"autoFilter",
+		"pivotTables"
+	]) if (opts[k] !== void 0) out[k] = opts[k];
+	if (opts.saltValue !== void 0) out.saltValue = opts.saltValue;
+	if (opts.spinCount !== void 0) out.spinCount = opts.spinCount;
+	if (opts.algorithmName !== void 0) out.algorithmName = opts.algorithmName;
+	if (opts.hashValue !== void 0) out.hashValue = opts.hashValue;
+	return out;
+};
+Object.freeze({
+	sheet: true,
+	objects: true,
+	scenarios: true,
+	formatCells: false,
+	formatColumns: false,
+	formatRows: false,
+	insertColumns: false,
+	insertRows: false,
+	insertHyperlinks: false,
+	deleteColumns: false,
+	deleteRows: false,
+	selectLockedCells: false,
+	selectUnlockedCells: false,
+	sort: false,
+	autoFilter: false,
+	pivotTables: false
+});
+//#endregion
+//#region src/worksheet/protected-ranges.ts
+const makeProtectedRange = (opts) => ({
+	sqref: opts.sqref,
+	name: opts.name,
+	...opts.password !== void 0 ? { password: opts.password } : {},
+	...opts.securityDescriptor !== void 0 ? { securityDescriptor: opts.securityDescriptor } : {},
+	...opts.algorithmName !== void 0 ? { algorithmName: opts.algorithmName } : {},
+	...opts.hashValue !== void 0 ? { hashValue: opts.hashValue } : {},
+	...opts.saltValue !== void 0 ? { saltValue: opts.saltValue } : {},
+	...opts.spinCount !== void 0 ? { spinCount: opts.spinCount } : {}
+});
+//#endregion
+//#region src/worksheet/sort-state.ts
+const makeSortCondition = (opts) => ({ ...opts });
+const makeSortState = (opts) => ({
+	ref: opts.ref,
+	conditions: opts.conditions?.slice() ?? [],
+	...opts.columnSort !== void 0 ? { columnSort: opts.columnSort } : {},
+	...opts.caseSensitive !== void 0 ? { caseSensitive: opts.caseSensitive } : {},
+	...opts.sortMethod !== void 0 ? { sortMethod: opts.sortMethod } : {}
+});
+//#endregion
+//#region src/worksheet/smart-tags.ts
+const makeCellSmartTagProperty = (key, val) => ({
+	key,
+	val
+});
+const makeCellSmartTag = (opts) => ({
+	type: opts.type,
+	properties: opts.properties?.slice() ?? [],
+	...opts.deleted !== void 0 ? { deleted: opts.deleted } : {},
+	...opts.xmlBased !== void 0 ? { xmlBased: opts.xmlBased } : {}
+});
+const makeCellSmartTags = (opts) => ({
+	ref: opts.ref,
+	tags: opts.tags?.slice() ?? []
+});
+//#endregion
+//#region src/worksheet/ole-objects.ts
+const makeOleObject = (opts) => ({
+	shapeId: opts.shapeId,
+	...opts.rId !== void 0 ? { rId: opts.rId } : {},
+	...opts.progId !== void 0 ? { progId: opts.progId } : {},
+	...opts.dvAspect !== void 0 ? { dvAspect: opts.dvAspect } : {},
+	...opts.link !== void 0 ? { link: opts.link } : {},
+	...opts.oleUpdate !== void 0 ? { oleUpdate: opts.oleUpdate } : {},
+	...opts.autoLoad !== void 0 ? { autoLoad: opts.autoLoad } : {},
+	...opts.objectPr !== void 0 ? { objectPr: opts.objectPr } : {}
+});
+const makeFormControl = (opts) => ({
+	shapeId: opts.shapeId,
+	...opts.rId !== void 0 ? { rId: opts.rId } : {},
+	...opts.name !== void 0 ? { name: opts.name } : {},
+	...opts.controlPr !== void 0 ? { controlPr: opts.controlPr } : {}
+});
+//#endregion
+//#region src/worksheet/custom-sheet-views.ts
+const makeCustomSheetView = (opts) => ({ ...opts });
+//#endregion
+//#region src/worksheet/page-setup.ts
+const makePageMargins = (opts = {}) => ({
+	left: opts.left ?? .75,
+	right: opts.right ?? .75,
+	top: opts.top ?? 1,
+	bottom: opts.bottom ?? 1,
+	header: opts.header ?? .5,
+	footer: opts.footer ?? .5
+});
+const makePrintOptions = (opts = {}) => ({ ...opts });
+const makePageSetup = (opts = {}) => ({ ...opts });
+const makeHeaderFooter = (opts = {}) => ({ ...opts });
+const makePageBreak = (opts = {}) => ({ ...opts });
+/**
+* Excel's reserved header / footer code tokens. Drop these into the left /
+* center / right text inputs of {@link buildHeaderFooterText} (or directly into
+* a setHeader / setFooter string) to render dynamic values at print time.
+*/
+const HEADER_FOOTER_CODES = Object.freeze({
+	/** Current page number. */
+	pageNumber: "&P",
+	/** Total number of pages. */
+	pageCount: "&N",
+	/** Print date. */
+	date: "&D",
+	/** Print time. */
+	time: "&T",
+	/** File path + name. */
+	filePath: "&Z&F",
+	/** File name only. */
+	fileName: "&F",
+	/** Sheet name. */
+	sheetName: "&A",
+	/** Embedded image (Excel inserts via "Insert Picture" — `&G` is the placeholder). */
+	picture: "&G"
+});
+/**
+* Build a header / footer string from optional left / center / right fragments
+* using Excel's `&L` / `&C` / `&R` markers. An empty fragment is omitted (no
+* marker emitted) so a center-only header doesn't leave a stray `&L` prefix.
+* Returns `''` when all three fragments are undefined.
+*/
+const buildHeaderFooterText = (parts) => {
+	let out = "";
+	if (parts.left !== void 0) out += `&L${parts.left}`;
+	if (parts.center !== void 0) out += `&C${parts.center}`;
+	if (parts.right !== void 0) out += `&R${parts.right}`;
+	return out;
+};
+//#endregion
+//#region src/worksheet/web-publish.ts
+const makeWorksheetCustomProperty = (opts) => ({
+	name: opts.name,
+	...opts.rId !== void 0 ? { rId: opts.rId } : {}
+});
+const makeWebPublishItem = (opts) => ({
+	id: opts.id,
+	divId: opts.divId,
+	sourceType: opts.sourceType,
+	destinationFile: opts.destinationFile,
+	...opts.sourceRef !== void 0 ? { sourceRef: opts.sourceRef } : {},
+	...opts.sourceObject !== void 0 ? { sourceObject: opts.sourceObject } : {},
+	...opts.title !== void 0 ? { title: opts.title } : {},
+	...opts.autoRepublish !== void 0 ? { autoRepublish: opts.autoRepublish } : {}
+});
+//#endregion
+//#region src/worksheet/phonetic.ts
+const makeWorksheetPhoneticProperties = (opts = {}) => ({ ...opts });
+//#endregion
+//#region src/worksheet/data-consolidate.ts
+const makeDataConsolidate = (opts = {}) => {
+	const out = {};
+	if (opts.function !== void 0) out.function = opts.function;
+	if (opts.topLabels !== void 0) out.topLabels = opts.topLabels;
+	if (opts.leftLabels !== void 0) out.leftLabels = opts.leftLabels;
+	if (opts.link !== void 0) out.link = opts.link;
+	if (opts.dataRefs !== void 0) out.dataRefs = opts.dataRefs.map((r) => ({ ...r }));
+	if (opts.startLabels !== void 0) out.startLabels = opts.startLabels;
+	return out;
+};
+//#endregion
+//#region src/worksheet/scenarios.ts
+const makeScenarioInputCell = (opts) => ({
+	ref: opts.ref,
+	val: opts.val,
+	...opts.deleted !== void 0 ? { deleted: opts.deleted } : {},
+	...opts.undone !== void 0 ? { undone: opts.undone } : {},
+	...opts.numFmtId !== void 0 ? { numFmtId: opts.numFmtId } : {}
+});
+const makeScenario = (opts) => ({
+	name: opts.name,
+	inputCells: opts.inputCells.slice(),
+	...opts.locked !== void 0 ? { locked: opts.locked } : {},
+	...opts.hidden !== void 0 ? { hidden: opts.hidden } : {},
+	...opts.user !== void 0 ? { user: opts.user } : {},
+	...opts.comment !== void 0 ? { comment: opts.comment } : {}
+});
+const makeScenarioList = (opts = {}) => ({
+	scenarios: opts.scenarios?.slice() ?? [],
+	...opts.current !== void 0 ? { current: opts.current } : {},
+	...opts.show !== void 0 ? { show: opts.show } : {},
+	...opts.sqref !== void 0 ? { sqref: opts.sqref } : {}
+});
+//#endregion
+export { HEADER_FOOTER_CODES, addCellWatch, addConditionalFormatting, addDataValidation, addExcelTable, addIgnoredError, addTable, appendRow, appendRows, applyToRange, autofitColumns, buildHeaderFooterText, clearAllCells, clearRange, collapseColumnGroup, collapseRowGroup, copyRange, countCells, countCellsByKind, deleteCell, expandColumnGroup, expandRangeStr, expandRowGroup, findCells, freezePaneRef, freezePanes, getAutoFilter, getCell, getCellByCoord, getCellsInColumn, getCellsInRange, getCellsInRow, getColumnDimension, getDataExtent, getFreezePanes, getMaxCol, getMaxRow, getMergedCells, getMergedRangeAt, getNonEmptyCellCount, getPopulatedColumnIndices, getPopulatedRowIndices, getRangeValues, getRowDimension, getTable, groupColumns, groupRows, hideColumn, hideColumns, hideRow, hideRows, intersectionRange, isCellInRange, isMergedCell, isRangeInRange, isWorksheetEmpty, iterCells, iterRows, iterValues, listComments, listDataValidations, listHyperlinks, listTables, makeAutoFilter, makeCellSmartTag, makeCellSmartTagProperty, makeCellSmartTags, makeCellWatch, makeCfRule, makeColumnDimension, makeConditionalFormatting, makeCustomSheetView, makeDataConsolidate, makeDataValidation, makeFilterColumn, makeFormControl, makeFreezePane, makeHeaderFooter, makeHyperlink, makeIgnoredError, makeLegacyComment, makeOleObject, makePageBreak, makePageMargins, makePageSetup, makePrintOptions, makeProtectedRange, makeRowDimension, makeScenario, makeScenarioInputCell, makeScenarioList, makeSheetProperties, makeSheetProtection, makeSheetView, makeSortCondition, makeSortState, makeTableColumn, makeTableDefinition, makeWebPublishItem, makeWorksheet, makeWorksheetCustomProperty, makeWorksheetPhoneticProperties, mergeCells, moveRange, rangeArea, rangeContainsCell, rangeContainsRange, rangesOverlap, removeAllComments, removeAllConditionalFormatting, removeAllDataValidations, removeAllHyperlinks, removeAllMergedRanges, removeAllTables, removeCellWatches, removeDataValidations, removeHyperlink, removeIgnoredErrors, removeTable, setAutoFilter, setCell, setCellByCoord, setColumnDimension, setColumnWidth, setColumnWidths, setComment, setDefaultColumnWidth, setDefaultRowHeight, setFreezePanes, setHyperlink, setRangeValues, setRowDimension, setRowHeight, setRowHeights, setSheetTabColor, setSheetViewMode, setSheetZoom, shiftRange, ungroupColumns, ungroupRows, unhideColumn, unhideColumns, unhideRow, unhideRows, unionRange, unmergeCells, unmergeCellsAt, writeRange };
+
+//# sourceMappingURL=worksheet.mjs.map

package/dist/worksheet.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"worksheet.mjs","names":[],"sources":["../src/worksheet/auto-filter.ts","../src/worksheet/errors.ts","../src/worksheet/protection.ts","../src/worksheet/protected-ranges.ts","../src/worksheet/sort-state.ts","../src/worksheet/smart-tags.ts","../src/worksheet/ole-objects.ts","../src/worksheet/custom-sheet-views.ts","../src/worksheet/page-setup.ts","../src/worksheet/web-publish.ts","../src/worksheet/phonetic.ts","../src/worksheet/data-consolidate.ts","../src/worksheet/scenarios.ts"],"sourcesContent":["// AutoFilter.\n//\n// **Stage 1**: ref + filterColumns where each entry is the `kind: 'filters'`\n// variant — the value-list dropdown filter that covers >95% of real-world\n// spreadsheets. customFilters / top10 / dynamicFilter / colorFilter /\n// iconFilter / SortState are reserved for later iterations.\n\nimport { OpenXmlSchemaError } from '../utils/exceptions';\n\nexport type FilterColumn = {\n  kind: 'filters';\n  colId: number;\n  /** Discrete values that pass the filter. Stored as strings to match the wire format. */\n  values: string[];\n  /** Whether blanks are visible. */\n  blank?: boolean;\n};\n\nexport interface AutoFilter {\n  /** Excel range the filter covers (`\"A1:E100\"`). */\n  ref: string;\n  filterColumns: FilterColumn[];\n}\n\nexport function makeAutoFilter(opts: { ref: string; filterColumns?: FilterColumn[] }): AutoFilter {\n  return { ref: opts.ref, filterColumns: opts.filterColumns ?? [] };\n}\n\nexport function makeFilterColumn(opts: {\n  colId: number;\n  values: ReadonlyArray<string>;\n  blank?: boolean;\n}): FilterColumn {\n  return {\n    kind: 'filters',\n    colId: opts.colId,\n    values: [...opts.values],\n    ...(opts.blank !== undefined ? { blank: opts.blank } : {}),\n  };\n}\n\n// ---- Worksheet ergonomic builders ---------------------------------------\n\nimport type { Worksheet } from './worksheet';\n\n/** Add an AutoFilter dropdown header strip to the given range. */\nexport const addAutoFilter = (ws: Worksheet, ref: string): AutoFilter => {\n  ws.autoFilter = makeAutoFilter({ ref });\n  return ws.autoFilter;\n};\n\n/**\n * Add a value-list dropdown filter to a column inside the existing AutoFilter\n * range. `colId` is 0-based relative to the AutoFilter left edge.\n */\nexport const addAutoFilterColumn = (\n  ws: Worksheet,\n  colId: number,\n  values: ReadonlyArray<string>,\n  opts: { blank?: boolean } = {},\n): FilterColumn => {\n  if (!ws.autoFilter) {\n    throw new OpenXmlSchemaError('addAutoFilterColumn: call addAutoFilter(ws, ref) first');\n  }\n  const fc = makeFilterColumn({ colId, values, ...(opts.blank !== undefined ? { blank: opts.blank } : {}) });\n  ws.autoFilter.filterColumns.push(fc);\n  return fc;\n};\n\n/** Drop the worksheet's AutoFilter entirely. */\nexport const removeAutoFilter = (ws: Worksheet): void => {\n  delete (ws as { autoFilter?: AutoFilter }).autoFilter;\n};\n","// Cell-level error / watch metadata. (cellWatches / ignoredErrors).\n//\n// `ignoredErrors` lets you tell Excel \"don't flag these cells with the little\n// green triangle for this class of validation\". `cellWatches` records which\n// cells the user has pinned in the Watch Window.\n//\n// Both round-trip via the worksheet `bodyExtras` passthrough already, but\n// promoting them to first-class arrays gives the editor a clean API and the\n// writer a stable position in the worksheet element order (between rowBreaks /\n// colBreaks and the drawing block per ECMA-376 §18.3.1.94 cellWatches /\n// §18.3.1.51 ignoredErrors).\n\nimport type { MultiCellRange } from './cell-range';\n\n/**\n * One Cell-Watch entry. The Watch Window in Excel (Formulas → Watch Window)\n * shows live values for the cells listed here.\n */\nexport interface CellWatch {\n  /** Single-cell reference like \"Sheet1!$A$1\" — kept verbatim. */\n  ref: string;\n}\n\n/**\n * One ignored-error entry. Each Boolean flag corresponds to a class of Excel's\n * background validation; setting any of them to `true` suppresses the green\n * triangle for cells in `sqref`.\n */\nexport interface IgnoredError {\n  /** Cells to which the suppressions apply. */\n  sqref: MultiCellRange;\n  /** \"Formula evaluates to error\" warning. */\n  evalError?: boolean;\n  /** \"Date stored as 2-digit year\" warning. */\n  twoDigitTextYear?: boolean;\n  /** \"Number stored as text\" warning. */\n  numberStoredAsText?: boolean;\n  /** \"Inconsistent formula\" warning. */\n  formula?: boolean;\n  /** \"Formula omits cells\" warning. */\n  formulaRange?: boolean;\n  /** \"Unlocked cells containing formulas\" warning. */\n  unlockedFormula?: boolean;\n  /** \"Empty cells referenced\" warning. */\n  emptyCellReference?: boolean;\n  /** \"Data validation list error\" warning. */\n  listDataValidation?: boolean;\n  /** \"Inconsistent calculated column\" warning (Excel Tables). */\n  calculatedColumn?: boolean;\n}\n\nexport const makeCellWatch = (ref: string): CellWatch => ({ ref });\n\nexport function makeIgnoredError(\n  opts: Partial<IgnoredError> & { sqref: MultiCellRange },\n): IgnoredError {\n  return {\n    sqref: opts.sqref,\n    ...(opts.evalError !== undefined ? { evalError: opts.evalError } : {}),\n    ...(opts.twoDigitTextYear !== undefined ? { twoDigitTextYear: opts.twoDigitTextYear } : {}),\n    ...(opts.numberStoredAsText !== undefined ? { numberStoredAsText: opts.numberStoredAsText } : {}),\n    ...(opts.formula !== undefined ? { formula: opts.formula } : {}),\n    ...(opts.formulaRange !== undefined ? { formulaRange: opts.formulaRange } : {}),\n    ...(opts.unlockedFormula !== undefined ? { unlockedFormula: opts.unlockedFormula } : {}),\n    ...(opts.emptyCellReference !== undefined ? { emptyCellReference: opts.emptyCellReference } : {}),\n    ...(opts.listDataValidation !== undefined ? { listDataValidation: opts.listDataValidation } : {}),\n    ...(opts.calculatedColumn !== undefined ? { calculatedColumn: opts.calculatedColumn } : {}),\n  };\n}\n","// Sheet-protection model. (without password hashing — saltValue / spinCount /\n// algorithmName / hashValue round-trip verbatim, but no helper to compute them\n// yet).\n//\n// Excel uses the listed booleans inversely: `true` typically means \"users CAN\n// do this even when the sheet is locked\" (e.g. `formatCells: true` lets people\n// change cell formatting on a protected sheet). The only universally meaningful\n// field is `sheet: true`, which actually enables the lock.\n\nexport interface SheetProtection {\n  /** Master toggle — when true the sheet is protected. */\n  sheet?: boolean;\n  /** Allow operations on drawing objects when sheet is protected. */\n  objects?: boolean;\n  /** Allow operations on scenarios when sheet is protected. */\n  scenarios?: boolean;\n  formatCells?: boolean;\n  formatColumns?: boolean;\n  formatRows?: boolean;\n  insertColumns?: boolean;\n  insertRows?: boolean;\n  insertHyperlinks?: boolean;\n  deleteColumns?: boolean;\n  deleteRows?: boolean;\n  selectLockedCells?: boolean;\n  selectUnlockedCells?: boolean;\n  sort?: boolean;\n  autoFilter?: boolean;\n  pivotTables?: boolean;\n\n  // Password-protection fields. Round-trip only — computing a fresh hash from a\n  // plaintext password lives behind a future helper.\n  /** Base-64 salt for the password hash. */\n  saltValue?: string;\n  /** Number of hash iterations. */\n  spinCount?: number;\n  /** Hash algorithm name, e.g. \"SHA-512\". */\n  algorithmName?: string;\n  /** Base-64 hashed password. */\n  hashValue?: string;\n}\n\nexport const makeSheetProtection = (opts: SheetProtection = {}): SheetProtection => {\n  const out: SheetProtection = {};\n  for (const k of [\n    'sheet',\n    'objects',\n    'scenarios',\n    'formatCells',\n    'formatColumns',\n    'formatRows',\n    'insertColumns',\n    'insertRows',\n    'insertHyperlinks',\n    'deleteColumns',\n    'deleteRows',\n    'selectLockedCells',\n    'selectUnlockedCells',\n    'sort',\n    'autoFilter',\n    'pivotTables',\n  ] as const) {\n    if (opts[k] !== undefined) out[k] = opts[k];\n  }\n  if (opts.saltValue !== undefined) out.saltValue = opts.saltValue;\n  if (opts.spinCount !== undefined) out.spinCount = opts.spinCount;\n  if (opts.algorithmName !== undefined) out.algorithmName = opts.algorithmName;\n  if (opts.hashValue !== undefined) out.hashValue = opts.hashValue;\n  return out;\n};\n\n// ---- Worksheet ergonomic helpers ----------------------------------------\n\nimport type { Worksheet } from './worksheet';\n\n/**\n * Excel's \"Protect Sheet\" defaults — when you click the dialog without changing\n * any checkbox, it locks structure but allows the listed actions. This matches\n * Excel's wire form (sheet=1 + the listed flags left at their defaults).\n */\nconst PROTECT_SHEET_DEFAULTS: SheetProtection = Object.freeze({\n  sheet: true,\n  objects: true,\n  scenarios: true,\n  formatCells: false,\n  formatColumns: false,\n  formatRows: false,\n  insertColumns: false,\n  insertRows: false,\n  insertHyperlinks: false,\n  deleteColumns: false,\n  deleteRows: false,\n  selectLockedCells: false,\n  selectUnlockedCells: false,\n  sort: false,\n  autoFilter: false,\n  pivotTables: false,\n});\n\n/**\n * Lock a worksheet with Excel's \"Protect Sheet\" defaults. Pass `overrides` to\n * allow specific actions while otherwise locked (e.g. `{ sort: true,\n * autoFilter: true }` for \"allow sort + filter on locked sheet\"). Password-hash\n * fields can be supplied as a quad (algorithmName / hashValue / saltValue /\n * spinCount); plaintext passwords are out of scope until the D-tier hashing\n * helper lands.\n */\nexport const protectSheet = (\n  ws: Worksheet,\n  overrides: Partial<SheetProtection> = {},\n): SheetProtection => {\n  ws.sheetProtection = { ...PROTECT_SHEET_DEFAULTS, ...overrides };\n  return ws.sheetProtection;\n};\n\n/** Drop the typed sheet-protection record. */\nexport const unprotectSheet = (ws: Worksheet): void => {\n  delete (ws as { sheetProtection?: SheetProtection }).sheetProtection;\n};\n\n/** Quick-lock helper that mirrors Excel's \"Allow users to edit ranges → Protect Sheet\" defaults. */\nexport const isSheetProtected = (ws: Worksheet): boolean => ws.sheetProtection?.sheet === true;\n","// Worksheet-level <protectedRanges>. Per ECMA-376 §18.3.1.69.\n//\n// Excel's \"Allow Edit Ranges\" dialog (Review → Allow Edit Ranges).\n// Each entry whitelists a specific range to be editable while the\n// sheet is otherwise protected. Round-tripped verbatim — no password\n// hashing helper yet.\n\nimport type { MultiCellRange } from './cell-range';\n\nexport interface ProtectedRange {\n  /** Range to expose for editing while the sheet is protected. */\n  sqref: MultiCellRange;\n  /** Display name shown in the dialog. */\n  name: string;\n  /** Legacy 16-bit hex password. */\n  password?: string;\n  /** Optional security descriptor (Windows ACL string). */\n  securityDescriptor?: string;\n  // Modern hash quad — round-tripped verbatim.\n  algorithmName?: string;\n  hashValue?: string;\n  saltValue?: string;\n  spinCount?: number;\n}\n\nexport const makeProtectedRange = (\n  opts: Partial<ProtectedRange> & { sqref: MultiCellRange; name: string },\n): ProtectedRange => ({\n  sqref: opts.sqref,\n  name: opts.name,\n  ...(opts.password !== undefined ? { password: opts.password } : {}),\n  ...(opts.securityDescriptor !== undefined ? { securityDescriptor: opts.securityDescriptor } : {}),\n  ...(opts.algorithmName !== undefined ? { algorithmName: opts.algorithmName } : {}),\n  ...(opts.hashValue !== undefined ? { hashValue: opts.hashValue } : {}),\n  ...(opts.saltValue !== undefined ? { saltValue: opts.saltValue } : {}),\n  ...(opts.spinCount !== undefined ? { spinCount: opts.spinCount } : {}),\n});\n","// Worksheet-level <sortState>. Per ECMA-376 §18.3.1.92.\n//\n// Excel persists the last sort the user applied so re-opening the file\n// shows the rows in the same order. The element carries one or more\n// <sortCondition> entries describing the sort key columns (or rows).\n\nexport type SortBy = 'value' | 'cellColor' | 'fontColor' | 'icon';\nexport type SortMethod = 'stroke' | 'pinYin';\nexport type SortIconSet =\n  | '3Arrows'\n  | '3ArrowsGray'\n  | '3Flags'\n  | '3TrafficLights1'\n  | '3TrafficLights2'\n  | '3Signs'\n  | '3Symbols'\n  | '3Symbols2'\n  | '4Arrows'\n  | '4ArrowsGray'\n  | '4RedToBlack'\n  | '4Rating'\n  | '4TrafficLights'\n  | '5Arrows'\n  | '5ArrowsGray'\n  | '5Rating'\n  | '5Quarters';\n\nexport interface SortCondition {\n  /** Column or row that drives this sort key. */\n  ref: string;\n  descending?: boolean;\n  sortBy?: SortBy;\n  /** Reference to a custom-list defined name. */\n  customList?: string;\n  /** Differential-style index (`<dxf>` slot in the stylesheet). */\n  dxfId?: number;\n  iconSet?: SortIconSet;\n  iconId?: number;\n}\n\nexport interface SortState {\n  /** Range the sort applies to (`A1:D20`). */\n  ref: string;\n  conditions: SortCondition[];\n  /** Sort columns instead of rows (rare). */\n  columnSort?: boolean;\n  caseSensitive?: boolean;\n  sortMethod?: SortMethod;\n}\n\nexport const makeSortCondition = (opts: SortCondition): SortCondition => ({ ...opts });\n\nexport const makeSortState = (opts: Partial<SortState> & { ref: string }): SortState => ({\n  ref: opts.ref,\n  conditions: opts.conditions?.slice() ?? [],\n  ...(opts.columnSort !== undefined ? { columnSort: opts.columnSort } : {}),\n  ...(opts.caseSensitive !== undefined ? { caseSensitive: opts.caseSensitive } : {}),\n  ...(opts.sortMethod !== undefined ? { sortMethod: opts.sortMethod } : {}),\n});\n","// Worksheet-level <smartTags>. Per ECMA-376 §18.3.1.93.\n//\n// Per-cell smart-tag annotations from Excel 2003. The element is\n// nested:\n//   <smartTags>\n//     <cellSmartTags r=\"A1\">\n//       <cellSmartTag type=\"0\" deleted=\"0\" xmlBased=\"0\">\n//         <cellSmartTagPr key=\"…\" val=\"…\"/>\n//       </cellSmartTag>\n//     </cellSmartTags>\n//   </smartTags>\n// Almost never seen in modern files; the workbook-level smartTagTypes\n// list registers the schema, this element pins individual cells.\n\nexport interface CellSmartTagProperty {\n  key: string;\n  val: string;\n}\n\nexport interface CellSmartTag {\n  /** 0-based index into the workbook's smartTagTypes list. */\n  type: number;\n  properties: CellSmartTagProperty[];\n  deleted?: boolean;\n  xmlBased?: boolean;\n}\n\nexport interface CellSmartTags {\n  /** Single-cell ref (\"A1\"). */\n  ref: string;\n  tags: CellSmartTag[];\n}\n\nexport const makeCellSmartTagProperty = (key: string, val: string): CellSmartTagProperty => ({ key, val });\n\nexport const makeCellSmartTag = (opts: Partial<CellSmartTag> & { type: number }): CellSmartTag => ({\n  type: opts.type,\n  properties: opts.properties?.slice() ?? [],\n  ...(opts.deleted !== undefined ? { deleted: opts.deleted } : {}),\n  ...(opts.xmlBased !== undefined ? { xmlBased: opts.xmlBased } : {}),\n});\n\nexport const makeCellSmartTags = (opts: Partial<CellSmartTags> & { ref: string }): CellSmartTags => ({\n  ref: opts.ref,\n  tags: opts.tags?.slice() ?? [],\n});\n","// Worksheet-level <oleObjects> + <controls>. Per ECMA-376 §18.3.1.61\n// and §18.3.1.27.\n//\n// Both elements are lists of object references where each entry has a\n// `shapeId` + `r:id` plus a child `<objectPr>` / `<controlPr>` element\n// that holds the anchor / display properties. The objectPr/controlPr\n// children pull in the spreadsheet-drawing namespace, so we round-trip\n// them as opaque XmlNode payloads rather than fully modeling the\n// nested anchor schema. The top-level attrs are typed for editor access.\n\nimport type { XmlNode } from '../xml/tree';\n\nexport type OleDvAspect = 'DVASPECT_CONTENT' | 'DVASPECT_ICON';\nexport type OleUpdateMode = 'OLEUPDATE_ALWAYS' | 'OLEUPDATE_ONCALL';\n\nexport interface OleObject {\n  /** Unique shape id assigned by Excel — required. */\n  shapeId: number;\n  /** rels link to the embedded OLE blob. */\n  rId?: string;\n  progId?: string;\n  dvAspect?: OleDvAspect;\n  link?: string;\n  oleUpdate?: OleUpdateMode;\n  autoLoad?: boolean;\n  /**\n   * Optional `<objectPr>` child preserved verbatim. Modeling its\n   * `<anchor>` schema in detail is deferred — this preserves the\n   * round-trip without re-deriving the anchor attrs.\n   */\n  objectPr?: XmlNode;\n}\n\nexport interface FormControl {\n  shapeId: number;\n  rId?: string;\n  /** ECMA-376 §18.3.1.27 — name shown in the form-control name box. */\n  name?: string;\n  /**\n   * Optional `<controlPr>` child preserved verbatim (similar to\n   * `objectPr` for OLE objects).\n   */\n  controlPr?: XmlNode;\n}\n\nexport const makeOleObject = (opts: Partial<OleObject> & { shapeId: number }): OleObject => ({\n  shapeId: opts.shapeId,\n  ...(opts.rId !== undefined ? { rId: opts.rId } : {}),\n  ...(opts.progId !== undefined ? { progId: opts.progId } : {}),\n  ...(opts.dvAspect !== undefined ? { dvAspect: opts.dvAspect } : {}),\n  ...(opts.link !== undefined ? { link: opts.link } : {}),\n  ...(opts.oleUpdate !== undefined ? { oleUpdate: opts.oleUpdate } : {}),\n  ...(opts.autoLoad !== undefined ? { autoLoad: opts.autoLoad } : {}),\n  ...(opts.objectPr !== undefined ? { objectPr: opts.objectPr } : {}),\n});\n\nexport const makeFormControl = (opts: Partial<FormControl> & { shapeId: number }): FormControl => ({\n  shapeId: opts.shapeId,\n  ...(opts.rId !== undefined ? { rId: opts.rId } : {}),\n  ...(opts.name !== undefined ? { name: opts.name } : {}),\n  ...(opts.controlPr !== undefined ? { controlPr: opts.controlPr } : {}),\n});\n","// Worksheet-level <customSheetViews> — saved per-user view presets.\n// Per ECMA-376 §18.3.1.26 / §18.3.1.27.\n//\n// Each <customSheetView> snapshots a sheet's view state: zoom level,\n// gridline / formula / heading toggles, plus its own page-setup block\n// and break list. The chartsheet sibling (smaller) has been typed\n// separately in src/chartsheet/chartsheet.ts.\n\nimport type { HeaderFooter, PageBreak, PageMargins, PageSetup, PrintOptions } from './page-setup';\nimport type { Pane, Selection, SheetViewMode } from './views';\n\nexport type CustomSheetViewState = 'visible' | 'hidden' | 'veryHidden';\n\nexport interface CustomSheetView {\n  guid: string;\n  scale?: number;\n  /** 0..64 (legacy palette index) */\n  colorId?: number;\n  showPageBreaks?: boolean;\n  showFormulas?: boolean;\n  showGridLines?: boolean;\n  showRowCol?: boolean;\n  outlineSymbols?: boolean;\n  zeroValues?: boolean;\n  fitToPage?: boolean;\n  /** Print only the print-area selection on this saved view. */\n  printArea?: boolean;\n  /** AutoFilter is active in this saved view. */\n  filter?: boolean;\n  showAutoFilter?: boolean;\n  /** Hidden rows persist for this saved view. */\n  hiddenRows?: boolean;\n  hiddenColumns?: boolean;\n  state?: CustomSheetViewState;\n  filterUnique?: boolean;\n  view?: SheetViewMode;\n  showRuler?: boolean;\n  /** Top-left cell ref shown when this view is restored. */\n  topLeftCell?: string;\n  /** Inner pane split / freeze. */\n  pane?: Pane;\n  /** Selection state for this view (one entry per pane). */\n  selections?: Selection[];\n  rowBreaks?: PageBreak[];\n  colBreaks?: PageBreak[];\n  pageMargins?: PageMargins;\n  printOptions?: PrintOptions;\n  pageSetup?: PageSetup;\n  headerFooter?: HeaderFooter;\n}\n\nexport const makeCustomSheetView = (\n  opts: Partial<CustomSheetView> & { guid: string },\n): CustomSheetView => ({ ...opts });\n","// Page-setup typed model.\n//\n// Promotes <printOptions> / <pageMargins> / <pageSetup> / <headerFooter> from\n// the bodyExtras passthrough into typed Worksheet fields with round-trip\n// readers / writers. Mirrors openpyxl/openpyxl/worksheet/ page.py +\n// header_footer.py.\n\nexport interface PrintOptions {\n  /** Center the printed sheet horizontally on the page. */\n  horizontalCentered?: boolean;\n  /** Center the printed sheet vertically on the page. */\n  verticalCentered?: boolean;\n  /** Print row + column headings (the A B C / 1 2 3 strips). */\n  headings?: boolean;\n  /** Print sheet gridlines. */\n  gridLines?: boolean;\n  /** Mirrors a quirky Excel companion flag for `gridLines`. */\n  gridLinesSet?: boolean;\n}\n\n/** Page margins in inches. ECMA-376 §18.3.1.62. All six fields are required when the element is present. */\nexport interface PageMargins {\n  left: number;\n  right: number;\n  top: number;\n  bottom: number;\n  header: number;\n  footer: number;\n}\n\nexport type PageOrientation = 'default' | 'portrait' | 'landscape';\nexport type PageOrder = 'downThenOver' | 'overThenDown';\nexport type CellCommentMode = 'none' | 'asDisplayed' | 'atEnd';\nexport type PrintErrorMode = 'displayed' | 'blank' | 'dash' | 'NA';\n\nexport interface PageSetup {\n  paperSize?: number;\n  scale?: number;\n  firstPageNumber?: number;\n  fitToWidth?: number;\n  fitToHeight?: number;\n  pageOrder?: PageOrder;\n  orientation?: PageOrientation;\n  usePrinterDefaults?: boolean;\n  blackAndWhite?: boolean;\n  draft?: boolean;\n  cellComments?: CellCommentMode;\n  useFirstPageNumber?: boolean;\n  errors?: PrintErrorMode;\n  horizontalDpi?: number;\n  verticalDpi?: number;\n  copies?: number;\n  /** Optional `r:id` referencing an external printerSettings part — round-tripped verbatim. */\n  rId?: string;\n  /** Paper height (UniversalMeasure, e.g. \"297mm\"). */\n  paperHeight?: string;\n  /** Paper width (UniversalMeasure). */\n  paperWidth?: string;\n}\n\nexport interface HeaderFooter {\n  differentFirst?: boolean;\n  differentOddEven?: boolean;\n  /** Mirror Excel's \"scale header/footer with document\" toggle. Default true. */\n  scaleWithDoc?: boolean;\n  /** Mirror Excel's \"align header/footer with margins\" toggle. Default true. */\n  alignWithMargins?: boolean;\n  /**\n   * Mini-format string. Excel uses `&L` / `&C` / `&R` to split the three\n   * sections, plus codes like `&P` (page number), `&N` (page count), `&F` (file\n   * name), `&A` (sheet name), `&D` / `&T` (date / time). We round-trip the\n   * literal text — no parsing into sections.\n   */\n  oddHeader?: string;\n  oddFooter?: string;\n  evenHeader?: string;\n  evenFooter?: string;\n  firstHeader?: string;\n  firstFooter?: string;\n}\n\nexport const makePageMargins = (opts: Partial<PageMargins> = {}): PageMargins => ({\n  left: opts.left ?? 0.75,\n  right: opts.right ?? 0.75,\n  top: opts.top ?? 1,\n  bottom: opts.bottom ?? 1,\n  header: opts.header ?? 0.5,\n  footer: opts.footer ?? 0.5,\n});\n\nexport const makePrintOptions = (opts: PrintOptions = {}): PrintOptions => ({ ...opts });\n\nexport const makePageSetup = (opts: PageSetup = {}): PageSetup => ({ ...opts });\n\nexport const makeHeaderFooter = (opts: HeaderFooter = {}): HeaderFooter => ({ ...opts });\n\n/**\n * One manual page break. `id` is the row (for rowBreaks) or column (for\n * colBreaks) index where the break sits; `min`/`max` constrain the orthogonal\n * range Excel honours; `man=true` means a user-placed break (default true).\n * `pt` indicates a \"pivot table\" break — rare.\n */\nexport interface PageBreak {\n  id?: number;\n  min?: number;\n  max?: number;\n  man?: boolean;\n  pt?: boolean;\n}\n\nexport const makePageBreak = (opts: PageBreak = {}): PageBreak => ({ ...opts });\n\n// ---- Worksheet ergonomic helpers ----------------------------------------\n// Operate on a Worksheet directly so callers don't have to allocate the\n// individual typed records up front.\n\nimport type { Worksheet } from './worksheet';\n\nconst ensurePageSetup = (ws: Worksheet): PageSetup => {\n  if (!ws.pageSetup) ws.pageSetup = {};\n  return ws.pageSetup;\n};\n\nconst ensureHeaderFooter = (ws: Worksheet): HeaderFooter => {\n  if (!ws.headerFooter) ws.headerFooter = {};\n  return ws.headerFooter;\n};\n\n/** Set page orientation on `ws.pageSetup` (allocates if missing). */\nexport const setPageOrientation = (ws: Worksheet, orientation: PageOrientation): void => {\n  ensurePageSetup(ws).orientation = orientation;\n};\n\n/** Set paper size code (Excel uses ECMA-376 §3.3 paper-size enums; 1=Letter, 9=A4 etc.). */\nexport const setPaperSize = (ws: Worksheet, paperSize: number): void => {\n  ensurePageSetup(ws).paperSize = paperSize;\n};\n\n/** Set the print scale percentage (10..400). */\nexport const setPrintScale = (ws: Worksheet, scale: number): void => {\n  ensurePageSetup(ws).scale = scale;\n};\n\n/** Set fitToWidth + fitToHeight (Excel \"Fit to N pages wide × M tall\" UI). */\nexport const setFitToPage = (ws: Worksheet, opts: { width?: number; height?: number }): void => {\n  const ps = ensurePageSetup(ws);\n  if (opts.width !== undefined) ps.fitToWidth = opts.width;\n  if (opts.height !== undefined) ps.fitToHeight = opts.height;\n};\n\n/** Replace ws.pageMargins with the provided values (uses Excel defaults for missing axes). */\nexport const setPageMargins = (ws: Worksheet, opts: Partial<PageMargins> = {}): void => {\n  ws.pageMargins = {\n    left: opts.left ?? 0.75,\n    right: opts.right ?? 0.75,\n    top: opts.top ?? 1,\n    bottom: opts.bottom ?? 1,\n    header: opts.header ?? 0.5,\n    footer: opts.footer ?? 0.5,\n  };\n};\n\nexport type HeaderFooterSection = 'odd' | 'even' | 'first';\n\n/** Set the header text for a given section. Excel uses `&L` / `&C` / `&R` codes inside the string. */\nexport const setHeader = (ws: Worksheet, section: HeaderFooterSection, text: string): void => {\n  const hf = ensureHeaderFooter(ws);\n  if (section === 'odd') hf.oddHeader = text;\n  else if (section === 'even') {\n    hf.evenHeader = text;\n    hf.differentOddEven = true;\n  } else {\n    hf.firstHeader = text;\n    hf.differentFirst = true;\n  }\n};\n\n/** Set the footer text for a given section. */\nexport const setFooter = (ws: Worksheet, section: HeaderFooterSection, text: string): void => {\n  const hf = ensureHeaderFooter(ws);\n  if (section === 'odd') hf.oddFooter = text;\n  else if (section === 'even') {\n    hf.evenFooter = text;\n    hf.differentOddEven = true;\n  } else {\n    hf.firstFooter = text;\n    hf.differentFirst = true;\n  }\n};\n\n/**\n * Excel's reserved header / footer code tokens. Drop these into the left /\n * center / right text inputs of {@link buildHeaderFooterText} (or directly into\n * a setHeader / setFooter string) to render dynamic values at print time.\n */\nexport const HEADER_FOOTER_CODES = Object.freeze({\n  /** Current page number. */\n  pageNumber: '&P',\n  /** Total number of pages. */\n  pageCount: '&N',\n  /** Print date. */\n  date: '&D',\n  /** Print time. */\n  time: '&T',\n  /** File path + name. */\n  filePath: '&Z&F',\n  /** File name only. */\n  fileName: '&F',\n  /** Sheet name. */\n  sheetName: '&A',\n  /** Embedded image (Excel inserts via \"Insert Picture\" — `&G` is the placeholder). */\n  picture: '&G',\n});\n\n/**\n * Build a header / footer string from optional left / center / right fragments\n * using Excel's `&L` / `&C` / `&R` markers. An empty fragment is omitted (no\n * marker emitted) so a center-only header doesn't leave a stray `&L` prefix.\n * Returns `''` when all three fragments are undefined.\n */\nexport const buildHeaderFooterText = (\n  parts: { left?: string; center?: string; right?: string },\n): string => {\n  let out = '';\n  if (parts.left !== undefined) out += `&L${parts.left}`;\n  if (parts.center !== undefined) out += `&C${parts.center}`;\n  if (parts.right !== undefined) out += `&R${parts.right}`;\n  return out;\n};\n\n/**\n * Set a header by left / center / right parts. `section` defaults to `'odd'`\n * (the standard pages); pass `'first'` or `'even'` to target the alternate\n * sections (Excel auto-flips the corresponding differentOddEven /\n * differentFirst flag).\n */\nexport const setHeaderText = (\n  ws: Worksheet,\n  parts: { left?: string; center?: string; right?: string },\n  section: HeaderFooterSection = 'odd',\n): void => {\n  setHeader(ws, section, buildHeaderFooterText(parts));\n};\n\n/** Same shape as {@link setHeaderText} but writes the corresponding footer slot. */\nexport const setFooterText = (\n  ws: Worksheet,\n  parts: { left?: string; center?: string; right?: string },\n  section: HeaderFooterSection = 'odd',\n): void => {\n  setFooter(ws, section, buildHeaderFooterText(parts));\n};\n\n/** Push a manual horizontal page break above the given row (1-based). Defaults to `man=true`. */\nexport const addRowBreak = (ws: Worksheet, row: number): PageBreak => {\n  const brk: PageBreak = { id: row, man: true, max: 16383 };\n  ws.rowBreaks.push(brk);\n  return brk;\n};\n\n/** Push a manual vertical page break to the left of the given column (1-based). Defaults to `man=true`. */\nexport const addColBreak = (ws: Worksheet, col: number): PageBreak => {\n  const brk: PageBreak = { id: col, man: true, max: 1048575 };\n  ws.colBreaks.push(brk);\n  return brk;\n};\n\nconst ensurePrintOptions = (ws: Worksheet): PrintOptions => {\n  if (!ws.printOptions) ws.printOptions = {};\n  return ws.printOptions;\n};\n\n/** Toggle \"Print gridlines\". Mirrors Excel's \"Page Layout → Sheet Options → Gridlines: Print\". */\nexport const setPrintGridLines = (ws: Worksheet, on: boolean): void => {\n  const po = ensurePrintOptions(ws);\n  po.gridLines = on;\n  // Excel pairs gridLines with the gridLinesSet companion flag.\n  po.gridLinesSet = on;\n};\n\n/** Toggle \"Print row and column headings\" (the A B C / 1 2 3 strips on the printed page). */\nexport const setPrintHeadings = (ws: Worksheet, on: boolean): void => {\n  ensurePrintOptions(ws).headings = on;\n};\n\n/**\n * Toggle horizontal / vertical centering on the printed page. Pass either field\n * to leave the other untouched.\n */\nexport const setPrintCentered = (\n  ws: Worksheet,\n  opts: { horizontal?: boolean; vertical?: boolean },\n): void => {\n  const po = ensurePrintOptions(ws);\n  if (opts.horizontal !== undefined) po.horizontalCentered = opts.horizontal;\n  if (opts.vertical !== undefined) po.verticalCentered = opts.vertical;\n};\n\n","// Worksheet-level <customProperties> and <webPublishItems>.\n//\n// Both elements live near the bottom of <worksheet> (after tableParts, before\n// extLst per ECMA-376 §18.3.1.43 / §18.3.1.97). Each is a thin shell over a\n// list of children. customProperty references a Custom XML part via `r:id` —\n// the underlying rel is already preserved by the worksheet's `relsExtras`\n// machinery, so we just have to keep the inline element from leaking.\n\n/**\n * One <customProperty>. The `rId` points at a Custom XML part registered in the\n * worksheet rels (e.g. for SharePoint sync metadata).\n */\nexport interface WorksheetCustomProperty {\n  name: string;\n  /** Worksheet-rels rId pointing at the Custom XML part backing this entry. */\n  rId?: string;\n}\n\nexport interface WebPublishItem {\n  id: number;\n  divId: string;\n  sourceType: 'sheet' | 'printArea' | 'autoFilter' | 'range' | 'chart' | 'pivotTable' | 'query' | 'label';\n  sourceRef?: string;\n  sourceObject?: string;\n  destinationFile: string;\n  title?: string;\n  autoRepublish?: boolean;\n}\n\nexport const makeWorksheetCustomProperty = (\n  opts: WorksheetCustomProperty,\n): WorksheetCustomProperty => ({\n  name: opts.name,\n  ...(opts.rId !== undefined ? { rId: opts.rId } : {}),\n});\n\nexport const makeWebPublishItem = (opts: WebPublishItem): WebPublishItem => ({\n  id: opts.id,\n  divId: opts.divId,\n  sourceType: opts.sourceType,\n  destinationFile: opts.destinationFile,\n  ...(opts.sourceRef !== undefined ? { sourceRef: opts.sourceRef } : {}),\n  ...(opts.sourceObject !== undefined ? { sourceObject: opts.sourceObject } : {}),\n  ...(opts.title !== undefined ? { title: opts.title } : {}),\n  ...(opts.autoRepublish !== undefined ? { autoRepublish: opts.autoRepublish } : {}),\n});\n","// Worksheet-level <phoneticPr> for East-Asian (mostly Japanese) furigana\n// rendering.\n//\n// Excel uses `<phoneticPr fontId=\"...\" type=\"...\" alignment=\"...\"/>` to drive\n// how it renders the small phonetic annotation strip above CJK characters in\n// cells. The per-cell `<rPh>` annotations live on shared-string entries and are\n// a separate concern (richer model).\n\nexport type PhoneticType = 'halfwidthKatakana' | 'fullwidthKatakana' | 'Hiragana' | 'noConversion';\nexport type PhoneticAlignment = 'noControl' | 'left' | 'center' | 'distributed';\n\nexport interface WorksheetPhoneticProperties {\n  /** Font index in the workbook's stylesheet for the furigana glyphs. */\n  fontId?: number;\n  /** Conversion mode the IME should default to when adding furigana. */\n  type?: PhoneticType;\n  /** Horizontal alignment of the furigana strip relative to the base text. */\n  alignment?: PhoneticAlignment;\n}\n\nexport const makeWorksheetPhoneticProperties = (\n  opts: WorksheetPhoneticProperties = {},\n): WorksheetPhoneticProperties => ({ ...opts });\n","// Worksheet-level <dataConsolidate>. Used by Excel's\n// Data → Consolidate dialog to join multiple ranges into one summary\n// table. Per ECMA-376 §18.3.1.20, §18.3.1.22 (dataRef).\n\nexport type DataConsolidateFunction =\n  | 'average'\n  | 'count'\n  | 'countNums'\n  | 'max'\n  | 'min'\n  | 'product'\n  | 'stdDev'\n  | 'stdDevp'\n  | 'sum'\n  | 'var'\n  | 'varp';\n\nexport interface DataReference {\n  /** Optional name of the source range (defined-name reference). */\n  name?: string;\n  /** External range ref like \"Sheet1!$A$1:$B$10\" — required when no `rId`. */\n  ref?: string;\n  /** Optional friendly sheet name for display. */\n  sheet?: string;\n  /** rels rId pointing at an external workbook part — round-tripped verbatim. */\n  rId?: string;\n}\n\nexport interface DataConsolidate {\n  /** Aggregation function applied to overlapping cells. Default `sum`. */\n  function?: DataConsolidateFunction;\n  /** Use top-row labels as category keys. */\n  topLabels?: boolean;\n  /** Use left-column labels as category keys. */\n  leftLabels?: boolean;\n  /** \"Create links to source data\" (Excel's checkbox). */\n  link?: boolean;\n  /** Optional `<dataRefs>` list (one entry per source range). */\n  dataRefs?: DataReference[];\n  /**\n   * `startLabels` was added in a later schema revision — round-tripped\n   * verbatim when present.\n   */\n  startLabels?: string;\n}\n\nexport const makeDataConsolidate = (opts: DataConsolidate = {}): DataConsolidate => {\n  const out: DataConsolidate = {};\n  if (opts.function !== undefined) out.function = opts.function;\n  if (opts.topLabels !== undefined) out.topLabels = opts.topLabels;\n  if (opts.leftLabels !== undefined) out.leftLabels = opts.leftLabels;\n  if (opts.link !== undefined) out.link = opts.link;\n  if (opts.dataRefs !== undefined) out.dataRefs = opts.dataRefs.map((r) => ({ ...r }));\n  if (opts.startLabels !== undefined) out.startLabels = opts.startLabels;\n  return out;\n};\n","// Worksheet-level <scenarios> — Excel's Data → What-If Analysis →\n// Scenario Manager. Per ECMA-376 §18.3.1.74 / §18.3.1.41 (inputCells)\n// and openpyxl/openpyxl/worksheet/scenario.py.\n\nimport type { MultiCellRange } from './cell-range';\n\n/** One <inputCells> entry — a single (cell, override-value) pair. */\nexport interface ScenarioInputCell {\n  /** Single-cell ref, e.g. \"B5\". */\n  ref: string;\n  /** Stored as a string on the wire (Excel uses int / float / text format codes via numFmtId). */\n  val: string;\n  /** Mark this entry as deleted in the scenario history. */\n  deleted?: boolean;\n  /** Marks an undone change in the scenario history. */\n  undone?: boolean;\n  /** Number-format index used to display the override. */\n  numFmtId?: number;\n}\n\nexport interface Scenario {\n  name: string;\n  inputCells: ScenarioInputCell[];\n  /** When true, Excel disables editing the scenario unless the workbook protection password is supplied. */\n  locked?: boolean;\n  /** Hide the scenario from the picker dialog. */\n  hidden?: boolean;\n  user?: string;\n  comment?: string;\n}\n\nexport interface ScenarioList {\n  scenarios: Scenario[];\n  /** Index of the currently active scenario. */\n  current?: number;\n  /** Index of the scenario shown by default. */\n  show?: number;\n  /** Range that the scenarios change (output cells). */\n  sqref?: MultiCellRange;\n}\n\nexport const makeScenarioInputCell = (opts: ScenarioInputCell): ScenarioInputCell => ({\n  ref: opts.ref,\n  val: opts.val,\n  ...(opts.deleted !== undefined ? { deleted: opts.deleted } : {}),\n  ...(opts.undone !== undefined ? { undone: opts.undone } : {}),\n  ...(opts.numFmtId !== undefined ? { numFmtId: opts.numFmtId } : {}),\n});\n\nexport const makeScenario = (opts: Scenario): Scenario => ({\n  name: opts.name,\n  inputCells: opts.inputCells.slice(),\n  ...(opts.locked !== undefined ? { locked: opts.locked } : {}),\n  ...(opts.hidden !== undefined ? { hidden: opts.hidden } : {}),\n  ...(opts.user !== undefined ? { user: opts.user } : {}),\n  ...(opts.comment !== undefined ? { comment: opts.comment } : {}),\n});\n\nexport const makeScenarioList = (opts: Partial<ScenarioList> = {}): ScenarioList => ({\n  scenarios: opts.scenarios?.slice() ?? [],\n  ...(opts.current !== undefined ? { current: opts.current } : {}),\n  ...(opts.show !== undefined ? { show: opts.show } : {}),\n  ...(opts.sqref !== undefined ? { sqref: opts.sqref } : {}),\n});\n"],"mappings":"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"}

package/dist/writer-DspzfkNA.mjs

@@ -0,0 +1,221 @@
+import { a as OpenXmlNotImplementedError, i as OpenXmlIoError } from "./exceptions-D-CFwxgm.mjs";
+import { Zip, ZipDeflate, ZipPassThrough } from "fflate";
+//#region src/zip/zip64-patch.ts
+const ZIP32_MAX_ENTRIES$1 = 65535;
+const ZIP32_MAX_U32 = 4294967295;
+const SIG_EOCD = 101010256;
+const SIG_ZIP64_EOCD = 101075792;
+const SIG_ZIP64_EOCD_LOCATOR = 117853008;
+const ZIP64_EOCD_SIZE = 56;
+const ZIP64_LOCATOR_SIZE = 20;
+const u16 = (b, o) => (b[o] ?? 0) | (b[o + 1] ?? 0) << 8;
+const u32 = (b, o) => {
+	const v0 = b[o] ?? 0;
+	const v1 = b[o + 1] ?? 0;
+	const v2 = b[o + 2] ?? 0;
+	const v3 = b[o + 3] ?? 0;
+	return (v0 | v1 << 8 | v2 << 16 | v3 << 24) >>> 0;
+};
+const writeU16 = (b, o, v) => {
+	b[o] = v & 255;
+	b[o + 1] = v >>> 8 & 255;
+};
+const writeU32 = (b, o, v) => {
+	b[o] = v & 255;
+	b[o + 1] = v >>> 8 & 255;
+	b[o + 2] = v >>> 16 & 255;
+	b[o + 3] = v >>> 24 & 255;
+};
+const writeU64 = (b, o, v) => {
+	const lo = v >>> 0;
+	const hi = Math.floor(v / 4294967296) >>> 0;
+	writeU32(b, o, lo);
+	writeU32(b, o + 4, hi);
+};
+const findEocdOffset = (bytes) => {
+	const minOffset = Math.max(0, bytes.length - 65557);
+	for (let p = bytes.length - 22; p >= minOffset; p--) if (u32(bytes, p) === SIG_EOCD) {
+		const commentLen = u16(bytes, p + 20);
+		if (p + 22 + commentLen === bytes.length) return p;
+	}
+	throw new OpenXmlIoError("zip64-patch: no End-of-Central-Directory signature found");
+};
+/**
+* Splice ZIP64 EOCD record + locator into fflate's final chunk and
+* patch the trailing EOCD entry-count fields with the 0xFFFF sentinel.
+*
+* `finalChunk` must be the [CD | EOCD] block fflate emits as its last
+* ondata callback (everything before it is per-entry LFH/data/DD that
+* we leave untouched). Returns a new chunk; the input is not mutated.
+*
+* Assumes per-entry sizes and central-directory offset fit in 32 bits;
+* throws if not (xlsx archives never approach those limits).
+*/
+function applyZip64EntryCountPatch(finalChunk, totalEntries) {
+	if (totalEntries <= ZIP32_MAX_ENTRIES$1) return finalChunk;
+	const eocdOffset = findEocdOffset(finalChunk);
+	const cdSize = u32(finalChunk, eocdOffset + 12);
+	const cdOffset = u32(finalChunk, eocdOffset + 16);
+	const commentLen = u16(finalChunk, eocdOffset + 20);
+	if (cdSize === ZIP32_MAX_U32 || cdOffset === ZIP32_MAX_U32) throw new OpenXmlNotImplementedError("zip64-patch: archive size or central-directory offset exceeds 4 GiB; full ZIP64 size support is not implemented (xlsx in practice stays well under 4 GiB).");
+	const globalEocdOffset = cdOffset + cdSize;
+	const eocdLen = 22 + commentLen;
+	const newChunkLen = eocdOffset + ZIP64_EOCD_SIZE + ZIP64_LOCATOR_SIZE + eocdLen;
+	const out = new Uint8Array(newChunkLen);
+	out.set(finalChunk.subarray(0, eocdOffset), 0);
+	const zip64Eocd = out.subarray(eocdOffset, eocdOffset + ZIP64_EOCD_SIZE);
+	writeU32(zip64Eocd, 0, SIG_ZIP64_EOCD);
+	writeU64(zip64Eocd, 4, ZIP64_EOCD_SIZE - 12);
+	writeU16(zip64Eocd, 12, 45);
+	writeU16(zip64Eocd, 14, 45);
+	writeU32(zip64Eocd, 16, 0);
+	writeU32(zip64Eocd, 20, 0);
+	writeU64(zip64Eocd, 24, totalEntries);
+	writeU64(zip64Eocd, 32, totalEntries);
+	writeU64(zip64Eocd, 40, cdSize);
+	writeU64(zip64Eocd, 48, cdOffset);
+	const locOffset = eocdOffset + ZIP64_EOCD_SIZE;
+	const locator = out.subarray(locOffset, locOffset + ZIP64_LOCATOR_SIZE);
+	writeU32(locator, 0, SIG_ZIP64_EOCD_LOCATOR);
+	writeU32(locator, 4, 0);
+	writeU64(locator, 8, globalEocdOffset);
+	writeU32(locator, 16, 1);
+	const newEocdOffset = locOffset + ZIP64_LOCATOR_SIZE;
+	out.set(finalChunk.subarray(eocdOffset, eocdOffset + eocdLen), newEocdOffset);
+	writeU16(out, newEocdOffset + 8, ZIP32_MAX_ENTRIES$1);
+	writeU16(out, newEocdOffset + 10, ZIP32_MAX_ENTRIES$1);
+	return out;
+}
+//#endregion
+//#region src/zip/writer.ts
+const ZIP32_MAX_ENTRIES = 65535;
+/**
+* ZIP writer backed by fflate's streaming `Zip` class. Entries are pushed
+* through `ZipDeflate` / `ZipPassThrough` streams as they arrive, so peak
+* memory stays at the size of the in-flight entry plus the output buffer rather
+* than the full archive.
+*
+* The sink contract is `toBytes()`, but that name is historical: the sink is
+* driven by a chunked `write(chunk)` API that fans bytes out as they arrive.
+* The buffered Node/browser sinks (`toBuffer`, `toBlob`, `toArrayBuffer`)
+* concatenate the chunks for a single-shot result; streaming sinks
+* (`toFile`, `toWritable`) forward each chunk to disk / the wrapped writable
+* without ever holding the full archive resident. Either kind plugs in here.
+*/
+function createZipWriter(sink) {
+	const writer = sink.toBytes();
+	let finalised;
+	let endCalled = false;
+	const seen = /* @__PURE__ */ new Set();
+	const errors = [];
+	let finalChunk;
+	let zipFinishResolve;
+	const zipFinishPromise = new Promise((resolve) => {
+		zipFinishResolve = resolve;
+	});
+	const zip = new Zip((err, chunk, final) => {
+		if (err) {
+			errors.push(err instanceof Error ? err : new Error(String(err)));
+			return;
+		}
+		if (chunk && chunk.byteLength > 0) if (final) finalChunk = chunk;
+		else writer.write(chunk);
+		if (final && zipFinishResolve) {
+			zipFinishResolve();
+			zipFinishResolve = void 0;
+		}
+	});
+	let streamingOpen = false;
+	const guardAdd = (path) => {
+		if (finalised !== void 0) throw new OpenXmlIoError("createZipWriter: addEntry after finalize");
+		if (streamingOpen) throw new OpenXmlIoError("createZipWriter: a streaming entry is still open — call end() first");
+		if (seen.has(path)) throw new OpenXmlIoError(`createZipWriter: duplicate entry "${path}"`);
+	};
+	return {
+		async addEntry(path, bytes, opts) {
+			if (!(bytes instanceof Uint8Array)) throw new OpenXmlIoError("createZipWriter: ReadableStream entries are not yet supported (deferred to streaming writer)");
+			guardAdd(path);
+			seen.add(path);
+			const file = opts?.compress ?? true ? new ZipDeflate(path) : new ZipPassThrough(path);
+			try {
+				zip.add(file);
+				file.push(bytes, true);
+			} catch (cause) {
+				throw new OpenXmlIoError(`createZipWriter: failed to add entry "${path}"`, { cause });
+			}
+			if (errors.length > 0) throw new OpenXmlIoError("createZipWriter: stream error during addEntry", { cause: errors[0] });
+		},
+		addStreamingEntry(path, opts) {
+			guardAdd(path);
+			seen.add(path);
+			streamingOpen = true;
+			const file = opts?.compress ?? true ? new ZipDeflate(path) : new ZipPassThrough(path);
+			try {
+				zip.add(file);
+			} catch (cause) {
+				streamingOpen = false;
+				throw new OpenXmlIoError(`createZipWriter: failed to open streaming entry "${path}"`, { cause });
+			}
+			let ended = false;
+			return {
+				write(chunk) {
+					if (ended) throw new OpenXmlIoError(`createZipWriter: write after end on "${path}"`);
+					if (!(chunk instanceof Uint8Array)) throw new OpenXmlIoError(`createZipWriter: streaming entry "${path}" chunk is not a Uint8Array`);
+					if (chunk.byteLength === 0) return;
+					try {
+						file.push(chunk, false);
+					} catch (cause) {
+						throw new OpenXmlIoError(`createZipWriter: failed to push chunk on "${path}"`, { cause });
+					}
+					if (errors.length > 0) throw new OpenXmlIoError("createZipWriter: stream error during write", { cause: errors[0] });
+				},
+				async end() {
+					if (ended) return;
+					ended = true;
+					try {
+						file.push(new Uint8Array(0), true);
+					} catch (cause) {
+						throw new OpenXmlIoError(`createZipWriter: failed to end streaming entry "${path}"`, { cause });
+					}
+					streamingOpen = false;
+					if (errors.length > 0) throw new OpenXmlIoError("createZipWriter: stream error during end", { cause: errors[0] });
+				}
+			};
+		},
+		async finalize() {
+			if (finalised !== void 0) return finalised;
+			if (streamingOpen) throw new OpenXmlIoError("createZipWriter: cannot finalize while a streaming entry is open");
+			finalised = (async () => {
+				try {
+					if (!endCalled) {
+						zip.end();
+						endCalled = true;
+					}
+				} catch (cause) {
+					throw new OpenXmlIoError("createZipWriter: failed to finalize zip archive", { cause });
+				}
+				await zipFinishPromise;
+				if (errors.length > 0) throw new OpenXmlIoError("createZipWriter: stream error during finalize", { cause: errors[0] });
+				if (finalChunk) {
+					const patched = seen.size > ZIP32_MAX_ENTRIES ? applyZip64EntryCountPatch(finalChunk, seen.size) : finalChunk;
+					writer.write(patched);
+				}
+				return writer.finish();
+			})();
+			return finalised;
+		},
+		abort(cause) {
+			if (finalised !== void 0) return;
+			finalised = Promise.resolve(new Uint8Array(0));
+			if (zipFinishResolve) {
+				zipFinishResolve();
+				zipFinishResolve = void 0;
+			}
+			writer.abort?.(cause);
+		}
+	};
+}
+//#endregion
+export { createZipWriter as t };
+
+//# sourceMappingURL=writer-DspzfkNA.mjs.map

package/dist/writer-DspzfkNA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"writer-DspzfkNA.mjs","names":["ZIP32_MAX_ENTRIES"],"sources":["../src/zip/zip64-patch.ts","../src/zip/writer.ts"],"sourcesContent":["// ZIP64 post-processing for archives whose entry count exceeds the\n// 16-bit ZIP32 cap (65535). fflate's `Zip` writer always emits a\n// plain ZIP32 EOCD; for archives with more entries we keep its\n// per-entry LFH/CDH layout (correct as long as no individual size or\n// offset overflows 32 bits) and splice in a ZIP64 End-of-Central-\n// Directory record + locator before the EOCD, then patch the EOCD's\n// entry-count fields with the 0xFFFF sentinel that signals \"consult\n// the ZIP64 record for the real values\".\n//\n// The input is fflate's *final* chunk — the trailing [CD | EOCD] block\n// it emits in one ondata callback when `Zip.end()` is called. The\n// preceding entry-data chunks have already been streamed to the sink,\n// so we operate on the final chunk in isolation. The global EOCD\n// offset (needed for the ZIP64 locator) is derivable from cd_offset +\n// cd_size carried in the EOCD itself, so no external bookkeeping is\n// required.\n//\n// Out of scope: per-entry sizes or central-directory offsets > 4 GiB.\n// xlsx archives don't approach those limits in practice; we throw a\n// clear error if we detect overflow there.\n\nimport { OpenXmlIoError, OpenXmlNotImplementedError } from '../utils/exceptions';\n\nconst ZIP32_MAX_ENTRIES = 0xffff;\nconst ZIP32_MAX_U32 = 0xffffffff;\nconst SIG_EOCD = 0x06054b50;\nconst SIG_ZIP64_EOCD = 0x06064b50;\nconst SIG_ZIP64_EOCD_LOCATOR = 0x07064b50;\n\nconst ZIP64_EOCD_SIZE = 56;\nconst ZIP64_LOCATOR_SIZE = 20;\n\nconst u16 = (b: Uint8Array, o: number): number => (b[o] ?? 0) | ((b[o + 1] ?? 0) << 8);\n\nconst u32 = (b: Uint8Array, o: number): number => {\n  const v0 = b[o] ?? 0;\n  const v1 = b[o + 1] ?? 0;\n  const v2 = b[o + 2] ?? 0;\n  const v3 = b[o + 3] ?? 0;\n  return (v0 | (v1 << 8) | (v2 << 16) | (v3 << 24)) >>> 0;\n};\n\nconst writeU16 = (b: Uint8Array, o: number, v: number): void => {\n  b[o] = v & 0xff;\n  b[o + 1] = (v >>> 8) & 0xff;\n};\n\nconst writeU32 = (b: Uint8Array, o: number, v: number): void => {\n  b[o] = v & 0xff;\n  b[o + 1] = (v >>> 8) & 0xff;\n  b[o + 2] = (v >>> 16) & 0xff;\n  b[o + 3] = (v >>> 24) & 0xff;\n};\n\nconst writeU64 = (b: Uint8Array, o: number, v: number): void => {\n  // JS Number safely represents integers up to 2^53 - 1, well beyond\n  // anything we'd ever emit here. Split via Math.floor + modulo to\n  // avoid bit-shift truncation at 32 bits.\n  const lo = v >>> 0;\n  const hi = Math.floor(v / 0x100000000) >>> 0;\n  writeU32(b, o, lo);\n  writeU32(b, o + 4, hi);\n};\n\nconst findEocdOffset = (bytes: Uint8Array): number => {\n  // EOCD is min 22 bytes and may be followed by up to 65535 bytes of\n  // archive comment. Scan backwards from the latest possible position.\n  const minOffset = Math.max(0, bytes.length - (22 + 0xffff));\n  for (let p = bytes.length - 22; p >= minOffset; p--) {\n    if (u32(bytes, p) === SIG_EOCD) {\n      const commentLen = u16(bytes, p + 20);\n      if (p + 22 + commentLen === bytes.length) return p;\n    }\n  }\n  throw new OpenXmlIoError('zip64-patch: no End-of-Central-Directory signature found');\n};\n\n/**\n * Splice ZIP64 EOCD record + locator into fflate's final chunk and\n * patch the trailing EOCD entry-count fields with the 0xFFFF sentinel.\n *\n * `finalChunk` must be the [CD | EOCD] block fflate emits as its last\n * ondata callback (everything before it is per-entry LFH/data/DD that\n * we leave untouched). Returns a new chunk; the input is not mutated.\n *\n * Assumes per-entry sizes and central-directory offset fit in 32 bits;\n * throws if not (xlsx archives never approach those limits).\n */\nexport function applyZip64EntryCountPatch(finalChunk: Uint8Array, totalEntries: number): Uint8Array {\n  if (totalEntries <= ZIP32_MAX_ENTRIES) return finalChunk;\n\n  const eocdOffset = findEocdOffset(finalChunk);\n\n  const cdSize = u32(finalChunk, eocdOffset + 12);\n  const cdOffset = u32(finalChunk, eocdOffset + 16);\n  const commentLen = u16(finalChunk, eocdOffset + 20);\n\n  if (cdSize === ZIP32_MAX_U32 || cdOffset === ZIP32_MAX_U32) {\n    throw new OpenXmlNotImplementedError(\n      'zip64-patch: archive size or central-directory offset exceeds 4 GiB; full ZIP64 size support is not implemented (xlsx in practice stays well under 4 GiB).',\n    );\n  }\n\n  // Where the EOCD starts in the *global* archive (before our patch).\n  // CD precedes EOCD with no gap, so global EOCD offset is just\n  // cd_offset + cd_size — the locator points here.\n  const globalEocdOffset = cdOffset + cdSize;\n\n  const eocdLen = 22 + commentLen;\n  const newChunkLen = eocdOffset + ZIP64_EOCD_SIZE + ZIP64_LOCATOR_SIZE + eocdLen;\n  const out = new Uint8Array(newChunkLen);\n\n  // Original CD bytes (everything before the EOCD).\n  out.set(finalChunk.subarray(0, eocdOffset), 0);\n\n  // ZIP64 EOCD record (56 bytes total).\n  const zip64Eocd = out.subarray(eocdOffset, eocdOffset + ZIP64_EOCD_SIZE);\n  writeU32(zip64Eocd, 0, SIG_ZIP64_EOCD);\n  // size_of_zip64_eocd = total_size - 12 (size field excludes signature + this field itself)\n  writeU64(zip64Eocd, 4, ZIP64_EOCD_SIZE - 12);\n  writeU16(zip64Eocd, 12, 45); // version made by (4.5 — first ZIP64 spec)\n  writeU16(zip64Eocd, 14, 45); // version needed\n  writeU32(zip64Eocd, 16, 0); // disk_number\n  writeU32(zip64Eocd, 20, 0); // disk_with_cd\n  writeU64(zip64Eocd, 24, totalEntries); // entries_on_this_disk\n  writeU64(zip64Eocd, 32, totalEntries); // total_entries\n  writeU64(zip64Eocd, 40, cdSize); // cd_size\n  writeU64(zip64Eocd, 48, cdOffset); // cd_offset\n\n  // ZIP64 EOCD locator (20 bytes).\n  const locOffset = eocdOffset + ZIP64_EOCD_SIZE;\n  const locator = out.subarray(locOffset, locOffset + ZIP64_LOCATOR_SIZE);\n  writeU32(locator, 0, SIG_ZIP64_EOCD_LOCATOR);\n  writeU32(locator, 4, 0); // disk_with_zip64_eocd\n  writeU64(locator, 8, globalEocdOffset);\n  writeU32(locator, 16, 1); // total_disks\n\n  // New EOCD: copy original then patch entry counts to the 0xFFFF\n  // sentinel. (fflate writes the low 16 bits of the true count there,\n  // which confuses readers that don't first look for the ZIP64 record.)\n  const newEocdOffset = locOffset + ZIP64_LOCATOR_SIZE;\n  out.set(finalChunk.subarray(eocdOffset, eocdOffset + eocdLen), newEocdOffset);\n  writeU16(out, newEocdOffset + 8, ZIP32_MAX_ENTRIES);\n  writeU16(out, newEocdOffset + 10, ZIP32_MAX_ENTRIES);\n\n  return out;\n}\n","// ZIP write layer. Streaming-deflate via fflate's `Zip` + per-entry\n// `ZipDeflate` / `ZipPassThrough` so the writer never holds the whole archive\n// in memory. Each addEntry pushes its bytes through the deflate stream and the\n// resulting ZIP chunks land on the sink one at a time — the buffered\n// `toBytes()` sink concatenates them on finish, while a streaming sink can\n// flush them as they arrive.\n//\n// ZIP64 (entry count > 65535): fflate's `Zip` emits a plain ZIP32 EOCD in all\n// cases, so on finalize we splice in a ZIP64 EOCD record + locator when needed\n// via `applyZip64EntryCountPatch`. That keeps the per-entry LFH/CDH layout\n// fflate produces and only rewrites the trailing records.\n//\n// Scope: this covers the entry-count-overflow case (the limit xlsx archives\n// realistically hit — `tens of millions of cells` → tens of thousands of\n// worksheet entries via the streaming writer). Per-entry compressed/uncompressed\n// sizes and the central-directory offset must still fit in 32 bits (≤ 4 GiB\n// each); a single >4 GiB entry would need full ZIP64 size support and\n// `applyZip64EntryCountPatch` throws `OpenXmlNotImplementedError` if we ever\n// detect that. xlsx workbooks don't approach that limit in practice, but the\n// constraint is real — surface it in your own size estimates.\n\nimport { Zip, ZipDeflate, ZipPassThrough } from 'fflate';\nimport type { XlsxSink } from '../io/sink';\nimport { OpenXmlIoError } from '../utils/exceptions';\nimport { applyZip64EntryCountPatch } from './zip64-patch';\n\nconst ZIP32_MAX_ENTRIES = 0xffff;\n\nexport interface ZipWriter {\n  /**\n   * Stage an entry. Bytes are pushed through fflate's `ZipDeflate` /\n   * `ZipPassThrough` stream synchronously, so the deflated chunks land on the\n   * sink as the call runs (no per-entry buffering — see the streaming-behaviour\n   * test in `tests/phase-1/zip/writer.test.ts`). Streams (`ReadableStream`)\n   * are not accepted today; pass an already-materialised entry, or use\n   * {@link addStreamingEntry} for chunked writes.\n   *\n   * `compress` defaults to `true`. Pass `false` for already-compressed payloads\n   * (PNG/JPEG/zip-as-binary content like vbaProject.bin) so we don't pay\n   * deflate costs for no gain.\n   */\n  addEntry(path: string, bytes: Uint8Array | ReadableStream<Uint8Array>, opts?: { compress?: boolean }): Promise<void>;\n\n  /**\n   * Open a streaming entry. Returns a writer the caller can `write()` chunks to\n   * and `end()` to seal the entry. Each chunk pushes through the same fflate\n   * `ZipDeflate` / `ZipPassThrough` machinery as `addEntry`, so peak memory\n   * stays at one chunk + deflate scratch even for multi-GB worksheets.\n   *\n   * Sequencing: only one streaming entry may be open at a time — `addEntry` and\n   * a second `addStreamingEntry` both throw until the current entry's `end()`\n   * resolves.\n   */\n  addStreamingEntry(path: string, opts?: { compress?: boolean }): StreamingEntryWriter;\n\n  /**\n   * Build the central directory and flush all bytes through the sink.\n   * Idempotent; subsequent calls resolve to the same payload.\n   */\n  finalize(): Promise<Uint8Array>;\n\n  /**\n   * Release the sink and underlying writer without producing a valid archive.\n   * Use this from a surrounding catch block when serialization fails part-way\n   * through — without it, streaming sinks (`toFile` / `toWritable`) keep their\n   * file descriptors / writables open and the half-written xlsx looks valid on\n   * disk. Idempotent; safe to call after `finalize()`.\n   */\n  abort(cause?: unknown): void;\n}\n\n/** Writer handle for a single streaming entry. */\nexport interface StreamingEntryWriter {\n  /** Push a chunk of bytes (already-encoded). Throws after `end()`. */\n  write(chunk: Uint8Array): void;\n  /** Seal the entry. Subsequent `write()` throws. Idempotent. */\n  end(): Promise<void>;\n}\n\n/**\n * ZIP writer backed by fflate's streaming `Zip` class. Entries are pushed\n * through `ZipDeflate` / `ZipPassThrough` streams as they arrive, so peak\n * memory stays at the size of the in-flight entry plus the output buffer rather\n * than the full archive.\n *\n * The sink contract is `toBytes()`, but that name is historical: the sink is\n * driven by a chunked `write(chunk)` API that fans bytes out as they arrive.\n * The buffered Node/browser sinks (`toBuffer`, `toBlob`, `toArrayBuffer`)\n * concatenate the chunks for a single-shot result; streaming sinks\n * (`toFile`, `toWritable`) forward each chunk to disk / the wrapped writable\n * without ever holding the full archive resident. Either kind plugs in here.\n */\nexport function createZipWriter(sink: XlsxSink): ZipWriter {\n  const writer = sink.toBytes();\n  let finalised: Promise<Uint8Array> | undefined;\n  let endCalled = false;\n  const seen = new Set<string>();\n  const errors: Error[] = [];\n  // fflate emits the [CD | EOCD] block in a single ondata call with\n  // `final=true`. We capture only that chunk so we can apply the ZIP64 patch on\n  // finalize; all preceding entry-data chunks stream straight to the sink to\n  // preserve the writer's incremental flushing contract.\n  let finalChunk: Uint8Array | undefined;\n  let zipFinishResolve: (() => void) | undefined;\n  const zipFinishPromise = new Promise<void>((resolve) => {\n    zipFinishResolve = resolve;\n  });\n\n  const zip = new Zip((err, chunk, final) => {\n    if (err) {\n      errors.push(err instanceof Error ? err : new Error(String(err)));\n      return;\n    }\n    // ZipDeflate emits an empty trailer chunk on the final callback even when\n    // there are no bytes; guard against pushing an undefined chunk.\n    if (chunk && chunk.byteLength > 0) {\n      if (final) {\n        // Buffer the trailing CD + EOCD block; written after possible patch.\n        finalChunk = chunk;\n      } else {\n        writer.write(chunk);\n      }\n    }\n    if (final && zipFinishResolve) {\n      zipFinishResolve();\n      zipFinishResolve = undefined;\n    }\n  });\n\n  let streamingOpen = false;\n\n  const guardAdd = (path: string): void => {\n    if (finalised !== undefined) {\n      throw new OpenXmlIoError('createZipWriter: addEntry after finalize');\n    }\n    if (streamingOpen) {\n      throw new OpenXmlIoError('createZipWriter: a streaming entry is still open — call end() first');\n    }\n    if (seen.has(path)) {\n      throw new OpenXmlIoError(`createZipWriter: duplicate entry \"${path}\"`);\n    }\n  };\n\n  return {\n    async addEntry(path, bytes, opts) {\n      if (!(bytes instanceof Uint8Array)) {\n        throw new OpenXmlIoError(\n          'createZipWriter: ReadableStream entries are not yet supported (deferred to streaming writer)',\n        );\n      }\n      guardAdd(path);\n      seen.add(path);\n      const compress = opts?.compress ?? true;\n      const file = compress ? new ZipDeflate(path) : new ZipPassThrough(path);\n      try {\n        zip.add(file);\n        file.push(bytes, /* final */ true);\n      } catch (cause) {\n        throw new OpenXmlIoError(`createZipWriter: failed to add entry \"${path}\"`, { cause });\n      }\n      if (errors.length > 0) {\n        throw new OpenXmlIoError('createZipWriter: stream error during addEntry', { cause: errors[0] });\n      }\n    },\n\n    addStreamingEntry(path, opts) {\n      guardAdd(path);\n      seen.add(path);\n      streamingOpen = true;\n      const compress = opts?.compress ?? true;\n      const file = compress ? new ZipDeflate(path) : new ZipPassThrough(path);\n      try {\n        zip.add(file);\n      } catch (cause) {\n        streamingOpen = false;\n        throw new OpenXmlIoError(`createZipWriter: failed to open streaming entry \"${path}\"`, { cause });\n      }\n      let ended = false;\n      return {\n        write(chunk: Uint8Array): void {\n          if (ended) throw new OpenXmlIoError(`createZipWriter: write after end on \"${path}\"`);\n          if (!(chunk instanceof Uint8Array)) {\n            throw new OpenXmlIoError(`createZipWriter: streaming entry \"${path}\" chunk is not a Uint8Array`);\n          }\n          if (chunk.byteLength === 0) return;\n          try {\n            file.push(chunk, /* final */ false);\n          } catch (cause) {\n            throw new OpenXmlIoError(`createZipWriter: failed to push chunk on \"${path}\"`, { cause });\n          }\n          if (errors.length > 0) {\n            throw new OpenXmlIoError('createZipWriter: stream error during write', { cause: errors[0] });\n          }\n        },\n        async end(): Promise<void> {\n          if (ended) return;\n          ended = true;\n          try {\n            file.push(new Uint8Array(0), /* final */ true);\n          } catch (cause) {\n            throw new OpenXmlIoError(`createZipWriter: failed to end streaming entry \"${path}\"`, { cause });\n          }\n          streamingOpen = false;\n          if (errors.length > 0) {\n            throw new OpenXmlIoError('createZipWriter: stream error during end', { cause: errors[0] });\n          }\n        },\n      };\n    },\n\n    async finalize() {\n      if (finalised !== undefined) return finalised;\n      if (streamingOpen) {\n        throw new OpenXmlIoError('createZipWriter: cannot finalize while a streaming entry is open');\n      }\n      finalised = (async () => {\n        try {\n          if (!endCalled) {\n            zip.end();\n            endCalled = true;\n          }\n        } catch (cause) {\n          throw new OpenXmlIoError('createZipWriter: failed to finalize zip archive', { cause });\n        }\n        await zipFinishPromise;\n        if (errors.length > 0) {\n          throw new OpenXmlIoError('createZipWriter: stream error during finalize', { cause: errors[0] });\n        }\n\n        // Apply the ZIP64 patch to fflate's [CD | EOCD] tail when the entry\n        // count exceeds ZIP32's 16-bit cap, then flush the (possibly patched)\n        // tail to the sink.\n        if (finalChunk) {\n          const patched =\n            seen.size > ZIP32_MAX_ENTRIES\n              ? applyZip64EntryCountPatch(finalChunk, seen.size)\n              : finalChunk;\n          writer.write(patched);\n        }\n        return writer.finish();\n      })();\n      return finalised;\n    },\n\n    abort(cause?: unknown): void {\n      if (finalised !== undefined) return;\n      // Mark finalised so any subsequent addEntry / finalize short-circuits.\n      finalised = Promise.resolve(new Uint8Array(0));\n      // Drop fflate's listener — we don't care about further `ondata` callbacks.\n      if (zipFinishResolve) {\n        zipFinishResolve();\n        zipFinishResolve = undefined;\n      }\n      writer.abort?.(cause);\n    },\n  };\n}\n"],"mappings":"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"}

package/dist/xml/index.d.ts

@@ -0,0 +1,10 @@
+export type { SaxEvent, SaxInput } from './iterparse';
+export { iterParse } from './iterparse';
+export { ACTIVEX_TYPE, ARC_APP, ARC_CONTENT_TYPES, ARC_CORE, ARC_CUSTOM, ARC_CUSTOM_UI, ARC_ROOT_RELS, ARC_SHARED_STRINGS, ARC_STYLE, ARC_THEME, ARC_WORKBOOK, ARC_WORKBOOK_RELS, C14_NS, C15_NS, C16_NS, CHART_DRAWING_NS, CHART_NS, CHART_TYPE, CHARTSHAPE_TYPE, CHARTSHEET_TYPE, COMMENTS_NS, COMMENTS_TYPE, CONTYPES_NS, COREPROPS_NS, CPROPS_FMTID, CPROPS_TYPE, CTRLPROPS_TYPE, CUSTOMUI_NS, CUSTPROPS_NS, CX_NS, DCMITYPE_NS, DCORE_NS, DCTERMS_NS, DCTERMS_PREFIX, DEFAULT_PREFIXES, DRAWING_NS, DRAWING_TYPE, EXTERNAL_LINK_NS, EXTERNAL_LINK_TYPE, IMAGE_NS, MARKUP_COMPAT_NS, PACKAGE_CHARTS, PACKAGE_CHARTSHEETS, PACKAGE_CHARTSHEETS_RELS, PACKAGE_DRAWINGS, PACKAGE_IMAGES, PACKAGE_PIVOT_CACHE, PACKAGE_PIVOT_TABLE, PACKAGE_PROPS, PACKAGE_RELS, PACKAGE_THEME, PACKAGE_WORKSHEET_RELS, PACKAGE_WORKSHEETS, PACKAGE_XL, PICTURE_NS, PKG_REL_NS, parseQName, qname, REL_NS, SHARED_STRINGS_TYPE, SHEET_DRAWING_NS, SHEET_MAIN_NS, STYLES_TYPE, THEME_TYPE, THREADED_COMMENTS_NS, VBA_TYPE, VML_NS, VTYPES_NS, WORKSHEET_TYPE, X14_NS, X15_NS, X16_NS, XLSM_TYPE, XLSX_TYPE, XLTM_TYPE, XLTX_TYPE, XML_NS, XPROPS_NS, XSI_NS, } from './namespaces';
+export { parseXml } from './parser';
+export type { SerializeOptions } from './serializer';
+export { serializeXml } from './serializer';
+export type { XmlStreamWriter, XmlStreamWriterOptions } from './stream-writer';
+export { createXmlStreamWriter } from './stream-writer';
+export type { XmlNode } from './tree';
+export { appendChild, el, elNs, findChild, findChildren } from './tree';