@a3s-lab/office 0.35.0 → 0.37.0

package/dist/styles.css

@@ -18364,6 +18364,113 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
   min-width: 76px;
 }
 
+.work-spreadsheet-table-totals-root {
+  display: flex;
+}
+
+.work-office-ribbon .work-spreadsheet-table-totals-trigger {
+  min-width: 70px;
+}
+
+.work-spreadsheet-table-totals-menu {
+  border: 1px solid var(--a3s-overlay-border);
+  border-radius: var(--a3s-overlay-radius);
+  background: var(--a3s-overlay-surface);
+  width: min(560px, 100vw - 24px);
+  max-height: min(650px, 100vh - 32px);
+  box-shadow: var(--a3s-shadow-soft);
+  padding: 14px;
+  overflow: auto;
+}
+
+.work-spreadsheet-table-totals-content {
+  gap: 10px;
+  display: grid;
+}
+
+.work-spreadsheet-table-totals-hint {
+  color: var(--a3s-muted);
+  margin: -4px 0 2px;
+  font-size: 11px;
+  line-height: 1.45;
+}
+
+.work-spreadsheet-table-totals-columns {
+  gap: 8px;
+  max-height: 440px;
+  padding-right: 2px;
+  display: grid;
+  overflow: auto;
+}
+
+.work-spreadsheet-table-totals-column {
+  border: 1px solid var(--a3s-line);
+  background: var(--a3s-panel-soft);
+  border-radius: 7px;
+  grid-template-columns: minmax(92px, 1fr) minmax(100px, 1fr) minmax(100px, 1fr);
+  align-items: end;
+  gap: 7px;
+  padding: 9px;
+  display: grid;
+}
+
+.work-spreadsheet-table-totals-column > strong {
+  color: var(--a3s-ink);
+  text-overflow: ellipsis;
+  white-space: nowrap;
+  grid-column: 1 / -1;
+  font-size: 11px;
+  font-weight: 650;
+  overflow: hidden;
+}
+
+.work-spreadsheet-table-totals-column label {
+  gap: 3px;
+  min-width: 0;
+  display: grid;
+}
+
+.work-spreadsheet-table-totals-column label > span {
+  color: var(--a3s-muted);
+  font-size: 9px;
+  line-height: 1;
+}
+
+.work-spreadsheet-table-totals-column select, .work-spreadsheet-table-totals-column input {
+  box-sizing: border-box;
+  border: 1px solid var(--a3s-line-strong);
+  background: var(--a3s-panel);
+  width: 100%;
+  min-width: 0;
+  height: 28px;
+  color: var(--a3s-ink);
+  border-radius: 5px;
+  padding: 0 7px;
+  font-size: 11px;
+}
+
+.work-spreadsheet-table-totals-column select:disabled, .work-spreadsheet-table-totals-column input:disabled {
+  cursor: not-allowed;
+  opacity: .55;
+}
+
+.work-spreadsheet-table-totals-close {
+  border: 1px solid var(--work-spreadsheet-accent, #159469);
+  background: var(--work-spreadsheet-accent, #159469);
+  color: #fff;
+  cursor: pointer;
+  border-radius: 5px;
+  justify-self: end;
+  min-height: 29px;
+  padding: 0 13px;
+  font-size: 11px;
+  font-weight: 650;
+}
+
+.work-spreadsheet-table-totals-close:hover, .work-spreadsheet-table-totals-close:focus-visible {
+  filter: brightness(.94);
+}
+
 .work-spreadsheet-table-style-preview {
   background: #fff;
   border: 1px solid #0f172a29;
@@ -18455,6 +18562,19 @@ sub [data-office-character-position-half-points], sup [data-office-character-pos
     padding: 8px;
   }
 
+  .work-spreadsheet-table-totals-menu {
+    width: min(440px, 100vw - 16px);
+    padding: 10px;
+  }
+
+  .work-spreadsheet-table-totals-column {
+    grid-template-columns: 1fr 1fr;
+  }
+
+  .work-spreadsheet-table-totals-column label:last-child {
+    grid-column: 1 / -1;
+  }
+
   .work-spreadsheet-table-style-family > div {
     grid-template-columns: repeat(5, minmax(0, 1fr));
   }

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

@@ -603,11 +603,16 @@ tests. Successful scalar results are applied without adding undo history,
 known grouped formulas refresh before their dependents, and unresolved
 dependencies enter an ordered, cell-scoped Fortune Sheet compatibility pass.
 The shared Rust parser handles the same bounded formula grammar in the native
-core and browser kernel. This is not a complete Excel engine: Fortune Sheet
-remains the canonical grid, initial and replacement sparse projection still
-run on the main thread, and the kernel does not materialize whole-row or
-whole-column ranges, calculate arrays, spills, structured references or
-external workbooks, own number formatting, or own print layout.
+core and browser kernel. The current table slice resolves names/display names,
+worksheet-qualified tables, contiguous column ranges, `#All`, `#Headers`,
+`#Data`, `#Totals`, `#This Row`, and table-local `[@Column]` formulas. It is not
+a complete Excel engine: Fortune Sheet remains the canonical grid, initial and
+replacement sparse projection still run on the main thread, and the kernel
+does not materialize whole-row or whole-column ranges, calculate arrays, spills,
+external workbooks, own number formatting, or own print layout. Structured
+areas are capped at 100,000 cells and requests at 1,024 tables; disjoint,
+three-dimensional, missing, or over-budget references fail closed with a
+cell-scoped diagnostic.
 Presentation sends alignment plus move and resize snapping to Rust/WASM. The
 main thread treats an ordered selection as one bounded geometry frame, paints
 at most one transient preview per animation frame, and ignores stale geometry
@@ -1419,8 +1424,20 @@ 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.
+convergence. The follow-up structured-reference slice now shares the parser and
+dependency session with native calculation, including calculated-column
+formulas authored on data rows and totals/header/data selectors. A consistent
+current-row rule is persisted in the table metadata and fills only empty cells
+in newly inserted body rows; manual values and conflicting formulas fail closed.
+Dense and sparse sheet representations use the same path, and native XLSX
+`<calculatedColumnFormula>` metadata round-trips. Native totals-row authoring
+now extends the same model: Table Design controls the row and each column's
+label, aggregate, or custom formula; native aggregates map to filter-aware
+`SUBTOTAL` codes; generated cells are reconciled after direct edits, row/column
+changes, and table renames; and `totalsRowFunction`, `totalsRowLabel`, and
+`totalsRowFormula` survive XLSX and Yjs round trips. Occupied, merged,
+protected, overlapping, AutoFilter, unsafe, external, and over-budget targets
+fail closed. 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
@@ -1642,7 +1659,9 @@ 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
+filters, or table conversion have the same profile. Calculated-column fill is
+bounded by the inserted-row operation and has correctness coverage, but no
+large-ListObject latency or memory number is published yet. A dedicated large
 ListObject matrix remains required before publishing table-specific load,
 mutation, conversion, and export budgets.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@a3s-lab/office",
-  "version": "0.35.0",
+  "version": "0.37.0",
   "description": "Open-source collaborative browser editors for documents, Markdown, spreadsheets, presentations, and PDFs.",
   "keywords": [
     "office",
@@ -114,6 +114,7 @@
     "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:spreadsheet-table-totals": "playwright test visual-tests/spreadsheet-table-totals.functional.spec.ts --config playwright.config.ts",
     "playground:visual:presentation-animation": "playwright test visual-tests/presentation-animation.functional.spec.ts --config playwright.config.ts",
     "playground:visual:pdf-page-organization": "playwright test visual-tests/pdf-page-organization.functional.spec.ts --config playwright.config.ts",
     "playground:visual:update": "playwright test --config playwright.config.ts --update-snapshots",
@@ -178,6 +179,8 @@
     "test:e2e:spreadsheet-underline-styles:check": "a3s-test check tests/e2e/spreadsheet-underline-styles.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-table-totals": "a3s-test run tests/e2e/spreadsheet-table-totals.acl --json",
+    "test:e2e:spreadsheet-table-totals:check": "a3s-test check tests/e2e/spreadsheet-table-totals.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",