@a3s-lab/office 0.15.0 → 0.16.0

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

@@ -213,12 +213,112 @@ export interface WorkSpreadsheetDataValidationRange {
     ranges: WorkSpreadsheetCellRange[];
     item: WorkSpreadsheetDataValidationItem;
 }
+export type WorkSpreadsheetTableStyle = {
+    family: 'none';
+} | {
+    family: 'light';
+    number: number;
+} | {
+    family: 'medium';
+    number: number;
+} | {
+    family: 'dark';
+    number: number;
+};
+export interface WorkSpreadsheetTableColumn {
+    name: string;
+}
+export type WorkSpreadsheetDynamicFilter = 'above-average' | 'below-average' | 'tomorrow' | 'today' | 'yesterday' | 'next-week' | 'this-week' | 'last-week' | 'next-month' | 'this-month' | 'last-month' | 'next-quarter' | 'this-quarter' | 'last-quarter' | 'next-year' | 'this-year' | 'last-year' | 'year-to-date' | 'quarter-1' | 'quarter-2' | 'quarter-3' | 'quarter-4' | 'month-1' | 'month-2' | 'month-3' | 'month-4' | 'month-5' | 'month-6' | 'month-7' | 'month-8' | 'month-9' | 'month-10' | 'month-11' | 'month-12';
+export type WorkSpreadsheetTableFilterCriteria = {
+    type: 'values';
+    values: string[];
+    includeBlanks: boolean;
+} | {
+    type: 'equals';
+    value: string;
+} | {
+    type: 'not-equals';
+    value: string;
+} | {
+    type: 'contains';
+    value: string;
+} | {
+    type: 'does-not-contain';
+    value: string;
+} | {
+    type: 'begins-with';
+    value: string;
+} | {
+    type: 'ends-with';
+    value: string;
+} | {
+    type: 'greater-than';
+    value: string;
+} | {
+    type: 'greater-than-or-equal';
+    value: string;
+} | {
+    type: 'less-than';
+    value: string;
+} | {
+    type: 'less-than-or-equal';
+    value: string;
+} | {
+    type: 'between';
+    lower: string;
+    upper: string;
+} | {
+    type: 'not-between';
+    lower: string;
+    upper: string;
+} | {
+    type: 'blanks';
+} | {
+    type: 'non-blanks';
+} | {
+    type: 'top';
+    count: number;
+} | {
+    type: 'top-percent';
+    percent: number;
+} | {
+    type: 'bottom';
+    count: number;
+} | {
+    type: 'bottom-percent';
+    percent: number;
+} | {
+    type: 'dynamic';
+    kind: WorkSpreadsheetDynamicFilter;
+};
+export interface WorkSpreadsheetTableFilter {
+    column: number;
+    criteria: WorkSpreadsheetTableFilterCriteria;
+}
+export interface WorkSpreadsheetTable {
+    /** Stable browser-model identity. OOXML numeric identity is kept separately. */
+    id: string;
+    ooxmlId?: number;
+    name: string;
+    displayName?: string;
+    range: WorkSpreadsheetCellRange;
+    columns: WorkSpreadsheetTableColumn[];
+    filters: WorkSpreadsheetTableFilter[];
+    headerRow: boolean;
+    totalsRow: boolean;
+    style: WorkSpreadsheetTableStyle;
+    showFirstColumn: boolean;
+    showLastColumn: boolean;
+    showRowStripes: boolean;
+    showColumnStripes: boolean;
+}
 export type WorkSpreadsheetSheet = Omit<Sheet, 'images'> & {
     images?: WorkSpreadsheetImage[];
     charts?: WorkSpreadsheetChart[];
     pivotTables?: WorkSpreadsheetPivotTable[];
     formulaMetadata?: WorkSpreadsheetFormulaMetadata;
     dataValidationRanges?: WorkSpreadsheetDataValidationRange[];
+    tables?: WorkSpreadsheetTable[];
 };
 export type WorkSpreadsheetPivotAggregation = 'sum' | 'count' | 'counta' | 'average' | 'max' | 'min' | 'product' | 'stdDev' | 'stdDevP' | 'var' | 'varP';
 export interface WorkSpreadsheetPivotValue {

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 { WorkSpreadsheetTable } from './work-types';
 type FrozenPane = NonNullable<Sheet['frozen']>;
 export interface XlsxDataValidation {
     references: string[];
@@ -24,6 +25,7 @@ export interface XlsxSheetFeatures {
     pageSetup?: XlsxPageSetup;
     images: XlsxWorksheetImage[];
     charts: XlsxWorksheetChart[];
+    tables: WorkSpreadsheetTable[];
 }
 export type FortuneDataValidationItem = WorkSpreadsheetDataValidationItem;
 export declare function readXlsxSheetFeatures(buffer: ArrayBuffer): Promise<Map<string, XlsxSheetFeatures>>;

package/dist/internal/features/work/work-xlsx-table-filters.d.ts

@@ -0,0 +1,3 @@
+import type { WorkSpreadsheetTableFilter } from './work-types';
+export declare function readXlsxTableFilters(table: Document, width: number): WorkSpreadsheetTableFilter[];
+export declare function xlsxTableAutoFilterXml(filters: readonly WorkSpreadsheetTableFilter[], rangeReference: string, totalsRow: boolean): string;

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

@@ -0,0 +1,4 @@
+import { OoxmlPackage } from './work-ooxml-package';
+import type { WorkSpreadsheetContent, WorkSpreadsheetTable } from './work-types';
+export declare function readXlsxWorksheetTables(archive: OoxmlPackage, worksheetPart: string): Promise<WorkSpreadsheetTable[]>;
+export declare function patchXlsxSpreadsheetTables(buffer: ArrayBuffer, content: WorkSpreadsheetContent): Promise<ArrayBuffer>;

package/dist/styles.css

@@ -16436,6 +16436,195 @@ button.work-office-collaboration-participant:hover .work-office-collaboration-lo
   }
 }
 
+.work-spreadsheet-table-dialog {
+  --work-office-control-accent: var(--work-spreadsheet-accent, #159469);
+  width: min(480px, 100%);
+}
+
+.work-spreadsheet-table-dialog form {
+  gap: 16px;
+  display: grid;
+}
+
+.work-spreadsheet-table-scope {
+  background: var(--a3s-panel-soft);
+  border-radius: 8px;
+  grid-template-columns: 34px minmax(0, 1fr);
+  align-items: center;
+  gap: 10px;
+  padding: 10px 12px;
+  display: grid;
+}
+
+.work-spreadsheet-table-scope > span {
+  background: color-mix(in srgb,
+    var(--work-spreadsheet-accent, #159469) 11%,
+    var(--a3s-panel));
+  width: 34px;
+  height: 34px;
+  color: var(--work-spreadsheet-accent, #159469);
+  border-radius: 7px;
+  place-items: center;
+  display: grid;
+}
+
+.work-spreadsheet-table-scope > div {
+  gap: 2px;
+  min-width: 0;
+  display: grid;
+}
+
+.work-spreadsheet-table-scope strong, .work-spreadsheet-table-scope small {
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  overflow: hidden;
+}
+
+.work-spreadsheet-table-scope strong {
+  color: var(--a3s-ink);
+  font-size: 12px;
+  font-weight: 650;
+}
+
+.work-spreadsheet-table-scope small {
+  color: var(--a3s-muted);
+  font-size: 10px;
+}
+
+.work-spreadsheet-table-dialog .work-office-checkbox {
+  min-height: 38px;
+  padding: 8px 10px;
+}
+
+.work-spreadsheet-table-name {
+  align-content: center;
+  gap: 3px;
+  width: 132px;
+  padding: 2px 5px;
+  display: grid;
+}
+
+.work-spreadsheet-table-name > span {
+  color: var(--a3s-muted);
+  font-size: 9px;
+  line-height: 1;
+}
+
+.work-spreadsheet-table-name > input {
+  border: 1px solid var(--a3s-line-strong);
+  background: var(--a3s-panel);
+  width: 100%;
+  height: 27px;
+  color: var(--a3s-ink);
+  border-radius: 5px;
+  padding: 0 8px;
+  font-size: 11px;
+}
+
+.work-spreadsheet-table-style-root {
+  display: flex;
+}
+
+.work-office-ribbon .work-spreadsheet-table-style-trigger {
+  min-width: 76px;
+}
+
+.work-spreadsheet-table-style-preview {
+  background: #fff;
+  border: 1px solid #0f172a29;
+  border-radius: 3px;
+  grid-template-rows: 8px 1fr 1fr;
+  width: 48px;
+  height: 28px;
+  display: grid;
+  overflow: hidden;
+}
+
+.work-spreadsheet-table-style-preview > i {
+  min-height: 0;
+  display: block;
+}
+
+.work-spreadsheet-table-style-menu {
+  border: 1px solid var(--a3s-overlay-border);
+  border-radius: var(--a3s-overlay-radius);
+  background: var(--a3s-overlay-surface);
+  width: min(464px, 100vw - 24px);
+  max-height: min(520px, 100vh - 32px);
+  box-shadow: var(--a3s-shadow-soft);
+  padding: 10px;
+  overflow: auto;
+}
+
+.work-spreadsheet-table-style-family {
+  border: 0;
+  gap: 6px;
+  min-inline-size: 0;
+  margin: 0;
+  padding: 0;
+  display: grid;
+}
+
+.work-spreadsheet-table-style-family + .work-spreadsheet-table-style-family {
+  border-top: 1px solid var(--a3s-line);
+  margin-top: 10px;
+  padding-top: 9px;
+}
+
+.work-spreadsheet-table-style-family > span {
+  color: var(--a3s-muted);
+  font-size: 10px;
+  font-weight: 650;
+}
+
+.work-spreadsheet-table-style-family > div {
+  grid-template-columns: repeat(7, minmax(0, 1fr));
+  gap: 4px;
+  display: grid;
+}
+
+.work-spreadsheet-table-style-family button {
+  cursor: pointer;
+  background: none;
+  border: 1px solid #0000;
+  border-radius: 5px;
+  place-items: center;
+  min-width: 0;
+  height: 38px;
+  padding: 4px;
+  display: grid;
+}
+
+.work-spreadsheet-table-style-family button:hover, .work-spreadsheet-table-style-family button:focus-visible, .work-spreadsheet-table-style-family button[aria-checked="true"] {
+  border-color: color-mix(in srgb,
+    var(--work-spreadsheet-accent, #159469) 46%,
+    var(--a3s-line));
+  background: color-mix(in srgb,
+    var(--work-spreadsheet-accent, #159469) 8%,
+    var(--a3s-panel));
+}
+
+.work-spreadsheet-table-style-family button:focus-visible {
+  outline: 2px solid
+    color-mix(in srgb, var(--work-spreadsheet-accent, #159469) 66%, white);
+  outline-offset: 1px;
+}
+
+@media (width <= 620px) {
+  .work-spreadsheet-table-name {
+    width: 104px;
+  }
+
+  .work-spreadsheet-table-style-menu {
+    width: min(356px, 100vw - 16px);
+    padding: 8px;
+  }
+
+  .work-spreadsheet-table-style-family > div {
+    grid-template-columns: repeat(5, minmax(0, 1fr));
+  }
+}
+
 .work-spreadsheet-chart-manager {
   border: 0;
   grid-template-columns: minmax(180px, 230px) minmax(720px, 1fr);

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

@@ -3996,7 +3996,8 @@ https://github.com/nodeca/pako/blob/main/LICENSE
             'printOptions',
             'headerFooter',
             'pageSetUpPr',
-            'drawing'
+            'drawing',
+            'tableParts'
         ]);
         const DIAGNOSTIC_WORKSHEET_ELEMENTS = new Set([
             'conditionalFormatting',
@@ -4011,7 +4012,7 @@ 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)(?=[\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*=)/g;
         function scanXlsxWorksheetXml(source) {
             let hasDirectCellStyles = false;
             let hasDiagnosticFeatures = false;

package/docs/latest/en/browser-editor-architecture.md

@@ -304,6 +304,21 @@ focus restoration.
 | Presentation | Scene canvas with ordered typed multi-selection, persistent nested browser groups, native PPTX group-node export, exact keyboard-accessible table-dimension insertion, native slide/object context actions with optional AI actions, a separate object/content editing state, one on-demand TipTap instance, collective move/scale/nudge/clipboard/delete/layer commands, selection-bound alignment and distribution, typed group/ungroup commands, one typed dispatcher for ribbon commands, editor-scoped shortcuts with post-command selection focus, direct beginning/current-slide playback with fullscreen fallback, frame-coalesced transactional move/resize previews that commit once on pointer release, two-level thumbnail node and scene windowing, and a phone stage that top-aligns the primary canvas while retaining one readable slide indicator beside view and zoom controls | Revisioned, cancellable Worker/Rust-WASM slide-relative alignment and object-set snapping with typed visual guides and a JavaScript fallback | Arbitrary rotated or reflected PPTX group transforms, connectors, theme resolution, text fitting, kernel-owned thumbnail layout, and slide serialization |
 | PDF | PDFium-backed page rendering with an A3S-owned responsive toolbar, a scrollable page-thumbnail rail with active-page synchronization and bounded bitmap/DOM windowing, a focus-contained phone page drawer, and typed capability controllers for navigation, zoom, search, basic annotations, annotation color, opacity, compatible stroke-width defaults and selection updates, history, and save; page and search drafts cancel without accidental commands, shortcuts remain scoped to the PDF root, and compact widths retain page status while exposing search-result traversal, navigation, zoom, and history through the keyboard-operated overflow menu | PDFium WebAssembly | Forms, redaction review, page organization, and reopen fixtures |
 
+Spreadsheet Tables/ListObjects remain part of the controlled workbook model,
+not a formatting sidecar. The active cell selects the contextual Table Design
+ribbon; creation, design, structure reconciliation, conversion, collaboration,
+and XLSX import/export all read the same stable ID, range, column, filter, and
+style record. Table presentation is resolved inside Fortune's existing
+visible-cell Canvas callbacks. A row-cached resolver inspects only tables that
+can intersect the cell being painted, and conditional formatting remains the
+higher-priority visual layer. Ordinary style changes therefore do not stamp or
+allocate cells. Convert to Range is the deliberate boundary where the selected
+appearance becomes native cell fills, emphasis, and borders; a bounded
+footprint check switches large matrix projections to sparse `celldata` before
+materialization. Fortune row/column operations are reconciled back into table
+ranges, column identities, filter offsets, and canonical header cells, while
+merge and worksheet AutoFilter commands reject intersecting ownership.
+
 The table is a fidelity statement, not a marketing capability list. The
 current Document path shapes text-flow paragraphs in Rust/WASM when every
 explicit CSS family resolves to an exact registered face. Each run may carry up
@@ -391,6 +406,16 @@ scroll range. A cumulative geometry index and binary search map the viewport
 to its exact leaves. `Ctrl+Home`, `Ctrl+End`, and the macOS equivalents operate
 on model positions first and never depend on mounted DOM.
 
+CSS `content-visibility: auto` is not the production long-document boundary.
+It can skip browser layout and paint for an off-screen subtree, but the
+ProseMirror nodes, descendant DOM, JavaScript projection work, mutation and
+selection bookkeeping, and accessibility tree still exist. The production
+NodeView window instead omits descendant DOM and page-sheet DOM while retaining
+model-authoritative positions, indexed geometry, and semantic previews only
+for the visible leaves. `content-visibility` remains useful as a measured
+benchmark mode where a surface owns ordinary DOM, but it cannot replace model
+windowing or visible-range Canvas painting.
+
 Pagination reads the canonical JSON payloads of lazy chunks without hydrating
 them into ProseMirror. A text edit reuses the measured block and page prefix
 before the first changed position, locates the current page with a binary
@@ -1228,6 +1253,16 @@ is still Fortune Sheet. The A3S-owned virtual viewport, moving initial and
 replacement projection off the main thread, complete formula semantics, kernel
 number formatting, and print pagination remain open work in this stage.
 
+The native table slice is also implemented at this stage. Insert Table creates
+one bounded semantic ListObject, the contextual design surface selects among
+60 built-in OOXML styles, visible cells receive render-time Canvas styling,
+row/column operations reconcile table structure, and Convert to Range
+materializes appearance through a sparse-safe path. XLSX table parts,
+relationships, content types, styles, and supported filters round-trip, while
+Yjs uses ordered ID-keyed records and creation claims for two-client
+convergence. Structured-reference calculation, calculated columns, complete
+totals authoring, slicers, and external/query tables remain open gates.
+
 Exit criteria: scrolling and selection do not scale with total row count;
 incremental recalculation touches only affected dependency subgraphs; XLSX
 fixtures preserve formulas, styles, names, validation, conditional formatting,
@@ -1421,6 +1456,14 @@ runner polling backoff is therefore excluded from the load time.
 | DOCX table, 100,000 rows × 3 columns | 0.813 s (0.810–0.814) | 1.747 s (1.739–1.749), 2,381 pages | 96 ms (88–144) |
 | XLSX table, 100,000 rows × 10 columns, 1 million populated cells | 0.480 s (0.474–0.494) | n/a | No task ≥50 ms in any of five runs |
 
+The XLSX row above is a rectangular one-million-cell data fixture, not a
+semantic `WorkSpreadsheetTable`/OOXML ListObject benchmark. It proves the
+plain-workbook import and visible-range Canvas path; it must not be used to
+claim that structured-reference calculation, calculated columns, totals,
+filters, or table conversion have the same profile. A dedicated large
+ListObject matrix remains required before publishing table-specific load,
+mutation, conversion, and export budgets.
+
 The median text phases were 121.6 ms for the complete import, 76.1 ms inside
 the Worker, and 56.6 ms for Worker parsing. The table phases were 462.6 ms,
 377.6 ms, and 311.6 ms respectively; the already mounted editor applied that

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -90,6 +90,7 @@
     "playground:visual:spreadsheet-data-validation": "playwright test visual-tests/spreadsheet-data-validation.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-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",
     "performance:fixtures": "bun .a3s-test/performance/generate-fixtures.ts",
     "performance:large-document-edits": "bun .a3s-test/performance/generate-fixtures.ts --documents-only && bun .a3s-test/performance/benchmark-document-edit.ts http://127.0.0.1:4175/ 3",
@@ -134,6 +135,8 @@
     "test:e2e:spreadsheet-ribbon:check": "a3s-test check tests/e2e/spreadsheet-ribbon-alignment.acl --json",
     "test:e2e:spreadsheet-cell-style": "a3s-test run tests/e2e/spreadsheet-cell-style.acl --json",
     "test:e2e:spreadsheet-cell-style:check": "a3s-test check tests/e2e/spreadsheet-cell-style.acl --json",
+    "test:e2e:spreadsheet-table": "a3s-test run tests/e2e/spreadsheet-table.acl --json",
+    "test:e2e:spreadsheet-table:check": "a3s-test check tests/e2e/spreadsheet-table.acl --json",
     "test:e2e:spreadsheet-cell-fill": "a3s-test run tests/e2e/spreadsheet-cell-fill.acl --json",
     "test:e2e:spreadsheet-cell-fill:check": "a3s-test check tests/e2e/spreadsheet-cell-fill.acl --json",
     "test:e2e:spreadsheet-auto-sum": "a3s-test run tests/e2e/spreadsheet-auto-sum.acl --json",