Skip to content

Virtual whiteboard for sketching hand-drawn like diagrams

perf: use `UIAppState` where possible to reduce UI rerenders (#6560)

David Luzar560231d36595
diff --git a/src/components/Actions.tsx b/src/components/Actions.tsx
index 3bbc0ff1a6..875d8447ca 100644
--- a/src/components/Actions.tsx
+++ b/src/components/Actions.tsx
@@ -14,7 +14,7 @@ import {
hasText,
} from "../scene";
import { SHAPES } from "../shapes";
-import { AppState, Zoom } from "../types";
+import { UIAppState, Zoom } from "../types";
import {
capitalizeString,
isTransparent,
@@ -28,19 +28,20 @@ import { trackEvent } from "../analytics";
import { hasBoundTextElement } from "../element/typeChecks";
import clsx from "clsx";
import { actionToggleZenMode } from "../actions";
-import "./Actions.scss";
import { Tooltip } from "./Tooltip";
import {
shouldAllowVerticalAlign,
suppportsHorizontalAlign,
} from "../element/textElement";
+import "./Actions.scss";
+
export const SelectedShapeActions = ({
appState,
elements,
renderAction,
}: {
- appState: AppState;
+ appState: UIAppState;
elements: readonly ExcalidrawElement[];
renderAction: ActionManager["renderAction"];
}) => {
@@ -215,10 +216,10 @@ export const ShapesSwitcher = ({
appState,
}: {
canvas: HTMLCanvasElement | null;
- activeTool: AppState["activeTool"];
- setAppState: React.Component<any, AppState>["setState"];
+ activeTool: UIAppState["activeTool"];
+ setAppState: React.Component<any, UIAppState>["setState"];
onImageAction: (data: { pointerType: PointerType | null }) => void;
- appState: AppState;
+ appState: UIAppState;
}) => (
<>
{SHAPES.map(({ value, icon, key, numericKey, fillable }, index) => {
diff --git a/src/components/HintViewer.tsx b/src/components/HintViewer.tsx
index a193754d22..a1b6308f4a 100644
--- a/src/components/HintViewer.tsx
+++ b/src/components/HintViewer.tsx
@@ -1,9 +1,7 @@
import { t } from "../i18n";
import { NonDeletedExcalidrawElement } from "../element/types";
import { getSelectedElements } from "../scene";
-
-import "./HintViewer.scss";
-import { AppState, Device } from "../types";
+import { Device, UIAppState } from "../types";
import {
isImageElement,
isLinearElement,
@@ -13,8 +11,10 @@ import {
import { getShortcutKey } from "../utils";
import { isEraserActive } from "../appState";
+import "./HintViewer.scss";
+
interface HintViewerProps {
- appState: AppState;
+ appState: UIAppState;
elements: readonly NonDeletedExcalidrawElement[];
isMobile: boolean;
device: Device;
diff --git a/src/components/ImageExportDialog.tsx b/src/components/ImageExportDialog.tsx
index 0e4eff3657..3f8a9679f4 100644
--- a/src/components/ImageExportDialog.tsx
+++ b/src/components/ImageExportDialog.tsx
@@ -4,11 +4,10 @@ import { canvasToBlob } from "../data/blob";
import { NonDeletedExcalidrawElement } from "../element/types";
import { t } from "../i18n";
import { getSelectedElements, isSomeElementSelected } from "../scene";
-import { AppState, BinaryFiles } from "../types";
+import { BinaryFiles, UIAppState } from "../types";
import { Dialog } from "./Dialog";
import { clipboard } from "./icons";
import Stack from "./Stack";
-import "./ExportDialog.scss";
import OpenColor from "open-color";
import { CheckboxItem } from "./CheckboxItem";
import { DEFAULT_EXPORT_PADDING, isFirefox } from "../constants";
@@ -16,6 +15,8 @@ import { nativeFileSystemSupported } from "../data/filesystem";
import { ActionManager } from "../actions/manager";
import { exportToCanvas } from "../packages/utils";
+import "./ExportDialog.scss";
+
const supportsContextFilters =
"filter" in document.createElement("canvas").getContext("2d")!;
@@ -70,7 +71,7 @@ const ImageExportModal = ({
onExportToSvg,
onExportToClipboard,
}: {
- appState: AppState;
+ appState: UIAppState;
elements: readonly NonDeletedExcalidrawElement[];
files: BinaryFiles;
exportPadding?: number;
@@ -216,8 +217,8 @@ export const ImageExportDialog = ({
onExportToSvg,
onExportToClipboard,
}: {
- appState: AppState;
- setAppState: React.Component<any, AppState>["setState"];
+ appState: UIAppState;
+ setAppState: React.Component<any, UIAppState>["setState"];
elements: readonly NonDeletedExcalidrawElement[];
files: BinaryFiles;
exportPadding?: number;
diff --git a/src/components/JSONExportDialog.tsx b/src/components/JSONExportDialog.tsx
index 8f89ebcb73..f40ebe4532 100644
--- a/src/components/JSONExportDialog.tsx
+++ b/src/components/JSONExportDialog.tsx
@@ -2,7 +2,7 @@ import React from "react";
import { NonDeletedExcalidrawElement } from "../element/types";
import { t } from "../i18n";
-import { AppState, ExportOpts, BinaryFiles } from "../types";
+import { ExportOpts, BinaryFiles, UIAppState } from "../types";
import { Dialog } from "./Dialog";
import { exportToFileIcon, LinkIcon } from "./icons";
import { ToolButton } from "./ToolButton";
@@ -28,7 +28,7 @@ const JSONExportModal = ({
exportOpts,
canvas,
}: {
- appState: AppState;
+ appState: UIAppState;
files: BinaryFiles;
elements: readonly NonDeletedExcalidrawElement[];
actionManager: ActionManager;
@@ -96,12 +96,12 @@ export const JSONExportDialog = ({
setAppState,
}: {
elements: readonly NonDeletedExcalidrawElement[];
- appState: AppState;
+ appState: UIAppState;
files: BinaryFiles;
actionManager: ActionManager;
exportOpts: ExportOpts;
canvas: HTMLCanvasElement | null;
- setAppState: React.Component<any, AppState>["setState"];
+ setAppState: React.Component<any, UIAppState>["setState"];
}) => {
const handleClose = React.useCallback(() => {
setAppState({ openDialog: null });
diff --git a/src/components/LayerUI.tsx b/src/components/LayerUI.tsx
index 6ae01d6a15..0e08eafa88 100644
--- a/src/components/LayerUI.tsx
+++ b/src/components/LayerUI.tsx
@@ -8,7 +8,13 @@ import { NonDeletedExcalidrawElement } from "../element/types";
import { Language, t } from "../i18n";
import { calculateScrollCenter } from "../scene";
import { ExportType } from "../scene/types";
-import { AppProps, AppState, ExcalidrawProps, BinaryFiles } from "../types";
+import {
+ AppProps,
+ AppState,
+ ExcalidrawProps,
+ BinaryFiles,
+ UIAppState,
+} from "../types";
import { capitalizeString, isShallowEqual, muteFSAbortError } from "../utils";
import { SelectedShapeActions, ShapesSwitcher } from "./Actions";
import { ErrorDialog } from "./ErrorDialog";
@@ -49,7 +55,7 @@ import "./Toolbar.scss";
interface LayerUIProps {
actionManager: ActionManager;
- appState: AppState;
+ appState: UIAppState;
files: BinaryFiles;
canvas: HTMLCanvasElement | null;
setAppState: React.Component<any, AppState>["setState"];
@@ -144,7 +150,8 @@ const LayerUI = ({
const fileHandle = await exportCanvas(
type,
exportedElements,
- appState,
+ // FIXME once we split UI canvas from element canvas
+ appState as AppState,
files,
{
exportBackground: appState.exportBackground,
@@ -458,9 +465,9 @@ const LayerUI = ({
<button
className="scroll-back-to-content"
onClick={() => {
- setAppState({
+ setAppState((appState) => ({
...calculateScrollCenter(elements, appState, canvas),
- });
+ }));
}}
>
{t("buttons.scrollBackToContent")}
@@ -484,14 +491,15 @@ const LayerUI = ({
);
};
-const stripIrrelevantAppStateProps = (
- appState: AppState,
-): Omit<
- AppState,
- "suggestedBindings" | "startBoundElement" | "cursorButton"
-> => {
- const { suggestedBindings, startBoundElement, cursorButton, ...ret } =
- appState;
+const stripIrrelevantAppStateProps = (appState: AppState): UIAppState => {
+ const {
+ suggestedBindings,
+ startBoundElement,
+ cursorButton,
+ scrollX,
+ scrollY,
+ ...ret
+ } = appState;
return ret;
};
@@ -506,8 +514,10 @@ const areEqual = (prevProps: LayerUIProps, nextProps: LayerUIProps) => {
return (
isShallowEqual(
- stripIrrelevantAppStateProps(prevAppState),
- stripIrrelevantAppStateProps(nextAppState),
+ // asserting AppState because we're being passed the whole AppState
+ // but resolve to only the UI-relevant props
+ stripIrrelevantAppStateProps(prevAppState as AppState),
+ stripIrrelevantAppStateProps(nextAppState as AppState),
{
selectedElementIds: isShallowEqual,
selectedGroupIds: isShallowEqual,
diff --git a/src/components/LibraryMenu.tsx b/src/components/LibraryMenu.tsx
index eb81bd2e40..7f25a69695 100644
--- a/src/components/LibraryMenu.tsx
+++ b/src/components/LibraryMenu.tsx
@@ -5,7 +5,12 @@ import Library, {
} from "../data/library";
import { t } from "../i18n";
import { randomId } from "../random";
-import { LibraryItems, LibraryItem, AppState, ExcalidrawProps } from "../types";
+import {
+ LibraryItems,
+ LibraryItem,
+ ExcalidrawProps,
+ UIAppState,
+} from "../types";
import LibraryMenuItems from "./LibraryMenuItems";
import { trackEvent } from "../analytics";
import { atom, useAtom } from "jotai";
@@ -44,11 +49,11 @@ export const LibraryMenuContent = ({
pendingElements: LibraryItem["elements"];
onInsertLibraryItems: (libraryItems: LibraryItems) => void;
onAddToLibrary: () => void;
- setAppState: React.Component<any, AppState>["setState"];
+ setAppState: React.Component<any, UIAppState>["setState"];
libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
library: Library;
id: string;
- appState: AppState;
+ appState: UIAppState;
selectedItems: LibraryItem["id"][];
onSelectItems: (id: LibraryItem["id"][]) => void;
}) => {
diff --git a/src/components/LibraryMenuBrowseButton.tsx b/src/components/LibraryMenuBrowseButton.tsx
index 69e1a69409..6668049224 100644
--- a/src/components/LibraryMenuBrowseButton.tsx
+++ b/src/components/LibraryMenuBrowseButton.tsx
@@ -1,6 +1,6 @@
import { VERSIONS } from "../constants";
import { t } from "../i18n";
-import { AppState, ExcalidrawProps } from "../types";
+import { ExcalidrawProps, UIAppState } from "../types";
const LibraryMenuBrowseButton = ({
theme,
@@ -8,7 +8,7 @@ const LibraryMenuBrowseButton = ({
libraryReturnUrl,
}: {
libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
- theme: AppState["theme"];
+ theme: UIAppState["theme"];
id: string;
}) => {
const referrer =
diff --git a/src/components/LibraryMenuControlButtons.tsx b/src/components/LibraryMenuControlButtons.tsx
index 78edcb3b50..6f3e752082 100644
--- a/src/components/LibraryMenuControlButtons.tsx
+++ b/src/components/LibraryMenuControlButtons.tsx
@@ -1,4 +1,4 @@
-import { LibraryItem, ExcalidrawProps, AppState } from "../types";
+import { LibraryItem, ExcalidrawProps, UIAppState } from "../types";
import LibraryMenuBrowseButton from "./LibraryMenuBrowseButton";
import { LibraryDropdownMenu } from "./LibraryMenuHeaderContent";
@@ -13,7 +13,7 @@ export const LibraryMenuControlButtons = ({
selectedItems: LibraryItem["id"][];
onSelectItems: (id: LibraryItem["id"][]) => void;
libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
- theme: AppState["theme"];
+ theme: UIAppState["theme"];
id: string;
style: React.CSSProperties;
}) => {
diff --git a/src/components/LibraryMenuHeaderContent.tsx b/src/components/LibraryMenuHeaderContent.tsx
index 58e2c8ec5c..2df5880c77 100644
--- a/src/components/LibraryMenuHeaderContent.tsx
+++ b/src/components/LibraryMenuHeaderContent.tsx
@@ -1,8 +1,8 @@
import { useCallback, useState } from "react";
import { t } from "../i18n";
import { jotaiScope } from "../jotai";
-import { AppState, LibraryItem, LibraryItems } from "../types";
-import { useApp, useExcalidrawAppState, useExcalidrawSetAppState } from "./App";
+import { LibraryItem, LibraryItems, UIAppState } from "../types";
+import { useApp, useExcalidrawSetAppState } from "./App";
import { saveLibraryAsJSON } from "../data/json";
import Library, { libraryItemsAtom } from "../data/library";
import {
@@ -21,6 +21,7 @@ import PublishLibrary from "./PublishLibrary";
import { Dialog } from "./Dialog";
import DropdownMenu from "./dropdownMenu/DropdownMenu";
import { isLibraryMenuOpenAtom } from "./LibraryMenu";
+import { useUIAppState } from "../context/ui-appState";
const getSelectedItems = (
libraryItems: LibraryItems,
@@ -28,13 +29,13 @@ const getSelectedItems = (
) => libraryItems.filter((item) => selectedItems.includes(item.id));
export const LibraryDropdownMenuButton: React.FC<{
- setAppState: React.Component<any, AppState>["setState"];
+ setAppState: React.Component<any, UIAppState>["setState"];
selectedItems: LibraryItem["id"][];
library: Library;
onRemoveFromLibrary: () => void;
resetLibrary: () => void;
onSelectItems: (items: LibraryItem["id"][]) => void;
- appState: AppState;
+ appState: UIAppState;
}> = ({
setAppState,
selectedItems,
@@ -270,7 +271,7 @@ export const LibraryDropdownMenu = ({
onSelectItems: (id: LibraryItem["id"][]) => void;
}) => {
const { library } = useApp();
- const appState = useExcalidrawAppState();
+ const appState = useUIAppState();
const setAppState = useExcalidrawSetAppState();
const [libraryItemsData] = useAtom(libraryItemsAtom, jotaiScope);
diff --git a/src/components/LibraryMenuItems.tsx b/src/components/LibraryMenuItems.tsx
index a5770a69bc..bc914c19c6 100644
--- a/src/components/LibraryMenuItems.tsx
+++ b/src/components/LibraryMenuItems.tsx
@@ -2,17 +2,22 @@ import React, { useState } from "react";
import { serializeLibraryAsJSON } from "../data/json";
import { ExcalidrawElement, NonDeleted } from "../element/types";
import { t } from "../i18n";
-import { AppState, ExcalidrawProps, LibraryItem, LibraryItems } from "../types";
+import {
+ ExcalidrawProps,
+ LibraryItem,
+ LibraryItems,
+ UIAppState,
+} from "../types";
import { arrayToMap, chunk } from "../utils";
import { LibraryUnit } from "./LibraryUnit";
import Stack from "./Stack";
-
-import "./LibraryMenuItems.scss";
import { MIME_TYPES } from "../constants";
import Spinner from "./Spinner";
import { duplicateElements } from "../element/newElement";
import { LibraryMenuControlButtons } from "./LibraryMenuControlButtons";
+import "./LibraryMenuItems.scss";
+
const CELLS_PER_ROW = 4;
const LibraryMenuItems = ({
@@ -35,7 +40,7 @@ const LibraryMenuItems = ({
selectedItems: LibraryItem["id"][];
onSelectItems: (id: LibraryItem["id"][]) => void;
libraryReturnUrl: ExcalidrawProps["libraryReturnUrl"];
- theme: AppState["theme"];
+ theme: UIAppState["theme"];
id: string;
}) => {
const [lastSelectedItem, setLastSelectedItem] = useState<
diff --git a/src/components/MobileMenu.tsx b/src/components/MobileMenu.tsx
index 34eb83a055..20e0edce01 100644
--- a/src/components/MobileMenu.tsx
+++ b/src/components/MobileMenu.tsx
@@ -1,5 +1,5 @@
import React from "react";
-import { AppState, Device, ExcalidrawProps } from "../types";
+import { AppState, Device, ExcalidrawProps, UIAppState } from "../types";
import { ActionManager } from "../actions/manager";
import { t } from "../i18n";
import Stack from "./Stack";
@@ -21,7 +21,7 @@ import { isHandToolActive } from "../appState";
import { useTunnels } from "../context/tunnels";
type MobileMenuProps = {
- appState: AppState;
+ appState: UIAppState;
actionManager: ActionManager;
renderJSONExportDialog: () => React.ReactNode;
renderImageExportDialog: () => React.ReactNode;
@@ -35,7 +35,7 @@ type MobileMenuProps = {
onImageAction: (data: { insertOnCanvasDirectly: boolean }) => void;
renderTopRightUI?: (
isMobile: boolean,
- appState: AppState,
+ appState: UIAppState,
) => JSX.Element | null;
renderCustomStats?: ExcalidrawProps["renderCustomStats"];
renderSidebars: () => JSX.Element | null;
@@ -193,9 +193,9 @@ export const MobileMenu = ({
<button
className="scroll-back-to-content"
onClick={() => {
- setAppState({
+ setAppState((appState) => ({
...calculateScrollCenter(elements, appState, canvas),
- });
+ }));
}}
>
{t("buttons.scrollBackToContent")}
diff --git a/src/components/PasteChartDialog.tsx b/src/components/PasteChartDialog.tsx
index ac96820a12..a44db40259 100644
--- a/src/components/PasteChartDialog.tsx
+++ b/src/components/PasteChartDialog.tsx
@@ -5,9 +5,10 @@ import { ChartElements, renderSpreadsheet, Spreadsheet } from "../charts";
import { ChartType } from "../element/types";
import { t } from "../i18n";
import { exportToSvg } from "../scene/export";
-import { AppState } from "../types";
+import { UIAppState } from "../types";
import { useApp } from "./App";
import { Dialog } from "./Dialog";
+
import "./PasteChartDialog.scss";
type OnInsertChart = (chartType: ChartType, elements: ChartElements) => void;
@@ -80,9 +81,9 @@ export const PasteChartDialog = ({
appState,
onClose,
}: {
- appState: AppState;
+ appState: UIAppState;
onClose: () => void;
- setAppState: React.Component<any, AppState>["setState"];
+ setAppState: React.Component<any, UIAppState>["setState"];
}) => {
const { onInsertElements } = useApp();
const handleClose = React.useCallback(() => {
diff --git a/src/components/PublishLibrary.tsx b/src/components/PublishLibrary.tsx
index b4233222dd..cb40f6b073 100644
--- a/src/components/PublishLibrary.tsx
+++ b/src/components/PublishLibrary.tsx
@@ -4,7 +4,7 @@ import OpenColor from "open-color";
import { Dialog } from "./Dialog";
import { t } from "../i18n";
-import { AppState, LibraryItems, LibraryItem } from "../types";
+import { LibraryItems, LibraryItem, UIAppState } from "../types";
import { exportToCanvas, exportToSvg } from "../packages/utils";
import {
EXPORT_DATA_TYPES,
@@ -135,7 +135,7 @@ const SingleLibraryItem = ({
onRemove,
}: {
libItem: LibraryItem;
- appState: AppState;
+ appState: UIAppState;
index: number;
onChange: (val: string, index: number) => void;
onRemove: (id: string) => void;
@@ -231,7 +231,7 @@ const PublishLibrary = ({
}: {
onClose: () => void;
libraryItems: LibraryItems;
- appState: AppState;
+ appState: UIAppState;
onSuccess: (data: {
url: string;
authorName: string;
diff --git a/src/components/Sidebar/Sidebar.tsx b/src/components/Sidebar/Sidebar.tsx
index abbec7cbca..c03682fb2e 100644
--- a/src/components/Sidebar/Sidebar.tsx
+++ b/src/components/Sidebar/Sidebar.tsx
@@ -18,11 +18,7 @@ import {
} from "./common";
import { SidebarHeader } from "./SidebarHeader";
import clsx from "clsx";
-import {
- useDevice,
- useExcalidrawAppState,
- useExcalidrawSetAppState,
-} from "../App";
+import { useDevice, useExcalidrawSetAppState } from "../App";
import { updateObject } from "../../utils";
import { KEYS } from "../../keys";
import { EVENT } from "../../constants";
@@ -33,6 +29,7 @@ import { SidebarTabs } from "./SidebarTabs";
import { SidebarTab } from "./SidebarTab";
import "./Sidebar.scss";
+import { useUIAppState } from "../../context/ui-appState";
// FIXME replace this with the implem from ColorPicker once it's merged
const useOnClickOutside = (
@@ -185,7 +182,7 @@ SidebarInner.displayName = "SidebarInner";
export const Sidebar = Object.assign(
forwardRef((props: SidebarProps, ref: React.ForwardedRef<HTMLDivElement>) => {
- const appState = useExcalidrawAppState();
+ const appState = useUIAppState();
const { onStateChange } = props;
diff --git a/src/components/Sidebar/SidebarTrigger.tsx b/src/components/Sidebar/SidebarTrigger.tsx
index 358cc35023..7114328187 100644
--- a/src/components/Sidebar/SidebarTrigger.tsx
+++ b/src/components/Sidebar/SidebarTrigger.tsx
@@ -1,8 +1,9 @@
-import { useExcalidrawSetAppState, useExcalidrawAppState } from "../App";
+import { useExcalidrawSetAppState } from "../App";
import { SidebarTriggerProps } from "./common";
+import { useUIAppState } from "../../context/ui-appState";
+import clsx from "clsx";
import "./SidebarTrigger.scss";
-import clsx from "clsx";
export const SidebarTrigger = ({
name,
@@ -15,8 +16,7 @@ export const SidebarTrigger = ({
style,
}: SidebarTriggerProps) => {
const setAppState = useExcalidrawSetAppState();
- // TODO replace with sidebar context
- const appState = useExcalidrawAppState();
+ const appState = useUIAppState();
return (
<label title={title}>
diff --git a/src/components/Stats.tsx b/src/components/Stats.tsx
index 8aad760264..eb2b93e7ed 100644
--- a/src/components/Stats.tsx
+++ b/src/components/Stats.tsx
@@ -3,14 +3,14 @@ import { getCommonBounds } from "../element/bounds";
import { NonDeletedExcalidrawElement } from "../element/types";
import { t } from "../i18n";
import { getTargetElements } from "../scene";
-import { AppState, ExcalidrawProps } from "../types";
+import { ExcalidrawProps, UIAppState } from "../types";
import { CloseIcon } from "./icons";
import { Island } from "./Island";
import "./Stats.scss";
export const Stats = (props: {
- appState: AppState;
- setAppState: React.Component<any, AppState>["setState"];
+ appState: UIAppState;
+ setAppState: React.Component<any, UIAppState>["setState"];
elements: readonly NonDeletedExcalidrawElement[];
onClose: () => void;
renderCustomStats: ExcalidrawProps["renderCustomStats"];
diff --git a/src/components/dropdownMenu/DropdownMenuTrigger.tsx b/src/components/dropdownMenu/DropdownMenuTrigger.tsx
index 100cef0ea4..d9d3f799ed 100644
--- a/src/components/dropdownMenu/DropdownMenuTrigger.tsx
+++ b/src/components/dropdownMenu/DropdownMenuTrigger.tsx
@@ -1,5 +1,6 @@
import clsx from "clsx";
-import { useDevice, useExcalidrawAppState } from "../App";
+import { useUIAppState } from "../../context/ui-appState";
+import { useDevice } from "../App";
const MenuTrigger = ({
className = "",
@@ -10,7 +11,7 @@ const MenuTrigger = ({
children: React.ReactNode;
onToggle: () => void;
}) => {
- const appState = useExcalidrawAppState();
+ const appState = useUIAppState();
const device = useDevice();
const classNames = clsx(
`dropdown-menu-button ${className}`,
diff --git a/src/components/footer/Footer.tsx b/src/components/footer/Footer.tsx
index dae2847cd4..173ea451ad 100644
--- a/src/components/footer/Footer.tsx
+++ b/src/components/footer/Footer.tsx
@@ -1,7 +1,6 @@
import clsx from "clsx";
import { actionShortcuts } from "../../actions";
import { ActionManager } from "../../actions/manager";
-import { AppState } from "../../types";
import {
ExitZenModeAction,
FinalizeAction,
@@ -13,6 +12,7 @@ import { useTunnels } from "../../context/tunnels";
import { HelpButton } from "../HelpButton";
import { Section } from "../Section";
import Stack from "../Stack";
+import { UIAppState } from "../../types";
const Footer = ({
appState,
@@ -20,7 +20,7 @@ const Footer = ({
showExitZenModeBtn,
renderWelcomeScreen,
}: {
- appState: AppState;
+ appState: UIAppState;
actionManager: ActionManager;
showExitZenModeBtn: boolean;
renderWelcomeScreen: boolean;
diff --git a/src/components/footer/FooterCenter.tsx b/src/components/footer/FooterCenter.tsx
index 294a65f3f4..55a0fb9988 100644
--- a/src/components/footer/FooterCenter.tsx
+++ b/src/components/footer/FooterCenter.tsx
@@ -1,11 +1,11 @@
import clsx from "clsx";
-import { useExcalidrawAppState } from "../App";
import { useTunnels } from "../../context/tunnels";
import "./FooterCenter.scss";
+import { useUIAppState } from "../../context/ui-appState";
const FooterCenter = ({ children }: { children?: React.ReactNode }) => {
const { FooterCenterTunnel } = useTunnels();
- const appState = useExcalidrawAppState();
+ const appState = useUIAppState();
return (
<FooterCenterTunnel.In>
<div
diff --git a/src/components/live-collaboration/LiveCollaborationTrigger.tsx b/src/components/live-collaboration/LiveCollaborationTrigger.tsx
index 87f696d85f..3111680cb0 100644
--- a/src/components/live-collaboration/LiveCollaborationTrigger.tsx
+++ b/src/components/live-collaboration/LiveCollaborationTrigger.tsx
@@ -3,9 +3,9 @@ import { usersIcon } from "../icons";
import { Button } from "../Button";
import clsx from "clsx";
-import { useExcalidrawAppState } from "../App";
import "./LiveCollaborationTrigger.scss";
+import { useUIAppState } from "../../context/ui-appState";
const LiveCollaborationTrigger = ({
isCollaborating,
@@ -15,7 +15,7 @@ const LiveCollaborationTrigger = ({
isCollaborating: boolean;
onSelect: () => void;
} & React.ButtonHTMLAttributes<HTMLButtonElement>) => {
- const appState = useExcalidrawAppState();
+ const appState = useUIAppState();
return (
<Button
diff --git a/src/components/main-menu/DefaultItems.tsx b/src/components/main-menu/DefaultItems.tsx
index d02719a2ca..100af104f1 100644
--- a/src/components/main-menu/DefaultItems.tsx
+++ b/src/components/main-menu/DefaultItems.tsx
@@ -1,10 +1,6 @@
import { getShortcutFromShortcutName } from "../../actions/shortcuts";
import { useI18n } from "../../i18n";
-import {
- useExcalidrawAppState,
- useExcalidrawSetAppState,
- useExcalidrawActionManager,
-} from "../App";
+import { useExcalidrawSetAppState, useExcalidrawActionManager } from "../App";
import {
ExportIcon,
ExportImageIcon,
@@ -32,6 +28,7 @@ import clsx from "clsx";
import { useSetAtom } from "jotai";
import { activeConfirmDialogAtom } from "../ActiveConfirmDialog";
import { jotaiScope } from "../../jotai";
+import { useUIAppState } from "../../context/ui-appState";
export const LoadScene = () => {
const { t } = useI18n();
@@ -139,7 +136,7 @@ ClearCanvas.displayName = "ClearCanvas";
export const ToggleTheme = () => {
const { t } = useI18n();
- const appState = useExcalidrawAppState();
+ const appState = useUIAppState();
const actionManager = useExcalidrawActionManager();
if (!actionManager.isActionEnabled(actionToggleTheme)) {
@@ -172,7 +169,7 @@ ToggleTheme.displayName = "ToggleTheme";
export const ChangeCanvasBackground = () => {
const { t } = useI18n();
- const appState = useExcalidrawAppState();
+ const appState = useUIAppState();
const actionManager = useExcalidrawActionManager();
if (appState.viewModeEnabled) {
diff --git a/src/components/main-menu/MainMenu.tsx b/src/components/main-menu/MainMenu.tsx
index 1a4e171cf5..12dd8e830b 100644
--- a/src/components/main-menu/MainMenu.tsx
+++ b/src/components/main-menu/MainMenu.tsx
@@ -1,9 +1,5 @@
import React from "react";
-import {
- useDevice,
- useExcalidrawAppState,
- useExcalidrawSetAppState,
-} from "../App";
+import { useDevice, useExcalidrawSetAppState } from "../App";
import DropdownMenu from "../dropdownMenu/DropdownMenu";
import * as DefaultItems from "./DefaultItems";
@@ -14,6 +10,7 @@ import { HamburgerMenuIcon } from "../icons";
import { withInternalFallback } from "../hoc/withInternalFallback";
import { composeEventHandlers } from "../../utils";
import { useTunnels } from "../../context/tunnels";
+import { useUIAppState } from "../../context/ui-appState";
const MainMenu = Object.assign(
withInternalFallback(
@@ -30,7 +27,7 @@ const MainMenu = Object.assign(
}) => {
const { MainMenuTunnel } = useTunnels();
const device = useDevice();
- const appState = useExcalidrawAppState();
+ const appState = useUIAppState();
const setAppState = useExcalidrawSetAppState();
const onClickOutside = device.isMobile
? undefined
diff --git a/src/components/welcome-screen/WelcomeScreen.Center.tsx b/src/components/welcome-screen/WelcomeScreen.Center.tsx
index f4ea6d4d49..2d43761e65 100644
--- a/src/components/welcome-screen/WelcomeScreen.Center.tsx
+++ b/src/components/welcome-screen/WelcomeScreen.Center.tsx
@@ -1,13 +1,10 @@
import { actionLoadScene, actionShortcuts } from "../../actions";
import { getShortcutFromShortcutName } from "../../actions/shortcuts";
import { t, useI18n } from "../../i18n";
-import {
- useDevice,
- useExcalidrawActionManager,
- useExcalidrawAppState,
-} from "../App";
+import { useDevice, useExcalidrawActionManager } from "../App";
import { useTunnels } from "../../context/tunnels";
import { ExcalLogo, HelpIcon, LoadIcon, usersIcon } from "../icons";
+import { useUIAppState } from "../../context/ui-appState";
const WelcomeScreenMenuItemContent = ({
icon,
@@ -148,7 +145,7 @@ const MenuItemHelp = () => {
MenuItemHelp.displayName = "MenuItemHelp";
const MenuItemLoadScene = () => {
- const appState = useExcalidrawAppState();
+ const appState = useUIAppState();
const actionManager = useExcalidrawActionManager();
if (appState.viewModeEnabled) {
diff --git a/src/context/ui-appState.ts b/src/context/ui-appState.ts
index f74ec6e0c1..d276f18c8d 100644
--- a/src/context/ui-appState.ts
+++ b/src/context/ui-appState.ts
@@ -1,5 +1,5 @@
import React from "react";
-import { AppState } from "../types";
+import { UIAppState } from "../types";
-export const UIAppStateContext = React.createContext<AppState>(null!);
+export const UIAppStateContext = React.createContext<UIAppState>(null!);
export const useUIAppState = () => React.useContext(UIAppStateContext);
diff --git a/src/element/Hyperlink.tsx b/src/element/Hyperlink.tsx
index 43cbf0da5f..d609942828 100644
--- a/src/element/Hyperlink.tsx
+++ b/src/element/Hyperlink.tsx
@@ -1,4 +1,4 @@
-import { AppState, ExcalidrawProps, Point } from "../types";
+import { AppState, ExcalidrawProps, Point, UIAppState } from "../types";
import {
getShortcutKey,
sceneCoordsToViewportCoords,
@@ -297,10 +297,11 @@ export const getContextMenuLabel = (
: "labels.link.create";
return label;
};
+
export const getLinkHandleFromCoords = (
[x1, y1, x2, y2]: Bounds,
angle: number,
- appState: AppState,
+ appState: UIAppState,
): [x: number, y: number, width: number, height: number] => {
const size = DEFAULT_LINK_SIZE;
const linkWidth = size / appState.zoom.value;
diff --git a/src/element/showSelectedShapeActions.ts b/src/element/showSelectedShapeActions.ts
index 29f8d9fcb7..e04802934d 100644
--- a/src/element/showSelectedShapeActions.ts
+++ b/src/element/showSelectedShapeActions.ts
@@ -1,9 +1,9 @@
-import { AppState } from "../types";
import { NonDeletedExcalidrawElement } from "./types";
import { getSelectedElements } from "../scene";
+import { UIAppState } from "../types";
export const showSelectedShapeActions = (
- appState: AppState,
+ appState: UIAppState,
elements: readonly NonDeletedExcalidrawElement[],
) =>
Boolean(
diff --git a/src/excalidraw-app/CustomStats.tsx b/src/excalidraw-app/CustomStats.tsx
index d23e67a9f3..addea4cd9d 100644
--- a/src/excalidraw-app/CustomStats.tsx
+++ b/src/excalidraw-app/CustomStats.tsx
@@ -7,8 +7,9 @@ import {
import { DEFAULT_VERSION } from "../constants";
import { t } from "../i18n";
import { copyTextToSystemClipboard } from "../clipboard";
-import { AppState } from "../types";
import { NonDeletedExcalidrawElement } from "../element/types";
+import { UIAppState } from "../types";
+
type StorageSizes = { scene: number; total: number };
const STORAGE_SIZE_TIMEOUT = 500;
@@ -23,7 +24,7 @@ const getStorageSizes = debounce((cb: (sizes: StorageSizes) => void) => {
type Props = {
setToast: (message: string) => void;
elements: readonly NonDeletedExcalidrawElement[];
- appState: AppState;
+ appState: UIAppState;
};
const CustomStats = (props: Props) => {
const [storageSizes, setStorageSizes] = useState<StorageSizes>({
diff --git a/src/excalidraw-app/components/ExportToExcalidrawPlus.tsx b/src/excalidraw-app/components/ExportToExcalidrawPlus.tsx
index daf4b95c36..86cf9cc414 100644
--- a/src/excalidraw-app/components/ExportToExcalidrawPlus.tsx
+++ b/src/excalidraw-app/components/ExportToExcalidrawPlus.tsx
@@ -18,7 +18,7 @@ import { getFrame } from "../../utils";
const exportToExcalidrawPlus = async (
elements: readonly NonDeletedExcalidrawElement[],
- appState: AppState,
+ appState: Partial<AppState>,
files: BinaryFiles,
) => {
const firebase = await loadFirebaseStorage();
@@ -75,7 +75,7 @@ const exportToExcalidrawPlus = async (
export const ExportToExcalidrawPlus: React.FC<{
elements: readonly NonDeletedExcalidrawElement[];
- appState: AppState;
+ appState: Partial<AppState>;
files: BinaryFiles;
onError: (error: Error) => void;
}> = ({ elements, appState, files, onError }) => {
diff --git a/src/excalidraw-app/data/index.ts b/src/excalidraw-app/data/index.ts
index 2e50abf1f9..0e3cc6902a 100644
--- a/src/excalidraw-app/data/index.ts
+++ b/src/excalidraw-app/data/index.ts
@@ -284,7 +284,7 @@ export const loadScene = async (
export const exportToBackend = async (
elements: readonly ExcalidrawElement[],
- appState: AppState,
+ appState: Partial<AppState>,
files: BinaryFiles,
) => {
const encryptionKey = await generateEncryptionKey("string");
diff --git a/src/excalidraw-app/index.tsx b/src/excalidraw-app/index.tsx
index 930143f98e..9017bbb87b 100644
--- a/src/excalidraw-app/index.tsx
+++ b/src/excalidraw-app/index.tsx
@@ -32,6 +32,7 @@ import {
ExcalidrawImperativeAPI,
BinaryFiles,
ExcalidrawInitialDataState,
+ UIAppState,
} from "../types";
import {
debounce,
@@ -550,7 +551,7 @@ const ExcalidrawWrapper = () => {
const onExportToBackend = async (
exportedElements: readonly NonDeletedExcalidrawElement[],
- appState: AppState,
+ appState: Partial<AppState>,
files: BinaryFiles,
canvas: HTMLCanvasElement | null,
) => {
@@ -581,7 +582,7 @@ const ExcalidrawWrapper = () => {
const renderCustomStats = (
elements: readonly NonDeletedExcalidrawElement[],
- appState: AppState,
+ appState: UIAppState,
) => {
return (
<CustomStats
diff --git a/src/scene/selection.ts b/src/scene/selection.ts
index 39d3518b13..20d787bc45 100644
--- a/src/scene/selection.ts
+++ b/src/scene/selection.ts
@@ -30,7 +30,7 @@ export const getElementsWithinSelection = (
export const isSomeElementSelected = (
elements: readonly NonDeletedExcalidrawElement[],
- appState: AppState,
+ appState: Pick<AppState, "selectedElementIds">,
): boolean =>
elements.some((element) => appState.selectedElementIds[element.id]);
@@ -40,7 +40,7 @@ export const isSomeElementSelected = (
*/
export const getCommonAttributeOfSelectedElements = <T>(
elements: readonly NonDeletedExcalidrawElement[],
- appState: AppState,
+ appState: Pick<AppState, "selectedElementIds">,
getAttribute: (element: ExcalidrawElement) => T,
): T | null => {
const attributes = Array.from(
@@ -55,7 +55,7 @@ export const getCommonAttributeOfSelectedElements = <T>(
export const getSelectedElements = (
elements: readonly NonDeletedExcalidrawElement[],
- appState: AppState,
+ appState: Pick<AppState, "selectedElementIds">,
includeBoundTextElement: boolean = false,
) =>
elements.filter((element) => {
@@ -74,7 +74,7 @@ export const getSelectedElements = (
export const getTargetElements = (
elements: readonly NonDeletedExcalidrawElement[],
- appState: AppState,
+ appState: Pick<AppState, "selectedElementIds" | "editingElement">,
) =>
appState.editingElement
? [appState.editingElement]
diff --git a/src/types.ts b/src/types.ts
index 2a95d347ed..8aa07d3ce3 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -1,3 +1,4 @@
+import React from "react";
import {
PointerType,
ExcalidrawLinearElement,
@@ -32,7 +33,6 @@ import type { FileSystemHandle } from "./data/filesystem";
import type { IMAGE_MIME_TYPES, MIME_TYPES } from "./constants";
import { ContextMenuItems } from "./components/ContextMenu";
import { Merge, ForwardRef, ValueOf } from "./utility-types";
-import React from "react";
export type Point = Readonly<RoughPoint>;
@@ -218,6 +218,15 @@ export type AppState = {
selectedLinearElement: LinearElementEditor | null;
};
+export type UIAppState = Omit<
+ AppState,
+ | "suggestedBindings"
+ | "startBoundElement"
+ | "cursorButton"
+ | "scrollX"
+ | "scrollY"
+>;
+
export type NormalizedZoomValue = number & { _brand: "normalizedZoom" };
export type Zoom = Readonly<{
@@ -314,7 +323,7 @@ export interface ExcalidrawProps {
) => Promise<boolean> | boolean;
renderTopRightUI?: (
isMobile: boolean,
- appState: AppState,
+ appState: UIAppState,
) => JSX.Element | null;
langCode?: Language["code"];
viewModeEnabled?: boolean;
@@ -325,7 +334,7 @@ export interface ExcalidrawProps {
name?: string;
renderCustomStats?: (
elements: readonly NonDeletedExcalidrawElement[],
- appState: AppState,
+ appState: UIAppState,
) => JSX.Element;
UIOptions?: Partial<UIOptions>;
detectScroll?: boolean;
@@ -364,13 +373,13 @@ export type ExportOpts = {
saveFileToDisk?: boolean;
onExportToBackend?: (
exportedElements: readonly NonDeletedExcalidrawElement[],
- appState: AppState,
+ appState: UIAppState,
files: BinaryFiles,
canvas: HTMLCanvasElement | null,
) => void;
renderCustomUI?: (
exportedElements: readonly NonDeletedExcalidrawElement[],
- appState: AppState,
+ appState: UIAppState,
files: BinaryFiles,
canvas: HTMLCanvasElement | null,
) => JSX.Element;
diff --git a/src/utils.ts b/src/utils.ts
index f35abe8081..83376cd3bd 100644
--- a/src/utils.ts
+++ b/src/utils.ts
@@ -372,7 +372,7 @@ export const setEraserCursor = (
export const setCursorForShape = (
canvas: HTMLCanvasElement | null,
- appState: AppState,
+ appState: Pick<AppState, "activeTool" | "theme">,
) => {
if (!canvas) {
return;
@@ -787,7 +787,12 @@ export const isShallowEqual = <
? comparator(objA[key], objB[key])
: objA[key] === objB[key];
if (!ret && debug) {
- console.warn(`isShallowEqual: ${key} not equal ->`, objA[key], objB[key]);
+ console.info(
+ `%cisShallowEqual: ${key} not equal ->`,
+ "color: #8B4000",
+ objA[key],
+ objB[key],
+ );
}
return ret;
});