@realsee/dnalogel 2.0.0-alpha.49 → 2.0.0-alpha.51

package/dist/GuideLinePlugin/PanoMeasurePlugin/index.d.ts

@@ -0,0 +1,10 @@
+import type { FivePlugin } from '@realsee/five';
+import MeasureController, { PanoMeasureParameterType } from './Controller';
+import Magnifier from './Modules/Magnifier';
+export declare const PanoMeasurePlugin: FivePlugin<PanoMeasureParameterType, PanoMeasureReturnType>;
+export default PanoMeasurePlugin;
+export declare type PanoMeasureReturnType = MeasureController;
+export type { PanoMeasurePluginEvent } from './typings/event.type';
+export type { LineJson, PointJson, OpenParameter } from './typings/data';
+export type { PanoMeasureParameterType } from './Controller';
+export { Magnifier };

package/dist/GuideLinePlugin/PanoMeasurePlugin/typings/data.d.ts

@@ -0,0 +1,37 @@
+export interface LineCompletelyJson {
+    id: string;
+    points: PointJson[];
+}
+export interface PolylineCompletelyJson {
+    id: string;
+    points: PointJson[];
+    lines: LineCompletelyJson[];
+}
+export interface LineJson {
+    id: string;
+    points: string[];
+}
+export interface PolylineJson {
+    id: string;
+    points: string[];
+    lines: string[];
+}
+export interface PointJson {
+    id: string;
+    lines: string[];
+    position: number[];
+}
+export interface PluginData {
+    lines: LineJson[];
+    points: PointJson[];
+    polylines: PolylineJson[];
+}
+/** 开放可配置参数 */
+export interface OpenParameter {
+    isMobile?: boolean;
+    crossHairParameter?: CrossHairParameter;
+}
+export interface CrossHairParameter {
+    useNormalVector?: boolean;
+    ballColor?: number;
+}

package/dist/GuideLinePlugin/PanoMeasurePlugin/typings/event.type.d.ts

@@ -0,0 +1,37 @@
+import type { SubscribeEventMap } from '@realsee/five';
+import type { Vector3 } from 'three';
+import type { Mode } from '../Controller';
+import type { State } from '../Controller/MixedController';
+import type Point from '../Model/point';
+import type { LineCompletelyJson } from './data';
+interface ControllerEvent extends SubscribeEventMap {
+    /**
+     * Mode 变更
+     */
+    modeChange: (mode: Mode) => void;
+}
+interface WatchEvent extends SubscribeEventMap {
+    selectedChange: (lines: LineCompletelyJson[]) => void;
+}
+interface EditEvent {
+    /**
+     * 编辑线条变更
+     */
+    editedLineChange: (lines: LineCompletelyJson[]) => void;
+    anchorChange: (anchor: Vector3 | null) => void;
+}
+interface DragEvent extends SubscribeEventMap {
+    wantsDragLine: (event: {
+        point: string;
+        lines: string[];
+    }) => boolean;
+}
+/** 移动端专用事件 */
+interface MobileEvent extends SubscribeEventMap {
+    getStartPoint: (point: Point) => void;
+    getEndPoint: (point: Point) => void;
+    willChangeState: (state: State, newState: State) => void;
+    nowPointChange: (point: Point) => void;
+}
+export declare type PanoMeasurePluginEvent = ControllerEvent & EditEvent & WatchEvent & DragEvent & MobileEvent;
+export {};

package/dist/GuideLinePlugin/PanoMeasurePlugin/typings/utils.type.d.ts

@@ -0,0 +1 @@
+export declare type ValueOf<T> = T[keyof T];

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/calculateThreeMouse.d.ts

@@ -0,0 +1,10 @@
+import * as THREE from 'three';
+/**
+ * 计算 three 中的 mouse 的值
+ * @param  {{x:Number, y:Number}} mouseXY 鼠标相对屏幕位置
+ * @param  {Element}              element canvas元素（three的展示元素）
+ */
+export default function calculateThreeMouse(mouseXY: any, element: any): THREE.Vector2 & {
+    x: number;
+    y: number;
+};

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/clearGroup.d.ts

@@ -0,0 +1,2 @@
+import type { Group } from 'three';
+export default function clearGroup(group: Group): void;

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/constants.d.ts

@@ -0,0 +1,4 @@
+import type { ICreateLineOpts } from './line';
+export declare const normalLineOpts: ICreateLineOpts;
+export declare const dashLineOpts: ICreateLineOpts;
+export declare const lightLineOpts: ICreateLineOpts;

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/distanceDom.d.ts

@@ -0,0 +1,28 @@
+import type Line from '../Model/line';
+import type { Five } from '@realsee/five';
+import type { LineCompletelyJson, PolylineCompletelyJson } from '../typings/data';
+import { Vector3 } from 'three';
+export declare type DistanceItem = ReturnType<typeof createDistanceItem>;
+export interface UserDistanceItem {
+    element: Element;
+    highlight: () => void;
+    unHighlight: () => void;
+    update: (params: {
+        line: LineCompletelyJson;
+        polyline: PolylineCompletelyJson;
+    }) => void;
+}
+export interface IDistanceItemProps {
+    line: Line;
+    userDistanceItem?: UserDistanceItem;
+    clickCallback?: (item: DistanceItem) => unknown;
+}
+export declare function createDistanceItem(props: IDistanceItemProps): {
+    lineID: string;
+    ndcPosition: Vector3;
+    update: (five: Five) => void;
+    appendTo: (container: Element) => void;
+    remove: () => void;
+    highlight: () => void;
+    unHighlight: () => void;
+};

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/findAssociatedLines.d.ts

@@ -0,0 +1,2 @@
+import type Line from '../Model/line';
+export declare function findAssociatedLines(line: Line): Line[];

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/findClosestPoint.d.ts

@@ -0,0 +1,10 @@
+import type { Vector2 } from 'three';
+import type Point from '../Model/point';
+import type { Five } from '@realsee/five';
+/**
+ * @param tapPoint 注意这里的坐标是相对于 FiveElement 的
+ */
+export declare function findClosestPoint(five: Five, points: Point[], tapPoint: Vector2, maxDistance?: number): {
+    distance: number;
+    point: Point;
+};

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/getIntersectionFromEvent.d.ts

@@ -0,0 +1,4 @@
+import type Hammer from 'hammerjs';
+import type { Five, Intersection } from '@realsee/five';
+/** 通过鼠标事件或者触摸事件，获取当前点击屏幕关联的射线与模型的交点 */
+export declare function getIntersectionFromEvent(five: Five, event: typeof Hammer['Input']): Intersection[];

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/getPointFromHammerEvent.d.ts

@@ -0,0 +1,10 @@
+import type Hammer from 'hammerjs';
+import { Vector2 } from 'three';
+/**
+ * 从 Hammer 事件中获取操作的点在交互 DOM 中的位置
+ * @ignore TODO: make a suitable name
+ */
+export declare function getPointFromHammerEvent(event: typeof Hammer['Input']): {
+    point: Vector2;
+    ndcPoint: Vector2;
+};

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/ironbox.d.ts

@@ -0,0 +1 @@
+export declare const preventDefault: (e: Event) => void;

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/isNDCPointInScreen.d.ts

@@ -0,0 +1,2 @@
+import type { Vector3 } from 'three';
+export default function isNDCPointInScreen(ndcPoint: Vector3): boolean;

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/line.d.ts

@@ -0,0 +1,17 @@
+import type Line from '../Model/line';
+import { Line as FiveLine } from '@realsee/five/line';
+import { Color, Texture, Vector3 } from 'three';
+declare type ISetMaterialOpts = Parameters<FiveLine['setMaterial']>[0];
+export interface ICreateLineOpts extends ISetMaterialOpts {
+    hasPoint?: boolean;
+    pointSize?: number;
+    lineWidth?: number;
+    pointTexture?: Texture;
+    lineRenderOrder?: number;
+    pointsRenderOrder?: number;
+    lineColor?: Color | string | number;
+    pointColor?: Color | string | number;
+}
+export declare function createLine(start: Vector3, end: Vector3, opts?: ICreateLineOpts): FiveLine;
+export declare function createLineMesh(line: Line, type: 'normal' | 'light'): FiveLine;
+export {};

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/math.d.ts

@@ -0,0 +1,17 @@
+import { Vector2 } from 'three';
+/**
+ * 获取一点对于线段上最近的一点，
+ * 如果可以是过直线垂线的垂足，不行的话取线段的两端
+ * @param point
+ * @param linePoints
+ * @return
+ */
+export declare function closestPointOnLine(point: Vector2, linePoints: Vector2[]): Vector2;
+/**
+ * 检查两个点是否位置相同
+ * point: { x: number, y: number }
+ * @param  point1
+ * @param  point2
+ * @return
+ */
+export declare function samePointAt(point1: Vector2, point2: Vector2): boolean;

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/mouseGroup.d.ts

@@ -0,0 +1,7 @@
+import { Group } from 'three';
+export interface MouseGroupParameter {
+    isMobile?: boolean;
+    useNormalVector?: boolean;
+    ballColor?: number;
+}
+export declare function getMouseGroup(params: MouseGroupParameter): Group;

package/dist/GuideLinePlugin/PanoMeasurePlugin/utils/ndc2Screen.d.ts

@@ -0,0 +1,5 @@
+import { Vector2, Vector3 } from 'three';
+export default function ndc2Screen(ndcPosition: Vector3, containerSize: {
+    width: number;
+    height: number;
+}): Vector2;

package/dist/GuideLinePlugin/PanoRulerPlugin/Plugin.d.ts

@@ -0,0 +1,31 @@
+import type { FivePlugin } from '@realsee/five';
+import type { RoomInfo, RoomRules } from './typings';
+export interface PanoRulerPluginOptions {
+    distanceText?: (distance: number) => string;
+    className?: string;
+}
+interface PanoRulerPluginPluginState {
+    enable: boolean;
+    loaded: boolean;
+    options: PanoRulerPluginOptions;
+}
+export interface PanoRulerPluginParameterType {
+    roomInfo?: RoomInfo;
+    roomRules?: RoomRules;
+    options?: PanoRulerPluginOptions;
+}
+export interface PanoRulerPluginExportType {
+    enable: () => void;
+    disable: () => void;
+    load: (roomInfo?: RoomInfo, roomRules?: RoomRules, options?: PanoRulerPluginOptions) => Promise<boolean>;
+    state: PanoRulerPluginPluginState;
+}
+/**
+ * 全景标尺插件
+ */
+export declare const PanoRulerPlugin: FivePlugin<PanoRulerPluginParameterType, PanoRulerPluginExportType>;
+export declare const panoRulerPluginServerParams: {
+    name: string;
+    version: number;
+};
+export default PanoRulerPlugin;

package/dist/GuideLinePlugin/PanoRulerPlugin/index.d.ts

@@ -0,0 +1,5 @@
+import PanoRulerPlugin from './Plugin';
+export { PanoRulerPlugin };
+export default PanoRulerPlugin;
+export type { Room, Rooms, RoomInfo, RoomRules } from './typings';
+export type { PanoRulerPluginOptions, PanoRulerPluginParameterType, PanoRulerPluginExportType } from './Plugin';

package/dist/GuideLinePlugin/PanoRulerPlugin/style.d.ts

@@ -0,0 +1,2 @@
+declare const PanoRulerStyle = "<style type=\"text/css\">\n.PanoRulerPlugin-rule-line {\n  position: absolute;\n  transform-origin: left center;\n  width: 0;\n  height: 0.0625rem;\n}\n\n.PanoRulerPlugin-rule-line::after {\n  content: '';\n  position: absolute;\n  left: -0.125rem;\n  top: -0.1rem;\n  width: 0.25rem;\n  height: 0.25rem;\n  border-radius: 50%;\n  background: #FFFFFF;\n  z-index: 1;\n  animation: viewport-rule-point 0.1s 1s;\n  animation-fill-mode: both;\n}\n\n.PanoRulerPlugin-rule-line::before {\n  content: '';\n  position: absolute;\n  right: -0.125rem;\n  top: -0.1rem;\n  width: 0.25rem;\n  height: 0.25rem;\n  border-radius: 50%;\n  background: #FFFFFF;\n  animation: viewport-rule-point 0.1s 1.5s;\n  animation-fill-mode: both;\n}\n\n.PanoRulerPlugin-rule-line em {\n  background: #fff;\n  display: block;\n  height: 100%;\n  animation: viewport-rule-line 0.5s ease 1s;\n  animation-fill-mode: both;\n  box-shadow: 0 0 0.25rem rgb(0 0 0 / 40%);\n}\n\n.PanoRulerPlugin-rule-label {\n  position: absolute;\n  width: 0;\n  height: 0;\n  top: 0.0625rem;\n}\n\n.PanoRulerPlugin-rule-label-name {\n  position: absolute;\n  padding: 0.1875rem 0.375rem;\n  background: rgba(195,195,195,0.30);\n  backdrop-filter: blur(0.25rem);\n  -webkit-backdrop-filter: blur(0.25rem);\n  border-radius: 6.25rem;\n  border: 0.0625rem solid rgba(255,255,255,0.6);\n  white-space: nowrap;\n  overflow: hidden;\n  color: #FFFFFF;\n  font-weight: 500;\n  font-size: 0.75rem;\n  line-height: 1;\n  -webkit-animation: viewport-rule-label 0.25s ease 1s;\n  animation: viewport-rule-label 0.25s ease 1s;\n  animation-fill-mode: both;\n  box-shadow: inset 0 0 0.625rem 0 rgba(255,255,255,0.30);\n}\n\n@keyframes viewport-rule-line {\n  0% { width: 0% }\n  100% { width: 100% }\n}\n\n@keyframes viewport-rule-label {\n  0% { opacity: 0; transform: scaleX(0); }\n  100% { opacity: 1; transform: translate(-50%, -50%) scaleX(1); }\n}\n\n@keyframes viewport-rule-point {\n  0% { transform: scaleX(0); }\n  100% { transform: scaleX(1); }\n}\n</style>\n";
+export default PanoRulerStyle;

package/dist/GuideLinePlugin/PanoRulerPlugin/typings.d.ts

@@ -0,0 +1,21 @@
+export interface Room {
+    id: string;
+    name: string;
+    localName: string;
+    area: number;
+}
+export interface Rooms {
+    [key: string]: Room;
+}
+export declare type RoomObservers = string[];
+export interface RoomInfo {
+    rooms: Rooms;
+    observers: RoomObservers;
+}
+export interface RoomRules {
+    [key: string]: {
+        x: number;
+        z: number;
+        observers: number[];
+    }[];
+}

package/dist/GuideLinePlugin/PanoRulerProPlugin/Controller.d.ts

@@ -0,0 +1,15 @@
+import type { Five } from '@realsee/five';
+import type { PanoRulerProPluginDatas, PanoRulerProPluginParameterType, PanoRulerProPluginState } from './typings';
+export default class Controller {
+    private five;
+    private container;
+    private panoRulerProData;
+    private rulerItems;
+    state: PanoRulerProPluginState;
+    constructor(five: Five, params: PanoRulerProPluginParameterType);
+    load(serverData: PanoRulerProPluginDatas): Promise<void>;
+    enable(): boolean;
+    disable(): boolean;
+    private render;
+    private dispose;
+}

package/dist/GuideLinePlugin/PanoRulerProPlugin/index.d.ts

@@ -0,0 +1,8 @@
+import type { FivePlugin } from '@realsee/five';
+import type { PanoRulerProPluginParameterType, PanoRulerProPluginExportType } from './typings';
+/**
+ * 全景标尺插件
+ */
+export declare const PanoRulerProPlugin: FivePlugin<PanoRulerProPluginParameterType, PanoRulerProPluginExportType>;
+export default PanoRulerProPlugin;
+export type { PanoRulerProPluginParameterType, PanoRulerProPluginExportType, PanoRulerProPluginOptions, PanoRulerProPluginState, } from './typings';

package/dist/GuideLinePlugin/PanoRulerProPlugin/typings.d.ts

@@ -0,0 +1,46 @@
+export declare type PanoRulerProPluginDatas = {
+    data: PanoRulerProPluginData[];
+    version: number;
+};
+export interface PanoRulerProPluginData {
+    panoIndex: number;
+    roomName: string;
+    lines: Line[];
+}
+interface Line {
+    start: number[];
+    end: number[];
+    state: boolean;
+    children?: Line[];
+}
+export interface PanoRulerProPluginOptions {
+    distanceText?: (distance: number) => string;
+    className?: string;
+}
+export interface PanoRulerProPluginState {
+    enabled: boolean;
+    loaded: boolean;
+    options: PanoRulerProPluginOptions;
+}
+export interface PanoRulerProPluginParameterType {
+    data?: PanoRulerProPluginDatas;
+    options?: PanoRulerProPluginOptions;
+}
+export interface PanoRulerProPluginExportType {
+    enable: () => void;
+    disable: () => void;
+    load: (serverData: PanoRulerProPluginDatas) => void;
+    state: PanoRulerProPluginState;
+}
+export interface RulerItemProp {
+    width: number;
+    left: number;
+    top: number;
+    rotateDeg: number;
+    state: boolean;
+    children: any[];
+    labelOffset: number;
+    labelElement: string;
+    visible: boolean;
+}
+export {};

package/dist/GuideLinePlugin/PanoSpatialTagPlugin/Plugin.d.ts

@@ -0,0 +1,35 @@
+import type { FivePlugin } from '@realsee/five';
+import type { PanoSpatialTagPluginId, PanoSpatialTagPluginDataElement, PanoSpatialTagPluginContentReplacement, PanoSpatialTagPluginContentEvent } from './typings';
+export interface PanoSpatialTagPluginData {
+    folded?: boolean;
+    enabled?: boolean;
+    points: Array<PanoSpatialTagPluginDataElement>;
+    template: string;
+    events?: PanoSpatialTagPluginContentEvent;
+    render?: (template: string, replacement: PanoSpatialTagPluginContentReplacement) => string;
+}
+export interface PanoSpatialTagPluginParameterType {
+    container?: Element;
+    wait?: number;
+    maxNumberOnScreen?: number;
+    minRad?: number;
+    nearTolerance?: number;
+    upsideHeight?: number;
+    minDistance?: number;
+    maxDistance?: number;
+}
+export interface PanoSpatialTagPluginExportType {
+    load: (data: PanoSpatialTagPluginData) => void;
+    unfoldAll: () => void;
+    foldAll: () => void;
+    unfold: (id: PanoSpatialTagPluginId) => void;
+    fold: (id: PanoSpatialTagPluginId) => void;
+    enable: () => void;
+    disable: () => void;
+    dispose: () => void;
+}
+/**
+ * 空间游走标签插件
+ */
+export declare const PanoSpatialTagPlugin: FivePlugin<PanoSpatialTagPluginParameterType, PanoSpatialTagPluginExportType>;
+export default PanoSpatialTagPlugin;

package/dist/GuideLinePlugin/PanoSpatialTagPlugin/index.d.ts

@@ -0,0 +1,5 @@
+import PanoSpatialTagPlugin from './Plugin';
+export { PanoSpatialTagPlugin };
+export default PanoSpatialTagPlugin;
+export * from './typings';
+export type { PanoSpatialTagPluginExportType, PanoSpatialTagPluginParameterType, PanoSpatialTagPluginData } from './Plugin';

package/dist/GuideLinePlugin/PanoSpatialTagPlugin/store.d.ts

@@ -0,0 +1 @@
+export declare const currentTarget: import("svelte/store").Writable<any>;

package/dist/GuideLinePlugin/PanoSpatialTagPlugin/style.d.ts

@@ -0,0 +1 @@
+export declare const pluginStyle: Partial<CSSStyleDeclaration>;

package/dist/GuideLinePlugin/PanoSpatialTagPlugin/typings.d.ts

@@ -0,0 +1,40 @@
+import type * as THREE from 'three';
+export declare type PanoSpatialTagPluginId = string | number;
+export interface PanoSpatialTagPluginContentReplacement {
+    [key: string]: string;
+}
+interface PanoSpatialTagPluginAppData {
+    replacement: PanoSpatialTagPluginContentReplacement;
+    weight?: number;
+}
+export interface PanoSpatialTagPluginDataElement extends PanoSpatialTagPluginAppData {
+    id: PanoSpatialTagPluginId;
+    position: number[];
+    normal: number[];
+}
+export interface PanoSpatialTagPluginTagElement {
+    id: PanoSpatialTagPluginId;
+    position: THREE.Vector3;
+    normal: THREE.Vector3;
+    app: any;
+    destroying?: boolean;
+}
+export interface PanoSpatialTagPluginOriginElement {
+    id: PanoSpatialTagPluginId;
+    front: boolean;
+    left: number;
+    top: number;
+    destroying?: boolean;
+}
+export interface PanoSpatialTagPluginContentEvent {
+    [className: string]: (id: PanoSpatialTagPluginId) => any;
+}
+export interface PanoSpatialTagPluginPointElement {
+    id: PanoSpatialTagPluginId;
+    position: THREE.Vector3;
+    normal: THREE.Vector3;
+    replacement: PanoSpatialTagPluginContentReplacement;
+    weight: number;
+    distance?: number;
+}
+export {};

package/dist/GuideLinePlugin/base/BasePlugin.d.ts

@@ -0,0 +1,100 @@
+import { Five, Subscribe } from '@realsee/five';
+/**
+ * 基本属性字段
+ */
+interface State {
+    /**
+     * 插件是否启用
+     */
+    enabled: boolean;
+    /**
+     * 插件UI是否展示
+     */
+    visible?: boolean;
+    /**
+     * 插件的配置项
+     */
+    config?: unknown;
+}
+interface BaseOptions {
+    /** 是否是用户行为 */
+    userAction?: boolean;
+}
+/**
+ * 插件基本事件
+ */
+declare type EventMap<PluginState> = {
+    /**
+     * 插件被销毁
+     */
+    dispose: () => void;
+    /**
+     * 插件状态变化
+     * @param params.state      最新的State
+     * @param params.prevState  上一个State
+     * @param params.userAction 是否是用户触发
+     */
+    stateChange: (params: {
+        state: PluginState;
+        prevState?: PluginState;
+        userAction: boolean;
+    }) => void;
+};
+/**
+ * plugin 的基本控制器
+ */
+declare abstract class Controller<PluginState extends State, PluginEventMap extends EventMap<PluginState>> {
+    five: Five;
+    /**
+     * 插件事件钩子
+     */
+    hooks: Subscribe<PluginEventMap>;
+    /**
+     * 当前状态
+     * @description
+     * ```text
+     * 可以通过 plugin.state 和 plugin.setState 来获取和设置。
+     * 通过 state 设置后，plugin 会通过合适的动画运动来达到设置的效果。
+     * 来迎合一些通过数据驱动的场景。
+     * ```
+     */
+    abstract state: PluginState;
+    constructor(five: Five);
+    /**
+     * 获取当前的插件状态，如果当初插件内存在需要通过动画变更的 state 值，则通过此方法可以得到中间状态
+     */
+    getCurrentState(): PluginState;
+    /**
+     * 插件自身DOM添加到父容器
+     * @param wrapper
+     */
+    appendTo?(wrapper: Element): void;
+    /**
+     * 展示UI
+     */
+    show?(options?: BaseOptions): Promise<void>;
+    /**
+     * 隐藏UI
+     */
+    hide?(options?: BaseOptions): Promise<void>;
+    /**
+     * 启用插件，让插件能够响应交互
+     */
+    abstract enable(options?: BaseOptions): void;
+    /**
+     * 禁用插件，让插件停止响应交互
+     */
+    abstract disable(options?: BaseOptions): void;
+    /**
+     * 插件进行销毁
+     */
+    abstract dispose(): void;
+    /**
+     * 设置state
+     * @param state 插件的目标状态
+     * @param options 配置项
+     */
+    abstract setState(state: Partial<PluginState>, options?: BaseOptions): void;
+}
+export type { State, EventMap, BaseOptions };
+export { Controller };

package/dist/GuideLinePlugin/base/BasePluginWithData.d.ts

@@ -0,0 +1,34 @@
+import * as BasePlugin from './BasePlugin';
+declare type State = BasePlugin.State;
+interface EventMap<PluginState, PluginData> extends BasePlugin.EventMap<PluginState> {
+    /** 数据变更 */
+    dataChange: (data: PluginData, prevData?: PluginData) => void;
+    /** 数据加载完成 */
+    dataLoaded: (data: PluginData) => void;
+}
+/**
+ * 插件的基础数据
+ */
+interface ServerData {
+    /**
+     * 数据版本
+     */
+    version: number;
+    /**
+     * 数据
+     */
+    data?: unknown;
+}
+declare abstract class Controller<PluginState extends State, PluginEventMap extends EventMap<PluginState, PluginData>, PluginServerData extends ServerData, PluginData> extends BasePlugin.Controller<PluginState, PluginEventMap> {
+    protected abstract data?: PluginData;
+    /**
+     * 加载插件依赖数据
+     * @param serverData 插件数据
+     * @param state 插件 State
+     */
+    abstract load(serverData: PluginServerData, state?: PluginState, userAction?: boolean): Promise<void>;
+    /** 把原始数据转化为插件数据 */
+    protected abstract formatData?(serverData: PluginServerData): Promise<PluginData>;
+}
+export type { State, EventMap, ServerData };
+export { Controller };

package/dist/GuideLinePlugin/components/PaintBrush/Controller.d.ts

@@ -0,0 +1,43 @@
+import { noop } from './utils';
+import { PaintBrushAction, PaintBrushConfigs, PaintBrushEventMap, PaintBrushState } from './typings';
+import { Subscribe } from './Subscribe';
+export declare class Controller extends Subscribe<PaintBrushEventMap> {
+    configs: PaintBrushConfigs;
+    private clientWidth;
+    private clientHeight;
+    private ready;
+    private uuid;
+    private tween?;
+    private tweening;
+    private container;
+    private canvas;
+    private data;
+    private tempLine;
+    get color(): string;
+    get state(): Record<string, PaintBrushState[]>;
+    get dpr(): number;
+    constructor(configs: PaintBrushConfigs);
+    ifInsertToDOM(): HTMLDivElement;
+    /**
+     *
+     * @param className 初始化画板
+     * @returns
+     */
+    initCanvas(className: string): HTMLCanvasElement;
+    /**
+     * 初始化操作面板
+     * @returns
+     */
+    initCtrl(): HTMLDivElement;
+    openBrush(): void;
+    closeBrush(): void;
+    updateCurrentColor(color: string): void;
+    openBrushHandle(): void;
+    emitStateChange(action: PaintBrushAction, userAction?: boolean): void;
+    action(action: PaintBrushAction): void;
+    handleDrawLine(_uuid: string, data: PaintBrushState, { withUndo }: {
+        withUndo?: boolean;
+    }, callback?: typeof noop): void;
+    handleUndo(uuid: string): void;
+    destroyBrush(): void;
+}