@ldkj/web-ui 0.19.0 → 0.20.0

package/components/form/input/index.d.ts

@@ -1,2 +1 @@
 export * from "./input";
-export * from "./useInputValue";

package/components/form/input/input.d.ts

@@ -1,14 +1,45 @@
 import * as React from "react";
 import { type SxProps } from "@/styling";
-export type InputProps = React.ComponentPropsWithoutRef<"input"> & {
+export type InputSlotProps = {
+    children?: React.ReactNode;
+};
+export type InputAddonProps = InputSlotProps & {
+    position?: "before" | "after";
+};
+export type InputProps = Omit<React.ComponentPropsWithoutRef<"input">, "prefix"> & {
+    addonAfter?: React.ReactNode;
+    addonBefore?: React.ReactNode;
     class?: string;
+    prefix?: React.ReactNode;
+    suffix?: React.ReactNode;
     sx?: SxProps;
 };
-/**
- * Input 是基础文本输入框组件，支持原生 input 属性、`class` 别名与本库 `sx` 样式系统。
- */
-declare const Input: React.ForwardRefExoticComponent<Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref"> & {
+export declare const Input: React.ForwardRefExoticComponent<Omit<Omit<React.DetailedHTMLProps<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>, "ref">, "prefix"> & {
+    addonAfter?: React.ReactNode;
+    addonBefore?: React.ReactNode;
     class?: string;
+    prefix?: React.ReactNode;
+    suffix?: React.ReactNode;
     sx?: SxProps;
-} & React.RefAttributes<HTMLInputElement>>;
-export { Input };
+} & React.RefAttributes<HTMLInputElement>> & {
+    Addon: {
+        (props: InputAddonProps): import("react/jsx-runtime").JSX.Element;
+        displayName: string;
+    };
+    AddonAfter: {
+        (props: InputSlotProps): import("react/jsx-runtime").JSX.Element;
+        displayName: string;
+    };
+    AddonBefore: {
+        (props: InputSlotProps): import("react/jsx-runtime").JSX.Element;
+        displayName: string;
+    };
+    Prefix: {
+        (props: InputSlotProps): import("react/jsx-runtime").JSX.Element;
+        displayName: string;
+    };
+    Suffix: {
+        (props: InputSlotProps): import("react/jsx-runtime").JSX.Element;
+        displayName: string;
+    };
+};

package/components/form/input-number/InputNumber.d.ts

@@ -1,10 +1,10 @@
 import * as React from "react";
 import { type InputProps } from "@/components/form/input";
-export type InputNumberValueChangeReason = "input" | "commit";
+export type InputNumberValueChangeReason = "input" | "commit" | "set";
 export type InputNumberValueChangeMeta = {
     reason: InputNumberValueChangeReason;
     valueAsString: string;
-    event: React.ChangeEvent<HTMLInputElement> | React.FocusEvent<HTMLInputElement>;
+    event?: React.ChangeEvent<HTMLInputElement> | React.FocusEvent<HTMLInputElement> | React.KeyboardEvent<HTMLInputElement>;
 };
 export type InputNumberProps = Omit<InputProps, "type" | "inputMode"> & {
     min?: number;
@@ -16,6 +16,32 @@ export type InputNumberProps = Omit<InputProps, "type" | "inputMode"> & {
     precision?: number;
     /** 返回解析后的数值；空值或非法临时值返回 `null`。 */
     onValueChange?: (value: number | null, meta: InputNumberValueChangeMeta) => void;
+    /** 输入值提交时触发，默认在失焦或按下 Enter 时提交。 */
+    onValueCommit?: (value: number | null, meta: InputNumberValueChangeMeta) => void;
+};
+export type NumberInputValue = string | number | null;
+export type UseNumberInputOptions = NormalizeOptions & {
+    value?: NumberInputValue;
+    defaultValue?: string | number | null;
+    onValueChange?: (value: number | null, meta: InputNumberValueChangeMeta) => void;
+    onValueCommit?: (value: number | null, meta: InputNumberValueChangeMeta) => void;
+};
+export type UseNumberInputGetInputProps = Omit<InputProps, "defaultValue" | "inputMode" | "max" | "min" | "onBlur" | "onChange" | "onKeyDown" | "step" | "type" | "value"> & {
+    disabled?: boolean;
+    readOnly?: boolean;
+    onBlur?: React.FocusEventHandler<HTMLInputElement>;
+    onChange?: React.ChangeEventHandler<HTMLInputElement>;
+    onKeyDown?: React.KeyboardEventHandler<HTMLInputElement>;
+};
+export type UseNumberInputResult = {
+    value: string;
+    numberValue: number | null;
+    setValue: (value: NumberInputValue) => void;
+    commitValue: (value?: NumberInputValue) => {
+        value: number | null;
+        valueAsString: string;
+    };
+    getInputProps: (props?: UseNumberInputGetInputProps) => InputProps;
 };
 export type UseInputNumberStateOptions = NormalizeOptions & {
     defaultValue?: string | number | null;
@@ -29,8 +55,11 @@ export type UseInputNumberStateResult = {
 };
 type NormalizeOptions = Pick<InputNumberProps, "clampOnBlur" | "max" | "min" | "precision" | "step">;
 /**
- * 管理 InputNumber 的字符串输入态与解析后的数字值。
- * 它会自动同步 `clampOnBlur` 产生的提交值，避免业务侧手写 commit 分支。
+ * 提供数字输入的 headless 行为层，统一管理字符串展示值、解析值和提交归一化。
+ */
+export declare function useNumberInput(options?: UseNumberInputOptions): UseNumberInputResult;
+/**
+ * @deprecated 优先使用 `useNumberInput`，通过 `getInputProps()` 组合输入控件。
  */
 export declare function useInputNumberState(options?: UseInputNumberStateOptions): UseInputNumberStateResult;
 /**
@@ -47,5 +76,7 @@ export declare const InputNumber: React.ForwardRefExoticComponent<Omit<InputProp
     precision?: number;
     /** 返回解析后的数值；空值或非法临时值返回 `null`。 */
     onValueChange?: (value: number | null, meta: InputNumberValueChangeMeta) => void;
+    /** 输入值提交时触发，默认在失焦或按下 Enter 时提交。 */
+    onValueCommit?: (value: number | null, meta: InputNumberValueChangeMeta) => void;
 } & React.RefAttributes<HTMLInputElement>>;
 export {};

package/components/interact/progress/Progress.d.ts

@@ -1,13 +1,14 @@
 import * as React from "react";
 export type ProgressType = "line" | "circle";
 export type ProgressStatus = "normal" | "success" | "warning" | "exception";
+export type ProgressSize = "xs" | "sm" | "md" | "lg" | "xl" | number;
 export type ProgressProps = React.HTMLAttributes<HTMLDivElement> & {
     value?: number;
     max?: number;
     showInfo?: boolean;
     type?: ProgressType;
     status?: ProgressStatus;
-    size?: number;
+    size?: ProgressSize;
     strokeWidth?: number;
     strokeColor?: string;
     trailColor?: string;