@vef-framework/components 1.0.5

package/dist/vef-radio/props.d.ts

@@ -0,0 +1,59 @@
+import type { BasicSize, BiConsumer, DataOption, DataOptionConfig, Handler, IdValue, NormalizedDataOption, ObjectType, Provider, PureDataOption, QueryConfig, StringKey } from "@vef-framework/shared";
+import type { RadioGroupProps } from "antd";
+import type { EmptyObject } from "@vef-framework/shared";
+/**
+ * The instance of the VefRadio component.
+ */
+export interface VefRadioInstance<T extends DataOption<T>> {
+    /**
+     * The blur method of the radio.
+     */
+    blur: Handler;
+    /**
+     * The focus method of the radio.
+     */
+    focus: Handler;
+    /**
+     * Get the data options of the radio.
+     */
+    getDataOptions: Provider<Array<NormalizedDataOption<T>>>;
+}
+/**
+ * The variant of the radio.
+ */
+export type RadioVariant = "default" | "button";
+/**
+ * The button variant of the radio.
+ */
+export type RadioButtonVariant = "solid" | "outline";
+/**
+ * The props of the VefRadio component.
+ */
+export interface VefRadioProps<T extends DataOption<T> = PureDataOption, P extends ObjectType = EmptyObject, R = T[]> extends QueryConfig<T[], P, R>, DataOptionConfig<StringKey<T>>, Pick<RadioGroupProps, "disabled" | "block"> {
+    /**
+     * The default value of the radio.
+     */
+    defaultValue?: IdValue;
+    /**
+     * The value of the radio.
+     */
+    value?: IdValue;
+    /**
+     * The variant of the radio.
+     */
+    variant?: RadioVariant;
+    /**
+     * The button variant of the radio.
+     * Only works when the variant is `button`.
+     */
+    buttonVariant?: RadioButtonVariant;
+    /**
+     * The size of the button.
+     * Only works when the variant is `button`.
+     */
+    buttonSize?: BasicSize;
+    /**
+     * The change handler of the radio.
+     */
+    onChange?: BiConsumer<IdValue, NormalizedDataOption<T>>;
+}

package/dist/vef-rate/hooks/use-rate-instance.d.ts

@@ -0,0 +1,12 @@
+import type { GetRef, Rate } from "antd";
+import { type ForwardedRef, type RefObject } from "react";
+import type { VefRateInstance } from "../props";
+type RateRef = GetRef<typeof Rate>;
+/**
+ * The hook to use rate instance.
+ *
+ * @param ref - The forwarded ref.
+ * @returns The ref object.
+ */
+export declare function useRateInstance(ref: ForwardedRef<VefRateInstance>): RefObject<RateRef>;
+export {};

package/dist/vef-rate/hooks/use-rate-instance.js

@@ -0,0 +1,3 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{useRef as r,useImperativeHandle as u}from"react";function t(t){const c=r(null);return u(t,(()=>({blur:()=>c.current?.blur(),focus:()=>c.current?.focus()}))),c}export{t as useRateInstance};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-rate/index.d.ts

@@ -0,0 +1,4 @@
+import type { VefRateInstance, VefRateProps } from "./props";
+declare const VefRate: import("react").ForwardRefExoticComponent<VefRateProps & import("react").RefAttributes<VefRateInstance>>;
+export type { VefRateInstance, VefRateProps };
+export default VefRate;

package/dist/vef-rate/index.js

@@ -0,0 +1,3 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsx as r}from"@emotion/react/jsx-runtime";import{Rate as t}from"antd";import{isFunction as o}from"@vef-framework/shared";import{forwardRef as e,useMemo as a}from"react";import{useRateInstance as m}from"./hooks/use-rate-instance.js";const c=e((({character:e,...c},f)=>{const i=a((()=>o(e)?({index:r})=>e(r):e),[e]),n=m(f);return r(t,{ref:n,character:i,...c})}));export{c as default};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-rate/props.d.ts

@@ -0,0 +1,25 @@
+import type { Handler, Mapper } from "@vef-framework/shared";
+import type { RateProps } from "antd";
+import type { ReactNode } from "react";
+/**
+ * The instance of the VefRate component.
+ */
+export interface VefRateInstance {
+    /**
+     * The blur handler of the rate.
+     */
+    blur?: Handler;
+    /**
+     * The focus handler of the rate.
+     */
+    focus?: Handler;
+}
+/**
+ * The props of the VefRate component.
+ */
+export interface VefRateProps extends Pick<RateProps, "defaultValue" | "value" | "disabled" | "allowClear" | "allowHalf" | "count" | "onBlur" | "onFocus" | "onChange" | "onHoverChange"> {
+    /**
+     * The character of the rate.
+     */
+    character?: ReactNode | Mapper<number, ReactNode>;
+}

package/dist/vef-responsive-container/index.d.ts

@@ -0,0 +1,4 @@
+import type { VefResponsiveContainerProps } from "./props";
+declare const VefResponsiveContainer: import("react").MemoExoticComponent<import("react").ForwardRefExoticComponent<VefResponsiveContainerProps & import("react").RefAttributes<HTMLDivElement>>>;
+export type { VefResponsiveContainerProps };
+export default VefResponsiveContainer;

package/dist/vef-responsive-container/index.js

@@ -0,0 +1,7 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsx as e}from"@emotion/react/jsx-runtime";import{css as r}from"@emotion/react";import{useGapSizeNormalizer as o}from"@vef-framework/hooks";import{motion as t}from"motion/react";import{isArray as n}from"@vef-framework/shared";import{forwardRef as i,Children as a,isValidElement as s,useMemo as m,memo as p}from"react";import f from"../vef-responsive-item/index.js";const v=r`
+  display: grid;
+  grid-template-columns: repeat(var(--vef-responsive-container-auto-mode), minmax(var(--vef-responsive-container-base-width), 1fr));
+  gap: var(--vef-responsive-container-gap);
+`,c=p(i((({style:r,baseItemWidth:i=320,autoExpand:p=!0,gap:c=0,children:d,...l},u)=>{if(i%2!=0)throw new Error("VefResponsiveContainer: baseItemWidth must be an even number.");a.forEach(d,(e=>{if(!s(e)||e.type!==f)throw new Error("VefResponsiveContainer: children must be a VefResponsiveItem element.")}));const h=o(),w=m((()=>n(c)?c.map((e=>h(e))).join(" "):h(c)),[c,h]),b=m((()=>{const e=p?"auto-fit":"auto-fill";return{...r,"--vef-responsive-container-auto-mode":e,"--vef-responsive-container-base-width":i/2+"px","--vef-responsive-container-gap":w}}),[p,i,w,r]);return e(t.div,{ref:u,css:v,style:b,...l,children:d})})));c.displayName="VefResponsiveContainer";export{c as default};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-responsive-container/props.d.ts

@@ -0,0 +1,21 @@
+import type { ChildrenProps, GapType } from "@vef-framework/shared";
+import type { HTMLMotionProps } from "motion/react";
+import type { Except } from "@vef-framework/shared";
+/**
+ * The props of VefResponsiveContainer component.
+ */
+export interface VefResponsiveContainerProps extends Except<HTMLMotionProps<"div">, "children">, Required<ChildrenProps> {
+    /**
+     * The base width of the responsive item.
+     */
+    baseItemWidth?: number;
+    /**
+     * Whether to auto expand the remaining space of the row.
+     * @default true
+     */
+    autoExpand?: boolean;
+    /**
+     * The gap between the responsive items.
+     */
+    gap?: GapType;
+}

package/dist/vef-responsive-item/index.d.ts

@@ -0,0 +1,4 @@
+import type { VefResponsiveItemProps } from "./props";
+declare const VefResponsiveItem: import("react").ForwardRefExoticComponent<VefResponsiveItemProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { VefResponsiveItemProps };
+export default VefResponsiveItem;

package/dist/vef-responsive-item/index.js

@@ -0,0 +1,5 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsx as e}from"@emotion/react/jsx-runtime";import{css as r}from"@emotion/react";import{motion as t}from"motion/react";import{forwardRef as o,useMemo as i}from"react";const n=r`
+  grid-column: span var(--vef-responsive-item-span);
+`,s=o((({style:r,span:o=1,children:s,...m},a)=>{const p=i((()=>({...r,"--vef-responsive-item-span":2*o})),[o,r]);return e(t.div,{ref:a,css:n,style:p,...m,children:s})}));export{s as default};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-responsive-item/props.d.ts

@@ -0,0 +1,12 @@
+import type { ChildrenProps } from "@vef-framework/shared";
+import type { HTMLMotionProps } from "motion/react";
+import type { Except } from "@vef-framework/shared";
+/**
+ * The props of VefResponsiveItem component.
+ */
+export interface VefResponsiveItemProps extends Except<HTMLMotionProps<"div">, "children">, Required<ChildrenProps> {
+    /**
+     * The span of the responsive item.
+     */
+    span?: number;
+}

package/dist/vef-ribbon/index.d.ts

@@ -0,0 +1,5 @@
+import { type FC } from "react";
+import type { VefRibbonProps } from "./props";
+declare const VefRibbon: FC<VefRibbonProps>;
+export type { VefRibbonProps };
+export default VefRibbon;

package/dist/vef-ribbon/index.js

@@ -0,0 +1,3 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsx as o}from"@emotion/react/jsx-runtime";import{useColorTokens as r}from"@vef-framework/hooks";import{Badge as t}from"antd";import{useMemo as e}from"react";const{Ribbon:n}=t,i=({color:t,position:i="right",children:a})=>{const m=r(),c=e((()=>{if(!t)return{placement:"right"===i?"end":"start",text:a};if(m.has(t))return{color:t?m.get(t):void 0,placement:"right"===i?"end":"start",text:a};throw new Error(`Invalid color value "${t}" of VefRibbon component. Color must be a valid color token.`)}),[a,t,m,i]);return o(n,{...c})};export{i as default};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-ribbon/props.d.ts

@@ -0,0 +1,15 @@
+import type { ChildrenProps, ColorType, Position } from "@vef-framework/shared";
+/**
+ * The props of the VefRibbon component.
+ */
+export interface VefRibbonProps extends Required<ChildrenProps> {
+    /**
+     * The color of the ribbon.
+     */
+    color?: ColorType;
+    /**
+     * The position of the ribbon.
+     * @default "right"
+     */
+    position?: Exclude<Position, "center">;
+}

package/dist/vef-row/index.d.ts

@@ -0,0 +1,5 @@
+import type { FC } from "react";
+import type { VefRowProps } from "./props";
+declare const VefRow: FC<VefRowProps>;
+export type { VefRowProps };
+export default VefRow;

package/dist/vef-row/index.js

@@ -0,0 +1,3 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsx as t}from"@emotion/react/jsx-runtime";import{Row as o}from"antd";const r=r=>t(o,{...r});export{r as default};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-row/props.d.ts

@@ -0,0 +1,7 @@
+import type { RowProps } from "antd";
+import type { Except } from "@vef-framework/shared";
+/**
+ * The props of VefRow component.
+ */
+export interface VefRowProps extends Except<RowProps, "prefixCls"> {
+}

package/dist/vef-scroll-area/components/scrollbar.d.ts

@@ -0,0 +1,2 @@
+declare const VefScrollbar: import("react").ForwardRefExoticComponent<Omit<import("@radix-ui/react-scroll-area").ScrollAreaScrollbarProps & import("react").RefAttributes<HTMLDivElement>, "ref"> & import("react").RefAttributes<HTMLDivElement>>;
+export default VefScrollbar;

package/dist/vef-scroll-area/components/scrollbar.js

@@ -0,0 +1,34 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsx as r}from"@emotion/react/jsx-runtime";import{css as o}from"@emotion/react";import{ScrollAreaScrollbar as a,ScrollAreaThumb as e}from"@radix-ui/react-scroll-area";import{themeVariables as i}from"@vef-framework/shared";import{forwardRef as l}from"react";const t=o`
+  --vef-scroll-area-scrollbar-padding: 2px;
+
+  display: flex;
+  touch-action: none;
+  user-select: none;
+`,n=o`
+  height: 100%;
+  width: var(--vef-scroll-area-scrollbar-size);
+  border-left-width: 1px;
+  border-left-color: transparent;
+  padding: var(--vef-scroll-area-scrollbar-padding);
+`,c=o`
+  flex-direction: column;
+  height: var(--vef-scroll-area-scrollbar-size);
+  border-top-width: 1px;
+  border-top-color: transparent;
+  padding: var(--vef-scroll-area-scrollbar-padding);
+`,s=o`
+  position: relative;
+  z-index: 2;
+  flex: 1;
+  border-radius: calc(var(--vef-scroll-area-scrollbar-size) - var(--vef-scroll-area-scrollbar-padding) * 2);
+  background-color: hsl(240 5.9% 90%);
+  transition-property: background-color;
+  transition-timing-function: ${i.motionEaseInOutCirc};
+  transition-duration: ${i.motionDurationMid};
+
+  &:hover {
+    background-color: hsl(240 5.9% 84%);
+  }
+`,d=l((({orientation:o="vertical",...i},l)=>r(a,{ref:l,orientation:o,css:[t,"vertical"===o&&n,"horizontal"===o&&c],...i,children:r(e,{css:s})})));d.displayName="VefScrollbar";export{d as default};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-scroll-area/index.d.ts

@@ -0,0 +1,4 @@
+import type { VefScrollAreaProps } from "./props";
+declare const VefScrollArea: import("react").ForwardRefExoticComponent<VefScrollAreaProps & import("react").RefAttributes<HTMLDivElement>>;
+export type { VefScrollAreaProps };
+export default VefScrollArea;

package/dist/vef-scroll-area/index.js

@@ -0,0 +1,10 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsxs as r,jsx as o}from"@emotion/react/jsx-runtime";import{css as e}from"@emotion/react";import{Root as t,Viewport as i,Corner as l}from"@radix-ui/react-scroll-area";import{forwardRef as a}from"react";import c from"./components/scrollbar.js";const s=e`
+  position: relative;
+  overflow: hidden;
+`,n=e`
+  height: 100%;
+  width: 100%;
+  border-radius: inherit;
+`;const m=a((({scrollbarSize:e="medium",autoHideScrollbar:a=!0,onScroll:m,children:d,...p},f)=>{const h={"--vef-scroll-area-scrollbar-size":"small"===(u=e)?"10px":"medium"===u?"12px":"14px"};var u;return r(t,{ref:f,css:s,type:a?"hover":"auto",...p,children:[o(i,{css:n,onScroll:m,children:d}),o(c,{orientation:"vertical",style:h}),o(c,{orientation:"horizontal",style:h}),o(l,{})]})}));m.displayName="VefScrollArea";export{m as default};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-scroll-area/props.d.ts

@@ -0,0 +1,24 @@
+import type { Root, ScrollAreaViewportProps } from "@radix-ui/react-scroll-area";
+import type { BasicSize } from "@vef-framework/shared";
+import type { ComponentPropsWithoutRef } from "react";
+/**
+ * The props of the VefScrollArea component.
+ */
+export interface VefScrollAreaProps extends Pick<ComponentPropsWithoutRef<typeof Root>, "className" | "style" | "children"> {
+    /**
+     * The size of the scrollbar.
+     *
+     * @default "medium"
+     */
+    scrollbarSize?: BasicSize;
+    /**
+     * Whether to hide the scrollbar automatically.
+     *
+     * @default true
+     */
+    autoHideScrollbar?: boolean;
+    /**
+     * The callback function when the scroll area is scrolled.
+     */
+    onScroll?: ScrollAreaViewportProps["onScroll"];
+}

package/dist/vef-select/components/option.d.ts

@@ -0,0 +1,7 @@
+import { type ReactNode } from "react";
+export interface VefOptionProps {
+    label: ReactNode;
+    description?: ReactNode;
+}
+declare const VefOptionMemo: import("react").NamedExoticComponent<VefOptionProps>;
+export default VefOptionMemo;

package/dist/vef-select/components/option.js

@@ -0,0 +1,11 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsxs as e,jsx as i}from"@emotion/react/jsx-runtime";import{css as r}from"@emotion/react";import{themeVariables as o}from"@vef-framework/shared";import{memo as l}from"react";import t from"../../vef-text/index.js";const s=r`
+  display: flex;
+  flex-direction: column;
+  row-gap: 4px;
+
+  > .vef-typography-secondary {
+    font-size: ${o.fontSizeSm};
+  }
+`,p=l((({label:r,description:o})=>o?e("div",{css:s,children:[i(t,{ellipsis:!0,ellipsisTipPlacement:"right",children:r}),i(t,{ellipsis:!0,color:"secondary",ellipsisTipPlacement:"right",children:o})]}):i(t,{ellipsis:!0,ellipsisTipPlacement:"right",children:r})));p.displayName="VefOption";export{p as default};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-select/hooks/use-data-options.d.ts

@@ -0,0 +1,37 @@
+import type { DataOption, ObjectType, PureDataOption } from "@vef-framework/shared";
+import type { EmptyObject, Except } from "@vef-framework/shared";
+import type { VefSelectProps } from "../props";
+/**
+ * The hook to use data options.
+ */
+export declare function useDataOptions<T extends DataOption<T> = PureDataOption, P extends ObjectType = EmptyObject, R = T[], KK extends string = "keyword", VK extends string = "ids", FP extends ObjectType = EmptyObject>({ value, grouped, multiple, onChange, ...rest }: Except<VefSelectProps<T, P, R, KK, VK, FP>, "size" | "clearable" | "disabled" | "placeholder" | "variant" | "maxCount" | "onClear" | "onBlur" | "onFocus" | "onSelect" | "onDeselect" | "optionRender">): {
+    onFilterKeywordChange: import("radashi").DebounceFunction<[keyword: string]> | undefined;
+    normalizedOptions: ({
+        [x: string]: any;
+        description?: import("react").ReactNode;
+        labelText?: string | undefined;
+        descriptionText?: string | undefined;
+        label: string | number | boolean | import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | import("react").ReactPortal | null;
+        value: import("@vef-framework/shared").IdValue;
+        disabled: boolean;
+    } & {
+        children?: import("@vef-framework/shared").NormalizedDataOption<PureDataOption>[] | undefined;
+        labelPinyin?: string;
+        descriptionPinyin?: string;
+    } & T)[] | ({
+        [x: string]: any;
+        description?: import("react").ReactNode;
+        labelText?: string | undefined;
+        descriptionText?: string | undefined;
+        label: string | number | boolean | import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | import("react").ReactPortal | null;
+        value: import("@vef-framework/shared").IdValue;
+        disabled: boolean;
+    } & {
+        children?: import("@vef-framework/shared").NormalizedDataOption<PureDataOption>[] | undefined;
+        labelPinyin?: string;
+        descriptionPinyin?: string;
+    } & T)[];
+    isLoading: boolean;
+    fallbackOptions: T[] | undefined;
+    isFallbackOptionsLoading: boolean;
+};

package/dist/vef-select/hooks/use-data-options.js

@@ -0,0 +1,3 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{useComputedOptions as o}from"@vef-framework/hooks";import{isArray as e,isFunction as a,isNullish as i}from"@vef-framework/shared";import{useLayoutEffect as n}from"react";function r({value:r,grouped:t=!1,multiple:l=!1,onChange:s,...p}){const{onFilterKeywordChange:d,normalizedOptions:f,defaultOption:m,isLoading:u,fallbackOptions:c,isFallbackOptionsLoading:g}=o({...p,isGrouped:t,selectedOptionValues:e(r)?r:r?[r]:[]});return n((()=>{m&&a(s)&&i(r)&&s(l?[m.value]:m.value,l?[m]:m)}),[m,l,s,r]),{onFilterKeywordChange:d,normalizedOptions:f,isLoading:u,fallbackOptions:c,isFallbackOptionsLoading:g}}export{r as useDataOptions};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-select/hooks/use-field-names.d.ts

@@ -0,0 +1,9 @@
+import type { SelectProps } from "antd";
+type FieldNames = NonNullable<SelectProps["fieldNames"]>;
+/**
+ * The hook to get the field names.
+ *
+ * @param grouped - Whether the options are grouped.
+ */
+export declare function useFieldNames(grouped: boolean): FieldNames;
+export {};

package/dist/vef-select/hooks/use-field-names.js

@@ -0,0 +1,3 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{useMemo as l}from"react";function e(e){return l((()=>e?{label:"label",value:"value",options:"children",groupLabel:"label"}:{label:"label",value:"value"}),[e])}export{e as useFieldNames};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-select/hooks/use-label-render.d.ts

@@ -0,0 +1,11 @@
+import type { DataOption, PureDataOption } from "@vef-framework/shared";
+import type { SelectProps } from "antd";
+type LabelRender = NonNullable<SelectProps["labelRender"]>;
+/**
+ * The hook to get the label render.
+ *
+ * @param isFallbackOptionsLoading - The flag to indicate if the fallback options are loading.
+ * @param fallbackOptions - The fallback options.
+ */
+export declare function useLabelRender<T extends DataOption<T> = PureDataOption>(isFallbackOptionsLoading: boolean, fallbackOptions?: T[]): LabelRender;
+export {};

package/dist/vef-select/hooks/use-label-render.js

@@ -0,0 +1,10 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsx as i}from"@emotion/react/jsx-runtime";import{LoadingOutlined as r}from"@ant-design/icons";import{css as e}from"@emotion/react";import{useCallback as n}from"react";import t from"../../vef-spin/index.js";const o=e`
+  display: inline-flex;
+  align-items: center;
+
+  .vef-spin {
+    color: inherit;
+  }
+`;function m(e,m){return n((({label:n,value:s})=>{if(n)return n;if(e)return i("span",{css:o,children:i(t,{indicator:i(r,{}),size:"small"})});const l=m?.find((i=>i.value===s));return l?.label??s}),[e,m])}export{m as useLabelRender};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-select/hooks/use-option-render.d.ts

@@ -0,0 +1,11 @@
+import type { DataOption, MaybeArray, NormalizedDataOption, PureDataOption } from "@vef-framework/shared";
+import type { SelectProps } from "antd";
+import type { VefSelectProps } from "../props";
+type OptionRender<T extends DataOption<T>> = NonNullable<SelectProps<MaybeArray<string>, NormalizedDataOption<T>>["optionRender"]>;
+/**
+ * The hook to get the option render.
+ *
+ * @param optionRender - The option render.
+ */
+export declare function useOptionRender<T extends DataOption<T> = PureDataOption>(optionRender: VefSelectProps<T>["optionRender"]): OptionRender<T>;
+export {};

package/dist/vef-select/hooks/use-option-render.js

@@ -0,0 +1,3 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsx as o}from"@emotion/react/jsx-runtime";import{isFunction as r}from"@vef-framework/shared";import{useMemo as e}from"react";import t from"../components/option.js";function i(i){return e((()=>r(i)?({data:o},{index:r})=>i({...o,index:r}):({data:{label:r,description:e}})=>o(t,{description:e,label:r??"Missing Label"})),[i])}export{i as useOptionRender};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-select/hooks/use-select-instance.d.ts

@@ -0,0 +1,11 @@
+import type { DataOption, NormalizedDataOption } from "@vef-framework/shared";
+import { type ForwardedRef } from "react";
+import type { VefSelectInstance } from "../props";
+/**
+ * The hook to get the instance of the select.
+ *
+ * @param ref - The forwarded ref.
+ * @param dataOptions - The data options.
+ * @returns The ref of the select.
+ */
+export declare function useSelectInstance<T extends DataOption<T>>(ref: ForwardedRef<VefSelectInstance<T>>, dataOptions: Array<NormalizedDataOption<T>>): import("react").RefObject<import("antd").RefSelectProps>;

package/dist/vef-select/hooks/use-select-instance.js

@@ -0,0 +1,3 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{useRef as r,useImperativeHandle as t}from"react";function n(n,o){const u=r(null);return t(n,(()=>({blur:()=>{u.current?.blur()},focus:()=>{u.current?.focus({preventScroll:!0})},getDataOptions:()=>o}))),u}export{n as useSelectInstance};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-select/index.d.ts

@@ -0,0 +1,7 @@
+import type { EmptyObject } from "@vef-framework/shared";
+import { type DataOption, type ObjectType, type PureDataOption } from "@vef-framework/shared";
+import { type FC, type ReactNode, type RefAttributes } from "react";
+import type { VefSelectInstance, VefSelectProps } from "./props";
+declare const VefSelect: (<T extends DataOption<T> = PureDataOption, P extends ObjectType = EmptyObject, R = T[], KK extends string = "keyword", VK extends string = "ids", FP extends ObjectType = EmptyObject>(props: VefSelectProps<T, P, R, KK, VK, FP> & RefAttributes<VefSelectInstance<T>>) => ReactNode) & Pick<FC, "displayName">;
+export type { VefSelectInstance, VefSelectProps };
+export default VefSelect;

package/dist/vef-select/index.js

@@ -0,0 +1,3 @@
+/*! VefFramework version: 1.0.5, build time: 2024-12-10T10:24:47.065Z, made by Venus. */
+import{jsx as e}from"@emotion/react/jsx-runtime";import{useOptionFilter as o}from"@vef-framework/hooks";import{styles as r}from"@vef-framework/shared";import{Select as t}from"antd";import{memo as i,forwardRef as n}from"react";import"../internal/index.js";import l from"../vef-loading-placeholder/index.js";import{useDataOptions as a}from"./hooks/use-data-options.js";import{useFieldNames as s}from"./hooks/use-field-names.js";import{useLabelRender as m}from"./hooks/use-label-render.js";import{useOptionRender as d}from"./hooks/use-option-render.js";import{useSelectInstance as p}from"./hooks/use-select-instance.js";import{convertBasicSizeToUiSize as f}from"../internal/utils.js";const u=e("div",{css:{height:140},children:e(l,{})});const c=i(n((function({defaultValue:i,value:n,size:l,clearable:c,disabled:h,placeholder:v,variant:g,onClear:C,onBlur:k,onFocus:b,onChange:j,onSelect:F,onDeselect:x,multiple:w=!1,grouped:O=!1,maxCount:R,optionRender:S,filterable:z=!0,filterFromRemote:V=!1,...y},B){const{onFilterKeywordChange:D,normalizedOptions:L,isLoading:N,fallbackOptions:A,isFallbackOptionsLoading:H}=a({value:n,grouped:O,multiple:w,onChange:j,filterable:z,filterFromRemote:V,...y}),K=d(S),T=o(z,V),W=s(O),q=m(H,A),E=p(B,L);return e(t,{ref:E,defaultActiveFirstOption:!0,allowClear:c,css:r.fullWidth,defaultValue:i,disabled:h,fieldNames:W,filterOption:T,labelRender:q,listHeight:280,loading:N,maxCount:w?R:void 0,maxTagCount:w?"responsive":void 0,mode:w?"multiple":void 0,notFoundContent:N?u:void 0,optionRender:K,options:L,placeholder:v,showSearch:z,size:f(l),value:n,variant:g,onBlur:k,onChange:j,onClear:C,onDeselect:x,onFocus:b,onSearch:D,onSelect:F})})));c.displayName="VefSelect";export{c as default};
+/*! VefFramework is a blazingly high-level, modern, flexible, easy-to-use UI framework made by Venus. Follow me on Github: https://github.com/ilxqx! @ilxqx */

package/dist/vef-select/props.d.ts

@@ -0,0 +1,153 @@
+import type { BasicSize, BiConsumer, DataOption, DataOptionConfig, Handler, IdValue, Mapper, MaybeArray, MaybeNull, MaybePromise, NormalizedDataOption, ObjectType, Provider, PureDataOption, QueryApi, QueryConfig, QueryParamsWithKeyword, QueryParamsWithValues, StringKey } from "@vef-framework/shared";
+import type { SelectProps } from "antd";
+import type { ReactNode } from "react";
+import type { EmptyObject } from "@vef-framework/shared";
+/**
+ * The instance of the VefSelect component.
+ */
+export interface VefSelectInstance<T extends DataOption<T> = PureDataOption> {
+    /**
+     * Focus the select.
+     */
+    focus: Handler;
+    /**
+     * Blur the select.
+     */
+    blur: Handler;
+    /**
+     * Get the data options of the select.
+     */
+    getDataOptions: Provider<Array<NormalizedDataOption<T>>>;
+}
+/**
+ * The base props of the VefSelect component.
+ */
+interface VefBaseSelectProps<T extends DataOption<T> = PureDataOption, P extends ObjectType = EmptyObject, R = T, KK extends string = "keyword", VK extends string = "ids", FP extends ObjectType = EmptyObject> extends QueryConfig<T[], QueryParamsWithKeyword<P, KK>, R[]>, DataOptionConfig<StringKey<T>>, Pick<SelectProps<MaybeNull<MaybeArray<IdValue>>, NormalizedDataOption<T>>, "disabled" | "placeholder" | "variant" | "maxCount" | "onClear" | "onBlur" | "onFocus" | "onSelect" | "onDeselect"> {
+    /**
+     * The size of the select.
+     */
+    size?: BasicSize;
+    /**
+     * Whether to allow clear.
+     */
+    clearable?: boolean;
+    /**
+     * Whether to allow multiple selection.
+     */
+    multiple?: boolean;
+    /**
+     * Whether to allow filter.
+     */
+    filterable?: boolean;
+    /**
+     * Whether to filter from remote.
+     */
+    filterFromRemote?: boolean;
+    /**
+     * The parameter key of keyword.
+     * Only works when `filterFromRemote` is true.
+     */
+    keywordKey?: KK;
+    /**
+     * The parameter key of values.
+     */
+    valuesKey?: VK;
+    /**
+     * The API of fallback options.
+     */
+    fallbackOptionsApi?: Readonly<QueryApi<QueryParamsWithValues<FP>, T[]>>;
+    /**
+     * The API params of fallback options.
+     */
+    fallbackOptionsApiParams?: FP;
+    /**
+     * The function to resolve fallback options.
+     */
+    resolveFallbackOptions?: Mapper<IdValue[], MaybePromise<T[]>>;
+    /**
+     * Whether the options are grouped.
+     */
+    grouped?: boolean;
+    /**
+     * The option render function.
+     */
+    optionRender?: Mapper<NormalizedDataOption<T> & {
+        index: number;
+    }, ReactNode>;
+}
+/**
+ * The default props of the single select.
+ */
+interface VefDefaultSingleSelectProps<T extends DataOption<T> = PureDataOption, P extends ObjectType = EmptyObject, R = T[], KK extends string = "keyword", VK extends string = "ids", FP extends ObjectType = EmptyObject> extends VefBaseSelectProps<T, P, R, KK, VK, FP> {
+    /**
+     * The default value of the select.
+     */
+    defaultValue?: IdValue;
+    /**
+     * The value of the select.
+     */
+    value?: MaybeNull<IdValue>;
+    /**
+     * Whether to allow clear.
+     */
+    clearable?: false;
+    /**
+     * Whether to allow multiple selection.
+     */
+    multiple?: false;
+    /**
+     * The change handler.
+     */
+    onChange?: BiConsumer<IdValue, NormalizedDataOption<T>>;
+}
+/**
+ * The clearable props of the single select.
+ */
+interface VefClearableSingleSelectProps<T extends DataOption<T> = PureDataOption, P extends ObjectType = EmptyObject, R = T[], KK extends string = "keyword", VK extends string = "ids", FP extends ObjectType = EmptyObject> extends VefBaseSelectProps<T, P, R, KK, VK, FP> {
+    /***
+     * The default value of the select.
+     */
+    defaultValue?: IdValue;
+    /**
+     * The value of the select.
+     */
+    value?: MaybeNull<IdValue>;
+    /**
+     * Whether to allow clear.
+     */
+    clearable: true;
+    /**
+     * Whether to allow multiple selection.
+     */
+    multiple?: false;
+    /**
+     * The change handler.
+     */
+    onChange?: BiConsumer<MaybeNull<IdValue>, MaybeNull<NormalizedDataOption<T>>>;
+}
+/**
+ * The props of the multiple select.
+ */
+interface VefMultipleSelectProps<T extends DataOption<T> = PureDataOption, P extends ObjectType = EmptyObject, R = T[], KK extends string = "keyword", VK extends string = "ids", FP extends ObjectType = EmptyObject> extends VefBaseSelectProps<T, P, R, KK, VK, FP> {
+    /**
+     * The default value of the select.
+     */
+    defaultValue?: IdValue[];
+    /**
+     * The value of the select.
+     */
+    value?: IdValue[];
+    /**
+     * Whether to allow multiple selection.
+     */
+    multiple: true;
+    /**
+     * The change handler.
+     */
+    onChange?: BiConsumer<IdValue[], Array<NormalizedDataOption<T>>>;
+}
+/**
+ * The props of the VefSelect component.
+ */
+export type VefSelectProps<T extends DataOption<T> = PureDataOption, P extends ObjectType = EmptyObject, R = T[], KK extends string = "keyword", VK extends string = "ids", FP extends ObjectType = EmptyObject> = VefDefaultSingleSelectProps<T, P, R, KK, VK, FP> | VefClearableSingleSelectProps<T, P, R, KK, VK, FP> | VefMultipleSelectProps<T, P, R, KK, VK, FP>;
+export {};