@dwelle/excalidraw 0.4.0-e1bdbb6 → 0.4.0-e587816

package/types/utils.d.ts

@@ -1,13 +1,13 @@
 import { EVENT } from "./constants";
-import { FontFamilyValues, FontString } from "./element/types";
-import { AppState, LastActiveToolBeforeEraser, Zoom } from "./types";
-import { SHAPES } from "./shapes";
+import { FontFamilyValues, FontString, NonDeletedExcalidrawElement } from "./element/types";
+import { ActiveTool, AppState, ToolType, Zoom } from "./types";
 export declare const setDateTimeForTests: (dateTime: string) => void;
 export declare const getDateTime: () => string;
 export declare const capitalizeString: (str: string) => string;
 export declare const isToolIcon: (target: Element | EventTarget | null) => target is HTMLElement;
-export declare const isInputLike: (target: Element | EventTarget | null) => target is HTMLBRElement | HTMLDivElement | HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
-export declare const isWritableElement: (target: Element | EventTarget | null) => target is HTMLBRElement | HTMLDivElement | HTMLInputElement | HTMLTextAreaElement;
+export declare const isInputLike: (target: Element | EventTarget | null) => target is HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | HTMLBRElement | HTMLDivElement;
+export declare const isInteractive: (target: Element | EventTarget | null) => boolean;
+export declare const isWritableElement: (target: Element | EventTarget | null) => target is HTMLInputElement | HTMLTextAreaElement | HTMLBRElement | HTMLDivElement;
 export declare const getFontFamilyString: ({ fontFamily, }: {
     fontFamily: FontFamilyValues;
 }) => string;
@@ -28,22 +28,67 @@ export declare const throttleRAF: <T extends any[]>(fn: (...args: T) => void, op
     flush(): void;
     cancel(): void;
 };
+/**
+ * Exponential ease-out method
+ *
+ * @param {number} k - The value to be tweened.
+ * @returns {number} The tweened value.
+ */
+export declare const easeOut: (k: number) => number;
+/**
+ * Animates values from `fromValues` to `toValues` using the requestAnimationFrame API.
+ * Executes the `onStep` callback on each step with the interpolated values.
+ * Returns a function that can be called to cancel the animation.
+ *
+ * @example
+ * // Example usage:
+ * const fromValues = { x: 0, y: 0 };
+ * const toValues = { x: 100, y: 200 };
+ * const onStep = ({x, y}) => {
+ *   setState(x, y)
+ * };
+ * const onCancel = () => {
+ *   console.log("Animation canceled");
+ * };
+ *
+ * const cancelAnimation = easeToValuesRAF({
+ *   fromValues,
+ *   toValues,
+ *   onStep,
+ *   onCancel,
+ * });
+ *
+ * // To cancel the animation:
+ * cancelAnimation();
+ */
+export declare const easeToValuesRAF: <T extends Record<keyof T, number>, K extends keyof T>({ fromValues, toValues, onStep, duration, interpolateValue, onStart, onEnd, onCancel, }: {
+    fromValues: T;
+    toValues: T;
+    /**
+     * Interpolate a single value.
+     * Return undefined to be handled by the default interpolator.
+     */
+    interpolateValue?: ((fromValue: number, toValue: number, progress: number, key: K) => number | undefined) | undefined;
+    onStep: (values: T) => void;
+    duration?: number | undefined;
+    onStart?: (() => void) | undefined;
+    onEnd?: (() => void) | undefined;
+    onCancel?: (() => void) | undefined;
+}) => () => void;
 export declare const chunk: <T extends unknown>(array: readonly T[], size: number) => T[][];
 export declare const selectNode: (node: Element) => void;
 export declare const removeSelection: () => void;
 export declare const distance: (x: number, y: number) => number;
-export declare const updateActiveTool: (appState: Pick<AppState, "activeTool">, data: ({
-    type: (typeof SHAPES)[number]["value"] | "eraser";
+export declare const updateActiveTool: (appState: Pick<AppState, "activeTool">, data: (({
+    type: ToolType;
 } | {
     type: "custom";
     customType: string;
 }) & {
-    lastActiveToolBeforeEraser?: LastActiveToolBeforeEraser;
+    locked?: boolean;
+}) & {
+    lastActiveToolBeforeEraser?: ActiveTool | null;
 }) => AppState["activeTool"];
-export declare const resetCursor: (canvas: HTMLCanvasElement | null) => void;
-export declare const setCursor: (canvas: HTMLCanvasElement | null, cursor: string) => void;
-export declare const setEraserCursor: (canvas: HTMLCanvasElement | null, theme: AppState["theme"]) => void;
-export declare const setCursorForShape: (canvas: HTMLCanvasElement | null, appState: AppState) => void;
 export declare const isFullScreen: () => boolean;
 export declare const allowFullScreen: () => Promise<void>;
 export declare const exitFullScreen: () => Promise<void>;
@@ -91,7 +136,7 @@ export declare const muteFSAbortError: (error?: Error) => void;
 export declare const findIndex: <T>(array: readonly T[], cb: (element: T, index: number, array: readonly T[]) => boolean, fromIndex?: number) => number;
 export declare const findLastIndex: <T>(array: readonly T[], cb: (element: T, index: number, array: readonly T[]) => boolean, fromIndex?: number) => number;
 export declare const isTransparent: (color: string) => boolean;
-export declare type ResolvablePromise<T> = Promise<T> & {
+export type ResolvablePromise<T> = Promise<T> & {
     resolve: [T] extends [undefined] ? (value?: T) => void : (value: T) => void;
     reject: (error: Error) => void;
 };
@@ -124,13 +169,29 @@ export declare const getUpdatedTimestamp: () => number;
 export declare const arrayToMap: <T extends string | {
     id: string;
 }>(items: readonly T[]) => Map<string, T>;
+export declare const arrayToMapWithIndex: <T extends {
+    id: string;
+}>(elements: readonly T[]) => Map<string, [element: T, index: number]>;
 export declare const isTestEnv: () => boolean;
-export declare const isProdEnv: () => boolean;
 export declare const wrapEvent: <T extends Event>(name: EVENT, nativeEvent: T) => CustomEvent<{
     nativeEvent: T;
 }>;
 export declare const updateObject: <T extends Record<string, any>>(obj: T, updates: Partial<T>) => T;
 export declare const isPrimitive: (val: any) => boolean;
 export declare const getFrame: () => "top" | "iframe";
+export declare const isRunningInIframe: () => boolean;
 export declare const isPromiseLike: (value: any) => value is Promise<any>;
 export declare const queryFocusableElements: (container: HTMLElement | null) => HTMLElement[];
+export declare const isShallowEqual: <T extends Record<string, any>, I extends keyof T>(objA: T, objB: T, comparators?: Record<I, (a: T[I], b: T[I]) => boolean> | undefined, debug?: boolean) => boolean;
+export declare const composeEventHandlers: <E>(originalEventHandler?: ((event: E) => void) | undefined, ourEventHandler?: ((event: E) => void) | undefined, { checkForDefaultPrevented }?: {
+    checkForDefaultPrevented?: boolean | undefined;
+}) => (event: E) => void;
+export declare const isOnlyExportingSingleFrame: (elements: readonly NonDeletedExcalidrawElement[]) => boolean;
+export declare const assertNever: (value: never, message: string, softAssert?: boolean) => never;
+/**
+ * Memoizes on values of `opts` object (strict equality).
+ */
+export declare const memoize: <T extends Record<string, any>, R extends unknown>(func: (opts: T) => R) => ((opts: T) => R) & {
+    clear: () => void;
+};
+export declare const isRenderThrottlingEnabled: () => boolean;

package/types/zindex.d.ts

@@ -1,6 +1,6 @@
 import { ExcalidrawElement } from "./element/types";
 import { AppState } from "./types";
-export declare const moveOneLeft: (elements: readonly ExcalidrawElement[], appState: AppState) => (import("./element/types").ExcalidrawLinearElement | import("./element/types").ExcalidrawSelectionElement | import("./element/types").ExcalidrawRectangleElement | import("./element/types").ExcalidrawDiamondElement | import("./element/types").ExcalidrawEllipseElement | import("./element/types").ExcalidrawImageElement | import("./element/types").ExcalidrawTextElement | import("./element/types").ExcalidrawFreeDrawElement)[];
-export declare const moveOneRight: (elements: readonly ExcalidrawElement[], appState: AppState) => (import("./element/types").ExcalidrawLinearElement | import("./element/types").ExcalidrawSelectionElement | import("./element/types").ExcalidrawRectangleElement | import("./element/types").ExcalidrawDiamondElement | import("./element/types").ExcalidrawEllipseElement | import("./element/types").ExcalidrawImageElement | import("./element/types").ExcalidrawTextElement | import("./element/types").ExcalidrawFreeDrawElement)[];
-export declare const moveAllLeft: (elements: readonly ExcalidrawElement[], appState: AppState) => readonly ExcalidrawElement[];
-export declare const moveAllRight: (elements: readonly ExcalidrawElement[], appState: AppState) => readonly ExcalidrawElement[];
+export declare const moveOneLeft: (allElements: readonly ExcalidrawElement[], appState: AppState) => ExcalidrawElement[];
+export declare const moveOneRight: (allElements: readonly ExcalidrawElement[], appState: AppState) => ExcalidrawElement[];
+export declare const moveAllLeft: (allElements: readonly ExcalidrawElement[], appState: AppState) => readonly ExcalidrawElement[] | ExcalidrawElement[];
+export declare const moveAllRight: (allElements: readonly ExcalidrawElement[], appState: AppState) => readonly ExcalidrawElement[] | ExcalidrawElement[];

package/types/components/ActiveFile.d.ts

@@ -1,7 +0,0 @@
-import "./ActiveFile.scss";
-declare type ActiveFileProps = {
-    fileName?: string;
-    onSave: () => void;
-};
-export declare const ActiveFile: ({ fileName, onSave }: ActiveFileProps) => JSX.Element;
-export {};

package/types/components/ClearCanvas.d.ts

@@ -1,4 +0,0 @@
-declare const ClearCanvas: ({ onConfirm }: {
-    onConfirm: () => void;
-}) => JSX.Element;
-export default ClearCanvas;

package/types/components/CollabButton.d.ts

@@ -1,6 +0,0 @@
-import "./CollabButton.scss";
-declare const CollabButton: ({ onClick, isInHamburgerMenu, }: {
-    onClick: () => void;
-    isInHamburgerMenu?: boolean | undefined;
-}) => JSX.Element;
-export default CollabButton;

package/types/components/ColorPicker.d.ts

@@ -1,14 +0,0 @@
-import "./ColorPicker.scss";
-import { ExcalidrawElement } from "../element/types";
-import { AppState } from "../types";
-export declare const getCustomColors: (elements: readonly ExcalidrawElement[], type: "elementBackground" | "elementStroke") => string[];
-export declare const ColorPicker: ({ type, color, onChange, label, isActive, setActive, elements, appState, }: {
-    type: "canvasBackground" | "elementBackground" | "elementStroke";
-    color: string | null;
-    onChange: (color: string) => void;
-    label: string;
-    isActive: boolean;
-    setActive: (active: boolean) => void;
-    elements: readonly ExcalidrawElement[];
-    appState: AppState;
-}) => JSX.Element;

package/types/components/Footer.d.ts

@@ -1,10 +0,0 @@
-import { ActionManager } from "../actions/manager";
-import { AppState, ExcalidrawProps } from "../types";
-declare const Footer: ({ appState, actionManager, renderCustomFooter, showExitZenModeBtn, renderWelcomeScreen, }: {
-    appState: AppState;
-    actionManager: ActionManager;
-    renderCustomFooter?: ExcalidrawProps["renderFooter"];
-    showExitZenModeBtn: boolean;
-    renderWelcomeScreen: boolean;
-}) => JSX.Element;
-export default Footer;

package/types/components/LibraryButton.d.ts

@@ -1,8 +0,0 @@
-import React from "react";
-import { AppState } from "../types";
-import "./LibraryButton.scss";
-export declare const LibraryButton: React.FC<{
-    appState: AppState;
-    setAppState: React.Component<any, AppState>["setState"];
-    isMobile?: boolean;
-}>;

package/types/components/MenuItem.d.ts

@@ -1,11 +0,0 @@
-import "./Menu.scss";
-interface MenuProps {
-    icon: JSX.Element;
-    onClick: () => void;
-    label: string;
-    dataTestId: string;
-    shortcut?: string;
-    isCollaborating?: boolean;
-}
-declare const MenuItem: ({ icon, onClick, label, dataTestId, shortcut, isCollaborating, }: MenuProps) => JSX.Element;
-export default MenuItem;

package/types/components/MenuUtils.d.ts

@@ -1 +0,0 @@
-export declare const Separator: () => JSX.Element;

package/types/components/SingleLibraryItem.d.ts

@@ -1,10 +0,0 @@
-import { AppState, LibraryItem } from "../types";
-import "./SingleLibraryItem.scss";
-declare const SingleLibraryItem: ({ libItem, appState, index, onChange, onRemove, }: {
-    libItem: LibraryItem;
-    appState: AppState;
-    index: number;
-    onChange: (val: string, index: number) => void;
-    onRemove: (id: string) => void;
-}) => JSX.Element;
-export default SingleLibraryItem;

package/types/components/WelcomeScreen.d.ts

@@ -1,10 +0,0 @@
-import { ActionManager } from "../actions/manager";
-import { AppState } from "../types";
-import { AppProps } from "../types";
-import "./WelcomeScreen.scss";
-declare const WelcomeScreen: ({ appState, actionManager, onCollabButtonClick, }: {
-    appState: AppState;
-    actionManager: ActionManager;
-    onCollabButtonClick: AppProps["onCollabButtonClick"];
-}) => JSX.Element;
-export default WelcomeScreen;

package/types/components/WelcomeScreenDecor.d.ts

@@ -1,6 +0,0 @@
-import { ReactNode } from "react";
-declare const WelcomeScreenDecor: ({ children, shouldRender, }: {
-    children: ReactNode;
-    shouldRender: boolean;
-}) => JSX.Element | null;
-export default WelcomeScreenDecor;

package/types/components/hoc/withUpstreamOverride.d.ts

@@ -1,10 +0,0 @@
-import React from "react";
-export declare const withUpstreamOverride: <P>(Component: React.ComponentType<P>) => readonly [React.FC<{
-    children: React.ReactNode;
-}>, {
-    (props: P & {
-        /** @private internal */
-        __isFallback?: boolean | undefined;
-    }): JSX.Element | null;
-    displayName: string;
-}];