@deepcitation/deepcitation-js 1.1.4 → 1.1.6

package/lib/parsing/parseCitation.js

@@ -158,11 +158,10 @@ export const parseCitation = (fragment, mdAttachmentId, citationCounterRef, isVe
         pageNumber,
         startPageKey: `page_number_${pageNumber || 1}_index_${pageIndex || 0}`,
         fullPhrase,
-        keySpan,
+        keySpan: keySpan || value,
         citationNumber,
         lineIds,
         beforeCite,
-        value,
         timestamps,
         reasoning,
     };
@@ -221,9 +220,8 @@ const parseJsonCitation = (jsonCitation, citationNumber) => {
         fullPhrase,
         citationNumber,
         lineIds,
-        keySpan,
+        keySpan: keySpan || value,
         reasoning,
-        value,
     };
     return citation;
 };

package/lib/react/CitationComponent.js

@@ -94,7 +94,7 @@ const StatusTooltipContent = ({ citation, status, verification, isExpanded, onTo
     }
     // Fallback to citation text if no phrases recorded
     if (allPhrases.length === 0) {
-        const searchedText = citation.fullPhrase || citation.value || "";
+        const searchedText = citation.fullPhrase || citation.keySpan?.toString() || "";
         if (searchedText) {
             allPhrases.push(searchedText);
         }
@@ -104,7 +104,7 @@ const StatusTooltipContent = ({ citation, status, verification, isExpanded, onTo
         return (_jsxs("span", { className: "dc-status-tooltip", role: "tooltip", children: [_jsxs("span", { className: "dc-status-header dc-status-header--miss", children: [_jsx(WarningIcon, {}), _jsx("span", { children: "Not found in source" })] }), allPhrases.length > 0 && (_jsxs("span", { className: "dc-search-phrases", children: [_jsxs("span", { className: "dc-search-phrases-header", children: [hiddenCount > 0 && (_jsx("button", { type: "button", className: "dc-search-phrases-toggle", onClick: onToggleExpand, children: isExpanded ? "collapse" : `+${hiddenCount} more` })), _jsxs("span", { className: "dc-status-label", children: ["Searched ", allPhrases.length, " phrase", allPhrases.length > 1 ? "s" : ""] })] }), _jsx("span", { className: "dc-search-phrases-list", children: (isExpanded ? allPhrases : allPhrases.slice(0, 1)).map((phrase, idx) => (_jsxs("span", { className: "dc-search-phrase-item", children: ["\"", phrase.length > 80 ? phrase.slice(0, 80) + "…" : phrase, "\""] }, idx))) })] }))] }));
     }
     if (isPartialMatch) {
-        const expectedText = citation.fullPhrase || citation.value || "";
+        const expectedText = citation.fullPhrase || citation.keySpan?.toString() || "";
         const actualText = verification?.matchSnippet || "";
         const truncatedExpected = expectedText.length > 100
             ? expectedText.slice(0, 100) + "…"
@@ -182,7 +182,7 @@ const DefaultPopoverContent = ({ verification, status, onImageClick, }) => {
  * This means partial matches have blue text (because they were found) but
  * an orange indicator (because they didn't match exactly).
  */
-export const CitationComponent = forwardRef(({ citation, children, className, displayCitationValue = false, fallbackDisplay, verification, variant = "brackets", eventHandlers, isMobile = false, renderIndicator, renderContent, popoverPosition = "top", renderPopoverContent, }, ref) => {
+export const CitationComponent = forwardRef(({ citation, children, className, displayKeySpan = false, fallbackDisplay, verification, variant = "brackets", eventHandlers, isMobile = false, renderIndicator, renderContent, popoverPosition = "top", renderPopoverContent, }, ref) => {
     const containerRef = useRef(null);
     const wrapperRef = useRef(null);
     const [expandedImageSrc, setExpandedImageSrc] = useState(null);
@@ -274,13 +274,13 @@ export const CitationComponent = forwardRef(({ citation, children, className, di
         }
         // For text/minimal/brackets, show the value or fullPhrase
         return getCitationDisplayText(citation, {
-            displayCitationValue: variant === "text" ||
+            displayKeySpan: variant === "text" ||
                 variant === "minimal" ||
                 variant === "brackets" ||
-                displayCitationValue,
+                displayKeySpan,
             fallbackDisplay,
         });
-    }, [citation, variant, displayCitationValue, fallbackDisplay]);
+    }, [citation, variant, displayKeySpan, fallbackDisplay]);
     // Found status class for text styling (blue for found, gray for miss)
     const foundStatusClass = useMemo(() => getFoundStatusClass(status), [status]);
     // Event handlers
@@ -300,7 +300,7 @@ export const CitationComponent = forwardRef(({ citation, children, className, di
     // Early return for miss with fallback display
     if (fallbackDisplay !== null &&
         fallbackDisplay !== undefined &&
-        displayCitationValue &&
+        displayKeySpan &&
         isMiss) {
         return (_jsx("span", { className: classNames("dc-citation-fallback", className), children: fallbackDisplay }));
     }
@@ -332,9 +332,7 @@ export const CitationComponent = forwardRef(({ citation, children, className, di
                 status,
                 citationKey,
                 displayText,
-                isMergedDisplay: variant === "text" ||
-                    variant === "brackets" ||
-                    displayCitationValue,
+                isMergedDisplay: variant === "text" || variant === "brackets" || displayKeySpan,
             });
         }
         // Indicator-only variant - just the checkmark/warning

package/lib/react/CitationVariants.js

@@ -1,7 +1,7 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { memo, useMemo, useCallback, forwardRef, } from "react";
 import { getCitationStatus } from "../parsing/parseCitation.js";
-import { generateCitationKey, generateCitationInstanceId, getCitationDisplayText, getCitationValueText, classNames, } from "./utils.js";
+import { generateCitationKey, generateCitationInstanceId, getCitationDisplayText, getCitationKeySpanText, classNames, } from "./utils.js";
 const TWO_DOTS_THINKING_CONTENT = "..";
 /**
  * Hook to get common citation data.
@@ -31,16 +31,16 @@ const DefaultPartialIndicator = () => (_jsx("span", { className: "citation-parti
  * <ChipCitation citation={citation} verification={found} size="md" />
  * ```
  */
-export const ChipCitation = forwardRef(({ citation, children, className, displayCitationValue = false, fallbackDisplay, verification, eventHandlers, isMobile = false, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), size = "md", showIcon = false, icon, }, ref) => {
+export const ChipCitation = forwardRef(({ citation, children, className, displayKeySpan = false, fallbackDisplay, verification, eventHandlers, isMobile = false, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), size = "md", showIcon = false, icon, }, ref) => {
     const { citationKey, citationInstanceId, status } = useCitationData(citation, verification);
     const { isVerified, isMiss, isPartialMatch, isPending } = status;
     const displayText = useMemo(() => getCitationDisplayText(citation, {
-        displayCitationValue,
+        displayKeySpan,
         fallbackDisplay,
-    }), [citation, displayCitationValue, fallbackDisplay]);
-    const valueText = useMemo(() => getCitationValueText(citation, {
-        displayCitationValue,
-    }), [citation, displayCitationValue]);
+    }), [citation, displayKeySpan, fallbackDisplay]);
+    const keySpanText = useMemo(() => getCitationKeySpanText(citation, {
+        displayKeySpan,
+    }), [citation, displayKeySpan]);
     const handleClick = useCallback((e) => {
         e.preventDefault();
         e.stopPropagation();
@@ -68,7 +68,7 @@ export const ChipCitation = forwardRef(({ citation, children, className, display
                     ? "citation-chip--pending"
                     : "";
     return (_jsxs(_Fragment, { children: [children, _jsxs("span", { ref: ref, "data-citation-id": citationKey, "data-citation-instance": citationInstanceId, "data-variant": "chip", className: classNames("citation-chip", sizeClasses[size], statusClass, className), onMouseEnter: preventTooltips ? undefined : handleMouseEnter, onMouseLeave: preventTooltips ? undefined : handleMouseLeave, onMouseDown: handleClick, onClick: (e) => e.stopPropagation(), "aria-label": displayText ? `Citation: ${displayText}` : undefined, children: [showIcon &&
-                        (icon || _jsx("span", { className: "citation-chip__icon", children: "\uD83D\uDCC4" })), valueText && !displayCitationValue && (_jsx("span", { className: "citation-chip__value", children: valueText })), _jsx("span", { className: "citation-chip__text", children: displayText }), isPartialMatch && renderPartialIndicator(status), isVerified && !isPartialMatch && renderVerifiedIndicator(status), isPending && (_jsx("span", { className: "citation-chip__pending", children: pendingContent }))] })] }));
+                        (icon || _jsx("span", { className: "citation-chip__icon", children: "\uD83D\uDCC4" })), _jsx("span", { className: "citation-chip__text", children: displayText }), isPartialMatch && renderPartialIndicator(status), isVerified && !isPartialMatch && renderVerifiedIndicator(status), isPending && (_jsx("span", { className: "citation-chip__pending", children: pendingContent }))] })] }));
 });
 ChipCitation.displayName = "ChipCitation";
 /**
@@ -81,13 +81,13 @@ ChipCitation.displayName = "ChipCitation";
  * // Renders: Text content¹
  * ```
  */
-export const SuperscriptCitation = forwardRef(({ citation, children, className, displayCitationValue = false, fallbackDisplay, verification, eventHandlers, isMobile = false, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), showBrackets = false, }, ref) => {
+export const SuperscriptCitation = forwardRef(({ citation, children, className, displayKeySpan = false, fallbackDisplay, verification, eventHandlers, isMobile = false, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), showBrackets = false, }, ref) => {
     const { citationKey, citationInstanceId, status } = useCitationData(citation, verification);
     const { isVerified, isMiss, isPartialMatch, isPending } = status;
     const displayText = useMemo(() => getCitationDisplayText(citation, {
-        displayCitationValue,
+        displayKeySpan,
         fallbackDisplay,
-    }), [citation, displayCitationValue, fallbackDisplay]);
+    }), [citation, displayKeySpan, fallbackDisplay]);
     const handleClick = useCallback((e) => {
         e.preventDefault();
         e.stopPropagation();
@@ -173,14 +173,14 @@ FootnoteCitation.displayName = "FootnoteCitation";
  * // Renders: "quoted text" with subtle underline
  * ```
  */
-export const InlineCitation = forwardRef(({ citation, children, className, displayCitationValue = true, // Default to merged for inline
+export const InlineCitation = forwardRef(({ citation, children, className, displayKeySpan = true, // Default to merged for inline
 fallbackDisplay, verification, eventHandlers, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), underlineStyle = "dotted", }, ref) => {
     const { citationKey, citationInstanceId, status } = useCitationData(citation, verification);
     const { isVerified, isMiss, isPartialMatch, isPending } = status;
     const displayText = useMemo(() => getCitationDisplayText(citation, {
-        displayCitationValue,
+        displayKeySpan,
         fallbackDisplay,
-    }), [citation, displayCitationValue, fallbackDisplay]);
+    }), [citation, displayKeySpan, fallbackDisplay]);
     const handleClick = useCallback((e) => {
         e.preventDefault();
         e.stopPropagation();
@@ -216,13 +216,13 @@ InlineCitation.displayName = "InlineCitation";
  * // Renders: 1
  * ```
  */
-export const MinimalCitation = forwardRef(({ citation, children, className, displayCitationValue = false, fallbackDisplay, verification, eventHandlers, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), showStatusIndicator = true, }, ref) => {
+export const MinimalCitation = forwardRef(({ citation, children, className, displayKeySpan = false, fallbackDisplay, verification, eventHandlers, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), showStatusIndicator = true, }, ref) => {
     const { citationKey, citationInstanceId, status } = useCitationData(citation, verification);
     const { isVerified, isMiss, isPartialMatch, isPending } = status;
     const displayText = useMemo(() => getCitationDisplayText(citation, {
-        displayCitationValue,
+        displayKeySpan,
         fallbackDisplay,
-    }), [citation, displayCitationValue, fallbackDisplay]);
+    }), [citation, displayKeySpan, fallbackDisplay]);
     const handleClick = useCallback((e) => {
         e.preventDefault();
         e.stopPropagation();

package/lib/react/index.d.ts

@@ -11,6 +11,6 @@
  * @packageDocumentation
  */
 export type { CitationContentProps, CitationRenderProps, CitationTooltipProps, CitationStyles, CitationStateClasses, CitationCursorClasses, CitationEventHandlers, CitationVariant as CitationVariantType, UrlFetchStatus, UrlCitationMeta, UrlCitationProps, } from "./types.js";
-export { extractDomain, isBlockedStatus, isErrorStatus, isVerifiedStatus } from "./UrlCitationComponent.js";
-export { generateCitationKey, generateCitationInstanceId, getCitationDisplayText, getCitationValueText, classNames, CITATION_X_PADDING, CITATION_Y_PADDING, } from "./utils.js";
+export { extractDomain, isBlockedStatus, isErrorStatus, isVerifiedStatus, } from "./UrlCitationComponent.js";
+export { generateCitationKey, generateCitationInstanceId, getCitationDisplayText, getCitationKeySpanText, classNames, CITATION_X_PADDING, CITATION_Y_PADDING, } from "./utils.js";
 export { CitationComponent, MemoizedCitationComponent, type CitationVariant, type CitationComponentProps, } from "./CitationComponent.js";

package/lib/react/index.js

@@ -11,8 +11,8 @@
  * @packageDocumentation
  */
 // URL Utilities - For handling URL citation metadata
-export { extractDomain, isBlockedStatus, isErrorStatus, isVerifiedStatus } from "./UrlCitationComponent.js";
+export { extractDomain, isBlockedStatus, isErrorStatus, isVerifiedStatus, } from "./UrlCitationComponent.js";
 // Utilities - For generating citation keys and display text
-export { generateCitationKey, generateCitationInstanceId, getCitationDisplayText, getCitationValueText, classNames, CITATION_X_PADDING, CITATION_Y_PADDING, } from "./utils.js";
+export { generateCitationKey, generateCitationInstanceId, getCitationDisplayText, getCitationKeySpanText, classNames, CITATION_X_PADDING, CITATION_Y_PADDING, } from "./utils.js";
 // Components
 export { CitationComponent, MemoizedCitationComponent, } from "./CitationComponent.js";

package/lib/react/primitives.d.ts

@@ -14,7 +14,7 @@ interface CitationContextValue {
     verification: Verification | null;
     searchState: SearchState | null;
     config: {
-        displayCitationValue: boolean;
+        displayKeySpan: boolean;
         fallbackDisplay: string | null;
         pendingContent: ReactNode;
     };
@@ -28,7 +28,7 @@ export interface CitationRootProps {
     verification?: Verification | null;
     searchState?: SearchState | null;
     children: ReactNode;
-    displayCitationValue?: boolean;
+    displayKeySpan?: boolean;
     fallbackDisplay?: string | null;
     pendingContent?: ReactNode;
 }

package/lib/react/primitives.js

@@ -20,7 +20,7 @@ export function useCitationContextSafe() {
     return useContext(CitationContext);
 }
 /** Root component that provides citation context to all child primitives. */
-export const CitationRoot = forwardRef(({ citation, verification = null, searchState = null, children, displayCitationValue = false, fallbackDisplay = null, pendingContent = "..", className, ...props }, ref) => {
+export const CitationRoot = forwardRef(({ citation, verification = null, searchState = null, children, displayKeySpan = false, fallbackDisplay = null, pendingContent = "..", className, ...props }, ref) => {
     const citationKey = useMemo(() => generateCitationKey(citation), [citation]);
     const citationInstanceId = useMemo(() => generateCitationInstanceId(citationKey), [citationKey]);
     const status = getCitationStatus(verification);
@@ -32,7 +32,7 @@ export const CitationRoot = forwardRef(({ citation, verification = null, searchS
         verification,
         searchState,
         config: {
-            displayCitationValue,
+            displayKeySpan,
             fallbackDisplay,
             pendingContent,
         },
@@ -43,7 +43,7 @@ export const CitationRoot = forwardRef(({ citation, verification = null, searchS
         status,
         verification,
         searchState,
-        displayCitationValue,
+        displayKeySpan,
         fallbackDisplay,
         pendingContent,
     ]);
@@ -100,8 +100,8 @@ export const CitationNumber = forwardRef(({ className, number, ...props }, ref)
     const displayNumber = useMemo(() => {
         if (number !== undefined)
             return String(number);
-        if (config.displayCitationValue) {
-            return (citation.value ||
+        if (config.displayKeySpan) {
+            return (citation.keySpan?.toString() ||
                 citation.citationNumber?.toString() ||
                 config.fallbackDisplay ||
                 "");
@@ -120,9 +120,9 @@ export const CitationValue = forwardRef(({ className, value, separator = " ", ..
     const displayValue = useMemo(() => {
         if (value !== undefined)
             return value;
-        if (config.displayCitationValue)
+        if (!config.displayKeySpan)
             return "";
-        return citation.value || "";
+        return citation.keySpan?.toString() || "";
     }, [value, citation, config]);
     if (!displayValue)
         return null;

package/lib/react/types.d.ts

@@ -90,7 +90,7 @@ export interface BaseCitationProps {
     /** Class name for controlling inner content width */
     innerWidthClassName?: string;
     /** When true, displays value/citationNumber merged in the bracket */
-    displayCitationValue?: boolean;
+    displayKeySpan?: boolean;
     /** Fallback display text when citation value is empty */
     fallbackDisplay?: string | null;
     /** Display variant for the citation */

package/lib/react/utils.d.ts

@@ -13,14 +13,14 @@ export declare function generateCitationInstanceId(citationKey: string): string;
  * Gets the display text for a citation based on configuration.
  */
 export declare function getCitationDisplayText(citation: Citation, options?: {
-    displayCitationValue?: boolean;
+    displayKeySpan?: boolean;
     fallbackDisplay?: string | null;
 }): string;
 /**
- * Gets the value text to display before the citation bracket.
+ * Gets the keySpan text to display before the citation bracket.
  */
-export declare function getCitationValueText(citation: Citation, options?: {
-    displayCitationValue?: boolean;
+export declare function getCitationKeySpanText(citation: Citation, options?: {
+    displayKeySpan?: boolean;
 }): string;
 /**
  * Joins class names, filtering out falsy values.

package/lib/react/utils.js

@@ -20,16 +20,16 @@ export function generateCitationKey(citation) {
  * Combines the citation key with a random suffix for uniqueness.
  */
 export function generateCitationInstanceId(citationKey) {
-    const randomSuffix = Math.random().toString(36).substr(2, 9);
+    const randomSuffix = Math.random().toString(36).slice(2, 11);
     return `${citationKey}-${randomSuffix}`;
 }
 /**
  * Gets the display text for a citation based on configuration.
  */
 export function getCitationDisplayText(citation, options = {}) {
-    const { displayCitationValue = false, fallbackDisplay } = options;
-    if (displayCitationValue) {
-        return (citation.value ||
+    const { displayKeySpan = false, fallbackDisplay } = options;
+    if (displayKeySpan) {
+        return (citation.keySpan?.toString() ||
             citation.citationNumber?.toString() ||
             fallbackDisplay ||
             "");
@@ -37,14 +37,14 @@ export function getCitationDisplayText(citation, options = {}) {
     return citation.citationNumber?.toString() || "";
 }
 /**
- * Gets the value text to display before the citation bracket.
+ * Gets the keySpan text to display before the citation bracket.
  */
-export function getCitationValueText(citation, options = {}) {
-    const { displayCitationValue = false } = options;
-    if (displayCitationValue) {
+export function getCitationKeySpanText(citation, options = {}) {
+    const { displayKeySpan = false } = options;
+    if (displayKeySpan) {
         return "";
     }
-    return citation.value || "";
+    return citation.keySpan?.toString() || "";
 }
 /**
  * Joins class names, filtering out falsy values.

package/lib/types/citation.d.ts

@@ -19,7 +19,6 @@ export interface Citation {
     fileId?: string;
     fullPhrase?: string | null;
     keySpan?: string | null;
-    value?: string | null;
     startPageKey?: string | null;
     lineIds?: number[] | null;
     reasoning?: string | null;

package/lib/types/verification.d.ts

@@ -5,10 +5,8 @@ export declare const NOT_FOUND_VERIFICATION_INDEX = -1;
 export declare const PENDING_VERIFICATION_INDEX = -2;
 export declare const BLANK_VERIFICATION: Verification;
 export interface Verification {
-    regex?: RegExp | null;
-    lowerCaseSearchTerm: string | null;
+    fileId?: string | null;
     label?: string | null;
-    attachmentId?: string | null;
     pageNumber?: number | null;
     timestamp?: number | null;
     citation?: Citation;

package/lib/types/verification.js

@@ -1,10 +1,8 @@
 export const NOT_FOUND_VERIFICATION_INDEX = -1;
 export const PENDING_VERIFICATION_INDEX = -2;
 export const BLANK_VERIFICATION = {
+    fileId: null,
     pageNumber: NOT_FOUND_VERIFICATION_INDEX,
-    regex: null,
-    lowerCaseSearchTerm: null,
-    attachmentId: null,
     matchSnippet: null,
     source: null,
     citation: {

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@deepcitation/deepcitation-js",
-    "version": "1.1.4",
+    "version": "1.1.6",
     "description": "DeepCitation JavaScript SDK for deterministic AI citation verification",
     "type": "module",
     "private": false,