Add auto-saving draft with Save / Save As and Wipe

[alex-rawlings-yyc]

Editing the interlinearizer no longer writes to the active project on every keystroke. Each source project now has an always-present draft (draft:{sourceProjectId}) that auto-saves every edit to papi storage, decoupled from the user's saved projects and never shown in the picker, so work is never lost.

Persistence is now explicit:

• Save writes the draft to the active project
• Save As writes the draft to a new project, or overwrites an existing one
• New starts an empty draft (a project is created only on Save As)
• Open loads a project into the draft as a working copy
• Wipe clears the draft — the current book or the whole thing

Switching projects (New / Open) while the draft is dirty prompts to discard. The tab title shows a "●" marker while the draft has unsaved changes, toggled via updateWebViewDefinition (Platform.Bible exposes no native unsaved-tab indicator).

Implementation:

• DraftProject type + isDraftProject guard; getDraft/saveDraft storage with a per-source serialization queue; getDraft/saveDraft backend commands.
• useDraftProject hook owns the draft (autosave, dirty tracking, and a draftVersion that remounts the editor on New/Open/Wipe).
• New SaveAsProjectModal, WipeConfirm, and DiscardDraftConfirm; the New modal is repurposed to configure a draft rather than create a project.
• removeBookFromAnalysis util backs the per-book wipe.

Alignment links are intentionally not carried in the draft yet (no link-editing feature exists); Save preserves a target project's existing links.

Deferred UX decisions are recorded in user-questions.md. 988 tests, 100% coverage, lint clean.

---

This change is 

Summary by CodeRabbit

Release Notes

New Features

• Added draft auto-save functionality that independently persists edits while working on analysis
• Introduced Save command to write draft changes to the active project (or opens Save As if none)
• Added Save As dialog to create new projects or overwrite existing ones with current draft
• Added Wipe function to clear analysis with scope selection (current book or entire draft)
• Unsaved changes now indicated with marker in the tab title
• Discard confirmation appears when switching projects with unsaved changes
• Active project highlighted with badge in project selection modal

[coderabbitai]

Note

Reviews paused

Use the following commands to manage reviews:

• @coderabbitai resume to resume automatic reviews.
• @coderabbitai review to trigger a single review.

Use the checkboxes below for quick actions:

• ▶️ Resume reviews
• ✅ Review completed - (🔄 Check again to review again)

📝 Walkthrough

Walkthrough

This PR adds a per-project draft buffer with save, save as, discard, and wipe flows, updates the loader and modal wiring around that draft state, introduces morphology display and editing controls, bundles view options, and expands tests, strings, menus, settings, and supporting mocks.

Changes

Draft workflow and morphology UI

Layer / File(s)	Summary
Draft contracts and command registration src/types/interlinearizer.d.ts, src/types/type-guards.ts, src/types/view-options.ts, src/main.ts, src/interlinearizer.web-view.tsx, contributions/menus.json, user-questions.md	Adds DraftProject, draft command signatures, bundled ViewOptions, backend and webview command registration, webview definition forwarding, menu entries, and draft workflow documentation.
Draft storage and hook behavior src/services/projectStorage.ts, src/hooks/useDraftProject.ts, src/types/empty-factories.ts, src/utils/analysis-book.ts, src/__tests__/hooks/useDraftProject.test.ts, src/__tests__/services/projectStorage.test.ts, src/__tests__/main.test.ts, src/__tests__/types/type-guards.test.ts, src/__tests__/utils/analysis-book.test.ts	Adds empty draft creation, draft validation and storage, book-removal helpers, the draft-management hook, and tests for loading, autosave, wipe, sync, command handling, and serialization.
Modal save and wipe flows src/components/modals/*, src/__tests__/components/modals/*, __mocks__/platform-bible-react.tsx, contributions/localizedStrings.json	Refactors create to collect draft config, adds discard and wipe confirmation dialogs, adds Save As and active-project modal behavior, wires save and wipe toolbar actions, and extends strings and tests for those flows.
Loader draft integration src/components/InterlinearizerLoader.tsx, src/__tests__/components/InterlinearizerLoader.test.tsx	Moves the loader to draft-backed state, updates the tab title for dirty or pending edits, routes save and wipe commands, resets phrase mode on draft replacement, and rewrites loader tests around async draft behavior.
Pending edits and view option plumbing src/components/AnalysisStore.tsx, src/components/Interlinearizer.tsx, src/components/ContinuousView.tsx, src/components/SegmentListView.tsx, src/components/SegmentView.tsx, src/components/PhraseStripContext.tsx, src/hooks/usePhraseStripSetup.ts, src/components/controls/ViewOptionsDropdown.tsx, contributions/projectSettings.json, src/__tests__/components/{AnalysisStore,ContinuousView,Interlinearizer,SegmentView}.test.tsx, src/__tests__/components/controls/ViewOptionsDropdown.test.tsx	Adds pending-edit reporting, bundles display toggles into viewOptions, adds the show-morphology setting and dropdown toggle, and updates contexts, views, and tests to use the new plumbing.
Morphology editor and token UI src/components/{MorphemeEditor,TokenChip,PhraseBox}.tsx, src/components/__mocks__/AnalysisStore.tsx, __mocks__/platform-bible-react.tsx, src/__tests__/components/{MorphemeEditor,PhraseBox,TokenChip}.test.tsx, REVIEW.md, cspell.json	Adds morpheme breakdown and gloss editing UI, updates token and phrase focus behavior when morphology is shown, extends test mocks, and adds coverage for popover, token, and phrase interactions.
Analysis slice morphology reducers src/store/analysisSlice.ts, src/__tests__/store/analysisSlice.test.ts	Refactors token-analysis helper logic, adds morpheme write, delete, and gloss actions and selectors, and extends reducer tests for cleanup, id preservation, and orphan-link repair.

Sequence Diagram(s)

sequenceDiagram
  participant User
  participant InterlinearizerLoader
  participant ProjectModals
  participant Main
  participant ProjectStorage

  User->>InterlinearizerLoader: Save / Save As / Wipe action
  InterlinearizerLoader->>ProjectModals: open saveAs or confirm flow
  ProjectModals->>Main: createProject / saveAnalysis / getProject
  InterlinearizerLoader->>Main: saveDraft
  Main->>ProjectStorage: saveDraft(sourceProjectId, draft)
  ProjectModals-->>InterlinearizerLoader: markSynced or loadFromProject

Loading

Estimated code review effort

🎯 5 (Critical) | ⏱️ ~120 minutes

Possibly related PRs

• sillsdev/interlinearizer-extension#109: Follow-up changes touch the new MorphemeEditor and TokenChip popover behavior added here.
• sillsdev/interlinearizer-extension#86: Both PRs change InterlinearizerLoader persistence flow and backend command wiring for loading and saving analysis state.
• sillsdev/interlinearizer-extension#62: Both PRs modify the modal orchestration around InterlinearizerLoader and ProjectModals.

Suggested labels

🟥High, up next

Suggested reviewers

• imnasnainaec

Poem

🐇 I found a draft beneath the clover,
Saved its notes and wiped them over.
Tiny morphemes hopped in line,
Glosses blinked and tabs would shine.
A rabbit bows: “What a busy burrow!”

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch save-draft-project

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[alex-rawlings-yyc]

@alex-rawlings-yyc resolved 7 discussions.
Reviewable status: 0 of 29 files reviewed, all discussions resolved (waiting on alex-rawlings-yyc).

[imnasnainaec]

@imnasnainaec reviewed 16 files and all commit messages, and made 4 comments.
Reviewable status: 16 of 61 files reviewed, 3 unresolved discussions (waiting on alex-rawlings-yyc).

---

a discussion (no related file):
It appears Devin (https://app.devin.ai/review/sillsdev/interlinearizer-extension/pull/108) found another bug (and a handful of ⛏️s).

---

user-questions.md line 36 at r6 (raw file):

3. **"Wipe book" scope.** "Wipe Current Book" targets the book currently in view. Alternative: present
   a picker of books that have draft analysis. Current choice: current book only.

An alternative would be to combine the 2 wipe options, the dialog could give wipe all vs wipe selected books options. I'm pondering whether that should even be done now to simplify the menu and give more immediate view of edited books when the decision is being made. (Also easier to have only one option when only 1 book has been modified.)

Code quote:

3. **"Wipe book" scope.** "Wipe Current Book" targets the book currently in view. Alternative: present
   a picker of books that have draft analysis. Current choice: current book only.

---

src/__tests__/components/InterlinearizerLoader.test.tsx line 609 at r6 (raw file):

    });

    expect(capturedInterlinearizerProps?.viewOptions.simplifyPhrases).toBe(false);

⛏️ These strictly-default-prop-capture tests seem like they could be combined into a single test.

Code quote:

expect(capturedInterlinearizerProps?.viewOptions.simplifyPhrases).toBe(false);

---

src/__tests__/types/type-guards.test.ts at r6 (raw file):
The type-guards.ts file is located in src/types/ which is excluded from the coverage requirements, so it would be okay to delete this test file.

[alex-rawlings-yyc]

user-questions.md line 36 at r6 (raw file):

Previously, imnasnainaec (D. Ror.) wrote…

An alternative would be to combine the 2 wipe options, the dialog could give wipe all vs wipe selected books options. I'm pondering whether that should even be done now to simplify the menu and give more immediate view of edited books when the decision is being made.

I'm going to add an issue to add UI that allows users to see books that they've interlinearized. Perhaps they could choose to wipe books from there. We can discuss this further at a later time. I think for now I will add a combined "Wipe..." menu item that opens a dialogue

[alex-rawlings-yyc]

@alex-rawlings-yyc resolved 2 discussions.
Reviewable status: 16 of 61 files reviewed, 1 unresolved discussion (waiting on alex-rawlings-yyc and imnasnainaec).

[imnasnainaec]

@imnasnainaec reviewed 55 files and all commit messages, and resolved 1 discussion.
Reviewable status: all files reviewed, 1 unresolved discussion (waiting on alex-rawlings-yyc).

[alex-rawlings-yyc]

@alex-rawlings-yyc resolved 1 discussion.
Reviewable status: complete! all files reviewed, all discussions resolved (waiting on alex-rawlings-yyc).