@excalidraw/element 0.18.0-200a6bd94 → 0.18.0-2a82821

package/dist/types/math/src/types.d.ts

@@ -19,12 +19,24 @@ export type InclusiveRange = [number, number] & {
     _brand: "excalimath_degree";
 };
 /**
- * Represents a 2D position in world or canvas space. A
+ * Represents a 2D position in world/canvas/scene space. A
  * global coordinate.
  */
 export type GlobalPoint = [x: number, y: number] & {
     _brand: "excalimath__globalpoint";
 };
+/**
+ * Represents a 2D position in world/canvas/scene space. A
+ * global coordinate.
+ *
+ * TODO remove this once we migrate the codebase to use Point tuples everywhere
+ */
+export type GlobalCoord = {
+    x: number;
+    y: number;
+} & {
+    _brand: "excalimath__globalcoord";
+};
 /**
  * Represents a 2D position in whatever local space it's
  * needed. A local coordinate.
@@ -32,6 +44,18 @@ export type GlobalPoint = [x: number, y: number] & {
 export type LocalPoint = [x: number, y: number] & {
     _brand: "excalimath__localpoint";
 };
+/**
+ * Represents a 2D position in whatever local space it's needed.
+ * A local coordinate.
+ *
+ * TODO remove this once we migrate the codebase to use Point tuples everywhere
+ */
+export type LocalCoord = {
+    x: number;
+    y: number;
+} & {
+    _brand: "excalimath__localcoord";
+};
 /**
  * A line is an infinitely long object with no width, depth, or curvature.
  */

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

@@ -15,7 +15,7 @@ type ExportOpts = {
     };
 };
 export declare const exportToCanvas: ({ elements, appState, files, maxWidthOrHeight, getDimensions, exportPadding, exportingFrame, }: ExportOpts & {
-    exportPadding?: number | undefined;
+    exportPadding?: number;
 }) => Promise<HTMLCanvasElement>;
 export declare const exportToBlob: (opts: ExportOpts & {
     mimeType?: string;
@@ -23,10 +23,10 @@ export declare const exportToBlob: (opts: ExportOpts & {
     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;
+    exportPadding?: number;
+    renderEmbeddables?: boolean;
+    skipInliningFonts?: true;
+    reuseImages?: boolean;
 }) => Promise<SVGSVGElement>;
 export declare const exportToClipboard: (opts: ExportOpts & {
     mimeType?: string;

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

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

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

@@ -46,13 +46,13 @@ export declare const getClosedCurveShape: <Point extends GlobalPoint | LocalPoin
  * @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>) => {
+export declare const segmentIntersectRectangleElement: <Point extends LocalPoint | GlobalPoint>(element: ExcalidrawBindableElement, segment: LineSegment<Point>, gap?: number) => Point[];
+export declare const pointOnEllipse: <Point extends LocalPoint | GlobalPoint>(point: Point, ellipse: Ellipse<Point>, threshold?: number) => boolean;
+export declare const pointInEllipse: <Point extends LocalPoint | GlobalPoint>(p: Point, ellipse: Ellipse<Point>) => boolean;
+export declare const ellipseAxes: <Point extends LocalPoint | GlobalPoint>(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 declare const ellipseFocusToCenter: <Point extends LocalPoint | GlobalPoint>(ellipse: Ellipse<Point>) => number;
+export declare const ellipseExtremes: <Point extends LocalPoint | GlobalPoint>(ellipse: Ellipse<Point>) => import("@excalidraw/math").Vector[];
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excalidraw/element",
-  "version": "0.18.0-200a6bd94",
+  "version": "0.18.0-2a82821",
   "type": "module",
   "types": "./dist/types/element/src/index.d.ts",
   "main": "./dist/prod/index.js",
@@ -17,6 +17,12 @@
       "development": "./dist/dev/index.js",
       "production": "./dist/prod/index.js",
       "default": "./dist/prod/index.js"
+    },
+    "./visualdebug": {
+      "types": "./dist/types/element/src/visualdebug.d.ts",
+      "development": "./dist/dev/visualdebug.js",
+      "production": "./dist/prod/visualdebug.js",
+      "default": "./dist/prod/visualdebug.js"
     }
   },
   "files": [
@@ -57,7 +63,8 @@
     "build:esm": "rimraf dist && node ../../scripts/buildBase.js && yarn gen:types"
   },
   "dependencies": {
-    "@excalidraw/common": "0.18.0-200a6bd94",
-    "@excalidraw/math": "0.18.0-200a6bd94"
+    "@excalidraw/common": "0.18.0-2a82821",
+    "@excalidraw/math": "0.18.0-2a82821",
+    "@excalidraw/fractional-indexing": "0.18.0-2a82821"
   }
 }

package/dist/types/excalidraw/animation-frame-handler.d.ts

@@ -1,16 +0,0 @@
-export type AnimationCallback = (timestamp: number) => void | boolean;
-export type AnimationTarget = {
-    callback: AnimationCallback;
-    stopped: boolean;
-};
-export declare class AnimationFrameHandler {
-    private targets;
-    private rafIds;
-    register(key: object, callback: AnimationCallback): void;
-    start(key: object): void;
-    stop(key: object): void;
-    private constructFrame;
-    private scheduleFrame;
-    private cancelFrame;
-    private onFrame;
-}

package/dist/types/excalidraw/charts.d.ts

@@ -1,27 +0,0 @@
-import type { NonDeletedExcalidrawElement } from "@excalidraw/element/types";
-export type ChartElements = readonly NonDeletedExcalidrawElement[];
-export interface Spreadsheet {
-    title: string | null;
-    labels: string[] | null;
-    values: number[];
-}
-export declare const NOT_SPREADSHEET = "NOT_SPREADSHEET";
-export declare const VALID_SPREADSHEET = "VALID_SPREADSHEET";
-type ParseSpreadsheetResult = {
-    type: typeof NOT_SPREADSHEET;
-    reason: string;
-} | {
-    type: typeof VALID_SPREADSHEET;
-    spreadsheet: Spreadsheet;
-};
-/**
- * @private exported for testing
- */
-export declare const tryParseNumber: (s: string) => number | null;
-/**
- * @private exported for testing
- */
-export declare const tryParseCells: (cells: string[][]) => ParseSpreadsheetResult;
-export declare const tryParseSpreadsheet: (text: string) => ParseSpreadsheetResult;
-export declare const renderSpreadsheet: (chartType: string, spreadsheet: Spreadsheet, x: number, y: number) => ChartElements;
-export {};

package/dist/types/excalidraw/components/DiagramToCodePlugin/DiagramToCodePlugin.d.ts

@@ -1,4 +0,0 @@
-import type { GenerateDiagramToCode } from "../../types";
-export declare const DiagramToCodePlugin: (props: {
-    generate: GenerateDiagramToCode;
-}) => null;

package/dist/types/excalidraw/components/ExcalidrawLogo.d.ts

@@ -1,16 +0,0 @@
-/// <reference types="react" />
-import "./ExcalidrawLogo.scss";
-type LogoSize = "xs" | "small" | "normal" | "large" | "custom";
-interface LogoProps {
-    size?: LogoSize;
-    withText?: boolean;
-    style?: React.CSSProperties;
-    /**
-     * If true, the logo will not be wrapped in a Link component.
-     * The link prop will be ignored as well.
-     * It will merely be a plain div.
-     */
-    isNotLink?: boolean;
-}
-export declare const ExcalidrawLogo: ({ style, size, withText, }: LogoProps) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/types/excalidraw/components/InitializeApp.d.ts

@@ -1,10 +0,0 @@
-import React from "react";
-import type { Theme } from "@excalidraw/element/types";
-import type { Language } from "../i18n";
-interface Props {
-    langCode: Language["code"];
-    children: React.ReactElement;
-    theme?: Theme;
-}
-export declare const InitializeApp: (props: Props) => import("react/jsx-runtime").JSX.Element;
-export {};

package/dist/types/excalidraw/components/TTDDialog/TTDDialogTrigger.d.ts

@@ -1,9 +0,0 @@
-import type { ReactNode } from "react";
-import type { JSX } from "react";
-export declare const TTDDialogTrigger: {
-    ({ children, icon, }: {
-        children?: ReactNode;
-        icon?: JSX.Element | undefined;
-    }): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};

package/dist/types/excalidraw/components/footer/FooterCenter.d.ts

@@ -1,8 +0,0 @@
-import "./FooterCenter.scss";
-declare const FooterCenter: {
-    ({ children }: {
-        children?: React.ReactNode;
-    }): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
-export default FooterCenter;

package/dist/types/excalidraw/components/live-collaboration/LiveCollaborationTrigger.d.ts

@@ -1,10 +0,0 @@
-/// <reference types="react" />
-import "./LiveCollaborationTrigger.scss";
-declare const LiveCollaborationTrigger: {
-    ({ isCollaborating, onSelect, ...rest }: {
-        isCollaborating: boolean;
-        onSelect: () => void;
-    } & import("react").ButtonHTMLAttributes<HTMLButtonElement>): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
-export default LiveCollaborationTrigger;

package/dist/types/excalidraw/components/welcome-screen/WelcomeScreen.Center.d.ts

@@ -1,58 +0,0 @@
-import type { JSX } from "react";
-declare const Center: {
-    ({ children }: {
-        children?: React.ReactNode;
-    }): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-    Logo: {
-        ({ children }: {
-            children?: React.ReactNode;
-        }): import("react/jsx-runtime").JSX.Element;
-        displayName: string;
-    };
-    Heading: {
-        ({ children }: {
-            children: React.ReactNode;
-        }): import("react/jsx-runtime").JSX.Element;
-        displayName: string;
-    };
-    Menu: {
-        ({ children }: {
-            children?: React.ReactNode;
-        }): import("react/jsx-runtime").JSX.Element;
-        displayName: string;
-    };
-    MenuItem: {
-        ({ onSelect, children, icon, shortcut, className, ...props }: {
-            onSelect: () => void;
-            children: React.ReactNode;
-            icon?: JSX.Element | undefined;
-            shortcut?: string | null | undefined;
-        } & import("react").ButtonHTMLAttributes<HTMLButtonElement>): import("react/jsx-runtime").JSX.Element;
-        displayName: string;
-    };
-    MenuItemLink: {
-        ({ children, href, icon, shortcut, className, ...props }: {
-            children: React.ReactNode;
-            href: string;
-            icon?: JSX.Element | undefined;
-            shortcut?: string | null | undefined;
-        } & import("react").AnchorHTMLAttributes<HTMLAnchorElement>): import("react/jsx-runtime").JSX.Element;
-        displayName: string;
-    };
-    MenuItemHelp: {
-        (): import("react/jsx-runtime").JSX.Element;
-        displayName: string;
-    };
-    MenuItemLoadScene: {
-        (): import("react/jsx-runtime").JSX.Element | null;
-        displayName: string;
-    };
-    MenuItemLiveCollaborationTrigger: {
-        ({ onSelect, }: {
-            onSelect: () => any;
-        }): import("react/jsx-runtime").JSX.Element;
-        displayName: string;
-    };
-};
-export { Center };

package/dist/types/excalidraw/components/welcome-screen/WelcomeScreen.Hints.d.ts

@@ -1,19 +0,0 @@
-declare const MenuHint: {
-    ({ children }: {
-        children?: React.ReactNode;
-    }): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
-declare const ToolbarHint: {
-    ({ children }: {
-        children?: React.ReactNode;
-    }): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
-declare const HelpHint: {
-    ({ children }: {
-        children?: React.ReactNode;
-    }): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-};
-export { HelpHint, MenuHint, ToolbarHint };

package/dist/types/excalidraw/components/welcome-screen/WelcomeScreen.d.ts

@@ -1,85 +0,0 @@
-/// <reference types="react" />
-import "./WelcomeScreen.scss";
-declare const WelcomeScreen: {
-    (props: {
-        children?: React.ReactNode;
-    }): import("react/jsx-runtime").JSX.Element;
-    displayName: string;
-    Center: {
-        ({ children }: {
-            children?: import("react").ReactNode;
-        }): import("react/jsx-runtime").JSX.Element;
-        displayName: string;
-        Logo: {
-            ({ children }: {
-                children?: import("react").ReactNode;
-            }): import("react/jsx-runtime").JSX.Element;
-            displayName: string;
-        };
-        Heading: {
-            ({ children }: {
-                children: import("react").ReactNode;
-            }): import("react/jsx-runtime").JSX.Element;
-            displayName: string;
-        };
-        Menu: {
-            ({ children }: {
-                children?: import("react").ReactNode;
-            }): import("react/jsx-runtime").JSX.Element;
-            displayName: string;
-        };
-        MenuItem: {
-            ({ onSelect, children, icon, shortcut, className, ...props }: {
-                onSelect: () => void;
-                children: import("react").ReactNode;
-                icon?: import("react").JSX.Element | undefined;
-                shortcut?: string | null | undefined;
-            } & import("react").ButtonHTMLAttributes<HTMLButtonElement>): import("react/jsx-runtime").JSX.Element;
-            displayName: string;
-        };
-        MenuItemLink: {
-            ({ children, href, icon, shortcut, className, ...props }: {
-                children: import("react").ReactNode;
-                href: string;
-                icon?: import("react").JSX.Element | undefined;
-                shortcut?: string | null | undefined;
-            } & import("react").AnchorHTMLAttributes<HTMLAnchorElement>): import("react/jsx-runtime").JSX.Element;
-            displayName: string;
-        };
-        MenuItemHelp: {
-            (): import("react/jsx-runtime").JSX.Element;
-            displayName: string;
-        };
-        MenuItemLoadScene: {
-            (): import("react/jsx-runtime").JSX.Element | null;
-            displayName: string;
-        };
-        MenuItemLiveCollaborationTrigger: {
-            ({ onSelect, }: {
-                onSelect: () => any;
-            }): import("react/jsx-runtime").JSX.Element;
-            displayName: string;
-        };
-    };
-    Hints: {
-        MenuHint: {
-            ({ children }: {
-                children?: import("react").ReactNode;
-            }): import("react/jsx-runtime").JSX.Element;
-            displayName: string;
-        };
-        ToolbarHint: {
-            ({ children }: {
-                children?: import("react").ReactNode;
-            }): import("react/jsx-runtime").JSX.Element;
-            displayName: string;
-        };
-        HelpHint: {
-            ({ children }: {
-                children?: import("react").ReactNode;
-            }): import("react/jsx-runtime").JSX.Element;
-            displayName: string;
-        };
-    };
-};
-export default WelcomeScreen;

package/dist/types/excalidraw/data/reconcile.d.ts

@@ -1,7 +0,0 @@
-import type { OrderedExcalidrawElement } from "@excalidraw/element/types";
-import type { MakeBrand } from "@excalidraw/common/utility-types";
-import type { AppState } from "../types";
-export type ReconciledExcalidrawElement = OrderedExcalidrawElement & MakeBrand<"ReconciledElement">;
-export type RemoteExcalidrawElement = OrderedExcalidrawElement & MakeBrand<"RemoteExcalidrawElement">;
-export declare const shouldDiscardRemoteElement: (localAppState: AppState, local: OrderedExcalidrawElement | undefined, remote: RemoteExcalidrawElement) => boolean;
-export declare const reconcileElements: (localElements: readonly OrderedExcalidrawElement[], remoteElements: readonly RemoteExcalidrawElement[], localAppState: AppState) => ReconciledExcalidrawElement[];

package/dist/types/excalidraw/index.d.ts

@@ -1,47 +0,0 @@
-import React from "react";
-import Footer from "./components/footer/FooterCenter";
-import LiveCollaborationTrigger from "./components/live-collaboration/LiveCollaborationTrigger";
-import MainMenu from "./components/main-menu/MainMenu";
-import WelcomeScreen from "./components/welcome-screen/WelcomeScreen";
-import "./css/app.scss";
-import "./css/styles.scss";
-import "./fonts/fonts.css";
-import type { ExcalidrawProps } from "./types";
-export declare const Excalidraw: React.MemoExoticComponent<(props: ExcalidrawProps) => import("react/jsx-runtime").JSX.Element>;
-export { getSceneVersion, hashElementsVersion, hashString, getNonDeletedElements, } from "@excalidraw/element";
-export { getTextFromElements } from "@excalidraw/element";
-export { isInvisiblySmallElement } from "@excalidraw/element";
-export { defaultLang, useI18n, languages } from "./i18n";
-export { restore, restoreAppState, restoreElements, restoreLibraryItems, } from "./data/restore";
-export { reconcileElements } from "./data/reconcile";
-export { exportToCanvas, exportToBlob, exportToSvg, exportToClipboard, } from "@excalidraw/utils/export";
-export { serializeAsJSON, serializeLibraryAsJSON } from "./data/json";
-export { loadFromBlob, loadSceneOrLibraryFromBlob, loadLibraryFromBlob, } from "./data/blob";
-export { getFreeDrawSvgPath } from "@excalidraw/element";
-export { mergeLibraryItems, getLibraryItemsHash } from "./data/library";
-export { isLinearElement } from "@excalidraw/element";
-export { FONT_FAMILY, THEME, MIME_TYPES, ROUNDNESS, DEFAULT_LASER_COLOR, UserIdleState, normalizeLink, } from "@excalidraw/common";
-export { mutateElement, newElementWith, bumpVersion, } from "@excalidraw/element";
-export { CaptureUpdateAction } from "@excalidraw/element";
-export { parseLibraryTokensFromUrl, useHandleLibrary } from "./data/library";
-export { sceneCoordsToViewportCoords, viewportCoordsToSceneCoords, } from "@excalidraw/common";
-export { Sidebar } from "./components/Sidebar/Sidebar";
-export { Button } from "./components/Button";
-export { Footer };
-export { MainMenu };
-export { Ellipsify } from "./components/Ellipsify";
-export { useDevice } from "./components/App";
-export { WelcomeScreen };
-export { LiveCollaborationTrigger };
-export { Stats } from "./components/Stats";
-export { DefaultSidebar } from "./components/DefaultSidebar";
-export { TTDDialog } from "./components/TTDDialog/TTDDialog";
-export { TTDDialogTrigger } from "./components/TTDDialog/TTDDialogTrigger";
-export { zoomToFitBounds } from "./actions/actionCanvas";
-export { convertToExcalidrawElements } from "./data/transform";
-export { getCommonBounds, getVisibleSceneBounds } from "@excalidraw/element";
-export { elementsOverlappingBBox, isElementInsideBBox, elementPartiallyOverlapsWithOrContainsBBox, } from "@excalidraw/utils/withinBounds";
-export { DiagramToCodePlugin } from "./components/DiagramToCodePlugin/DiagramToCodePlugin";
-export { getDataURL } from "./data/blob";
-export { isElementLink } from "@excalidraw/element";
-export { setCustomTextMetricsProvider } from "@excalidraw/element";

package/dist/types/excalidraw/polyfill.d.ts

@@ -1,2 +0,0 @@
-declare const polyfill: () => void;
-export default polyfill;

package/dist/types/utils/src/bbox.d.ts

@@ -1,9 +0,0 @@
-import { type GlobalPoint, type LocalPoint } from "@excalidraw/math";
-import type { Bounds } from "@excalidraw/element";
-export type LineSegment<P extends LocalPoint | GlobalPoint> = [P, P];
-export declare function getBBox<P extends LocalPoint | GlobalPoint>(line: LineSegment<P>): Bounds;
-export declare function doBBoxesIntersect(a: Bounds, b: Bounds): boolean;
-export declare function isPointOnLine<P extends GlobalPoint | LocalPoint>(l: LineSegment<P>, p: P): boolean;
-export declare function isPointRightOfLine<P extends GlobalPoint | LocalPoint>(l: LineSegment<P>, p: P): boolean;
-export declare function isLineSegmentTouchingOrCrossingLine<P extends GlobalPoint | LocalPoint>(a: LineSegment<P>, b: LineSegment<P>): boolean;
-export declare function doLineSegmentsIntersect<P extends GlobalPoint | LocalPoint>(a: LineSegment<P>, b: LineSegment<P>): boolean;

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

@@ -1,19 +0,0 @@
-import type { Bounds } from "@excalidraw/element";
-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 {};