@deepcitation/deepcitation-js 1.1.27 → 1.1.29

package/lib/react/CitationVariants.js

@@ -1,277 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
-import { memo, useMemo, useCallback, forwardRef, } from "react";
-import { getCitationStatus } from "../parsing/parseCitation.js";
-import { generateCitationKey, generateCitationInstanceId, getCitationDisplayText, getCitationNumber, classNames, } from "./utils.js";
-const TWO_DOTS_THINKING_CONTENT = "..";
-/**
- * Hook to get common citation data.
- * NOTE: Status is not memoized because verification may be mutated in place.
- */
-function useCitationData(citation, verification) {
-    const citationKey = useMemo(() => generateCitationKey(citation), [citation]);
-    const citationInstanceId = useMemo(() => generateCitationInstanceId(citationKey), [citationKey]);
-    // Don't memoize - object reference as dependency causes stale values on mutation
-    const status = getCitationStatus(verification ?? null);
-    return { citationKey, citationInstanceId, status };
-}
-/**
- * Default verified indicator (checkmark)
- */
-const DefaultVerifiedIndicator = () => (_jsx("span", { className: "text-green-600 dark:text-green-500 ml-0.5", "aria-hidden": "true", children: "\u2713" }));
-/**
- * Default partial match indicator (asterisk)
- */
-const DefaultPartialIndicator = () => (_jsx("span", { className: "text-amber-600 dark:text-amber-500 ml-0.5", "aria-hidden": "true", children: "*" }));
-/**
- * Chip/Badge style citation component.
- * Displays citation as a rounded pill/badge.
- *
- * @example
- * ```tsx
- * <ChipCitation citation={citation} verification={found} size="md" />
- * ```
- */
-export const ChipCitation = forwardRef(({ citation, children, className, fallbackDisplay, verification, eventHandlers, isMobile = false, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), size = "md", showIcon = false, icon, }, ref) => {
-    const { citationKey, citationInstanceId, status } = useCitationData(citation, verification);
-    const { isVerified, isMiss, isPartialMatch, isPending } = status;
-    // ChipCitation shows keySpan by default
-    const displayText = useMemo(() => getCitationDisplayText(citation, { fallbackDisplay }), [citation, fallbackDisplay]);
-    const handleClick = useCallback((e) => {
-        e.preventDefault();
-        e.stopPropagation();
-        eventHandlers?.onClick?.(citation, citationKey, e);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseEnter = useCallback(() => {
-        eventHandlers?.onMouseEnter?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseLeave = useCallback(() => {
-        eventHandlers?.onMouseLeave?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    const sizeClasses = {
-        sm: "text-xs px-1.5 py-px",
-        md: "text-sm px-2 py-0.5",
-        lg: "text-base px-3 py-1",
-    };
-    // Check partial first since isVerified is true when isPartialMatch is true
-    const statusClass = isPartialMatch
-        ? "bg-amber-100 text-amber-600 dark:bg-amber-900/30 dark:text-amber-500"
-        : isMiss
-            ? "bg-red-100 text-red-600 dark:bg-red-900/30 dark:text-red-400 line-through"
-            : isVerified
-                ? "bg-green-100 text-green-600 dark:bg-green-900/30 dark:text-green-500"
-                : isPending
-                    ? "bg-gray-100 text-gray-500 dark:bg-gray-800 dark:text-gray-400"
-                    : "bg-blue-100 text-blue-600 dark:bg-blue-900/30 dark:text-blue-400";
-    return (_jsxs(_Fragment, { children: [children, _jsxs("span", { ref: ref, "data-citation-id": citationKey, "data-citation-instance": citationInstanceId, "data-variant": "chip", className: classNames("inline-flex items-center gap-1 rounded-full font-medium cursor-pointer transition-colors hover:brightness-95", sizeClasses[size], statusClass, className), onMouseEnter: preventTooltips ? undefined : handleMouseEnter, onMouseLeave: preventTooltips ? undefined : handleMouseLeave, onMouseDown: handleClick, onClick: (e) => e.stopPropagation(), "aria-label": displayText ? `Citation: ${displayText}` : undefined, children: [showIcon &&
-                        (icon || _jsx("span", { className: "text-[0.9em]", children: "\uD83D\uDCC4" })), _jsx("span", { className: "font-medium", children: displayText }), isPartialMatch && renderPartialIndicator(status), isVerified && !isPartialMatch && renderVerifiedIndicator(status), isPending && (_jsx("span", { className: "opacity-70", children: pendingContent }))] })] }));
-});
-ChipCitation.displayName = "ChipCitation";
-/**
- * Superscript style citation component.
- * Displays citation as a superscript number like academic papers.
- *
- * @example
- * ```tsx
- * <SuperscriptCitation citation={citation} verification={found} />
- * // Renders: Text content¹
- * ```
- */
-export const SuperscriptCitation = forwardRef(({ citation, children, className, fallbackDisplay, verification, eventHandlers, isMobile = false, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), hideBrackets = false, }, ref) => {
-    const { citationKey, citationInstanceId, status } = useCitationData(citation, verification);
-    const { isVerified, isMiss, isPartialMatch, isPending } = status;
-    // SuperscriptCitation shows number by default
-    const displayText = useMemo(() => getCitationNumber(citation), [citation]);
-    const handleClick = useCallback((e) => {
-        e.preventDefault();
-        e.stopPropagation();
-        eventHandlers?.onClick?.(citation, citationKey, e);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseEnter = useCallback(() => {
-        eventHandlers?.onMouseEnter?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseLeave = useCallback(() => {
-        eventHandlers?.onMouseLeave?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    // Check partial first since isVerified is true when isPartialMatch is true
-    const statusClass = isPartialMatch
-        ? "text-amber-600 dark:text-amber-500"
-        : isMiss
-            ? "text-red-500 dark:text-red-400 line-through"
-            : isVerified
-                ? "text-green-600 dark:text-green-500"
-                : isPending
-                    ? "text-gray-400 dark:text-gray-500"
-                    : "text-blue-600 dark:text-blue-400";
-    return (_jsxs(_Fragment, { children: [children, _jsxs("sup", { ref: ref, "data-citation-id": citationKey, "data-citation-instance": citationInstanceId, "data-variant": "superscript", className: classNames("text-xs cursor-pointer font-medium transition-colors hover:underline", statusClass, className), onMouseEnter: preventTooltips ? undefined : handleMouseEnter, onMouseLeave: preventTooltips ? undefined : handleMouseLeave, onMouseDown: handleClick, onClick: (e) => e.stopPropagation(), "aria-label": `Citation ${displayText}`, children: [!hideBrackets && "[", displayText, isPartialMatch && renderPartialIndicator(status), isVerified && !isPartialMatch && renderVerifiedIndicator(status), isPending && pendingContent, !hideBrackets && "]"] })] }));
-});
-SuperscriptCitation.displayName = "SuperscriptCitation";
-const FOOTNOTE_SYMBOLS = ["*", "†", "‡", "§", "‖", "¶"];
-/**
- * Footnote style citation component.
- * Displays citation as a footnote marker.
- *
- * @example
- * ```tsx
- * <FootnoteCitation citation={citation} symbolStyle="asterisk" />
- * // Renders: Text content*
- * ```
- */
-export const FootnoteCitation = forwardRef(({ citation, children, className, fallbackDisplay, verification, eventHandlers, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), symbolStyle = "number", customSymbol, }, ref) => {
-    const { citationKey, citationInstanceId, status } = useCitationData(citation, verification);
-    const { isVerified, isMiss, isPartialMatch, isPending } = status;
-    const displaySymbol = useMemo(() => {
-        if (symbolStyle === "custom" && customSymbol)
-            return customSymbol;
-        if (symbolStyle === "number")
-            return citation.citationNumber?.toString() || "1";
-        if (symbolStyle === "asterisk")
-            return "*";
-        if (symbolStyle === "dagger") {
-            const num = (citation.citationNumber || 1) - 1;
-            return FOOTNOTE_SYMBOLS[num % FOOTNOTE_SYMBOLS.length];
-        }
-        return "*";
-    }, [symbolStyle, customSymbol, citation.citationNumber]);
-    const handleClick = useCallback((e) => {
-        e.preventDefault();
-        e.stopPropagation();
-        eventHandlers?.onClick?.(citation, citationKey, e);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseEnter = useCallback(() => {
-        eventHandlers?.onMouseEnter?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseLeave = useCallback(() => {
-        eventHandlers?.onMouseLeave?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    // Check partial first since isVerified is true when isPartialMatch is true
-    const statusClass = isPartialMatch
-        ? "text-amber-600 dark:text-amber-500"
-        : isMiss
-            ? "text-red-500 dark:text-red-400 line-through"
-            : isVerified
-                ? "text-green-600 dark:text-green-500"
-                : isPending
-                    ? "text-gray-400 dark:text-gray-500"
-                    : "text-gray-500 hover:text-blue-600 dark:text-gray-400 dark:hover:text-blue-400";
-    return (_jsxs(_Fragment, { children: [children, _jsxs("sup", { ref: ref, "data-citation-id": citationKey, "data-citation-instance": citationInstanceId, "data-variant": "footnote", className: classNames("text-xs cursor-pointer font-normal transition-colors", statusClass, className), onMouseEnter: preventTooltips ? undefined : handleMouseEnter, onMouseLeave: preventTooltips ? undefined : handleMouseLeave, onMouseDown: handleClick, onClick: (e) => e.stopPropagation(), "aria-label": `Footnote ${displaySymbol}`, children: [displaySymbol, isPartialMatch && renderPartialIndicator(status), isVerified && !isPartialMatch && renderVerifiedIndicator(status), isPending && pendingContent] })] }));
-});
-FootnoteCitation.displayName = "FootnoteCitation";
-/**
- * Inline style citation component.
- * Displays citation inline with subtle underline decoration.
- *
- * @example
- * ```tsx
- * <InlineCitation citation={citation} underlineStyle="dotted" />
- * // Renders: "quoted text" with subtle underline
- * ```
- */
-export const InlineCitation = forwardRef(({ citation, children, className, fallbackDisplay, verification, eventHandlers, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), underlineStyle = "dotted", }, ref) => {
-    const { citationKey, citationInstanceId, status } = useCitationData(citation, verification);
-    const { isVerified, isMiss, isPartialMatch, isPending } = status;
-    // InlineCitation shows keySpan by default
-    const displayText = useMemo(() => getCitationDisplayText(citation, { fallbackDisplay }), [citation, fallbackDisplay]);
-    const handleClick = useCallback((e) => {
-        e.preventDefault();
-        e.stopPropagation();
-        eventHandlers?.onClick?.(citation, citationKey, e);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseEnter = useCallback(() => {
-        eventHandlers?.onMouseEnter?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseLeave = useCallback(() => {
-        eventHandlers?.onMouseLeave?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    // Check partial first since isVerified is true when isPartialMatch is true
-    const statusClass = isPartialMatch
-        ? "text-amber-600 dark:text-amber-500"
-        : isMiss
-            ? "text-red-500 dark:text-red-400 line-through"
-            : isVerified
-                ? "text-green-600 dark:text-green-500"
-                : isPending
-                    ? "text-gray-400 dark:text-gray-500"
-                    : "";
-    const underlineClasses = {
-        solid: "border-b border-current",
-        dotted: "border-b border-dotted border-current",
-        dashed: "border-b border-dashed border-current",
-        none: "",
-    };
-    return (_jsxs(_Fragment, { children: [children, _jsxs("span", { ref: ref, "data-citation-id": citationKey, "data-citation-instance": citationInstanceId, "data-variant": "inline", className: classNames("cursor-pointer transition-colors hover:bg-blue-500/5", underlineClasses[underlineStyle], statusClass, className), onMouseEnter: preventTooltips ? undefined : handleMouseEnter, onMouseLeave: preventTooltips ? undefined : handleMouseLeave, onMouseDown: handleClick, onClick: (e) => e.stopPropagation(), "aria-label": `Citation: ${displayText}`, children: [displayText, isPartialMatch && renderPartialIndicator(status), isVerified && !isPartialMatch && renderVerifiedIndicator(status), isPending && (_jsx("span", { className: "opacity-70 ml-1", children: pendingContent }))] })] }));
-});
-InlineCitation.displayName = "InlineCitation";
-/**
- * Minimal style citation component.
- * Displays just the citation number with minimal decoration.
- *
- * @example
- * ```tsx
- * <MinimalCitation citation={citation} />
- * // Renders: 1
- * ```
- */
-export const MinimalCitation = forwardRef(({ citation, children, className, fallbackDisplay, verification, eventHandlers, preventTooltips = false, pendingContent = TWO_DOTS_THINKING_CONTENT, renderVerifiedIndicator = () => _jsx(DefaultVerifiedIndicator, {}), renderPartialIndicator = () => _jsx(DefaultPartialIndicator, {}), showStatusIndicator = true, }, ref) => {
-    const { citationKey, citationInstanceId, status } = useCitationData(citation, verification);
-    const { isVerified, isMiss, isPartialMatch, isPending } = status;
-    // MinimalCitation shows number by default
-    const displayText = useMemo(() => getCitationNumber(citation), [citation]);
-    const handleClick = useCallback((e) => {
-        e.preventDefault();
-        e.stopPropagation();
-        eventHandlers?.onClick?.(citation, citationKey, e);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseEnter = useCallback(() => {
-        eventHandlers?.onMouseEnter?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    const handleMouseLeave = useCallback(() => {
-        eventHandlers?.onMouseLeave?.(citation, citationKey);
-    }, [eventHandlers, citation, citationKey]);
-    // Check partial first since isVerified is true when isPartialMatch is true
-    const statusClass = isPartialMatch
-        ? "text-amber-600 dark:text-amber-500"
-        : isMiss
-            ? "text-red-500 dark:text-red-400 line-through"
-            : isVerified
-                ? "text-green-600 dark:text-green-500"
-                : isPending
-                    ? "text-gray-400 dark:text-gray-500"
-                    : "text-blue-600 dark:text-blue-400";
-    return (_jsxs(_Fragment, { children: [children, _jsxs("span", { ref: ref, "data-citation-id": citationKey, "data-citation-instance": citationInstanceId, "data-variant": "minimal", className: classNames("cursor-pointer transition-colors hover:underline", statusClass, className), onMouseEnter: preventTooltips ? undefined : handleMouseEnter, onMouseLeave: preventTooltips ? undefined : handleMouseLeave, onMouseDown: handleClick, onClick: (e) => e.stopPropagation(), "aria-label": `Citation ${displayText}`, children: [displayText, showStatusIndicator && (_jsxs(_Fragment, { children: [isPartialMatch && renderPartialIndicator(status), isVerified && !isPartialMatch && renderVerifiedIndicator(status), isPending && pendingContent] }))] })] }));
-});
-MinimalCitation.displayName = "MinimalCitation";
-/**
- * Factory component that renders the appropriate citation variant.
- *
- * @example
- * ```tsx
- * <CitationVariantFactory variant="chip" citation={citation} chipProps={{ size: "lg" }} />
- * ```
- */
-export const CitationVariantFactory = forwardRef(({ variant = "bracket", chipProps, superscriptProps, footnoteProps, inlineProps, minimalProps, ...props }, ref) => {
-    switch (variant) {
-        case "chip":
-            return _jsx(ChipCitation, { ref: ref, ...props, ...chipProps });
-        case "superscript":
-            return (_jsx(SuperscriptCitation, { ref: ref, ...props, ...superscriptProps }));
-        case "footnote":
-            return _jsx(FootnoteCitation, { ref: ref, ...props, ...footnoteProps });
-        case "inline":
-            return _jsx(InlineCitation, { ref: ref, ...props, ...inlineProps });
-        case "minimal":
-            return _jsx(MinimalCitation, { ref: ref, ...props, ...minimalProps });
-        case "bracket":
-        default:
-            // For bracket variant, we return null here as CitationComponent handles it
-            // This factory is meant to be used for alternate variants
-            return null;
-    }
-});
-CitationVariantFactory.displayName = "CitationVariantFactory";
-// Memoized versions for performance
-export const MemoizedChipCitation = memo(ChipCitation);
-export const MemoizedSuperscriptCitation = memo(SuperscriptCitation);
-export const MemoizedFootnoteCitation = memo(FootnoteCitation);
-export const MemoizedInlineCitation = memo(InlineCitation);
-export const MemoizedMinimalCitation = memo(MinimalCitation);
-export const MemoizedCitationVariantFactory = memo(CitationVariantFactory);

package/lib/react/DiffDisplay.d.ts

@@ -1,10 +0,0 @@
-import React from "react";
-interface DiffDisplayProps {
-    expected: string;
-    actual: string;
-    label?: string;
-    className?: string;
-    sanitize?: (text: string) => string;
-}
-declare const DiffDisplay: React.FC<DiffDisplayProps>;
-export default DiffDisplay;

package/lib/react/DiffDisplay.js

@@ -1,33 +0,0 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { useMemo } from "react";
-import { useSmartDiff } from "./useSmartDiff.js";
-import { classNames } from "./utils.js";
-const DiffDisplay = ({ expected, actual, label, className, sanitize }) => {
-    // 1. Sanitize Inputs if sanitization function provided
-    const { sanitizedExpected, sanitizedActual } = useMemo(() => {
-        if (sanitize) {
-            return {
-                sanitizedExpected: sanitize(expected),
-                sanitizedActual: sanitize(actual),
-            };
-        }
-        return {
-            sanitizedExpected: expected,
-            sanitizedActual: actual,
-        };
-    }, [expected, actual, sanitize]);
-    // 2. Run the Smart Diff Hook
-    const { diffResult } = useSmartDiff(sanitizedExpected, sanitizedActual);
-    return (_jsxs("div", { className: classNames("dc-diff-display", className), children: [label && _jsx("div", { className: "dc-diff-label", children: label }), _jsx("div", { className: "dc-diff-content", children: _jsx("div", { className: "dc-diff-blocks", children: diffResult.map((block, blockIndex) => (_jsx("div", { className: classNames("dc-diff-block", `dc-diff-block--${block.type}`, block.type === "added" ? "dc-diff-block-added" : ""), children: block.parts.map((part, partIndex) => {
-                            const key = `p-${blockIndex}-${partIndex}`;
-                            if (part.removed) {
-                                return (_jsx("span", { className: "dc-diff-part dc-diff-part--removed", title: "Expected text", children: part.value }, key));
-                            }
-                            if (part.added) {
-                                return (_jsx("span", { className: "dc-diff-part dc-diff-part--added", title: "Actual text found", children: part.value }, key));
-                            }
-                            // Unchanged text
-                            return (_jsx("span", { className: "dc-diff-part dc-diff-part--unchanged", children: part.value }, key));
-                        }) }, `block-${blockIndex}`))) }) })] }));
-};
-export default DiffDisplay;

package/lib/react/Popover.d.ts

@@ -1,15 +0,0 @@
-/**
- * Popover component built on Radix UI primitives.
- * This is a shadcn-style component - copy/paste friendly.
- *
- * @see https://ui.shadcn.com/docs/components/popover
- * @see https://www.radix-ui.com/primitives/docs/components/popover
- */
-import * as React from "react";
-import * as PopoverPrimitive from "@radix-ui/react-popover";
-declare const Popover: React.FC<PopoverPrimitive.PopoverProps>;
-declare const PopoverTrigger: React.ForwardRefExoticComponent<PopoverPrimitive.PopoverTriggerProps & React.RefAttributes<HTMLButtonElement>>;
-declare const PopoverAnchor: React.ForwardRefExoticComponent<PopoverPrimitive.PopoverAnchorProps & React.RefAttributes<HTMLDivElement>>;
-declare const PopoverPortal: React.FC<PopoverPrimitive.PopoverPortalProps>;
-declare const PopoverContent: React.ForwardRefExoticComponent<Omit<PopoverPrimitive.PopoverContentProps & React.RefAttributes<HTMLDivElement>, "ref"> & React.RefAttributes<HTMLDivElement>>;
-export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor, PopoverPortal };

package/lib/react/Popover.js

@@ -1,20 +0,0 @@
-import { jsx as _jsx } from "react/jsx-runtime";
-/**
- * Popover component built on Radix UI primitives.
- * This is a shadcn-style component - copy/paste friendly.
- *
- * @see https://ui.shadcn.com/docs/components/popover
- * @see https://www.radix-ui.com/primitives/docs/components/popover
- */
-import * as React from "react";
-import * as PopoverPrimitive from "@radix-ui/react-popover";
-function cn(...classes) {
-    return classes.filter(Boolean).join(" ");
-}
-const Popover = PopoverPrimitive.Root;
-const PopoverTrigger = PopoverPrimitive.Trigger;
-const PopoverAnchor = PopoverPrimitive.Anchor;
-const PopoverPortal = PopoverPrimitive.Portal;
-const PopoverContent = React.forwardRef(({ className, align = "center", sideOffset = 4, ...props }, ref) => (_jsx(PopoverPrimitive.Portal, { children: _jsx(PopoverPrimitive.Content, { ref: ref, align: align, sideOffset: sideOffset, className: cn("z-50 rounded-md border bg-white p-1 shadow-md outline-none", "border-gray-200 dark:border-gray-700 dark:bg-gray-900", "data-[state=open]:animate-in data-[state=closed]:animate-out", "data-[state=closed]:fade-out-0 data-[state=open]:fade-in-0", "data-[state=closed]:zoom-out-95 data-[state=open]:zoom-in-95", "data-[side=bottom]:slide-in-from-top-2", "data-[side=left]:slide-in-from-right-2", "data-[side=right]:slide-in-from-left-2", "data-[side=top]:slide-in-from-bottom-2", className), ...props }) })));
-PopoverContent.displayName = PopoverPrimitive.Content.displayName;
-export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor, PopoverPortal };

package/lib/react/UrlCitationComponent.d.ts

@@ -1,83 +0,0 @@
-import React from "react";
-import type { UrlCitationMeta, UrlCitationProps, UrlFetchStatus } from "./types.js";
-/**
- * Extracts domain from URL for compact display.
- */
-export declare function extractDomain(url: string): string;
-/**
- * Truncates a string to max length with ellipsis.
- */
-declare function truncateString(str: string, maxLength: number): string;
-/**
- * Get path from URL for display.
- */
-declare function getUrlPath(url: string): string;
-/**
- * Status indicator icons for URL fetch states.
- */
-declare const STATUS_ICONS: Record<UrlFetchStatus, {
-    icon: string;
-    label: string;
-    className: string;
-}>;
-/**
- * Checks if status is a blocked status.
- */
-export declare function isBlockedStatus(status: UrlFetchStatus): boolean;
-/**
- * Checks if status is an error status.
- */
-export declare function isErrorStatus(status: UrlFetchStatus): boolean;
-/**
- * Checks if URL was successfully verified.
- */
-export declare function isVerifiedStatus(status: UrlFetchStatus): boolean;
-/**
- * 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 declare const UrlCitationComponent: React.ForwardRefExoticComponent<UrlCitationProps & React.RefAttributes<HTMLSpanElement>>;
-/**
- * Memoized version for performance.
- */
-export declare const MemoizedUrlCitationComponent: React.NamedExoticComponent<UrlCitationProps & React.RefAttributes<HTMLSpanElement>>;
-/**
- * Hook to parse URL and create UrlCitationMeta.
- */
-export declare function useUrlMeta(url: string, fetchStatus?: UrlFetchStatus, additionalMeta?: Partial<UrlCitationMeta>): UrlCitationMeta;
-/**
- * Compact URL display utilities.
- */
-export declare const urlDisplayUtils: {
-    extractDomain: typeof extractDomain;
-    truncateString: typeof truncateString;
-    getUrlPath: typeof getUrlPath;
-    isBlockedStatus: typeof isBlockedStatus;
-    isErrorStatus: typeof isErrorStatus;
-    isVerifiedStatus: typeof isVerifiedStatus;
-};
-/**
- * Status configuration for custom styling.
- */
-export { STATUS_ICONS };