rtcpts 0.0.6 → 0.0.8

package/dist/components/j-c-editable-proxy/index.d.ts

@@ -1,6 +1,7 @@
 import { PropType, SlotsType, DefineComponent, ExtractPropTypes, Ref, ComponentOptionsMixin, PublicProps, ComputedRef, ComponentProvideOptions } from 'vue';
-import { QBtn, QCard, QCardActions, QCardSection, QIcon, QPopupProxy, ComponentConstructor } from 'quasar';
+import { QCard, QCardActions, QCardSection, QIcon, QPopupProxy, ComponentConstructor, QBtn, QTooltip } from 'quasar';
 import { t } from '../..';
+import { JQButtonSizeType, JQButtonTypeType, JQButtonSlots } from '../j-q-button/index';
 type ModelValueType = any;
 export interface QInputRef {
     validate: () => boolean;
@@ -150,6 +151,92 @@ declare const _default: DefineComponent<ExtractPropTypes<{
     QCard: ComponentConstructor<QCard>;
     QCardSection: ComponentConstructor<QCardSection>;
     QCardActions: ComponentConstructor<QCardActions>;
-    QBtn: ComponentConstructor<QBtn>;
+    JQButton: DefineComponent<ExtractPropTypes<{
+        size: {
+            type: PropType< JQButtonSizeType>;
+            default: "large";
+            validator: (value: JQButtonSizeType) => boolean;
+        };
+        type: {
+            type: PropType< JQButtonTypeType>;
+            default: "primary";
+            validator: (value: JQButtonTypeType) => boolean;
+        };
+        label: {
+            type: StringConstructor;
+            default: string;
+        };
+        icon: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        loading: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        tips: {
+            type: StringConstructor;
+            default: string;
+        };
+    }>, {
+        computedClass: ComputedRef<{
+            [x: string]: boolean;
+            'j-q-button': boolean;
+            'j-q-button--primary': boolean;
+            'j-q-button--secondary': boolean;
+            'j-q-button--text'?: undefined;
+        } | {
+            'j-q-button--text': boolean;
+            'j-q-button'?: undefined;
+            'j-q-button--primary'?: undefined;
+            'j-q-button--secondary'?: undefined;
+        }>;
+        iconPadding: ComputedRef<{
+            'j-q-button-label': string | (() => any) | undefined;
+        }>;
+        click: (e: Event) => void;
+        qBtnRef: Ref< QBtn | null, QBtn | null>;
+    }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+        click: (e: Event) => true;
+    }, string, PublicProps, Readonly< ExtractPropTypes<{
+        size: {
+            type: PropType< JQButtonSizeType>;
+            default: "large";
+            validator: (value: JQButtonSizeType) => boolean;
+        };
+        type: {
+            type: PropType< JQButtonTypeType>;
+            default: "primary";
+            validator: (value: JQButtonTypeType) => boolean;
+        };
+        label: {
+            type: StringConstructor;
+            default: string;
+        };
+        icon: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        loading: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        tips: {
+            type: StringConstructor;
+            default: string;
+        };
+    }>> & Readonly<{
+        onClick?: ((e: Event) => any) | undefined;
+    }>, {
+        type: JQButtonTypeType;
+        size: JQButtonSizeType;
+        label: string;
+        icon: string;
+        loading: boolean;
+        tips: string;
+    }, SlotsType< JQButtonSlots>, {
+        QBtn: ComponentConstructor<QBtn>;
+        QTooltip: ComponentConstructor<QTooltip>;
+    }, {}, string, ComponentProvideOptions, true, {}, any>;
 }, {}, string, ComponentProvideOptions, true, {}, any>;
 export default _default;

package/dist/components/j-c-fallback/index.d.ts

@@ -1,18 +1,32 @@
 import { PropType, SlotsType, DefineComponent, ExtractPropTypes, ComputedRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
 type FallbackValue = any;
 declare const _default: DefineComponent<ExtractPropTypes<{
+    /**
+     * 需要判断是否存在的原始值 (例如：row.name)。
+     * * 接受任何类型。
+     */
     value: {
         type: PropType<FallbackValue>;
         default: null;
     };
+    /**
+     * 无值时显示的默认内容
+     */
     defaultContent: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 是否在无值时彻底隐藏组件，而不是显示 defaultContent
+     */
     rmDom: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * 可选：是否把 0 或 '0' 视为有效值 (true)，或视为需要回退的值 (false)。
+     * 默认情况下，与 defaultFormat 逻辑保持一致：0 和 '0' 被视为有效值。
+     */
     zeroIsValid: {
         type: BooleanConstructor;
         default: boolean;
@@ -24,18 +38,32 @@ declare const _default: DefineComponent<ExtractPropTypes<{
 }>, {
     hasValue: ComputedRef<boolean>;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
+    /**
+     * 需要判断是否存在的原始值 (例如：row.name)。
+     * * 接受任何类型。
+     */
     value: {
         type: PropType<FallbackValue>;
         default: null;
     };
+    /**
+     * 无值时显示的默认内容
+     */
     defaultContent: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 是否在无值时彻底隐藏组件，而不是显示 defaultContent
+     */
     rmDom: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * 可选：是否把 0 或 '0' 视为有效值 (true)，或视为需要回退的值 (false)。
+     * 默认情况下，与 defaultFormat 逻辑保持一致：0 和 '0' 被视为有效值。
+     */
     zeroIsValid: {
         type: BooleanConstructor;
         default: boolean;

package/dist/components/j-c-format-lookup/index.d.ts

@@ -1,28 +1,50 @@
 import { PropType, SlotsType, DefineComponent, ExtractPropTypes, ComputedRef, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+/**
+ * 通用的选项类型定义
+ */
 export interface OptionItem {
     label: string;
     value: any;
     [key: string]: any;
 }
+/**
+ * 查找键的类型
+ */
 type LookupKey = 'label' | 'value';
 declare const _default: DefineComponent<ExtractPropTypes<{
+    /**
+     * 要查找的值 (例如：表格行中的某个 ID 或名称)。
+     */
     value: {
         type: PropType<any>;
         default: null;
     };
+    /**
+     * 选项列表，组件会在这个列表中进行查找。
+     */
     options: {
         type: PropType<OptionItem[]>;
         required: true;
     };
+    /**
+     * 指定查找时是匹配 options 元素的 'value' 还是 'label' 属性。
+     * 默认会同时匹配 'value' 和 'label' (如果提供了两个键)。
+     */
     matchKeys: {
         type: PropType<LookupKey[]>;
         default: () => string[];
         validator: (val: LookupKey[]) => boolean;
     };
+    /**
+     * 查找失败时显示的默认内容
+     */
     defaultContent: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 是否在查找失败时彻底隐藏组件，而不是显示 defaultContent
+     */
     rmDom: {
         type: BooleanConstructor;
         default: boolean;
@@ -31,23 +53,39 @@ declare const _default: DefineComponent<ExtractPropTypes<{
     hasMatch: ComputedRef<boolean>;
     displayLabel: ComputedRef<string>;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
+    /**
+     * 要查找的值 (例如：表格行中的某个 ID 或名称)。
+     */
     value: {
         type: PropType<any>;
         default: null;
     };
+    /**
+     * 选项列表，组件会在这个列表中进行查找。
+     */
     options: {
         type: PropType<OptionItem[]>;
         required: true;
     };
+    /**
+     * 指定查找时是匹配 options 元素的 'value' 还是 'label' 属性。
+     * 默认会同时匹配 'value' 和 'label' (如果提供了两个键)。
+     */
     matchKeys: {
         type: PropType<LookupKey[]>;
         default: () => string[];
         validator: (val: LookupKey[]) => boolean;
     };
+    /**
+     * 查找失败时显示的默认内容
+     */
     defaultContent: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 是否在查找失败时彻底隐藏组件，而不是显示 defaultContent
+     */
     rmDom: {
         type: BooleanConstructor;
         default: boolean;

package/dist/components/j-c-more-menu/index.d.ts

@@ -8,15 +8,26 @@ type LabelLike<T> = string | ((ctx: {
 type TranslateFn = (key: string, variables?: Record<string, any>) => string;
 export type JCMoreMenuAction<T = any> = {
     key?: string | number;
+    /** 用于图标插槽的唯一标识（选填） */
+    id?: string;
+    /** 权限码；不传则默认当作有权限 */
     permissionCode?: string | null;
+    /** 无权限时是否移除 DOM（默认 true） */
     rmDom?: boolean;
+    /** 无权限且 rmDom=false 时显示的默认文案 */
     defaultContent?: string;
+    /** 文案：优先 label，其次 i18nKey */
     label?: LabelLike<T>;
     i18nKey?: string;
+    /** 是否可点击（默认 true） */
     clickable?: boolean;
+    /** 点击后是否自动关闭弹层（默认 true） */
     closePopup?: boolean;
+    /** 是否显示该 action（默认 true） */
     visible?: BoolLike<T>;
+    /** 是否禁用该 action（默认 false） */
     disabled?: BoolLike<T>;
+    /** 点击回调 */
     onClick?: (item: T) => void | Promise<void>;
 };
 declare const _default: DefineComponent<ExtractPropTypes<{
@@ -28,8 +39,8 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: PropType<JCMoreMenuAction<any>[]>;
         default: () => never[];
     };
-    preset: {
-        type: PropType<"option" | "action">;
+    size: {
+        type: PropType<"md" | "lg">;
         default: string;
     };
     fit: {
@@ -44,6 +55,9 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: string;
     };
+    /**
+     * size=lg 时生效：默认 offset/anchor/self/minWidth 贴近业务中的写法
+     */
     offset: {
         type: PropType<[number, number]>;
         default: undefined;
@@ -68,12 +82,17 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: PropType<TranslateFn | undefined>;
         default: undefined;
     };
+    showEmptyPlaceholder: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 }>, {
     hasVisibleActions: ComputedRef<boolean>;
     isActionVisible: (action: JCMoreMenuAction<any>) => boolean;
     isActionDisabled: (action: JCMoreMenuAction<any>) => boolean;
     shouldShowAction: (action: JCMoreMenuAction<any>) => boolean;
-    preset: ComputedRef<"option" | "action">;
+    size: ComputedRef<"lg" | "md">;
+    showEmptyPlaceholder: ComputedRef<boolean>;
     computedFit: ComputedRef<boolean>;
     computedOffset: ComputedRef<[number, number] | undefined>;
     computedAnchor: ComputedRef<"top middle" | "top left" | "top right" | "top start" | "top end" | "center left" | "center middle" | "center right" | "center start" | "center end" | "bottom left" | "bottom middle" | "bottom right" | "bottom start" | "bottom end" | undefined>;
@@ -85,6 +104,7 @@ declare const _default: DefineComponent<ExtractPropTypes<{
     computedMenuAttrs: ComputedRef<Record<string, string | undefined>>;
     getActionLabel: (action: JCMoreMenuAction<any>) => string;
     handleActionClick: (action: JCMoreMenuAction<any>) => Promise<void>;
+    hasMenuIconSlot: (action: JCMoreMenuAction<any>) => boolean;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
     action: (payload: {
         action: JCMoreMenuAction<any>;
@@ -99,8 +119,8 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: PropType<JCMoreMenuAction<any>[]>;
         default: () => never[];
     };
-    preset: {
-        type: PropType<"option" | "action">;
+    size: {
+        type: PropType<"md" | "lg">;
         default: string;
     };
     fit: {
@@ -115,6 +135,9 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: StringConstructor;
         default: string;
     };
+    /**
+     * size=lg 时生效：默认 offset/anchor/self/minWidth 贴近业务中的写法
+     */
     offset: {
         type: PropType<[number, number]>;
         default: undefined;
@@ -139,24 +162,29 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         type: PropType<TranslateFn | undefined>;
         default: undefined;
     };
+    showEmptyPlaceholder: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
 }>> & Readonly<{
     onAction?: ((payload: {
         action: JCMoreMenuAction<any>;
         item: any;
     }) => any) | undefined;
 }>, {
+    size: "lg" | "md";
     anchor: "top middle" | "top left" | "top right" | "top start" | "top end" | "center left" | "center middle" | "center right" | "center start" | "center end" | "bottom left" | "bottom middle" | "bottom right" | "bottom start" | "bottom end" | undefined;
     item: any;
     dense: boolean;
     self: "top middle" | "top left" | "top right" | "top start" | "top end" | "center left" | "center middle" | "center right" | "center start" | "center end" | "bottom left" | "bottom middle" | "bottom right" | "bottom start" | "bottom end" | undefined;
     offset: [number, number];
     actions: JCMoreMenuAction<any>[];
-    preset: "option" | "action";
     fit: boolean | undefined;
     triggerSize: string;
     listMinWidth: string | undefined;
     menuClass: any;
     translate: TranslateFn | undefined;
+    showEmptyPlaceholder: boolean;
 }, {}, {
     QIcon: ComponentConstructor<QIcon>;
     QMenu: ComponentConstructor<QMenu>;

package/dist/components/j-c-permission/index.d.ts

@@ -3,22 +3,37 @@ type PermissionCode = string;
 export declare const PAGE_ACTION_PERMISSION_KEY: unique symbol;
 export declare const PAGE_PERMISSION_KEY: unique symbol;
 declare const _default: DefineComponent<ExtractPropTypes<{
+    /**
+     * 权限码。如果传递 falsy 值（如 null, undefined, 或空字符串），则默认认为有权限（用来测试或特殊逻辑）
+     */
     code: {
         type: PropType<PermissionCode | null>;
         default: null;
     };
+    /**
+     * 无权限时显示的默认内容
+     */
     defaultContent: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 是否在无权限时彻底隐藏组件，而不是显示 defaultContent
+     */
     rmDom: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * 权限码列表（优先用 props 传入的，如果没有则用全局注入的）
+     */
     pagePermissionId: {
         type: PropType<PermissionCode[]>;
         default: undefined;
     };
+    /**
+     * 操作权限码列表（优先用 props 传入的，如果没有则用全局注入的）
+     */
     pageActionPermissionId: {
         type: PropType<PermissionCode[]>;
         default: undefined;
@@ -27,22 +42,37 @@ declare const _default: DefineComponent<ExtractPropTypes<{
     hasPermission: ComputedRef<boolean>;
     canRender: ComputedRef<boolean>;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {}, string, PublicProps, Readonly< ExtractPropTypes<{
+    /**
+     * 权限码。如果传递 falsy 值（如 null, undefined, 或空字符串），则默认认为有权限（用来测试或特殊逻辑）
+     */
     code: {
         type: PropType<PermissionCode | null>;
         default: null;
     };
+    /**
+     * 无权限时显示的默认内容
+     */
     defaultContent: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 是否在无权限时彻底隐藏组件，而不是显示 defaultContent
+     */
     rmDom: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * 权限码列表（优先用 props 传入的，如果没有则用全局注入的）
+     */
     pagePermissionId: {
         type: PropType<PermissionCode[]>;
         default: undefined;
     };
+    /**
+     * 操作权限码列表（优先用 props 传入的，如果没有则用全局注入的）
+     */
     pageActionPermissionId: {
         type: PropType<PermissionCode[]>;
         default: undefined;

package/dist/components/j-c-tabs/index.d.ts

@@ -6,6 +6,7 @@ export interface TabOption {
     label: string;
     value: TModelValue;
     disable?: boolean;
+    /** 单个 tab 的最大宽度（优先级高于 itemMaxWidth） */
     maxWidth?: string | number;
 }
 declare const _default: DefineComponent<ExtractPropTypes<{
@@ -26,14 +27,17 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         default: string;
         validator: (val: string) => boolean;
     };
+    /** tabs 支持换行（多行展示） */
     wrap: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /** tabs 扩展铺满（每个 item 等分） */
     expand: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /** tab item 最大宽度，超出省略号，hover tooltip 显示完整内容 */
     itemMaxWidth: {
         type: PropType<string | number>;
         default: undefined;
@@ -63,14 +67,17 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         default: string;
         validator: (val: string) => boolean;
     };
+    /** tabs 支持换行（多行展示） */
     wrap: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /** tabs 扩展铺满（每个 item 等分） */
     expand: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /** tab item 最大宽度，超出省略号，hover tooltip 显示完整内容 */
     itemMaxWidth: {
         type: PropType<string | number>;
         default: undefined;

package/dist/components/j-c-tree/index.d.ts

@@ -12,5 +12,12 @@ interface TransformConfig {
     optionValue?: string;
     optionChildren?: string;
 }
+/**
+ * 把通用数组转成 label/value/children 格式的数组。
+ *
+ * @param array 待转换的原始数组。
+ * @param config 包含自定义键名的配置对象。
+ * @returns 转换后的 TargetOption 数组。
+ */
 export declare function transformTreeUseLabelAndValue(array: RawItem[], config?: TransformConfig): TargetOption[];
 export {};

package/dist/components/j-q-button/index.d.ts

@@ -1,40 +1,54 @@
-import { PropType, DefineComponent, ExtractPropTypes, ComputedRef, Slot, Ref, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
+import { PropType, SlotsType, DefineComponent, ExtractPropTypes, ComputedRef, Ref, ComponentOptionsMixin, PublicProps, ComponentProvideOptions } from 'vue';
 import { QBtn, QTooltip, ComponentConstructor } from 'quasar';
-declare const enum TypeEnum {
-    PRIMARY = "primary",
-    SECONDARY = "secondary",
-    TEXT = "text"
-}
-declare const enum IconSizeEnum {
-    LARGE = "large",
-    NORMAL = "normal",
-    SMALL = "small"
-}
-type Size = IconSizeEnum;
-type Type = TypeEnum;
+import { JQButtonSizeType, JQButtonTypeType, JQButtonSlots } from './types';
+export * from './types';
 declare const _default: DefineComponent<ExtractPropTypes<{
+    /**
+     * 按钮大小
+     * @default 'large'
+     */
     size: {
-        type: PropType<Size>;
-        default: string;
-        validator: (value: Size) => boolean;
+        type: PropType<JQButtonSizeType>;
+        default: "large";
+        validator: (value: JQButtonSizeType) => boolean;
     };
+    /**
+     * 按钮类型
+     * @default 'primary'
+     */
     type: {
-        type: PropType<Type>;
-        default: TypeEnum;
-        validator: (value: Type) => boolean;
+        type: PropType<JQButtonTypeType>;
+        default: "primary";
+        validator: (value: JQButtonTypeType) => boolean;
     };
+    /**
+     * 按钮标签文字
+     * @default ''
+     */
     label: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 按钮图标 (Quasar icon name)
+     * @default undefined
+     */
     icon: {
         type: StringConstructor;
         default: undefined;
     };
+    /**
+     * 按钮加载状态
+     * @default false
+     */
     loading: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * 按钮提示文字 (tooltip)
+     * @default ''
+     */
     tips: {
         type: StringConstructor;
         default: string;
@@ -53,35 +67,63 @@ declare const _default: DefineComponent<ExtractPropTypes<{
         'j-q-button--secondary'?: undefined;
     }>;
     iconPadding: ComputedRef<{
-        'j-q-button-label': string | Slot<any> | undefined;
+        'j-q-button-label': string | (() => any) | undefined;
     }>;
     click: (e: Event) => void;
     qBtnRef: Ref<QBtn | null, QBtn | null>;
 }, {}, {}, {}, ComponentOptionsMixin, ComponentOptionsMixin, {
+    /**
+     * 点击事件
+     * @param e 原生点击事件
+     */
     click: (e: Event) => true;
 }, string, PublicProps, Readonly< ExtractPropTypes<{
+    /**
+     * 按钮大小
+     * @default 'large'
+     */
     size: {
-        type: PropType<Size>;
-        default: string;
-        validator: (value: Size) => boolean;
+        type: PropType<JQButtonSizeType>;
+        default: "large";
+        validator: (value: JQButtonSizeType) => boolean;
     };
+    /**
+     * 按钮类型
+     * @default 'primary'
+     */
     type: {
-        type: PropType<Type>;
-        default: TypeEnum;
-        validator: (value: Type) => boolean;
+        type: PropType<JQButtonTypeType>;
+        default: "primary";
+        validator: (value: JQButtonTypeType) => boolean;
     };
+    /**
+     * 按钮标签文字
+     * @default ''
+     */
     label: {
         type: StringConstructor;
         default: string;
     };
+    /**
+     * 按钮图标 (Quasar icon name)
+     * @default undefined
+     */
     icon: {
         type: StringConstructor;
         default: undefined;
     };
+    /**
+     * 按钮加载状态
+     * @default false
+     */
     loading: {
         type: BooleanConstructor;
         default: boolean;
     };
+    /**
+     * 按钮提示文字 (tooltip)
+     * @default ''
+     */
     tips: {
         type: StringConstructor;
         default: string;
@@ -89,13 +131,13 @@ declare const _default: DefineComponent<ExtractPropTypes<{
 }>> & Readonly<{
     onClick?: ((e: Event) => any) | undefined;
 }>, {
-    type: TypeEnum;
-    size: IconSizeEnum;
+    type: JQButtonTypeType;
+    size: JQButtonSizeType;
     label: string;
     icon: string;
     loading: boolean;
     tips: string;
-}, {}, {
+}, SlotsType<JQButtonSlots>, {
     QBtn: ComponentConstructor<QBtn>;
     QTooltip: ComponentConstructor<QTooltip>;
 }, {}, string, ComponentProvideOptions, true, {}, any>;