From c199686c05e5725ef8d1888e868270b623227a8e Mon Sep 17 00:00:00 2001
From: dwelle <luzar.david@gmail.com>
Date: Thu, 5 Oct 2023 18:17:46 +0200
Subject: [PATCH] feat: support `props.activeTool`

---
 .../@excalidraw/excalidraw/api/props/props.mdx | 18 +++++++++++++++++-
 src/components/App.tsx                         |  7 +++++++
 src/packages/excalidraw/index.tsx              |  2 ++
 src/types.ts                                   |  8 ++++++++
 4 files changed, 34 insertions(+), 1 deletion(-)

diff --git a/dev-docs/docs/@excalidraw/excalidraw/api/props/props.mdx b/dev-docs/docs/@excalidraw/excalidraw/api/props/props.mdx
index 5764528b6..02be11296 100644
--- a/dev-docs/docs/@excalidraw/excalidraw/api/props/props.mdx
+++ b/dev-docs/docs/@excalidraw/excalidraw/api/props/props.mdx
@@ -30,6 +30,7 @@ All `props` are *optional*.
 | [`generateIdForFile`](#generateidforfile) | `function` | _ | Allows you to override `id` generation for files added on canvas |
 | [`validateEmbeddable`](#validateEmbeddable) | string[] | `boolean | RegExp | RegExp[] | ((link: string) => boolean | undefined)` | \_ | use for custom src url validation |
 | [`renderEmbeddable`](/docs/@excalidraw/excalidraw/api/props/render-props#renderEmbeddable) | `function` | \_ | Render function that can override the built-in `<iframe>` |
+| [`activeTool`](#activeTool) | `object` | - | Set the active editor tool (forced) |
 
 ### Storing custom data on Excalidraw elements
 
@@ -236,4 +237,19 @@ validateEmbeddable?: boolean | string[] | RegExp | RegExp[] | ((link: string) =>
 
 This is an optional property. By default we support a handful of well-known sites. You may allow additional sites or disallow the default ones by supplying a custom validator. If you pass `true`, all URLs will be allowed. You can also supply a list of hostnames, RegExp (or list of RegExp objects), or a function. If the function returns `undefined`, the built-in validator will be used.
 
-Supplying a list of hostnames (with or without `www.`) is the preferred way to allow a specific list of domains.
\ No newline at end of file
+Supplying a list of hostnames (with or without `www.`) is the preferred way to allow a specific list of domains.
+
+### activeTool
+
+```ts
+activeTool?: 
+  | {
+      type: ToolType;
+    }
+  | {
+      type: "custom";
+      customType: string;
+    };
+```
+
+Tool to be force-set as active. As long as the prop is set, the editor active tool will be set to this. Useful only in specific circumstances such as when UI is disabled and the editor should be limited to just one tool (such as a laser pointer).
\ No newline at end of file
diff --git a/src/components/App.tsx b/src/components/App.tsx
index 737d2bed7..6d3d9bd12 100644
--- a/src/components/App.tsx
+++ b/src/components/App.tsx
@@ -1903,6 +1903,13 @@ class App extends React.Component<AppProps, AppState> {
       this.refreshDeviceState(this.excalidrawContainerRef.current);
     }
 
+    if (
+      this.props.activeTool &&
+      this.props.activeTool.type !== this.state.activeTool.type
+    ) {
+      this.setActiveTool(this.props.activeTool);
+    }
+
     if (
       prevState.scrollX !== this.state.scrollX ||
       prevState.scrollY !== this.state.scrollY
diff --git a/src/packages/excalidraw/index.tsx b/src/packages/excalidraw/index.tsx
index 901785f1c..d9e6fcd0a 100644
--- a/src/packages/excalidraw/index.tsx
+++ b/src/packages/excalidraw/index.tsx
@@ -44,6 +44,7 @@ const ExcalidrawBase = (props: ExcalidrawProps) => {
     children,
     validateEmbeddable,
     renderEmbeddable,
+    activeTool,
   } = props;
 
   const canvasActions = props.UIOptions?.canvasActions;
@@ -119,6 +120,7 @@ const ExcalidrawBase = (props: ExcalidrawProps) => {
           onScrollChange={onScrollChange}
           validateEmbeddable={validateEmbeddable}
           renderEmbeddable={renderEmbeddable}
+          activeTool={activeTool}
         >
           {children}
         </App>
diff --git a/src/types.ts b/src/types.ts
index 8b05ba40a..dde9b6500 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -445,6 +445,14 @@ export interface ExcalidrawProps {
     element: NonDeleted<ExcalidrawEmbeddableElement>,
     appState: AppState,
   ) => JSX.Element | null;
+  activeTool?:
+    | {
+        type: ToolType;
+      }
+    | {
+        type: "custom";
+        customType: string;
+      };
 }
 
 export type SceneData = {