@a3s-lab/office 0.24.0 → 0.25.0

package/dist/core.js

@@ -7,6 +7,6 @@ export { createArtifact, createOfficeId, officeTemplates } from "./5184.js";
 export { createOfficeDocumentCollaborationBinding, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration } from "./6282.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";
-export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./5045.js";
+export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./164.js";
 export { normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetBubbleSizeRepresents, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetDataLabelPosition, normalizeWorkSpreadsheetDataLabels, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetErrorBars, normalizeWorkSpreadsheetRadarStyle, normalizeWorkSpreadsheetScatterStyle, normalizeWorkSpreadsheetTrendline, normalizeWorkSpreadsheetTrendlineType, workSpreadsheetChartSupportsAxes, workSpreadsheetChartSupportsErrorBars, workSpreadsheetChartSupportsTrendlines, workSpreadsheetChartTypeLabel, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetCombinationSeriesTypeLabel, workSpreadsheetDataLabelPositionLabel, workSpreadsheetErrorBarTypeLabel, workSpreadsheetErrorBarValueTypeLabel, workSpreadsheetTrendlineTypeLabel } from "./8715.js";
 export { core_OFFICE_COLLABORATION_VERSION as OFFICE_COLLABORATION_VERSION };

package/dist/index.js

@@ -10,6 +10,6 @@ export { createArtifact, createOfficeId, officeTemplates } from "./5184.js";
 export { createOfficeDocumentCollaborationBinding, initializeOfficeDocumentCollaboration, officeDocumentCollaborationFragment, readOfficeDocumentCollaboration } from "./6282.js";
 export { createOfficeMarkdownCollaborationBinding, initializeOfficeMarkdownCollaboration, readOfficeMarkdownCollaboration, replaceOfficeMarkdownCollaboration } from "./2591.js";
 export { createOfficePresentationCollaborationBinding, initializeOfficePresentationCollaboration, readOfficePresentationCollaboration, replaceOfficePresentationCollaboration } from "./4560.js";
-export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./5045.js";
+export { createOfficeSpreadsheetCollaborationBinding, initializeOfficeSpreadsheetCollaboration, readOfficeSpreadsheetCollaboration, replaceOfficeSpreadsheetCollaboration } from "./164.js";
 export { normalizeWorkSpreadsheetBubbleScale, normalizeWorkSpreadsheetBubbleSizeRepresents, normalizeWorkSpreadsheetChartAxisGroup, normalizeWorkSpreadsheetCombinationSeriesType, normalizeWorkSpreadsheetDataLabelPosition, normalizeWorkSpreadsheetDataLabels, normalizeWorkSpreadsheetDoughnutHoleSize, normalizeWorkSpreadsheetErrorBars, normalizeWorkSpreadsheetRadarStyle, normalizeWorkSpreadsheetScatterStyle, normalizeWorkSpreadsheetTrendline, normalizeWorkSpreadsheetTrendlineType, workSpreadsheetChartSupportsAxes, workSpreadsheetChartSupportsErrorBars, workSpreadsheetChartSupportsTrendlines, workSpreadsheetChartTypeLabel, workSpreadsheetChartUsesNumericXAxis, workSpreadsheetCombinationSeriesTypeLabel, workSpreadsheetDataLabelPositionLabel, workSpreadsheetErrorBarTypeLabel, workSpreadsheetErrorBarValueTypeLabel, workSpreadsheetTrendlineTypeLabel } from "./8715.js";
 export { src_DOCUMENT_SNAPSHOT_VERSION as DOCUMENT_SNAPSHOT_VERSION, src_DOCUMENT_SOURCE_VERSION as DOCUMENT_SOURCE_VERSION, src_OFFICE_COLLABORATION_VERSION as OFFICE_COLLABORATION_VERSION };

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

@@ -42,3 +42,4 @@ export declare function applyXlsxSemanticColorOrigin(element: Element, origin: X
 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 normalizeXlsxSemanticColorOrigin(value: unknown): XlsxSemanticColorOrigin | undefined;

package/dist/internal/features/work/work-xlsx-colors.d.ts

@@ -2,5 +2,5 @@ export interface XlsxColorResolver {
     indexed: readonly string[];
     theme: readonly string[];
 }
-export declare function createXlsxColorResolver(styles: Document, theme: Document | null): XlsxColorResolver;
+export declare function createXlsxColorResolver(styles: Document | null, theme: Document | null): XlsxColorResolver;
 export declare function resolveXlsxColor(element: Element | undefined, resolver: XlsxColorResolver): string | undefined;

package/dist/internal/features/work/work-xlsx-interop.d.ts

@@ -9,6 +9,7 @@ import { type XlsxManualPageBreaks } from './work-xlsx-page-breaks';
 import { type XlsxPageSetup } from './work-xlsx-page-setup';
 import { type XlsxProtectionFeatures } from './work-xlsx-protection';
 import { type XlsxWorksheetXmlScan } from './work-xlsx-worksheet-scan';
+import { type XlsxRichTextCell } from './work-xlsx-rich-text';
 import type { WorkSpreadsheetTable } from './work-types';
 type FrozenPane = NonNullable<Sheet['frozen']>;
 export interface XlsxDataValidation {
@@ -26,6 +27,7 @@ export interface XlsxSheetFeatures {
     images: XlsxWorksheetImage[];
     charts: XlsxWorksheetChart[];
     tables: WorkSpreadsheetTable[];
+    richTextCells: XlsxRichTextCell[];
 }
 export type FortuneDataValidationItem = WorkSpreadsheetDataValidationItem;
 export declare function readXlsxSheetFeatures(buffer: ArrayBuffer): Promise<Map<string, XlsxSheetFeatures>>;

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

@@ -0,0 +1,55 @@
+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 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;
+}
+export interface XlsxRichTextCell {
+    column: number;
+    row: number;
+    runs: XlsxRichTextRun[];
+    text: string;
+}
+export interface XlsxRichTextReadContext {
+    readonly colors: XlsxColorResolver;
+    readonly hasRichSharedStrings: boolean;
+    readonly sharedStrings: ReadonlyMap<number, readonly XlsxRichTextRun[]>;
+    remainingCells: number;
+    remainingRuns: number;
+}
+interface XlsxRichTextContextOptions {
+    sharedStrings: Document | null;
+    styles: Document | null;
+    theme: Document | null;
+}
+interface SpreadsheetRichTextFontPatch {
+    bold?: boolean;
+    fontColor?: string;
+    fontFamily?: string;
+    fontSize?: number;
+    italic?: boolean;
+    strike?: boolean;
+    underline?: SpreadsheetUnderlineStyle;
+}
+export declare function createXlsxRichTextReadContext(options: XlsxRichTextContextOptions): XlsxRichTextReadContext;
+export declare function readXlsxRichTextCells(worksheet: Document, context: XlsxRichTextReadContext): XlsxRichTextCell[];
+export declare function applyImportedXlsxRichText(cell: Cell, richText: XlsxRichTextCell | undefined): Cell;
+export declare function patchSpreadsheetRichTextFontRuns(cell: Cell, patch: SpreadsheetRichTextFontPatch): Cell;
+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 {};

package/dist/internal/features/work/work-xlsx-worksheet-scan.d.ts

@@ -3,6 +3,7 @@ export interface XlsxWorksheetXmlScan {
     hasDiagnosticFeatures: boolean;
     hasFormulaFeatures: boolean;
     hasImportedFeatures: boolean;
+    hasRichTextCells: boolean;
     requiresSheetJsCellStyles: boolean;
 }
 /**

package/dist/internal/features/work/work-xlsx-worksheet.d.ts

@@ -10,3 +10,8 @@ export interface XlsxWorksheetCellEntry {
  * materializing a second list of every worksheet cell.
  */
 export declare function xlsxWorksheetCellEntries(worksheet: WorkSheet): Generator<XlsxWorksheetCellEntry>;
+export declare function xlsxCellAddress(row: number, column: number): string;
+export declare function decodeXlsxCellAddress(address: string): {
+    column: number;
+    row: number;
+} | null;

package/dist/work-spreadsheet-package-scan.worker.js

@@ -4012,22 +4012,24 @@ https://github.com/nodeca/pako/blob/main/LICENSE
             'rowBreaks',
             'colBreaks'
         ]);
-        const WORKSHEET_SCAN_PATTERN = /<(?:[A-Za-z_][\w.-]*:)?(?:(cols|f|pane|dataValidation|conditionalFormatting|sheetProtection|protectedRange|rowBreaks|colBreaks|pageSetup|pageMargins|printOptions|headerFooter|pageSetUpPr|drawing|tableParts)(?=[\s/>])|(row)(?=[\s/>])[^>]*\s(?:collapsed|customFormat|customHeight|hidden|ht|outlineLevel|thickBot|thickTop)\s*=|(c)(?=[\s/>])[^>]*\ss\s*=)/g;
+        const WORKSHEET_SCAN_PATTERN = /<(?:[A-Za-z_][\w.-]*:)?(?:(cols|f|pane|dataValidation|conditionalFormatting|sheetProtection|protectedRange|rowBreaks|colBreaks|pageSetup|pageMargins|printOptions|headerFooter|pageSetUpPr|drawing|tableParts)(?=[\s/>])|(row)(?=[\s/>])[^>]*\s(?:collapsed|customFormat|customHeight|hidden|ht|outlineLevel|thickBot|thickTop)\s*=|(c)(?=[\s/>])[^>]*\ss\s*=|(r)(?=[\s/>]))/g;
         function scanXlsxWorksheetXml(source) {
             let hasDirectCellStyles = false;
             let hasDiagnosticFeatures = false;
             let hasFormulaFeatures = false;
             let hasImportedFeatures = false;
+            let hasRichTextCells = false;
             let requiresSheetJsCellStyles = false;
             WORKSHEET_SCAN_PATTERN.lastIndex = 0;
             for(let match = WORKSHEET_SCAN_PATTERN.exec(source); match;){
                 const element = match[1];
                 if (match[3]) hasDirectCellStyles = true;
+                if (match[4]) hasRichTextCells = true;
                 if (match[2] || match[3] || 'cols' === element) requiresSheetJsCellStyles = true;
                 if ('f' === element) hasFormulaFeatures = true;
                 if (element && IMPORTED_WORKSHEET_ELEMENTS.has(element)) hasImportedFeatures = true;
                 if (element && DIAGNOSTIC_WORKSHEET_ELEMENTS.has(element)) hasDiagnosticFeatures = true;
-                if (hasDirectCellStyles && hasDiagnosticFeatures && hasFormulaFeatures && hasImportedFeatures && requiresSheetJsCellStyles) break;
+                if (hasDirectCellStyles && hasDiagnosticFeatures && hasFormulaFeatures && hasImportedFeatures && hasRichTextCells && requiresSheetJsCellStyles) break;
                 match = WORKSHEET_SCAN_PATTERN.exec(source);
             }
             WORKSHEET_SCAN_PATTERN.lastIndex = 0;
@@ -4036,6 +4038,7 @@ https://github.com/nodeca/pako/blob/main/LICENSE
                 hasDiagnosticFeatures,
                 hasFormulaFeatures,
                 hasImportedFeatures,
+                hasRichTextCells,
                 requiresSheetJsCellStyles
             };
         }
@@ -4131,6 +4134,7 @@ https://github.com/nodeca/pako/blob/main/LICENSE
             hasDiagnosticFeatures: false,
             hasFormulaFeatures: false,
             hasImportedFeatures: false,
+            hasRichTextCells: false,
             requiresSheetJsCellStyles: false
         };
         async function plainWorkbookPlan(zip, packagePaths) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -95,6 +95,7 @@
     "playground:visual:spreadsheet-font-colors-shortcuts": "playwright test visual-tests/spreadsheet-font-colors-shortcuts.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-hyperlink": "playwright test visual-tests/spreadsheet-hyperlink.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-ribbon": "playwright test visual-tests/spreadsheet-ribbon.functional.spec.ts --config playwright.config.ts",
+    "playground:visual:spreadsheet-rich-text": "playwright test visual-tests/spreadsheet-rich-text.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-underline": "playwright test visual-tests/spreadsheet-underline.functional.spec.ts --config playwright.config.ts",
     "playground:visual:spreadsheet-table": "playwright test visual-tests/spreadsheet-table.functional.spec.ts --config playwright.config.ts",
     "playground:visual:update": "playwright test --config playwright.config.ts --update-snapshots",
@@ -169,6 +170,8 @@
     "test:e2e:spreadsheet-copy-from-above:check": "a3s-test check tests/e2e/spreadsheet-copy-from-above.acl --json",
     "test:e2e:spreadsheet-font-dialog-shortcuts": "A3S_TEST_SUITE=tests/e2e/spreadsheet-font-dialog-shortcuts.acl bash scripts/run-a3s-test-web-gate.sh",
     "test:e2e:spreadsheet-font-dialog-shortcuts:check": "a3s-test check tests/e2e/spreadsheet-font-dialog-shortcuts.acl --json",
+    "test:e2e:spreadsheet-rich-text": "A3S_TEST_SUITE=tests/e2e/spreadsheet-rich-text.acl bash scripts/run-a3s-test-web-gate.sh",
+    "test:e2e:spreadsheet-rich-text:check": "a3s-test check tests/e2e/spreadsheet-rich-text.acl --json",
     "test:e2e:spreadsheet-hyperlink": "a3s-test run tests/e2e/spreadsheet-hyperlink.acl --json",
     "test:e2e:spreadsheet-hyperlink:check": "a3s-test check tests/e2e/spreadsheet-hyperlink.acl --json",
     "test:e2e:spreadsheet-maximum-sparse": "a3s-test run tests/e2e/spreadsheet-maximum-sparse.acl --json",