Add Interlinearization model, PT9 refactor, and viewing-mode support

[alex-rawlings-yyc]

• Introduce Interlinearization data model.
• Move internal-only PT9 types to dedicated file and change case of props.
• Removed ScrTextName prop as it's been deprecated in PT9 since 2020.
• Enhance interlinearizer WebView to support switching between viewing modes: InterlinearData and Interlinearization.
• Update Jest configuration to include path aliases for types and parsers.
• Modify README to clarify the structure of the src/types/ and src/parsers/ directories.
• Rename interlinearXmlParser and related tests to paratext9parser.
• Add new words to cspell configuration for improved spell checking.

---

This change is 

Summary by CodeRabbit

• New Features

  • JSON view control to switch between parsed data, converted interlinearization, and analyses.

• Improvements

  • Richer, language-aware interlinear model with runtime enums and standardized camelCase fields.
  • New Paratext 9 parsing and conversion path producing deterministic IDs and text-versioning.

• Documentation

  • README updated with path-alias import guidance and shared types; spell-check dictionary expanded.

• Tests

  • Extensive unit and UI tests added for parsing, conversion, view switching, and edge cases.

[coderabbitai]

Caution

Review failed

An error occurred during the review process. Please try again later.

📝 Walkthrough

Walkthrough

Renames parser to Paratext9Parser, normalizes parsed output to camelCase, adds Paratext‑9 TS types, implements conversion to the Interlinearization model and analysis creation, introduces runtime enums, updates the web view to toggle JSON views, and adjusts tests, docs, and path aliases.

Changes

Cohort / File(s)	Summary
Parser core & PT9 types src/parsers/paratext-9/paratext9Parser.ts, src/parsers/paratext-9/paratext-9-types.ts, src/parsers/paratext-9/pt9-xml.md	Renamed InterlinearXmlParser → Paratext9Parser; removed ScrTextName; normalized parser output keys to camelCase; added PT9-specific type declarations and updated PT9 XML documentation and examples.
Converter & tests src/parsers/paratext-9/paratext9Converter.ts, src/__tests__/parsers/paratext-9/paratext9Converter.test.ts	Added conversion from Paratext9 InterlinearData → Interlinearization, deterministic hashing helpers, ID generators, occurrence/assignment creation, and createAnalyses; comprehensive tests for conversion logic and edge cases.
Runtime model & enums src/types/interlinearizer.d.ts, src/types/interlinearizer-enums.ts	Replaced legacy verse-centric types with hierarchical Interlinearization model and related interfaces; added runtime enums (OccurrenceType, AnalysisType, Confidence, AssignmentStatus).
Web view & tests src/interlinearizer.web-view.tsx, src/__tests__/interlinearizer.web-view.test.tsx	Switched web view to use Paratext9Parser; added async conversion to Interlinearization and analyses; introduced JsonViewMode with UI to toggle InterlinearData/Interlinearization/Analyses and updated tests/mocks for the new flows.
Config, tooling & docs tsconfig.json, jest.config.ts, cspell.json, README.md	Added types/* path alias and jest mapping; adjusted coverage exclude pattern; expanded cspell dictionary; README updated to recommend using types/... and parsers/... path aliases and new directory layout.

Sequence Diagram

sequenceDiagram
    participant WebView as Web View (interlinearizer.web-view.tsx)
    participant Parser as Paratext9Parser
    participant Converter as Converter (paratext9Converter)
    participant Display as JSON Display

    WebView->>Parser: parse(xmlString)
    Parser-->>WebView: InterlinearData {glossLanguage, bookId, verses}
    WebView->>Converter: convertParatext9ToInterlinearization(InterlinearData)
    Converter-->>WebView: Interlinearization {books, segments, occurrences}
    WebView->>Converter: createAnalyses(InterlinearData)
    Converter-->>WebView: Map<analysisId, Analysis>
    WebView->>Display: render(selectedView: InterlinearData|Interlinearization|Analyses)

Loading

Estimated code review effort

🎯 4 (Complex) | ⏱️ ~50 minutes

Possibly related PRs

• Add interlinearizer feature with XML parsing and web view integration #6: Large refactor touching the same parser rename, type additions, converter, web view, and tests — strongly related to this change.

Suggested reviewers

• imnasnainaec

Poem

🐰 A parser renamed, fields hop into place,

glosses and books in a tidy little space.
Converters hum, analyses bloom bright,
JSON views dance under soft web‑view light.
🥕📜

🚥 Pre-merge checks | ✅ 3

✅ Passed checks (3 passed)

Check name	Status	Explanation
Description Check	✅ Passed	Check skipped - CodeRabbit’s high-level summary is enabled.
Title check	✅ Passed	The title accurately summarizes the main changes: introducing the Interlinearization model, refactoring Paratext 9 (PT9) implementation, and adding viewing-mode support for the WebView.
Docstring Coverage	✅ Passed	Docstring coverage is 87.50% which is sufficient. The required threshold is 80.00%.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch interlinearization-model

---

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 1 discussion.
Reviewable status: 0 of 14 files reviewed, all discussions resolved (waiting on alex-rawlings-yyc).