foucui 2.2.2 → 2.3.1

package/README.md

@@ -14,9 +14,10 @@ pnpm add foucui
 ```ts
 import { setupFoucui, setupFou } from 'foucui'
 import 'foucui/dist/foucui.css'
-import 'foucui/styles/fou.scss'
 ```
 
+主题变量已打进 `foucui.css`。按需引入示例：`import { FouDialog, FouForm, FouSelect } from 'foucui'`。消费端需安装 peer：`vue`、`vue-router`、`@vueuse/core`、`pinia`。
+
 `setupFoucui` / `setupQiuye` / `setupFou` 行为一致。
 
 ## 画布套件 FouCanvasKit

package/dist/components/FouBreadcrumb/types.d.ts

@@ -0,0 +1,14 @@
+import { InjectionKey, Ref } from 'vue';
+import { RouteLocationRaw } from 'vue-router';
+export interface FouBreadcrumbItemData {
+    label: string;
+    to?: RouteLocationRaw;
+    replace?: boolean;
+    disabled?: boolean;
+    icon?: string;
+}
+export interface FouBreadcrumbContext {
+    separator: Ref<string>;
+    separatorIcon: Ref<string>;
+}
+export declare const FOU_BREADCRUMB_KEY: InjectionKey<FouBreadcrumbContext>;

package/dist/components/FouCalendar/types.d.ts

@@ -0,0 +1,5 @@
+export interface FouCalendarMark {
+    date: Date | string;
+    type?: 'primary' | 'success' | 'warning' | 'danger' | 'info';
+    content?: string;
+}

package/dist/components/FouConfigProvider/types.d.ts

@@ -0,0 +1,6 @@
+import { Ref } from 'vue';
+export interface FouConfigProviderContext {
+    size: Ref<'large' | 'default' | 'small'>;
+    locale: Ref<Record<string, string> | undefined>;
+    zIndex: Ref<number>;
+}

package/dist/components/FouFloatButton/context.d.ts

@@ -0,0 +1 @@
+export declare const FOU_FLOAT_GROUP_KEY: unique symbol;

package/dist/components/FouForm/types.d.ts

@@ -8,7 +8,7 @@ export type FouFormRule = {
     pattern?: RegExp;
     type?: string;
     trigger?: 'blur' | 'change' | Array<'blur' | 'change'>;
-    validator?: (rule: FouFormRule, value: any, callback: (error?: string | Error) => void) => void;
+    validator?: (rule: FouFormRule, value: any, callback: (error?: string | Error) => void) => void | boolean | Promise<void | boolean | string | Error>;
 };
 export type FouFormRules = Record<string, FouFormRule | FouFormRule[]>;
 export interface FouFormItemContext {
@@ -25,6 +25,7 @@ export interface FouFormContext {
     labelPosition: import('vue').ComputedRef<'left' | 'right' | 'top'>;
     disabled: import('vue').ComputedRef<boolean>;
     hideRequiredAsterisk: import('vue').ComputedRef<boolean>;
+    requireAsteriskPosition: import('vue').ComputedRef<'left' | 'right'>;
     addField: (field: FouFormItemContext) => void;
     removeField: (field: FouFormItemContext) => void;
     emitValidate: (prop: string, isValid: boolean, message: string) => void;

package/dist/components/FouImagePreviewGroup/context.d.ts

@@ -0,0 +1,6 @@
+export declare const FOU_IMAGE_GROUP_KEY: unique symbol;
+export interface FouImageGroupContext {
+    register: (src: string) => void;
+    unregister: (src: string) => void;
+    open: (src: string) => void;
+}

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

@@ -0,0 +1,14 @@
+import { App, Directive } from 'vue';
+export interface FouInfiniteScrollOptions {
+    handler?: () => void | Promise<void>;
+    disabled?: boolean;
+    delay?: number;
+    distance?: number;
+    immediate?: boolean;
+}
+type BindingValue = (() => void | Promise<void>) | FouInfiniteScrollOptions | undefined;
+export declare const vFouInfiniteScroll: Directive<HTMLElement, BindingValue>;
+declare const _default: {
+    install(app: App): void;
+};
+export default _default;

package/dist/components/FouSelect/types.d.ts

@@ -4,10 +4,12 @@ export interface FouSelectOption {
     label: string;
     disabled?: boolean;
 }
+export type FouSelectValue = string | number | boolean;
 export interface FouSelectContext {
-    modelValue: Ref<string | number | boolean | null | undefined>;
-    selectOption: (value: string | number | boolean, label: string) => void;
-    setHoverOption: (value: string | number | boolean) => void;
+    modelValue: Ref<FouSelectValue | FouSelectValue[] | null | undefined>;
+    multiple: Ref<boolean>;
+    selectOption: (value: FouSelectValue, label: string) => void;
+    setHoverOption: (value: FouSelectValue) => void;
     registerOption: (option: FouSelectOption) => void;
-    unregisterOption: (value: string | number | boolean) => void;
+    unregisterOption: (value: FouSelectValue) => void;
 }

package/dist/components/FouSplitter/types.d.ts

@@ -0,0 +1,19 @@
+import { InjectionKey, Ref } from 'vue';
+export interface FouSplitterPanelItem {
+    uid: number;
+    size?: number | string;
+    min?: number | string;
+    max?: number | string;
+    resizable?: boolean;
+}
+export interface FouSplitterContext {
+    layout: Ref<'horizontal' | 'vertical'>;
+    panels: Ref<FouSplitterPanelItem[]>;
+    flexMap: Ref<Record<number, number>>;
+    draggingUid: Ref<number>;
+    register: (panel: FouSplitterPanelItem) => void;
+    unregister: (uid: number) => void;
+    update: (uid: number, partial: Partial<FouSplitterPanelItem>) => void;
+    startDrag: (uid: number, event: MouseEvent) => void;
+}
+export declare const FOU_SPLITTER_KEY: InjectionKey<FouSplitterContext>;

package/dist/components/FouTabBar/types.d.ts

@@ -5,7 +5,11 @@ export interface FouTabPaneRegistration {
     label: string;
     lazy?: boolean;
     loaded?: boolean;
+    disabled?: boolean;
+    closable?: boolean;
+    icon?: string;
     render: () => VNode[];
+    renderLabel?: () => VNode[];
 }
 export interface FouTabBarContext {
     activeName: Ref<string | number | undefined>;
@@ -14,3 +18,4 @@ export interface FouTabBarContext {
     updatePane: (uid: number, partial: Partial<FouTabPaneRegistration>) => void;
 }
 export declare const FOU_TAB_BAR_KEY: InjectionKey<FouTabBarContext>;
+export declare const FOU_TABS_KEY: InjectionKey<FouTabBarContext>;

package/dist/components/FouTour/types.d.ts

@@ -0,0 +1,18 @@
+import { InjectionKey } from 'vue';
+export type FouTourPlacement = 'top' | 'top-start' | 'top-end' | 'bottom' | 'bottom-start' | 'bottom-end' | 'left' | 'left-start' | 'left-end' | 'right' | 'right-start' | 'right-end';
+export interface FouTourStep {
+    target?: string | HTMLElement | (() => HTMLElement | null | undefined);
+    title?: string;
+    description?: string;
+    placement?: FouTourPlacement;
+    nextText?: string;
+    prevText?: string;
+    mask?: boolean;
+}
+export interface FouTourContext {
+    registerStep: (step: FouTourStep & {
+        uid: number;
+    }) => void;
+    unregisterStep: (uid: number) => void;
+}
+export declare const FOU_TOUR_KEY: InjectionKey<FouTourContext>;

package/dist/components/popupZIndex.d.ts

@@ -0,0 +1,3 @@
+/** 弹层递增 z-index：后打开的盖住先打开的（Dialog 内的 Select 也能盖住 Dialog） */
+export declare function nextPopupZIndex(min?: number): number;
+export declare function peekPopupZIndex(): number;

package/dist/components/useFormField.d.ts

@@ -0,0 +1,14 @@
+import { MaybeRefOrGetter } from 'vue';
+export type FouFormItemTrigger = {
+    validate?: (trigger: string) => Promise<boolean>;
+    onFieldBlur?: () => void;
+    onFieldChange?: () => void;
+    prop?: {
+        value?: string;
+    };
+};
+export declare function useFormDisabled(disabled: MaybeRefOrGetter<boolean | undefined>): globalThis.ComputedRef<boolean>;
+export declare function useFormItemTrigger(): {
+    triggerBlur: () => void;
+    triggerChange: () => void;
+};

package/dist/components/useVirtualList.d.ts

@@ -0,0 +1,19 @@
+import { Ref } from 'vue';
+/** 简单纵向虚拟列表：按固定行高切可视区 */
+export declare function useVirtualList(opts: {
+    scrollRef: Ref<HTMLElement | null>;
+    total: () => number;
+    itemHeight?: number;
+    overscan?: number;
+}): {
+    range: globalThis.ComputedRef<{
+        start: number;
+        end: number;
+        padTop: number;
+        padBottom: number;
+        height: number;
+    }>;
+    itemHeight: globalThis.ComputedRef<number>;
+    measure: () => void;
+    onScroll: () => void;
+};