platform: data-driven selection tests for USJ <-> Lexical conversion (#456)

Add 612 data-driven tests (136 USJ locations x 3 marker modes + round-trips)
for selection resolution and round-trip conversion between USJ document
locations and Lexical editor selections.

Test data:
- 2sa.usj-locations.ts: 136 location entries adapted from paranext-core's
  testUSFM-2SA-1-locations.ts covering all 7 UsjDocumentLocation subtypes
- 2sa.lexical.{editable,visible,hidden}.ts: pre-generated serialized Lexical
  editor states for `usj2Sa` in each marker mode

Known implementation gaps are tracked with `expect(() => ...).toThrow()`
inside regular `it()` tests so they stay visible without breaking CI or
the VS Code test explorer. When a gap is fixed the `toThrow()` assertion
fails, prompting removal of the entry from the KNOWN_*_GAPS set.

Generation:
- generate-2sa-lexical-states.test.ts guarded by GENERATE_TEST_DATA env var
  (skipped during normal nx test runs)
- pnpm generate:test-data in packages/platform to regenerate fixtures

Also adds test-data as a devDependency of shared-react and excludes the
auto-generated Lexical state fixtures from SonarLint analysis.

Author: irahopkinson

.vscode/settings.json

@@ -25,5 +25,7 @@
     "node_modules": true,
     "demos/platform/lib": true
   },
+  // Exclude auto-generated Lexical state fixtures from SonarLint analysis
+  "sonarlint.analysisExcludesStandalone": ["**/test-data/src/data/2sa.lexical.*.ts"],
   "typescript.tsdk": "node_modules/typescript/lib"
 }

demos/platform/src/app/app.tsx

@@ -49,7 +49,7 @@ interface Annotations {
 
 const isTesting = process.env.NODE_ENV === "testing";
 const webUsj = usxStringToUsj(isTesting ? WEB_PSA_USX : WEB_PSA_CH1_USX);
-const editorUsj = webUsj; // isTesting ? webUsj : TJ_USJ;
+const editorUsj = webUsj; // isTesting ? webUsj : usj2Sa;
 const defaultScrRef: SerializedVerseRef = { book: "PSA", chapterNum: 1, verseNum: 1 };
 // Word "man" inside first q1 of PSA 1:1.
 const annotationRange1: AnnotationRange = {

libs/shared-react/package.json

@@ -44,7 +44,8 @@
     "quill-delta": "^5.1.0"
   },
   "devDependencies": {
-    "shared": "workspace:~"
+    "shared": "workspace:~",
+    "test-data": "workspace:~"
   },
   "repository": {
     "type": "git",

libs/shared-react/src/plugins/usj/annotation/selection.utils.data-driven.test.ts

@@ -45,6 +45,9 @@
     },
     {
       "path": "../shared/tsconfig.lib.json"
+    },
+    {
+      "path": "../test-data/tsconfig.lib.json"
     }
   ]
 }

libs/shared-react/tsconfig.lib.json

@@ -17,6 +17,7 @@
   },
   "dependencies": {
     "@eten-tech-foundation/scripture-utilities": "workspace:~",
+    "lexical": "^0.40.0",
     "tslib": "^2.8.1"
   }
 }