@zsviczian/excalidraw 0.18.0-12 → 0.18.0-14

package/types/utils/src/export.d.ts

@@ -1,35 +1,35 @@
-import { MIME_TYPES } from "@excalidraw/common";
-import type { ExcalidrawElement, ExcalidrawFrameLikeElement, NonDeleted } from "@excalidraw/element/types";
-import type { AppState, BinaryFiles } from "@excalidraw/excalidraw/types";
-export { MIME_TYPES };
-type ExportOpts = {
-    elements: readonly NonDeleted<ExcalidrawElement>[];
-    appState?: Partial<Omit<AppState, "offsetTop" | "offsetLeft">>;
-    files: BinaryFiles | null;
-    maxWidthOrHeight?: number;
-    exportingFrame?: ExcalidrawFrameLikeElement | null;
-    getDimensions?: (width: number, height: number) => {
-        width: number;
-        height: number;
-        scale?: number;
-    };
-};
-export declare const exportToCanvas: ({ elements, appState, files, maxWidthOrHeight, getDimensions, exportPadding, exportingFrame, }: ExportOpts & {
-    exportPadding?: number | undefined;
-}) => Promise<HTMLCanvasElement>;
-export declare const exportToBlob: (opts: ExportOpts & {
-    mimeType?: string;
-    quality?: number;
-    exportPadding?: number;
-}) => Promise<Blob>;
-export declare const exportToSvg: ({ elements, appState, files, exportPadding, renderEmbeddables, exportingFrame, skipInliningFonts, reuseImages, }: Omit<ExportOpts, "getDimensions"> & {
-    exportPadding?: number | undefined;
-    renderEmbeddables?: boolean | undefined;
-    skipInliningFonts?: true | undefined;
-    reuseImages?: boolean | undefined;
-}) => Promise<SVGSVGElement>;
-export declare const exportToClipboard: (opts: ExportOpts & {
-    mimeType?: string;
-    quality?: number;
-    type: "png" | "svg" | "json";
-}) => Promise<void>;
+import { MIME_TYPES } from "@excalidraw/common";
+import type { ExcalidrawElement, ExcalidrawFrameLikeElement, NonDeleted } from "@excalidraw/element/types";
+import type { AppState, BinaryFiles } from "@excalidraw/excalidraw/types";
+export { MIME_TYPES };
+type ExportOpts = {
+    elements: readonly NonDeleted<ExcalidrawElement>[];
+    appState?: Partial<Omit<AppState, "offsetTop" | "offsetLeft">>;
+    files: BinaryFiles | null;
+    maxWidthOrHeight?: number;
+    exportingFrame?: ExcalidrawFrameLikeElement | null;
+    getDimensions?: (width: number, height: number) => {
+        width: number;
+        height: number;
+        scale?: number;
+    };
+};
+export declare const exportToCanvas: ({ elements, appState, files, maxWidthOrHeight, getDimensions, exportPadding, exportingFrame, }: ExportOpts & {
+    exportPadding?: number | undefined;
+}) => Promise<HTMLCanvasElement>;
+export declare const exportToBlob: (opts: ExportOpts & {
+    mimeType?: string;
+    quality?: number;
+    exportPadding?: number;
+}) => Promise<Blob>;
+export declare const exportToSvg: ({ elements, appState, files, exportPadding, renderEmbeddables, exportingFrame, skipInliningFonts, reuseImages, }: Omit<ExportOpts, "getDimensions"> & {
+    exportPadding?: number | undefined;
+    renderEmbeddables?: boolean | undefined;
+    skipInliningFonts?: true | undefined;
+    reuseImages?: boolean | undefined;
+}) => Promise<SVGSVGElement>;
+export declare const exportToClipboard: (opts: ExportOpts & {
+    mimeType?: string;
+    quality?: number;
+    type: "png" | "svg" | "json";
+}) => Promise<void>;

package/types/utils/src/index.d.ts

@@ -1,4 +1,4 @@
-export * from "./export";
-export * from "./withinBounds";
-export * from "./bbox";
-export { getCommonBounds } from "@excalidraw/element/bounds";
+export * from "./export";
+export * from "./withinBounds";
+export * from "./bbox";
+export { getCommonBounds } from "@excalidraw/element/bounds";

package/types/utils/src/shape.d.ts

@@ -1,58 +1,58 @@
-import { type GlobalPoint, type LocalPoint } from "@excalidraw/math";
-import type { ElementsMap, ExcalidrawBindableElement, ExcalidrawDiamondElement, ExcalidrawElement, ExcalidrawEllipseElement, ExcalidrawEmbeddableElement, ExcalidrawFrameLikeElement, ExcalidrawFreeDrawElement, ExcalidrawIframeElement, ExcalidrawImageElement, ExcalidrawLinearElement, ExcalidrawRectangleElement, ExcalidrawSelectionElement, ExcalidrawTextElement } from "@excalidraw/element/types";
-import type { Curve, LineSegment, Polygon, Radians } from "@excalidraw/math";
-import type { Drawable, Op } from "roughjs/bin/core";
-export type Polyline<Point extends GlobalPoint | LocalPoint> = LineSegment<Point>[];
-export type Polycurve<Point extends GlobalPoint | LocalPoint> = Curve<Point>[];
-export type Ellipse<Point extends GlobalPoint | LocalPoint> = {
-    center: Point;
-    angle: Radians;
-    halfWidth: number;
-    halfHeight: number;
-};
-export type GeometricShape<Point extends GlobalPoint | LocalPoint> = {
-    type: "line";
-    data: LineSegment<Point>;
-} | {
-    type: "polygon";
-    data: Polygon<Point>;
-} | {
-    type: "curve";
-    data: Curve<Point>;
-} | {
-    type: "ellipse";
-    data: Ellipse<Point>;
-} | {
-    type: "polyline";
-    data: Polyline<Point>;
-} | {
-    type: "polycurve";
-    data: Polycurve<Point>;
-};
-type RectangularElement = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawFrameLikeElement | ExcalidrawEmbeddableElement | ExcalidrawImageElement | ExcalidrawIframeElement | ExcalidrawTextElement | ExcalidrawSelectionElement;
-export declare const getPolygonShape: <Point extends GlobalPoint | LocalPoint>(element: RectangularElement) => GeometricShape<Point>;
-export declare const getSelectionBoxShape: <Point extends GlobalPoint | LocalPoint>(element: ExcalidrawElement, elementsMap: ElementsMap, padding?: number) => GeometricShape<Point>;
-export declare const getEllipseShape: <Point extends GlobalPoint | LocalPoint>(element: ExcalidrawEllipseElement) => GeometricShape<Point>;
-export declare const getCurvePathOps: (shape: Drawable) => Op[];
-export declare const getCurveShape: <Point extends GlobalPoint | LocalPoint>(roughShape: Drawable, startingPoint: Point | undefined, angleInRadian: Radians, center: Point) => GeometricShape<Point>;
-export declare const getFreedrawShape: <Point extends GlobalPoint | LocalPoint>(element: ExcalidrawFreeDrawElement, center: Point, isClosed?: boolean) => GeometricShape<Point>;
-export declare const getClosedCurveShape: <Point extends GlobalPoint | LocalPoint>(element: ExcalidrawLinearElement, roughShape: Drawable, startingPoint: Point | undefined, angleInRadian: Radians, center: Point) => GeometricShape<Point>;
-/**
- * Determine intersection of a rectangular shaped element and a
- * line segment.
- *
- * @param element The rectangular element to test against
- * @param segment The segment intersecting the element
- * @param gap Optional value to inflate the shape before testing
- * @returns An array of intersections
- */
-export declare const segmentIntersectRectangleElement: <Point extends GlobalPoint | LocalPoint>(element: ExcalidrawBindableElement, segment: LineSegment<Point>, gap?: number) => Point[];
-export declare const pointOnEllipse: <Point extends GlobalPoint | LocalPoint>(point: Point, ellipse: Ellipse<Point>, threshold?: number) => boolean;
-export declare const pointInEllipse: <Point extends GlobalPoint | LocalPoint>(p: Point, ellipse: Ellipse<Point>) => boolean;
-export declare const ellipseAxes: <Point extends GlobalPoint | LocalPoint>(ellipse: Ellipse<Point>) => {
-    majorAxis: number;
-    minorAxis: number;
-};
-export declare const ellipseFocusToCenter: <Point extends GlobalPoint | LocalPoint>(ellipse: Ellipse<Point>) => number;
-export declare const ellipseExtremes: <Point extends GlobalPoint | LocalPoint>(ellipse: Ellipse<Point>) => import("@excalidraw/math").Vector[];
-export {};
+import { type GlobalPoint, type LocalPoint } from "@excalidraw/math";
+import type { ElementsMap, ExcalidrawBindableElement, ExcalidrawDiamondElement, ExcalidrawElement, ExcalidrawEllipseElement, ExcalidrawEmbeddableElement, ExcalidrawFrameLikeElement, ExcalidrawFreeDrawElement, ExcalidrawIframeElement, ExcalidrawImageElement, ExcalidrawLinearElement, ExcalidrawRectangleElement, ExcalidrawSelectionElement, ExcalidrawTextElement } from "@excalidraw/element/types";
+import type { Curve, LineSegment, Polygon, Radians } from "@excalidraw/math";
+import type { Drawable, Op } from "roughjs/bin/core";
+export type Polyline<Point extends GlobalPoint | LocalPoint> = LineSegment<Point>[];
+export type Polycurve<Point extends GlobalPoint | LocalPoint> = Curve<Point>[];
+export type Ellipse<Point extends GlobalPoint | LocalPoint> = {
+    center: Point;
+    angle: Radians;
+    halfWidth: number;
+    halfHeight: number;
+};
+export type GeometricShape<Point extends GlobalPoint | LocalPoint> = {
+    type: "line";
+    data: LineSegment<Point>;
+} | {
+    type: "polygon";
+    data: Polygon<Point>;
+} | {
+    type: "curve";
+    data: Curve<Point>;
+} | {
+    type: "ellipse";
+    data: Ellipse<Point>;
+} | {
+    type: "polyline";
+    data: Polyline<Point>;
+} | {
+    type: "polycurve";
+    data: Polycurve<Point>;
+};
+type RectangularElement = ExcalidrawRectangleElement | ExcalidrawDiamondElement | ExcalidrawFrameLikeElement | ExcalidrawEmbeddableElement | ExcalidrawImageElement | ExcalidrawIframeElement | ExcalidrawTextElement | ExcalidrawSelectionElement;
+export declare const getPolygonShape: <Point extends GlobalPoint | LocalPoint>(element: RectangularElement) => GeometricShape<Point>;
+export declare const getSelectionBoxShape: <Point extends GlobalPoint | LocalPoint>(element: ExcalidrawElement, elementsMap: ElementsMap, padding?: number) => GeometricShape<Point>;
+export declare const getEllipseShape: <Point extends GlobalPoint | LocalPoint>(element: ExcalidrawEllipseElement) => GeometricShape<Point>;
+export declare const getCurvePathOps: (shape: Drawable) => Op[];
+export declare const getCurveShape: <Point extends GlobalPoint | LocalPoint>(roughShape: Drawable, startingPoint: Point | undefined, angleInRadian: Radians, center: Point) => GeometricShape<Point>;
+export declare const getFreedrawShape: <Point extends GlobalPoint | LocalPoint>(element: ExcalidrawFreeDrawElement, center: Point, isClosed?: boolean) => GeometricShape<Point>;
+export declare const getClosedCurveShape: <Point extends GlobalPoint | LocalPoint>(element: ExcalidrawLinearElement, roughShape: Drawable, startingPoint: Point | undefined, angleInRadian: Radians, center: Point) => GeometricShape<Point>;
+/**
+ * Determine intersection of a rectangular shaped element and a
+ * line segment.
+ *
+ * @param element The rectangular element to test against
+ * @param segment The segment intersecting the element
+ * @param gap Optional value to inflate the shape before testing
+ * @returns An array of intersections
+ */
+export declare const segmentIntersectRectangleElement: <Point extends GlobalPoint | LocalPoint>(element: ExcalidrawBindableElement, segment: LineSegment<Point>, gap?: number) => Point[];
+export declare const pointOnEllipse: <Point extends GlobalPoint | LocalPoint>(point: Point, ellipse: Ellipse<Point>, threshold?: number) => boolean;
+export declare const pointInEllipse: <Point extends GlobalPoint | LocalPoint>(p: Point, ellipse: Ellipse<Point>) => boolean;
+export declare const ellipseAxes: <Point extends GlobalPoint | LocalPoint>(ellipse: Ellipse<Point>) => {
+    majorAxis: number;
+    minorAxis: number;
+};
+export declare const ellipseFocusToCenter: <Point extends GlobalPoint | LocalPoint>(ellipse: Ellipse<Point>) => number;
+export declare const ellipseExtremes: <Point extends GlobalPoint | LocalPoint>(ellipse: Ellipse<Point>) => import("@excalidraw/math").Vector[];
+export {};

package/types/utils/src/withinBounds.d.ts

@@ -1,19 +1,19 @@
-import type { Bounds } from "@excalidraw/element/bounds";
-import type { ExcalidrawElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
-type Element = NonDeletedExcalidrawElement;
-type Elements = readonly NonDeletedExcalidrawElement[];
-export declare const isElementInsideBBox: (element: Element, bbox: Bounds, eitherDirection?: boolean) => boolean;
-export declare const elementPartiallyOverlapsWithOrContainsBBox: (element: Element, bbox: Bounds) => boolean;
-export declare const elementsOverlappingBBox: ({ elements, bounds, type, errorMargin, }: {
-    elements: Elements;
-    bounds: Bounds | ExcalidrawElement;
-    /** safety offset. Defaults to 0. */
-    errorMargin?: number | undefined;
-    /**
-     * - overlap: elements overlapping or inside bounds
-     * - contain: elements inside bounds or bounds inside elements
-     * - inside: elements inside bounds
-     **/
-    type: "overlap" | "contain" | "inside";
-}) => NonDeletedExcalidrawElement[];
-export {};
+import type { Bounds } from "@excalidraw/element/bounds";
+import type { ExcalidrawElement, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+type Element = NonDeletedExcalidrawElement;
+type Elements = readonly NonDeletedExcalidrawElement[];
+export declare const isElementInsideBBox: (element: Element, bbox: Bounds, eitherDirection?: boolean) => boolean;
+export declare const elementPartiallyOverlapsWithOrContainsBBox: (element: Element, bbox: Bounds) => boolean;
+export declare const elementsOverlappingBBox: ({ elements, bounds, type, errorMargin, }: {
+    elements: Elements;
+    bounds: Bounds | ExcalidrawElement;
+    /** safety offset. Defaults to 0. */
+    errorMargin?: number | undefined;
+    /**
+     * - overlap: elements overlapping or inside bounds
+     * - contain: elements inside bounds or bounds inside elements
+     * - inside: elements inside bounds
+     **/
+    type: "overlap" | "contain" | "inside";
+}) => NonDeletedExcalidrawElement[];
+export {};

package/types/excalidraw/store.d.ts

@@ -1,129 +0,0 @@
-import type { OrderedExcalidrawElement } from "@excalidraw/element/types";
-import type { ValueOf } from "@excalidraw/common/utility-types";
-import { AppStateChange, ElementsChange } from "./change";
-import { Emitter } from "./emitter";
-import type { AppState, ObservedAppState } from "./types";
-export declare const getObservedAppState: (appState: AppState) => ObservedAppState;
-export declare const CaptureUpdateAction: {
-    /**
-     * Immediately undoable.
-     *
-     * Use for updates which should be captured.
-     * Should be used for most of the local updates.
-     *
-     * These updates will _immediately_ make it to the local undo / redo stacks.
-     */
-    readonly IMMEDIATELY: "IMMEDIATELY";
-    /**
-     * Never undoable.
-     *
-     * Use for updates which should never be recorded, such as remote updates
-     * or scene initialization.
-     *
-     * These updates will _never_ make it to the local undo / redo stacks.
-     */
-    readonly NEVER: "NEVER";
-    /**
-     * Eventually undoable.
-     *
-     * Use for updates which should not be captured immediately - likely
-     * exceptions which are part of some async multi-step process. Otherwise, all
-     * such updates would end up being captured with the next
-     * `CaptureUpdateAction.IMMEDIATELY` - triggered either by the next `updateScene`
-     * or internally by the editor.
-     *
-     * These updates will _eventually_ make it to the local undo / redo stacks.
-     */
-    readonly EVENTUALLY: "EVENTUALLY";
-};
-export type CaptureUpdateActionType = ValueOf<typeof CaptureUpdateAction>;
-/**
- * Represent an increment to the Store.
- */
-declare class StoreIncrementEvent {
-    readonly elementsChange: ElementsChange;
-    readonly appStateChange: AppStateChange;
-    constructor(elementsChange: ElementsChange, appStateChange: AppStateChange);
-}
-/**
- * Store which captures the observed changes and emits them as `StoreIncrementEvent` events.
- *
- * @experimental this interface is experimental and subject to change.
- */
-export interface IStore {
-    onStoreIncrementEmitter: Emitter<[StoreIncrementEvent]>;
-    get snapshot(): Snapshot;
-    set snapshot(snapshot: Snapshot);
-    /**
-     * Use to schedule update of the snapshot, useful on updates for which we don't need to calculate increments (i.e. remote updates).
-     */
-    shouldUpdateSnapshot(): void;
-    /**
-     * Use to schedule calculation of a store increment.
-     */
-    shouldCaptureIncrement(): void;
-    /**
-     * Based on the scheduled operation, either only updates store snapshot or also calculates increment and emits the result as a `StoreIncrementEvent`.
-     *
-     * @emits StoreIncrementEvent when increment is calculated.
-     */
-    commit(elements: Map<string, OrderedExcalidrawElement> | undefined, appState: AppState | ObservedAppState | undefined): void;
-    /**
-     * Clears the store instance.
-     */
-    clear(): void;
-    /**
-     * Filters out yet uncomitted elements from `nextElements`, which are part of in-progress local async actions (ephemerals) and thus were not yet commited to the snapshot.
-     *
-     * This is necessary in updates in which we receive reconciled elements, already containing elements which were not yet captured by the local store (i.e. collab).
-     */
-    filterUncomittedElements(prevElements: Map<string, OrderedExcalidrawElement>, nextElements: Map<string, OrderedExcalidrawElement>): Map<string, OrderedExcalidrawElement>;
-}
-export declare class Store implements IStore {
-    readonly onStoreIncrementEmitter: Emitter<[StoreIncrementEvent]>;
-    private scheduledActions;
-    private _snapshot;
-    get snapshot(): Snapshot;
-    set snapshot(snapshot: Snapshot);
-    shouldCaptureIncrement: () => void;
-    shouldUpdateSnapshot: () => void;
-    private scheduleAction;
-    commit: (elements: Map<string, OrderedExcalidrawElement> | undefined, appState: AppState | ObservedAppState | undefined) => void;
-    captureIncrement: (elements: Map<string, OrderedExcalidrawElement> | undefined, appState: AppState | ObservedAppState | undefined) => void;
-    updateSnapshot: (elements: Map<string, OrderedExcalidrawElement> | undefined, appState: AppState | ObservedAppState | undefined) => void;
-    filterUncomittedElements: (prevElements: Map<string, OrderedExcalidrawElement>, nextElements: Map<string, OrderedExcalidrawElement>) => Map<string, OrderedExcalidrawElement>;
-    clear: () => void;
-    private satisfiesScheduledActionsInvariant;
-}
-export declare class Snapshot {
-    readonly elements: Map<string, OrderedExcalidrawElement>;
-    readonly appState: ObservedAppState;
-    readonly meta: {
-        didElementsChange: boolean;
-        didAppStateChange: boolean;
-        isEmpty?: boolean;
-    };
-    private constructor();
-    static empty(): Snapshot;
-    isEmpty(): boolean | undefined;
-    /**
-     * Efficiently clone the existing snapshot, only if we detected changes.
-     *
-     * @returns same instance if there are no changes detected, new instance otherwise.
-     */
-    maybeClone(elements: Map<string, OrderedExcalidrawElement> | undefined, appState: AppState | ObservedAppState | undefined): Snapshot;
-    private maybeCreateAppStateSnapshot;
-    private detectChangedAppState;
-    private maybeCreateElementsSnapshot;
-    /**
-     * Detect if there any changed elements.
-     *
-     * NOTE: we shouldn't just use `sceneVersionNonce` instead, as we need to call this before the scene updates.
-     */
-    private detectChangedElements;
-    /**
-     * Perform structural clone, cloning only elements that changed.
-     */
-    private createElementsSnapshot;
-}
-export {};