@a3s-lab/office 0.25.0 → 0.27.0

package/dist/internal/features/work/work-docx-twips.d.ts

@@ -5,6 +5,12 @@ export declare function parseDocxTwipsMeasure(source: string, options: {
     signed: boolean;
     strict: boolean;
 }): number | null;
+export declare function parseDocxHalfPointsMeasure(source: string, options: {
+    minimum: number;
+    maximum: number;
+    signed: boolean;
+    strict: boolean;
+}): number | null;
 export declare function parseBoundedDocxInteger(source: string, options: {
     minimum: number;
     maximum: number;

package/dist/internal/features/work/work-docx-underline.d.ts

@@ -0,0 +1,3 @@
+import { type WorkDocumentUnderlineFormatting } from './work-document-underline';
+import { type DocxThemeResolver } from './work-docx-theme';
+export declare function importedDocxUnderline(element: Element, theme?: DocxThemeResolver): WorkDocumentUnderlineFormatting;

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

@@ -0,0 +1,10 @@
+import type { XlsxGradientFill } from './work-xlsx-gradient-fill';
+export interface SpreadsheetGradientFillBounds {
+    endX: number;
+    endY: number;
+    startX: number;
+    startY: number;
+}
+type SpreadsheetGradientFillRect = CanvasRenderingContext2D['fillRect'];
+export declare function drawSpreadsheetGradientFill(context: CanvasRenderingContext2D, bounds: SpreadsheetGradientFillBounds, fill: XlsxGradientFill, fillRect?: SpreadsheetGradientFillRect): void;
+export {};

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

@@ -0,0 +1,8 @@
+import type { XlsxNativeFill } from './work-xlsx-native-fill';
+/**
+ * Fortune Sheet paints a cell background immediately after beforeRenderCell.
+ * Intercepting only that first viewport paint keeps native fills behind text
+ * and avoids any fill work for cells outside the visible Canvas.
+ */
+export declare function beginSpreadsheetNativeFillRender(fill: XlsxNativeFill | undefined, context: CanvasRenderingContext2D): void;
+export declare function finishSpreadsheetNativeFillRender(context: CanvasRenderingContext2D): void;

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

@@ -0,0 +1,8 @@
+import type { XlsxPatternFill } from './work-xlsx-pattern-fill';
+export interface SpreadsheetPatternFillBounds {
+    endX: number;
+    endY: number;
+    startX: number;
+    startY: number;
+}
+export declare function drawSpreadsheetPatternFillOverlay(context: CanvasRenderingContext2D, bounds: SpreadsheetPatternFillBounds, fill: XlsxPatternFill): void;

package/dist/internal/features/work/work-xlsx-cell-style-origin.d.ts

@@ -41,5 +41,6 @@ export declare function xlsxColorElementMatchesOrigin(element: Element | undefin
 export declare function applyXlsxSemanticColorOrigin(element: Element, origin: XlsxSemanticColorOrigin): void;
 export declare function xlsxSemanticColorOriginKey(origin: XlsxSemanticColorOrigin | undefined): string;
 export declare function xlsxSemanticColorOriginSupported(origin: XlsxSemanticColorOrigin, palette: XlsxSemanticPalette | undefined): boolean;
-export declare function prepareXlsxSemanticPalette(styles: Document, theme: Document | null, origins: Iterable<XlsxCellStyleOrigin>): PreparedXlsxSemanticPalette;
+export declare function prepareXlsxSemanticPalette(styles: Document, theme: Document | null, colors: Iterable<XlsxSemanticColorOrigin>): PreparedXlsxSemanticPalette;
+export declare function xlsxCellStyleOriginSemanticColors(origin: XlsxCellStyleOrigin): XlsxSemanticColorOrigin[];
 export declare function normalizeXlsxSemanticColorOrigin(value: unknown): XlsxSemanticColorOrigin | undefined;

package/dist/internal/features/work/work-xlsx-cell-style-writer.d.ts

@@ -18,6 +18,9 @@ export declare class XlsxDirectCellStyleWriter {
     styleId(baseStyleId: number, cell: Cell, border?: XlsxCellBorder): number;
     private fontId;
     private fillId;
+    private gradientFillId;
+    private exportGradientFill;
+    private fillColorElement;
     private borderId;
     private updateCounts;
 }

package/dist/internal/features/work/work-xlsx-cell-styles.d.ts

@@ -2,11 +2,15 @@ import type { Cell, Sheet } from '@fortune-sheet/core';
 import { type XlsxCellBorder } from './work-xlsx-cell-borders';
 import { type XlsxDirectCellStyleWriter } from './work-xlsx-cell-style-writer';
 import { type XlsxCellStyleOrigin } from './work-xlsx-cell-style-origin';
+import { type XlsxGradientFill } from './work-xlsx-gradient-fill';
+import { type XlsxPatternFill } from './work-xlsx-pattern-fill';
 export { XlsxDirectCellStyleWriter } from './work-xlsx-cell-style-writer';
 export interface XlsxDirectCellStyle {
     border?: XlsxCellBorder;
     column: number;
+    gradientFill?: XlsxGradientFill;
     origin?: XlsxCellStyleOrigin;
+    patternFill?: XlsxPatternFill;
     row: number;
     style: Partial<Cell>;
 }

package/dist/internal/features/work/work-xlsx-gradient-fill.d.ts

@@ -0,0 +1,31 @@
+import type { Cell } from '@fortune-sheet/core';
+import { type XlsxSemanticColorOrigin } from './work-xlsx-cell-style-origin';
+import { type XlsxColorResolver } from './work-xlsx-colors';
+export declare const XLSX_GRADIENT_FILL_CELL_KEY: "a3sXlsxGradientFill";
+export declare const MAX_XLSX_GRADIENT_STOPS = 256;
+export interface XlsxGradientStop {
+    color: string;
+    colorOrigin?: XlsxSemanticColorOrigin;
+    position: number;
+}
+export type XlsxGradientFill = {
+    degree: number;
+    stops: XlsxGradientStop[];
+    type: 'linear';
+} | {
+    bottom: number;
+    left: number;
+    right: number;
+    stops: XlsxGradientStop[];
+    top: number;
+    type: 'path';
+};
+export declare function readXlsxGradientFill(element: Element | undefined, colors: XlsxColorResolver): XlsxGradientFill | undefined;
+export declare function withXlsxGradientFill(cell: Cell, fill: XlsxGradientFill | undefined): Cell;
+export declare function deleteXlsxGradientFill(cell: Cell): void;
+export declare function xlsxGradientFill(cell: Cell | null | undefined): XlsxGradientFill | undefined;
+export declare function activeXlsxGradientFill(cell: Cell | null | undefined): XlsxGradientFill | undefined;
+export declare function normalizeXlsxGradientFill(value: unknown): XlsxGradientFill | undefined;
+export declare function xlsxGradientFillFallbackColor(fill: XlsxGradientFill): string;
+export declare function xlsxGradientFillSemanticColors(fill: XlsxGradientFill | undefined): XlsxSemanticColorOrigin[];
+export declare function xlsxGradientFillKey(fill: XlsxGradientFill | undefined): string;

package/dist/internal/features/work/work-xlsx-native-fill.d.ts

@@ -0,0 +1,17 @@
+import type { Cell } from '@fortune-sheet/core';
+import { type XlsxGradientFill } from './work-xlsx-gradient-fill';
+import { type XlsxPatternFill } from './work-xlsx-pattern-fill';
+import type { XlsxSemanticColorOrigin } from './work-xlsx-cell-style-origin';
+export declare const xlsxNativeFillCellKeys: readonly ["a3sXlsxPatternFill", "a3sXlsxGradientFill"];
+export type XlsxNativeFillCellKey = (typeof xlsxNativeFillCellKeys)[number];
+export type XlsxNativeFill = {
+    kind: 'gradient';
+    value: XlsxGradientFill;
+} | {
+    kind: 'pattern';
+    value: XlsxPatternFill;
+};
+export declare function activeXlsxNativeFill(cell: Cell | null | undefined): XlsxNativeFill | undefined;
+export declare function deleteXlsxNativeFills(cell: Cell): void;
+export declare function xlsxNativeFillSemanticColors(fill: XlsxNativeFill | undefined): XlsxSemanticColorOrigin[];
+export declare function xlsxNativeFillKey(fill: XlsxNativeFill | undefined): string;

package/dist/internal/features/work/work-xlsx-pattern-fill.d.ts

@@ -0,0 +1,21 @@
+import type { Cell } from '@fortune-sheet/core';
+import { type XlsxSemanticColorOrigin } from './work-xlsx-cell-style-origin';
+import { type XlsxColorResolver } from './work-xlsx-colors';
+export declare const XLSX_PATTERN_FILL_CELL_KEY: "a3sXlsxPatternFill";
+export declare const xlsxPatternFillTypes: readonly ["darkDown", "darkGray", "darkGrid", "darkHorizontal", "darkTrellis", "darkUp", "darkVertical", "gray0625", "gray125", "lightDown", "lightGray", "lightGrid", "lightHorizontal", "lightTrellis", "lightUp", "lightVertical", "mediumGray"];
+export type XlsxPatternFillType = (typeof xlsxPatternFillTypes)[number];
+export interface XlsxPatternFill {
+    backgroundColor: string;
+    backgroundColorOrigin?: XlsxSemanticColorOrigin;
+    foregroundColor: string;
+    foregroundColorOrigin?: XlsxSemanticColorOrigin;
+    patternType: XlsxPatternFillType;
+}
+export declare function readXlsxPatternFill(pattern: Element | undefined, colors: XlsxColorResolver): XlsxPatternFill | undefined;
+export declare function withXlsxPatternFill(cell: Cell, fill: XlsxPatternFill | undefined): Cell;
+export declare function deleteXlsxPatternFill(cell: Cell): void;
+export declare function xlsxPatternFill(cell: Cell | null | undefined): XlsxPatternFill | undefined;
+export declare function activeXlsxPatternFill(cell: Cell | null | undefined): XlsxPatternFill | undefined;
+export declare function normalizeXlsxPatternFill(value: unknown): XlsxPatternFill | undefined;
+export declare function xlsxPatternFillSemanticColors(fill: XlsxPatternFill | undefined): XlsxSemanticColorOrigin[];
+export declare function xlsxPatternFillKey(fill: XlsxPatternFill | undefined): string;

package/dist/internal/features/work/work-xlsx-rich-text-edit.d.ts

@@ -0,0 +1,28 @@
+import type { Cell } from '@fortune-sheet/core';
+import { type XlsxRichTextRun } from './work-xlsx-rich-text-model';
+export interface SpreadsheetRichTextPasteIntent {
+    end: number;
+    runs: readonly XlsxRichTextRun[];
+    start: number;
+    text: string;
+}
+/**
+ * Reconciles a text edit emitted by Fortune with the previous native XLSX
+ * rich-text cell. Formula-bar edits may arrive as a plain string, while the
+ * in-cell editor emits visible runs without A3S-only semantic color metadata.
+ * This bounded model restores only style and metadata justified by the prior
+ * controlled value and the exact text replacement.
+ */
+export declare function reconcileSpreadsheetRichTextCellEdit(previous: Cell | null | undefined, current: Cell, formattedPaste?: SpreadsheetRichTextPasteIntent): Cell;
+/**
+ * Restores the controlled runs when an unauthenticated Fortune callback keeps
+ * the exact visible text but drops native run metadata. Callers must reserve
+ * this for non-structural batches without an exact cell-operation coordinate.
+ */
+export declare function restoreSpreadsheetRichTextCellRuns(previous: Cell | null | undefined, current: Cell): Cell;
+/**
+ * Proves that Fortune retained the visible text of a controlled native
+ * rich-text cell. This permits metadata-only callbacks to restore lost run
+ * structure without guessing across a text or structural edit.
+ */
+export declare function sameSpreadsheetRichTextCellText(previous: Cell | null | undefined, current: Cell): boolean;

package/dist/internal/features/work/work-xlsx-rich-text-model.d.ts

@@ -0,0 +1,40 @@
+import type { Cell } from '@fortune-sheet/core';
+import { type XlsxSemanticColorOrigin } from './work-xlsx-cell-style-origin';
+import type { SpreadsheetUnderlineCellValue } from './work-spreadsheet-underline';
+export declare const MAX_XLSX_RICH_TEXT_CELL_CHARACTERS = 32767;
+export declare const MAX_XLSX_RICH_TEXT_RUNS_PER_CELL = 512;
+export declare const MAX_XLSX_RICH_TEXT_CELLS = 10000;
+export declare const MAX_XLSX_RICH_TEXT_RUNS = 100000;
+export declare const MAX_XLSX_RICH_TEXT_FONT_NAME_CHARACTERS = 128;
+export declare const MAX_XLSX_RICH_TEXT_FONT_SIZE = 409;
+export interface XlsxRichTextRun {
+    a3sXlsxColorOrigin?: XlsxSemanticColorOrigin;
+    bl?: 0 | 1;
+    cl?: 0 | 1;
+    fc?: string;
+    ff?: string;
+    fs?: number;
+    it?: 0 | 1;
+    un?: SpreadsheetUnderlineCellValue;
+    v: string;
+}
+export interface NormalizedXlsxRichTextCell {
+    runs: XlsxRichTextRun[];
+    text: string;
+}
+/**
+ * Normalizes the text state that may participate in caret-level rich-text
+ * authoring. Native runs remain authoritative; bounded plain strings receive
+ * one run derived from the cell-wide font so partial formatting and formatted
+ * paste share the same conversion contract.
+ */
+export declare function normalizeXlsxRichTextEditSource(cell: Cell | null | undefined): NormalizedXlsxRichTextCell | null;
+export declare function xlsxRichTextBaseRun(cell: Cell | null | undefined, text: string): XlsxRichTextRun;
+export declare function normalizeXlsxRichTextCell(cell: Cell): NormalizedXlsxRichTextCell | null;
+export declare function normalizeXlsxRichTextRun(value: unknown): XlsxRichTextRun | null;
+export declare function normalizeXlsxRichTextColor(value: unknown): string | null;
+export declare function coalesceXlsxRichTextRuns(source: readonly XlsxRichTextRun[]): XlsxRichTextRun[];
+export declare function sameXlsxRichTextRunStyle(left: XlsxRichTextRun, right: XlsxRichTextRun): boolean;
+export declare function validXlsxRichText(value: string): boolean;
+export declare function isHighSurrogate(value: number): boolean;
+export declare function isLowSurrogate(value: number): boolean;

package/dist/internal/features/work/work-xlsx-rich-text.d.ts

@@ -1,22 +1,9 @@
 import type { Cell, Sheet } from '@fortune-sheet/core';
-import { type SpreadsheetUnderlineCellValue, type SpreadsheetUnderlineStyle } from './work-spreadsheet-underline';
-import { type XlsxCellStyleOrigin, type XlsxSemanticColorOrigin, type XlsxSemanticPalette } from './work-xlsx-cell-style-origin';
+import { type SpreadsheetUnderlineStyle } from './work-spreadsheet-underline';
+import { type XlsxCellStyleOrigin, type XlsxSemanticPalette } from './work-xlsx-cell-style-origin';
 import { type XlsxColorResolver } from './work-xlsx-colors';
-export declare const MAX_XLSX_RICH_TEXT_CELL_CHARACTERS = 32767;
-export declare const MAX_XLSX_RICH_TEXT_RUNS_PER_CELL = 512;
-export declare const MAX_XLSX_RICH_TEXT_CELLS = 10000;
-export declare const MAX_XLSX_RICH_TEXT_RUNS = 100000;
-export interface XlsxRichTextRun {
-    a3sXlsxColorOrigin?: XlsxSemanticColorOrigin;
-    bl?: 0 | 1;
-    cl?: 0 | 1;
-    fc?: string;
-    ff?: string;
-    fs?: number;
-    it?: 0 | 1;
-    un?: SpreadsheetUnderlineCellValue;
-    v: string;
-}
+import { type XlsxRichTextRun } from './work-xlsx-rich-text-model';
+export { MAX_XLSX_RICH_TEXT_CELL_CHARACTERS, MAX_XLSX_RICH_TEXT_CELLS, MAX_XLSX_RICH_TEXT_RUNS, MAX_XLSX_RICH_TEXT_RUNS_PER_CELL, type XlsxRichTextRun, } from './work-xlsx-rich-text-model';
 export interface XlsxRichTextCell {
     column: number;
     row: number;
@@ -52,4 +39,3 @@ export declare function xlsxRichTextCellText(cell: Cell): string | null;
 export declare function sheetHasXlsxRichTextCells(sheet: Sheet): boolean;
 export declare function xlsxRichTextStyleOrigins(sheet: Sheet): XlsxCellStyleOrigin[];
 export declare function writeXlsxRichTextCells(worksheet: Document, sheet: Sheet, semanticPalette?: XlsxSemanticPalette): void;
-export {};