@excalidraw/common 0.18.0-816c81c → 0.18.0-81ab857

package/dist/types/element/src/selection.d.ts

@@ -1,6 +1,6 @@
 import type { AppState, InteractiveCanvasAppState } from "@excalidraw/excalidraw/types";
 import { LinearElementEditor } from "./linearElementEditor";
-import type { ElementsMap, ElementsMapOrArray, ExcalidrawElement, NonDeletedExcalidrawElement } from "./types";
+import type { ElementsMap, ElementsMapOrArray, ExcalidrawElement, NonDeleted, NonDeletedExcalidrawElement } from "./types";
 /**
  * Frames and their containing elements are not to be selected at the same time.
  * Given an array of selected elements, if there are frames and their containing elements
@@ -32,3 +32,7 @@ export declare const getSelectionStateForElements: (targetElements: readonly Exc
     editingGroupId: AppState["editingGroupId"];
     selectedLinearElement: LinearElementEditor | null;
 };
+/**
+ * Returns editing or single-selected text element, if any.
+ */
+export declare const getActiveTextElement: (selectedElements: readonly NonDeleted<ExcalidrawElement>[], appState: Pick<AppState, "editingTextElement">) => import("./types").ExcalidrawTextElement | null;

package/dist/types/element/src/textElement.d.ts

@@ -31,7 +31,7 @@ export declare const suppportsHorizontalAlign: (selectedElements: NonDeletedExca
 declare const VALID_CONTAINER_TYPES: Set<string>;
 export declare const isValidTextContainer: (element: {
     type: ExcalidrawElementType;
-}) => boolean;
+}) => element is ExcalidrawTextContainer;
 export declare const computeContainerDimensionForBoundText: (dimension: number, containerType: ExtractSetType<typeof VALID_CONTAINER_TYPES>) => number;
 export declare const getBoundTextMaxWidth: (container: ExcalidrawElement, boundTextElement: ExcalidrawTextElement | null) => number;
 export declare const getBoundTextMaxHeight: (container: ExcalidrawElement, boundTextElement: ExcalidrawTextElementWithContainer) => number;

package/dist/types/element/src/textWrapping.d.ts

@@ -5,9 +5,35 @@ import type { FontString } from "./types";
 export declare const containsCJK: (text: string) => boolean;
 /**
  * Breaks the line into the tokens based on the found line break opporutnities.
+ *
+ * Note: tokenization normalizes to NFC first so decomposed graphemes are treated as
+ * their composed variants for wrapping. Any code that needs exact source offsets should
+ * keep in mind that this assumes the input text is already NFC-normalized.
  */
 export declare const parseTokens: (line: string) => string[];
 /**
  * Wraps the original text into the lines based on the given width.
+ *
+ * This is a convenience adapter over `getWrappedTextLines()` for call sites
+ * that only need the rendered wrapped string and not the source offsets.
  */
 export declare const wrapText: (text: string, font: FontString, maxWidth: number) => string;
+/**
+ * A single rendered visual line produced from the original text.
+ *
+ * `start` and `end` are end-exclusive code-unit offsets into the original text, and do
+ * not include synthetic soft line breaks inserted by this module. If trailing whitespace
+ * was trimmed away at a wrap boundary, `end` points to the last rendered character.
+ */
+export type WrappedTextLine = {
+    text: string;
+    start: number;
+    end: number;
+};
+/**
+ * Returns the rendered visual lines together with their source offsets.
+ *
+ * This is the source-of-truth wrapping pipeline for callers that need more than the
+ * final wrapped string, for example caret placement or future editor/rich-text mapping.
+ */
+export declare const getWrappedTextLines: (text: string, font: FontString, maxWidth: number) => WrappedTextLine[];

package/dist/types/excalidraw/actions/actionAddToLibrary.d.ts

@@ -42,7 +42,7 @@ export declare const actionAddToLibrary: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -196,7 +196,7 @@ export declare const actionAddToLibrary: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -355,7 +355,7 @@ export declare const actionAddToLibrary: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionBoundText.d.ts

@@ -1,4 +1,4 @@
-import type { ExcalidrawElement, ExcalidrawLinearElement } from "@excalidraw/element/types";
+import type { ExcalidrawElement, ExcalidrawLinearElement, ExcalidrawTextElement } from "@excalidraw/element/types";
 import type { Mutable } from "@excalidraw/common/utility-types";
 import type { AppState } from "../types";
 export declare const actionUnbindText: {
@@ -62,7 +62,7 @@ export declare const actionBindText: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -233,7 +233,7 @@ export declare const actionWrapTextInContainer: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionCanvas.d.ts

@@ -71,7 +71,7 @@ export declare const actionClearCanvas: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;
@@ -222,7 +222,7 @@ export declare const actionZoomIn: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -397,7 +397,7 @@ export declare const actionZoomOut: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -572,7 +572,7 @@ export declare const actionResetZoom: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -748,7 +748,7 @@ export declare const zoomToFitBounds: ({ bounds, appState, canvasOffsets, fitToV
         };
         editingFrame: string | null;
         elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-        editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
         activeTool: {
             lastActiveTool: import("../types").ActiveTool | null;
             locked: boolean;
@@ -920,7 +920,7 @@ export declare const zoomToFit: ({ canvasOffsets, targetElements, appState, fitT
         };
         editingFrame: string | null;
         elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-        editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
         activeTool: {
             lastActiveTool: import("../types").ActiveTool | null;
             locked: boolean;
@@ -1089,7 +1089,7 @@ export declare const actionZoomToFitSelectionInViewport: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -1262,7 +1262,7 @@ export declare const actionZoomToFitSelection: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -1436,7 +1436,7 @@ export declare const actionZoomToFit: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -1610,7 +1610,7 @@ export declare const actionToggleEraserTool: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;
@@ -1775,7 +1775,7 @@ export declare const actionToggleLassoTool: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;
@@ -1939,7 +1939,7 @@ export declare const actionToggleHandTool: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;

package/dist/types/excalidraw/actions/actionClipboard.d.ts

@@ -43,7 +43,7 @@ export declare const actionPaste: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -252,7 +252,7 @@ export declare const actionCopyAsPng: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionCropEditor.d.ts

@@ -44,7 +44,7 @@ export declare const actionToggleCropEditor: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionDeleteSelected.d.ts

@@ -45,7 +45,7 @@ export declare const actionDeleteSelected: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -237,7 +237,7 @@ export declare const actionDeleteSelected: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -402,7 +402,7 @@ export declare const actionDeleteSelected: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;

package/dist/types/excalidraw/actions/actionElementLink.d.ts

@@ -73,7 +73,7 @@ export declare const actionLinkToElement: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionElementLock.d.ts

@@ -55,7 +55,7 @@ export declare const actionToggleElementLock: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -225,7 +225,7 @@ export declare const actionUnlockAllElements: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionEmbeddable.d.ts

@@ -46,7 +46,7 @@ export declare const actionSetEmbeddableAsActiveTool: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;

package/dist/types/excalidraw/actions/actionExport.d.ts

@@ -128,7 +128,7 @@ export declare const actionLoadScene: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;
@@ -272,7 +272,7 @@ export declare const actionLoadScene: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionFrame.d.ts

@@ -43,7 +43,7 @@ export declare const actionSelectAllElementsInFrame: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -218,7 +218,7 @@ export declare const actionRemoveAllElementsFromFrame: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -391,7 +391,7 @@ export declare const actionupdateFrameRendering: {
             frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -569,7 +569,7 @@ export declare const actionSetFrameAsActiveTool: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;

package/dist/types/excalidraw/actions/actionGroup.d.ts

@@ -1,4 +1,4 @@
-import type { ExcalidrawElement, OrderedExcalidrawElement } from "@excalidraw/element/types";
+import type { ExcalidrawElement, ExcalidrawTextElement, OrderedExcalidrawElement } from "@excalidraw/element/types";
 import type { AppClassProperties, AppState } from "../types";
 export declare const actionGroup: {
     name: "group";
@@ -49,7 +49,7 @@ export declare const actionGroup: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -223,7 +223,7 @@ export declare const actionUngroup: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionLinearEditor.d.ts

@@ -76,7 +76,7 @@ export declare const actionToggleLinearEditor: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionLink.d.ts

@@ -40,7 +40,7 @@ export declare const actionLink: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionMenu.d.ts

@@ -47,7 +47,7 @@ export declare const actionShortcuts: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionProperties.d.ts

@@ -1,8 +1,8 @@
 import { LinearElementEditor } from "@excalidraw/element";
-import type { Arrowhead, ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawLinearElement, FontFamilyValues, TextAlign } from "@excalidraw/element/types";
+import type { Arrowhead, ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawLinearElement, ExcalidrawTextElement, FontFamilyValues, TextAlign } from "@excalidraw/element/types";
 import type { AppClassProperties, AppState, Primitive } from "../types";
 export declare const changeProperty: (elements: readonly ExcalidrawElement[], appState: AppState, callback: (element: ExcalidrawElement) => ExcalidrawElement, includeBoundText?: boolean) => ExcalidrawElement[];
-export declare const getFormValue: <T extends Primitive>(elements: readonly ExcalidrawElement[], app: AppClassProperties, getAttribute: (element: ExcalidrawElement) => T, isRelevantElement: true | ((element: ExcalidrawElement) => boolean), defaultValue: T | ((isSomeElementSelected: boolean) => T)) => T;
+export declare const getFormValue: <T extends Primitive>(elements: readonly ExcalidrawElement[], app: AppClassProperties, getAttribute: (element: ExcalidrawElement) => T, elementPredicate: true | ((element: ExcalidrawElement) => boolean), defaultValue: T | ((isSomeElementSelected: boolean) => T)) => T;
 export declare const actionChangeStrokeColor: import("./types").Action<Pick<AppState, "currentItemStrokeColor">> & {
     keyTest?: ((event: React.KeyboardEvent | KeyboardEvent, appState: AppState, elements: readonly ExcalidrawElement[], app: AppClassProperties) => boolean) | undefined;
 };
@@ -69,7 +69,7 @@ export declare const actionDecreaseFontSize: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;
@@ -239,7 +239,7 @@ export declare const actionIncreaseFontSize: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionSelectAll.d.ts

@@ -47,7 +47,7 @@ export declare const actionSelectAll: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionStyles.d.ts

@@ -1,3 +1,4 @@
+import type { ExcalidrawTextElement } from "@excalidraw/element/types";
 export declare let copiedStyles: string;
 export declare const actionCopyStyles: {
     name: "copyStyles";
@@ -44,7 +45,7 @@ export declare const actionCopyStyles: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionTextAutoResize.d.ts

@@ -1,4 +1,4 @@
-import type { AppClassProperties } from "../types";
+import type { ExcalidrawElement } from "@excalidraw/element/types";
 export declare const actionTextAutoResize: {
     name: "autoResize";
     label: string;
@@ -6,8 +6,8 @@ export declare const actionTextAutoResize: {
     trackEvent: {
         category: "element";
     };
-    predicate: (elements: readonly import("@excalidraw/element/types").ExcalidrawElement[], appState: import("../types").AppState, _: unknown, app: AppClassProperties) => boolean;
-    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>, _: unknown, app: AppClassProperties) => {
+    predicate: (elements: readonly ExcalidrawElement[], appState: import("../types").AppState, _: unknown) => boolean;
+    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<import("../types").AppState>, targetElement: unknown) => {
         appState: Readonly<import("../types").AppState>;
         elements: import("@excalidraw/element/types").OrderedExcalidrawElement[];
         captureUpdate: "IMMEDIATELY";

package/dist/types/excalidraw/actions/actionToggleArrowBinding.d.ts

@@ -41,7 +41,7 @@ export declare const actionToggleArrowBinding: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionToggleGridMode.d.ts

@@ -46,7 +46,7 @@ export declare const actionToggleGridMode: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionToggleMidpointSnapping.d.ts

@@ -41,7 +41,7 @@ export declare const actionToggleMidpointSnapping: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionToggleObjectsSnapMode.d.ts

@@ -44,7 +44,7 @@ export declare const actionToggleObjectsSnapMode: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionToggleSearchMenu.d.ts

@@ -50,7 +50,7 @@ export declare const actionToggleSearchMenu: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionToggleStats.d.ts

@@ -46,7 +46,7 @@ export declare const actionToggleStats: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionToggleViewMode.d.ts

@@ -43,7 +43,7 @@ export declare const actionToggleViewMode: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

package/dist/types/excalidraw/actions/actionToggleZenMode.d.ts

@@ -43,7 +43,7 @@ export declare const actionToggleZenMode: {
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
                 locked: boolean;

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

@@ -113,12 +113,14 @@ declare class App extends React.Component<AppProps, AppState> {
     hitLinkElement?: NonDeletedExcalidrawElement;
     lastPointerDownEvent: React.PointerEvent<HTMLElement> | null;
     lastPointerUpEvent: React.PointerEvent<HTMLElement> | PointerEvent | null;
+    lastPointerUpIsDoubleClick: boolean;
     lastPointerMoveEvent: PointerEvent | null;
     /** current frame pointer cords */
     lastPointerMoveCoords: {
         x: number;
         y: number;
     } | null;
+    private lastCompletedCanvasClicks;
     /** previous frame pointer coords */
     previousPointerMoveCoords: {
         x: number;
@@ -278,10 +280,12 @@ declare class App extends React.Component<AppProps, AppState> {
      * If disabled, returns null.
      */
     getEffectiveGridSize: () => NullableGridSize;
+    private getTextCreationGridPoint;
     private getHTMLIFrameElement;
     private handleIframeLikeElementHover;
     /** @returns true if iframe-like element click handled */
     private handleIframeLikeCenterClick;
+    private isDoubleClick;
     private isIframeLikeElementCenter;
     private updateEmbedValidationStatus;
     private updateEmbeddables;
@@ -472,7 +476,11 @@ declare class App extends React.Component<AppProps, AppState> {
     private onGestureEnd;
     private handleTextWysiwyg;
     private deselectElements;
+    private getSelectedTextElement;
+    private getSelectedTextEditingContainerAtPosition;
     private getTextElementAtPosition;
+    private isHittingTextAutoResizeHandle;
+    private handleTextAutoResizeHandlePointerDown;
     private getElementAtPosition;
     private getElementsAtPosition;
     getElementHitThreshold(element: ExcalidrawElement): number;
@@ -481,7 +489,9 @@ declare class App extends React.Component<AppProps, AppState> {
     private startTextEditing;
     private startImageCropping;
     private finishImageCropping;
+    private shouldHandleBrowserCanvasDoubleClick;
     private handleCanvasDoubleClick;
+    private handleCanvasClick;
     private getElementLinkAtPosition;
     private handleElementLinkClick;
     private getTopLayerFrameAtSceneCoords;

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

@@ -1,8 +1,14 @@
+import React from "react";
 import "./Range.scss";
-import type { AppClassProperties } from "../types";
 export type RangeProps = {
-    updateData: (value: number) => void;
-    app: AppClassProperties;
+    label: React.ReactNode;
+    value: number;
+    onChange: (value: number) => void;
+    min?: number;
+    max?: number;
+    step?: number;
+    minLabel?: React.ReactNode;
+    hasCommonValue?: boolean;
     testId?: string;
 };
-export declare const Range: ({ updateData, app, testId }: RangeProps) => import("react/jsx-runtime").JSX.Element;
+export declare const Range: ({ label, value, onChange, min, max, step, minLabel, hasCommonValue, testId, }: RangeProps) => import("react/jsx-runtime").JSX.Element;

package/dist/types/excalidraw/components/canvases/InteractiveCanvas.d.ts

@@ -21,6 +21,7 @@ type InteractiveCanvasProps = {
     renderInteractiveSceneCallback: (data: RenderInteractiveSceneCallback) => void;
     handleCanvasRef: (canvas: HTMLCanvasElement | null) => void;
     onContextMenu: Exclude<DOMAttributes<HTMLCanvasElement | HTMLDivElement>["onContextMenu"], undefined>;
+    onClick: Exclude<DOMAttributes<HTMLCanvasElement>["onClick"], undefined>;
     onPointerMove: Exclude<DOMAttributes<HTMLCanvasElement>["onPointerMove"], undefined>;
     onPointerUp: Exclude<DOMAttributes<HTMLCanvasElement>["onPointerUp"], undefined>;
     onPointerCancel: Exclude<DOMAttributes<HTMLCanvasElement>["onPointerCancel"], undefined>;

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

@@ -66,7 +66,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
             };
             editingFrame: string | null;
             elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-            editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
             preferredSelectionTool: {
                 type: "selection" | "lasso";
                 initialized: boolean;
@@ -231,7 +231,7 @@ fileHandle?: FileSystemFileHandle | null) => Promise<{
         };
         editingFrame: string | null;
         elementsToHighlight: import("@excalidraw/element/types").NonDeleted<ExcalidrawElement>[] | null;
-        editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
         preferredSelectionTool: {
             type: "selection" | "lasso";
             initialized: boolean;

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

@@ -64,7 +64,7 @@ export declare const loadFromJSON: (localAppState: AppState, localElements: read
         };
         editingFrame: string | null;
         elementsToHighlight: NonDeleted<ExcalidrawElement>[] | null;
-        editingTextElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+        editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
         preferredSelectionTool: {
             type: "selection" | "lasso";
             initialized: boolean;

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

@@ -0,0 +1,15 @@
+import { type GlobalPoint } from "@excalidraw/math";
+import type { EditorInterface } from "@excalidraw/common";
+import type { ExcalidrawTextElement } from "@excalidraw/element/types";
+export declare const getTextBoxPadding: (zoomValue: number) => number;
+export declare const getTextAutoResizeHandle: (textElement: ExcalidrawTextElement, zoomValue: number, formFactor: EditorInterface["formFactor"]) => {
+    center: GlobalPoint | import("@excalidraw/math").LocalPoint;
+    start: GlobalPoint;
+    end: GlobalPoint;
+    hitboxWidth: number;
+    hitboxHeight: number;
+} | null;
+export declare const isPointHittingTextAutoResizeHandle: (point: Readonly<{
+    x: number;
+    y: number;
+}>, textElement: ExcalidrawTextElement, zoomValue: number, formFactor: EditorInterface["formFactor"]) => boolean;

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

@@ -1,7 +1,7 @@
 import type { IMAGE_MIME_TYPES, UserIdleState, throttleRAF, MIME_TYPES, EditorInterface } from "@excalidraw/common";
 import type { LinearElementEditor } from "@excalidraw/element";
 import type { MaybeTransformHandleType } from "@excalidraw/element";
-import type { PointerType, ExcalidrawLinearElement, NonDeletedExcalidrawElement, NonDeleted, TextAlign, ExcalidrawElement, GroupId, ExcalidrawBindableElement, Arrowhead, FontFamilyValues, FileId, Theme, StrokeRoundness, ExcalidrawEmbeddableElement, ExcalidrawMagicFrameElement, ExcalidrawFrameLikeElement, ExcalidrawElementType, ExcalidrawIframeLikeElement, OrderedExcalidrawElement, ExcalidrawNonSelectionElement, BindMode } from "@excalidraw/element/types";
+import type { PointerType, ExcalidrawLinearElement, NonDeletedExcalidrawElement, NonDeleted, TextAlign, ExcalidrawElement, GroupId, ExcalidrawBindableElement, Arrowhead, FontFamilyValues, FileId, Theme, StrokeRoundness, ExcalidrawEmbeddableElement, ExcalidrawMagicFrameElement, ExcalidrawFrameLikeElement, ExcalidrawElementType, ExcalidrawIframeLikeElement, OrderedExcalidrawElement, ExcalidrawNonSelectionElement, BindMode, ExcalidrawTextElement } from "@excalidraw/element/types";
 import type { Merge, MaybePromise, ValueOf, MakeBrand } from "@excalidraw/common/utility-types";
 import type { CaptureUpdateActionType, DurableIncrement, EphemeralIncrement } from "@excalidraw/element";
 import type { GlobalPoint } from "@excalidraw/math";
@@ -231,7 +231,7 @@ export interface AppState {
     /**
      * set when a new text is created or when an existing text is being edited
      */
-    editingTextElement: NonDeletedExcalidrawElement | null;
+    editingTextElement: ExcalidrawTextElement | null;
     activeTool: {
         /**
          * indicates a previous tool we should revert back to if we deselect the

package/dist/types/excalidraw/wysiwyg/textWysiwyg.d.ts

@@ -1,7 +1,7 @@
 import type { ExcalidrawElement, ExcalidrawTextElement } from "@excalidraw/element/types";
 import type App from "../components/App";
 type SubmitHandler = () => void;
-export declare const textWysiwyg: ({ id, onChange, onSubmit, getViewportCoords, element, canvas, excalidrawContainer, app, autoSelect, }: {
+export declare const textWysiwyg: ({ id, onChange, onSubmit, getViewportCoords, element, canvas, excalidrawContainer, app, autoSelect, initialCaretSceneCoords, }: {
     id: ExcalidrawElement["id"];
     /**
      * textWysiwyg only deals with `originalText`
@@ -20,5 +20,9 @@ export declare const textWysiwyg: ({ id, onChange, onSubmit, getViewportCoords,
     excalidrawContainer: HTMLDivElement | null;
     app: App;
     autoSelect?: boolean;
+    initialCaretSceneCoords?: {
+        x: number;
+        y: number;
+    } | null;
 }) => SubmitHandler;
 export {};

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

@@ -57,7 +57,7 @@ export declare function pointsEqual<Point extends GlobalPoint | LocalPoint>(a: P
  * @param angle The radians to rotate the point by
  * @returns The rotated point
  */
-export declare function pointRotateRads<Point extends GlobalPoint | LocalPoint>([x, y]: Point, [cx, cy]: Point, angle: Radians): Point;
+export declare function pointRotateRads<Point extends GlobalPoint | LocalPoint>(point: Point, center: Point, angle: Radians): Point;
 /**
  * Rotate a point by [angle] degree.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@excalidraw/common",
-  "version": "0.18.0-816c81c",
+  "version": "0.18.0-81ab857",
   "type": "module",
   "types": "./dist/types/common/src/index.d.ts",
   "main": "./dist/prod/index.js",