@a3s-lab/office 0.14.0 → 0.16.0

package/COLLABORATION_ROADMAP.md

@@ -271,9 +271,10 @@ comments, and delete-vs-edit cases converge and survive PPTX round trips.
 
 ### Phase 4: Spreadsheet
 
-Status: browser collaboration foundation plus native conflict-local single-cell
-and atomic batch-cell mutations implemented; structural operations, native
-recalculation parity, and XLSX concurrency coverage are pending.
+Status: browser collaboration foundation, ordered ID-keyed native table
+records, and native conflict-local single-cell plus atomic batch-cell mutations
+implemented; broader structural operations, native recalculation parity, and
+XLSX concurrency coverage are pending.
 
 - Stable sheet/named-range order arrays, ID-keyed records, and append-only
   creation claims avoid a serialized workbook or dense worksheet root.
@@ -285,6 +286,12 @@ recalculation parity, and XLSX concurrency coverage are pending.
   and dynamic-array metadata leaves do not replace their containing object.
 - Images, charts, pivot tables, defined names, calculation settings, print
   areas/titles, page breaks, and page setup have conflict-local typed roots.
+- Native Tables/ListObjects use a per-sheet ID-keyed record map plus an explicit
+  order array. Immutable parent-scoped creation claims prevent ID reuse;
+  recursively patched name, range, column, filter, style, header/totals, and
+  stripe fields let independent browser design edits converge. Shared-input
+  validation rejects duplicate table/defined names, overlaps, invalid styles,
+  malformed columns or filters, and out-of-sheet ranges before projection.
 - Snapshot writes are translated into `previous -> next` patches. Unrelated
   stale snapshots preserve remote cells and records; a delete that would
   discard a remote edit fails closed and asks the caller to refresh.
@@ -316,8 +323,11 @@ recalculation parity, and XLSX concurrency coverage are pending.
 
 Remaining:
 
-- Add stable structural operations and reference transforms for row/column
-  insertion/deletion, merged ranges, tables, sort, and named references.
+- Add native typed structural operations and reference transforms for
+  row/column insertion/deletion, merged ranges, sort, and named references;
+  bridge the existing native table add/set/remove file mutations into the
+  browser-convergent table records, then add collaboration-aware conversion,
+  calculated-column, totals, and structured-reference operations.
 - Treat calculated values as derived once browser and native recalculation are
   deterministic and source formulas remain the only canonical formula state.
 - Add offline/reordered-update property tests plus merged XLSX export/reopen.

package/README.md

@@ -192,6 +192,9 @@ through the CLI, standard MCP server, or A3S Code.
 The host owns rooms, authentication, authorization, network delivery, offline
 buffering, persistence, and the `Y.Doc`; A3S Office owns format-specific
 bindings, local undo, validated presence, and conflict-local typed mutations.
+Spreadsheet table state uses ordered, ID-keyed records with creation claims;
+independent table name, style, stripe, column, and filter fields can converge
+without replacing a serialized worksheet.
 An authenticated Document `comment` session can select text, create a durable
 thread, reply, resolve or reopen it, and delete only review records owned by
 its actor while canonical content remains read-only. The server independently
@@ -534,7 +537,26 @@ interaction model.
   modes, arithmetic operations, Skip blanks, Transpose, translated formula
   references, rich same-editor styles/comments/validation/merges/column widths,
   bounded TSV fallback, one-step Undo, and fail-closed protected or unsafe
-  targets, a WPS-style Format Painter with single-use and double-click locked
+  targets, an Insert and Links Hyperlink command with grid-scoped `Cmd/Ctrl+K`,
+  accessible Web page, cell-range, and worksheet targets, explicit Edit and
+  Remove, immutable dense/sparse updates, content/style/comment preservation,
+  exact focus restoration, one-step Undo, and fail-closed unsafe, hidden,
+  protected, pivot, or out-of-bounds targets, a Data and Data Tools Validation
+  command for lists, whole numbers, decimals, dates, and text length across
+  multiple ranges, compact rule writes and removal, input messages,
+  invalid-input blocking, 1900/1904-aware XLSX date round trips, exact focus
+  restoration, one-step Undo, and fail-closed protected, merged, pivot,
+  read-only, invalid, out-of-bounds, or over-10,000-cell targets, native
+  Spreadsheet Tables/ListObjects through Insert and grid-scoped `Cmd/Ctrl+T`,
+  bounded current-region or explicit-range creation, canonical unique headers,
+  a contextual Table Design ribbon with editable names, 60 OOXML
+  Light/Medium/Dark styles, first/last-column emphasis and row/column stripes,
+  visible-range Canvas styling, sparse-safe Convert to Range, row/column
+  reconciliation, native XLSX table parts and supported filters, one-step Undo,
+  browser/Yjs record convergence, and fail-closed overlap, merge, AutoFilter,
+  protection, pivot, invalid, or over-100,000-cell targets, a WPS-style
+  Format Painter with
+  single-use and double-click locked
   sessions, cross-sheet range-pattern tiling, Escape cancellation, and native
   style-only writes, a Home and Font cell-border split control with side, all,
   outside, inside, horizontal, vertical, clear, and diagonal targets, ten
@@ -723,6 +745,15 @@ Protection ranges, passwordless editable ranges, and conditional formatting
 also remain compact and round-trip through native XLSX records without
 allocating every covered cell.
 
+Worksheet Tables/ListObjects live in `sheet.tables` as semantic records with
+stable IDs, workbook-unique names, zero-based ranges, ordered columns, filters,
+header/totals flags, and built-in style identity. XLSX import and export keep
+native table parts and relationships. Table styling is resolved only for the
+visible Canvas cells; converting a table to a range materializes the confirmed
+appearance without densifying unrelated worksheet space. Structured-reference
+calculation, calculated columns, complete totals authoring, slicers, and
+external/query tables are not yet claimed.
+
 Use `downloadArtifact` to start a browser download or
 `createArtifactBlob` when your application owns upload and persistence.
 Imported DOCX artifacts are source-backed: safe source-only OPC parts,
@@ -1484,6 +1515,8 @@ without hard-coded return URLs.
 
 - [Live Playground](https://a3s-lab.github.io/Office/)
 - [Documentation center](https://a3s-lab.github.io/Office/docs/)
+- [A3S Office 0.16.0 documentation](https://a3s-lab.github.io/Office/docs/0.16.0/)
+- [A3S Office 0.15.0 documentation](https://a3s-lab.github.io/Office/docs/0.15.0/)
 - [A3S Office 0.14.0 documentation](https://a3s-lab.github.io/Office/docs/0.14.0/)
 - [A3S Office 0.13.1 documentation](https://a3s-lab.github.io/Office/docs/0.13.1/)
 - [A3S Office 0.13.0 documentation](https://a3s-lab.github.io/Office/docs/0.13.0/)

package/dist/0~6090.js

@@ -571,17 +571,16 @@ function Popover({ label, panelLabel, trigger, children, disabled = false, class
         portal,
         updateFloatingPosition
     ]);
-    useEffect(()=>{
-        if (!open || !focusFirstOnOpen) return;
-        const frame = requestAnimationFrame(()=>{
-            firstFocusableElement(panelElementRef.current)?.focus({
-                preventScroll: true
-            });
+    const panelReadyForFocus = !portal || null !== floatingPosition;
+    useLayoutEffect(()=>{
+        if (!open || !focusFirstOnOpen || !panelReadyForFocus) return;
+        firstFocusableElement(panelElementRef.current)?.focus({
+            preventScroll: true
         });
-        return ()=>cancelAnimationFrame(frame);
     }, [
         focusFirstOnOpen,
-        open
+        open,
+        panelReadyForFocus
     ]);
     const triggerProps = {
         ref: (element)=>{