@excalidraw/math 0.18.0-a8acc82 → 0.18.0-ab0255f

package/dist/types/excalidraw/components/hyperlink/helpers.d.ts

@@ -1,10 +1,10 @@
 import type { GlobalPoint, Radians } from "@excalidraw/math";
-import type { Bounds } from "@excalidraw/element";
+import type { Bounds } from "@excalidraw/common";
 import type { ElementsMap, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
-import type { AppState, UIAppState } from "../../types";
+import type { AppState } from "../../types";
 export declare const DEFAULT_LINK_SIZE = 12;
 export declare const EXTERNAL_LINK_IMG: HTMLImageElement;
 export declare const ELEMENT_LINK_IMG: HTMLImageElement;
-export declare const getLinkHandleFromCoords: ([x1, y1, x2, y2]: Bounds, angle: Radians, appState: Pick<UIAppState, "zoom">) => Bounds;
+export declare const getLinkHandleFromCoords: ([x1, y1, x2, y2]: Bounds, angle: Radians, appState: Pick<AppState, "zoom">) => Bounds;
 export declare const isPointHittingLinkIcon: (element: NonDeletedExcalidrawElement, elementsMap: ElementsMap, appState: AppState, [x, y]: GlobalPoint) => boolean;
 export declare const isPointHittingLink: (element: NonDeletedExcalidrawElement, elementsMap: ElementsMap, appState: AppState, [x, y]: GlobalPoint, isMobile: boolean) => boolean;

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

@@ -114,41 +114,54 @@ export declare const StrokeStyleDottedIcon: import("react/jsx-runtime").JSX.Elem
 export declare const SloppinessArchitectIcon: import("react/jsx-runtime").JSX.Element;
 export declare const SloppinessArtistIcon: import("react/jsx-runtime").JSX.Element;
 export declare const SloppinessCartoonistIcon: import("react/jsx-runtime").JSX.Element;
+export declare const strokeVariabilityConstantIcon: import("react/jsx-runtime").JSX.Element;
+export declare const strokeVariabilityVariableIcon: import("react/jsx-runtime").JSX.Element;
 export declare const EdgeSharpIcon: import("react/jsx-runtime").JSX.Element;
 export declare const EdgeRoundIcon: import("react/jsx-runtime").JSX.Element;
-export declare const ArrowheadNoneIcon: import("react/jsx-runtime").JSX.Element;
+export declare const ArrowheadNoneIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
+}) => import("react/jsx-runtime").JSX.Element>;
 export declare const ArrowheadArrowIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+    flip?: boolean;
+}) => import("react/jsx-runtime").JSX.Element>;
+export declare const ArrowheadTriangleIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
+}) => import("react/jsx-runtime").JSX.Element>;
+export declare const ArrowheadTriangleOutlineIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
 export declare const ArrowheadCircleIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
 export declare const ArrowheadCircleOutlineIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadBarIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+export declare const ArrowheadDiamondIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadTriangleIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+export declare const ArrowheadDiamondOutlineIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadTriangleOutlineIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+export declare const ArrowheadBarIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadDiamondIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+export declare const ArrowheadCardinalityOneIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadDiamondOutlineIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+export declare const ArrowheadCardinalityManyIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
+}) => import("react/jsx-runtime").JSX.Element>;
+export declare const ArrowheadCardinalityOneOrManyIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadCrowfootIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+export declare const ArrowheadCardinalityExactlyOneIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadCrowfootOneIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+export declare const ArrowheadCardinalityZeroOrOneIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
-export declare const ArrowheadCrowfootOneOrManyIcon: React.MemoExoticComponent<({ flip }: {
-    flip?: boolean | undefined;
+export declare const ArrowheadCardinalityZeroOrManyIcon: React.MemoExoticComponent<({ flip }: {
+    flip?: boolean;
 }) => import("react/jsx-runtime").JSX.Element>;
 export declare const FontSizeSmallIcon: import("react/jsx-runtime").JSX.Element;
 export declare const FontSizeMediumIcon: import("react/jsx-runtime").JSX.Element;
@@ -157,6 +170,7 @@ export declare const FontSizeExtraLargeIcon: import("react/jsx-runtime").JSX.Ele
 export declare const fontSizeIcon: import("react/jsx-runtime").JSX.Element;
 export declare const FontFamilyHeadingIcon: import("react/jsx-runtime").JSX.Element;
 export declare const FontFamilyNormalIcon: import("react/jsx-runtime").JSX.Element;
+export declare const codeIcon: import("react/jsx-runtime").JSX.Element;
 export declare const FontFamilyCodeIcon: import("react/jsx-runtime").JSX.Element;
 export declare const TextAlignLeftIcon: import("react/jsx-runtime").JSX.Element;
 export declare const TextAlignCenterIcon: import("react/jsx-runtime").JSX.Element;
@@ -183,10 +197,12 @@ export declare const playerStopFilledIcon: import("react/jsx-runtime").JSX.Eleme
 export declare const tablerCheckIcon: import("react/jsx-runtime").JSX.Element;
 export declare const alertTriangleIcon: import("react/jsx-runtime").JSX.Element;
 export declare const eyeDropperIcon: import("react/jsx-runtime").JSX.Element;
-export declare const extraToolsIcon: import("react/jsx-runtime").JSX.Element;
 export declare const frameToolIcon: import("react/jsx-runtime").JSX.Element;
 export declare const mermaidLogoIcon: import("react/jsx-runtime").JSX.Element;
+export declare const RetryIcon: import("react/jsx-runtime").JSX.Element;
+export declare const stackPushIcon: import("react/jsx-runtime").JSX.Element;
 export declare const ArrowRightIcon: import("react/jsx-runtime").JSX.Element;
+export declare const drawShapeToolIcon: import("react/jsx-runtime").JSX.Element;
 export declare const laserPointerToolIcon: import("react/jsx-runtime").JSX.Element;
 export declare const MagicIcon: import("react/jsx-runtime").JSX.Element;
 export declare const MagicIconThin: import("react/jsx-runtime").JSX.Element;
@@ -197,7 +213,8 @@ export declare const eyeClosedIcon: import("react/jsx-runtime").JSX.Element;
 export declare const brainIcon: import("react/jsx-runtime").JSX.Element;
 export declare const brainIconThin: import("react/jsx-runtime").JSX.Element;
 export declare const searchIcon: import("react/jsx-runtime").JSX.Element;
-export declare const clockIcon: import("react/jsx-runtime").JSX.Element;
+export declare const historyCommandIcon: import("react/jsx-runtime").JSX.Element;
+export declare const historyIcon: import("react/jsx-runtime").JSX.Element;
 export declare const microphoneIcon: import("react/jsx-runtime").JSX.Element;
 export declare const microphoneMutedIcon: import("react/jsx-runtime").JSX.Element;
 export declare const boltIcon: import("react/jsx-runtime").JSX.Element;
@@ -226,6 +243,13 @@ export declare const cropIcon: import("react/jsx-runtime").JSX.Element;
 export declare const elementLinkIcon: import("react/jsx-runtime").JSX.Element;
 export declare const resizeIcon: import("react/jsx-runtime").JSX.Element;
 export declare const adjustmentsIcon: import("react/jsx-runtime").JSX.Element;
-export declare const backgroundIcon: import("react/jsx-runtime").JSX.Element;
 export declare const strokeIcon: import("react/jsx-runtime").JSX.Element;
+export declare const pencilIcon: import("react/jsx-runtime").JSX.Element;
+export declare const chevronLeftIcon: import("react/jsx-runtime").JSX.Element;
+export declare const sidebarRightIcon: import("react/jsx-runtime").JSX.Element;
+export declare const messageCircleIcon: import("react/jsx-runtime").JSX.Element;
+export declare const presentationIcon: import("react/jsx-runtime").JSX.Element;
+export declare const emptyIcon: import("react/jsx-runtime").JSX.Element;
+export declare const chevronRight: import("react/jsx-runtime").JSX.Element;
+export declare const settingsIcon: import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/types/excalidraw/components/main-menu/DefaultItems.d.ts

@@ -35,11 +35,14 @@ export declare const ClearCanvas: {
 export declare const ToggleTheme: {
     (props: {
         allowSystemTheme: true;
+        /**
+         * Controls the theme of this UI component only.
+         * You should subscribe to `props.onThemeChange` and control the theme
+         * upstream.
+         */
         theme: Theme | "system";
-        onSelect: (theme: Theme | "system") => void;
     } | {
-        allowSystemTheme?: false | undefined;
-        onSelect?: ((theme: Theme) => void) | undefined;
+        allowSystemTheme: false;
     }): import("react/jsx-runtime").JSX.Element | null;
     displayName: string;
 };
@@ -62,3 +65,21 @@ export declare const LiveCollaborationTrigger: {
     }): import("react/jsx-runtime").JSX.Element;
     displayName: string;
 };
+export declare const PreferencesToggleGridModeItem: () => import("react/jsx-runtime").JSX.Element;
+export declare const PreferencesToggleZenModeItem: () => import("react/jsx-runtime").JSX.Element;
+export declare const Preferences: {
+    ({ children, additionalItems, }: {
+        children?: React.ReactNode;
+        additionalItems?: React.ReactNode;
+    }): import("react/jsx-runtime").JSX.Element;
+    ToggleToolLock: () => import("react/jsx-runtime").JSX.Element;
+    BoxSelectionMode: () => import("react/jsx-runtime").JSX.Element;
+    ToggleSnapMode: () => import("react/jsx-runtime").JSX.Element;
+    ToggleArrowBinding: () => import("react/jsx-runtime").JSX.Element;
+    ToggleMidpointSnapping: () => import("react/jsx-runtime").JSX.Element;
+    ToggleGridMode: () => import("react/jsx-runtime").JSX.Element;
+    ToggleZenMode: () => import("react/jsx-runtime").JSX.Element;
+    ToggleViewMode: () => import("react/jsx-runtime").JSX.Element | null;
+    ToggleElementProperties: () => import("react/jsx-runtime").JSX.Element;
+    displayName: string;
+};

package/dist/types/excalidraw/components/main-menu/MainMenu.d.ts

@@ -5,43 +5,25 @@ declare const MainMenu: React.FC<{
     /**
      * Called when any menu item is selected (clicked on).
      */
-    onSelect?: ((event: Event) => void) | undefined;
+    onSelect?: (event: Event) => void;
 } & {
-    __fallback?: boolean | undefined;
+    __fallback?: boolean;
 }> & {
     Trigger: {
         ({ className, children, onToggle, title, ...rest }: {
-            className?: string | undefined;
+            className?: string;
             children: React.ReactNode;
             onToggle: () => void;
-            title?: string | undefined;
+            title?: string;
         } & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onSelect">): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
     Item: {
-        ({ icon, value, order, children, shortcut, className, hovered, selected, textStyle, onSelect, onClick, ...rest }: {
-            icon?: React.JSX.Element | undefined;
-            value?: string | number | undefined;
-            order?: number | undefined;
-            onSelect?: ((event: Event) => void) | undefined;
-            children: React.ReactNode;
-            /**
-             * Called when any menu item is selected (clicked on).
-             */
-            shortcut?: string | undefined;
-            hovered?: boolean | undefined;
-            selected?: boolean | undefined;
-            textStyle?: React.CSSProperties | undefined;
-            className?: string | undefined;
-        } & Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, "onSelect">): import("react/jsx-runtime").JSX.Element;
+        ({ icon, badge, value, children, shortcut, className, selected, onSelect, ...rest }: import("../dropdownMenu/DropdownMenuItem").DropdownMenuItemProps): import("react/jsx-runtime").JSX.Element;
         displayName: string;
         Badge: {
             ({ type, children, }: {
-                type?: import("../../../common/src/utility-types").ValueOf<{
-                    readonly GREEN: "green";
-                    readonly RED: "red";
-                    readonly BLUE: "blue";
-                }> | undefined;
+                type?: import("@excalidraw/common/utility-types").ValueOf<typeof import("../dropdownMenu/DropdownMenuItem").DropDownMenuItemBadgeType>;
                 children: React.ReactNode;
             }): import("react/jsx-runtime").JSX.Element;
             displayName: string;
@@ -50,27 +32,27 @@ declare const MainMenu: React.FC<{
     ItemLink: {
         ({ icon, shortcut, href, children, onSelect, className, selected, rel, ...rest }: {
             href: string;
-            icon?: React.JSX.Element | undefined;
+            icon?: React.JSX.Element;
             children: React.ReactNode;
-            shortcut?: string | undefined;
-            className?: string | undefined;
-            selected?: boolean | undefined;
-            onSelect?: ((event: Event) => void) | undefined;
-            rel?: string | undefined;
+            shortcut?: string;
+            className?: string;
+            selected?: boolean;
+            onSelect?: (event: Event) => void;
+            rel?: string;
         } & React.AnchorHTMLAttributes<HTMLAnchorElement>): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
     ItemCustom: ({ children, className, selected, ...rest }: {
         children: React.ReactNode;
-        className?: string | undefined;
-        selected?: boolean | undefined;
+        className?: string;
+        selected?: boolean;
     } & React.HTMLAttributes<HTMLDivElement>) => import("react/jsx-runtime").JSX.Element;
     Group: {
         ({ children, className, style, title, }: {
             children: React.ReactNode;
-            className?: string | undefined;
-            style?: React.CSSProperties | undefined;
-            title?: string | undefined;
+            className?: string;
+            style?: React.CSSProperties;
+            title?: string;
         }): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
@@ -78,6 +60,28 @@ declare const MainMenu: React.FC<{
         (): import("react/jsx-runtime").JSX.Element;
         displayName: string;
     };
+    Sub: {
+        ({ children }: {
+            children?: React.ReactNode;
+        }): import("react/jsx-runtime").JSX.Element;
+        Trigger: {
+            ({ children, icon, shortcut, className, }: {
+                children: React.ReactNode;
+                icon?: React.JSX.Element;
+                shortcut?: string;
+                className?: string;
+            }): import("react/jsx-runtime").JSX.Element;
+            displayName: string;
+        };
+        Content: {
+            ({ children, className, }: {
+                children?: React.ReactNode;
+                className?: string;
+            }): import("react/jsx-runtime").JSX.Element;
+            displayName: string;
+        };
+        displayName: string;
+    };
     DefaultItems: typeof DefaultItems;
 };
 export default MainMenu;

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

@@ -0,0 +1,26 @@
+/**
+ * Positions an element beside a cursor within a container, flipping the
+ * element to the other side of the cursor when it would overflow the
+ * container, resolved independently on each axis.
+ *
+ * Takes the cursor in client (viewport) coordinates and returns
+ * container-local coordinates.
+ */
+export declare const positionElementBesideCursor: ({ cursor, element, container, gap, }: {
+    /** client (viewport) coordinates */
+    cursor: {
+        x: number;
+        y: number;
+    };
+    element: {
+        width: number;
+        height: number;
+    };
+    /** the container's bounding client rect */
+    container: Pick<DOMRect, "left" | "top" | "width" | "height">;
+    /** distance between the cursor and the positioned element */
+    gap: number;
+}) => {
+    left: number;
+    top: number;
+};

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

@@ -0,0 +1,39 @@
+import type { ExcalidrawElement, NonDeletedElementsMap, NonDeletedSceneElementsMap } from "@excalidraw/element/types";
+import type { AppClassProperties, UIAppState } from "../types";
+export declare const canChangeStrokeColor: (appState: UIAppState, targetElements: ExcalidrawElement[]) => boolean;
+export declare const canChangeBackgroundColor: (appState: UIAppState, targetElements: ExcalidrawElement[]) => boolean;
+/**
+ * Single source of truth for "which shape-action controls are relevant right
+ * now". Each flag answers whether a given control should be shown, given the
+ * active tool and the current selection. All three styles-panel layouts
+ * (full / compact / mobile) and the compact popovers consume these flags so
+ * that visibility logic lives in one place and layout stays pure.
+ */
+export declare const getShapeActionPredicates: (appState: UIAppState, targetElements: ExcalidrawElement[], elementsMap: NonDeletedElementsMap | NonDeletedSceneElementsMap, app: AppClassProperties) => {
+    /** some element(s) selected */
+    hasSelection: boolean;
+    /** actions on selected elements (delete/duplicate/...) */
+    showExtraActions: boolean;
+    strokeColor: boolean;
+    backgroundColor: boolean;
+    fill: boolean;
+    strokeWidth: boolean;
+    freedrawMode: boolean;
+    strokeStyle: boolean;
+    sloppiness: boolean;
+    roundness: boolean;
+    arrowType: boolean;
+    arrowheads: boolean;
+    text: boolean;
+    textAlign: boolean;
+    verticalAlign: boolean;
+    opacity: boolean;
+    layers: boolean;
+    align: boolean;
+    distribute: boolean;
+    link: boolean;
+    linkSingleOnly: boolean;
+    cropEditor: boolean;
+    lineEditor: boolean;
+};
+export type ShapeActionPredicates = ReturnType<typeof getShapeActionPredicates>;