@plait/core 0.48.0 → 0.50.0

package/interfaces/board.d.ts

@@ -14,6 +14,7 @@ import { PathRef, PathRefOptions } from './path-ref';
 import { PlaitNode } from './node';
 import { Path } from './path';
 import { PlaitTheme, ThemeColor } from './theme';
+import { ClipboardData, WritableClipboardContext } from '../utils';
 export interface PlaitBoard {
     viewport: Viewport;
     children: PlaitElement[];
@@ -37,8 +38,8 @@ export interface PlaitBoard {
     keydown: (event: KeyboardEvent) => void;
     globalKeydown: (event: KeyboardEvent) => void;
     keyup: (event: KeyboardEvent) => void;
-    setFragment: (data: DataTransfer | null, rectangle: RectangleClient | null, type: 'copy' | 'cut') => void;
-    insertFragment: (data: DataTransfer | null, targetPoint: Point) => void;
+    setFragment: (data: DataTransfer | null, clipboardContext: WritableClipboardContext | null, rectangle: RectangleClient | null, type: 'copy' | 'cut') => void;
+    insertFragment: (data: DataTransfer | null, clipboardData: ClipboardData | null, targetPoint: Point) => void;
     deleteFragment: (data: DataTransfer | null) => void;
     getDeletedFragment: (data: PlaitElement[]) => PlaitElement[];
     getRelatedFragment: (data: PlaitElement[]) => PlaitElement[];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plait/core",
-  "version": "0.48.0",
+  "version": "0.50.0",
   "peerDependencies": {
     "@angular/common": "^16.0.0",
     "@angular/core": "^16.0.0",

package/utils/board.d.ts

@@ -1,5 +1,4 @@
 import { PlaitBoard } from '../interfaces/board';
-import { Point } from '../interfaces/point';
 export type ViewBox = {
     minX: number;
     minY: number;
@@ -8,7 +7,5 @@ export type ViewBox = {
     viewportWidth: number;
     viewportHeight: number;
 };
-export declare function transformPoints(board: PlaitBoard, points: Point[]): Point[];
-export declare function transformPoint(board: PlaitBoard, point: Point): Point;
 export declare function isInPlaitBoard(board: PlaitBoard, x: number, y: number): boolean;
 export declare function getRealScrollBarWidth(board: PlaitBoard): number;

package/utils/clipboard/clipboard.d.ts

@@ -0,0 +1,3 @@
+import { ClipboardData, WritableClipboardContext } from './types';
+export declare const getClipboardData: (dataTransfer: DataTransfer | null) => Promise<ClipboardData>;
+export declare const setClipboardData: (dataTransfer: DataTransfer | null, clipboardContext: WritableClipboardContext | null) => Promise<void>;

package/utils/clipboard/common.d.ts

@@ -0,0 +1,8 @@
+import { ClipboardData, WritableClipboardContext, WritableClipboardData, WritableClipboardType } from './types';
+export declare const buildPlaitHtml: (type: WritableClipboardType, data: WritableClipboardData) => string;
+export declare const getClipboardFromHtml: (html: string) => ClipboardData | null;
+export declare const stripHtml: (html: string) => string;
+export declare const getProbablySupportsClipboardWrite: () => boolean;
+export declare const getProbablySupportsClipboardRead: () => boolean;
+export declare const createClipboardContext: (type: WritableClipboardType, data: WritableClipboardData, text: string) => WritableClipboardContext;
+export declare const addClipboardContext: (clipboardContext: WritableClipboardContext, addition: WritableClipboardContext) => WritableClipboardContext;

package/utils/clipboard/data-transfer.d.ts

@@ -0,0 +1,5 @@
+import { ClipboardData, WritableClipboardData, WritableClipboardType } from './types';
+export declare const setDataTransferClipboard: (dataTransfer: DataTransfer | null, type: WritableClipboardType, data: WritableClipboardData) => void;
+export declare const setDataTransferClipboardText: (data: DataTransfer | null, text: string) => void;
+export declare const getDataTransferClipboard: (data: DataTransfer | null) => ClipboardData;
+export declare const getDataTransferClipboardText: (data: DataTransfer | null) => string;

package/utils/clipboard/index.d.ts

@@ -0,0 +1,2 @@
+export * from './data-transfer';
+export * from './types';

package/utils/clipboard/navigator-clipboard.d.ts

@@ -0,0 +1,3 @@
+import { ClipboardData, WritableClipboardData, WritableClipboardType } from './types';
+export declare const setNavigatorClipboard: (type: WritableClipboardType, data: WritableClipboardData, text?: string) => Promise<void>;
+export declare const getNavigatorClipboard: () => Promise<ClipboardData>;

package/utils/clipboard/types.d.ts

@@ -0,0 +1,17 @@
+import { PlaitElement } from '../../interfaces';
+export declare enum WritableClipboardType {
+    'medias' = "medias",
+    'elements' = "elements"
+}
+export type WritableClipboardData = PlaitElement[] | any[];
+export interface WritableClipboardContext {
+    text: string;
+    type: WritableClipboardType;
+    data: WritableClipboardData;
+}
+export interface ClipboardData {
+    files?: File[];
+    elements?: PlaitElement[];
+    medias?: any[];
+    text?: string;
+}

package/utils/dom/common.d.ts

@@ -1,21 +1,6 @@
 import { Options } from 'roughjs/bin/core';
-import { PlaitBoard, RectangleClient } from '../../interfaces';
-import { Point } from '../../interfaces/point';
+import { RectangleClient } from '../../interfaces';
 export declare const NS = "http://www.w3.org/2000/svg";
-/**
- * Get the screen coordinates starting from the upper left corner of the svg element (based on the svg screen coordinate system)
- * @param x screen x
- * @param y screen x
- * @returns
- */
-export declare function toPoint(x: number, y: number, svg: SVGElement): Point;
-/**
- * `toPoint` reverse processing
- * Get the screen coordinate starting from the upper left corner of the browser window (based on the screen coordinate system)
- * @param point screen coordinates based on the upper left corner of the svg
- * @returns
- */
-export declare function toScreenPoint(board: PlaitBoard, point: Point): Point;
 export declare function createG(): SVGGElement;
 export declare function createPath(): SVGPathElement;
 export declare function createRect(rectangle: RectangleClient, options?: Options): SVGRectElement;

package/utils/index.d.ts

@@ -18,6 +18,10 @@ export * from './viewport';
 export * from './common';
 export * from './moving-element';
 export * from './to-image';
+export * from './clipboard/types';
+export * from './clipboard/clipboard';
+export * from './clipboard/common';
 export * from './clipboard';
 export * from './touch';
 export * from './dnd';
+export * from './to-point';

package/utils/to-point.d.ts

@@ -0,0 +1,21 @@
+import { PlaitBoard } from '../interfaces/board';
+import { Point } from '../interfaces/point';
+export declare const getViewBox: (board: PlaitBoard) => DOMRect;
+/**
+ * Get the screen point starting from the upper left corner of the svg element (based on the svg screen coordinate system)
+ */
+export declare function toHostPoint(board: PlaitBoard, x: number, y: number): Point;
+/**
+ * Get the point in the coordinate system of the svg viewBox
+ */
+export declare function toViewBoxPoint(board: PlaitBoard, hostPoint: Point): Point;
+export declare function toViewBoxPoints(board: PlaitBoard, hostPoints: Point[]): Point[];
+/**
+ * `toHostPoint` reverse processing
+ * Get the screen point starting from the upper left corner of the browser window or the viewport (based on the screen coordinate system)
+ */
+export declare function toScreenPointFromHostPoint(board: PlaitBoard, hostPoint: Point): Point;
+/**
+ * `toViewBoxPoint` reverse processing
+ */
+export declare function toHostPointFromViewBoxPoint(board: PlaitBoard, viewBoxPoint: Point): Point;

package/utils/viewport.d.ts

@@ -1,5 +1,4 @@
 import { PlaitBoard, Point, RectangleClient } from '../interfaces';
-export declare function toSVGScreenPoint(board: PlaitBoard, point: Point): Point;
 export declare function getViewportContainerRect(board: PlaitBoard): {
     width: number;
     height: number;
@@ -11,14 +10,10 @@ export declare function getElementHostBBox(board: PlaitBoard, zoom: number): {
     bottom: number;
 };
 /**
- * 验证缩放比是否符合限制，如果超出限制，则返回合适的缩放比
- * @param zoom 缩放比
- * @param minZoom 最小缩放比
- * @param maxZoom 最大缩放比
- * @returns 正确的缩放比
+ * Normalize the scaling ratio, or return the corrected scaling ratio if the limit is exceeded
  */
 export declare function clampZoomLevel(zoom: number, minZoom?: number, maxZoom?: number): number;
-export declare function getViewBox(board: PlaitBoard, zoom: number): number[];
+export declare function calcNewViewBox(board: PlaitBoard, zoom: number): number[];
 export declare function getViewBoxCenterPoint(board: PlaitBoard): Point;
 export declare function setSVGViewBox(board: PlaitBoard, viewBox: number[]): void;
 export declare function updateViewportOffset(board: PlaitBoard): void;

package/esm2022/utils/clipboard.mjs

@@ -1,45 +0,0 @@
-import { CLIP_BOARD_FORMAT_KEY } from '../constants';
-export const getClipboardByKey = (key) => {
-    return `application/x-plait-${key}-fragment`;
-};
-export const setClipboardData = (data, elements) => {
-    const result = [...elements];
-    const pluginContextResult = getDataFromClipboard(data);
-    if (pluginContextResult) {
-        result.push(...pluginContextResult);
-    }
-    const stringObj = JSON.stringify(result);
-    const encoded = window.btoa(encodeURIComponent(stringObj));
-    data?.setData(`application/${CLIP_BOARD_FORMAT_KEY}`, encoded);
-};
-export const setClipboardDataByText = (data, text) => {
-    const pluginContextResult = getTextFromClipboard(data);
-    data?.setData(`text/plain`, text + '\n' + pluginContextResult);
-};
-export const setClipboardDataByMedia = (data, media, key) => {
-    const stringObj = JSON.stringify(media);
-    const encoded = window.btoa(encodeURIComponent(stringObj));
-    data?.setData(getClipboardByKey(key), encoded);
-};
-export const getDataFromClipboard = (data) => {
-    const encoded = data?.getData(`application/${CLIP_BOARD_FORMAT_KEY}`);
-    let nodesData = [];
-    if (encoded) {
-        const decoded = decodeURIComponent(window.atob(encoded));
-        nodesData = JSON.parse(decoded);
-    }
-    return nodesData;
-};
-export const getTextFromClipboard = (data) => {
-    return (data ? data.getData(`text/plain`) : '');
-};
-export const getClipboardDataByMedia = (data, key) => {
-    const encoded = data?.getData(getClipboardByKey(key));
-    let imageItem = null;
-    if (encoded) {
-        const decoded = decodeURIComponent(window.atob(encoded));
-        imageItem = JSON.parse(decoded);
-    }
-    return imageItem;
-};
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY2xpcGJvYXJkLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vLi4vLi4vcGFja2FnZXMvY29yZS9zcmMvdXRpbHMvY2xpcGJvYXJkLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUdyRCxNQUFNLENBQUMsTUFBTSxpQkFBaUIsR0FBRyxDQUFDLEdBQVcsRUFBRSxFQUFFO0lBQzdDLE9BQU8sdUJBQXVCLEdBQUcsV0FBVyxDQUFDO0FBQ2pELENBQUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLGdCQUFnQixHQUFHLENBQUMsSUFBeUIsRUFBRSxRQUF3QixFQUFFLEVBQUU7SUFDcEYsTUFBTSxNQUFNLEdBQUcsQ0FBQyxHQUFHLFFBQVEsQ0FBQyxDQUFDO0lBQzdCLE1BQU0sbUJBQW1CLEdBQUcsb0JBQW9CLENBQUMsSUFBSSxDQUFDLENBQUM7SUFDdkQsSUFBSSxtQkFBbUIsRUFBRTtRQUNyQixNQUFNLENBQUMsSUFBSSxDQUFDLEdBQUcsbUJBQW1CLENBQUMsQ0FBQztLQUN2QztJQUNELE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxTQUFTLENBQUMsTUFBTSxDQUFDLENBQUM7SUFDekMsTUFBTSxPQUFPLEdBQUcsTUFBTSxDQUFDLElBQUksQ0FBQyxrQkFBa0IsQ0FBQyxTQUFTLENBQUMsQ0FBQyxDQUFDO0lBQzNELElBQUksRUFBRSxPQUFPLENBQUMsZUFBZSxxQkFBcUIsRUFBRSxFQUFFLE9BQU8sQ0FBQyxDQUFDO0FBQ25FLENBQUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLHNCQUFzQixHQUFHLENBQUMsSUFBeUIsRUFBRSxJQUFZLEVBQUUsRUFBRTtJQUM5RSxNQUFNLG1CQUFtQixHQUFHLG9CQUFvQixDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ3ZELElBQUksRUFBRSxPQUFPLENBQUMsWUFBWSxFQUFFLElBQUksR0FBRyxJQUFJLEdBQUcsbUJBQW1CLENBQUMsQ0FBQztBQUNuRSxDQUFDLENBQUM7QUFFRixNQUFNLENBQUMsTUFBTSx1QkFBdUIsR0FBRyxDQUFtQixJQUF5QixFQUFFLEtBQVEsRUFBRSxHQUFXLEVBQUUsRUFBRTtJQUMxRyxNQUFNLFNBQVMsR0FBRyxJQUFJLENBQUMsU0FBUyxDQUFDLEtBQUssQ0FBQyxDQUFDO0lBQ3hDLE1BQU0sT0FBTyxHQUFHLE1BQU0sQ0FBQyxJQUFJLENBQUMsa0JBQWtCLENBQUMsU0FBUyxDQUFDLENBQUMsQ0FBQztJQUMzRCxJQUFJLEVBQUUsT0FBTyxDQUFDLGlCQUFpQixDQUFDLEdBQUcsQ0FBQyxFQUFFLE9BQU8sQ0FBQyxDQUFDO0FBQ25ELENBQUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFHLENBQUMsSUFBeUIsRUFBRSxFQUFFO0lBQzlELE1BQU0sT0FBTyxHQUFHLElBQUksRUFBRSxPQUFPLENBQUMsZUFBZSxxQkFBcUIsRUFBRSxDQUFDLENBQUM7SUFDdEUsSUFBSSxTQUFTLEdBQW1CLEVBQUUsQ0FBQztJQUNuQyxJQUFJLE9BQU8sRUFBRTtRQUNULE1BQU0sT0FBTyxHQUFHLGtCQUFrQixDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsT0FBTyxDQUFDLENBQUMsQ0FBQztRQUN6RCxTQUFTLEdBQUcsSUFBSSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztLQUNuQztJQUNELE9BQU8sU0FBUyxDQUFDO0FBQ3JCLENBQUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLG9CQUFvQixHQUFHLENBQUMsSUFBeUIsRUFBRSxFQUFFO0lBQzlELE9BQU8sQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsWUFBWSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBVyxDQUFDO0FBQzlELENBQUMsQ0FBQztBQUVGLE1BQU0sQ0FBQyxNQUFNLHVCQUF1QixHQUFHLENBQUMsSUFBeUIsRUFBRSxHQUFXLEVBQUUsRUFBRTtJQUM5RSxNQUFNLE9BQU8sR0FBRyxJQUFJLEVBQUUsT0FBTyxDQUFDLGlCQUFpQixDQUFDLEdBQUcsQ0FBQyxDQUFDLENBQUM7SUFDdEQsSUFBSSxTQUFTLEdBQUcsSUFBSSxDQUFDO0lBQ3JCLElBQUksT0FBTyxFQUFFO1FBQ1QsTUFBTSxPQUFPLEdBQUcsa0JBQWtCLENBQUMsTUFBTSxDQUFDLElBQUksQ0FBQyxPQUFPLENBQUMsQ0FBQyxDQUFDO1FBQ3pELFNBQVMsR0FBRyxJQUFJLENBQUMsS0FBSyxDQUFDLE9BQU8sQ0FBQyxDQUFDO0tBQ25DO0lBQ0QsT0FBTyxTQUFTLENBQUM7QUFDckIsQ0FBQyxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgQ0xJUF9CT0FSRF9GT1JNQVRfS0VZIH0gZnJvbSAnLi4vY29uc3RhbnRzJztcbmltcG9ydCB7IFBsYWl0RWxlbWVudCB9IGZyb20gJy4uL2ludGVyZmFjZXMnO1xuXG5leHBvcnQgY29uc3QgZ2V0Q2xpcGJvYXJkQnlLZXkgPSAoa2V5OiBzdHJpbmcpID0+IHtcbiAgICByZXR1cm4gYGFwcGxpY2F0aW9uL3gtcGxhaXQtJHtrZXl9LWZyYWdtZW50YDtcbn07XG5cbmV4cG9ydCBjb25zdCBzZXRDbGlwYm9hcmREYXRhID0gKGRhdGE6IERhdGFUcmFuc2ZlciB8IG51bGwsIGVsZW1lbnRzOiBQbGFpdEVsZW1lbnRbXSkgPT4ge1xuICAgIGNvbnN0IHJlc3VsdCA9IFsuLi5lbGVtZW50c107XG4gICAgY29uc3QgcGx1Z2luQ29udGV4dFJlc3VsdCA9IGdldERhdGFGcm9tQ2xpcGJvYXJkKGRhdGEpO1xuICAgIGlmIChwbHVnaW5Db250ZXh0UmVzdWx0KSB7XG4gICAgICAgIHJlc3VsdC5wdXNoKC4uLnBsdWdpbkNvbnRleHRSZXN1bHQpO1xuICAgIH1cbiAgICBjb25zdCBzdHJpbmdPYmogPSBKU09OLnN0cmluZ2lmeShyZXN1bHQpO1xuICAgIGNvbnN0IGVuY29kZWQgPSB3aW5kb3cuYnRvYShlbmNvZGVVUklDb21wb25lbnQoc3RyaW5nT2JqKSk7XG4gICAgZGF0YT8uc2V0RGF0YShgYXBwbGljYXRpb24vJHtDTElQX0JPQVJEX0ZPUk1BVF9LRVl9YCwgZW5jb2RlZCk7XG59O1xuXG5leHBvcnQgY29uc3Qgc2V0Q2xpcGJvYXJkRGF0YUJ5VGV4dCA9IChkYXRhOiBEYXRhVHJhbnNmZXIgfCBudWxsLCB0ZXh0OiBzdHJpbmcpID0+IHtcbiAgICBjb25zdCBwbHVnaW5Db250ZXh0UmVzdWx0ID0gZ2V0VGV4dEZyb21DbGlwYm9hcmQoZGF0YSk7XG4gICAgZGF0YT8uc2V0RGF0YShgdGV4dC9wbGFpbmAsIHRleHQgKyAnXFxuJyArIHBsdWdpbkNvbnRleHRSZXN1bHQpO1xufTtcblxuZXhwb3J0IGNvbnN0IHNldENsaXBib2FyZERhdGFCeU1lZGlhID0gPFQgZXh0ZW5kcyBPYmplY3Q+KGRhdGE6IERhdGFUcmFuc2ZlciB8IG51bGwsIG1lZGlhOiBULCBrZXk6IHN0cmluZykgPT4ge1xuICAgIGNvbnN0IHN0cmluZ09iaiA9IEpTT04uc3RyaW5naWZ5KG1lZGlhKTtcbiAgICBjb25zdCBlbmNvZGVkID0gd2luZG93LmJ0b2EoZW5jb2RlVVJJQ29tcG9uZW50KHN0cmluZ09iaikpO1xuICAgIGRhdGE/LnNldERhdGEoZ2V0Q2xpcGJvYXJkQnlLZXkoa2V5KSwgZW5jb2RlZCk7XG59O1xuXG5leHBvcnQgY29uc3QgZ2V0RGF0YUZyb21DbGlwYm9hcmQgPSAoZGF0YTogRGF0YVRyYW5zZmVyIHwgbnVsbCkgPT4ge1xuICAgIGNvbnN0IGVuY29kZWQgPSBkYXRhPy5nZXREYXRhKGBhcHBsaWNhdGlvbi8ke0NMSVBfQk9BUkRfRk9STUFUX0tFWX1gKTtcbiAgICBsZXQgbm9kZXNEYXRhOiBQbGFpdEVsZW1lbnRbXSA9IFtdO1xuICAgIGlmIChlbmNvZGVkKSB7XG4gICAgICAgIGNvbnN0IGRlY29kZWQgPSBkZWNvZGVVUklDb21wb25lbnQod2luZG93LmF0b2IoZW5jb2RlZCkpO1xuICAgICAgICBub2Rlc0RhdGEgPSBKU09OLnBhcnNlKGRlY29kZWQpO1xuICAgIH1cbiAgICByZXR1cm4gbm9kZXNEYXRhO1xufTtcblxuZXhwb3J0IGNvbnN0IGdldFRleHRGcm9tQ2xpcGJvYXJkID0gKGRhdGE6IERhdGFUcmFuc2ZlciB8IG51bGwpID0+IHtcbiAgICByZXR1cm4gKGRhdGEgPyBkYXRhLmdldERhdGEoYHRleHQvcGxhaW5gKSA6ICcnKSBhcyBzdHJpbmc7XG59O1xuXG5leHBvcnQgY29uc3QgZ2V0Q2xpcGJvYXJkRGF0YUJ5TWVkaWEgPSAoZGF0YTogRGF0YVRyYW5zZmVyIHwgbnVsbCwga2V5OiBzdHJpbmcpID0+IHtcbiAgICBjb25zdCBlbmNvZGVkID0gZGF0YT8uZ2V0RGF0YShnZXRDbGlwYm9hcmRCeUtleShrZXkpKTtcbiAgICBsZXQgaW1hZ2VJdGVtID0gbnVsbDtcbiAgICBpZiAoZW5jb2RlZCkge1xuICAgICAgICBjb25zdCBkZWNvZGVkID0gZGVjb2RlVVJJQ29tcG9uZW50KHdpbmRvdy5hdG9iKGVuY29kZWQpKTtcbiAgICAgICAgaW1hZ2VJdGVtID0gSlNPTi5wYXJzZShkZWNvZGVkKTtcbiAgICB9XG4gICAgcmV0dXJuIGltYWdlSXRlbTtcbn07XG4iXX0=

package/utils/clipboard.d.ts

@@ -1,8 +0,0 @@
-import { PlaitElement } from '../interfaces';
-export declare const getClipboardByKey: (key: string) => string;
-export declare const setClipboardData: (data: DataTransfer | null, elements: PlaitElement[]) => void;
-export declare const setClipboardDataByText: (data: DataTransfer | null, text: string) => void;
-export declare const setClipboardDataByMedia: <T extends Object>(data: DataTransfer | null, media: T, key: string) => void;
-export declare const getDataFromClipboard: (data: DataTransfer | null) => PlaitElement[];
-export declare const getTextFromClipboard: (data: DataTransfer | null) => string;
-export declare const getClipboardDataByMedia: (data: DataTransfer | null, key: string) => any;