@office-kit/xlsx 0.8.0

package/dist/table-DkX6UniA.mjs

@@ -0,0 +1,113 @@
+import { Sn as parseMultiCellRange } from "./worksheet-CmCNoIgD.mjs";
+//#region src/worksheet/conditional-formatting.ts
+function makeConditionalFormatting(opts) {
+	return {
+		sqref: typeof opts.sqref === "string" ? parseMultiCellRange(opts.sqref) : opts.sqref,
+		rules: opts.rules ?? [],
+		...opts.pivot !== void 0 ? { pivot: opts.pivot } : {}
+	};
+}
+function makeCfRule(opts) {
+	return {
+		type: opts.type,
+		priority: opts.priority,
+		formulas: opts.formulas ?? [],
+		...opts.dxfId !== void 0 ? { dxfId: opts.dxfId } : {},
+		...opts.stopIfTrue !== void 0 ? { stopIfTrue: opts.stopIfTrue } : {},
+		...opts.operator !== void 0 ? { operator: opts.operator } : {},
+		...opts.text !== void 0 ? { text: opts.text } : {},
+		...opts.percent !== void 0 ? { percent: opts.percent } : {},
+		...opts.bottom !== void 0 ? { bottom: opts.bottom } : {},
+		...opts.rank !== void 0 ? { rank: opts.rank } : {},
+		...opts.aboveAverage !== void 0 ? { aboveAverage: opts.aboveAverage } : {},
+		...opts.equalAverage !== void 0 ? { equalAverage: opts.equalAverage } : {},
+		...opts.stdDev !== void 0 ? { stdDev: opts.stdDev } : {},
+		...opts.timePeriod !== void 0 ? { timePeriod: opts.timePeriod } : {},
+		...opts.innerXml !== void 0 ? { innerXml: opts.innerXml } : {}
+	};
+}
+//#endregion
+//#region src/worksheet/data-validations.ts
+function makeDataValidation(opts) {
+	return {
+		type: opts.type,
+		sqref: typeof opts.sqref === "string" ? parseMultiCellRange(opts.sqref) : opts.sqref,
+		...opts.operator !== void 0 ? { operator: opts.operator } : {},
+		...opts.formula1 !== void 0 ? { formula1: opts.formula1 } : {},
+		...opts.formula2 !== void 0 ? { formula2: opts.formula2 } : {},
+		...opts.allowBlank !== void 0 ? { allowBlank: opts.allowBlank } : {},
+		...opts.showInputMessage !== void 0 ? { showInputMessage: opts.showInputMessage } : {},
+		...opts.showErrorMessage !== void 0 ? { showErrorMessage: opts.showErrorMessage } : {},
+		...opts.errorTitle !== void 0 ? { errorTitle: opts.errorTitle } : {},
+		...opts.error !== void 0 ? { error: opts.error } : {},
+		...opts.errorStyle !== void 0 ? { errorStyle: opts.errorStyle } : {},
+		...opts.promptTitle !== void 0 ? { promptTitle: opts.promptTitle } : {},
+		...opts.prompt !== void 0 ? { prompt: opts.prompt } : {},
+		...opts.showDropDown !== void 0 ? { showDropDown: opts.showDropDown } : {}
+	};
+}
+//#endregion
+//#region src/worksheet/table.ts
+function makeTableColumn(opts) {
+	return {
+		id: opts.id,
+		name: opts.name
+	};
+}
+function makeTableDefinition(opts) {
+	return {
+		id: opts.id,
+		displayName: opts.displayName,
+		ref: opts.ref,
+		columns: opts.columns ?? [],
+		...opts.name !== void 0 ? { name: opts.name } : {},
+		...opts.headerRowCount !== void 0 ? { headerRowCount: opts.headerRowCount } : {},
+		...opts.totalsRowCount !== void 0 ? { totalsRowCount: opts.totalsRowCount } : {},
+		...opts.totalsRowShown !== void 0 ? { totalsRowShown: opts.totalsRowShown } : {},
+		...opts.styleInfo ? { styleInfo: opts.styleInfo } : {},
+		...opts.autoFilter ? { autoFilter: opts.autoFilter } : {}
+	};
+}
+const nextTableId = (wb) => {
+	let max = 0;
+	for (const ref of wb.sheets) {
+		if (ref.kind !== "worksheet") continue;
+		for (const t of ref.sheet.tables) if (t.id > max) max = t.id;
+	}
+	return max + 1;
+};
+/**
+* High-level wrapper that builds a TableDefinition + pushes it onto `ws.tables`
+* in one call. Auto-assigns the workbook-unique `id`, derives `displayName`
+* from the supplied `name`, and constructs `TableColumn` records (1-based ids)
+* from a string-array shorthand.
+*/
+const addExcelTable = (wb, ws, opts) => {
+	const cols = opts.columns.map((c, i) => typeof c === "string" ? {
+		id: i + 1,
+		name: c
+	} : c);
+	const styleInfo = opts.styleInfo ?? (opts.style !== void 0 ? {
+		name: opts.style,
+		showRowStripes: true,
+		showColumnStripes: false
+	} : void 0);
+	const def = makeTableDefinition({
+		id: nextTableId(wb),
+		displayName: opts.displayName ?? opts.name,
+		name: opts.name,
+		ref: opts.ref,
+		columns: cols,
+		...opts.headerRowCount !== void 0 ? { headerRowCount: opts.headerRowCount } : {},
+		...opts.totalsRowCount !== void 0 ? { totalsRowCount: opts.totalsRowCount } : {},
+		...opts.totalsRowShown !== void 0 ? { totalsRowShown: opts.totalsRowShown } : {},
+		...styleInfo ? { styleInfo } : {},
+		...opts.autoFilter ? { autoFilter: opts.autoFilter } : {}
+	});
+	ws.tables.push(def);
+	return def;
+};
+//#endregion
+export { makeCfRule as a, makeDataValidation as i, makeTableColumn as n, makeConditionalFormatting as o, makeTableDefinition as r, addExcelTable as t };
+
+//# sourceMappingURL=table-DkX6UniA.mjs.map

package/dist/table-DkX6UniA.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"table-DkX6UniA.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"}

package/dist/tree-Bbs1C8Rc.mjs

@@ -0,0 +1,192 @@
+//#region src/xml/namespaces.ts
+const XML_NS = "http://www.w3.org/XML/1998/namespace";
+const XSI_NS = "http://www.w3.org/2001/XMLSchema-instance";
+const DCORE_NS = "http://purl.org/dc/elements/1.1/";
+const DCTERMS_NS = "http://purl.org/dc/terms/";
+const DCMITYPE_NS = "http://purl.org/dc/dcmitype/";
+const DCTERMS_PREFIX = "dcterms";
+const DOC_NS = "http://schemas.openxmlformats.org/officeDocument/2006/";
+const REL_NS = `${DOC_NS}relationships`;
+const COMMENTS_NS = `${REL_NS}/comments`;
+const IMAGE_NS = `${REL_NS}/image`;
+const VML_NS = `${REL_NS}/vmlDrawing`;
+const EXTERNAL_LINK_NS = `${REL_NS}/externalLink`;
+const VTYPES_NS = `${DOC_NS}docPropsVTypes`;
+const XPROPS_NS = `${DOC_NS}extended-properties`;
+const CUSTPROPS_NS = `${DOC_NS}custom-properties`;
+const CPROPS_FMTID = "{D5CDD505-2E9C-101B-9397-08002B2CF9AE}";
+const PKG_NS = "http://schemas.openxmlformats.org/package/2006/";
+const PKG_REL_NS = `${PKG_NS}relationships`;
+const COREPROPS_NS = `${PKG_NS}metadata/core-properties`;
+const CONTYPES_NS = `${PKG_NS}content-types`;
+const SHEET_MAIN_NS = "http://schemas.openxmlformats.org/spreadsheetml/2006/main";
+const CHART_NS = "http://schemas.openxmlformats.org/drawingml/2006/chart";
+const DRAWING_NS = "http://schemas.openxmlformats.org/drawingml/2006/main";
+const SHEET_DRAWING_NS = "http://schemas.openxmlformats.org/drawingml/2006/spreadsheetDrawing";
+const CHART_DRAWING_NS = "http://schemas.openxmlformats.org/drawingml/2006/chartDrawing";
+const PICTURE_NS = "http://schemas.openxmlformats.org/drawingml/2006/picture";
+const CUSTOMUI_NS = "http://schemas.microsoft.com/office/2006/relationships/ui/extensibility";
+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 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";
+const C16_NS = "http://schemas.microsoft.com/office/drawing/2017/03/chart";
+const CX_NS = "http://schemas.microsoft.com/office/drawing/2014/chartex";
+const THREADED_COMMENTS_NS = "http://schemas.microsoft.com/office/spreadsheetml/2018/threadedcomments";
+const DEFAULT_PREFIXES = Object.freeze({
+	[XML_NS]: "xml",
+	[XSI_NS]: "xsi",
+	[DCORE_NS]: "dc",
+	[DCTERMS_NS]: DCTERMS_PREFIX,
+	[DCMITYPE_NS]: "dcmitype",
+	[REL_NS]: "r",
+	[VTYPES_NS]: "vt",
+	[XPROPS_NS]: "",
+	[CUSTPROPS_NS]: "",
+	[PKG_REL_NS]: "",
+	[COREPROPS_NS]: "cp",
+	[CONTYPES_NS]: "",
+	[SHEET_MAIN_NS]: "",
+	[CHART_NS]: "c",
+	[DRAWING_NS]: "a",
+	[SHEET_DRAWING_NS]: "xdr",
+	[CHART_DRAWING_NS]: "cdr",
+	[PICTURE_NS]: "pic",
+	[MARKUP_COMPAT_NS]: "mc",
+	[X14_NS]: "x14",
+	[X15_NS]: "x15",
+	[X16_NS]: "x16",
+	[C14_NS]: "c14",
+	[C15_NS]: "c15",
+	[C16_NS]: "c16",
+	[CX_NS]: "cx",
+	[THREADED_COMMENTS_NS]: "tc"
+});
+const PACKAGE_PROPS = "docProps";
+const PACKAGE_XL = "xl";
+const PACKAGE_RELS = "_rels";
+const PACKAGE_THEME = `xl/theme`;
+const PACKAGE_WORKSHEETS = `xl/worksheets`;
+const PACKAGE_CHARTSHEETS = `xl/chartsheets`;
+const PACKAGE_DRAWINGS = `xl/drawings`;
+const PACKAGE_CHARTS = `xl/charts`;
+const PACKAGE_IMAGES = `xl/media`;
+const PACKAGE_PIVOT_TABLE = `xl/pivotTables`;
+const PACKAGE_PIVOT_CACHE = `xl/pivotCache`;
+const PACKAGE_WORKSHEET_RELS = `${PACKAGE_WORKSHEETS}/${PACKAGE_RELS}`;
+const PACKAGE_CHARTSHEETS_RELS = `${PACKAGE_CHARTSHEETS}/${PACKAGE_RELS}`;
+const ARC_CONTENT_TYPES = "[Content_Types].xml";
+const ARC_ROOT_RELS = `${PACKAGE_RELS}/.rels`;
+const ARC_WORKBOOK_RELS = `xl/${PACKAGE_RELS}/workbook.xml.rels`;
+const ARC_CORE = `${PACKAGE_PROPS}/core.xml`;
+const ARC_APP = `${PACKAGE_PROPS}/app.xml`;
+const ARC_CUSTOM = `${PACKAGE_PROPS}/custom.xml`;
+const ARC_WORKBOOK = `xl/workbook.xml`;
+const ARC_STYLE = `xl/styles.xml`;
+const ARC_THEME = `${PACKAGE_THEME}/theme1.xml`;
+const ARC_SHARED_STRINGS = `xl/sharedStrings.xml`;
+const ARC_CUSTOM_UI = "customUI/customUI.xml";
+const WORKBOOK_TPL = "application/vnd.openxmlformats-officedocument.spreadsheetml.%s.main+xml";
+const SPREADSHEET_TPL = "application/vnd.openxmlformats-officedocument.spreadsheetml.%s+xml";
+const WORKBOOK_MACRO_TPL = "application/vnd.ms-excel.%s.macroEnabled.main+xml";
+const fmt = (tpl, kind) => tpl.replace("%s", kind);
+const XLSX_TYPE = fmt(WORKBOOK_TPL, "sheet");
+const XLTX_TYPE = fmt(WORKBOOK_TPL, "template");
+const XLSM_TYPE = fmt(WORKBOOK_MACRO_TPL, "sheet");
+const XLTM_TYPE = fmt(WORKBOOK_MACRO_TPL, "template");
+const SHARED_STRINGS_TYPE = fmt(SPREADSHEET_TPL, "sharedStrings");
+const EXTERNAL_LINK_TYPE = fmt(SPREADSHEET_TPL, "externalLink");
+const WORKSHEET_TYPE = fmt(SPREADSHEET_TPL, "worksheet");
+const COMMENTS_TYPE = fmt(SPREADSHEET_TPL, "comments");
+const STYLES_TYPE = fmt(SPREADSHEET_TPL, "styles");
+const CHARTSHEET_TYPE = fmt(SPREADSHEET_TPL, "chartsheet");
+const DRAWING_TYPE = "application/vnd.openxmlformats-officedocument.drawing+xml";
+const CHART_TYPE = "application/vnd.openxmlformats-officedocument.drawingml.chart+xml";
+const CHARTEX_TYPE = "application/vnd.ms-office.chartex+xml";
+const CHARTSHAPE_TYPE = "application/vnd.openxmlformats-officedocument.drawingml.chartshapes+xml";
+const THEME_TYPE = "application/vnd.openxmlformats-officedocument.theme+xml";
+const CPROPS_TYPE = "application/vnd.openxmlformats-officedocument.custom-properties+xml";
+const VBA_TYPE = "application/vnd.ms-office.vbaProject";
+const ACTIVEX_TYPE = "application/vnd.ms-office.activeX+xml";
+const CTRLPROPS_TYPE = "application/vnd.ms-excel.controlproperties+xml";
+/**
+* Build a Clark-notation QName: `{namespace}localname`. When `namespace` is
+* empty / undefined the local name is returned as-is.
+*/
+function qname(namespace, local) {
+	return namespace ? `{${namespace}}${local}` : local;
+}
+const QNAME_RE = /^\{([^}]*)\}(.+)$/;
+/**
+* Inverse of {@link qname}. Returns `{ ns, local }`. For unprefixed names `ns`
+* is the empty string.
+*/
+function parseQName(name) {
+	const m = QNAME_RE.exec(name);
+	if (m === null) return {
+		ns: "",
+		local: name
+	};
+	return {
+		ns: m[1] ?? "",
+		local: m[2] ?? ""
+	};
+}
+//#endregion
+//#region src/xml/tree.ts
+/**
+* Build an XmlNode from primitive bits. Attributes / children default to empty;
+* pass `undefined` for `text` to omit the text node.
+*
+* The element's name is always supplied in Clark notation. Use the {@link
+* qname} helper from `./namespaces` to keep call sites readable.
+*/
+function el(name, attrs = {}, children = [], text) {
+	const out = {
+		name,
+		attrs: normaliseAttrs(attrs),
+		children: children.slice()
+	};
+	if (text !== void 0) out.text = text;
+	return out;
+}
+const normaliseAttrs = (attrs) => {
+	const out = {};
+	for (const [k, v] of Object.entries(attrs)) {
+		if (v === void 0 || v === null) continue;
+		out[k] = typeof v === "string" ? v : String(v);
+	}
+	return out;
+};
+/**
+* Convenience: element with a Clark-notation name composed from a namespace URI
+* and local name.
+*/
+function elNs(namespace, local, attrs, children, text) {
+	return el(qname(namespace, local), attrs, children, text);
+}
+/** Locate the first child matching the supplied Clark-notation name. */
+function findChild(node, name) {
+	for (const c of node.children) if (c.name === name) return c;
+}
+/** All children matching the supplied Clark-notation name, in document order. */
+function findChildren(node, name) {
+	const out = [];
+	for (const c of node.children) if (c.name === name) out.push(c);
+	return out;
+}
+/**
+* Append `child` to `parent`. Mutates and returns `parent` for chaining during
+* construction. Avoid in hot paths — for cell writing the worksheet writer goes
+* through a templated emitter rather than building XmlNode trees per cell.
+*/
+function appendChild(parent, child) {
+	parent.children.push(child);
+	return parent;
+}
+//#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

package/dist/tree-Bbs1C8Rc.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"tree-Bbs1C8Rc.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';\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  [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/units-rOMQqXh2.mjs

@@ -0,0 +1,41 @@
+//#region src/utils/units.ts
+const EMU_PER_INCH = 914400;
+const EMU_PER_CM = 36e4;
+const EMU_PER_PIXEL = 9525;
+const EMU_PER_POINT = 12700;
+/** DPI assumed by Excel when converting between pixels and other units. */
+const DEFAULT_PIXEL_DPI = 96;
+function emuFromPx(px) {
+	return Math.round(px * EMU_PER_PIXEL);
+}
+function pxFromEmu(emu) {
+	return emu / EMU_PER_PIXEL;
+}
+function emuFromCm(cm) {
+	return Math.round(cm * EMU_PER_CM);
+}
+function cmFromEmu(emu) {
+	return emu / EMU_PER_CM;
+}
+function emuFromInch(inch) {
+	return Math.round(inch * EMU_PER_INCH);
+}
+function inchFromEmu(emu) {
+	return emu / EMU_PER_INCH;
+}
+function emuFromPoint(pt) {
+	return Math.round(pt * EMU_PER_POINT);
+}
+function pointFromEmu(emu) {
+	return emu / EMU_PER_POINT;
+}
+function pointToPixel(pt, dpi = DEFAULT_PIXEL_DPI) {
+	return pt * dpi / 72;
+}
+function pixelToPoint(px, dpi = DEFAULT_PIXEL_DPI) {
+	return px * 72 / dpi;
+}
+//#endregion
+export { cmFromEmu as a, emuFromPoint as c, pixelToPoint as d, pointFromEmu as f, EMU_PER_POINT as i, emuFromPx as l, pxFromEmu as m, EMU_PER_INCH as n, emuFromCm as o, pointToPixel as p, EMU_PER_PIXEL as r, emuFromInch as s, EMU_PER_CM as t, inchFromEmu as u };
+
+//# sourceMappingURL=units-rOMQqXh2.mjs.map

package/dist/units-rOMQqXh2.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"units-rOMQqXh2.mjs","names":[],"sources":["../src/utils/units.ts"],"sourcesContent":["// DrawingML / SpreadsheetDrawing length unit conversions. EMUs (English Metric\n// Units) are OOXML's universal length type — 1 inch = 914400 EMU, 1 cm = 360000\n// EMU, 1 px @ 96 DPI = 9525 EMU.\n//\n// Mirrors openpyxl/openpyxl/utils/units.py. These helpers are on the hot path\n// for the drawing / chart writers.\n\nexport const EMU_PER_INCH = 914_400;\nexport const EMU_PER_CM = 360_000;\nexport const EMU_PER_PIXEL = 9_525;\nexport const EMU_PER_POINT = 12_700;\n\n/** DPI assumed by Excel when converting between pixels and other units. */\nconst DEFAULT_PIXEL_DPI = 96;\n\n// ---- pixel <-> EMU ---------------------------------------------------------\n\nexport function emuFromPx(px: number): number {\n  return Math.round(px * EMU_PER_PIXEL);\n}\nexport function pxFromEmu(emu: number): number {\n  return emu / EMU_PER_PIXEL;\n}\n\n// ---- centimetre <-> EMU ----------------------------------------------------\n\nexport function emuFromCm(cm: number): number {\n  return Math.round(cm * EMU_PER_CM);\n}\nexport function cmFromEmu(emu: number): number {\n  return emu / EMU_PER_CM;\n}\n\n// ---- inch <-> EMU ----------------------------------------------------------\n\nexport function emuFromInch(inch: number): number {\n  return Math.round(inch * EMU_PER_INCH);\n}\nexport function inchFromEmu(emu: number): number {\n  return emu / EMU_PER_INCH;\n}\n\n// ---- point <-> EMU ---------------------------------------------------------\n\nexport function emuFromPoint(pt: number): number {\n  return Math.round(pt * EMU_PER_POINT);\n}\nexport function pointFromEmu(emu: number): number {\n  return emu / EMU_PER_POINT;\n}\n\n// ---- pixel <-> point (DPI) ------------------------------------------------\n\nexport function pointToPixel(pt: number, dpi = DEFAULT_PIXEL_DPI): number {\n  return (pt * dpi) / 72;\n}\nexport function pixelToPoint(px: number, dpi = DEFAULT_PIXEL_DPI): number {\n  return (px * 72) / dpi;\n}\n"],"mappings":";AAOA,MAAa,eAAe;AAC5B,MAAa,aAAa;AAC1B,MAAa,gBAAgB;AAC7B,MAAa,gBAAgB;;AAG7B,MAAM,oBAAoB;AAI1B,SAAgB,UAAU,IAAoB;CAC5C,OAAO,KAAK,MAAM,KAAK,aAAa;AACtC;AACA,SAAgB,UAAU,KAAqB;CAC7C,OAAO,MAAM;AACf;AAIA,SAAgB,UAAU,IAAoB;CAC5C,OAAO,KAAK,MAAM,KAAK,UAAU;AACnC;AACA,SAAgB,UAAU,KAAqB;CAC7C,OAAO,MAAM;AACf;AAIA,SAAgB,YAAY,MAAsB;CAChD,OAAO,KAAK,MAAM,OAAO,YAAY;AACvC;AACA,SAAgB,YAAY,KAAqB;CAC/C,OAAO,MAAM;AACf;AAIA,SAAgB,aAAa,IAAoB;CAC/C,OAAO,KAAK,MAAM,KAAK,aAAa;AACtC;AACA,SAAgB,aAAa,KAAqB;CAChD,OAAO,MAAM;AACf;AAIA,SAAgB,aAAa,IAAY,MAAM,mBAA2B;CACxE,OAAQ,KAAK,MAAO;AACtB;AACA,SAAgB,aAAa,IAAY,MAAM,mBAA2B;CACxE,OAAQ,KAAK,KAAM;AACrB"}