@cloudtower/eagle 0.0.0-testid-rc-0 → 0.0.0-theme-rc-1

package/dist/src/core/Duration/duration.type.d.ts

@@ -0,0 +1,50 @@
+/// <reference types="react" />
+import { IEmptyProps } from "../../core/Empty";
+import { DurationUnitType, FormatDurationItem } from "../../utils/formatDuration";
+import { RawValue } from "../Units/units.type";
+/**
+ * Duration 组件的属性类型
+ *
+ * data-testid 在空态（Empty）和 noUnitOnZero 分支生效。
+ * 默认渲染分支（多单位拼接）和 contentRender 分支返回 Fragment，不支持 data-testid。
+ * 需要 data-testid 时，请在 Duration 外层自行包一层 wrapper 并设置 data-testid。
+ * 使用 contentRender 时，也可在 contentRender 返回的根元素上自行设置 data-testid。
+ */
+export interface DurationProps extends Omit<RawValue, "decimals"> {
+    /**
+     * 最大展示单位数量，默认为 2
+     * @default 2
+     * @example
+     * maxDisplayUnits={3} // 最多展示 3 个单位，如：1 day 1 hour 1 minute
+     */
+    maxDisplayUnits?: number;
+    /**
+     * 最小展示单位，默认为 "second"（秒）
+     * @default "second"
+     * @example
+     * minUnit="minute" // 最小单位为分钟，秒数会被忽略
+     */
+    minUnit?: DurationUnitType;
+    /**
+     * Empty组件的配置属性
+     */
+    emptyProps?: IEmptyProps;
+    /**
+     * 自定义返回结果的渲染。
+     * 当提供此函数时，将使用自定义渲染函数来渲染持续时间，而不是使用默认的渲染方式。
+     * 注意：使用 contentRender 时，组件不会透传 data-testid，
+     * 调用方需要在返回的根元素上自行设置 data-testid。
+     * @param parts 格式化后的持续时间数组，每个元素包含 value 和 unit
+     * @returns 自定义的 React 节点
+     * @example
+     * contentRender={(parts) => (
+     *   <div data-testid="my-duration">
+     *     {parts.map((part, i) => (
+     *       <span key={i}>{part.value} {part.unit}</span>
+     *     ))}
+     *   </div>
+     * )}
+     */
+    contentRender?: (parts: FormatDurationItem[]) => React.ReactNode;
+    "data-testid"?: string;
+}

package/dist/src/core/Duration/index.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { DurationProps } from "./duration.type";
+declare const Duration: React.FC<DurationProps>;
+export default Duration;

package/dist/src/core/Empty/index.d.ts

@@ -0,0 +1,8 @@
+import React, { CSSProperties } from "react";
+export interface IEmptyProps {
+    "data-testid"?: string;
+    className?: string;
+    style?: CSSProperties;
+}
+declare const Empty: ({ className, style, "data-testid": dataTestId, }: IEmptyProps) => React.JSX.Element;
+export default Empty;

package/dist/src/core/Error/index.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+declare const Error: ({ error, "data-testid": dataTestId, }: {
+    error: unknown;
+    "data-testid"?: string | undefined;
+}) => React.JSX.Element;
+export default Error;

package/dist/src/core/ExpandableList/ExpandIcon.d.ts

@@ -0,0 +1,13 @@
+import React from "react";
+interface IProps {
+    isActive?: boolean;
+    header?: React.ReactNode;
+    className?: string;
+    style?: React.CSSProperties;
+    showArrow?: boolean;
+    forceRender?: boolean;
+    disabled?: boolean;
+    extra?: React.ReactNode;
+}
+declare const ExpandIcon: (props: IProps) => React.JSX.Element;
+export default ExpandIcon;

package/dist/src/core/ExpandableList/ExpandableContainer.d.ts

@@ -0,0 +1,5 @@
+import React, { PropsWithChildren } from "react";
+interface IProps {
+}
+declare const ExpandableContainer: (props: PropsWithChildren<IProps>) => React.JSX.Element;
+export default ExpandableContainer;

package/dist/src/core/ExpandableList/ExpandableItem.d.ts

@@ -0,0 +1,9 @@
+import React, { PropsWithChildren } from "react";
+interface IProps {
+    header?: React.ReactNode;
+    order?: number;
+    disableExpand?: boolean;
+    defaultActive?: boolean;
+}
+declare const ExpandableItem: (props: PropsWithChildren<IProps>) => React.JSX.Element;
+export default ExpandableItem;

package/dist/src/core/ExpandableList/RoundOrder.d.ts

@@ -0,0 +1,6 @@
+import React, { PropsWithChildren } from "react";
+interface IProps {
+    order?: number;
+}
+declare const RoundedOrder: (props: PropsWithChildren<IProps>) => React.JSX.Element;
+export default RoundedOrder;

package/dist/src/core/ExpandableList/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./ExpandableContainer";
+export { default as ExpandableContainer } from "./ExpandableContainer";
+export * from "./ExpandableItem";
+export { default as ExpandableItem } from "./ExpandableItem";
+export * from "./ExpandIcon";
+export { default as ExpandIcon } from "./ExpandIcon";
+export * from "./RoundOrder";
+export { default as RoundOrder } from "./RoundOrder";

package/dist/src/core/FailedLoad/index.d.ts

@@ -0,0 +1,10 @@
+import React from "react";
+declare const FailedLoad: React.FC<{
+    error: Error | string;
+    refetch: () => Promise<unknown>;
+    refetchText?: string;
+    className?: string;
+    title?: string;
+    "data-testid"?: string;
+}>;
+export default FailedLoad;

package/dist/src/core/Fields/FieldsBoolean/index.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { FieldBaseProps } from "../fields.type";
+declare const FieldsBoolean: ({ input, children, "data-testid": dataTestId, ...props }: FieldBaseProps) => React.JSX.Element;
+export default FieldsBoolean;

package/dist/src/core/Fields/FieldsDateTime/index.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { FieldBaseProps } from "../fields.type";
+declare const FieldsDateTime: ({ input, "data-testid": dataTestId, }: FieldBaseProps) => React.JSX.Element;
+export default FieldsDateTime;

package/dist/src/core/Fields/FieldsDateTimeRange/index.d.ts

@@ -0,0 +1,5 @@
+import { DatePickerProps } from "antd/lib/date-picker";
+import React from "react";
+import { FieldBaseProps } from "../fields.type";
+declare const FieldsDateTimeRange: React.FC<FieldBaseProps & DatePickerProps>;
+export default FieldsDateTimeRange;

package/dist/src/core/Fields/FieldsEnum/fieldsEnum.type.d.ts

@@ -0,0 +1,20 @@
+import { FieldRenderProps, InputSize } from "../fields.type";
+export interface BaseEnumProps {
+    enumValues: readonly (string | {
+        value: string;
+        text: string;
+    })[];
+    placeholder?: string;
+    emptyLabel?: string;
+    size?: InputSize;
+    defaultValue?: string;
+    multiple?: boolean;
+}
+export type EnumProps<V = any, T extends HTMLElement = HTMLElement> = {
+    input: Partial<FieldRenderProps<V, T>["input"]>;
+    meta: FieldRenderProps<V, T>["meta"];
+    disabled?: boolean;
+    className?: string;
+    dropdownClassName?: string;
+    "data-testid"?: string;
+} & BaseEnumProps;

package/dist/src/core/Fields/FieldsEnum/index.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+import { EnumProps } from "./fieldsEnum.type";
+declare const FieldsEnum: ({ meta: __, enumValues, emptyLabel, "data-testid": dataTestId, ...restProps }: EnumProps) => React.JSX.Element;
+export default FieldsEnum;
+export * from "./fieldsEnum.type";

package/dist/src/core/Fields/FieldsFloat/index.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { FloatFieldProps } from "../../../spec";
+declare const FieldsFloat: ({ input, meta, onBlur, autoComplete, "data-testid": dataTestId, ...props }: FloatFieldProps) => React.JSX.Element;
+export default FieldsFloat;

package/dist/src/core/Fields/FieldsInt/fieldsInt.type.d.ts

@@ -0,0 +1,15 @@
+/// <reference types="react" />
+import { FieldBaseProps, InputSize } from "../fields.type";
+export interface IntProps {
+    placeholder?: string;
+    suffix?: string;
+    size?: InputSize;
+    onBlur?: (input: FieldBaseProps<number, HTMLInputElement>["input"], event?: React.FocusEvent<HTMLInputElement>) => void;
+}
+export type IntFieldProps<V = any, T extends HTMLElement = HTMLElement> = FieldBaseProps<V, T> & IntProps & {
+    onChange?: FieldBaseProps<V, T>["input"]["onChange"];
+    autoComplete?: "on" | "off";
+    maximum?: number;
+    minimum?: number;
+    supportNegativeValue?: boolean;
+};

package/dist/src/core/Fields/FieldsInt/index.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+import { IntFieldProps } from "./fieldsInt.type";
+declare const FieldsInt: ({ input, meta, onBlur, autoComplete, supportNegativeValue, "data-testid": dataTestId, ...props }: IntFieldProps) => React.JSX.Element;
+export default FieldsInt;
+export * from "./fieldsInt.type";

package/dist/src/core/Fields/FieldsInteger/index.d.ts

@@ -0,0 +1,4 @@
+import React from "react";
+import { IntegerFieldProps } from "../../../spec";
+declare const FieldsInteger: ({ meta, input, onBlur, "data-testid": dataTestId, ...props }: IntegerFieldProps) => React.JSX.Element;
+export default FieldsInteger;

package/dist/src/core/Fields/FieldsString/fieldsString.type.d.ts

@@ -0,0 +1,17 @@
+/// <reference types="react" />
+import { InputSize } from "../fields.type";
+export interface StringProps {
+    placeholder?: string;
+    autoComplete?: "on" | "off" | "new-password";
+    prefix?: React.ReactNode;
+    suffix?: React.ReactNode;
+    className?: string;
+    size?: InputSize;
+    allowClear?: boolean;
+    tags?: string[];
+    tagsOverflow?: React.ReactNode;
+    onTagsAllowClearClick?: (e: React.MouseEvent) => void;
+    onClick?: (e: React.MouseEvent) => void;
+    maxLength?: number;
+    disabled?: boolean;
+}

package/dist/src/core/Fields/FieldsString/index.d.ts

@@ -0,0 +1,6 @@
+import React from "react";
+import { FieldBaseProps } from "../fields.type";
+import { StringProps } from "./fieldsString.type";
+declare const FieldsString: ({ input, meta, autoComplete, size, tags, className, allowClear, tagsOverflow, onTagsAllowClearClick, onClick, maxLength, focusIndicator, "data-testid": dataTestId, ...props }: FieldBaseProps & StringProps) => React.JSX.Element;
+export default FieldsString;
+export * from "./fieldsString.type";

package/dist/src/core/Fields/FieldsTextArea/index.d.ts

@@ -0,0 +1,5 @@
+import { TextAreaProps } from "antd/lib/input";
+import React from "react";
+import { FieldBaseProps } from "../fields.type";
+declare const FieldsTextArea: ({ input, meta, onFocusChangeHeight, "data-testid": dataTestId, ...props }: FieldBaseProps & TextAreaProps) => React.JSX.Element;
+export default FieldsTextArea;

package/dist/src/core/Fields/FieldsTimePicker/index.d.ts

@@ -0,0 +1,5 @@
+import { TimePickerProps } from "antd/lib/time-picker";
+import React from "react";
+import { FieldBaseProps } from "../fields.type";
+declare const FieldsTimePicker: ({ input, meta, "data-testid": dataTestId, ...props }: FieldBaseProps & TimePickerProps) => React.JSX.Element;
+export default FieldsTimePicker;

package/dist/src/core/Fields/fields.type.d.ts

@@ -0,0 +1,52 @@
+/// <reference types="react" />
+export type InputSize = "large" | "middle" | "small";
+interface AnyObject {
+    [key: string]: any;
+}
+export interface FieldState<FieldValue> {
+    active?: boolean;
+    blur: () => void;
+    change: (value: any) => void;
+    data?: AnyObject;
+    dirty?: boolean;
+    dirtySinceLastSubmit?: boolean;
+    error?: any;
+    focus: () => void;
+    initial?: FieldValue;
+    invalid?: boolean;
+    length?: number;
+    modified?: boolean;
+    name: string;
+    pristine?: boolean;
+    submitError?: any;
+    submitFailed?: boolean;
+    submitSucceeded?: boolean;
+    submitting?: boolean;
+    touched?: boolean;
+    valid?: boolean;
+    validating?: boolean;
+    value?: FieldValue;
+    visited?: boolean;
+}
+export type FieldMetaState<FieldValue> = Pick<FieldState<FieldValue>, Exclude<keyof FieldState<FieldValue>, "blur" | "change" | "focus" | "name" | "value">>;
+export interface FieldInputProps<FieldValue, T extends HTMLElement = HTMLElement> extends AnyObject {
+    name: string;
+    onBlur: (event?: React.FocusEvent<T>) => void;
+    onChange: (event: React.ChangeEvent<T> | any) => void;
+    onFocus: (event?: React.FocusEvent<T>) => void;
+    type?: string;
+    value: FieldValue;
+    checked?: boolean;
+    multiple?: boolean;
+}
+export interface FieldRenderProps<FieldValue, T extends HTMLElement = HTMLElement> {
+    input: FieldInputProps<FieldValue, T>;
+    meta: FieldMetaState<FieldValue>;
+    [otherProp: string]: any;
+}
+export type FieldBaseProps<V = any, T extends HTMLElement = HTMLElement> = FieldRenderProps<V, T> & {
+    disabled?: boolean;
+    className?: string;
+    "data-testid"?: string;
+};
+export {};

package/dist/src/core/Fields/index.d.ts

@@ -0,0 +1,41 @@
+/// <reference types="react" />
+declare const fields: {
+    Int: ({ input, meta, onBlur, autoComplete, supportNegativeValue, "data-testid": dataTestId, ...props }: import("./FieldsInt").IntFieldProps) => import("react").JSX.Element;
+    Integer: ({ meta, input, onBlur, "data-testid": dataTestId, ...props }: import("../..").IntegerFieldProps) => import("react").JSX.Element;
+    Float: ({ input, meta, onBlur, autoComplete, "data-testid": dataTestId, ...props }: import("../..").FloatFieldProps) => import("react").JSX.Element;
+    DateTime: ({ input, "data-testid": dataTestId, }: import("./fields.type").FieldBaseProps) => import("react").JSX.Element;
+    TimePicker: ({ input, meta, "data-testid": dataTestId, ...props }: import("./fields.type").FieldRenderProps<any, HTMLElement> & {
+        disabled?: boolean | undefined;
+        className?: string | undefined;
+        "data-testid"?: string | undefined;
+    } & import("antd/lib/time-picker").TimePickerProps) => import("react").JSX.Element;
+    Enum: ({ meta: __, enumValues, emptyLabel, "data-testid": dataTestId, ...restProps }: import("./FieldsEnum").EnumProps) => import("react").JSX.Element;
+    String: ({ input, meta, autoComplete, size, tags, className, allowClear, tagsOverflow, onTagsAllowClearClick, onClick, maxLength, focusIndicator, "data-testid": dataTestId, ...props }: import("./fields.type").FieldRenderProps<any, HTMLElement> & {
+        disabled?: boolean | undefined;
+        className?: string | undefined;
+        "data-testid"?: string | undefined;
+    } & import("./FieldsString").StringProps) => import("react").JSX.Element;
+    Boolean: ({ input, children, "data-testid": dataTestId, ...props }: import("./fields.type").FieldBaseProps) => import("react").JSX.Element;
+    TextArea: ({ input, meta, onFocusChangeHeight, "data-testid": dataTestId, ...props }: import("./fields.type").FieldRenderProps<any, HTMLElement> & {
+        disabled?: boolean | undefined;
+        className?: string | undefined;
+        "data-testid"?: string | undefined;
+    } & import("antd/lib/input").TextAreaProps) => import("react").JSX.Element;
+    DateTimeRange: import("react").FC<import("./fields.type").FieldRenderProps<any, HTMLElement> & {
+        disabled?: boolean | undefined;
+        className?: string | undefined;
+        "data-testid"?: string | undefined;
+    } & import("antd/lib/date-picker").DatePickerProps>;
+};
+export default fields;
+export * from "./fields.type";
+export * from "./FieldsBoolean";
+export * from "./FieldsDateTime";
+export * from "./FieldsDateTimeRange";
+export * from "./FieldsEnum";
+export * from "./FieldsFloat";
+export * from "./FieldsInt";
+export * from "./FieldsInteger";
+export * from "./FieldsString";
+export * from "./FieldsTextArea";
+export * from "./FieldsTimePicker";

package/dist/src/core/FormItem/index.d.ts

@@ -0,0 +1,6 @@
+import { FormItemProps } from "antd/lib/form";
+import React from "react";
+declare const FormItem: (props: React.PropsWithChildren<FormItemProps> & {
+    "data-testid"?: string;
+}) => React.ReactElement;
+export default FormItem;

package/dist/src/core/Frequency/index.d.ts

@@ -0,0 +1,3 @@
+import { UnitFn } from "../Units/units.type";
+declare const Frequency: UnitFn;
+export default Frequency;

package/dist/src/core/Icon/index.d.ts

@@ -0,0 +1,39 @@
+import { SrcType } from "../../core/BaseIcon";
+import React from "react";
+export type IconProps = React.HTMLAttributes<HTMLSpanElement> & {
+    src: SrcType;
+    active?: boolean;
+    hoverSrc?: SrcType;
+    activeSrc?: SrcType;
+    className?: string;
+    alt?: string;
+    iconWidth?: number;
+    iconHeight?: number | "auto";
+    cursor?: "pointer" | string;
+    isRotate?: boolean;
+    prefix?: React.ReactNode;
+    suffix?: {
+        src: SrcType;
+        hoverSrc?: SrcType;
+        activeSrc?: SrcType;
+    };
+};
+declare const Icon: React.ForwardRefExoticComponent<React.HTMLAttributes<HTMLSpanElement> & {
+    src: SrcType;
+    active?: boolean | undefined;
+    hoverSrc?: SrcType | undefined;
+    activeSrc?: SrcType | undefined;
+    className?: string | undefined;
+    alt?: string | undefined;
+    iconWidth?: number | undefined;
+    iconHeight?: number | "auto" | undefined;
+    cursor?: string | undefined;
+    isRotate?: boolean | undefined;
+    prefix?: React.ReactNode;
+    suffix?: {
+        src: SrcType;
+        hoverSrc?: SrcType | undefined;
+        activeSrc?: SrcType | undefined;
+    } | undefined;
+} & React.RefAttributes<HTMLSpanElement>>;
+export default Icon;

package/dist/src/core/ImmersiveDialog/index.d.ts

@@ -0,0 +1,7 @@
+import React from "react";
+import { ImmersiveDialogProps } from "./type";
+/**
+ * 统一沉浸式弹窗的初始化展示、footer 和关闭入口，关闭锁定不接管业务主动出栈。
+ * @param props 弹窗布局、初始化状态与操作配置
+ */
+export declare function ImmersiveDialog(props: ImmersiveDialogProps): React.JSX.Element;

package/dist/src/core/ImmersiveDialog/styles.d.ts

@@ -0,0 +1,15 @@
+export declare const ImmersiveDialogStyle: import("@linaria/core").LinariaClassName;
+export declare const MultiAreaStyle: import("@linaria/core").LinariaClassName;
+export declare const CloseIconStyle: import("@linaria/core").LinariaClassName;
+export declare const CloseButtonStyle: import("@linaria/core").LinariaClassName;
+export declare const TitleStyle: import("@linaria/core").LinariaClassName;
+export declare const FullContentStyle: import("@linaria/core").LinariaClassName;
+export declare const BodyStyle: import("@linaria/core").LinariaClassName;
+export declare const MultiAreaBodyStyle: import("@linaria/core").LinariaClassName;
+export declare const FooterStyle: import("@linaria/core").LinariaClassName;
+export declare const FooterButtonStyle: import("@linaria/core").LinariaClassName;
+export declare const FooterButtonRightStyle: import("@linaria/core").LinariaClassName;
+export declare const ErrorStyle: import("@linaria/core").LinariaClassName;
+export declare const ErrorIconStyle: import("@linaria/core").LinariaClassName;
+export declare const ErrorTextStyle: import("@linaria/core").LinariaClassName;
+export declare const CancelButtonStyle: import("@linaria/core").LinariaClassName;

package/dist/src/core/ImmersiveDialog/type.d.ts

@@ -0,0 +1,179 @@
+/// <reference types="react" />
+import { ButtonProps } from "../../core/Button";
+import { SafeReactNode } from "../../spec";
+import { ModalProps as AntdModalProps } from "antd/lib/modal";
+/**
+ * 沉浸式全屏对话框，支持左中右三栏布局。适合复杂操作、大面积内容展示。通过 usePushModal 打开。
+ *
+ * 默认三栏布局宽度：左侧面板 192px、中间内容区 648px、右侧面板 192px，左右面板与内容区间距 60px。
+ * 设置 `isContentFull` 后左右面板隐藏，内容区占满整个对话框宽度。
+ *
+ * @example
+ * ```tsx
+ * // 带左右面板的全屏对话框（创建虚拟机场景）
+ * import { ImmersiveDialog } from "@cloudtower/eagle";
+ * import { usePushModal, usePopModal } from "@cloudtower/eagle";
+ *
+ * const pushModal = usePushModal();
+ *
+ * pushModal({
+ *   component: () => (
+ *     <ImmersiveDialog
+ *       title="创建虚拟机"
+ *       left={<VMConfigSteps current={step} />}
+ *       right={<VMResourceSummary cpu={cpu} memory={memory} />}
+ *       onOk={() => handleCreate()}
+ *     >
+ *       <VMConfigForm step={step} />
+ *     </ImmersiveDialog>
+ *   ),
+ *   props: { name: "CreateVmDialog" },
+ * });
+ * ```
+ *
+ * @example
+ * ```tsx
+ * // 纯内容全屏对话框（isContentFull 模式）
+ * import { ImmersiveDialog } from "@cloudtower/eagle";
+ * import { usePushModal, usePopModal } from "@cloudtower/eagle";
+ *
+ * const popModal = usePopModal();
+ *
+ * <ImmersiveDialog
+ *   title="查看详情"
+ *   isContentFull
+ *   onOk={() => popModal()}
+ * >
+ *   <FullWidthContent />
+ * </ImmersiveDialog>
+ * ```
+ *
+ * 除下列自有属性外，还继承了 antd Modal 的全部属性（如 `onCancel`、`maskClosable`、`closable` 等），
+ * 这些属性会直接透传给底层 Modal 组件。
+ *
+ * @see WizardDialog — 基于 ImmersiveDialog 的向导变体，支持分步操作
+ * @see SmallDialog — 小型弹窗（492px），适用于简单确认或少量内容
+ * @see MediumDialog — 中型弹窗（720px），适用于中等复杂度的表单或内容
+ */
+export type ImmersiveDialogProps = React.PropsWithChildren<AntdModalProps & {
+    /** 自定义关闭图标，替换右上角默认的关闭按钮图标 */
+    closeIcon?: React.ReactNode;
+    /**
+     * 是否禁用右上角关闭按钮及 Escape、遮罩关闭。
+     * 禁用时保留灰色关闭按钮；`closable=false` 时仍隐藏按钮。
+     * 不影响 footer 取消按钮或业务主动调用 `popModal`，需要分别控制。
+     * @default false
+     */
+    closeDisabled?: boolean;
+    /**
+     * 是否显示取消按钮
+     * @default true
+     */
+    showCancel?: boolean;
+    /**
+     * 取消按钮的文本。
+     * 当 showOk 为 true 时默认为"取消"，否则默认为"关闭"。
+     */
+    cancelText?: string;
+    /** 取消按钮的属性，透传至底层 Button 组件 */
+    cancelButtonProps?: ButtonProps;
+    /**
+     * 是否显示确定按钮
+     * @default true
+     */
+    showOk?: boolean;
+    /**
+     * 确定按钮的文本。
+     * 当存在 initializingError 时默认为"重试"，否则默认为"确认"。
+     */
+    okText?: string;
+    /** 确定按钮的属性，透传至底层 Button 组件 */
+    okButtonProps?: ButtonProps;
+    /** 底部错误信息，显示在 footer 左侧区域，最多展示 3 行溢出后 tooltip 提示 */
+    error?: React.ReactNode;
+    /**
+     * 是否隐藏 footer。隐藏后 footer 区域仍保留 40px 的空白间距。
+     * @default false
+     */
+    hideFooter?: boolean;
+    /**
+     * 是否展示 footer 错误信息旁的错误图标
+     * @default true
+     */
+    showFooterErrorIcon?: boolean;
+    /**
+     * 确定按钮的回调。
+     *
+     * 注意：签名为 `(e: React.MouseEvent) => void`，与 SmallDialog/MediumDialog 的
+     * `onOk?: (popModal: () => void) => void` 不同。此组件的 onOk 不会自动关闭弹窗，
+     * 需要通过 `usePopModal()` hook 获取 popModal 函数手动关闭。
+     */
+    onOk?: (e: React.MouseEvent<HTMLElement, MouseEvent>) => void;
+    /**
+     * 是否内容占满整个对话框宽度。
+     * 开启后隐藏左右面板，内容区域占满对话框，左右各留 40px 的内边距。
+     * @default false
+     */
+    isContentFull?: boolean;
+    /**
+     * 左侧面板的自定义内容。
+     * 三栏布局下固定宽度 192px，使用 fixed 定位，顶部距弹窗上边缘 140px。
+     * 当 isContentFull 为 true 或处于 initializing/initializingError 状态时不渲染。
+     */
+    left?: React.ReactNode;
+    /**
+     * 左侧面板的自定义类名，用于覆盖左侧面板的默认样式。
+     * 面板默认宽度 192px，可通过此类名调整样式。
+     */
+    leftClassName?: string;
+    /**
+     * 右侧面板的自定义内容。
+     * 三栏布局下固定宽度 192px，使用 fixed 定位，顶部距弹窗上边缘 140px。
+     * 当 isContentFull 为 true 或处于 initializing/initializingError 状态时不渲染。
+     */
+    right?: React.ReactNode;
+    /**
+     * 右侧面板的自定义类名，用于覆盖右侧面板的默认样式。
+     * 面板默认宽度 192px，可通过此类名调整样式。
+     */
+    rightClassName?: string;
+    /**
+     * 底部左侧的操作区域，通常放置"上一步"按钮或其他辅助操作。
+     * 渲染在 footer 左侧，与确定/取消按钮分居两端。
+     */
+    footerLeftAction?: React.ReactNode;
+    /**
+     * 是否仅初始化一次。首次初始化成功后，忽略后续的 `initializing` 和 `initializingError`。
+     *
+     * @description
+     * `initializing` 为 false 或未传入，且 `initializingError` 无值时，视为初始化成功；
+     * 首次渲染就满足该条件时也会记录成功。成功前允许失败后重试，再次进入加载状态。
+     * 记录在组件卸载后重置，仅切换 `visible` 不重置；切换资源可通过 `key` 重新挂载。
+     * 延迟启动请求时，需要在准备期间保持 `initializing=true`。
+     * 设为 false 时，两项初始化状态完全跟随外部传入的值。
+     *
+     * @default true
+     */
+    initializeOnce?: boolean;
+    /**
+     * 是否处于初始化加载中状态。
+     * 为 true 时标题区显示骨架屏，内容区显示 4 行骨架屏加载占位，footer 隐藏。
+     * 加载完成后设为 false 显示正常内容。
+     * 默认仅在首次初始化成功前生效；设 `initializeOnce=false` 可反复进入加载状态。
+     * @default false
+     */
+    initializing?: boolean;
+    /**
+     * 初始化错误的内容。设置后内容区显示错误提示（居中展示），
+     * 标题自动变为"加载失败"，确定按钮文本自动变为"重试"。
+     * 与 initializing 配合使用：先设 initializing=true 开始加载，
+     * 失败时设 initializing=false 并设置 initializingError。
+     * 默认在首次初始化成功后被忽略。
+     */
+    initializingError?: string | SafeReactNode;
+    /**
+     * 测试标识符前缀，用于自动化测试定位元素。
+     * 派生子 testid：`${testId}-cancel`、`${testId}-ok`、`${testId}-close`
+     */
+    "data-testid"?: string;
+}>;

package/dist/src/core/Input/index.d.ts

@@ -0,0 +1,5 @@
+import React from "react";
+import { InputProps } from "./input.type";
+declare const Input: React.FC<InputProps>;
+export default Input;
+export * from "./input.type";

package/dist/src/core/Input/input.type.d.ts

@@ -0,0 +1,23 @@
+import { InputProps as AntdInputProps } from "antd/lib/input";
+export interface AdditionOptions {
+    /**
+     * 使用变量控制是否显示 error 效果
+     */
+    error?: boolean;
+    /**
+     * 是否显示箭头按钮，用于加减数值
+     */
+    controls?: boolean;
+    /**
+     * 开启 control 后，不会显示 suffix
+     */
+    suffix?: string;
+    /**
+     * 数据测试 id
+     */
+    "data-testid"?: string;
+}
+export type InputProps = AntdInputProps & {
+    error?: boolean;
+    "data-testid"?: string;
+};

package/dist/src/core/InputGroup/index.d.ts

@@ -0,0 +1,4 @@
+/// <reference types="react" />
+declare const InputGroup: import("@linaria/react").StyledMeta & import("react").FC<import("antd/lib/input").GroupProps>;
+export default InputGroup;
+export * from "./inputGroup.type";