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

package/components/CitationCard/CitationCard.d.ts

@@ -20,8 +20,6 @@ export interface CitationCardLabels {
 }
 /** Color overrides for `CitationCard`, applied as CSS custom properties with app theme fallbacks. */
 export interface CitationCardColors {
-    /** Card border color. Fallback: `--stroke-primary`. */
-    cardBorder?: string;
     /** Card background color. Fallback: `--bg-layer-raised`. */
     cardBackground?: string;
     /** Quoted excerpt text color. Fallback: `--text-secondary`. */
@@ -41,6 +39,8 @@ export interface CitationCardTypography {
     titleClassName?: string;
     /** CSS class applied to the quoted excerpt. Defaults to `'dial-small-text'`. */
     quoteClassName?: string;
+    /** CSS class applied to bold spans inside the quoted excerpt. Defaults to `'dial-small-semi-text'` — the semibold step matching the default `quoteClassName`. */
+    quoteStrongClassName?: string;
     /** CSS class applied to the pagination switcher text. Defaults to `'dial-tiny-text'`. */
     switcherClassName?: string;
 }
@@ -71,6 +71,4 @@ export interface CitationCardProps {
 }
 /** Popup card displaying a citation's title, quoted excerpt, and navigation controls. */
 export declare const CitationCard: FC<CitationCardProps>;
-declare const _default: import('react').NamedExoticComponent<CitationCardProps>;
-export default _default;
 //# sourceMappingURL=CitationCard.d.ts.map

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;AAc5D,OAAO,EAAE,EAAE,EAAQ,SAAS,EAAE,MAAM,OAAO,CAAC;AAC5C,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,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,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,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,CAmI9C,CAAC;;AAEF,wBAAkC"}
+{"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"}

package/components/CitationDropdown/CitationDropdown.d.ts

@@ -24,9 +24,9 @@ export interface CitationDropdownProps {
     markerLabels: CitationMarkerLabels;
     /** Optional typography overrides forwarded to the card. */
     cardTypography?: CitationCardTypography;
+    /** 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. */
 export declare const CitationDropdown: FC<CitationDropdownProps>;
-declare const _default: import('react').NamedExoticComponent<CitationDropdownProps>;
-export default _default;
 //# 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;AAE5D,OAAO,EAAE,EAAE,EAAQ,SAAS,EAAwB,MAAM,OAAO,CAAC;AAElE,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;AAE1C,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;CACzC;AAED,8HAA8H;AAC9H,eAAO,MAAM,gBAAgB,EAAE,EAAE,CAAC,qBAAqB,CA6DtD,CAAC;;AAEF,wBAAsC"}
+{"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"}

package/components/CitationMarker/CitationMarker.d.ts

@@ -20,9 +20,9 @@ export interface CitationMarkerProps {
     icon?: ReactNode;
     /** User-visible strings. */
     labels: CitationMarkerLabels;
+    /** Typography class applied to the marker's label text. Defaults to `'dial-caption-text'`. */
+    labelClassName?: string;
 }
 /** Inline button that opens the citation popup for a source group. */
 export declare const CitationMarker: FC<CitationMarkerProps>;
-declare const _default: import('react').NamedExoticComponent<CitationMarkerProps>;
-export default _default;
 //# sourceMappingURL=CitationMarker.d.ts.map

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,EAAQ,SAAS,EAAE,MAAM,OAAO,CAAC;AAE5C,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;CAC9B;AAED,sEAAsE;AACtE,eAAO,MAAM,cAAc,EAAE,EAAE,CAAC,mBAAmB,CAuBlD,CAAC;;AAEF,wBAAoC"}
+{"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"}

package/context/CitationCardContext.d.ts

@@ -3,11 +3,11 @@ 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: (sourceUrl: string) => void;
+    openPopup: (groupKey: string) => void;
     closePopup: () => void;
-    setActiveIndex: (sourceUrl: string, index: number) => void;
-    isOpen: (sourceUrl: string) => boolean;
-    getActiveIndex: (sourceUrl: string) => number;
+    setActiveIndex: (groupKey: string, index: number) => void;
+    isOpen: (groupKey: string) => boolean;
+    getActiveIndex: (groupKey: string) => number;
 } | null>;
 /** Returns the nearest `CitationCardHook` from context. Throws when used outside a `CitationCardProvider`. */
 export declare const useCitationCardContext: () => CitationCardHook;

package/hooks/useCitationMarkdownComponents/useCitationMarkdownComponents.d.ts

@@ -0,0 +1,48 @@
+import { Annotation } from '@epam/ai-dial-chat-shared';
+import { Components } from 'react-markdown';
+import { CitationCardLabels } from '../../components/CitationCard/CitationCard';
+import { CitationMarkerLabels } from '../../components/CitationMarker/CitationMarker';
+import { AnnotationGroup } from '../../utils/group-annotations-by-source';
+/** Host-supplied callbacks and label builder consumed by `useCitationMarkdownComponents`. */
+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;
+    /** 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. */
+    buildLabels(group: AnnotationGroup): {
+        cardLabels: CitationCardLabels;
+        markerLabels: CitationMarkerLabels;
+    };
+}
+/**
+ * Builds react-markdown component overrides that inject citation markers
+ * into rendered assistant message content: a `cit` element override for
+ * `<cit data-id="…">` tags (rendered as real elements once `rehype-raw` and
+ * the host's `rehype-sanitize` allowlist parse them — see
+ * `MarkdownRenderer`'s `baseRehypePlugins`), and `p`/`li` overrides that
+ * inject markers at the character offsets of every other annotation
+ * group's primary selector.
+ *
+ * Citation card open/close state is provided via `CitationCardContext` so
+ * that state changes do not recreate the component functions, preventing
+ * ReactMarkdown from unmounting and remounting the paragraph subtree on
+ * every interaction.
+ *
+ * Returns both the pre-processed content string and the `Components` map to
+ * pass to the markdown renderer. While `isStreaming` is true, complete
+ * supported `<cit data-id="…"></cit>` elements are hidden from
+ * `processedContent`; incomplete or otherwise unsupported `cit` markup is
+ * escaped and remains visible as literal text. Citation pills for supported
+ * `<cit>` elements only appear once the message has finished streaming,
+ * matching every other citation family.
+ *
+ * `isCompactTypography` drops the paragraph class one type-scale step, matching
+ * `COMPACT_MARKDOWN_CLASS_NAMES` so cited and uncited paragraphs stay the same
+ * size.
+ */
+export declare const useCitationMarkdownComponents: (content: string, groups: AnnotationGroup[], callbacks: UseCitationMarkdownComponentsCallbacks, isStreaming?: boolean, isCompactTypography?: boolean) => {
+    processedContent: string;
+    markdownComponents: Components;
+};
+//# sourceMappingURL=useCitationMarkdownComponents.d.ts.map

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

@@ -0,0 +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"}

package/index.css

@@ -1,2 +1,2 @@
-._card_18wh9_1{border-color:var(--cc-card-border,var(--stroke-primary,#6b7280));background:var(--cc-card-bg,var(--bg-layer-raised,#fcfcfc))}._quote_18wh9_6{color:var(--cc-quote-text,var(--text-secondary,#6b7280))}._title_18wh9_10{color:var(--cc-title-text,var(--text-primary,#161b2d))}._switcher_18wh9_14{color:var(--cc-switcher-text,var(--text-secondary,#6b7280))}._sourceName_18wh9_18{color:var(--cc-source-name-text,var(--text-primary,#161b2d))}
+._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*/

package/index.d.ts

@@ -1,5 +1,5 @@
 export { CitationCard } from './components/CitationCard/CitationCard';
-export type { CitationCardLabels, CitationCardProps, CitationCardTypography, } from './components/CitationCard/CitationCard';
+export type { CitationCardColors, CitationCardLabels, CitationCardProps, CitationCardTypography, } from './components/CitationCard/CitationCard';
 export { CitationMarker } from './components/CitationMarker/CitationMarker';
 export type { CitationMarkerLabels, CitationMarkerProps, } from './components/CitationMarker/CitationMarker';
 export { CitationDropdown } from './components/CitationDropdown/CitationDropdown';
@@ -8,11 +8,13 @@ export { CitationCardProvider, useCitationCardContext, } from './context/Citatio
 export type { CitationCardHook } from './context/CitationCardContext';
 export { useAnnotations } from './utils/useAnnotations';
 export { useCitationCard } from './utils/useCitationCard';
-export { groupAnnotationsBySource } from './utils/group-annotations-by-source';
+export { useCitationMarkdownComponents } from './hooks/useCitationMarkdownComponents/useCitationMarkdownComponents';
+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 { annotationsToPdfHighlights, annotationHighlightId, normalizeRawAnnotations, resolveMessageAnnotations, } from './utils/annotation';
-export type { AttachmentResource } from './utils/annotation';
-export { injectCitationSentinels, replaceSentinelsInChildren, } from './utils/citation-injection';
+export { annotationHighlightId, annotationsToPdfHighlights, annotationToOfficeHighlightLocations, getAnnotationPdfPage, isDocxRangeSelector, isExcelRcRangeSelector, isPptxRangeSelector, resolveMessageAnnotations, } from './utils/annotation';
+export type { DocxOfficeHighlightLocation, ExcelOfficeHighlightLocation, OfficeHighlightLocation, PptxOfficeHighlightLocation, } 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';
 //# 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,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;AAG1D,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,YAAY,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AAE3E,OAAO,EACL,0BAA0B,EAC1B,qBAAqB,EACrB,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,OAAO,EACL,uBAAuB,EACvB,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,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"}

package/index.js

@@ -1,244 +1,307 @@
-import { MIMEType as e, MarkdownRenderer as t, buildCssVars as n, mergeClasses as r } from "@epam/ai-dial-chat-shared";
-import { DialEllipsisTooltip as i, DialTooltip as a, ElementSize as o, GhostIconButton as s, NeutralButton as c, PrimaryButton as l } from "@epam/ai-dial-ui-kit";
-import { IconChevronLeft as u, IconChevronRight as d } from "@tabler/icons-react";
-import { createContext as f, memo as p, useCallback as m, useContext as h, useMemo as g, useState as _ } from "react";
-import { jsx as v, jsxs as y } from "react/jsx-runtime";
-var b = {
-	card: "_card_18wh9_1",
-	quote: "_quote_18wh9_6",
-	title: "_title_18wh9_10",
-	switcher: "_switcher_18wh9_14",
-	sourceName: "_sourceName_18wh9_18"
-}, x = ({ group: a, activeIndex: c, onIndexChange: f, onPreview: p, onOpenInBrowser: m, headerIcon: h, labels: g, typography: _, colors: x }) => {
-	let S = a.annotations.length, C = a.annotations[c] ?? a.primaryAnnotation, w = S > 1, T = a.annotations.some((e) => e.body?.title), E = a.primaryAnnotation.body?.source?.attachment?.type, D = p == null || E === e.HTML || E === e.XHTML, O = _?.sourceNameClassName ?? "dial-tiny-text", k = _?.titleClassName ?? "dial-body-semi-text", A = _?.quoteClassName ?? "dial-small-text", j = _?.switcherClassName ?? "dial-tiny-text", M = n({
-		"--cc-card-border": x?.cardBorder,
+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, useMemo as S, useState as C } from "react";
+var w = {
+	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({
 		"--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__ */ y("div", {
+	return /* @__PURE__ */ v("div", {
 		role: "dialog",
 		"aria-modal": "true",
-		"aria-label": g.ariaLabel,
-		style: M,
-		className: r("flex w-[400px] flex-col gap-3 rounded-lg border p-4 shadow-lg", b.card),
+		"aria-label": y.ariaLabel,
+		style: N,
+		className: i("flex w-[400px] flex-col gap-3 rounded-lg p-4 shadow-lg", w.card),
 		children: [
-			/* @__PURE__ */ y("div", {
+			/* @__PURE__ */ v("div", {
 				className: "flex items-center justify-between gap-2",
-				children: [/* @__PURE__ */ y("div", {
+				children: [/* @__PURE__ */ v("div", {
 					className: "flex min-w-0 items-center gap-1",
-					children: [h, /* @__PURE__ */ v(i, {
-						text: a.sourceName,
-						className: r(O, "min-w-0", b.sourceName)
+					children: [g, /* @__PURE__ */ _(l, {
+						text: r.sourceName,
+						className: i(O, "min-w-0", w.sourceName)
 					})]
-				}), w && /* @__PURE__ */ y("div", {
+				}), T && /* @__PURE__ */ v("div", {
 					className: "flex shrink-0 items-center gap-1",
 					children: [
-						/* @__PURE__ */ v(s, {
-							icon: /* @__PURE__ */ v(u, {
+						/* @__PURE__ */ _(u, {
+							icon: /* @__PURE__ */ _(m, {
 								size: 14,
-								className: "rtl:scale-x-[-1]"
+								className: "rtl:scale-x-[-1]",
+								stroke: s
 							}),
-							size: o.Small,
-							"aria-label": g.previousCitation,
-							onClick: () => f((c - 1 + S) % S)
+							size: c.Small,
+							"aria-label": y.previousCitation,
+							onClick: () => o((a - 1 + S) % S)
 						}),
-						/* @__PURE__ */ v("span", {
-							className: r(j, b.switcher),
-							children: g.formatSwitcherText(c + 1, S)
+						/* @__PURE__ */ _("span", {
+							className: i(M, w.switcher),
+							children: y.formatSwitcherText(a + 1, S)
 						}),
-						/* @__PURE__ */ v(s, {
-							icon: /* @__PURE__ */ v(d, {
+						/* @__PURE__ */ _(u, {
+							icon: /* @__PURE__ */ _(h, {
 								size: 14,
-								className: "rtl:scale-x-[-1]"
+								className: "rtl:scale-x-[-1]",
+								stroke: s
 							}),
-							size: o.Small,
-							"aria-label": g.nextCitation,
-							onClick: () => f((c + 1) % S)
+							size: c.Small,
+							"aria-label": y.nextCitation,
+							onClick: () => o((a + 1) % S)
 						})
 					]
 				})]
 			}),
-			(C.body?.title || C.body?.quote || w) && /* @__PURE__ */ y("div", {
+			(C.body?.title || C.body?.quote || T) && /* @__PURE__ */ v("div", {
 				className: "flex flex-col gap-3",
-				children: [(C.body?.title || w && T) && /* @__PURE__ */ v("p", {
-					className: r(k, b.title, w && T && "min-h-[1lh]"),
-					children: C.body?.title
-				}), (C.body?.quote || w) && /* @__PURE__ */ v("div", {
-					className: r(w && "min-h-[3lh]"),
-					children: C.body?.quote && /* @__PURE__ */ v(t, {
+				children: [C.body?.title && /* @__PURE__ */ _("p", {
+					className: i(k, w.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]"),
+					children: C.body?.quote && /* @__PURE__ */ _(t, {
 						content: C.body.quote,
-						classNames: { p: r(A, "line-clamp-6", b.quote) }
+						classNames: {
+							p: i(A, w.quote),
+							ul: i(A, "ps-3"),
+							ol: i(A, "ps-3"),
+							strong: j
+						}
 					})
 				})]
 			}),
-			/* @__PURE__ */ y("div", {
+			/* @__PURE__ */ v("div", {
 				className: "flex justify-start gap-2",
-				children: [p && /* @__PURE__ */ v(l, {
-					label: g.preview,
-					size: o.Small,
+				children: [d && /* @__PURE__ */ _(f, {
+					label: y.preview,
+					size: c.Small,
+					onClick: () => d(C)
+				}), /* @__PURE__ */ _(f, {
+					label: D ? y.openInBrowser : y.download,
+					size: c.Small,
 					onClick: () => p(C)
-				}), /* @__PURE__ */ v(l, {
-					label: D ? g.openInBrowser : g.download,
-					size: o.Small,
-					onClick: () => m(C)
 				})]
 			})
 		]
 	});
-};
-p(x);
-//#endregion
-//#region src/components/CitationMarker/CitationMarker.tsx
-var S = ({ annotationCount: e, onOpen: t, icon: n, labels: r }) => {
-	let i = /* @__PURE__ */ y("span", {
+}, 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__ */ v("span", {
-			className: "dial-caption-text",
+		children: [n, /* @__PURE__ */ _("span", {
+			className: i,
 			children: e > 1 ? r.labelWithOverflow : r.label
 		})]
 	});
-	return /* @__PURE__ */ v(c, {
-		size: o.Small,
-		label: i,
+	return /* @__PURE__ */ _(d, {
+		size: c.Small,
+		label: a,
 		"aria-label": r.ariaLabel,
 		onClick: t
 	});
-};
-p(S);
-//#endregion
-//#region src/context/CitationCardContext.tsx
-var C = f(null), w = C.Provider, T = () => {
-	let e = h(C);
+}, D = y(null), O = D.Provider, k = () => {
+	let e = x(D);
 	if (e == null) throw Error("useCitationCardContext must be used within a CitationCardProvider");
 	return e;
-}, E = ({ group: e, onPreview: t, onOpenInBrowser: n, icon: r, headerIcon: i, cardLabels: o, markerLabels: s, cardTypography: c }) => {
-	let l = T(), u = l.isOpen(e.sourceUrl), d = l.getActiveIndex(e.sourceUrl);
-	return /* @__PURE__ */ v(a, {
-		open: u,
-		onOpenChange: m((e) => {
-			e || l.closePopup();
-		}, [l]),
-		placement: "bottom-end",
+}, 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]);
+	return /* @__PURE__ */ _(p, {
+		open: d,
+		onOpenChange: m,
 		triggerClassName: "ms-1 inline-flex align-middle",
-		contentClassName: "!p-0 !bg-transparent !border-0 !shadow-none !max-w-none !rounded-none",
-		tooltip: /* @__PURE__ */ v(x, {
+		contentClassName: i("!p-0 !bg-transparent !border-0 !shadow-none !max-w-none !rounded-none", A.content),
+		tooltip: /* @__PURE__ */ _(T, {
 			group: e,
-			activeIndex: d,
-			onIndexChange: (t) => l.setActiveIndex(e.sourceUrl, t),
-			onPreview: g(() => t ? (e) => {
-				t(e), l.closePopup();
-			} : void 0, [t, l]),
+			activeIndex: f,
+			onIndexChange: (t) => u.setActiveIndex(e.groupKey, t),
+			onPreview: h,
 			onOpenInBrowser: n,
-			headerIcon: i,
+			headerIcon: a,
 			labels: o,
 			typography: c
 		}),
-		children: /* @__PURE__ */ v(S, {
+		children: /* @__PURE__ */ _(E, {
 			sourceName: e.sourceName,
 			annotationCount: e.annotations.length,
-			onOpen: () => l.openPopup(e.sourceUrl),
+			onOpen: () => u.openPopup(e.groupKey),
 			icon: r,
-			labels: s
+			labels: s,
+			labelClassName: l
 		})
 	});
-};
-p(E);
-//#endregion
-//#region src/utils/annotation.ts
-var D = {
+}, M = {
 	backgroundColor: "transparent",
-	borderColor: "#124ACE",
+	borderColor: "var(--stroke-accent, #1D4ED8)",
 	borderWidth: "2px",
 	opacity: .5,
 	hoverOpacity: .5
-}, O = (e) => e.flatMap((e, t) => {
-	let n = e.body?.selector;
-	if (n == null) return [];
-	let r = (Array.isArray(n) ? n : [n]).flatMap((e) => {
-		if (e.type !== "pdf_bbox") return [];
-		let { page: t, x1: n, y1: r, x2: i, y2: a } = e;
-		return [{
-			page: t,
-			x1: n,
-			y1: r,
-			x2: i,
-			y2: a
-		}];
-	});
-	return r.length === 0 ? [] : [{
-		id: String(e.index ?? t),
-		bboxes: r,
-		style: D
-	}];
-}), k = (e, t) => String(e.index ?? t), A = (e) => typeof e == "number" ? e : null, j = (e) => {
-	if (typeof e != "object" || !e) return null;
-	let t = e;
-	if (t.type !== "pdf_region") return null;
-	let n = t.bbox;
-	if (typeof n != "object" || !n) return null;
-	let r = n, i = A(r.left), a = A(r.top), o = A(r.width), s = A(r.height);
-	return i === null || a === null || o === null || s === null ? null : {
-		type: "pdf_bbox",
-		page: A(t.page) ?? 1,
+}, N = (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) {
+		let [e, t] = n, [i, a] = r;
+		if (typeof e == "number" && typeof t == "number" && typeof i == "number" && typeof a == "number") return {
+			x1: e,
+			y1: t,
+			x2: e + i,
+			y2: t + a
+		};
+	}
+	let { left: i, top: a, width: o, height: s } = t;
+	if (typeof i == "number" && typeof a == "number" && typeof o == "number" && typeof s == "number") return {
 		x1: i,
 		y1: a,
 		x2: i + o,
 		y2: a + s
 	};
-}, M = (t, n) => t.flatMap((t) => {
-	if (typeof t != "object" || !t) return [];
-	let r = t, i = r.target;
-	if (typeof i != "object" || !i) return [];
-	let a = i, o = a.source;
-	if (typeof o != "object" || !o) return [];
-	let s = A(o.attachment_index);
-	if (s === null) return [];
-	let c = n.find((e) => e.index === s);
-	if (c?.url == null) return [];
-	let l = j(a.selector);
-	if (l === null) return [];
-	let u = r.body, d = typeof u == "object" && u ? u : {}, f = typeof d.title == "string" ? d.title : void 0, p = typeof d.quote == "string" ? d.quote : void 0;
-	return [{
-		index: A(r.index) ?? void 0,
-		body: {
-			title: f,
-			quote: p,
-			source: {
-				type: "attachment",
-				attachment: {
-					type: c.type ?? e.PDF,
-					url: c.url,
-					title: c.title
-				}
-			},
-			selector: l
-		}
+}, P = (e) => {
+	if (!r(e)) return;
+	let t = e, n;
+	if (t.type === "pdf_bbox") {
+		let { x1: e, y1: r, x2: i, y2: a } = t;
+		typeof e == "number" && typeof r == "number" && typeof i == "number" && typeof a == "number" && (n = {
+			x1: e,
+			y1: r,
+			x2: i,
+			y2: a
+		});
+	} else t.type === "pdf_region" && (n = N(t.bbox));
+	if (n == null) return;
+	let i = t.page;
+	if (!(typeof i != "number" || !Number.isInteger(i) || i < 1) && [
+		n.x1,
+		n.y1,
+		n.x2,
+		n.y2
+	].every(Number.isFinite)) return {
+		page: i,
+		x1: n.x1,
+		y1: n.y1,
+		x2: n.x2,
+		y2: n.y2
+	};
+}, ee = (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);
+		return t == null ? [] : [t];
+	});
+	return i.length === 0 ? [] : [{
+		id: String(e.index ?? t),
+		bboxes: i,
+		style: M
 	}];
-}), N = (e) => {
+}), te = (e, t) => String(e.index ?? t), ne = (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);
+		if (t != null) return t.page;
+	}
+}, F = (e) => {
 	let t = e.custom_content?.annotations;
-	if (t?.length) return t.filter((e) => e != null && e.body?.source?.attachment?.url != null);
+	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 ? [] : M(r, e.custom_content?.attachments ?? []);
-}, P = (e, t) => g(() => t ? [] : N(e), [t, e]), F = {
-	openGroupSourceUrl: null,
+	return !Array.isArray(r) || r.length === 0 ? [] : o(r, e.custom_content?.attachments ?? []).map(a);
+}, I = (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) => {
+	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) => {
+	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) => {
+	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",
+		story: t,
+		path: n,
+		start: r,
+		endExclusive: i,
+		text: a
+	};
+}, ie = (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",
+		slide: t,
+		shapeId: n,
+		start: r,
+		endExclusive: i,
+		text: a
+	};
+}, ae = (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 {
+			type: "excel_rc_range",
+			sheet: t,
+			start: n
+		};
+		if (!(!Number.isInteger(r.row) || !Number.isInteger(r.col) || r.row !== n.row || r.col < n.col)) return {
+			type: "excel_rc_range",
+			sheet: t,
+			start: n,
+			end: r
+		};
+	}
+}, oe = (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);
+			return t ? [t] : [];
+		}
+		if (L(e)) {
+			let t = ie(e);
+			return t ? [t] : [];
+		}
+		if (z(e)) {
+			let t = ae(e);
+			return t ? [t] : [];
+		}
+		return [];
+	});
+}, se = (e, t) => S(() => t ? [] : F(e), [t, e]), ce = {
+	openGroupKey: null,
 	activeIndexByGroup: {}
-}, I = () => {
-	let [e, t] = _(F), n = m((e) => {
+}, le = () => {
+	let [e, t] = C(ce), n = b((e) => {
 		t((t) => ({
 			...t,
-			openGroupSourceUrl: e
+			openGroupKey: e
 		}));
-	}, []), r = m(() => {
+	}, []), r = b(() => {
 		t((e) => ({
 			...e,
-			openGroupSourceUrl: null
+			openGroupKey: null
 		}));
-	}, []), i = m((e, n) => {
+	}, []), i = b((e, n) => {
 		t((t) => ({
 			...t,
 			activeIndexByGroup: {
@@ -247,11 +310,11 @@ var D = {
 			}
 		}));
 	}, []);
-	return g(() => ({
+	return S(() => ({
 		openPopup: n,
 		closePopup: r,
 		setActiveIndex: i,
-		isOpen: (t) => e.openGroupSourceUrl === t,
+		isOpen: (t) => e.openGroupKey === t,
 		getActiveIndex: (t) => e.activeIndexByGroup[t] ?? 0
 	}), [
 		n,
@@ -259,64 +322,151 @@ var D = {
 		i,
 		e
 	]);
-}, L = (e) => {
+}, ue = /⟦C(\d+)⟧/g, B = (e, t) => {
+	let n = t.map((e, t) => ({
+		g: e,
+		idx: t
+	})).filter(({ g: e }) => e.primaryAnnotation.target?.selector?.type !== "html_tag").map(({ g: t, idx: n }) => {
+		let r = t.primaryAnnotation.target?.selector, i = typeof r == "object" && r && "type" in r && r.type === "text_character_range" ? r.end : e.length;
+		return {
+			idx: n,
+			pos: Math.min(i, e.length)
+		};
+	}).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) => {
+	if (typeof e == "string") {
+		let n = e.split(ue);
+		if (n.length === 1) return e;
+		let r = [];
+		return n.forEach((e, n) => {
+			n % 2 == 1 ? r.push(t(parseInt(e, 10))) : e && r.push(e);
+		}), r;
+	}
+	return Array.isArray(e) ? e.flatMap((e) => {
+		let n = G(e, t);
+		return Array.isArray(n) ? n : [n];
+	}) : e;
+}, pe = (e) => {
+	let t = e.primaryAnnotation.target?.selector;
+	return t?.type === "html_tag" ? t.id : void 0;
+}, me = (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), [
+		e,
+		t,
+		r
+	]), u = l.includes("<cit");
+	return {
+		processedContent: l,
+		markdownComponents: S(() => {
+			let e = /* @__PURE__ */ new Map();
+			for (let n of t) {
+				let t = pe(n);
+				t != null && e.set(t, n);
+			}
+			let n = (e) => {
+				let { cardLabels: t, markerLabels: n } = c(e);
+				return /* @__PURE__ */ _(j, {
+					group: e,
+					onPreview: (t) => o(t, e),
+					onOpenInBrowser: s,
+					cardLabels: t,
+					markerLabels: n
+				}, `citation-${e.groupKey}`);
+			}, r = (e) => {
+				let r = t[e];
+				return r ? n(r) : null;
+			}, l = { 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 t.length === 0 ? u ? l : {} : {
+				...l,
+				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)
+				}),
+				li: ({ children: e, ...t }) => /* @__PURE__ */ _("li", {
+					...t,
+					className: "mb-1.5 last:mb-0",
+					children: G(e, r)
+				})
+			};
+		}, [
+			t,
+			o,
+			s,
+			c,
+			a,
+			u
+		])
+	};
+}, K = (e) => {
 	try {
 		return decodeURIComponent(e);
 	} catch {
 		return e;
 	}
-}, R = (e) => {
+}, ge = (e) => {
 	try {
 		let t = new URL(e);
-		return t.pathname.split("/").map((e) => L(e)).filter(Boolean).at(-1) ?? t.hostname;
+		return t.pathname.split("/").map((e) => K(e)).filter(Boolean).at(-1) ?? t.hostname;
 	} catch {
-		return e.split("/").map((e) => L(e)).filter(Boolean).at(-1) ?? e;
+		return e.split("/").map((e) => K(e)).filter(Boolean).at(-1) ?? e;
 	}
-}, z = (e) => {
+}, q = (e, t) => e.body?.source?.attachment?.title ?? ge(t), J = (e) => {
+	let t = e.target?.selector;
+	return t?.type === "html_tag" ? t : void 0;
+}, _e = (e) => J(e) != null, Y = (e) => {
 	let t = /* @__PURE__ */ new Map();
 	for (let n of e) {
+		if (_e(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.body?.source?.attachment?.title ?? R(e),
+			sourceName: q(n, e),
 			annotations: [n],
 			primaryAnnotation: n
 		});
 	}
 	return Array.from(t.values());
-}, B = /⟦C(\d+)⟧/g, V = (e, t) => {
-	let n = t.map((t, n) => {
-		let r = t.primaryAnnotation.target?.selector, i = typeof r == "object" && r && "type" in r && r.type === "text_character_range" ? r.end : e.length;
-		return {
-			idx: n,
-			pos: Math.min(i, e.length)
-		};
-	}).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;
-}, H = (e, t) => {
-	if (typeof e == "string") {
-		let n = e.split(B);
-		if (n.length === 1) return e;
-		let r = [];
-		return n.forEach((e, n) => {
-			n % 2 == 1 ? r.push(t(parseInt(e, 10))) : e && r.push(e);
-		}), r;
+}, X = (e) => {
+	let t = /* @__PURE__ */ new Map();
+	for (let n of e) {
+		let e = J(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: q(n, r),
+			annotations: [n],
+			primaryAnnotation: n
+		});
 	}
-	return Array.isArray(e) ? e.flatMap((e) => {
-		let n = H(e, t);
-		return Array.isArray(n) ? n : [n];
-	}) : e;
-}, U = (e) => e.url == null && e.reference_url != null, W = /^(.*\.pdf)(?:#page=(\d+))?$/i, G = (e) => {
-	let t = W.exec(e);
+	return Array.from(t.values());
+}, ve = (e) => [...X(e), ...Y(e)], Z = (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);
 	return t ? {
 		baseUrl: t[1],
 		page: t[2] == null ? null : Number(t[2])
 	} : null;
-}, K = (t) => z((t ?? []).filter(U).map((t) => {
-	let n = t.reference_url, r = G(n) != null;
+}, be = (t) => Y((t ?? []).filter(Q).map((t) => {
+	let n = t.reference_url, r = $(n) != null;
 	return { body: {
 		quote: t.data,
 		source: {
@@ -330,4 +480,4 @@ var D = {
 	} };
 }));
 //#endregion
-export { x as CitationCard, w as CitationCardProvider, E as CitationDropdown, S as CitationMarker, k as annotationHighlightId, O as annotationsToPdfHighlights, K as getReferenceAttachmentGroups, z as groupAnnotationsBySource, V as injectCitationSentinels, U as isReferenceOnlyAttachment, M as normalizeRawAnnotations, G as parsePdfPageReference, H as replaceSentinelsInChildren, N as resolveMessageAnnotations, P as useAnnotations, I as useCitationCard, T as useCitationCardContext };
+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 };

package/models/office-highlight.d.ts

@@ -0,0 +1,62 @@
+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).
+ */
+export interface DocxOfficeHighlightLocation {
+    /** Discriminates this location within `OfficeHighlightLocation`. Mirrors the wire selector's `type`. */
+    type: 'docx_text_range';
+    /** Name of the DOCX story the range lives in, as an opaque string (only `'body'` is confirmed upstream). */
+    story: string;
+    /** Source-tree element indices identifying the paragraph, matched element-wise. */
+    path: number[];
+    /** Zero-based start character offset. */
+    start: number;
+    /** Zero-based exclusive end character offset. */
+    endExclusive: number;
+    /** The cited text, expected to equal the text resolved over `[start, endExclusive)`. */
+    text: string;
+}
+/**
+ * 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).
+ */
+export interface PptxOfficeHighlightLocation {
+    /** Discriminates this location within `OfficeHighlightLocation`. Mirrors the wire selector's `type`. */
+    type: 'pptx_text_range';
+    /** 1-based slide number. */
+    slide: number;
+    /** Shape identifier, compared as a string against the run's own shape id. */
+    shapeId: string;
+    /** Zero-based start character offset. */
+    start: number;
+    /** Zero-based exclusive end character offset. */
+    endExclusive: number;
+    /** The cited text, expected to equal the text resolved over `[start, endExclusive)`. */
+    text: string;
+}
+/** 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`. */
+    type: 'excel_rc_range';
+    /** Sheet name, matched exactly against the workbook's own sheet names. */
+    sheet: string;
+    /** First cell of the range. */
+    start: ExcelCellAddress;
+    /** Last (inclusive) cell of the range, on the same row as `start`. Omitted for a single cell. */
+    end?: ExcelCellAddress;
+}
+/**
+ * A validated, normalised Office document highlight location, produced by
+ * `annotationToOfficeHighlightLocations`. Intentionally not the
+ * `@epam/ai-dial-attachment-canvas` `OoxmlHighlightLocation` shape — this lib
+ * must not depend on `attachment-canvas` (that lib's own test already
+ * depends on this one, via `annotationsToPdfHighlights`, and a lib-to-lib
+ * cycle is not permitted). `libs/chat-hooks`, which already depends on both,
+ * maps this into `OoxmlHighlight`/`OoxmlHighlightLocation`.
+ */
+export type OfficeHighlightLocation = DocxOfficeHighlightLocation | PptxOfficeHighlightLocation | ExcelOfficeHighlightLocation;
+//# sourceMappingURL=office-highlight.d.ts.map

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

@@ -0,0 +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"}

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.1.0-dev.99",
+  "version": "1.2.0-dev.1",
   "license": "Apache-2.0",
   "type": "module",
   "main": "./index.js",
@@ -9,18 +9,22 @@
   "types": "./index.d.ts",
   "exports": {
     "./package.json": "./package.json",
+    "./styles.css": "./index.css",
     ".": {
       "types": "./index.d.ts",
       "import": "./index.js",
       "default": "./index.js"
     }
   },
+  "dependencies": {
+    "@tabler/icons-react": "^3.44.0",
+    "react-markdown": "^10.1.0",
+    "@epam/pdf-highlighter-kit": "^0.0.19"
+  },
   "peerDependencies": {
-    "react": "^19.0.0",
-    "@tabler/icons-react": "^3.0.0",
-    "@epam/ai-dial-chat-shared": "1.1.0-dev.99",
-    "@epam/ai-dial-ui-kit": "^0.13.0-dev.26",
-    "@epam/pdf-highlighter-kit": ">=0.0.14"
+    "react": "^19.2.8",
+    "@epam/ai-dial-chat-shared": "1.2.0-dev.1",
+    "@epam/ai-dial-ui-kit": "^0.14.2"
   },
   "repository": {
     "type": "git",

package/utils/annotation.d.ts

@@ -1,27 +1,23 @@
-import { Annotation, AttachmentResource, Message, MessageAttachment } from '@epam/ai-dial-chat-shared';
+import { Annotation, AnnotationSelector, DocxRangeSelector, ExcelRcRangeSelector, Message, PptxRangeSelector } from '@epam/ai-dial-chat-shared';
 import { InputHighlightData } from '@epam/pdf-highlighter-kit';
+import { OfficeHighlightLocation } from '../models/office-highlight';
 /**
  * Maps a list of annotations to `InputHighlightData` entries for the PDF viewer.
- * Annotations whose `body.selector` contains no `pdf_bbox` selectors are skipped.
- * The highlight `id` is `annotation.index` when present, otherwise the position
- * in the input array.
+ * 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.
  */
 export declare const annotationsToPdfHighlights: (annotations: Annotation[]) => InputHighlightData[];
 /** Returns a stable string ID for a given annotation, matching the IDs produced by `annotationsToPdfHighlights`. */
 export declare const annotationHighlightId: (annotation: Annotation, fallbackIndex: number) => string;
 /**
- * Normalizes raw annotations from the API wire format (stored in
- * `message.custom_fields.annotations`) to the internal `Annotation` model.
- *
- * The API format uses `target.source.attachment_index` (integer) and a
- * `pdf_region` selector with `{ left, top, width, height }` coordinates.
- * The internal model uses `body.source.attachment.url` (resolved URL) and a
- * `pdf_bbox` selector with `{ x1, y1, x2, y2 }` coordinates.
- *
- * Annotations whose attachment index cannot be resolved or whose selector
- * is not a recognised PDF region are omitted from the result.
+ * 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`).
  */
-export declare const normalizeRawAnnotations: (rawAnnotations: unknown[], attachments: MessageAttachment[]) => Annotation[];
+export declare const getAnnotationPdfPage: (annotation: Annotation) => number | undefined;
 /**
  * Resolves the annotation list for a message regardless of how it was loaded.
  *
@@ -30,5 +26,26 @@ export declare const normalizeRawAnnotations: (rawAnnotations: unknown[], attach
  * normalises those entries using the message's `custom_content.attachments`.
  */
 export declare const resolveMessageAnnotations: (message: Message) => Annotation[];
-export type { AttachmentResource };
+/**
+ * Returns whether `selector` is a `docx_text_range` selector carrying every
+ * field the shape requires — a `_range`-suffixed selector missing any field
+ * (or with a wrongly-typed one) does not match.
+ */
+export declare const isDocxRangeSelector: (selector: AnnotationSelector) => selector is DocxRangeSelector;
+/**
+ * Returns whether `selector` is a `pptx_text_range` selector carrying every
+ * field the shape requires.
+ */
+export declare const isPptxRangeSelector: (selector: AnnotationSelector) => selector is PptxRangeSelector;
+/**
+ * Returns whether `selector` is an `excel_rc_range` selector carrying every
+ * field the shape requires. `end` may be a cell address, `null`, or absent.
+ */
+export declare const isExcelRcRangeSelector: (selector: AnnotationSelector) => selector is ExcelRcRangeSelector;
+/**
+ * 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.
+ */
+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,OAAO,EACP,iBAAiB,EAElB,MAAM,2BAA2B,CAAC;AAEnC,OAAO,KAAK,EAEV,kBAAkB,EACnB,MAAM,2BAA2B,CAAC;AAUnC;;;;;GAKG;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;AA+BvD;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,uBAAuB,GAClC,gBAAgB,OAAO,EAAE,EACzB,aAAa,iBAAiB,EAAE,KAC/B,UAAU,EAmDT,CAAC;AAEL;;;;;;GAMG;AACH,eAAO,MAAM,yBAAyB,GAAI,SAAS,OAAO,KAAG,UAAU,EAkBtE,CAAC;AAGF,YAAY,EAAE,kBAAkB,EAAE,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;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"}

package/utils/citation-injection.d.ts

@@ -2,10 +2,26 @@ import { ReactNode } from 'react';
 import { AnnotationGroup } from './group-annotations-by-source';
 /**
  * Inserts sentinel strings into `content` at the `end` character offsets of
- * each annotation group's primary selector. Offsets are processed in
- * descending order so earlier insertions do not shift later ones.
+ * each non-`html_tag` annotation group's primary selector (descending order
+ * so earlier insertions don't shift later ones). Sentinel indices are the
+ * group's position in the original flat `groups` array, so a caller doing
+ * `groups[idx]` still resolves correctly even though `html_tag` groups are
+ * skipped here — those render as real `<cit>` elements instead (see
+ * `useCitationMarkdownComponents`'s `cit` component override).
  */
 export declare const injectCitationSentinels: (content: string, groups: AnnotationGroup[]) => string;
+/**
+ * Leaves the one supported paired citation element parseable as HTML and
+ * escapes every other `cit` shape so Markdown renders the original markup as
+ * visible text. Unsupported markup is never interpreted as a citation.
+ */
+export declare const escapeUnsupportedCitTags: (content: string) => string;
+/**
+ * Hides supported paired citation elements while the message is streaming.
+ * Every other `cit` shape is escaped and remains visible as ordinary text,
+ * preventing an incomplete opening tag from swallowing the streamed suffix.
+ */
+export declare const stripCitTagsWhileStreaming: (content: string) => 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;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,GAClC,SAAS,MAAM,EACf,QAAQ,eAAe,EAAE,KACxB,MAoBF,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":"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"}

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

@@ -1,7 +1,14 @@
 import { Annotation } from '@epam/ai-dial-chat-shared';
-/** A set of annotations that all cite the same source document. */
+/** A set of annotations rendered behind one inline citation marker. */
 export interface AnnotationGroup {
-    /** The attachment URL shared by all annotations in this group. */
+    /**
+     * This group's identity — used for open/active-index popup state and
+     * React keys. Equals `sourceUrl` for a `groupAnnotationsBySource` group;
+     * equals `` `cit:${id}` `` for a `groupAnnotationsByCitId` group, so two
+     * cit ids citing the same document never share popup state.
+     */
+    groupKey: string;
+    /** The cited attachment's URL — used for Preview/Download. */
     sourceUrl: string;
     /**
      * Human-readable name derived from the URL: the last non-empty path segment
@@ -13,6 +20,35 @@ export interface AnnotationGroup {
     /** The first annotation in the group — used for the inline citation marker position. */
     primaryAnnotation: Annotation;
 }
-/** Groups annotations by their source attachment URL. Annotations without a `body.source.attachment.url` are excluded. */
+/**
+ * Groups annotations by their source attachment URL. Annotations without a
+ * `body.source.attachment.url` are excluded, as are `html_tag`-selector
+ * annotations — those are grouped by tag id instead, see
+ * `groupAnnotationsByCitId`.
+ */
 export declare const groupAnnotationsBySource: (annotations: Annotation[]) => AnnotationGroup[];
+/**
+ * Groups `html_tag`-selector annotations by `target.selector.id`, one group
+ * per distinct tag id — never collapsing two different ids that cite the
+ * same source document into one group. Annotations without
+ * `target.selector.id` or without `body.source.attachment.url` are excluded.
+ */
+export declare const groupAnnotationsByCitId: (annotations: Annotation[]) => AnnotationGroup[];
+/**
+ * Partitions annotations by selector type and groups each family with its
+ * own algorithm: `html_tag` annotations via `groupAnnotationsByCitId`, every
+ * other annotation via `groupAnnotationsBySource`. Lets a host render
+ * citations without branching on selector type itself.
+ */
+export declare const groupAnnotations: (annotations: Annotation[]) => AnnotationGroup[];
+/**
+ * Returns every annotation in `annotations` whose `body.source.attachment.url`
+ * equals `clicked`'s, in their original order — gathering across the whole
+ * list rather than one `cit`-id group, so annotations behind other markers
+ * citing the same file are included too. Keys on URL, never on the display
+ * title, since two different files can share a title. Returns `[clicked]`
+ * when `clicked` is not itself present in `annotations` (identified by
+ * reference identity) or has no source URL.
+ */
+export declare const gatherSameSourceAnnotations: (clicked: Annotation, annotations: Annotation[]) => Annotation[];
 //# sourceMappingURL=group-annotations-by-source.d.ts.map

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,EAAE,MAAM,2BAA2B,CAAC;AAE5D,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,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;AA2BD,0HAA0H;AAC1H,eAAO,MAAM,wBAAwB,GACnC,aAAa,UAAU,EAAE,KACxB,eAAe,EAsBjB,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,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"}

package/utils/useCitationCard.d.ts

@@ -1,12 +1,15 @@
 /**
  * Manages open/close state and per-group active annotation index for citation
- * cards within a single assistant message.
+ * 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.
  */
 export declare const useCitationCard: () => {
-    openPopup: (sourceUrl: string) => void;
+    openPopup: (groupKey: string) => void;
     closePopup: () => void;
-    setActiveIndex: (sourceUrl: string, index: number) => void;
-    isOpen: (sourceUrl: string) => boolean;
-    getActiveIndex: (sourceUrl: string) => number;
+    setActiveIndex: (groupKey: string, index: number) => void;
+    isOpen: (groupKey: 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;;;GAGG;AACH,eAAO,MAAM,eAAe;2BAGgB,MAAM;;gCAQD,MAAM,SAAS,MAAM;wBAY5C,MAAM;gCACE,MAAM;CAKvC,CAAC"}
+{"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"}