@a3s-lab/office 0.1.0

package/dist/internal/features/work/work-spreadsheet-chart-types.d.ts

@@ -0,0 +1,147 @@
+import type { Image } from '@fortune-sheet/core';
+import type { WorkSpreadsheetChartLayout } from './work-spreadsheet-chart-layout';
+export interface WorkSpreadsheetImage extends Image {
+    name?: string;
+    altText?: string;
+    contentType?: string;
+}
+export type WorkSpreadsheetChartType = 'bar' | 'column' | 'line' | 'pie' | 'doughnut' | 'area' | 'radar' | 'scatter' | 'bubble' | 'combination';
+export type WorkSpreadsheetRadarStyle = 'standard' | 'marker' | 'filled';
+export type WorkSpreadsheetScatterStyle = 'marker' | 'line' | 'lineMarker' | 'smooth' | 'smoothMarker';
+export type WorkSpreadsheetBubbleSizeRepresents = 'area' | 'width';
+export type WorkSpreadsheetCombinationSeriesType = 'column' | 'line' | 'area';
+export type WorkSpreadsheetChartAxisGroup = 'primary' | 'secondary';
+export type WorkSpreadsheetChartAxisPosition = 'bottom' | 'left' | 'top' | 'right';
+export type WorkSpreadsheetChartLineDash = 'solid' | 'dash' | 'dot' | 'dashDot';
+export type WorkSpreadsheetChartMarkerSymbol = 'none' | 'circle' | 'square' | 'diamond' | 'triangle' | 'plus' | 'x' | 'star';
+export interface WorkSpreadsheetChartMarkerStyle {
+    symbol?: WorkSpreadsheetChartMarkerSymbol;
+    size?: number;
+    fillColor?: string;
+    lineColor?: string;
+}
+export interface WorkSpreadsheetChartSeriesStyle {
+    fillColor?: string;
+    fillTransparency?: number;
+    lineColor?: string;
+    lineWidth?: number;
+    lineDash?: WorkSpreadsheetChartLineDash;
+    marker?: WorkSpreadsheetChartMarkerStyle;
+}
+export interface WorkSpreadsheetChartAxis {
+    title?: string;
+    titleReference?: string;
+    reverseOrder?: boolean;
+    labelPosition?: 'nextTo' | 'high' | 'low' | 'none';
+    majorTickMark?: 'none' | 'inside' | 'outside' | 'cross';
+    labelInterval?: number;
+    minimum?: number;
+    maximum?: number;
+    majorUnit?: number;
+    showMajorGridlines?: boolean;
+    numberFormat?: string;
+    numberFormatSourceLinked?: boolean;
+}
+export interface WorkSpreadsheetChartAxes {
+    bottom?: WorkSpreadsheetChartAxis;
+    left?: WorkSpreadsheetChartAxis;
+    top?: WorkSpreadsheetChartAxis;
+    right?: WorkSpreadsheetChartAxis;
+}
+export type WorkSpreadsheetDataLabelPosition = 'bestFit' | 'center' | 'insideBase' | 'insideEnd' | 'outsideEnd' | 'left' | 'right' | 'above' | 'below';
+export interface WorkSpreadsheetDataLabels {
+    showValue?: boolean;
+    showCategoryName?: boolean;
+    showSeriesName?: boolean;
+    showPercentage?: boolean;
+    showBubbleSize?: boolean;
+    separator?: string;
+    position?: WorkSpreadsheetDataLabelPosition;
+}
+export type WorkSpreadsheetErrorBarDirection = 'x' | 'y';
+export type WorkSpreadsheetErrorBarType = 'both' | 'plus' | 'minus';
+export type WorkSpreadsheetErrorBarValueType = 'fixedValue' | 'percentage' | 'standardDeviation' | 'standardError' | 'custom';
+export interface WorkSpreadsheetErrorBars {
+    direction: WorkSpreadsheetErrorBarDirection;
+    barType: WorkSpreadsheetErrorBarType;
+    valueType: WorkSpreadsheetErrorBarValueType;
+    value?: number;
+    showEndCaps?: boolean;
+    plusValues?: number[];
+    plusReference?: string;
+    minusValues?: number[];
+    minusReference?: string;
+}
+export type WorkSpreadsheetTrendlineType = 'linear' | 'exponential' | 'logarithmic' | 'polynomial' | 'power' | 'movingAverage';
+export interface WorkSpreadsheetTrendline {
+    type: WorkSpreadsheetTrendlineType;
+    name?: string;
+    order?: number;
+    period?: number;
+    forward?: number;
+    backward?: number;
+    intercept?: number;
+    displayEquation?: boolean;
+    displayRSquared?: boolean;
+}
+export declare function normalizeWorkSpreadsheetDoughnutHoleSize(value: unknown): number;
+export declare function normalizeWorkSpreadsheetRadarStyle(value: unknown): WorkSpreadsheetRadarStyle;
+export declare function normalizeWorkSpreadsheetScatterStyle(value: unknown): WorkSpreadsheetScatterStyle;
+export declare function normalizeWorkSpreadsheetBubbleScale(value: unknown): number;
+export declare function normalizeWorkSpreadsheetBubbleSizeRepresents(value: unknown): WorkSpreadsheetBubbleSizeRepresents;
+export declare function workSpreadsheetChartUsesNumericXAxis(type: WorkSpreadsheetChartType): boolean;
+export declare function workSpreadsheetChartSupportsAxes(type: WorkSpreadsheetChartType): boolean;
+export declare function normalizeWorkSpreadsheetCombinationSeriesType(value: unknown): WorkSpreadsheetCombinationSeriesType;
+export declare function normalizeWorkSpreadsheetChartAxisGroup(value: unknown): WorkSpreadsheetChartAxisGroup;
+export declare function workSpreadsheetCombinationSeriesTypeLabel(type: WorkSpreadsheetCombinationSeriesType): string;
+export declare function workSpreadsheetChartSupportsTrendlines(type: WorkSpreadsheetChartType): boolean;
+export declare function workSpreadsheetChartSupportsErrorBars(type: WorkSpreadsheetChartType): boolean;
+export declare function normalizeWorkSpreadsheetErrorBars(source: WorkSpreadsheetErrorBars, chartType: WorkSpreadsheetChartType): WorkSpreadsheetErrorBars;
+export declare function workSpreadsheetErrorBarValueTypeLabel(type: WorkSpreadsheetErrorBarValueType): string;
+export declare function workSpreadsheetErrorBarTypeLabel(type: WorkSpreadsheetErrorBarType): string;
+export declare function normalizeWorkSpreadsheetDataLabelPosition(value: unknown): WorkSpreadsheetDataLabelPosition;
+export declare function normalizeWorkSpreadsheetDataLabels(source: WorkSpreadsheetDataLabels, chartType: WorkSpreadsheetChartType): WorkSpreadsheetDataLabels;
+export declare function workSpreadsheetDataLabelPositionLabel(position: WorkSpreadsheetDataLabelPosition): string;
+export declare function normalizeWorkSpreadsheetTrendlineType(value: unknown): WorkSpreadsheetTrendlineType;
+export declare function normalizeWorkSpreadsheetTrendline(trendline: WorkSpreadsheetTrendline): WorkSpreadsheetTrendline;
+export declare function workSpreadsheetTrendlineTypeLabel(type: WorkSpreadsheetTrendlineType): string;
+export declare function workSpreadsheetChartTypeLabel(type: WorkSpreadsheetChartType): string;
+export interface WorkSpreadsheetChartSeries {
+    name: string;
+    values: number[];
+    nameReference?: string;
+    valuesReference?: string;
+    xValues?: number[];
+    xValuesReference?: string;
+    bubbleSizes?: number[];
+    bubbleSizesReference?: string;
+    chartType?: WorkSpreadsheetCombinationSeriesType;
+    axisGroup?: WorkSpreadsheetChartAxisGroup;
+    dataLabels?: WorkSpreadsheetDataLabels;
+    errorBars?: WorkSpreadsheetErrorBars[];
+    trendlines?: WorkSpreadsheetTrendline[];
+    style?: WorkSpreadsheetChartSeriesStyle;
+}
+export interface WorkSpreadsheetChart extends WorkSpreadsheetChartLayout {
+    id: string;
+    name: string;
+    altText?: string;
+    type: WorkSpreadsheetChartType;
+    title?: string;
+    titleReference?: string;
+    axes?: WorkSpreadsheetChartAxes;
+    categories: string[];
+    categoryReference?: string;
+    series: WorkSpreadsheetChartSeries[];
+    showLegend: boolean;
+    doughnutHoleSize?: number;
+    radarStyle?: WorkSpreadsheetRadarStyle;
+    scatterStyle?: WorkSpreadsheetScatterStyle;
+    bubbleScale?: number;
+    showNegativeBubbles?: boolean;
+    bubbleSizeRepresents?: WorkSpreadsheetBubbleSizeRepresents;
+    left: number;
+    top: number;
+    width: number;
+    height: number;
+}

package/dist/internal/features/work/work-spreadsheet-chart-validation.d.ts

@@ -0,0 +1,2 @@
+import type { WorkSpreadsheetChartSeries } from './work-types';
+export declare function validateSpreadsheetChartSeriesTrendlines(series: WorkSpreadsheetChartSeries, seriesIndex: number): string | null;

package/dist/internal/features/work/work-spreadsheet-charts.d.ts

@@ -0,0 +1,17 @@
+import type { Selection } from '@fortune-sheet/core';
+import type { WorkSpreadsheetChart, WorkSpreadsheetContent, WorkSpreadsheetSheet } from './work-types';
+export interface SpreadsheetCellRangeReference {
+    sheet: WorkSpreadsheetSheet;
+    startRow: number;
+    endRow: number;
+    startColumn: number;
+    endColumn: number;
+}
+export declare function spreadsheetChartCount(content: WorkSpreadsheetContent): number;
+export declare function spreadsheetSheetsWithChartPreviews(content: WorkSpreadsheetContent): WorkSpreadsheetSheet[];
+export declare function reconcileSpreadsheetChartPreviews(content: WorkSpreadsheetContent, changedSheets: WorkSpreadsheetSheet[]): WorkSpreadsheetContent;
+export declare function resolveSpreadsheetChart(content: WorkSpreadsheetContent, ownerSheet: WorkSpreadsheetSheet, chart: WorkSpreadsheetChart): WorkSpreadsheetChart;
+export declare function createSpreadsheetChartFromSelection(content: WorkSpreadsheetContent, sheetId: string, selection: Selection | undefined): WorkSpreadsheetChart | null;
+export declare function parseSpreadsheetChartReference(content: WorkSpreadsheetContent, ownerSheet: WorkSpreadsheetSheet, reference: string): SpreadsheetCellRangeReference | null;
+export declare function spreadsheetReferenceValues(content: WorkSpreadsheetContent, ownerSheet: WorkSpreadsheetSheet, reference: string): unknown[] | undefined;
+export declare function quoteSpreadsheetSheetName(name: string): string;

package/dist/internal/features/work/work-spreadsheet-combination-chart-svg.d.ts

@@ -0,0 +1,9 @@
+import { type WorkSpreadsheetChart } from './work-types';
+interface CombinationPlot {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function spreadsheetCombinationChartSvg(chart: WorkSpreadsheetChart, plot: CombinationPlot): string;
+export {};

package/dist/internal/features/work/work-spreadsheet-comments.d.ts

@@ -0,0 +1,7 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { Comments } from 'xlsx';
+export interface WorkSpreadsheetCellComment extends NonNullable<Cell['ps']> {
+    author?: string;
+}
+export declare function importXlsxCellComment(source: Comments | undefined): WorkSpreadsheetCellComment | undefined;
+export declare function exportXlsxCellComment(source: WorkSpreadsheetCellComment | undefined): Comments | undefined;

package/dist/internal/features/work/work-spreadsheet-conditional-canvas.d.ts

@@ -0,0 +1,5 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { SpreadsheetConditionalDataBar } from './work-spreadsheet-conditional-data-bar';
+import type { SpreadsheetConditionalIconBounds } from './work-spreadsheet-conditional-icons';
+export declare function drawSpreadsheetConditionalDataBar(context: CanvasRenderingContext2D, bounds: SpreadsheetConditionalIconBounds, dataBar: SpreadsheetConditionalDataBar, cell: Cell | null, background: string, textColor?: string): void;
+export declare function drawSpreadsheetCommentMarker(context: CanvasRenderingContext2D, bounds: SpreadsheetConditionalIconBounds): void;

package/dist/internal/features/work/work-spreadsheet-conditional-colors.d.ts

@@ -0,0 +1,9 @@
+export interface SpreadsheetConditionalRgbColor {
+    red: number;
+    green: number;
+    blue: number;
+}
+export declare function parseSpreadsheetConditionalColor(value: string): SpreadsheetConditionalRgbColor | null;
+export declare function interpolateSpreadsheetConditionalColor(start: SpreadsheetConditionalRgbColor, end: SpreadsheetConditionalRgbColor, amount: number): SpreadsheetConditionalRgbColor;
+export declare function spreadsheetConditionalCssColor(color: SpreadsheetConditionalRgbColor): string;
+export declare function spreadsheetConditionalRatio(value: number, minimum: number, maximum: number): number;

package/dist/internal/features/work/work-spreadsheet-conditional-comparisons.d.ts

@@ -0,0 +1,4 @@
+export declare const SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS: readonly ["greaterThan", "greaterThanOrEqual", "lessThan", "lessThanOrEqual", "equal", "notEqual", "between", "notBetween"];
+export type SpreadsheetConditionalComparisonOperator = (typeof SPREADSHEET_CONDITIONAL_COMPARISON_OPERATORS)[number];
+export declare function isSpreadsheetConditionalComparisonOperator(value: unknown): value is SpreadsheetConditionalComparisonOperator;
+export declare function spreadsheetConditionalComparisonNeedsUpperValue(operator: SpreadsheetConditionalComparisonOperator): boolean;

package/dist/internal/features/work/work-spreadsheet-conditional-data-bar.d.ts

@@ -0,0 +1,8 @@
+export interface SpreadsheetConditionalDataBar {
+    color: string;
+    startPercent: number;
+    widthPercent: number;
+    axisPercent?: number;
+    showValue: boolean;
+}
+export declare function spreadsheetConditionalDataBar(color: string, value: number, minimum: number, maximum: number, minLength: number, maxLength: number, showValue: boolean): SpreadsheetConditionalDataBar;

package/dist/internal/features/work/work-spreadsheet-conditional-format.d.ts

@@ -0,0 +1,10 @@
+import type { Sheet } from '@fortune-sheet/core';
+import { type SpreadsheetConditionalDataBar } from './work-spreadsheet-conditional-data-bar';
+import { type SpreadsheetConditionalIcon } from './work-spreadsheet-conditional-icons';
+export interface SpreadsheetConditionalCellStyle {
+    textColor?: string;
+    cellColor?: string;
+    dataBar?: SpreadsheetConditionalDataBar;
+    icon?: SpreadsheetConditionalIcon;
+}
+export declare function spreadsheetConditionalFormatStyles(sheet: Sheet): Map<string, SpreadsheetConditionalCellStyle>;

package/dist/internal/features/work/work-spreadsheet-conditional-icons.d.ts

@@ -0,0 +1,107 @@
+export declare const SPREADSHEET_CONDITIONAL_ICON_SETS: readonly [{
+    readonly name: "3Arrows";
+    readonly label: "三向彩色箭头";
+    readonly count: 3;
+}, {
+    readonly name: "3ArrowsGray";
+    readonly label: "三向灰色箭头";
+    readonly count: 3;
+}, {
+    readonly name: "3Flags";
+    readonly label: "三色旗帜";
+    readonly count: 3;
+}, {
+    readonly name: "3TrafficLights1";
+    readonly label: "三色交通灯（实心）";
+    readonly count: 3;
+}, {
+    readonly name: "3TrafficLights2";
+    readonly label: "三色交通灯（边框）";
+    readonly count: 3;
+}, {
+    readonly name: "3Signs";
+    readonly label: "三色标志";
+    readonly count: 3;
+}, {
+    readonly name: "3Symbols";
+    readonly label: "三色符号（圆形）";
+    readonly count: 3;
+}, {
+    readonly name: "3Symbols2";
+    readonly label: "三色符号";
+    readonly count: 3;
+}, {
+    readonly name: "4Arrows";
+    readonly label: "四向彩色箭头";
+    readonly count: 4;
+}, {
+    readonly name: "4ArrowsGray";
+    readonly label: "四向灰色箭头";
+    readonly count: 4;
+}, {
+    readonly name: "4RedToBlack";
+    readonly label: "红到黑圆点";
+    readonly count: 4;
+}, {
+    readonly name: "4Rating";
+    readonly label: "四级评分";
+    readonly count: 4;
+}, {
+    readonly name: "4TrafficLights";
+    readonly label: "四色交通灯";
+    readonly count: 4;
+}, {
+    readonly name: "5Arrows";
+    readonly label: "五向彩色箭头";
+    readonly count: 5;
+}, {
+    readonly name: "5ArrowsGray";
+    readonly label: "五向灰色箭头";
+    readonly count: 5;
+}, {
+    readonly name: "5Rating";
+    readonly label: "五级评分";
+    readonly count: 5;
+}, {
+    readonly name: "5Quarters";
+    readonly label: "五级圆饼";
+    readonly count: 5;
+}];
+export type SpreadsheetConditionalIconSetName = (typeof SPREADSHEET_CONDITIONAL_ICON_SETS)[number]['name'];
+export type SpreadsheetConditionalIconCount = 3 | 4 | 5;
+export type SpreadsheetConditionalIconThresholdType = SpreadsheetConditionalThresholdType;
+export interface SpreadsheetConditionalIconThreshold extends SpreadsheetConditionalThreshold {
+    gte: boolean;
+}
+export interface SpreadsheetConditionalIconSetFormat {
+    iconSet: SpreadsheetConditionalIconSetName;
+    showValue: boolean;
+    reverse: boolean;
+    percent: boolean;
+    thresholds: SpreadsheetConditionalIconThreshold[];
+}
+export interface SpreadsheetConditionalIcon {
+    iconSet: SpreadsheetConditionalIconSetName;
+    index: number;
+    count: SpreadsheetConditionalIconCount;
+    showValue: boolean;
+}
+export interface SpreadsheetConditionalIconAppearance {
+    glyph: string;
+    color: string;
+    label: string;
+}
+export interface SpreadsheetConditionalIconBounds {
+    startX: number;
+    startY: number;
+    endX: number;
+    endY: number;
+}
+export declare function isSpreadsheetConditionalIconSetName(value: unknown): value is SpreadsheetConditionalIconSetName;
+export declare function spreadsheetConditionalIconSetCount(iconSet: SpreadsheetConditionalIconSetName): SpreadsheetConditionalIconCount;
+export declare function defaultSpreadsheetConditionalIconThresholds(iconSet: SpreadsheetConditionalIconSetName): SpreadsheetConditionalIconThreshold[];
+export declare function normalizeSpreadsheetConditionalIconSetFormat(value: unknown): SpreadsheetConditionalIconSetFormat | null;
+export declare function spreadsheetConditionalIconForValue(sourceFormat: SpreadsheetConditionalIconSetFormat, value: number, sourceValues: number[]): SpreadsheetConditionalIcon | null;
+export declare function spreadsheetConditionalIconAppearance(icon: SpreadsheetConditionalIcon): SpreadsheetConditionalIconAppearance;
+export declare function drawSpreadsheetConditionalIcon(context: CanvasRenderingContext2D, bounds: SpreadsheetConditionalIconBounds, icon: SpreadsheetConditionalIcon, background: string, maskValue?: boolean): void;
+import { type SpreadsheetConditionalThreshold, type SpreadsheetConditionalThresholdType } from './work-spreadsheet-conditional-values';

package/dist/internal/features/work/work-spreadsheet-conditional-values.d.ts

@@ -0,0 +1,19 @@
+export type SpreadsheetConditionalThresholdType = 'min' | 'max' | 'num' | 'percent' | 'percentile';
+export interface SpreadsheetConditionalThreshold {
+    type: SpreadsheetConditionalThresholdType;
+    value?: number;
+}
+export interface SpreadsheetConditionalVisualOptions {
+    thresholds: SpreadsheetConditionalThreshold[];
+    showValue?: boolean;
+    minLength?: number;
+    maxLength?: number;
+}
+export declare const DEFAULT_DATA_BAR_MIN_LENGTH = 10;
+export declare const DEFAULT_DATA_BAR_MAX_LENGTH = 90;
+export declare function defaultSpreadsheetColorScaleThresholds(colorCount: number): SpreadsheetConditionalThreshold[];
+export declare function defaultSpreadsheetDataBarOptions(): Required<SpreadsheetConditionalVisualOptions>;
+export declare function normalizeSpreadsheetConditionalThreshold(value: unknown): SpreadsheetConditionalThreshold | null;
+export declare function normalizeSpreadsheetConditionalVisualOptions(value: unknown, expectedThresholdCount: number, kind: 'colorScale' | 'dataBar'): SpreadsheetConditionalVisualOptions | null;
+export declare function spreadsheetConditionalThresholdValue(threshold: SpreadsheetConditionalThreshold, sourceValues: number[]): number | null;
+export declare function spreadsheetConditionalThresholdsEqual(left: SpreadsheetConditionalThreshold[], right: SpreadsheetConditionalThreshold[]): boolean;

package/dist/internal/features/work/work-spreadsheet-data-label-svg.d.ts

@@ -0,0 +1,27 @@
+import { type WorkSpreadsheetChart } from './work-types';
+export type SpreadsheetDataLabelGeometry = {
+    kind: 'point';
+    x: number;
+    y: number;
+} | {
+    kind: 'verticalBar';
+    x: number;
+    valueY: number;
+    baselineY: number;
+    value: number;
+} | {
+    kind: 'horizontalBar';
+    y: number;
+    valueX: number;
+    baselineX: number;
+    value: number;
+} | {
+    kind: 'circular';
+    centerX: number;
+    centerY: number;
+    angle: number;
+    innerRadius: number;
+    outerRadius: number;
+};
+export declare function spreadsheetDataLabelSvg(chart: WorkSpreadsheetChart, seriesIndex: number, pointIndex: number, geometry: SpreadsheetDataLabelGeometry): string;
+export declare function spreadsheetDataLabelText(chart: WorkSpreadsheetChart, seriesIndex: number, pointIndex: number): string;

package/dist/internal/features/work/work-spreadsheet-error-bar-svg.d.ts

@@ -0,0 +1,5 @@
+import { type WorkSpreadsheetChart, type WorkSpreadsheetErrorBarDirection } from './work-types';
+type ErrorBarPoint = readonly [number, number];
+type ErrorBarPosition = (direction: WorkSpreadsheetErrorBarDirection, pointIndex: number, value: number) => ErrorBarPoint;
+export declare function spreadsheetSeriesErrorBarsSvg(chart: WorkSpreadsheetChart, seriesIndex: number, position: ErrorBarPosition): string;
+export {};

package/dist/internal/features/work/work-spreadsheet-error-bars.d.ts

@@ -0,0 +1,8 @@
+import { type WorkSpreadsheetChartSeries, type WorkSpreadsheetChartType, type WorkSpreadsheetErrorBars } from './work-types';
+export interface SpreadsheetErrorBarAmount {
+    minus: number;
+    plus: number;
+}
+export declare function spreadsheetErrorBarAmounts(series: WorkSpreadsheetChartSeries, source: WorkSpreadsheetErrorBars, chartType: WorkSpreadsheetChartType): SpreadsheetErrorBarAmount[];
+export declare function spreadsheetSeriesErrorBarBounds(series: WorkSpreadsheetChartSeries, chartType: WorkSpreadsheetChartType, direction: 'x' | 'y'): number[];
+export declare function errorBarSourceValues(series: WorkSpreadsheetChartSeries, errorBars: Pick<WorkSpreadsheetErrorBars, 'direction'>): number[];

package/dist/internal/features/work/work-spreadsheet-formula-analysis.d.ts

@@ -0,0 +1,30 @@
+import type { WorkSpreadsheetContent } from './work-types';
+export interface SpreadsheetFormulaSummary {
+    formulaCells: number;
+    cachedErrorCells: number;
+    arrayRanges: number;
+    dynamicArrayRanges: number;
+    dataTableRanges: number;
+    normalizedSharedFormulaGroups: number;
+    normalizedSharedFormulaCells: number;
+    externalReferenceCells: number;
+    structuredReferenceCells: number;
+    volatileFormulaCells: number;
+    unsupportedFunctions: string[];
+    spillConflicts: number;
+}
+export interface SpreadsheetFormulaDiagnostic {
+    code: string;
+    severity: 'info' | 'warning' | 'error';
+    title: string;
+    message: string;
+    locations: string[];
+}
+export interface SpreadsheetFormulaAnalysis {
+    summary: SpreadsheetFormulaSummary;
+    diagnostics: SpreadsheetFormulaDiagnostic[];
+}
+export declare function spreadsheetFormulaCount(content: WorkSpreadsheetContent): number;
+export declare function spreadsheetFormulaSummary(content: WorkSpreadsheetContent): SpreadsheetFormulaSummary;
+export declare function spreadsheetFormulaDiagnostics(content: WorkSpreadsheetContent): SpreadsheetFormulaDiagnostic[];
+export declare function spreadsheetFormulaAnalysis(content: WorkSpreadsheetContent): SpreadsheetFormulaAnalysis;

package/dist/internal/features/work/work-spreadsheet-formula-support.d.ts

@@ -0,0 +1 @@
+export declare function unsupportedSpreadsheetFormulaFunctions(formula: string): string[];

package/dist/internal/features/work/work-spreadsheet-formulas.d.ts

@@ -0,0 +1,19 @@
+import type { WorkSpreadsheetCalculationSettings, WorkSpreadsheetFormulaRange, WorkSpreadsheetSheet } from './work-types';
+export declare const DEFAULT_SPREADSHEET_CALCULATION_SETTINGS: WorkSpreadsheetCalculationSettings;
+export interface SpreadsheetRangeBounds {
+    startRow: number;
+    endRow: number;
+    startColumn: number;
+    endColumn: number;
+}
+export declare function effectiveSpreadsheetCalculationSettings(settings: WorkSpreadsheetCalculationSettings | undefined): WorkSpreadsheetCalculationSettings;
+export declare function editableSpreadsheetFormula(source: string): string;
+export declare function spreadsheetFormulaForXlsx(currentFormula: string, sourceFormula?: string): string;
+export declare function spreadsheetFormulaRangeForCell(sheet: WorkSpreadsheetSheet, row: number, column: number): WorkSpreadsheetFormulaRange | undefined;
+export declare function spreadsheetFormulaRangesForSelection(sheet: WorkSpreadsheetSheet, selection: SpreadsheetRangeBounds): WorkSpreadsheetFormulaRange[];
+export declare function spreadsheetFormulaRangeConflict(sheet: WorkSpreadsheetSheet, range: WorkSpreadsheetFormulaRange): string | null;
+export declare function spreadsheetFormulaFunctions(formula: string): string[];
+export declare function formulaHasExternalReference(formula: string): boolean;
+export declare function formulaHasStructuredReference(formula: string): boolean;
+export declare function volatileSpreadsheetFormulaFunctions(formula: string): string[];
+export declare function spreadsheetCellAddress(row: number, column: number): string;

package/dist/internal/features/work/work-spreadsheet-header-footer.d.ts

@@ -0,0 +1,14 @@
+import type { WorkSpreadsheetHeaderFooterSections } from './work-types';
+export type EffectiveSpreadsheetHeaderFooterSections = Required<WorkSpreadsheetHeaderFooterSections>;
+export declare const SPREADSHEET_HEADER_FOOTER_TOKENS: readonly ["{page}", "{pages}", "{sheet}", "{file}", "{path}", "{date}", "{time}"];
+export interface SpreadsheetHeaderFooterTokenContext {
+    page: number;
+    pages: number;
+    sheetName: string;
+    fileName: string;
+    filePath?: string;
+    now?: Date;
+}
+export declare function effectiveSpreadsheetHeaderFooterSections(sections: WorkSpreadsheetHeaderFooterSections | undefined): EffectiveSpreadsheetHeaderFooterSections;
+export declare function hasSpreadsheetHeaderFooterSections(sections: WorkSpreadsheetHeaderFooterSections | undefined): boolean;
+export declare function resolveSpreadsheetHeaderFooterTemplate(template: string, context: SpreadsheetHeaderFooterTokenContext): string;

package/dist/internal/features/work/work-spreadsheet-line-chart-svg.d.ts

@@ -0,0 +1,10 @@
+import type { SpreadsheetChartSeriesLayout } from './work-spreadsheet-chart-series-layout';
+import type { WorkSpreadsheetChart } from './work-types';
+interface SpreadsheetLineChartPlot {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+export declare function spreadsheetLineChartSvg(chart: WorkSpreadsheetChart, plot: SpreadsheetLineChartPlot, valuePosition: (value: number) => number, layout: SpreadsheetChartSeriesLayout): string;
+export {};

package/dist/internal/features/work/work-spreadsheet-page-breaks.d.ts

@@ -0,0 +1,4 @@
+export declare function parseSpreadsheetRowPageBreaks(value: string, maximumRow: number): number[] | null;
+export declare function formatSpreadsheetRowPageBreaks(breaks: number[] | undefined): string;
+export declare function parseSpreadsheetColumnPageBreaks(value: string, maximumColumn: number): number[] | null;
+export declare function formatSpreadsheetColumnPageBreaks(breaks: number[] | undefined): string;

package/dist/internal/features/work/work-spreadsheet-page-setup.d.ts

@@ -0,0 +1,26 @@
+import { type EffectiveSpreadsheetHeaderFooterSections } from './work-spreadsheet-header-footer';
+import type { WorkSpreadsheetPageMargins, WorkSpreadsheetPageSetup, WorkSpreadsheetPaperSize } from './work-types';
+export interface EffectiveSpreadsheetPageSetup {
+    paperSize: WorkSpreadsheetPaperSize;
+    orientation: 'portrait' | 'landscape';
+    scale: number;
+    fitToPage: boolean;
+    fitToWidth: number;
+    fitToHeight: number;
+    horizontalCentered: boolean;
+    verticalCentered: boolean;
+    header: EffectiveSpreadsheetHeaderFooterSections;
+    footer: EffectiveSpreadsheetHeaderFooterSections;
+    pageNumberStart: number;
+    pageOrder: 'downThenOver' | 'overThenDown';
+    scaleWithDocument: boolean;
+    alignWithMargins: boolean;
+    margins: WorkSpreadsheetPageMargins;
+}
+export declare function effectiveSpreadsheetPageSetup(pageSetup: WorkSpreadsheetPageSetup | undefined): EffectiveSpreadsheetPageSetup;
+export declare function normalizeSpreadsheetPaperSize(value: unknown): WorkSpreadsheetPaperSize;
+export declare function spreadsheetPageCapacity(pageSetup: EffectiveSpreadsheetPageSetup): {
+    rows: number;
+    columns: number;
+};
+export declare function fitSpreadsheetAxisCapacity(start: number, end: number, titleRange: [number, number] | undefined, targetPages: number, fallbackCapacity: number): number;

package/dist/internal/features/work/work-spreadsheet-pivot-engine.d.ts

@@ -0,0 +1,21 @@
+import type { CellMatrix } from '@fortune-sheet/core';
+import type { WorkSpreadsheetPivotAggregation, WorkSpreadsheetPivotFilterValue, WorkSpreadsheetPivotTable, WorkSpreadsheetSheet } from './work-types';
+export interface SpreadsheetPivotField {
+    index: number;
+    name: string;
+    numeric: boolean;
+}
+export interface SpreadsheetPivotFilterItem {
+    value: WorkSpreadsheetPivotFilterValue;
+    label: string;
+}
+export interface SpreadsheetPivotBounds {
+    startRow: number;
+    endRow: number;
+    startColumn: number;
+    endColumn: number;
+}
+export declare function spreadsheetPivotFilterItemsFromSource(sourceSheet: WorkSpreadsheetSheet, sourceBounds: SpreadsheetPivotBounds, fieldIndex: number): SpreadsheetPivotFilterItem[];
+export declare function buildSpreadsheetPivotOutput(sourceSheet: WorkSpreadsheetSheet, sourceBounds: SpreadsheetPivotBounds, fields: SpreadsheetPivotField[], pivot: WorkSpreadsheetPivotTable): CellMatrix;
+export declare function defaultPivotValueCaption(fieldName: string, aggregation: WorkSpreadsheetPivotAggregation): string;
+export declare function spreadsheetPivotAggregationLabel(aggregation: WorkSpreadsheetPivotAggregation): string;

package/dist/internal/features/work/work-spreadsheet-pivot-values.d.ts

@@ -0,0 +1,7 @@
+import type { Cell } from '@fortune-sheet/core';
+import type { WorkSpreadsheetPivotFilterValue } from './work-types';
+export declare function spreadsheetPivotCellValue(cell: Cell | null | undefined): unknown;
+export declare function normalizeSpreadsheetPivotFilterValue(value: unknown): WorkSpreadsheetPivotFilterValue;
+export declare function spreadsheetPivotFilterValueKey(value: WorkSpreadsheetPivotFilterValue): string;
+export declare function displaySpreadsheetPivotValue(value: unknown): string;
+export declare function finiteSpreadsheetPivotNumber(value: unknown): number | null;

package/dist/internal/features/work/work-spreadsheet-pivots.d.ts

@@ -0,0 +1,27 @@
+import type { Selection } from '@fortune-sheet/core';
+import { defaultPivotValueCaption, spreadsheetPivotAggregationLabel, type SpreadsheetPivotBounds as PivotBounds, type SpreadsheetPivotField, type SpreadsheetPivotFilterItem } from './work-spreadsheet-pivot-engine';
+import type { WorkSpreadsheetContent, WorkSpreadsheetPivotTable, WorkSpreadsheetSheet } from './work-types';
+export { defaultPivotValueCaption, spreadsheetPivotAggregationLabel };
+export type { SpreadsheetPivotField, SpreadsheetPivotFilterItem };
+export interface SpreadsheetPivotValidation {
+    valid: boolean;
+    code?: string;
+    message?: string;
+    outputReference?: string;
+}
+export interface CreateSpreadsheetPivotResult {
+    content: WorkSpreadsheetContent;
+    ownerSheetId?: string;
+    pivotId?: string;
+    error?: string;
+}
+export declare function spreadsheetPivotCount(content: WorkSpreadsheetContent): number;
+export declare function spreadsheetPivotFields(content: WorkSpreadsheetContent, pivot: Pick<WorkSpreadsheetPivotTable, 'sourceSheetId' | 'sourceReference'>): SpreadsheetPivotField[];
+export declare function spreadsheetPivotFilterItems(content: WorkSpreadsheetContent, pivot: Pick<WorkSpreadsheetPivotTable, 'sourceSheetId' | 'sourceReference'>, fieldIndex: number): SpreadsheetPivotFilterItem[];
+export declare function createSpreadsheetPivotFromSelection(content: WorkSpreadsheetContent, sourceSheetId: string, selection: Pick<Selection, 'row' | 'column'>): CreateSpreadsheetPivotResult;
+export declare function refreshSpreadsheetPivotTables(content: WorkSpreadsheetContent): WorkSpreadsheetContent;
+export declare function reconcileSpreadsheetPivots(content: WorkSpreadsheetContent, changedSheets: WorkSpreadsheetSheet[]): WorkSpreadsheetContent;
+export declare function deleteSpreadsheetPivotTable(content: WorkSpreadsheetContent, ownerSheetId: string, pivotId: string): WorkSpreadsheetContent;
+export declare function spreadsheetPivotValidation(content: WorkSpreadsheetContent, ownerSheetId: string, pivot: WorkSpreadsheetPivotTable): SpreadsheetPivotValidation;
+export declare function spreadsheetPivotOutputContains(sheet: WorkSpreadsheetSheet, row: number, column: number): boolean;
+export declare function spreadsheetPivotIntersects(sheet: WorkSpreadsheetSheet, range: PivotBounds): WorkSpreadsheetPivotTable[];

package/dist/internal/features/work/work-spreadsheet-protection.d.ts

@@ -0,0 +1,55 @@
+import type { CellMatrix, Sheet } from '@fortune-sheet/core';
+import { type SpreadsheetCellRange } from './work-spreadsheet-ranges';
+export declare const DEFAULT_PROTECTION_HINT = "\u6B64\u5DE5\u4F5C\u8868\u5DF2\u53D7\u4FDD\u62A4\u3002\u82E5\u8981\u66F4\u6539\u9501\u5B9A\u7684\u5355\u5143\u683C\uFF0C\u8BF7\u5148\u53D6\u6D88\u5DE5\u4F5C\u8868\u4FDD\u62A4\u3002";
+export interface FortuneSheetEditableRange {
+    name: string;
+    sqref: string;
+    hintText?: string;
+    xlsxAttributes?: Record<string, string>;
+}
+export interface FortuneSheetProtectionAuthority {
+    sheet: 0 | 1;
+    selectLockedCells: 0 | 1;
+    selectunLockedCells: 0 | 1;
+    formatCells: 0 | 1;
+    formatColumns: 0 | 1;
+    formatRows: 0 | 1;
+    insertColumns: 0 | 1;
+    insertRows: 0 | 1;
+    insertHyperlinks: 0 | 1;
+    deleteColumns: 0 | 1;
+    deleteRows: 0 | 1;
+    sort: 0 | 1;
+    filter: 0 | 1;
+    usePivotTablereports: 0 | 1;
+    editObjects: 0 | 1;
+    editScenarios: 0 | 1;
+    hintText: string;
+    defaultSheetHintText: string;
+    allowRangeList: FortuneSheetEditableRange[];
+    xlsxAttributes?: Record<string, string>;
+}
+export interface SpreadsheetCellProtectionRange {
+    range: SpreadsheetCellRange;
+    locked: boolean;
+    hidden: boolean;
+}
+export declare function defaultSheetProtectionAuthority(enabled?: boolean): FortuneSheetProtectionAuthority;
+export declare function sheetProtectionAuthority(sheet: Sheet): FortuneSheetProtectionAuthority;
+export declare function normalizeSheetProtectionAuthority(source: unknown): FortuneSheetProtectionAuthority;
+export declare function withSheetProtection(sheet: Sheet, enabled: boolean): Sheet;
+export declare function withSheetSelectionPermissions(sheet: Sheet, permissions: {
+    selectLockedCells?: boolean;
+    selectUnlockedCells?: boolean;
+}): Sheet;
+export declare function withEditableRange(sheet: Sheet, index: number | null, editableRange: FortuneSheetEditableRange): Sheet;
+export declare function withoutEditableRange(sheet: Sheet, index: number): Sheet;
+export declare function withCellProtection(sheet: Sheet, ranges: SpreadsheetCellRange[], locked: boolean, hidden?: boolean): Sheet;
+export declare function applySpreadsheetCellProtectionRanges(data: CellMatrix, ranges: SpreadsheetCellProtectionRange[], rowCount: number, columnCount: number): void;
+export declare function applyPasswordlessEditableRanges(data: CellMatrix, ranges: FortuneSheetEditableRange[], rowCount: number, columnCount: number): void;
+export declare function editableRangeRequiresCredentials(range: FortuneSheetEditableRange): boolean;
+export declare function sheetHasProtectionState(sheet: Sheet): boolean;
+export declare function protectedSheetCount(sheets: Sheet[]): number;
+export declare function unlockedCellCount(sheet: Sheet): number;
+export declare function spreadsheetProtectionKey(sheets: Sheet[]): string;
+export declare function editableRangeCellCount(ranges: SpreadsheetCellRange[]): number;