@a3s-lab/office 0.10.0 → 0.12.0

package/COLLABORATION_ROADMAP.md

@@ -110,17 +110,17 @@ Redis/NATS fan-out plus a distributed writer/lock policy.
 
 Status: browser collaboration foundation, participant roster, remote
 selection/caret projection, participant navigation, durable review-only
-comment and suggestion modes, character-formatting revisions, immutable
-decision audit, and native text/options/bounded structural
+comment and suggestion modes, character- and paragraph-formatting revisions,
+immutable decision audit, and native text/options/bounded structural
 paragraph/comment/suggestion mutations implemented; rich native mutation
 parity remains pending.
 
 - TipTap is bound to `document.content` through
   `@tiptap/extension-collaboration`; StarterKit undo/redo is disabled and the
   collaboration binding owns local history.
-- Section/page OOXML state, comment anchors, and text or character-formatting
-  tracked-change marks converge in the ProseMirror fragment. Document-level
-  page color, tracking mode,
+- Section/page OOXML state, comment anchors, text tracked-change marks, and
+  character-formatting marks or paragraph-formatting node revisions converge
+  in the ProseMirror fragment. Document-level page color, tracking mode,
   comment threads/replies, and bibliography sources use conflict-local typed
   roots instead of a serialized document blob.
 - React, Vue, and Web Component adapters accept the same initialized session.
@@ -174,6 +174,14 @@ parity remains pending.
   bold, italic, underline, strike, sub/superscript, font, size, color,
   highlight, and grid marks without changing text. Supported DOCX
   `w:rPrChange` records import into the same model and export natively.
+- Paragraph-formatting commands create one shared `paragraph-formatting`
+  identity across every affected paragraph or heading and retain the complete
+  canonical old-property snapshot on each node. Accept keeps current paragraph
+  properties; reject atomically restores alignment, direction, indentation,
+  spacing and line rules, pagination controls, contextual spacing, outline
+  level, tab stops, borders, shading, and collapsed state without changing
+  text. Supported strict or transitional DOCX `w:pPrChange` records use the
+  same model and export natively.
 - Rust, CLI, MCP, and A3S Code expose `document-comment-create`,
   `document-comment-reply`, `document-comment-set-resolved`,
   `document-comment-delete`, `document-suggestion-create`, and
@@ -191,19 +199,21 @@ parity remains pending.
   content, structure, options, non-suggestion formatting, authorship, order,
   claims, anchors, foreign deletion, or foreign suggestion changes fail before
   the durable store changes.
-- Native Yrs validation admits only the bounded formatting-change schema,
-  preserves it across restart and duplicate/reordered delivery, exposes
-  `formatting` in immutable decision projections, and makes `suggest` updates
-  retain existing formatting revisions byte-semantically. Formatting is a
-  Document change kind, not a native insertion/deletion suggestion kind; the
-  current closed `document-suggestion-*` mutations remain text-only.
+- Native Yrs validation admits only the bounded character- and
+  paragraph-formatting schemas, preserves them across restart and
+  duplicate/reordered delivery, exposes `formatting` and
+  `paragraph-formatting` in immutable decision projections, and makes
+  `suggest` updates retain existing formatting revisions byte-semantically.
+  Formatting revisions are Document change kinds, not native
+  insertion/deletion suggestion kinds; the current closed
+  `document-suggestion-*` mutations remain text-only.
 
 Remaining:
 
 - Prove concurrent full-table, list-restructure, section, comment, and revision
   workflows, plus DOCX import/export after merged edits.
 - Expand native convergence from bounded paragraph edits to complete table,
-  list, and section operations, comments, and tracked revisions.
+  list, and section operations, comments, and the remaining tracked revisions.
 
 Exit criterion: two browsers and one native client converge on document
 content and review state; local undo never removes a remote change; a DOCX

package/README.md

@@ -48,9 +48,9 @@ workflows, and a separate Rust automation plane.
   participants and remote locations, plus browser, CLI, MCP, and A3S Code peers.
   Document reviewers can submit attributed insertions, deletions, and
   replacements without directly changing canonical text. Editors can also
-  track character-formatting revisions, accept the new formatting or restore
-  the exact prior marks, and retain either result in the immutable shared
-  decision audit.
+  track character- and paragraph-formatting revisions, accept the new
+  formatting or restore the exact prior marks/properties, and retain either
+  result in the immutable shared decision audit.
 - **Automate deterministically** through the native CLI, standard MCP server,
   or packaged Office Skill.
 
@@ -150,8 +150,9 @@ The images below are committed visual-regression baselines from the real
   Presentation scene-element and z-order, and PDF annotation, form-value, and
   review changes, including attributable Document selection comments, replies,
   text suggestions, and atomic final decisions, retain browser/native actor
-  attribution, validate browser-created formatting revisions and their audit
-  records, and checkpoint without replacing a whole Office file.
+  attribution, validate browser-created character- and paragraph-formatting
+  revisions and their audit records, and checkpoint without replacing a whole
+  Office file.
 
 ## Real-time collaboration
 
@@ -174,13 +175,13 @@ deletions, and replacements while canonical text, structure, formatting,
 options, comments, and other actors' suggestions remain protected. An `edit`
 participant accepts or rejects a proposal and appends the final actor-attributed
 decision to the immutable `document.change-decisions` audit trail. The A3S Boot
-service also persists `edit`-mode character-formatting revisions and validates
-their bounded prior-format snapshot before broadcast. Accept keeps the new
-bold, italic, underline, strike, vertical position, font, size, color, or
-highlight; reject restores the prior direct marks without deleting the text.
-Authenticated `suggest` updates must preserve those formatting revisions and
-cannot rewrite their identity or snapshot. `suggest` on non-Document formats
-remains receive-only.
+service also persists `edit`-mode character- and paragraph-formatting revisions
+and validates their bounded prior-format snapshots before broadcast. Character
+decisions keep or restore direct marks. Paragraph decisions keep or restore
+alignment, direction, indentation, spacing, pagination, outline, tab stops,
+borders, shading, and collapsed state without deleting text. Authenticated
+`suggest` updates must preserve both revision kinds and cannot rewrite their
+identity or snapshot. `suggest` on non-Document formats remains receive-only.
 See the bilingual [real-time collaboration guide](https://a3s-lab.github.io/Office/docs/components/collaboration.html)
 for React, Vue, Web Component, reconnect, security, and native-agent setup.
 The repository also ships a runnable
@@ -203,8 +204,9 @@ bun run playground
 
 Then open the local URL printed by the development server. For a zero-install
 tour, use the [live Playground](https://a3s-lab.github.io/Office/).
-Choose **体验格式修订**, open **审阅**, then **查看修订（1）** to inspect the
-Formatting card and exercise accept or reject semantics.
+Choose **体验格式修订**, open **审阅**, then **查看修订（2）** to inspect the
+independent Formatting and Paragraph Formatting cards and exercise accept or
+reject semantics.
 
 ### Embed a controlled React editor
 
@@ -576,11 +578,32 @@ import {
   importOfficeFile,
 } from '@a3s-lab/office/core';
 
-const imported = await importOfficeFile(file);
+const controller = new AbortController();
+const imported = await importOfficeFile(file, {
+  signal: controller.signal,
+  onProgress: ({ stage, progress }) => {
+    console.info(stage, `${Math.round(progress * 100)}%`);
+  },
+});
 const output = await createArtifactBlob(imported);
 const blankDeck = createArtifact('blank-presentation');
 ```
 
+Import progress advances monotonically through `reading`, `parsing`,
+`analyzing`, and `finalizing`. Calling `controller.abort()` rejects with an
+`AbortError`; large reads and parser checkpoints yield so a host can keep the
+progress and Cancel controls responsive.
+
+Spreadsheet import and export preserve sparse worksheets up to the XLSX limit
+of 1,048,576 rows by 16,384 columns. The logical `data.length`, `row`, and
+`column` dimensions can be large while only populated indexes are materialized.
+Virtual scrolling never emits `onChange`, and editing a far blank row creates
+only that row. Data-validation regions remain compact in
+`dataValidationRanges`; direct `dataVerification` entries take precedence.
+Protection ranges, passwordless editable ranges, and conditional formatting
+also remain compact and round-trip through native XLSX records without
+allocating every covered cell.
+
 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,
@@ -1336,6 +1359,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.12.0 documentation](https://a3s-lab.github.io/Office/docs/0.12.0/)
+- [A3S Office 0.11.0 documentation](https://a3s-lab.github.io/Office/docs/0.11.0/)
 - [A3S Office 0.10.0 documentation](https://a3s-lab.github.io/Office/docs/0.10.0/)
 - [A3S Office 0.9.2 documentation](https://a3s-lab.github.io/Office/docs/0.9.2/)
 - [A3S Office 0.9.1 documentation](https://a3s-lab.github.io/Office/docs/0.9.1/)