@plait/core 0.52.0 → 0.53.0

package/interfaces/board.d.ts

@@ -59,6 +59,7 @@ export interface PlaitBoard {
     applyTheme: (element: PlaitElement) => void;
     isAlign: (element: PlaitElement) => boolean;
     isImageBindingAllowed: (element: PlaitElement) => boolean;
+    canAddToGroup: (element: PlaitElement) => boolean;
     pointerDown: (pointer: PointerEvent) => void;
     pointerMove: (pointer: PointerEvent) => void;
     pointerUp: (pointer: PointerEvent) => void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@plait/core",
-  "version": "0.52.0",
+  "version": "0.53.0",
   "peerDependencies": {
     "@angular/common": "^17.2.4",
     "@angular/core": "^17.2.4",

package/plugins/with-moving.d.ts

@@ -2,5 +2,5 @@ import { PlaitBoard } from '../interfaces/board';
 import { PlaitElement } from '../interfaces/element';
 export declare function withMoving(board: PlaitBoard): PlaitBoard;
 export declare function withArrowMoving(board: PlaitBoard): PlaitBoard;
-export declare function getTargetElements(board: PlaitBoard): PlaitElement[];
+export declare function getSelectedTargetElements(board: PlaitBoard): PlaitElement[];
 export declare function updatePoints(board: PlaitBoard, targetElements: PlaitElement[], offsetX: number, offsetY: number): PlaitElement[];

package/plugins/with-related-fragment.d.ts

@@ -0,0 +1,2 @@
+import { PlaitBoard } from '../interfaces';
+export declare function withRelatedFragment(board: PlaitBoard): PlaitBoard;

package/public-api.d.ts

@@ -13,3 +13,4 @@ export * from './plugins/with-moving';
 export * from './plugins/with-options';
 export * from './testing';
 export * from './services/image-context.service';
+export * from './utils/debug';

package/transforms/group.d.ts

@@ -0,0 +1,7 @@
+import { PlaitBoard, PlaitElement } from '../interfaces';
+export declare const addGroup: (board: PlaitBoard, elements?: PlaitElement[]) => void;
+export declare const removeGroup: (board: PlaitBoard, elements?: PlaitElement[]) => void;
+export declare const GroupTransforms: {
+    addGroup: (board: PlaitBoard, elements?: PlaitElement[]) => void;
+    removeGroup: (board: PlaitBoard, elements?: PlaitElement[]) => void;
+};

package/transforms/index.d.ts

@@ -4,4 +4,5 @@ import { SelectionTransforms } from './selection';
 import { ViewportTransforms } from './viewport';
 export { BoardTransforms } from './board';
 export { CoreTransforms } from './element';
+export { GroupTransforms } from './group';
 export declare const Transforms: GeneralTransforms & ViewportTransforms & SelectionTransforms & NodeTransforms;

package/utils/angle.d.ts

@@ -0,0 +1,13 @@
+import { PlaitElement, Point, RectangleClient } from '../interfaces';
+export declare const rotatePoints: <T>(points: T, centerPoint: Point, angle: number) => T;
+export declare const getSelectionAngle: (elements: PlaitElement[]) => any;
+export declare const hasSameAngle: (elements: PlaitElement[]) => boolean;
+export declare const getRotatedBoundingRectangle: (rectanglesCornerPoints: [Point, Point, Point, Point][], angle: number) => RectangleClient;
+export declare const getOffsetAfterRotate: (rectangle: RectangleClient, rotateCenterPoint: Point, angle: number) => {
+    offsetX: number;
+    offsetY: number;
+};
+export declare const rotatedDataPoints: (points: Point[], rotateCenterPoint: Point, angle: number) => Point[];
+export declare const hasValidAngle: (node: PlaitElement) => any;
+export declare const rotatePointsByElement: <T>(points: T, element: PlaitElement) => T | null;
+export declare const rotateAntiPointsByElement: <T>(points: T, element: PlaitElement) => T | null;

package/utils/debug.d.ts

@@ -0,0 +1,13 @@
+import { Options } from 'roughjs/bin/core';
+import { PlaitBoard, Point, RectangleClient } from '../interfaces';
+export declare class DebugGenerator {
+    private debugKey;
+    constructor(debugKey: string);
+    isDebug(): boolean;
+    clear(): void;
+    drawPolygon(board: PlaitBoard, points: Point[], options?: Options): SVGGElement | undefined;
+    drawRectangle(board: PlaitBoard, data: Point[] | RectangleClient, options?: Options): SVGGElement | undefined;
+    drawCircles(board: PlaitBoard, points: Point[], diameter?: number, isCumulativeDiameter?: boolean, options?: Options): SVGGElement[] | undefined;
+}
+export declare const createDebugGenerator: (debugKey: string) => DebugGenerator;
+export declare const isDebug: (key?: string) => boolean;

package/utils/group.d.ts

@@ -1,22 +1,22 @@
-import { PlaitBoard, PlaitElement } from '../interfaces';
-import { PlaitGroup } from '../interfaces/group';
+import { PlaitBoard, PlaitElement, PlaitGroup } from '../interfaces';
 export declare const getElementsInGroup: (board: PlaitBoard, group: PlaitGroup, recursion?: boolean, includeGroup?: boolean) => PlaitElement[];
+export declare const getAllElementsInGroup: (board: PlaitBoard, group: PlaitGroup, recursion?: boolean, includeGroup?: boolean) => PlaitElement[];
 export declare const getRectangleByGroup: (board: PlaitBoard, group: PlaitGroup, recursion?: boolean) => import("../interfaces").RectangleClient;
-export declare const getGroupByElement: (board: PlaitBoard, element: PlaitElement, recursion?: boolean) => PlaitGroup | PlaitGroup[] | null;
+export declare const getGroupByElement: (board: PlaitBoard, element: PlaitElement, recursion?: boolean, source?: PlaitElement[]) => PlaitGroup | PlaitGroup[] | null;
 export declare const getHighestGroup: (board: PlaitBoard, element: PlaitElement) => PlaitGroup | null;
 export declare const getElementsInGroupByElement: (board: PlaitBoard, element: PlaitElement) => PlaitElement[];
-export declare const isSelectedElementOrGroup: (board: PlaitBoard, element: PlaitElement) => boolean;
-export declare const isSelectedAllElementsInGroup: (board: PlaitBoard, group: PlaitGroup) => boolean;
-export declare const getSelectedGroups: (board: PlaitBoard, groups: PlaitGroup[]) => PlaitGroup[];
-export declare const getHighestSelectedGroup: (board: PlaitBoard, element: PlaitElement) => PlaitGroup | null;
-export declare const getHighestSelectedGroups: (board: PlaitBoard) => PlaitGroup[];
-export declare const getSelectedIsolatedElements: (board: PlaitBoard) => PlaitElement[];
-export declare const getHighestSelectedElements: (board: PlaitBoard) => PlaitElement[];
+export declare const isSelectedElementOrGroup: (board: PlaitBoard, element: PlaitElement, elements?: PlaitElement[]) => boolean;
+export declare const isSelectedAllElementsInGroup: (board: PlaitBoard, group: PlaitGroup, elements?: PlaitElement[]) => boolean;
+export declare const filterSelectedGroups: (board: PlaitBoard, groups: PlaitGroup[], elements?: PlaitElement[]) => PlaitGroup[];
+export declare const getSelectedGroups: (board: PlaitBoard, elements?: PlaitElement[]) => PlaitGroup[];
+export declare const getHighestSelectedGroup: (board: PlaitBoard, element: PlaitElement, elements?: PlaitElement[]) => PlaitGroup | null;
+export declare const getHighestSelectedGroups: (board: PlaitBoard, elements?: PlaitElement[]) => PlaitGroup[];
+export declare const getSelectedIsolatedElements: (board: PlaitBoard, elements?: PlaitElement[]) => PlaitElement[];
+export declare const getSelectedIsolatedElementsCanAddToGroup: (board: PlaitBoard, elements?: PlaitElement[]) => PlaitElement[];
+export declare const getHighestSelectedElements: (board: PlaitBoard, elements?: PlaitElement[]) => PlaitElement[];
 export declare const createGroupRectangleG: (board: PlaitBoard, elements: PlaitElement[]) => SVGGElement | null;
-export declare const createGroup: () => PlaitGroup;
+export declare const createGroup: (groupId?: string) => PlaitGroup;
 export declare const nonGroupInHighestSelectedElements: (elements: PlaitElement[]) => boolean;
 export declare const hasSelectedElementsInSameGroup: (elements: PlaitElement[]) => boolean;
-export declare const canAddGroup: (highestSelectedElements: PlaitElement[]) => boolean;
-export declare const addGroup: (board: PlaitBoard) => void;
-export declare const canRemoveGroup: (board: PlaitBoard, selectedGroups: PlaitGroup[]) => boolean;
-export declare const removeGroup: (board: PlaitBoard) => void;
+export declare const canAddGroup: (board: PlaitBoard, elements?: PlaitElement[]) => boolean;
+export declare const canRemoveGroup: (board: PlaitBoard, elements?: PlaitElement[]) => boolean;

package/utils/helper.d.ts

@@ -1,3 +1,4 @@
+import { PlaitElement } from "../interfaces";
 export declare function isNullOrUndefined(value: any): boolean;
 /**
  * get {x,y} point
@@ -10,3 +11,4 @@ export declare function normalizePoint(point: number[]): {
 };
 export declare const RgbaToHEX: (Rgb: string, opacity: number) => string;
 export declare function isContextmenu(event: MouseEvent): boolean;
+export declare function uniqueById(elements: PlaitElement[]): any[];

package/utils/index.d.ts

@@ -27,3 +27,4 @@ export * from './dnd';
 export * from './to-point';
 export * from './group';
 export * from './selection';
+export * from './angle';

package/utils/math.d.ts

@@ -27,3 +27,11 @@ export declare function getVectorFromPointAndSlope(x: number, y: number, slope:
  */
 export declare function toDomPrecision(v: number): number;
 export declare function toFixed(v: number): number;
+/**
+ * Whether two numbers numbers a and b are approximately equal.
+ *
+ * @param a - The first point.
+ * @param b - The second point.
+ * @public
+ */
+export declare function approximately(a: number, b: number, precision?: number): boolean;

package/utils/selection.d.ts

@@ -1,13 +1,16 @@
-import { PlaitBoard } from '../interfaces';
+import { PlaitBoard, PlaitElement, PlaitGroup } from '../interfaces';
 export declare function isSelectionMoving(board: PlaitBoard): boolean;
 export declare function setSelectionMoving(board: PlaitBoard): void;
 export declare function clearSelectionMoving(board: PlaitBoard): void;
 export declare function isHandleSelection(board: PlaitBoard): boolean;
 export declare function isSetSelectionOperation(board: PlaitBoard): boolean;
-export declare function getTemporaryElements(board: PlaitBoard): import("../interfaces").PlaitElement[] | undefined;
+export declare function getTemporaryElements(board: PlaitBoard): PlaitElement[] | undefined;
 export declare function getTemporaryRef(board: PlaitBoard): {
-    elements: import("../interfaces").PlaitElement[];
+    elements: PlaitElement[];
     timeoutId: any;
 } | undefined;
 export declare function deleteTemporaryElements(board: PlaitBoard): void;
 export declare function createSelectionRectangleG(board: PlaitBoard): SVGGElement | null;
+export declare function setSelectedElementsWithGroup(board: PlaitBoard, elements: PlaitElement[], isShift: boolean): void;
+export declare function cacheSelectedElementsWithGroupOnShift(board: PlaitBoard, elements: PlaitElement[], isSelectGroupElement: boolean, elementsInHighestGroup: PlaitElement[]): void;
+export declare function cacheSelectedElementsWithGroup(board: PlaitBoard, elements: PlaitElement[], isSelectGroupElement: boolean, hitElementGroups: PlaitGroup[]): void;

package/utils/touch.d.ts

@@ -1,6 +1,6 @@
 import { PlaitBoard } from '../interfaces/board';
 export interface TouchRef {
-    target?: SVGElement;
+    target?: HTMLElement | SVGElement;
     state: boolean;
     host?: SVGGElement;
 }

package/esm2022/plugins/with-group.mjs

@@ -1,27 +0,0 @@
-import { PlaitBoard, Selection } from '../interfaces';
-import { createGroupRectangleG, toViewBoxPoint, toHostPoint, getHitElementsBySelection } from '../utils';
-export function withGroup(board) {
-    const { pointerMove, globalPointerUp } = board;
-    let groupRectangleG;
-    board.pointerMove = (event) => {
-        groupRectangleG?.remove();
-        const point = toViewBoxPoint(board, toHostPoint(board, event.x, event.y));
-        let selection = { anchor: point, focus: point };
-        if (board.selection && !Selection.isCollapsed(board.selection)) {
-            selection = board.selection;
-        }
-        const hitElements = getHitElementsBySelection(board, selection);
-        if (hitElements.length) {
-            groupRectangleG = createGroupRectangleG(board, hitElements);
-            groupRectangleG && PlaitBoard.getElementActiveHost(board).append(groupRectangleG);
-        }
-        pointerMove(event);
-    };
-    board.globalPointerUp = (event) => {
-        groupRectangleG?.remove();
-        groupRectangleG = null;
-        globalPointerUp(event);
-    };
-    return board;
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2l0aC1ncm91cC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uLy4uL3BhY2thZ2VzL2NvcmUvc3JjL3BsdWdpbnMvd2l0aC1ncm91cC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsVUFBVSxFQUFFLFNBQVMsRUFBRSxNQUFNLGVBQWUsQ0FBQztBQUN0RCxPQUFPLEVBQ0gscUJBQXFCLEVBQ3JCLGNBQWMsRUFDZCxXQUFXLEVBQ1gseUJBQXlCLEVBQzVCLE1BQU0sVUFBVSxDQUFDO0FBRWxCLE1BQU0sVUFBVSxTQUFTLENBQUMsS0FBaUI7SUFDdkMsTUFBTSxFQUFFLFdBQVcsRUFBRSxlQUFlLEVBQUUsR0FBRyxLQUFLLENBQUM7SUFDL0MsSUFBSSxlQUFtQyxDQUFDO0lBRXhDLEtBQUssQ0FBQyxXQUFXLEdBQUcsQ0FBQyxLQUFtQixFQUFFLEVBQUU7UUFDeEMsZUFBZSxFQUFFLE1BQU0sRUFBRSxDQUFDO1FBQzFCLE1BQU0sS0FBSyxHQUFHLGNBQWMsQ0FBQyxLQUFLLEVBQUUsV0FBVyxDQUFDLEtBQUssRUFBRSxLQUFLLENBQUMsQ0FBQyxFQUFFLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQyxDQUFDO1FBQzFFLElBQUksU0FBUyxHQUFjLEVBQUUsTUFBTSxFQUFFLEtBQUssRUFBRSxLQUFLLEVBQUUsS0FBSyxFQUFFLENBQUM7UUFDM0QsSUFBSSxLQUFLLENBQUMsU0FBUyxJQUFJLENBQUMsU0FBUyxDQUFDLFdBQVcsQ0FBQyxLQUFLLENBQUMsU0FBUyxDQUFDLEVBQUUsQ0FBQztZQUM3RCxTQUFTLEdBQUcsS0FBSyxDQUFDLFNBQVMsQ0FBQztRQUNoQyxDQUFDO1FBQ0QsTUFBTSxXQUFXLEdBQUcseUJBQXlCLENBQUMsS0FBSyxFQUFFLFNBQVMsQ0FBQyxDQUFDO1FBQ2hFLElBQUksV0FBVyxDQUFDLE1BQU0sRUFBRSxDQUFDO1lBQ3JCLGVBQWUsR0FBRyxxQkFBcUIsQ0FBQyxLQUFLLEVBQUUsV0FBVyxDQUFDLENBQUM7WUFDNUQsZUFBZSxJQUFJLFVBQVUsQ0FBQyxvQkFBb0IsQ0FBQyxLQUFLLENBQUMsQ0FBQyxNQUFNLENBQUMsZUFBZSxDQUFDLENBQUM7UUFDdEYsQ0FBQztRQUVELFdBQVcsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUN2QixDQUFDLENBQUM7SUFFRixLQUFLLENBQUMsZUFBZSxHQUFHLENBQUMsS0FBbUIsRUFBRSxFQUFFO1FBQzVDLGVBQWUsRUFBRSxNQUFNLEVBQUUsQ0FBQztRQUMxQixlQUFlLEdBQUcsSUFBSSxDQUFDO1FBQ3ZCLGVBQWUsQ0FBQyxLQUFLLENBQUMsQ0FBQztJQUMzQixDQUFDLENBQUM7SUFFRixPQUFPLEtBQUssQ0FBQztBQUNqQixDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0IHsgUGxhaXRCb2FyZCwgU2VsZWN0aW9uIH0gZnJvbSAnLi4vaW50ZXJmYWNlcyc7XG5pbXBvcnQge1xuICAgIGNyZWF0ZUdyb3VwUmVjdGFuZ2xlRyxcbiAgICB0b1ZpZXdCb3hQb2ludCxcbiAgICB0b0hvc3RQb2ludCxcbiAgICBnZXRIaXRFbGVtZW50c0J5U2VsZWN0aW9uXG59IGZyb20gJy4uL3V0aWxzJztcblxuZXhwb3J0IGZ1bmN0aW9uIHdpdGhHcm91cChib2FyZDogUGxhaXRCb2FyZCkge1xuICAgIGNvbnN0IHsgcG9pbnRlck1vdmUsIGdsb2JhbFBvaW50ZXJVcCB9ID0gYm9hcmQ7XG4gICAgbGV0IGdyb3VwUmVjdGFuZ2xlRzogU1ZHR0VsZW1lbnQgfCBudWxsO1xuXG4gICAgYm9hcmQucG9pbnRlck1vdmUgPSAoZXZlbnQ6IFBvaW50ZXJFdmVudCkgPT4ge1xuICAgICAgICBncm91cFJlY3RhbmdsZUc/LnJlbW92ZSgpO1xuICAgICAgICBjb25zdCBwb2ludCA9IHRvVmlld0JveFBvaW50KGJvYXJkLCB0b0hvc3RQb2ludChib2FyZCwgZXZlbnQueCwgZXZlbnQueSkpO1xuICAgICAgICBsZXQgc2VsZWN0aW9uOiBTZWxlY3Rpb24gPSB7IGFuY2hvcjogcG9pbnQsIGZvY3VzOiBwb2ludCB9O1xuICAgICAgICBpZiAoYm9hcmQuc2VsZWN0aW9uICYmICFTZWxlY3Rpb24uaXNDb2xsYXBzZWQoYm9hcmQuc2VsZWN0aW9uKSkge1xuICAgICAgICAgICAgc2VsZWN0aW9uID0gYm9hcmQuc2VsZWN0aW9uO1xuICAgICAgICB9XG4gICAgICAgIGNvbnN0IGhpdEVsZW1lbnRzID0gZ2V0SGl0RWxlbWVudHNCeVNlbGVjdGlvbihib2FyZCwgc2VsZWN0aW9uKTtcbiAgICAgICAgaWYgKGhpdEVsZW1lbnRzLmxlbmd0aCkge1xuICAgICAgICAgICAgZ3JvdXBSZWN0YW5nbGVHID0gY3JlYXRlR3JvdXBSZWN0YW5nbGVHKGJvYXJkLCBoaXRFbGVtZW50cyk7XG4gICAgICAgICAgICBncm91cFJlY3RhbmdsZUcgJiYgUGxhaXRCb2FyZC5nZXRFbGVtZW50QWN0aXZlSG9zdChib2FyZCkuYXBwZW5kKGdyb3VwUmVjdGFuZ2xlRyk7XG4gICAgICAgIH1cblxuICAgICAgICBwb2ludGVyTW92ZShldmVudCk7XG4gICAgfTtcblxuICAgIGJvYXJkLmdsb2JhbFBvaW50ZXJVcCA9IChldmVudDogUG9pbnRlckV2ZW50KSA9PiB7XG4gICAgICAgIGdyb3VwUmVjdGFuZ2xlRz8ucmVtb3ZlKCk7XG4gICAgICAgIGdyb3VwUmVjdGFuZ2xlRyA9IG51bGw7XG4gICAgICAgIGdsb2JhbFBvaW50ZXJVcChldmVudCk7XG4gICAgfTtcblxuICAgIHJldHVybiBib2FyZDtcbn1cbiJdfQ==

package/plugins/with-group.d.ts

@@ -1,2 +0,0 @@
-import { PlaitBoard } from '../interfaces';
-export declare function withGroup(board: PlaitBoard): PlaitBoard;