@nice2dev/ui-tools 1.0.10

package/dist/spreadsheet.d.ts

@@ -0,0 +1,1043 @@
+/**
+ * @file spreadsheet.ts
+ * @module @nice2dev/ui-tools
+ * @description PRO-14.2 — Spreadsheet Editor
+ *
+ * Types for Excel-like spreadsheet editor: formula engine, cell formatting,
+ * conditional formatting, data validation, charts, pivot tables, collaboration.
+ */
+/** Cell address reference */
+export interface CellAddress {
+    row: number;
+    col: number;
+    sheet?: string;
+}
+/** Cell range */
+export interface CellRange {
+    start: CellAddress;
+    end: CellAddress;
+    sheet?: string;
+}
+/** Direction */
+export type Direction = 'up' | 'down' | 'left' | 'right';
+/** Horizontal alignment */
+export type HorizontalAlign = 'left' | 'center' | 'right' | 'fill' | 'justify' | 'distributed';
+/** Vertical alignment */
+export type VerticalAlign = 'top' | 'middle' | 'bottom' | 'justify' | 'distributed';
+/** Spreadsheet configuration */
+export interface SpreadsheetConfig {
+    /** Initial data */
+    data?: SpreadsheetData;
+    /** Number of rows */
+    rows?: number;
+    /** Number of columns */
+    cols?: number;
+    /** Row height */
+    defaultRowHeight?: number;
+    /** Column width */
+    defaultColWidth?: number;
+    /** Enable formulas */
+    formulas?: boolean;
+    /** Enable conditional formatting */
+    conditionalFormatting?: boolean;
+    /** Enable data validation */
+    dataValidation?: boolean;
+    /** Enable charts */
+    charts?: boolean;
+    /** Enable pivot tables */
+    pivotTables?: boolean;
+    /** Enable comments */
+    comments?: boolean;
+    /** Enable collaboration */
+    collaboration?: boolean;
+    /** Enable undo/redo */
+    undoRedo?: boolean;
+    /** Max undo steps */
+    maxUndoSteps?: number;
+    /** Read only */
+    readOnly?: boolean;
+    /** Show grid lines */
+    showGridLines?: boolean;
+    /** Show row headers */
+    showRowHeaders?: boolean;
+    /** Show column headers */
+    showColHeaders?: boolean;
+    /** Show formula bar */
+    showFormulaBar?: boolean;
+    /** Show sheet tabs */
+    showSheetTabs?: boolean;
+    /** Freeze panes */
+    freezePanes?: FreezePanes;
+    /** Theme */
+    theme?: SpreadsheetTheme;
+    /** Locale */
+    locale?: string;
+    /** Date format */
+    dateFormat?: string;
+    /** Number format */
+    numberFormat?: NumberFormatOptions;
+    /** Custom functions */
+    customFunctions?: CustomFunction[];
+    /** Toolbar configuration */
+    toolbar?: ToolbarConfig;
+}
+/** Freeze panes configuration */
+export interface FreezePanes {
+    rows?: number;
+    cols?: number;
+}
+/** Spreadsheet theme */
+export interface SpreadsheetTheme {
+    name?: string;
+    colors?: SpreadsheetColors;
+    font?: SpreadsheetFont;
+}
+/** Spreadsheet colors */
+export interface SpreadsheetColors {
+    background?: string;
+    gridLine?: string;
+    headerBackground?: string;
+    headerText?: string;
+    selection?: string;
+    selectionBackground?: string;
+    frozenLine?: string;
+}
+/** Spreadsheet font */
+export interface SpreadsheetFont {
+    family?: string;
+    size?: number;
+    color?: string;
+}
+/** Number format options */
+export interface NumberFormatOptions {
+    decimalSeparator?: string;
+    thousandsSeparator?: string;
+    currencySymbol?: string;
+    currencyPosition?: 'prefix' | 'suffix';
+}
+/** Custom function */
+export interface CustomFunction {
+    name: string;
+    description?: string;
+    params: FunctionParameter[];
+    returnType: CellValueType;
+    handler: (...args: CellValue[]) => CellValue;
+    category?: string;
+    volatile?: boolean;
+}
+/** Function parameter */
+export interface FunctionParameter {
+    name: string;
+    type: CellValueType | CellValueType[];
+    description?: string;
+    optional?: boolean;
+    repeating?: boolean;
+}
+/** Toolbar configuration */
+export interface ToolbarConfig {
+    visible?: boolean;
+    items?: ToolbarItem[];
+    customItems?: ToolbarCustomItem[];
+}
+/** Toolbar item */
+export type ToolbarItem = 'undo' | 'redo' | 'cut' | 'copy' | 'paste' | 'font' | 'fontSize' | 'bold' | 'italic' | 'underline' | 'strikethrough' | 'fill' | 'textColor' | 'borders' | 'merge' | 'align' | 'wrap' | 'format' | 'numberFormat' | 'conditional' | 'filter' | 'sort' | 'find' | 'chart' | 'comment' | 'separator';
+/** Custom toolbar item */
+export interface ToolbarCustomItem {
+    id: string;
+    label?: string;
+    icon?: string;
+    tooltip?: string;
+    handler: () => void;
+    disabled?: boolean;
+    position?: number;
+}
+/** Spreadsheet data */
+export interface SpreadsheetData {
+    sheets: Sheet[];
+    activeSheet?: string;
+    namedRanges?: NamedRange[];
+    styles?: CellStyle[];
+    metadata?: SpreadsheetMetadata;
+}
+/** Sheet */
+export interface Sheet {
+    id: string;
+    name: string;
+    cells: CellData[][];
+    rows?: RowInfo[];
+    cols?: ColInfo[];
+    mergedCells?: CellRange[];
+    conditionalFormats?: ConditionalFormat[];
+    dataValidations?: DataValidation[];
+    charts?: SpreadsheetChart[];
+    pivotTables?: PivotTable[];
+    comments?: CellComment[];
+    images?: SheetImage[];
+    protections?: SheetProtection;
+    hidden?: boolean;
+    tabColor?: string;
+    freezePanes?: FreezePanes;
+    zoom?: number;
+    showGridLines?: boolean;
+    printSettings?: PrintSettings;
+}
+/** Row info */
+export interface RowInfo {
+    index: number;
+    height?: number;
+    hidden?: boolean;
+    style?: Partial<CellStyle>;
+}
+/** Column info */
+export interface ColInfo {
+    index: number;
+    width?: number;
+    hidden?: boolean;
+    style?: Partial<CellStyle>;
+}
+/** Cell data */
+export interface CellData {
+    value?: CellValue;
+    formula?: string;
+    type?: CellValueType;
+    style?: CellStyle | number;
+    hyperlink?: Hyperlink;
+    comment?: string;
+    note?: CellNote;
+    validationId?: string;
+    readonly?: boolean;
+}
+/** Cell value */
+export type CellValue = string | number | boolean | Date | null | undefined | CellError;
+/** Cell value type */
+export type CellValueType = 'string' | 'number' | 'boolean' | 'date' | 'formula' | 'error' | 'empty';
+/** Cell error */
+export interface CellError {
+    type: ErrorType;
+    message?: string;
+}
+/** Error type */
+export type ErrorType = '#NULL!' | '#DIV/0!' | '#VALUE!' | '#REF!' | '#NAME?' | '#NUM!' | '#N/A' | '#GETTING_DATA' | '#SPILL!' | '#CALC!' | '#BLOCKED!' | '#FIELD!' | '#UNKNOWN!';
+/** Cell note */
+export interface CellNote {
+    text: string;
+    author?: string;
+    date?: Date;
+}
+/** Hyperlink */
+export interface Hyperlink {
+    type: 'url' | 'email' | 'cell' | 'sheet' | 'file';
+    target: string;
+    display?: string;
+    tooltip?: string;
+}
+/** Named range */
+export interface NamedRange {
+    name: string;
+    range: CellRange;
+    scope?: 'workbook' | string;
+    comment?: string;
+}
+/** Sheet image */
+export interface SheetImage {
+    id: string;
+    src: string;
+    position: ImagePosition;
+    size?: {
+        width: number;
+        height: number;
+    };
+    rotation?: number;
+    opacity?: number;
+    alt?: string;
+}
+/** Image position */
+export interface ImagePosition {
+    type: 'absolute' | 'cell';
+    x?: number;
+    y?: number;
+    cell?: CellAddress;
+    offsetX?: number;
+    offsetY?: number;
+}
+/** Sheet protection */
+export interface SheetProtection {
+    enabled: boolean;
+    password?: string;
+    allowSelectLockedCells?: boolean;
+    allowSelectUnlockedCells?: boolean;
+    allowFormatCells?: boolean;
+    allowFormatColumns?: boolean;
+    allowFormatRows?: boolean;
+    allowInsertColumns?: boolean;
+    allowInsertRows?: boolean;
+    allowInsertHyperlinks?: boolean;
+    allowDeleteColumns?: boolean;
+    allowDeleteRows?: boolean;
+    allowSort?: boolean;
+    allowAutoFilter?: boolean;
+    allowPivotTables?: boolean;
+    allowEditObjects?: boolean;
+    allowEditScenarios?: boolean;
+}
+/** Spreadsheet metadata */
+export interface SpreadsheetMetadata {
+    title?: string;
+    author?: string;
+    subject?: string;
+    keywords?: string[];
+    description?: string;
+    created?: Date;
+    modified?: Date;
+    lastAuthor?: string;
+    revision?: number;
+    application?: string;
+    customProperties?: Record<string, unknown>;
+}
+/** Cell style */
+export interface CellStyle {
+    fontFamily?: string;
+    fontSize?: number;
+    fontWeight?: 'normal' | 'bold';
+    fontStyle?: 'normal' | 'italic';
+    textDecoration?: TextDecoration;
+    color?: string;
+    horizontal?: HorizontalAlign;
+    vertical?: VerticalAlign;
+    wrapText?: boolean;
+    shrinkToFit?: boolean;
+    textRotation?: number;
+    indent?: number;
+    backgroundColor?: string;
+    pattern?: FillPattern;
+    patternColor?: string;
+    gradient?: CellGradient;
+    border?: CellBorder | BorderStyle;
+    borderTop?: BorderStyle;
+    borderRight?: BorderStyle;
+    borderBottom?: BorderStyle;
+    borderLeft?: BorderStyle;
+    borderDiagonalUp?: BorderStyle;
+    borderDiagonalDown?: BorderStyle;
+    numberFormat?: string;
+    locked?: boolean;
+    hidden?: boolean;
+}
+/** Text decoration */
+export interface TextDecoration {
+    underline?: 'none' | 'single' | 'double' | 'singleAccounting' | 'doubleAccounting';
+    strikethrough?: boolean;
+    superscript?: boolean;
+    subscript?: boolean;
+}
+/** Fill pattern */
+export type FillPattern = 'none' | 'solid' | 'darkGray' | 'mediumGray' | 'lightGray' | 'gray125' | 'gray0625' | 'darkHorizontal' | 'darkVertical' | 'darkDown' | 'darkUp' | 'darkGrid' | 'darkTrellis' | 'lightHorizontal' | 'lightVertical' | 'lightDown' | 'lightUp' | 'lightGrid' | 'lightTrellis';
+/** Cell gradient */
+export interface CellGradient {
+    type: 'linear' | 'path';
+    degree?: number;
+    stops: GradientStop[];
+    left?: number;
+    right?: number;
+    top?: number;
+    bottom?: number;
+}
+/** Gradient stop */
+export interface GradientStop {
+    position: number;
+    color: string;
+}
+/** Cell border */
+export interface CellBorder {
+    top?: BorderStyle;
+    right?: BorderStyle;
+    bottom?: BorderStyle;
+    left?: BorderStyle;
+}
+/** Border style */
+export interface BorderStyle {
+    style?: BorderLineStyle;
+    color?: string;
+}
+/** Border line style */
+export type BorderLineStyle = 'none' | 'thin' | 'medium' | 'thick' | 'dashed' | 'dotted' | 'double' | 'hair' | 'mediumDashed' | 'dashDot' | 'mediumDashDot' | 'dashDotDot' | 'mediumDashDotDot' | 'slantDashDot';
+/** Conditional format */
+export interface ConditionalFormat {
+    id: string;
+    range: CellRange;
+    rules: ConditionalRule[];
+    stopIfTrue?: boolean;
+    priority?: number;
+}
+/** Conditional rule */
+export interface ConditionalRule {
+    id: string;
+    type: ConditionalRuleType;
+    style: Partial<CellStyle>;
+    condition?: ConditionalCondition;
+    colorScale?: ColorScale;
+    dataBar?: DataBar;
+    iconSet?: IconSet;
+}
+/** Conditional rule type */
+export type ConditionalRuleType = 'cellIs' | 'expression' | 'colorScale' | 'dataBar' | 'iconSet' | 'top10' | 'aboveAverage' | 'uniqueValues' | 'duplicateValues' | 'containsText' | 'notContainsText' | 'beginsWith' | 'endsWith' | 'containsBlanks' | 'notContainsBlanks' | 'containsErrors' | 'notContainsErrors' | 'timePeriod' | 'dataBarGradient';
+/** Conditional condition */
+export interface ConditionalCondition {
+    operator?: ConditionalOperator;
+    values?: (string | number | boolean | null)[];
+    formula?: string;
+    text?: string;
+    timePeriod?: TimePeriod;
+    rank?: number;
+    percent?: boolean;
+    bottom?: boolean;
+}
+/** Conditional operator */
+export type ConditionalOperator = 'equal' | 'notEqual' | 'greaterThan' | 'greaterThanOrEqual' | 'lessThan' | 'lessThanOrEqual' | 'between' | 'notBetween';
+/** Time period */
+export type TimePeriod = 'today' | 'yesterday' | 'tomorrow' | 'last7Days' | 'thisWeek' | 'lastWeek' | 'nextWeek' | 'thisMonth' | 'lastMonth' | 'nextMonth' | 'thisYear' | 'lastYear' | 'nextYear';
+/** Color scale */
+export interface ColorScale {
+    type: '2-color' | '3-color';
+    min: ColorScaleValue;
+    mid?: ColorScaleValue;
+    max: ColorScaleValue;
+}
+/** Color scale value */
+export interface ColorScaleValue {
+    type: 'min' | 'max' | 'num' | 'percent' | 'formula' | 'percentile';
+    value?: number | string;
+    color: string;
+}
+/** Data bar */
+export interface DataBar {
+    minValue?: DataBarValue;
+    maxValue?: DataBarValue;
+    color?: string;
+    negativeColor?: string;
+    borderColor?: string;
+    negativeBorderColor?: string;
+    axisColor?: string;
+    showValue?: boolean;
+    gradient?: boolean;
+    direction?: 'ltr' | 'rtl' | 'context';
+    axisPosition?: 'automatic' | 'middle' | 'none';
+}
+/** Data bar value */
+export interface DataBarValue {
+    type: 'min' | 'max' | 'num' | 'percent' | 'formula' | 'percentile' | 'autoMin' | 'autoMax';
+    value?: number | string;
+}
+/** Icon set */
+export interface IconSet {
+    style: IconSetStyle;
+    reverse?: boolean;
+    showValue?: boolean;
+    icons?: IconSetIcon[];
+}
+/** Icon set style */
+export type IconSetStyle = '3Arrows' | '3ArrowsGray' | '3Flags' | '3TrafficLights1' | '3TrafficLights2' | '3Signs' | '3Symbols' | '3Symbols2' | '4Arrows' | '4ArrowsGray' | '4RedToBlack' | '4Rating' | '4TrafficLights' | '5Arrows' | '5ArrowsGray' | '5Rating' | '5Quarters' | '3Stars' | '3Triangles' | '5Boxes';
+/** Icon set icon */
+export interface IconSetIcon {
+    iconSet?: IconSetStyle;
+    iconId?: number;
+    type: 'percent' | 'num' | 'formula' | 'percentile';
+    value: number | string;
+    operator?: '>=' | '>';
+}
+/** Data validation */
+export interface DataValidation {
+    id: string;
+    range: CellRange;
+    type: DataValidationType;
+    criteria?: ValidationCriteria;
+    inputMessage?: ValidationMessage;
+    errorMessage?: ValidationErrorMessage;
+    allowBlank?: boolean;
+    showDropdown?: boolean;
+    inCellDropdown?: boolean;
+}
+/** Data validation type */
+export type DataValidationType = 'any' | 'whole' | 'decimal' | 'list' | 'date' | 'time' | 'textLength' | 'custom';
+/** Validation criteria */
+export interface ValidationCriteria {
+    operator?: ValidationOperator;
+    value1?: string | number | Date;
+    value2?: string | number | Date;
+    formula1?: string;
+    formula2?: string;
+    list?: string[];
+    listFormula?: string;
+}
+/** Validation operator */
+export type ValidationOperator = 'between' | 'notBetween' | 'equal' | 'notEqual' | 'greaterThan' | 'lessThan' | 'greaterThanOrEqual' | 'lessThanOrEqual';
+/** Validation message */
+export interface ValidationMessage {
+    show?: boolean;
+    title?: string;
+    message?: string;
+}
+/** Validation error message */
+export interface ValidationErrorMessage {
+    show?: boolean;
+    style?: 'stop' | 'warning' | 'information';
+    title?: string;
+    message?: string;
+}
+/** Formula engine configuration */
+export interface FormulaEngineConfig {
+    /** Array formula support */
+    arrayFormulas?: boolean;
+    /** Dynamic array support */
+    dynamicArrays?: boolean;
+    /** Lambda functions */
+    lambdaFunctions?: boolean;
+    /** Let function */
+    letFunction?: boolean;
+    /** Max iterations for circular refs */
+    maxIterations?: number;
+    /** Max change for iteration */
+    maxChange?: number;
+    /** Iteration enabled */
+    iterationEnabled?: boolean;
+    /** Precision as displayed */
+    precisionAsDisplayed?: boolean;
+    /** Date 1900/1904 system */
+    date1904?: boolean;
+    /** Custom functions */
+    customFunctions?: CustomFunction[];
+}
+/** Formula evaluation result */
+export interface FormulaResult {
+    value: CellValue | CellValue[][];
+    type: CellValueType;
+    error?: CellError;
+    dependencies: CellAddress[];
+    isArray?: boolean;
+    spillRange?: CellRange;
+}
+/** Formula parse result */
+export interface FormulaParseResult {
+    valid: boolean;
+    tokens: FormulaToken[];
+    ast?: FormulaAST;
+    errors?: FormulaError[];
+    references: CellAddress[];
+    functions: string[];
+}
+/** Formula token */
+export interface FormulaToken {
+    type: TokenType;
+    value: string;
+    start: number;
+    end: number;
+}
+/** Token type */
+export type TokenType = 'operator' | 'operand' | 'function' | 'subexpression' | 'argument' | 'operand-range' | 'operand-number' | 'operand-text' | 'operand-logical' | 'operand-error' | 'operand-array' | 'whitespace' | 'unknown';
+/** Formula AST */
+export interface FormulaAST {
+    type: 'expression' | 'function' | 'reference' | 'literal' | 'operator' | 'array';
+    value?: unknown;
+    name?: string;
+    operator?: string;
+    arguments?: FormulaAST[];
+    left?: FormulaAST;
+    right?: FormulaAST;
+    reference?: CellAddress | CellRange;
+}
+/** Formula error */
+export interface FormulaError {
+    message: string;
+    position: number;
+    length: number;
+    code: string;
+}
+/** Spreadsheet chart */
+export interface SpreadsheetChart {
+    id: string;
+    type: ChartType;
+    title?: ChartTitle;
+    legend?: ChartLegend;
+    dataSource: ChartDataSource;
+    position: ChartPosition;
+    size: {
+        width: number;
+        height: number;
+    };
+    axes?: ChartAxes;
+    series?: ChartSeries[];
+    plotArea?: PlotArea;
+    colors?: string[];
+    animation?: boolean;
+    style?: ChartStyle;
+}
+/** Chart type */
+export type ChartType = 'column' | 'bar' | 'line' | 'area' | 'pie' | 'doughnut' | 'scatter' | 'bubble' | 'radar' | 'stock' | 'surface' | 'combo' | 'waterfall' | 'funnel' | 'treemap' | 'sunburst' | 'histogram' | 'boxWhisker' | 'pareto';
+/** Chart title */
+export interface ChartTitle {
+    text?: string;
+    visible?: boolean;
+    position?: 'top' | 'bottom' | 'left' | 'right' | 'overlay';
+    font?: ChartFont;
+}
+/** Chart legend */
+export interface ChartLegend {
+    visible?: boolean;
+    position?: 'top' | 'bottom' | 'left' | 'right' | 'topRight';
+    font?: ChartFont;
+}
+/** Chart font */
+export interface ChartFont {
+    family?: string;
+    size?: number;
+    weight?: 'normal' | 'bold';
+    style?: 'normal' | 'italic';
+    color?: string;
+}
+/** Chart data source */
+export interface ChartDataSource {
+    range?: CellRange;
+    categories?: CellRange | string[];
+    values?: ChartValueSource[];
+    seriesInRows?: boolean;
+}
+/** Chart value source */
+export interface ChartValueSource {
+    name?: string | CellAddress;
+    values: CellRange;
+    categories?: CellRange;
+}
+/** Chart position */
+export interface ChartPosition {
+    type: 'absolute' | 'cell';
+    x?: number;
+    y?: number;
+    cell?: CellAddress;
+    offsetX?: number;
+    offsetY?: number;
+}
+/** Chart axes */
+export interface ChartAxes {
+    category?: ChartAxis;
+    value?: ChartAxis;
+    secondaryCategory?: ChartAxis;
+    secondaryValue?: ChartAxis;
+}
+/** Chart axis */
+export interface ChartAxis {
+    visible?: boolean;
+    title?: ChartTitle;
+    min?: number;
+    max?: number;
+    majorUnit?: number;
+    minorUnit?: number;
+    logarithmic?: boolean;
+    reversed?: boolean;
+    crossAt?: number | 'min' | 'max' | 'auto';
+    majorGridlines?: GridlineStyle;
+    minorGridlines?: GridlineStyle;
+    tickMarks?: 'none' | 'inside' | 'outside' | 'cross';
+    labelPosition?: 'nextTo' | 'low' | 'high' | 'none';
+    labelRotation?: number;
+    numberFormat?: string;
+    font?: ChartFont;
+}
+/** Gridline style */
+export interface GridlineStyle {
+    visible?: boolean;
+    color?: string;
+    width?: number;
+    dash?: string;
+}
+/** Chart series */
+export interface ChartSeries {
+    name?: string;
+    type?: ChartType;
+    values: CellRange | number[];
+    categories?: CellRange | string[];
+    color?: string;
+    marker?: MarkerStyle;
+    dataLabels?: DataLabels;
+    trendline?: Trendline;
+    errorBars?: ErrorBars;
+    secondaryAxis?: boolean;
+}
+/** Marker style */
+export interface MarkerStyle {
+    type?: 'none' | 'automatic' | 'circle' | 'dash' | 'diamond' | 'dot' | 'plus' | 'square' | 'star' | 'triangle' | 'x';
+    size?: number;
+    fill?: string;
+    border?: {
+        color?: string;
+        width?: number;
+    };
+}
+/** Data labels */
+export interface DataLabels {
+    visible?: boolean;
+    position?: 'center' | 'insideEnd' | 'insideBase' | 'outsideEnd' | 'bestFit';
+    showValue?: boolean;
+    showCategory?: boolean;
+    showSeriesName?: boolean;
+    showPercent?: boolean;
+    showLeaderLines?: boolean;
+    separator?: string;
+    numberFormat?: string;
+    font?: ChartFont;
+}
+/** Trendline */
+export interface Trendline {
+    type: 'linear' | 'exponential' | 'logarithmic' | 'polynomial' | 'power' | 'movingAverage';
+    order?: number;
+    period?: number;
+    forward?: number;
+    backward?: number;
+    intercept?: number;
+    displayEquation?: boolean;
+    displayRSquared?: boolean;
+    color?: string;
+    width?: number;
+    dash?: string;
+}
+/** Error bars */
+export interface ErrorBars {
+    type: 'both' | 'plus' | 'minus';
+    valueType: 'fixedValue' | 'percentage' | 'standardDeviation' | 'standardError' | 'custom';
+    value?: number;
+    plusRange?: CellRange;
+    minusRange?: CellRange;
+    color?: string;
+    width?: number;
+}
+/** Plot area */
+export interface PlotArea {
+    fill?: string;
+    border?: {
+        color?: string;
+        width?: number;
+    };
+}
+/** Chart style */
+export interface ChartStyle {
+    preset?: number;
+    fill?: string;
+    border?: {
+        color?: string;
+        width?: number;
+        radius?: number;
+    };
+    shadow?: boolean;
+}
+/** Pivot table */
+export interface PivotTable {
+    id: string;
+    name: string;
+    sourceRange: CellRange;
+    targetCell: CellAddress;
+    rows: PivotField[];
+    columns: PivotField[];
+    values: PivotValue[];
+    filters: PivotFilter[];
+    config?: PivotTableConfig;
+}
+/** Pivot field */
+export interface PivotField {
+    sourceField: string | number;
+    name?: string;
+    sortOrder?: 'ascending' | 'descending' | 'manual';
+    showBlank?: boolean;
+    subtotals?: PivotSubtotal[];
+    items?: PivotItem[];
+    grouping?: PivotGrouping;
+}
+/** Pivot item */
+export interface PivotItem {
+    value: CellValue;
+    visible?: boolean;
+    position?: number;
+}
+/** Pivot subtotal */
+export type PivotSubtotal = 'sum' | 'count' | 'average' | 'max' | 'min' | 'product' | 'countNums' | 'stdDev' | 'stdDevP' | 'var' | 'varP';
+/** Pivot grouping */
+export interface PivotGrouping {
+    type: 'numeric' | 'date';
+    start?: number | Date;
+    end?: number | Date;
+    interval?: number;
+    dateUnits?: ('seconds' | 'minutes' | 'hours' | 'days' | 'months' | 'quarters' | 'years')[];
+}
+/** Pivot value */
+export interface PivotValue {
+    sourceField: string | number;
+    name?: string;
+    summarizeBy: PivotSubtotal;
+    showDataAs?: PivotShowDataAs;
+    baseField?: string | number;
+    baseItem?: CellValue | 'previous' | 'next';
+    numberFormat?: string;
+}
+/** Show data as */
+export type PivotShowDataAs = 'normal' | 'percentOfGrandTotal' | 'percentOfColumnTotal' | 'percentOfRowTotal' | 'percentOfParentColumnTotal' | 'percentOfParentRowTotal' | 'percentOfParentTotal' | 'difference' | 'percentDifference' | 'runningTotal' | 'percentRunningTotal' | 'rankAscending' | 'rankDescending' | 'index';
+/** Pivot filter */
+export interface PivotFilter {
+    sourceField: string | number;
+    type: PivotFilterType;
+    value1?: CellValue;
+    value2?: CellValue;
+    items?: CellValue[];
+}
+/** Pivot filter type */
+export type PivotFilterType = 'valueFilter' | 'labelFilter' | 'dateFilter' | 'top10' | 'captionEquals' | 'captionNotEquals' | 'captionBeginsWith' | 'captionNotBeginsWith' | 'captionEndsWith' | 'captionNotEndsWith' | 'captionContains' | 'captionNotContains' | 'captionGreaterThan' | 'captionGreaterThanOrEqual' | 'captionLessThan' | 'captionLessThanOrEqual' | 'captionBetween' | 'captionNotBetween';
+/** Pivot table config */
+export interface PivotTableConfig {
+    rowGrandTotals?: boolean;
+    columnGrandTotals?: boolean;
+    showRowHeaders?: boolean;
+    showColumnHeaders?: boolean;
+    compactForm?: boolean;
+    outlineForm?: boolean;
+    tabularForm?: boolean;
+    repeatItemLabels?: boolean;
+    insertBlankRows?: boolean;
+    showValuesAs?: boolean;
+    preserveFormatting?: boolean;
+    autoFormat?: boolean;
+    style?: PivotTableStyle;
+}
+/** Pivot table style */
+export interface PivotTableStyle {
+    name?: string;
+    showRowStripes?: boolean;
+    showColumnStripes?: boolean;
+    showRowHeaders?: boolean;
+    showColumnHeaders?: boolean;
+}
+/** Cell comment */
+export interface CellComment {
+    id: string;
+    cell: CellAddress;
+    text: string;
+    author?: string;
+    date?: Date;
+    replies?: CommentReply[];
+    resolved?: boolean;
+    visible?: boolean;
+    position?: {
+        x: number;
+        y: number;
+    };
+    size?: {
+        width: number;
+        height: number;
+    };
+}
+/** Comment reply */
+export interface CommentReply {
+    id: string;
+    text: string;
+    author?: string;
+    date?: Date;
+}
+/** Import options */
+export interface SpreadsheetImportOptions {
+    format: ImportFormat;
+    delimiter?: string;
+    encoding?: string;
+    hasHeader?: boolean;
+    dateFormat?: string;
+    numberFormat?: NumberFormatOptions;
+    sheet?: string;
+    range?: CellRange;
+}
+/** Import format */
+export type ImportFormat = 'xlsx' | 'xls' | 'csv' | 'tsv' | 'json' | 'xml' | 'ods' | 'html';
+/** Export options */
+export interface SpreadsheetExportOptions {
+    format: ExportFormat;
+    sheets?: string[];
+    range?: CellRange;
+    includeStyles?: boolean;
+    includeFormulas?: boolean;
+    includeComments?: boolean;
+    includeCharts?: boolean;
+    includePivotTables?: boolean;
+    csv?: CSVExportOptions;
+    pdf?: PDFExportOptions;
+}
+/** Export format */
+export type ExportFormat = 'xlsx' | 'xls' | 'csv' | 'tsv' | 'json' | 'xml' | 'ods' | 'pdf' | 'html';
+/** CSV export options */
+export interface CSVExportOptions {
+    delimiter?: string;
+    encoding?: string;
+    lineEnding?: 'crlf' | 'lf' | 'cr';
+    includeHeader?: boolean;
+    quoteStrings?: boolean;
+}
+/** PDF export options */
+export interface PDFExportOptions {
+    pageSize?: 'A4' | 'A3' | 'Letter' | 'Legal' | 'custom';
+    orientation?: 'portrait' | 'landscape';
+    fitToPage?: boolean;
+    margins?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+    };
+    gridLines?: boolean;
+    rowColHeaders?: boolean;
+}
+/** Print settings */
+export interface PrintSettings {
+    pageSize?: string;
+    orientation?: 'portrait' | 'landscape';
+    scale?: number;
+    fitToWidth?: number;
+    fitToHeight?: number;
+    margins?: {
+        top: number;
+        right: number;
+        bottom: number;
+        left: number;
+        header: number;
+        footer: number;
+    };
+    printArea?: CellRange;
+    printTitles?: {
+        rows?: CellRange;
+        cols?: CellRange;
+    };
+    gridLines?: boolean;
+    rowColHeaders?: boolean;
+    blackAndWhite?: boolean;
+    draft?: boolean;
+    cellComments?: 'none' | 'atEnd' | 'asDisplayed';
+    cellErrors?: 'displayed' | 'blank' | 'dash' | 'notAvailable';
+    pageOrder?: 'downThenOver' | 'overThenDown';
+    firstPageNumber?: number | 'auto';
+    header?: HeaderFooter;
+    footer?: HeaderFooter;
+}
+/** Header/Footer */
+export interface HeaderFooter {
+    left?: string;
+    center?: string;
+    right?: string;
+    different?: boolean;
+    firstPage?: {
+        left?: string;
+        center?: string;
+        right?: string;
+    };
+    evenPage?: {
+        left?: string;
+        center?: string;
+        right?: string;
+    };
+    scaleWithDoc?: boolean;
+    alignWithMargins?: boolean;
+}
+/** Collaboration session */
+export interface CollaborationSession {
+    id: string;
+    documentId: string;
+    users: CollaborationUser[];
+    cursors: UserCursor[];
+    selections: UserSelection[];
+    changes: CollaborationChange[];
+    version: number;
+}
+/** Collaboration user */
+export interface CollaborationUser {
+    id: string;
+    name: string;
+    color: string;
+    avatar?: string;
+    online: boolean;
+    lastActivity?: Date;
+}
+/** User cursor */
+export interface UserCursor {
+    userId: string;
+    cell: CellAddress;
+    timestamp: Date;
+}
+/** User selection */
+export interface UserSelection {
+    userId: string;
+    range: CellRange;
+    timestamp: Date;
+}
+/** Collaboration change */
+export interface CollaborationChange {
+    id: string;
+    userId: string;
+    type: ChangeType;
+    timestamp: Date;
+    data: unknown;
+    reverted?: boolean;
+}
+/** Change type */
+export type ChangeType = 'cell-edit' | 'cell-format' | 'row-insert' | 'row-delete' | 'col-insert' | 'col-delete' | 'row-resize' | 'col-resize' | 'merge' | 'unmerge' | 'sheet-add' | 'sheet-delete' | 'sheet-rename' | 'comment-add' | 'comment-edit' | 'comment-delete';
+/** History entry */
+export interface HistoryEntry {
+    id: string;
+    timestamp: Date;
+    user?: string;
+    operation: HistoryOperation;
+    description?: string;
+    undo: () => void;
+    redo: () => void;
+}
+/** History operation */
+export interface HistoryOperation {
+    type: ChangeType;
+    before: unknown;
+    after: unknown;
+    range?: CellRange;
+}
+/** History state */
+export interface HistoryState {
+    entries: HistoryEntry[];
+    currentIndex: number;
+    canUndo: boolean;
+    canRedo: boolean;
+}
+/** Macro definition */
+export interface SpreadsheetMacro {
+    id: string;
+    name: string;
+    description?: string;
+    shortcut?: string;
+    code: string;
+    type: 'javascript' | 'vba';
+    enabled?: boolean;
+    runOnOpen?: boolean;
+}
+/** Macro execution context */
+export interface MacroContext {
+    activeSheet: Sheet;
+    activeCell: CellAddress;
+    selection: CellRange;
+    workbook: SpreadsheetData;
+    api: MacroAPI;
+}
+/** Macro API */
+export interface MacroAPI {
+    getValue(cell: CellAddress): CellValue;
+    setValue(cell: CellAddress, value: CellValue): void;
+    getRange(range: CellRange): CellValue[][];
+    setRange(range: CellRange, values: CellValue[][]): void;
+    getFormula(cell: CellAddress): string | undefined;
+    setFormula(cell: CellAddress, formula: string): void;
+    getStyle(cell: CellAddress): CellStyle;
+    setStyle(range: CellRange, style: Partial<CellStyle>): void;
+    insertRow(index: number, count?: number): void;
+    deleteRow(index: number, count?: number): void;
+    insertColumn(index: number, count?: number): void;
+    deleteColumn(index: number, count?: number): void;
+    msgBox(message: string, title?: string): void;
+    inputBox(prompt: string, title?: string, defaultValue?: string): string | null;
+}
+//# sourceMappingURL=spreadsheet.d.ts.map