knight-ui 1.0.4 → 1.0.6

package/README.md

@@ -1541,25 +1541,56 @@ import { Tooltip, Button } from "knight-ui";
 
 ```tsx
 import { Popconfirm, Button } from "knight-ui";
+import { IconAlertTriangle } from "knight-ui";
 
+// 基础用法 (默认 position="bottom", trigger="click")
 <Popconfirm
   title="确定删除？"
   content="删除后不可恢复"
-  trigger="click"
   onConfirm={() => console.log("confirmed")}
   onCancel={() => console.log("cancelled")}
 >
   <Button type="danger">删除</Button>
 </Popconfirm>
+
+// 自定义按钮文字 + 图标
+<Popconfirm title="确定保存?" content="保存后覆盖原有数据"
+  icon={<IconAlertTriangle size="extraLarge" color="var(--ku-color-warning)" />}
+  okText="保存" cancelText="取消"
+  onConfirm={() => console.log("saved")}>
+  <Button type="warning">保存</Button>
+</Popconfirm>
+
+// 8 方向弹出 (position)
+<Popconfirm title="确认?" position="leftTop" onConfirm={() => {}}>
+  <Button>左上弹出</Button>
+</Popconfirm>
+<Popconfirm title="确认?" position="rightBottom" onConfirm={() => {}}>
+  <Button>右下弹出</Button>
+</Popconfirm>
+
+// hover 触发 + 带箭头
+<Popconfirm title="提示" content="悬停即可查看" trigger="hover" showArrow position="top"
+  onConfirm={() => {}}>
+  <Button type="secondary">悬停触发</Button>
+</Popconfirm>
 ```
 
 | 属性 | 类型 | 默认值 | 说明 |
 |---|---|---|---|
 | `title` | `React.ReactNode` | — | 标题 |
 | `content` | `React.ReactNode` | — | 内容 |
-| `okText / cancelText` | `string` | — | 按钮文字 |
+| `position` | `"top" \| "bottom" \| "left" \| "right" \| "leftTop" \| "rightTop" \| "leftBottom" \| "rightBottom"` | `"bottom"` | 弹出位置（命名规则: 第一个词=左右, 第二个词=上下） |
+| `trigger` | `"click" \| "hover" \| "focus" \| "custom"` | `"click"` | 触发方式 |
+| `icon` | `React.ReactNode` | — | 自定义图标 |
+| `showArrow` | `boolean` | `false` | 显示箭头 |
+| `okText / cancelText` | `string` | `"确认" / "取消"` | 按钮文字 |
+| `okButtonProps / cancelButtonProps` | `ButtonHTMLAttributes` | — | 按钮额外属性 |
+| `visible / defaultVisible` | `boolean` | — | 受控/非受控显示 |
+| `offset` | `number` | `4` | 弹出偏移距离 |
 | `onConfirm` | `(e) => void` | — | 确认回调 |
 | `onCancel` | `(e) => void` | — | 取消回调 |
+| `onVisibleChange` | `(visible: boolean) => void` | — | 显示状态变化回调 |
 
 ### Calendar 日历
 

package/component/feedback/Popconfirm.d.ts

@@ -1,6 +1,6 @@
 import React from "react";
 import { AbstractUI, type UIProps, type UIState } from "../../base";
-type PopconfirmPosition = "top" | "topLeft" | "topRight" | "bottom" | "bottomLeft" | "bottomRight" | "left" | "leftTop" | "leftBottom" | "right" | "rightTop" | "rightBottom";
+type PopconfirmPosition = "top" | "bottom" | "left" | "right" | "leftTop" | "rightTop" | "leftBottom" | "rightBottom";
 type PopconfirmTrigger = "click" | "hover" | "focus" | "custom";
 /**
  * 气泡确认框。

package/component/input/Form.d.ts

@@ -28,6 +28,7 @@ interface FormContextValue {
     labelWidth: number;
     disabled: boolean;
     validating: boolean;
+    formKey: number;
 }
 declare class FormField extends AbstractUI<FormFieldProps, FormFieldState> {
     static displayName: string;
@@ -83,6 +84,7 @@ export declare class Form extends AbstractUI<FormProps, FormState> {
     private registerField;
     private updateField;
     private getValues;
+    private bumpFormKey;
     private setValues;
     private addField;
     private removeField;
@@ -112,5 +114,6 @@ export interface FormProps extends UIProps {
 }
 interface FormState extends UIState {
     validating: boolean;
+    formKey: number;
 }
 export {};

package/component/input/Input.d.ts

@@ -4,13 +4,12 @@ import type { ValidateStatus } from "../types";
 declare class TextArea extends AbstractUI<TextAreaProps, TextAreaState> {
     static displayName: string;
     private textareaRef;
+    private _isComposing;
     constructor(props: TextAreaProps);
-    componentDidUpdate(prevProps: Readonly<TextAreaProps>, _prevState: Readonly<TextAreaState>): void;
     focus(): void;
     protected OnRenderContent(): React.ReactElement;
 }
 export interface TextAreaProps extends UIProps {
-    /** 受控值(提供后组件变为受控模式) */
     value?: string;
     defaultValue?: string;
     placeholder?: string;
@@ -21,24 +20,24 @@ export interface TextAreaProps extends UIProps {
     onChange?: (value: string, event?: React.ChangeEvent<HTMLTextAreaElement>) => void;
 }
 interface TextAreaState extends UIState {
-    value: string;
     focused: boolean;
 }
 /**
- * 输入框。纯非受控，浏览器原生管理输入内容，IME 无干扰。
+ * 输入框。
+ * - 受控模式: 传入 value，值完全由父组件控制
+ * - 非受控模式: 传入 defaultValue，浏览器原生管理输入内容，IME 无干扰
  */
 export declare class Input extends AbstractUI<InputProps, InputState> {
     static TextArea: typeof TextArea;
     private inputRef;
+    private _isComposing;
     constructor(props: InputProps);
-    componentDidUpdate(prevProps: Readonly<InputProps>, _prevState: Readonly<InputState>): void;
     focus(): void;
     blur(): void;
     protected OnRenderContent(): React.ReactElement;
 }
 export interface InputProps extends UIProps {
     type?: "text" | "password";
-    /** 受控值(提供后组件变为受控模式) */
     value?: string;
     defaultValue?: string;
     placeholder?: string;
@@ -55,7 +54,6 @@ export interface InputProps extends UIProps {
     onChange?: (value: string, event?: React.ChangeEvent<HTMLInputElement>) => void;
 }
 interface InputState extends UIState {
-    value: string;
     showPassword: boolean;
     focused: boolean;
 }