@deepcitation/deepcitation-js 1.1.11 → 1.1.13

package/lib/prompts/citationPrompts.d.ts

@@ -1,4 +1,4 @@
-export declare const CITATION_MARKDOWN_SYNTAX_PROMPT = "\nCitation syntax to use within Markdown:\n\u2022 To support any ideas or information that requires a citation from the provided content, use the following citation syntax:\n<cite file_id='file_id' start_page_key='page_number_PAGE_index_INDEX' full_phrase='the verbatim text of the terse phrase inside <file_text />; remember to escape quotes and newlines inside the full_phrase to remain as valid JSON' key_span='the verbatim value or 1-3 words within full_phrase that best support the citation' line_ids='2-6' reasoning='the terse logic used to conclude the citation' />\n\n\u2022 Very important: for page numbers, only use the page number and page index info from the page_number_PAGE_index_INDEX format (e.g. <page_number_1_index_0>) and never from the contents inside the page.\n\u2022 start_page_key, full_phrase, and line_ids are required for each citation.\n\u2022 Infer line_ids, as we only provide the first, last, and every 5th line. When copying a previous <cite />, use the full info from the previous citation without changing the start_page_key, line_ids, or any other <cite /> attributes.\n\u2022 Use refer to line_ids inclusively, and use a range (or single) for each citation, split multiple sequential line_ids into multiple citations.\n\u2022 These citations will be replaced and displayed in-line as a numeric element (e.g. [1]), the markdown preceding <cite /> should read naturally with only one <cite /> per sentence with rare exceptions for two <cite /> in a sentence. <cite /> often present best at the end of the sentence, and are not grouped at the end of the document.\n\u2022 The full_phrase should be the exact verbatim text of the phrase or paragraph from the source document to support the insight or idea.\n\u2022 We do NOT put the full_phrase inside <cite ...></cite>; we only use full_phrase inside the full_phrase attribute.\n";
+export declare const CITATION_MARKDOWN_SYNTAX_PROMPT = "\nCitation syntax to use within Markdown:\n\u2022 To support any ideas or information that requires a citation from the provided content, use the following citation syntax:\n<cite file_id='file_id' start_page_key='page_number_PAGE_index_INDEX' full_phrase='the verbatim text of the terse phrase inside <file_text />; remember to escape quotes and newlines inside the full_phrase to remain as valid JSON' key_span='the verbatim 1-3 words within full_phrase that best support the citation' line_ids='2-6' reasoning='the terse logic used to conclude the citation' />\n\n\u2022 Very important: for page numbers, only use the page number and page index info from the page_number_PAGE_index_INDEX format (e.g. <page_number_1_index_0>) and never from the contents inside the page.\n\u2022 start_page_key, full_phrase, and line_ids are required for each citation.\n\u2022 Infer line_ids, as we only provide the first, last, and every 5th line. When copying a previous <cite />, use the full info from the previous citation without changing the start_page_key, line_ids, or any other <cite /> attributes.\n\u2022 Use refer to line_ids inclusively, and use a range (or single) for each citation, split multiple sequential line_ids into multiple citations.\n\u2022 These citations will be replaced and displayed in-line as a numeric element (e.g. [1]), the markdown preceding <cite /> should read naturally with only one <cite /> per sentence with rare exceptions for two <cite /> in a sentence. <cite /> often present best at the end of the sentence, and are not grouped at the end of the document.\n\u2022 The full_phrase should be the exact verbatim text of the phrase or paragraph from the source document to support the insight or idea.\n\u2022 We do NOT put the full_phrase inside <cite ...></cite>; we only use full_phrase inside the full_phrase attribute.\n";
 export declare const AV_CITATION_MARKDOWN_SYNTAX_PROMPT = "\n\u2022 To support any ideas or information that requires a citation from the provided content, use the following citation syntax:\n<cite file_id='file_id' full_phrase='the verbatim text of the phrase; remember to escape quotes and newlines inside the full_phrase to remain as valid JSON' timestamps='HH:MM:SS.SSS-HH:MM:SS.SSS' reasoning='the logic connecting the form section requirements to the supporting source citation' />\n\u2022 These citations are displayed in-line or in the relevant list item, and are not grouped at the end of the document.\n";
 export interface WrapSystemPromptOptions {
     /** The original system prompt to wrap with citation instructions */

package/lib/prompts/citationPrompts.js

@@ -1,7 +1,7 @@
 export const CITATION_MARKDOWN_SYNTAX_PROMPT = `
 Citation syntax to use within Markdown:
 • To support any ideas or information that requires a citation from the provided content, use the following citation syntax:
-<cite file_id='file_id' start_page_key='page_number_PAGE_index_INDEX' full_phrase='the verbatim text of the terse phrase inside <file_text />; remember to escape quotes and newlines inside the full_phrase to remain as valid JSON' key_span='the verbatim value or 1-3 words within full_phrase that best support the citation' line_ids='2-6' reasoning='the terse logic used to conclude the citation' />
+<cite file_id='file_id' start_page_key='page_number_PAGE_index_INDEX' full_phrase='the verbatim text of the terse phrase inside <file_text />; remember to escape quotes and newlines inside the full_phrase to remain as valid JSON' key_span='the verbatim 1-3 words within full_phrase that best support the citation' line_ids='2-6' reasoning='the terse logic used to conclude the citation' />
 
 • Very important: for page numbers, only use the page number and page index info from the page_number_PAGE_index_INDEX format (e.g. <page_number_1_index_0>) and never from the contents inside the page.
 • start_page_key, full_phrase, and line_ids are required for each citation.
@@ -121,11 +121,11 @@ export const CITATION_JSON_OUTPUT_FORMAT = {
         },
         fullPhrase: {
             type: "string",
-            description: "The verbatim text of the terse phrase inside <file_text /> to support the value description (if there is a detected OCR correction, use the corrected text)",
+            description: "The verbatim text of the terse phrase inside <file_text /> to support the citation (if there is a detected OCR correction, use the corrected text)",
         },
         keySpan: {
             type: "string",
-            description: "the verbatim value or 1-3 words within fullPhrase that best support the citation",
+            description: "the verbatim 1-3 words within fullPhrase that best support the citation",
         },
         lineIds: {
             type: "array",
@@ -152,7 +152,7 @@ export const CITATION_AV_BASED_JSON_OUTPUT_FORMAT = {
         },
         fullPhrase: {
             type: "string",
-            description: "The exact verbatim text of the phrase or paragraph from the source document to support the value description (if there is a detected OCR correction, use the verbatim corrected text)",
+            description: "The exact verbatim text of the phrase or paragraph from the source document to support the citation (if there is a detected OCR correction, use the verbatim corrected text)",
         },
         timestamps: {
             type: "object",

package/lib/react/CitationComponent.d.ts

@@ -7,33 +7,43 @@ export type { CitationVariant } from "./types.js";
 /**
  * Props for the CitationComponent.
  *
- * @example Brackets variant (default) - shows value/number in brackets with blue styling
+ * @example Brackets variant (default) - shows keySpan in brackets with blue styling
  * ```tsx
  * <CitationComponent
- *   citation={{ citationNumber: 1, fullPhrase: "Revenue grew by 25%" }}
+ *   citation={{ citationNumber: 1, keySpan: "Revenue grew by 25%" }}
  *   verification={verificationResult}
  * />
- * // Renders: [1✓] with blue text
+ * // Renders: [Revenue grew by 25%✓] with blue text
  * ```
  *
- * @example Numeric variant - shows just the citation number with indicator
+ * @example Numeric only - use displayKeySpan=false with brackets variant
  * ```tsx
  * <CitationComponent
- *   citation={{ citationNumber: 1, value: "25% growth" }}
+ *   citation={{ citationNumber: 1, keySpan: "25% growth" }}
  *   verification={verificationResult}
- *   variant="numeric"
+ *   displayKeySpan={false}
  * />
- * // Renders: 1✓
+ * // Renders: [1✓]
  * ```
  *
- * @example Text variant - shows the value without styling
+ * @example Without brackets - use displayBrackets=false
  * ```tsx
  * <CitationComponent
- *   citation={{ citationNumber: 1, value: "25% growth" }}
+ *   citation={{ citationNumber: 1, keySpan: "25% growth" }}
+ *   verification={verificationResult}
+ *   displayBrackets={false}
+ * />
+ * // Renders: 25% growth✓ (no brackets)
+ * ```
+ *
+ * @example Text variant - inherits parent text styling, no truncation
+ * ```tsx
+ * <CitationComponent
+ *   citation={{ citationNumber: 1, keySpan: "25% growth" }}
  *   verification={verificationResult}
  *   variant="text"
  * />
- * // Renders: 25% growth✓
+ * // Renders: 25% growth✓ (inherits parent styling)
  * ```
  *
  * @example Minimal variant - no brackets, just text and indicator
@@ -73,13 +83,18 @@ export interface CitationComponentProps extends BaseCitationProps {
     verification?: Verification | null;
     /**
      * Display variant for the citation.
-     * - `brackets`: Shows value/number in brackets, blue text styling (default)
-     * - `numeric`: Shows citation number with indicator, no brackets
-     * - `text`: Shows the value, no text styling, no truncate, shows indicator
+     * - `brackets`: Shows keySpan/number in brackets, blue text styling (default)
+     * - `text`: Shows the keySpan, inherits parent text styling, no truncation, shows indicator
      * - `minimal`: No brackets, just display text with indicator
      * - `indicator`: Only the status indicator (checkmark/warning), no text
      */
     variant?: CitationVariant;
+    /**
+     * Whether to show square brackets around the citation.
+     * Only applies to the `brackets` variant.
+     * @default true
+     */
+    displayBrackets?: boolean;
     /**
      * Event handlers for citation interactions.
      */

package/lib/react/CitationComponent.js

@@ -136,12 +136,28 @@ const ImageOverlay = ({ src, alt, onClose, }) => {
     // Use portal to render at body level, avoiding any parent positioning issues
     return createPortal(_jsx("div", { className: "dc-overlay", onClick: handleBackdropClick, role: "dialog", "aria-modal": "true", "aria-label": "Full size verification image", children: _jsx("div", { className: "dc-overlay-content", onClick: onClose, children: _jsx("img", { src: src, alt: alt, className: "dc-overlay-image", draggable: false }) }) }), document.body);
 };
+/**
+ * Diff details for partial/miss verification states.
+ * Shows expected vs found text.
+ */
+const DiffDetails = ({ citation, verification, status, }) => {
+    const { isMiss, isPartialMatch } = status;
+    if (!isMiss && !isPartialMatch)
+        return null;
+    const expectedText = citation.fullPhrase || citation.keySpan?.toString() || "";
+    const actualText = verification?.matchSnippet || "";
+    const truncatedExpected = expectedText.length > 100 ? expectedText.slice(0, 100) + "…" : expectedText;
+    const truncatedActual = actualText.length > 100 ? actualText.slice(0, 100) + "…" : actualText;
+    return (_jsxs("span", { className: "dc-diff-details", children: [truncatedExpected && (_jsxs("span", { className: "dc-status-searched", children: [_jsx("span", { className: "dc-status-label", children: "Expected" }), _jsx("span", { className: "dc-status-text", children: truncatedExpected })] })), isPartialMatch && truncatedActual && (_jsxs("span", { className: "dc-status-searched", children: [_jsx("span", { className: "dc-status-label", children: "Found" }), _jsx("span", { className: "dc-status-text", children: truncatedActual })] })), isMiss && (_jsxs("span", { className: "dc-status-searched", children: [_jsx("span", { className: "dc-status-label", children: "Found" }), _jsx("span", { className: "dc-status-text dc-status-text--miss", children: "Not found in source" })] }))] }));
+};
 /**
  * Default popover content component.
  * Shows verification image if available, otherwise shows text info.
+ * For partial/miss states, also displays expected vs found details.
  */
-const DefaultPopoverContent = ({ verification, status, onImageClick, }) => {
+const DefaultPopoverContent = ({ citation, verification, status, onImageClick, }) => {
     const hasImage = verification?.verificationImageBase64;
+    const { isMiss, isPartialMatch } = status;
     const handleImageClick = useCallback((e) => {
         e.preventDefault();
         e.stopPropagation();
@@ -149,9 +165,9 @@ const DefaultPopoverContent = ({ verification, status, onImageClick, }) => {
             onImageClick(verification.verificationImageBase64);
         }
     }, [hasImage, verification?.verificationImageBase64, onImageClick]);
-    // If we have a verification image, show only the image
+    // If we have a verification image, show image + diff details for partial/miss
     if (hasImage) {
-        return (_jsx("button", { type: "button", className: "dc-popover-image-button", onClick: handleImageClick, "aria-label": "Click to view full size", children: _jsx("img", { src: verification.verificationImageBase64, alt: "Citation verification", className: "dc-popover-image", loading: "lazy" }) }));
+        return (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", className: "dc-popover-image-button", onClick: handleImageClick, "aria-label": "Click to view full size", children: _jsx("img", { src: verification.verificationImageBase64, alt: "Citation verification", className: "dc-popover-image", loading: "lazy" }) }), (isMiss || isPartialMatch) && (_jsx(DiffDetails, { citation: citation, verification: verification, status: status }))] }));
     }
     // No image - show text info
     const statusLabel = getStatusLabel(status);
@@ -161,7 +177,7 @@ const DefaultPopoverContent = ({ verification, status, onImageClick, }) => {
     if (!hasSnippet && !statusLabel) {
         return null;
     }
-    return (_jsxs(_Fragment, { children: [statusLabel && (_jsx("span", { className: classNames("dc-popover-status", statusClass), children: statusLabel })), hasSnippet && (_jsxs("span", { className: "dc-popover-snippet", children: ["\"", verification.matchSnippet, "\""] })), pageNumber && pageNumber > 0 && (_jsxs("span", { className: "dc-popover-page", children: ["Page ", pageNumber] }))] }));
+    return (_jsxs(_Fragment, { children: [statusLabel && (_jsx("span", { className: classNames("dc-popover-status", statusClass), children: statusLabel })), hasSnippet && (_jsxs("span", { className: "dc-popover-snippet", children: ["\"", verification.matchSnippet, "\""] })), pageNumber && pageNumber > 0 && (_jsxs("span", { className: "dc-popover-page", children: ["Page ", pageNumber] })), (isMiss || isPartialMatch) && (_jsx(DiffDetails, { citation: citation, verification: verification, status: status }))] }));
 };
 // =============================================================================
 // MAIN COMPONENT
@@ -182,7 +198,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, displayKeySpan = false, fallbackDisplay, verification, variant = "brackets", eventHandlers, isMobile = false, renderIndicator, renderContent, popoverPosition = "top", renderPopoverContent, }, ref) => {
+export const CitationComponent = forwardRef(({ citation, children, className, displayKeySpan = true, displayBrackets = true, 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);
@@ -268,15 +284,11 @@ export const CitationComponent = forwardRef(({ citation, children, className, di
     // const { isVerified, isPending } = status;
     const { isMiss, isPartialMatch, isVerified, isPending } = status;
     const displayText = useMemo(() => {
-        // For numeric variant, always show the citation number
-        if (variant === "numeric") {
-            return citation.citationNumber?.toString() ?? "";
-        }
-        // For text/minimal/brackets, show the value or fullPhrase
+        // For text/minimal variants, always show keySpan
+        // For brackets variant, show keySpan based on displayKeySpan prop
         return getCitationDisplayText(citation, {
             displayKeySpan: variant === "text" ||
                 variant === "minimal" ||
-                variant === "brackets" ||
                 displayKeySpan,
             fallbackDisplay,
         });
@@ -309,12 +321,13 @@ export const CitationComponent = forwardRef(({ citation, children, className, di
         if (renderIndicator) {
             return renderIndicator(status);
         }
-        if (isVerified) {
-            return _jsx(DefaultVerifiedIndicator, {});
-        }
-        else if (isPartialMatch) {
+        // Check partial match first since isVerified includes isPartialMatch
+        if (isPartialMatch) {
             return _jsx(DefaultPartialIndicator, {});
         }
+        else if (isVerified) {
+            return _jsx(DefaultVerifiedIndicator, {});
+        }
         else if (isPending) {
             return (_jsx("span", { className: "dc-indicator dc-indicator--pending", "aria-hidden": "true", children: TWO_DOTS_THINKING_CONTENT }));
         }
@@ -339,7 +352,7 @@ export const CitationComponent = forwardRef(({ citation, children, className, di
         if (variant === "indicator") {
             return (_jsx("span", { className: "dc-citation-text", children: renderStatusIndicator() }));
         }
-        // Text variant - no special styling, shows value with indicator
+        // Text variant - no special styling, shows keySpan with indicator
         if (variant === "text") {
             return (_jsxs("span", { className: "dc-citation-text dc-citation-text--plain", children: [displayText, renderStatusIndicator()] }));
         }
@@ -347,12 +360,8 @@ export const CitationComponent = forwardRef(({ citation, children, className, di
         if (variant === "minimal") {
             return (_jsxs("span", { className: "dc-citation-text", children: [displayText, renderStatusIndicator()] }));
         }
-        // Numeric variant - shows citation number with indicator, no brackets
-        if (variant === "numeric") {
-            return (_jsxs("span", { className: "dc-citation-text", children: [displayText, renderStatusIndicator()] }));
-        }
-        // Brackets variant (default) - value/number in brackets with styling
-        return (_jsxs("span", { className: "dc-citation-bracket", "aria-hidden": "true", role: "presentation", children: ["[", _jsxs("span", { className: "dc-citation-text", children: [displayText, renderStatusIndicator()] }), "]"] }));
+        // Brackets variant (default) - keySpan/number in brackets with styling
+        return (_jsxs("span", { className: "dc-citation-bracket", "aria-hidden": "true", role: "presentation", children: [displayBrackets && "[", _jsxs("span", { className: "dc-citation-text", children: [displayText, renderStatusIndicator()] }), displayBrackets && "]"] }));
     };
     // Determine if popover should be shown
     const isPopoverHidden = popoverPosition === "hidden";

package/lib/react/primitives.d.ts

@@ -55,12 +55,12 @@ export interface CitationNumberProps extends HTMLAttributes<HTMLSpanElement> {
 }
 /** Displays the citation number. */
 export declare const CitationNumber: React.ForwardRefExoticComponent<CitationNumberProps & React.RefAttributes<HTMLSpanElement>>;
-export interface CitationValueProps extends HTMLAttributes<HTMLSpanElement> {
-    value?: string;
+export interface CitationKeySpanProps extends HTMLAttributes<HTMLSpanElement> {
+    keySpan?: string;
     separator?: string;
 }
-/** Displays the citation value (summary text). */
-export declare const CitationValue: React.ForwardRefExoticComponent<CitationValueProps & React.RefAttributes<HTMLSpanElement>>;
+/** Displays the citation keySpan (summary text). */
+export declare const CitationKeySpan: React.ForwardRefExoticComponent<CitationKeySpanProps & React.RefAttributes<HTMLSpanElement>>;
 export interface CitationIndicatorProps extends HTMLAttributes<HTMLSpanElement> {
     verifiedIndicator?: ReactNode;
     partialIndicator?: ReactNode;
@@ -95,7 +95,7 @@ export declare const Citation: {
     readonly Trigger: React.ForwardRefExoticComponent<CitationTriggerProps & React.RefAttributes<HTMLSpanElement>>;
     readonly Bracket: React.ForwardRefExoticComponent<CitationBracketProps & React.RefAttributes<HTMLSpanElement>>;
     readonly Number: React.ForwardRefExoticComponent<CitationNumberProps & React.RefAttributes<HTMLSpanElement>>;
-    readonly Value: React.ForwardRefExoticComponent<CitationValueProps & React.RefAttributes<HTMLSpanElement>>;
+    readonly KeySpan: React.ForwardRefExoticComponent<CitationKeySpanProps & React.RefAttributes<HTMLSpanElement>>;
     readonly Indicator: React.ForwardRefExoticComponent<CitationIndicatorProps & React.RefAttributes<HTMLSpanElement>>;
     readonly Status: typeof CitationStatusComponent;
     readonly Phrase: React.ForwardRefExoticComponent<CitationPhraseProps & React.RefAttributes<HTMLSpanElement>>;

package/lib/react/primitives.js

@@ -114,21 +114,21 @@ export const CitationNumber = forwardRef(({ className, number, ...props }, ref)
     return (_jsx("span", { ref: ref, className: classNames("citation-number", className), ...props, children: displayNumber }));
 });
 CitationNumber.displayName = "Citation.Number";
-/** Displays the citation value (summary text). */
-export const CitationValue = forwardRef(({ className, value, separator = " ", ...props }, ref) => {
+/** Displays the citation keySpan (summary text). */
+export const CitationKeySpan = forwardRef(({ className, keySpan, separator = " ", ...props }, ref) => {
     const { citation, config } = useCitationContext();
-    const displayValue = useMemo(() => {
-        if (value !== undefined)
-            return value;
+    const displayKeySpan = useMemo(() => {
+        if (keySpan !== undefined)
+            return keySpan;
         if (!config.displayKeySpan)
             return "";
         return citation.keySpan?.toString() || "";
-    }, [value, citation, config]);
-    if (!displayValue)
+    }, [keySpan, citation, config]);
+    if (!displayKeySpan)
         return null;
-    return (_jsxs("span", { ref: ref, className: classNames("citation-value", className), ...props, children: [displayValue, separator] }));
+    return (_jsxs("span", { ref: ref, className: classNames("citation-key-span", className), ...props, children: [displayKeySpan, separator] }));
 });
-CitationValue.displayName = "Citation.Value";
+CitationKeySpan.displayName = "Citation.KeySpan";
 /** Displays a status indicator based on citation verification state. */
 export const CitationIndicator = forwardRef(({ className, verifiedIndicator = "✓", partialIndicator = "*", missIndicator = null, pendingIndicator = null, showFor, ...props }, ref) => {
     const { status } = useCitationContext();
@@ -187,7 +187,7 @@ export const Citation = {
     Trigger: CitationTrigger,
     Bracket: CitationBracket,
     Number: CitationNumber,
-    Value: CitationValue,
+    KeySpan: CitationKeySpan,
     Indicator: CitationIndicator,
     Status: CitationStatusComponent,
     Phrase: CitationPhrase,

package/lib/react/styles.css

@@ -57,6 +57,27 @@
   text-overflow: ellipsis;
 }
 
+/* Text variant - plain styling that inherits from parent */
+.dc-citation-text--plain {
+  max-width: none;
+  overflow: visible;
+  font-family: inherit;
+  font-size: inherit;
+  line-height: inherit;
+  color: inherit;
+}
+
+/* Text variant container - inherit all styling from parent */
+.dc-citation--text {
+  font-family: inherit;
+  font-size: inherit;
+  line-height: inherit;
+}
+
+.dc-citation--text .dc-citation-text--plain {
+  color: inherit;
+}
+
 /* Status-specific styles */
 .dc-citation--verified .dc-citation-text {
   color: var(--dc-color-verified, #2563eb);
@@ -423,6 +444,23 @@
   text-overflow: ellipsis;
 }
 
+.dc-status-text--miss {
+  color: var(--dc-color-warning, #d97706);
+  font-style: italic;
+}
+
+/* Diff details container in popover */
+.dc-diff-details {
+  display: flex;
+  flex-direction: column;
+  gap: 0.25rem;
+  margin-top: 0.5rem;
+  padding-top: 0.5rem;
+  border-top: 1px solid var(--dc-border-color, #e2e8f0);
+  font-family: system-ui, -apple-system, sans-serif;
+  font-size: 0.75rem;
+}
+
 /* Dark mode support */
 @media (prefers-color-scheme: dark) {
   .dc-status-tooltip {

package/lib/react/types.d.ts

@@ -4,13 +4,14 @@ import type { SearchState } from "../types/search.js";
 /**
  * Available citation display variants.
  *
- * - `brackets`: Shows value/number in brackets with blue text styling (default)
- * - `numeric`: Shows citation number with indicator, no brackets
- * - `text`: Shows the value, no text styling, no truncate, shows indicator
+ * - `brackets`: Shows keySpan/number in brackets with blue text styling (default).
+ *               Use displayKeySpan=false for numeric-only display.
+ *               Use displayBrackets=false to hide the square brackets.
+ * - `text`: Shows the keySpan, inherits parent text styling, no truncation, shows indicator
  * - `minimal`: No brackets, just display text with indicator
  * - `indicator`: Only the status indicator (checkmark/warning), no text
  */
-export type CitationVariant = "brackets" | "numeric" | "text" | "minimal" | "indicator";
+export type CitationVariant = "brackets" | "text" | "minimal" | "indicator";
 /**
  * URL fetch status for URL citations.
  */
@@ -89,9 +90,12 @@ export interface BaseCitationProps {
     className?: string;
     /** Class name for controlling inner content width */
     innerWidthClassName?: string;
-    /** When true, displays value/citationNumber merged in the bracket */
+    /**
+     * When true, displays keySpan text. When false, displays citation number only.
+     * @default true
+     */
     displayKeySpan?: boolean;
-    /** Fallback display text when citation value is empty */
+    /** Fallback display text when citation keySpan is empty */
     fallbackDisplay?: string | null;
     /** Display variant for the citation */
     variant?: CitationVariant;
@@ -164,7 +168,7 @@ export interface CitationRenderProps {
     citationKey: string;
     /** Display text for the citation */
     displayText: string;
-    /** Whether this is a merged value display */
+    /** Whether this is a merged keySpan display */
     isMergedDisplay: boolean;
 }
 /**

package/package.json

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