oolong-engine 0.0.1 → 0.0.2

package/dist/app/ai-api/module/AINodeAPI.d.ts

@@ -0,0 +1,380 @@
+import { OolongApp } from "../../OolongApp";
+import { RichTextHelper } from "../../../renderText/richText/RichTextHelper";
+/**
+ * AI Node API
+ * 提供给 AI 调用的节点操作接口
+ */
+export declare class AINodeAPI {
+    app: OolongApp;
+    textHelper: RichTextHelper;
+    constructor(app: OolongApp);
+    /**
+     * 获取上下文
+     */
+    private getCtx;
+    /**
+     * 计算富文本
+     * 如果文本已经是 <root> 开头的 XML 富文本格式，则直接返回
+     * 否则转换为富文本格式
+     */
+    private computeRichText;
+    /**
+     * 添加节点
+     * @param params 节点参数
+     * @returns {code: 200, id: string} | {code: number, msg: string}
+     */
+    addNode(params: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        angle?: number;
+        zIndex?: number;
+        color?: string;
+        alpha?: number;
+        borderColor?: string;
+        dashType?: number;
+        text?: string;
+        fontSize?: number;
+        fontColor?: string;
+        shapeCode?: number;
+        bold?: boolean;
+        italic?: boolean;
+        underline?: boolean;
+        strikethrough?: boolean;
+        verticalAlign?: number;
+        horizonAlign?: number;
+    }): {
+        code: number;
+        id?: string;
+        msg?: string;
+    };
+    /**
+     * 删除节点
+     * @param params 删除参数
+     * @returns {code: 200} | {code: number, msg: string}
+     */
+    deleteNode(params: {
+        ids: string[];
+    }): {
+        code: number;
+        msg?: string;
+    };
+    /**
+     * 更新节点
+     * @param params 更新参数
+     * @returns {code: 200} | {code: number, msg: string}
+     */
+    updateNode(params: {
+        id: string;
+        x?: number;
+        y?: number;
+        width?: number;
+        height?: number;
+        angle?: number;
+        zIndex?: number;
+        color?: string;
+        alpha?: number;
+        borderColor?: string;
+        borderWidth?: number;
+        borderAlpha?: number;
+        dashType?: number;
+        text?: string;
+        fontSize?: number;
+        fontColor?: string;
+        shapeCode?: number;
+    }): {
+        code: number;
+        msg?: string;
+    };
+    /**
+     * 批量更新节点
+     * @param params 批量更新参数
+     * @returns {code: 200, successCount: number} | {code: 206, successCount: number, errorCount: number, errors: any[]} | {code: number, msg: string}
+     */
+    batchUpdateNode(params: {
+        nodes: Array<{
+            id: string;
+            x?: number;
+            y?: number;
+            width?: number;
+            height?: number;
+            angle?: number;
+            zIndex?: number;
+            color?: string;
+            alpha?: number;
+            borderColor?: string;
+            borderWidth?: number;
+            borderAlpha?: number;
+            dashType?: number;
+            text?: string;
+            fontSize?: number;
+            fontColor?: string;
+            shapeCode?: number;
+            bold?: boolean;
+            italic?: boolean;
+            underline?: boolean;
+            strikethrough?: boolean;
+            verticalAlign?: number;
+            horizonAlign?: number;
+        }>;
+    }): {
+        code: number;
+        successCount?: number;
+        errorCount?: number;
+        errors?: any[];
+        msg?: string;
+    };
+    /**
+     * 查询节点
+     * @param params 查询参数（矩形区域）
+     * @returns {code: 200, nodes: any[]} | {code: number, msg: string}
+     */
+    selectNode(params: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    }): {
+        code: number;
+        nodes?: any[];
+        count?: number;
+        msg?: string;
+    };
+    /**
+     * 查询节点详细信息
+     * @param params 查询参数（节点 ID 数组）
+     * @returns {code: 200, nodes: any[]} | {code: number, msg: string}
+     */
+    selectNodeDetail(params: {
+        ids: string[];
+    }): {
+        code: number;
+        nodes?: any[];
+        count?: number;
+        msg?: string;
+    };
+    /**
+     * 计算文字节点尺寸
+     * 计算包含文字的节点的最小尺寸（确保文字不被遮挡）
+     * @param params 计算参数（节点 ID 数组）
+     * @returns {code: 200, nodes: any[]} | {code: number, msg: string}
+     */
+    computeTextNodeSize(params: {
+        ids: string[];
+    }): {
+        code: number;
+        nodes?: {
+            id: string;
+            width: number;
+            height: number;
+        }[];
+        count?: number;
+        msg?: string;
+    };
+    /**
+     * 添加连线
+     * @param params 连线参数
+     * @returns {code: 200, id: string} | {code: number, msg: string}
+     */
+    addLine(params: {
+        points: {
+            x: number;
+            y: number;
+        }[];
+        zIndex?: number;
+        shapeCode?: number;
+        borderColor?: string;
+        borderWidth?: number;
+        dashType?: number;
+        lArrow?: number;
+        rArrow?: number;
+        text?: string;
+        fontSize?: number;
+        fontColor?: string;
+        textPosition?: number;
+    }): {
+        code: number;
+        id?: string;
+        msg?: string;
+    };
+    /**
+     * 添加 SVG 节点
+     * @param params SVG 节点参数
+     * @returns {code: 200, id: string} | {code: number, msg: string}
+     */
+    addSvg(params: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        angle?: number;
+        svgCode: string;
+        borderColor?: string;
+        borderWidth?: number;
+        dashType?: number;
+    }): {
+        code: number;
+        id?: string;
+        msg?: string;
+    };
+    /**
+     * 批量添加节点
+     * @param params 批量节点参数
+     * @returns {code: 200, ids: string[]} | {code: number, msg: string}
+     */
+    batchAddNodes(params: {
+        nodes: Array<{
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+            angle?: number;
+            zIndex?: number;
+            color?: string;
+            alpha?: number;
+            borderColor?: string;
+            dashType?: number;
+            text?: string;
+            fontSize?: number;
+            fontColor?: string;
+            shapeCode?: number;
+            bold?: boolean;
+            italic?: boolean;
+            underline?: boolean;
+            strikethrough?: boolean;
+            verticalAlign?: number;
+            horizonAlign?: number;
+        }>;
+    }): {
+        code: number;
+        ids?: string[];
+        count?: number;
+        msg?: string;
+    };
+    /**
+     * 批量添加连线
+     * @param params 批量连线参数
+     * @returns {code: 200, ids: string[]} | {code: number, msg: string}
+     */
+    batchAddLines(params: {
+        lines: Array<{
+            points: {
+                x: number;
+                y: number;
+            }[];
+            zIndex?: number;
+            shapeCode?: number;
+            borderColor?: string;
+            borderWidth?: number;
+            dashType?: number;
+            lArrow?: number;
+            rArrow?: number;
+            text?: string;
+            fontSize?: number;
+            fontColor?: string;
+            textPosition?: number;
+        }>;
+    }): {
+        code: number;
+        ids?: string[];
+        count?: number;
+        msg?: string;
+    };
+    /**
+     * 创建连接线（连接两个节点或指定端点）
+     * @param params 连接线参数
+     * @returns {code: 200, id: string} | {code: number, msg: string}
+     */
+    connectLine(params: {
+        startInfo?: {
+            id: string;
+            endType: 0 | 1 | 2 | 3;
+        };
+        endInfo?: {
+            id: string;
+            endType: 0 | 1 | 2 | 3;
+        };
+        startPoint?: {
+            x: number;
+            y: number;
+        };
+        endPoint?: {
+            x: number;
+            y: number;
+        };
+        zIndex?: number;
+        shapeCode?: number;
+        borderColor?: string;
+        borderWidth?: number;
+        dashType?: number;
+        lArrow?: number;
+        rArrow?: number;
+        text?: string;
+        fontSize?: number;
+        fontColor?: string;
+        textPosition?: number;
+    }): {
+        code: number;
+        id?: string;
+        msg?: string;
+    };
+    /**
+     * 批量创建连接线
+     * @param params 批量连接线参数
+     * @returns {code: 200, successCount: number, failedCount: number, results: Array} | {code: number, msg: string}
+     */
+    batchConnectLine(params: {
+        connections: Array<{
+            startInfo?: {
+                id: string;
+                endType: 0 | 1 | 2 | 3;
+            };
+            endInfo?: {
+                id: string;
+                endType: 0 | 1 | 2 | 3;
+            };
+            startPoint?: {
+                x: number;
+                y: number;
+            };
+            endPoint?: {
+                x: number;
+                y: number;
+            };
+            zIndex?: number;
+            shapeCode?: number;
+            borderColor?: string;
+            borderWidth?: number;
+            dashType?: number;
+            lArrow?: number;
+            rArrow?: number;
+            text?: string;
+            fontSize?: number;
+            fontColor?: string;
+            textPosition?: number;
+        }>;
+        defaultStyle?: {
+            zIndex?: number;
+            shapeCode?: number;
+            borderColor?: string;
+            borderWidth?: number;
+            dashType?: number;
+            lArrow?: number;
+            rArrow?: number;
+            fontSize?: number;
+            fontColor?: string;
+        };
+    }): {
+        code: number;
+        successCount?: number;
+        failedCount?: number;
+        results?: Array<{
+            index: number;
+            success: boolean;
+            id?: string;
+            error?: string;
+        }>;
+        msg?: string;
+    };
+}

package/dist/app/ai-api/module/AIViewportAPI.d.ts

@@ -0,0 +1,59 @@
+import { OolongApp } from "../../OolongApp";
+/**
+ * AI Viewport API
+ * 提供给 AI 调用的视口操作接口
+ */
+export declare class AIViewportAPI {
+    app: OolongApp;
+    constructor(app: OolongApp);
+    /**
+     * 获取上下文
+     */
+    private getCtx;
+    /**
+     * 获取视口边界
+     * @returns {code: 200, bounds: {minX, minY, maxX, maxY, width, height}} | {code: number, msg: string}
+     */
+    getViewportBounds(): {
+        code: number;
+        bounds?: {
+            minX: number;
+            minY: number;
+            maxX: number;
+            maxY: number;
+            width: number;
+            height: number;
+        };
+        msg?: string;
+    };
+    /**
+     * 缩放到指定边界区域
+     * @param minX - 目标区域的最小X坐标
+     * @param minY - 目标区域的最小Y坐标
+     * @param maxX - 目标区域的最大X坐标
+     * @param maxY - 目标区域的最大Y坐标
+     * @returns {code: 200} | {code: number, msg: string}
+     */
+    zoomToBounds(minX: number, minY: number, maxX: number, maxY: number): {
+        code: number;
+        msg?: string;
+    };
+    /**
+     * 缩放适配画布中的所有节点
+     * 将所有节点完整显示在视口中
+     * @returns {code: 200} | {code: number, msg: string}
+     */
+    zoomToFit(): {
+        code: number;
+        msg?: string;
+    };
+    /**
+     * 缩放到当前选中的节点
+     * 将选中节点居中显示在视口中
+     * @returns {code: 200} | {code: number, msg: string}
+     */
+    zoomToSelect(): {
+        code: number;
+        msg?: string;
+    };
+}

package/dist/app/ai-api/module/SelectAPI.d.ts

@@ -0,0 +1,51 @@
+import { OolongApp } from "../../OolongApp";
+/**
+ * AI Select API
+ * 提供给 AI 调用的选择节点操作接口
+ */
+export declare class SelectAPI {
+    app: OolongApp;
+    constructor(app: OolongApp);
+    /**
+     * 获取上下文
+     */
+    private getCtx;
+    /**
+     * 获取选中节点信息
+     * 无需传入任何参数，返回当前画布上选中的所有节点的简要信息
+     * 如需详细信息，可调用 selectNodeDetail 方法
+     * @returns {code: 200, nodes: Array, count: number} | {code: number, msg: string}
+     */
+    getSelectedNodes(): {
+        code: number;
+        nodes?: Array<{
+            id: string;
+            text: string;
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+        count?: number;
+        msg?: string;
+    };
+    /**
+     * 获取所有节点信息
+     * 无需传入任何参数，返回画布上所有节点的简要信息
+     * 如需详细信息，可调用 selectNodeDetail 方法
+     * @returns {code: 200, nodes: Array, count: number} | {code: number, msg: string}
+     */
+    selectAllNodes(): {
+        code: number;
+        nodes?: Array<{
+            id: string;
+            text: string;
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        }>;
+        count?: number;
+        msg?: string;
+    };
+}

package/dist/app/api/OolongAPI.d.ts

@@ -2,21 +2,41 @@ import { OolongApp } from "../OolongApp";
 import { IRectNode, Point, Rect } from "../../common";
 import { SlotCallback, SlotKeyType } from "../../slot";
 import { GraphicNode } from "../../graphics";
-import { CreateAPI } from "./module/createAPI";
+import { CreateAPI } from "./module/CreateAPI";
 import { ImageAPI } from "./module/ImageAPI";
 import { CopyPasteAPI } from "./module/CopyPasteAPI";
 import { CropAPI } from "./module/CropAPI";
+import { SwitchAPI } from "./module/SwitchAPI";
+import { PropChangeAPI } from "./module/propChange/PropChangeAPI";
+import { AlignAPI } from "./module/align/AlignAPI";
+import { TextAPI } from "./module/text/TextAPI";
+import { SlideAPI } from "./module/slide/SlideAPI";
 export declare class OolongAPI {
     app: OolongApp;
     create: CreateAPI;
     image: ImageAPI;
     copyPaste: CopyPasteAPI;
     crop: CropAPI;
+    switch: SwitchAPI;
+    propChangeAPI: PropChangeAPI;
+    align: AlignAPI;
+    text: TextAPI;
+    slide: SlideAPI;
     constructor(app: OolongApp);
+    resizeCanvas(): void;
+    /**
+     * 聚焦渲染
+     * @param nodeId
+     * @param buffer
+     * @param padding
+     */
+    focus(nodeId?: string, buffer?: number, padding?: number): void;
+    resetCursor(): void;
     zoomScale(scale: number, globalPoint: Point): void;
     zoomToFit(): void;
     zoomToSelect(): void;
     zoomTo100(): void;
+    exportCoverCanvas(resolution: number, bgColor?: string): HTMLCanvasElement;
     exportOfflineCanvas(rectNode: IRectNode, resolution: number, bgColor?: string): HTMLCanvasElement;
     exportAllNodesImg(resolution: number, bgColor?: string): HTMLCanvasElement;
     scroll(dx: number, dy: number): void;
@@ -34,4 +54,5 @@ export declare class OolongAPI {
     makeUnGroup(): void;
     getImageBlobUrl(fileKey: string): string;
     deleteSelectNodes(): void;
+    deleteByIds(ids: string[]): void;
 }

package/dist/app/api/module/{createAPI.d.ts → CreateAPI.d.ts}

@@ -1,7 +1,15 @@
 import { OolongApp } from "../../OolongApp";
+import { GraphicNode } from "../../../graphics";
+import { DocumentInfo, NodeType } from "../../../idl";
 export declare class CreateAPI {
     app: OolongApp;
     constructor(app: OolongApp);
+    /**
+     * 找空地方法
+     * @param docInfo
+     */
+    addTemplateNodes(docInfo: DocumentInfo): void;
+    addNode(nodeType: NodeType, shapeCode: number): void;
     addSvgNodeBySvgCode(svgCode: string): void;
     /**
      * 添加svg节点，默认添加到视口中间
@@ -17,4 +25,12 @@ export declare class CreateAPI {
      */
     addImageNode(imgUrl: string, width: number, height: number): void;
     quickCreateNode(shapeType: number, lineId: string): void;
+    makeupToSlidesBySelective(): void;
+    makeupToSlides(nodes: GraphicNode[]): void;
+    /**
+     * 按照位置排序 sections：先找最左上角的节点，然后按行排序
+     * @param sections
+     * @returns 排序后的 section id 一维数组
+     */
+    private sortSectionsByPosition;
 }

package/dist/app/api/module/SwitchAPI.d.ts

@@ -0,0 +1,10 @@
+import { OolongApp } from "../../OolongApp";
+import { LineTextWorker } from "../../../ability/line/LineTextWorker";
+export declare class SwitchAPI {
+    app: OolongApp;
+    lineTextWorker: LineTextWorker;
+    constructor(app: OolongApp);
+    switchShape(shapeCode: number): void;
+    switchLineShape(lineShapeCode: number): void;
+    private modifyLinePoints;
+}

package/dist/app/api/module/align/AlignAPI.d.ts

@@ -0,0 +1,19 @@
+import { OolongApp } from "../../../OolongApp";
+import { RelatedGroupBaseWorker } from "../../../../ability/group/RelatedGroupBaseWorker";
+export declare class AlignAPI {
+    app: OolongApp;
+    groupBaseWorker: RelatedGroupBaseWorker;
+    constructor(app: OolongApp);
+    alignLeft(): void;
+    alignRight(): void;
+    alignHorizontalCenter(): void;
+    private dealNodePos;
+    alignTop(): void;
+    alignBottom(): void;
+    alignVerticalCenter(): void;
+    distributeHorizontal(): void;
+    distributeVertical(): void;
+    private getAlignNodes;
+    private getLayoutNodes;
+    private computeGroupChildrenAction;
+}

package/dist/app/api/module/propChange/PropChangeAPI.d.ts

@@ -0,0 +1,5 @@
+import { OolongApp } from "../../../OolongApp";
+export declare class PropChangeAPI {
+    app: OolongApp;
+    constructor(app: OolongApp);
+}

package/dist/app/api/module/propChange/fontsize/AbsFontSizeChangeHandler.d.ts

@@ -0,0 +1,6 @@
+import { GraphicNode } from "../../../../../graphics";
+import { UpdateNodeInfo } from "../../../../../action";
+export declare abstract class AbsFontSizeChangeHandler {
+    abstract enable(node: GraphicNode): boolean;
+    abstract handle(node: GraphicNode, fontSize: number): UpdateNodeInfo;
+}

package/dist/app/api/module/propChange/fontsize/CheckboxTextFontSizeChangeHandler.d.ts

@@ -0,0 +1,7 @@
+import { GraphicNode } from "../../../../../graphics";
+import { UpdateNodeInfo } from "../../../../../action";
+import { AbsFontSizeChangeHandler } from "./AbsFontSizeChangeHandler";
+export declare class CheckboxTextFontSizeChangeHandler extends AbsFontSizeChangeHandler {
+    enable(node: GraphicNode): boolean;
+    handle(node: GraphicNode, fontSize: number): UpdateNodeInfo;
+}

package/dist/app/api/module/propChange/fontsize/NormalFontSizeChangeHandler.d.ts

@@ -0,0 +1,7 @@
+import { GraphicNode } from "../../../../../graphics";
+import { UpdateNodeInfo } from "../../../../../action";
+import { AbsFontSizeChangeHandler } from "./AbsFontSizeChangeHandler";
+export declare class NormalFontSizeChangeHandler extends AbsFontSizeChangeHandler {
+    enable(node: GraphicNode): boolean;
+    handle(node: GraphicNode, fontSize: number): UpdateNodeInfo;
+}

package/dist/app/api/module/slide/SlideAPI.d.ts

@@ -0,0 +1,25 @@
+import { OolongApp } from "../../../OolongApp";
+import { OolongSlideContainer } from "../../../../graphics/OolongSlideContainer";
+import { SlidePlayWorker } from "../../../../ability/slide/SlidePlayWorker";
+import { DuplicateWorker } from "../../../../ability/copyPaste/duplicate/DuplicateWorker";
+export declare class SlideAPI {
+    app: OolongApp;
+    slidePlayWorker: SlidePlayWorker;
+    duplicateWorker: DuplicateWorker;
+    constructor(app: OolongApp);
+    createEmptySlideContainer(): void;
+    refocusSlide(padding?: number): void;
+    enterEditing(): void;
+    exitEditing(): void;
+    jumpToWhenEditing(index: number): void;
+    enterPlayFromEdit(): void;
+    enterPlay(): void;
+    playToNext(): void;
+    playToPrev(): void;
+    exitPlay(): void;
+    unGroupSlideContainerBySelective(): void;
+    unGroupSlideContainer(container: OolongSlideContainer): void;
+    insertSlideByEditingMode(index: number): Promise<void>;
+    deleteSlideByEditingMode(index: number): void;
+    duplicateSlideByEditingMode(index: number): void;
+}

package/dist/app/api/module/text/TextAPI.d.ts

@@ -0,0 +1,38 @@
+import { OolongApp } from "../../../OolongApp";
+import { TextUnOrderWorker } from "../../../../ability/textInput/textParagraphPrefix/TextUnOrderWorker";
+import { TextOrderWorker } from "../../../../ability/textInput/textParagraphPrefix/TextOrderWorker";
+import { TextQuoteWorker } from "../../../../ability/textInput/textParagraphPrefix/TextQuoteWorker";
+import { TextNormalWorker } from "../../../../ability/textInput/textParagraphPrefix/TextNormalWorker";
+import { TextFontColorWorker } from "../../../../ability/textInput/textFont/TextFontColorWorker";
+import { TextFontBgColorWorker } from "../../../../ability/textInput/textFont/TextFontBgColorWorker";
+import { TextFontBoldWorker } from "../../../../ability/textInput/textFont/TextFontBoldWorker";
+import { TextFontItalicWorker } from "../../../../ability/textInput/textFont/TextFontItalicWorker";
+import { TextUnderLineWorker } from "../../../../ability/textInput/textFont/TextUnderLineWorker";
+import { TextFontStrikethroughWorker } from "../../../../ability/textInput/textFont/TextFontStrikethroughWorker";
+import { TextFontSizeWorker } from "../../../../ability/textInput/textFont/TextFontSizeWorker";
+export declare class TextAPI {
+    app: OolongApp;
+    textUnOrderWorker: TextUnOrderWorker;
+    textOrderWorker: TextOrderWorker;
+    textQuoteWorker: TextQuoteWorker;
+    textNormalWorker: TextNormalWorker;
+    textFontColorWorker: TextFontColorWorker;
+    textFontBgColorWorker: TextFontBgColorWorker;
+    textFontBoldWorker: TextFontBoldWorker;
+    textFontItalicWorker: TextFontItalicWorker;
+    textUnderLineWorker: TextUnderLineWorker;
+    textFontStrikethroughWorker: TextFontStrikethroughWorker;
+    textFontSizeWorker: TextFontSizeWorker;
+    constructor(app: OolongApp);
+    addUnOrderList(): void;
+    addOrderList(): void;
+    addQuote(): void;
+    toNormal(): void;
+    changeTextColor(color: string): void;
+    changeTextBgColor(color: string): void;
+    changeTextBold(bold: boolean): void;
+    changeTextItalic(italic: boolean): void;
+    changeTextUnderLine(underline: boolean): void;
+    changeTextStrikethrough(strikethrough: boolean): void;
+    changeTextFontSize(fontSize: number): void;
+}