@deepcitation/deepcitation-js 1.1.23 → 1.1.25

package/lib/react/CitationComponent.js

@@ -1,16 +1,10 @@
 import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { forwardRef, memo, useCallback, useEffect, useMemo, useState, } from "react";
 import { createPortal } from "react-dom";
-import { CheckIcon, WarningIcon } from "./icons.js";
+import { CheckIcon, SpinnerIcon, WarningIcon } from "./icons.js";
 import { Popover, PopoverContent, PopoverTrigger } from "./Popover.js";
-import { generateCitationInstanceId, generateCitationKey, getCitationDisplayText, } from "./utils.js";
+import { cn, generateCitationInstanceId, generateCitationKey, getCitationDisplayText, } from "./utils.js";
 import { useSmartDiff } from "./useSmartDiff.js";
-// =============================================================================
-// UTILITY FUNCTIONS
-// =============================================================================
-function cn(...classes) {
-    return classes.filter(Boolean).join(" ");
-}
 function getStatusLabel(status) {
     if (status.isVerified && !status.isPartialMatch)
         return "Verified";
@@ -30,7 +24,12 @@ function getStatusFromVerification(verification) {
     const status = verification?.status;
     // No verification or no status = pending
     if (!verification || !status) {
-        return { isVerified: false, isMiss: false, isPartialMatch: false, isPending: true };
+        return {
+            isVerified: false,
+            isMiss: false,
+            isPartialMatch: false,
+            isPending: true,
+        };
     }
     const isMiss = status === "not_found";
     const isPending = status === "pending" || status === "loading";
@@ -74,14 +73,12 @@ function ImageOverlay({ src, alt, onClose }) {
 //
 // Use `renderIndicator` prop to customize. Use `variant="indicator"` to show only the icon.
 // =============================================================================
-/** Spinner component for loading/pending state */
-const Spinner = ({ className }) => (_jsxs("svg", { className: cn("animate-spin", className), xmlns: "http://www.w3.org/2000/svg", fill: "none", viewBox: "0 0 24 24", width: "12", height: "12", children: [_jsx("circle", { className: "opacity-25", cx: "12", cy: "12", r: "10", stroke: "currentColor", strokeWidth: "4" }), _jsx("path", { className: "opacity-75", fill: "currentColor", d: "M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z" })] }));
 /** Verified indicator - green checkmark for exact matches */
 const VerifiedIndicator = () => (_jsx("span", { className: "inline-flex relative ml-0.5 text-green-600 dark:text-green-500", "aria-hidden": "true", children: _jsx(CheckIcon, {}) }));
 /** Partial match indicator - amber checkmark for partial/relocated matches */
 const PartialIndicator = () => (_jsx("span", { className: "inline-flex relative ml-0.5 text-amber-600 dark:text-amber-500", "aria-hidden": "true", children: _jsx(CheckIcon, {}) }));
 /** Pending indicator - spinner for loading state */
-const PendingIndicator = () => (_jsx("span", { className: "inline-flex ml-1 text-gray-400 dark:text-gray-500", "aria-hidden": "true", children: _jsx(Spinner, {}) }));
+const PendingIndicator = () => (_jsx("span", { className: "inline-flex ml-1 text-gray-400 dark:text-gray-500", "aria-hidden": "true", children: _jsx(SpinnerIcon, {}) }));
 /** Miss indicator - red warning triangle for not found */
 const MissIndicator = () => (_jsx("span", { className: "inline-flex relative ml-0.5 text-red-500 dark:text-red-400", "aria-hidden": "true", children: _jsx(WarningIcon, {}) }));
 function DefaultPopoverContent({ citation, verification, status, onImageClick, }) {
@@ -101,7 +98,9 @@ function DefaultPopoverContent({ citation, verification, status, onImageClick, }
     const pageNumber = verification?.verifiedPageNumber;
     if (!hasSnippet && !statusLabel)
         return null;
-    return (_jsxs("div", { className: "p-3 flex flex-col gap-2 min-w-[200px] max-w-[400px]", children: [statusLabel && (_jsx("span", { className: cn("text-xs font-medium", status.isVerified && !status.isPartialMatch && "text-green-600 dark:text-green-500", status.isPartialMatch && "text-amber-600 dark:text-amber-500", status.isMiss && "text-red-600 dark:text-red-500", status.isPending && "text-gray-500 dark:text-gray-400"), children: statusLabel })), hasSnippet && (_jsxs("span", { className: "text-sm text-gray-700 dark:text-gray-300 italic", children: ["\"", verification.verifiedMatchSnippet, "\""] })), pageNumber && pageNumber > 0 && (_jsxs("span", { className: "text-xs text-gray-500 dark:text-gray-400", children: ["Page ", pageNumber] })), (isMiss || isPartialMatch) && (_jsx(DiffDetails, { citation: citation, verification: verification, status: status }))] }));
+    return (_jsxs("div", { className: "p-3 flex flex-col gap-2 min-w-[200px] max-w-[400px]", children: [statusLabel && (_jsx("span", { className: cn("text-xs font-medium", status.isVerified &&
+                    !status.isPartialMatch &&
+                    "text-green-600 dark:text-green-500", status.isPartialMatch && "text-amber-600 dark:text-amber-500", status.isMiss && "text-red-600 dark:text-red-500", status.isPending && "text-gray-500 dark:text-gray-400"), children: statusLabel })), hasSnippet && (_jsxs("span", { className: "text-sm text-gray-700 dark:text-gray-300 italic", children: ["\"", verification.verifiedMatchSnippet, "\""] })), pageNumber && pageNumber > 0 && (_jsxs("span", { className: "text-xs text-gray-500 dark:text-gray-400", children: ["Page ", pageNumber] })), (isMiss || isPartialMatch) && (_jsx(DiffDetails, { citation: citation, verification: verification, status: status }))] }));
 }
 // =============================================================================
 // DIFF DETAILS COMPONENT
@@ -128,10 +127,16 @@ function DiffDetails({ citation, verification, status, }) {
     const pageDiffers = expectedPage != null && actualPage != null && expectedPage !== actualPage;
     // For "not_found" status, show expected text and "Not found" message
     if (isMiss) {
-        return (_jsxs("div", { className: "mt-2 pt-2 border-t border-gray-200 dark:border-gray-700 text-xs space-y-2", children: [expectedText && (_jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Expected" }), _jsx("p", { className: "mt-1 p-2 bg-gray-100 dark:bg-gray-800 rounded font-mono text-[11px] break-words text-red-600 dark:text-red-400 line-through opacity-70", children: expectedText.length > 100 ? expectedText.slice(0, 100) + "…" : expectedText })] })), _jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Found" }), _jsx("p", { className: "mt-1 p-2 bg-gray-100 dark:bg-gray-800 rounded font-mono text-[11px] text-amber-600 dark:text-amber-500 italic", children: "Not found in source" })] })] }));
+        return (_jsxs("div", { className: "mt-2 pt-2 border-t border-gray-200 dark:border-gray-700 text-xs space-y-2", children: [expectedText && (_jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Expected" }), _jsx("p", { className: "mt-1 p-2 bg-gray-100 dark:bg-gray-800 rounded font-mono text-[11px] break-words text-red-600 dark:text-red-400 line-through opacity-70", children: expectedText.length > 100
+                                ? expectedText.slice(0, 100) + "…"
+                                : expectedText })] })), _jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Found" }), _jsx("p", { className: "mt-1 p-2 bg-gray-100 dark:bg-gray-800 rounded font-mono text-[11px] text-amber-600 dark:text-amber-500 italic", children: "Not found in source" })] })] }));
     }
     // For partial matches, show word-level diff
-    return (_jsxs("div", { className: "mt-2 pt-2 border-t border-gray-200 dark:border-gray-700 text-xs space-y-2", children: [expectedText && actualText && hasDiff ? (_jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Diff" }), _jsx("div", { className: "mt-1 p-2 bg-gray-100 dark:bg-gray-800 rounded font-mono text-[11px] break-words text-gray-700 dark:text-gray-300", children: isHighVariance ? (_jsxs("div", { className: "space-y-2", children: [_jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 text-[10px]", children: "Expected: " }), _jsx("span", { className: "text-red-600 dark:text-red-400 line-through opacity-70", children: expectedText.length > 100 ? expectedText.slice(0, 100) + "…" : expectedText })] }), _jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 text-[10px]", children: "Found: " }), _jsx("span", { className: "text-green-600 dark:text-green-400", children: actualText.length > 100 ? actualText.slice(0, 100) + "…" : actualText })] })] })) : (
+    return (_jsxs("div", { className: "mt-2 pt-2 border-t border-gray-200 dark:border-gray-700 text-xs space-y-2", children: [expectedText && actualText && hasDiff ? (_jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Diff" }), _jsx("div", { className: "mt-1 p-2 bg-gray-100 dark:bg-gray-800 rounded font-mono text-[11px] break-words text-gray-700 dark:text-gray-300", children: isHighVariance ? (_jsxs("div", { className: "space-y-2", children: [_jsxs("div", { children: [_jsxs("span", { className: "text-gray-500 dark:text-gray-400 text-[10px]", children: ["Expected:", " "] }), _jsx("span", { className: "text-red-600 dark:text-red-400 line-through opacity-70", children: expectedText.length > 100
+                                                ? expectedText.slice(0, 100) + "…"
+                                                : expectedText })] }), _jsxs("div", { children: [_jsxs("span", { className: "text-gray-500 dark:text-gray-400 text-[10px]", children: ["Found:", " "] }), _jsx("span", { className: "text-green-600 dark:text-green-400", children: actualText.length > 100
+                                                ? actualText.slice(0, 100) + "…"
+                                                : actualText })] })] })) : (
                         // Inline word-level diff
                         diffResult.map((block, blockIndex) => (_jsx("span", { children: block.parts.map((part, partIndex) => {
                                 const key = `p-${blockIndex}-${partIndex}`;
@@ -145,7 +150,9 @@ function DiffDetails({ citation, verification, status, }) {
                                 return _jsx("span", { children: part.value }, key);
                             }) }, `block-${blockIndex}`)))) })] })) : expectedText && !hasDiff ? (
             // Text matches exactly (partial match is due to location difference)
-            _jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Text" }), _jsx("p", { className: "mt-1 p-2 bg-gray-100 dark:bg-gray-800 rounded font-mono text-[11px] break-words text-gray-700 dark:text-gray-300", children: expectedText.length > 100 ? expectedText.slice(0, 100) + "…" : expectedText })] })) : null, pageDiffers && (_jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Page" }), _jsxs("p", { className: "mt-1 font-mono text-[11px] text-gray-700 dark:text-gray-300", children: [_jsx("span", { className: "text-red-600 dark:text-red-400 line-through opacity-70", children: expectedPage }), " → ", actualPage] })] })), lineIdDiffers && (_jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Line" }), _jsxs("p", { className: "mt-1 font-mono text-[11px] text-gray-700 dark:text-gray-300", children: [_jsx("span", { className: "text-red-600 dark:text-red-400 line-through opacity-70", children: expectedLineIds?.join(", ") }), " → ", actualLineIds?.join(", ")] })] }))] }));
+            _jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Text" }), _jsx("p", { className: "mt-1 p-2 bg-gray-100 dark:bg-gray-800 rounded font-mono text-[11px] break-words text-gray-700 dark:text-gray-300", children: expectedText.length > 100
+                            ? expectedText.slice(0, 100) + "…"
+                            : expectedText })] })) : null, pageDiffers && (_jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Page" }), _jsxs("p", { className: "mt-1 font-mono text-[11px] text-gray-700 dark:text-gray-300", children: [_jsx("span", { className: "text-red-600 dark:text-red-400 line-through opacity-70", children: expectedPage }), " → ", actualPage] })] })), lineIdDiffers && (_jsxs("div", { children: [_jsx("span", { className: "text-gray-500 dark:text-gray-400 font-medium uppercase text-[10px]", children: "Line" }), _jsxs("p", { className: "mt-1 font-mono text-[11px] text-gray-700 dark:text-gray-300", children: [_jsx("span", { className: "text-red-600 dark:text-red-400 line-through opacity-70", children: expectedLineIds?.join(", ") }), " → ", actualLineIds?.join(", ")] })] }))] }));
 }
 // =============================================================================
 // MAIN COMPONENT
@@ -193,7 +200,8 @@ export const CitationComponent = forwardRef(({ citation, children, className, hi
             if (typeof actions.setImageExpanded === "string") {
                 setExpandedImageSrc(actions.setImageExpanded);
             }
-            else if (actions.setImageExpanded === true && verification?.verificationImageBase64) {
+            else if (actions.setImageExpanded === true &&
+                verification?.verificationImageBase64) {
                 setExpandedImageSrc(verification.verificationImageBase64);
             }
             else if (actions.setImageExpanded === false) {
@@ -240,14 +248,26 @@ export const CitationComponent = forwardRef(({ citation, children, className, hi
             behaviorConfig.onHover.onEnter(getBehaviorContext());
         }
         eventHandlers?.onMouseEnter?.(citation, citationKey);
-    }, [eventHandlers, behaviorConfig, citation, citationKey, getBehaviorContext]);
+    }, [
+        eventHandlers,
+        behaviorConfig,
+        citation,
+        citationKey,
+        getBehaviorContext,
+    ]);
     const handleMouseLeave = useCallback(() => {
         setIsHovering(false);
         if (behaviorConfig?.onHover?.onLeave) {
             behaviorConfig.onHover.onLeave(getBehaviorContext());
         }
         eventHandlers?.onMouseLeave?.(citation, citationKey);
-    }, [eventHandlers, behaviorConfig, citation, citationKey, getBehaviorContext]);
+    }, [
+        eventHandlers,
+        behaviorConfig,
+        citation,
+        citationKey,
+        getBehaviorContext,
+    ]);
     // Touch handler for mobile
     const handleTouchEnd = useCallback((e) => {
         if (isMobile) {
@@ -257,13 +277,18 @@ export const CitationComponent = forwardRef(({ citation, children, className, hi
         }
     }, [eventHandlers, citation, citationKey, isMobile]);
     // Early return for miss with fallback display
-    if (fallbackDisplay !== null && fallbackDisplay !== undefined && !hideKeySpan && isMiss) {
+    if (fallbackDisplay !== null &&
+        fallbackDisplay !== undefined &&
+        !hideKeySpan &&
+        isMiss) {
         return (_jsx("span", { className: cn("text-gray-400 dark:text-gray-500", className), children: fallbackDisplay }));
     }
     // Status classes for text styling
     const statusClasses = cn(
     // Found status (text color) - verified or partial match
-    (isVerified || isPartialMatch) && variant === "brackets" && "text-blue-600 dark:text-blue-400 hover:text-blue-700 dark:hover:text-blue-300 hover:underline", isMiss && "opacity-70 line-through text-gray-400 dark:text-gray-500", isPending && "text-gray-500 dark:text-gray-400");
+    (isVerified || isPartialMatch) &&
+        variant === "brackets" &&
+        "text-blue-600 dark:text-blue-400 hover:text-blue-700 dark:hover:text-blue-300 hover:underline", isMiss && "opacity-70 line-through text-gray-400 dark:text-gray-500", isPending && "text-gray-500 dark:text-gray-400");
     // Render indicator based on status priority:
     // 1. Custom renderIndicator (if provided)
     // 2. Pending → Spinner
@@ -310,7 +335,8 @@ export const CitationComponent = forwardRef(({ citation, children, className, hi
     const isPopoverHidden = popoverPosition === "hidden";
     const shouldShowPopover = !isPopoverHidden &&
         verification &&
-        (verification.verificationImageBase64 || verification.verifiedMatchSnippet);
+        (verification.verificationImageBase64 ||
+            verification.verifiedMatchSnippet);
     const hasImage = !!verification?.verificationImageBase64;
     // Image overlay
     const imageOverlay = expandedImageSrc ? (_jsx(ImageOverlay, { src: expandedImageSrc, alt: "Citation verification - full size", onClose: () => setExpandedImageSrc(null) })) : null;

package/lib/react/icons.d.ts

@@ -6,3 +6,7 @@ export declare const CheckIcon: () => import("react/jsx-runtime").JSX.Element;
  * Warning icon SVG (no dependencies)
  */
 export declare const WarningIcon: () => import("react/jsx-runtime").JSX.Element;
+/** Spinner component for loading/pending state */
+export declare const SpinnerIcon: ({ className }: {
+    className?: string;
+}) => import("react/jsx-runtime").JSX.Element;

package/lib/react/icons.js

@@ -1,4 +1,5 @@
-import { jsx as _jsx } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "./utils.js";
 /**
  * Check icon SVG (no dependencies)
  */
@@ -7,3 +8,5 @@ export const CheckIcon = () => (_jsx("svg", { className: "dc-check-icon", viewBo
  * Warning icon SVG (no dependencies)
  */
 export const WarningIcon = () => (_jsx("svg", { className: "dc-status-icon", viewBox: "0 0 256 256", fill: "currentColor", "aria-hidden": "true", children: _jsx("path", { d: "M236.8,188.09,149.35,36.22h0a24.76,24.76,0,0,0-42.7,0L19.2,188.09a23.51,23.51,0,0,0,0,23.72A24.35,24.35,0,0,0,40.55,224h174.9a24.35,24.35,0,0,0,21.33-12.19A23.51,23.51,0,0,0,236.8,188.09ZM120,104a8,8,0,0,1,16,0v40a8,8,0,0,1-16,0Zm8,88a12,12,0,1,1,12-12A12,12,0,0,1,128,192Z" }) }));
+/** Spinner component for loading/pending state */
+export const SpinnerIcon = ({ className }) => (_jsxs("svg", { className: cn("animate-spin", className), xmlns: "http://www.w3.org/2000/svg", fill: "none", viewBox: "0 0 24 24", width: "12", height: "12", children: [_jsx("circle", { className: "opacity-25", cx: "12", cy: "12", r: "10", stroke: "currentColor", strokeWidth: "4" }), _jsx("path", { className: "opacity-75", fill: "currentColor", d: "M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4zm2 5.291A7.962 7.962 0 014 12H0c0 3.042 1.135 5.824 3 7.938l3-2.647z" })] }));

package/lib/react/useSmartDiff.js

@@ -1,4 +1,4 @@
-import * as Diff from "diff";
+import { diffLines, diffWordsWithSpace } from "../utils/diff.js";
 import { useMemo } from "react";
 export const useSmartDiff = (expected = "", actual = "") => {
     return useMemo(() => {
@@ -8,7 +8,7 @@ export const useSmartDiff = (expected = "", actual = "") => {
         // 2. First Pass: Diff by LINES.
         // This isolates the "extra line" issue. The extra line becomes one "added" chunk,
         // and it prevents the tokenizer from getting confused on the rest of the text.
-        const lineDiffs = Diff.diffLines(cleanExpected, cleanActual);
+        const lineDiffs = diffLines(cleanExpected, cleanActual);
         // 3. Second Pass: Process the line results to find "Modifications"
         const processedDiffs = [];
         let hasDiff = false;
@@ -21,7 +21,7 @@ export const useSmartDiff = (expected = "", actual = "") => {
             // it means this specific line changed. We should DIFF WORDS inside this line.
             if (part.removed && nextPart && nextPart.added) {
                 // Run word diff ONLY on this pair of lines
-                const wordDiffs = Diff.diffWordsWithSpace(part.value, nextPart.value);
+                const wordDiffs = diffWordsWithSpace(part.value, nextPart.value);
                 processedDiffs.push({
                     type: "modified",
                     parts: wordDiffs,

package/lib/react/utils.d.ts

@@ -1,5 +1,6 @@
 import type { Citation } from "../types/citation.js";
 import type { Verification } from "../types/verification.js";
+export declare function cn(...classes: (string | undefined | null | false)[]): string;
 /**
  * Generates a unique, deterministic key for a citation based on its content.
  *  @param citation - The citation to generate a key for

package/lib/react/utils.js

@@ -1,5 +1,11 @@
 import { sha1Hash } from "../utils/sha.js";
 import { getCitationPageNumber } from "../parsing/normalizeCitation.js";
+// =============================================================================
+// UTILITY FUNCTIONS
+// =============================================================================
+export function cn(...classes) {
+    return classes.filter(Boolean).join(" ");
+}
 /**
  * Generates a unique, deterministic key for a citation based on its content.
  *  @param citation - The citation to generate a key for

package/lib/utils/diff.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Custom diff implementation to replace the 'diff' npm package.
+ * This avoids dependency issues in Firebase Functions environments.
+ *
+ * Implements a Myers diff algorithm with optimizations inspired by jsdiff.
+ * @see https://github.com/kpdecker/jsdiff
+ *
+ * ---
+ *
+ * BSD 3-Clause License
+ *
+ * Copyright (c) 2009-2015, Kevin Decker <kpdecker@gmail.com>
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ *    this list of conditions and the following disclaimer in the documentation
+ *    and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from
+ *    this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+export interface Change {
+    value: string;
+    added?: boolean;
+    removed?: boolean;
+    count?: number;
+}
+/**
+ * Compare two strings line by line.
+ * Similar to Diff.diffLines from the 'diff' package.
+ */
+export declare function diffLines(oldStr: string, newStr: string): Change[];
+/**
+ * Compare two strings word by word, preserving whitespace.
+ * Similar to Diff.diffWordsWithSpace from the 'diff' package.
+ *
+ * Features matching jsdiff:
+ * - Extended Unicode word character support
+ * - Proper tokenization (words, whitespace runs, single punctuation)
+ * - Whitespace deduplication in consecutive changes
+ */
+export declare function diffWordsWithSpace(oldStr: string, newStr: string): Change[];

package/lib/utils/diff.js

@@ -0,0 +1,414 @@
+/**
+ * Custom diff implementation to replace the 'diff' npm package.
+ * This avoids dependency issues in Firebase Functions environments.
+ *
+ * Implements a Myers diff algorithm with optimizations inspired by jsdiff.
+ * @see https://github.com/kpdecker/jsdiff
+ *
+ * ---
+ *
+ * BSD 3-Clause License
+ *
+ * Copyright (c) 2009-2015, Kevin Decker <kpdecker@gmail.com>
+ * All rights reserved.
+ *
+ * Redistribution and use in source and binary forms, with or without
+ * modification, are permitted provided that the following conditions are met:
+ *
+ * 1. Redistributions of source code must retain the above copyright notice, this
+ *    list of conditions and the following disclaimer.
+ *
+ * 2. Redistributions in binary form must reproduce the above copyright notice,
+ *    this list of conditions and the following disclaimer in the documentation
+ *    and/or other materials provided with the distribution.
+ *
+ * 3. Neither the name of the copyright holder nor the names of its
+ *    contributors may be used to endorse or promote products derived from
+ *    this software without specific prior written permission.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+ * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+ * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+ * DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
+ * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+ * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+ * CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
+ * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+/**
+ * Myers diff algorithm with diagonal pruning optimization.
+ * This reduces complexity from O(n+d²) to O(n+d) for common cases like appending text.
+ *
+ * @see https://blog.jcoglan.com/2017/02/12/the-myers-diff-algorithm-part-1/
+ */
+function computeDiff(oldTokens, newTokens, equals = (a, b) => a === b) {
+    const oldLen = oldTokens.length;
+    const newLen = newTokens.length;
+    // Handle edge cases
+    if (oldLen === 0 && newLen === 0) {
+        return [];
+    }
+    // Quick path for completely new content
+    if (oldLen === 0) {
+        return [{ value: newTokens.join(""), added: true, count: newTokens.length }];
+    }
+    // Quick path for completely removed content
+    if (newLen === 0) {
+        return [
+            { value: oldTokens.join(""), removed: true, count: oldTokens.length },
+        ];
+    }
+    // Find common prefix
+    let commonPrefixLen = 0;
+    while (commonPrefixLen < oldLen &&
+        commonPrefixLen < newLen &&
+        equals(oldTokens[commonPrefixLen], newTokens[commonPrefixLen])) {
+        commonPrefixLen++;
+    }
+    // Find common suffix (but don't overlap with prefix)
+    let commonSuffixLen = 0;
+    while (commonSuffixLen < oldLen - commonPrefixLen &&
+        commonSuffixLen < newLen - commonPrefixLen &&
+        equals(oldTokens[oldLen - 1 - commonSuffixLen], newTokens[newLen - 1 - commonSuffixLen])) {
+        commonSuffixLen++;
+    }
+    // Extract the differing middle portions
+    const oldMiddle = oldTokens.slice(commonPrefixLen, oldLen - commonSuffixLen);
+    const newMiddle = newTokens.slice(commonPrefixLen, newLen - commonSuffixLen);
+    // If middles are empty, we only have common prefix/suffix
+    if (oldMiddle.length === 0 && newMiddle.length === 0) {
+        return [{ value: oldTokens.join(""), count: oldTokens.length }];
+    }
+    // Compute diff on the middle portion using Myers algorithm
+    const middleDiff = myersDiff(oldMiddle, newMiddle, equals);
+    // Build result with prefix, middle diff, and suffix
+    const result = [];
+    if (commonPrefixLen > 0) {
+        result.push({
+            value: oldTokens.slice(0, commonPrefixLen).join(""),
+            count: commonPrefixLen,
+        });
+    }
+    result.push(...middleDiff);
+    if (commonSuffixLen > 0) {
+        result.push({
+            value: oldTokens.slice(oldLen - commonSuffixLen).join(""),
+            count: commonSuffixLen,
+        });
+    }
+    return mergeConsecutiveChanges(result);
+}
+/**
+ * Myers diff algorithm implementation.
+ * Uses the "middle snake" approach for better memory efficiency.
+ */
+function myersDiff(oldTokens, newTokens, equals) {
+    const oldLen = oldTokens.length;
+    const newLen = newTokens.length;
+    const maxD = oldLen + newLen;
+    // V array indexed by k = x - y (diagonal)
+    // We use an object to handle negative indices
+    const v = { 1: 0 };
+    // Store the path for backtracking
+    const trace = [];
+    // Iterate through edit distances
+    outer: for (let d = 0; d <= maxD; d++) {
+        trace.push({ ...v });
+        // Iterate through diagonals
+        for (let k = -d; k <= d; k += 2) {
+            // Decide whether to go down or right
+            let x;
+            if (k === -d || (k !== d && v[k - 1] < v[k + 1])) {
+                x = v[k + 1]; // Move down (insert)
+            }
+            else {
+                x = v[k - 1] + 1; // Move right (delete)
+            }
+            let y = x - k;
+            // Follow diagonal (matches)
+            while (x < oldLen && y < newLen && equals(oldTokens[x], newTokens[y])) {
+                x++;
+                y++;
+            }
+            v[k] = x;
+            // Check if we've reached the end
+            if (x >= oldLen && y >= newLen) {
+                break outer;
+            }
+        }
+    }
+    // Backtrack to build the diff
+    return backtrack(trace, oldTokens, newTokens);
+}
+/**
+ * Backtrack through the trace to build the diff result.
+ */
+function backtrack(trace, oldTokens, newTokens) {
+    const changes = [];
+    let x = oldTokens.length;
+    let y = newTokens.length;
+    for (let d = trace.length - 1; d >= 0; d--) {
+        const v = trace[d];
+        const k = x - y;
+        let prevK;
+        if (k === -d || (k !== d && v[k - 1] < v[k + 1])) {
+            prevK = k + 1;
+        }
+        else {
+            prevK = k - 1;
+        }
+        const prevX = v[prevK] ?? 0;
+        const prevY = prevX - prevK;
+        // Add diagonal matches (unchanged)
+        while (x > prevX && y > prevY) {
+            x--;
+            y--;
+            changes.unshift({ value: oldTokens[x], count: 1 });
+        }
+        if (d > 0) {
+            if (x === prevX) {
+                // Insertion (went down)
+                y--;
+                changes.unshift({ value: newTokens[y], added: true, count: 1 });
+            }
+            else {
+                // Deletion (went right)
+                x--;
+                changes.unshift({ value: oldTokens[x], removed: true, count: 1 });
+            }
+        }
+    }
+    return changes;
+}
+/**
+ * Merge consecutive changes of the same type.
+ */
+function mergeConsecutiveChanges(changes) {
+    if (changes.length === 0)
+        return [];
+    const result = [];
+    for (const change of changes) {
+        const last = result[result.length - 1];
+        if (last &&
+            last.added === change.added &&
+            last.removed === change.removed) {
+            last.value += change.value;
+            last.count = (last.count || 1) + (change.count || 1);
+        }
+        else {
+            result.push({ ...change });
+        }
+    }
+    return result;
+}
+/**
+ * Split text into lines, preserving line endings.
+ * Handles both Unix (\n) and Windows (\r\n) line endings.
+ */
+function splitLines(text) {
+    if (!text)
+        return [];
+    const lines = [];
+    let current = "";
+    for (let i = 0; i < text.length; i++) {
+        const char = text[i];
+        current += char;
+        if (char === "\n") {
+            lines.push(current);
+            current = "";
+        }
+    }
+    // Don't forget the last line if it doesn't end with newline
+    if (current.length > 0) {
+        lines.push(current);
+    }
+    return lines;
+}
+/**
+ * Extended word character class - matches jsdiff's extendedWordChars.
+ * Includes: a-zA-Z0-9_, soft hyphen, Latin Extended-A/B, IPA Extensions,
+ * Spacing Modifier Letters, and Latin Extended Additional.
+ *
+ * @see https://github.com/kpdecker/jsdiff/blob/master/src/diff/word.ts
+ */
+const EXTENDED_WORD_CHARS = "a-zA-Z0-9_\\u00AD\\u00C0-\\u00D6\\u00D8-\\u00F6\\u00F8-\\u02C6\\u02C8-\\u02D7\\u02DE-\\u02FF\\u1E00-\\u1EFF";
+/**
+ * Tokenization regex matching jsdiff's approach.
+ * Matches: word character runs, whitespace runs, or single non-word chars.
+ */
+const TOKENIZE_REGEX = new RegExp(`[${EXTENDED_WORD_CHARS}]+|\\s+|[^${EXTENDED_WORD_CHARS}]`, "gu");
+/**
+ * Split text into tokens using jsdiff's tokenization approach.
+ * Each token is one of:
+ * - A word (extended word characters)
+ * - A whitespace run
+ * - A single punctuation/symbol character
+ */
+function tokenizeWords(text) {
+    if (!text)
+        return [];
+    return text.match(TOKENIZE_REGEX) || [];
+}
+/**
+ * Find the longest common prefix between two strings.
+ */
+function longestCommonPrefix(a, b) {
+    let i = 0;
+    while (i < a.length && i < b.length && a[i] === b[i]) {
+        i++;
+    }
+    return a.slice(0, i);
+}
+/**
+ * Find the longest common suffix between two strings.
+ */
+function longestCommonSuffix(a, b) {
+    let i = 0;
+    while (i < a.length &&
+        i < b.length &&
+        a[a.length - 1 - i] === b[b.length - 1 - i]) {
+        i++;
+    }
+    return a.slice(a.length - i);
+}
+/**
+ * Check if a string is only whitespace.
+ */
+function isWhitespace(str) {
+    return /^\s*$/.test(str);
+}
+/**
+ * Deduplicate whitespace in change objects.
+ * This is a simplified version of jsdiff's dedupeWhitespaceInChangeObjects.
+ *
+ * Handles three main scenarios:
+ * 1. Deletion followed by insertion - extract common leading/trailing whitespace
+ * 2. Lone insertion after unchanged - strip duplicate leading whitespace
+ * 3. Lone deletion between unchanged - distribute whitespace properly
+ */
+function dedupeWhitespaceInChangeObjects(changes) {
+    const result = [];
+    for (let i = 0; i < changes.length; i++) {
+        const change = changes[i];
+        // Scenario 1: Deletion followed by insertion
+        if (change.removed && changes[i + 1]?.added) {
+            const deletion = change;
+            const insertion = changes[i + 1];
+            // Find common prefix (must be whitespace)
+            const commonPrefix = longestCommonPrefix(deletion.value, insertion.value);
+            const wsPrefix = commonPrefix.match(/^\s*/)?.[0] || "";
+            // Find common suffix (must be whitespace)
+            const delWithoutPrefix = deletion.value.slice(wsPrefix.length);
+            const insWithoutPrefix = insertion.value.slice(wsPrefix.length);
+            const commonSuffix = longestCommonSuffix(delWithoutPrefix, insWithoutPrefix);
+            const wsSuffix = commonSuffix.match(/\s*$/)?.[0] || "";
+            // Build the cleaned changes
+            if (wsPrefix) {
+                result.push({ value: wsPrefix, count: 1 });
+            }
+            const cleanedDel = deletion.value.slice(wsPrefix.length, deletion.value.length - wsSuffix.length);
+            const cleanedIns = insertion.value.slice(wsPrefix.length, insertion.value.length - wsSuffix.length);
+            if (cleanedDel) {
+                result.push({ value: cleanedDel, removed: true, count: 1 });
+            }
+            if (cleanedIns) {
+                result.push({ value: cleanedIns, added: true, count: 1 });
+            }
+            if (wsSuffix) {
+                result.push({ value: wsSuffix, count: 1 });
+            }
+            i++; // Skip the insertion since we processed it
+            continue;
+        }
+        // Scenario 2: Lone insertion after unchanged text
+        if (change.added && i > 0 && !changes[i - 1].added && !changes[i - 1].removed) {
+            const prev = result[result.length - 1];
+            if (prev && !prev.added && !prev.removed) {
+                // Check for duplicate leading whitespace
+                const leadingWs = change.value.match(/^\s*/)?.[0] || "";
+                const trailingWs = prev.value.match(/\s*$/)?.[0] || "";
+                if (leadingWs && trailingWs) {
+                    const overlap = longestCommonSuffix(trailingWs, leadingWs);
+                    if (overlap) {
+                        // Remove overlap from the insertion
+                        result.push({
+                            value: change.value.slice(overlap.length),
+                            added: true,
+                            count: 1,
+                        });
+                        continue;
+                    }
+                }
+            }
+        }
+        // Scenario 3: Lone deletion between unchanged text
+        if (change.removed &&
+            !changes[i + 1]?.added &&
+            i > 0 &&
+            !changes[i - 1]?.added &&
+            !changes[i - 1]?.removed) {
+            const prev = result[result.length - 1];
+            const next = changes[i + 1];
+            if (prev && next && !next.added && !next.removed) {
+                const leadingWs = change.value.match(/^\s*/)?.[0] || "";
+                const trailingWs = change.value.match(/\s*$/)?.[0] || "";
+                const prevTrailingWs = prev.value.match(/\s*$/)?.[0] || "";
+                const nextLeadingWs = next.value.match(/^\s*/)?.[0] || "";
+                // If deletion starts/ends with whitespace that overlaps with neighbors
+                if (leadingWs && prevTrailingWs) {
+                    const overlap = longestCommonSuffix(prevTrailingWs, leadingWs);
+                    if (overlap.length === leadingWs.length) {
+                        // Leading whitespace is already in prev, strip it
+                        result.push({
+                            value: change.value.slice(leadingWs.length),
+                            removed: true,
+                            count: 1,
+                        });
+                        continue;
+                    }
+                }
+                if (trailingWs && nextLeadingWs) {
+                    const overlap = longestCommonPrefix(trailingWs, nextLeadingWs);
+                    if (overlap.length === trailingWs.length) {
+                        // Trailing whitespace will be in next, strip it
+                        result.push({
+                            value: change.value.slice(0, -trailingWs.length) || change.value,
+                            removed: true,
+                            count: 1,
+                        });
+                        continue;
+                    }
+                }
+            }
+        }
+        // Default: just add the change as-is
+        result.push({ ...change });
+    }
+    return mergeConsecutiveChanges(result);
+}
+/**
+ * Compare two strings line by line.
+ * Similar to Diff.diffLines from the 'diff' package.
+ */
+export function diffLines(oldStr, newStr) {
+    const oldLines = splitLines(oldStr);
+    const newLines = splitLines(newStr);
+    return computeDiff(oldLines, newLines);
+}
+/**
+ * Compare two strings word by word, preserving whitespace.
+ * Similar to Diff.diffWordsWithSpace from the 'diff' package.
+ *
+ * Features matching jsdiff:
+ * - Extended Unicode word character support
+ * - Proper tokenization (words, whitespace runs, single punctuation)
+ * - Whitespace deduplication in consecutive changes
+ */
+export function diffWordsWithSpace(oldStr, newStr) {
+    const oldWords = tokenizeWords(oldStr);
+    const newWords = tokenizeWords(newStr);
+    const diff = computeDiff(oldWords, newWords);
+    return dedupeWhitespaceInChangeObjects(diff);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@deepcitation/deepcitation-js",
-    "version": "1.1.23",
+    "version": "1.1.25",
     "description": "DeepCitation JavaScript SDK for deterministic AI citation verification",
     "type": "module",
     "private": false,
@@ -34,8 +34,7 @@
     "peerDependencies": {
         "react": ">=17.0.0",
         "react-dom": ">=17.0.0",
-        "@radix-ui/react-popover": "^1.0.0",
-        "diff": "^8.0.0"
+        "@radix-ui/react-popover": "^1.0.0"
     },
     "peerDependenciesMeta": {
         "react": {
@@ -46,13 +45,9 @@
         },
         "@radix-ui/react-popover": {
             "optional": true
-        },
-        "diff": {
-            "optional": true
         }
     },
     "devDependencies": {
-        "diff": "^8.0.2",
         "@happy-dom/global-registrator": "^20.0.11",
         "@playwright/experimental-ct-react": "^1.57.0",
         "@playwright/test": "^1.57.0",