feat(google-docs): add cell-level mapping review to document outline [INTEG-3572] by harikakondur · Pull Request #10861 · contentful/apps

Harika Kondur (harikakondur) · 2026-04-10T14:20:26Z

Summary

Adds a better Google Docs review screen so we can see mappings at the cell level and make it easier to understand what content maps to which field.

Changes

Adds a new document outline view for mapping review.
Shows mappings for document blocks, tables, table cells, and images.
Adds side cards that show which field each section maps to.
Keeps the side cards lined up with the right part of the document.
Highlights the document content when you hover a mapping card.
Highlights the mapping card when you hover the matching text or image.
Adds entry filter cards so reviewers can focus on one entry at a time.
Supports tabs, lists, links, images, and nested table content in the review UI.
Cleans up the page flow so mapping review has its own screen.
Updates fixtures and tests to cover the new review experience.

Files Changed

File(s)	What changed
`apps/google-docs/src/locations/Page/components/review/DocumentOutline.tsx`	Adds the new review UI for document blocks, tables, images, and entry filtering.
`apps/google-docs/src/locations/Page/components/review/MappingCard.tsx` `apps/google-docs/src/locations/Page/components/review/mappingCardPositioning.ts` `apps/google-docs/src/locations/Page/components/review/buildDocument.ts`	Adds the mapping cards and the logic that places them next to the right content.
`apps/google-docs/src/locations/Page/Page.tsx` `apps/google-docs/src/locations/Page/components/mainpage/MainPageView.tsx` `apps/google-docs/src/locations/Page/components/mainpage/MappingReviewPage.tsx` `apps/google-docs/src/locations/Page/components/mainpage/ModalOrchestrator.tsx` `apps/google-docs/src/locations/Page/components/mainpage/PreviewPageView.tsx`	Updates the page flow to use the new mapping review screen.
`apps/google-docs/src/types/entryBlockGraph.ts` `apps/google-docs/src/types/normalizedDocument.ts` `apps/google-docs/src/types/workflow.ts` `apps/google-docs/src/types/index.ts`	Expands the data types to support table cells, images, and richer mapping data.
`apps/google-docs/src/fixtures/googleDocsReview/*`	Updates fixture data for the new review format.
`apps/google-docs/test/locations/Page/Page.spec.tsx` `apps/google-docs/test/locations/Page/components/mainpage/ModalOrchestrator.spec.tsx` `apps/google-docs/test/locations/Page/components/mainpage/PreviewPageView.spec.tsx` `apps/google-docs/test/locations/Page/components/review/DocumentOutline.spec.tsx` `apps/google-docs/test/locations/Page/components/review/mappingCardPositioning.spec.ts`	Adds test coverage for the new review flow and hover/positioning behavior.
`apps/google-docs/package.json` `apps/google-docs/package-lock.json` `apps/google-docs/tsconfig.json`	Adds UI/test support needed for the new screen.

Screenshots

Tab Name is visible (Draft)

Partial highlight within cell highlight

Multiple partial highlights from a single cell

Hover interaction

Screen.Recording.2026-04-13.at.12.07.39.AM.mov

Temporary Overview Section with mapping info. (click entry card -> relevant highlights appear)

Uploading Screen Recording 2026-04-13 at 12.09.09 AM.mov…

…ings

wiz-inc-38d59fb8d7 · 2026-04-10T14:26:58Z

Wiz Scan Summary

Scanner	Findings
Vulnerabilities	-
Sensitive Data	-
Secrets	-
IaC Misconfigurations	-
SAST Findings	1
Software Management Findings	-

Total	1

View scan details in Wiz

To detect these findings earlier in the dev lifecycle, try using Wiz Code VS Code Extension.

…ings

…ful/apps into feat/cell-level-mappings

…ings

…Outline for mapping review

Franco Banfi (FBanfi)

Nice update! 🙌 Paired the PR review with JuliRossi and left some comments!
The was reviewed to the best of our abilities given the length of the PR.
The most important part for us, is that there are some places in which the fieldType and fieldName are being fetch incorrectly, also check entry name.

Franco Banfi (FBanfi) · 2026-04-13T17:55:10Z

apps/google-docs/src/locations/Page/components/mainpage/MappingReviewPage.tsx

+  const [isConfirmCancelModalOpen, setIsConfirmCancelModalOpen] = useState(false);
+
+  const isMappingReview = isMappingReviewSuspendPayload(payload);
+  const documentTitle = payload.documentTitle || 'Selected document';


The document title comes from the normalized document that's in the payload.

we are also getting the title directly from the mapping review suspend payload

apps/google-docs/src/locations/Page/components/mainpage/MappingReviewPage.tsx

apps/google-docs/src/locations/Page/components/mainpage/ModalOrchestrator.tsx

Franco Banfi (FBanfi) · 2026-04-13T18:15:10Z

apps/google-docs/src/locations/Page/components/review/utils/buildDocument.ts

+  type SortableItem =
+    | { kind: 'block'; position: number; block: NormalizedDocumentContentBlock }
+    | { kind: 'table'; position: number; table: NormalizedDocumentTable }
+    | { kind: 'tab'; position: number; tab: NormalizedDocumentTabBlock };


We could use the existent types from above here. Also, we could extract this type outside the method

Franco Banfi (FBanfi) · 2026-04-13T18:20:25Z

apps/google-docs/src/locations/Page/components/review/utils/buildDocument.ts

+    if (!currentTab) {
+      currentTab = { id: normalizedDocument.documentId, name: '', segments: [] };
+      tabs.push(currentTab);
+    }


Why do we need this?

Franco Banfi (FBanfi) · 2026-04-13T20:01:18Z

apps/google-docs/src/locations/Page/components/review/DocumentOutline.tsx

+    };
+
+    measureOffsets();
+    window.addEventListener('resize', measureOffsets);


Why do we need a resize and an event here?

apps/google-docs/src/locations/Page/components/review/DocumentOutline.tsx

Franco Banfi (FBanfi) · 2026-04-13T20:22:44Z

apps/google-docs/src/types/entryBlockGraph.ts

+  blockId: string;
+};
+
+export type TableImageSourceRef = ImageSourceRefBase & {


We could create a type for this and reuse it in line 22

Franco Banfi (FBanfi) · 2026-04-13T20:27:00Z

apps/google-docs/src/types/entryBlockGraph.ts

Check if we are duplicating types that already exist

apps/google-docs/src/utils/getEntryTitle.ts

…g and unused utility function

…wFromPreviewCancel handlers

wip: cell level mappings

dc485fe

Harika Kondur (harikakondur) added the WIP label Apr 10, 2026

Harika Kondur (harikakondur) requested a review from a team as a code owner April 10, 2026 14:20

Merge branch 'google-docs-document-outline' into feat/cell-level-mapp…

ad0388d

…ings

Harika Kondur (harikakondur) and others added 4 commits April 10, 2026 09:12

Merge branch 'google-docs-document-outline' into feat/cell-level-mapp…

8cb6668

…ings

Merge branch 'feat/cell-level-mappings' of https://github.com/content…

afd70da

…ful/apps into feat/cell-level-mappings

Merge branch 'google-docs-document-outline' into feat/cell-level-mapp…

64e1da0

…ings

refactor: remove fixture-loader and related types, integrate Document…

806b561

…Outline for mapping review

Harika Kondur (harikakondur) force-pushed the feat/cell-level-mappings branch from 375803f to 806b561 Compare April 10, 2026 15:57

Harika Kondur (harikakondur) added 5 commits April 10, 2026 10:09

fix: remove duplicate resumeMappingReview function

b1ece2c

fix: revert overview section changes

7d91c39

fix: update review component test folder path

6f36a26

fix: removing section based document rendering

eb9aa39

feat: add index based highlighting

ac5b4bc

Harika Kondur (harikakondur) force-pushed the feat/cell-level-mappings branch from d1463f7 to ac5b4bc Compare April 13, 2026 05:51

Harika Kondur (harikakondur) changed the title ~~wip: cell level mappings~~ feat(google-docs): add cell-level mapping review to document outline [INTEG-3572] Apr 13, 2026

Harika Kondur (harikakondur) added 3 commits April 13, 2026 00:04

fix: reorganize util files

9c256e7

fix: fixture loader build error

59258d4

fix: rename orderDocument to buildDocument

7185d1c

Franco Banfi (FBanfi) reviewed Apr 13, 2026

View reviewed changes

Harika Kondur (harikakondur) added 2 commits April 13, 2026 15:40

refactor: simplify MappingReviewPage by removing conditional renderin…

69e8169

…g and unused utility function

refactor(google-docs): remove unused resumeMappingReview and resetFlo…

a94d855

…wFromPreviewCancel handlers

Harika Kondur (harikakondur) force-pushed the feat/cell-level-mappings branch from 2d94c4a to a94d855 Compare April 14, 2026 04:27

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat(google-docs): add cell-level mapping review to document outline [INTEG-3572]#10861

feat(google-docs): add cell-level mapping review to document outline [INTEG-3572]#10861
Harika Kondur (harikakondur) wants to merge 16 commits intogoogle-docs-document-outlinefrom
feat/cell-level-mappings

Harika Kondur (harikakondur) commented Apr 10, 2026 •

edited

Loading

Uh oh!

wiz-inc-38d59fb8d7 bot commented Apr 10, 2026 •

edited

Loading

Uh oh!

Franco Banfi (FBanfi) left a comment •

edited

Loading

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Uh oh!

Harika Kondur (harikakondur) Apr 13, 2026

Uh oh!

Uh oh!

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Uh oh!

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

Harika Kondur (harikakondur) commented Apr 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Changes

Files Changed

Screenshots

Uh oh!

wiz-inc-38d59fb8d7 bot commented Apr 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Wiz Scan Summary

Uh oh!

Franco Banfi (FBanfi) left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

Harika Kondur (harikakondur) Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

Franco Banfi (FBanfi) Apr 13, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Harika Kondur (harikakondur) commented Apr 10, 2026 •

edited

Loading

wiz-inc-38d59fb8d7 bot commented Apr 10, 2026 •

edited

Loading

Franco Banfi (FBanfi) left a comment •

edited

Loading