@8btc/whiteboard 0.0.20-alpha.39 → 0.0.20-alpha.40

package/dist/maze.d.ts

@@ -562,6 +562,25 @@ declare class CanvasApi extends CanvasCore {
         destroy(): void;
     }
 
+    /**
+     * 根据字体识别结果在选区附近创建可编辑的 rich-text 节点
+     */
+    export declare function createRichTextFromFontReplace(api: CanvasApi | null | undefined, params: {
+        text: string;
+        fontFamily: string;
+        fontId: string;
+        fontSize: number;
+        letterSpacing: number;
+        fontWeight: number;
+        fontColor: string;
+        lineHeight: number;
+        position: {
+            x: number;
+            y: number;
+        };
+        width: number;
+    }): string | undefined;
+
     /**
      * 图片裁剪变换数据
      * 描述图像位图在裁剪区域内的位置、缩放和旋转
@@ -583,6 +602,11 @@ declare class CanvasApi extends CanvasCore {
         $_type: "ellipse";
     };
 
+    /**
+     * 导出 font-replace 选区数据，用于发送到后端
+     */
+    export declare function exportFontReplaceRegion(api: CanvasApi | null | undefined, fontReplaceNodeId: string): Promise<FontReplaceObj | null>;
+
     /**
      * 根据图片标注裁剪图片并返回 base64 字符串
      * @param api Canvas API 实例
@@ -604,6 +628,64 @@ declare class CanvasApi extends CanvasCore {
         padding?: number;
     }): string | null;
 
+    /**
+     * 字体替换选区节点配置
+     */
+    declare type FontReplaceNodeConfig = BaseNodeConfig & default_2.RectConfig & Partial<NodeStyle> & {
+        $_type: "font-replace";
+        width: number;
+        height: number;
+        $_parentId: string;
+        $_relativeBox: {
+            start: {
+                ratioX: number;
+                ratioY: number;
+            };
+            end: {
+                ratioX: number;
+                ratioY: number;
+            };
+        };
+        $_status: "selecting" | "confirming" | "processing" | "done" | "error";
+        $_bounds?: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+    };
+
+    /**
+     * Font-Replace 选区数据结构（前端 → 后端）
+     */
+    export declare interface FontReplaceObj {
+        /** 选区裁剪后的 base64 图片 */
+        region_image: string;
+        /** 原图完整 URL（含标注框，用于 NanoBanana 擦除） */
+        edit_urls: string[];
+        /** 擦除提示词 */
+        prompt: string;
+        /** 选区在原图中的相对位置 */
+        relative_box: {
+            start: {
+                ratioX: number;
+                ratioY: number;
+            };
+            end: {
+                ratioX: number;
+                ratioY: number;
+            };
+        };
+        /** 原图节点 ID */
+        image_node_id: string;
+        /** font-replace 节点 ID */
+        font_replace_node_id: string;
+        /** 原图真实像素宽度 */
+        natural_width?: number;
+        /** 原图真实像素高度 */
+        natural_height?: number;
+    }
+
     declare type HistoryState<T> = {
         past: T[];
         present: T;
@@ -668,6 +750,16 @@ declare class CanvasApi extends CanvasCore {
         $_type: "image";
         $_imageUrl: string;
         $_cropTransform?: CropTransform | null;
+        $_applyBlurFilter?: boolean;
+        $_applyBrightnessFilter?: boolean;
+        $_applyRGBFilter?: boolean;
+        $_applyHSLFilter?: boolean;
+        red?: number;
+        green?: number;
+        blue?: number;
+        hue?: number;
+        saturation?: number;
+        luminance?: number;
         image?: CanvasImageSource | undefined;
     };
 
@@ -719,14 +811,14 @@ declare class CanvasApi extends CanvasCore {
      * 节点配置联合类型（判别联合）
      * 根据 $_type 字段可以自动推断出对应节点的特定字段
      */
-    declare type NodeConfig = RectangleNodeConfig | ImageNodeConfig | ImageMarkerNodeConfig | HtmlNodeConfig | TextNodeConfig | RichTextNodeConfig | VideoNodeConfig | StarNodeConfig | EllipseNodeConfig | PolygonNodeConfig | ArrowNodeConfig | BrushNodeConfig | ImageBrushNodeConfig;
+    declare type NodeConfig = RectangleNodeConfig | ImageNodeConfig | ImageMarkerNodeConfig | HtmlNodeConfig | TextNodeConfig | RichTextNodeConfig | VideoNodeConfig | StarNodeConfig | EllipseNodeConfig | PolygonNodeConfig | ArrowNodeConfig | BrushNodeConfig | ImageBrushNodeConfig | FontReplaceNodeConfig;
 
     declare interface NodeStyle {
         $_strokeColor: ThemeKeysStartingWith<"theme.stroke-color."> | string;
         $_fillColor: ThemeKeysStartingWith<"theme.fill-color."> | string;
     }
 
-    declare type NodeType = "rectangle" | "image" | "image-marker" | "html" | "text" | "rich-text" | "video" | "star" | "ellipse" | "polygon" | "arrow" | "brush" | "image-brush";
+    declare type NodeType = "rectangle" | "image" | "image-marker" | "html" | "text" | "rich-text" | "video" | "star" | "ellipse" | "polygon" | "arrow" | "brush" | "image-brush" | "font-replace";
 
     /**
      * 多边形节点配置
@@ -745,6 +837,11 @@ declare class CanvasApi extends CanvasCore {
         height: number;
     };
 
+    /**
+     * 替换图片节点的图片 URL（用擦除后的图片替换原图）
+     */
+    export declare function replaceImageUrl(api: CanvasApi | null | undefined, imageNodeId: string, newImageUrl: string): void;
+
     export declare function replaceLoadingImageNode(api: CanvasApi | null | undefined, loadingNodeId: string, imageUrls: string | string[]): void;
 
     declare type RichTextNodeConfig = BaseNodeConfig & default_2.ImageConfig & Partial<NodeStyle> & {
@@ -792,7 +889,7 @@ declare class CanvasApi extends CanvasCore {
 
     declare type ThemeKeysStartingWith<Prefix extends string> = Extract<keyof Theme, `${Prefix}${string}`>;
 
-    declare type ToolType = "select" | "hand" | "rectangle" | "star" | "image-marker" | "text" | "rich-text" | "ellipse" | "polygon" | "arrow" | "brush" | "image-brush";
+    declare type ToolType = "select" | "hand" | "rectangle" | "star" | "image-marker" | "text" | "rich-text" | "ellipse" | "polygon" | "arrow" | "brush" | "image-brush" | "font-replace";
 
     declare type TransformerConfig = {
         rotateEnabled?: boolean;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@8btc/whiteboard",
   "private": false,
-  "version": "0.0.20-alpha.39",
+  "version": "0.0.20-alpha.40",
   "type": "module",
   "main": "./dist/index.umd.js",
   "module": "./dist/index.js",