knight-ui 1.2.3 → 1.2.5

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/plus/Markdown.d.ts

@@ -5,11 +5,30 @@ import { AbstractUI, type UIProps, type UIState } from "../../base";
  * 支持完整 CommonMark + GFM: 表格/任务列表/删除线/链接/图片/代码块/引用.
  */
 export declare class Markdown extends AbstractUI<MarkdownProps, MarkdownState> {
+    /** 代码块折叠阈值(行)默认值 — 超过即默认收起 */
+    private static readonly DEFAULT_CODE_FOLD_LINES;
+    /** 代码块收起态可视高度(px)默认值 */
+    private static readonly DEFAULT_CODE_FOLD_HEIGHT;
     constructor(props: MarkdownProps);
     componentDidMount(): void;
     componentWillUnmount(): void;
     private onWheel;
-    private static readonly components;
+    /** 渲染组件表 — 每实例一份: pre 要读实例 props(折叠阈值/高度), 故写成箭头函数绑定 this;
+     *  实例字段只构造一次, 函数标识跨渲染稳定, 折叠状态不会因重渲染丢失 */
+    private readonly components;
+    /** 抽纯文本 — 只用于统计代码块的行数与体量(react-markdown 把代码文本挂在 code 子节点的 children 上) */
+    private static extractText;
+    /** 语言标签 — 从 code 子节点的 `language-json` 类名取, 取不到写"代码" */
+    private static readLang;
+    /** 体量标签 — 1KB 以内按字节, 超出按 KB 保留一位 */
+    private static readSize;
+    /** 整理源码里的 JSON 围栏 — 渲染前改写, 高亮与折叠行数都基于整理后的文本 */
+    private static formatCodeFences;
+    /** 按语言整理一段围栏正文 — 目前只处理 json, 其余语言原样 */
+    private static pushFenceBody;
+    /** JSON 缩进整理 — 只重排空白, 字面量逐字保留(不走 parse→stringify 往返, 大整数与 1.0 这类写法不会失真)
+     *  返回 null 表示不是合法 JSON, 调用方保持原样 */
+    private static prettifyJson;
     protected OnRenderContent(): React.ReactElement;
 }
 export interface MarkdownProps extends UIProps {
@@ -17,6 +36,12 @@ export interface MarkdownProps extends UIProps {
     renderMode?: "default" | "preview" | "raw";
     /** 最大可视行数 (每行约 18px) */
     rows?: number;
+    /** 代码块折叠阈值(行) — 超过即默认收起; 传 0 或负数表示不折叠 @default 16 */
+    codeFoldLines?: number;
+    /** 折叠收起态的可视高度(px) @default 180 */
+    codeFoldHeight?: number;
+    /** 是否整理代码块内容 — 目前只做 JSON 缩进规范化(只重排空白, 不改字面量) @default true */
+    codeFormat?: boolean;
 }
 export interface MarkdownState extends UIState {
 }