@uipath/apollo-wind 2.68.0 → 2.70.0

package/dist/components/ui/citation.cjs

@@ -0,0 +1,188 @@
+"use strict";
+"use client";
+var __webpack_require__ = {};
+(()=>{
+    __webpack_require__.d = (exports1, definition)=>{
+        for(var key in definition)if (__webpack_require__.o(definition, key) && !__webpack_require__.o(exports1, key)) Object.defineProperty(exports1, key, {
+            enumerable: true,
+            get: definition[key]
+        });
+    };
+})();
+(()=>{
+    __webpack_require__.o = (obj, prop)=>Object.prototype.hasOwnProperty.call(obj, prop);
+})();
+(()=>{
+    __webpack_require__.r = (exports1)=>{
+        if ("u" > typeof Symbol && Symbol.toStringTag) Object.defineProperty(exports1, Symbol.toStringTag, {
+            value: 'Module'
+        });
+        Object.defineProperty(exports1, '__esModule', {
+            value: true
+        });
+    };
+})();
+var __webpack_exports__ = {};
+__webpack_require__.r(__webpack_exports__);
+__webpack_require__.d(__webpack_exports__, {
+    Citation: ()=>Citation,
+    citationVariants: ()=>citationVariants,
+    DEFAULT_CITATION_STRINGS: ()=>DEFAULT_CITATION_STRINGS
+});
+const jsx_runtime_namespaceObject = require("react/jsx-runtime");
+const external_class_variance_authority_namespaceObject = require("class-variance-authority");
+const external_react_namespaceObject = require("react");
+const index_cjs_namespaceObject = require("../../lib/index.cjs");
+const external_hover_card_cjs_namespaceObject = require("./hover-card.cjs");
+const DEFAULT_CITATION_STRINGS = {
+    label: (index, title)=>title ? `Citation ${index}: ${title}` : `Citation ${index}`
+};
+const citationVariants = (0, external_class_variance_authority_namespaceObject.cva)('mx-0.5 inline-flex cursor-pointer items-center justify-center rounded-full bg-muted align-text-top font-medium leading-none text-muted-foreground tabular-nums transition-colors hover:bg-accent hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring data-[state=open]:bg-accent data-[state=open]:text-accent-foreground', {
+    variants: {
+        size: {
+            default: 'h-4.5 min-w-4.5 px-1.5 text-[11px]',
+            sm: 'h-4 min-w-4 px-1 text-[10px]',
+            lg: 'h-5 min-w-5 px-1.5 text-xs'
+        }
+    },
+    defaultVariants: {
+        size: 'default'
+    }
+});
+const Citation = /*#__PURE__*/ external_react_namespaceObject.forwardRef(({ className, size = 'default', index, title, snippet, source, href, onSelect, onClick, onFocus, onBlur, onPointerEnter, onPointerLeave, preview = true, previewSide = 'top', onActiveChange, strings, 'aria-label': ariaLabel, children, ...props }, ref)=>{
+    const text = {
+        ...DEFAULT_CITATION_STRINGS,
+        ...strings
+    };
+    const [open, setOpen] = external_react_namespaceObject.useState(false);
+    const activity = external_react_namespaceObject.useRef({
+        hovered: false,
+        focused: false,
+        previewOpen: false
+    });
+    const active = external_react_namespaceObject.useRef(false);
+    const onActiveChangeRef = external_react_namespaceObject.useRef(onActiveChange);
+    onActiveChangeRef.current = onActiveChange;
+    const updateActivity = (patch)=>{
+        Object.assign(activity.current, patch);
+        const { hovered, focused, previewOpen } = activity.current;
+        const next = hovered || focused || previewOpen;
+        if (next === active.current) return;
+        active.current = next;
+        onActiveChangeRef.current?.(next);
+    };
+    const dismissed = external_react_namespaceObject.useRef(false);
+    const setPreviewOpen = (next)=>{
+        if (next && dismissed.current) return;
+        setOpen(next);
+        updateActivity({
+            previewOpen: next
+        });
+    };
+    external_react_namespaceObject.useEffect(()=>()=>{
+            if (active.current) onActiveChangeRef.current?.(false);
+        }, []);
+    const name = ariaLabel ?? text.label(String(index), title || void 0);
+    const hasPreview = preview && Boolean(title || snippet || source);
+    const button = /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)("button", {
+        ref: ref,
+        type: "button",
+        "data-slot": "citation",
+        "data-size": size,
+        "aria-label": name,
+        className: (0, index_cjs_namespaceObject.cn)(citationVariants({
+            size
+        }), className),
+        onClick: (event)=>{
+            onClick?.(event);
+            if (hasPreview) {
+                dismissed.current = true;
+                setPreviewOpen(false);
+            }
+            if (!event.defaultPrevented) onSelect?.({
+                index,
+                title,
+                snippet,
+                source,
+                href: (0, index_cjs_namespaceObject.safeHref)(href)
+            }, event);
+        },
+        onFocus: (event)=>{
+            onFocus?.(event);
+            if (!event.currentTarget.matches(':focus-visible')) return;
+            updateActivity({
+                focused: true
+            });
+            if (hasPreview) setPreviewOpen(true);
+        },
+        onBlur: (event)=>{
+            onBlur?.(event);
+            dismissed.current = false;
+            updateActivity({
+                focused: false
+            });
+        },
+        onPointerEnter: (event)=>{
+            onPointerEnter?.(event);
+            updateActivity({
+                hovered: true
+            });
+        },
+        onPointerLeave: (event)=>{
+            onPointerLeave?.(event);
+            dismissed.current = false;
+            updateActivity({
+                hovered: false
+            });
+        },
+        ...props,
+        children: children ?? index
+    });
+    if (!hasPreview) return button;
+    return /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsxs)(external_hover_card_cjs_namespaceObject.HoverCard, {
+        open: open,
+        onOpenChange: setPreviewOpen,
+        openDelay: 300,
+        closeDelay: 150,
+        children: [
+            /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)(external_hover_card_cjs_namespaceObject.HoverCardTrigger, {
+                asChild: true,
+                children: button
+            }),
+            /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsxs)(external_hover_card_cjs_namespaceObject.HoverCardContent, {
+                "data-slot": "citation-preview",
+                side: previewSide,
+                className: "flex w-72 flex-col gap-1 p-3 text-sm",
+                children: [
+                    source && /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)("span", {
+                        "data-slot": "citation-source",
+                        className: "truncate text-xs text-muted-foreground",
+                        children: source
+                    }),
+                    title && /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)("span", {
+                        "data-slot": "citation-title",
+                        className: "line-clamp-2 font-medium",
+                        children: title
+                    }),
+                    snippet && /*#__PURE__*/ (0, jsx_runtime_namespaceObject.jsx)("span", {
+                        "data-slot": "citation-snippet",
+                        className: "line-clamp-3 text-xs leading-relaxed text-muted-foreground",
+                        children: snippet
+                    })
+                ]
+            })
+        ]
+    });
+});
+Citation.displayName = 'Citation';
+exports.Citation = __webpack_exports__.Citation;
+exports.DEFAULT_CITATION_STRINGS = __webpack_exports__.DEFAULT_CITATION_STRINGS;
+exports.citationVariants = __webpack_exports__.citationVariants;
+for(var __rspack_i in __webpack_exports__)if (-1 === [
+    "Citation",
+    "DEFAULT_CITATION_STRINGS",
+    "citationVariants"
+].indexOf(__rspack_i)) exports[__rspack_i] = __webpack_exports__[__rspack_i];
+Object.defineProperty(exports, '__esModule', {
+    value: true
+});

package/dist/components/ui/citation.d.ts

@@ -0,0 +1,42 @@
+import { type VariantProps } from 'class-variance-authority';
+import * as React from 'react';
+import { HoverCardContent } from './hover-card';
+/**
+ * An inline citation marker for chat prose, with a hover and focus preview of the source. It does
+ * not navigate on its own: `onSelect` receives the citation and the event, so a host can run its
+ * `citation-click` pre-hook and decide whether to open `href`. The payload drops an `href` that is
+ * not http(s), mailto, tel or relative, so it is safe to open.
+ */
+export interface CitationData {
+    /** The source number, usually 1-based. Shown in the pill unless `children` are given. */
+    index: number | string;
+    title?: string;
+    snippet?: string;
+    /** Where it came from: a domain, a file name or a page reference. */
+    source?: string;
+    href?: string;
+}
+export interface CitationStrings {
+    /** Accessible name of the pill. */
+    label: (index: string, title?: string) => string;
+}
+export declare const DEFAULT_CITATION_STRINGS: CitationStrings;
+declare const citationVariants: (props?: ({
+    size?: "default" | "lg" | "sm" | null | undefined;
+} & import("class-variance-authority/types").ClassProp) | undefined) => string;
+export interface CitationProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onSelect' | 'title'>, CitationData, VariantProps<typeof citationVariants> {
+    onSelect?: (citation: CitationData, event: React.MouseEvent<HTMLButtonElement>) => void;
+    /** Set false to skip the preview card even when there is content for it. */
+    preview?: boolean;
+    previewSide?: React.ComponentPropsWithoutRef<typeof HoverCardContent>['side'];
+    /**
+     * Called when the citation becomes active or inactive, so a host can mark the cited text. It
+     * activates at once on hover or keyboard focus, and deactivates once neither applies and its
+     * preview, if shown, has closed. The preview's close delay means one citation can deactivate after the next
+     * activates. Also called with `false` if it unmounts active.
+     */
+    onActiveChange?: (active: boolean) => void;
+    strings?: Partial<CitationStrings>;
+}
+declare const Citation: React.ForwardRefExoticComponent<CitationProps & React.RefAttributes<HTMLButtonElement>>;
+export { Citation, citationVariants };

package/dist/components/ui/citation.js

@@ -0,0 +1,148 @@
+"use client";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { cva } from "class-variance-authority";
+import { forwardRef, useEffect, useRef, useState } from "react";
+import { cn, safeHref } from "../../lib/index.js";
+import { HoverCard, HoverCardContent, HoverCardTrigger } from "./hover-card.js";
+const DEFAULT_CITATION_STRINGS = {
+    label: (index, title)=>title ? `Citation ${index}: ${title}` : `Citation ${index}`
+};
+const citationVariants = cva('mx-0.5 inline-flex cursor-pointer items-center justify-center rounded-full bg-muted align-text-top font-medium leading-none text-muted-foreground tabular-nums transition-colors hover:bg-accent hover:text-accent-foreground focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring data-[state=open]:bg-accent data-[state=open]:text-accent-foreground', {
+    variants: {
+        size: {
+            default: 'h-4.5 min-w-4.5 px-1.5 text-[11px]',
+            sm: 'h-4 min-w-4 px-1 text-[10px]',
+            lg: 'h-5 min-w-5 px-1.5 text-xs'
+        }
+    },
+    defaultVariants: {
+        size: 'default'
+    }
+});
+const Citation = /*#__PURE__*/ forwardRef(({ className, size = 'default', index, title, snippet, source, href, onSelect, onClick, onFocus, onBlur, onPointerEnter, onPointerLeave, preview = true, previewSide = 'top', onActiveChange, strings, 'aria-label': ariaLabel, children, ...props }, ref)=>{
+    const text = {
+        ...DEFAULT_CITATION_STRINGS,
+        ...strings
+    };
+    const [open, setOpen] = useState(false);
+    const activity = useRef({
+        hovered: false,
+        focused: false,
+        previewOpen: false
+    });
+    const active = useRef(false);
+    const onActiveChangeRef = useRef(onActiveChange);
+    onActiveChangeRef.current = onActiveChange;
+    const updateActivity = (patch)=>{
+        Object.assign(activity.current, patch);
+        const { hovered, focused, previewOpen } = activity.current;
+        const next = hovered || focused || previewOpen;
+        if (next === active.current) return;
+        active.current = next;
+        onActiveChangeRef.current?.(next);
+    };
+    const dismissed = useRef(false);
+    const setPreviewOpen = (next)=>{
+        if (next && dismissed.current) return;
+        setOpen(next);
+        updateActivity({
+            previewOpen: next
+        });
+    };
+    useEffect(()=>()=>{
+            if (active.current) onActiveChangeRef.current?.(false);
+        }, []);
+    const name = ariaLabel ?? text.label(String(index), title || void 0);
+    const hasPreview = preview && Boolean(title || snippet || source);
+    const button = /*#__PURE__*/ jsx("button", {
+        ref: ref,
+        type: "button",
+        "data-slot": "citation",
+        "data-size": size,
+        "aria-label": name,
+        className: cn(citationVariants({
+            size
+        }), className),
+        onClick: (event)=>{
+            onClick?.(event);
+            if (hasPreview) {
+                dismissed.current = true;
+                setPreviewOpen(false);
+            }
+            if (!event.defaultPrevented) onSelect?.({
+                index,
+                title,
+                snippet,
+                source,
+                href: safeHref(href)
+            }, event);
+        },
+        onFocus: (event)=>{
+            onFocus?.(event);
+            if (!event.currentTarget.matches(':focus-visible')) return;
+            updateActivity({
+                focused: true
+            });
+            if (hasPreview) setPreviewOpen(true);
+        },
+        onBlur: (event)=>{
+            onBlur?.(event);
+            dismissed.current = false;
+            updateActivity({
+                focused: false
+            });
+        },
+        onPointerEnter: (event)=>{
+            onPointerEnter?.(event);
+            updateActivity({
+                hovered: true
+            });
+        },
+        onPointerLeave: (event)=>{
+            onPointerLeave?.(event);
+            dismissed.current = false;
+            updateActivity({
+                hovered: false
+            });
+        },
+        ...props,
+        children: children ?? index
+    });
+    if (!hasPreview) return button;
+    return /*#__PURE__*/ jsxs(HoverCard, {
+        open: open,
+        onOpenChange: setPreviewOpen,
+        openDelay: 300,
+        closeDelay: 150,
+        children: [
+            /*#__PURE__*/ jsx(HoverCardTrigger, {
+                asChild: true,
+                children: button
+            }),
+            /*#__PURE__*/ jsxs(HoverCardContent, {
+                "data-slot": "citation-preview",
+                side: previewSide,
+                className: "flex w-72 flex-col gap-1 p-3 text-sm",
+                children: [
+                    source && /*#__PURE__*/ jsx("span", {
+                        "data-slot": "citation-source",
+                        className: "truncate text-xs text-muted-foreground",
+                        children: source
+                    }),
+                    title && /*#__PURE__*/ jsx("span", {
+                        "data-slot": "citation-title",
+                        className: "line-clamp-2 font-medium",
+                        children: title
+                    }),
+                    snippet && /*#__PURE__*/ jsx("span", {
+                        "data-slot": "citation-snippet",
+                        className: "line-clamp-3 text-xs leading-relaxed text-muted-foreground",
+                        children: snippet
+                    })
+                ]
+            })
+        ]
+    });
+});
+Citation.displayName = 'Citation';
+export { Citation, DEFAULT_CITATION_STRINGS, citationVariants };