star-horse-lowcode 3.1.14 → 3.1.15

package/dist/types/components/whiteboard/composables/useWhiteboardDesigner.d.ts

@@ -0,0 +1,301 @@
+/**
+ * 白板组件 - 状态管理
+ *
+ * 管理 elements / 当前工具 / 颜色 / 线宽 / 透明度 / 选择 / 历史栈
+ */
+import type { WbCanvasConfig, WhiteboardElement, WhiteboardState, WhiteboardTool } from "../types";
+export declare function useWhiteboardDesigner(initial?: Partial<WhiteboardState>): {
+    state: {
+        elements: ({
+            type: "pen";
+            points: {
+                x: number;
+                y: number;
+            }[];
+            stroke: string;
+            strokeWidth: number;
+            id: string;
+            rotation?: number;
+            opacity?: number;
+            locked?: boolean;
+            visible?: boolean;
+            name?: string;
+        } | {
+            type: "shape";
+            shape: import("..").WhiteboardShapeType;
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+            stroke: string;
+            fill: string;
+            strokeWidth: number;
+            id: string;
+            rotation?: number;
+            opacity?: number;
+            locked?: boolean;
+            visible?: boolean;
+            name?: string;
+        } | {
+            type: "line";
+            x1: number;
+            y1: number;
+            x2: number;
+            y2: number;
+            stroke: string;
+            strokeWidth: number;
+            id: string;
+            rotation?: number;
+            opacity?: number;
+            locked?: boolean;
+            visible?: boolean;
+            name?: string;
+        } | {
+            type: "line";
+            arrow: true;
+            x1: number;
+            y1: number;
+            x2: number;
+            y2: number;
+            stroke: string;
+            strokeWidth: number;
+            id: string;
+            rotation?: number;
+            opacity?: number;
+            locked?: boolean;
+            visible?: boolean;
+            name?: string;
+        } | {
+            type: "text";
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+            text: string;
+            fontSize: number;
+            color: string;
+            fontWeight?: "normal" | "bold";
+            textAlign?: "left" | "center" | "right";
+            id: string;
+            rotation?: number;
+            opacity?: number;
+            locked?: boolean;
+            visible?: boolean;
+            name?: string;
+        })[];
+        selectedIds: string[];
+        tool: WhiteboardTool;
+        stroke: string;
+        fill: string;
+        strokeWidth: number;
+        opacity: number;
+        fontSize: number;
+        canvas: {
+            zoom: number;
+            panX: number;
+            panY: number;
+            showGrid: boolean;
+            gridSize: number;
+            backgroundColor: string;
+        };
+        readonly: boolean;
+    };
+    drafting: import("vue").Ref<{
+        type: "pen";
+        points: {
+            x: number;
+            y: number;
+        }[];
+        stroke: string;
+        strokeWidth: number;
+        id: string;
+        rotation?: number;
+        opacity?: number;
+        locked?: boolean;
+        visible?: boolean;
+        name?: string;
+    } | {
+        type: "shape";
+        shape: import("..").WhiteboardShapeType;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        stroke: string;
+        fill: string;
+        strokeWidth: number;
+        id: string;
+        rotation?: number;
+        opacity?: number;
+        locked?: boolean;
+        visible?: boolean;
+        name?: string;
+    } | {
+        type: "line";
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+        stroke: string;
+        strokeWidth: number;
+        id: string;
+        rotation?: number;
+        opacity?: number;
+        locked?: boolean;
+        visible?: boolean;
+        name?: string;
+    } | {
+        type: "line";
+        arrow: true;
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+        stroke: string;
+        strokeWidth: number;
+        id: string;
+        rotation?: number;
+        opacity?: number;
+        locked?: boolean;
+        visible?: boolean;
+        name?: string;
+    } | {
+        type: "text";
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        text: string;
+        fontSize: number;
+        color: string;
+        fontWeight?: "normal" | "bold";
+        textAlign?: "left" | "center" | "right";
+        id: string;
+        rotation?: number;
+        opacity?: number;
+        locked?: boolean;
+        visible?: boolean;
+        name?: string;
+    }, WhiteboardElement | {
+        type: "pen";
+        points: {
+            x: number;
+            y: number;
+        }[];
+        stroke: string;
+        strokeWidth: number;
+        id: string;
+        rotation?: number;
+        opacity?: number;
+        locked?: boolean;
+        visible?: boolean;
+        name?: string;
+    } | {
+        type: "shape";
+        shape: import("..").WhiteboardShapeType;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        stroke: string;
+        fill: string;
+        strokeWidth: number;
+        id: string;
+        rotation?: number;
+        opacity?: number;
+        locked?: boolean;
+        visible?: boolean;
+        name?: string;
+    } | {
+        type: "line";
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+        stroke: string;
+        strokeWidth: number;
+        id: string;
+        rotation?: number;
+        opacity?: number;
+        locked?: boolean;
+        visible?: boolean;
+        name?: string;
+    } | {
+        type: "line";
+        arrow: true;
+        x1: number;
+        y1: number;
+        x2: number;
+        y2: number;
+        stroke: string;
+        strokeWidth: number;
+        id: string;
+        rotation?: number;
+        opacity?: number;
+        locked?: boolean;
+        visible?: boolean;
+        name?: string;
+    } | {
+        type: "text";
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        text: string;
+        fontSize: number;
+        color: string;
+        fontWeight?: "normal" | "bold";
+        textAlign?: "left" | "center" | "right";
+        id: string;
+        rotation?: number;
+        opacity?: number;
+        locked?: boolean;
+        visible?: boolean;
+        name?: string;
+    }>;
+    tool: import("vue").ComputedRef<WhiteboardTool>;
+    canvas: import("vue").ComputedRef<WbCanvasConfig>;
+    selectedElements: import("vue").ComputedRef<WhiteboardElement[]>;
+    selectedElement: import("vue").ComputedRef<WhiteboardElement>;
+    elementCount: import("vue").ComputedRef<number>;
+    reversedElements: import("vue").ComputedRef<WhiteboardElement[]>;
+    canUndo: import("vue").ComputedRef<boolean>;
+    canRedo: import("vue").ComputedRef<boolean>;
+    setTool: (t: WhiteboardTool) => void;
+    setStroke: (color: string) => void;
+    setFill: (color: string) => void;
+    setStrokeWidth: (w: number) => void;
+    setOpacity: (o: number) => void;
+    setFontSize: (s: number) => void;
+    selectElement: (id: string, multi?: boolean) => void;
+    selectMany: (ids: string[]) => void;
+    clearSelection: () => void;
+    isSelected: (id: string) => boolean;
+    addElement: (el: WhiteboardElement, pushHist?: boolean) => void;
+    updateElement: (id: string, patch: Partial<WhiteboardElement>) => void;
+    moveElement: (id: string, dx: number, dy: number) => void;
+    deleteElements: (ids?: string[]) => void;
+    duplicateElement: (id: string) => void;
+    setDrafting: (el: WhiteboardElement | null) => void;
+    commitDrafting: () => void;
+    cancelDrafting: () => void;
+    bringToFront: (id: string) => void;
+    bringForward: (id: string) => void;
+    sendBackward: (id: string) => void;
+    sendToBack: (id: string) => void;
+    toggleVisible: (id: string) => void;
+    undo: () => void;
+    redo: () => void;
+    pushHistory: () => void;
+    setZoom: (zoom: number) => void;
+    zoomIn: () => void;
+    zoomOut: () => void;
+    zoomReset: () => void;
+    setPan: (x: number, y: number) => void;
+    toggleGrid: () => void;
+    clearBoard: () => Promise<void>;
+    loadElements: (elements: WhiteboardElement[]) => void;
+    getElements: () => WhiteboardElement[];
+    resetAll: () => void;
+};
+export type UseWhiteboardDesignerReturn = ReturnType<typeof useWhiteboardDesigner>;

package/dist/types/components/whiteboard/composables/useWhiteboardHistory.d.ts

@@ -0,0 +1,20 @@
+export declare const useWhiteboardHistory: <T>(initial: T, maxLen?: number) => {
+    past: {
+        value: T[];
+    };
+    future: {
+        value: T[];
+    };
+    current: {
+        value: T;
+    };
+    canUndo: import("vue").ComputedRef<boolean>;
+    canRedo: import("vue").ComputedRef<boolean>;
+    push: (next: T) => void;
+    replace: (next: T) => void;
+    undo: () => T | null;
+    redo: () => T | null;
+    clear: () => void;
+    reset: (val: T) => void;
+};
+export type UseWhiteboardHistoryReturn<T> = ReturnType<typeof useWhiteboardHistory<T>>;

package/dist/types/components/whiteboard/constants.d.ts

@@ -0,0 +1,94 @@
+/**
+ * 白板组件 - 常量定义
+ *
+ * 工具/形状/颜色/线宽 预设
+ * 注意：常量统一使用 WB_ 前缀，避免与其他模块冲突
+ */
+import type { WbColorPreset, WbLineWidthPreset, WbShapePreset, WbToolPreset, WhiteboardElement, WhiteboardShapeType, WhiteboardState, WhiteboardTool } from "./types";
+/** 默认画布配置 */
+export declare const WB_DEFAULT_CANVAS: {
+    zoom: number;
+    panX: number;
+    panY: number;
+    showGrid: boolean;
+    gridSize: number;
+    backgroundColor: string;
+};
+/** 默认描边色 */
+export declare const WB_DEFAULT_STROKE = "#1890FF";
+/** 默认填充色 */
+export declare const WB_DEFAULT_FILL = "transparent";
+/** 默认线宽 */
+export declare const WB_DEFAULT_STROKE_WIDTH = 2;
+/** 默认透明度 */
+export declare const WB_DEFAULT_OPACITY = 1;
+/** 默认字号 */
+export declare const WB_DEFAULT_FONT_SIZE = 16;
+/** 历史最大长度 */
+export declare const WB_MAX_HISTORY = 50;
+/** 工具预设列表 */
+export declare const WB_TOOL_PRESETS: WbToolPreset[];
+/** 形状预设列表 */
+export declare const WB_SHAPE_TYPE_PRESETS: WbShapePreset[];
+/** 颜色预设 */
+export declare const WB_COLOR_PRESETS: WbColorPreset[];
+/** 线宽预设 */
+export declare const WB_LINE_WIDTH_PRESETS: WbLineWidthPreset[];
+/** 透明度预设 */
+export declare const WB_OPACITY_PRESETS: WbLineWidthPreset[];
+/** 字号预设 */
+export declare const WB_FONT_SIZE_PRESETS: WbLineWidthPreset[];
+/** 生成元素 ID */
+export declare const wbGenId: (prefix?: string) => string;
+/** 创建画笔元素 */
+export declare const createWbPenElement: (params: {
+    points: {
+        x: number;
+        y: number;
+    }[];
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+}) => WhiteboardElement;
+/** 创建形状元素 */
+export declare const createWbShapeElement: (params: {
+    shape: WhiteboardShapeType;
+    x: number;
+    y: number;
+    width?: number;
+    height?: number;
+    stroke?: string;
+    fill?: string;
+    strokeWidth?: number;
+    opacity?: number;
+}) => WhiteboardElement;
+/** 创建直线元素 */
+export declare const createWbLineElement: (params: {
+    x1: number;
+    y1: number;
+    x2: number;
+    y2: number;
+    stroke?: string;
+    strokeWidth?: number;
+    opacity?: number;
+    arrow?: boolean;
+}) => WhiteboardElement;
+/** 创建文本元素 */
+export declare const createWbTextElement: (params: {
+    x: number;
+    y: number;
+    text?: string;
+    width?: number;
+    height?: number;
+    color?: string;
+    fontSize?: number;
+    opacity?: number;
+}) => WhiteboardElement;
+/** 统一元素工厂（按工具创建） */
+export declare const createWbElement: (tool: WhiteboardTool, params: Record<string, any>) => WhiteboardElement | null;
+/** 创建初始状态 */
+export declare const createWbInitialState: (initialElements?: WhiteboardElement[]) => WhiteboardState;
+/** 工具的 i18n 标签 */
+export declare const wbToolLabel: (tool: WhiteboardTool) => string;
+/** 形状的 i18n 标签 */
+export declare const wbShapeLabel: (shape: WhiteboardShapeType) => string;

package/dist/types/components/whiteboard/dialogs/WbExportDialog.vue.d.ts

@@ -0,0 +1,12 @@
+import type { WhiteboardElement } from "../types";
+type __VLS_Props = {
+    visible: boolean;
+    elements: WhiteboardElement[];
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    "update:visible": (v: boolean) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    "onUpdate:visible"?: (v: boolean) => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/types/components/whiteboard/index.d.ts

@@ -0,0 +1,12 @@
+export { default as Whiteboard } from "./Whiteboard.vue";
+export { default as WbToolbar } from "./panels/WbToolbar.vue";
+export { default as WbCanvas } from "./panels/WbCanvas.vue";
+export { default as WbLayerPanel } from "./panels/WbLayerPanel.vue";
+export { default as WbPropertyPanel } from "./panels/WbPropertyPanel.vue";
+export { default as WbExportDialog } from "./dialogs/WbExportDialog.vue";
+export { useWhiteboardDesigner } from "./composables/useWhiteboardDesigner";
+export { useWhiteboardHistory } from "./composables/useWhiteboardHistory";
+export { WB_TOOL_PRESETS, WB_SHAPE_TYPE_PRESETS, WB_COLOR_PRESETS, WB_LINE_WIDTH_PRESETS, WB_OPACITY_PRESETS, WB_FONT_SIZE_PRESETS, WB_DEFAULT_CANVAS, WB_DEFAULT_STROKE, WB_DEFAULT_FILL, WB_DEFAULT_STROKE_WIDTH, WB_DEFAULT_OPACITY, WB_DEFAULT_FONT_SIZE, WB_MAX_HISTORY, wbGenId, createWbPenElement, createWbShapeElement, createWbLineElement, createWbTextElement, createWbElement, createWbInitialState, wbToolLabel, wbShapeLabel, } from "./constants";
+export { wbDistance, wbDistanceSq, wbPointToSegment, wbPointInRect, wbPointInEllipse, wbPointInTriangle, wbPointInDiamond, wbPointsToPath, wbArrowPath, wbShapePath, wbGetBoundingBox, wbHitTest, wbElementIntersectsRect, wbExpandBox, wbUnionBox, } from "./utils/WbGeometryUtils";
+export { wbElementToSvg, wbGetElementsBounds, wbToSvgXml, wbToJson, wbSvgXmlToPng, wbDownloadBlob, wbDownloadText, } from "./utils/WbExportUtils";
+export type * from "./types";

package/dist/types/components/whiteboard/panels/WbCanvas.vue.d.ts

@@ -0,0 +1,8 @@
+import type { UseWhiteboardDesignerReturn } from "../composables/useWhiteboardDesigner";
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    designer: UseWhiteboardDesignerReturn;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    designer: UseWhiteboardDesignerReturn;
+}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/types/components/whiteboard/panels/WbLayerPanel.vue.d.ts

@@ -0,0 +1,10 @@
+import type { UseWhiteboardDesignerReturn } from "../composables/useWhiteboardDesigner";
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    designer: UseWhiteboardDesignerReturn;
+    readonly?: boolean;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    designer: UseWhiteboardDesignerReturn;
+    readonly?: boolean;
+}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/types/components/whiteboard/panels/WbPropertyPanel.vue.d.ts

@@ -0,0 +1,10 @@
+import type { UseWhiteboardDesignerReturn } from "../composables/useWhiteboardDesigner";
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    designer: UseWhiteboardDesignerReturn;
+    readonly?: boolean;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<{
+    designer: UseWhiteboardDesignerReturn;
+    readonly?: boolean;
+}> & Readonly<{}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/types/components/whiteboard/panels/WbToolbar.vue.d.ts

@@ -0,0 +1,14 @@
+import type { UseWhiteboardDesignerReturn } from "../composables/useWhiteboardDesigner";
+declare const _default: typeof __VLS_export;
+export default _default;
+declare const __VLS_export: import("vue").DefineComponent<{
+    designer: UseWhiteboardDesignerReturn;
+    readonly?: boolean;
+}, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {} & {
+    export: () => any;
+}, string, import("vue").PublicProps, Readonly<{
+    designer: UseWhiteboardDesignerReturn;
+    readonly?: boolean;
+}> & Readonly<{
+    onExport?: () => any;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;

package/dist/types/components/whiteboard/types.d.ts

@@ -0,0 +1,190 @@
+/**
+ * 白板组件 - 类型定义
+ *
+ * 元素类型：pen / shape / line / text
+ * 支持选择、拖拽、缩放、旋转、撤销/重做、导出
+ */
+/** 白板工具 */
+export type WhiteboardTool = "select" | "pan" | "pen" | "eraser" | "line" | "rect" | "circle" | "triangle" | "diamond" | "arrow" | "text";
+/** 形状子类型（用于 shape 元素） */
+export type WhiteboardShapeType = "rect" | "circle" | "triangle" | "diamond" | "arrow";
+/** 元素基础属性 */
+export interface WbBaseElement {
+    id: string;
+    /** 元素类型 */
+    type: "pen" | "shape" | "line" | "text";
+    /** 旋转角度（度，0-360） */
+    rotation?: number;
+    /** 透明度 0-1 */
+    opacity?: number;
+    /** 是否锁定 */
+    locked?: boolean;
+    /** 是否可见 */
+    visible?: boolean;
+    /** 名称（图层显示用） */
+    name?: string;
+}
+/** 点 */
+export interface WbPoint {
+    x: number;
+    y: number;
+}
+/** 画笔元素（自由曲线） */
+export interface PenElement extends WbBaseElement {
+    type: "pen";
+    /** 路径点数组 */
+    points: WbPoint[];
+    /** 描边色 */
+    stroke: string;
+    /** 线宽 */
+    strokeWidth: number;
+}
+/** 形状元素（矩形/圆形/三角形/菱形/箭头） */
+export interface ShapeElement extends WbBaseElement {
+    type: "shape";
+    /** 形状子类型 */
+    shape: WhiteboardShapeType;
+    /** X 坐标（左上角） */
+    x: number;
+    /** Y 坐标（左上角） */
+    y: number;
+    /** 宽度 */
+    width: number;
+    /** 高度 */
+    height: number;
+    /** 描边色 */
+    stroke: string;
+    /** 填充色，"transparent" 表示透明 */
+    fill: string;
+    /** 线宽 */
+    strokeWidth: number;
+}
+/** 直线元素 */
+export interface LineElement extends WbBaseElement {
+    type: "line";
+    /** 起点 */
+    x1: number;
+    y1: number;
+    /** 终点 */
+    x2: number;
+    y2: number;
+    /** 描边色 */
+    stroke: string;
+    /** 线宽 */
+    strokeWidth: number;
+}
+/** 箭头元素（带箭头的线段） */
+export interface ArrowElement extends WbBaseElement {
+    type: "line";
+    /** 子类型：箭头 */
+    arrow: true;
+    /** 起点 */
+    x1: number;
+    y1: number;
+    /** 终点 */
+    x2: number;
+    y2: number;
+    /** 描边色 */
+    stroke: string;
+    /** 线宽 */
+    strokeWidth: number;
+}
+/** 文本元素 */
+export interface TextElement extends WbBaseElement {
+    type: "text";
+    /** X 坐标（左上角） */
+    x: number;
+    /** Y 坐标（左上角） */
+    y: number;
+    /** 宽度 */
+    width: number;
+    /** 高度 */
+    height: number;
+    /** 文本内容 */
+    text: string;
+    /** 字号 */
+    fontSize: number;
+    /** 文字颜色 */
+    color: string;
+    /** 字重 */
+    fontWeight?: "normal" | "bold";
+    /** 对齐方式 */
+    textAlign?: "left" | "center" | "right";
+}
+/** 白板元素联合类型 */
+export type WhiteboardElement = PenElement | ShapeElement | LineElement | ArrowElement | TextElement;
+/** 画布配置 */
+export interface WbCanvasConfig {
+    /** 缩放 */
+    zoom: number;
+    /** 平移 X */
+    panX: number;
+    /** 平移 Y */
+    panY: number;
+    /** 是否显示网格 */
+    showGrid: boolean;
+    /** 网格大小 */
+    gridSize: number;
+    /** 背景色 */
+    backgroundColor: string;
+}
+/** 包围盒 */
+export interface WbBoundingBox {
+    x: number;
+    y: number;
+    width: number;
+    height: number;
+}
+/** 工具预设 */
+export interface WbToolPreset {
+    tool: WhiteboardTool;
+    /** 图标 CSS class（sh-xxx） */
+    icon: string;
+    /** i18n key */
+    labelKey: string;
+}
+/** 形状预设 */
+export interface WbShapePreset {
+    shape: WhiteboardShapeType;
+    /** i18n key */
+    labelKey: string;
+    /** 默认宽 */
+    width: number;
+    /** 默认高 */
+    height: number;
+}
+/** 颜色预设 */
+export interface WbColorPreset {
+    label: string;
+    value: string;
+}
+/** 线宽预设 */
+export interface WbLineWidthPreset {
+    label: string;
+    value: number;
+}
+/** 导出格式 */
+export type WbExportFormat = "png" | "svg" | "json";
+/** 白板状态 */
+export interface WhiteboardState {
+    /** 元素列表（按 z-order 升序，越后越在上层） */
+    elements: WhiteboardElement[];
+    /** 选中元素 ID 列表 */
+    selectedIds: string[];
+    /** 当前工具 */
+    tool: WhiteboardTool;
+    /** 当前描边色 */
+    stroke: string;
+    /** 当前填充色 */
+    fill: string;
+    /** 当前线宽 */
+    strokeWidth: number;
+    /** 当前透明度 */
+    opacity: number;
+    /** 当前字号 */
+    fontSize: number;
+    /** 画布配置 */
+    canvas: WbCanvasConfig;
+    /** 是否只读 */
+    readonly: boolean;
+}