@a3s-lab/office 0.9.2 → 0.11.0

package/COLLABORATION_ROADMAP.md

@@ -110,14 +110,16 @@ 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, immutable suggestion-decision audit, and native
-text/options/bounded structural paragraph/comment/suggestion mutations
-implemented; rich native mutation parity remains pending.
+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 tracked-change marks converge
+- 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.
@@ -166,6 +168,20 @@ implemented; rich native mutation parity remains pending.
   converge, a second conflicting final decision fails closed, old Documents
   without the additive roots remain readable, and a final decision clears
   local history that could otherwise resurrect the decided mark.
+- Character-formatting commands over existing text create one `formatting`
+  change mark with a bounded prior-direct-mark snapshot. Accept removes only
+  the revision wrapper and keeps the new formatting; reject restores the prior
+  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
@@ -183,13 +199,21 @@ implemented; rich native mutation 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 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

@@ -47,8 +47,10 @@ workflows, and a separate Rust automation plane.
 - **Collaborate across every editor** with shared Yjs/Yrs content, Awareness
   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 accept or
-  reject each proposal with an immutable shared decision record.
+  replacements without directly changing canonical text. Editors can also
+  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.
 
@@ -148,7 +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, 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
 
@@ -171,9 +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 validates both comment and suggestion semantics under the durable room
-lock before it persists or broadcasts caller-supplied Yjs bytes. `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
@@ -196,6 +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 **查看修订（2）** to inspect the
+independent Formatting and Paragraph Formatting cards and exercise accept or
+reject semantics.
 
 ### Embed a controlled React editor
 
@@ -1327,6 +1338,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.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/)
 - [A3S Office 0.9.0 documentation](https://a3s-lab.github.io/Office/docs/0.9.0/)