@e-llm-studio/requirement-ai 0.0.253 → 0.0.255

package/dist/types/src/features/DualCitation/SourceBQDataCompnent.d.ts

@@ -0,0 +1,36 @@
+/**
+ * SourcesBQCitation.tsx
+ *
+ * Simplified citation renderer: finds the right source by SKU ID,
+ * picks the citation entry by citationNumber, and renders ONLY the
+ * data table with column highlighting — no reasoning/gap/footer panels.
+ *
+ * URL shape:
+ *   ./columnName=sku?citationNumber=1&citation_type=bq_data&sku_id=20QH20N5
+ */
+import React from 'react';
+export interface SourcesBQHrefParams {
+    columnName: string;
+    citationNumber: string;
+    citationType: string;
+    skuId: string;
+}
+export type SourceCitationEntry = Record<string, any[]>;
+export interface SourceObject {
+    citations: Record<string, SourceCitationEntry>;
+    gap: string;
+    score: number;
+    reasoning: string;
+}
+export declare function parseSourcesBQHref(href: string): SourcesBQHrefParams | null;
+export declare function findSourceCitation(sources: Record<string, SourceObject> | undefined | null, skuId: string): [string, SourceObject] | null;
+interface SourcesBQCitationProps {
+    hrefParams: SourcesBQHrefParams;
+    sourceObj: SourceObject;
+    children: React.ReactNode;
+    defaultOpen?: boolean;
+    showChevron?: boolean;
+}
+export declare const SourcesBQCitation: React.FC<SourcesBQCitationProps>;
+export {};
+//# sourceMappingURL=SourceBQDataCompnent.d.ts.map

package/dist/types/src/features/DualCitation/SourceBQDataCompnent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SourceBQDataCompnent.d.ts","sourceRoot":"","sources":["../../../../../src/features/DualCitation/SourceBQDataCompnent.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAsC,MAAM,OAAO,CAAC;AAM3D,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,MAAM,mBAAmB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,CAAC;AAExD,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAID,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,mBAAmB,GAAG,IAAI,CA2B3E;AAID,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,SAAS,GAAG,IAAI,EACxD,KAAK,EAAE,MAAM,GACZ,CAAC,MAAM,EAAE,YAAY,CAAC,GAAG,IAAI,CA+B/B;AAmKD,UAAU,sBAAsB;IAC9B,UAAU,EAAE,mBAAmB,CAAC;IAChC,SAAS,EAAE,YAAY,CAAC;IACxB,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,eAAO,MAAM,iBAAiB,EAAE,KAAK,CAAC,EAAE,CAAC,sBAAsB,CAmD9D,CAAC"}

package/dist/types/src/features/EmailCitation/EmailCitation.d.ts

@@ -0,0 +1,43 @@
+import { ReactNode } from "react";
+export interface CitationAttachment {
+    name: string;
+    type?: string;
+}
+export interface CitationItem {
+    source_field: "from" | "to" | "body" | "subject" | "cc" | string;
+    cited_text: string | string[];
+}
+export interface CitationEmailData {
+    subject: string;
+    from: string;
+    from_name?: string;
+    from_email: string;
+    to: string;
+    cc?: string | null;
+    date: string;
+    body: string;
+}
+export interface CitationEmailCardProps {
+    title?: string;
+    relevance: number;
+    email: CitationEmailData;
+    citations?: CitationItem[];
+    attachments?: CitationAttachment[];
+    toggleLabel?: string;
+    mailIcon?: ReactNode;
+    chevronUpIcon?: ReactNode;
+    chevronDownIcon?: ReactNode;
+    paperclipIcon?: ReactNode;
+    fileTextIcon?: ReactNode;
+    downloadIcon?: ReactNode;
+}
+export declare const formatEmailDate: (dateString: string) => string;
+export declare const HighlightedText: ({ text, highlights, style, firstHighlightRef, }: {
+    text: string;
+    highlights: string[];
+    style?: import("react").CSSProperties | undefined;
+    firstHighlightRef?: import("react").RefObject<HTMLElement> | undefined;
+}) => import("react/jsx-runtime").JSX.Element;
+declare const CitationEmailCard: ({ title, relevance, email, citations, attachments, toggleLabel, mailIcon, chevronUpIcon, chevronDownIcon, paperclipIcon, fileTextIcon, downloadIcon, }: CitationEmailCardProps) => import("react/jsx-runtime").JSX.Element;
+export default CitationEmailCard;
+//# sourceMappingURL=EmailCitation.d.ts.map

package/dist/types/src/features/EmailCitation/EmailCitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailCitation.d.ts","sourceRoot":"","sources":["../../../../../src/features/EmailCitation/EmailCitation.tsx"],"names":[],"mappings":"AAAA,OAAO,EAA+B,SAAS,EAAE,MAAM,OAAO,CAAC;AAa/D,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAAC;IACjE,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,iBAAiB,CAAC;IACzB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAC3B,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,eAAe,CAAC,EAAE,SAAS,CAAC;IAC5B,aAAa,CAAC,EAAE,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,SAAS,CAAC;IACzB,YAAY,CAAC,EAAE,SAAS,CAAC;CAC1B;AA2DD,eAAO,MAAM,eAAe,eAAgB,MAAM,WAcjD,CAAC;AAuBF,eAAO,MAAM,eAAe;UAMpB,MAAM;gBACA,MAAM,EAAE;;;6CAmCrB,CAAC;AAKF,QAAA,MAAM,iBAAiB,2JAapB,sBAAsB,4CA+TxB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/types/src/features/EmailCitation/components/EmailMetaDropdown.d.ts

@@ -0,0 +1,10 @@
+import { CitationEmailData } from "../EmailCitation";
+export interface EmailMetaDropdownProps {
+    email: CitationEmailData;
+    toList: string[];
+    ccList: string[];
+    highlightsFor?: (field: string) => string[];
+}
+declare const EmailMetaDropdown: ({ email, toList, ccList, highlightsFor, }: EmailMetaDropdownProps) => import("react/jsx-runtime").JSX.Element;
+export default EmailMetaDropdown;
+//# sourceMappingURL=EmailMetaDropdown.d.ts.map

package/dist/types/src/features/EmailCitation/components/EmailMetaDropdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailMetaDropdown.d.ts","sourceRoot":"","sources":["../../../../../../src/features/EmailCitation/components/EmailMetaDropdown.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAoC,MAAM,kBAAkB,CAAC;AAGvF,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,iBAAiB,CAAC;IACzB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CAC7C;AAGD,QAAA,MAAM,iBAAiB,8CAKpB,sBAAsB,4CA4DxB,CAAC;AAEF,eAAe,iBAAiB,CAAC"}

package/dist/types/src/features/ExcelCitation/ExcelCitations.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+import "./css/excel-citation.css";
+export interface DataDict {
+    [key: number]: string[];
+}
+interface ExcelCitationProps {
+    data: DataDict;
+    highlightRow?: number;
+    loading: boolean;
+    isErrored: boolean;
+    highlightText?: string | null;
+}
+declare const ExcelCitation: React.FC<ExcelCitationProps>;
+export default ExcelCitation;
+//# sourceMappingURL=ExcelCitations.d.ts.map

package/dist/types/src/features/ExcelCitation/ExcelCitations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ExcelCitations.d.ts","sourceRoot":"","sources":["../../../../../src/features/ExcelCitation/ExcelCitations.tsx"],"names":[],"mappings":"AAAA,OAAO,KAA4B,MAAM,OAAO,CAAC;AAEjD,OAAO,0BAA0B,CAAC;AAElC,MAAM,WAAW,QAAQ;IACvB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACzB;AAED,UAAU,kBAAkB;IAC1B,IAAI,EAAE,QAAQ,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,QAAA,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA0M/C,CAAC;AAEF,eAAe,aAAa,CAAC"}

package/dist/types/src/features/ExcelCitation/utils/helper.d.ts

@@ -0,0 +1,2 @@
+export declare const highlightMatch: (originalText: string, highlightText: string) => (string | import("react/jsx-runtime").JSX.Element)[];
+//# sourceMappingURL=helper.d.ts.map

package/dist/types/src/features/ExcelCitation/utils/helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../../../../../../src/features/ExcelCitation/utils/helper.tsx"],"names":[],"mappings":"AAAA,eAAO,MAAM,cAAc,iBAAkB,MAAM,iBAAiB,MAAM,yDAoBzE,CAAC"}

package/dist/types/src/features/GptWebCitation/GptWebCitation.d.ts

@@ -0,0 +1,15 @@
+import React from "react";
+import { IGptWebCitationProps } from "./types";
+/**
+ * Composite citation component: GPT reasoning panel with an optional web citation view.
+ *
+ * Import:
+ * ```tsx
+ * import GptWebCitation from "@e-llm-studio/citation/GptWebCitation";
+ * ```
+ *
+ * @see {@link IGptWebCitationProps} for full prop documentation (IDE hover hints).
+ */
+declare const GptWebCitation: React.FC<IGptWebCitationProps>;
+export default GptWebCitation;
+//# sourceMappingURL=GptWebCitation.d.ts.map

package/dist/types/src/features/GptWebCitation/GptWebCitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GptWebCitation.d.ts","sourceRoot":"","sources":["../../../../../src/features/GptWebCitation/GptWebCitation.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAyC,MAAM,OAAO,CAAC;AAK9D,OAAO,EAAE,oBAAoB,EAA4I,MAAM,SAAS,CAAC;AAmGzL;;;;;;;;;GASG;AACH,QAAA,MAAM,cAAc,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CAqQlD,CAAC;AAEF,eAAe,cAAc,CAAC"}

package/dist/types/src/features/GptWebCitation/GptWebCitationImageCitation.d.ts

@@ -0,0 +1,16 @@
+import { IGptWebCitationImageIconsConfig, IGptWebCitationImageStyles, IGptWebCitationSkeletonStyles, IGptWebCitationVisitLinkStyles } from "./types";
+type GptWebCitationImageCitationProps = {
+    citationImage: string;
+    citationUrl?: string;
+    skeletonVisitUrl?: string;
+    showExpandImageButton?: boolean;
+    iconsConfig?: IGptWebCitationImageIconsConfig;
+    styles?: IGptWebCitationImageStyles;
+    visitLinkStyles?: IGptWebCitationVisitLinkStyles;
+    skeletonStyles?: IGptWebCitationSkeletonStyles;
+    skeletonVisitLinkStyles?: IGptWebCitationVisitLinkStyles;
+    isFixedHeight?: boolean;
+};
+declare const GptWebCitationImageCitation: ({ citationImage, citationUrl, skeletonVisitUrl, showExpandImageButton, iconsConfig, styles: styleOverrides, visitLinkStyles, skeletonStyles, skeletonVisitLinkStyles, isFixedHeight, }: GptWebCitationImageCitationProps) => import("react/jsx-runtime").JSX.Element;
+export default GptWebCitationImageCitation;
+//# sourceMappingURL=GptWebCitationImageCitation.d.ts.map

package/dist/types/src/features/GptWebCitation/GptWebCitationImageCitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GptWebCitationImageCitation.d.ts","sourceRoot":"","sources":["../../../../../src/features/GptWebCitation/GptWebCitationImageCitation.tsx"],"names":[],"mappings":"AAIA,OAAO,EACL,+BAA+B,EAC/B,0BAA0B,EAC1B,6BAA6B,EAC7B,8BAA8B,EAC/B,MAAM,SAAS,CAAC;AAIjB,KAAK,gCAAgC,GAAG;IACtC,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,WAAW,CAAC,EAAE,+BAA+B,CAAC;IAC9C,MAAM,CAAC,EAAE,0BAA0B,CAAC;IACpC,eAAe,CAAC,EAAE,8BAA8B,CAAC;IACjD,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAC/C,uBAAuB,CAAC,EAAE,8BAA8B,CAAC;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAIF,QAAA,MAAM,2BAA2B,2LAW9B,gCAAgC,4CAwIlC,CAAC;AAEF,eAAe,2BAA2B,CAAC"}

package/dist/types/src/features/GptWebCitation/GptWebCitationImageFullScreenView.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+import { IGptWebCitationFullScreenStyles } from "./types";
+type GptWebCitationImageFullScreenViewProps = {
+    src: string;
+    onClose: () => void;
+    styles?: IGptWebCitationFullScreenStyles;
+};
+declare const GptWebCitationImageFullScreenView: ({ src, onClose, styles: styleOverrides, }: GptWebCitationImageFullScreenViewProps) => React.ReactPortal;
+export default GptWebCitationImageFullScreenView;
+//# sourceMappingURL=GptWebCitationImageFullScreenView.d.ts.map

package/dist/types/src/features/GptWebCitation/GptWebCitationImageFullScreenView.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GptWebCitationImageFullScreenView.d.ts","sourceRoot":"","sources":["../../../../../src/features/GptWebCitation/GptWebCitationImageFullScreenView.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAoB,MAAM,OAAO,CAAC;AAGzC,OAAO,EAAE,+BAA+B,EAAE,MAAM,SAAS,CAAC;AAI1D,KAAK,sCAAsC,GAAG;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,MAAM,CAAC,EAAE,+BAA+B,CAAC;CAC1C,CAAC;AAQF,QAAA,MAAM,iCAAiC,8CAIpC,sCAAsC,sBAgDxC,CAAC;AAEF,eAAe,iCAAiC,CAAC"}

package/dist/types/src/features/GptWebCitation/GptWebCitationMarkdown.d.ts

@@ -0,0 +1,9 @@
+import React from "react";
+type GptWebCitationMarkdownProps = {
+    content: string;
+    activeHighlightIndex: number;
+    onHighlightCountChange?: (count: number) => void;
+};
+declare const GptWebCitationMarkdown: React.FC<GptWebCitationMarkdownProps>;
+export default GptWebCitationMarkdown;
+//# sourceMappingURL=GptWebCitationMarkdown.d.ts.map

package/dist/types/src/features/GptWebCitation/GptWebCitationMarkdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GptWebCitationMarkdown.d.ts","sourceRoot":"","sources":["../../../../../src/features/GptWebCitation/GptWebCitationMarkdown.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAqC,MAAM,OAAO,CAAC;AAM1D,KAAK,2BAA2B,GAAG;IACjC,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,sBAAsB,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,CAAC;CAClD,CAAC;AAEF,QAAA,MAAM,sBAAsB,EAAE,KAAK,CAAC,EAAE,CAAC,2BAA2B,CA8FjE,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/dist/types/src/features/GptWebCitation/GptWebCitationSkeleton.d.ts

@@ -0,0 +1,14 @@
+import { type ElementType } from "react";
+import { IGptWebCitationSkeletonStyles, IGptWebCitationVisitLinkStyles } from "./types";
+export type GptWebCitationSkeletonStatus = "pending" | "error";
+export interface GptWebCitationSkeletonProps {
+    status: GptWebCitationSkeletonStatus;
+    ExternalLinkIcon?: ElementType;
+    citationUrl?: string;
+    styles?: IGptWebCitationSkeletonStyles;
+    visitLinkStyles?: IGptWebCitationVisitLinkStyles;
+    isFixedHeight?: boolean;
+}
+declare const GptWebCitationSkeleton: ({ status, ExternalLinkIcon, citationUrl, styles: styleOverrides, visitLinkStyles, isFixedHeight, }: GptWebCitationSkeletonProps) => import("react/jsx-runtime").JSX.Element;
+export default GptWebCitationSkeleton;
+//# sourceMappingURL=GptWebCitationSkeleton.d.ts.map

package/dist/types/src/features/GptWebCitation/GptWebCitationSkeleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GptWebCitationSkeleton.d.ts","sourceRoot":"","sources":["../../../../../src/features/GptWebCitation/GptWebCitationSkeleton.tsx"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,OAAO,CAAC;AAEzC,OAAO,EAAE,6BAA6B,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAC;AAIxF,MAAM,MAAM,4BAA4B,GAAG,SAAS,GAAG,OAAO,CAAC;AAE/D,MAAM,WAAW,2BAA2B;IAC1C,MAAM,EAAE,4BAA4B,CAAC;IACrC,gBAAgB,CAAC,EAAE,WAAW,CAAC;IAC/B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,6BAA6B,CAAC;IACvC,eAAe,CAAC,EAAE,8BAA8B,CAAC;IACjD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,QAAA,MAAM,sBAAsB,uGAOzB,2BAA2B,4CAqF7B,CAAC;AAEF,eAAe,sBAAsB,CAAC"}

package/dist/types/src/features/GptWebCitation/GptWebCitationTest.d.ts

@@ -0,0 +1,4 @@
+import { IGptWebCitationTestProps } from "./types";
+declare const GptWebCitationTest: ({ gptCitation, citationType, webCitationData: webCitationDataProp, sourceModel, learnedFrom, showWebCitation: showWebCitationProp, onGenerateWebCitation, webCitationStatus: webCitationStatusProp, showExpandImageButton, showGptMaximizeButton, iconsConfig, isFixedHeight, styles, }: IGptWebCitationTestProps) => import("react/jsx-runtime").JSX.Element;
+export default GptWebCitationTest;
+//# sourceMappingURL=GptWebCitationTest.d.ts.map

package/dist/types/src/features/GptWebCitation/GptWebCitationTest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GptWebCitationTest.d.ts","sourceRoot":"","sources":["../../../../../src/features/GptWebCitation/GptWebCitationTest.tsx"],"names":[],"mappings":"AAQA,OAAO,EAAwB,wBAAwB,EAAgB,MAAM,SAAS,CAAC;AA2BvF,QAAA,MAAM,kBAAkB,4RAcrB,wBAAwB,4CAoE1B,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/types/src/features/GptWebCitation/WebCitationSampleResponse.d.ts

@@ -0,0 +1,4 @@
+import { IWebCitationApiResponse } from "./types";
+export declare const sampleWebCitationApiResponse: IWebCitationApiResponse;
+export declare const sampleWebCitationApiResponseLoading: IWebCitationApiResponse;
+//# sourceMappingURL=WebCitationSampleResponse.d.ts.map

package/dist/types/src/features/GptWebCitation/WebCitationSampleResponse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebCitationSampleResponse.d.ts","sourceRoot":"","sources":["../../../../../src/features/GptWebCitation/WebCitationSampleResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAC;AAGlD,eAAO,MAAM,4BAA4B,EAAE,uBAmB1C,CAAA;AAGD,eAAO,MAAM,mCAAmC,EAAE,uBAGjD,CAAC"}

package/dist/types/src/features/GptWebCitation/types.d.ts

@@ -0,0 +1,405 @@
+import { CSSProperties, ElementType } from "react";
+import type { INonReasoningSource, NonWebReasoningIconsConfig } from "../CognitiveInternalgptReasoning/CognitiveInternalgptReasoningComponent";
+/** Database metadata returned with a web citation API response. */
+export interface IGptWebCitationDbMetadata {
+    /** Citation identifier stored in the backend. */
+    citation_id?: string;
+    /** GCS/blob storage path for the citation screenshot. */
+    blob_path?: string;
+}
+/** Image snapshot metadata for a web citation (screenshot of the source page). */
+export interface IGptWebCitationImageMetadata {
+    /** Preferred signed HTTPS URL for the screenshot image. */
+    signed_url?: string;
+    /** Blob path inside the citation storage bucket. */
+    blob_path?: string;
+    /** GCS URI fallback (`gs://...`) when a signed URL is not available. */
+    gs_uri?: string;
+}
+type GptWebCitationType = "web" | (string & {});
+/**
+ * Web citation payload from your `get_citation` (or equivalent) API.
+ *
+ * When `imageMetadata.signed_url` is present, the component renders a screenshot.
+ * Otherwise it falls back to rendering `content` as HTML/markdown.
+ */
+export interface IWebCitationApiResponse {
+    /** Unique citation identifier. */
+    citationId?: string;
+    /** HTML/markdown explanation with optional `<highlight>` tags and anchor links. */
+    content?: string;
+    /** Citation type — use `"web"` for web citation toggle flows. */
+    citationType?: GptWebCitationType;
+    /** Optional status message from the API. */
+    message?: string;
+    userId?: string;
+    userName?: string;
+    userEmail?: string;
+    /** Original source URL shown in the visit-link footer. */
+    citationUrl?: string;
+    /** Highlighted source URL returned by the citation API (preferred for visit links). */
+    highlightedUrl?: string;
+    db?: IGptWebCitationDbMetadata;
+    imageMetadata?: IGptWebCitationImageMetadata;
+}
+/** Normalized display fields derived from {@link IWebCitationApiResponse}. */
+export interface IGptWebCitationMappedData {
+    citationId?: string;
+    content: string;
+    citationType?: GptWebCitationType;
+    citationUrl?: string;
+    /** Highlighted source URL from the API (preferred over `defaultCitationUrl` for visit links). */
+    highlightedUrl?: string;
+    /** Topic label extracted from content (first anchor text) or overridden via props. */
+    topic: string;
+    /** Decision strength / relevance score parsed from content or overridden via props. */
+    relevanceScore: number;
+    /** Site name derived from `citationUrl` (e.g. `forbes.com` → `Forbes`). */
+    learnedFrom?: string;
+    web_citation_gcs_url?: string;
+    userId?: string;
+    userName?: string;
+    userEmail?: string;
+    db?: IGptWebCitationDbMetadata;
+    imageMetadata?: IGptWebCitationImageMetadata;
+}
+/** Active citation panel: GPT reasoning or web snapshot/markdown. */
+export type GptWebCitationView = "gpt" | "web";
+/**
+ * Controls which citation views are available and whether the GPT/Web toggle is shown.
+ *
+ * | Value     | GPT view | Web view | Toggle |
+ * | --------- | -------- | -------- | ------ |
+ * | `GPT`     | yes      | no       | no     |
+ * | `WEB`     | no       | yes      | no     |
+ * | `GPT_WEB` | yes      | yes      | yes    |
+ */
+export declare enum CitationType {
+    GPT = "gpt",
+    WEB = "web",
+    GPT_WEB = "gptWeb"
+}
+export declare const allowsGptCitationView: (citationType: CitationType) => boolean;
+export declare const allowsWebCitationView: (citationType: CitationType) => boolean;
+export declare const showsCitationViewToggle: (citationType: CitationType) => boolean;
+/**
+ * Web citation lifecycle status — set by the parent from their API call state.
+ *
+ * - `"pending"` — fetch in progress; shows loading skeleton (default).
+ * - `"success"` — fetch succeeded; renders screenshot when `webCitationData` has an image URL.
+ * - `"error"` — fetch failed or no preview; shows error skeleton.
+ */
+export type GptWebCitationStatus = "pending" | "success" | "error";
+/**
+ * Configuration for the embedded GPT reasoning panel
+ * (`CognitiveInternalgptCoreComponent`).
+ */
+export interface IGptCitationConfig {
+    /**
+     * GPT reasoning source data — highlights, paraphrase, confidence score, etc.
+     * Passed to the underlying GPT citation core component.
+     */
+    item: INonReasoningSource;
+    /** Panel header title (e.g. `"Summary Citations"`). */
+    headerTitle: string;
+    /** Zero-based citation index shown in the header. */
+    index?: number;
+    /**
+     * Icon component overrides for the GPT panel (chevrons, maximize, close).
+     * Supply React components compatible with your icon library version.
+     */
+    iconsConfig?: NonWebReasoningIconsConfig;
+    /**
+     * Source document label in the GPT footer (right side).
+     * Hidden when `citationType` is `CitationType.GPT_WEB` or `CitationType.WEB`.
+     */
+    DocumentTitle?: string;
+    /**
+     * Called when the user clicks the GPT footer source link.
+     * Hidden when `citationType` is `CitationType.GPT_WEB` or `CitationType.WEB`.
+     */
+    previewCallback?: () => void;
+    /**
+     * Fixed height for the GPT content body (e.g. `"384px"`).
+     * Pair with `styles.webCitation.content` to match web view height.
+     */
+    bodyHeight?: string;
+    /** When true, hides the GPT header fullscreen/maximize button. */
+    disableMaximize?: boolean;
+}
+/**
+ * Icon overrides for the web citation screenshot view.
+ *
+ * @example
+ * ```tsx
+ * import { ExternalLink, Maximize2 } from "lucide-react";
+ *
+ * iconsConfig={{
+ *   MaximizeIcon: Maximize2,
+ *   ExternalLinkIcon: ExternalLink,
+ * }}
+ * ```
+ */
+export type IGptWebCitationImageIconsConfig = {
+    /** Expand screenshot button icon. Falls back to `gptCitation.iconsConfig.MaximizeIcon`, then `Maximize2`. */
+    MaximizeIcon?: ElementType;
+    /** Visit-link icon in the screenshot footer. Defaults to `ExternalLink`. */
+    ExternalLinkIcon?: ElementType;
+};
+/** Style overrides for the GPT citation card and its footer toggle. */
+export interface IGptWebCitationGptStyles {
+    /** Border card around the GPT citation panel. */
+    wrapper?: CSSProperties;
+    /** Row overlay for the **View Web Citation** button in the GPT footer. */
+    footerAction?: CSSProperties;
+    /** **View Web Citation** button styles. */
+    toggleButton?: CSSProperties;
+}
+/** Style overrides for the web citation card (header, content, footer). */
+export interface IGptWebCitationVisitLinkStyles {
+    /** Visit link row container (hint + link). */
+    row?: CSSProperties;
+    /** Hint text beside the visit link (e.g. "to view details"). */
+    hint?: CSSProperties;
+    /** Visit link anchor/button styles. */
+    link?: CSSProperties;
+}
+/** Style overrides for the web citation screenshot view. */
+export interface IGptWebCitationImageStyles {
+    /** Outer image citation wrapper. */
+    wrapper?: CSSProperties;
+    /** Center column that holds the viewport or loading skeleton. */
+    center?: CSSProperties;
+    /** Viewport around the scroll container and expand button. */
+    viewport?: CSSProperties;
+    /** Scrollable container around the screenshot. */
+    scrollContainer?: CSSProperties;
+    /** Screenshot `<img>` element. */
+    image?: CSSProperties;
+    /** Full-screen expand button. */
+    expandButton?: CSSProperties;
+    /** Visit link overrides for the screenshot footer. */
+    visitLink?: IGptWebCitationVisitLinkStyles;
+    /** Full-screen image viewer (portal overlay). */
+    fullScreen?: IGptWebCitationFullScreenStyles;
+}
+/** Style overrides for the full-screen screenshot viewer. */
+export interface IGptWebCitationFullScreenStyles {
+    overlay?: CSSProperties;
+    content?: CSSProperties;
+    closeButton?: CSSProperties;
+    imageWrapper?: CSSProperties;
+    image?: CSSProperties;
+}
+/** Style overrides for pending/error loading skeletons. */
+export interface IGptWebCitationSkeletonStyles {
+    /** Outer skeleton column wrapper. */
+    container?: CSSProperties;
+    /** Skeleton frame (gray background area). */
+    frame?: CSSProperties;
+    /** Shimmer animation overlay (pending state). */
+    shimmer?: CSSProperties;
+    pending?: {
+        content?: CSSProperties;
+        text?: CSSProperties;
+        actionRow?: CSSProperties;
+        actionHint?: CSSProperties;
+    };
+    error?: {
+        content?: CSSProperties;
+        title?: CSSProperties;
+        message?: CSSProperties;
+        actionGroup?: CSSProperties;
+        detailsToggle?: CSSProperties;
+        detailsMessage?: CSSProperties;
+        /** Glowing visit link in error state. Merged on top of `visitLink.link`. */
+        visitLinkGlow?: CSSProperties;
+    };
+    /** Visit link overrides inside skeleton states. */
+    visitLink?: IGptWebCitationVisitLinkStyles;
+}
+/** Style overrides for the web citation card (header, content, footer). */
+export interface IGptWebCitationWebStyles {
+    /** Outer web citation card. */
+    panel?: CSSProperties;
+    /** Header row (source label, pagination, relevance badge). */
+    header?: CSSProperties;
+    /** Main content area (markdown, image, or loading skeleton). */
+    content?: CSSProperties;
+    /** Footer row (**View GPT Citation** + Learned From). */
+    footer?: CSSProperties;
+    /** **View GPT Citation** button styles. */
+    toggleButton?: CSSProperties;
+    /** "Learned From …" text styles. */
+    learnedFrom?: CSSProperties;
+    /** Shared visit link styles for image footer and skeleton states. */
+    visitLink?: IGptWebCitationVisitLinkStyles;
+    /** Screenshot image view styles. */
+    image?: IGptWebCitationImageStyles;
+    /** Pending/error skeleton styles. */
+    skeleton?: IGptWebCitationSkeletonStyles;
+}
+/**
+ * Inline style overrides for GPT and web citation layouts.
+ *
+ * Use nested `gptCitation` / `webCitation` keys for view-specific styling.
+ * Legacy flat keys (`gptCitationWrapper`, `footerAction`, `webCitationButton`) still work.
+ */
+export interface IGptWebCitationStyleOverrides {
+    /** Shared outer wrapper applied in both GPT and web views. */
+    container?: CSSProperties;
+    gptCitation?: IGptWebCitationGptStyles;
+    webCitation?: IGptWebCitationWebStyles;
+    /** @deprecated Use `gptCitation.wrapper` */
+    gptCitationWrapper?: CSSProperties;
+    /** @deprecated Use `gptCitation.footerAction` */
+    footerAction?: CSSProperties;
+    /** @deprecated Use `gptCitation.toggleButton` or `webCitation.toggleButton` */
+    webCitationButton?: CSSProperties;
+}
+/**
+ * Props for {@link GptWebCitation} — composite GPT + optional web citation panel.
+ *
+ * The component is **presentational**: it does not fetch web citations.
+ * The parent owns `webCitationData`, loading state, and view toggling.
+ *
+ * @example Basic controlled usage
+ * ```tsx
+ * const [status, setStatus] = useState<GptWebCitationStatus>("pending");
+ *
+ * <GptWebCitation
+ *   gptCitation={gptCitationConfig}
+ *   defaultCitationUrl="https://example.com/article"
+ *   citationType={CitationType.GPT_WEB}
+ *   webCitationData={data}
+ *   webCitationStatus={status}
+ *   showWebCitation={showWeb}
+ *   onToggleCitationView={() => setShowWeb((v) => !v)}
+ *   onGenerateWebCitation={fetchWebCitation}
+ * />
+ * ```
+ *
+ * @example GPT-only (no web toggle)
+ * ```tsx
+ * <GptWebCitation
+ *   gptCitation={gptCitationConfig}
+ *   defaultCitationUrl="https://example.com/article"
+ *   citationType={CitationType.GPT}
+ * />
+ * ```
+ */
+export interface IGptWebCitationProps {
+    /**
+     * **Required.** GPT citation configuration forwarded to
+     * `CognitiveInternalgptCoreComponent`.
+     */
+    gptCitation: IGptCitationConfig;
+    /**
+     * Fallback source URL for visit links while web citation is pending or failed.
+     * Used when `webCitationData.highlightedUrl` is not yet available.
+     */
+    defaultCitationUrl: string;
+    /**
+     * **Required.** Controls available views and toggle visibility.
+     * Use `CitationType.GPT_WEB` for dual GPT + web with toggle (default web view).
+     */
+    citationType: CitationType;
+    /**
+     * Web citation API response (screenshot and/or markdown content).
+     * Omit until the parent has fetched or prefetched data.
+     */
+    webCitationData?: IWebCitationApiResponse;
+    /**
+     * Overrides the topic label in the web citation header.
+     * Auto-extracted from `webCitationData.content` when omitted.
+     */
+    topic?: string;
+    /** @deprecated Use `sourceLabel` instead. */
+    sourceModel?: string;
+    /**
+     * Overrides the header source label in web view
+     * (default: `Source: Web Citation > {topic}`).
+     */
+    sourceLabel?: string;
+    /**
+     * Overrides the relevance / decision strength badge (%).
+     * Auto-parsed from content (e.g. "decision strength is 85%") when omitted.
+     */
+    relevanceScore?: number;
+    /**
+     * Overrides the "Learned From …" site name in the web footer.
+     * Auto-derived from `citationUrl` when omitted.
+     */
+    learnedFrom?: string;
+    /**
+     * Controls which view is active when `citationType` is `CitationType.GPT_WEB`.
+     * - `false` → GPT view (+ **View Web Citation** toggle)
+     * - `true` → Web citation panel (+ **View GPT Citation** toggle)
+     *
+     * Ignored for `CitationType.GPT` (always GPT) and `CitationType.WEB` (always web).
+     * Omit for uncontrolled internal state (defaults to web for `GPT_WEB`).
+     */
+    showWebCitation?: boolean;
+    /**
+     * Optional override for web citation lifecycle status from the parent's API call.
+     * When omitted, status is inferred from `webCitationData`:
+     * image URL → `"success"`, data without image → `"error"`, no data → `"pending"`.
+     * Pass `"pending"` explicitly while fetching (before image is available).
+     */
+    webCitationStatus?: GptWebCitationStatus;
+    /**
+     * Called when the user clicks **View Web Citation**.
+     * Parent should start their fetch and update `webCitationStatus` / `webCitationData`.
+     */
+    onGenerateWebCitation?: () => void;
+    /**
+     * Called when the user toggles between GPT and web views.
+     * Required for controlled mode (`showWebCitation` is set by parent).
+     */
+    onToggleCitationView?: () => void;
+    /**
+     * Shows the fullscreen expand button on web citation screenshot images.
+     * @default true
+     */
+    showExpandImageButton?: boolean;
+    /**
+     * Shows the GPT citation header maximize/expand icon.
+     * When `false`, equivalent to `gptCitation.disableMaximize: true`.
+     * @default true (unless `gptCitation.disableMaximize` is set)
+     */
+    showGptMaximizeButton?: boolean;
+    /**
+     * Icon overrides for the web citation screenshot view
+     * (expand button + visit link). See {@link IGptWebCitationImageIconsConfig}.
+     */
+    iconsConfig?: IGptWebCitationImageIconsConfig;
+    /**
+     * When `true`, GPT and web citation panels share the same fixed height and width.
+     * Screenshot images use `object-fit: contain` within the content box.
+     * @default false
+     */
+    isFixedHeight?: boolean;
+    /**
+     * Inline style overrides for GPT and web citation layouts.
+     * See {@link IGptWebCitationStyleOverrides}.
+     */
+    styles?: IGptWebCitationStyleOverrides;
+}
+/** Props for the local `GptWebCitationTest` dev harness. */
+export interface IGptWebCitationTestProps {
+    gptCitation?: IGptCitationConfig;
+    citationType?: CitationType;
+    webCitationData?: IWebCitationApiResponse;
+    sourceModel?: string;
+    learnedFrom?: string;
+    showWebCitation?: boolean;
+    onGenerateWebCitation?: () => void;
+    webCitationStatus?: GptWebCitationStatus;
+    showExpandImageButton?: boolean;
+    showGptMaximizeButton?: boolean;
+    iconsConfig?: IGptWebCitationImageIconsConfig;
+    isFixedHeight?: boolean;
+    styles?: IGptWebCitationStyleOverrides;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map