@deepcitation/deepcitation-js 1.1.27 → 1.1.29

package/lib/react/UrlCitationComponent.js

@@ -1,224 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { forwardRef, memo, useCallback, useMemo } from "react";
-import { classNames, generateCitationInstanceId, generateCitationKey } from "./utils.js";
-/**
- * Extracts domain from URL for compact display.
- */
-export function extractDomain(url) {
-    try {
-        const urlObj = new URL(url);
-        return urlObj.hostname.replace(/^www\./, "");
-    }
-    catch {
-        // Fallback for invalid URLs
-        return url.replace(/^https?:\/\/(www\.)?/, "").split("/")[0];
-    }
-}
-/**
- * Truncates a string to max length with ellipsis.
- */
-function truncateString(str, maxLength) {
-    if (str.length <= maxLength)
-        return str;
-    return str.slice(0, maxLength - 1) + "…";
-}
-/**
- * Get path from URL for display.
- */
-function getUrlPath(url) {
-    try {
-        const urlObj = new URL(url);
-        const path = urlObj.pathname + urlObj.search;
-        return path === "/" ? "" : path;
-    }
-    catch {
-        return "";
-    }
-}
-/**
- * Status indicator icons for URL fetch states.
- */
-const STATUS_ICONS = {
-    verified: { icon: "✓", label: "Verified", className: "text-green-600 dark:text-green-500" },
-    partial: { icon: "~", label: "Partial match", className: "text-amber-600 dark:text-amber-500" },
-    pending: { icon: "…", label: "Verifying", className: "text-gray-400 dark:text-gray-500" },
-    blocked_antibot: { icon: "🛡", label: "Blocked by anti-bot", className: "text-amber-600 dark:text-amber-500" },
-    blocked_login: { icon: "🔒", label: "Login required", className: "text-amber-600 dark:text-amber-500" },
-    blocked_paywall: { icon: "💳", label: "Paywall", className: "text-amber-600 dark:text-amber-500" },
-    blocked_geo: { icon: "🌍", label: "Geo-restricted", className: "text-amber-600 dark:text-amber-500" },
-    blocked_rate_limit: { icon: "⏱", label: "Rate limited", className: "text-amber-600 dark:text-amber-500" },
-    error_timeout: { icon: "⏰", label: "Timed out", className: "text-red-500 dark:text-red-400" },
-    error_not_found: { icon: "404", label: "Not found", className: "text-red-500 dark:text-red-400" },
-    error_server: { icon: "⚠", label: "Server error", className: "text-red-500 dark:text-red-400" },
-    error_network: { icon: "⚡", label: "Network error", className: "text-red-500 dark:text-red-400" },
-    unknown: { icon: "?", label: "Unknown status", className: "text-gray-400 dark:text-gray-500" },
-};
-/**
- * Checks if status is a blocked status.
- */
-export function isBlockedStatus(status) {
-    return status.startsWith("blocked_");
-}
-/**
- * Checks if status is an error status.
- */
-export function isErrorStatus(status) {
-    return status.startsWith("error_");
-}
-/**
- * Checks if URL was successfully verified.
- */
-export function isVerifiedStatus(status) {
-    return status === "verified" || status === "partial";
-}
-/**
- * Default blocked indicator component.
- */
-const DefaultBlockedIndicator = ({ status, errorMessage }) => {
-    const statusInfo = STATUS_ICONS[status];
-    return (_jsx("span", { className: classNames("inline-flex items-center gap-1", statusInfo.className), title: errorMessage || statusInfo.label, "aria-label": statusInfo.label, children: _jsx("span", { className: "text-[0.9em]", "aria-hidden": "true", children: statusInfo.icon }) }));
-};
-/**
- * Default favicon component.
- */
-const DefaultFavicon = ({ url, faviconUrl }) => {
-    const domain = extractDomain(url);
-    const src = faviconUrl || `https://www.google.com/s2/favicons?domain=${domain}&sz=16`;
-    return (_jsx("img", { src: src, alt: "", className: "w-3.5 h-3.5 rounded-sm", width: 14, height: 14, loading: "lazy", onError: e => {
-            // Hide broken favicon images
-            e.target.style.display = "none";
-        } }));
-};
-/**
- * URL Citation Component
- *
- * Displays a URL citation with compact domain display,
- * verification status, and blocked/error indicators.
- *
- * @example
- * ```tsx
- * <UrlCitationComponent
- *   urlMeta={{
- *     url: "https://example.com/article",
- *     fetchStatus: "verified",
- *   }}
- * />
- * // Renders: [example.com ✓]
- *
- * <UrlCitationComponent
- *   urlMeta={{
- *     url: "https://protected-site.com/page",
- *     fetchStatus: "blocked_login",
- *   }}
- * />
- * // Renders: [protected-site.com 🔒]
- * ```
- */
-export const UrlCitationComponent = forwardRef(({ urlMeta, citation: providedCitation, children, className, variant = "chip", // Default to chip for URLs
-showFullUrlOnHover = true, showFavicon = true, showTitle = false, maxDisplayLength = 30, renderBlockedIndicator, onUrlClick, eventHandlers, preventTooltips = false, }, ref) => {
-    const { url, domain: providedDomain, title, fetchStatus, faviconUrl, errorMessage } = urlMeta;
-    // Derive citation from URL meta if not provided
-    const citation = useMemo(() => providedCitation || {
-        value: url,
-        fullPhrase: title || url,
-    }, [providedCitation, url, title]);
-    const citationKey = useMemo(() => generateCitationKey(citation), [citation]);
-    const citationInstanceId = useMemo(() => generateCitationInstanceId(citationKey), [citationKey]);
-    // Compute display text
-    const domain = useMemo(() => providedDomain || extractDomain(url), [providedDomain, url]);
-    const path = useMemo(() => getUrlPath(url), [url]);
-    const displayText = useMemo(() => {
-        if (showTitle && title) {
-            return truncateString(title, maxDisplayLength);
-        }
-        // Show domain + truncated path
-        const pathPart = path ? truncateString(path, maxDisplayLength - domain.length - 1) : "";
-        return pathPart ? `${domain}${pathPart}` : domain;
-    }, [showTitle, title, domain, path, maxDisplayLength]);
-    const statusInfo = STATUS_ICONS[fetchStatus];
-    const isBlocked = isBlockedStatus(fetchStatus);
-    const isError = isErrorStatus(fetchStatus);
-    const isVerified = fetchStatus === "verified";
-    const isPartial = fetchStatus === "partial";
-    const isPending = fetchStatus === "pending";
-    const handleClick = useCallback((e) => {
-        e.preventDefault();
-        e.stopPropagation();
-        if (onUrlClick) {
-            onUrlClick(url, e);
-        }
-        else {
-            // Default: open URL in new tab
-            window.open(url, "_blank", "noopener,noreferrer");
-        }
-        eventHandlers?.onClick?.(citation, citationKey, e);
-    }, [onUrlClick, url, eventHandlers, citation, citationKey]);
-    const handleMouseEnter = useCallback(() => {
-        eventHandlers?.onMouseEnter?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseLeave = useCallback(() => {
-        eventHandlers?.onMouseLeave?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    const renderStatusIndicator = () => {
-        if (isBlocked || isError) {
-            if (renderBlockedIndicator) {
-                return renderBlockedIndicator(fetchStatus, errorMessage);
-            }
-            return _jsx(DefaultBlockedIndicator, { status: fetchStatus, errorMessage: errorMessage });
-        }
-        if (isVerified) {
-            return (_jsx("span", { className: "text-[0.85em] text-green-600 dark:text-green-500", "aria-hidden": "true", title: "Verified", children: "\u2713" }));
-        }
-        if (isPartial) {
-            return (_jsx("span", { className: "text-[0.85em] text-amber-600 dark:text-amber-500", "aria-hidden": "true", title: "Partial match", children: "~" }));
-        }
-        if (isPending) {
-            return (_jsx("span", { className: "opacity-70", "aria-hidden": "true", children: "\u2026" }));
-        }
-        return null;
-    };
-    // Choose variant-specific rendering
-    if (variant === "chip") {
-        return (_jsxs(_Fragment, { children: [children, _jsxs("span", { ref: ref, "data-citation-id": citationKey, "data-citation-instance": citationInstanceId, "data-url": url, "data-fetch-status": fetchStatus, "data-variant": "chip", className: classNames("inline-flex items-center gap-1 px-2 py-0.5 rounded-full text-sm cursor-pointer transition-colors no-underline", "bg-blue-100 dark:bg-blue-900/30", statusInfo.className, className), title: showFullUrlOnHover ? url : undefined, onMouseEnter: preventTooltips ? undefined : handleMouseEnter, onMouseLeave: preventTooltips ? undefined : handleMouseLeave, onMouseDown: handleClick, onClick: e => e.stopPropagation(), role: "link", "aria-label": `Link to ${domain}: ${statusInfo.label}`, children: [showFavicon && _jsx(DefaultFavicon, { url: url, faviconUrl: faviconUrl }), _jsx("span", { className: "max-w-[200px] overflow-hidden text-ellipsis whitespace-nowrap", children: displayText }), renderStatusIndicator()] })] }));
-    }
-    // Inline variant
-    if (variant === "inline") {
-        return (_jsxs(_Fragment, { children: [children, _jsxs("a", { ref: ref, href: url, "data-citation-id": citationKey, "data-citation-instance": citationInstanceId, "data-fetch-status": fetchStatus, "data-variant": "inline", className: classNames("inline-flex items-center gap-1 cursor-pointer transition-colors no-underline border-b border-dotted border-current", statusInfo.className, className), title: showFullUrlOnHover ? url : undefined, onMouseEnter: preventTooltips ? undefined : handleMouseEnter, onMouseLeave: preventTooltips ? undefined : handleMouseLeave, onClick: e => {
-                        e.preventDefault();
-                        handleClick(e);
-                    }, target: "_blank", rel: "noopener noreferrer", "aria-label": `Link to ${domain}: ${statusInfo.label}`, children: [showFavicon && _jsx(DefaultFavicon, { url: url, faviconUrl: faviconUrl }), _jsx("span", { children: displayText }), renderStatusIndicator()] })] }));
-    }
-    // Bracket variant (default for non-URL citations)
-    return (_jsxs(_Fragment, { children: [children, _jsxs("span", { ref: ref, "data-citation-id": citationKey, "data-citation-instance": citationInstanceId, "data-url": url, "data-fetch-status": fetchStatus, "data-variant": "bracket", className: classNames("cursor-pointer transition-colors", statusInfo.className, className), title: showFullUrlOnHover ? url : undefined, onMouseEnter: preventTooltips ? undefined : handleMouseEnter, onMouseLeave: preventTooltips ? undefined : handleMouseLeave, onMouseDown: handleClick, onClick: e => e.stopPropagation(), role: "link", "aria-label": `Link to ${domain}: ${statusInfo.label}`, children: ["[", showFavicon && _jsx(DefaultFavicon, { url: url, faviconUrl: faviconUrl }), _jsx("span", { className: "max-w-[200px] overflow-hidden text-ellipsis whitespace-nowrap", children: displayText }), renderStatusIndicator(), "]"] })] }));
-});
-UrlCitationComponent.displayName = "UrlCitationComponent";
-/**
- * Memoized version for performance.
- */
-export const MemoizedUrlCitationComponent = memo(UrlCitationComponent);
-/**
- * Hook to parse URL and create UrlCitationMeta.
- */
-export function useUrlMeta(url, fetchStatus = "unknown", additionalMeta) {
-    return useMemo(() => ({
-        url,
-        domain: extractDomain(url),
-        fetchStatus,
-        ...additionalMeta,
-    }), [url, fetchStatus, additionalMeta]);
-}
-/**
- * Compact URL display utilities.
- */
-export const urlDisplayUtils = {
-    extractDomain,
-    truncateString,
-    getUrlPath,
-    isBlockedStatus,
-    isErrorStatus,
-    isVerifiedStatus,
-};
-/**
- * Status configuration for custom styling.
- */
-export { STATUS_ICONS };

package/lib/react/VerificationTabs.d.ts

@@ -1,10 +0,0 @@
-import React from "react";
-interface VerificationTabsProps {
-    expected: string;
-    actual: string;
-    label?: string;
-    renderCopyButton?: (text: string, position: "expected" | "found") => React.ReactNode;
-    emptyText?: string;
-}
-export declare const VerificationTabs: React.FC<VerificationTabsProps>;
-export {};

package/lib/react/VerificationTabs.js

@@ -1,36 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useEffect, useState } from "react";
-import { useSmartDiff } from "./useSmartDiff.js";
-import { classNames } from "./utils.js";
-import { CheckIcon } from "./icons.js";
-// Sub-component: The individual tab button
-const TabButton = ({ isActive, onClick, label }) => (_jsx("button", { onClick: e => {
-        e.stopPropagation(); // Prevent tooltip from closing or dragging
-        onClick();
-    }, className: classNames("dc-tab-button", isActive ? "dc-tab-button--active" : ""), type: "button", children: label }));
-export const VerificationTabs = ({ expected, actual, label, renderCopyButton, emptyText = "No text found", }) => {
-    const { diffResult, isHighVariance, hasDiff } = useSmartDiff(expected, actual);
-    const [activeTab, setActiveTab] = useState("diff");
-    useEffect(() => {
-        if (isHighVariance) {
-            setActiveTab("found");
-        }
-        else {
-            setActiveTab("diff");
-        }
-    }, [isHighVariance, expected, actual]);
-    const renderFoundContent = () => (_jsx("div", { className: "dc-tab-content dc-tab-content--found", children: actual ? (_jsxs("div", { className: "dc-tab-text-wrapper", children: [renderCopyButton && _jsx("div", { className: "dc-copy-button-wrapper", children: renderCopyButton(actual, "found") }), _jsx("div", { className: "dc-tab-text", children: actual })] })) : (_jsx("span", { className: "dc-tab-empty", children: emptyText })) }));
-    const isExactMatch = !hasDiff && Boolean(actual) && Boolean(expected);
-    if (isExactMatch) {
-        return (_jsxs("div", { className: "dc-verification-tabs dc-verification-tabs--exact", children: [label && _jsx("div", { className: "dc-verification-label", children: label }), _jsxs("div", { className: "dc-exact-match-badge", children: [_jsx(CheckIcon, {}), _jsx("span", { children: "Exact match" })] }), _jsx("div", { className: "dc-exact-match-content", children: renderFoundContent() })] }));
-    }
-    return (_jsxs("div", { className: "dc-verification-tabs", children: [label && _jsx("div", { className: "dc-verification-label", children: label }), _jsx("div", { className: "dc-tabs-container", children: _jsxs("div", { className: "dc-tabs-nav", children: [_jsx(TabButton, { label: "Expected", isActive: activeTab === "expected", onClick: () => setActiveTab("expected") }), _jsx(TabButton, { label: "Diff", isActive: activeTab === "diff", onClick: () => setActiveTab("diff") }), _jsx(TabButton, { label: "Found", isActive: activeTab === "found", onClick: () => setActiveTab("found") })] }) }), _jsxs("div", { className: "dc-tabs-content", children: [activeTab === "found" && renderFoundContent(), activeTab === "expected" && (_jsx("div", { className: "dc-tab-content dc-tab-content--expected", children: _jsxs("div", { className: "dc-tab-text-wrapper", children: [renderCopyButton && (_jsx("div", { className: "dc-copy-button-wrapper", children: renderCopyButton(expected, "expected") })), _jsx("div", { className: "dc-tab-text", children: expected })] }) })), activeTab === "diff" && (_jsx("div", { className: "dc-tab-content dc-tab-content--diff", children: !hasDiff ? (_jsxs("div", { className: "dc-exact-match-indicator", children: [_jsx(CheckIcon, {}), _jsx("span", { children: "Exact Match" })] })) : (_jsx("div", { className: "dc-diff-result", children: diffResult.map((block, i) => (_jsx("div", { className: classNames("dc-diff-block", block.type === "added" ? "dc-diff-block--added" : "", block.type === "removed" ? "dc-diff-block--removed" : ""), children: block.parts.map((part, j) => {
-                                    if (part.removed) {
-                                        return (_jsx("span", { className: "dc-diff-part dc-diff-part--removed", title: "Expected but not found", children: part.value }, j));
-                                    }
-                                    if (part.added) {
-                                        return (_jsx("span", { className: "dc-diff-part dc-diff-part--added", title: "Actually found in source", children: part.value }, j));
-                                    }
-                                    return (_jsx("span", { className: "dc-diff-part dc-diff-part--unchanged", children: part.value }, j));
-                                }) }, i))) })) }))] })] }));
-};

package/lib/react/icons.d.ts

@@ -1,22 +0,0 @@
-/**
- * DeepCitation icon SVG (no dependencies)
- */
-export declare const DeepCitationIcon: ({ className }: {
-    className?: string;
-}) => import("react/jsx-runtime").JSX.Element;
-/**
- * Check icon SVG (no dependencies)
- */
-export declare const CheckIcon: ({ className }: {
-    className?: string;
-}) => import("react/jsx-runtime").JSX.Element;
-/**
- * Warning icon SVG (no dependencies)
- */
-export declare const WarningIcon: ({ className }: {
-    className?: string;
-}) => 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,16 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { cn } from "./utils.js";
-/**
- * DeepCitation icon SVG (no dependencies)
- */
-export const DeepCitationIcon = ({ className }) => (_jsxs("svg", { xmlns: "http://www.w3.org/2000/svg", width: "24", height: "24", viewBox: "0 0 24 24", fill: "none", stroke: "currentColor", strokeWidth: "2", strokeLinecap: "square", shapeRendering: "crispEdges", className: className, children: [_jsx("path", { d: "M7 3 L3 3 L3 21 L7 21" }), _jsx("path", { d: "M17 3 L21 3 L21 21 L17 21" })] }));
-/**
- * Check icon SVG (no dependencies)
- */
-export const CheckIcon = ({ className }) => (_jsx("svg", { className: cn("w-[0.7em] h-[0.7em]", className), viewBox: "0 0 256 256", fill: "currentColor", "aria-hidden": "true", children: _jsx("path", { d: "M229.66,66.34 L96,200 L34.34,138.34 L51,121.66 L96,166.69 L213,50 Z", stroke: "currentColor", strokeWidth: "12" }) }));
-/**
- * Warning icon SVG (no dependencies)
- */
-export const WarningIcon = ({ className }) => (_jsx("svg", { className: cn("w-[0.7em] h-[0.7em]", className), 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("w-[0.7em] h-[0.7em] animate-spin", className), xmlns: "http://www.w3.org/2000/svg", fill: "none", viewBox: "0 0 24 24", 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/primitives.d.ts

@@ -1,99 +0,0 @@
-/**
- * Citation Primitives - Composable building blocks for citation components
- * @packageDocumentation
- */
-import React, { type ReactNode, type HTMLAttributes, type MouseEvent, type TouchEvent } from "react";
-import type { Citation as CitationType, CitationStatus } from "../types/citation.js";
-import type { Verification } from "../types/verification.js";
-interface CitationContextValue {
-    citation: CitationType;
-    citationKey: string;
-    citationInstanceId: string;
-    status: CitationStatus;
-    verification: Verification | null;
-    config: {
-        fallbackDisplay: string | null;
-        pendingContent: ReactNode;
-    };
-}
-/** Access citation context. Must be used within Citation.Root. */
-export declare function useCitationContext(): CitationContextValue;
-/** Safely access citation context (returns null if not in context). */
-export declare function useCitationContextSafe(): CitationContextValue | null;
-export interface CitationRootProps {
-    citation: CitationType;
-    verification?: Verification | null;
-    children: ReactNode;
-    fallbackDisplay?: string | null;
-    pendingContent?: ReactNode;
-}
-/** Root component that provides citation context to all child primitives. */
-export declare const CitationRoot: React.ForwardRefExoticComponent<CitationRootProps & React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
-export interface CitationTriggerProps extends HTMLAttributes<HTMLSpanElement> {
-    onCitationClick?: (citation: CitationType, citationKey: string, event: MouseEvent) => void;
-    onCitationMouseEnter?: (citation: CitationType, citationKey: string) => void;
-    onCitationMouseLeave?: (citation: CitationType, citationKey: string) => void;
-    onCitationTouchEnd?: (citation: CitationType, citationKey: string, event: TouchEvent) => void;
-    isMobile?: boolean;
-    disableHover?: boolean;
-}
-/** Interactive trigger component for the citation. */
-export declare const CitationTrigger: React.ForwardRefExoticComponent<CitationTriggerProps & React.RefAttributes<HTMLSpanElement>>;
-export interface CitationBracketProps extends HTMLAttributes<HTMLSpanElement> {
-    open?: string;
-    close?: string;
-}
-/** Bracket wrapper component for citation content. */
-export declare const CitationBracket: React.ForwardRefExoticComponent<CitationBracketProps & React.RefAttributes<HTMLSpanElement>>;
-export interface CitationNumberProps extends HTMLAttributes<HTMLSpanElement> {
-    number?: string | number;
-}
-/** Displays the citation number. */
-export declare const CitationNumber: React.ForwardRefExoticComponent<CitationNumberProps & React.RefAttributes<HTMLSpanElement>>;
-export interface CitationKeySpanProps extends HTMLAttributes<HTMLSpanElement> {
-    keySpan?: string;
-    separator?: string;
-}
-/** 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;
-    missIndicator?: ReactNode;
-    pendingIndicator?: ReactNode;
-    showFor?: Array<"verified" | "partial" | "miss" | "pending">;
-}
-/** Displays a status indicator based on citation verification state. */
-export declare const CitationIndicator: React.ForwardRefExoticComponent<CitationIndicatorProps & React.RefAttributes<HTMLSpanElement>>;
-export interface CitationStatusProps {
-    children: (status: CitationStatus) => ReactNode;
-}
-/** Render prop component for accessing citation status. */
-export declare function CitationStatusComponent({ children }: CitationStatusProps): import("react/jsx-runtime").JSX.Element;
-export declare namespace CitationStatusComponent {
-    var displayName: string;
-}
-export interface CitationPhraseProps extends HTMLAttributes<HTMLSpanElement> {
-    maxLength?: number;
-    truncationSuffix?: string;
-}
-/** Displays the citation's full phrase with optional truncation. */
-export declare const CitationPhrase: React.ForwardRefExoticComponent<CitationPhraseProps & React.RefAttributes<HTMLSpanElement>>;
-export interface CitationPageProps extends HTMLAttributes<HTMLSpanElement> {
-    prefix?: string;
-}
-/** Displays the citation's page number. */
-export declare const CitationPage: React.ForwardRefExoticComponent<CitationPageProps & React.RefAttributes<HTMLSpanElement>>;
-/** Citation primitives namespace for composable citation components. */
-export declare const Citation: {
-    readonly Root: React.ForwardRefExoticComponent<CitationRootProps & React.HTMLAttributes<HTMLSpanElement> & React.RefAttributes<HTMLSpanElement>>;
-    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 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>>;
-    readonly Page: React.ForwardRefExoticComponent<CitationPageProps & React.RefAttributes<HTMLSpanElement>>;
-};
-export {};

package/lib/react/primitives.js

@@ -1,187 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-/**
- * Citation Primitives - Composable building blocks for citation components
- * @packageDocumentation
- */
-import { createContext, useContext, useMemo, useCallback, forwardRef, } from "react";
-import { getCitationStatus } from "../parsing/parseCitation.js";
-import { generateCitationKey, generateCitationInstanceId, classNames, } from "./utils.js";
-const CitationContext = createContext(null);
-/** Access citation context. Must be used within Citation.Root. */
-export function useCitationContext() {
-    const context = useContext(CitationContext);
-    if (!context) {
-        throw new Error("Citation components must be used within a Citation.Root");
-    }
-    return context;
-}
-/** Safely access citation context (returns null if not in context). */
-export function useCitationContextSafe() {
-    return useContext(CitationContext);
-}
-/** Root component that provides citation context to all child primitives. */
-export const CitationRoot = forwardRef(({ citation, verification = null, children, fallbackDisplay = null, pendingContent = "..", className, ...props }, ref) => {
-    const citationKey = useMemo(() => generateCitationKey(citation), [citation]);
-    const citationInstanceId = useMemo(() => generateCitationInstanceId(citationKey), [citationKey]);
-    const status = getCitationStatus(verification);
-    const contextValue = useMemo(() => ({
-        citation,
-        citationKey,
-        citationInstanceId,
-        status,
-        verification,
-        config: {
-            fallbackDisplay,
-            pendingContent,
-        },
-    }), [
-        citation,
-        citationKey,
-        citationInstanceId,
-        status,
-        verification,
-        fallbackDisplay,
-        pendingContent,
-    ]);
-    return (_jsx(CitationContext.Provider, { value: contextValue, children: _jsx("span", { ref: ref, "data-citation-id": citationKey, "data-citation-instance": citationInstanceId, className: classNames("inline", className), ...props, children: children }) }));
-});
-CitationRoot.displayName = "Citation.Root";
-/** Interactive trigger component for the citation. */
-export const CitationTrigger = forwardRef(({ children, className, onCitationClick, onCitationMouseEnter, onCitationMouseLeave, onCitationTouchEnd, isMobile = false, disableHover = false, onClick, onMouseEnter, onMouseLeave, onMouseDown, onTouchEnd, ...props }, ref) => {
-    const { citation, citationKey, status } = useCitationContext();
-    const handleClick = useCallback((e) => {
-        e.stopPropagation();
-        onClick?.(e);
-    }, [onClick]);
-    const handleMouseDown = useCallback((e) => {
-        e.preventDefault();
-        e.stopPropagation();
-        onMouseDown?.(e);
-        onCitationClick?.(citation, citationKey, e);
-    }, [onMouseDown, onCitationClick, citation, citationKey]);
-    const handleMouseEnter = useCallback((e) => {
-        onMouseEnter?.(e);
-        if (!disableHover) {
-            onCitationMouseEnter?.(citation, citationKey);
-        }
-    }, [onMouseEnter, disableHover, onCitationMouseEnter, citation, citationKey]);
-    const handleMouseLeave = useCallback((e) => {
-        onMouseLeave?.(e);
-        if (!disableHover) {
-            onCitationMouseLeave?.(citation, citationKey);
-        }
-    }, [onMouseLeave, disableHover, onCitationMouseLeave, citation, citationKey]);
-    const handleTouchEnd = useCallback((e) => {
-        onTouchEnd?.(e);
-        if (isMobile) {
-            e.preventDefault();
-            e.stopPropagation();
-            onCitationTouchEnd?.(citation, citationKey, e);
-        }
-    }, [onTouchEnd, isMobile, onCitationTouchEnd, citation, citationKey]);
-    const statusClasses = classNames(status.isVerified &&
-        !status.isPartialMatch &&
-        "text-green-600 dark:text-green-500", status.isPartialMatch && "text-amber-600 dark:text-amber-500", status.isMiss && "text-red-500 dark:text-red-400 line-through", status.isPending && "text-gray-400 dark:text-gray-500");
-    return (_jsx("span", { ref: ref, role: "button", tabIndex: 0, className: classNames("cursor-pointer transition-colors focus-visible:outline-2 focus-visible:outline-blue-500 focus-visible:outline-offset-2 focus-visible:rounded-sm", statusClasses, className), onClick: handleClick, onMouseDown: handleMouseDown, onMouseEnter: handleMouseEnter, onMouseLeave: handleMouseLeave, onTouchEndCapture: isMobile ? handleTouchEnd : undefined, ...props, children: children }));
-});
-CitationTrigger.displayName = "Citation.Trigger";
-/** Bracket wrapper component for citation content. */
-export const CitationBracket = forwardRef(({ children, className, open = "[", close = "]", ...props }, ref) => {
-    return (_jsxs("span", { ref: ref, className: classNames("inline", className), "aria-hidden": "true", ...props, children: [_jsx("span", { className: "inline", children: open }), _jsx("span", { className: "inline", children: children }), _jsx("span", { className: "inline", children: close })] }));
-});
-CitationBracket.displayName = "Citation.Bracket";
-/** Displays the citation number. */
-export const CitationNumber = forwardRef(({ className, number, ...props }, ref) => {
-    const { citation, config, status } = useCitationContext();
-    const displayNumber = useMemo(() => {
-        if (number !== undefined)
-            return String(number);
-        return (citation.keySpan?.toString() ||
-            citation.citationNumber?.toString() ||
-            config.fallbackDisplay ||
-            "1");
-    }, [number, citation, config]);
-    if (status.isPending) {
-        return (_jsx("span", { ref: ref, className: classNames("font-medium opacity-60", className), ...props, children: config.pendingContent }));
-    }
-    return (_jsx("span", { ref: ref, className: classNames("font-medium", className), ...props, children: displayNumber }));
-});
-CitationNumber.displayName = "Citation.Number";
-/** Displays the citation keySpan (summary text). */
-export const CitationKeySpan = forwardRef(({ className, keySpan, separator = " ", ...props }, ref) => {
-    const { citation } = useCitationContext();
-    const displayKeySpan = useMemo(() => {
-        if (keySpan !== undefined)
-            return keySpan;
-        return citation.keySpan?.toString() || "";
-    }, [keySpan, citation]);
-    if (!displayKeySpan)
-        return null;
-    return (_jsxs("span", { ref: ref, className: classNames("italic", className), ...props, children: [displayKeySpan, separator] }));
-});
-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();
-    const shouldShow = useCallback((state) => {
-        if (!showFor)
-            return true;
-        return showFor.includes(state);
-    }, [showFor]);
-    const baseClasses = "inline ml-0.5 text-[0.85em]";
-    if (status.isPartialMatch && shouldShow("partial")) {
-        return (_jsx("span", { ref: ref, className: classNames(baseClasses, "text-amber-600 dark:text-amber-500", className), "aria-label": "Partial match", ...props, children: partialIndicator }));
-    }
-    if (status.isVerified && !status.isPartialMatch && shouldShow("verified")) {
-        return (_jsx("span", { ref: ref, className: classNames(baseClasses, "text-green-600 dark:text-green-500", className), "aria-label": "Verified", ...props, children: verifiedIndicator }));
-    }
-    if (status.isMiss && shouldShow("miss") && missIndicator) {
-        return (_jsx("span", { ref: ref, className: classNames(baseClasses, "text-red-500 dark:text-red-400", className), "aria-label": "Not found", ...props, children: missIndicator }));
-    }
-    if (status.isPending && shouldShow("pending") && pendingIndicator) {
-        return (_jsx("span", { ref: ref, className: classNames(baseClasses, "text-gray-400 dark:text-gray-500", className), "aria-label": "Pending", ...props, children: pendingIndicator }));
-    }
-    return null;
-});
-CitationIndicator.displayName = "Citation.Indicator";
-/** Render prop component for accessing citation status. */
-export function CitationStatusComponent({ children }) {
-    const { status } = useCitationContext();
-    return _jsx(_Fragment, { children: children(status) });
-}
-CitationStatusComponent.displayName = "Citation.Status";
-/** Displays the citation's full phrase with optional truncation. */
-export const CitationPhrase = forwardRef(({ className, maxLength, truncationSuffix = "...", ...props }, ref) => {
-    const { citation } = useCitationContext();
-    const displayPhrase = useMemo(() => {
-        const phrase = citation.fullPhrase || "";
-        if (!maxLength || phrase.length <= maxLength)
-            return phrase;
-        return phrase.slice(0, maxLength) + truncationSuffix;
-    }, [citation.fullPhrase, maxLength, truncationSuffix]);
-    if (!displayPhrase)
-        return null;
-    return (_jsx("span", { ref: ref, className: classNames("italic", className), ...props, children: displayPhrase }));
-});
-CitationPhrase.displayName = "Citation.Phrase";
-/** Displays the citation's page number. */
-export const CitationPage = forwardRef(({ className, prefix = "", ...props }, ref) => {
-    const { citation } = useCitationContext();
-    if (citation.pageNumber === undefined || citation.pageNumber === null) {
-        return null;
-    }
-    return (_jsxs("span", { ref: ref, className: classNames("text-xs text-gray-400 dark:text-gray-500", className), ...props, children: [prefix, citation.pageNumber] }));
-});
-CitationPage.displayName = "Citation.Page";
-/** Citation primitives namespace for composable citation components. */
-export const Citation = {
-    Root: CitationRoot,
-    Trigger: CitationTrigger,
-    Bracket: CitationBracket,
-    Number: CitationNumber,
-    KeySpan: CitationKeySpan,
-    Indicator: CitationIndicator,
-    Status: CitationStatusComponent,
-    Phrase: CitationPhrase,
-    Page: CitationPage,
-};

package/lib/react/types.js

@@ -1 +0,0 @@
-export {};

package/lib/react/useSmartDiff.d.ts

@@ -1,16 +0,0 @@
-export type DiffBlockType = "modified" | "added" | "removed" | "unchanged";
-export interface DiffPart {
-    value: string;
-    added?: boolean;
-    removed?: boolean;
-}
-export interface DiffBlock {
-    type: DiffBlockType;
-    parts: DiffPart[];
-}
-export declare const useSmartDiff: (expected?: string, actual?: string) => {
-    diffResult: DiffBlock[];
-    hasDiff: boolean;
-    similarity: number;
-    isHighVariance: boolean;
-};