@excalidraw/common 0.18.0-51ad895 → 0.18.0-6135548
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/dev/index.js +1128 -302
- package/dist/dev/index.js.map +4 -4
- package/dist/prod/index.js +3 -3
- package/dist/types/common/src/bounds.d.ts +10 -0
- package/dist/types/common/src/colors.d.ts +59 -39
- package/dist/types/common/src/constants.d.ts +14 -12
- package/dist/types/common/src/editorInterface.d.ts +1 -1
- package/dist/types/common/src/font-metadata.d.ts +1 -3
- package/dist/types/common/src/index.d.ts +1 -1
- package/dist/types/common/src/keys.d.ts +1 -1
- package/dist/types/common/src/utility-types.d.ts +0 -1
- package/dist/types/common/src/utils.d.ts +44 -35
- package/dist/types/element/src/Scene.d.ts +4 -4
- package/dist/types/element/src/binding.d.ts +6 -4
- package/dist/types/element/src/bounds.d.ts +2 -10
- package/dist/types/element/src/collision.d.ts +2 -2
- package/dist/types/element/src/comparisons.d.ts +7 -7
- package/dist/types/element/src/dragElements.d.ts +3 -3
- package/dist/types/element/src/duplicate.d.ts +3 -3
- package/dist/types/element/src/fractionalIndex.d.ts +2 -2
- package/dist/types/element/src/frame.d.ts +7 -3
- package/dist/types/element/src/heading.d.ts +2 -1
- package/dist/types/element/src/image.d.ts +1 -11
- package/dist/types/element/src/index.d.ts +1 -0
- package/dist/types/element/src/linearElementEditor.d.ts +1 -2
- package/dist/types/element/src/mutateElement.d.ts +3 -1
- package/dist/types/element/src/newElement.d.ts +6 -6
- package/dist/types/element/src/renderElement.d.ts +0 -6
- package/dist/types/element/src/resizeElements.d.ts +10 -10
- package/dist/types/element/src/resizeTest.d.ts +1 -1
- package/dist/types/element/src/selection.d.ts +3 -7
- package/dist/types/element/src/shape.d.ts +8 -7
- package/dist/types/element/src/textMeasurements.d.ts +1 -3
- package/dist/types/{excalidraw/data → element/src}/transform.d.ts +3 -3
- package/dist/types/element/src/transformHandles.d.ts +3 -23
- package/dist/types/element/src/typeChecks.d.ts +2 -4
- package/dist/types/element/src/utils.d.ts +3 -1
- package/dist/types/excalidraw/actions/actionAddToLibrary.d.ts +114 -178
- package/dist/types/excalidraw/actions/actionAlign.d.ts +0 -1
- package/dist/types/excalidraw/actions/actionBoundText.d.ts +44 -87
- package/dist/types/excalidraw/actions/actionCanvas.d.ts +263 -510
- package/dist/types/excalidraw/actions/actionClipboard.d.ts +85 -128
- package/dist/types/excalidraw/actions/actionCropEditor.d.ts +21 -43
- package/dist/types/excalidraw/actions/actionDeleteSelected.d.ts +74 -142
- package/dist/types/excalidraw/actions/actionDistribute.d.ts +0 -1
- package/dist/types/excalidraw/actions/actionDuplicateSelection.d.ts +2 -3
- package/dist/types/excalidraw/actions/actionElementLink.d.ts +41 -63
- package/dist/types/excalidraw/actions/actionElementLock.d.ts +45 -88
- package/dist/types/excalidraw/actions/actionEmbeddable.d.ts +41 -63
- package/dist/types/excalidraw/actions/actionExport.d.ts +85 -170
- package/dist/types/excalidraw/actions/actionFinalize.d.ts +1 -2
- package/dist/types/excalidraw/actions/actionFlip.d.ts +0 -1
- package/dist/types/excalidraw/actions/actionFrame.d.ts +208 -329
- package/dist/types/excalidraw/actions/actionGroup.d.ts +48 -99
- package/dist/types/excalidraw/actions/actionLinearEditor.d.ts +149 -207
- package/dist/types/excalidraw/actions/actionLink.d.ts +43 -65
- package/dist/types/excalidraw/actions/actionMenu.d.ts +35 -57
- package/dist/types/excalidraw/actions/actionNavigate.d.ts +14 -17
- package/dist/types/excalidraw/actions/actionProperties.d.ts +59 -102
- package/dist/types/excalidraw/actions/actionSelectAll.d.ts +24 -50
- package/dist/types/excalidraw/actions/actionStyles.d.ts +20 -42
- package/dist/types/excalidraw/actions/actionTextAutoResize.d.ts +3 -3
- package/dist/types/excalidraw/actions/actionToggleGridMode.d.ts +41 -63
- package/dist/types/excalidraw/actions/actionToggleObjectsSnapMode.d.ts +41 -63
- package/dist/types/excalidraw/actions/actionToggleSearchMenu.d.ts +35 -57
- package/dist/types/excalidraw/actions/actionToggleStats.d.ts +40 -62
- package/dist/types/excalidraw/actions/actionToggleViewMode.d.ts +41 -63
- package/dist/types/excalidraw/actions/actionToggleZenMode.d.ts +41 -63
- package/dist/types/excalidraw/actions/actionZindex.d.ts +8 -9
- package/dist/types/excalidraw/actions/manager.d.ts +1 -1
- package/dist/types/excalidraw/actions/register.d.ts +2 -2
- package/dist/types/excalidraw/appState.d.ts +12 -12
- package/dist/types/excalidraw/clipboard.d.ts +7 -31
- package/dist/types/excalidraw/components/Actions.d.ts +1 -1
- package/dist/types/excalidraw/components/App.d.ts +32 -40
- package/dist/types/excalidraw/components/Card.d.ts +1 -3
- package/dist/types/excalidraw/components/ColorPicker/ColorInput.d.ts +2 -4
- package/dist/types/excalidraw/components/ColorPicker/ColorPicker.d.ts +0 -1
- package/dist/types/excalidraw/components/ColorPicker/colorPickerUtils.d.ts +0 -1
- package/dist/types/excalidraw/components/ColorPicker/keyboardNavHandlers.d.ts +0 -1
- package/dist/types/excalidraw/components/CommandPalette/types.d.ts +0 -1
- package/dist/types/excalidraw/components/ConvertElementTypePopup.d.ts +2 -2
- package/dist/types/excalidraw/components/DarkModeToggle.d.ts +1 -1
- package/dist/types/excalidraw/components/DefaultSidebar.d.ts +9 -13
- package/dist/types/excalidraw/components/ElementLinkDialog.d.ts +1 -1
- package/dist/types/excalidraw/components/Ellipsify.d.ts +1 -2
- package/dist/types/excalidraw/components/ErrorDialog.d.ts +1 -1
- package/dist/types/excalidraw/components/ExcalidrawLogo.d.ts +0 -1
- package/dist/types/excalidraw/components/EyeDropper.d.ts +0 -1
- package/dist/types/excalidraw/components/FilledButton.d.ts +1 -0
- package/dist/types/excalidraw/components/FontPicker/keyboardNavHandlers.d.ts +0 -1
- package/dist/types/excalidraw/components/HelpDialog.d.ts +1 -1
- package/dist/types/excalidraw/components/InlineIcon.d.ts +2 -2
- package/dist/types/excalidraw/components/LibraryMenuControlButtons.d.ts +1 -1
- package/dist/types/excalidraw/components/LibraryMenuHeaderContent.d.ts +1 -2
- package/dist/types/excalidraw/components/LibraryUnit.d.ts +2 -3
- package/dist/types/excalidraw/components/LoadingMessage.d.ts +0 -1
- package/dist/types/excalidraw/components/MobileToolBar.d.ts +0 -1
- package/dist/types/excalidraw/components/Modal.d.ts +0 -1
- package/dist/types/excalidraw/components/OverwriteConfirm/OverwriteConfirm.d.ts +1 -1
- package/dist/types/excalidraw/components/RadioGroup.d.ts +0 -1
- package/dist/types/excalidraw/components/RadioSelection.d.ts +4 -4
- package/dist/types/excalidraw/components/ScrollableList.d.ts +0 -1
- package/dist/types/excalidraw/components/Sidebar/Sidebar.d.ts +15 -21
- package/dist/types/excalidraw/components/Sidebar/SidebarHeader.d.ts +1 -1
- package/dist/types/excalidraw/components/Sidebar/SidebarTab.d.ts +1 -2
- package/dist/types/excalidraw/components/Sidebar/SidebarTabTrigger.d.ts +1 -2
- package/dist/types/excalidraw/components/Sidebar/SidebarTabTriggers.d.ts +1 -2
- package/dist/types/excalidraw/components/Sidebar/SidebarTabs.d.ts +1 -2
- package/dist/types/excalidraw/components/Spinner.d.ts +4 -4
- package/dist/types/excalidraw/components/Stats/CanvasGrid.d.ts +0 -1
- package/dist/types/excalidraw/components/Stats/Collapsible.d.ts +0 -1
- package/dist/types/excalidraw/components/Stats/DragInput.d.ts +0 -1
- package/dist/types/excalidraw/components/Stats/index.d.ts +7 -8
- package/dist/types/excalidraw/components/TTDDialog/Chat/ChatHistoryMenu.d.ts +15 -0
- package/dist/types/excalidraw/components/TTDDialog/Chat/ChatInterface.d.ts +27 -0
- package/dist/types/excalidraw/components/TTDDialog/Chat/ChatMessage.d.ts +14 -0
- package/dist/types/excalidraw/components/TTDDialog/Chat/TTDChatPanel.d.ts +26 -0
- package/dist/types/excalidraw/components/TTDDialog/Chat/index.d.ts +3 -0
- package/dist/types/excalidraw/components/TTDDialog/Chat/useChatAgent.d.ts +8 -0
- package/dist/types/excalidraw/components/TTDDialog/MermaidToExcalidraw.d.ts +3 -2
- package/dist/types/excalidraw/components/TTDDialog/TTDContext.d.ts +13 -0
- package/dist/types/excalidraw/components/TTDDialog/TTDDialog.d.ts +4 -25
- package/dist/types/excalidraw/components/TTDDialog/TTDDialogOutput.d.ts +2 -2
- package/dist/types/excalidraw/components/TTDDialog/TTDDialogPanel.d.ts +13 -9
- package/dist/types/excalidraw/components/TTDDialog/TTDDialogTab.d.ts +1 -2
- package/dist/types/excalidraw/components/TTDDialog/TTDDialogTabTrigger.d.ts +1 -2
- package/dist/types/excalidraw/components/TTDDialog/TTDDialogTabTriggers.d.ts +1 -2
- package/dist/types/excalidraw/components/TTDDialog/TTDDialogTrigger.d.ts +1 -1
- package/dist/types/excalidraw/components/TTDDialog/TTDPreviewPanel.d.ts +9 -0
- package/dist/types/excalidraw/components/TTDDialog/TextToDiagram.d.ts +8 -0
- package/dist/types/excalidraw/components/TTDDialog/common.d.ts +16 -16
- package/dist/types/excalidraw/components/TTDDialog/hooks/useChatManagement.d.ts +13 -0
- package/dist/types/excalidraw/components/TTDDialog/hooks/useMermaidRenderer.d.ts +14 -0
- package/dist/types/excalidraw/components/TTDDialog/hooks/useTextGeneration.d.ts +7 -0
- package/dist/types/excalidraw/components/TTDDialog/types.d.ts +91 -0
- package/dist/types/excalidraw/components/TTDDialog/useTTDChatStorage.d.ts +22 -0
- package/dist/types/excalidraw/components/TTDDialog/utils/TTDStreamFetch.d.ts +24 -0
- package/dist/types/excalidraw/components/TTDDialog/utils/chat.d.ts +10 -0
- package/dist/types/excalidraw/components/TTDDialog/utils/mermaidValidation.d.ts +1 -0
- package/dist/types/excalidraw/components/Toast.d.ts +3 -3
- package/dist/types/excalidraw/components/Trans.d.ts +2 -2
- package/dist/types/excalidraw/components/dropdownMenu/DropdownMenu.d.ts +30 -33
- package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuContent.d.ts +5 -5
- package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuGroup.d.ts +3 -3
- package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItem.d.ts +12 -19
- package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItemContent.d.ts +5 -4
- package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItemContentRadio.d.ts +0 -1
- package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItemCustom.d.ts +2 -2
- package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItemLink.d.ts +6 -6
- package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuTrigger.d.ts +3 -4
- package/dist/types/excalidraw/components/dropdownMenu/common.d.ts +1 -1
- package/dist/types/excalidraw/components/hoc/withInternalFallback.d.ts +1 -1
- package/dist/types/excalidraw/components/hyperlink/helpers.d.ts +1 -1
- package/dist/types/excalidraw/components/icons.d.ts +16 -12
- package/dist/types/excalidraw/components/live-collaboration/LiveCollaborationTrigger.d.ts +2 -13
- package/dist/types/excalidraw/components/main-menu/DefaultItems.d.ts +2 -2
- package/dist/types/excalidraw/components/main-menu/MainMenu.d.ts +26 -29
- package/dist/types/excalidraw/components/shapes.d.ts +1 -1
- package/dist/types/excalidraw/components/welcome-screen/WelcomeScreen.Center.d.ts +6 -6
- package/dist/types/excalidraw/components/welcome-screen/WelcomeScreen.d.ts +15 -16
- package/dist/types/excalidraw/data/blob.d.ts +321 -3
- package/dist/types/excalidraw/data/encode.d.ts +4 -4
- package/dist/types/excalidraw/data/encryption.d.ts +5 -5
- package/dist/types/excalidraw/data/filesystem.d.ts +2 -2
- package/dist/types/excalidraw/data/index.d.ts +3 -3
- package/dist/types/excalidraw/data/json.d.ts +159 -2
- package/dist/types/excalidraw/data/library.d.ts +24 -9
- package/dist/types/excalidraw/data/restore.d.ts +25 -10
- package/dist/types/excalidraw/editor-jotai.d.ts +11 -11
- package/dist/types/excalidraw/errors.d.ts +14 -0
- package/dist/types/excalidraw/hooks/useOutsideClick.d.ts +1 -2
- package/dist/types/excalidraw/hooks/useScrollPosition.d.ts +1 -2
- package/dist/types/excalidraw/i18n.d.ts +2 -2
- package/dist/types/excalidraw/index.d.ts +4 -4
- package/dist/types/excalidraw/renderer/helpers.d.ts +6 -4
- package/dist/types/excalidraw/renderer/interactiveScene.d.ts +8 -6
- package/dist/types/excalidraw/scene/Renderer.d.ts +5 -2
- package/dist/types/excalidraw/scene/export.d.ts +2 -2
- package/dist/types/excalidraw/scene/scroll.d.ts +1 -6
- package/dist/types/excalidraw/scene/types.d.ts +7 -2
- package/dist/types/excalidraw/snapping.d.ts +5 -5
- package/dist/types/excalidraw/subset/harfbuzz/harfbuzz-bindings.d.ts +1 -1
- package/dist/types/excalidraw/subset/harfbuzz/harfbuzz-loader.d.ts +1 -1
- package/dist/types/excalidraw/subset/harfbuzz/harfbuzz-wasm.d.ts +1 -1
- package/dist/types/excalidraw/subset/woff2/woff2-loader.d.ts +2 -2
- package/dist/types/excalidraw/subset/woff2/woff2-wasm.d.ts +1 -1
- package/dist/types/excalidraw/types.d.ts +1 -2
- package/dist/types/excalidraw/wysiwyg/textWysiwyg.d.ts +2 -2
- package/dist/types/math/src/polygon.d.ts +2 -2
- package/dist/types/math/src/range.d.ts +1 -3
- package/dist/types/math/src/segment.d.ts +3 -3
- package/dist/types/utils/src/bbox.d.ts +1 -1
- package/dist/types/utils/src/export.d.ts +5 -5
- package/dist/types/utils/src/shape.d.ts +6 -6
- package/dist/types/utils/src/withinBounds.d.ts +2 -2
- package/package.json +7 -1
- package/dist/types/common/src/visualdebug.d.ts +0 -41
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
import type { FontFamilyValues, FontString } from "@excalidraw/element/types";
|
|
2
2
|
import type { ActiveTool, AppState, ToolType, UnsubscribeCallback, Zoom } from "@excalidraw/excalidraw/types";
|
|
3
|
-
import type { MaybePromise } from "./utility-types";
|
|
3
|
+
import type { MaybePromise, ResolutionType } from "./utility-types";
|
|
4
4
|
import type { EVENT } from "./constants";
|
|
5
5
|
export declare const setDateTimeForTests: (dateTime: string) => void;
|
|
6
6
|
export declare const getDateTime: () => string;
|
|
7
7
|
export declare const capitalizeString: (str: string) => string;
|
|
8
8
|
export declare const isToolIcon: (target: Element | EventTarget | null) => target is HTMLElement;
|
|
9
|
-
export declare const isInputLike: (target: Element | EventTarget | null) => target is
|
|
9
|
+
export declare const isInputLike: (target: Element | EventTarget | null) => target is HTMLInputElement | HTMLTextAreaElement | HTMLSelectElement | HTMLBRElement | HTMLDivElement;
|
|
10
10
|
export declare const isInteractive: (target: Element | EventTarget | null) => boolean;
|
|
11
|
-
export declare const isWritableElement: (target: Element | EventTarget | null) => target is
|
|
11
|
+
export declare const isWritableElement: (target: Element | EventTarget | null) => target is HTMLInputElement | HTMLTextAreaElement | HTMLBRElement | HTMLDivElement;
|
|
12
12
|
export declare const getFontFamilyString: ({ fontFamily, }: {
|
|
13
13
|
fontFamily: FontFamilyValues;
|
|
14
14
|
}) => string;
|
|
@@ -71,18 +71,20 @@ export declare const easeToValuesRAF: <T extends Record<keyof T, number>, K exte
|
|
|
71
71
|
* Interpolate a single value.
|
|
72
72
|
* Return undefined to be handled by the default interpolator.
|
|
73
73
|
*/
|
|
74
|
-
interpolateValue?: (
|
|
74
|
+
interpolateValue?: (fromValue: number, toValue: number,
|
|
75
|
+
/** no easing applied */
|
|
76
|
+
progress: number, key: K) => number | undefined;
|
|
75
77
|
onStep: (values: T) => void;
|
|
76
|
-
duration?: number
|
|
77
|
-
onStart?: (
|
|
78
|
-
onEnd?: (
|
|
79
|
-
onCancel?: (
|
|
78
|
+
duration?: number;
|
|
79
|
+
onStart?: () => void;
|
|
80
|
+
onEnd?: () => void;
|
|
81
|
+
onCancel?: () => void;
|
|
80
82
|
}) => () => void;
|
|
81
|
-
export declare const chunk: <T extends
|
|
83
|
+
export declare const chunk: <T extends any>(array: readonly T[], size: number) => T[][];
|
|
82
84
|
export declare const selectNode: (node: Element) => void;
|
|
83
85
|
export declare const removeSelection: () => void;
|
|
84
86
|
export declare const distance: (x: number, y: number) => number;
|
|
85
|
-
export declare const isSelectionLikeTool: (type: ToolType | "custom") =>
|
|
87
|
+
export declare const isSelectionLikeTool: (type: ToolType | "custom") => type is "selection" | "lasso";
|
|
86
88
|
export declare const updateActiveTool: (appState: Pick<AppState, "activeTool">, data: (({
|
|
87
89
|
type: ToolType;
|
|
88
90
|
} | {
|
|
@@ -140,8 +142,7 @@ export declare const muteFSAbortError: (error?: Error) => void;
|
|
|
140
142
|
export declare const findIndex: <T>(array: readonly T[], cb: (element: T, index: number, array: readonly T[]) => boolean, fromIndex?: number) => number;
|
|
141
143
|
export declare const findLastIndex: <T>(array: readonly T[], cb: (element: T, index: number, array: readonly T[]) => boolean, fromIndex?: number) => number;
|
|
142
144
|
/** returns the first non-null mapped value */
|
|
143
|
-
export declare const mapFind: <T, K>(collection: readonly T[], iteratee: (value: T, index: number) => K |
|
|
144
|
-
export declare const isTransparent: (color: string) => boolean;
|
|
145
|
+
export declare const mapFind: <T, K>(collection: readonly T[], iteratee: (value: T, index: number) => K | undefined | null) => K | undefined;
|
|
145
146
|
export type ResolvablePromise<T> = Promise<T> & {
|
|
146
147
|
resolve: [T] extends [undefined] ? (value?: MaybePromise<Awaited<T>>) => void : (value: MaybePromise<Awaited<T>>) => void;
|
|
147
148
|
reject: (error: Error) => void;
|
|
@@ -159,16 +160,16 @@ export declare const getUpdatedTimestamp: () => number;
|
|
|
159
160
|
* Transforms array of objects containing `id` attribute,
|
|
160
161
|
* or array of ids (strings), into a Map, keyd by `id`.
|
|
161
162
|
*/
|
|
162
|
-
export declare const arrayToMap: <T extends
|
|
163
|
+
export declare const arrayToMap: <T extends {
|
|
163
164
|
id: string;
|
|
164
|
-
}>(items: Map<string, T>
|
|
165
|
+
} | string>(items: readonly T[] | Map<string, T>) => Map<string, T>;
|
|
165
166
|
export declare const arrayToMapWithIndex: <T extends {
|
|
166
167
|
id: string;
|
|
167
168
|
}>(elements: readonly T[]) => Map<string, [element: T, index: number]>;
|
|
168
169
|
/**
|
|
169
170
|
* Transform array into an object, use only when array order is irrelevant.
|
|
170
171
|
*/
|
|
171
|
-
export declare const arrayToObject: <T>(array: readonly T[], groupBy?: (
|
|
172
|
+
export declare const arrayToObject: <T>(array: readonly T[], groupBy?: (value: T) => string | number) => {
|
|
172
173
|
[key: string]: T;
|
|
173
174
|
};
|
|
174
175
|
/** Doubly linked node */
|
|
@@ -184,11 +185,11 @@ export declare const arrayToList: <T>(array: readonly T[]) => Node<T>[];
|
|
|
184
185
|
* Converts a readonly array or map into an iterable.
|
|
185
186
|
* Useful for avoiding entry allocations when iterating object / map on each iteration.
|
|
186
187
|
*/
|
|
187
|
-
export declare const toIterable: <T>(values: ReadonlyMap<string, T>
|
|
188
|
+
export declare const toIterable: <T>(values: readonly T[] | ReadonlyMap<string, T>) => Iterable<T>;
|
|
188
189
|
/**
|
|
189
190
|
* Converts a readonly array or map into an array.
|
|
190
191
|
*/
|
|
191
|
-
export declare const toArray: <T>(values: ReadonlyMap<string, T>
|
|
192
|
+
export declare const toArray: <T>(values: readonly T[] | ReadonlyMap<string, T>) => T[];
|
|
192
193
|
export declare const isTestEnv: () => boolean;
|
|
193
194
|
export declare const isDevEnv: () => boolean;
|
|
194
195
|
export declare const isProdEnv: () => boolean;
|
|
@@ -198,20 +199,20 @@ export declare const wrapEvent: <T extends Event>(name: EVENT, nativeEvent: T) =
|
|
|
198
199
|
}>;
|
|
199
200
|
export declare const updateObject: <T extends Record<string, any>>(obj: T, updates: Partial<T>) => T;
|
|
200
201
|
export declare const isPrimitive: (val: any) => boolean;
|
|
201
|
-
export declare const getFrame: () => "
|
|
202
|
+
export declare const getFrame: () => "top" | "iframe";
|
|
202
203
|
export declare const isRunningInIframe: () => boolean;
|
|
203
|
-
export declare const isPromiseLike: (value: any) => value is Promise<
|
|
204
|
+
export declare const isPromiseLike: (value: any) => value is Promise<ResolutionType<typeof value>>;
|
|
204
205
|
export declare const queryFocusableElements: (container: HTMLElement | null) => HTMLElement[];
|
|
205
206
|
/**
|
|
206
207
|
* Returns whether object/array is shallow equal.
|
|
207
208
|
* Considers empty object/arrays as equal (whether top-level or second-level).
|
|
208
209
|
*/
|
|
209
|
-
export declare const isShallowEqual: <T extends Record<string, any>, K extends readonly unknown[]>(objA: T, objB: T, comparators?: { [key in keyof T]?: (
|
|
210
|
+
export declare const isShallowEqual: <T extends Record<string, any>, K extends readonly unknown[]>(objA: T, objB: T, comparators?: { [key in keyof T]?: (a: T[key], b: T[key]) => boolean; } | (keyof T extends K[number] ? K extends readonly (keyof T)[] ? K : {
|
|
210
211
|
_error: "keys are either missing or include keys not in compared obj";
|
|
211
212
|
} : {
|
|
212
213
|
_error: "keys are either missing or include keys not in compared obj";
|
|
213
|
-
})
|
|
214
|
-
export declare const composeEventHandlers: <E>(originalEventHandler?: (
|
|
214
|
+
}), debug?: boolean) => boolean;
|
|
215
|
+
export declare const composeEventHandlers: <E>(originalEventHandler?: (event: E) => void, ourEventHandler?: (event: E) => void, { checkForDefaultPrevented }?: {
|
|
215
216
|
checkForDefaultPrevented?: boolean | undefined;
|
|
216
217
|
}) => (event: E) => void;
|
|
217
218
|
/**
|
|
@@ -223,11 +224,15 @@ export declare function invariant(condition: any, message: string): asserts cond
|
|
|
223
224
|
/**
|
|
224
225
|
* Memoizes on values of `opts` object (strict equality).
|
|
225
226
|
*/
|
|
226
|
-
export declare const memoize: <T extends Record<string, any>, R extends
|
|
227
|
+
export declare const memoize: <T extends Record<string, any>, R extends any>(func: (opts: T) => R) => typeof func & {
|
|
227
228
|
clear: () => void;
|
|
228
229
|
};
|
|
229
230
|
/** Checks if value is inside given collection. Useful for type-safety. */
|
|
230
|
-
export declare const isMemberOf: <T extends string>(
|
|
231
|
+
export declare const isMemberOf: <T extends string>(
|
|
232
|
+
/** Set/Map/Array/Object */
|
|
233
|
+
collection: Set<T> | readonly T[] | Record<T, any> | Map<T, any>,
|
|
234
|
+
/** value to look for */
|
|
235
|
+
value: string) => value is T;
|
|
231
236
|
export declare const cloneJSON: <T>(obj: T) => T;
|
|
232
237
|
export declare const updateStable: <T extends any[] | Record<string, any>>(prevValue: T, nextValue: T) => T;
|
|
233
238
|
export declare function addEventListener<K extends keyof WindowEventMap>(target: Window & typeof globalThis, type: K, listener: (this: Window, ev: WindowEventMap[K]) => any, options?: boolean | AddEventListenerOptions): UnsubscribeCallback;
|
|
@@ -238,21 +243,25 @@ export declare function addEventListener<K extends keyof FontFaceSetEventMap>(ta
|
|
|
238
243
|
export declare function addEventListener<K extends keyof HTMLElementEventMap>(target: Document | (Window & typeof globalThis) | HTMLElement | undefined | null | false, type: K, listener: (this: HTMLDivElement, ev: HTMLElementEventMap[K]) => any, options?: boolean | AddEventListenerOptions): UnsubscribeCallback;
|
|
239
244
|
export declare function getSvgPathFromStroke(points: number[][], closed?: boolean): string;
|
|
240
245
|
export declare const normalizeEOL: (str: string) => string;
|
|
241
|
-
type HasBrand<T> = {
|
|
242
|
-
[K in keyof T]: K extends `~brand${infer _}` ? true : never;
|
|
246
|
+
export type HasBrand<T> = {
|
|
247
|
+
[K in keyof T]: K extends `~brand${infer _}` | "_brand" ? true : never;
|
|
243
248
|
}[keyof T];
|
|
244
249
|
type RemoveAllBrands<T> = HasBrand<T> extends true ? {
|
|
245
|
-
[K in keyof T as K extends `~brand~${infer _}` ? never : K]: T[K];
|
|
246
|
-
} :
|
|
247
|
-
type
|
|
250
|
+
[K in keyof T as K extends `~brand~${infer _}` | "_brand" ? never : K]: T[K];
|
|
251
|
+
} : T;
|
|
252
|
+
type UnbrandForValue<T> = T extends Map<infer E, infer F> ? Map<UnbrandForValue<E>, UnbrandForValue<F>> : T extends Set<infer E> ? Set<UnbrandForValue<E>> : T extends readonly any[] ? T extends any[] ? unknown[] : readonly unknown[] : RemoveAllBrands<T>;
|
|
253
|
+
export type Unbrand<T> = T extends Map<infer E, infer F> ? Map<Unbrand<E>, Unbrand<F>> : T extends Set<infer E> ? Set<Unbrand<E>> : T extends readonly (infer E)[] ? Array<Unbrand<E>> : RemoveAllBrands<T>;
|
|
254
|
+
export type CombineBrands<BrandedType, CurrentType> = BrandedType extends readonly (infer BE)[] ? CurrentType extends readonly (infer CE)[] ? Array<CE & BE> : CurrentType & BrandedType : CurrentType & BrandedType;
|
|
255
|
+
export type CombineBrandsIfNeeded<T, Required> = [T] extends [Required] ? T[] : HasBrand<T> extends true ? CombineBrands<T, Required>[] : Required[];
|
|
248
256
|
/**
|
|
249
257
|
* Makes type into a branded type, ensuring that value is assignable to
|
|
250
|
-
* the base
|
|
258
|
+
* the base unbranded type. Optionally you can explicitly supply current value
|
|
251
259
|
* type to combine both (useful for composite branded types. Make sure you
|
|
252
260
|
* compose branded types which are not composite themselves.)
|
|
253
261
|
*/
|
|
254
|
-
export declare
|
|
255
|
-
export declare
|
|
262
|
+
export declare function toBrandedType<BrandedType>(value: UnbrandForValue<BrandedType>): BrandedType;
|
|
263
|
+
export declare function toBrandedType<BrandedType, CurrentType>(value: CurrentType): CombineBrands<BrandedType, CurrentType>;
|
|
264
|
+
export declare const promiseTry: <TValue, TArgs extends unknown[]>(fn: (...args: TArgs) => PromiseLike<TValue> | TValue, ...args: TArgs) => Promise<TValue>;
|
|
256
265
|
export declare const isAnyTrue: (...args: boolean[]) => boolean;
|
|
257
266
|
export declare const safelyParseJSON: (json: string) => Record<string, any> | null;
|
|
258
267
|
/**
|
|
@@ -264,10 +273,10 @@ export declare const castArray: <T>(value: T | T[]) => T[];
|
|
|
264
273
|
/** hack for Array.isArray type guard not working with readonly value[] */
|
|
265
274
|
export declare const isReadonlyArray: (value?: any) => value is readonly any[];
|
|
266
275
|
export declare const sizeOf: (value: readonly unknown[] | Readonly<Map<string, unknown>> | Readonly<Record<string, unknown>> | ReadonlySet<unknown>) => number;
|
|
267
|
-
export declare const reduceToCommonValue: <T, R = T>(collection:
|
|
276
|
+
export declare const reduceToCommonValue: <T, R = T>(collection: readonly T[] | ReadonlySet<T>, getValue?: (item: T) => R) => R | null;
|
|
268
277
|
type FEATURE_FLAGS = {
|
|
269
278
|
COMPLEX_BINDINGS: boolean;
|
|
270
279
|
};
|
|
271
|
-
export declare const getFeatureFlag: <F extends
|
|
272
|
-
export declare const setFeatureFlag: <F extends
|
|
280
|
+
export declare const getFeatureFlag: <F extends keyof FEATURE_FLAGS>(flag: F) => FEATURE_FLAGS[F];
|
|
281
|
+
export declare const setFeatureFlag: <F extends keyof FEATURE_FLAGS>(flag: F, value: FEATURE_FLAGS[F]) => void;
|
|
273
282
|
export {};
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { type ElementUpdate } from "@excalidraw/element";
|
|
2
|
-
import type { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted, ExcalidrawFrameLikeElement, ElementsMapOrArray, OrderedExcalidrawElement, Ordered } from "@excalidraw/element/types";
|
|
2
|
+
import type { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted, ExcalidrawFrameLikeElement, ElementsMapOrArray, SceneElementsMap, NonDeletedSceneElementsMap, OrderedExcalidrawElement, Ordered } from "@excalidraw/element/types";
|
|
3
3
|
import type { Mutable } from "@excalidraw/common/utility-types";
|
|
4
4
|
import type { AppState } from "../../excalidraw/types";
|
|
5
5
|
type SceneStateCallback = () => void;
|
|
@@ -22,9 +22,9 @@ export declare class Scene {
|
|
|
22
22
|
*/
|
|
23
23
|
private sceneNonce;
|
|
24
24
|
getSceneNonce(): number | undefined;
|
|
25
|
-
getNonDeletedElementsMap():
|
|
25
|
+
getNonDeletedElementsMap(): NonDeletedSceneElementsMap;
|
|
26
26
|
getElementsIncludingDeleted(): readonly OrderedExcalidrawElement[];
|
|
27
|
-
getElementsMapIncludingDeleted():
|
|
27
|
+
getElementsMapIncludingDeleted(): SceneElementsMap;
|
|
28
28
|
getNonDeletedElements(): readonly Ordered<NonDeletedExcalidrawElement>[];
|
|
29
29
|
getFramesIncludingDeleted(): readonly ExcalidrawFrameLikeElement[];
|
|
30
30
|
constructor(elements?: ElementsMapOrArray | null, options?: {
|
|
@@ -70,7 +70,7 @@ export declare class Scene {
|
|
|
70
70
|
getElementIndex(elementId: string): number;
|
|
71
71
|
getContainerElement: (element: (ExcalidrawElement & {
|
|
72
72
|
containerId: ExcalidrawElement["id"] | null;
|
|
73
|
-
}) | null) => import("@excalidraw/element/types").
|
|
73
|
+
}) | null) => import("@excalidraw/element/types").ExcalidrawLinearElement | import("@excalidraw/element/types").ExcalidrawSelectionElement | import("@excalidraw/element/types").ExcalidrawRectangleElement | import("@excalidraw/element/types").ExcalidrawDiamondElement | import("@excalidraw/element/types").ExcalidrawEllipseElement | import("@excalidraw/element/types").ExcalidrawEmbeddableElement | import("@excalidraw/element/types").ExcalidrawIframeElement | import("@excalidraw/element/types").ExcalidrawImageElement | import("@excalidraw/element/types").ExcalidrawFrameElement | import("@excalidraw/element/types").ExcalidrawMagicFrameElement | import("@excalidraw/element/types").ExcalidrawTextElement | import("@excalidraw/element/types").ExcalidrawFreeDrawElement | null;
|
|
74
74
|
getElementsFromId: (id: string) => ExcalidrawElement[];
|
|
75
75
|
mutateElement<TElement extends Mutable<ExcalidrawElement>>(element: TElement, updates: ElementUpdate<TElement>, options?: {
|
|
76
76
|
informMutation: boolean;
|
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
import { type GlobalPoint } from "@excalidraw/math";
|
|
2
2
|
import type { LineSegment, LocalPoint } from "@excalidraw/math";
|
|
3
3
|
import type { AppState } from "@excalidraw/excalidraw/types";
|
|
4
|
+
import type { Bounds } from "@excalidraw/common";
|
|
4
5
|
import { type Heading } from "./heading";
|
|
5
6
|
import type { Scene } from "./Scene";
|
|
6
|
-
import type { Bounds } from "./bounds";
|
|
7
7
|
import type { ElementUpdate } from "./mutateElement";
|
|
8
8
|
import type { BindMode, ElementsMap, ExcalidrawArrowElement, ExcalidrawBindableElement, ExcalidrawElbowArrowElement, ExcalidrawElement, FixedPoint, FixedPointBinding, NonDeleted, NonDeletedExcalidrawElement, NonDeletedSceneElementsMap, Ordered, PointsPositionUpdates } from "./types";
|
|
9
9
|
export type BindingStrategy = {
|
|
@@ -30,17 +30,18 @@ export declare const getBindingGap: (bindTarget: ExcalidrawBindableElement, opts
|
|
|
30
30
|
export declare const maxBindingDistance_simple: (zoom?: AppState["zoom"]) => number;
|
|
31
31
|
export declare const shouldEnableBindingForPointerEvent: (event: React.PointerEvent<HTMLElement>) => boolean;
|
|
32
32
|
export declare const isBindingEnabled: (appState: AppState) => boolean;
|
|
33
|
-
export declare const bindOrUnbindBindingElement: (arrow: NonDeleted<ExcalidrawArrowElement>, draggingPoints: PointsPositionUpdates, scene: Scene, appState: AppState, opts?: {
|
|
33
|
+
export declare const bindOrUnbindBindingElement: (arrow: NonDeleted<ExcalidrawArrowElement>, draggingPoints: PointsPositionUpdates, scenePointerX: number, scenePointerY: number, scene: Scene, appState: AppState, opts?: {
|
|
34
34
|
newArrow?: boolean;
|
|
35
35
|
altKey?: boolean;
|
|
36
|
+
angleLocked?: boolean;
|
|
36
37
|
initialBinding?: boolean;
|
|
37
38
|
}) => {
|
|
38
39
|
start: BindingStrategy;
|
|
39
40
|
end: BindingStrategy;
|
|
40
41
|
};
|
|
41
|
-
export declare const getBindingStrategyForDraggingBindingElementEndpoints: (arrow: NonDeleted<ExcalidrawArrowElement>, draggingPoints: PointsPositionUpdates, elementsMap: NonDeletedSceneElementsMap, elements: readonly Ordered<NonDeletedExcalidrawElement>[], appState: AppState, opts?: {
|
|
42
|
+
export declare const getBindingStrategyForDraggingBindingElementEndpoints: (arrow: NonDeleted<ExcalidrawArrowElement>, draggingPoints: PointsPositionUpdates, screenPointerX: number, screenPointerY: number, elementsMap: NonDeletedSceneElementsMap, elements: readonly Ordered<NonDeletedExcalidrawElement>[], appState: AppState, opts?: {
|
|
42
43
|
newArrow?: boolean;
|
|
43
|
-
|
|
44
|
+
angleLocked?: boolean;
|
|
44
45
|
altKey?: boolean;
|
|
45
46
|
finalize?: boolean;
|
|
46
47
|
initialBinding?: boolean;
|
|
@@ -120,3 +121,4 @@ export declare const getGlobalFixedPointForBindableElement: (fixedPointRatio: Fi
|
|
|
120
121
|
export declare const getGlobalFixedPoints: (arrow: ExcalidrawArrowElement, elementsMap: ElementsMap) => [GlobalPoint, GlobalPoint];
|
|
121
122
|
export declare const getArrowLocalFixedPoints: (arrow: ExcalidrawElbowArrowElement, elementsMap: ElementsMap) => LocalPoint[];
|
|
122
123
|
export declare const normalizeFixedPoint: <T extends FixedPoint | null>(fixedPoint: T) => T extends null ? null : FixedPoint;
|
|
124
|
+
export declare const getBindingSideMidPoint: (binding: FixedPointBinding, elementsMap: ElementsMap) => GlobalPoint | LocalPoint | null;
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type Bounds } from "@excalidraw/common";
|
|
1
2
|
import type { Degrees, GlobalPoint, LineSegment, LocalPoint } from "@excalidraw/math";
|
|
2
3
|
import type { AppState } from "@excalidraw/excalidraw/types";
|
|
3
4
|
import type { Drawable, Op } from "roughjs/bin/core";
|
|
@@ -9,15 +10,6 @@ export type RectangleBox = {
|
|
|
9
10
|
height: number;
|
|
10
11
|
angle: number;
|
|
11
12
|
};
|
|
12
|
-
/**
|
|
13
|
-
* x and y position of top left corner, x and y position of bottom right corner
|
|
14
|
-
*/
|
|
15
|
-
export type Bounds = readonly [
|
|
16
|
-
minX: number,
|
|
17
|
-
minY: number,
|
|
18
|
-
maxX: number,
|
|
19
|
-
maxY: number
|
|
20
|
-
];
|
|
21
13
|
export type SceneBounds = readonly [
|
|
22
14
|
sceneX: number,
|
|
23
15
|
sceneY: number,
|
|
@@ -45,7 +37,7 @@ export declare const getElementLineSegments: (element: ExcalidrawElement, elemen
|
|
|
45
37
|
export declare const getRectangleBoxAbsoluteCoords: (boxSceneCoords: RectangleBox) => number[];
|
|
46
38
|
export declare const getDiamondPoints: (element: ExcalidrawElement) => number[];
|
|
47
39
|
export declare const getCubicBezierCurveBound: (p0: GlobalPoint, p1: GlobalPoint, p2: GlobalPoint, p3: GlobalPoint) => Bounds;
|
|
48
|
-
export declare const getMinMaxXYFromCurvePathOps: (ops: Op[], transformXY?: (
|
|
40
|
+
export declare const getMinMaxXYFromCurvePathOps: (ops: Op[], transformXY?: (p: GlobalPoint) => GlobalPoint) => Bounds;
|
|
49
41
|
export declare const getBoundsFromPoints: (points: ExcalidrawFreeDrawElement["points"]) => Bounds;
|
|
50
42
|
/** @returns number in pixels */
|
|
51
43
|
export declare const getArrowheadSize: (arrowhead: Arrowhead) => number;
|
|
@@ -14,8 +14,8 @@ export declare const hitElementItself: ({ point, element, threshold, elementsMap
|
|
|
14
14
|
export declare const hitElementBoundingBox: (point: GlobalPoint, element: ExcalidrawElement, elementsMap: ElementsMap, tolerance?: number) => boolean;
|
|
15
15
|
export declare const hitElementBoundingBoxOnly: (hitArgs: HitTestArgs, elementsMap: ElementsMap) => boolean;
|
|
16
16
|
export declare const hitElementBoundText: (point: GlobalPoint, element: ExcalidrawElement, elementsMap: ElementsMap) => boolean;
|
|
17
|
-
export declare const getAllHoveredElementAtPoint: (point: Readonly<GlobalPoint>, elements: readonly Ordered<NonDeletedExcalidrawElement>[], elementsMap: NonDeletedSceneElementsMap, toleranceFn?: (
|
|
18
|
-
export declare const getHoveredElementForBinding: (point: Readonly<GlobalPoint>, elements: readonly Ordered<NonDeletedExcalidrawElement>[], elementsMap: NonDeletedSceneElementsMap, toleranceFn?: (
|
|
17
|
+
export declare const getAllHoveredElementAtPoint: (point: Readonly<GlobalPoint>, elements: readonly Ordered<NonDeletedExcalidrawElement>[], elementsMap: NonDeletedSceneElementsMap, toleranceFn?: (element: ExcalidrawBindableElement) => number) => NonDeleted<ExcalidrawBindableElement>[];
|
|
18
|
+
export declare const getHoveredElementForBinding: (point: Readonly<GlobalPoint>, elements: readonly Ordered<NonDeletedExcalidrawElement>[], elementsMap: NonDeletedSceneElementsMap, toleranceFn?: (element: ExcalidrawBindableElement) => number) => NonDeleted<ExcalidrawBindableElement> | null;
|
|
19
19
|
/**
|
|
20
20
|
* Intersect a line with an element for binding test
|
|
21
21
|
*
|
|
@@ -1,8 +1,8 @@
|
|
|
1
1
|
import type { ElementOrToolType } from "@excalidraw/excalidraw/types";
|
|
2
|
-
export declare const hasBackground: (type: ElementOrToolType) =>
|
|
3
|
-
export declare const hasStrokeColor: (type: ElementOrToolType) =>
|
|
4
|
-
export declare const hasStrokeWidth: (type: ElementOrToolType) =>
|
|
5
|
-
export declare const hasStrokeStyle: (type: ElementOrToolType) =>
|
|
6
|
-
export declare const canChangeRoundness: (type: ElementOrToolType) =>
|
|
7
|
-
export declare const toolIsArrow: (type: ElementOrToolType) =>
|
|
8
|
-
export declare const canHaveArrowheads: (type: ElementOrToolType) =>
|
|
2
|
+
export declare const hasBackground: (type: ElementOrToolType) => type is "line" | "rectangle" | "diamond" | "ellipse" | "embeddable" | "iframe" | "freedraw";
|
|
3
|
+
export declare const hasStrokeColor: (type: ElementOrToolType) => type is "line" | "arrow" | "text" | "rectangle" | "diamond" | "ellipse" | "embeddable" | "freedraw";
|
|
4
|
+
export declare const hasStrokeWidth: (type: ElementOrToolType) => type is "line" | "arrow" | "rectangle" | "diamond" | "ellipse" | "embeddable" | "iframe" | "freedraw";
|
|
5
|
+
export declare const hasStrokeStyle: (type: ElementOrToolType) => type is "line" | "arrow" | "rectangle" | "diamond" | "ellipse" | "embeddable" | "iframe";
|
|
6
|
+
export declare const canChangeRoundness: (type: ElementOrToolType) => type is "line" | "rectangle" | "diamond" | "embeddable" | "iframe" | "image";
|
|
7
|
+
export declare const toolIsArrow: (type: ElementOrToolType) => type is "arrow";
|
|
8
|
+
export declare const canHaveArrowheads: (type: ElementOrToolType) => type is "arrow";
|
|
@@ -24,10 +24,10 @@ export declare const dragNewElement: ({ newElement, elementType, originX, origin
|
|
|
24
24
|
scene: Scene;
|
|
25
25
|
/** whether to keep given aspect ratio when `isResizeWithSidesSameLength` is
|
|
26
26
|
true */
|
|
27
|
-
widthAspectRatio?: number | null
|
|
27
|
+
widthAspectRatio?: number | null;
|
|
28
28
|
originOffset?: {
|
|
29
29
|
x: number;
|
|
30
30
|
y: number;
|
|
31
|
-
} | null
|
|
32
|
-
informMutation?: boolean
|
|
31
|
+
} | null;
|
|
32
|
+
informMutation?: boolean;
|
|
33
33
|
}) => void;
|
|
@@ -17,12 +17,12 @@ import type { ExcalidrawElement, GroupId } from "./types";
|
|
|
17
17
|
export declare const duplicateElement: <TElement extends ExcalidrawElement>(editingGroupId: AppState["editingGroupId"], groupIdMapForOperation: Map<GroupId, GroupId>, element: TElement, randomizeSeed?: boolean) => Readonly<TElement>;
|
|
18
18
|
export declare const duplicateElements: (opts: {
|
|
19
19
|
elements: readonly ExcalidrawElement[];
|
|
20
|
-
randomizeSeed?: boolean
|
|
21
|
-
overrides?: (
|
|
20
|
+
randomizeSeed?: boolean;
|
|
21
|
+
overrides?: (data: {
|
|
22
22
|
duplicateElement: ExcalidrawElement;
|
|
23
23
|
origElement: ExcalidrawElement;
|
|
24
24
|
origIdToDuplicateId: Map<ExcalidrawElement["id"], ExcalidrawElement["id"]>;
|
|
25
|
-
}) => Partial<ExcalidrawElement
|
|
25
|
+
}) => Partial<ExcalidrawElement>;
|
|
26
26
|
} & ({
|
|
27
27
|
/**
|
|
28
28
|
* Duplicates all elements in array.
|
|
@@ -26,11 +26,11 @@ export declare class InvalidFractionalIndexError extends Error {
|
|
|
26
26
|
export declare const validateFractionalIndices: (elements: readonly ExcalidrawElement[], { shouldThrow, includeBoundTextValidation, ignoreLogs, reconciliationContext, }: {
|
|
27
27
|
shouldThrow: boolean;
|
|
28
28
|
includeBoundTextValidation: boolean;
|
|
29
|
-
ignoreLogs?: true
|
|
29
|
+
ignoreLogs?: true;
|
|
30
30
|
reconciliationContext?: {
|
|
31
31
|
localElements: ReadonlyArray<ExcalidrawElement>;
|
|
32
32
|
remoteElements: ReadonlyArray<ExcalidrawElement>;
|
|
33
|
-
}
|
|
33
|
+
};
|
|
34
34
|
}) => void;
|
|
35
35
|
/**
|
|
36
36
|
* Order the elements based on the fractional indices.
|
|
@@ -31,8 +31,8 @@ export declare const getFrameLikeElements: (allElements: ExcalidrawElementsInclu
|
|
|
31
31
|
*/
|
|
32
32
|
export declare const getRootElements: (allElements: ExcalidrawElementsIncludingDeleted) => ExcalidrawElement[];
|
|
33
33
|
export declare const getElementsInResizingFrame: (allElements: ExcalidrawElementsIncludingDeleted, frame: ExcalidrawFrameLikeElement, appState: AppState, elementsMap: ElementsMap) => ExcalidrawElement[];
|
|
34
|
-
export declare const getElementsInNewFrame: (elements: ExcalidrawElementsIncludingDeleted, frame: ExcalidrawFrameLikeElement, elementsMap: ElementsMap) => (import("./types").
|
|
35
|
-
export declare const omitPartialGroups: (elements: ExcalidrawElement[], frame: ExcalidrawFrameLikeElement, allElementsMap: ElementsMap) => (import("./types").
|
|
34
|
+
export declare const getElementsInNewFrame: (elements: ExcalidrawElementsIncludingDeleted, frame: ExcalidrawFrameLikeElement, elementsMap: ElementsMap) => (import("./types").ExcalidrawLinearElement | import("./types").ExcalidrawSelectionElement | import("./types").ExcalidrawRectangleElement | import("./types").ExcalidrawDiamondElement | import("./types").ExcalidrawEllipseElement | import("./types").ExcalidrawEmbeddableElement | import("./types").ExcalidrawIframeElement | import("./types").ExcalidrawImageElement | import("./types").ExcalidrawFrameElement | import("./types").ExcalidrawMagicFrameElement | import("./types").ExcalidrawTextElement | import("./types").ExcalidrawFreeDrawElement)[];
|
|
35
|
+
export declare const omitPartialGroups: (elements: ExcalidrawElement[], frame: ExcalidrawFrameLikeElement, allElementsMap: ElementsMap) => (import("./types").ExcalidrawLinearElement | import("./types").ExcalidrawSelectionElement | import("./types").ExcalidrawRectangleElement | import("./types").ExcalidrawDiamondElement | import("./types").ExcalidrawEllipseElement | import("./types").ExcalidrawEmbeddableElement | import("./types").ExcalidrawIframeElement | import("./types").ExcalidrawImageElement | import("./types").ExcalidrawFrameElement | import("./types").ExcalidrawMagicFrameElement | import("./types").ExcalidrawTextElement | import("./types").ExcalidrawFreeDrawElement)[];
|
|
36
36
|
export declare const getContainingFrame: (element: ExcalidrawElement, elementsMap: ElementsMap) => ExcalidrawFrameLikeElement | null;
|
|
37
37
|
/** */
|
|
38
38
|
export declare const filterElementsEligibleAsFrameChildren: (elements: readonly ExcalidrawElement[], frame: ExcalidrawFrameLikeElement) => ExcalidrawElement[];
|
|
@@ -53,7 +53,11 @@ export declare const updateFrameMembershipOfSelectedElements: <T extends Element
|
|
|
53
53
|
* filters out elements that are inside groups that contain a frame element
|
|
54
54
|
* anywhere in the group tree
|
|
55
55
|
*/
|
|
56
|
-
export declare const omitGroupsContainingFrameLikes: (allElements: ElementsMapOrArray,
|
|
56
|
+
export declare const omitGroupsContainingFrameLikes: (allElements: ElementsMapOrArray,
|
|
57
|
+
/** subset of elements you want to filter. Optional perf optimization so we
|
|
58
|
+
* don't have to filter all elements unnecessarily
|
|
59
|
+
*/
|
|
60
|
+
selectedElements?: readonly ExcalidrawElement[]) => ExcalidrawElement[];
|
|
57
61
|
/**
|
|
58
62
|
* depending on the appState, return target frame, which is the frame the given element
|
|
59
63
|
* is going to be added to or remove from
|
|
@@ -1,3 +1,4 @@
|
|
|
1
|
+
import { type Bounds } from "@excalidraw/common";
|
|
1
2
|
import type { LocalPoint, GlobalPoint, Vector } from "@excalidraw/math";
|
|
2
3
|
import type { ExcalidrawBindableElement } from "./types";
|
|
3
4
|
export declare const HEADING_RIGHT: Heading;
|
|
@@ -11,5 +12,5 @@ export declare const headingForPointIsHorizontal: <P extends GlobalPoint | Local
|
|
|
11
12
|
export declare const compareHeading: (a: Heading, b: Heading) => boolean;
|
|
12
13
|
export declare const headingIsHorizontal: (a: Heading) => boolean;
|
|
13
14
|
export declare const headingIsVertical: (a: Heading) => boolean;
|
|
14
|
-
export declare const headingForPointFromElement: <Point extends GlobalPoint>(element: Readonly<ExcalidrawBindableElement>, aabb:
|
|
15
|
+
export declare const headingForPointFromElement: <Point extends GlobalPoint>(element: Readonly<ExcalidrawBindableElement>, aabb: Readonly<Bounds>, p: Readonly<Point>) => Heading;
|
|
15
16
|
export declare const flipHeading: (h: Heading) => Heading;
|
|
@@ -10,17 +10,7 @@ export declare const updateImageCache: ({ fileIds, files, imageCache, }: {
|
|
|
10
10
|
}) => Promise<{
|
|
11
11
|
imageCache: Map<FileId, {
|
|
12
12
|
image: HTMLImageElement | Promise<HTMLImageElement>;
|
|
13
|
-
mimeType: import("@excalidraw/common/utility-types").ValueOf<
|
|
14
|
-
readonly svg: "image/svg+xml";
|
|
15
|
-
readonly png: "image/png";
|
|
16
|
-
readonly jpg: "image/jpeg";
|
|
17
|
-
readonly gif: "image/gif";
|
|
18
|
-
readonly webp: "image/webp";
|
|
19
|
-
readonly bmp: "image/bmp";
|
|
20
|
-
readonly ico: "image/x-icon";
|
|
21
|
-
readonly avif: "image/avif";
|
|
22
|
-
readonly jfif: "image/jfif";
|
|
23
|
-
}>;
|
|
13
|
+
mimeType: import("@excalidraw/common/utility-types").ValueOf<typeof import("@excalidraw/common").IMAGE_MIME_TYPES>;
|
|
24
14
|
}>;
|
|
25
15
|
/** includes errored files because they cache was updated nonetheless */
|
|
26
16
|
updatedFiles: Map<FileId, true>;
|
|
@@ -49,6 +49,7 @@ export * from "./store";
|
|
|
49
49
|
export * from "./textElement";
|
|
50
50
|
export * from "./textMeasurements";
|
|
51
51
|
export * from "./textWrapping";
|
|
52
|
+
export * from "./transform";
|
|
52
53
|
export * from "./transformHandles";
|
|
53
54
|
export * from "./typeChecks";
|
|
54
55
|
export * from "./utils";
|
|
@@ -1,9 +1,8 @@
|
|
|
1
|
-
/// <reference types="react" />
|
|
2
1
|
import { type GlobalPoint, type LocalPoint } from "@excalidraw/math";
|
|
3
2
|
import { type Store } from "@excalidraw/element";
|
|
4
3
|
import type { AppState, PointerCoords, InteractiveCanvasAppState, AppClassProperties, NullableGridSize, Zoom } from "@excalidraw/excalidraw/types";
|
|
4
|
+
import type { Bounds } from "@excalidraw/common";
|
|
5
5
|
import type { Scene } from "./Scene";
|
|
6
|
-
import type { Bounds } from "./bounds";
|
|
7
6
|
import type { NonDeleted, ExcalidrawLinearElement, ExcalidrawElement, ExcalidrawTextElementWithContainer, ElementsMap, NonDeletedSceneElementsMap, FixedPointBinding, ExcalidrawElbowArrowElement, PointsPositionUpdates } from "./types";
|
|
8
7
|
export declare class LinearElementEditor {
|
|
9
8
|
readonly elementId: ExcalidrawElement["id"] & {
|
|
@@ -12,7 +12,9 @@ export type ElementUpdate<TElement extends ExcalidrawElement> = Omit<Partial<TEl
|
|
|
12
12
|
export declare const mutateElement: <TElement extends Mutable<ExcalidrawElement>>(element: TElement, elementsMap: ElementsMap, updates: ElementUpdate<TElement>, options?: {
|
|
13
13
|
isDragging?: boolean;
|
|
14
14
|
}) => TElement;
|
|
15
|
-
export declare const newElementWith: <TElement extends ExcalidrawElement>(element: TElement, updates: ElementUpdate<TElement>,
|
|
15
|
+
export declare const newElementWith: <TElement extends ExcalidrawElement>(element: TElement, updates: ElementUpdate<TElement>,
|
|
16
|
+
/** pass `true` to always regenerate */
|
|
17
|
+
force?: boolean) => TElement;
|
|
16
18
|
/**
|
|
17
19
|
* Mutates element, bumping `version`, `versionNonce`, and `updated`.
|
|
18
20
|
*
|
|
@@ -47,12 +47,12 @@ export declare const newLinearElement: (opts: {
|
|
|
47
47
|
} & ElementConstructorOpts) => NonDeleted<ExcalidrawLinearElement>;
|
|
48
48
|
export declare const newArrowElement: <T extends boolean>(opts: {
|
|
49
49
|
type: ExcalidrawArrowElement["type"];
|
|
50
|
-
startArrowhead?: Arrowhead | null
|
|
51
|
-
endArrowhead?: Arrowhead | null
|
|
52
|
-
points?:
|
|
53
|
-
elbowed?: T
|
|
54
|
-
fixedSegments?:
|
|
55
|
-
} &
|
|
50
|
+
startArrowhead?: Arrowhead | null;
|
|
51
|
+
endArrowhead?: Arrowhead | null;
|
|
52
|
+
points?: ExcalidrawArrowElement["points"];
|
|
53
|
+
elbowed?: T;
|
|
54
|
+
fixedSegments?: ExcalidrawElbowArrowElement["fixedSegments"] | null;
|
|
55
|
+
} & ElementConstructorOpts) => T extends true ? NonDeleted<ExcalidrawElbowArrowElement> : NonDeleted<ExcalidrawArrowElement>;
|
|
56
56
|
export declare const newImageElement: (opts: {
|
|
57
57
|
type: ExcalidrawImageElement["type"];
|
|
58
58
|
status?: ExcalidrawImageElement["status"];
|
|
@@ -3,7 +3,6 @@ import type { AppState, StaticCanvasAppState, InteractiveCanvasAppState, Element
|
|
|
3
3
|
import type { StaticCanvasRenderConfig, RenderableElementsMap, InteractiveCanvasRenderConfig } from "@excalidraw/excalidraw/scene/types";
|
|
4
4
|
import type { ExcalidrawElement, ExcalidrawTextElement, NonDeletedExcalidrawElement, ExcalidrawFreeDrawElement, ExcalidrawImageElement, ExcalidrawFrameLikeElement, NonDeletedSceneElementsMap, ElementsMap } from "./types";
|
|
5
5
|
import type { RoughCanvas } from "roughjs/bin/canvas";
|
|
6
|
-
export declare const IMAGE_INVERT_FILTER = "invert(100%) hue-rotate(180deg) saturate(1.25)";
|
|
7
6
|
export declare const getRenderOpacity: (element: ExcalidrawElement, containingFrame: ExcalidrawFrameLikeElement | null, elementsPendingErasure: ElementsPendingErasure, pendingNodes: Readonly<PendingExcalidrawElements> | null, globalAlpha?: number) => number;
|
|
8
7
|
export interface ExcalidrawElementWithCanvas {
|
|
9
8
|
element: ExcalidrawElement | ExcalidrawTextElement;
|
|
@@ -23,9 +22,4 @@ export declare const DEFAULT_LINK_SIZE = 14;
|
|
|
23
22
|
export declare const elementWithCanvasCache: WeakMap<ExcalidrawElement, ExcalidrawElementWithCanvas>;
|
|
24
23
|
export declare const renderSelectionElement: (element: NonDeletedExcalidrawElement, context: CanvasRenderingContext2D, appState: InteractiveCanvasAppState, selectionColor: InteractiveCanvasRenderConfig["selectionColor"]) => void;
|
|
25
24
|
export declare const renderElement: (element: NonDeletedExcalidrawElement, elementsMap: RenderableElementsMap, allElementsMap: NonDeletedSceneElementsMap, rc: RoughCanvas, context: CanvasRenderingContext2D, renderConfig: StaticCanvasRenderConfig, appState: StaticCanvasAppState | InteractiveCanvasAppState) => void;
|
|
26
|
-
export declare const pathsCache: WeakMap<ExcalidrawFreeDrawElement, Path2D>;
|
|
27
|
-
export declare function generateFreeDrawShape(element: ExcalidrawFreeDrawElement): Path2D;
|
|
28
|
-
export declare function getFreeDrawPath2D(element: ExcalidrawFreeDrawElement): Path2D | undefined;
|
|
29
|
-
export declare function getFreeDrawSvgPath(element: ExcalidrawFreeDrawElement): string;
|
|
30
25
|
export declare function getFreedrawOutlineAsSegments(element: ExcalidrawFreeDrawElement, points: [number, number][], elementsMap: ElementsMap): import("@excalidraw/math").LineSegment<GlobalPoint>[];
|
|
31
|
-
export declare function getFreedrawOutlinePoints(element: ExcalidrawFreeDrawElement): [number, number][];
|
|
@@ -17,16 +17,16 @@ export declare const resizeSingleTextElement: (origElement: NonDeleted<Excalidra
|
|
|
17
17
|
export declare const getResizeOffsetXY: (transformHandleType: MaybeTransformHandleType, selectedElements: NonDeletedExcalidrawElement[], elementsMap: ElementsMap, x: number, y: number) => [number, number];
|
|
18
18
|
export declare const getResizeArrowDirection: (transformHandleType: MaybeTransformHandleType, element: NonDeleted<ExcalidrawLinearElement>) => "origin" | "end";
|
|
19
19
|
export declare const resizeSingleElement: (nextWidth: number, nextHeight: number, latestElement: ExcalidrawElement, origElement: ExcalidrawElement, originalElementsMap: ElementsMap, scene: Scene, handleDirection: TransformHandleDirection, { shouldInformMutation, shouldMaintainAspectRatio, shouldResizeFromCenter, }?: {
|
|
20
|
-
shouldMaintainAspectRatio?: boolean
|
|
21
|
-
shouldResizeFromCenter?: boolean
|
|
22
|
-
shouldInformMutation?: boolean
|
|
20
|
+
shouldMaintainAspectRatio?: boolean;
|
|
21
|
+
shouldResizeFromCenter?: boolean;
|
|
22
|
+
shouldInformMutation?: boolean;
|
|
23
23
|
}) => void;
|
|
24
24
|
export declare const resizeMultipleElements: (selectedElements: readonly NonDeletedExcalidrawElement[], elementsMap: ElementsMap, handleDirection: TransformHandleDirection, scene: Scene, originalElementsMap: ElementsMap, { shouldMaintainAspectRatio, shouldResizeFromCenter, flipByX, flipByY, nextHeight, nextWidth, originalBoundingBox, }?: {
|
|
25
|
-
nextWidth?: number
|
|
26
|
-
nextHeight?: number
|
|
27
|
-
shouldMaintainAspectRatio?: boolean
|
|
28
|
-
shouldResizeFromCenter?: boolean
|
|
29
|
-
flipByX?: boolean
|
|
30
|
-
flipByY?: boolean
|
|
31
|
-
originalBoundingBox?: BoundingBox
|
|
25
|
+
nextWidth?: number;
|
|
26
|
+
nextHeight?: number;
|
|
27
|
+
shouldMaintainAspectRatio?: boolean;
|
|
28
|
+
shouldResizeFromCenter?: boolean;
|
|
29
|
+
flipByX?: boolean;
|
|
30
|
+
flipByY?: boolean;
|
|
31
|
+
originalBoundingBox?: BoundingBox;
|
|
32
32
|
}) => void;
|
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { type EditorInterface } from "@excalidraw/common";
|
|
2
2
|
import type { GlobalPoint, LocalPoint } from "@excalidraw/math";
|
|
3
3
|
import type { AppState, Zoom } from "@excalidraw/excalidraw/types";
|
|
4
|
-
import type { Bounds } from "
|
|
4
|
+
import type { Bounds } from "@excalidraw/common";
|
|
5
5
|
import type { MaybeTransformHandleType } from "./transformHandles";
|
|
6
6
|
import type { ExcalidrawElement, PointerType, NonDeletedExcalidrawElement, ElementsMap } from "./types";
|
|
7
7
|
export declare const resizeTest: <Point extends GlobalPoint | LocalPoint>(element: NonDeletedExcalidrawElement, elementsMap: ElementsMap, appState: AppState, x: number, y: number, zoom: Zoom, pointerType: PointerType, editorInterface: EditorInterface) => MaybeTransformHandleType;
|
|
@@ -27,12 +27,8 @@ export declare const makeNextSelectedElementIds: (nextSelectedElementIds: AppSta
|
|
|
27
27
|
[id: string]: true;
|
|
28
28
|
}>;
|
|
29
29
|
export declare const getSelectionStateForElements: (targetElements: readonly ExcalidrawElement[], allElements: readonly NonDeletedExcalidrawElement[], appState: AppState) => {
|
|
30
|
-
editingGroupId:
|
|
31
|
-
selectedElementIds:
|
|
32
|
-
|
|
33
|
-
}>;
|
|
34
|
-
selectedGroupIds: {
|
|
35
|
-
[groupId: string]: boolean;
|
|
36
|
-
};
|
|
30
|
+
editingGroupId: AppState["editingGroupId"];
|
|
31
|
+
selectedElementIds: AppState["selectedElementIds"];
|
|
32
|
+
selectedGroupIds: AppState["selectedGroupIds"];
|
|
37
33
|
selectedLinearElement: LinearElementEditor | null;
|
|
38
34
|
};
|
|
@@ -3,7 +3,7 @@ import { type LocalPoint } from "@excalidraw/math";
|
|
|
3
3
|
import type { GlobalPoint } from "@excalidraw/math";
|
|
4
4
|
import type { AppState, EmbedsValidationStatus } from "@excalidraw/excalidraw/types";
|
|
5
5
|
import type { ElementShape, ElementShapes } from "@excalidraw/excalidraw/scene/types";
|
|
6
|
-
import type { ExcalidrawElement, ExcalidrawLinearElement, ExcalidrawFreeDrawElement, ElementsMap, ExcalidrawLineElement } from "./types";
|
|
6
|
+
import type { ExcalidrawElement, ExcalidrawSelectionElement, ExcalidrawLinearElement, ExcalidrawFreeDrawElement, ElementsMap, ExcalidrawLineElement } from "./types";
|
|
7
7
|
import type { Drawable, Options } from "roughjs/bin/core";
|
|
8
8
|
export declare class ShapeCache {
|
|
9
9
|
private static rg;
|
|
@@ -12,21 +12,21 @@ export declare class ShapeCache {
|
|
|
12
12
|
* Retrieves shape from cache if available. Use this only if shape
|
|
13
13
|
* is optional and you have a fallback in case it's not cached.
|
|
14
14
|
*/
|
|
15
|
-
static get: <T extends ExcalidrawElement>(element: T) => T["type"] extends keyof ElementShapes ? ElementShapes[T["type"]] | undefined : ElementShape | undefined;
|
|
16
|
-
static
|
|
17
|
-
static delete: (element: ExcalidrawElement) => boolean;
|
|
15
|
+
static get: <T extends ExcalidrawElement>(element: T, theme: AppState["theme"] | null) => (T["type"] extends keyof ElementShapes ? ElementShapes[T["type"]] | undefined : ElementShape | undefined) | undefined;
|
|
16
|
+
static delete: (element: ExcalidrawElement) => void;
|
|
18
17
|
static destroy: () => void;
|
|
19
18
|
/**
|
|
20
19
|
* Generates & caches shape for element if not already cached, otherwise
|
|
21
20
|
* returns cached shape.
|
|
22
21
|
*/
|
|
23
|
-
static generateElementShape: <T extends
|
|
22
|
+
static generateElementShape: <T extends Exclude<ExcalidrawElement, ExcalidrawSelectionElement>>(element: T, renderConfig: {
|
|
24
23
|
isExporting: boolean;
|
|
25
24
|
canvasBackgroundColor: AppState["viewBackgroundColor"];
|
|
26
25
|
embedsValidationStatus: EmbedsValidationStatus;
|
|
27
|
-
|
|
26
|
+
theme: AppState["theme"];
|
|
27
|
+
} | null) => ((T["type"] extends keyof ElementShapes ? ElementShapes[T["type"]] | undefined : ElementShape | undefined) & {}) | (T["type"] extends keyof ElementShapes ? ElementShapes[T["type"]] : Drawable | null);
|
|
28
28
|
}
|
|
29
|
-
export declare const generateRoughOptions: (element: ExcalidrawElement, continuousPath?: boolean) => Options;
|
|
29
|
+
export declare const generateRoughOptions: (element: ExcalidrawElement, continuousPath?: boolean, isDarkMode?: boolean) => Options;
|
|
30
30
|
export declare const generateLinearCollisionShape: (element: ExcalidrawLinearElement | ExcalidrawFreeDrawElement) => {
|
|
31
31
|
op: string;
|
|
32
32
|
data: number[];
|
|
@@ -40,3 +40,4 @@ export declare const toggleLinePolygonState: (element: ExcalidrawLineElement, ne
|
|
|
40
40
|
polygon: ExcalidrawLineElement["polygon"];
|
|
41
41
|
points: ExcalidrawLineElement["points"];
|
|
42
42
|
} | null;
|
|
43
|
+
export declare const getFreedrawOutlinePoints: (element: ExcalidrawFreeDrawElement) => [number, number][];
|