@athenaintel/react 0.10.39 → 0.10.40

package/README.md

@@ -193,8 +193,9 @@ When `onCitationClick` is provided, citation navigation is delegated to the host
 `onCitationAction` handles actions initiated from a citation popover. It currently receives `action: 'open-in-spaces'` when the user clicks the (+) button. Providing the handler delegates that action to the host by default. Set `citationActionBehavior="browser"` to observe the event while preserving Athena's default navigation; requesting host mode without a handler safely falls back to browser behavior.
 
 Pass the callback's complete `reference` to the linked `AthenaAssetEmbed`, rather than storing only
-`reference.id`. The embed uses the reference anchor to navigate PDFs to the cited page. Updating the
-reference also navigates when the host opens another citation in the same asset.
+`reference.id`. The embed uses the reference anchor to navigate PDFs to the cited page and highlight
+the cited excerpt or rectangular region. Updating the reference also navigates when the host opens
+another citation in the same asset.
 
 If the host starts with an Athena citation URL/string instead of an
 `onCitationAction` event, parse it and pass the returned `reference` directly to the embed:
@@ -226,8 +227,10 @@ For example, this citation opens the PDF directly at page 34:
 https://app.athenaintel.com/dashboard/spaces/?asset_ids=asset_pdf&anchor=page&page=34&excerpt=Term%20debt
 ```
 
-The important query parameters are `asset_ids`, `anchor=page`, and `page`. Page ranges and
-positioned citations are also preserved by `parseAthenaCitationLink`.
+The important query parameters are `asset_ids`, `anchor=page`, `page`, and `excerpt`. Page ranges,
+text anchors, and positioned citations are also preserved by `parseAthenaCitationLink`. A
+`page_rect` may include `unit=percent` (the default) or `unit=point`; retain the unit so the region
+maps to the correct PDF coordinates.
 
 ## Theming
 

package/dist/index.cjs

@@ -47552,7 +47552,16 @@ const parseCitationReference = ({
       const width = getFiniteNumber(url, "width");
       const height = getFiniteNumber(url, "height");
       if (page !== null && x !== null && y !== null && width !== null && height !== null) {
-        reference2.anchor = { type: anchorType, page, x, y, width, height };
+        const unit = url.searchParams.get("unit");
+        reference2.anchor = {
+          type: anchorType,
+          page,
+          x,
+          y,
+          width,
+          height,
+          ...unit === "percent" || unit === "point" ? { unit } : {}
+        };
       }
       break;
     }
@@ -56501,6 +56510,9 @@ function appendCitationReferenceParams({
         key: "height",
         value: "height" in anchor ? anchor.height : void 0
       });
+      if ("unit" in anchor && (anchor.unit === "percent" || anchor.unit === "point")) {
+        params.set("unit", anchor.unit);
+      }
       break;
     case "page_text":
       params.set("anchor", anchor.type);