feat(docx-io): add tracked changes and comments import/export by arthrod · Pull Request #4836 · udecode/plate

arthrod · 2026-02-08T22:36:21Z

Add full round-trip support for DOCX tracked changes (suggestions) and comments with threading. This enables import/export of Word documents while preserving revision history and comment discussions.

Import pipeline:

Custom mammoth.js fork emits [[DOCX_*:...]] tokens for ins/del/comments
importTrackChanges.ts parses tokens, applies suggestion marks
importComments.ts parses comment tokens, creates discussion structures
importDocx.ts orchestrates full pipeline with token cleanup
searchRange.ts provides text-based range finding for token placement

Export pipeline:

exportTrackChanges.ts injects tracking tokens into serialized HTML
exportComments.ts handles comment-specific OOXML generation
html-to-docx enhanced with comments.xml, commentsExtended.xml, commentsIds.xml, commentsExtensible.xml, and people.xml generation
Proper paraId threading for reply chains

App integration:

import-toolbar-button.tsx: full DOCX import with user registration
export-toolbar-button.tsx: export with discussions and suggestions
suggestion-node-docx.tsx: DOCX-safe suggestion rendering (no ins/del)
discussion-kit.tsx: paraId fields for round-trip fidelity
docx-export-kit.tsx: SuggestionLeafDocx override for clean export

Key features:

Suggestion authorship preserved through round-trip
Comment threading via paraId/parentParaId linking
UTC date handling for cross-timezone compatibility
Overlapping comment ranges supported
ImportedUser type for user store registration

Checklist

Add full round-trip support for DOCX tracked changes (suggestions) and comments with threading. This enables import/export of Word documents while preserving revision history and comment discussions. Import pipeline: - Custom mammoth.js fork emits [[DOCX_*:...]] tokens for ins/del/comments - importTrackChanges.ts parses tokens, applies suggestion marks - importComments.ts parses comment tokens, creates discussion structures - importDocx.ts orchestrates full pipeline with token cleanup - searchRange.ts provides text-based range finding for token placement Export pipeline: - exportTrackChanges.ts injects tracking tokens into serialized HTML - exportComments.ts handles comment-specific OOXML generation - html-to-docx enhanced with comments.xml, commentsExtended.xml, commentsIds.xml, commentsExtensible.xml, and people.xml generation - Proper paraId threading for reply chains App integration: - import-toolbar-button.tsx: full DOCX import with user registration - export-toolbar-button.tsx: export with discussions and suggestions - suggestion-node-docx.tsx: DOCX-safe suggestion rendering (no ins/del) - discussion-kit.tsx: paraId fields for round-trip fidelity - docx-export-kit.tsx: SuggestionLeafDocx override for clean export Key features: - Suggestion authorship preserved through round-trip - Comment threading via paraId/parentParaId linking - UTC date handling for cross-timezone compatibility - Overlapping comment ranges supported - ImportedUser type for user store registration

codesandbox · 2026-02-08T22:36:24Z

Review or Edit in CodeSandbox

Open the branch in Web Editor • VS Code • Insiders

Open Preview

changeset-bot · 2026-02-08T22:36:25Z

⚠️ No Changeset found

Latest commit: 28ac47f

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

vercel · 2026-02-08T22:36:27Z

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Actions	Updated (UTC)
plate	Ignored		May 19, 2026 9:36pm

…oth.js - Remove redundant biome suppression comment in roundtrip.spec.tsx - Use literal key instead of computed expression in export-comment-ids.spec.ts - Exclude vendored mammoth.js directory from biome linting https://claude.ai/code/session_016HSa8FaK9T51SfKE9TvZX4

fix(docx-io): fix lint errors in test files and exclude vendored mamm…

- Fix roundtrip test: replace registry imports with Base* plugins, resolve mammoth fixtures from npm package, add render.as config for table/link plugins to enable proper HTML serialization - Fix export-replies test: update date expectations to match normalizeDate output format (no milliseconds) - Fix lists test: unskip and update expected output to match BaseListPlugin indent-based flat paragraph behavior - Fix testDocxImporter: rewrite to use Base* plugins instead of React plugin variants that required unavailable packages - Add missing devDependencies for test plugins - Fix type error: use any[] for editorPlugins array in tests All 300 tests pass, 0 failures, 0 skipped. https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Removed the 'generate_from_rules' setting from skills.

Removed 'mammoth' dependency from package.json.

https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

Removes ~700MB of downloads (puppeteer ~500MB Chromium, playwright ~200MB). These caused OOM during CI builds. Scripts now print install instructions instead of failing silently. https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

- Fix DocxExportPlugin import in DocxIOPlugin.spec.tsx (not re-exported from DocxIOPlugin) - Fix SlatePlugin[] type incompatibility in roundtrip.spec.tsx - Add @playwright/test as devDep to @platejs/playwright (was only peerDep, needed for typecheck after removing from root) - Fix biome lint error (template literal) https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

Skiller moved .claude/rules/ to .claude/skills/ and added SKILL.md metadata files. Also includes external spec file updates. https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

…yarn-7f4e323a06 Bump the npm_and_yarn group across 4 directories with 18 updates

…sfy useThrowOnlyError lint rule https://claude.ai/code/session_01V5zGakMe6vBHVZEAinNrsC

tests(docx-io): throw Error objects in applyDocxTracking.spec to sati…

chatgpt-codex-connector · 2026-02-24T22:30:49Z

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

felixfeng33 · 2026-02-25T08:15:28Z

Also, any suggestions on dealing with that template? I found several versions-mismatches there and fixed, but can't find a solution for this component.

Sorry I missed this you can only focus on playground I will update template later

arthrod · 2026-02-25T15:47:27Z

I was able to take care of the template! Now just the docxio needs review.

Cr

Apply validated PR #184 review feedback and resolve conflicts Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Document dot-starting diffs vs main and docxio direct/indirect file inventory. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

cr

Supply-chain defense: packages must be 7+ days old before install. Adds [test] root="./packages" in monorepos. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

dosubot Bot added the size:XXL This PR changes 1000+ lines, ignoring generated files. label Feb 8, 2026

dosubot Bot added the plugin:docx label Feb 8, 2026

arthrod force-pushed the feat/docx-import-export-suggestions-comments branch 2 times, most recently from 52af579 to 04d04d8 Compare February 14, 2026 20:49

claude and others added 2 commits February 15, 2026 10:17

Merge pull request #71 from arthrod/claude/fix-tests-lint-lreDb

2695796

fix(docx-io): fix lint errors in test files and exclude vendored mamm…

arthrod requested a review from a team February 15, 2026 10:45

claude and others added 19 commits February 15, 2026 12:16

chore: add .cursor/skills to gitignore for skiller-generated files

4772b93

https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

Update packages/docx-io/src/lib/__tests__/roundtrip.spec.tsx

c072455

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Update packages/docx-io/src/lib/__tests__/roundtrip.spec.tsx

3ff6411

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Update packages/docx-io/src/lib/__tests__/testDocxImporter.tsx

d061f1a

Co-authored-by: gemini-code-assist[bot] <176961590+gemini-code-assist[bot]@users.noreply.github.com>

Remove .claude/skills from .gitignore

8cf3386

📝 CodeRabbit Chat: Add unit tests for PR changes

41f7b1a

Remove generate_from_rules from skiller.toml

1222de3

Removed the 'generate_from_rules' setting from skills.

Fix script command for building registry and tw

de1a762

Remove mammoth dependency

743ca30

Removed 'mammoth' dependency from package.json.

chore: remove /.cursor/skills from gitignore

6ec1547

https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

chore: track .cursor/skills, remove /.claude/skills from gitignore

46ce2ef

https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

docs(docx-io): add fully_vendor_mammoth.md rebuild plan

91cfa4e

https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

chore: skiller rules→skills migration, external spec updates

ec8c9f4

Skiller moved .claude/rules/ to .claude/skills/ and added SKILL.md metadata files. Also includes external spec file updates. https://claude.ai/code/session_01Re6XP9ZEbTqXe4ng3mFRr1

Delete packages/playwright directory

f5a56f1

Delete yarn.lock

d2fb8cd

fix install after playwright workspace removal

afed32d

arthrod and others added 6 commits February 22, 2026 11:43

Merge pull request #136 from arthrod/dependabot/npm_and_yarn/npm_and_…

a40ebb3

…yarn-7f4e323a06 Bump the npm_and_yarn group across 4 directories with 18 updates

Rename railpack.json to railway.json

ba29fd3

Merge branch 'udecode:main' into main

5108b9e

Merge branch 'main' into feat/docx-import-export-suggestions-comments

221830e

tests(docx-io): throw Error objects in applyDocxTracking.spec to sati…

aca7fdb

…sfy useThrowOnlyError lint rule https://claude.ai/code/session_01V5zGakMe6vBHVZEAinNrsC

Merge pull request #152 from arthrod/claude/fix-docx-tracking-lint-JbQJu

03d1130

tests(docx-io): throw Error objects in applyDocxTracking.spec to sati…

arthrod marked this pull request as ready for review February 24, 2026 22:30

felixfeng33 reviewed Feb 25, 2026

View reviewed changes

Comment thread .claude/commands/changeset.md Outdated

Comment thread templates/plate-template/bun.lock Outdated

arthrod and others added 17 commits February 26, 2026 09:36

merge pr #166

d2564c6

Merge pull request #168 from udecode/main

7489e0d

Cr

stripe

8d873d4

pnpm

c5cf78f

pnpm-push

6e5aba9

Delete pnpm-lock.yaml

96a3d0f

Merge origin/main into feat/docx-import-export-suggestions-comments

0782642

Apply validated PR #184 review feedback and resolve conflicts Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Add files via upload

78ecc18

Rename pnpm-lock.yaml.txt to pnpm-lock.yaml

f915da8

Add main diff and docxio manifests

f1355f7

Document dot-starting diffs vs main and docxio direct/indirect file inventory. Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Merge pull request #187 from arthrod/main

bb070ad

cr

Delete templates/plate-playground-template/bun.lock

3f2fe89

Delete templates/plate-template/bun.lock

98f2ab7

Delete packages/docx-io/package.json

1cdb278

Delete yarn.lock

9b663f2

addtions

fe1c7ef

implementing new docxio

1cfa22d

zbeyens marked this pull request as draft March 6, 2026 08:32

chore: add bunfig.toml with minimumReleaseAge=7d

28ac47f

Supply-chain defense: packages must be 7+ days old before install. Adds [test] root="./packages" in monorepos. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(docx-io): add tracked changes and comments import/export#4836

feat(docx-io): add tracked changes and comments import/export#4836
arthrod wants to merge 122 commits into
udecode:mainfrom
cicero-im:feat/docx-import-export-suggestions-comments

arthrod commented Feb 8, 2026 •

edited by github-actions Bot

Loading

Uh oh!

codesandbox Bot commented Feb 8, 2026

Uh oh!

changeset-bot Bot commented Feb 8, 2026 •

edited

Loading

Uh oh!

vercel Bot commented Feb 8, 2026 •

edited

Loading

Uh oh!

chatgpt-codex-connector Bot commented Feb 24, 2026

Uh oh!

felixfeng33 commented Feb 25, 2026

Uh oh!

arthrod commented Feb 25, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

arthrod commented Feb 8, 2026 • edited by github-actions Bot Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

codesandbox Bot commented Feb 8, 2026

Review or Edit in CodeSandbox

Uh oh!

changeset-bot Bot commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

⚠️ No Changeset found

Uh oh!

vercel Bot commented Feb 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chatgpt-codex-connector Bot commented Feb 24, 2026

Uh oh!

felixfeng33 commented Feb 25, 2026

Uh oh!

arthrod commented Feb 25, 2026

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

arthrod commented Feb 8, 2026 •

edited by github-actions Bot

Loading

changeset-bot Bot commented Feb 8, 2026 •

edited

Loading

vercel Bot commented Feb 8, 2026 •

edited

Loading