markers-checklist follow-up: TJ review polish + ScriptureRange contract fix

- ChecklistService: honor platform ScriptureRange contract — End == null now
  narrows to a single-verse range at Start (was: scan to last verse of project).
  No production caller triggers the changed branch; new regression test
  BuildChecklistData_VerseRangeEndOmitted_ScansSingleVerseAtStart covers it.
- platform-scripture.d.ts: tighten verseRange.end TSDoc to reference the
  canonical ScriptureRange semantics; document '' fallback on
  ResolvedComparativeTexts.texts[].name / fullName when available is false.
- LinkedScrRefButton: mirror the @experimental marker on the function itself
  so IDE / TypeDoc surfaces the warning at every call site (was: only on
  LinkedScrRefButtonProps).
- popover.tsx (PopoverPortalContainerProvider): rephrase JSDoc so the inline
  useState<HTMLElement | null>(null) reference lands mid-line and isn't
  reflowed across paragraphs by Prettier.
- Rename test ResolveComparativeTexts_MixedResolutionPaths_… →
  ResolveComparativeTexts_MixedAvailability_… (only one resolution path remains
  after name-fallback was removed).
- Regenerate lib/platform-bible-react/dist for the JSDoc / @experimental
  changes. Includes benign CSS reordering churn (build-tool non-determinism).

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>

Author: rolfheij-sil

c-sharp-tests/Checklists/ChecklistServiceBuildChecklistDataTests.cs

@@ -542,6 +542,65 @@ public void BuildChecklistData_VerseRangeStartAtChapter1Verse2_DoesNotAdjust()
         );
     }
 
+    [Test]
+    [Category("Contract")]
+    [Property("CapabilityId", "CAP-006")]
+    [Property("Contract", "BuildChecklistData")]
+    public void BuildChecklistData_VerseRangeEndOmitted_ScansSingleVerseAtStart()
+    {
+        // Platform ScriptureRange contract (lib/papi-dts):
+        //   "If not provided, then only the verse indicated by start is included."
+        // Verify the checklist honors that contract — passing { Start, End: null }
+        // must narrow to a single-verse range, NOT fall back to the project bounds.
+        const string usfm = @"\id GEN \c 1 \v 1 alpha \p \v 2 bravo \p \v 3 charlie \p \v 4 delta";
+        var scrText = RegisterDummyProject(usfm, bookNum: 1);
+
+        var request = BuildRequest(
+            activeProjectId: scrText.Guid.ToString(),
+            verseRange: new ScriptureRange(
+                Start: new VerseRef("GEN", "1", "2", ScrVers.English),
+                End: null
+            ),
+            showVerseText: true
+        );
+
+        ChecklistResult result = ChecklistService.BuildChecklistData(
+            request,
+            CancellationToken.None
+        );
+
+        var verseTexts = result
+            .Rows.SelectMany(r => r.Cells)
+            .SelectMany(c => c.Paragraphs)
+            .SelectMany(p => p.Items)
+            .OfType<TextItem>()
+            .Select(t => t.Text.Trim())
+            .Where(t => !string.IsNullOrEmpty(t))
+            .ToList();
+
+        // Only verse 2 should appear; verses 1, 3, 4 must be excluded.
+        Assert.That(
+            verseTexts,
+            Has.Some.Contains("bravo"),
+            "End == null must include the verse at Start (GEN 1:2)"
+        );
+        Assert.That(
+            verseTexts,
+            Has.None.Contains("alpha"),
+            "End == null must NOT scan the whole project (verse 1 should be excluded)"
+        );
+        Assert.That(
+            verseTexts,
+            Has.None.Contains("charlie"),
+            "End == null must NOT scan past the Start verse (verse 3 should be excluded)"
+        );
+        Assert.That(
+            verseTexts,
+            Has.None.Contains("delta"),
+            "End == null must NOT scan past the Start verse (verse 4 should be excluded)"
+        );
+    }
+
     // =====================================================================
     // Group D — Max rows truncation (TS-049, INV-012)
     // =====================================================================

c-sharp-tests/Checklists/ChecklistServiceResolveComparativeTextsTests.cs

@@ -16,7 +16,7 @@ namespace TestParanextDataProvider.Checklists;
 /// <para>
 /// Per strategic-plan-backend.md §CAP-009, this capability uses
 /// <b>Outside-In TDD</b>: the outer acceptance test
-/// (<see cref="ResolveComparativeTexts_MixedResolutionPaths_PreservesOrderAndCorrectlyFlagsAvailability"/>)
+/// (<see cref="ResolveComparativeTexts_MixedAvailability_PreservesOrderAndCorrectlyFlagsAvailability"/>)
 /// drives the full INV-014 contract; focused tests pin individual cases
 /// (TS-048 / PTX-23529 duplicate short names resolved by GUID,
 /// active-project exclusion).
@@ -97,7 +97,7 @@ private DummyScrText RegisterProject(string shortName)
     [Property("Contract", "ResolveComparativeTexts")]
     [Property("BehaviorId", "BHV-605")]
     [Property("Invariant", "INV-014")]
-    public void ResolveComparativeTexts_MixedResolutionPaths_PreservesOrderAndCorrectlyFlagsAvailability()
+    public void ResolveComparativeTexts_MixedAvailability_PreservesOrderAndCorrectlyFlagsAvailability()
     {
         // Arrange: register 3 projects in the shared ScrTextCollection.
         //   - active  : the "active" project (self-reference target)

c-sharp/Checklists/ChecklistService.cs

@@ -327,10 +327,13 @@ ScrText active
     // EXPLANATION:
     // Mirrors PT9's pre-flight that converts the optional ScriptureRange
     // carried on the request into a concrete [startRef, endRef] pair,
-    // falling back to mainScrText.FirstVerseRef() / LastVerseRef() when
-    // the request's bounds are null or default. `FirstVerseRef` returns
-    // "GEN 1:0" (intro verse) and `LastVerseRef` returns the final verse
-    // of the final book of the versification.
+    // honoring the platform ScriptureRange contract:
+    //   - range == null              ⇒ whole project (FirstVerseRef..LastVerseRef)
+    //   - range.End == null          ⇒ single-verse range at Start
+    //   - range.{Start,End}.IsDefault ⇒ defensive fallback to the project bounds
+    //                                   for malformed wire payloads (defaulted VerseRef)
+    // `FirstVerseRef` returns "GEN 1:0" (intro verse) and `LastVerseRef`
+    // returns the final verse of the final book of the versification.
     private static (VerseRef start, VerseRef end) ResolveVerseRange(
         ScrText mainScrText,
         ScriptureRange? range
@@ -353,8 +356,15 @@ private static (VerseRef start, VerseRef end) ResolveVerseRange(
             return (firstDefault, lastDefault);
 
         VerseRef start = range.Start.IsDefault ? firstDefault : range.Start;
-        VerseRef end =
-            range.End == null || range.End.Value.IsDefault ? lastDefault : range.End.Value;
+        // Platform ScriptureRange contract: End omitted ⇒ single-verse range at Start.
+        // A defaulted End (malformed wire payload) falls back to the project bounds.
+        VerseRef end;
+        if (range.End == null)
+            end = start;
+        else if (range.End.Value.IsDefault)
+            end = lastDefault;
+        else
+            end = range.End.Value;
         return (start, end);
     }
 

extensions/src/platform-scripture/src/types/platform-scripture.d.ts

@@ -1661,7 +1661,8 @@ declare module 'platform-scripture' {
     markerSettings: ChecklistMarkerSettings;
     /**
      * Inclusive verse range to limit the checklist to. When `undefined`, the entire project is
-     * scanned. When the range omits `end`, only the verse at `start` is included.
+     * scanned. Otherwise the standard {@link ScriptureRange} semantics apply: an omitted `end`
+     * narrows the request to the single verse at `start`.
      */
     verseRange: ScriptureRange | undefined;
     /** When true, rows whose cells all match (per `equivalentMarkers`) are omitted from output. */
@@ -1732,9 +1733,9 @@ declare module 'platform-scripture' {
     texts: {
       /** GUID of the resolved project (or the original requested id if resolution failed). */
       id: string;
-      /** Short name of the resolved project. */
+      /** Short name of the resolved project, or `''` when `available` is `false`. */
       name: string;
-      /** Full descriptive name of the resolved project. */
+      /** Full descriptive name of the resolved project, or `''` when `available` is `false`. */
       fullName: string;
       /** True when the project was successfully resolved and is currently registered. */
       available: boolean;

lib/platform-bible-react/dist/index.cjs

@@ -4448,13 +4448,6 @@ video:where(.pr-twp,.pr-twp *) {
 [data-side=secondary] .\\[\\[data-side\\=secondary\\]_\\&\\]\\:tw-cursor-w-resize {
   cursor: w-resize;
 }
-.banded-row:hover {
-  cursor: pointer;
-}
-
-.banded-row[data-state='selected']:hover {
-  cursor: default;
-}
 /* By default the editor is too tall for the footnote editor, even while empty, so this makes it
    shorter. */
 .footnote-editor .editor-input {
@@ -4474,6 +4467,13 @@ video:where(.pr-twp,.pr-twp *) {
 .footnote-editor .text-spacing .usfm_p {
   text-indent: 0;
 }
+.banded-row:hover {
+  cursor: pointer;
+}
+
+.banded-row[data-state='selected']:hover {
+  cursor: default;
+}
 /**
  * This file was automatically generated on installation of the Shadcn/Lexical editor. The default
  * location of this file has been changed to integrate better with our project structure.

lib/platform-bible-react/dist/index.cjs.map

@@ -2080,6 +2080,10 @@ export type LinkedScrRefButtonProps = {
  *
  * If no `onClick` is provided, the button is disabled and the tooltip still surfaces (useful for
  * read-only contexts where the reference should not be navigable but should still be readable).
+ *
+ * @experimental This component is expected to be removed once
+ *   [`LinkedScrRefDisplay`](https://github.com/paranext/paranext-core/pull/1949) lands. See
+ *   {@link LinkedScrRefButtonProps} for the migration plan.
  */
 export declare function LinkedScrRefButton({ scrRef, onClick, tooltipContent, ariaLabel, className, testId, }: LinkedScrRefButtonProps): import("react/jsx-runtime").JSX.Element | undefined;
 /**
@@ -2678,13 +2682,11 @@ export declare const PopoverAnchor: React$1.ForwardRefExoticComponent<PopoverPri
  * rendered as React children. It does not retroactively re-portal already-mounted popovers, and it
  * does not affect popovers in sibling subtrees.
  *
- * Initial-mount behavior: pass `null` for `container` (the initial value of a `useState<HTMLElement
- *
- * | null>(null)` paired with a ref callback on the ancestor) to keep Radix's default
- *
- * `document.body` behavior until the ancestor mounts. Once the element exists, future popover opens
- * portal into it. The triggering ancestor (the trap owner) must wrap, not be wrapped by, this
- * provider.
+ * Initial-mount behavior: pass `null` for `container` to keep Radix's default `document.body`
+ * behavior until the ancestor mounts. The typical pattern is to hold the ancestor element in
+ * `useState<HTMLElement | null>(null)` paired with a ref callback on the ancestor — once the
+ * element exists, future popover opens portal into it. The triggering ancestor (the trap owner)
+ * must wrap, not be wrapped by, this provider.
  * @example
  *
  * ```tsx

lib/platform-bible-react/dist/index.d.ts

@@ -62,6 +62,10 @@ export type LinkedScrRefButtonProps = {
  *
  * If no `onClick` is provided, the button is disabled and the tooltip still surfaces (useful for
  * read-only contexts where the reference should not be navigable but should still be readable).
+ *
+ * @experimental This component is expected to be removed once
+ *   [`LinkedScrRefDisplay`](https://github.com/paranext/paranext-core/pull/1949) lands. See
+ *   {@link LinkedScrRefButtonProps} for the migration plan.
  */
 export function LinkedScrRefButton({
   scrRef,