@epam/ai-dial-quotations 1.2.0-dev.1 → 1.2.0-dev.102

package/components/CitationCard/CitationCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CitationCard.d.ts","sourceRoot":"","sources":["../../../src/components/CitationCard/CitationCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAe5D,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAG/E,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,2GAA2G;IAC3G,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/D,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACrC,qFAAqF;IACrF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iKAAiK;IACjK,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,KAAK,EAAE,eAAe,CAAC;IACvB,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC7C,2EAA2E;IAC3E,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAClD,wEAAwE;IACxE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,4BAA4B;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,gCAAgC;IAChC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,yFAAyF;AACzF,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAqJ9C,CAAC"}
+{"version":3,"file":"CitationCard.d.ts","sourceRoot":"","sources":["../../../src/components/CitationCard/CitationCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAe5D,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAG/E,+CAA+C;AAC/C,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,gBAAgB,EAAE,MAAM,CAAC;IACzB,uDAAuD;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,2GAA2G;IAC3G,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/D,sCAAsC;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,qGAAqG;AACrG,MAAM,WAAW,kBAAkB;IACjC,4DAA4D;IAC5D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,oEAAoE;AACpE,MAAM,WAAW,sBAAsB;IACrC,qFAAqF;IACrF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sFAAsF;IACtF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gFAAgF;IAChF,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,iKAAiK;IACjK,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,yFAAyF;IACzF,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,8CAA8C;AAC9C,MAAM,WAAW,iBAAiB;IAChC,wEAAwE;IACxE,KAAK,EAAE,eAAe,CAAC;IACvB,kFAAkF;IAClF,WAAW,EAAE,MAAM,CAAC;IACpB,iFAAiF;IACjF,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;IACvC;;;;OAIG;IACH,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC7C,2EAA2E;IAC3E,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAClD,wEAAwE;IACxE,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,4BAA4B;IAC5B,MAAM,EAAE,kBAAkB,CAAC;IAC3B,2CAA2C;IAC3C,UAAU,CAAC,EAAE,sBAAsB,CAAC;IACpC,gCAAgC;IAChC,MAAM,CAAC,EAAE,kBAAkB,CAAC;CAC7B;AAED,yFAAyF;AACzF,eAAO,MAAM,YAAY,EAAE,EAAE,CAAC,iBAAiB,CAqJ9C,CAAC"}

package/components/CitationDropdown/CitationDropdown.d.ts

@@ -12,6 +12,8 @@ export interface CitationDropdownProps {
      * group has nothing previewable — the "Preview" button is hidden.
      */
     onPreview?: (annotation: Annotation) => void;
+    /** Whether the host can preview the active annotation. Defaults to allowing preview when `onPreview` is provided. */
+    isPreviewable?: (annotation: Annotation) => boolean;
     /** Called when the user clicks "Open in browser" for an annotation. */
     onOpenInBrowser: (annotation: Annotation) => void;
     /** Optional icon rendered before the marker's label. */

package/components/CitationDropdown/CitationDropdown.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CitationDropdown.d.ts","sourceRoot":"","sources":["../../../src/components/CitationDropdown/CitationDropdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EAAE,EAAE,EAAE,SAAS,EAAwB,MAAM,OAAO,CAAC;AAE5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAG1C,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,KAAK,EAAE,eAAe,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC7C,uEAAuE;IACvE,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAClD,wDAAwD;IACxD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,uFAAuF;IACvF,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,+CAA+C;IAC/C,UAAU,EAAE,kBAAkB,CAAC;IAC/B,yDAAyD;IACzD,YAAY,EAAE,oBAAoB,CAAC;IACnC,2DAA2D;IAC3D,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,8HAA8H;AAC9H,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CAuEtD,CAAC"}
+{"version":3,"file":"CitationDropdown.d.ts","sourceRoot":"","sources":["../../../src/components/CitationDropdown/CitationDropdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,OAAO,EAAE,EAAE,EAAE,SAAS,EAA+B,MAAM,OAAO,CAAC;AAGnE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAC/E,OAAO,EAEL,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC5B,MAAM,8BAA8B,CAAC;AACtC,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,kCAAkC,CAAC;AAG1C,kDAAkD;AAClD,MAAM,WAAW,qBAAqB;IACpC,kEAAkE;IAClE,KAAK,EAAE,eAAe,CAAC;IACvB;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAC7C,qHAAqH;IACrH,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,OAAO,CAAC;IACpD,uEAAuE;IACvE,eAAe,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,IAAI,CAAC;IAClD,wDAAwD;IACxD,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,uFAAuF;IACvF,UAAU,CAAC,EAAE,SAAS,CAAC;IACvB,+CAA+C;IAC/C,UAAU,EAAE,kBAAkB,CAAC;IAC/B,yDAAyD;IACzD,YAAY,EAAE,oBAAoB,CAAC;IACnC,2DAA2D;IAC3D,cAAc,CAAC,EAAE,sBAAsB,CAAC;IACxC,gGAAgG;IAChG,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,8HAA8H;AAC9H,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CA6EtD,CAAC"}

package/components/CitationMarker/CitationMarker.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"CitationMarker.d.ts","sourceRoot":"","sources":["../../../src/components/CitationMarker/CitationMarker.tsx"],"names":[],"mappings":"AACA,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAEtC,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,mEAAmE;IACnE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,4BAA4B;IAC5B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,8FAA8F;IAC9F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,sEAAsE;AACtE,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CAwBlD,CAAC"}
+{"version":3,"file":"CitationMarker.d.ts","sourceRoot":"","sources":["../../../src/components/CitationMarker/CitationMarker.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAGtC,iDAAiD;AACjD,MAAM,WAAW,oBAAoB;IACnC,8CAA8C;IAC9C,SAAS,EAAE,MAAM,CAAC;IAClB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,8CAA8C;IAC9C,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,gDAAgD;AAChD,MAAM,WAAW,mBAAmB;IAClC,kEAAkE;IAClE,UAAU,EAAE,MAAM,CAAC;IACnB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,MAAM,EAAE,MAAM,IAAI,CAAC;IACnB,mEAAmE;IACnE,IAAI,CAAC,EAAE,SAAS,CAAC;IACjB,4BAA4B;IAC5B,MAAM,EAAE,oBAAoB,CAAC;IAC7B,8FAA8F;IAC9F,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,sEAAsE;AACtE,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CA6BlD,CAAC"}

package/constants/public-class-names.d.ts

@@ -0,0 +1,14 @@
+export declare const QUOTATIONS_CLASS: {
+    /** The citation card's `role="dialog"` root, which carries the themed CSS variables. */
+    readonly citationCard: "dial-quotations-citation-card";
+    /** The floating panel a `CitationDropdown` reveals, which holds the card. */
+    readonly citationDropdown: "dial-quotations-citation-dropdown";
+    /**
+     * The marker pill that opens a citation, additive to the
+     * `dial-kit-base-button` that `@epam/ai-dial-ui-kit` draws. The pill caps its
+     * own width and ellipsises a long source name, so a host widening it should
+     * override `max-inline-size` here rather than unset the truncation.
+     */
+    readonly citationMarker: "dial-quotations-citation-marker";
+};
+//# sourceMappingURL=public-class-names.d.ts.map

package/constants/public-class-names.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-class-names.d.ts","sourceRoot":"","sources":["../../src/constants/public-class-names.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,gBAAgB;IAC3B,wFAAwF;;IAExF,6EAA6E;;IAE7E;;;;;OAKG;;CAEK,CAAC"}

package/context/CitationCardContext.d.ts

@@ -3,10 +3,10 @@ import { useCitationCard } from '../utils/useCitationCard';
 export type CitationCardHook = ReturnType<typeof useCitationCard>;
 /** Provider that supplies `CitationCardHook` state to a citation subtree. */
 export declare const CitationCardProvider: import('react').Provider<{
-    openPopup: (groupKey: string) => void;
-    closePopup: () => void;
+    openPopup: (ownerKey: string) => void;
+    closePopup: (ownerKey: string) => void;
     setActiveIndex: (groupKey: string, index: number) => void;
-    isOpen: (groupKey: string) => boolean;
+    isOpen: (ownerKey: string) => boolean;
     getActiveIndex: (groupKey: string) => number;
 } | null>;
 /** Returns the nearest `CitationCardHook` from context. Throws when used outside a `CitationCardProvider`. */

package/hooks/useCitationMarkdownComponents/useCitationMarkdownComponents.d.ts

@@ -7,6 +7,8 @@ import { AnnotationGroup } from '../../utils/group-annotations-by-source';
 export interface UseCitationMarkdownComponentsCallbacks {
     /** Called when a citation marker's preview action is invoked, with the clicked annotation and its group. */
     onPreview(annotation: Annotation, group: AnnotationGroup): void;
+    /** Whether the host can preview an annotation. Defaults to allowing preview. */
+    isPreviewable?(annotation: Annotation): boolean;
     /** Called when a citation marker's open-in-browser action is invoked. */
     onOpenInBrowser(annotation: Annotation): void;
     /** Builds the translated label bundles used by a given citation group's card and marker. */

package/hooks/useCitationMarkdownComponents/useCitationMarkdownComponents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCitationMarkdownComponents.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCitationMarkdownComponents/useCitationMarkdownComponents.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAO3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE/E,6FAA6F;AAC7F,MAAM,WAAW,sCAAsC;IACrD,4GAA4G;IAC5G,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAChE,yEAAyE;IACzE,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9C,4FAA4F;IAC5F,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG;QACnC,UAAU,EAAE,kBAAkB,CAAC;QAC/B,YAAY,EAAE,oBAAoB,CAAC;KACpC,CAAC;CACH;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,EACf,QAAQ,eAAe,EAAE,EACzB,WAAW,sCAAsC,EACjD,qBAAmB,EACnB,6BAA2B,KAC1B;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,UAAU,CAAA;CA8F5D,CAAC"}
+{"version":3,"file":"useCitationMarkdownComponents.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCitationMarkdownComponents/useCitationMarkdownComponents.tsx"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,UAAU,EAEhB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAErF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gDAAgD,CAAC;AAO3F,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAE/E,6FAA6F;AAC7F,MAAM,WAAW,sCAAsC;IACrD,4GAA4G;IAC5G,SAAS,CAAC,UAAU,EAAE,UAAU,EAAE,KAAK,EAAE,eAAe,GAAG,IAAI,CAAC;IAChE,gFAAgF;IAChF,aAAa,CAAC,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC;IAChD,yEAAyE;IACzE,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9C,4FAA4F;IAC5F,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG;QACnC,UAAU,EAAE,kBAAkB,CAAC;QAC/B,YAAY,EAAE,oBAAoB,CAAC;KACpC,CAAC;CACH;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,EACf,QAAQ,eAAe,EAAE,EACzB,WAAW,sCAAsC,EACjD,qBAAmB,EACnB,6BAA2B,KAC1B;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,UAAU,CAAA;CAgG5D,CAAC"}

package/index.css

@@ -1,2 +1,2 @@
 ._card_1kph1_1{background:var(--cc-card-bg,var(--bg-layer-raised,#fcfcfc))}._quote_1kph1_5{color:var(--cc-quote-text,var(--text-secondary,#57647a))}._title_1kph1_9{color:var(--cc-title-text,var(--text-primary,#161b2d))}._switcher_1kph1_13{color:var(--cc-switcher-text,var(--text-secondary,#57647a))}._sourceName_1kph1_17{color:var(--cc-source-name-text,var(--text-primary,#161b2d))}._content_xzs0h_1>svg{fill:var(--cc-card-bg,var(--bg-layer-raised,#fcfcfc));stroke:#0000}
-/*$vite$:1*/
+/*$vite$:1*/.visible{visibility:visible}.collapse{visibility:collapse}.fixed{position:fixed}.absolute{position:absolute}.mb-1{margin-bottom:.25rem}.mb-1\.5{margin-bottom:.375rem}.mb-3{margin-bottom:.75rem}.ms-1{margin-inline-start:.25rem}.line-clamp-6{display:-webkit-box;overflow:hidden;-webkit-box-orient:vertical;-webkit-line-clamp:6}.inline{display:inline}.flex{display:flex}.inline-flex{display:inline-flex}.table-cell{display:table-cell}.table-row{display:table-row}.hidden{display:none}.min-h-\[3lh\]{min-height:3lh}.w-\[400px\]{width:400px}.min-w-0{min-width:0}.\!max-w-none{max-width:none!important}.max-w-\[240px\]{max-width:240px}.shrink{flex-shrink:1}.shrink-0{flex-shrink:0}.flex-col{flex-direction:column}.items-center{align-items:center}.justify-start{justify-content:flex-start}.justify-between{justify-content:space-between}.gap-1{gap:.25rem}.gap-2{gap:.5rem}.gap-3{gap:.75rem}.truncate{overflow:hidden;text-overflow:ellipsis;white-space:nowrap}.break-words{overflow-wrap:break-word}.\!rounded-none{border-radius:0!important}.rounded-lg{border-radius:.5rem}.\!border-0{border-width:0!important}.\!bg-transparent{background-color:transparent!important}.\!p-0{padding:0!important}.p-4{padding:1rem}.ps-3{padding-inline-start:.75rem}.align-middle{vertical-align:middle}.\!shadow-none{--tw-shadow:0 0 #0000!important;--tw-shadow-colored:0 0 #0000!important;box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)!important}.shadow-lg{--tw-shadow:0 8px 44px 0 var(--shadow-lg,#2764d914);--tw-shadow-colored:0 8px 44px 0 var(--tw-shadow-color);box-shadow:var(--tw-ring-offset-shadow,0 0 #0000),var(--tw-ring-shadow,0 0 #0000),var(--tw-shadow)}.filter{filter:var(--tw-blur) var(--tw-brightness) var(--tw-contrast) var(--tw-grayscale) var(--tw-hue-rotate) var(--tw-invert) var(--tw-saturate) var(--tw-sepia) var(--tw-drop-shadow)}.\[overflow-wrap\:anywhere\]{overflow-wrap:anywhere}.\[text-wrap\:pretty\]{text-wrap:pretty}.last\:mb-0:last-child{margin-bottom:0}.rtl\:scale-x-\[-1\]:where([dir=rtl],[dir=rtl] *){--tw-scale-x:-1;transform:translate(var(--tw-translate-x),var(--tw-translate-y)) rotate(var(--tw-rotate)) skewX(var(--tw-skew-x)) skewY(var(--tw-skew-y)) scaleX(var(--tw-scale-x)) scaleY(var(--tw-scale-y))}

package/index.d.ts

@@ -13,8 +13,9 @@ export type { UseCitationMarkdownComponentsCallbacks } from './hooks/useCitation
 export { gatherSameSourceAnnotations, groupAnnotations, groupAnnotationsByCitId, groupAnnotationsBySource, } from './utils/group-annotations-by-source';
 export type { AnnotationGroup } from './utils/group-annotations-by-source';
 export { annotationHighlightId, annotationsToPdfHighlights, annotationToOfficeHighlightLocations, getAnnotationPdfPage, isDocxRangeSelector, isExcelRcRangeSelector, isPptxRangeSelector, resolveMessageAnnotations, } from './utils/annotation';
-export type { DocxOfficeHighlightLocation, ExcelOfficeHighlightLocation, OfficeHighlightLocation, PptxOfficeHighlightLocation, } from './models/office-highlight';
+export type { DocxOfficeHighlightLocation, DocxTableRowOfficeHighlightLocation, ExcelOfficeHighlightLocation, OfficeHighlightLocation, PptxOfficeHighlightLocation, PptxTableRowOfficeHighlightLocation, } from './models/office-highlight';
 export { injectCitationSentinels, replaceSentinelsInChildren, stripCitTagsWhileStreaming, } from './utils/citation-injection';
 export { isReferenceOnlyAttachment, parsePdfPageReference, getReferenceAttachmentGroups, } from './utils/reference-attachment';
 export type { PdfPageReference } from './utils/reference-attachment';
+export { QUOTATIONS_CLASS } from './constants/public-class-names';
 //# sourceMappingURL=index.d.ts.map

package/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACtE,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,YAAY,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAG5F,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qEAAqE,CAAC;AACpH,YAAY,EAAE,sCAAsC,EAAE,MAAM,qEAAqE,CAAC;AAGlI,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oCAAoC,EACpC,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,2BAA2B,EAC3B,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,wCAAwC,CAAC;AACtE,YAAY,EACV,kBAAkB,EAClB,kBAAkB,EAClB,iBAAiB,EACjB,sBAAsB,GACvB,MAAM,wCAAwC,CAAC;AAEhD,OAAO,EAAE,cAAc,EAAE,MAAM,4CAA4C,CAAC;AAC5E,YAAY,EACV,oBAAoB,EACpB,mBAAmB,GACpB,MAAM,4CAA4C,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gDAAgD,CAAC;AAClF,YAAY,EAAE,qBAAqB,EAAE,MAAM,gDAAgD,CAAC;AAG5F,OAAO,EACL,oBAAoB,EACpB,sBAAsB,GACvB,MAAM,+BAA+B,CAAC;AACvC,YAAY,EAAE,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGtE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,6BAA6B,EAAE,MAAM,qEAAqE,CAAC;AACpH,YAAY,EAAE,sCAAsC,EAAE,MAAM,qEAAqE,CAAC;AAGlI,OAAO,EACL,2BAA2B,EAC3B,gBAAgB,EAChB,uBAAuB,EACvB,wBAAwB,GACzB,MAAM,qCAAqC,CAAC;AAC7C,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EACL,qBAAqB,EACrB,0BAA0B,EAC1B,oCAAoC,EACpC,oBAAoB,EACpB,mBAAmB,EACnB,sBAAsB,EACtB,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EACV,2BAA2B,EAC3B,mCAAmC,EACnC,4BAA4B,EAC5B,uBAAuB,EACvB,2BAA2B,EAC3B,mCAAmC,GACpC,MAAM,2BAA2B,CAAC;AAEnC,OAAO,EACL,uBAAuB,EACvB,0BAA0B,EAC1B,0BAA0B,GAC3B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EACL,yBAAyB,EACzB,qBAAqB,EACrB,4BAA4B,GAC7B,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/index.js

@@ -2,15 +2,20 @@ import { MIMEType as e, MarkdownRenderer as t, buildCssVars as n, isAnnotationSe
 import { DIAL_KIT_ICON_STROKE as s, ElementSize as c, EllipsisTooltip as l, GhostIconButton as u, NeutralButton as d, PrimaryButton as f, Tooltip as p } from "@epam/ai-dial-ui-kit";
 import { IconChevronLeft as m, IconChevronRight as h } from "@tabler/icons-react";
 import { Fragment as g, jsx as _, jsxs as v } from "react/jsx-runtime";
-import { createContext as y, useCallback as b, useContext as x, useMemo as S, useState as C } from "react";
-var w = {
+import { createContext as y, useCallback as b, useContext as x, useId as S, useMemo as C, useState as w } from "react";
+//#region src/constants/public-class-names.ts
+var T = {
+	citationCard: "dial-quotations-citation-card",
+	citationDropdown: "dial-quotations-citation-dropdown",
+	citationMarker: "dial-quotations-citation-marker"
+}, E = {
 	card: "_card_1kph1_1",
 	quote: "_quote_1kph1_5",
 	title: "_title_1kph1_9",
 	switcher: "_switcher_1kph1_13",
 	sourceName: "_sourceName_1kph1_17"
-}, T = ({ group: r, activeIndex: a, onIndexChange: o, onPreview: d, onOpenInBrowser: p, headerIcon: g, labels: y, typography: b, colors: x }) => {
-	let S = r.annotations.length, C = r.annotations[a] ?? r.primaryAnnotation, T = S > 1, E = r.primaryAnnotation.body?.source?.attachment?.type, D = d == null || E === e.HTML || E === e.XHTML, O = b?.sourceNameClassName ?? "dial-tiny-text", k = b?.titleClassName ?? "dial-body-semi-text", A = b?.quoteClassName ?? "dial-small-text", j = b?.quoteStrongClassName ?? "dial-small-semi-text", M = b?.switcherClassName ?? "dial-tiny-text", N = n({
+}, D = ({ group: r, activeIndex: a, onIndexChange: o, onPreview: d, onOpenInBrowser: p, headerIcon: g, labels: y, typography: b, colors: x }) => {
+	let S = r.annotations.length, C = r.annotations[a] ?? r.primaryAnnotation, w = S > 1, D = C.body?.source?.attachment?.type, O = d == null || D === e.HTML || D === e.XHTML, k = b?.sourceNameClassName ?? "dial-tiny-text", A = b?.titleClassName ?? "dial-body-semi-text", j = b?.quoteClassName ?? "dial-small-text", M = b?.quoteStrongClassName ?? "dial-small-semi-text", N = b?.switcherClassName ?? "dial-tiny-text", P = n({
 		"--cc-card-bg": x?.cardBackground,
 		"--cc-quote-text": x?.quoteText,
 		"--cc-title-text": x?.titleText,
@@ -21,8 +26,8 @@ var w = {
 		role: "dialog",
 		"aria-modal": "true",
 		"aria-label": y.ariaLabel,
-		style: N,
-		className: i("flex w-[400px] flex-col gap-3 rounded-lg p-4 shadow-lg", w.card),
+		style: P,
+		className: i("flex w-[400px] flex-col gap-3 rounded-lg p-4 shadow-lg", E.card, T.citationCard),
 		children: [
 			/* @__PURE__ */ v("div", {
 				className: "flex items-center justify-between gap-2",
@@ -30,9 +35,9 @@ var w = {
 					className: "flex min-w-0 items-center gap-1",
 					children: [g, /* @__PURE__ */ _(l, {
 						text: r.sourceName,
-						className: i(O, "min-w-0", w.sourceName)
+						className: i(k, "min-w-0", E.sourceName)
 					})]
-				}), T && /* @__PURE__ */ v("div", {
+				}), w && /* @__PURE__ */ v("div", {
 					className: "flex shrink-0 items-center gap-1",
 					children: [
 						/* @__PURE__ */ _(u, {
@@ -46,7 +51,7 @@ var w = {
 							onClick: () => o((a - 1 + S) % S)
 						}),
 						/* @__PURE__ */ _("span", {
-							className: i(M, w.switcher),
+							className: i(N, E.switcher),
 							children: y.formatSwitcherText(a + 1, S)
 						}),
 						/* @__PURE__ */ _(u, {
@@ -62,20 +67,20 @@ var w = {
 					]
 				})]
 			}),
-			(C.body?.title || C.body?.quote || T) && /* @__PURE__ */ v("div", {
+			(C.body?.title || C.body?.quote || w) && /* @__PURE__ */ v("div", {
 				className: "flex flex-col gap-3",
 				children: [C.body?.title && /* @__PURE__ */ _("p", {
-					className: i(k, w.title, "break-words"),
+					className: i(A, E.title, "break-words"),
 					children: C.body.title
-				}), (C.body?.quote || T) && /* @__PURE__ */ _("div", {
-					className: i(A, w.quote, "line-clamp-6 break-words", T && "min-h-[3lh]"),
+				}), (C.body?.quote || w) && /* @__PURE__ */ _("div", {
+					className: i(j, E.quote, "line-clamp-6 break-words", w && "min-h-[3lh]"),
 					children: C.body?.quote && /* @__PURE__ */ _(t, {
 						content: C.body.quote,
 						classNames: {
-							p: i(A, w.quote),
-							ul: i(A, "ps-3"),
-							ol: i(A, "ps-3"),
-							strong: j
+							p: i(j, E.quote),
+							ul: i(j, "ps-3"),
+							ol: i(j, "ps-3"),
+							strong: M
 						}
 					})
 				})]
@@ -87,68 +92,97 @@ var w = {
 					size: c.Small,
 					onClick: () => d(C)
 				}), /* @__PURE__ */ _(f, {
-					label: D ? y.openInBrowser : y.download,
+					label: O ? y.openInBrowser : y.download,
 					size: c.Small,
 					onClick: () => p(C)
 				})]
 			})
 		]
 	});
-}, E = ({ annotationCount: e, onOpen: t, icon: n, labels: r, labelClassName: i = "dial-caption-text" }) => {
-	let a = /* @__PURE__ */ v("span", {
-		className: "flex items-center gap-1",
-		children: [n, /* @__PURE__ */ _("span", {
-			className: i,
-			children: e > 1 ? r.labelWithOverflow : r.label
-		})]
-	});
-	return /* @__PURE__ */ _(d, {
-		size: c.Small,
-		label: a,
-		"aria-label": r.ariaLabel,
-		onClick: t
-	});
-}, D = y(null), O = D.Provider, k = () => {
-	let e = x(D);
+}, O = ({ annotationCount: e, onOpen: t, icon: n, labels: r, labelClassName: a = "dial-caption-text" }) => /* @__PURE__ */ _(d, {
+	size: c.Small,
+	className: i("max-w-[240px]", T.citationMarker),
+	textClassName: "min-w-0 truncate",
+	iconBefore: n,
+	label: /* @__PURE__ */ _("span", {
+		className: a,
+		children: e > 1 ? r.labelWithOverflow : r.label
+	}),
+	"aria-label": r.ariaLabel,
+	onClick: t
+}), k = y(null), A = k.Provider, j = () => {
+	let e = x(k);
 	if (e == null) throw Error("useCitationCardContext must be used within a CitationCardProvider");
 	return e;
-}, A = { content: "_content_xzs0h_1" }, j = ({ group: e, onPreview: t, onOpenInBrowser: n, icon: r, headerIcon: a, cardLabels: o, markerLabels: s, cardTypography: c, markerLabelClassName: l }) => {
-	let u = k(), d = u.isOpen(e.groupKey), f = u.getActiveIndex(e.groupKey), m = b((e) => {
-		e || u.closePopup();
-	}, [u]), h = S(() => t ? (e) => {
-		t(e), u.closePopup();
-	} : void 0, [t, u]);
+}, M = { content: "_content_xzs0h_1" }, N = ({ group: e, onPreview: t, isPreviewable: n, onOpenInBrowser: r, icon: a, headerIcon: o, cardLabels: s, markerLabels: c, cardTypography: l, markerLabelClassName: u }) => {
+	let d = j(), f = S(), m = d.isOpen(f), h = d.getActiveIndex(e.groupKey), g = e.annotations[h] ?? e.primaryAnnotation, v = n?.(g) ?? !0, y = b((e) => {
+		e || d.closePopup(f);
+	}, [d, f]), x = C(() => t && v ? (e) => {
+		t(e), d.closePopup(f);
+	} : void 0, [
+		t,
+		v,
+		d,
+		f
+	]);
 	return /* @__PURE__ */ _(p, {
-		open: d,
-		onOpenChange: m,
+		open: m,
+		onOpenChange: y,
 		triggerClassName: "ms-1 inline-flex align-middle",
-		contentClassName: i("!p-0 !bg-transparent !border-0 !shadow-none !max-w-none !rounded-none", A.content),
-		tooltip: /* @__PURE__ */ _(T, {
+		contentClassName: i("!p-0 !bg-transparent !border-0 !shadow-none !max-w-none !rounded-none", M.content, T.citationDropdown),
+		tooltip: /* @__PURE__ */ _(D, {
 			group: e,
-			activeIndex: f,
-			onIndexChange: (t) => u.setActiveIndex(e.groupKey, t),
-			onPreview: h,
-			onOpenInBrowser: n,
-			headerIcon: a,
-			labels: o,
-			typography: c
+			activeIndex: h,
+			onIndexChange: (t) => d.setActiveIndex(e.groupKey, t),
+			onPreview: x,
+			onOpenInBrowser: r,
+			headerIcon: o,
+			labels: s,
+			typography: l
 		}),
-		children: /* @__PURE__ */ _(E, {
+		children: /* @__PURE__ */ _(O, {
 			sourceName: e.sourceName,
 			annotationCount: e.annotations.length,
-			onOpen: () => u.openPopup(e.groupKey),
-			icon: r,
-			labels: s,
-			labelClassName: l
+			onOpen: () => d.openPopup(f),
+			icon: a,
+			labels: c,
+			labelClassName: u
 		})
 	});
-}, M = {
+}, P = (e) => {
+	let t = e.trim();
+	if (!t.startsWith("|") || !t.endsWith("|") || /[\r\n]/.test(t)) return;
+	let n = [], r = "";
+	for (let e = 1; e < t.length; e += 1) {
+		let i = t[e], a = t[e + 1];
+		i === "\\" && a != null && /[!-/:-@[-`{-~]/.test(a) ? (r += a, e += 1) : i === "|" ? (n.push(r.trim()), r = "") : r += i;
+	}
+	if (!(r !== "" || n.length < 2 || n.every((e) => e === "" || /^:?-{3,}:?$/.test(e)))) return n;
+}, ee = (e) => {
+	if (e.type !== "docx_text_anchor" && e.type !== "pptx_text_anchor") return;
+	let { text: t, occurrence: n, slide: r } = e;
+	if (typeof t != "string" || typeof n != "number" || !Number.isSafeInteger(n) || n < 1) return;
+	let i = P(t);
+	if (i != null) {
+		if (e.type === "docx_text_anchor") return {
+			type: "docx_text_anchor",
+			cells: i,
+			occurrence: n
+		};
+		if (!(typeof r != "number" || !Number.isSafeInteger(r) || r < 1)) return {
+			type: "pptx_text_anchor",
+			cells: i,
+			occurrence: n,
+			slide: r
+		};
+	}
+}, te = {
 	backgroundColor: "transparent",
 	borderColor: "var(--stroke-accent, #1D4ED8)",
 	borderWidth: "2px",
 	opacity: .5,
 	hoverOpacity: .5
-}, N = (e) => {
+}, ne = (e) => {
 	if (typeof e != "object" || !e) return;
 	let t = e, { lt: n, wh: r } = t;
 	if (Array.isArray(n) && Array.isArray(r) && n.length >= 2 && r.length >= 2) {
@@ -167,7 +201,7 @@ var w = {
 		x2: i + o,
 		y2: a + s
 	};
-}, P = (e) => {
+}, F = (e) => {
 	if (!r(e)) return;
 	let t = e, n;
 	if (t.type === "pdf_bbox") {
@@ -178,7 +212,7 @@ var w = {
 			x2: i,
 			y2: a
 		});
-	} else t.type === "pdf_region" && (n = N(t.bbox));
+	} else t.type === "pdf_region" && (n = ne(t.bbox));
 	if (n == null) return;
 	let i = t.page;
 	if (!(typeof i != "number" || !Number.isInteger(i) || i < 1) && [
@@ -193,48 +227,63 @@ var w = {
 		x2: n.x2,
 		y2: n.y2
 	};
-}, ee = (e) => e.flatMap((e, t) => {
+}, I = (e) => typeof e != "object" || !e ? String(e) : Array.isArray(e) ? `[${e.map(I).join(",")}]` : `{${Object.entries(e).filter(([, e]) => e !== void 0).sort(([e], [t]) => e < t ? -1 : +(e > t)).map(([e, t]) => `${e}=${I(t)}`).join(",")}}`, re = (e) => {
+	let t = 5381;
+	for (let n = 0; n < e.length; n += 1) t = t * 33 + e.charCodeAt(n) | 0;
+	return (t >>> 0).toString(36);
+}, ie = (e) => {
+	let t = e.body?.selector;
+	if (t == null) return;
+	let n = (Array.isArray(t) ? t : [t]).flatMap((e) => {
+		let t = F(e);
+		return t == null ? [] : [t];
+	}), r = U(e);
+	if (!(n.length === 0 && r.length === 0)) return I([n, r]);
+}, ae = (e) => {
+	let t = e.target?.selector, n = t?.type === "html_tag" ? t.id : void 0, r = typeof n == "string" ? n : void 0, i = ie(e);
+	if (!(r == null && i == null)) return re(`${r ?? ""}|${i ?? ""}`);
+}, oe = (e) => e.flatMap((e, t) => {
 	let n = e.body?.selector;
 	if (n == null) return [];
 	let i = (Array.isArray(n) ? n : [n]).flatMap((e) => {
 		if (!r(e)) return [];
-		let t = P(e);
+		let t = F(e);
 		return t == null ? [] : [t];
 	});
 	return i.length === 0 ? [] : [{
-		id: String(e.index ?? t),
+		id: L(e, t),
 		bboxes: i,
-		style: M
+		style: te
 	}];
-}), te = (e, t) => String(e.index ?? t), ne = (e) => {
+}), L = (e, t) => e.index == null ? ae(e) ?? String(t) : String(e.index), se = (e) => {
 	let t = e.body?.selector;
 	if (t == null) return;
 	let n = Array.isArray(t) ? t : [t];
 	for (let e of n) {
 		if (!r(e)) continue;
-		let t = P(e);
+		let t = F(e);
 		if (t != null) return t.page;
 	}
-}, F = (e) => {
+}, R = (e) => {
 	let t = e.custom_content?.annotations;
 	if (t?.length) return t.filter((e) => e != null && e.body?.source?.attachment?.url != null).map(a);
 	let n = e.custom_fields;
 	if (typeof n != "object" || !n) return [];
 	let r = n.annotations;
 	return !Array.isArray(r) || r.length === 0 ? [] : o(r, e.custom_content?.attachments ?? []).map(a);
-}, I = (e) => {
+}, z = (e) => {
 	if (e.type !== "docx_text_range") return !1;
 	let t = e;
 	return typeof t.story == "string" && Array.isArray(t.path) && t.path.every((e) => typeof e == "number") && typeof t.start == "number" && typeof t.end == "number" && typeof t.text == "string";
-}, L = (e) => {
+}, B = (e) => {
 	if (e.type !== "pptx_text_range") return !1;
 	let t = e;
 	return typeof t.slide == "number" && typeof t.shape_id == "string" && typeof t.start == "number" && typeof t.end == "number" && typeof t.text == "string";
-}, R = (e) => typeof e == "object" && !!e && typeof e.row == "number" && typeof e.col == "number", z = (e) => {
+}, V = (e) => typeof e == "object" && !!e && typeof e.row == "number" && typeof e.col == "number", H = (e) => {
 	if (e.type !== "excel_rc_range") return !1;
 	let t = e;
-	return typeof t.sheet == "string" && R(t.start) && (t.end === void 0 || t.end === null || R(t.end));
-}, re = (e) => {
+	return typeof t.sheet == "string" && V(t.start) && (t.end === void 0 || t.end === null || V(t.end));
+}, ce = (e) => {
 	let { story: t, path: n, start: r, end: i, text: a } = e;
 	if (!(!n.every((e) => Number.isInteger(e)) || !Number.isInteger(r) || !Number.isInteger(i) || r < 0 || i < r)) return {
 		type: "docx_text_range",
@@ -244,7 +293,7 @@ var w = {
 		endExclusive: i,
 		text: a
 	};
-}, ie = (e) => {
+}, le = (e) => {
 	let { slide: t, shape_id: n, start: r, end: i, text: a } = e;
 	if (!(!Number.isInteger(t) || t < 1 || !Number.isInteger(r) || !Number.isInteger(i) || r < 0 || i < r)) return {
 		type: "pptx_text_range",
@@ -254,7 +303,7 @@ var w = {
 		endExclusive: i,
 		text: a
 	};
-}, ae = (e) => {
+}, ue = (e) => {
 	let { sheet: t, start: n, end: r } = e;
 	if (!(t.length === 0 || !Number.isInteger(n.row) || !Number.isInteger(n.col) || n.row < 1 || n.col < 1)) {
 		if (r == null) return {
@@ -269,38 +318,39 @@ var w = {
 			end: r
 		};
 	}
-}, oe = (e) => {
+}, U = (e) => {
 	let t = e.body?.selector;
 	return t == null ? [] : (Array.isArray(t) ? t : [t]).flatMap((e) => {
 		if (!r(e)) return [];
-		if (I(e)) {
-			let t = re(e);
+		if (z(e)) {
+			let t = ce(e);
 			return t ? [t] : [];
 		}
-		if (L(e)) {
-			let t = ie(e);
+		if (B(e)) {
+			let t = le(e);
 			return t ? [t] : [];
 		}
-		if (z(e)) {
-			let t = ae(e);
+		if (H(e)) {
+			let t = ue(e);
 			return t ? [t] : [];
 		}
-		return [];
+		let t = ee(e);
+		return t ? [t] : [];
 	});
-}, se = (e, t) => S(() => t ? [] : F(e), [t, e]), ce = {
-	openGroupKey: null,
+}, de = (e, t) => C(() => t ? [] : R(e), [t, e]), fe = {
+	openOwnerKey: null,
 	activeIndexByGroup: {}
-}, le = () => {
-	let [e, t] = C(ce), n = b((e) => {
+}, pe = () => {
+	let [e, t] = w(fe), n = b((e) => {
 		t((t) => ({
 			...t,
-			openGroupKey: e
-		}));
-	}, []), r = b(() => {
-		t((e) => ({
-			...e,
-			openGroupKey: null
+			openOwnerKey: e
 		}));
+	}, []), r = b((e) => {
+		t((t) => t.openOwnerKey === e ? {
+			...t,
+			openOwnerKey: null
+		} : t);
 	}, []), i = b((e, n) => {
 		t((t) => ({
 			...t,
@@ -310,11 +360,11 @@ var w = {
 			}
 		}));
 	}, []);
-	return S(() => ({
+	return C(() => ({
 		openPopup: n,
 		closePopup: r,
 		setActiveIndex: i,
-		isOpen: (t) => e.openGroupKey === t,
+		isOpen: (t) => e.openOwnerKey === t,
 		getActiveIndex: (t) => e.activeIndexByGroup[t] ?? 0
 	}), [
 		n,
@@ -322,7 +372,7 @@ var w = {
 		i,
 		e
 	]);
-}, ue = /⟦C(\d+)⟧/g, B = (e, t) => {
+}, me = /⟦C(\d+)⟧/g, W = (e, t) => {
 	let n = t.map((e, t) => ({
 		g: e,
 		idx: t
@@ -335,9 +385,9 @@ var w = {
 	}).sort((e, t) => t.pos - e.pos), r = e;
 	for (let { idx: e, pos: t } of n) r = `${r.slice(0, t)}⟦C${e}⟧${r.slice(t)}`;
 	return r;
-}, V = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>/g, H = /^<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>$/, de = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>|<\/?cit\b[^>]*>|<\/?cit\b[^>]*$/gi, fe = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), U = (e) => e.replace(de, (e) => H.test(e) ? e : fe(e)), W = (e) => U(e).replace(V, ""), G = (e, t) => {
+}, he = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>/g, ge = /^<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>$/, _e = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>|<\/?cit\b[^>]*>|<\/?cit\b[^>]*$/gi, ve = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), G = (e) => e.replace(_e, (e) => ge.test(e) ? e : ve(e)), K = (e) => G(e).replace(he, ""), q = (e, t) => {
 	if (typeof e == "string") {
-		let n = e.split(ue);
+		let n = e.split(me);
 		if (n.length === 1) return e;
 		let r = [];
 		return n.forEach((e, n) => {
@@ -345,57 +395,58 @@ var w = {
 		}), r;
 	}
 	return Array.isArray(e) ? e.flatMap((e) => {
-		let n = G(e, t);
+		let n = q(e, t);
 		return Array.isArray(n) ? n : [n];
 	}) : e;
-}, pe = (e) => {
+}, ye = (e) => {
 	let t = e.primaryAnnotation.target?.selector;
 	return t?.type === "html_tag" ? t.id : void 0;
-}, me = (e, t) => /* @__PURE__ */ v(g, { children: [
+}, be = (e, t) => /* @__PURE__ */ v(g, { children: [
 	e == null ? "<cit>" : `<cit data-id="${e}">`,
 	t,
 	"</cit>"
-] }), he = (e, t, n, r = !1, a = !1) => {
-	let { onPreview: o, onOpenInBrowser: s, buildLabels: c } = n, l = S(() => r ? W(e) : U(t.length > 0 ? B(e, t) : e), [
+] }), xe = (e, t, n, r = !1, a = !1) => {
+	let { onPreview: o, isPreviewable: s, onOpenInBrowser: c, buildLabels: l } = n, u = C(() => r ? K(e) : G(t.length > 0 ? W(e, t) : e), [
 		e,
 		t,
 		r
-	]), u = l.includes("<cit");
+	]), d = u.includes("<cit");
 	return {
-		processedContent: l,
-		markdownComponents: S(() => {
+		processedContent: u,
+		markdownComponents: C(() => {
 			let e = /* @__PURE__ */ new Map();
 			for (let n of t) {
-				let t = pe(n);
+				let t = ye(n);
 				t != null && e.set(t, n);
 			}
 			let n = (e) => {
-				let { cardLabels: t, markerLabels: n } = c(e);
-				return /* @__PURE__ */ _(j, {
+				let { cardLabels: t, markerLabels: n } = l(e);
+				return /* @__PURE__ */ _(N, {
 					group: e,
 					onPreview: (t) => o(t, e),
-					onOpenInBrowser: s,
+					isPreviewable: s,
+					onOpenInBrowser: c,
 					cardLabels: t,
 					markerLabels: n
 				}, `citation-${e.groupKey}`);
 			}, r = (e) => {
 				let r = t[e];
 				return r ? n(r) : null;
-			}, l = { cit: (t) => {
+			}, u = { cit: (t) => {
 				let r = t["data-id"] == null ? void 0 : e.get(t["data-id"]);
-				return r ? n(r) : me(t["data-id"], t.children);
+				return r ? n(r) : be(t["data-id"], t.children);
 			} };
-			return t.length === 0 ? u ? l : {} : {
-				...l,
+			return t.length === 0 ? d ? u : {} : {
+				...u,
 				p: ({ children: e, ...t }) => /* @__PURE__ */ _("p", {
 					...t,
 					className: i(a ? "dial-small-paragraph-text" : "dial-body-paragraph-text", "mb-3 [overflow-wrap:anywhere] [text-wrap:pretty] last:mb-0"),
-					children: G(e, r)
+					children: q(e, r)
 				}),
 				li: ({ children: e, ...t }) => /* @__PURE__ */ _("li", {
 					...t,
 					className: "mb-1.5 last:mb-0",
-					children: G(e, r)
+					children: q(e, r)
 				})
 			};
 		}, [
@@ -403,46 +454,47 @@ var w = {
 			o,
 			s,
 			c,
+			l,
 			a,
-			u
+			d
 		])
 	};
-}, K = (e) => {
+}, J = (e) => {
 	try {
 		return decodeURIComponent(e);
 	} catch {
 		return e;
 	}
-}, ge = (e) => {
+}, Se = (e) => {
 	try {
 		let t = new URL(e);
-		return t.pathname.split("/").map((e) => K(e)).filter(Boolean).at(-1) ?? t.hostname;
+		return t.pathname.split("/").map((e) => J(e)).filter(Boolean).at(-1) ?? t.hostname;
 	} catch {
-		return e.split("/").map((e) => K(e)).filter(Boolean).at(-1) ?? e;
+		return e.split("/").map((e) => J(e)).filter(Boolean).at(-1) ?? e;
 	}
-}, q = (e, t) => e.body?.source?.attachment?.title ?? ge(t), J = (e) => {
+}, Y = (e, t) => e.body?.source?.attachment?.title ?? Se(t), X = (e) => {
 	let t = e.target?.selector;
 	return t?.type === "html_tag" ? t : void 0;
-}, _e = (e) => J(e) != null, Y = (e) => {
+}, Ce = (e) => X(e) != null, Z = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
-		if (_e(n)) continue;
+		if (Ce(n)) continue;
 		let e = n.body?.source?.attachment?.url;
 		if (e == null) continue;
 		let r = t.get(e);
 		r ? r.annotations.push(n) : t.set(e, {
 			groupKey: e,
 			sourceUrl: e,
-			sourceName: q(n, e),
+			sourceName: Y(n, e),
 			annotations: [n],
 			primaryAnnotation: n
 		});
 	}
 	return Array.from(t.values());
-}, X = (e) => {
+}, Q = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
-		let e = J(n)?.id;
+		let e = X(n)?.id;
 		if (e == null) continue;
 		let r = n.body?.source?.attachment?.url;
 		if (r == null) continue;
@@ -450,22 +502,22 @@ var w = {
 		i ? i.annotations.push(n) : t.set(e, {
 			groupKey: `cit:${e}`,
 			sourceUrl: r,
-			sourceName: q(n, r),
+			sourceName: Y(n, r),
 			annotations: [n],
 			primaryAnnotation: n
 		});
 	}
 	return Array.from(t.values());
-}, ve = (e) => [...X(e), ...Y(e)], Z = (e, t) => {
+}, we = (e) => [...Q(e), ...Z(e)], Te = (e, t) => {
 	let n = e.body?.source?.attachment?.url;
 	return n == null || !t.includes(e) ? [e] : t.filter((e) => e.body?.source?.attachment?.url === n);
-}, Q = (e) => e.url == null && e.reference_url != null, ye = /^(.*\.pdf)(?:#page=(\d+))?$/i, $ = (e) => {
-	let t = ye.exec(e);
+}, Ee = (e) => e.url == null && e.reference_url != null, De = /^(.*\.pdf)(?:#page=(\d+))?$/i, $ = (e) => {
+	let t = De.exec(e);
 	return t ? {
 		baseUrl: t[1],
 		page: t[2] == null ? null : Number(t[2])
 	} : null;
-}, be = (t) => Y((t ?? []).filter(Q).map((t) => {
+}, Oe = (t) => Z((t ?? []).filter(Ee).map((t) => {
 	let n = t.reference_url, r = $(n) != null;
 	return { body: {
 		quote: t.data,
@@ -480,4 +532,4 @@ var w = {
 	} };
 }));
 //#endregion
-export { T as CitationCard, O as CitationCardProvider, j as CitationDropdown, E as CitationMarker, te as annotationHighlightId, oe as annotationToOfficeHighlightLocations, ee as annotationsToPdfHighlights, Z as gatherSameSourceAnnotations, ne as getAnnotationPdfPage, be as getReferenceAttachmentGroups, ve as groupAnnotations, X as groupAnnotationsByCitId, Y as groupAnnotationsBySource, B as injectCitationSentinels, I as isDocxRangeSelector, z as isExcelRcRangeSelector, L as isPptxRangeSelector, Q as isReferenceOnlyAttachment, $ as parsePdfPageReference, G as replaceSentinelsInChildren, F as resolveMessageAnnotations, W as stripCitTagsWhileStreaming, se as useAnnotations, le as useCitationCard, k as useCitationCardContext, he as useCitationMarkdownComponents };
+export { D as CitationCard, A as CitationCardProvider, N as CitationDropdown, O as CitationMarker, T as QUOTATIONS_CLASS, L as annotationHighlightId, U as annotationToOfficeHighlightLocations, oe as annotationsToPdfHighlights, Te as gatherSameSourceAnnotations, se as getAnnotationPdfPage, Oe as getReferenceAttachmentGroups, we as groupAnnotations, Q as groupAnnotationsByCitId, Z as groupAnnotationsBySource, W as injectCitationSentinels, z as isDocxRangeSelector, H as isExcelRcRangeSelector, B as isPptxRangeSelector, Ee as isReferenceOnlyAttachment, $ as parsePdfPageReference, q as replaceSentinelsInChildren, R as resolveMessageAnnotations, K as stripCitTagsWhileStreaming, de as useAnnotations, pe as useCitationCard, j as useCitationCardContext, xe as useCitationMarkdownComponents };

package/models/office-highlight.d.ts

@@ -38,6 +38,26 @@ export interface PptxOfficeHighlightLocation {
     /** The cited text, expected to equal the text resolved over `[start, endExclusive)`. */
     text: string;
 }
+/** Temporary table-row location decoded from a DOCX text anchor. */
+export interface DocxTableRowOfficeHighlightLocation {
+    /** Wire selector type. */
+    type: 'docx_text_anchor';
+    /** Plain text of each cell, in column order. */
+    cells: string[];
+    /** 1-based matching row in the document body. */
+    occurrence: number;
+}
+/** Temporary table-row location decoded from a PPTX text anchor. */
+export interface PptxTableRowOfficeHighlightLocation {
+    /** Wire selector type. */
+    type: 'pptx_text_anchor';
+    /** Plain text of each cell, in column order. */
+    cells: string[];
+    /** 1-based matching row on the specified slide. */
+    occurrence: number;
+    /** 1-based slide number. */
+    slide: number;
+}
 /** A validated, normalised XLSX cell or same-row cell-range location. */
 export interface ExcelOfficeHighlightLocation {
     /** Discriminates this location within `OfficeHighlightLocation`. Mirrors the wire selector's `type`. */
@@ -58,5 +78,5 @@ export interface ExcelOfficeHighlightLocation {
  * cycle is not permitted). `libs/chat-hooks`, which already depends on both,
  * maps this into `OoxmlHighlight`/`OoxmlHighlightLocation`.
  */
-export type OfficeHighlightLocation = DocxOfficeHighlightLocation | PptxOfficeHighlightLocation | ExcelOfficeHighlightLocation;
+export type OfficeHighlightLocation = DocxOfficeHighlightLocation | PptxOfficeHighlightLocation | DocxTableRowOfficeHighlightLocation | PptxTableRowOfficeHighlightLocation | ExcelOfficeHighlightLocation;
 //# sourceMappingURL=office-highlight.d.ts.map

package/models/office-highlight.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"office-highlight.d.ts","sourceRoot":"","sources":["../../src/models/office-highlight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wGAAwG;IACxG,IAAI,EAAE,iBAAiB,CAAC;IACxB,4GAA4G;IAC5G,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wGAAwG;IACxG,IAAI,EAAE,iBAAiB,CAAC;IACxB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,yEAAyE;AACzE,MAAM,WAAW,4BAA4B;IAC3C,wGAAwG;IACxG,IAAI,EAAE,gBAAgB,CAAC;IACvB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,KAAK,EAAE,gBAAgB,CAAC;IACxB,iGAAiG;IACjG,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAC/B,2BAA2B,GAC3B,2BAA2B,GAC3B,4BAA4B,CAAC"}
+{"version":3,"file":"office-highlight.d.ts","sourceRoot":"","sources":["../../src/models/office-highlight.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAElE;;;;;GAKG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wGAAwG;IACxG,IAAI,EAAE,iBAAiB,CAAC;IACxB,4GAA4G;IAC5G,KAAK,EAAE,MAAM,CAAC;IACd,mFAAmF;IACnF,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,2BAA2B;IAC1C,wGAAwG;IACxG,IAAI,EAAE,iBAAiB,CAAC;IACxB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,EAAE,MAAM,CAAC;IACd,iDAAiD;IACjD,YAAY,EAAE,MAAM,CAAC;IACrB,wFAAwF;IACxF,IAAI,EAAE,MAAM,CAAC;CACd;AAED,oEAAoE;AACpE,MAAM,WAAW,mCAAmC;IAClD,0BAA0B;IAC1B,IAAI,EAAE,kBAAkB,CAAC;IACzB,gDAAgD;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,oEAAoE;AACpE,MAAM,WAAW,mCAAmC;IAClD,0BAA0B;IAC1B,IAAI,EAAE,kBAAkB,CAAC;IACzB,gDAAgD;IAChD,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;IACnB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,yEAAyE;AACzE,MAAM,WAAW,4BAA4B;IAC3C,wGAAwG;IACxG,IAAI,EAAE,gBAAgB,CAAC;IACvB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,KAAK,EAAE,gBAAgB,CAAC;IACxB,iGAAiG;IACjG,GAAG,CAAC,EAAE,gBAAgB,CAAC;CACxB;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,uBAAuB,GAC/B,2BAA2B,GAC3B,2BAA2B,GAC3B,mCAAmC,GACnC,mCAAmC,GACnC,4BAA4B,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@epam/ai-dial-quotations",
   "description": "Citation and annotation components, hooks, and utilities for AI DIAL conversations",
-  "version": "1.2.0-dev.1",
+  "version": "1.2.0-dev.102",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -23,8 +23,8 @@
   },
   "peerDependencies": {
     "react": "^19.2.8",
-    "@epam/ai-dial-chat-shared": "1.2.0-dev.1",
-    "@epam/ai-dial-ui-kit": "^0.14.2"
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.102",
+    "@epam/ai-dial-ui-kit": "^0.15.0-dev.12"
   },
   "repository": {
     "type": "git",

package/utils/annotation.d.ts

@@ -5,11 +5,34 @@ import { OfficeHighlightLocation } from '../models/office-highlight';
  * Maps a list of annotations to `InputHighlightData` entries for the PDF viewer.
  * Recognizes `pdf_bbox` selectors and both `pdf_region` coordinate forms
  * (`lt`/`wh` and legacy `left`/`top`/`width`/`height`); annotations whose
- * `body.selector` contains none of these are skipped. The highlight `id` is
- * `annotation.index` when present, otherwise the position in the input array.
+ * `body.selector` contains none of these are skipped. The highlight `id` comes
+ * from `annotationHighlightId`, so it identifies the annotation itself rather
+ * than its position in this particular input list.
  */
 export declare const annotationsToPdfHighlights: (annotations: Annotation[]) => InputHighlightData[];
-/** Returns a stable string ID for a given annotation, matching the IDs produced by `annotationsToPdfHighlights`. */
+/**
+ * Returns a stable string ID for a given annotation, matching the IDs
+ * `annotationsToPdfHighlights` produces (it calls this function) and the ones
+ * the Office highlight path assigns.
+ *
+ * Resolved in order:
+ * 1. `annotation.index` when the wire supplied one — already unique within the
+ *    message, and short.
+ * 2. Otherwise an id derived from the annotation's own identity: its `cit` tag
+ *    id plus a digest of its selectors. Two annotations differing in either
+ *    part get different ids; two agreeing in both describe the same cited
+ *    region and may share one.
+ * 3. Otherwise `fallbackIndex` — the annotation's position in the caller's
+ *    list, for an annotation carrying neither an index, a `cit` id, nor a
+ *    recognised selector.
+ *
+ * The id is opaque: compare it, never parse it. A position-derived id is not
+ * unique beyond the list it came from, which is why it is the last resort — a
+ * caller gathering one citation group at a time would otherwise give every
+ * single-annotation group the same id, and the canvas could not tell two
+ * citations of one document apart (issue #8907). Ids are never persisted and
+ * never sent over the wire.
+ */
 export declare const annotationHighlightId: (annotation: Annotation, fallbackIndex: number) => string;
 /**
  * Returns the first positive integer PDF page in the annotation's body selectors,
@@ -45,7 +68,7 @@ export declare const isExcelRcRangeSelector: (selector: AnnotationSelector) => s
 /**
  * Converts an annotation's `body.selector` (scalar or array) to validated
  * `OfficeHighlightLocation` entries, skipping any selector that is not a
- * recognised Office range or that fails validation — never throwing.
+ * recognised Office range or temporary table-row anchor, or that fails validation.
  */
 export declare const annotationToOfficeHighlightLocations: (annotation: Annotation) => OfficeHighlightLocation[];
 //# sourceMappingURL=annotation.d.ts.map

package/utils/annotation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../src/utils/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,OAAO,EACP,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAGV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAqG1E;;;;;;GAMG;AACH,eAAO,MAAM,0BAA0B,GACrC,aAAa,UAAU,EAAE,KACxB,kBAAkB,EAoBjB,CAAC;AAEL,oHAAoH;AACpH,eAAO,MAAM,qBAAqB,GAChC,YAAY,UAAU,EACtB,eAAe,MAAM,KACpB,MAAmD,CAAC;AAEvD;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,UAAU,KACrB,MAAM,GAAG,SAWX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,OAAO,KAAG,UAAU,EAoBtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,iBAWd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,iBAUd,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,oBAQd,CAAC;AA8FF;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,GAC/C,YAAY,UAAU,KACrB,uBAAuB,EAsBzB,CAAC"}
+{"version":3,"file":"annotation.d.ts","sourceRoot":"","sources":["../../src/utils/annotation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,iBAAiB,EACjB,oBAAoB,EACpB,OAAO,EACP,iBAAiB,EAClB,MAAM,2BAA2B,CAAC;AAMnC,OAAO,KAAK,EAGV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAgL1E;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GACrC,aAAa,UAAU,EAAE,KACxB,kBAAkB,EAoBjB,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,qBAAqB,GAChC,YAAY,UAAU,EACtB,eAAe,MAAM,KACpB,MAG+D,CAAC;AAEnE;;;;;GAKG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,UAAU,KACrB,MAAM,GAAG,SAWX,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,OAAO,KAAG,UAAU,EAoBtE,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,iBAWd,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,mBAAmB,GAC9B,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,iBAUd,CAAC;AAUF;;;GAGG;AACH,eAAO,MAAM,sBAAsB,GACjC,UAAU,kBAAkB,KAC3B,QAAQ,IAAI,oBAQd,CAAC;AA8FF;;;;GAIG;AACH,eAAO,MAAM,oCAAoC,GAC/C,YAAY,UAAU,KACrB,uBAAuB,EAuBzB,CAAC"}

package/utils/office-table-anchor.d.ts

@@ -0,0 +1,5 @@
+import { AnnotationSelector } from '@epam/ai-dial-chat-shared';
+import { DocxTableRowOfficeHighlightLocation, PptxTableRowOfficeHighlightLocation } from '../models/office-highlight';
+/** Returns a validated table-row location for the temporary Office anchor format. */
+export declare const normalizeOfficeTableAnchor: (selector: AnnotationSelector) => DocxTableRowOfficeHighlightLocation | PptxTableRowOfficeHighlightLocation | undefined;
+//# sourceMappingURL=office-table-anchor.d.ts.map

package/utils/office-table-anchor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"office-table-anchor.d.ts","sourceRoot":"","sources":["../../src/utils/office-table-anchor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AACpE,OAAO,KAAK,EACV,mCAAmC,EACnC,mCAAmC,EACpC,MAAM,4BAA4B,CAAC;AAwCpC,qFAAqF;AACrF,eAAO,MAAM,0BAA0B,GACrC,UAAU,kBAAkB,KAE1B,mCAAmC,GACnC,mCAAmC,GACnC,SA2BH,CAAC"}

package/utils/useCitationCard.d.ts

@@ -1,15 +1,22 @@
 /**
  * Manages open/close state and per-group active annotation index for citation
- * cards within a single assistant message. State is keyed by
- * `AnnotationGroup.groupKey`, not `sourceUrl` — two groups can share a
- * `sourceUrl` (e.g. two `cit`-id groups citing the same document) while
- * having independent popup/switcher state.
+ * cards within a single assistant message. The hook carries two distinct key
+ * spaces:
+ *
+ * - Openness (`openPopup`/`closePopup`/`isOpen`) is keyed by **occurrence
+ *   owner key** — a stable per-instance id derived by the rendered
+ *   `CitationDropdown` (see its `ownerKey`), not by `AnnotationGroup.groupKey`
+ *   or `sourceUrl`. Two rendered occurrences resolving to the same group are
+ *   therefore always independent popup owners.
+ * - The switcher index (`setActiveIndex`/`getActiveIndex`) is keyed by
+ *   `groupKey`, because the index indexes into `group.annotations`, which is
+ *   group data, not occurrence data.
  */
 export declare const useCitationCard: () => {
-    openPopup: (groupKey: string) => void;
-    closePopup: () => void;
+    openPopup: (ownerKey: string) => void;
+    closePopup: (ownerKey: string) => void;
     setActiveIndex: (groupKey: string, index: number) => void;
-    isOpen: (groupKey: string) => boolean;
+    isOpen: (ownerKey: string) => boolean;
     getActiveIndex: (groupKey: string) => number;
 };
 //# sourceMappingURL=useCitationCard.d.ts.map

package/utils/useCitationCard.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCitationCard.d.ts","sourceRoot":"","sources":["../../src/utils/useCitationCard.ts"],"names":[],"mappings":"AAcA;;;;;;GAMG;AACH,eAAO,MAAM,eAAe;0BAGe,MAAM;;+BAQD,MAAM,SAAS,MAAM;uBAY5C,MAAM;+BACE,MAAM;CAKtC,CAAC"}
+{"version":3,"file":"useCitationCard.d.ts","sourceRoot":"","sources":["../../src/utils/useCitationCard.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,eAAe;0BAGe,MAAM;2BAIL,MAAM;+BAMF,MAAM,SAAS,MAAM;uBAY5C,MAAM;+BACE,MAAM;CAKtC,CAAC"}