@office-kit/xlsx 0.9.2 → 0.10.0

package/dist/{table-BifavDVW.mjs → table-1P8we2gS.mjs}

@@ -1,4 +1,4 @@
-import { Sn as parseMultiCellRange } from "./worksheet-C6CWgvP5.mjs";
+import { on as parseMultiCellRange } from "./worksheet-C5Ensf_j.mjs";
 //#region src/worksheet/conditional-formatting.ts
 function makeConditionalFormatting(opts) {
 	return {
@@ -110,4 +110,4 @@ const addExcelTable = (wb, ws, opts) => {
 //#endregion
 export { makeCfRule as a, makeDataValidation as i, makeTableColumn as n, makeConditionalFormatting as o, makeTableDefinition as r, addExcelTable as t };
 
-//# sourceMappingURL=table-BifavDVW.mjs.map
+//# sourceMappingURL=table-1P8we2gS.mjs.map

package/dist/{table-BifavDVW.mjs.map → table-1P8we2gS.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"table-BifavDVW.mjs","names":[],"sources":["../src/worksheet/conditional-formatting.ts","../src/worksheet/data-validations.ts","../src/worksheet/table.ts"],"sourcesContent":["// Conditional formatting.\n//\n// Stage-1 covers the **value-based** rule kinds (cellIs / expression / top10 /\n// aboveAverage / containsText family / containsBlanks family / duplicateValues\n// / uniqueValues / timePeriod). The visual rule kinds — colorScale / dataBar /\n// iconSet — round-trip as opaque inner XML (`innerXml` field) so the data\n// survives a save / load cycle without our needing to model cfvo / colors /\n// iconSets fully.\n\nimport { escapeXmlAttr } from '../utils/escape';\nimport { OpenXmlSchemaError } from '../utils/exceptions';\nimport { type MultiCellRange, parseMultiCellRange } from './cell-range';\n\nexport type ConditionalFormattingRuleType =\n  | 'expression'\n  | 'cellIs'\n  | 'colorScale'\n  | 'dataBar'\n  | 'iconSet'\n  | 'top10'\n  | 'aboveAverage'\n  | 'uniqueValues'\n  | 'duplicateValues'\n  | 'containsText'\n  | 'notContainsText'\n  | 'beginsWith'\n  | 'endsWith'\n  | 'containsBlanks'\n  | 'notContainsBlanks'\n  | 'containsErrors'\n  | 'notContainsErrors'\n  | 'timePeriod';\n\nexport type CellIsOperator =\n  | 'lessThan'\n  | 'lessThanOrEqual'\n  | 'equal'\n  | 'notEqual'\n  | 'greaterThanOrEqual'\n  | 'greaterThan'\n  | 'between'\n  | 'notBetween';\n\nexport type TextOperator = 'containsText' | 'notContains' | 'beginsWith' | 'endsWith';\n\nexport type TimePeriod =\n  | 'today'\n  | 'yesterday'\n  | 'tomorrow'\n  | 'last7Days'\n  | 'thisMonth'\n  | 'lastMonth'\n  | 'nextMonth'\n  | 'thisWeek'\n  | 'lastWeek'\n  | 'nextWeek';\n\nexport interface ConditionalFormattingRule {\n  /** Wire-level rule kind. */\n  type: ConditionalFormattingRuleType;\n  /** 1-based priority — Excel evaluates lower priority first. */\n  priority: number;\n  /** Index into Stylesheet.dxfs for the cell-format applied when the rule fires. */\n  dxfId?: number;\n  /** Stop evaluating subsequent rules on the same cell when this rule matches. */\n  stopIfTrue?: boolean;\n  /** cellIs operator. */\n  operator?: CellIsOperator | TextOperator | string;\n  /** Comparison string for the contains-text family. */\n  text?: string;\n  /** top10: rank percentage flag. */\n  percent?: boolean;\n  /** top10: bottom-N flag (false = top-N, true = bottom-N). */\n  bottom?: boolean;\n  /** top10: rank value (defaults to 10). */\n  rank?: number;\n  /** aboveAverage: aboveAverage=\"0\" → below average. */\n  aboveAverage?: boolean;\n  /** aboveAverage: equalAverage flag. */\n  equalAverage?: boolean;\n  /** aboveAverage: stdDev. */\n  stdDev?: number;\n  /** timePeriod token. */\n  timePeriod?: TimePeriod;\n  /** 0..3 formula strings — varies by rule type. */\n  formulas: string[];\n  /**\n   * Raw inner XML for colorScale / dataBar / iconSet rules. Stage-1 stores the\n   * verbatim child markup so saves round-trip without our needing to model cfvo\n   * / colors / iconSets fully.\n   */\n  innerXml?: string;\n}\n\nexport interface ConditionalFormatting {\n  sqref: MultiCellRange;\n  rules: ConditionalFormattingRule[];\n  pivot?: boolean;\n}\n\nexport function makeConditionalFormatting(opts: {\n  sqref: MultiCellRange | string;\n  rules?: ConditionalFormattingRule[];\n  pivot?: boolean;\n}): ConditionalFormatting {\n  return {\n    sqref: typeof opts.sqref === 'string' ? parseMultiCellRange(opts.sqref) : opts.sqref,\n    rules: opts.rules ?? [],\n    ...(opts.pivot !== undefined ? { pivot: opts.pivot } : {}),\n  };\n}\n\nexport function makeCfRule(\n  opts: Partial<ConditionalFormattingRule> & {\n    type: ConditionalFormattingRuleType;\n    priority: number;\n  },\n): ConditionalFormattingRule {\n  return {\n    type: opts.type,\n    priority: opts.priority,\n    formulas: opts.formulas ?? [],\n    ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n    ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    ...(opts.operator !== undefined ? { operator: opts.operator } : {}),\n    ...(opts.text !== undefined ? { text: opts.text } : {}),\n    ...(opts.percent !== undefined ? { percent: opts.percent } : {}),\n    ...(opts.bottom !== undefined ? { bottom: opts.bottom } : {}),\n    ...(opts.rank !== undefined ? { rank: opts.rank } : {}),\n    ...(opts.aboveAverage !== undefined ? { aboveAverage: opts.aboveAverage } : {}),\n    ...(opts.equalAverage !== undefined ? { equalAverage: opts.equalAverage } : {}),\n    ...(opts.stdDev !== undefined ? { stdDev: opts.stdDev } : {}),\n    ...(opts.timePeriod !== undefined ? { timePeriod: opts.timePeriod } : {}),\n    ...(opts.innerXml !== undefined ? { innerXml: opts.innerXml } : {}),\n  };\n}\n\n// ---- Worksheet ergonomic builders ---------------------------------------\n\nimport type { Worksheet } from './worksheet';\n\nconst resolveCfSqref = (sqref: MultiCellRange | string): MultiCellRange =>\n  typeof sqref === 'string' ? parseMultiCellRange(sqref) : sqref;\n\nconst nextCfPriority = (ws: Worksheet): number => {\n  let max = 0;\n  for (const cf of ws.conditionalFormatting) {\n    for (const r of cf.rules) {\n      if (r.priority > max) max = r.priority;\n    }\n  }\n  return max + 1;\n};\n\n/** Push one CF rule onto the worksheet, wrapping it in a ConditionalFormatting block keyed off `sqref`. */\nconst pushRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  rule: ConditionalFormattingRule,\n): ConditionalFormattingRule => {\n  ws.conditionalFormatting.push(makeConditionalFormatting({ sqref: resolveCfSqref(sqref), rules: [rule] }));\n  return rule;\n};\n\n/**\n * \"If cell value [op] formula → apply dxf\". Mirrors Excel's \"Highlight Cell\n * Rules → ...\" UI.\n */\nexport const addCellIsRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: {\n    operator: CellIsOperator;\n    formula1: string;\n    formula2?: string;\n    dxfId?: number;\n    stopIfTrue?: boolean;\n    priority?: number;\n  },\n): ConditionalFormattingRule => {\n  const formulas = opts.formula2 !== undefined ? [opts.formula1, opts.formula2] : [opts.formula1];\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'cellIs',\n      priority: opts.priority ?? nextCfPriority(ws),\n      operator: opts.operator,\n      formulas,\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n      ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    }),\n  );\n};\n\n/** Top-N or bottom-N rule. `bottom: true` → bottom-N. `percent: true` → percentile. */\nexport const addTopNRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: { rank?: number; bottom?: boolean; percent?: boolean; dxfId?: number; priority?: number },\n): ConditionalFormattingRule => {\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'top10',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      ...(opts.rank !== undefined ? { rank: opts.rank } : {}),\n      ...(opts.bottom !== undefined ? { bottom: opts.bottom } : {}),\n      ...(opts.percent !== undefined ? { percent: opts.percent } : {}),\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n    }),\n  );\n};\n\n/** Above/below-average rule. `aboveAverage: false` → below-average; provide `stdDev` for ±N stddev. */\nexport const addAverageRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: {\n    aboveAverage?: boolean;\n    equalAverage?: boolean;\n    stdDev?: number;\n    dxfId?: number;\n    priority?: number;\n  },\n): ConditionalFormattingRule => {\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'aboveAverage',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      ...(opts.aboveAverage !== undefined ? { aboveAverage: opts.aboveAverage } : {}),\n      ...(opts.equalAverage !== undefined ? { equalAverage: opts.equalAverage } : {}),\n      ...(opts.stdDev !== undefined ? { stdDev: opts.stdDev } : {}),\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n    }),\n  );\n};\n\n/** Duplicate-values rule (each cell whose value appears more than once gets the dxf). */\nexport const addDuplicateValuesRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: { dxfId?: number; priority?: number; unique?: boolean } = {},\n): ConditionalFormattingRule => {\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: opts.unique ? 'uniqueValues' : 'duplicateValues',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n    }),\n  );\n};\n\n/** Free-form formula rule — any `=ISNUMBER(A1)`-style boolean expression. */\nexport const addFormulaRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: { formula: string; dxfId?: number; stopIfTrue?: boolean; priority?: number },\n): ConditionalFormattingRule => {\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'expression',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [opts.formula],\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n      ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    }),\n  );\n};\n\n/** Text-based rule (containsText / notContains / beginsWith / endsWith). */\nexport const addTextRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: { operator: TextOperator; text: string; dxfId?: number; priority?: number },\n): ConditionalFormattingRule => {\n  // Excel uses different `type` tokens for the four text operators.\n  const typeMap: Record<TextOperator, ConditionalFormattingRuleType> = {\n    containsText: 'containsText',\n    notContains: 'notContainsText',\n    beginsWith: 'beginsWith',\n    endsWith: 'endsWith',\n  };\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: typeMap[opts.operator],\n      priority: opts.priority ?? nextCfPriority(ws),\n      operator: opts.operator,\n      text: opts.text,\n      formulas: [],\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n    }),\n  );\n};\n\n// ---- Visual rule builders (colorScale / dataBar / iconSet) --------------\n\nexport type CfvoType = 'min' | 'max' | 'num' | 'percent' | 'percentile' | 'formula';\n\nexport interface Cfvo {\n  type: CfvoType;\n  /** Required for num / percent / percentile / formula; ignored for min / max. */\n  val?: string;\n}\n\nexport type IconSetStyle =\n  | '3Arrows'\n  | '3ArrowsGray'\n  | '3Flags'\n  | '3Signs'\n  | '3Symbols'\n  | '3Symbols2'\n  | '3TrafficLights1'\n  | '3TrafficLights2'\n  | '4Arrows'\n  | '4ArrowsGray'\n  | '4Rating'\n  | '4RedToBlack'\n  | '4TrafficLights'\n  | '5Arrows'\n  | '5ArrowsGray'\n  | '5Quarters'\n  | '5Rating';\n\nconst escapeAttr = escapeXmlAttr;\n\nconst renderCfvo = (c: Cfvo): string => {\n  if (c.type === 'min' || c.type === 'max') {\n    if (c.val === undefined) return `<cfvo type=\"${c.type}\"/>`;\n    return `<cfvo type=\"${c.type}\" val=\"${escapeAttr(c.val)}\"/>`;\n  }\n  if (c.val === undefined) {\n    throw new OpenXmlSchemaError(`cfvo type \"${c.type}\" requires val`);\n  }\n  return `<cfvo type=\"${c.type}\" val=\"${escapeAttr(c.val)}\"/>`;\n};\n\nconst renderColor = (hex: string): string => `<color rgb=\"${escapeAttr(hex)}\"/>`;\n\n/**\n * Color-scale rule — gradient between 2 or 3 reference points. Each cfvo pairs\n * with one color.\n */\nexport const addColorScaleRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: {\n    cfvos: ReadonlyArray<Cfvo>;\n    /** Hex strings, e.g. `'FFFF0000'`; one per cfvo. */\n    colors: ReadonlyArray<string>;\n    priority?: number;\n    stopIfTrue?: boolean;\n  },\n): ConditionalFormattingRule => {\n  if (opts.cfvos.length !== 2 && opts.cfvos.length !== 3) {\n    throw new OpenXmlSchemaError(`addColorScaleRule: cfvos must be length 2 or 3; got ${opts.cfvos.length}`);\n  }\n  if (opts.colors.length !== opts.cfvos.length) {\n    throw new OpenXmlSchemaError(\n      `addColorScaleRule: colors length (${opts.colors.length}) must match cfvos length (${opts.cfvos.length})`,\n    );\n  }\n  const inner = `<colorScale>${opts.cfvos.map(renderCfvo).join('')}${opts.colors.map(renderColor).join('')}</colorScale>`;\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'colorScale',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      innerXml: inner,\n      ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    }),\n  );\n};\n\n/**\n * Data-bar rule — a gradient bar inside each cell sized to the value. Defaults\n * to `min`/`max` cfvos so the bar spans the visible range.\n */\nexport const addDataBarRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: {\n    color: string;\n    minCfvo?: Cfvo;\n    maxCfvo?: Cfvo;\n    minLength?: number;\n    maxLength?: number;\n    showValue?: boolean;\n    priority?: number;\n    stopIfTrue?: boolean;\n  },\n): ConditionalFormattingRule => {\n  const min = opts.minCfvo ?? { type: 'min' };\n  const max = opts.maxCfvo ?? { type: 'max' };\n  let attrs = '';\n  if (opts.minLength !== undefined) attrs += ` minLength=\"${opts.minLength}\"`;\n  if (opts.maxLength !== undefined) attrs += ` maxLength=\"${opts.maxLength}\"`;\n  if (opts.showValue !== undefined) attrs += ` showValue=\"${opts.showValue ? '1' : '0'}\"`;\n  const inner = `<dataBar${attrs}>${renderCfvo(min)}${renderCfvo(max)}${renderColor(opts.color)}</dataBar>`;\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'dataBar',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      innerXml: inner,\n      ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    }),\n  );\n};\n\n/**\n * Icon-set rule — visual icons (arrows / lights / flags) drawn next to each\n * cell value. The number of cfvos depends on the icon set (3 for `3Arrows`, 4\n * for `4Arrows`, 5 for `5Arrows`, etc).\n */\nexport const addIconSetRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: {\n    iconSet: IconSetStyle | string;\n    cfvos: ReadonlyArray<Cfvo>;\n    reverse?: boolean;\n    showValue?: boolean;\n    percent?: boolean;\n    priority?: number;\n    stopIfTrue?: boolean;\n  },\n): ConditionalFormattingRule => {\n  if (opts.cfvos.length < 3 || opts.cfvos.length > 5) {\n    throw new OpenXmlSchemaError(`addIconSetRule: cfvos must be length 3..5; got ${opts.cfvos.length}`);\n  }\n  let attrs = ` iconSet=\"${escapeAttr(opts.iconSet)}\"`;\n  if (opts.reverse !== undefined) attrs += ` reverse=\"${opts.reverse ? '1' : '0'}\"`;\n  if (opts.showValue !== undefined) attrs += ` showValue=\"${opts.showValue ? '1' : '0'}\"`;\n  if (opts.percent !== undefined) attrs += ` percent=\"${opts.percent ? '1' : '0'}\"`;\n  const inner = `<iconSet${attrs}>${opts.cfvos.map(renderCfvo).join('')}</iconSet>`;\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'iconSet',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      innerXml: inner,\n      ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    }),\n  );\n};\n","// Data validations.\n//\n// A DataValidation entry attaches a constraint (one of seven type kinds,\n// optional operator, two formula slots) to a sqref-style MultiCellRange.\n// Stage-1 maps every OOXML attribute we have a use for; imeMode + numeric/value\n// clamps land later when phase 7's Asian-locale support catches up.\n\nimport { type MultiCellRange, parseMultiCellRange } from './cell-range';\n\nexport type DataValidationType = 'whole' | 'decimal' | 'list' | 'date' | 'time' | 'textLength' | 'custom';\nexport type DataValidationOperator =\n  | 'between'\n  | 'notBetween'\n  | 'equal'\n  | 'notEqual'\n  | 'greaterThan'\n  | 'greaterThanOrEqual'\n  | 'lessThan'\n  | 'lessThanOrEqual';\nexport type DataValidationErrorStyle = 'stop' | 'warning' | 'information';\n\nexport interface DataValidation {\n  /** Constraint kind. `'list'` is the dropdown form (formula1 = comma list or range). */\n  type: DataValidationType;\n  /** Comparison operator — only meaningful for whole/decimal/date/time/textLength. */\n  operator?: DataValidationOperator;\n  /** Lower-bound formula or list source. Always required for list/whole/decimal/date/time. */\n  formula1?: string;\n  /** Upper-bound formula. Used by between / notBetween only. */\n  formula2?: string;\n  /** Allow empty cells. */\n  allowBlank?: boolean;\n  /** Show the input message popover when the cell is selected. */\n  showInputMessage?: boolean;\n  /** Show the error message popover on invalid entry. */\n  showErrorMessage?: boolean;\n  errorTitle?: string;\n  error?: string;\n  errorStyle?: DataValidationErrorStyle;\n  promptTitle?: string;\n  prompt?: string;\n  /** Excel inverts this attribute: `showDropDown=\"1\"` actually *hides* the dropdown arrow on list-type validators. We mirror the wire form. */\n  showDropDown?: boolean;\n  /** Apply-to range (sqref). */\n  sqref: MultiCellRange;\n}\n\nexport function makeDataValidation(\n  opts: Omit<Partial<DataValidation>, 'sqref'> & {\n    type: DataValidationType;\n    sqref: MultiCellRange | string;\n  },\n): DataValidation {\n  return {\n    type: opts.type,\n    sqref: typeof opts.sqref === 'string' ? parseMultiCellRange(opts.sqref) : opts.sqref,\n    ...(opts.operator !== undefined ? { operator: opts.operator } : {}),\n    ...(opts.formula1 !== undefined ? { formula1: opts.formula1 } : {}),\n    ...(opts.formula2 !== undefined ? { formula2: opts.formula2 } : {}),\n    ...(opts.allowBlank !== undefined ? { allowBlank: opts.allowBlank } : {}),\n    ...(opts.showInputMessage !== undefined ? { showInputMessage: opts.showInputMessage } : {}),\n    ...(opts.showErrorMessage !== undefined ? { showErrorMessage: opts.showErrorMessage } : {}),\n    ...(opts.errorTitle !== undefined ? { errorTitle: opts.errorTitle } : {}),\n    ...(opts.error !== undefined ? { error: opts.error } : {}),\n    ...(opts.errorStyle !== undefined ? { errorStyle: opts.errorStyle } : {}),\n    ...(opts.promptTitle !== undefined ? { promptTitle: opts.promptTitle } : {}),\n    ...(opts.prompt !== undefined ? { prompt: opts.prompt } : {}),\n    ...(opts.showDropDown !== undefined ? { showDropDown: opts.showDropDown } : {}),\n  };\n}\n\n// ---- Worksheet ergonomic builders ---------------------------------------\n\nimport type { Worksheet } from './worksheet';\n\nconst resolveSqref = (sqref: MultiCellRange | string): MultiCellRange =>\n  typeof sqref === 'string' ? parseMultiCellRange(sqref) : sqref;\n\nexport interface ValidationCommon {\n  /** Show the dropdown / input prompt when the cell is selected. */\n  prompt?: string;\n  promptTitle?: string;\n  /** Show an error dialog when the user types an invalid value. */\n  error?: string;\n  errorTitle?: string;\n  errorStyle?: DataValidationErrorStyle;\n  allowBlank?: boolean;\n}\n\n/**\n * Add a list-type dropdown validation to a range. `values` may be an inline\n * list (`['Red', 'Green', 'Blue']`) or a sheet reference\n * (`'=Sheet1!$A$1:$A$10'`).\n */\nexport const addListValidation = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  values: ReadonlyArray<string> | string,\n  opts: ValidationCommon = {},\n): DataValidation => {\n  const formula1 = Array.isArray(values)\n    ? `\"${(values as ReadonlyArray<string>).join(',')}\"`\n    : (values as string);\n  const dv = makeDataValidation({\n    type: 'list',\n    sqref: resolveSqref(sqref),\n    formula1,\n    allowBlank: opts.allowBlank ?? true,\n    showInputMessage: opts.prompt !== undefined,\n    showErrorMessage: opts.error !== undefined || opts.errorStyle !== undefined,\n    ...(opts.errorStyle !== undefined ? { errorStyle: opts.errorStyle } : {}),\n    ...(opts.error !== undefined ? { error: opts.error } : {}),\n    ...(opts.errorTitle !== undefined ? { errorTitle: opts.errorTitle } : {}),\n    ...(opts.prompt !== undefined ? { prompt: opts.prompt } : {}),\n    ...(opts.promptTitle !== undefined ? { promptTitle: opts.promptTitle } : {}),\n  });\n  ws.dataValidations.push(dv);\n  return dv;\n};\n\n/**\n * Add a number-range validation. `between(min, max)` matches Excel's \"Whole\n * Number\" → \"between\" form by default. Use `kind: 'decimal'` for decimal\n * (default 'whole').\n */\nexport const addNumberValidation = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  range: { min: number; max?: number; operator?: DataValidationOperator; kind?: 'whole' | 'decimal' },\n  opts: ValidationCommon = {},\n): DataValidation => {\n  const operator: DataValidationOperator =\n    range.operator ?? (range.max !== undefined ? 'between' : 'greaterThanOrEqual');\n  const dv = makeDataValidation({\n    type: range.kind ?? 'whole',\n    sqref: resolveSqref(sqref),\n    operator,\n    formula1: String(range.min),\n    ...(range.max !== undefined ? { formula2: String(range.max) } : {}),\n    allowBlank: opts.allowBlank ?? true,\n    showInputMessage: opts.prompt !== undefined,\n    showErrorMessage: opts.error !== undefined || opts.errorStyle !== undefined,\n    ...(opts.errorStyle !== undefined ? { errorStyle: opts.errorStyle } : {}),\n    ...(opts.error !== undefined ? { error: opts.error } : {}),\n    ...(opts.errorTitle !== undefined ? { errorTitle: opts.errorTitle } : {}),\n    ...(opts.prompt !== undefined ? { prompt: opts.prompt } : {}),\n    ...(opts.promptTitle !== undefined ? { promptTitle: opts.promptTitle } : {}),\n  });\n  ws.dataValidations.push(dv);\n  return dv;\n};\n\n/**\n * Add a date-range validation. Dates are passed as Excel serial numbers (use\n * `dateToExcel` to convert from JS `Date`).\n */\nexport const addDateValidation = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  range: { min: number; max?: number; operator?: DataValidationOperator },\n  opts: ValidationCommon = {},\n): DataValidation => {\n  const operator: DataValidationOperator =\n    range.operator ?? (range.max !== undefined ? 'between' : 'greaterThanOrEqual');\n  const dv = makeDataValidation({\n    type: 'date',\n    sqref: resolveSqref(sqref),\n    operator,\n    formula1: String(range.min),\n    ...(range.max !== undefined ? { formula2: String(range.max) } : {}),\n    allowBlank: opts.allowBlank ?? true,\n    showInputMessage: opts.prompt !== undefined,\n    showErrorMessage: opts.error !== undefined || opts.errorStyle !== undefined,\n    ...(opts.errorStyle !== undefined ? { errorStyle: opts.errorStyle } : {}),\n    ...(opts.error !== undefined ? { error: opts.error } : {}),\n    ...(opts.errorTitle !== undefined ? { errorTitle: opts.errorTitle } : {}),\n    ...(opts.prompt !== undefined ? { prompt: opts.prompt } : {}),\n    ...(opts.promptTitle !== undefined ? { promptTitle: opts.promptTitle } : {}),\n  });\n  ws.dataValidations.push(dv);\n  return dv;\n};\n\n/** Add a custom-formula validation (`formula1` evaluated for each cell). */\nexport const addCustomValidation = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  formula: string,\n  opts: ValidationCommon = {},\n): DataValidation => {\n  const dv = makeDataValidation({\n    type: 'custom',\n    sqref: resolveSqref(sqref),\n    formula1: formula,\n    allowBlank: opts.allowBlank ?? true,\n    showInputMessage: opts.prompt !== undefined,\n    showErrorMessage: opts.error !== undefined || opts.errorStyle !== undefined,\n    ...(opts.errorStyle !== undefined ? { errorStyle: opts.errorStyle } : {}),\n    ...(opts.error !== undefined ? { error: opts.error } : {}),\n    ...(opts.errorTitle !== undefined ? { errorTitle: opts.errorTitle } : {}),\n    ...(opts.prompt !== undefined ? { prompt: opts.prompt } : {}),\n    ...(opts.promptTitle !== undefined ? { promptTitle: opts.promptTitle } : {}),\n  });\n  ws.dataValidations.push(dv);\n  return dv;\n};\n","// Excel Table object (xl/tables/tableN.xml).\n//\n// Tables ride on top of a worksheet range, give it a name + structured column\n// references, and own their own AutoFilter. Each table sits in a separate part\n// — the worksheet only carries a `<tableParts>` block pointing at the\n// workbook-rels rId. Stage-1 covers the table shell + columns + styleInfo +\n// autoFilter; sortState / totals row formulas / calculated column formulas /\n// xml extlst are reserved for later.\n\nimport type { Workbook } from '../workbook/workbook';\nimport type { AutoFilter } from './auto-filter';\nimport type { Worksheet } from './worksheet';\n\nexport interface TableColumn {\n  /** 1-based column id (per-table). */\n  id: number;\n  /** Header name. */\n  name: string;\n  /** Totals-row aggregation function. */\n  totalsRowFunction?: 'sum' | 'min' | 'max' | 'count' | 'countNums' | 'average' | 'stdDev' | 'var' | 'custom';\n  /** Override label for the totals row. */\n  totalsRowLabel?: string;\n  /** Custom totals-row formula text. */\n  totalsRowFormula?: string;\n  /** Calculated-column formula. */\n  calculatedColumnFormula?: string;\n}\n\nexport interface TableStyleInfo {\n  /** Built-in style name (TableStyleMedium2, etc) or custom. */\n  name?: string;\n  showFirstColumn?: boolean;\n  showLastColumn?: boolean;\n  showRowStripes?: boolean;\n  showColumnStripes?: boolean;\n}\n\nexport interface TableDefinition {\n  /** Workbook-unique id (`<table id=\"N\">`). */\n  id: number;\n  /** Workbook-unique displayName — Excel surfaces this in formulas. */\n  displayName: string;\n  /** Optional friendly name; usually matches `displayName`. */\n  name?: string;\n  /** Range covered by the table, e.g. \"A1:E10\". */\n  ref: string;\n  /** Number of header rows. Defaults to 1; 0 means a header-less table. */\n  headerRowCount?: number;\n  /** Number of totals rows. */\n  totalsRowCount?: number;\n  /** Whether the totals row is currently visible. */\n  totalsRowShown?: boolean;\n  styleInfo?: TableStyleInfo;\n  columns: TableColumn[];\n  autoFilter?: AutoFilter;\n  /** Worksheet-rels rId — populated on read; the writer assigns its own. */\n  rId?: string;\n}\n\nexport function makeTableColumn(opts: { id: number; name: string }): TableColumn {\n  return { id: opts.id, name: opts.name };\n}\n\nexport function makeTableDefinition(opts: {\n  id: number;\n  displayName: string;\n  ref: string;\n  name?: string;\n  columns?: TableColumn[];\n  headerRowCount?: number;\n  totalsRowCount?: number;\n  totalsRowShown?: boolean;\n  styleInfo?: TableStyleInfo;\n  autoFilter?: AutoFilter;\n}): TableDefinition {\n  return {\n    id: opts.id,\n    displayName: opts.displayName,\n    ref: opts.ref,\n    columns: opts.columns ?? [],\n    ...(opts.name !== undefined ? { name: opts.name } : {}),\n    ...(opts.headerRowCount !== undefined ? { headerRowCount: opts.headerRowCount } : {}),\n    ...(opts.totalsRowCount !== undefined ? { totalsRowCount: opts.totalsRowCount } : {}),\n    ...(opts.totalsRowShown !== undefined ? { totalsRowShown: opts.totalsRowShown } : {}),\n    ...(opts.styleInfo ? { styleInfo: opts.styleInfo } : {}),\n    ...(opts.autoFilter ? { autoFilter: opts.autoFilter } : {}),\n  };\n}\n\nconst nextTableId = (wb: Workbook): number => {\n  let max = 0;\n  for (const ref of wb.sheets) {\n    if (ref.kind !== 'worksheet') continue;\n    for (const t of ref.sheet.tables) {\n      if (t.id > max) max = t.id;\n    }\n  }\n  return max + 1;\n};\n\n/**\n * High-level wrapper that builds a TableDefinition + pushes it onto `ws.tables`\n * in one call. Auto-assigns the workbook-unique `id`, derives `displayName`\n * from the supplied `name`, and constructs `TableColumn` records (1-based ids)\n * from a string-array shorthand.\n */\nexport const addExcelTable = (\n  wb: Workbook,\n  ws: Worksheet,\n  opts: {\n    name: string;\n    ref: string;\n    columns: ReadonlyArray<string | TableColumn>;\n    style?: string;\n    styleInfo?: TableStyleInfo;\n    headerRowCount?: number;\n    totalsRowCount?: number;\n    totalsRowShown?: boolean;\n    autoFilter?: AutoFilter;\n    displayName?: string;\n  },\n): TableDefinition => {\n  const cols: TableColumn[] = opts.columns.map((c, i): TableColumn =>\n    typeof c === 'string' ? { id: i + 1, name: c } : c,\n  );\n  const styleInfo: TableStyleInfo | undefined =\n    opts.styleInfo ??\n    (opts.style !== undefined ? { name: opts.style, showRowStripes: true, showColumnStripes: false } : undefined);\n  const def: TableDefinition = makeTableDefinition({\n    id: nextTableId(wb),\n    displayName: opts.displayName ?? opts.name,\n    name: opts.name,\n    ref: opts.ref,\n    columns: cols,\n    ...(opts.headerRowCount !== undefined ? { headerRowCount: opts.headerRowCount } : {}),\n    ...(opts.totalsRowCount !== undefined ? { totalsRowCount: opts.totalsRowCount } : {}),\n    ...(opts.totalsRowShown !== undefined ? { totalsRowShown: opts.totalsRowShown } : {}),\n    ...(styleInfo ? { styleInfo } : {}),\n    ...(opts.autoFilter ? { autoFilter: opts.autoFilter } : {}),\n  });\n  ws.tables.push(def);\n  return def;\n};\n"],"mappings":";;AAoGA,SAAgB,0BAA0B,MAIhB;CACxB,OAAO;EACL,OAAO,OAAO,KAAK,UAAU,WAAW,oBAAoB,KAAK,KAAK,IAAI,KAAK;EAC/E,OAAO,KAAK,SAAS,CAAC;EACtB,GAAI,KAAK,UAAU,KAAA,IAAY,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;CAC1D;AACF;AAEA,SAAgB,WACd,MAI2B;CAC3B,OAAO;EACL,MAAM,KAAK;EACX,UAAU,KAAK;EACf,UAAU,KAAK,YAAY,CAAC;EAC5B,GAAI,KAAK,UAAU,KAAA,IAAY,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;EACxD,GAAI,KAAK,eAAe,KAAA,IAAY,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;EACvE,GAAI,KAAK,aAAa,KAAA,IAAY,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;EACjE,GAAI,KAAK,SAAS,KAAA,IAAY,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;EACrD,GAAI,KAAK,YAAY,KAAA,IAAY,EAAE,SAAS,KAAK,QAAQ,IAAI,CAAC;EAC9D,GAAI,KAAK,WAAW,KAAA,IAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;EAC3D,GAAI,KAAK,SAAS,KAAA,IAAY,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;EACrD,GAAI,KAAK,iBAAiB,KAAA,IAAY,EAAE,cAAc,KAAK,aAAa,IAAI,CAAC;EAC7E,GAAI,KAAK,iBAAiB,KAAA,IAAY,EAAE,cAAc,KAAK,aAAa,IAAI,CAAC;EAC7E,GAAI,KAAK,WAAW,KAAA,IAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;EAC3D,GAAI,KAAK,eAAe,KAAA,IAAY,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;EACvE,GAAI,KAAK,aAAa,KAAA,IAAY,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;CACnE;AACF;;;ACxFA,SAAgB,mBACd,MAIgB;CAChB,OAAO;EACL,MAAM,KAAK;EACX,OAAO,OAAO,KAAK,UAAU,WAAW,oBAAoB,KAAK,KAAK,IAAI,KAAK;EAC/E,GAAI,KAAK,aAAa,KAAA,IAAY,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;EACjE,GAAI,KAAK,aAAa,KAAA,IAAY,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;EACjE,GAAI,KAAK,aAAa,KAAA,IAAY,EAAE,UAAU,KAAK,SAAS,IAAI,CAAC;EACjE,GAAI,KAAK,eAAe,KAAA,IAAY,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;EACvE,GAAI,KAAK,qBAAqB,KAAA,IAAY,EAAE,kBAAkB,KAAK,iBAAiB,IAAI,CAAC;EACzF,GAAI,KAAK,qBAAqB,KAAA,IAAY,EAAE,kBAAkB,KAAK,iBAAiB,IAAI,CAAC;EACzF,GAAI,KAAK,eAAe,KAAA,IAAY,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;EACvE,GAAI,KAAK,UAAU,KAAA,IAAY,EAAE,OAAO,KAAK,MAAM,IAAI,CAAC;EACxD,GAAI,KAAK,eAAe,KAAA,IAAY,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;EACvE,GAAI,KAAK,gBAAgB,KAAA,IAAY,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;EAC1E,GAAI,KAAK,WAAW,KAAA,IAAY,EAAE,QAAQ,KAAK,OAAO,IAAI,CAAC;EAC3D,GAAI,KAAK,iBAAiB,KAAA,IAAY,EAAE,cAAc,KAAK,aAAa,IAAI,CAAC;CAC/E;AACF;;;ACVA,SAAgB,gBAAgB,MAAiD;CAC/E,OAAO;EAAE,IAAI,KAAK;EAAI,MAAM,KAAK;CAAK;AACxC;AAEA,SAAgB,oBAAoB,MAWhB;CAClB,OAAO;EACL,IAAI,KAAK;EACT,aAAa,KAAK;EAClB,KAAK,KAAK;EACV,SAAS,KAAK,WAAW,CAAC;EAC1B,GAAI,KAAK,SAAS,KAAA,IAAY,EAAE,MAAM,KAAK,KAAK,IAAI,CAAC;EACrD,GAAI,KAAK,mBAAmB,KAAA,IAAY,EAAE,gBAAgB,KAAK,eAAe,IAAI,CAAC;EACnF,GAAI,KAAK,mBAAmB,KAAA,IAAY,EAAE,gBAAgB,KAAK,eAAe,IAAI,CAAC;EACnF,GAAI,KAAK,mBAAmB,KAAA,IAAY,EAAE,gBAAgB,KAAK,eAAe,IAAI,CAAC;EACnF,GAAI,KAAK,YAAY,EAAE,WAAW,KAAK,UAAU,IAAI,CAAC;EACtD,GAAI,KAAK,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;CAC3D;AACF;AAEA,MAAM,eAAe,OAAyB;CAC5C,IAAI,MAAM;CACV,KAAK,MAAM,OAAO,GAAG,QAAQ;EAC3B,IAAI,IAAI,SAAS,aAAa;EAC9B,KAAK,MAAM,KAAK,IAAI,MAAM,QACxB,IAAI,EAAE,KAAK,KAAK,MAAM,EAAE;CAE5B;CACA,OAAO,MAAM;AACf;;;;;;;AAQA,MAAa,iBACX,IACA,IACA,SAYoB;CACpB,MAAM,OAAsB,KAAK,QAAQ,KAAK,GAAG,MAC/C,OAAO,MAAM,WAAW;EAAE,IAAI,IAAI;EAAG,MAAM;CAAE,IAAI,CACnD;CACA,MAAM,YACJ,KAAK,cACJ,KAAK,UAAU,KAAA,IAAY;EAAE,MAAM,KAAK;EAAO,gBAAgB;EAAM,mBAAmB;CAAM,IAAI,KAAA;CACrG,MAAM,MAAuB,oBAAoB;EAC/C,IAAI,YAAY,EAAE;EAClB,aAAa,KAAK,eAAe,KAAK;EACtC,MAAM,KAAK;EACX,KAAK,KAAK;EACV,SAAS;EACT,GAAI,KAAK,mBAAmB,KAAA,IAAY,EAAE,gBAAgB,KAAK,eAAe,IAAI,CAAC;EACnF,GAAI,KAAK,mBAAmB,KAAA,IAAY,EAAE,gBAAgB,KAAK,eAAe,IAAI,CAAC;EACnF,GAAI,KAAK,mBAAmB,KAAA,IAAY,EAAE,gBAAgB,KAAK,eAAe,IAAI,CAAC;EACnF,GAAI,YAAY,EAAE,UAAU,IAAI,CAAC;EACjC,GAAI,KAAK,aAAa,EAAE,YAAY,KAAK,WAAW,IAAI,CAAC;CAC3D,CAAC;CACD,GAAG,OAAO,KAAK,GAAG;CAClB,OAAO;AACT"}
+{"version":3,"file":"table-1P8we2gS.mjs","names":[],"sources":["../src/worksheet/conditional-formatting.ts","../src/worksheet/data-validations.ts","../src/worksheet/table.ts"],"sourcesContent":["// Conditional formatting.\n//\n// Stage-1 covers the **value-based** rule kinds (cellIs / expression / top10 /\n// aboveAverage / containsText family / containsBlanks family / duplicateValues\n// / uniqueValues / timePeriod). The visual rule kinds — colorScale / dataBar /\n// iconSet — round-trip as opaque inner XML (`innerXml` field) so the data\n// survives a save / load cycle without our needing to model cfvo / colors /\n// iconSets fully.\n\nimport { escapeXmlAttr } from '../utils/escape';\nimport { OpenXmlSchemaError } from '../utils/exceptions';\nimport { type MultiCellRange, parseMultiCellRange } from './cell-range';\n\nexport type ConditionalFormattingRuleType =\n  | 'expression'\n  | 'cellIs'\n  | 'colorScale'\n  | 'dataBar'\n  | 'iconSet'\n  | 'top10'\n  | 'aboveAverage'\n  | 'uniqueValues'\n  | 'duplicateValues'\n  | 'containsText'\n  | 'notContainsText'\n  | 'beginsWith'\n  | 'endsWith'\n  | 'containsBlanks'\n  | 'notContainsBlanks'\n  | 'containsErrors'\n  | 'notContainsErrors'\n  | 'timePeriod';\n\nexport type CellIsOperator =\n  | 'lessThan'\n  | 'lessThanOrEqual'\n  | 'equal'\n  | 'notEqual'\n  | 'greaterThanOrEqual'\n  | 'greaterThan'\n  | 'between'\n  | 'notBetween';\n\nexport type TextOperator = 'containsText' | 'notContains' | 'beginsWith' | 'endsWith';\n\nexport type TimePeriod =\n  | 'today'\n  | 'yesterday'\n  | 'tomorrow'\n  | 'last7Days'\n  | 'thisMonth'\n  | 'lastMonth'\n  | 'nextMonth'\n  | 'thisWeek'\n  | 'lastWeek'\n  | 'nextWeek';\n\nexport interface ConditionalFormattingRule {\n  /** Wire-level rule kind. */\n  type: ConditionalFormattingRuleType;\n  /** 1-based priority — Excel evaluates lower priority first. */\n  priority: number;\n  /** Index into Stylesheet.dxfs for the cell-format applied when the rule fires. */\n  dxfId?: number;\n  /** Stop evaluating subsequent rules on the same cell when this rule matches. */\n  stopIfTrue?: boolean;\n  /** cellIs operator. */\n  operator?: CellIsOperator | TextOperator | string;\n  /** Comparison string for the contains-text family. */\n  text?: string;\n  /** top10: rank percentage flag. */\n  percent?: boolean;\n  /** top10: bottom-N flag (false = top-N, true = bottom-N). */\n  bottom?: boolean;\n  /** top10: rank value (defaults to 10). */\n  rank?: number;\n  /** aboveAverage: aboveAverage=\"0\" → below average. */\n  aboveAverage?: boolean;\n  /** aboveAverage: equalAverage flag. */\n  equalAverage?: boolean;\n  /** aboveAverage: stdDev. */\n  stdDev?: number;\n  /** timePeriod token. */\n  timePeriod?: TimePeriod;\n  /** 0..3 formula strings — varies by rule type. */\n  formulas: string[];\n  /**\n   * Raw inner XML for colorScale / dataBar / iconSet rules. Stage-1 stores the\n   * verbatim child markup so saves round-trip without our needing to model cfvo\n   * / colors / iconSets fully.\n   */\n  innerXml?: string;\n}\n\nexport interface ConditionalFormatting {\n  sqref: MultiCellRange;\n  rules: ConditionalFormattingRule[];\n  pivot?: boolean;\n}\n\nexport function makeConditionalFormatting(opts: {\n  sqref: MultiCellRange | string;\n  rules?: ConditionalFormattingRule[];\n  pivot?: boolean;\n}): ConditionalFormatting {\n  return {\n    sqref: typeof opts.sqref === 'string' ? parseMultiCellRange(opts.sqref) : opts.sqref,\n    rules: opts.rules ?? [],\n    ...(opts.pivot !== undefined ? { pivot: opts.pivot } : {}),\n  };\n}\n\nexport function makeCfRule(\n  opts: Partial<ConditionalFormattingRule> & {\n    type: ConditionalFormattingRuleType;\n    priority: number;\n  },\n): ConditionalFormattingRule {\n  return {\n    type: opts.type,\n    priority: opts.priority,\n    formulas: opts.formulas ?? [],\n    ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n    ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    ...(opts.operator !== undefined ? { operator: opts.operator } : {}),\n    ...(opts.text !== undefined ? { text: opts.text } : {}),\n    ...(opts.percent !== undefined ? { percent: opts.percent } : {}),\n    ...(opts.bottom !== undefined ? { bottom: opts.bottom } : {}),\n    ...(opts.rank !== undefined ? { rank: opts.rank } : {}),\n    ...(opts.aboveAverage !== undefined ? { aboveAverage: opts.aboveAverage } : {}),\n    ...(opts.equalAverage !== undefined ? { equalAverage: opts.equalAverage } : {}),\n    ...(opts.stdDev !== undefined ? { stdDev: opts.stdDev } : {}),\n    ...(opts.timePeriod !== undefined ? { timePeriod: opts.timePeriod } : {}),\n    ...(opts.innerXml !== undefined ? { innerXml: opts.innerXml } : {}),\n  };\n}\n\n// ---- Worksheet ergonomic builders ---------------------------------------\n\nimport type { Worksheet } from './worksheet';\n\nconst resolveCfSqref = (sqref: MultiCellRange | string): MultiCellRange =>\n  typeof sqref === 'string' ? parseMultiCellRange(sqref) : sqref;\n\nconst nextCfPriority = (ws: Worksheet): number => {\n  let max = 0;\n  for (const cf of ws.conditionalFormatting) {\n    for (const r of cf.rules) {\n      if (r.priority > max) max = r.priority;\n    }\n  }\n  return max + 1;\n};\n\n/** Push one CF rule onto the worksheet, wrapping it in a ConditionalFormatting block keyed off `sqref`. */\nconst pushRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  rule: ConditionalFormattingRule,\n): ConditionalFormattingRule => {\n  ws.conditionalFormatting.push(makeConditionalFormatting({ sqref: resolveCfSqref(sqref), rules: [rule] }));\n  return rule;\n};\n\n/**\n * \"If cell value [op] formula → apply dxf\". Mirrors Excel's \"Highlight Cell\n * Rules → ...\" UI.\n */\nexport const addCellIsRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: {\n    operator: CellIsOperator;\n    formula1: string;\n    formula2?: string;\n    dxfId?: number;\n    stopIfTrue?: boolean;\n    priority?: number;\n  },\n): ConditionalFormattingRule => {\n  const formulas = opts.formula2 !== undefined ? [opts.formula1, opts.formula2] : [opts.formula1];\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'cellIs',\n      priority: opts.priority ?? nextCfPriority(ws),\n      operator: opts.operator,\n      formulas,\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n      ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    }),\n  );\n};\n\n/** Top-N or bottom-N rule. `bottom: true` → bottom-N. `percent: true` → percentile. */\nexport const addTopNRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: { rank?: number; bottom?: boolean; percent?: boolean; dxfId?: number; priority?: number },\n): ConditionalFormattingRule => {\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'top10',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      ...(opts.rank !== undefined ? { rank: opts.rank } : {}),\n      ...(opts.bottom !== undefined ? { bottom: opts.bottom } : {}),\n      ...(opts.percent !== undefined ? { percent: opts.percent } : {}),\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n    }),\n  );\n};\n\n/** Above/below-average rule. `aboveAverage: false` → below-average; provide `stdDev` for ±N stddev. */\nexport const addAverageRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: {\n    aboveAverage?: boolean;\n    equalAverage?: boolean;\n    stdDev?: number;\n    dxfId?: number;\n    priority?: number;\n  },\n): ConditionalFormattingRule => {\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'aboveAverage',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      ...(opts.aboveAverage !== undefined ? { aboveAverage: opts.aboveAverage } : {}),\n      ...(opts.equalAverage !== undefined ? { equalAverage: opts.equalAverage } : {}),\n      ...(opts.stdDev !== undefined ? { stdDev: opts.stdDev } : {}),\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n    }),\n  );\n};\n\n/** Duplicate-values rule (each cell whose value appears more than once gets the dxf). */\nexport const addDuplicateValuesRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: { dxfId?: number; priority?: number; unique?: boolean } = {},\n): ConditionalFormattingRule => {\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: opts.unique ? 'uniqueValues' : 'duplicateValues',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n    }),\n  );\n};\n\n/** Free-form formula rule — any `=ISNUMBER(A1)`-style boolean expression. */\nexport const addFormulaRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: { formula: string; dxfId?: number; stopIfTrue?: boolean; priority?: number },\n): ConditionalFormattingRule => {\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'expression',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [opts.formula],\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n      ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    }),\n  );\n};\n\n/** Text-based rule (containsText / notContains / beginsWith / endsWith). */\nexport const addTextRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: { operator: TextOperator; text: string; dxfId?: number; priority?: number },\n): ConditionalFormattingRule => {\n  // Excel uses different `type` tokens for the four text operators.\n  const typeMap: Record<TextOperator, ConditionalFormattingRuleType> = {\n    containsText: 'containsText',\n    notContains: 'notContainsText',\n    beginsWith: 'beginsWith',\n    endsWith: 'endsWith',\n  };\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: typeMap[opts.operator],\n      priority: opts.priority ?? nextCfPriority(ws),\n      operator: opts.operator,\n      text: opts.text,\n      formulas: [],\n      ...(opts.dxfId !== undefined ? { dxfId: opts.dxfId } : {}),\n    }),\n  );\n};\n\n// ---- Visual rule builders (colorScale / dataBar / iconSet) --------------\n\nexport type CfvoType = 'min' | 'max' | 'num' | 'percent' | 'percentile' | 'formula';\n\nexport interface Cfvo {\n  type: CfvoType;\n  /** Required for num / percent / percentile / formula; ignored for min / max. */\n  val?: string;\n}\n\nexport type IconSetStyle =\n  | '3Arrows'\n  | '3ArrowsGray'\n  | '3Flags'\n  | '3Signs'\n  | '3Symbols'\n  | '3Symbols2'\n  | '3TrafficLights1'\n  | '3TrafficLights2'\n  | '4Arrows'\n  | '4ArrowsGray'\n  | '4Rating'\n  | '4RedToBlack'\n  | '4TrafficLights'\n  | '5Arrows'\n  | '5ArrowsGray'\n  | '5Quarters'\n  | '5Rating';\n\nconst escapeAttr = escapeXmlAttr;\n\nconst renderCfvo = (c: Cfvo): string => {\n  if (c.type === 'min' || c.type === 'max') {\n    if (c.val === undefined) return `<cfvo type=\"${c.type}\"/>`;\n    return `<cfvo type=\"${c.type}\" val=\"${escapeAttr(c.val)}\"/>`;\n  }\n  if (c.val === undefined) {\n    throw new OpenXmlSchemaError(`cfvo type \"${c.type}\" requires val`);\n  }\n  return `<cfvo type=\"${c.type}\" val=\"${escapeAttr(c.val)}\"/>`;\n};\n\nconst renderColor = (hex: string): string => `<color rgb=\"${escapeAttr(hex)}\"/>`;\n\n/**\n * Color-scale rule — gradient between 2 or 3 reference points. Each cfvo pairs\n * with one color.\n */\nexport const addColorScaleRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: {\n    cfvos: ReadonlyArray<Cfvo>;\n    /** Hex strings, e.g. `'FFFF0000'`; one per cfvo. */\n    colors: ReadonlyArray<string>;\n    priority?: number;\n    stopIfTrue?: boolean;\n  },\n): ConditionalFormattingRule => {\n  if (opts.cfvos.length !== 2 && opts.cfvos.length !== 3) {\n    throw new OpenXmlSchemaError(`addColorScaleRule: cfvos must be length 2 or 3; got ${opts.cfvos.length}`);\n  }\n  if (opts.colors.length !== opts.cfvos.length) {\n    throw new OpenXmlSchemaError(\n      `addColorScaleRule: colors length (${opts.colors.length}) must match cfvos length (${opts.cfvos.length})`,\n    );\n  }\n  const inner = `<colorScale>${opts.cfvos.map(renderCfvo).join('')}${opts.colors.map(renderColor).join('')}</colorScale>`;\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'colorScale',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      innerXml: inner,\n      ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    }),\n  );\n};\n\n/**\n * Data-bar rule — a gradient bar inside each cell sized to the value. Defaults\n * to `min`/`max` cfvos so the bar spans the visible range.\n */\nexport const addDataBarRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: {\n    color: string;\n    minCfvo?: Cfvo;\n    maxCfvo?: Cfvo;\n    minLength?: number;\n    maxLength?: number;\n    showValue?: boolean;\n    priority?: number;\n    stopIfTrue?: boolean;\n  },\n): ConditionalFormattingRule => {\n  const min = opts.minCfvo ?? { type: 'min' };\n  const max = opts.maxCfvo ?? { type: 'max' };\n  let attrs = '';\n  if (opts.minLength !== undefined) attrs += ` minLength=\"${opts.minLength}\"`;\n  if (opts.maxLength !== undefined) attrs += ` maxLength=\"${opts.maxLength}\"`;\n  if (opts.showValue !== undefined) attrs += ` showValue=\"${opts.showValue ? '1' : '0'}\"`;\n  const inner = `<dataBar${attrs}>${renderCfvo(min)}${renderCfvo(max)}${renderColor(opts.color)}</dataBar>`;\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'dataBar',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      innerXml: inner,\n      ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    }),\n  );\n};\n\n/**\n * Icon-set rule — visual icons (arrows / lights / flags) drawn next to each\n * cell value. The number of cfvos depends on the icon set (3 for `3Arrows`, 4\n * for `4Arrows`, 5 for `5Arrows`, etc).\n */\nexport const addIconSetRule = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  opts: {\n    iconSet: IconSetStyle | string;\n    cfvos: ReadonlyArray<Cfvo>;\n    reverse?: boolean;\n    showValue?: boolean;\n    percent?: boolean;\n    priority?: number;\n    stopIfTrue?: boolean;\n  },\n): ConditionalFormattingRule => {\n  if (opts.cfvos.length < 3 || opts.cfvos.length > 5) {\n    throw new OpenXmlSchemaError(`addIconSetRule: cfvos must be length 3..5; got ${opts.cfvos.length}`);\n  }\n  let attrs = ` iconSet=\"${escapeAttr(opts.iconSet)}\"`;\n  if (opts.reverse !== undefined) attrs += ` reverse=\"${opts.reverse ? '1' : '0'}\"`;\n  if (opts.showValue !== undefined) attrs += ` showValue=\"${opts.showValue ? '1' : '0'}\"`;\n  if (opts.percent !== undefined) attrs += ` percent=\"${opts.percent ? '1' : '0'}\"`;\n  const inner = `<iconSet${attrs}>${opts.cfvos.map(renderCfvo).join('')}</iconSet>`;\n  return pushRule(\n    ws,\n    sqref,\n    makeCfRule({\n      type: 'iconSet',\n      priority: opts.priority ?? nextCfPriority(ws),\n      formulas: [],\n      innerXml: inner,\n      ...(opts.stopIfTrue !== undefined ? { stopIfTrue: opts.stopIfTrue } : {}),\n    }),\n  );\n};\n","// Data validations.\n//\n// A DataValidation entry attaches a constraint (one of seven type kinds,\n// optional operator, two formula slots) to a sqref-style MultiCellRange.\n// Stage-1 maps every OOXML attribute we have a use for; imeMode + numeric/value\n// clamps land later when phase 7's Asian-locale support catches up.\n\nimport { type MultiCellRange, parseMultiCellRange } from './cell-range';\n\nexport type DataValidationType = 'whole' | 'decimal' | 'list' | 'date' | 'time' | 'textLength' | 'custom';\nexport type DataValidationOperator =\n  | 'between'\n  | 'notBetween'\n  | 'equal'\n  | 'notEqual'\n  | 'greaterThan'\n  | 'greaterThanOrEqual'\n  | 'lessThan'\n  | 'lessThanOrEqual';\nexport type DataValidationErrorStyle = 'stop' | 'warning' | 'information';\n\nexport interface DataValidation {\n  /** Constraint kind. `'list'` is the dropdown form (formula1 = comma list or range). */\n  type: DataValidationType;\n  /** Comparison operator — only meaningful for whole/decimal/date/time/textLength. */\n  operator?: DataValidationOperator;\n  /** Lower-bound formula or list source. Always required for list/whole/decimal/date/time. */\n  formula1?: string;\n  /** Upper-bound formula. Used by between / notBetween only. */\n  formula2?: string;\n  /** Allow empty cells. */\n  allowBlank?: boolean;\n  /** Show the input message popover when the cell is selected. */\n  showInputMessage?: boolean;\n  /** Show the error message popover on invalid entry. */\n  showErrorMessage?: boolean;\n  errorTitle?: string;\n  error?: string;\n  errorStyle?: DataValidationErrorStyle;\n  promptTitle?: string;\n  prompt?: string;\n  /** Excel inverts this attribute: `showDropDown=\"1\"` actually *hides* the dropdown arrow on list-type validators. We mirror the wire form. */\n  showDropDown?: boolean;\n  /** Apply-to range (sqref). */\n  sqref: MultiCellRange;\n}\n\nexport function makeDataValidation(\n  opts: Omit<Partial<DataValidation>, 'sqref'> & {\n    type: DataValidationType;\n    sqref: MultiCellRange | string;\n  },\n): DataValidation {\n  return {\n    type: opts.type,\n    sqref: typeof opts.sqref === 'string' ? parseMultiCellRange(opts.sqref) : opts.sqref,\n    ...(opts.operator !== undefined ? { operator: opts.operator } : {}),\n    ...(opts.formula1 !== undefined ? { formula1: opts.formula1 } : {}),\n    ...(opts.formula2 !== undefined ? { formula2: opts.formula2 } : {}),\n    ...(opts.allowBlank !== undefined ? { allowBlank: opts.allowBlank } : {}),\n    ...(opts.showInputMessage !== undefined ? { showInputMessage: opts.showInputMessage } : {}),\n    ...(opts.showErrorMessage !== undefined ? { showErrorMessage: opts.showErrorMessage } : {}),\n    ...(opts.errorTitle !== undefined ? { errorTitle: opts.errorTitle } : {}),\n    ...(opts.error !== undefined ? { error: opts.error } : {}),\n    ...(opts.errorStyle !== undefined ? { errorStyle: opts.errorStyle } : {}),\n    ...(opts.promptTitle !== undefined ? { promptTitle: opts.promptTitle } : {}),\n    ...(opts.prompt !== undefined ? { prompt: opts.prompt } : {}),\n    ...(opts.showDropDown !== undefined ? { showDropDown: opts.showDropDown } : {}),\n  };\n}\n\n// ---- Worksheet ergonomic builders ---------------------------------------\n\nimport type { Worksheet } from './worksheet';\n\nconst resolveSqref = (sqref: MultiCellRange | string): MultiCellRange =>\n  typeof sqref === 'string' ? parseMultiCellRange(sqref) : sqref;\n\nexport interface ValidationCommon {\n  /** Show the dropdown / input prompt when the cell is selected. */\n  prompt?: string;\n  promptTitle?: string;\n  /** Show an error dialog when the user types an invalid value. */\n  error?: string;\n  errorTitle?: string;\n  errorStyle?: DataValidationErrorStyle;\n  allowBlank?: boolean;\n}\n\n/**\n * Add a list-type dropdown validation to a range. `values` may be an inline\n * list (`['Red', 'Green', 'Blue']`) or a sheet reference\n * (`'=Sheet1!$A$1:$A$10'`).\n */\nexport const addListValidation = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  values: ReadonlyArray<string> | string,\n  opts: ValidationCommon = {},\n): DataValidation => {\n  const formula1 = Array.isArray(values)\n    ? `\"${(values as ReadonlyArray<string>).join(',')}\"`\n    : (values as string);\n  const dv = makeDataValidation({\n    type: 'list',\n    sqref: resolveSqref(sqref),\n    formula1,\n    allowBlank: opts.allowBlank ?? true,\n    showInputMessage: opts.prompt !== undefined,\n    showErrorMessage: opts.error !== undefined || opts.errorStyle !== undefined,\n    ...(opts.errorStyle !== undefined ? { errorStyle: opts.errorStyle } : {}),\n    ...(opts.error !== undefined ? { error: opts.error } : {}),\n    ...(opts.errorTitle !== undefined ? { errorTitle: opts.errorTitle } : {}),\n    ...(opts.prompt !== undefined ? { prompt: opts.prompt } : {}),\n    ...(opts.promptTitle !== undefined ? { promptTitle: opts.promptTitle } : {}),\n  });\n  ws.dataValidations.push(dv);\n  return dv;\n};\n\n/**\n * Add a number-range validation. `between(min, max)` matches Excel's \"Whole\n * Number\" → \"between\" form by default. Use `kind: 'decimal'` for decimal\n * (default 'whole').\n */\nexport const addNumberValidation = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  range: { min: number; max?: number; operator?: DataValidationOperator; kind?: 'whole' | 'decimal' },\n  opts: ValidationCommon = {},\n): DataValidation => {\n  const operator: DataValidationOperator =\n    range.operator ?? (range.max !== undefined ? 'between' : 'greaterThanOrEqual');\n  const dv = makeDataValidation({\n    type: range.kind ?? 'whole',\n    sqref: resolveSqref(sqref),\n    operator,\n    formula1: String(range.min),\n    ...(range.max !== undefined ? { formula2: String(range.max) } : {}),\n    allowBlank: opts.allowBlank ?? true,\n    showInputMessage: opts.prompt !== undefined,\n    showErrorMessage: opts.error !== undefined || opts.errorStyle !== undefined,\n    ...(opts.errorStyle !== undefined ? { errorStyle: opts.errorStyle } : {}),\n    ...(opts.error !== undefined ? { error: opts.error } : {}),\n    ...(opts.errorTitle !== undefined ? { errorTitle: opts.errorTitle } : {}),\n    ...(opts.prompt !== undefined ? { prompt: opts.prompt } : {}),\n    ...(opts.promptTitle !== undefined ? { promptTitle: opts.promptTitle } : {}),\n  });\n  ws.dataValidations.push(dv);\n  return dv;\n};\n\n/**\n * Add a date-range validation. Dates are passed as Excel serial numbers (use\n * `dateToExcel` to convert from JS `Date`).\n */\nexport const addDateValidation = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  range: { min: number; max?: number; operator?: DataValidationOperator },\n  opts: ValidationCommon = {},\n): DataValidation => {\n  const operator: DataValidationOperator =\n    range.operator ?? (range.max !== undefined ? 'between' : 'greaterThanOrEqual');\n  const dv = makeDataValidation({\n    type: 'date',\n    sqref: resolveSqref(sqref),\n    operator,\n    formula1: String(range.min),\n    ...(range.max !== undefined ? { formula2: String(range.max) } : {}),\n    allowBlank: opts.allowBlank ?? true,\n    showInputMessage: opts.prompt !== undefined,\n    showErrorMessage: opts.error !== undefined || opts.errorStyle !== undefined,\n    ...(opts.errorStyle !== undefined ? { errorStyle: opts.errorStyle } : {}),\n    ...(opts.error !== undefined ? { error: opts.error } : {}),\n    ...(opts.errorTitle !== undefined ? { errorTitle: opts.errorTitle } : {}),\n    ...(opts.prompt !== undefined ? { prompt: opts.prompt } : {}),\n    ...(opts.promptTitle !== undefined ? { promptTitle: opts.promptTitle } : {}),\n  });\n  ws.dataValidations.push(dv);\n  return dv;\n};\n\n/** Add a custom-formula validation (`formula1` evaluated for each cell). */\nexport const addCustomValidation = (\n  ws: Worksheet,\n  sqref: MultiCellRange | string,\n  formula: string,\n  opts: ValidationCommon = {},\n): DataValidation => {\n  const dv = makeDataValidation({\n    type: 'custom',\n    sqref: resolveSqref(sqref),\n    formula1: formula,\n    allowBlank: opts.allowBlank ?? true,\n    showInputMessage: opts.prompt !== undefined,\n    showErrorMessage: opts.error !== undefined || opts.errorStyle !== undefined,\n    ...(opts.errorStyle !== undefined ? { errorStyle: opts.errorStyle } : {}),\n    ...(opts.error !== undefined ? { error: opts.error } : {}),\n    ...(opts.errorTitle !== undefined ? { errorTitle: opts.errorTitle } : {}),\n    ...(opts.prompt !== undefined ? { prompt: opts.prompt } : {}),\n    ...(opts.promptTitle !== undefined ? { promptTitle: opts.promptTitle } : {}),\n  });\n  ws.dataValidations.push(dv);\n  return dv;\n};\n","// Excel Table object (xl/tables/tableN.xml).\n//\n// Tables ride on top of a worksheet range, give it a name + structured column\n// references, and own their own AutoFilter. Each table sits in a separate part\n// — the worksheet only carries a `<tableParts>` block pointing at the\n// workbook-rels rId. Stage-1 covers the table shell + columns + styleInfo +\n// autoFilter; sortState / totals row formulas / calculated column formulas /\n// xml extlst are reserved for later.\n\nimport type { Workbook } from '../workbook/workbook';\nimport type { AutoFilter } from './auto-filter';\nimport type { Worksheet } from './worksheet';\n\nexport interface TableColumn {\n  /** 1-based column id (per-table). */\n  id: number;\n  /** Header name. */\n  name: string;\n  /** Totals-row aggregation function. */\n  totalsRowFunction?: 'sum' | 'min' | 'max' | 'count' | 'countNums' | 'average' | 'stdDev' | 'var' | 'custom';\n  /** Override label for the totals row. */\n  totalsRowLabel?: string;\n  /** Custom totals-row formula text. */\n  totalsRowFormula?: string;\n  /** Calculated-column formula. */\n  calculatedColumnFormula?: string;\n}\n\nexport interface TableStyleInfo {\n  /** Built-in style name (TableStyleMedium2, etc) or custom. */\n  name?: string;\n  showFirstColumn?: boolean;\n  showLastColumn?: boolean;\n  showRowStripes?: boolean;\n  showColumnStripes?: boolean;\n}\n\nexport interface TableDefinition {\n  /** Workbook-unique id (`<table id=\"N\">`). */\n  id: number;\n  /** Workbook-unique displayName — Excel surfaces this in formulas. */\n  displayName: string;\n  /** Optional friendly name; usually matches `displayName`. */\n  name?: string;\n  /** Range covered by the table, e.g. \"A1:E10\". */\n  ref: string;\n  /** Number of header rows. Defaults to 1; 0 means a header-less table. */\n  headerRowCount?: number;\n  /** Number of totals rows. */\n  totalsRowCount?: number;\n  /** Whether the totals row is currently visible. */\n  totalsRowShown?: boolean;\n  styleInfo?: TableStyleInfo;\n  columns: TableColumn[];\n  autoFilter?: AutoFilter;\n  /** Worksheet-rels rId — populated on read; the writer assigns its own. */\n  rId?: string;\n}\n\nexport function makeTableColumn(opts: { id: number; name: string }): TableColumn {\n  return { id: opts.id, name: opts.name };\n}\n\nexport function makeTableDefinition(opts: {\n  id: number;\n  displayName: string;\n  ref: string;\n  name?: string;\n  columns?: TableColumn[];\n  headerRowCount?: number;\n  totalsRowCount?: number;\n  totalsRowShown?: boolean;\n  styleInfo?: TableStyleInfo;\n  autoFilter?: AutoFilter;\n}): TableDefinition {\n  return {\n    id: opts.id,\n    displayName: opts.displayName,\n    ref: opts.ref,\n    columns: opts.columns ?? [],\n    ...(opts.name !== undefined ? { name: opts.name } : {}),\n    ...(opts.headerRowCount !== undefined ? { headerRowCount: opts.headerRowCount } : {}),\n    ...(opts.totalsRowCount !== undefined ? { totalsRowCount: opts.totalsRowCount } : {}),\n    ...(opts.totalsRowShown !== undefined ? { totalsRowShown: opts.totalsRowShown } : {}),\n    ...(opts.styleInfo ? { styleInfo: opts.styleInfo } : {}),\n    ...(opts.autoFilter ? { autoFilter: opts.autoFilter } : {}),\n  };\n}\n\nconst nextTableId = (wb: Workbook): number => {\n  let max = 0;\n  for (const ref of wb.sheets) {\n    if (ref.kind !== 'worksheet') continue;\n    for (const t of ref.sheet.tables) {\n      if (t.id > max) max = t.id;\n    }\n  }\n  return max + 1;\n};\n\n/**\n * High-level wrapper that builds a TableDefinition + pushes it onto `ws.tables`\n * in one call. Auto-assigns the workbook-unique `id`, derives `displayName`\n * from the supplied `name`, and constructs `TableColumn` records (1-based ids)\n * from a string-array shorthand.\n */\nexport const addExcelTable = (\n  wb: Workbook,\n  ws: Worksheet,\n  opts: {\n    name: string;\n    ref: string;\n    columns: ReadonlyArray<string | TableColumn>;\n    style?: string;\n    styleInfo?: TableStyleInfo;\n    headerRowCount?: number;\n    totalsRowCount?: number;\n    totalsRowShown?: boolean;\n    autoFilter?: AutoFilter;\n    displayName?: string;\n  },\n): TableDefinition => {\n  const cols: TableColumn[] = opts.columns.map((c, i): TableColumn =>\n    typeof c === 'string' ? { id: i + 1, name: c } : c,\n  );\n  const styleInfo: TableStyleInfo | undefined =\n    opts.styleInfo ??\n    (opts.style !== undefined ? { name: opts.style, showRowStripes: true, showColumnStripes: false } : undefined);\n  const def: TableDefinition = makeTableDefinition({\n    id: nextTableId(wb),\n    displayName: opts.displayName ?? opts.name,\n    name: opts.name,\n    ref: opts.ref,\n    columns: cols,\n    ...(opts.headerRowCount !== undefined ? { headerRowCount: opts.headerRowCount } : {}),\n    ...(opts.totalsRowCount !== undefined ? { totalsRowCount: opts.totalsRowCount } : {}),\n    ...(opts.totalsRowShown !== undefined ? { totalsRowShown: opts.totalsRowShown } : {}),\n    ...(styleInfo ? { styleInfo } : {}),\n    ...(opts.autoFilter ? { autoFilter: opts.autoFilter } : {}),\n  });\n  ws.tables.push(def);\n  return def;\n};\n"],"mappings":"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"}

package/dist/{tree-Bbs1C8Rc.mjs → tree-BX-sRRVp.mjs}

@@ -29,6 +29,7 @@ const CUSTOMUI_NS = "http://schemas.microsoft.com/office/2006/relationships/ui/e
 const MARKUP_COMPAT_NS = "http://schemas.openxmlformats.org/markup-compatibility/2006";
 const X14_NS = "http://schemas.microsoft.com/office/spreadsheetml/2009/9/main";
 const X15_NS = "http://schemas.microsoft.com/office/spreadsheetml/2010/11/main";
+const X15AC_NS = "http://schemas.microsoft.com/office/spreadsheetml/2010/11/ac";
 const X16_NS = "http://schemas.microsoft.com/office/spreadsheetml/2014/revision";
 const C14_NS = "http://schemas.microsoft.com/office/drawing/2010/chart";
 const C15_NS = "http://schemas.microsoft.com/office/drawing/2012/chart";
@@ -57,6 +58,7 @@ const DEFAULT_PREFIXES = Object.freeze({
 	[MARKUP_COMPAT_NS]: "mc",
 	[X14_NS]: "x14",
 	[X15_NS]: "x15",
+	[X15AC_NS]: "x15ac",
 	[X16_NS]: "x16",
 	[C14_NS]: "c14",
 	[C15_NS]: "c15",
@@ -189,4 +191,4 @@ function appendChild(parent, child) {
 //#endregion
 export { PACKAGE_PIVOT_CACHE as $, COREPROPS_NS as A, parseQName as At, DCTERMS_PREFIX as B, CHARTSHEET_TYPE as C, XLSM_TYPE as Ct, COMMENTS_NS as D, XML_NS as Dt, CHART_TYPE as E, XLTX_TYPE as Et, CUSTPROPS_NS as F, EXTERNAL_LINK_TYPE as G, DRAWING_NS as H, CX_NS as I, PACKAGE_CHARTS as J, IMAGE_NS as K, DCMITYPE_NS as L, CPROPS_TYPE as M, CTRLPROPS_TYPE as N, COMMENTS_TYPE as O, XPROPS_NS as Ot, CUSTOMUI_NS as P, PACKAGE_IMAGES as Q, DCORE_NS as R, CHARTSHAPE_TYPE as S, X16_NS as St, CHART_NS as T, XLTM_TYPE as Tt, DRAWING_TYPE as U, DEFAULT_PREFIXES as V, EXTERNAL_LINK_NS as W, PACKAGE_CHARTSHEETS_RELS as X, PACKAGE_CHARTSHEETS as Y, PACKAGE_DRAWINGS as Z, ARC_WORKBOOK_RELS as _, VML_NS as _t, findChildren as a, PACKAGE_WORKSHEET_RELS as at, C16_NS as b, X14_NS as bt, ARC_CONTENT_TYPES as c, PKG_REL_NS as ct, ARC_CUSTOM_UI as d, SHEET_DRAWING_NS as dt, PACKAGE_PIVOT_TABLE as et, ARC_ROOT_RELS as f, SHEET_MAIN_NS as ft, ARC_WORKBOOK as g, VBA_TYPE as gt, ARC_THEME as h, THREADED_COMMENTS_NS as ht, findChild as i, PACKAGE_WORKSHEETS as it, CPROPS_FMTID as j, qname as jt, CONTYPES_NS as k, XSI_NS as kt, ARC_CORE as l, REL_NS as lt, ARC_STYLE as m, THEME_TYPE as mt, el as n, PACKAGE_RELS as nt, ACTIVEX_TYPE as o, PACKAGE_XL as ot, ARC_SHARED_STRINGS as p, STYLES_TYPE as pt, MARKUP_COMPAT_NS as q, elNs as r, PACKAGE_THEME as rt, ARC_APP as s, PICTURE_NS as st, appendChild as t, PACKAGE_PROPS as tt, ARC_CUSTOM as u, SHARED_STRINGS_TYPE as ut, C14_NS as v, VTYPES_NS as vt, CHART_DRAWING_NS as w, XLSX_TYPE as wt, CHARTEX_TYPE as x, X15_NS as xt, C15_NS as y, WORKSHEET_TYPE as yt, DCTERMS_NS as z };
 
-//# sourceMappingURL=tree-Bbs1C8Rc.mjs.map
+//# sourceMappingURL=tree-BX-sRRVp.mjs.map

package/dist/tree-BX-sRRVp.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-BX-sRRVp.mjs","names":[],"sources":["../src/xml/namespaces.ts","../src/xml/tree.ts"],"sourcesContent":["// OOXML namespace and well-known package-path constants.\n//\n// Mirrors openpyxl/openpyxl/xml/constants.py so the test corpus stays directly\n// comparable. Where openpyxl exposes a single big dict (NAMESPACES) we keep\n// them as discrete `const` exports — bundlers can then drop the ones a given\n// build path never imports.\n\n// ---- W3C / Dublin Core ------------------------------------------------------\n\nexport const XML_NS = 'http://www.w3.org/XML/1998/namespace';\nexport const XSI_NS = 'http://www.w3.org/2001/XMLSchema-instance';\n\nexport const DCORE_NS = 'http://purl.org/dc/elements/1.1/';\nexport const DCTERMS_NS = 'http://purl.org/dc/terms/';\nexport const DCMITYPE_NS = 'http://purl.org/dc/dcmitype/';\nexport const DCTERMS_PREFIX = 'dcterms';\n\n// ---- ECMA-376 Office Document core ------------------------------------------\n\nconst DOC_NS = 'http://schemas.openxmlformats.org/officeDocument/2006/';\nexport const REL_NS = `${DOC_NS}relationships`;\nexport const COMMENTS_NS = `${REL_NS}/comments`;\nexport const IMAGE_NS = `${REL_NS}/image`;\nexport const VML_NS = `${REL_NS}/vmlDrawing`;\nexport const EXTERNAL_LINK_NS = `${REL_NS}/externalLink`;\nexport const VTYPES_NS = `${DOC_NS}docPropsVTypes`;\nexport const XPROPS_NS = `${DOC_NS}extended-properties`;\nexport const CUSTPROPS_NS = `${DOC_NS}custom-properties`;\nexport const CPROPS_FMTID = '{D5CDD505-2E9C-101B-9397-08002B2CF9AE}';\n\n// ---- Package layer ----------------------------------------------------------\n\nconst PKG_NS = 'http://schemas.openxmlformats.org/package/2006/';\nexport const PKG_REL_NS = `${PKG_NS}relationships`;\nexport const COREPROPS_NS = `${PKG_NS}metadata/core-properties`;\nexport const CONTYPES_NS = `${PKG_NS}content-types`;\n\n// ---- SpreadsheetML & DrawingML ----------------------------------------------\n\nexport const SHEET_MAIN_NS = 'http://schemas.openxmlformats.org/spreadsheetml/2006/main';\nexport const CHART_NS = 'http://schemas.openxmlformats.org/drawingml/2006/chart';\nexport const DRAWING_NS = 'http://schemas.openxmlformats.org/drawingml/2006/main';\nexport const SHEET_DRAWING_NS = 'http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing';\nexport const CHART_DRAWING_NS = 'http://schemas.openxmlformats.org/drawingml/2006/chartDrawing';\nexport const PICTURE_NS = 'http://schemas.openxmlformats.org/drawingml/2006/picture';\n\n// ---- Microsoft extensions ---------------------------------------------------\n\nexport const CUSTOMUI_NS = 'http://schemas.microsoft.com/office/2006/relationships/ui/extensibility';\nexport const MARKUP_COMPAT_NS = 'http://schemas.openxmlformats.org/markup-compatibility/2006';\nexport const X14_NS = 'http://schemas.microsoft.com/office/spreadsheetml/2009/9/main';\nexport const X15_NS = 'http://schemas.microsoft.com/office/spreadsheetml/2010/11/main';\n// \"Author capabilities\" — the namespace of the `<x15ac:absPath>` Excel writes\n// inside workbook.xml's `mc:Choice Requires=\"x15\"`. Only needed for its\n// canonical prefix, so it isn't exported.\nconst X15AC_NS = 'http://schemas.microsoft.com/office/spreadsheetml/2010/11/ac';\nexport const X16_NS = 'http://schemas.microsoft.com/office/spreadsheetml/2014/revision';\nexport const C14_NS = 'http://schemas.microsoft.com/office/drawing/2010/chart';\nexport const C15_NS = 'http://schemas.microsoft.com/office/drawing/2012/chart';\nexport const C16_NS = 'http://schemas.microsoft.com/office/drawing/2017/03/chart';\nexport const CX_NS = 'http://schemas.microsoft.com/office/drawing/2014/chartex';\nexport const THREADED_COMMENTS_NS = 'http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments';\n\n// ---- Default prefix map -----------------------------------------------------\n//\n// Used when serialising XmlNode trees back to text: prefer these prefixes for\n// namespaces we recognise so output matches what Excel / openpyxl\n// conventionally emit. Entries are intentionally short — full prefix discovery\n// falls back to auto-generated names (`ns0`, `ns1`, ...) for namespaces not\n// listed here.\n\nexport const DEFAULT_PREFIXES: Readonly<Record<string, string>> = Object.freeze({\n  [XML_NS]: 'xml',\n  [XSI_NS]: 'xsi',\n  [DCORE_NS]: 'dc',\n  [DCTERMS_NS]: DCTERMS_PREFIX,\n  [DCMITYPE_NS]: 'dcmitype',\n  [REL_NS]: 'r',\n  [VTYPES_NS]: 'vt',\n  // app.xml uses XPROPS_NS as its default namespace; custom.xml uses\n  // CUSTPROPS_NS the same way. Mark them as '' so serialised output matches\n  // Office / openpyxl convention out of the box.\n  [XPROPS_NS]: '',\n  [CUSTPROPS_NS]: '',\n  [PKG_REL_NS]: '',\n  [COREPROPS_NS]: 'cp',\n  [CONTYPES_NS]: '',\n  [SHEET_MAIN_NS]: '',\n  [CHART_NS]: 'c',\n  [DRAWING_NS]: 'a',\n  [SHEET_DRAWING_NS]: 'xdr',\n  [CHART_DRAWING_NS]: 'cdr',\n  [PICTURE_NS]: 'pic',\n  [MARKUP_COMPAT_NS]: 'mc',\n  [X14_NS]: 'x14',\n  [X15_NS]: 'x15',\n  [X15AC_NS]: 'x15ac',\n  [X16_NS]: 'x16',\n  [C14_NS]: 'c14',\n  [C15_NS]: 'c15',\n  [C16_NS]: 'c16',\n  [CX_NS]: 'cx',\n  [THREADED_COMMENTS_NS]: 'tc',\n});\n\n// ---- ZIP package paths ------------------------------------------------------\n\nexport const PACKAGE_PROPS = 'docProps';\nexport const PACKAGE_XL = 'xl';\nexport const PACKAGE_RELS = '_rels';\nexport const PACKAGE_THEME = `${PACKAGE_XL}/theme`;\nexport const PACKAGE_WORKSHEETS = `${PACKAGE_XL}/worksheets`;\nexport const PACKAGE_CHARTSHEETS = `${PACKAGE_XL}/chartsheets`;\nexport const PACKAGE_DRAWINGS = `${PACKAGE_XL}/drawings`;\nexport const PACKAGE_CHARTS = `${PACKAGE_XL}/charts`;\nexport const PACKAGE_IMAGES = `${PACKAGE_XL}/media`;\nexport const PACKAGE_PIVOT_TABLE = `${PACKAGE_XL}/pivotTables`;\nexport const PACKAGE_PIVOT_CACHE = `${PACKAGE_XL}/pivotCache`;\nexport const PACKAGE_WORKSHEET_RELS = `${PACKAGE_WORKSHEETS}/${PACKAGE_RELS}`;\nexport const PACKAGE_CHARTSHEETS_RELS = `${PACKAGE_CHARTSHEETS}/${PACKAGE_RELS}`;\n\nexport const ARC_CONTENT_TYPES = '[Content_Types].xml';\nexport const ARC_ROOT_RELS = `${PACKAGE_RELS}/.rels`;\nexport const ARC_WORKBOOK_RELS = `${PACKAGE_XL}/${PACKAGE_RELS}/workbook.xml.rels`;\nexport const ARC_CORE = `${PACKAGE_PROPS}/core.xml`;\nexport const ARC_APP = `${PACKAGE_PROPS}/app.xml`;\nexport const ARC_CUSTOM = `${PACKAGE_PROPS}/custom.xml`;\nexport const ARC_WORKBOOK = `${PACKAGE_XL}/workbook.xml`;\nexport const ARC_STYLE = `${PACKAGE_XL}/styles.xml`;\nexport const ARC_THEME = `${PACKAGE_THEME}/theme1.xml`;\nexport const ARC_SHARED_STRINGS = `${PACKAGE_XL}/sharedStrings.xml`;\nexport const ARC_CUSTOM_UI = 'customUI/customUI.xml';\n\n// ---- MIME / content-type strings -------------------------------------------\n\nconst WORKBOOK_TPL = 'application/vnd.openxmlformats-officedocument.spreadsheetml.%s.main+xml';\nconst SPREADSHEET_TPL = 'application/vnd.openxmlformats-officedocument.spreadsheetml.%s+xml';\nconst WORKBOOK_MACRO_TPL = 'application/vnd.ms-excel.%s.macroEnabled.main+xml';\nconst fmt = (tpl: string, kind: string): string => tpl.replace('%s', kind);\n\nexport const XLSX_TYPE = fmt(WORKBOOK_TPL, 'sheet');\nexport const XLTX_TYPE = fmt(WORKBOOK_TPL, 'template');\nexport const XLSM_TYPE = fmt(WORKBOOK_MACRO_TPL, 'sheet');\nexport const XLTM_TYPE = fmt(WORKBOOK_MACRO_TPL, 'template');\nexport const SHARED_STRINGS_TYPE = fmt(SPREADSHEET_TPL, 'sharedStrings');\nexport const EXTERNAL_LINK_TYPE = fmt(SPREADSHEET_TPL, 'externalLink');\nexport const WORKSHEET_TYPE = fmt(SPREADSHEET_TPL, 'worksheet');\nexport const COMMENTS_TYPE = fmt(SPREADSHEET_TPL, 'comments');\nexport const STYLES_TYPE = fmt(SPREADSHEET_TPL, 'styles');\nexport const CHARTSHEET_TYPE = fmt(SPREADSHEET_TPL, 'chartsheet');\nexport const DRAWING_TYPE = 'application/vnd.openxmlformats-officedocument.drawing+xml';\nexport const CHART_TYPE = 'application/vnd.openxmlformats-officedocument.drawingml.chart+xml';\nexport const CHARTEX_TYPE = 'application/vnd.ms-office.chartex+xml';\nexport const CHARTSHAPE_TYPE = 'application/vnd.openxmlformats-officedocument.drawingml.chartshapes+xml';\nexport const THEME_TYPE = 'application/vnd.openxmlformats-officedocument.theme+xml';\nexport const CPROPS_TYPE = 'application/vnd.openxmlformats-officedocument.custom-properties+xml';\nexport const VBA_TYPE = 'application/vnd.ms-office.vbaProject';\nexport const ACTIVEX_TYPE = 'application/vnd.ms-office.activeX+xml';\nexport const CTRLPROPS_TYPE = 'application/vnd.ms-excel.controlproperties+xml';\n\n// ---- QName helpers ----------------------------------------------------------\n\n/**\n * Build a Clark-notation QName: `{namespace}localname`. When `namespace` is\n * empty / undefined the local name is returned as-is.\n */\nexport function qname(namespace: string | undefined, local: string): string {\n  return namespace ? `{${namespace}}${local}` : local;\n}\n\nconst QNAME_RE = /^\\{([^}]*)\\}(.+)$/;\n\n/**\n * Inverse of {@link qname}. Returns `{ ns, local }`. For unprefixed names `ns`\n * is the empty string.\n */\nexport function parseQName(name: string): { ns: string; local: string } {\n  const m = QNAME_RE.exec(name);\n  if (m === null) return { ns: '', local: name };\n  return { ns: m[1] ?? '', local: m[2] ?? '' };\n}\n","// Lightweight XML tree representation used between the parser, the schema\n// layer, and the serializer.\n//\n// Plain object, no DOM, names in Clark notation `{ns}local` so namespace-aware\n// code does not depend on runtime prefix bookkeeping.\n\nimport { qname } from './namespaces';\n\nexport interface XmlNode {\n  /** Clark-notation qualified name: `{namespace}local` or just `local`. */\n  name: string;\n  /** Attribute table; values are always strings (no value coercion at this layer). */\n  attrs: Record<string, string>;\n  /**\n   * Optional element text. When an element has both text and child elements,\n   * callers should set `text` and rely on `children` for mixed content; the\n   * serializer emits `text` then children.\n   */\n  text?: string;\n  /** Child element nodes in document order. */\n  children: XmlNode[];\n}\n\n/**\n * Build an XmlNode from primitive bits. Attributes / children default to empty;\n * pass `undefined` for `text` to omit the text node.\n *\n * The element's name is always supplied in Clark notation. Use the {@link\n * qname} helper from `./namespaces` to keep call sites readable.\n */\nexport function el(\n  name: string,\n  attrs: Readonly<Record<string, string | number | boolean | null | undefined>> = {},\n  children: ReadonlyArray<XmlNode> = [],\n  text?: string,\n): XmlNode {\n  const out: XmlNode = {\n    name,\n    attrs: normaliseAttrs(attrs),\n    children: children.slice(),\n  };\n  if (text !== undefined) out.text = text;\n  return out;\n}\n\nconst normaliseAttrs = (\n  attrs: Readonly<Record<string, string | number | boolean | null | undefined>>,\n): Record<string, string> => {\n  const out: Record<string, string> = {};\n  for (const [k, v] of Object.entries(attrs)) {\n    if (v === undefined || v === null) continue;\n    out[k] = typeof v === 'string' ? v : String(v);\n  }\n  return out;\n};\n\n/**\n * Convenience: element with a Clark-notation name composed from a namespace URI\n * and local name.\n */\nexport function elNs(\n  namespace: string | undefined,\n  local: string,\n  attrs?: Readonly<Record<string, string | number | boolean | null | undefined>>,\n  children?: ReadonlyArray<XmlNode>,\n  text?: string,\n): XmlNode {\n  return el(qname(namespace, local), attrs, children, text);\n}\n\n/** Locate the first child matching the supplied Clark-notation name. */\nexport function findChild(node: XmlNode, name: string): XmlNode | undefined {\n  for (const c of node.children) if (c.name === name) return c;\n  return undefined;\n}\n\n/** All children matching the supplied Clark-notation name, in document order. */\nexport function findChildren(node: XmlNode, name: string): XmlNode[] {\n  const out: XmlNode[] = [];\n  for (const c of node.children) if (c.name === name) out.push(c);\n  return out;\n}\n\n/**\n * Append `child` to `parent`. Mutates and returns `parent` for chaining during\n * construction. Avoid in hot paths — for cell writing the worksheet writer goes\n * through a templated emitter rather than building XmlNode trees per cell.\n */\nexport function appendChild(parent: XmlNode, child: XmlNode): XmlNode {\n  parent.children.push(child);\n  return parent;\n}\n"],"mappings":"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"}

package/dist/{utf8-D91g1XTG.mjs → utf8-Tn3nzyik.mjs}

@@ -1,5 +1,5 @@
 import { o as OpenXmlSchemaError } from "./exceptions-D-CFwxgm.mjs";
-import { jt as qname } from "./tree-Bbs1C8Rc.mjs";
+import { jt as qname } from "./tree-BX-sRRVp.mjs";
 import { SaxesParser } from "saxes";
 //#region src/xml/iterparse.ts
 const DOCTYPE_RE = /<!DOCTYPE\b/;
@@ -140,4 +140,4 @@ function utf8ByteLength(s) {
 //#endregion
 export { iterParse as n, utf8ByteLength as t };
 
-//# sourceMappingURL=utf8-D91g1XTG.mjs.map
+//# sourceMappingURL=utf8-Tn3nzyik.mjs.map

package/dist/{utf8-D91g1XTG.mjs.map → utf8-Tn3nzyik.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"utf8-D91g1XTG.mjs","names":[],"sources":["../src/xml/iterparse.ts","../src/utils/utf8.ts"],"sourcesContent":["// SAX iterator over OOXML XML payloads. Wraps `saxes` (XMLNS-aware) and yields\n// a flat stream of {start | end | text} events with names already converted to\n// Clark notation (`{ns}local`) — same shape as the DOM parser produces for\n// static XmlNode trees, so consumers can switch between bulk and streaming\n// reads without retouching name comparison.\n//\n// Phase 1 §3 acceptance: 1 k–row sheetData walked end-to-end with cell counts\n// matching the source. The phase-4 read-only worksheet drives real-world use;\n// this layer just produces the events.\n//\n// DOCTYPE / external entity declarations are forbidden. saxes does not expand\n// external entities, but a prescan also rejects DTDs in non-streaming inputs.\n// Streaming inputs are checked on the first chunk before being fed to the\n// parser.\n\nimport { SaxesParser } from 'saxes';\nimport { OpenXmlSchemaError } from '../utils/exceptions';\nimport { qname } from './namespaces';\n\nexport type SaxEvent =\n  | { kind: 'start'; name: string; attrs: Record<string, string> }\n  | { kind: 'end'; name: string }\n  | { kind: 'text'; text: string };\n\n/**\n * Streamable input: `Uint8Array`, plain string, or a Web `ReadableStream` of\n * `Uint8Array` chunks (produced by xlsx zip entries via fflate, fetch, file\n * streams, etc.).\n */\nexport type SaxInput = Uint8Array | string | ReadableStream<Uint8Array>;\n\nconst DOCTYPE_RE = /<!DOCTYPE\\b/;\nconst ENTITY_RE = /<!ENTITY\\b/;\n\nconst checkDoctype = (text: string): void => {\n  if (DOCTYPE_RE.test(text)) {\n    throw new OpenXmlSchemaError('DTD declarations are not permitted in OOXML payloads');\n  }\n  if (ENTITY_RE.test(text)) {\n    throw new OpenXmlSchemaError('Entity declarations are not permitted in OOXML payloads');\n  }\n};\n\nconst isReadableStream = (v: unknown): v is ReadableStream<Uint8Array> => {\n  return typeof v === 'object' && v !== null && typeof (v as ReadableStream).getReader === 'function';\n};\n\nconst decoder = (): TextDecoder => new TextDecoder('utf-8', { fatal: false });\n\ninterface SaxesOpenTag {\n  name: string;\n  uri: string;\n  local: string;\n  prefix: string;\n  attributes: Record<string, { value: string; uri: string; local: string; prefix: string }>;\n  isSelfClosing?: boolean;\n}\n\ninterface SaxesCloseTag {\n  name: string;\n  uri: string;\n  local: string;\n  prefix: string;\n}\n\nconst buildAttrsClark = (attrs: SaxesOpenTag['attributes']): Record<string, string> => {\n  const out: Record<string, string> = {};\n  for (const [, info] of Object.entries(attrs)) {\n    // saxes already resolved the namespace when xmlns: true is set; raw xmlns /\n    // xmlns:* declarations have prefix='xmlns' (or local==='xmlns' when\n    // default) and we drop those — they're rebuilt by the serializer.\n    if (info.prefix === 'xmlns' || (info.prefix === '' && info.local === 'xmlns')) continue;\n    const key = qname(info.uri, info.local);\n    out[key] = info.value;\n  }\n  return out;\n};\n\n/**\n * Parse the input as a stream of SAX events. Element / attribute names are\n * returned in Clark notation (`{ns}local`).\n */\nexport async function* iterParse(input: SaxInput): AsyncIterableIterator<SaxEvent> {\n  // Set up the parser. xmlns: true gives us resolved {uri, local, prefix} on\n  // every open / close tag and on every attribute.\n  const parser = new SaxesParser({ xmlns: true, fragment: false });\n\n  // Head-pointer ring instead of Array#shift: each saxes write() can produce\n  // hundreds of events in a single synchronous batch (a `<row>` with dozens of\n  // cells flushes one opentag + one text + one closetag per cell). `shift()`\n  // is O(n) per element in V8, so a single-batch drain of N events would be\n  // O(N²) before iteration. The head advances on yield; the queue is reset\n  // (head + length) once it drains so memory stays bounded.\n  let queue: SaxEvent[] = [];\n  let head = 0;\n  let pending: Error | undefined;\n\n  parser.on('error', (err: Error) => {\n    pending = err;\n  });\n  parser.on('doctype', () => {\n    pending = new OpenXmlSchemaError('DTD declarations are not permitted in OOXML payloads');\n  });\n  parser.on('opentag', (node: SaxesOpenTag) => {\n    queue.push({ kind: 'start', name: qname(node.uri, node.local), attrs: buildAttrsClark(node.attributes) });\n  });\n  parser.on('closetag', (node: SaxesCloseTag) => {\n    queue.push({ kind: 'end', name: qname(node.uri, node.local) });\n  });\n  parser.on('text', (text: string) => {\n    if (text.length > 0) queue.push({ kind: 'text', text });\n  });\n\n  const drain = function* (): IterableIterator<SaxEvent> {\n    for (;;) {\n      const ev = head < queue.length ? queue[head] : undefined;\n      if (ev === undefined) {\n        // Reset rather than grow forever; the next batch starts at index 0.\n        queue = [];\n        head = 0;\n        return;\n      }\n      head++;\n      yield ev;\n    }\n  };\n\n  const feed = (chunk: string): void => {\n    parser.write(chunk);\n    if (pending !== undefined) throw pending;\n  };\n\n  if (typeof input === 'string') {\n    checkDoctype(input);\n    feed(input);\n  } else if (input instanceof Uint8Array) {\n    const text = decoder().decode(input);\n    checkDoctype(text);\n    feed(text);\n    yield* drain();\n  } else if (isReadableStream(input)) {\n    const reader = input.getReader();\n    const td = decoder();\n    let firstChunkChecked = false;\n    let firstChunkBuffer = '';\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      const chunk = td.decode(value, { stream: true });\n      if (!firstChunkChecked) {\n        // We need to see enough of the prologue to be sure no DOCTYPE is\n        // hiding. Buffer until we have ~256 chars; if the stream ends before\n        // we reach the threshold the tail handler below runs `checkDoctype`\n        // on the accumulated prologue. (The previous `|| done` here was dead:\n        // a true `done` short-circuits at the top of the loop.)\n        firstChunkBuffer += chunk;\n        if (firstChunkBuffer.length >= 256) {\n          checkDoctype(firstChunkBuffer);\n          firstChunkChecked = true;\n          feed(firstChunkBuffer);\n          yield* drain();\n        }\n      } else {\n        feed(chunk);\n        yield* drain();\n      }\n    }\n    // Stream ended; flush decoder + any buffered prologue.\n    const tail = td.decode();\n    if (!firstChunkChecked) {\n      const all = firstChunkBuffer + tail;\n      checkDoctype(all);\n      feed(all);\n      yield* drain();\n    } else if (tail.length > 0) {\n      feed(tail);\n      yield* drain();\n    }\n  } else {\n    throw new OpenXmlSchemaError('iterParse: unsupported input type');\n  }\n\n  parser.close();\n  if (pending !== undefined) throw pending;\n  yield* drain();\n}\n","// Fast UTF-8 byte-length scan. Used by streaming writers to decide when their\n// pending string buffer should be encoded + flushed.\n//\n// `s.length` returns UTF-16 code units, which undercounts BMP characters above\n// U+007F (1 code unit, 2 UTF-8 bytes for U+0080–U+07FF, 3 bytes for the rest\n// of the BMP). For CJK-heavy payloads the discrepancy is ~3× — large enough\n// to push a \"64 KB\" flush threshold to 192 KB of resident text. We scan the\n// string once and account for each codepoint instead of running a full\n// TextEncoder, which would also have to materialise the byte buffer we don't\n// need yet.\nexport function utf8ByteLength(s: string): number {\n  let n = 0;\n  for (let i = 0; i < s.length; i++) {\n    const c = s.charCodeAt(i);\n    if (c < 0x80) {\n      n += 1;\n    } else if (c < 0x800) {\n      n += 2;\n    } else if (c >= 0xd800 && c <= 0xdbff) {\n      // High surrogate. Only consume the next code unit when it actually\n      // is a low surrogate — an unpaired high surrogate (followed by a\n      // BMP char or by EOS) would otherwise swallow the next code unit\n      // and undercount the string. TextEncoder replaces a lone high\n      // surrogate with U+FFFD (3 bytes), so use 3 here too. A paired\n      // surrogate encodes one 4-byte codepoint.\n      const next = i + 1 < s.length ? s.charCodeAt(i + 1) : 0;\n      if (next >= 0xdc00 && next <= 0xdfff) {\n        n += 4;\n        i++;\n      } else {\n        n += 3;\n      }\n    } else {\n      // Includes unpaired low surrogates (0xDC00-0xDFFF), which encode as\n      // U+FFFD = 3 UTF-8 bytes through TextEncoder.\n      n += 3;\n    }\n  }\n  return n;\n}\n"],"mappings":"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"}
+{"version":3,"file":"utf8-Tn3nzyik.mjs","names":[],"sources":["../src/xml/iterparse.ts","../src/utils/utf8.ts"],"sourcesContent":["// SAX iterator over OOXML XML payloads. Wraps `saxes` (XMLNS-aware) and yields\n// a flat stream of {start | end | text} events with names already converted to\n// Clark notation (`{ns}local`) — same shape as the DOM parser produces for\n// static XmlNode trees, so consumers can switch between bulk and streaming\n// reads without retouching name comparison.\n//\n// Phase 1 §3 acceptance: 1 k–row sheetData walked end-to-end with cell counts\n// matching the source. The phase-4 read-only worksheet drives real-world use;\n// this layer just produces the events.\n//\n// DOCTYPE / external entity declarations are forbidden. saxes does not expand\n// external entities, but a prescan also rejects DTDs in non-streaming inputs.\n// Streaming inputs are checked on the first chunk before being fed to the\n// parser.\n\nimport { SaxesParser } from 'saxes';\nimport { OpenXmlSchemaError } from '../utils/exceptions';\nimport { qname } from './namespaces';\n\nexport type SaxEvent =\n  | { kind: 'start'; name: string; attrs: Record<string, string> }\n  | { kind: 'end'; name: string }\n  | { kind: 'text'; text: string };\n\n/**\n * Streamable input: `Uint8Array`, plain string, or a Web `ReadableStream` of\n * `Uint8Array` chunks (produced by xlsx zip entries via fflate, fetch, file\n * streams, etc.).\n */\nexport type SaxInput = Uint8Array | string | ReadableStream<Uint8Array>;\n\nconst DOCTYPE_RE = /<!DOCTYPE\\b/;\nconst ENTITY_RE = /<!ENTITY\\b/;\n\nconst checkDoctype = (text: string): void => {\n  if (DOCTYPE_RE.test(text)) {\n    throw new OpenXmlSchemaError('DTD declarations are not permitted in OOXML payloads');\n  }\n  if (ENTITY_RE.test(text)) {\n    throw new OpenXmlSchemaError('Entity declarations are not permitted in OOXML payloads');\n  }\n};\n\nconst isReadableStream = (v: unknown): v is ReadableStream<Uint8Array> => {\n  return typeof v === 'object' && v !== null && typeof (v as ReadableStream).getReader === 'function';\n};\n\nconst decoder = (): TextDecoder => new TextDecoder('utf-8', { fatal: false });\n\ninterface SaxesOpenTag {\n  name: string;\n  uri: string;\n  local: string;\n  prefix: string;\n  attributes: Record<string, { value: string; uri: string; local: string; prefix: string }>;\n  isSelfClosing?: boolean;\n}\n\ninterface SaxesCloseTag {\n  name: string;\n  uri: string;\n  local: string;\n  prefix: string;\n}\n\nconst buildAttrsClark = (attrs: SaxesOpenTag['attributes']): Record<string, string> => {\n  const out: Record<string, string> = {};\n  for (const [, info] of Object.entries(attrs)) {\n    // saxes already resolved the namespace when xmlns: true is set; raw xmlns /\n    // xmlns:* declarations have prefix='xmlns' (or local==='xmlns' when\n    // default) and we drop those — they're rebuilt by the serializer.\n    if (info.prefix === 'xmlns' || (info.prefix === '' && info.local === 'xmlns')) continue;\n    const key = qname(info.uri, info.local);\n    out[key] = info.value;\n  }\n  return out;\n};\n\n/**\n * Parse the input as a stream of SAX events. Element / attribute names are\n * returned in Clark notation (`{ns}local`).\n */\nexport async function* iterParse(input: SaxInput): AsyncIterableIterator<SaxEvent> {\n  // Set up the parser. xmlns: true gives us resolved {uri, local, prefix} on\n  // every open / close tag and on every attribute.\n  const parser = new SaxesParser({ xmlns: true, fragment: false });\n\n  // Head-pointer ring instead of Array#shift: each saxes write() can produce\n  // hundreds of events in a single synchronous batch (a `<row>` with dozens of\n  // cells flushes one opentag + one text + one closetag per cell). `shift()`\n  // is O(n) per element in V8, so a single-batch drain of N events would be\n  // O(N²) before iteration. The head advances on yield; the queue is reset\n  // (head + length) once it drains so memory stays bounded.\n  let queue: SaxEvent[] = [];\n  let head = 0;\n  let pending: Error | undefined;\n\n  parser.on('error', (err: Error) => {\n    pending = err;\n  });\n  parser.on('doctype', () => {\n    pending = new OpenXmlSchemaError('DTD declarations are not permitted in OOXML payloads');\n  });\n  parser.on('opentag', (node: SaxesOpenTag) => {\n    queue.push({ kind: 'start', name: qname(node.uri, node.local), attrs: buildAttrsClark(node.attributes) });\n  });\n  parser.on('closetag', (node: SaxesCloseTag) => {\n    queue.push({ kind: 'end', name: qname(node.uri, node.local) });\n  });\n  parser.on('text', (text: string) => {\n    if (text.length > 0) queue.push({ kind: 'text', text });\n  });\n\n  const drain = function* (): IterableIterator<SaxEvent> {\n    for (;;) {\n      const ev = head < queue.length ? queue[head] : undefined;\n      if (ev === undefined) {\n        // Reset rather than grow forever; the next batch starts at index 0.\n        queue = [];\n        head = 0;\n        return;\n      }\n      head++;\n      yield ev;\n    }\n  };\n\n  const feed = (chunk: string): void => {\n    parser.write(chunk);\n    if (pending !== undefined) throw pending;\n  };\n\n  if (typeof input === 'string') {\n    checkDoctype(input);\n    feed(input);\n  } else if (input instanceof Uint8Array) {\n    const text = decoder().decode(input);\n    checkDoctype(text);\n    feed(text);\n    yield* drain();\n  } else if (isReadableStream(input)) {\n    const reader = input.getReader();\n    const td = decoder();\n    let firstChunkChecked = false;\n    let firstChunkBuffer = '';\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      const chunk = td.decode(value, { stream: true });\n      if (!firstChunkChecked) {\n        // We need to see enough of the prologue to be sure no DOCTYPE is\n        // hiding. Buffer until we have ~256 chars; if the stream ends before\n        // we reach the threshold the tail handler below runs `checkDoctype`\n        // on the accumulated prologue. (The previous `|| done` here was dead:\n        // a true `done` short-circuits at the top of the loop.)\n        firstChunkBuffer += chunk;\n        if (firstChunkBuffer.length >= 256) {\n          checkDoctype(firstChunkBuffer);\n          firstChunkChecked = true;\n          feed(firstChunkBuffer);\n          yield* drain();\n        }\n      } else {\n        feed(chunk);\n        yield* drain();\n      }\n    }\n    // Stream ended; flush decoder + any buffered prologue.\n    const tail = td.decode();\n    if (!firstChunkChecked) {\n      const all = firstChunkBuffer + tail;\n      checkDoctype(all);\n      feed(all);\n      yield* drain();\n    } else if (tail.length > 0) {\n      feed(tail);\n      yield* drain();\n    }\n  } else {\n    throw new OpenXmlSchemaError('iterParse: unsupported input type');\n  }\n\n  parser.close();\n  if (pending !== undefined) throw pending;\n  yield* drain();\n}\n","// Fast UTF-8 byte-length scan. Used by streaming writers to decide when their\n// pending string buffer should be encoded + flushed.\n//\n// `s.length` returns UTF-16 code units, which undercounts BMP characters above\n// U+007F (1 code unit, 2 UTF-8 bytes for U+0080–U+07FF, 3 bytes for the rest\n// of the BMP). For CJK-heavy payloads the discrepancy is ~3× — large enough\n// to push a \"64 KB\" flush threshold to 192 KB of resident text. We scan the\n// string once and account for each codepoint instead of running a full\n// TextEncoder, which would also have to materialise the byte buffer we don't\n// need yet.\nexport function utf8ByteLength(s: string): number {\n  let n = 0;\n  for (let i = 0; i < s.length; i++) {\n    const c = s.charCodeAt(i);\n    if (c < 0x80) {\n      n += 1;\n    } else if (c < 0x800) {\n      n += 2;\n    } else if (c >= 0xd800 && c <= 0xdbff) {\n      // High surrogate. Only consume the next code unit when it actually\n      // is a low surrogate — an unpaired high surrogate (followed by a\n      // BMP char or by EOS) would otherwise swallow the next code unit\n      // and undercount the string. TextEncoder replaces a lone high\n      // surrogate with U+FFFD (3 bytes), so use 3 here too. A paired\n      // surrogate encodes one 4-byte codepoint.\n      const next = i + 1 < s.length ? s.charCodeAt(i + 1) : 0;\n      if (next >= 0xdc00 && next <= 0xdfff) {\n        n += 4;\n        i++;\n      } else {\n        n += 3;\n      }\n    } else {\n      // Includes unpaired low surrogates (0xDC00-0xDFFF), which encode as\n      // U+FFFD = 3 UTF-8 bytes through TextEncoder.\n      n += 3;\n    }\n  }\n  return n;\n}\n"],"mappings":"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"}

package/dist/workbook/shared-strings.d.ts

@@ -1,4 +1,5 @@
 import type { RichText } from '../cell/rich-text';
+import { type XmlNode } from '../xml/tree';
 /** A single SST entry: either a plain string or a rich-text run array. */
 export type SharedStringEntry = string | {
     kind: 'rich-text';
@@ -14,6 +15,8 @@ export interface SharedStringsTable {
     entries: SharedStringEntry[];
     /** Reverse lookup keyed by literal text — rich-text entries skip this map. */
     index: Map<string, number>;
+    /** Reverse lookup for rich-text entries, keyed by the structure of their runs. */
+    richIndex: Map<string, number>;
 }
 export declare function makeSharedStrings(): SharedStringsTable;
 /**
@@ -22,6 +25,12 @@ export declare function makeSharedStrings(): SharedStringsTable;
  * else.
  */
 export declare function addSharedString(table: SharedStringsTable, value: string): number;
+/**
+ * Insert a rich-text entry and return its index. Deduped on the structure of
+ * the runs, so the same formatted string used in 100 cells lands in one slot —
+ * which is how Excel stores it.
+ */
+export declare function addSharedRichText(table: SharedStringsTable, runs: RichText): number;
 /** Look up a shared-string index by its literal text. Returns `undefined` for unknown values. */
 export declare function getSharedStringIndex(table: SharedStringsTable, value: string): number | undefined;
 /**
@@ -42,6 +51,12 @@ export declare function sharedStringCount(table: SharedStringsTable): number;
  * round-tripping a file with rich text doesn't drop the styling.
  */
 export declare function parseSharedStringsXml(bytes: Uint8Array | string): SharedStringsTable;
+/**
+ * Parse a `CT_Rst` body — the shape shared by `<si>` in sharedStrings.xml and
+ * `<is>` in an inline-string cell. Returns rich text when the body is built
+ * from `<r>` runs, and the plain concatenated text otherwise.
+ */
+export declare const parseRichString: (si: XmlNode) => SharedStringEntry;
 /**
  * Serialise a SharedStringsTable to its OOXML bytes. The `count` attribute
  * tracks total references (we don't know that here so we report the same as
@@ -50,8 +65,3 @@ export declare function parseSharedStringsXml(bytes: Uint8Array | string): Share
  */
 export declare function sharedStringsToBytes(table: SharedStringsTable): Uint8Array;
 export declare function serializeSharedStrings(table: SharedStringsTable): string;
-/**
- * Serialise a sequence of `<r>...<r>` runs — shared by the SST `<si>` writer
- * and the worksheet's inline-string (`t="inlineStr"`) cell writer.
- */
-export declare function serializeRichTextRuns(runs: import('../cell/rich-text').RichText): string;

package/dist/workbook/views.d.ts

@@ -18,6 +18,13 @@ export interface WorkbookView {
     /** Index of the currently active sheet tab (0-based). */
     activeTab?: number;
     autoFilterDateGrouping?: boolean;
+    /**
+     * Namespaced attributes outside SpreadsheetML, keyed in Clark notation
+     * (`{ns}local`). Excel writes `xr2:uid="{…}"` here to tie the view to its
+     * revision-tracking record; kept verbatim because the model has no slot for
+     * it and dropping it changes what Excel reads back.
+     */
+    extAttrs?: Readonly<Record<string, string>>;
 }
 export declare const makeWorkbookView: (opts?: WorkbookView) => WorkbookView;
 export type CustomViewShowComments = 'commNone' | 'commIndicator' | 'commIndAndComment';

package/dist/workbook/workbook.d.ts

@@ -95,6 +95,21 @@ export interface Workbook {
         beforeSheets: import('../xml/tree').XmlNode[];
         afterSheets: import('../xml/tree').XmlNode[];
     };
+    /**
+     * The `<workbook>` root's markup-compatibility header, as Excel wrote it:
+     * its namespace declarations and the `mc:Ignorable` list. The two only make
+     * sense together — `mc:Ignorable="x15 xr xr6 …"` names prefixes that are
+     * declared nowhere else — and the captured children have to keep the same
+     * prefixes, so the whole header round-trips verbatim rather than being
+     * rebuilt from the namespaces the serializer happens to walk.
+     */
+    workbookXmlRoot?: {
+        namespaces: ReadonlyArray<{
+            prefix: string;
+            ns: string;
+        }>;
+        ignorable?: string;
+    };
     /**
      * `<workbookProtection>` — locks structure / window / revision tracking with
      * the modern hash quad or the legacy 16-bit hash. Round-tripped verbatim;

package/dist/{workbook-T1Y3lstQ.mjs → workbook-CARZS94U.mjs}

@@ -4,10 +4,10 @@ import { h as isFormulaValue } from "./cell-BucgGwl3.mjs";
 import { t as makeChartsheet } from "./chartsheet-C3-tqkPy.mjs";
 import { a as makeChartDrawingItem, d as makeAbsoluteAnchor, o as makeDrawing } from "./drawing-BxzLuryn.mjs";
 import { i as unescapeCellString, n as escapeXmlAttr, r as escapeXmlText, t as escapeCellString } from "./escape-DFTE7ZJc.mjs";
-import { a as findChildren, ft as SHEET_MAIN_NS, i as findChild, jt as qname } from "./tree-Bbs1C8Rc.mjs";
-import { t as parseXml } from "./parser-nk0Lqmcb.mjs";
-import { Cn as parseRange, D as getCellHyperlink, Dn as rangeToString, E as getCellComment, L as getMergedRangeAt, Tn as rangeContainsCell, _ as countCellsByKind, at as makeWorksheet, bn as multiCellRangeContainsCell, nn as colorToHex, u as classifyCellValue, w as getCell, xt as setCellByCoord } from "./worksheet-C6CWgvP5.mjs";
-import { _ as getCellNumberFormat, ft as makeStylesheet, g as getCellFont, h as getCellFill, m as getCellBorder, p as getCellAlignment, v as getCellProtection } from "./cell-style-CN9JXOwm.mjs";
+import { a as findChildren, ft as SHEET_MAIN_NS, i as findChild, jt as qname } from "./tree-BX-sRRVp.mjs";
+import { t as parseXml } from "./parser-D3SLaOFe.mjs";
+import { D as getCellHyperlink, E as getCellComment, L as getMergedRangeAt, _ as countCellsByKind, _n as colorToHex, at as makeWorksheet, dn as rangeToString, in as multiCellRangeContainsCell, ln as rangeContainsCell, sn as parseRange, u as classifyCellValue, w as getCell, xt as setCellByCoord } from "./worksheet-C5Ensf_j.mjs";
+import { Zt as stableStringify, _ as getCellNumberFormat, ft as makeStylesheet, g as getCellFont, h as getCellFill, m as getCellBorder, p as getCellAlignment, v as getCellProtection } from "./cell-style-DuvS_Lsg.mjs";
 //#region src/workbook/shared-strings.ts
 const SST_TAG = `{${SHEET_MAIN_NS}}sst`;
 const SI_TAG = `{${SHEET_MAIN_NS}}si`;
@@ -16,7 +16,8 @@ const R_TAG = `{${SHEET_MAIN_NS}}r`;
 function makeSharedStrings() {
 	return {
 		entries: [],
-		index: /* @__PURE__ */ new Map()
+		index: /* @__PURE__ */ new Map(),
+		richIndex: /* @__PURE__ */ new Map()
 	};
 }
 /**
@@ -32,6 +33,23 @@ function addSharedString(table, value) {
 	table.index.set(value, id);
 	return id;
 }
+/**
+* Insert a rich-text entry and return its index. Deduped on the structure of
+* the runs, so the same formatted string used in 100 cells lands in one slot —
+* which is how Excel stores it.
+*/
+function addSharedRichText(table, runs) {
+	const key = stableStringify(runs);
+	const cached = table.richIndex.get(key);
+	if (cached !== void 0) return cached;
+	const id = table.entries.length;
+	table.entries.push({
+		kind: "rich-text",
+		runs
+	});
+	table.richIndex.set(key, id);
+	return id;
+}
 /** Look up a shared-string index by its literal text. Returns `undefined` for unknown values. */
 function getSharedStringIndex(table, value) {
 	return table.index.get(value);
@@ -79,14 +97,24 @@ function parseSharedStringsXml(bytes) {
 	if (root.name !== SST_TAG) throw new OpenXmlSchemaError(`parseSharedStringsXml: root is "${root.name}", expected sst`);
 	const table = makeSharedStrings();
 	for (const si of findChildren(root, SI_TAG)) {
-		const entry = parseSi(si);
+		const entry = parseRichString(si);
 		const id = table.entries.length;
 		table.entries.push(entry);
-		if (typeof entry === "string" && !table.index.has(entry)) table.index.set(entry, id);
+		if (typeof entry === "string") {
+			if (!table.index.has(entry)) table.index.set(entry, id);
+		} else {
+			const key = stableStringify(entry.runs);
+			if (!table.richIndex.has(key)) table.richIndex.set(key, id);
+		}
 	}
 	return table;
 }
-const parseSi = (si) => {
+/**
+* Parse a `CT_Rst` body — the shape shared by `<si>` in sharedStrings.xml and
+* `<is>` in an inline-string cell. Returns rich text when the body is built
+* from `<r>` runs, and the plain concatenated text otherwise.
+*/
+const parseRichString = (si) => {
 	const runEls = findChildren(si, R_TAG);
 	if (runEls.length > 0) {
 		const runs = [];
@@ -178,10 +206,7 @@ const serializeSi = (value) => {
 	if (typeof value === "string") return `<si><t${value.length > 0 && (value[0] === " " || value[value.length - 1] === " " || /[\t\n]/.test(value)) ? " xml:space=\"preserve\"" : ""}>${escapeXmlText(escapeCellString(value))}</t></si>`;
 	return `<si>${serializeRichTextRuns(value.runs)}</si>`;
 };
-/**
-* Serialise a sequence of `<r>...<r>` runs — shared by the SST `<si>` writer
-* and the worksheet's inline-string (`t="inlineStr"`) cell writer.
-*/
+/** Serialise a sequence of `<r>…</r>` runs into an `<si>` / `<is>` body. */
 function serializeRichTextRuns(runs) {
 	const parts = [];
 	for (const run of runs) {
@@ -631,6 +656,6 @@ function listCustomXmlParts(wb) {
 	return out;
 }
 //#endregion
-export { sharedStringsToBytes as A, addSharedString as C, parseSharedStringsXml as D, makeSharedStrings as E, serializeRichTextRuns as O, validateSheetTitle as S, getSharedStringIndex as T, renameSheet as _, getActiveSheet as a, setSheetState as b, getChartsheet as c, getWorkbookCellsByKind as d, getWorkbookStats as f, removeSheet as g, moveSheet as h, describeWorkbook as i, sharedStringCount as k, getSheet as l, listCustomXmlParts as m, addWorksheet as n, getCellAtAddress as o, iterWorksheets as p, createWorkbook as r, getCellSummary as s, addChartsheet as t, getSheetState as u, setActiveSheet as v, getSharedStringAt as w, sheetNames as x, setCellAtAddress as y };
+export { sharedStringCount as A, addSharedRichText as C, makeSharedStrings as D, getSharedStringIndex as E, parseRichString as O, validateSheetTitle as S, getSharedStringAt as T, renameSheet as _, getActiveSheet as a, setSheetState as b, getChartsheet as c, getWorkbookCellsByKind as d, getWorkbookStats as f, removeSheet as g, moveSheet as h, describeWorkbook as i, sharedStringsToBytes as j, parseSharedStringsXml as k, getSheet as l, listCustomXmlParts as m, addWorksheet as n, getCellAtAddress as o, iterWorksheets as p, createWorkbook as r, getCellSummary as s, addChartsheet as t, getSheetState as u, setActiveSheet as v, addSharedString as w, sheetNames as x, setCellAtAddress as y };
 
-//# sourceMappingURL=workbook-T1Y3lstQ.mjs.map
+//# sourceMappingURL=workbook-CARZS94U.mjs.map