@cregis/ui 1.0.9 → 1.0.13

package/dist/types/index.d.ts

@@ -175,6 +175,15 @@ export declare interface CheckboxProps {
     indeterminate?: boolean;
 }
 
+export declare interface ClickOutsideOptions {
+    /** 忽略的元素列表，点击这些元素内部不会触发回调（如触发弹窗的按钮） */
+    ignore?: ClickOutsideTarget[];
+    /** 是否在捕获阶段监听，默认 true，可穿透子元素的 event.stopPropagation() */
+    capture?: boolean;
+}
+
+export declare type ClickOutsideTarget = MaybeRef<HTMLElement | null | undefined>;
+
 /** 函数式确认弹框，点击确定 resolve，点击取消 reject('cancel') */
 declare function confirm_2(source: ConfirmParam): Promise<void>;
 export { confirm_2 as confirm }
@@ -280,6 +289,8 @@ export declare interface DividerProps {
     length?: string;
 }
 
+export declare const getDialogZIndex: () => number;
+
 export declare type IconButtonType = 'rectangle' | 'square' | 'circle' | 'professional';
 
 export declare const Input: DefineComponent<InputProps, {
@@ -342,6 +353,8 @@ export declare interface InputProps {
 
 export declare type LanguageKey = 'zh-CN' | 'zh-TW' | 'en-US';
 
+declare type MaybeRef<T> = T | Ref<T>;
+
 /** 函数式轻提示，默认停留 1s，可通过对象配置时长；已有提示展示时忽略新调用 */
 export declare function Message(source: MessageParam): void;
 
@@ -546,6 +559,8 @@ export declare interface SelectScrollPayload {
 
 export declare const setCregisUILocale: (lang: LanguageKey) => void;
 
+export declare const setDialogZIndex: (_zIndex: number) => void;
+
 declare type Size = 'large' | 'medium' | 'small' | 'extraSmall';
 
 declare type Size_2 = 'large' | 'medium' | 'small' | 'extraSmall';
@@ -707,4 +722,20 @@ export declare interface UploadProps {
     onChange?: (file: FormData) => void;
 }
 
+/**
+ * 点击目标元素外部时触发回调的 Hook。
+ *
+ * - 使用 pointerdown + click 组合，精准区分「拖拽」与「点击外部」
+ * - capture 默认开启，不被子节点 stopPropagation 干扰
+ * - 支持单个或多个目标元素，支持 ignore 排除列表
+ *
+ * @example
+ * const panelRef = ref<HTMLElement>()
+ * useClickOutside(panelRef, () => closePanel())
+ *
+ * @example
+ * useClickOutside([panelRef, triggerRef], callback, { ignore: [buttonRef] })
+ */
+export declare function useClickOutside(target: ClickOutsideTarget | ClickOutsideTarget[], callback: (event: PointerEvent) => void, options?: ClickOutsideOptions): void;
+
 export { }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cregis/ui",
   "private": false,
-  "version": "1.0.9",
+  "version": "1.0.13",
   "type": "module",
   "files": [
     "dist"