@openviking/react 0.1.4 → 0.1.6

package/dist/n~0.js

@@ -1,10 +1,10 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
-import { cloneElement, forwardRef, useCallback, useEffect, useId, useImperativeHandle, useRef, useState } from "react";
-import { createPortal } from "react-dom";
+import { forwardRef, useImperativeHandle, useRef, useState } from "react";
 import { resolveLocale, mergeLabels } from "./nx~0.js";
 import { FolderOpenIcon, FolderIcon, ChevronRightIcon, DocumentIcon } from "./k~0.js";
-import { useOverlayPosition } from "./o~0.js";
+import { Popover } from "./r~0.js";
 import { searchreact } from "./p~0.js";
+import { useLocale } from "./28~0.js";
 const messages = {
     search: 'Search files…',
     refresh: 'Refresh file tree',
@@ -277,131 +277,6 @@ function resolveInfoCopy(key, hostLabels) {
         triggerBehavior: triggerBehavior || void 0
     };
 }
-function useMergedRef(ref, target) {
-    return useCallback((node)=>{
-        target.current = node;
-        if ('function' == typeof ref) ref(node);
-        else if (ref) ref.current = node;
-    }, [
-        ref,
-        target
-    ]);
-}
-function Popover({ children, content, placement = 'right', trigger = 'hover', delay = 300, disabled = false, className, style, onOpenChange }) {
-    const [open, setOpen] = useState(false);
-    const triggerRef = useRef(null);
-    const timerRef = useRef(void 0);
-    const [surfaceNode, setSurfaceNode] = useState(null);
-    const id = useId();
-    const position = useOverlayPosition(open, triggerRef, surfaceNode, placement);
-    const change = useCallback((next)=>{
-        setOpen(next);
-        onOpenChange?.(next);
-    }, [
-        onOpenChange
-    ]);
-    const clearTimer = useCallback(()=>{
-        if (void 0 !== timerRef.current) {
-            window.clearTimeout(timerRef.current);
-            timerRef.current = void 0;
-        }
-    }, []);
-    useEffect(()=>clearTimer, [
-        clearTimer
-    ]);
-    useEffect(()=>{
-        if (disabled) {
-            clearTimer();
-            setOpen(false);
-        }
-    }, [
-        disabled,
-        clearTimer
-    ]);
-    useEffect(()=>{
-        if (!open || 'click' !== trigger) return;
-        const onPointerDown = (event)=>{
-            const target = event.target;
-            if (surfaceNode?.contains(target) || triggerRef.current?.contains(target)) return;
-            change(false);
-        };
-        const onKeyDown = (event)=>{
-            if ('Escape' === event.key) change(false);
-        };
-        document.addEventListener('mousedown', onPointerDown);
-        document.addEventListener('keydown', onKeyDown);
-        return ()=>{
-            document.removeEventListener('mousedown', onPointerDown);
-            document.removeEventListener('keydown', onKeyDown);
-        };
-    }, [
-        change,
-        open,
-        surfaceNode,
-        trigger
-    ]);
-    const show = ()=>{
-        if (disabled) return;
-        if ('click' === trigger) return void change(!open);
-        clearTimer();
-        timerRef.current = window.setTimeout(()=>{
-            change(true);
-            timerRef.current = void 0;
-        }, delay);
-    };
-    const hide = ()=>{
-        if ('click' === trigger) return;
-        clearTimer();
-        change(false);
-    };
-    const child = children;
-    const childProps = child.props;
-    const childRef = child.ref;
-    const mergedRef = useMergedRef(childRef, triggerRef);
-    const declaresExpanded = 'aria-expanded' in childProps;
-    const triggerElement = /*#__PURE__*/ cloneElement(child, {
-        ref: mergedRef,
-        ...declaresExpanded ? {} : {
-            'aria-expanded': open
-        },
-        onMouseEnter: (event)=>{
-            childProps.onMouseEnter?.(event);
-            if ('hover' === trigger) show();
-        },
-        onMouseLeave: (event)=>{
-            childProps.onMouseLeave?.(event);
-            if ('hover' === trigger) hide();
-        },
-        onClick: (event)=>{
-            childProps.onClick?.(event);
-            if ('click' === trigger) show();
-        }
-    });
-    const surface = open ? /*#__PURE__*/ createPortal(/*#__PURE__*/ jsx("div", {
-        ref: setSurfaceNode,
-        id: id,
-        role: 'click' === trigger ? 'dialog' : 'note',
-        className: [
-            'ov-popover',
-            className
-        ].filter(Boolean).join(' '),
-        "data-placement": position.placement,
-        style: {
-            top: position.top,
-            left: position.left,
-            ...style
-        },
-        onMouseEnter: 'hover' === trigger ? clearTimer : void 0,
-        onMouseLeave: 'hover' === trigger ? hide : void 0,
-        children: content
-    }), document.body) : null;
-    return /*#__PURE__*/ jsxs(Fragment, {
-        children: [
-            triggerElement,
-            surface
-        ]
-    });
-}
 const DEFAULT_FIELDS = {
     description: "Description",
     triggerBehavior: 'Trigger',
@@ -508,6 +383,7 @@ function Guides({ depth }) {
 }
 const FILE_TREE_ROW_ATTRIBUTE = 'data-file-tree-row-id';
 function FileTreeRowView({ row, ctx }) {
+    const anchorRef = useRef(null);
     const { text, selectedId, getRowAttributes, renderDashboard, renderRowTooltip, renderRowIcon, onSelect, onToggleExpand, onOpenRetentionSettings, onRowKeyDown } = ctx;
     const isDirectory = 'directory' === row.type;
     const canExpand = isDirectory && false !== row.hasChildren;
@@ -613,7 +489,15 @@ function FileTreeRowView({ row, ctx }) {
             dashboard ? /*#__PURE__*/ jsx("span", {
                 className: "ov-file-tree__dashboard",
                 children: dashboard
-            }) : null
+            }) : null,
+            /*#__PURE__*/ jsx("span", {
+                className: "ov-file-tree__popover-anchor-container",
+                "aria-hidden": "true",
+                children: /*#__PURE__*/ jsx("span", {
+                    ref: anchorRef,
+                    className: "ov-file-tree__popover-anchor"
+                })
+            })
         ]
     });
     const custom = renderRowTooltip?.(row);
@@ -627,6 +511,7 @@ function FileTreeRowView({ row, ctx }) {
     return /*#__PURE__*/ jsx(Popover, {
         content: tooltipContent,
         placement: "right",
+        anchorRef: anchorRef,
         trigger: "hover",
         children: rowNode
     });
@@ -904,7 +789,8 @@ function FileTreeSpinner({ className, ...rest }) {
 function findRow(root, id) {
     return root?.querySelector(`[${FILE_TREE_ROW_ATTRIBUTE}="${CSS.escape(id)}"]`) ?? null;
 }
-const file_tree_FileTree = /*#__PURE__*/ forwardRef(function({ rows, locale, operations, selectedId, search, refresh, isReady = true, loadingFallback, errorFallback, emptyFallback, slots, labels, getRowAttributes, renderDashboard, renderRowTooltip, renderRowIcon, onSelect, onToggleExpand, onLoadMore, onRetry, onOpenRetentionSettings, onSearch, onRefresh, className, ...rest }, ref) {
+const file_tree_FileTree = /*#__PURE__*/ forwardRef(function({ rows, locale: localeProp, operations, selectedId, search, refresh, isReady = true, loadingFallback, errorFallback, emptyFallback, slots, labels, getRowAttributes, renderDashboard, renderRowTooltip, renderRowIcon, onSelect, onToggleExpand, onLoadMore, onRetry, onOpenRetentionSettings, onSearch, onRefresh, className, ...rest }, ref) {
+    const locale = useLocale(localeProp);
     const rootRef = useRef(null);
     const text = resolveFileTreeLabels(locale, labels);
     const actions = useFileTreeActions({

package/dist/rt~0.js

@@ -0,0 +1,152 @@
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { cloneElement, useCallback, useEffect, useId, useRef, useState } from "react";
+import { createPortal } from "react-dom";
+import { useOverlayPosition } from "./o~0.js";
+const DEFAULT_LABELS = {
+    close: 'Close'
+};
+function useMergedRef(ref, target) {
+    const merged = useCallback((node)=>{
+        target.current = node;
+        if ('function' == typeof ref) ref(node);
+        else if (ref) ref.current = node;
+    }, [
+        ref,
+        target
+    ]);
+    return merged;
+}
+function Tooltip({ children, content, placement = 'top', trigger = 'hover', delay = 300, disabled = false, className, style, onOpenChange, labels }) {
+    const text = {
+        ...DEFAULT_LABELS,
+        ...labels
+    };
+    const [open, setOpen] = useState(false);
+    const triggerRef = useRef(null);
+    const timerRef = useRef(void 0);
+    const [surfaceNode, setSurfaceNode] = useState(null);
+    const id = useId();
+    const position = useOverlayPosition(open, triggerRef, surfaceNode, placement);
+    const change = useCallback((next)=>{
+        setOpen(next);
+        onOpenChange?.(next);
+    }, [
+        onOpenChange
+    ]);
+    const clearTimer = useCallback(()=>{
+        if (void 0 !== timerRef.current) {
+            window.clearTimeout(timerRef.current);
+            timerRef.current = void 0;
+        }
+    }, []);
+    useEffect(()=>clearTimer, [
+        clearTimer
+    ]);
+    useEffect(()=>{
+        if (disabled) {
+            clearTimer();
+            setOpen(false);
+        }
+    }, [
+        disabled,
+        clearTimer
+    ]);
+    useEffect(()=>{
+        if (!open) return;
+        const onPointerDown = (event)=>{
+            const target = event.target;
+            if (surfaceNode?.contains(target) || triggerRef.current?.contains(target)) return;
+            change(false);
+        };
+        const onKeyDown = (event)=>{
+            if ('Escape' === event.key) {
+                clearTimer();
+                change(false);
+            }
+        };
+        if ('click' === trigger) document.addEventListener('mousedown', onPointerDown);
+        document.addEventListener('keydown', onKeyDown);
+        return ()=>{
+            if ('click' === trigger) document.removeEventListener('mousedown', onPointerDown);
+            document.removeEventListener('keydown', onKeyDown);
+        };
+    }, [
+        change,
+        clearTimer,
+        open,
+        surfaceNode,
+        trigger
+    ]);
+    const show = ()=>{
+        if (disabled) return;
+        if ('click' === trigger) return void change(!open);
+        clearTimer();
+        timerRef.current = window.setTimeout(()=>{
+            change(true);
+            timerRef.current = void 0;
+        }, delay);
+    };
+    const hide = ()=>{
+        if ('click' === trigger) return;
+        clearTimer();
+        timerRef.current = window.setTimeout(()=>{
+            change(false);
+            timerRef.current = void 0;
+        }, 120);
+    };
+    const child = children;
+    const childProps = child.props;
+    const childRef = child.ref;
+    const mergedRef = useMergedRef(childRef, triggerRef);
+    const triggerElement = /*#__PURE__*/ cloneElement(child, {
+        ref: mergedRef,
+        'aria-describedby': open && 'hover' === trigger ? id : void 0,
+        'aria-expanded': 'click' === trigger ? open : childProps['aria-expanded'],
+        onMouseEnter: (event)=>{
+            childProps.onMouseEnter?.(event);
+            if ('hover' === trigger) show();
+        },
+        onMouseLeave: (event)=>{
+            childProps.onMouseLeave?.(event);
+            if ('hover' === trigger) hide();
+        },
+        onFocus: (event)=>{
+            childProps.onFocus?.(event);
+            if ('hover' === trigger) show();
+        },
+        onBlur: (event)=>{
+            childProps.onBlur?.(event);
+            hide();
+        },
+        onClick: (event)=>{
+            childProps.onClick?.(event);
+            if ('click' === trigger) show();
+        }
+    });
+    const surface = open ? /*#__PURE__*/ createPortal(/*#__PURE__*/ jsx("div", {
+        ref: setSurfaceNode,
+        id: id,
+        role: 'hover' === trigger ? 'tooltip' : 'dialog',
+        "aria-label": 'click' === trigger ? text.close : void 0,
+        className: [
+            'ov-tooltip',
+            className
+        ].filter(Boolean).join(' '),
+        "data-placement": position.placement,
+        style: {
+            top: position.top,
+            left: position.left,
+            ...style
+        },
+        onMouseEnter: 'hover' === trigger ? clearTimer : void 0,
+        onMouseLeave: 'hover' === trigger ? hide : void 0,
+        children: content
+    }), document.body) : null;
+    return /*#__PURE__*/ jsxs(Fragment, {
+        children: [
+            triggerElement,
+            surface
+        ]
+    });
+}
+export { Tooltip };

package/dist/r~0.js

@@ -2,11 +2,8 @@ import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { cloneElement, useCallback, useEffect, useId, useRef, useState } from "react";
 import { createPortal } from "react-dom";
 import { useOverlayPosition } from "./o~0.js";
-const DEFAULT_LABELS = {
-    close: 'Close'
-};
 function useMergedRef(ref, target) {
-    const merged = useCallback((node)=>{
+    return useCallback((node)=>{
         target.current = node;
         if ('function' == typeof ref) ref(node);
         else if (ref) ref.current = node;
@@ -14,19 +11,15 @@ function useMergedRef(ref, target) {
         ref,
         target
     ]);
-    return merged;
 }
-function Tooltip({ children, content, placement = 'top', trigger = 'hover', delay = 300, disabled = false, className, style, onOpenChange, labels }) {
-    const text = {
-        ...DEFAULT_LABELS,
-        ...labels
-    };
-    const [open, setOpen] = useState(false);
+function Popover({ children, content, placement = 'right', anchorRef, trigger = 'hover', delay = 300, open: controlledOpen, role, disabled = false, className, style, onOpenChange }) {
+    const [localOpen, setOpen] = useState(false);
+    const open = !disabled && (controlledOpen ?? localOpen);
     const triggerRef = useRef(null);
     const timerRef = useRef(void 0);
     const [surfaceNode, setSurfaceNode] = useState(null);
     const id = useId();
-    const position = useOverlayPosition(open, triggerRef, surfaceNode, placement);
+    const position = useOverlayPosition(open, anchorRef ?? triggerRef, surfaceNode, placement);
     const change = useCallback((next)=>{
         setOpen(next);
         onOpenChange?.(next);
@@ -52,27 +45,23 @@ function Tooltip({ children, content, placement = 'top', trigger = 'hover', dela
         clearTimer
     ]);
     useEffect(()=>{
-        if (!open) return;
+        if (!open || 'click' !== trigger) return;
         const onPointerDown = (event)=>{
             const target = event.target;
             if (surfaceNode?.contains(target) || triggerRef.current?.contains(target)) return;
             change(false);
         };
         const onKeyDown = (event)=>{
-            if ('Escape' === event.key) {
-                clearTimer();
-                change(false);
-            }
+            if ('Escape' === event.key) change(false);
         };
-        if ('click' === trigger) document.addEventListener('mousedown', onPointerDown);
+        document.addEventListener('mousedown', onPointerDown);
         document.addEventListener('keydown', onKeyDown);
         return ()=>{
-            if ('click' === trigger) document.removeEventListener('mousedown', onPointerDown);
+            document.removeEventListener('mousedown', onPointerDown);
             document.removeEventListener('keydown', onKeyDown);
         };
     }, [
         change,
-        clearTimer,
         open,
         surfaceNode,
         trigger
@@ -89,19 +78,18 @@ function Tooltip({ children, content, placement = 'top', trigger = 'hover', dela
     const hide = ()=>{
         if ('click' === trigger) return;
         clearTimer();
-        timerRef.current = window.setTimeout(()=>{
-            change(false);
-            timerRef.current = void 0;
-        }, 120);
+        change(false);
     };
     const child = children;
     const childProps = child.props;
     const childRef = child.ref;
     const mergedRef = useMergedRef(childRef, triggerRef);
+    const declaresExpanded = 'aria-expanded' in childProps;
     const triggerElement = /*#__PURE__*/ cloneElement(child, {
         ref: mergedRef,
-        'aria-describedby': open && 'hover' === trigger ? id : void 0,
-        'aria-expanded': 'click' === trigger ? open : childProps['aria-expanded'],
+        ...declaresExpanded ? {} : {
+            'aria-expanded': open
+        },
         onMouseEnter: (event)=>{
             childProps.onMouseEnter?.(event);
             if ('hover' === trigger) show();
@@ -110,14 +98,6 @@ function Tooltip({ children, content, placement = 'top', trigger = 'hover', dela
             childProps.onMouseLeave?.(event);
             if ('hover' === trigger) hide();
         },
-        onFocus: (event)=>{
-            childProps.onFocus?.(event);
-            if ('hover' === trigger) show();
-        },
-        onBlur: (event)=>{
-            childProps.onBlur?.(event);
-            hide();
-        },
         onClick: (event)=>{
             childProps.onClick?.(event);
             if ('click' === trigger) show();
@@ -126,10 +106,9 @@ function Tooltip({ children, content, placement = 'top', trigger = 'hover', dela
     const surface = open ? /*#__PURE__*/ createPortal(/*#__PURE__*/ jsx("div", {
         ref: setSurfaceNode,
         id: id,
-        role: 'hover' === trigger ? 'tooltip' : 'dialog',
-        "aria-label": 'click' === trigger ? text.close : void 0,
+        role: role ?? ('click' === trigger ? 'dialog' : 'note'),
         className: [
-            'ov-tooltip',
+            'ov-popover',
             className
         ].filter(Boolean).join(' '),
         "data-placement": position.placement,
@@ -149,4 +128,4 @@ function Tooltip({ children, content, placement = 'top', trigger = 'hover', dela
         ]
     });
 }
-export { Tooltip };
+export { Popover };

package/dist/shared/components/popover/popover.d.ts

@@ -20,4 +20,4 @@ export type { PopoverPlacement, PopoverProps, PopoverTrigger, } from './types.js
  * tooltip is one dark line, a popover is a white card. What they share — the
  * portal, positioning and theme-variable syncing — lives in `overlay/`.
  */
-export declare function Popover({ children, content, placement, trigger, delay, disabled, className, style, onOpenChange, }: PopoverProps): import("react").JSX.Element;
+export declare function Popover({ children, content, placement, anchorRef, trigger, delay, open: controlledOpen, role, disabled, className, style, onOpenChange, }: PopoverProps): import("react").JSX.Element;

package/dist/shared/components/popover/types.d.ts

@@ -1,5 +1,5 @@
 import type { OverlayPlacement } from '../overlay/types.js';
-import type { CSSProperties, ReactElement, ReactNode } from 'react';
+import type { AriaRole, CSSProperties, ReactElement, ReactNode, RefObject } from 'react';
 /**
  * 弹出层的方位，与提示共用一套取值。空间不足时自动翻到对侧。
  * Where the popover sits relative to its trigger, sharing the tooltip's values.
@@ -35,10 +35,16 @@ export interface PopoverProps {
     content: ReactNode;
     /** 方位，默认 `right`——内容在行尾展开，不遮挡左侧。 Placement, `right` by default. */
     placement?: PopoverPlacement;
+    /** 可选的定位元素，触发事件仍在 children 上。 Optional anchor; children still handle the trigger. */
+    anchorRef?: RefObject<HTMLElement | null>;
     /** 触发方式，默认 `hover`。 Trigger mode, `hover` by default. */
     trigger?: PopoverTrigger;
     /** 悬停后多久展示，单位毫秒。延迟只作用于 `hover`。 Hover delay in ms; `hover` only. */
     delay?: number;
+    /** Controlled visibility; omitted values use instance-local state. */
+    open?: boolean;
+    /** Surface semantics; defaults to dialog for click and note for hover. */
+    role?: AriaRole;
     /** 为真时不展示浮层。 Suppresses the surface; the trigger still renders. */
     disabled?: boolean;
     /** 浮层容器的额外类名。 Extra class names for the surface. */

package/dist/shared/dashboard/dashboard-state.d.ts

@@ -0,0 +1,12 @@
+export interface DashboardStatus {
+    loading?: boolean;
+    error?: Error | null;
+    onRetry?: () => void;
+}
+export declare function DashboardState({ state, empty, loading, failed, retry, }: {
+    state?: DashboardStatus;
+    empty: string;
+    loading: string;
+    failed: string;
+    retry: string;
+}): import("react").JSX.Element;

package/dist/shared/locale-context.d.ts

@@ -0,0 +1,8 @@
+import type { ReactNode } from 'react';
+import type { Locale } from './locale.js';
+/** A local prop overrides the nearest language scope without changing requests. */
+export declare function useLocale(locale?: Locale): Locale;
+export declare function LocaleProvider({ locale, children, }: {
+    locale?: Locale;
+    children?: ReactNode;
+}): import("react").JSX.Element;