@epam/ai-dial-quotations 1.2.0-dev.99 → 1.3.0-dev.5

package/components/CitationCard/CitationCard.d.ts

@@ -17,6 +17,20 @@ export interface CitationCardLabels {
     openInBrowser: string;
     /** Label for the "Download" button. */
     download: string;
+    /** Label for the toggle that expands a quote cut off at the collapsed height. */
+    showMore: string;
+    /** Label for the toggle that collapses an expanded quote. */
+    showLess: string;
+    /** Accessible label for the copy button on a fenced code block inside the quote. Defaults to `'Copy code'`. */
+    codeBlockCopyLabel?: string;
+    /** Status announced after a fenced code block inside the quote has been copied. Defaults to `'Copied!'`. */
+    codeBlockCopiedLabel?: string;
+    /** Accessible label for the download button on a fenced code block inside the quote. Defaults to `'Download code'`. */
+    codeBlockDownloadLabel?: string;
+    /** Accessible label for a table's horizontally scrollable region inside the quote. Defaults to `'Scrollable table'`. */
+    tableScrollRegionAriaLabel?: string;
+    /** Accessible label for a block formula's horizontally scrollable region inside the quote. Defaults to `'Scrollable formula'`. */
+    mathScrollRegionAriaLabel?: string;
 }
 /** Color overrides for `CitationCard`, applied as CSS custom properties with app theme fallbacks. */
 export interface CitationCardColors {
@@ -60,7 +74,13 @@ export interface CitationCardProps {
     onPreview?: (annotation: Annotation) => void;
     /** Called when the user clicks the "Open in browser"/"Download" button. */
     onOpenInBrowser: (annotation: Annotation) => void;
-    /** Optional icon rendered before the source name in the card header. */
+    /** Whether a previewable file shows the "Download" button. Web links keep "Open in browser" regardless. Defaults to `true`. */
+    isDownloadEnabled?: boolean;
+    /**
+     * Optional icon rendered before the header text (the file extension for a
+     * previewable file, otherwise the source name). When omitted, a previewable
+     * file gets the UI kit's `FileIcon` glyph for its extension.
+     */
     headerIcon?: ReactNode;
     /** User-visible strings. */
     labels: CitationCardLabels;

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;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"}
+{"version":3,"file":"CitationCard.d.ts","sourceRoot":"","sources":["../../../src/components/CitationCard/CitationCard.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAkB5D,OAAO,EACL,EAAE,EACF,SAAS,EAMV,MAAM,OAAO,CAAC;AAEf,OAAO,EAEL,KAAK,eAAe,EACrB,MAAM,yCAAyC,CAAC;AAGjD,+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;IACjB,iFAAiF;IACjF,QAAQ,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE,MAAM,CAAC;IACjB,+GAA+G;IAC/G,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,4GAA4G;IAC5G,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,uHAAuH;IACvH,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wHAAwH;IACxH,0BAA0B,CAAC,EAAE,MAAM,CAAC;IACpC,kIAAkI;IAClI,yBAAyB,CAAC,EAAE,MAAM,CAAC;CACpC;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,+HAA+H;IAC/H,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,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,CA4N9C,CAAC"}

package/components/CitationDropdown/CitationDropdown.d.ts

@@ -16,6 +16,10 @@ export interface CitationDropdownProps {
     isPreviewable?: (annotation: Annotation) => boolean;
     /** Called when the user clicks "Open in browser" for an annotation. */
     onOpenInBrowser: (annotation: Annotation) => void;
+    /** Whether the card shows the "Download" button for a previewable file. Defaults to `true`. */
+    isDownloadEnabled?: boolean;
+    /** Whether the host's preview panel is open; a marker click then previews the active annotation directly instead of showing the card. Defaults to `false`. */
+    isPreviewOpen?: boolean;
     /** Optional icon rendered before the marker's label. */
     icon?: ReactNode;
     /** Optional icon rendered in the card header. When absent, no header icon is shown. */
@@ -29,6 +33,6 @@ export interface CitationDropdownProps {
     /** Typography class forwarded to the marker's label text. Defaults to `'dial-caption-text'`. */
     markerLabelClassName?: string;
 }
-/** Combines `CitationMarker` and `CitationCard` into a tooltip-based dropdown. Requires a `CitationCardProvider` ancestor. */
+/** Combines `CitationMarker` and `CitationCard` into a click-opened popover. Requires a `CitationCardProvider` ancestor. */
 export declare const CitationDropdown: FC<CitationDropdownProps>;
 //# sourceMappingURL=CitationDropdown.d.ts.map

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,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"}
+{"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,+FAA+F;IAC/F,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8JAA8J;IAC9J,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,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,4HAA4H;AAC5H,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CA4GtD,CAAC"}

package/hooks/useCitationMarkdownComponents/useCitationMarkdownComponents.d.ts

@@ -11,6 +11,10 @@ export interface UseCitationMarkdownComponentsCallbacks {
     isPreviewable?(annotation: Annotation): boolean;
     /** Called when a citation marker's open-in-browser action is invoked. */
     onOpenInBrowser(annotation: Annotation): void;
+    /** Whether citation cards show the "Download" button for a previewable file. Defaults to `true`. */
+    isDownloadEnabled?: boolean;
+    /** Whether the host's preview panel is open; a marker click then previews directly instead of showing the card. Defaults to `false`. */
+    isPreviewOpen?: boolean;
     /** Builds the translated label bundles used by a given citation group's card and marker. */
     buildLabels(group: AnnotationGroup): {
         cardLabels: CitationCardLabels;
@@ -42,8 +46,14 @@ export interface UseCitationMarkdownComponentsCallbacks {
  * `isCompactTypography` drops the paragraph class one type-scale step, matching
  * `COMPACT_MARKDOWN_CLASS_NAMES` so cited and uncited paragraphs stay the same
  * size.
+ *
+ * `fallbackGroups` is an optional pool of groups that do not belong to this
+ * message, consulted only to resolve a `<cit data-id="…">` element the
+ * message's own `groups` do not cover. It never affects sentinel injection or
+ * `processedContent`, so a foreign group cannot shift a marker position in
+ * this message's text; a colliding id is always resolved from `groups`.
  */
-export declare const useCitationMarkdownComponents: (content: string, groups: AnnotationGroup[], callbacks: UseCitationMarkdownComponentsCallbacks, isStreaming?: boolean, isCompactTypography?: boolean) => {
+export declare const useCitationMarkdownComponents: (content: string, groups: AnnotationGroup[], callbacks: UseCitationMarkdownComponentsCallbacks, isStreaming?: boolean, isCompactTypography?: boolean, fallbackGroups?: AnnotationGroup[]) => {
     processedContent: string;
     markdownComponents: Components;
 };

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,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"}
+{"version":3,"file":"useCitationMarkdownComponents.d.ts","sourceRoot":"","sources":["../../../src/hooks/useCitationMarkdownComponents/useCitationMarkdownComponents.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE1E,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;AAQ3F,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,oGAAoG;IACpG,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,wIAAwI;IACxI,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,4FAA4F;IAC5F,WAAW,CAAC,KAAK,EAAE,eAAe,GAAG;QACnC,UAAU,EAAE,kBAAkB,CAAC;QAC/B,YAAY,EAAE,oBAAoB,CAAC;KACpC,CAAC;CACH;AA0BD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,EACf,QAAQ,eAAe,EAAE,EACzB,WAAW,sCAAsC,EACjD,qBAAmB,EACnB,6BAA2B,EAC3B,iBAAgB,eAAe,EAA0B,KACxD;IAAE,gBAAgB,EAAE,MAAM,CAAC;IAAC,kBAAkB,EAAE,UAAU,CAAA;CAwG5D,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*/.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))}
+._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))}td ._trigger_1ud83_1,th ._trigger_1ud83_1{max-width:100%;margin-inline-start:0}td ._trigger_1ud83_1>*,th ._trigger_1ud83_1>*{min-width:0;max-width:100%}
+/*$vite$:1*/.visible{visibility:visible}.collapse{visibility:collapse}.fixed{position:fixed}.absolute{position:absolute}.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}.block{display:block}.inline{display:inline}.flex{display:flex}.inline-flex{display:inline-flex}.table{display:table}.table-cell{display:table-cell}.table-row{display:table-row}.hidden{display:none}.max-h-\[min\(20rem\2c 50vh\)\]{max-height:min(20rem,50vh)}.w-\[400px\]{width:400px}.w-full{width:100%}.min-w-0{min-width:0}.max-w-\[240px\]{max-width:240px}.max-w-full{max-width:100%}.shrink{flex-shrink:1}.shrink-0{flex-shrink:0}.resize{resize:both}.flex-col{flex-direction:column}.items-start{align-items:flex-start}.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}.overflow-y-auto{overflow-y:auto}.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}.\!bg-transparent{background-color:transparent!important}.\!p-0{padding:0!important}.p-4{padding:1rem}.ps-\[1\.5em\]{padding-inline-start:1.5em}.align-middle{vertical-align:middle}.ordinal{--tw-ordinal:ordinal;font-variant-numeric:var(--tw-ordinal) var(--tw-slashed-zero) var(--tw-numeric-figure) var(--tw-numeric-spacing) var(--tw-numeric-fraction)}.\!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

@@ -12,9 +12,9 @@ export { useCitationMarkdownComponents } from './hooks/useCitationMarkdownCompon
 export type { UseCitationMarkdownComponentsCallbacks } from './hooks/useCitationMarkdownComponents/useCitationMarkdownComponents';
 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 { annotationHighlightId, annotationHighlightIds, annotationsToPdfHighlights, annotationToOfficeHighlightLocations, getAnnotationPdfPage, isDocxRangeSelector, isExcelRcRangeSelector, isPptxRangeSelector, resolveMessageAnnotations, } from './utils/annotation';
 export type { DocxOfficeHighlightLocation, DocxTableRowOfficeHighlightLocation, ExcelOfficeHighlightLocation, OfficeHighlightLocation, PptxOfficeHighlightLocation, PptxTableRowOfficeHighlightLocation, } from './models/office-highlight';
-export { injectCitationSentinels, replaceSentinelsInChildren, stripCitTagsWhileStreaming, } from './utils/citation-injection';
+export { injectCitationSentinels, replaceCitTagsWithSourceNames, 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';

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,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"}
+{"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,sBAAsB,EACtB,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,6BAA6B,EAC7B,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

@@ -1,155 +1,272 @@
 import { MIMEType as e, MarkdownRenderer as t, buildCssVars as n, isAnnotationSelector as r, mergeClasses as i, normalizePersistedHtmlTagAttachmentType as a, normalizeRawAnnotations as o } from "@epam/ai-dial-chat-shared";
-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, useId as S, useMemo as C, useState as w } from "react";
+import { DIAL_KIT_ICON_STROKE as s, DialItemType as c, Dropdown as l, ElementSize as u, EllipsisTooltip as d, FileIcon as f, GhostIconButton as p, LinkButton as m, NeutralButton as h, PrimaryButton as g } from "@epam/ai-dial-ui-kit";
+import { IconChevronLeft as _, IconChevronRight as v } from "@tabler/icons-react";
+import { createContext as y, useCallback as b, useContext as x, useEffect as S, useId as ee, useLayoutEffect as te, useMemo as C, useRef as ne, useState as w } from "react";
+import { Fragment as T, jsx as E, jsxs as D } from "react/jsx-runtime";
 //#region src/constants/public-class-names.ts
-var T = {
+var O = {
 	citationCard: "dial-quotations-citation-card",
 	citationDropdown: "dial-quotations-citation-dropdown",
 	citationMarker: "dial-quotations-citation-marker"
-}, E = {
+}, k = (e) => {
+	try {
+		return decodeURIComponent(e);
+	} catch {
+		return e;
+	}
+}, A = (e) => {
+	try {
+		let t = new URL(e);
+		return t.pathname.split("/").map((e) => k(e)).filter(Boolean).at(-1) ?? t.hostname;
+	} catch {
+		return e.split("/").map((e) => k(e)).filter(Boolean).at(-1) ?? e;
+	}
+}, j = /\.([a-z0-9]{1,10})$/i, M = (e) => {
+	let t = e == null ? null : j.exec(e.trim());
+	return t == null ? void 0 : `.${t[1].toLowerCase()}`;
+}, re = (e) => {
+	let t = e.body?.source?.attachment, n = t?.url;
+	return (n == null ? void 0 : M(A(n))) ?? M(t?.title);
+}, N = (e, t) => e.body?.source?.attachment?.title ?? A(t), P = (e) => {
+	let t = e.target?.selector;
+	return t?.type === "html_tag" ? t : void 0;
+}, F = (e) => P(e) != null, I = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e) {
+		if (F(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: N(n, e),
+			annotations: [n],
+			primaryAnnotation: n
+		});
+	}
+	return Array.from(t.values());
+}, L = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e) {
+		let e = P(n)?.id;
+		if (e == null) continue;
+		let r = n.body?.source?.attachment?.url;
+		if (r == null) continue;
+		let i = t.get(e);
+		i ? i.annotations.push(n) : t.set(e, {
+			groupKey: `cit:${e}`,
+			sourceUrl: r,
+			sourceName: N(n, r),
+			annotations: [n],
+			primaryAnnotation: n
+		});
+	}
+	return Array.from(t.values());
+}, ie = (e) => [...L(e), ...I(e)], R = (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);
+}, z = {
 	card: "_card_1kph1_1",
 	quote: "_quote_1kph1_5",
 	title: "_title_1kph1_9",
 	switcher: "_switcher_1kph1_13",
 	sourceName: "_sourceName_1kph1_17"
-}, 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,
-		"--cc-switcher-text": x?.switcherText,
-		"--cc-source-name-text": x?.sourceNameText
-	});
-	return /* @__PURE__ */ v("div", {
+}, B = ({ group: r, activeIndex: a, onIndexChange: o, onPreview: l, onOpenInBrowser: h, isDownloadEnabled: y = !0, headerIcon: b, labels: x, typography: C, colors: T }) => {
+	let k = r.annotations.length, A = r.annotations[a] ?? r.primaryAnnotation, j = k > 1, M = A.body?.source?.attachment?.type, N = l == null || M === e.HTML || M === e.XHTML, P = N ? void 0 : re(A), F = P ?? r.sourceName, I = b ?? (P == null ? void 0 : /* @__PURE__ */ E(f, {
+		type: c.File,
+		name: P,
+		fileExtension: P,
+		size: 16,
+		decorative: !0,
+		className: "shrink-0"
+	})), L = C?.sourceNameClassName ?? "dial-tiny-text", ie = C?.titleClassName ?? "dial-body-semi-text", R = C?.quoteClassName ?? "dial-small-text", B = C?.quoteStrongClassName ?? "dial-small-semi-text", V = C?.switcherClassName ?? "dial-tiny-text", H = n({
+		"--cc-card-bg": T?.cardBackground,
+		"--cc-quote-text": T?.quoteText,
+		"--cc-title-text": T?.titleText,
+		"--cc-switcher-text": T?.switcherText,
+		"--cc-source-name-text": T?.sourceNameText
+	}), U = A.body?.quote, W = ee(), G = ne(null), [K, q] = w(!1), [J, Y] = w(!1);
+	return S(() => {
+		q(!1);
+	}, [a, U]), te(() => {
+		let e = G.current;
+		if (!e || K) return;
+		let t = () => Y(e.scrollHeight > e.clientHeight + 1);
+		t();
+		let n = new ResizeObserver(t);
+		return n.observe(e), () => n.disconnect();
+	}, [U, K]), /* @__PURE__ */ D("div", {
 		role: "dialog",
 		"aria-modal": "true",
-		"aria-label": y.ariaLabel,
-		style: P,
-		className: i("flex w-[400px] flex-col gap-3 rounded-lg p-4 shadow-lg", E.card, T.citationCard),
+		"aria-label": x.ariaLabel,
+		style: H,
+		className: i("flex w-[400px] max-w-full flex-col gap-3 rounded-lg p-4 shadow-lg", z.card, O.citationCard),
 		children: [
-			/* @__PURE__ */ v("div", {
+			/* @__PURE__ */ D("div", {
 				className: "flex items-center justify-between gap-2",
-				children: [/* @__PURE__ */ v("div", {
+				children: [/* @__PURE__ */ D("div", {
 					className: "flex min-w-0 items-center gap-1",
-					children: [g, /* @__PURE__ */ _(l, {
-						text: r.sourceName,
-						className: i(k, "min-w-0", E.sourceName)
+					children: [I, /* @__PURE__ */ E(d, {
+						text: F,
+						className: i(L, "min-w-0", z.sourceName)
 					})]
-				}), w && /* @__PURE__ */ v("div", {
+				}), j && /* @__PURE__ */ D("div", {
 					className: "flex shrink-0 items-center gap-1",
 					children: [
-						/* @__PURE__ */ _(u, {
-							icon: /* @__PURE__ */ _(m, {
+						/* @__PURE__ */ E(p, {
+							icon: /* @__PURE__ */ E(_, {
 								size: 14,
 								className: "rtl:scale-x-[-1]",
 								stroke: s
 							}),
-							size: c.Small,
-							"aria-label": y.previousCitation,
-							onClick: () => o((a - 1 + S) % S)
+							size: u.Small,
+							"aria-label": x.previousCitation,
+							onClick: () => o((a - 1 + k) % k)
 						}),
-						/* @__PURE__ */ _("span", {
-							className: i(N, E.switcher),
-							children: y.formatSwitcherText(a + 1, S)
+						/* @__PURE__ */ E("span", {
+							className: i(V, z.switcher),
+							children: x.formatSwitcherText(a + 1, k)
 						}),
-						/* @__PURE__ */ _(u, {
-							icon: /* @__PURE__ */ _(h, {
+						/* @__PURE__ */ E(p, {
+							icon: /* @__PURE__ */ E(v, {
 								size: 14,
 								className: "rtl:scale-x-[-1]",
 								stroke: s
 							}),
-							size: c.Small,
-							"aria-label": y.nextCitation,
-							onClick: () => o((a + 1) % S)
+							size: u.Small,
+							"aria-label": x.nextCitation,
+							onClick: () => o((a + 1) % k)
 						})
 					]
 				})]
 			}),
-			(C.body?.title || C.body?.quote || w) && /* @__PURE__ */ v("div", {
+			(A.body?.title || A.body?.quote || j) && /* @__PURE__ */ D("div", {
 				className: "flex flex-col gap-3",
-				children: [C.body?.title && /* @__PURE__ */ _("p", {
-					className: i(A, E.title, "break-words"),
-					children: C.body.title
-				}), (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(j, E.quote),
-							ul: i(j, "ps-3"),
-							ol: i(j, "ps-3"),
-							strong: M
-						}
-					})
+				children: [A.body?.title && /* @__PURE__ */ E("p", {
+					className: i(ie, z.title, "break-words"),
+					children: A.body.title
+				}), (U || j) && /* @__PURE__ */ D("div", {
+					className: "flex flex-col items-start gap-1",
+					children: [/* @__PURE__ */ E("div", {
+						ref: G,
+						id: W,
+						tabIndex: K ? 0 : void 0,
+						className: i(R, z.quote, "w-full break-words", K ? "max-h-[min(20rem,50vh)] overflow-y-auto" : "line-clamp-6"),
+						children: U && /* @__PURE__ */ E(t, {
+							content: U,
+							classNames: {
+								p: i(R, z.quote),
+								ul: i(R, "ps-[1.5em]"),
+								ol: R,
+								strong: B
+							},
+							codeBlockCopyLabel: x.codeBlockCopyLabel,
+							codeBlockCopiedLabel: x.codeBlockCopiedLabel,
+							codeBlockDownloadLabel: x.codeBlockDownloadLabel,
+							tableScrollRegionAriaLabel: x.tableScrollRegionAriaLabel,
+							mathScrollRegionAriaLabel: x.mathScrollRegionAriaLabel
+						})
+					}), J && /* @__PURE__ */ E(m, {
+						label: K ? x.showLess : x.showMore,
+						size: u.Small,
+						"aria-expanded": K,
+						"aria-controls": W,
+						onClick: () => q((e) => !e)
+					})]
 				})]
 			}),
-			/* @__PURE__ */ v("div", {
+			/* @__PURE__ */ D("div", {
 				className: "flex justify-start gap-2",
-				children: [d && /* @__PURE__ */ _(f, {
-					label: y.preview,
-					size: c.Small,
-					onClick: () => d(C)
-				}), /* @__PURE__ */ _(f, {
-					label: O ? y.openInBrowser : y.download,
-					size: c.Small,
-					onClick: () => p(C)
+				children: [l && /* @__PURE__ */ E(g, {
+					label: x.preview,
+					size: u.Small,
+					onClick: () => l(A)
+				}), (N || y) && /* @__PURE__ */ E(g, {
+					label: N ? x.openInBrowser : x.download,
+					size: u.Small,
+					onClick: () => h(A)
 				})]
 			})
 		]
 	});
-}, 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),
+}, V = ({ annotationCount: e, onOpen: t, icon: n, labels: r, labelClassName: a = "dial-caption-text" }) => /* @__PURE__ */ E(h, {
+	size: u.Small,
+	className: i("max-w-[240px]", O.citationMarker),
 	textClassName: "min-w-0 truncate",
 	iconBefore: n,
-	label: /* @__PURE__ */ _("span", {
+	label: /* @__PURE__ */ E("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);
+}), H = y(null), U = H.Provider, W = () => {
+	let e = x(H);
 	if (e == null) throw Error("useCitationCardContext must be used within a CitationCardProvider");
 	return e;
-}, 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);
+}, G = { trigger: "_trigger_1ud83_1" }, K = ({ group: e, onPreview: t, isPreviewable: n, onOpenInBrowser: r, isDownloadEnabled: a = !0, isPreviewOpen: o = !1, icon: s, headerIcon: c, cardLabels: u, markerLabels: d, cardTypography: f, markerLabelClassName: p }) => {
+	let m = W(), h = ee(), g = m.isOpen(h), _ = m.getActiveIndex(e.groupKey), v = e.annotations[_] ?? e.primaryAnnotation, y = n?.(v) ?? !0, x = b((e) => {
+		e || m.closePopup(h);
+	}, [m, h]), S = C(() => t && y ? (e) => {
+		t(e), m.closePopup(h);
 	} : void 0, [
 		t,
+		y,
+		m,
+		h
+	]), te = b(() => {
+		if (o && S) {
+			S(v);
+			return;
+		}
+		m.openPopup(h);
+	}, [
+		o,
+		S,
 		v,
-		d,
+		m,
+		h
+	]), ne = b(() => /* @__PURE__ */ E(B, {
+		group: e,
+		activeIndex: _,
+		onIndexChange: (t) => m.setActiveIndex(e.groupKey, t),
+		onPreview: S,
+		onOpenInBrowser: r,
+		isDownloadEnabled: a,
+		headerIcon: c,
+		labels: u,
+		typography: f
+	}), [
+		e,
+		_,
+		m,
+		S,
+		r,
+		a,
+		c,
+		u,
 		f
 	]);
-	return /* @__PURE__ */ _(p, {
-		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", M.content, T.citationDropdown),
-		tooltip: /* @__PURE__ */ _(D, {
-			group: e,
-			activeIndex: h,
-			onIndexChange: (t) => d.setActiveIndex(e.groupKey, t),
-			onPreview: x,
-			onOpenInBrowser: r,
-			headerIcon: o,
-			labels: s,
-			typography: l
-		}),
-		children: /* @__PURE__ */ _(O, {
+	return /* @__PURE__ */ E(l, {
+		open: g,
+		onOpenChange: x,
+		trigger: [],
+		placement: "bottom-end",
+		matchReferenceWidth: !1,
+		className: i("ms-1 inline-flex align-middle", G.trigger),
+		listClassName: i("!p-0 !bg-transparent !shadow-none !rounded-none", O.citationDropdown),
+		renderOverlay: ne,
+		children: /* @__PURE__ */ E(V, {
 			sourceName: e.sourceName,
 			annotationCount: e.annotations.length,
-			onOpen: () => d.openPopup(f),
-			icon: a,
-			labels: c,
-			labelClassName: u
+			onOpen: te,
+			icon: s,
+			labels: d,
+			labelClassName: p
 		})
 	});
-}, P = (e) => {
+}, q = (e) => {
 	let t = e.trim();
 	if (!t.startsWith("|") || !t.endsWith("|") || /[\r\n]/.test(t)) return;
 	let n = [], r = "";
@@ -158,11 +275,11 @@ var T = {
 		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) => {
+}, J = (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);
+	let i = q(t);
 	if (i != null) {
 		if (e.type === "docx_text_anchor") return {
 			type: "docx_text_anchor",
@@ -176,13 +293,13 @@ var T = {
 			slide: r
 		};
 	}
-}, te = {
+}, Y = {
 	backgroundColor: "transparent",
 	borderColor: "var(--stroke-accent, #1D4ED8)",
 	borderWidth: "2px",
 	opacity: .5,
 	hoverOpacity: .5
-}, ne = (e) => {
+}, ae = (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) {
@@ -201,7 +318,7 @@ var T = {
 		x2: i + o,
 		y2: a + s
 	};
-}, F = (e) => {
+}, X = (e) => {
 	if (!r(e)) return;
 	let t = e, n;
 	if (t.type === "pdf_bbox") {
@@ -212,7 +329,7 @@ var T = {
 			x2: i,
 			y2: a
 		});
-	} else t.type === "pdf_region" && (n = ne(t.bbox));
+	} else t.type === "pdf_region" && (n = ae(t.bbox));
 	if (n == null) return;
 	let i = t.page;
 	if (!(typeof i != "number" || !Number.isInteger(i) || i < 1) && [
@@ -227,63 +344,85 @@ var T = {
 		x2: n.x2,
 		y2: n.y2
 	};
-}, 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) => {
+}, oe = (e) => {
+	if (!r(e)) return;
+	let t = e;
+	if (t.type !== "pdf_bbox" && t.type !== "pdf_region") return;
+	let n = t.page;
+	return typeof n == "number" && Number.isInteger(n) && n >= 1 ? n : void 0;
+}, Z = (e) => typeof e != "object" || !e ? String(e) : Array.isArray(e) ? `[${e.map(Z).join(",")}]` : `{${Object.entries(e).filter(([, e]) => e !== void 0).sort(([e], [t]) => e < t ? -1 : +(e > t)).map(([e, t]) => `${e}=${Z(t)}`).join(",")}}`, se = (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) => {
+}, ce = (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 = F(e);
+		let t = X(e);
 		return t == null ? [] : [t];
+	}), r = xe(e);
+	if (!(n.length === 0 && r.length === 0)) return Z([n, r]);
+}, le = (e) => {
+	let t = e.target?.selector, n = t?.type === "html_tag" ? t.id : void 0, r = typeof n == "string" ? n : void 0, i = ce(e);
+	if (!(r == null && i == null)) return se(`${r ?? ""}|${i ?? ""}`);
+}, ue = (e) => {
+	let t = fe(e);
+	return e.flatMap((e, n) => {
+		let i = e.body?.selector;
+		if (i == null) return [];
+		let a = (Array.isArray(i) ? i : [i]).flatMap((e) => {
+			if (!r(e)) return [];
+			let t = X(e);
+			return t == null ? [] : [t];
+		});
+		return a.length === 0 ? [] : [{
+			id: t[n],
+			bboxes: a,
+			style: Y
+		}];
+	});
+}, de = (e, t) => e.index == null ? le(e) ?? String(t) : String(e.index), fe = (e) => {
+	let t = e.map((e, t) => de(e, t)), n = new Set(t), r = /* @__PURE__ */ new Set();
+	return t.map((e) => {
+		if (!r.has(e)) return r.add(e), e;
+		let t = 1;
+		for (; n.has(`${e}-${t}`);) t += 1;
+		let i = `${e}-${t}`;
+		return n.add(i), r.add(i), i;
 	});
-	return i.length === 0 ? [] : [{
-		id: L(e, t),
-		bboxes: i,
-		style: te
-	}];
-}), L = (e, t) => e.index == null ? ae(e) ?? String(t) : String(e.index), se = (e) => {
+}, pe = (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 = F(e);
+		let t = X(e);
 		if (t != null) return t.page;
 	}
-}, R = (e) => {
+	for (let e of n) {
+		let t = oe(e);
+		if (t != null) return t;
+	}
+}, me = (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);
-}, z = (e) => {
+}, he = (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";
-}, B = (e) => {
+}, ge = (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";
-}, V = (e) => typeof e == "object" && !!e && typeof e.row == "number" && typeof e.col == "number", H = (e) => {
+}, Q = (e) => typeof e == "object" && !!e && typeof e.row == "number" && typeof e.col == "number", _e = (e) => {
 	if (e.type !== "excel_rc_range") return !1;
 	let t = e;
-	return typeof t.sheet == "string" && V(t.start) && (t.end === void 0 || t.end === null || V(t.end));
-}, ce = (e) => {
+	return typeof t.sheet == "string" && Q(t.start) && (t.end === void 0 || t.end === null || Q(t.end));
+}, ve = (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",
@@ -293,7 +432,7 @@ var T = {
 		endExclusive: i,
 		text: a
 	};
-}, le = (e) => {
+}, ye = (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",
@@ -303,7 +442,7 @@ var T = {
 		endExclusive: i,
 		text: a
 	};
-}, ue = (e) => {
+}, be = (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 {
@@ -318,30 +457,30 @@ var T = {
 			end: r
 		};
 	}
-}, U = (e) => {
+}, xe = (e) => {
 	let t = e.body?.selector;
 	return t == null ? [] : (Array.isArray(t) ? t : [t]).flatMap((e) => {
 		if (!r(e)) return [];
-		if (z(e)) {
-			let t = ce(e);
+		if (he(e)) {
+			let t = ve(e);
 			return t ? [t] : [];
 		}
-		if (B(e)) {
-			let t = le(e);
+		if (ge(e)) {
+			let t = ye(e);
 			return t ? [t] : [];
 		}
-		if (H(e)) {
-			let t = ue(e);
+		if (_e(e)) {
+			let t = be(e);
 			return t ? [t] : [];
 		}
-		let t = ee(e);
+		let t = J(e);
 		return t ? [t] : [];
 	});
-}, de = (e, t) => C(() => t ? [] : R(e), [t, e]), fe = {
+}, Se = (e, t) => C(() => t ? [] : me(e), [t, e]), Ce = {
 	openOwnerKey: null,
 	activeIndexByGroup: {}
-}, pe = () => {
-	let [e, t] = w(fe), n = b((e) => {
+}, we = () => {
+	let [e, t] = w(Ce), n = b((e) => {
 		t((t) => ({
 			...t,
 			openOwnerKey: e
@@ -372,7 +511,7 @@ var T = {
 		i,
 		e
 	]);
-}, me = /⟦C(\d+)⟧/g, W = (e, t) => {
+}, Te = /⟦C(\d+)⟧/g, Ee = (e, t) => {
 	let n = t.map((e, t) => ({
 		g: e,
 		idx: t
@@ -385,9 +524,26 @@ var T = {
 	}).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;
-}, 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) => {
+}, De = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>/g, Oe = /^<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>$/, ke = /<cit\s+data-id=(?:"[^"]+"|'[^']+')\s*>\s*<\/cit>|<\/?cit\b[^>]*>|<\/?cit\b[^>]*$/gi, Ae = (e) => e.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;"), je = (e) => e.replace(ke, (e) => Oe.test(e) ? e : Ae(e)), Me = (e) => je(e).replace(De, ""), Ne = (e) => {
+	let t = e.primaryAnnotation.target?.selector;
+	return t?.type === "html_tag" ? t.id : void 0;
+}, Pe = (e, t = []) => {
+	let n = /* @__PURE__ */ new Map();
+	for (let r of [...t, ...e]) {
+		let e = Ne(r);
+		e != null && n.set(e, r);
+	}
+	return n;
+}, Fe = /<cit\s+data-id=(?:"([^"]+)"|'([^']+)')\s*>\s*<\/cit>/g, Ie = (e) => e.replace(/[\\`*_[\]<>|]/g, "\\$&"), Le = (e, t, n = []) => {
+	if (!e.includes("<cit")) return e;
+	let r = Pe(t, n);
+	return r.size === 0 ? e : e.replace(Fe, (e, t, n) => {
+		let i = r.get(t ?? n ?? "");
+		return i ? Ie(i.sourceName) : e;
+	});
+}, $ = (e, t) => {
 	if (typeof e == "string") {
-		let n = e.split(me);
+		let n = e.split(Te);
 		if (n.length === 1) return e;
 		let r = [];
 		return n.forEach((e, n) => {
@@ -395,58 +551,52 @@ var T = {
 		}), r;
 	}
 	return Array.isArray(e) ? e.flatMap((e) => {
-		let n = q(e, t);
+		let n = $(e, t);
 		return Array.isArray(n) ? n : [n];
 	}) : e;
-}, ye = (e) => {
-	let t = e.primaryAnnotation.target?.selector;
-	return t?.type === "html_tag" ? t.id : void 0;
-}, be = (e, t) => /* @__PURE__ */ v(g, { children: [
+}, Re = {}, ze = [], Be = (e, t) => /* @__PURE__ */ D(T, { children: [
 	e == null ? "<cit>" : `<cit data-id="${e}">`,
 	t,
 	"</cit>"
-] }), 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), [
+] }), Ve = (e, t, n, r = !1, a = !1, o = ze) => {
+	let { onPreview: s, isPreviewable: c, onOpenInBrowser: l, isDownloadEnabled: u = !0, isPreviewOpen: d = !1, buildLabels: f } = n, p = C(() => r ? Me(e) : je(t.length > 0 ? Ee(e, t) : e), [
 		e,
 		t,
 		r
-	]), d = u.includes("<cit");
+	]), m = p.includes("<cit");
 	return {
-		processedContent: u,
+		processedContent: p,
 		markdownComponents: C(() => {
-			let e = /* @__PURE__ */ new Map();
-			for (let n of t) {
-				let t = ye(n);
-				t != null && e.set(t, n);
-			}
-			let n = (e) => {
-				let { cardLabels: t, markerLabels: n } = l(e);
-				return /* @__PURE__ */ _(N, {
+			let e = Pe(t, o), n = (e) => {
+				let { cardLabels: t, markerLabels: n } = f(e);
+				return /* @__PURE__ */ E(K, {
 					group: e,
-					onPreview: (t) => o(t, e),
-					isPreviewable: s,
-					onOpenInBrowser: c,
+					onPreview: (t) => s(t, e),
+					isPreviewable: c,
+					onOpenInBrowser: l,
+					isDownloadEnabled: u,
+					isPreviewOpen: d,
 					cardLabels: t,
 					markerLabels: n
 				}, `citation-${e.groupKey}`);
 			}, r = (e) => {
 				let r = t[e];
 				return r ? n(r) : null;
-			}, u = { cit: (t) => {
+			}, p = { cit: (t) => {
 				let r = t["data-id"] == null ? void 0 : e.get(t["data-id"]);
-				return r ? n(r) : be(t["data-id"], t.children);
+				return r ? n(r) : Be(t["data-id"], t.children);
 			} };
-			return t.length === 0 ? d ? u : {} : {
-				...u,
-				p: ({ children: e, ...t }) => /* @__PURE__ */ _("p", {
+			return t.length === 0 && o.length === 0 ? m ? p : Re : {
+				...p,
+				p: ({ children: e, ...t }) => /* @__PURE__ */ E("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: q(e, r)
+					children: $(e, r)
 				}),
-				li: ({ children: e, ...t }) => /* @__PURE__ */ _("li", {
+				li: ({ children: e, ...t }) => /* @__PURE__ */ E("li", {
 					...t,
 					className: "mb-1.5 last:mb-0",
-					children: q(e, r)
+					children: $(e, r)
 				})
 			};
 		}, [
@@ -455,70 +605,21 @@ var T = {
 			s,
 			c,
 			l,
+			u,
+			d,
+			f,
 			a,
-			d
+			m
 		])
 	};
-}, J = (e) => {
-	try {
-		return decodeURIComponent(e);
-	} catch {
-		return e;
-	}
-}, Se = (e) => {
-	try {
-		let t = new URL(e);
-		return t.pathname.split("/").map((e) => J(e)).filter(Boolean).at(-1) ?? t.hostname;
-	} catch {
-		return e.split("/").map((e) => J(e)).filter(Boolean).at(-1) ?? 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;
-}, Ce = (e) => X(e) != null, Z = (e) => {
-	let t = /* @__PURE__ */ new Map();
-	for (let n of e) {
-		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: Y(n, e),
-			annotations: [n],
-			primaryAnnotation: n
-		});
-	}
-	return Array.from(t.values());
-}, Q = (e) => {
-	let t = /* @__PURE__ */ new Map();
-	for (let n of e) {
-		let e = X(n)?.id;
-		if (e == null) continue;
-		let r = n.body?.source?.attachment?.url;
-		if (r == null) continue;
-		let i = t.get(e);
-		i ? i.annotations.push(n) : t.set(e, {
-			groupKey: `cit:${e}`,
-			sourceUrl: r,
-			sourceName: Y(n, r),
-			annotations: [n],
-			primaryAnnotation: n
-		});
-	}
-	return Array.from(t.values());
-}, 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);
-}, Ee = (e) => e.url == null && e.reference_url != null, De = /^(.*\.pdf)(?:#page=(\d+))?$/i, $ = (e) => {
-	let t = De.exec(e);
+}, He = (e) => e.url == null && e.reference_url != null, Ue = /^(.*\.pdf)(?:#page=(\d+))?$/i, We = (e) => {
+	let t = Ue.exec(e);
 	return t ? {
 		baseUrl: t[1],
 		page: t[2] == null ? null : Number(t[2])
 	} : null;
-}, Oe = (t) => Z((t ?? []).filter(Ee).map((t) => {
-	let n = t.reference_url, r = $(n) != null;
+}, Ge = (t) => I((t ?? []).filter(He).map((t) => {
+	let n = t.reference_url, r = We(n) != null;
 	return { body: {
 		quote: t.data,
 		source: {
@@ -532,4 +633,4 @@ var T = {
 	} };
 }));
 //#endregion
-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 };
+export { B as CitationCard, U as CitationCardProvider, K as CitationDropdown, V as CitationMarker, O as QUOTATIONS_CLASS, de as annotationHighlightId, fe as annotationHighlightIds, xe as annotationToOfficeHighlightLocations, ue as annotationsToPdfHighlights, R as gatherSameSourceAnnotations, pe as getAnnotationPdfPage, Ge as getReferenceAttachmentGroups, ie as groupAnnotations, L as groupAnnotationsByCitId, I as groupAnnotationsBySource, Ee as injectCitationSentinels, he as isDocxRangeSelector, _e as isExcelRcRangeSelector, ge as isPptxRangeSelector, He as isReferenceOnlyAttachment, We as parsePdfPageReference, Le as replaceCitTagsWithSourceNames, $ as replaceSentinelsInChildren, me as resolveMessageAnnotations, Me as stripCitTagsWhileStreaming, Se as useAnnotations, we as useCitationCard, W as useCitationCardContext, Ve as useCitationMarkdownComponents };

package/models/office-highlight.d.ts

@@ -3,7 +3,7 @@ import { ExcelCellAddress } from '@epam/ai-dial-chat-shared';
  * A validated, normalised DOCX character-range location. `endExclusive` is
  * the wire's `end` copied through unchanged — confirmed exclusive on the
  * wire, unlike `TextCharacterRangeSelector`'s inclusive `end` (see the
- * `annotation.ts` normaliser and `design.md` D3 for the evidence).
+ * `annotation.ts` normaliser and `openspec/changes/archive/2026-09-10-highlight-office-document-annotations/design.md` D3 for the evidence).
  */
 export interface DocxOfficeHighlightLocation {
     /** Discriminates this location within `OfficeHighlightLocation`. Mirrors the wire selector's `type`. */
@@ -22,7 +22,7 @@ export interface DocxOfficeHighlightLocation {
 /**
  * A validated, normalised PPTX character-range location. `endExclusive` is
  * the wire's `end` copied through unchanged — confirmed exclusive on the
- * wire (see `design.md` D3).
+ * wire (see `openspec/changes/archive/2026-09-10-highlight-office-document-annotations/design.md` D3).
  */
 export interface PptxOfficeHighlightLocation {
     /** Discriminates this location within `OfficeHighlightLocation`. Mirrors the wire selector's `type`. */

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.99",
+  "version": "1.3.0-dev.5",
   "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.99",
-    "@epam/ai-dial-ui-kit": "^0.15.0-dev.12"
+    "@epam/ai-dial-chat-shared": "1.3.0-dev.5",
+    "@epam/ai-dial-ui-kit": "^0.15.0"
   },
   "repository": {
     "type": "git",

package/utils/annotation.d.ts

@@ -5,19 +5,21 @@ 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` comes
- * from `annotationHighlightId`, so it identifies the annotation itself rather
- * than its position in this particular input list.
+ * `body.selector` contains none of these are skipped. Each highlight `id` is
+ * the entry's id from `annotationHighlightIds(annotations)`, unique within
+ * this input list.
  */
 export declare const annotationsToPdfHighlights: (annotations: Annotation[]) => InputHighlightData[];
 /**
- * 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.
+ * Returns a stable string ID for a given annotation — the id
+ * `annotationHighlightIds` (and so `annotationsToPdfHighlights` and the Office
+ * highlight path) assigns it whenever no earlier entry of the same list
+ * already holds that id.
  *
  * Resolved in order:
- * 1. `annotation.index` when the wire supplied one — already unique within the
- *    message, and short.
+ * 1. `annotation.index` when the wire supplied one — short, but not guaranteed
+ *    unique: a payload may repeat an `index`, which `annotationHighlightIds`
+ *    disambiguates.
  * 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
@@ -30,15 +32,24 @@ export declare const annotationsToPdfHighlights: (annotations: Annotation[]) =>
  * 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
+ * citations of one document apart ([#8907](https://github.com/epam/ai-dial-chat/issues/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,
- * or `undefined` when none exists. Recognizes `pdf_bbox` selectors and both
- * `pdf_region` coordinate forms; a page is returned only for a selector whose
- * geometry also validates (see `readPdfSelectorBox`).
+ * Returns one highlight id per entry of `annotations`, unique within the list:
+ * the entry's `annotationHighlightId` when no earlier entry holds it, otherwise
+ * that id with a `-<n>` suffix no other entry's id uses.
+ */
+export declare const annotationHighlightIds: (annotations: Annotation[]) => string[];
+/**
+ * Returns the PDF page to open for the annotation, or `undefined` when none
+ * exists. Recognizes `pdf_bbox` selectors and both `pdf_region` coordinate
+ * forms. The first selector whose geometry validates wins (see
+ * `readPdfSelectorBox`), so the page matches the selected highlight; when no
+ * selector has valid geometry, the first `pdf_bbox`/`pdf_region` selector
+ * with a positive integer `page` is used, so a page-only selector still
+ * navigates without a highlight.
  */
 export declare const getAnnotationPdfPage: (annotation: Annotation) => number | undefined;
 /**

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;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"}
+{"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;AAmM1E;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,GACrC,aAAa,UAAU,EAAE,KACxB,kBAAkB,EAsBpB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,qBAAqB,GAChC,YAAY,UAAU,EACtB,eAAe,MAAM,KACpB,MAG+D,CAAC;AAEnE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,aAAa,UAAU,EAAE,KAAG,MAAM,EAqBxE,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,YAAY,UAAU,KACrB,MAAM,GAAG,SAeX,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/citation-injection.d.ts

@@ -22,6 +22,15 @@ export declare const escapeUnsupportedCitTags: (content: string) => string;
  * preventing an incomplete opening tag from swallowing the streamed suffix.
  */
 export declare const stripCitTagsWhileStreaming: (content: string) => string;
+/** Returns `html_tag` groups keyed by the `data-id` of the `<cit>` element they resolve; a message's own `groups` win over `fallbackGroups` on a colliding id. */
+export declare const buildCitGroupsByTagId: (groups: AnnotationGroup[], fallbackGroups?: AnnotationGroup[]) => Map<string, AnnotationGroup>;
+/**
+ * Returns `content` with every supported `<cit data-id="…"></cit>` element
+ * that resolves to a group replaced by that group's `sourceName` as plain
+ * Markdown text — the label its citation marker shows on screen. Unresolved
+ * tags are left untouched.
+ */
+export declare const replaceCitTagsWithSourceNames: (content: string, groups: AnnotationGroup[], fallbackGroups?: AnnotationGroup[]) => string;
 /**
  * Recursively walks a React child tree and replaces sentinel strings with
  * the result of `renderMarker(idx)`. Handles string children, arrays, and

package/utils/citation-injection.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"citation-injection.d.ts","sourceRoot":"","sources":["../../src/utils/citation-injection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAUrE;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,QAAQ,eAAe,EAAE,KACxB,MAwBF,CAAC;AAmBF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,KAAG,MAGxD,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,MAAM,KAAG,MAE5D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,SAAS,EACnB,cAAc,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,KACvC,SA0BF,CAAC"}
+{"version":3,"file":"citation-injection.d.ts","sourceRoot":"","sources":["../../src/utils/citation-injection.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAUrE;;;;;;;;GAQG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,QAAQ,eAAe,EAAE,KACxB,MAwBF,CAAC;AAmBF;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,GAAI,SAAS,MAAM,KAAG,MAGxD,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GAAI,SAAS,MAAM,KAAG,MAE5D,CAAC;AAeF,kKAAkK;AAClK,eAAO,MAAM,qBAAqB,GAChC,QAAQ,eAAe,EAAE,EACzB,iBAAgB,eAAe,EAAO,KACrC,GAAG,CAAC,MAAM,EAAE,eAAe,CAQ7B,CAAC;AAUF;;;;;GAKG;AACH,eAAO,MAAM,6BAA6B,GACxC,SAAS,MAAM,EACf,QAAQ,eAAe,EAAE,EACzB,iBAAgB,eAAe,EAAO,KACrC,MAqBF,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,GACrC,UAAU,SAAS,EACnB,cAAc,CAAC,GAAG,EAAE,MAAM,KAAK,SAAS,KACvC,SA0BF,CAAC"}

package/utils/group-annotations-by-source.d.ts

@@ -8,7 +8,7 @@ export interface AnnotationGroup {
      * cit ids citing the same document never share popup state.
      */
     groupKey: string;
-    /** The cited attachment's URL — used for Preview/Download. */
+    /** The cited attachment's URL — used for Preview/Open in browser. */
     sourceUrl: string;
     /**
      * Human-readable name derived from the URL: the last non-empty path segment
@@ -20,6 +20,8 @@ export interface AnnotationGroup {
     /** The first annotation in the group — used for the inline citation marker position. */
     primaryAnnotation: Annotation;
 }
+/** Returns the cited file's extension with a leading dot (e.g. `'.pdf'`), read from its URL and then its title, or `undefined` when neither carries one. */
+export declare const getSourceFileExtension: (annotation: Annotation) => string | undefined;
 /**
  * Groups annotations by their source attachment URL. Annotations without a
  * `body.source.attachment.url` are excluded, as are `html_tag`-selector

package/utils/group-annotations-by-source.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"group-annotations-by-source.d.ts","sourceRoot":"","sources":["../../src/utils/group-annotations-by-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,2BAA2B,CAAC;AAE7E,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,wFAAwF;IACxF,iBAAiB,EAAE,UAAU,CAAC;CAC/B;AAkDD;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,UAAU,EAAE,KACxB,eAAe,EAuBjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,aAAa,UAAU,EAAE,KACxB,eAAe,EAwBjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,UAAU,EAAE,KACxB,eAAe,EAGjB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAS,UAAU,EACnB,aAAa,UAAU,EAAE,KACxB,UAAU,EAKZ,CAAC"}
+{"version":3,"file":"group-annotations-by-source.d.ts","sourceRoot":"","sources":["../../src/utils/group-annotations-by-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAmB,MAAM,2BAA2B,CAAC;AAE7E,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB,qEAAqE;IACrE,SAAS,EAAE,MAAM,CAAC;IAClB;;;OAGG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB,+DAA+D;IAC/D,WAAW,EAAE,UAAU,EAAE,CAAC;IAC1B,wFAAwF;IACxF,iBAAiB,EAAE,UAAU,CAAC;CAC/B;AAkCD,4JAA4J;AAC5J,eAAO,MAAM,sBAAsB,GACjC,YAAY,UAAU,KACrB,MAAM,GAAG,SAOX,CAAC;AAyBF;;;;;GAKG;AACH,eAAO,MAAM,wBAAwB,GACnC,aAAa,UAAU,EAAE,KACxB,eAAe,EAuBjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,GAClC,aAAa,UAAU,EAAE,KACxB,eAAe,EAwBjB,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,gBAAgB,GAC3B,aAAa,UAAU,EAAE,KACxB,eAAe,EAGjB,CAAC;AAEF;;;;;;;;GAQG;AACH,eAAO,MAAM,2BAA2B,GACtC,SAAS,UAAU,EACnB,aAAa,UAAU,EAAE,KACxB,UAAU,EAKZ,CAAC"}