@falcon-ui/falcon-ui 1.0.0 → 1.1.0

package/types/components/loading/src/loading.d.ts

@@ -0,0 +1,65 @@
+import type { ExtractPublicPropTypes, PropType } from 'vue';
+export declare const flLoadingAnimations: readonly ["working", "searching", "solving", "listening", "composing", "shaping", "earth"];
+export declare const flLoadingSizes: readonly [20, 32, 48, 64, 96];
+export type FlLoadingAnimation = (typeof flLoadingAnimations)[number];
+export type FlLoadingSize = (typeof flLoadingSizes)[number];
+export type FlLoadingTheme = 'auto' | 'light' | 'dark';
+export type FlLoadingLayout = 'inline' | 'vertical';
+export declare const flLoadingProps: {
+    /** Whether to show the indicator. Inactive indicators retain their layout space. */
+    readonly active: {
+        readonly type: BooleanConstructor;
+        readonly default: true;
+    };
+    /** Dot animation, including the land-textured Earth. */
+    readonly animation: {
+        readonly type: PropType<FlLoadingAnimation>;
+        readonly default: "searching";
+        readonly validator: (v: FlLoadingAnimation) => boolean;
+    };
+    /** Canvas CSS size in pixels. Each size has its own dot density. */
+    readonly size: {
+        readonly type: PropType<FlLoadingSize>;
+        readonly default: 64;
+        readonly validator: (v: FlLoadingSize) => boolean;
+    };
+    /** Dot color; accepts CSS colors and CSS variables. */
+    readonly color: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** Background theme used to choose contrasting dots. */
+    readonly theme: {
+        readonly type: PropType<FlLoadingTheme>;
+        readonly default: "auto";
+    };
+    /** Animation speed multiplier, clamped to 0.25–3. */
+    readonly speed: {
+        readonly type: NumberConstructor;
+        readonly default: 1;
+    };
+    /** Freeze the current animation time. */
+    readonly paused: {
+        readonly type: BooleanConstructor;
+        readonly default: false;
+    };
+    /** Accessible, selectable status text. */
+    readonly text: {
+        readonly type: StringConstructor;
+        readonly default: "";
+    };
+    /** Position the text beside or below the canvas. */
+    readonly layout: {
+        readonly type: PropType<FlLoadingLayout>;
+        readonly default: "inline";
+    };
+    /** Accessible label when no visible text is provided. */
+    readonly ariaLabel: {
+        readonly type: StringConstructor;
+        readonly default: "加载中";
+    };
+};
+export type FlLoadingProps = ExtractPublicPropTypes<typeof flLoadingProps>;
+export declare const normalizeAnimation: (v: FlLoadingAnimation) => FlLoadingAnimation;
+export declare const normalizeSize: (v: FlLoadingSize) => FlLoadingSize;
+export declare const normalizeSpeed: (v: number) => number;

package/types/components/loading/src/use-fl-loading.d.ts

@@ -0,0 +1,15 @@
+import type { ComputedRef, MaybeRefOrGetter, VNode } from 'vue';
+import type { FlLoadingProps } from './loading';
+export interface FlLoadingOptions extends Omit<FlLoadingProps, 'active'> {
+    background?: string;
+    customClass?: string;
+    themeTarget?: MaybeRefOrGetter<HTMLElement | null | undefined>;
+}
+/** Plain values are also accepted by the native directive's narrower binding type. */
+export interface FlLoadingDirectiveOptions {
+    text: VNode;
+    customClass: string;
+    background?: string;
+}
+/** Create options for the ORIGINAL Element Plus directive; install vLoading separately. */
+export declare function useFlLoading(active: MaybeRefOrGetter<boolean>, options?: MaybeRefOrGetter<FlLoadingOptions>): ComputedRef<false | FlLoadingDirectiveOptions>;

package/types/components/loading/src/use-loading-animation.d.ts

@@ -0,0 +1,13 @@
+import type { Ref } from 'vue';
+import type { FlLoadingAnimation, FlLoadingSize } from './loading';
+interface AnimationOptions {
+    active: boolean;
+    paused: boolean;
+    animation: FlLoadingAnimation;
+    size: FlLoadingSize;
+    speed: number;
+}
+export declare function useLoadingAnimation(canvas: Ref<HTMLCanvasElement | undefined>, options: () => AnimationOptions, color: Ref<string>): {
+    available: Ref<boolean, boolean>;
+};
+export {};

package/types/components/loading/src/use-loading-color.d.ts

@@ -0,0 +1,6 @@
+import type { FlLoadingTheme } from './loading';
+/** Resolve variables at the source element before a loading mask moves into body. */
+export declare function useLoadingColor(host: () => HTMLElement | undefined | null, options: () => {
+    color?: string;
+    theme?: FlLoadingTheme;
+}): import("vue").Ref<string, string>;