@excalidraw/math 0.18.0-4ce38fb → 0.18.0-4ce8305

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

@@ -1,3 +1,4 @@
+import type { RenderEnvironment } from "./renderEnvironment";
 import type { Scene } from "./Scene";
 import type { VerticalResizeAnchor } from "./sizeHelpers";
 import type { TransformHandleDirection } from "./transformHandles";
@@ -124,6 +125,12 @@ export type StickyNoteLayoutOpts = {
     baseFontSize?: number;
     /** the edge that stays put when the content correction changes the height */
     anchor?: StickyNoteLayoutAnchor;
+    /**
+     * the host whose text metrics the fit measures with; omitted = the global
+     * environment. An editor passes its own so a note laid out in one window
+     * (or headlessly) is measured with that realm's fonts and canvas.
+     */
+    renderEnvironment?: RenderEnvironment;
 };
 export type StickyNoteLayout = {
     container: Pick<ExcalidrawStickyNoteElement, "x" | "y" | "width" | "height" | "baseHeight">;
@@ -180,4 +187,5 @@ export declare const updateStickyNoteLayout: (container: ExcalidrawStickyNoteEle
  */
 export declare const relayoutStickyNotes: <T extends ExcalidrawElement>(elements: readonly T[], affectedIds: ReadonlySet<ExcalidrawElement["id"]>, opts?: {
     prevElementsMap?: ElementsMap;
+    renderEnvironment?: RenderEnvironment;
 }) => readonly T[];

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

@@ -1,10 +1,11 @@
 import { type Radians } from "@excalidraw/math";
 import type { ExtractSetType } from "@excalidraw/common/utility-types";
+import type { RenderEnvironment } from "./renderEnvironment";
 import type { Scene } from "./Scene";
 import type { MaybeTransformHandleType } from "./transformHandles";
 import type { ElementsMap, ExcalidrawElement, ExcalidrawElementType, ExcalidrawTextContainer, ExcalidrawTextElement, ExcalidrawTextElementWithContainer, NonDeleted } from "./types";
-export declare const redrawTextBoundingBox: (textElement: ExcalidrawTextElement, container: ExcalidrawElement | null, scene: Scene) => void;
-export declare const handleBindTextResize: (container: ExcalidrawElement, scene: Scene, transformHandleType: MaybeTransformHandleType, shouldMaintainAspectRatio?: boolean, shouldResizeFromCenter?: boolean, flipByY?: boolean) => void;
+export declare const redrawTextBoundingBox: (textElement: ExcalidrawTextElement, container: ExcalidrawElement | null, scene: Scene, renderEnvironment?: RenderEnvironment) => void;
+export declare const handleBindTextResize: (container: ExcalidrawElement, scene: Scene, transformHandleType: MaybeTransformHandleType, shouldMaintainAspectRatio?: boolean, shouldResizeFromCenter?: boolean, flipByY?: boolean, renderEnvironment?: RenderEnvironment) => void;
 export declare const computeBoundTextPosition: (container: ExcalidrawElement, boundTextElement: ExcalidrawTextElementWithContainer, elementsMap: ElementsMap) => {
     x: number;
     y: number;

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

@@ -1,10 +1,11 @@
+import type { RenderEnvironment } from "./renderEnvironment";
 import type { FontString, ExcalidrawTextElement } from "./types";
-export declare const measureText: (text: string, font: FontString, lineHeight: ExcalidrawTextElement["lineHeight"]) => {
+export declare const measureText: (text: string, font: FontString, lineHeight: ExcalidrawTextElement["lineHeight"], env?: RenderEnvironment) => {
     width: number;
     height: number;
 };
-export declare const getApproxMinLineWidth: (font: FontString, lineHeight: ExcalidrawTextElement["lineHeight"]) => number;
-export declare const getMinTextElementWidth: (font: FontString, lineHeight: ExcalidrawTextElement["lineHeight"]) => number;
+export declare const getApproxMinLineWidth: (font: FontString, lineHeight: ExcalidrawTextElement["lineHeight"], env?: RenderEnvironment) => number;
+export declare const getMinTextElementWidth: (font: FontString, lineHeight: ExcalidrawTextElement["lineHeight"], env?: RenderEnvironment) => number;
 export declare const isMeasureTextSupported: () => boolean;
 export declare const normalizeText: (text: string) => string;
 /**
@@ -19,21 +20,24 @@ export declare const detectLineHeight: (textElement: ExcalidrawTextElement) => E
 export declare const getLineHeightInPx: (fontSize: ExcalidrawTextElement["fontSize"], lineHeight: ExcalidrawTextElement["lineHeight"]) => number;
 export declare const getApproxMinLineHeight: (fontSize: ExcalidrawTextElement["fontSize"], lineHeight: ExcalidrawTextElement["lineHeight"]) => number;
 /**
- * Set a custom text metrics provider.
+ * Set a custom text metrics provider, for all text measured in an environment
+ * without its own (`RenderEnvironment["textMetrics"]`) -- e.g. elements
+ * created outside the editor, on a server. Pass `undefined` to go back to
+ * measuring on a canvas.
  *
  * Useful for overriding the width calculation algorithm where canvas API is not available / desired.
  */
-export declare const setCustomTextMetricsProvider: (provider: TextMetricsProvider) => void;
+export declare const setCustomTextMetricsProvider: (provider: TextMetricsProvider | undefined) => void;
 export interface TextMetricsProvider {
     getLineWidth(text: string, fontString: FontString): number;
 }
-export declare const getLineWidth: (text: string, font: FontString) => number;
-export declare const getTextWidth: (text: string, font: FontString) => number;
+export declare const getLineWidth: (text: string, font: FontString, env?: RenderEnvironment) => number;
+export declare const getTextWidth: (text: string, font: FontString, env?: RenderEnvironment) => number;
 export declare const getTextHeight: (text: string, fontSize: number, lineHeight: ExcalidrawTextElement["lineHeight"]) => number;
 export declare const charWidth: {
-    calculate: (char: string, font: FontString) => number;
-    getCache: (font: FontString) => number[];
+    calculate: (char: string, font: FontString, env?: RenderEnvironment) => number;
+    getCache: (font: FontString, env?: RenderEnvironment) => number[] | undefined;
     clearCache: (font: FontString) => void;
 };
-export declare const getMinCharWidth: (font: FontString) => number;
-export declare const getMaxCharWidth: (font: FontString) => number;
+export declare const getMinCharWidth: (font: FontString, env?: RenderEnvironment) => number;
+export declare const getMaxCharWidth: (font: FontString, env?: RenderEnvironment) => number;

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

@@ -1,3 +1,4 @@
+import type { RenderEnvironment } from "./renderEnvironment";
 import type { FontString } from "./types";
 /**
  * Test if a given text contains any CJK characters (including symbols, punctuation, etc,).
@@ -17,7 +18,7 @@ export declare const parseTokens: (line: string) => string[];
  * 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;
+export declare const wrapText: (text: string, font: FontString, maxWidth: number, env?: RenderEnvironment) => string;
 /**
  * A single rendered visual line produced from the original text.
  *
@@ -36,4 +37,4 @@ export type WrappedTextLine = {
  * 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[];
+export declare const getWrappedTextLines: (text: string, font: FontString, maxWidth: number, env?: RenderEnvironment) => WrappedTextLine[];

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

@@ -1,5 +1,6 @@
 import type { MarkOptional } from "@excalidraw/common/utility-types";
 import { type ElementConstructorOpts } from "./newElement";
+import type { RenderEnvironment } from "./renderEnvironment";
 import type { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawFrameElement, ExcalidrawFreeDrawElement, ExcalidrawGenericElement, ExcalidrawIframeLikeElement, ExcalidrawImageElement, ExcalidrawLinearElement, ExcalidrawMagicFrameElement, ExcalidrawSelectionElement, ExcalidrawTextElement, FileId, FontFamilyValues, NonDeletedExcalidrawElement, Ordered, TextAlign, VerticalAlign, ExcalidrawStickyNoteElement } from "./types";
 /**
  * Options for elements generated from a skeleton fragment (bound labels and
@@ -17,6 +18,8 @@ export type ValidLinearElement = {
         fontFamily?: FontFamilyValues;
         textAlign?: TextAlign;
         verticalAlign?: VerticalAlign;
+        /** where along an arrow's path (0-1) the label is centered */
+        labelPosition?: ExcalidrawTextElement["labelPosition"];
     } & FragmentConstructorOpts;
     end?: (({
         type: Exclude<ExcalidrawBindableElement["type"], "image" | "text" | "frame" | "magicframe" | "embeddable" | "iframe">;
@@ -95,6 +98,7 @@ export type ExcalidrawElementSkeleton = Extract<Exclude<ExcalidrawElement, Excal
     name?: string;
 } & Partial<ExcalidrawMagicFrameElement>);
 export declare const convertToExcalidrawElements: (elementsSkeleton: ExcalidrawElementSkeleton[] | null, opts?: {
-    regenerateIds: boolean;
+    regenerateIds?: boolean;
+    renderEnvironment?: RenderEnvironment;
 }) => Ordered<NonDeletedExcalidrawElement>[];
 export {};

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

@@ -1,34 +1,26 @@
-import type { ExcalidrawElement, ExcalidrawLinearElement, ExcalidrawTextElement } from "@excalidraw/element/types";
-import type { Mutable } from "@excalidraw/common/utility-types";
-import type { AppState } from "../types";
+import type { Scene } from "@excalidraw/element";
+import type { ExcalidrawElement, ExcalidrawLinearElement, ExcalidrawTextContainer, ExcalidrawTextElement, ExcalidrawTextElementWithContainer, NonDeleted, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
+import type { ActionResult } from "./types";
+import type { AppClassProperties, AppState } from "../types";
+/**
+ * Frees the container's text as it rendered: wrapped the same, at a fixed
+ * width.
+ */
+export declare const unbindTextFromContainer: (container: ExcalidrawElement, boundTextElement: ExcalidrawTextElementWithContainer, scene: Scene) => void;
 export declare const actionUnbindText: {
     name: "unbindText";
     label: string;
     trackEvent: {
         category: "element";
     };
-    predicate: (elements: readonly ExcalidrawElement[], appState: AppState, _: import("../types").ExcalidrawProps, app: import("../types").AppClassProperties) => boolean;
-    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: import("../types").AppClassProperties) => {
+    predicate: (elements: readonly ExcalidrawElement[], appState: AppState, _: import("../types").ExcalidrawProps, app: AppClassProperties) => boolean;
+    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: AppClassProperties) => {
         elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[];
-        appState: Readonly<AppState>;
-        captureUpdate: "IMMEDIATELY";
-    };
-} & {
-    keyTest?: undefined;
-};
-export declare const actionBindText: {
-    name: "bindText";
-    label: string;
-    trackEvent: {
-        category: "element";
-    };
-    predicate: (elements: readonly ExcalidrawElement[], appState: AppState, _: import("../types").ExcalidrawProps, app: import("../types").AppClassProperties) => boolean;
-    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: import("../types").AppClassProperties) => {
-        elements: ExcalidrawElement[];
         appState: {
-            selectedElementIds: {
-                [x: string]: true;
-            };
+            selectedElementIds: AppState["selectedElementIds"];
+            editingGroupId: AppState["editingGroupId"];
+            selectedGroupIds: AppState["selectedGroupIds"];
+            selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -38,13 +30,13 @@ export declare const actionBindText: {
             isLoading: boolean;
             errorMessage: React.ReactNode;
             activeEmbeddable: {
-                element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
+                element: NonDeletedExcalidrawElement;
                 state: "hover" | "active";
             } | null;
-            newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
-            resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            multiElement: import("@excalidraw/element/types").NonDeleted<ExcalidrawLinearElement> | null;
-            selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
+            newElement: NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
+            resizingElement: NonDeletedExcalidrawElement | null;
+            multiElement: NonDeleted<ExcalidrawLinearElement> | null;
+            selectionElement: NonDeletedExcalidrawElement | null;
             isBindingEnabled: boolean;
             boxSelectionMode: import("../types").BoxSelectionMode;
             bindingPreference: "enabled" | "disabled";
@@ -52,7 +44,7 @@ export declare const actionBindText: {
             showHints: boolean;
             inputDevice: import("../types").InputDevice;
             suggestedBinding: {
-                element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
+                element: NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@excalidraw/math").GlobalPoint;
             } | null;
             textToolHover: {
@@ -66,7 +58,7 @@ export declare const actionBindText: {
                 elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
                 anchor: "start" | "end" | "label";
             } | null;
-            frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
+            frameToHighlight: NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
             frameRendering: {
                 enabled: boolean;
                 name: boolean;
@@ -74,7 +66,7 @@ export declare const actionBindText: {
                 clip: boolean;
             };
             editingFrame: import("@excalidraw/element/types").ExcalidrawFrameLikeElement["id"] | null;
-            elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | null;
+            elementsToHighlight: readonly NonDeletedExcalidrawElement[] | null;
             editingTextElement: ExcalidrawTextElement | null;
             activeTool: {
                 lastActiveTool: import("../types").ActiveTool | null;
@@ -163,10 +155,6 @@ export declare const actionBindText: {
             gridStep: number;
             gridModeEnabled: boolean;
             viewModeEnabled: boolean;
-            selectedGroupIds: {
-                [groupId: string]: boolean;
-            };
-            editingGroupId: import("@excalidraw/element/types").GroupId | null;
             width: number;
             height: number;
             offsetTop: number;
@@ -178,7 +166,6 @@ export declare const actionBindText: {
                 panels: number;
             };
             showHyperlinkPopup: false | "info" | "editor";
-            selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             snapLines: readonly import("../snapping").SnapLine[];
             originSnapOffset: {
                 x: number;
@@ -210,197 +197,35 @@ export declare const actionBindText: {
 } & {
     keyTest?: undefined;
 };
+export declare const actionBindText: {
+    name: "bindText";
+    label: string;
+    trackEvent: {
+        category: "element";
+    };
+    predicate: (elements: readonly ExcalidrawElement[], appState: AppState, _: import("../types").ExcalidrawProps, app: AppClassProperties) => boolean;
+    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: AppClassProperties) => ActionResult;
+} & {
+    keyTest?: undefined;
+};
+/**
+ * A note and its label share one ink: the text the user styled wins, unless it
+ * is transparent (a note's label never is).
+ */
+export declare const getStickyNoteInk: (textElement: ExcalidrawTextElement, container: ExcalidrawElement) => string | null;
+/** binds the text to the (label-less) container, selecting the container */
+export declare const bindTextToContainer: (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, textElement: ExcalidrawTextElement, container: NonDeleted<ExcalidrawTextContainer>, app: AppClassProperties) => ActionResult;
+export declare const pushContainerBelowText: (elements: readonly ExcalidrawElement[], container: ExcalidrawElement, textElement: ExcalidrawTextElement) => ExcalidrawElement[];
 export declare const actionWrapTextInContainer: {
     name: "wrapTextInContainer";
     label: string;
     trackEvent: {
         category: "element";
     };
-    predicate: (elements: readonly ExcalidrawElement[], appState: AppState, _: import("../types").ExcalidrawProps, app: import("../types").AppClassProperties) => boolean;
-    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: import("../types").AppClassProperties) => {
-        elements: readonly ExcalidrawElement[];
-        appState: {
-            selectedElementIds: Mutable<Readonly<{
-                [id: string]: true;
-            }>>;
-            contextMenu: {
-                items: import("../components/ContextMenu").ContextMenuItems;
-                top: number;
-                left: number;
-            } | null;
-            showWelcomeScreen: boolean;
-            isLoading: boolean;
-            errorMessage: React.ReactNode;
-            activeEmbeddable: {
-                element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
-                state: "hover" | "active";
-            } | null;
-            newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
-            resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            multiElement: import("@excalidraw/element/types").NonDeleted<ExcalidrawLinearElement> | null;
-            selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
-            isBindingEnabled: boolean;
-            boxSelectionMode: import("../types").BoxSelectionMode;
-            bindingPreference: "enabled" | "disabled";
-            isMidpointSnappingEnabled: boolean;
-            showHints: boolean;
-            inputDevice: import("../types").InputDevice;
-            suggestedBinding: {
-                element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
-                midPoint?: import("@excalidraw/math").GlobalPoint;
-            } | null;
-            textToolHover: {
-                type: "text";
-                elementId: ExcalidrawElement["id"];
-            } | {
-                type: "container";
-                elementId: ExcalidrawElement["id"];
-            } | {
-                type: "arrow";
-                elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
-                anchor: "start" | "end" | "label";
-            } | null;
-            frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
-            frameRendering: {
-                enabled: boolean;
-                name: boolean;
-                outline: boolean;
-                clip: boolean;
-            };
-            editingFrame: import("@excalidraw/element/types").ExcalidrawFrameLikeElement["id"] | null;
-            elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | null;
-            editingTextElement: ExcalidrawTextElement | null;
-            activeTool: {
-                lastActiveTool: import("../types").ActiveTool | null;
-                locked: boolean;
-                fromSelection: boolean;
-            } & import("../types").ActiveTool;
-            preferredSelectionTool: {
-                type: "selection" | "lasso";
-                initialized: boolean;
-            };
-            penMode: boolean;
-            penDetected: boolean;
-            exportBackground: boolean;
-            exportEmbedScene: boolean;
-            exportWithDarkMode: boolean;
-            exportScale: number;
-            currentItemStrokeColor: string;
-            currentItemStickynoteStrokeColor: string;
-            currentItemStickynoteBackgroundColor: string;
-            currentItemBackgroundColor: string;
-            currentItemFillStyle: ExcalidrawElement["fillStyle"];
-            currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
-            currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
-            currentItemRoughness: number;
-            currentItemStrokeVariability: import("@excalidraw/element/types").StrokeVariability;
-            currentItemOpacity: number;
-            currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
-            currentItemFontSize: number;
-            currentItemTextAlign: import("@excalidraw/element/types").TextAlign;
-            currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
-            currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
-            currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
-            currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
-            currentItemArrowType: "sharp" | "round" | "elbow";
-            viewBackgroundColor: string;
-            scrollX: number;
-            scrollY: number;
-            scrollConstraints: import("../types").ScrollConstraints | null;
-            cursorButton: "up" | "down";
-            scrolledOutside: boolean;
-            name: string | null;
-            isResizing: boolean;
-            isRotating: boolean;
-            zoom: import("../types").Zoom;
-            openMenu: "canvas" | null;
-            openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
-            openSidebar: {
-                name: import("../types").SidebarName;
-                tab?: import("../types").SidebarTabName;
-            } | null;
-            openDialog: null | {
-                name: "imageExport" | "help" | "jsonExport";
-            } | {
-                name: "ttd";
-                tab: "text-to-diagram" | "mermaid";
-            } | {
-                name: "commandPalette";
-            } | {
-                name: "settings";
-            } | {
-                name: "elementLinkSelector";
-                sourceElementId: ExcalidrawElement["id"];
-            } | {
-                name: "charts";
-                data: import("../charts").Spreadsheet;
-                rawText: string;
-            };
-            defaultSidebarDockedPreference: boolean;
-            lastPointerDownWith: import("@excalidraw/element/types").PointerType;
-            hoveredElementIds: Readonly<{
-                [id: string]: true;
-            }>;
-            previousSelectedElementIds: {
-                [id: string]: true;
-            };
-            selectedElementsAreBeingDragged: boolean;
-            shouldCacheIgnoreZoom: boolean;
-            toast: {
-                message: React.ReactNode;
-                closable?: boolean;
-                duration?: number;
-            } | null;
-            zenModeEnabled: boolean;
-            theme: import("@excalidraw/element/types").Theme;
-            gridSize: number;
-            gridStep: number;
-            gridModeEnabled: boolean;
-            viewModeEnabled: boolean;
-            selectedGroupIds: {
-                [groupId: string]: boolean;
-            };
-            editingGroupId: import("@excalidraw/element/types").GroupId | null;
-            width: number;
-            height: number;
-            offsetTop: number;
-            offsetLeft: number;
-            fileHandle: FileSystemFileHandle | null;
-            collaborators: Map<import("../types").SocketId, import("../types").Collaborator>;
-            stats: {
-                open: boolean;
-                panels: number;
-            };
-            showHyperlinkPopup: false | "info" | "editor";
-            selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
-            snapLines: readonly import("../snapping").SnapLine[];
-            originSnapOffset: {
-                x: number;
-                y: number;
-            } | null;
-            objectsSnapModeEnabled: boolean;
-            isCropping: boolean;
-            croppingElementId: ExcalidrawElement["id"] | null;
-            searchMatches: Readonly<{
-                focusedId: ExcalidrawElement["id"] | null;
-                matches: readonly import("../types").SearchMatch[];
-            }> | null;
-            activeLockedId: string | null;
-            lockedMultiSelections: {
-                [groupId: string]: true;
-            };
-            bindMode: import("@excalidraw/element/types").BindMode;
-            colorTopPicks: {
-                elementStroke: readonly string[] | null;
-                elementBackground: readonly string[] | null;
-                bucketFill: readonly string[] | null;
-                stickyNoteStroke: readonly string[] | null;
-                stickyNoteBackground: readonly string[] | null;
-            };
-            fontTopPicks: readonly import("@excalidraw/element/types").FontFamilyValues[] | null;
-        };
-        captureUpdate: "IMMEDIATELY";
-    };
+    predicate: (elements: readonly ExcalidrawElement[], appState: AppState, _: import("../types").ExcalidrawProps, app: AppClassProperties) => boolean;
+    perform: (elements: readonly import("@excalidraw/element/types").OrderedExcalidrawElement[], appState: Readonly<AppState>, _: unknown, app: AppClassProperties) => ActionResult;
 } & {
     keyTest?: undefined;
 };
+/** wraps each (unbound) text in a new container, selecting the containers */
+export declare const wrapTextsInContainers: (elements: readonly ExcalidrawElement[], appState: Readonly<AppState>, textElements: readonly ExcalidrawTextElement[], app: AppClassProperties) => ActionResult;

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

@@ -48,6 +48,11 @@ export declare const actionClearCanvas: {
             };
             name: string | null;
             zoom: import("../types").Zoom;
+            isBindingEnabled: boolean;
+            isMidpointSnappingEnabled: boolean;
+            selectedElementIds: Readonly<{
+                [id: string]: true;
+            }>;
             scrollX: number;
             scrollY: number;
             viewModeEnabled: boolean;
@@ -69,9 +74,6 @@ export declare const actionClearCanvas: {
                 rawText: string;
             };
             editingGroupId: import("@excalidraw/element/types").GroupId | null;
-            selectedElementIds: Readonly<{
-                [id: string]: true;
-            }>;
             frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
             activeEmbeddable: {
                 element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
@@ -84,8 +86,6 @@ export declare const actionClearCanvas: {
             selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
             multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
             newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
-            isBindingEnabled: boolean;
-            isMidpointSnappingEnabled: boolean;
             suggestedBinding: {
                 element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
                 midPoint?: import("@excalidraw/math").GlobalPoint;
@@ -120,7 +120,6 @@ export declare const actionClearCanvas: {
             shouldCacheIgnoreZoom: boolean;
             exportScale: number;
             currentItemArrowType: "sharp" | "round" | "elbow";
-            bindMode: import("@excalidraw/element/types").BindMode;
             contextMenu: {
                 items: import("../components/ContextMenu").ContextMenuItems;
                 top: number;
@@ -188,6 +187,7 @@ export declare const actionClearCanvas: {
             lockedMultiSelections: {
                 [groupId: string]: true;
             };
+            bindMode: import("@excalidraw/element/types").BindMode;
         };
         captureUpdate: "IMMEDIATELY";
     };