@athenaintel/react 0.10.37 → 0.10.38

package/README.md

@@ -150,6 +150,8 @@ Use `AthenaAssetEmbed` to render a native Athena asset without chat, thread hist
 import { AthenaAssetEmbed, AthenaProvider } from '@athenaintel/react';
 
 function AssetView() {
+  const [linkedReference, setLinkedReference] = useState(null);
+
   return (
     <AthenaProvider config={{ token: accessToken }}>
       <div style={{ height: 800 }}>
@@ -162,10 +164,18 @@ function AssetView() {
           }}
           onCitationAction={({ action, reference }) => {
             if (action === 'open-in-spaces') {
-              openAssetInMyApp(reference);
+              setLinkedReference(reference);
             }
           }}
         />
+        {linkedReference && (
+          <AthenaAssetEmbed
+            assetId={linkedReference.id}
+            reference={linkedReference}
+            displayMode="full"
+            readOnly
+          />
+        )}
       </div>
     </AthenaProvider>
   );
@@ -176,6 +186,10 @@ 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.
+
 ## Theming
 
 ```tsx

package/dist/assets/AthenaAssetEmbed.d.ts

@@ -1,7 +1,9 @@
 import { type FC, type IframeHTMLAttributes } from "react";
-import { type AthenaAssetCitationActionEvent, type AthenaAssetCitationBehavior, type AthenaAssetCitationClickEvent } from "./asset-embed-messages";
+import { type AthenaAssetCitationActionEvent, type AthenaAssetCitationBehavior, type AthenaAssetCitationClickEvent, type AthenaAssetCitationReference } from "./asset-embed-messages";
 export interface AthenaAssetEmbedProps extends Omit<IframeHTMLAttributes<HTMLIFrameElement>, "src" | "onError" | "onLoad"> {
     assetId: string;
+    /** Optional citation target to open inside the embedded asset, such as a PDF page. */
+    reference?: AthenaAssetCitationReference;
     /** Defaults to the native full asset experience. */
     displayMode?: "minimal" | "full";
     /** Defaults to true. */

package/dist/assets/use-asset-embed.d.ts

@@ -1,3 +1,4 @@
+import type { AthenaAssetCitationReference } from './asset-embed-messages';
 export interface UseAssetEmbedOptions {
     readOnly?: boolean;
     expiresInSeconds?: number;
@@ -26,7 +27,7 @@ export declare function resolveAssetEmbedUrl({ embedUrl, appUrl, backendUrl, cur
     backendUrl?: string | null;
     currentOrigin?: string | null;
 }): string;
-export declare function buildSdkAssetEmbedUrl(embedUrl: string): string;
+export declare function buildSdkAssetEmbedUrl(embedUrl: string, reference?: AthenaAssetCitationReference): string;
 export declare function getAssetEmbedAuthContext({ token, apiKey }: {
     token?: string | null;
     apiKey?: string;

package/dist/index.cjs

@@ -56390,10 +56390,92 @@ function resolveAssetEmbedUrl({
     return embedUrl;
   }
 }
-function buildSdkAssetEmbedUrl(embedUrl) {
+function setFiniteNumberParam({ params, key, value }) {
+  if (typeof value === "number" && Number.isFinite(value)) {
+    params.set(key, String(value));
+  }
+}
+function appendCitationReferenceParams({
+  params,
+  reference: reference2
+}) {
+  var _a2;
+  const anchor = reference2 == null ? void 0 : reference2.anchor;
+  if (!anchor || typeof anchor !== "object" || !("type" in anchor) || typeof anchor.type !== "string") {
+    return;
+  }
+  switch (anchor.type) {
+    case "page":
+      params.set("anchor", anchor.type);
+      setFiniteNumberParam({
+        params,
+        key: "page",
+        value: "page" in anchor ? anchor.page : void 0
+      });
+      break;
+    case "page_range":
+      params.set("anchor", anchor.type);
+      setFiniteNumberParam({
+        params,
+        key: "start_page",
+        value: "startPage" in anchor ? anchor.startPage : void 0
+      });
+      setFiniteNumberParam({
+        params,
+        key: "end_page",
+        value: "endPage" in anchor ? anchor.endPage : void 0
+      });
+      break;
+    case "page_rect":
+      params.set("anchor", anchor.type);
+      setFiniteNumberParam({
+        params,
+        key: "page",
+        value: "page" in anchor ? anchor.page : void 0
+      });
+      setFiniteNumberParam({
+        params,
+        key: "x",
+        value: "x" in anchor ? anchor.x : void 0
+      });
+      setFiniteNumberParam({
+        params,
+        key: "y",
+        value: "y" in anchor ? anchor.y : void 0
+      });
+      setFiniteNumberParam({
+        params,
+        key: "width",
+        value: "width" in anchor ? anchor.width : void 0
+      });
+      setFiniteNumberParam({
+        params,
+        key: "height",
+        value: "height" in anchor ? anchor.height : void 0
+      });
+      break;
+    case "page_text":
+      params.set("anchor", anchor.type);
+      setFiniteNumberParam({
+        params,
+        key: "page",
+        value: "page" in anchor ? anchor.page : void 0
+      });
+      if ("text" in anchor && typeof anchor.text === "string") {
+        params.set("text", anchor.text);
+      }
+      break;
+  }
+  const excerpt = (_a2 = reference2.meta) == null ? void 0 : _a2.excerpt;
+  if (typeof excerpt === "string" && excerpt) {
+    params.set("excerpt", excerpt);
+  }
+}
+function buildSdkAssetEmbedUrl(embedUrl, reference2) {
   try {
     const url = new URL(embedUrl);
     url.searchParams.set("athena_sdk_bridge", "1");
+    appendCitationReferenceParams({ params: url.searchParams, reference: reference2 });
     return url.toString();
   } catch {
     return embedUrl;
@@ -56523,6 +56605,7 @@ const DEFAULT_STYLE = {
 const AUTH_SYNC_INTERVAL_MS = 6e4;
 const AthenaAssetEmbed = ({
   assetId,
+  reference: reference2,
   displayMode = "full",
   readOnly = true,
   expiresInSeconds,
@@ -56560,7 +56643,10 @@ const AthenaAssetEmbed = ({
       return null;
     }
   }, [embedUrl]);
-  const iframeSrc = React.useMemo(() => embedUrl ? buildSdkAssetEmbedUrl(embedUrl) : null, [embedUrl]);
+  const iframeSrc = React.useMemo(
+    () => embedUrl ? buildSdkAssetEmbedUrl(embedUrl, reference2) : null,
+    [embedUrl, reference2]
+  );
   const effectiveCitationBehavior = resolveAthenaAssetCitationBehavior({
     citationBehavior,
     hasCitationClickHandler: !!onCitationClick