@manohub/ui 0.6.0

package/dist/components/radio/index.d.ts

@@ -0,0 +1,473 @@
+import { type PropType, type SlotsType, type VNodeChild } from 'vue';
+import type { ControlSize } from '../control-size';
+/**
+ * 单选族（一个文件三成员，对应面 `styles/components/radio.css` 的两段）：
+ *
+ * - `Radio`：单个选项（原生路径的受控叶，`checked` 由使用方算）
+ * - `Radio.Group`：普通单选组 —— 一行一项，横排 16 / 纵排 12
+ * - `Radio.Card`：卡片式单选组 —— 一个选项一张卡、整卡可点
+ *
+ * **判据**：选项只有一行文字 → `Radio.Group`；选项要「标题 + 说明」且整卡可点 → `Radio.Card`；
+ * 要按钮形态的分组 → `Capsule`（本族不重复造按钮档）。
+ *
+ * **受控口径（族内统一）**：两个组都是「受控传 `modelValue`，不传即非受控（由 `defaultValue` 起）」，
+ * 选中上报 `emit('update:modelValue')`（`v-model` 落地）+ `onChange` 双走 —— 与 `Capsule` /
+ * `Checkbox.Group` 同一份口径，故 `v-model` 是本族的推荐写法。
+ *
+ * **单选组必须有值**：`modelValue` 与非受控初值都没给时，落到**第一个可选项**（跳过禁用项）——
+ * 单选语义就是必选其一，与 `Tabset` 的「缺省第一项」同口径；没有可选项（表为空或全禁用）才是空值。
+ * 自排插槽（`Radio.Group` 不给 `options`）时组件无从推断有哪些值，缺省值由消费方自定。
+ *
+ * 状态表达不统一是**有意的**（各自贴着自己的面）：`Radio` 走原生 `input:checked + .mh-radio__box`
+ * （故 **input 必须紧邻框体之前**），`Radio.Card` 走卡片上的 `data-state`（卡片就是 label，圆点在卡内）。
+ */
+export interface RadioProps {
+    /** 本项的值（组内唯一） */
+    value: string | number;
+    /** 选项文字（复杂内容走默认插槽） */
+    label?: string;
+    /** 原生分组名（组内同名互斥；用 `Radio.Group` 时由组下发） */
+    name?: string;
+    /** 受控选中态（用 `Radio.Group` 时由组下发） */
+    checked?: boolean;
+    /** 禁用本项 */
+    disabled?: boolean;
+    /** 尺寸档（用 `Radio.Group` 时由组下发） */
+    size?: ControlSize;
+    /** 选中变化回调（原生 change 路径） */
+    onChange?: (value: string | number) => void;
+}
+/**
+ * 单选（普通单选组的选项件）：一行一个选项。
+ *
+ * 三源等价的选中态由样式层承担（原生 `:checked` / 组件 `[data-state]` / 静态档 `.is-*`），
+ * 本件只负责把原生 input 与自绘框体的顺序摆对（**input 必须在框体之前** —— 样式层靠
+ * `input:checked + .mh-radio__box` 选态）。
+ *
+ * @example 单用（自己管互斥）
+ * <Radio name="scope" value="all" label="全部" checked={v === 'all'} onChange={setV} />
+ */
+export declare const Radio: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+    value: {
+        type: PropType<string | number>;
+        required: true;
+    };
+    label: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    name: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    checked: {
+        type: PropType<boolean | undefined>;
+        default: undefined;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    size: {
+        type: PropType<ControlSize>;
+        default: string;
+    };
+    /** 自动聚焦 */
+    autofocus: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    onChange: {
+        type: PropType<(value: string | number) => void>;
+        default: undefined;
+    };
+}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+    value: {
+        type: PropType<string | number>;
+        required: true;
+    };
+    label: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    name: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    checked: {
+        type: PropType<boolean | undefined>;
+        default: undefined;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    size: {
+        type: PropType<ControlSize>;
+        default: string;
+    };
+    /** 自动聚焦 */
+    autofocus: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    onChange: {
+        type: PropType<(value: string | number) => void>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, {
+    size: ControlSize;
+    disabled: boolean;
+    name: string;
+    label: string;
+    onChange: (value: string | number) => void;
+    checked: boolean | undefined;
+    autofocus: boolean;
+}, SlotsType<{
+    default?: () => VNodeChild;
+}>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export interface RadioGroupOption {
+    label: string;
+    value: string | number;
+    disabled?: boolean;
+}
+export interface RadioGroupProps {
+    /** 选项表（给了就由本件渲染一行一项；也可改用默认插槽自己排） */
+    options?: RadioGroupOption[];
+    /** 受控值；不传即非受控（由 `defaultValue` 起，再缺省则为第一个可选项） */
+    modelValue?: string | number;
+    /** 非受控初始值（缺省 = 第一个可选项） */
+    defaultValue?: string | number;
+    /** 原生分组名（缺省自动生成，组内唯一即可） */
+    name?: string;
+    /** 纵向排列（缺省横向） */
+    vertical?: boolean;
+    /** 整组禁用 */
+    disabled?: boolean;
+    /** 尺寸档（透传给组内每一项） */
+    size?: ControlSize;
+    /** 选中变化回调（受控与非受控都会调） */
+    onChange?: (value: string | number) => void;
+}
+export type RadioCardValue = string | number;
+export interface RadioCardItem {
+    /** 选项值（业务值，与 `modelValue` 同域） */
+    value: RadioCardValue;
+    /** 选项名（卡片标题） */
+    label: string;
+    /** 选项说明（卡片第二段文字，可缺省） */
+    description?: string;
+    /** 单项禁用 */
+    disabled?: boolean;
+}
+export interface RadioCardProps {
+    /** 受控值；不传即非受控（由 `defaultValue` 起，再缺省则为第一个可选项） */
+    modelValue?: RadioCardValue;
+    /** 非受控初始值（缺省 = 第一个可选项） */
+    defaultValue?: RadioCardValue;
+    /** 选项表 */
+    items?: RadioCardItem[];
+    /** 每行几个（>1 时走等宽网格；缺省 1 列堆叠） */
+    columns?: number;
+    /** 整组禁用（与单项 `disabled` 叠加） */
+    disabled?: boolean;
+    /** 选中变化回调（受控与非受控都会调） */
+    onChange?: (value: RadioCardValue) => void;
+}
+/** 单选族复合件：`Radio`（选项）+ `.Group`（普通组）+ `.Card`（卡片组） */
+export declare const RadioCompound: {
+    new (...args: any[]): import("vue").CreateComponentPublicInstanceWithMixins<Readonly<import("vue").ExtractPropTypes<{
+        value: {
+            type: PropType<string | number>;
+            required: true;
+        };
+        label: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        name: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        checked: {
+            type: PropType<boolean | undefined>;
+            default: undefined;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        size: {
+            type: PropType<ControlSize>;
+            default: string;
+        };
+        /** 自动聚焦 */
+        autofocus: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        onChange: {
+            type: PropType<(value: string | number) => void>;
+            default: undefined;
+        };
+    }>> & Readonly<{}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, import("vue").PublicProps, {
+        size: ControlSize;
+        disabled: boolean;
+        name: string;
+        label: string;
+        onChange: (value: string | number) => void;
+        checked: boolean | undefined;
+        autofocus: boolean;
+    }, true, {}, SlotsType<{
+        default?: () => VNodeChild;
+    }>, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, {}, any, import("vue").ComponentProvideOptions, {
+        P: {};
+        B: {};
+        D: {};
+        C: {};
+        M: {};
+        Defaults: {};
+    }, Readonly<import("vue").ExtractPropTypes<{
+        value: {
+            type: PropType<string | number>;
+            required: true;
+        };
+        label: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        name: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        checked: {
+            type: PropType<boolean | undefined>;
+            default: undefined;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        size: {
+            type: PropType<ControlSize>;
+            default: string;
+        };
+        /** 自动聚焦 */
+        autofocus: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        onChange: {
+            type: PropType<(value: string | number) => void>;
+            default: undefined;
+        };
+    }>> & Readonly<{}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, {
+        size: ControlSize;
+        disabled: boolean;
+        name: string;
+        label: string;
+        onChange: (value: string | number) => void;
+        checked: boolean | undefined;
+        autofocus: boolean;
+    }>;
+    __isFragment?: never;
+    __isTeleport?: never;
+    __isSuspense?: never;
+} & import("vue").ComponentOptionsBase<Readonly<import("vue").ExtractPropTypes<{
+    value: {
+        type: PropType<string | number>;
+        required: true;
+    };
+    label: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    name: {
+        type: StringConstructor;
+        default: undefined;
+    };
+    checked: {
+        type: PropType<boolean | undefined>;
+        default: undefined;
+    };
+    disabled: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    size: {
+        type: PropType<ControlSize>;
+        default: string;
+    };
+    /** 自动聚焦 */
+    autofocus: {
+        type: BooleanConstructor;
+        default: boolean;
+    };
+    onChange: {
+        type: PropType<(value: string | number) => void>;
+        default: undefined;
+    };
+}>> & Readonly<{}>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, {
+    size: ControlSize;
+    disabled: boolean;
+    name: string;
+    label: string;
+    onChange: (value: string | number) => void;
+    checked: boolean | undefined;
+    autofocus: boolean;
+}, {}, string, SlotsType<{
+    default?: () => VNodeChild;
+}>, import("vue").GlobalComponents, import("vue").GlobalDirectives, string, import("vue").ComponentProvideOptions> & import("vue").VNodeProps & import("vue").AllowedComponentProps & import("vue").ComponentCustomProps & {
+    Group: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+        options: {
+            type: PropType<RadioGroupOption[]>;
+            default: undefined;
+        };
+        modelValue: {
+            type: PropType<string | number | undefined>;
+            default: undefined;
+        };
+        defaultValue: {
+            type: PropType<string | number | undefined>;
+            default: undefined;
+        };
+        name: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        vertical: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        size: {
+            type: PropType<ControlSize>;
+            default: string;
+        };
+        onChange: {
+            type: PropType<(value: string | number) => void>;
+            default: undefined;
+        };
+    }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+        'update:modelValue': (value: string | number) => true;
+    }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+        options: {
+            type: PropType<RadioGroupOption[]>;
+            default: undefined;
+        };
+        modelValue: {
+            type: PropType<string | number | undefined>;
+            default: undefined;
+        };
+        defaultValue: {
+            type: PropType<string | number | undefined>;
+            default: undefined;
+        };
+        name: {
+            type: StringConstructor;
+            default: undefined;
+        };
+        vertical: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        disabled: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        size: {
+            type: PropType<ControlSize>;
+            default: string;
+        };
+        onChange: {
+            type: PropType<(value: string | number) => void>;
+            default: undefined;
+        };
+    }>> & Readonly<{
+        "onUpdate:modelValue"?: ((value: string | number) => any) | undefined;
+    }>, {
+        size: ControlSize;
+        vertical: boolean;
+        disabled: boolean;
+        name: string;
+        onChange: (value: string | number) => void;
+        options: RadioGroupOption[];
+        defaultValue: string | number | undefined;
+        modelValue: string | number | undefined;
+    }, SlotsType<{
+        default?: (context: {
+            value: string | number | undefined;
+            select: (value: string | number) => void;
+        }) => VNodeChild;
+    }>, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+    Card: import("vue").DefineComponent<import("vue").ExtractPropTypes<{
+        modelValue: {
+            type: PropType<RadioCardValue | undefined>;
+            default: undefined;
+        };
+        defaultValue: {
+            type: PropType<RadioCardValue | undefined>;
+            default: undefined;
+        };
+        items: {
+            type: PropType<RadioCardItem[]>;
+            default: () => never[];
+        };
+        /** 每行几个（>1 时走等宽网格；缺省 1 列堆叠） */
+        columns: {
+            type: NumberConstructor;
+            default: number;
+        };
+        /** 整组禁用（与单项 `disabled` 叠加） */
+        disabled: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        onChange: {
+            type: PropType<(value: RadioCardValue) => void>;
+            default: undefined;
+        };
+    }>, () => import("vue/jsx-runtime").JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+        'update:modelValue': (value: RadioCardValue) => true;
+    }, string, import("vue").PublicProps, Readonly<import("vue").ExtractPropTypes<{
+        modelValue: {
+            type: PropType<RadioCardValue | undefined>;
+            default: undefined;
+        };
+        defaultValue: {
+            type: PropType<RadioCardValue | undefined>;
+            default: undefined;
+        };
+        items: {
+            type: PropType<RadioCardItem[]>;
+            default: () => never[];
+        };
+        /** 每行几个（>1 时走等宽网格；缺省 1 列堆叠） */
+        columns: {
+            type: NumberConstructor;
+            default: number;
+        };
+        /** 整组禁用（与单项 `disabled` 叠加） */
+        disabled: {
+            type: BooleanConstructor;
+            default: boolean;
+        };
+        onChange: {
+            type: PropType<(value: RadioCardValue) => void>;
+            default: undefined;
+        };
+    }>> & Readonly<{
+        "onUpdate:modelValue"?: ((value: RadioCardValue) => any) | undefined;
+    }>, {
+        disabled: boolean;
+        onChange: (value: RadioCardValue) => void;
+        defaultValue: RadioCardValue | undefined;
+        columns: number;
+        modelValue: RadioCardValue | undefined;
+        items: RadioCardItem[];
+    }, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+};
+export type RadioCompoundType = typeof RadioCompound;