@vaebe/ccui 2.0.1-beta.2 → 2.0.1-beta.3

package/form/src/form-types.d.ts

@@ -0,0 +1,360 @@
+import type { ComputedRef, ExtractPropTypes, InjectionKey, PropType, Ref } from 'vue';
+export type FormNamePath = string | number | Array<string | number>;
+export type FormLabelPosition = 'left' | 'right' | 'top';
+export type FormLayout = 'horizontal' | 'vertical' | 'inline';
+export type FormValidateTrigger = 'change' | 'blur' | 'submit';
+export type FormValidateStatus = '' | 'validating' | 'success' | 'error' | 'warning';
+export type FormModel = Record<string, any>;
+export type FormRequiredMark = boolean | 'optional';
+export interface FormValidateMessages {
+    default?: string;
+    required?: string;
+    enum?: string;
+    whitespace?: string;
+    pattern?: string;
+    types?: Partial<Record<NonNullable<FormRule['type']>, string>>;
+    string?: {
+        len?: string;
+        min?: string;
+        max?: string;
+        range?: string;
+    };
+    number?: {
+        len?: string;
+        min?: string;
+        max?: string;
+        range?: string;
+    };
+    array?: {
+        len?: string;
+        min?: string;
+        max?: string;
+        range?: string;
+    };
+}
+export interface FormRule {
+    required?: boolean;
+    message?: string;
+    trigger?: FormValidateTrigger | FormValidateTrigger[];
+    type?: 'string' | 'number' | 'boolean' | 'array' | 'object' | 'email' | 'url';
+    min?: number;
+    max?: number;
+    len?: number;
+    pattern?: RegExp;
+    enum?: any[];
+    whitespace?: boolean;
+    /**
+     * 仅警告：校验失败时 FormItem 状态降级为 `'warning'`，不阻塞 form-level submit/validate。
+     */
+    warningOnly?: boolean;
+    validator?: (rule: FormRule, value: any, model: FormModel) => boolean | string | Error | Promise<boolean | string | Error>;
+}
+/**
+ * rules 可以是规则对象、数组，或返回规则的工厂函数 `(form) => Rule | Rule[]`。
+ * 工厂函数每次校验时执行，可基于当前 form model 派生规则。
+ */
+export type FormRuleFactory = (model: FormModel) => FormRule | FormRule[];
+export type FormItemRule = FormRule | FormRule[] | FormRuleFactory;
+export type FormRules = Record<string, FormRule | FormRule[]>;
+/**
+ * 栅格对象（Grid Col 子集）。
+ *
+ * `labelCol` / `wrapperCol` 用 24 栅格制描述 label 与控件的宽度比例。
+ */
+export interface FormColAttrs {
+    /** 栅格占据数（0–24） */
+    span?: number;
+    /** 栅格偏移格数（0–24） */
+    offset?: number;
+    /** flex 布局字符串 */
+    flex?: string | number;
+}
+export interface FormValidateError {
+    field: string;
+    message: string;
+}
+export interface FormItemContext {
+    prop?: FormNamePath;
+    field: string;
+    dependencies: FormNamePath[];
+    validate: (trigger?: FormValidateTrigger) => Promise<boolean>;
+    resetField: () => void;
+    clearValidate: () => void;
+    getValidateMessage: () => string;
+    getElement: () => HTMLElement | null;
+}
+export interface FormContext {
+    model: Ref<FormModel>;
+    rules: Ref<FormRules>;
+    initialValues: Ref<FormModel>;
+    validateMessages: Ref<FormValidateMessages>;
+    disabled: Ref<boolean>;
+    labelWidth: Ref<string | number>;
+    labelPosition: Ref<FormLabelPosition>;
+    layout: Ref<FormLayout>;
+    colon: Ref<boolean>;
+    requiredMark: Ref<FormRequiredMark>;
+    preserve: Ref<boolean>;
+    /** Form 级栅格列。FormItem 显式 labelCol 优先。 */
+    labelCol: Ref<FormColAttrs | undefined>;
+    /** Form 级栅格列。FormItem 显式 wrapperCol 优先。 */
+    wrapperCol: Ref<FormColAttrs | undefined>;
+    /** Form 级 hasFeedback 默认值。FormItem 显式 hasFeedback 优先。 */
+    hasFeedback: Ref<boolean>;
+    addField: (field: FormItemContext) => void;
+    removeField: (field: FormItemContext) => void;
+    emitValidate: (field: string, valid: boolean, message: string) => void;
+    validateField: (propsToValidate: FormNamePath | FormNamePath[], trigger?: FormValidateTrigger) => Promise<boolean>;
+    notifyFieldChange: (field: FormNamePath, value: any) => void;
+}
+export declare const formInjectionKey: InjectionKey<FormContext>;
+export interface FormItemInjectedContext {
+    validateStatus: Ref<FormValidateStatus>;
+    isInsideForm: boolean;
+    validate: (trigger?: FormValidateTrigger) => Promise<boolean>;
+}
+export declare const formItemInjectionKey: InjectionKey<FormItemInjectedContext>;
+export interface FormListField {
+    key: number;
+    name: number;
+}
+export interface FormListOperation {
+    add: (defaultValue?: any, insertIndex?: number) => void;
+    remove: (index: number | number[]) => void;
+    move: (from: number, to: number) => void;
+}
+export interface FormListContext {
+    prefixName: ComputedRef<Array<string | number>>;
+}
+export declare const formListInjectionKey: InjectionKey<FormListContext>;
+export interface FormInstance {
+    validate: (callback?: (valid: boolean, errors: FormValidateError[]) => void) => Promise<boolean>;
+    validateField: (propsToValidate: FormNamePath | FormNamePath[], trigger?: FormValidateTrigger) => Promise<boolean>;
+    resetFields: (propsToReset?: FormNamePath | FormNamePath[]) => void;
+    clearValidate: (propsToClear?: FormNamePath | FormNamePath[]) => void;
+    scrollToField: (name: FormNamePath, options?: ScrollIntoViewOptions) => void;
+    getFieldsValue: () => FormModel;
+}
+export interface FormChangeInfo {
+    changedFields: Array<{
+        name: FormNamePath;
+        value: any;
+    }>;
+    forms: Record<string, FormInstance>;
+}
+export interface FormFinishInfo {
+    values: FormModel;
+    forms: Record<string, FormInstance>;
+}
+export interface FormProviderContext {
+    registerForm: (name: string, instance: FormInstance) => void;
+    unregisterForm: (name: string) => void;
+    triggerFormChange: (name: string, changedFields: Array<{
+        name: FormNamePath;
+        value: any;
+    }>) => void;
+    triggerFormFinish: (name: string, values: FormModel) => void;
+}
+export declare const formProviderInjectionKey: InjectionKey<FormProviderContext>;
+export declare const formProps: {
+    readonly model: {
+        readonly type: PropType<FormModel>;
+        readonly default: () => {};
+    };
+    readonly rules: {
+        readonly type: PropType<FormRules>;
+        readonly default: () => {};
+    };
+    readonly initialValues: {
+        readonly type: PropType<FormModel>;
+        readonly default: () => {};
+    };
+    readonly labelWidth: {
+        readonly type: PropType<string | number>;
+        readonly default: "";
+    };
+    readonly labelPosition: {
+        readonly type: PropType<FormLabelPosition>;
+        readonly default: "right";
+    };
+    readonly disabled: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly layout: {
+        readonly type: PropType<FormLayout>;
+        readonly default: "horizontal";
+    };
+    readonly colon: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    readonly requiredMark: {
+        readonly type: PropType<FormRequiredMark>;
+        readonly default: true;
+    };
+    readonly validateMessages: {
+        readonly type: PropType<FormValidateMessages>;
+        readonly default: () => {};
+    };
+    readonly validateOnRuleChange: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    readonly scrollToFirstError: {
+        readonly type: PropType<boolean | ScrollIntoViewOptions>;
+        readonly default: false;
+    };
+    readonly name: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly preserve: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /**
+     * 栅格 label 列宽。配合 wrapperCol 使用，覆盖 `labelWidth` 的单一宽度方案。
+     */
+    readonly labelCol: {
+        readonly type: PropType<FormColAttrs>;
+        readonly default: undefined;
+    };
+    /**
+     * 栅格控件列宽。
+     */
+    readonly wrapperCol: {
+        readonly type: PropType<FormColAttrs>;
+        readonly default: undefined;
+    };
+    /**
+     * Form 级 hasFeedback：所有 FormItem 默认显示校验状态图标。FormItem 显式优先。
+     */
+    readonly hasFeedback: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+};
+export declare const formItemProps: {
+    /**
+     * 字段名，对应 Form `model` 的 key；嵌套用数组（如 `['user', 'email']`）。
+     */
+    readonly name: {
+        readonly type: PropType<FormNamePath>;
+        readonly default: undefined;
+    };
+    readonly label: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /**
+     * @deprecated 请改用 `name`。双写时 `name` 优先；旧名下一大版本移除。
+     */
+    readonly prop: {
+        readonly type: PropType<FormNamePath>;
+        readonly default: undefined;
+    };
+    readonly initialValue: {
+        readonly type: PropType<any>;
+        readonly default: undefined;
+    };
+    readonly required: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly rules: {
+        /**
+         * 支持规则对象、数组，或工厂函数 `(model) => Rule | Rule[]`。
+         */
+        readonly type: PropType<FormItemRule>;
+        readonly default: undefined;
+    };
+    readonly help: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly validateStatus: {
+        readonly type: PropType<FormValidateStatus>;
+        readonly default: "";
+    };
+    readonly extra: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly htmlFor: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    readonly colon: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    readonly hidden: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly noStyle: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    readonly dependencies: {
+        readonly type: PropType<FormNamePath[]>;
+        readonly default: () => never[];
+    };
+    readonly preserve: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /**
+     * @deprecated Vue 端的响应式系统已经自动处理依赖收集，通常无需指定。
+     * 保留 prop 接收以兼容现有代码；新代码不建议使用。详见 docs-notes/roadmap.md。
+     */
+    readonly shouldUpdate: {
+        readonly type: PropType<boolean | ((prevValues: any, curValues: any) => boolean)>;
+        readonly default: undefined;
+    };
+    /**
+     * FormItem 级 hasFeedback：显示 success / warning / error / validating 状态图标。
+     * 显式 `hasFeedback` 优先于 Form 级。
+     */
+    readonly hasFeedback: {
+        readonly type: BooleanConstructor;
+        readonly default: undefined;
+    };
+    /**
+     * 栅格 label 列宽（FormItem 级，覆盖 Form 级 labelCol）。
+     */
+    readonly labelCol: {
+        readonly type: PropType<FormColAttrs>;
+        readonly default: undefined;
+    };
+    /**
+     * 栅格控件列宽（FormItem 级，覆盖 Form 级 wrapperCol）。
+     */
+    readonly wrapperCol: {
+        readonly type: PropType<FormColAttrs>;
+        readonly default: undefined;
+    };
+    readonly validateDebounce: {
+        readonly type: NumberConstructor;
+        readonly default: 0;
+    };
+    readonly normalize: {
+        readonly type: PropType<(value: any, prevValue: any, allValues: any) => any>;
+        readonly default: undefined;
+    };
+};
+export declare const formListProps: {
+    readonly name: {
+        readonly type: PropType<FormNamePath>;
+        readonly required: true;
+    };
+    readonly initialValue: {
+        readonly type: PropType<any[]>;
+        readonly default: undefined;
+    };
+};
+export declare const formProviderProps: {};
+export type FormProps = ExtractPropTypes<typeof formProps>;
+export type FormItemProps = ExtractPropTypes<typeof formItemProps>;
+export type FormListProps = ExtractPropTypes<typeof formListProps>;

package/form/src/form.d.ts

@@ -0,0 +1,64 @@
+
+declare const _default: import("vue").DefineComponent<{
+    readonly name: string;
+    readonly layout: import("./form-types").FormLayout;
+    readonly preserve: boolean;
+    readonly disabled: boolean;
+    readonly model: import("./form-types").FormModel;
+    readonly rules: import("./form-types").FormRules;
+    readonly initialValues: import("./form-types").FormModel;
+    readonly labelWidth: string | number;
+    readonly labelPosition: import("./form-types").FormLabelPosition;
+    readonly colon: boolean;
+    readonly requiredMark: import("./form-types").FormRequiredMark;
+    readonly validateMessages: import("./form-types").FormValidateMessages;
+    readonly validateOnRuleChange: boolean;
+    readonly scrollToFirstError: boolean | ScrollIntoViewOptions;
+    readonly hasFeedback: boolean;
+    readonly labelCol?: import("./form-types").FormColAttrs | undefined;
+    readonly wrapperCol?: import("./form-types").FormColAttrs | undefined;
+}, () => import("vue").VNode<import("vue").RendererNode, import("vue").RendererElement, {
+    [key: string]: any;
+}>, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, ("submit" | "validate" | "validate-failed" | "values-change")[], "submit" | "validate" | "validate-failed" | "values-change", import("vue").PublicProps, Readonly<{
+    readonly name: string;
+    readonly layout: import("./form-types").FormLayout;
+    readonly preserve: boolean;
+    readonly disabled: boolean;
+    readonly model: import("./form-types").FormModel;
+    readonly rules: import("./form-types").FormRules;
+    readonly initialValues: import("./form-types").FormModel;
+    readonly labelWidth: string | number;
+    readonly labelPosition: import("./form-types").FormLabelPosition;
+    readonly colon: boolean;
+    readonly requiredMark: import("./form-types").FormRequiredMark;
+    readonly validateMessages: import("./form-types").FormValidateMessages;
+    readonly validateOnRuleChange: boolean;
+    readonly scrollToFirstError: boolean | ScrollIntoViewOptions;
+    readonly hasFeedback: boolean;
+    readonly labelCol?: import("./form-types").FormColAttrs | undefined;
+    readonly wrapperCol?: import("./form-types").FormColAttrs | undefined;
+}> & Readonly<{
+    onSubmit?: ((...args: any[]) => any) | undefined;
+    onValidate?: ((...args: any[]) => any) | undefined;
+    "onValidate-failed"?: ((...args: any[]) => any) | undefined;
+    "onValues-change"?: ((...args: any[]) => any) | undefined;
+}>, {
+    readonly name: string;
+    readonly layout: import("./form-types").FormLayout;
+    readonly preserve: boolean;
+    readonly disabled: boolean;
+    readonly model: import("./form-types").FormModel;
+    readonly rules: import("./form-types").FormRules;
+    readonly initialValues: import("./form-types").FormModel;
+    readonly labelWidth: string | number;
+    readonly labelPosition: import("./form-types").FormLabelPosition;
+    readonly colon: boolean;
+    readonly requiredMark: import("./form-types").FormRequiredMark;
+    readonly validateMessages: import("./form-types").FormValidateMessages;
+    readonly validateOnRuleChange: boolean;
+    readonly scrollToFirstError: boolean | ScrollIntoViewOptions;
+    readonly labelCol: import("./form-types").FormColAttrs;
+    readonly wrapperCol: import("./form-types").FormColAttrs;
+    readonly hasFeedback: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export default _default;

package/form/src/utils.d.ts

@@ -0,0 +1,10 @@
+import type { FormModel, FormNamePath, FormRule, FormValidateError, FormValidateMessages, FormValidateTrigger } from './form-types';
+export declare function normalizeNamePath(path?: FormNamePath): Array<string | number>;
+export declare function getPathKey(path?: FormNamePath): string;
+export declare function getValueByPath(model: FormModel, path?: FormNamePath): any;
+export declare function setValueByPath(model: FormModel, path: FormNamePath, value: any): void;
+export declare function deleteValueByPath(model: FormModel, path: FormNamePath): void;
+export declare function cloneValue<T>(value: T): T;
+export declare function normalizeRules(rules?: FormRule | FormRule[]): FormRule[];
+export declare function getTriggeredRules(rules: FormRule[], trigger?: FormValidateTrigger): FormRule[];
+export declare function validateRule(rule: FormRule, value: any, model: FormModel, field: string, label?: string, validateMessages?: FormValidateMessages): Promise<FormValidateError | null>;

package/grid/index.d.ts

@@ -0,0 +1,10 @@
+import type { App } from 'vue';
+import { Col, Row } from './src/grid';
+export { Col, Row };
+declare const _default: {
+    title: string;
+    category: string;
+    status: string;
+    install(app: App): void;
+};
+export default _default;

package/grid/src/grid-types.d.ts

@@ -0,0 +1,90 @@
+import type { ExtractPropTypes, PropType } from 'vue';
+export type Justify = 'start' | 'end' | 'center' | 'space-around' | 'space-between' | 'space-evenly';
+export type Align = 'top' | 'middle' | 'bottom' | 'stretch';
+export type Gutter = number | [number, number] | Partial<Record<Breakpoint, number | [number, number]>>;
+export type Breakpoint = 'xs' | 'sm' | 'md' | 'lg' | 'xl' | 'xxl';
+export interface ColSize {
+    span?: number;
+    order?: number;
+    offset?: number;
+    push?: number;
+    pull?: number;
+    flex?: string | number;
+}
+export type ColSizeProp = number | string | ColSize;
+export declare const rowProps: {
+    readonly justify: {
+        readonly type: PropType<Justify>;
+        readonly default: "start";
+    };
+    readonly align: {
+        readonly type: PropType<Align>;
+        readonly default: "top";
+    };
+    readonly gutter: {
+        readonly type: PropType<Gutter>;
+        readonly default: 0;
+    };
+    readonly wrap: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+};
+export declare const colProps: {
+    readonly span: {
+        readonly type: PropType<number | string>;
+        readonly default: undefined;
+    };
+    readonly order: {
+        readonly type: PropType<number | string>;
+        readonly default: undefined;
+    };
+    readonly offset: {
+        readonly type: PropType<number | string>;
+        readonly default: undefined;
+    };
+    readonly push: {
+        readonly type: PropType<number | string>;
+        readonly default: undefined;
+    };
+    readonly pull: {
+        readonly type: PropType<number | string>;
+        readonly default: undefined;
+    };
+    readonly flex: {
+        readonly type: PropType<number | string>;
+        readonly default: undefined;
+    };
+    readonly xs: {
+        readonly type: PropType<ColSizeProp>;
+        readonly default: undefined;
+    };
+    readonly sm: {
+        readonly type: PropType<ColSizeProp>;
+        readonly default: undefined;
+    };
+    readonly md: {
+        readonly type: PropType<ColSizeProp>;
+        readonly default: undefined;
+    };
+    readonly lg: {
+        readonly type: PropType<ColSizeProp>;
+        readonly default: undefined;
+    };
+    readonly xl: {
+        readonly type: PropType<ColSizeProp>;
+        readonly default: undefined;
+    };
+    readonly xxl: {
+        readonly type: PropType<ColSizeProp>;
+        readonly default: undefined;
+    };
+};
+export type RowProps = ExtractPropTypes<typeof rowProps>;
+export type ColProps = ExtractPropTypes<typeof colProps>;
+export declare const BREAKPOINT_PX: Record<Breakpoint, number>;
+export declare const BREAKPOINTS: Breakpoint[];
+export declare const ROW_INJECT_KEY: unique symbol;
+export interface RowContext {
+    gutter: [number, number];
+}

package/grid/src/grid.d.ts

@@ -0,0 +1,58 @@
+import type { ColSizeProp, Gutter } from './grid-types';
+
+export declare const Row: import("vue").DefineComponent<{
+    readonly wrap: boolean;
+    readonly justify: import("./grid-types").Justify;
+    readonly align: import("./grid-types").Align;
+    readonly gutter: Gutter;
+}, () => JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    readonly wrap: boolean;
+    readonly justify: import("./grid-types").Justify;
+    readonly align: import("./grid-types").Align;
+    readonly gutter: Gutter;
+}> & Readonly<{}>, {
+    readonly wrap: boolean;
+    readonly justify: import("./grid-types").Justify;
+    readonly align: import("./grid-types").Align;
+    readonly gutter: Gutter;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;
+export declare const Col: import("vue").DefineComponent<{
+    readonly span?: string | number | undefined;
+    readonly push?: string | number | undefined;
+    readonly order?: string | number | undefined;
+    readonly flex?: string | number | undefined;
+    readonly offset?: string | number | undefined;
+    readonly xs?: ColSizeProp | undefined;
+    readonly sm?: ColSizeProp | undefined;
+    readonly md?: ColSizeProp | undefined;
+    readonly lg?: ColSizeProp | undefined;
+    readonly xl?: ColSizeProp | undefined;
+    readonly xxl?: ColSizeProp | undefined;
+    readonly pull?: string | number | undefined;
+}, () => JSX.Element, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    readonly span?: string | number | undefined;
+    readonly push?: string | number | undefined;
+    readonly order?: string | number | undefined;
+    readonly flex?: string | number | undefined;
+    readonly offset?: string | number | undefined;
+    readonly xs?: ColSizeProp | undefined;
+    readonly sm?: ColSizeProp | undefined;
+    readonly md?: ColSizeProp | undefined;
+    readonly lg?: ColSizeProp | undefined;
+    readonly xl?: ColSizeProp | undefined;
+    readonly xxl?: ColSizeProp | undefined;
+    readonly pull?: string | number | undefined;
+}> & Readonly<{}>, {
+    readonly span: string | number;
+    readonly push: string | number;
+    readonly order: string | number;
+    readonly flex: string | number;
+    readonly offset: string | number;
+    readonly xs: ColSizeProp;
+    readonly sm: ColSizeProp;
+    readonly md: ColSizeProp;
+    readonly lg: ColSizeProp;
+    readonly xl: ColSizeProp;
+    readonly xxl: ColSizeProp;
+    readonly pull: string | number;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, true, {}, any>;

package/icon/index.d.ts

@@ -0,0 +1,12 @@
+import type { App } from 'vue';
+import Icon from './src/icon';
+import { clearIconRegistry, registerIcon, resolveIcon, unregisterIcon } from './src/icon-registry';
+export { addAPIProvider, addCollection, addIcon, loadIcon, loadIcons } from '@iconify/vue';
+export { clearIconRegistry, Icon, registerIcon, resolveIcon, unregisterIcon };
+declare const _default: {
+    title: string;
+    category: string;
+    status: string;
+    install(app: App): void;
+};
+export default _default;

package/icon/src/icon-registry.d.ts

@@ -0,0 +1,5 @@
+import type { Component } from 'vue';
+export declare function registerIcon(name: string, component: Component): void;
+export declare function unregisterIcon(name: string): void;
+export declare function clearIconRegistry(): void;
+export declare function resolveIcon(name?: string): Component | undefined;