oolong-engine 0.0.2-t.6 → 0.0.2-t.7

package/dist/graphics/OolongDocContainer.d.ts

@@ -0,0 +1,16 @@
+import { GraphicNode } from "@/graphics/node/GraphicNode";
+import { IRect } from "@/common";
+import { NodeType } from "@/idl";
+import { DocProps } from "@/graphics/props/DocProps";
+import { AbsProps } from "@/graphics/props/AbsProps";
+export declare class OolongDocContainer extends GraphicNode {
+    type: NodeType;
+    inDocEditMode: boolean;
+    get docProps(): DocProps;
+    constructor(id: string, ctx: CanvasRenderingContext2D);
+    updateProps(props: Partial<AbsProps>[]): void;
+    drawOnGLCtx(ctx: CanvasRenderingContext2D): void;
+    canQuickCreate(): boolean;
+    getTextContentRect(): IRect;
+    static load(id: string, type: NodeType, zIndex: number, props: Partial<AbsProps>[], parent: GraphicNode, ctx: CanvasRenderingContext2D): OolongDocContainer;
+}

package/dist/graphics/OolongNode.d.ts

@@ -43,6 +43,8 @@ export declare class OolongNode extends GraphicNode {
     getTextContentRect(): IRect;
     isEmptyText(): boolean;
     getConnectAnchor(): IPoint[];
+    canQuickCreate(): boolean;
+    canBeConnected(): boolean;
     /**
      * 根据数据创建节点
      * @param id

package/dist/graphics/line/LineIntersectionUtils.d.ts

@@ -1,4 +1,4 @@
-import { OolongLine } from "./OolongLine";
+import type { OolongLine } from "./OolongLine";
 import { IPoint } from "../../idl";
 import { IRectNode } from "../../common";
 export declare class LineIntersectionUtils {

package/dist/graphics/line/arrow/AbsArrowDrawer.d.ts

@@ -1,4 +1,4 @@
-import { OolongLine } from "../OolongLine";
+import type { OolongLine } from "../OolongLine";
 export declare abstract class AbsArrowDrawer {
     abstract drawOnGLCtx(ctx: CanvasRenderingContext2D, line: OolongLine): void;
 }

package/dist/graphics/line/arrow/CircleArrowDrawer.d.ts

@@ -1,5 +1,5 @@
 import { AbsArrowDrawer } from "./AbsArrowDrawer";
-import { OolongLine } from "../OolongLine";
+import type { OolongLine } from "../OolongLine";
 export declare class CircleArrowDrawer extends AbsArrowDrawer {
     drawOnGLCtx(ctx: CanvasRenderingContext2D, line: OolongLine): void;
 }

package/dist/graphics/line/arrow/DiamondArrowDrawer.d.ts

@@ -1,5 +1,5 @@
 import { AbsArrowDrawer } from "./AbsArrowDrawer";
-import { OolongLine } from "../OolongLine";
+import type { OolongLine } from "../OolongLine";
 export declare class DiamondArrowDrawer extends AbsArrowDrawer {
     drawOnGLCtx(ctx: CanvasRenderingContext2D, line: OolongLine): void;
 }

package/dist/graphics/line/arrow/EmptyCircleArrowDrawer.d.ts

@@ -1,5 +1,5 @@
 import { AbsArrowDrawer } from "./AbsArrowDrawer";
-import { OolongLine } from "../OolongLine";
+import type { OolongLine } from "../OolongLine";
 export declare class EmptyCircleArrowDrawer extends AbsArrowDrawer {
     drawOnGLCtx(ctx: CanvasRenderingContext2D, line: OolongLine): void;
 }

package/dist/graphics/line/arrow/EmptyDiamondArrowDrawer.d.ts

@@ -1,5 +1,5 @@
 import { AbsArrowDrawer } from "./AbsArrowDrawer";
-import { OolongLine } from "../OolongLine";
+import type { OolongLine } from "../OolongLine";
 export declare class EmptyDiamondArrowDrawer extends AbsArrowDrawer {
     drawOnGLCtx(ctx: CanvasRenderingContext2D, line: OolongLine): void;
 }

package/dist/graphics/line/arrow/EmptyTriangleArrowDrawer.d.ts

@@ -1,5 +1,5 @@
 import { AbsArrowDrawer } from "./AbsArrowDrawer";
-import { OolongLine } from "../OolongLine";
+import type { OolongLine } from "../OolongLine";
 export declare class EmptyTriangleArrowDrawer extends AbsArrowDrawer {
     drawOnGLCtx(ctx: CanvasRenderingContext2D, line: OolongLine): void;
 }

package/dist/graphics/line/arrow/SimpleArrowDrawer.d.ts

@@ -1,5 +1,5 @@
 import { AbsArrowDrawer } from "./AbsArrowDrawer";
-import { OolongLine } from "../OolongLine";
+import type { OolongLine } from "../OolongLine";
 /**
  * 简单箭头
  */

package/dist/graphics/line/arrow/TriangleArrowDrawer.d.ts

@@ -1,5 +1,5 @@
 import { AbsArrowDrawer } from "./AbsArrowDrawer";
-import { OolongLine } from "../OolongLine";
+import type { OolongLine } from "../OolongLine";
 export declare class TriangleArrowDrawer extends AbsArrowDrawer {
     drawOnGLCtx(ctx: CanvasRenderingContext2D, line: OolongLine): void;
 }

package/dist/graphics/props/DocProps.d.ts

@@ -0,0 +1,11 @@
+import { AbsProps } from "@/graphics";
+import { IDocProps } from "@/idl/capInfo/IDocProps";
+import { PropType } from "./PropType";
+export declare class DocProps extends AbsProps implements IDocProps {
+    type: PropType;
+    children: string[];
+    static create(updateProps: Partial<DocProps>): DocProps;
+    static from(iProps: IDocProps): DocProps;
+    clone(): DocProps;
+    update(props: Partial<DocProps>): void;
+}

package/dist/graphics/props/PropType.d.ts

@@ -15,5 +15,6 @@ export declare enum PropType {
     CheckSize = 13,
     TextParagraph = 14,
     TextParagraphQuote = 15,
-    Slide = 16
+    Slide = 16,
+    Doc = 17
 }

package/dist/graphics/utils/GraphicUtils.d.ts

@@ -6,11 +6,11 @@ import { AbsProps } from "../props/AbsProps";
 import { BaseProps } from "../props/BaseProps";
 import { InteractiveEvent, IRect, IRectNode, Point, Rect, RectNode, StretchType } from "../../common";
 import { NodeConnectEndType } from "../base/NodeConnectEndType";
-import { OolongLine } from "../line/OolongLine";
+import type { OolongLine } from "../line/OolongLine";
 import { AppEventContext } from "../../app";
 import { ShapeCategoryType } from "../../config/ShapeCategoryType";
 import { RotateType } from "../../idl/common/RotateType";
-import { RenderManager, UpdateNodeInfo } from "../../action";
+import { UpdateNodeInfo } from "../../action";
 import { TextBlock } from "../../renderText/TextBlock";
 import { RenderText, TextLine } from "../../renderText";
 import { TextParagraphProps } from "../props/TextParagraphProps";
@@ -198,8 +198,26 @@ export declare class GraphicUtils {
     static dealWithShiftLineInteractEvent(originEvent: InteractiveEvent, line: OolongLine, isDragEnd?: boolean): InteractiveEvent;
     static getMockEventModifierInit(event: KeyboardEvent): EventModifierInit;
     static judgeParentInset(node: GraphicNode, parentSet: Set<GraphicNode>): boolean;
+    static computeRelatedSlideSectionChildrenNode(node: GraphicNode, ctx: {
+        nodeManager: NodeManager;
+    }): Set<GraphicNode>;
     static judgeSlideSectionChildren(originNode: GraphicNode, slideContainer: OolongSlideContainer): GraphicNode | null;
+    static judgeSlideSectionRelatedNode(originNode: GraphicNode, slideContainer: OolongSlideContainer, ctx: {
+        nodeManager: NodeManager;
+    }): GraphicNode | null;
     static filterContainerFromNodes(nodes: GraphicNode[]): Set<GraphicNode>;
+    /**
+     * 判断节点是否在 DocContainer 内（是 DocContainer 的子节点）
+     * @param node 要检查的节点
+     * @returns 如果节点是 DocContainer 的子节点则返回 true
+     */
+    static isNodeInDocContainer(node: GraphicNode): boolean;
+    /**
+     * 检查节点列表中是否有任何节点在 DocContainer 内
+     * @param nodes 节点列表
+     * @returns 如果任何节点在 DocContainer 内则返回 true
+     */
+    static hasNodeInDocContainer(nodes: GraphicNode[]): boolean;
     /**
      * 判断线条的起始端点是否在容器外
      * @param line
@@ -244,8 +262,5 @@ export declare class GraphicUtils {
     static judgeNodeCanBeStretch(node: GraphicNode): boolean;
     static getSlideContainerChildNode(slideContainer: OolongSlideContainer, index: number, ctx: AppEventContext): OolongSection | null;
     static filterSlideContainerNodes(ctx: AppEventContext, nodeList: GraphicNode[]): GraphicNode[];
-    static getSlideInfo(node: GraphicNode, { renderManager, nodeManager }: {
-        renderManager: RenderManager;
-        nodeManager: NodeManager;
-    }): Promise<SlideCoverInfo>;
+    static getSlideInfo(node: GraphicNode, ctx: AppEventContext): Promise<SlideCoverInfo>;
 }

package/dist/idl/NodeType.d.ts

@@ -8,5 +8,6 @@ export declare enum NodeType {
     Checkbox = 6,
     CheckboxText = 7,
     SlideContainer = 8,
+    DocContainer = 9,
     ROOT = 99
 }

package/dist/idl/capInfo/ICapInfo.d.ts

@@ -15,6 +15,7 @@ import { ICheckSizeProps } from "./ICheckSizeProps";
 import { ITextParagraphProps } from "./ITextParagraphProps";
 import { ITextParagraphQuoteProps } from "./ITextParagraphQuoteProps";
 import { ISlideProps } from "./ISlideProps";
+import { IDocProps } from "@/idl/capInfo/IDocProps";
 export interface ICapInfo {
     baseProps?: IBaseProps;
     colorProps?: IColorProps;
@@ -33,4 +34,5 @@ export interface ICapInfo {
     textParagraphProps?: ITextParagraphProps;
     textParagraphQuoteProps?: ITextParagraphQuoteProps;
     slideProps?: ISlideProps;
+    docProps?: IDocProps;
 }

package/dist/idl/capInfo/IDocProps.d.ts

@@ -0,0 +1,3 @@
+export interface IDocProps {
+    children: string[];
+}

package/dist/index.css

@@ -1 +1 @@
-.canvas-container .auxiliary-canvas{position:absolute;left:0;top:0;width:100%;height:100%;z-index:2;pointer-events:none}.canvas-container .content-canvas{position:absolute;left:0;top:0;width:100%;height:100%;z-index:1}.canvas-container .page-canvas{position:absolute;left:0;top:0;width:100%;height:100%;z-index:0}.normal-container,.normal-container .normal-canvas{width:100%;height:100%}.canvas-input{position:absolute;border:none;outline:none;-webkit-user-select:none;user-select:none;width:1px;z-index:3;opacity:0;pointer-events:none}@keyframes van-cursor-flicker{0%{opacity:1}50%{opacity:0}to{opacity:1}}.render-input{position:absolute;background-color:#000;width:1px;height:12px;z-index:4;pointer-events:none;animation:.6s van-cursor-flicker infinite}
+.canvas-container .auxiliary-canvas{position:absolute;left:0;top:0;width:100%;height:100%;z-index:2;pointer-events:none}.canvas-container .content-canvas{position:absolute;left:0;top:0;width:100%;height:100%;z-index:1}.canvas-container .page-canvas{position:absolute;left:0;top:0;width:100%;height:100%;z-index:0}.normal-container,.normal-container .normal-canvas{width:100%;height:100%}.canvas-input{position:absolute;top:0;left:0;border:none;outline:none;-webkit-user-select:none;user-select:none;width:1px;z-index:3;opacity:0;pointer-events:none}@keyframes van-cursor-flicker{0%{opacity:1}50%{opacity:0}to{opacity:1}}.render-input{position:absolute;top:0;left:0;background-color:#000;width:1px;height:12px;z-index:4;pointer-events:none;animation:.6s van-cursor-flicker infinite}

package/dist/plugin-copy-paste/copy-paste/paste/img/ImgPasteHandler.d.ts

@@ -5,4 +5,31 @@ export declare class ImgPasteHandler implements IPasteHandler {
     worker: ImageWorker;
     paste(e: ClipboardEvent, ctx: AppEventContext): boolean;
     pasteImg(blob: Blob, ctx: AppEventContext): Promise<void>;
+    /**
+     * 判断是否应该在 DocContainer 内粘贴图片
+     * 条件：1. 当前处于 DOC_EDIT 模式
+     *       2. 当前处于文字编辑状态
+     *       3. 文字节点在 DocContainer 内部
+     */
+    private shouldPasteInDocContainer;
+    /**
+     * 在 DocContainer 内粘贴图片
+     */
+    private pasteImgInDocContainer;
+    /**
+     * 情况1：替换空文字节点为图片节点
+     */
+    private replaceEmptyNodeWithImage;
+    /**
+     * 情况2：在当前文字节点后插入图片节点
+     */
+    private insertImageAfterNode;
+    /**
+     * 调整后续兄弟节点的位置
+     */
+    private adjustSiblingPositions;
+    /**
+     * 如果需要，扩展容器高度
+     */
+    private expandContainerIfNeeded;
 }

package/dist/plugin-hotkey/hotkey/normal/DeleteKey.d.ts

@@ -4,6 +4,6 @@ import { DeleteWorker } from "../../../ability/delete/DeleteWorker";
 export declare class DeleteKey extends HotKey {
     type: string;
     worker: DeleteWorker;
-    work(_event: KeyboardEvent, context: AppEventContext): void;
+    work(event: KeyboardEvent, context: AppEventContext): void;
     enable(_event: KeyboardEvent): boolean;
 }

package/dist/plugin-hotkey/hotkey/normal/move/ArrowDownKey.d.ts

@@ -1,6 +1,7 @@
 import { HotKey } from "../../HotKey";
 import { AppEventContext } from "../../../../app";
 import { ArrowMoveWorker } from "./ArrowMoveWorker";
+import { DocContainerArrowWorker } from "./DocContainerArrowWorker";
 /**
  * 下方向键
  * - 普通模式：向下移动1px
@@ -9,6 +10,7 @@ import { ArrowMoveWorker } from "./ArrowMoveWorker";
 export declare class ArrowDownKey extends HotKey {
     type: string;
     worker: ArrowMoveWorker;
+    docContainerWorker: DocContainerArrowWorker;
     enable(event: KeyboardEvent, isMac: boolean): boolean;
     work(event: KeyboardEvent, context: AppEventContext): void;
 }

package/dist/plugin-hotkey/hotkey/normal/move/ArrowLeftKey.d.ts

@@ -1,6 +1,7 @@
 import { HotKey } from "../../HotKey";
 import { AppEventContext } from "../../../../app";
 import { ArrowMoveWorker } from "./ArrowMoveWorker";
+import { DocContainerArrowWorker } from "./DocContainerArrowWorker";
 /**
  * 左方向键
  * - 普通模式：向左移动1px
@@ -9,6 +10,7 @@ import { ArrowMoveWorker } from "./ArrowMoveWorker";
 export declare class ArrowLeftKey extends HotKey {
     type: string;
     worker: ArrowMoveWorker;
+    docContainerWorker: DocContainerArrowWorker;
     enable(event: KeyboardEvent, isMac: boolean): boolean;
     work(event: KeyboardEvent, context: AppEventContext): void;
 }

package/dist/plugin-hotkey/hotkey/normal/move/ArrowRightKey.d.ts

@@ -1,6 +1,7 @@
 import { HotKey } from "../../HotKey";
 import { AppEventContext } from "../../../../app";
 import { ArrowMoveWorker } from "./ArrowMoveWorker";
+import { DocContainerArrowWorker } from "./DocContainerArrowWorker";
 /**
  * 右方向键
  * - 普通模式：向右移动1px
@@ -9,6 +10,7 @@ import { ArrowMoveWorker } from "./ArrowMoveWorker";
 export declare class ArrowRightKey extends HotKey {
     type: string;
     worker: ArrowMoveWorker;
+    docContainerWorker: DocContainerArrowWorker;
     enable(event: KeyboardEvent, isMac: boolean): boolean;
     work(event: KeyboardEvent, context: AppEventContext): void;
 }

package/dist/plugin-hotkey/hotkey/normal/move/ArrowUpKey.d.ts

@@ -1,6 +1,7 @@
 import { HotKey } from "../../HotKey";
 import { AppEventContext } from "../../../../app";
 import { ArrowMoveWorker } from "./ArrowMoveWorker";
+import { DocContainerArrowWorker } from "./DocContainerArrowWorker";
 /**
  * 上方向键
  * - 普通模式：向上移动1px
@@ -9,6 +10,7 @@ import { ArrowMoveWorker } from "./ArrowMoveWorker";
 export declare class ArrowUpKey extends HotKey {
     type: string;
     worker: ArrowMoveWorker;
+    docContainerWorker: DocContainerArrowWorker;
     enable(event: KeyboardEvent, isMac: boolean): boolean;
     work(event: KeyboardEvent, context: AppEventContext): void;
 }

package/dist/plugin-hotkey/hotkey/normal/move/DocContainerArrowWorker.d.ts

@@ -0,0 +1,19 @@
+import { AppEventContext } from "../../../../app";
+/**
+ * 处理 DocContainer 内非文字节点的方向键跳转逻辑
+ */
+export declare class DocContainerArrowWorker {
+    /**
+     * 检查是否需要处理 DocContainer 内的节点跳转
+     * @returns 是否处理了跳转
+     */
+    handleArrowKey(context: AppEventContext, direction: "up" | "down" | "left" | "right"): boolean;
+    /**
+     * 跳到下一个节点
+     */
+    private handleNextNode;
+    /**
+     * 跳到上一个节点
+     */
+    private handlePrevNode;
+}

package/dist/plugin-hotkey/hotkey/text/AbsArrowKey.d.ts

@@ -4,6 +4,39 @@ import { AppEventContext } from "../../../app/index";
 export declare abstract class AbsArrowKey extends HotKey {
     cursorMoveWorker: TextCursorMoveWorker;
     abstract moveCursor(renderText: RenderText, textCursorPosition: TextCursorPosition, context: AppEventContext): TextCursorPosition;
+    /**
+     * 获取移动类型
+     * - 'left': 左移，在开头时跳到上一个节点末尾
+     * - 'right': 右移，在末尾时跳到下一个节点开头
+     * - 'up': 上移，在首行时跳到上一个节点对应 x 位置
+     * - 'down': 下移，在末行时跳到下一个节点对应 x 位置
+     */
+    abstract getMoveType(): "left" | "right" | "up" | "down";
     enable(_event: KeyboardEvent): boolean;
     work(event: KeyboardEvent, context: AppEventContext): void;
+    /**
+     * 检查是否是 DocContainer 内的纯文本节点
+     */
+    private isDocContainerText;
+    /**
+     * 处理 DocContainer 内跨节点的光标移动
+     * @returns 是否处理了跨节点移动
+     */
+    private handleDocContainerCrossNode;
+    /**
+     * Right: 在文本末尾时跳到下一个节点开头
+     */
+    private handleRightCrossNode;
+    /**
+     * Left: 在文本开头时跳到上一个节点末尾
+     */
+    private handleLeftCrossNode;
+    /**
+     * Down: 在最后一行时跳到下一个节点，保持 x 位置
+     */
+    private handleDownCrossNode;
+    /**
+     * Up: 在第一行时跳到上一个节点，保持 x 位置
+     */
+    private handleUpCrossNode;
 }

package/dist/plugin-hotkey/hotkey/text/ArrowDownKey.d.ts

@@ -2,5 +2,6 @@ import { AbsArrowKey } from "./AbsArrowKey";
 import { RenderText, TextCursorPosition } from "../../../renderText/index";
 export declare class ArrowDownKey extends AbsArrowKey {
     type: string;
+    getMoveType(): "left" | "right" | "up" | "down";
     moveCursor(renderText: RenderText, textCursorPosition: TextCursorPosition): TextCursorPosition;
 }

package/dist/plugin-hotkey/hotkey/text/ArrowLeftKey.d.ts

@@ -2,5 +2,6 @@ import { AbsArrowKey } from "./AbsArrowKey";
 import { RenderText, TextCursorPosition } from "../../../renderText/index";
 export declare class ArrowLeftKey extends AbsArrowKey {
     type: string;
+    getMoveType(): "left" | "right" | "up" | "down";
     moveCursor(renderText: RenderText, textCursorPosition: TextCursorPosition): TextCursorPosition;
 }

package/dist/plugin-hotkey/hotkey/text/ArrowRightKey.d.ts

@@ -3,5 +3,6 @@ import { RenderText, TextCursorPosition } from "../../../renderText";
 import { AppEventContext } from "../../../app";
 export declare class ArrowRightKey extends AbsArrowKey {
     type: string;
+    getMoveType(): "left" | "right" | "up" | "down";
     moveCursor(renderText: RenderText, textCursorPosition: TextCursorPosition, context: AppEventContext): TextCursorPosition;
 }

package/dist/plugin-hotkey/hotkey/text/ArrowUpKey.d.ts

@@ -2,5 +2,6 @@ import { AbsArrowKey } from "./AbsArrowKey";
 import { RenderText, TextCursorPosition } from "../../../renderText/index";
 export declare class ArrowUpKey extends AbsArrowKey {
     type: string;
+    getMoveType(): "left" | "right" | "up" | "down";
     moveCursor(renderText: RenderText, textCursorPosition: TextCursorPosition): TextCursorPosition;
 }

package/dist/plugin-hotkey/hotkey/text/deleteKey/DeleteHandler.d.ts

@@ -0,0 +1,17 @@
+import { AppEventContext } from "../../../../app";
+import { EditTextInfo } from "../../../../input/EditTextInfo";
+/**
+ * Delete 键处理器基类
+ */
+export declare abstract class DeleteHandler {
+    /**
+     * 判断是否启用该处理器
+     * @param editInfo 编辑文本信息
+     * @param context 应用事件上下文
+     */
+    abstract enable(editInfo: EditTextInfo, context: AppEventContext): boolean;
+    /**
+     * 处理 Delete 键事件
+     */
+    abstract handle(context: AppEventContext): void;
+}

package/dist/plugin-hotkey/hotkey/text/deleteKey/DocContainerDeleteHandler.d.ts

@@ -0,0 +1,26 @@
+import { DeleteHandler } from "./DeleteHandler";
+import { AppEventContext } from "../../../../app";
+import { EditTextInfo } from "../../../../input/EditTextInfo";
+/**
+ * DocContainer 内纯文本节点的 Delete 键处理器
+ * 当光标在首段首行首位时，删除当前节点并将内容合并到上一个节点
+ */
+export declare class DocContainerDeleteHandler extends DeleteHandler {
+    private docPosWorker;
+    enable(editInfo: EditTextInfo, context: AppEventContext): boolean;
+    handle(context: AppEventContext): void;
+    /**
+     * 合并两段富文本
+     * 将 nextRichText 的内容追加到 prevRichText 的最后一个段落
+     */
+    private mergeRichText;
+    /**
+     * 检查是否需要缩小容器高度
+     * 如果最后一个节点的底部位置距离容器底部超过一个默认高度，则缩小容器
+     */
+    private shrinkContainerIfNeeded;
+    /**
+     * 检查文本是否为空
+     */
+    private isTextEmpty;
+}

package/dist/plugin-hotkey/hotkey/text/deleteKey/NormalDeleteHandler.d.ts

@@ -0,0 +1,13 @@
+import { DeleteHandler } from "./DeleteHandler";
+import { AppEventContext } from "../../../../app";
+import { EditTextInfo } from "../../../../input/EditTextInfo";
+/**
+ * 普通文本节点的 Delete 键处理器
+ * 处理段落层级删除和普通字符删除
+ */
+export declare class NormalDeleteHandler extends DeleteHandler {
+    private editTextWorker;
+    private selectionDeleteWorker;
+    enable(_editInfo: EditTextInfo, _context: AppEventContext): boolean;
+    handle(context: AppEventContext): void;
+}

package/dist/plugin-hotkey/hotkey/text/deleteKey/TextDeleteKey.d.ts

@@ -0,0 +1,13 @@
+import { HotKey } from "../../HotKey";
+import { AppEventContext } from "../../../../app";
+/**
+ * Delete 键热键处理器
+ * 使用 handler 链模式处理不同场景的 Delete 键事件
+ */
+export declare class TextDeleteKey extends HotKey {
+    type: string;
+    /** 处理器列表，按优先级排序 */
+    private handlers;
+    enable(_event: KeyboardEvent): boolean;
+    work(_event: KeyboardEvent, context: AppEventContext): void;
+}

package/dist/plugin-hotkey/hotkey/text/deleteKey/index.d.ts

@@ -0,0 +1,4 @@
+export { TextDeleteKey } from "./TextDeleteKey";
+export { DeleteHandler } from "./DeleteHandler";
+export { DocContainerDeleteHandler } from "./DocContainerDeleteHandler";
+export { NormalDeleteHandler } from "./NormalDeleteHandler";

package/dist/plugin-hotkey/hotkey/text/enterKey/DocContainerEnterHandler.d.ts

@@ -0,0 +1,16 @@
+import { EnterHandler } from "./EnterHandler";
+import { AppEventContext } from "../../../../app";
+import { EditTextInfo } from "../../../../input/EditTextInfo";
+/**
+ * DocContainer 内纯文本节点的 Enter 键处理器
+ * 结束当前编辑，在下方插入新的纯文本节点
+ * 如果光标在文本中间，则分割文本
+ */
+export declare class DocContainerEnterHandler extends EnterHandler {
+    private textSplitter;
+    private listLevelHelper;
+    /** 处理步骤列表 */
+    private steps;
+    enable(editInfo: EditTextInfo): boolean;
+    handle(context: AppEventContext): void;
+}

package/dist/plugin-hotkey/hotkey/text/enterKey/DocContainerEnterStep.d.ts

@@ -0,0 +1,48 @@
+import { AppEventContext } from "../../../../app";
+import { OolongDocContainer } from "../../../../graphics/OolongDocContainer";
+import { GraphicNode } from "../../../../graphics";
+import { RenderText, TextCursorPosition } from "../../../../renderText";
+/**
+ * DocContainer Enter 操作的上下文信息
+ */
+export interface DocContainerEnterContext {
+    /** 应用事件上下文 */
+    appContext: AppEventContext;
+    /** 当前编辑的节点 */
+    node: GraphicNode;
+    /** 父容器 */
+    docContainer: OolongDocContainer;
+    /** 渲染文本 */
+    renderText: RenderText;
+    /** 光标位置 */
+    textCursorPosition: TextCursorPosition;
+    /** 当前节点在 children 中的索引 */
+    currentIndex: number;
+    /** 是否是最后一个子节点 */
+    isLastChild: boolean;
+    /** 当前 children 列表（可修改） */
+    currentChildren: string[];
+    /** 光标前的富文本 */
+    prevRichText: string;
+    /** 光标后的富文本 */
+    nextRichText: string;
+    /** 光标后是否有文本 */
+    hasTextAfterCursor: boolean;
+    /** 新创建的节点 ID */
+    newChildId?: string;
+    /** 新节点的 Y 坐标 */
+    newY?: number;
+    /** 新节点的实际高度 */
+    actualNewHeight?: number;
+}
+/**
+ * DocContainer Enter 子处理器基类
+ * 用于将 DocContainer Enter 逻辑拆分成多个独立的步骤
+ */
+export declare abstract class DocContainerEnterStep {
+    /**
+     * 执行该步骤的处理逻辑
+     * @param ctx DocContainer Enter 上下文
+     */
+    abstract execute(ctx: DocContainerEnterContext): void;
+}

package/dist/plugin-hotkey/hotkey/text/enterKey/DocContainerTextSplitter.d.ts

@@ -0,0 +1,18 @@
+import { RenderText, TextCursorPosition } from "../../../../renderText";
+/**
+ * DocContainer 文本分割工具
+ * 用于在光标位置分割富文本
+ */
+export declare class DocContainerTextSplitter {
+    /**
+     * 在光标位置分割富文本，返回光标前后的两段 richText
+     */
+    splitRichTextAtCursor(renderText: RenderText, textCursor: TextCursorPosition): {
+        prevRichText: string;
+        nextRichText: string;
+    };
+    /**
+     * 检查光标后是否有文本内容
+     */
+    hasTextAfterCursor(nextRichText: string): boolean;
+}

package/dist/plugin-hotkey/hotkey/text/enterKey/EnterHandler.d.ts

@@ -0,0 +1,15 @@
+import { AppEventContext } from "../../../../app";
+import { EditTextInfo } from "../../../../input/EditTextInfo";
+/**
+ * Enter 键处理器基类
+ */
+export declare abstract class EnterHandler {
+    /**
+     * 判断是否启用该处理器
+     */
+    abstract enable(editInfo: EditTextInfo): boolean;
+    /**
+     * 处理 Enter 键事件
+     */
+    abstract handle(context: AppEventContext): void;
+}

package/dist/plugin-hotkey/hotkey/text/enterKey/EnterHotKey.d.ts

@@ -0,0 +1,13 @@
+import { HotKey } from "../../HotKey";
+import { AppEventContext } from "../../../../app";
+/**
+ * Enter 键热键处理器
+ * 使用 handler 链模式处理不同场景的 Enter 键事件
+ */
+export declare class EnterHotKey extends HotKey {
+    type: string;
+    /** 处理器列表，按优先级排序 */
+    private handlers;
+    enable(_event: KeyboardEvent): boolean;
+    work(_event: KeyboardEvent, context: AppEventContext): void;
+}

package/dist/plugin-hotkey/hotkey/text/enterKey/ListLevelDecreaseHelper.d.ts

@@ -0,0 +1,29 @@
+import { AppEventContext } from "../../../../app";
+import { GraphicNode } from "../../../../graphics";
+import { RenderText, TextCursorPosition } from "../../../../renderText";
+/**
+ * 列表层级减少辅助类
+ * 处理空文本节点按 Enter 时减少列表缩进层级的逻辑
+ */
+export declare class ListLevelDecreaseHelper {
+    /**
+     * 处理 DocContainer 文本节点的列表层级减少
+     * 当文本为空且有列表样式时，减少 level；level 为 0 时移除列表样式
+     * @returns 是否处理了列表层级减少（true 表示已处理，不需要继续执行换行逻辑）
+     */
+    handleDocContainerListDecrease(node: GraphicNode, renderText: RenderText, context: AppEventContext): boolean;
+    /**
+     * 处理普通文本节点的列表层级减少
+     * 当当前段落为空且有列表样式时，减少 level；level 为 0 时移除该段落的列表样式
+     * @returns 是否处理了列表层级减少（true 表示已处理，不需要继续执行换行逻辑）
+     */
+    handleNormalListDecrease(node: GraphicNode, renderText: RenderText, textCursorPosition: TextCursorPosition, context: AppEventContext): boolean;
+    /**
+     * 检查整个文本是否为空（用于 DocContainer 单文本节点）
+     */
+    private isTextEmpty;
+    /**
+     * 检查段落是否为空
+     */
+    private isParagraphEmpty;
+}