@agile-team/mach-report 2.0.0 → 2.2.0

package/dist/xlsx.d.cts

@@ -1,5 +1,2300 @@
-/**
- * Excel 导出子路径入口（@agile-team/mach-report/xlsx）：
- * RenderPlan → xlsx 工作簿（exceljs 内联，零运行时依赖声明不变）。
- */
-export * from './xlsx/render-xlsx';
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { Stream } from 'stream';
+
+declare interface AboveAverageRuleType extends ConditionalFormattingBaseRule {
+    	type: 'aboveAverage';
+    	aboveAverage: boolean;
+}
+
+declare interface Address {
+    	sheetName?: string;
+    	address: string;
+    	col: string;
+    	row: string;
+    	$col$row: string;
+}
+
+declare interface AddWorksheetOptions {
+    	properties: Partial<WorksheetProperties>;
+    	pageSetup: Partial<PageSetup>;
+    	headerFooter: Partial<HeaderFooter>;
+    	views: Array<Partial<WorksheetView>>;
+    	state: WorksheetState;
+}
+
+declare interface Alignment {
+    	horizontal: 'left' | 'center' | 'right' | 'fill' | 'justify' | 'centerContinuous' | 'distributed';
+    	vertical: 'top' | 'middle' | 'bottom' | 'distributed' | 'justify';
+    	wrapText: boolean;
+    	shrinkToFit: boolean;
+    	indent: number;
+    	readingOrder: 'rtl' | 'ltr';
+    	textRotation: number | 'vertical';
+}
+
+declare class Anchor implements IAnchor {
+    	col: number;
+    	nativeCol: number;
+    	nativeColOff: number;
+    	nativeRow: number;
+    	nativeRowOff: number;
+    	row: number;
+
+    	private readonly colWidth: number;
+    	private readonly rowHeight: number;
+    	worksheet: Worksheet;
+
+    	constructor(model?: IAnchor | object);
+}
+
+declare type AutoFilter = string | {
+    	from: string | { row: number; column: number };
+    	to: string | { row: number; column: number };
+};
+
+declare interface Border {
+    	style: BorderStyle;
+    	color: Partial<Color>;
+}
+
+declare interface BorderDiagonal extends Border {
+    	up: boolean;
+    	down: boolean;
+}
+
+declare interface Borders {
+    	top: Partial<Border>;
+    	left: Partial<Border>;
+    	bottom: Partial<Border>;
+    	right: Partial<Border>;
+    	diagonal: Partial<BorderDiagonal>;
+}
+
+declare type BorderStyle =
+	| 'thin' | 'dotted' | 'hair' | 'medium' | 'double' | 'thick' | 'dashed' | 'dashDot'
+	| 'dashDotDot' | 'slantDashDot' | 'mediumDashed' | 'mediumDashDotDot' | 'mediumDashDot';
+
+declare interface Buffer_2 extends ArrayBuffer { }
+
+declare interface CalculationProperties {
+    	/**
+     	 * Whether the application shall perform a full recalculation when the workbook is opened
+     	 */
+    	fullCalcOnLoad: boolean
+}
+
+declare interface Cell extends Style, Address {
+    	readonly worksheet: Worksheet;
+    	readonly workbook: Workbook;
+
+    	readonly effectiveType: ValueType;
+    	readonly isMerged: boolean;
+    	readonly master: Cell;
+    	readonly isHyperlink: boolean;
+    	readonly hyperlink: string;	// todo
+    	readonly text: string;
+    	readonly fullAddress: {
+        		sheetName: string;
+        		address: string;
+        		row: number;
+        		col: number;
+        	};
+    	model: CellModel;
+    	/**
+     	 * Assign (or get) a name for a cell (will overwrite any other names that cell had)
+     	 */
+    	name: string;
+
+    	/**
+     	 * Assign (or get) an array of names for a cell (cells can have more than one name)
+     	 */
+    	names: string[];
+
+    	/**
+     	 * Cells can define what values are valid or not and provide
+     	 * prompting to the user to help guide them.
+     	 */
+    	dataValidation: DataValidation;
+
+    	/**
+     	 * Value of the cell
+     	 */
+    	value: CellValue;
+
+    	/**
+     	 * comment of the cell
+     	 */
+    	note: string | Comment_2;
+
+    	/**
+     	 * convenience getter to access the formula
+     	 */
+    	readonly formula: string;
+
+    	/**
+     	 * convenience getter to access the formula result
+     	 */
+    	readonly result: number | string | Date;
+
+    	/**
+     	 * The type of the cell's value
+     	 */
+    	readonly type: ValueType;
+
+    	/**
+     	 * The type of the cell's formula
+     	 */
+    	readonly formulaType: FormulaType;
+
+    	/**
+     	 * The styles of the cell
+     	 */
+    	style: Partial<Style>;
+
+    	addName(name: string): void;
+
+    	/**
+     	 * Remove a name from a cell
+     	 */
+    	removeName(name: string): void;
+    	removeAllNames(): void;
+
+    	destroy(): void;
+    	toCsvString(): string;
+    	release(): void;
+    	addMergeRef(): void;
+    	releaseMergeRef(): void;
+    	merge(master: Cell, ignoreStyle?: boolean): void;
+    	unmerge(): void;
+    	isMergedTo(master: Cell): boolean;
+    	toString(): string;
+}
+
+declare interface CellErrorValue {
+    	error: '#N/A' | '#REF!' | '#NAME?' | '#DIV/0!' | '#NULL!' | '#VALUE!' | '#NUM!';
+}
+
+declare interface CellFormulaValue {
+    	formula: string;
+    	result?: number | string | boolean | Date | CellErrorValue;
+    	date1904?: boolean;
+}
+
+declare interface CellHyperlinkValue {
+    	text: string;
+    	hyperlink: string;
+    	tooltip?: string;
+}
+
+declare type CellIsOperators = 'equal' | 'greaterThan' | 'lessThan' | 'between';
+
+declare interface CellIsRuleType extends ConditionalFormattingBaseRule {
+    	type: 'cellIs';
+    	formulae?: any[];
+    	operator?: CellIsOperators;
+}
+
+declare interface CellMatrix {
+    	addCell(addressStr: string): void;
+    	getCell(addressStr: string): Cell;
+    	findCell(addressStr: string): Cell | undefined;
+    	findCellAt(sheetName: string, rowNumber: number, colNumber: number): Cell | undefined;
+    	addCellEx(address: string | Location_2): void;
+    	getCellEx(address: string | Location_2): Cell;
+    	findCellEx(address: string | Location_2, create: boolean): Cell | undefined;
+    	getCellAt(sheetName: string, rowNumber: number, colNumber: number): Cell;
+    	removeCellEx(address: string | Location_2): void;
+    	forEach(callback: (cell: Cell) => void): void;
+    	map<T>(callback: (cell: Cell) => T): T[];
+    	findSheet(address: string | Location_2, create: boolean): Cell[] | undefined;
+    	findSheetRow(sheet: Cell[][], address: string | Location_2, create: boolean): Row | undefined;
+    	findRowCell(row: any[], address: Address, create: boolean): Cell | undefined;
+}
+
+declare interface CellModel {
+    	address: Address;
+    	style: Style;
+    	type: ValueType;
+    	text?: string;
+    	hyperlink?: string;
+    	value?: CellValue;
+    	master: string;
+    	formula?: string;
+    	sharedFormula?: string;
+    	result?: string | number | any;
+    	comment: Comment_2;
+}
+
+declare interface CellRichTextValue {
+    	richText: RichText[];
+}
+
+declare interface CellSharedFormulaValue {
+    	sharedFormula: string;
+    	readonly formula?: string;
+    	result?: number | string | boolean | Date | CellErrorValue;
+    	date1904?: boolean;
+}
+
+declare type CellValue =
+	| null | number | string | boolean | Date | undefined
+	| CellErrorValue
+	| CellRichTextValue | CellHyperlinkValue
+	| CellFormulaValue | CellSharedFormulaValue;
+
+declare type CfvoTypes = 'percentile' | 'percent' | 'num' | 'min' | 'max' | 'formula' | 'autoMin' | 'autoMax';
+
+declare interface Color {
+    	/**
+     	 * Hex string for alpha-red-green-blue e.g. FF00FF00
+     	 */
+    	argb: string;
+
+    	/**
+     	 * Choose a theme by index
+     	 */
+    	theme: number;
+}
+
+declare interface ColorScaleRuleType extends ConditionalFormattingBaseRule {
+    	type: 'colorScale';
+    	cfvo?: Cvfo[];
+    	color?: Partial<Color>[];
+}
+
+declare interface Column {
+    	/**
+     	 * Can be a string to set one row high header or an array to set multi-row high header
+     	 */
+    	header?: string | string[];
+
+    	/**
+     	 * The name of the properties associated with this column in each row
+     	 */
+    	key?: string;
+
+    	/**
+     	 * The width of the column
+     	 */
+    	width?: number;
+
+    	/**
+     	 * Set an outline level for columns
+     	 */
+    	outlineLevel: number;
+
+    	/**
+     	 * Hides the column
+     	 */
+    	hidden: boolean;
+
+    	/**
+     	 * Styles applied to the column
+     	 */
+    	style: Partial<Style>;
+
+    	/**
+     	 * The cell values in the column
+     	 */
+    	values: ReadonlyArray<CellValue>;
+
+    	/**
+     	 * Column letter key
+     	 */
+    	readonly letter: string;
+    	readonly number: number;
+    	readonly worksheet: Worksheet;
+    	readonly isCustomWidth: boolean;
+    	readonly headers: string[];
+    	readonly isDefault: boolean;
+    	readonly headerCount: number;
+
+    	/**
+     	 * Below properties read from style
+     	 */
+    	border?: Partial<Borders>;
+    	fill?: Fill;
+    	numFmt?: string;
+    	font?: Partial<Font>;
+    	alignment?: Partial<Alignment>;
+    	protection?: Partial<Protection>;
+
+    	toString(): string
+    	equivalentTo(other: Column): boolean
+
+    	/**
+     	 * indicate the collapsed state based on outlineLevel
+     	 */
+    	readonly collapsed: boolean;
+
+    	/**
+     	 * Iterate over all current cells in this column
+     	 */
+    	eachCell(callback: (cell: Cell, rowNumber: number) => void): void;
+
+    	/**
+     	 * Iterate over all current cells in this column including empty cells
+     	 */
+    	eachCell(opt: { includeEmpty: boolean }, callback: (cell: Cell, rowNumber: number) => void): void;
+
+    	defn: any; //todo
+}
+
+declare interface Comment_2 {
+    		texts?: RichText[];
+    		margins?: Partial<CommentMargins>;
+    		protection?: Partial<CommentProtection>;
+    		editAs?: CommentEditAs;
+    	}
+
+declare type CommentEditAs = 'twoCells' | 'oneCells' | 'absolute';
+
+declare interface CommentMargins {
+    		insetmode: 'auto' | 'custom';
+    		inset: Number[];
+    	}
+
+declare interface CommentProtection {
+    		locked: 'True' | 'False';
+    		lockText: 'True' | 'False';
+    	}
+
+declare type ComponentKind = "text" | "image" | "barcode" | "qrcode" | "chart" | "line" | "rect" | "ellipse";
+
+declare interface ComponentStyle {
+    fontSizePx?: number;
+    fontSize?: number;
+    fontFamily?: string;
+    bold?: boolean;
+    italic?: boolean;
+    underline?: boolean;
+    color?: string;
+    backgroundColor?: string;
+    align?: "left" | "center" | "right" | "justify";
+    verticalAlign?: "top" | "middle" | "bottom";
+    lineColor?: string;
+    borderColor?: string;
+    lineWidthPt?: number;
+    borderTop?: boolean;
+    borderRight?: boolean;
+    borderBottom?: boolean;
+    borderLeft?: boolean;
+    lineHeight?: number;
+    letterSpacing?: number;
+    opacity?: number;
+    rotateDeg?: number;
+}
+
+declare interface ConditionalFormattingBaseRule {
+    	priority: number;
+    	style?: Partial<Style>;
+}
+
+declare interface ConditionalFormattingOptions {
+    	ref: string;
+    	rules: ConditionalFormattingRule[];
+}
+
+declare type ConditionalFormattingRule = ExpressionRuleType | CellIsRuleType | Top10RuleType | AboveAverageRuleType | ColorScaleRuleType | IconSetRuleType
+	| ContainsTextRuleType | TimePeriodRuleType | DataBarRuleType;
+
+declare namespace config {
+    	function setValue(key: 'promise', promise: any): void;
+}
+
+declare type ContainsTextOperators = 'containsText' | 'containsBlanks' | 'notContainsBlanks' | 'containsErrors' | 'notContainsErrors';
+
+declare interface ContainsTextRuleType extends ConditionalFormattingBaseRule {
+    	type: 'containsText';
+    	operator?: ContainsTextOperators;
+    	text?: string;
+}
+
+declare interface Csv {
+    	/**
+     	 * read from a file
+     	 */
+    	readFile(path: string, options?: Partial<CsvReadOptions>): Promise<Worksheet>;
+
+    	/**
+     	 * read from a stream
+     	 */
+    	read(stream: Stream, options?: Partial<CsvReadOptions>): Promise<Worksheet>;
+
+    	/**
+     	 * Create input stream for reading
+     	 */
+    	createInputStream(options?: Partial<CsvReadOptions>): EventEmitter;
+
+    	/**
+     	 * write to a buffer
+     	 */
+    	writeBuffer(options?: Partial<CsvWriteOptions>): Promise<Buffer_2>;
+
+    	/**
+     	 * write to a file
+     	 */
+    	writeFile(path: string, options?: Partial<CsvWriteOptions>): Promise<void>;
+
+    	/**
+     	 * write to a stream
+     	 */
+    	write(stream: Stream, options?: Partial<CsvWriteOptions>): Promise<void>;
+}
+
+declare interface CsvReadOptions {
+    	dateFormats: string[];
+    	map(value: any, index: number): any;
+    	sheetName: string;
+    	parserOptions: Partial<FastCsvParserOptionsArgs>;
+}
+
+declare interface CsvWriteOptions {
+    	dateFormat: string;
+    	dateUTC: boolean;
+    	sheetName: string;
+    	sheetId: number;
+    	encoding: string;
+    	map(value: any, index: number): any;
+    	includeEmptyRows: boolean;
+    	formatterOptions: Partial<FastCsvFormatterOptionsArgs>;
+}
+
+declare interface Cvfo {
+    	type: CfvoTypes;
+    	value?: number;
+}
+
+declare interface DataBarRuleType extends ConditionalFormattingBaseRule {
+    	type: 'dataBar';
+    	gradient?: boolean;
+    	minLength?: number;
+    	maxLength?: number;
+    	showValue?: boolean;
+    	border?: boolean;
+    	negativeBarColorSameAsPositive?: boolean;
+    	negativeBarBorderColorSameAsPositive?: boolean;
+    	axisPosition?: 'auto' | 'middle' | 'none';
+    	direction?: 'context' | 'leftToRight' | 'rightToLeft';
+    	cfvo?: Cvfo[];
+}
+
+declare interface DataValidation {
+    	type: 'list' | 'whole' | 'decimal' | 'date' | 'textLength' | 'custom';
+    	formulae: any[];
+    	allowBlank?: boolean;
+    	operator?: DataValidationOperator;
+    	error?: string;
+    	errorTitle?: string;
+    	errorStyle?: string;
+    	prompt?: string;
+    	promptTitle?: string;
+    	showErrorMessage?: boolean;
+    	showInputMessage?: boolean;
+}
+
+declare type DataValidationOperator =
+	| 'between' | 'notBetween' | 'equal' | 'notEqual' | 'greaterThan' | 'lessThan'
+	| 'greaterThanOrEqual' | 'lessThanOrEqual';
+
+declare interface DefinedNames {
+    	getMatrix(name: string): CellMatrix;
+    	// add a name to a cell. locStr in the form SheetName!$col$row or SheetName!$c1$r1:$c2:$r2
+    	add(locStr: string, name?: string): void;
+    	addEx(location: string | Location_2, name: string): Cell;
+
+    	remove(locStr: string | Location_2, name: string): void;
+    	removeEx(location: string | Location_2, name: string): void;
+    	removeAllNames(location: string | Location_2): void;
+
+    	forEach(callback: (name: string, cell: Cell) => void): void;
+
+    	// get all the names of a cell
+    	getNames(addressStr: string): string[];
+    	getNamesEx(address: string): string[];
+
+    	getRanges(name: string, matrix?: CellMatrix): DefinedNamesRanges;
+
+    	model: DefinedNamesModel;
+}
+
+declare type DefinedNamesModel = DefinedNamesRanges[];
+
+declare interface DefinedNamesRanges {
+    	name: string;
+    	ranges: string[];
+}
+
+declare enum DocumentType_2 {
+    	Xlsx = 1
+}
+
+declare enum ErrorValue {
+    	NotApplicable = '#N/A',
+    	Ref = '#REF!',
+    	Name = '#NAME?',
+    	DivZero = '#DIV/0!',
+    	Null = '#NULL!',
+    	Value = '#VALUE!',
+    	Num = '#NUM!',
+}
+
+declare namespace ExcelJS {
+    export {
+        Buffer_2 as Buffer,
+        RelationshipType,
+        DocumentType_2 as DocumentType,
+        PaperSize,
+        WorksheetViewCommon,
+        WorksheetViewNormal,
+        WorksheetViewFrozen,
+        WorksheetViewSplit,
+        WorksheetView,
+        WorkbookView,
+        FillPatterns,
+        FillPattern,
+        GradientStop,
+        FillGradientAngle,
+        FillGradientPath,
+        Fill,
+        Font,
+        BorderStyle,
+        Color,
+        Border,
+        BorderDiagonal,
+        Borders,
+        Margins,
+        ReadingOrder,
+        Alignment,
+        Protection,
+        Style,
+        DataValidationOperator,
+        DataValidation,
+        ErrorValue,
+        CellErrorValue,
+        RichText,
+        CellRichTextValue,
+        CellHyperlinkValue,
+        CellFormulaValue,
+        CellSharedFormulaValue,
+        ValueType,
+        FormulaType,
+        CellValue,
+        CommentMargins,
+        CommentProtection,
+        CommentEditAs,
+        Comment_2 as Comment,
+        CellModel,
+        Cell,
+        RowModel,
+        Row,
+        Column,
+        PageSetup,
+        HeaderFooter,
+        AutoFilter,
+        WorksheetProtection,
+        Image_2 as Image,
+        IAnchor,
+        Anchor,
+        ImageRange,
+        ImagePosition,
+        ImageHyperlinkValue,
+        Range_2 as Range,
+        RowBreak,
+        WorksheetModel,
+        WorksheetState,
+        CellIsOperators,
+        ContainsTextOperators,
+        TimePeriodTypes,
+        IconSetTypes,
+        CfvoTypes,
+        Cvfo,
+        ConditionalFormattingBaseRule,
+        ExpressionRuleType,
+        CellIsRuleType,
+        Top10RuleType,
+        AboveAverageRuleType,
+        ColorScaleRuleType,
+        IconSetRuleType,
+        ContainsTextRuleType,
+        TimePeriodRuleType,
+        DataBarRuleType,
+        ConditionalFormattingRule,
+        RowValues,
+        ConditionalFormattingOptions,
+        Worksheet,
+        CalculationProperties,
+        WorksheetProperties,
+        AddWorksheetOptions,
+        WorkbookProperties,
+        JSZipGeneratorOptions,
+        XlsxReadOptions,
+        XlsxWriteOptions,
+        Xlsx,
+        HeaderArray,
+        HeaderTransformFunction,
+        FastCsvParserOptionsArgs,
+        QuoteColumnMap,
+        QuoteColumns,
+        RowMap,
+        RowHashArray,
+        RowArray,
+        Rows,
+        RowTransformCallback,
+        RowTransformFunction,
+        FastCsvFormatterOptionsArgs,
+        CsvReadOptions,
+        CsvWriteOptions,
+        Csv,
+        Media,
+        Address,
+        Location_2 as Location,
+        CellMatrix,
+        DefinedNamesRanges,
+        DefinedNamesModel,
+        DefinedNames,
+        WorkbookModel,
+        Workbook,
+        TableStyleProperties,
+        TableColumnProperties,
+        TableProperties,
+        TableColumn,
+        Table,
+        config,
+        stream
+    }
+}
+
+declare interface ExpressionRuleType extends ConditionalFormattingBaseRule {
+    	type: 'expression';
+    	formulae?: any[];
+}
+
+declare interface FastCsvFormatterOptionsArgs {
+    	objectMode: boolean;
+    	delimiter: string;
+    	rowDelimiter: string;
+    	quote: string | boolean;
+    	escape: string;
+    	quoteColumns: QuoteColumns;
+    	quoteHeaders: QuoteColumns;
+    	headers: null | boolean | string[];
+    	includeEndRowDelimiter: boolean;
+    	writeBOM: boolean;
+    	transform: RowTransformFunction;
+    	alwaysWriteHeaders: boolean;
+}
+
+declare interface FastCsvParserOptionsArgs {
+    	objectMode: boolean;
+    	delimiter: string;
+    	quote: string | null;
+    	escape: string;
+    	headers: boolean | HeaderTransformFunction | HeaderArray;
+    	renameHeaders: boolean;
+    	ignoreEmpty: boolean;
+    	comment: string;
+    	strictColumnHandling: boolean;
+    	discardUnmappedColumns: boolean;
+    	trim: boolean;
+    	ltrim: boolean;
+    	rtrim: boolean;
+    	encoding: string;
+    	maxRows: number;
+    	skipLines: number;
+    	skipRows: number;
+}
+
+declare type Fill = FillPattern | FillGradientAngle | FillGradientPath;
+
+declare interface FillGradientAngle {
+    	type: 'gradient';
+    	gradient: 'angle';
+
+    	/**
+     	 * For 'angle' gradient, specifies the direction of the gradient. 0 is from the left to the right.
+     	 * Values from 1 - 359 rotates the direction clockwise
+     	 */
+    	degree: number;
+
+    	/**
+     	 * Specifies the gradient colour sequence. Is an array of objects containing position and
+     	 * color starting with position 0 and ending with position 1.
+     	 * Intermediary positions may be used to specify other colours on the path.
+     	 */
+    	stops: GradientStop[];
+}
+
+declare interface FillGradientPath {
+    	type: 'gradient';
+    	gradient: 'path';
+
+    	/**
+     	 * For 'path' gradient. Specifies the relative coordinates for the start of the path.
+     	 * 'left' and 'top' values range from 0 to 1
+     	 */
+    	center: { left: number; top: number };
+
+    	/**
+     	 * Specifies the gradient colour sequence. Is an array of objects containing position and
+     	 * color starting with position 0 and ending with position 1.
+     	 * Intermediary positions may be used to specify other colours on the path.
+     	 */
+    	stops: GradientStop[];
+}
+
+declare interface FillPattern {
+    	type: 'pattern';
+    	pattern: FillPatterns;
+    	fgColor?: Partial<Color>;
+    	bgColor?: Partial<Color>;
+}
+
+declare type FillPatterns =
+	| 'none' | 'solid'
+	| 'darkVertical' | 'darkHorizontal' | 'darkGrid' | 'darkTrellis' | 'darkDown' | 'darkUp'
+	| 'lightVertical' | 'lightHorizontal' | 'lightGrid' | 'lightTrellis' | 'lightDown' | 'lightUp'
+	| 'darkGray' | 'mediumGray' | 'lightGray' | 'gray125' | 'gray0625';
+
+declare interface Font {
+    	name: string;
+    	size: number;
+    	family: number;
+    	scheme: 'minor' | 'major' | 'none';
+    	charset: number;
+    	color: Partial<Color>;
+    	bold: boolean;
+    	italic: boolean;
+    	underline: boolean | 'none' | 'single' | 'double' | 'singleAccounting' | 'doubleAccounting';
+    	vertAlign: 'superscript' | 'subscript';
+    	strike: boolean;
+    	outline: boolean;
+}
+
+declare enum FormulaType {
+    	None = 0,
+    	Master = 1,
+    	Shared = 2
+}
+
+declare interface GradientStop {
+    	position: number;
+    	color: Partial<Color>;
+}
+
+declare interface GridCell {
+    text?: string;
+    rawText?: string;
+    /** 原始值，仅供 Excel raw 模式消费；不参与预览、分页与 PDF 绘制。 */
+    value?: string | number | boolean | null;
+    /** Excel 数字格式（例如 #,##0.00 / 0.00%），不改变 text。 */
+    numberFormat?: string;
+    children?: PlanComponent[];
+    colSpan?: number;
+    rowSpan?: number;
+    style?: ComponentStyle;
+}
+
+declare type HeaderArray = (string | undefined | null)[];
+
+declare interface HeaderFooter {
+    	/**
+     	 * Set the value of differentFirst as true, which indicates that headers/footers for first page are different from the other pages, `false` by default
+     	 */
+    	differentFirst: boolean,
+    	/**
+     	 * Set the value of differentOddEven as true, which indicates that headers/footers for odd and even pages are different, `false` by default
+     	 */
+    	differentOddEven: boolean,
+    	/**
+     	 * Set header string for odd pages, could format the string and `null` by default
+     	 */
+    	oddHeader: string,
+    	/**
+     	 * Set footer string for odd pages, could format the string and `null` by default
+     	 */
+    	oddFooter: string,
+    	/**
+     	 * Set header string for even pages, could format the string and `null` by default
+     	 */
+    	evenHeader: string,
+    	/**
+     	 * Set footer string for even pages, could format the string and `null` by default
+     	 */
+    	evenFooter: string,
+    	/**
+     	 * Set header string for the first page, could format the string and `null` by default
+     	 */
+    	firstHeader: string,
+    	/**
+     	 * Set footer string for the first page, could format the string and `null` by default
+     	 */
+    	firstFooter: string
+}
+
+declare type HeaderTransformFunction = (headers: HeaderArray) => HeaderArray;
+
+declare interface IAnchor {
+    	col: number;
+    	row: number;
+    	nativeCol: number;
+    	nativeRow: number;
+    	nativeColOff: number;
+    	nativeRowOff: number;
+}
+
+declare interface IconSetRuleType extends ConditionalFormattingBaseRule {
+    	type: 'iconSet';
+    	showValue?: boolean;
+    	reverse?: boolean;
+    	custom?: boolean;
+    	iconSet?: IconSetTypes;
+    	cfvo?: Cvfo[];
+}
+
+declare type IconSetTypes = '5Arrows' | '5ArrowsGray' | '5Boxes' | '5Quarters' | '5Rating' | '4Arrows' | '4ArrowsGray'
+	| '4Rating' | '4RedToBlack' | '4TrafficLights' | 'NoIcons' | '3Arrows' | '3ArrowsGray' | '3Flags' | '3Signs'
+	| '3Stars' | '3Symbols' | '3Symbols2' | '3TrafficLights1' | '3TrafficLights2' | '3Triangles';
+
+declare interface Image_2 {
+    	extension: 'jpeg' | 'png' | 'gif';
+    	base64?: string;
+    	filename?: string;
+    	buffer?: Buffer_2;
+}
+
+declare interface ImageHyperlinkValue {
+    	hyperlink: string;
+    	tooltip?: string;
+}
+
+declare interface ImagePosition {
+    	tl: { col: number; row: number };
+    	ext: { width: number; height: number };
+}
+
+declare interface ImageRange {
+    	tl: Anchor;
+    	br: Anchor;
+}
+
+declare interface JSZipGeneratorOptions {
+    	/**
+     	 * @default DEFLATE
+     	 */
+    	compression: 'STORE' | 'DEFLATE';
+    	compressionOptions: null | {
+        		/**
+         		 * @default 6
+         		 */
+        		level: number;
+        	};
+}
+
+declare interface Location_2 {
+    	top: number;
+    	left: number;
+    	bottom: number;
+    	right: number;
+}
+
+declare interface Margins {
+    	top: number;
+    	left: number;
+    	bottom: number;
+    	right: number;
+    	header: number;
+    	footer: number;
+}
+
+declare interface Media {
+    	type: string;	// image,background
+    	name: string;
+    	extension: string;
+    	buffer: Buffer_2;
+}
+
+declare interface PageSetup {
+    	/**
+     	 * Whitespace on the borders of the page. Units are inches.
+     	 */
+    	margins: Margins;
+
+    	/**
+     	 * Orientation of the page - i.e. taller (`'portrait'`) or wider (`'landscape'`).
+     	 *
+     	 * `'portrait'` by default
+     	 */
+    	orientation: 'portrait' | 'landscape';
+
+    	/**
+     	 * Horizontal Dots per Inch. Default value is 4294967295
+     	 */
+    	horizontalDpi: number;
+
+    	/**
+     	 * Vertical Dots per Inch. Default value is 4294967295
+     	 */
+    	verticalDpi: number;
+
+    	/**
+     	 * Whether to use fitToWidth and fitToHeight or scale settings.
+     	 *
+     	 * Default is based on presence of these settings in the pageSetup object - if both are present,
+     	 * scale wins (i.e. default will be false)
+     	 */
+    	fitToPage: boolean;
+
+    	/**
+     	 * How many pages wide the sheet should print on to. Active when fitToPage is true
+     	 *
+     	 * Default is 1
+     	 */
+    	fitToWidth: number;
+
+    	/**
+     	 * How many pages high the sheet should print on to. Active when fitToPage is true
+     	 *
+     	 * Default is 1
+     	 */
+    	fitToHeight: number;
+
+    	/**
+     	 * Percentage value to increase or reduce the size of the print. Active when fitToPage is false
+     	 *
+     	 * Default is 100
+     	 */
+    	scale: number;
+
+    	/**
+     	 * Which order to print the pages.
+     	 *
+     	 * Default is `downThenOver`
+     	 */
+    	pageOrder: 'downThenOver' | 'overThenDown';
+
+    	/**
+     	 * Print without colour
+     	 *
+     	 * false by default
+     	 */
+    	blackAndWhite: boolean;
+
+    	/**
+     	 * Print with less quality (and ink)
+     	 *
+     	 * false by default
+     	 */
+    	draft: boolean;
+
+    	/**
+     	 * Where to place comments
+     	 *
+     	 * Default is `None`
+     	 */
+    	cellComments: 'atEnd' | 'asDisplayed' | 'None';
+
+    	/**
+     	 * Where to show errors
+     	 *
+     	 * Default is `displayed`
+     	 */
+    	errors: 'dash' | 'blank' | 'NA' | 'displayed';
+
+    	/**
+     	 * 	What paper size to use (see below)
+     	 *
+     	 * | Name                          | Value       |
+     	 * | ----------------------------- | ---------   |
+     	 * | Letter                        | `undefined` |
+     	 * | Legal                         |  `5`        |
+     	 * | Executive                     |  `7`        |
+     	 * | A4                            |  `9`        |
+     	 * | A5                            |  `11`       |
+     	 * | B5 (JIS)                      |  `13`       |
+     	 * | Envelope #10                  |  `20`       |
+     	 * | Envelope DL                   |  `27`       |
+     	 * | Envelope C5                   |  `28`       |
+     	 * | Envelope B5                   |  `34`       |
+     	 * | Envelope Monarch              |  `37`       |
+     	 * | Double Japan Postcard Rotated |  `82`       |
+     	 * | 16K 197x273 mm                |  `119`      |
+     	 */
+    	paperSize: PaperSize;
+
+    	/**
+     	 * Whether to show the row numbers and column letters, `false` by default
+     	 */
+    	showRowColHeaders: boolean;
+
+    	/**
+     	 * Whether to show grid lines, `false` by default
+     	 */
+    	showGridLines: boolean;
+
+    	/**
+     	 * Which number to use for the first page
+     	 */
+    	firstPageNumber: number;
+
+    	/**
+     	 * 	Whether to center the sheet data horizontally, `false` by default
+     	 */
+    	horizontalCentered: boolean;
+
+    	/**
+     	 * 	Whether to center the sheet data vertically, `false` by default
+     	 */
+    	verticalCentered: boolean;
+
+    	/**
+     	 * Set Print Area for a sheet, e.g. `'A1:G20'`
+     	 */
+    	printArea: string;
+
+    	/**
+     	 * Repeat specific rows on every printed page, e.g. `'1:3'`
+     	 */
+    	printTitlesRow: string;
+
+    	/**
+     	 * Repeat specific columns on every printed page, e.g. `'A:C'`
+     	 */
+    	printTitlesColumn: string;
+}
+
+declare const enum PaperSize {
+    	Legal = 5,
+    	Executive = 7,
+    	A4 = 9,
+    	A5 = 11,
+    	B5 = 13,
+    	Envelope_10 = 20,
+    	Envelope_DL = 27,
+    	Envelope_C5 = 28,
+    	Envelope_B5 = 34,
+    	Envelope_Monarch = 37,
+    	Double_Japan_Postcard_Rotated = 82,
+    	K16_197x273_mm = 119,
+}
+
+declare interface PlanComponent {
+    kind: ComponentKind;
+    leftMm: number;
+    topMm: number;
+    widthMm: number;
+    heightMm: number;
+    nid?: string;
+    rkey?: string;
+    text?: string;
+    rawText?: string;
+    lines?: string[];
+    richParagraphs?: RichParagraph[];
+    imageData?: string;
+    grid?: PlanGrid;
+    style?: ComponentStyle;
+    meta?: Record<string, unknown>;
+    /** MachReport 扩展字段：未知 kind 的兜底渲染标记 */
+    fallbackText?: string;
+}
+
+declare interface PlanGrid {
+    /** 行内允许 null 空位；渲染器按空单元格处理 */
+    cells: (GridCell | null)[][];
+    colWidthsMm?: number[];
+    rowHeightsMm?: number[];
+    gapMm?: number;
+}
+
+declare interface PlanPage {
+    pageWidthMm: number;
+    pageHeightMm: number;
+    marginTopMm?: number;
+    marginBottomMm?: number;
+    marginLeftMm?: number;
+    marginRightMm?: number;
+    components: PlanComponent[];
+}
+
+declare interface Protection {
+    	locked: boolean;
+    	hidden: boolean;
+}
+
+declare interface QuoteColumnMap {
+    	[s: string]: boolean;
+}
+
+declare type QuoteColumns = boolean | boolean[] | QuoteColumnMap;
+
+declare interface Range_2 extends Location_2 {
+    	sheetName: string;
+
+    	tl: string;
+    	$t$l: string;
+
+    	br: string;
+    	$b$r: string;
+
+    	range: string;
+    	$range: string;
+
+    	shortRange: string;
+    	$shortRange: string;
+
+    	count: number;
+
+    	decode(): void;
+    	decode(v: Range_2): void;
+    	decode(v: string): void;
+    	decode(v: Location_2): void;
+    	decode(top: number, left: number, bottom: number, right: number, sheetName?: string): void;
+    	decode(tl: string, br: string, sheetName?: string): void;
+    	decode(v: [string, string]): void;
+    	decode(v: [string, string, string]): void;
+    	decode(v: [number, number, number, number]): void;
+    	decode(v: [number, number, number, number, string]): void;
+
+    	expand(top: number, left: number, bottom: number, right: number): void;
+
+    	expandRow(row: Row): void;
+
+    	expandToAddress(addressStr: string): void;
+
+    	toString(): string;
+
+    	intersects(other: Range_2): boolean;
+
+    	contains(addressStr: string): boolean;
+
+    	containsEx(address: Partial<{
+        		sheetName: string;
+        		row: number;
+        		col: number;
+        	}>): boolean;
+}
+
+declare enum ReadingOrder {
+    	LeftToRight = 1,
+    	RightToLeft = 2,
+}
+
+declare enum RelationshipType {
+    	None = 0,
+    	OfficeDocument = 1,
+    	Worksheet = 2,
+    	CalcChain = 3,
+    	SharedStrings = 4,
+    	Styles = 5,
+    	Theme = 6,
+    	Hyperlink = 7
+}
+
+declare interface RenderPlan {
+    schemaVersion: string;
+    pages: PlanPage[];
+}
+
+export declare function renderPlanToXlsx(plan: RenderPlan, options?: XlsxRenderOptions): Promise<XlsxRenderResult>;
+
+declare interface RichParagraph {
+    segments: RichSegment[];
+    align?: ComponentStyle["align"];
+    lineHeight?: number;
+    spaceBeforeMm?: number;
+    spaceAfterMm?: number;
+    indentMm?: number;
+}
+
+declare interface RichSegment {
+    kind?: "text" | "field";
+    text?: string;
+    field?: string;
+    style?: ComponentStyle;
+}
+
+declare interface RichText {
+    	text: string;
+    	font?: Partial<Font>;
+}
+
+declare interface Row extends Style {
+    	readonly worksheet: Worksheet;
+    	readonly hasValues: boolean;
+    	readonly dimensions: number;
+    	model: Partial<RowModel> | null;
+    	/**
+     	 * Set a specific row height
+     	 */
+    	height: number;
+
+    	/**
+     	 * Make row hidden
+     	 */
+    	hidden: boolean;
+
+    	/**
+     	 * Get a row as a sparse array
+     	 */
+    	// readonly values: CellValue[];
+    	values: CellValue[] | { [key: string]: CellValue };
+
+    	/**
+     	 * Set an outline level for rows
+     	 */
+    	outlineLevel?: number;
+
+    	/**
+     	 * The row number
+     	 */
+    	readonly number: number;
+
+    	/**
+     	 * Indicate the collapsed state based on outlineLevel
+     	 */
+    	readonly collapsed: boolean;
+
+    	/**
+     	 * Number of cells including empty ones
+     	 */
+    	readonly cellCount: number;
+
+    	/**
+     	 * Number of non-empty cells
+     	 */
+    	readonly actualCellCount: number;
+
+    	/**
+     	 * Get cell by number, column letter or column key
+     	 */
+    	getCell(indexOrKey: number | string): Cell;
+
+    	findCell(colNumber: number): Cell | undefined;
+
+    	getCellEx(address: Address): Cell;
+
+    	/**
+     	 * Iterate over all non-null cells in a row
+     	 */
+    	eachCell(callback: (cell: Cell, colNumber: number) => void): void;
+
+    	/**
+     	 * Iterate over all cells in a row (including empty cells)
+     	 */
+    	eachCell(opt: { includeEmpty: boolean }, callback: (cell: Cell, colNumber: number) => void): void;
+
+    	/**
+     	 * Cut one or more cells (cells to the right are shifted left)
+     	 *
+     	 * Note: this operation will not affect other rows
+     	 */
+    	splice(start: number, count: number, ...insert: any[]): void;
+
+    	/**
+     	 * Commit a completed row to stream
+     	 */
+    	commit(): void;
+    	destroy(): void;
+    	addPageBreak(lft?: number, rght?: number): void;
+}
+
+declare type RowArray = string[];
+
+declare interface RowBreak {
+    	id: number;
+    	max: number;
+    	min: number;
+    	man: number;
+}
+
+declare type RowHashArray = [string, any][];
+
+declare interface RowMap {
+    	[key: string]: any;
+}
+
+declare interface RowModel {
+    	cells: CellModel[];
+    	number: number;
+    	min: number;
+    	max: number;
+    	height: number;
+    	style: Partial<Style>;
+    	hidden: boolean;
+    	outlineLevel: number;
+    	collapsed: boolean;
+}
+
+declare type Rows = RowArray | RowMap | RowHashArray;
+
+declare type RowTransformCallback = (error?: Error | null, row?: Rows) => void;
+
+declare interface RowTransformFunction {
+    	(row: Rows, callback: RowTransformCallback): void;
+    	(row: Rows): Rows;
+}
+
+declare type RowValues = CellValue[] | { [key: string]: CellValue } | undefined | null;
+
+declare namespace stream {
+    	namespace xlsx {
+        		interface WorkbookWriterOptions {
+            			/**
+             			 * Specifies a writable stream to write the XLSX workbook to.
+             			 */
+            			stream: Stream;
+
+            			/**
+             			 * 	If stream not specified, this field specifies the path to a file to write the XLSX workbook to.
+             			 */
+            			filename: string;
+
+            			/**
+             			 * 	Specifies whether to use shared strings in the workbook. Default is false
+             			 */
+            			useSharedStrings: boolean;
+
+            			/**
+             			 * Specifies whether to add style information to the workbook.
+             			 * Styles can add some performance overhead. Default is false
+             			 */
+            			useStyles: boolean;
+            		}
+
+        		interface ArchiverZipOptions {
+            			comment: string;
+            			forceLocalTime: boolean;
+            			forceZip64: boolean;
+            			store: boolean;
+            			zlib: Partial<ZlibOptions>;
+            		}
+
+        		interface ZlibOptions {
+            			/**
+             			 * @default constants.Z_NO_FLUSH
+             			 */
+            			flush: number;
+            			/**
+             			 * @default constants.Z_FINISH
+             			 */
+            			finishFlush: number;
+            			/**
+             			 * @default 16*1024
+             			 */
+            			chunkSize: number;
+            			windowBits: number;
+            			level: number; // compression only
+            			memLevel: number; // compression only
+            			strategy: number; // compression only
+            			dictionary: Buffer_2 | NodeJS.TypedArray | DataView | ArrayBuffer; // deflate/inflate only, empty dictionary by default
+            		}
+
+        		interface WorkbookStreamWriterOptions extends WorkbookWriterOptions {
+
+            			/**
+             			 * Specifies whether to add style information to the workbook.
+             			 * Styles can add some performance overhead. Default is false
+             			 */
+            			zip: Partial<ArchiverZipOptions>;
+            		}
+
+        		class WorkbookWriter extends Workbook {
+            			constructor(options: Partial<WorkbookStreamWriterOptions>);
+            			// commit all worksheets, then add suplimentary files
+            			commit(): Promise<void>;
+            			addStyles(): Promise<void>;
+            			addThemes(): Promise<void>;
+            			addOfficeRels(): Promise<void>;
+            			addContentTypes(): Promise<void>;
+            			addApp(): Promise<void>;
+            			addCore(): Promise<void>;
+            			addSharedStrings(): Promise<void>;
+            			addWorkbookRels(): Promise<void>;
+            			addWorkbook(): Promise<void>;
+            		}
+
+
+        		interface WorkbookStreamReaderOptions {
+            			/**
+             			 * @default 'emit'
+             			 */
+            			worksheets?: 'emit' | 'ignore';
+            			/**
+             			 * @default 'cache'
+             			 */
+            			sharedStrings?: 'cache' | 'emit' | 'ignore';
+            			/**
+             			 * @default 'ignore'
+             			 */
+            			hyperlinks?: 'cache' | 'emit' | 'ignore';
+            			/**
+             			 * @default 'ignore'
+             			 */
+            			styles?: 'cache' | 'ignore';
+            			/**
+             			 * @default 'ignore'
+             			 */
+            			entries?: 'emit' | 'ignore';
+            		}
+
+        		class WorkbookReader extends Workbook {
+            			constructor(input: string | Stream, options: Partial<WorkbookStreamReaderOptions>);
+            			read(): Promise<void>;
+            			[Symbol.asyncIterator](): AsyncGenerator<WorksheetReader>;
+            			parse(): AsyncIterator<any>;
+            		}
+
+        		interface WorksheetReaderOptions {
+            			workbook: Workbook;
+            			id: number;
+            			entry: Stream;
+            			options: WorkbookStreamReaderOptions;
+            		}
+
+        		class WorksheetReader {
+            			constructor(options: WorksheetReaderOptions);
+            			read(): Promise<void>;
+            			[Symbol.asyncIterator](): AsyncGenerator<Row>;
+            			parse(): AsyncIterator<Array<any>>;
+            			dimensions(): number;
+            			columns(): number;
+            			getColumn(c: number): Column;
+            		}
+        	}
+}
+
+declare interface Style {
+    	numFmt: string;
+    	font: Partial<Font>;
+    	alignment: Partial<Alignment>;
+    	protection: Partial<Protection>;
+    	border: Partial<Borders>;
+    	fill: Fill;
+}
+
+declare interface Table extends Required<TableProperties> {
+    	/**
+     	 * Commit changes
+     	 */
+    	commit: () => void
+    	/**
+     	 * Remove a rows of data
+     	 */
+    	removeRows: (rowIndex: number, count: number) => void
+    	/**
+     	 * Add a row of data, either insert at rowNumber or append
+     	 */
+    	addRow: (values: any[], rowNumber?: number) => void
+    	/**
+     	 * Get column
+     	 */
+    	getColumn: (colIndex: number) => TableColumn
+    	/**
+     	 * Add a new column, including column defn and values
+     	 * inserts at colNumber or adds to the right
+     	 */
+    	addColumn: (column: TableColumnProperties, values: any[], colIndex: number) => void
+    	/**
+     	 * Remove a column with data
+     	 */
+    	removeColumns: (colIndex: number, count: number) => void
+}
+
+declare type TableColumn = Required<TableColumnProperties>
+
+declare interface TableColumnProperties {
+    	/**
+     	  * The name of the column, also used in the header
+     	  */
+    	name: string;
+    	/**
+     	  * Switches the filter control in the header
+     	  * @default false
+     	  */
+    	filterButton?: boolean;
+    	/**
+     	  * Label to describe the totals row (first column)
+     	  * @default 'Total'
+     	  */
+    	totalsRowLabel?: string;
+    	/**
+     	  * Name of the totals function
+     	  * @default 'none'
+     	  */
+    	totalsRowFunction?: 'none' | 'average' | 'countNums' | 'count' | 'max' | 'min' | 'stdDev' | 'var' | 'sum' | 'custom';
+    	/**
+     	  * Optional formula for custom functions
+     	  */
+    	totalsRowFormula?: string;
+}
+
+declare interface TableProperties {
+    	/**
+     	 * The name of the table
+     	 */
+    	name: string;
+    	/**
+     	 * The display name of the table
+     	 */
+    	displayName?: string;
+    	/**
+     	 * Top left cell of the table
+     	 */
+    	ref: string;
+    	/**
+     	 * Show headers at top of table
+     	 * @default true
+     	 */
+    	headerRow?: boolean;
+    	/**
+     	 * Show totals at bottom of table
+     	 * @default false
+     	 */
+    	totalsRow?: boolean;
+    	/**
+     	 * Extra style properties
+     	 * @default {}
+     	 */
+    	style?: TableStyleProperties;
+    	/**
+     	 * Column definitions
+     	 */
+    	columns: TableColumnProperties[]
+    	/**
+     	 * Rows of data
+     	 */
+    	rows: any[][]
+}
+
+declare interface TableStyleProperties {
+    	/**
+     	 * The colour theme of the table
+     	 * @default 'TableStyleMedium2'
+     	 */
+    	theme?: 'TableStyleDark1' | 'TableStyleDark10' | 'TableStyleDark11' | 'TableStyleDark2' | 'TableStyleDark3' | 'TableStyleDark4' | 'TableStyleDark5' | 'TableStyleDark6' | 'TableStyleDark7' | 'TableStyleDark8' | 'TableStyleDark9' | 'TableStyleLight1' | 'TableStyleLight10' | 'TableStyleLight11' | 'TableStyleLight12' | 'TableStyleLight13' | 'TableStyleLight14' | 'TableStyleLight15' | 'TableStyleLight16' | 'TableStyleLight17' | 'TableStyleLight18' | 'TableStyleLight19' | 'TableStyleLight2' | 'TableStyleLight20' | 'TableStyleLight21' | 'TableStyleLight3' | 'TableStyleLight4' | 'TableStyleLight5' | 'TableStyleLight6' | 'TableStyleLight7' | 'TableStyleLight8' | 'TableStyleLight9' | 'TableStyleMedium1' | 'TableStyleMedium10' | 'TableStyleMedium11' | 'TableStyleMedium12' | 'TableStyleMedium13' | 'TableStyleMedium14' | 'TableStyleMedium15' | 'TableStyleMedium16' | 'TableStyleMedium17' | 'TableStyleMedium18' | 'TableStyleMedium19' | 'TableStyleMedium2' | 'TableStyleMedium20' | 'TableStyleMedium21' | 'TableStyleMedium22' | 'TableStyleMedium23' | 'TableStyleMedium24' | 'TableStyleMedium25' | 'TableStyleMedium26' | 'TableStyleMedium27' | 'TableStyleMedium28' | 'TableStyleMedium3' | 'TableStyleMedium4' | 'TableStyleMedium5' | 'TableStyleMedium6' | 'TableStyleMedium7' | 'TableStyleMedium8' | 'TableStyleMedium9';
+    	/**
+     	  * Highlight the first column (bold)
+     	  * @default false
+     	  */
+    	showFirstColumn?: boolean;
+    	/**
+     	  * Highlight the last column (bold)
+     	  * @default false
+     	  */
+    	showLastColumn?: boolean;
+    	/**
+     	  * Alternate rows shown with background colour
+     	  * @default false
+     	  */
+    	showRowStripes?: boolean;
+    	/**
+     	  * Alternate rows shown with background colour
+     	  * @default false
+     	  */
+    	showColumnStripes?: boolean;
+}
+
+declare interface TimePeriodRuleType extends ConditionalFormattingBaseRule {
+    	type: 'timePeriod';
+    	timePeriod?: TimePeriodTypes;
+}
+
+declare type TimePeriodTypes = 'lastWeek' | 'thisWeek' | 'nextWeek' | 'yesterday' | 'today' | 'tomorrow' | 'last7Days' | 'lastMonth'
+	| 'thisMonth' | 'nextMonth';
+
+declare interface Top10RuleType extends ConditionalFormattingBaseRule {
+    	type: 'top10';
+    	rank: number;
+    	percent: boolean;
+    	bottom: boolean;
+}
+
+declare enum ValueType {
+    	Null = 0,
+    	Merge = 1,
+    	Number = 2,
+    	String = 3,
+    	Date = 4,
+    	Hyperlink = 5,
+    	Formula = 6,
+    	SharedString = 7,
+    	RichText = 8,
+    	Boolean = 9,
+    	Error = 10
+}
+
+declare class Workbook {
+    category: string;
+    company: string;
+    	creator: string;
+    description: string;
+    keywords: string;
+    	lastModifiedBy: string;
+    	created: Date;
+    manager: string;
+    	modified: Date;
+    	lastPrinted: Date;
+    	properties: WorkbookProperties;
+    	subject: string;
+    title: string;
+
+    	/**
+     	 * Workbook calculation Properties
+     	 */
+    	calcProperties: CalculationProperties;
+
+    	/**
+     	 * xlsx file format operations
+     	 */
+    	readonly xlsx: Xlsx;
+
+    	/**
+     	 * csv file format operations
+     	 */
+    	readonly csv: Csv;
+
+    	readonly nextId: number;
+
+    	readonly definedNames: DefinedNames;
+
+    	model: WorkbookModel;
+
+    	/**
+     	 * The Workbook views controls how many separate windows Excel will open when viewing the workbook.
+     	 */
+    	views: WorkbookView[];
+
+    	/**
+     	 * return a clone of worksheets in order
+     	 */
+    	worksheets: Worksheet[];
+
+    	/**
+     	 * Add a new worksheet and return a reference to it
+     	 */
+    	addWorksheet(name?: string, options?: Partial<AddWorksheetOptions>): Worksheet;
+
+    	removeWorksheetEx(worksheet: Worksheet): void;
+    	removeWorksheet(indexOrName: number | string): void;
+
+    	/**
+     	 * fetch sheet by name or id
+     	 */
+    	getWorksheet(indexOrName?: number | string): Worksheet | undefined;
+
+    	/**
+     	 * Iterate over all sheets.
+     	 *
+     	 * Note: `workbook.worksheets.forEach` will still work but this is better.
+     	 */
+    	eachSheet(callback: (worksheet: Worksheet, id: number) => void): void;
+
+    	clearThemes(): void;
+
+    	/**
+     	 * Add Image to Workbook and return the id
+     	 */
+    	addImage(img: Image_2): number;
+
+    	getImage(id: number): Image_2;
+}
+
+declare interface WorkbookModel {
+    	creator: string;
+    	lastModifiedBy: string;
+    	lastPrinted: Date;
+    	created: Date;
+    	modified: Date;
+    	properties: WorkbookProperties;
+    	worksheets: Worksheet[];
+    	sheets: WorksheetModel[];
+    	definedNames: DefinedNamesModel;
+    	views: WorkbookView[];
+    	company: string;
+    	manager: string;
+    	title: string;
+    	subject: string;
+    	keywords: string;
+    	category: string;
+    	description: string;
+    	language: string;
+    	revision: Date;
+    	contentStatus: string;
+    	themes: string[];
+    	media: Media[];
+}
+
+declare interface WorkbookProperties {
+    	/**
+     	 * Set workbook dates to 1904 date system
+     	 */
+    	date1904: boolean;
+}
+
+declare interface WorkbookView {
+    	x: number;
+    	y: number;
+    	width: number;
+    	height: number;
+    	firstSheet: number;
+    	activeTab: number;
+    	visibility: string;
+}
+
+declare interface Worksheet {
+    	readonly id: number;
+    	name: string;
+    	readonly workbook: Workbook;
+    	readonly hasMerges: boolean;
+
+    	readonly dimensions: Range_2;
+    	/**
+     	 * Contains information related to how a worksheet is printed
+     	 */
+    	pageSetup: Partial<PageSetup>;
+
+    	/**
+     	 * Worksheet Header and Footer
+     	 */
+    	headerFooter: Partial<HeaderFooter>;
+
+    	/**
+     	 * Worksheet State
+     	 */
+    	state: WorksheetState;
+
+    	/**
+     	 * Worksheet Properties
+     	 */
+    	properties: WorksheetProperties;
+
+    	/**
+     	 * Open panes representing the sheet
+     	 */
+    	views: Array<Partial<WorksheetView>>;
+
+    	/**
+     	 * Apply an auto filter to your worksheet.
+     	 */
+    	autoFilter?: AutoFilter;
+
+    	destroy(): void;
+
+    	/**
+     	 * A count of the number of rows that have values. If a mid-document row is empty, it will not be included in the count.
+     	 */
+    	readonly actualRowCount: number;
+
+    	/**
+     	 * The total column size of the document. Equal to the maximum cell count from all of the rows
+     	 */
+    	readonly columnCount: number;
+
+    	/**
+     	 * Get the last column in a worksheet
+     	 */
+    	readonly lastColumn: Column | undefined;
+
+    	/**
+     	 * A count of the number of columns that have values.
+     	 */
+    	readonly actualColumnCount: number;
+
+    	getColumnKey(key: string): Column;
+
+    	setColumnKey(key: string, value: Column): void;
+
+    	deleteColumnKey(key: string): void;
+
+    	eachColumnKey(callback: (col: Column, index: number) => void): void;
+
+    	/**
+     	 * Access an individual columns by key, letter and 1-based column number
+     	 */
+    	getColumn(indexOrKey: number | string): Column;
+
+    	/**
+     	 * Cut one or more columns (columns to the right are shifted left)
+     	 * and optionally insert more
+     	 *
+     	 * If column properties have been definde, they will be cut or moved accordingly
+     	 *
+     	 * Known Issue: If a splice causes any merged cells to move, the results may be unpredictable
+     	 *
+     	 * Also: If the worksheet has more rows than values in the colulmn inserts,
+     	 * the rows will still be shifted as if the values existed
+     	 */
+    	spliceColumns(start: number, count: number, ...insert: any[][]): void;
+
+    	/**
+     	 * Add column headers and define column keys and widths.
+     	 *
+     	 * Note: these column structures are a workbook-building convenience only,
+     	 * apart from the column width, they will not be fully persisted.
+     	 */
+    	columns: Array<Partial<Column>>;
+
+    	/**
+     	 * The total row size of the document. Equal to the row number of the last row that has values.
+     	 */
+    	readonly rowCount: number;
+
+    	/**
+     	 * Get the last editable row in a worksheet (or undefined if there are none)
+     	 */
+    	readonly lastRow: Row | undefined;
+
+    	/**
+     	 * Tries to find and return row for row no, else undefined
+     	 * 
+     	 * @param row The 1-index row number
+     	 */
+    	findRow(row: number): Row | undefined;
+
+    	/**
+     	 * Tries to find and return rows for row no start and length, else undefined
+     	 * 
+     	 * @param start The 1-index starting row number
+     	 * @param length The length of the expected array
+     	 */
+    	findRows(start: number, length: number): Row[] | undefined;
+
+    	/**
+     	 * Cut one or more rows (rows below are shifted up)
+     	 * and optionally insert more
+     	 *
+     	 * Known Issue: If a splice causes any merged cells to move, the results may be unpredictable
+     	 */
+    	spliceRows(start: number, count: number, ...insert: any[][]): void;
+
+    	/**
+     	 * Add a couple of Rows by key-value, after the last current row, using the column keys,
+     	 * or add a row by contiguous Array (assign to columns A, B & C)
+     	 */
+    	addRow(data: any[] | any, style?: string): Row;
+
+    	/**
+     	 * Add multiple rows by providing an array of arrays or key-value pairs
+     	 */
+    	addRows(rows: any[], style?: string): Row[];
+
+    	/**
+     	 * Insert a Row by key-value, at the position (shifiting down all rows from position),
+     	 * using the column keys, or add a row by contiguous Array (assign to columns A, B & C)
+     	 */
+    	insertRow(pos: number, value: any[] | any, style?: string): Row;
+
+    	/**
+     	 * Insert multiple rows at position (shifiting down all rows from position)
+     	 * by providing an array of arrays or key-value pairs
+     	 */
+    	insertRows(pos: number, values: any[], style?: string): Row[];
+
+    	/**
+     	 * Duplicate rows and insert new rows
+     	 */
+    	duplicateRow(rowNum: number, count: number, insert: boolean): void;
+
+    	/**
+     	 * Get or create row by 1-based index
+     	 */
+    	getRow(index: number): Row;
+
+    	/**
+     	 * Get or create rows by 1-based index
+     	 */
+    	getRows(start: number, length: number): Row[] | undefined;
+
+    	/**
+     	 * Iterate over all rows that have values in a worksheet
+     	 */
+    	eachRow(callback: (row: Row, rowNumber: number) => void): void;
+
+    	/**
+     	 * Iterate over all rows (including empty rows) in a worksheet
+     	 */
+    	eachRow(opt: { includeEmpty: boolean }, callback: (row: Row, rowNumber: number) => void): void;
+
+    	/**
+     	 * return all rows as sparse array
+     	 */
+    	getSheetValues(): RowValues[];
+
+    	/**
+     	 * returns the cell at [r,c] or address given by r. If not found, return undefined
+     	 */
+    	findCell(r: number | string, c: number | string): Cell | undefined;
+
+    	/**
+     	 * Get or create cell
+     	 */
+    	getCell(r: number | string, c?: number | string): Cell;
+
+    	/**
+     	 * Merge cells, either:
+     	 *
+     	 * tlbr string, e.g. `'A4:B5'`
+     	 *
+     	 * tl string, br string, e.g. `'G10', 'H11'`
+     	 *
+     	 * t, l, b, r numbers, e.g. `10,11,12,13`
+     	 */
+    	mergeCells(): void;
+    	mergeCells(v: Range_2): void;
+    	mergeCells(v: string): void;
+    	mergeCells(v: Location_2): void;
+    	mergeCells(top: number, left: number, bottom: number, right: number, sheetName?: string): void;
+    	mergeCells(tl: string, br: string, sheetName?: string): void;
+    	mergeCells(v: [string, string]): void;
+    	mergeCells(v: [string, string, string]): void;
+    	mergeCells(v: [number, number, number, number]): void;
+    	mergeCells(v: [number, number, number, number, string]): void;
+    	mergeCellsWithoutStyle(): void;
+    	mergeCellsWithoutStyle(v: Range_2): void;
+    	mergeCellsWithoutStyle(v: string): void;
+    	mergeCellsWithoutStyle(v: Location_2): void;
+    	mergeCellsWithoutStyle(top: number, left: number, bottom: number, right: number, sheetName?: string): void;
+    	mergeCellsWithoutStyle(tl: string, br: string, sheetName?: string): void;
+    	mergeCellsWithoutStyle(v: [string, string]): void;
+    	mergeCellsWithoutStyle(v: [string, string, string]): void;
+    	mergeCellsWithoutStyle(v: [number, number, number, number]): void;
+    	mergeCellsWithoutStyle(v: [number, number, number, number, string]): void;
+
+    	/**
+     	 * unmerging the cells breaks the style links
+     	 */
+    	unMergeCells(): void;
+    	unMergeCells(v: Range_2): void;
+    	unMergeCells(v: string): void;
+    	unMergeCells(v: Location_2): void;
+    	unMergeCells(top: number, left: number, bottom: number, right: number, sheetName?: string): void;
+    	unMergeCells(tl: string, br: string, sheetName?: string): void;
+    	unMergeCells(v: [string, string]): void;
+    	unMergeCells(v: [string, string, string]): void;
+    	unMergeCells(v: [number, number, number, number]): void;
+    	unMergeCells(v: [number, number, number, number, string]): void;
+
+    	fillFormula(range: Range_2 | string | Location_2, formula: string, results?: ((r: number, c: number) => string | number) | number[] | number[][]): void;
+
+    	/**
+     	 * Using the image id from `Workbook.addImage`, set the background to the worksheet
+     	 */
+    	addBackgroundImage(imageId: number): void;
+
+    	getBackgroundImageId(): string;
+
+    	/**
+     	 * Using the image id from `Workbook.addImage`,
+     	 * embed an image within the worksheet to cover a range
+     	 */
+    	addImage(imageId: number, range: string | { editAs?: string; } & ImageRange & { hyperlinks?: ImageHyperlinkValue } | { editAs?: string; } & ImagePosition & { hyperlinks?: ImageHyperlinkValue }): void;
+
+    	getImages(): Array<{
+        		type: 'image',
+        		imageId: string;
+        		range: ImageRange;
+        	}>;
+
+    	commit(): void;
+
+    	model: WorksheetModel;
+
+    	/**
+     	 * Worksheet protection
+     	 */
+    	protect(password: string, options: Partial<WorksheetProtection>): Promise<void>;
+    	unprotect(): void;
+
+    	/**
+     	 * Add a new table and return a reference to it
+     	 */
+    	addTable(tableProperties: TableProperties): Table;
+    	/**
+     	 * fetch table by name or id
+     	 */
+    	getTable(name: string): Table;
+    	/**
+     	 * delete table by name or id
+     	 */
+    	removeTable(name: string): void;
+    	/**
+     	 *  fetch table
+     	 */
+    	getTables(): [Table, void][];
+    	/**
+     	 * add conditionalFormattingOptions
+     	 */
+    	addConditionalFormatting(cf: ConditionalFormattingOptions): void;
+
+    	/**
+     	 * delete conditionalFormattingOptions
+     	 */
+    	removeConditionalFormatting(filter: any): void;
+}
+
+declare interface WorksheetModel {
+    	id: number;
+    	name: string;
+    	// dataValidations: this.dataValidations.model,
+    	properties: WorksheetProperties;
+    	pageSetup: Partial<PageSetup>;
+    	headerFooter: Partial<HeaderFooter>;
+    	rowBreaks: RowBreak[];
+    	views: WorksheetView[];
+    	autoFilter: AutoFilter;
+    	media: Media[];
+    	merges: Range_2['range'][];
+}
+
+declare interface WorksheetProperties {
+    	/**
+     	 * Color of the tab
+     	 */
+    	tabColor: Partial<Color>;
+
+    	/**
+     	 * The worksheet column outline level (default: 0)
+     	 */
+    	outlineLevelCol: number;
+
+    	/**
+     	 * The worksheet row outline level (default: 0)
+     	 */
+    	outlineLevelRow: number;
+
+    	/**
+     	 * The outline properties which controls how it will summarize rows and columns
+     	 */
+    	outlineProperties: {
+        		summaryBelow: boolean,
+        		summaryRight: boolean,
+        	};
+    	/**
+     	 * Default row height (default: 15)
+     	 */
+    	defaultRowHeight: number;
+
+    	/**
+     	 * Default column width (optional)
+     	 */
+    	defaultColWidth?: number;
+
+    	/**
+     	 * default: 55
+     	 */
+    	dyDescent: number;
+    	showGridLines: boolean;
+}
+
+declare interface WorksheetProtection {
+    	objects: boolean;
+    	scenarios: boolean;
+    	selectLockedCells: boolean;
+    	selectUnlockedCells: boolean;
+    	formatCells: boolean;
+    	formatColumns: boolean;
+    	formatRows: boolean;
+    	insertColumns: boolean;
+    	insertRows: boolean;
+    	insertHyperlinks: boolean;
+    	deleteColumns: boolean;
+    	deleteRows: boolean;
+    	sort: boolean;
+    	autoFilter: boolean;
+    	pivotTables: boolean;
+    	spinCount: number;
+}
+
+declare type WorksheetState = 'visible' | 'hidden' | 'veryHidden';
+
+declare type WorksheetView =
+	& WorksheetViewCommon
+	& (WorksheetViewNormal | WorksheetViewFrozen | WorksheetViewSplit);
+
+declare interface WorksheetViewCommon {
+    	/**
+     	 * Sets the worksheet view's orientation to right-to-left, `false` by default
+     	 */
+    	rightToLeft: boolean;
+
+    	/**
+     	 * The currently selected cell
+     	 */
+    	activeCell: string;
+
+    	/**
+     	 * Shows or hides the ruler in Page Layout, `true` by default
+     	 */
+    	showRuler: boolean;
+
+    	/**
+     	 * Shows or hides the row and column headers (e.g. A1, B1 at the top and 1,2,3 on the left,
+     	 * `true` by default
+     	 */
+    	showRowColHeaders: boolean;
+
+    	/**
+     	 * Shows or hides the gridlines (shown for cells where borders have not been defined),
+     	 * `true` by default
+     	 */
+    	showGridLines: boolean;
+
+    	/**
+     	 * 	Percentage zoom to use for the view, `100` by default
+     	 */
+    	zoomScale: number;
+
+    	/**
+     	 * 	Normal zoom for the view, `100` by default
+     	 */
+    	zoomScaleNormal: number;
+}
+
+declare interface WorksheetViewFrozen {
+    	/**
+     	 * Where a number of rows and columns to the top and left are frozen in place.
+     	 * Only the bottom left section will scroll
+     	 */
+    	state: 'frozen';
+
+    	/**
+     	 * Presentation style
+     	 */
+    	style?: 'pageBreakPreview';
+
+    	/**
+     	 * How many columns to freeze. To freeze rows only, set this to 0 or undefined
+     	 */
+    	xSplit?: number;
+
+    	/**
+     	 * How many rows to freeze. To freeze columns only, set this to 0 or undefined
+     	 */
+    	ySplit?: number;
+
+    	/**
+     	 * Which cell will be top-left in the bottom-right pane. Note: cannot be a frozen cell.
+     	 * Defaults to first unfrozen cell
+     	 */
+    	topLeftCell?: string;
+}
+
+declare interface WorksheetViewNormal {
+    	/**
+     	 * Controls the view state
+     	 */
+    	state: 'normal';
+
+    	/**
+     	 * Presentation style
+     	 */
+    	style: 'pageBreakPreview' | 'pageLayout';
+}
+
+declare interface WorksheetViewSplit {
+    	/**
+     	 * Where the view is split into 4 sections, each semi-independently scrollable.
+     	 */
+    	state: 'split';
+
+    	/**
+     	 * Presentation style
+     	 */
+    	style?: 'pageBreakPreview' | 'pageLayout';
+
+    	/**
+     	 * How many points from the left to place the splitter.
+     	 * To split vertically, set this to 0 or undefined
+     	 */
+    	xSplit?: number;
+
+    	/**
+     	 * How many points from the top to place the splitter.
+     	 * To split horizontally, set this to 0 or undefined
+     	 */
+    	ySplit?: number;
+
+    	/**
+     	 * Which cell will be top-left in the bottom-right pane
+     	 */
+    	topLeftCell?: string;
+
+    	/**
+     	 * Which pane will be active
+     	 */
+    	activePane?: 'topLeft' | 'topRight' | 'bottomLeft' | 'bottomRight';
+}
+
+declare interface Xlsx {
+    	/**
+     	 * read from a file
+     	 */
+    	readFile(path: string, options?: Partial<XlsxReadOptions>): Promise<Workbook>;
+
+    	/**
+     	 * read from a stream
+     	 * @param stream
+     	 */
+    	read(stream: Stream, options?: Partial<XlsxReadOptions>): Promise<Workbook>;
+
+    	/**
+     	 * load from an array buffer
+     	 * @param buffer
+     	 */
+    	load(buffer: Buffer_2, options?: Partial<XlsxReadOptions>): Promise<Workbook>;
+
+    	/**
+     	 * write to a buffer
+     	 */
+    	writeBuffer(options?: Partial<XlsxWriteOptions>): Promise<Buffer_2>;
+
+    	/**
+     	 * write to a file
+     	 */
+    	writeFile(path: string, options?: Partial<XlsxWriteOptions>): Promise<void>;
+
+    	/**
+     	 * write to a stream
+     	 */
+    	write(stream: Stream, options?: Partial<XlsxWriteOptions>): Promise<void>;
+}
+
+declare interface XlsxReadOptions {
+    	/**
+     	 * The list of XML node names to ignore while parsing an XLSX file
+     	 */
+    	ignoreNodes: string[];
+}
+
+/**
+ * RenderPlan → xlsx 导出（B 端第二出口，对齐家族 @agile-team/mach-table-xlsx 路线）：
+ * - 网格组件 → 真表格：列宽（mm→Excel 宽度）、行高（mm→pt）、colSpan/rowSpan 合并、
+ *   加粗/对齐/底色/字号直译（resolveGridLayout 复用单真相源几何）
+ * - 文本组件 → 合并标题行（顺序流式输出，保字号/加粗/对齐；非像素级定位，
+ *   目标是"财务能直接用的对账表"而非复刻版面）
+ * - 未支持组件、富文本专有内容与单元格嵌套组件跳过并计入 warnings
+ */
+export declare interface XlsxRenderOptions {
+    /** 工作表命名（默认 "Sheet1" 起序） */
+    sheetName?: (pageIndex: number) => string;
+    /** 默认 text 保留显示文本；raw 使用列表自动保留的原始数值、布尔、文本与空值。 */
+    valueMode?: "text" | "raw";
+    /** 默认 auto 按计划识别 A3/A4/A5；自定义尺寸回退 A4 并返回告警。 */
+    paperSize?: "auto" | "a3" | "a4" | "a5";
+}
+
+export declare interface XlsxRenderResult {
+    workbook: ExcelJS.Workbook;
+    buffer: ExcelJS.Buffer;
+    warnings: string[];
+}
+
+declare interface XlsxWriteOptions extends stream.xlsx.WorkbookWriterOptions {
+    	/**
+     	 * The option passed to JsZip#generateAsync(options)
+     	 */
+    	zip: Partial<JSZipGeneratorOptions>;
+}
+
+export { }