knight-ui 1.2.0 → 1.2.4

package/component/ai/AIChatInput.d.ts

@@ -40,6 +40,8 @@ export interface AIChatInputProps extends UIProps {
     minRows?: number;
     /** 最大行数,超出后滚动 @default 4 */
     maxRows?: number;
+    /** 底部工具条内容(输入框内、textarea 下方、发送键左侧) —— 库不关心放什么,由调用方组装;不传则保留 20px 空白垫高 */
+    bottomBar?: React.ReactNode;
 }
 interface AIChatInputState extends UIState {
     value: string;

package/component/display/Tooltip.d.ts

@@ -9,12 +9,22 @@ type TooltipTheme = "dark" | "light";
 export declare class Tooltip extends AbstractUI<TooltipProps, TooltipState> {
     private zIndex;
     private wrapperRef;
+    private bubbleRef;
+    /** 视口夹取的累计偏移 — 量出溢出后回填,两个都为 0 表示无需偏移 */
+    private shiftX;
+    private shiftY;
     private animTimer;
     private leaveTimer;
     private enterTimer;
     constructor(props: TooltipProps);
     componentDidMount(): void;
     componentDidUpdate(prevProps: Readonly<TooltipProps>): void;
+    /**
+     * 视口夹取 — 气泡是固定定位,只按触发元素居中,靠屏幕边缘时会挂出去一截。
+     * 量在 componentDidUpdate:此时 DOM 已提交、浏览器尚未绘制,补一次 setState 仍落在同一帧,
+     * 校正过程不可见(不会先闪一下再跳)。偏移累计到 shift 上,收敛后不再 setState。
+     */
+    private clampToViewport;
     componentWillUnmount(): void;
     private enter;
     private exit;
@@ -22,6 +32,8 @@ export declare class Tooltip extends AbstractUI<TooltipProps, TooltipState> {
     private cleanup;
     protected OnRenderContent(): React.ReactElement;
     private getArrowStyle;
+    /** 叠加视口夹取偏移 — 走 transform 而不是改 left/right:12 个方位的锚点各不相同,只有位移对全体一致 */
+    private OnShiftPosition;
     private calcPosition;
 }
 type TooltipAnimPhase = "entering" | "entered" | "leaving" | "exited";
@@ -30,6 +42,8 @@ export interface TooltipProps extends UIProps {
     defaultVisible?: boolean;
     content?: React.ReactNode;
     title?: React.ReactNode;
+    /** 内容宽度上限(px) — 传了就允许换行并以它为上限;不传则单行不换行 */
+    maxWidth?: number;
     position?: TooltipPosition;
     trigger?: "hover" | "click" | "focus" | "custom";
     theme?: TooltipTheme;

package/component/input/KeyValueEditor.d.ts

@@ -2,12 +2,15 @@ import React from "react";
 import { AbstractUI, type UIProps, type UIState } from "../../base";
 /**
  * 键值编辑器 — 动态 key/value 行,支持增删. 用法: <KeyValueEditor value={obj} onChange={setObj} />
+ * - disabled 时输入框置灰、增删按钮不渲染,四个 handler 也各自挡一道(防程序侧调用)
  */
 export declare class KeyValueEditor extends AbstractUI<KeyValueEditorProps, KeyValueEditorState> {
     private seed;
     /** 标记内部编辑操作,阻止 componentDidUpdate 覆盖状态 */
     private internalEdit;
     constructor(props: KeyValueEditorProps);
+    /** 是否禁用 — 输入与增删一律不响应 */
+    private get isDisabled();
     componentDidUpdate(prevProps: Readonly<KeyValueEditorProps>): void;
     private static rowsEqual;
     static objectToRows(obj: Record<string, any>): KeyValueRow[];