@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.
Files changed (198) hide show
  1. package/dist/dev/index.js +1128 -302
  2. package/dist/dev/index.js.map +4 -4
  3. package/dist/prod/index.js +3 -3
  4. package/dist/types/common/src/bounds.d.ts +10 -0
  5. package/dist/types/common/src/colors.d.ts +59 -39
  6. package/dist/types/common/src/constants.d.ts +14 -12
  7. package/dist/types/common/src/editorInterface.d.ts +1 -1
  8. package/dist/types/common/src/font-metadata.d.ts +1 -3
  9. package/dist/types/common/src/index.d.ts +1 -1
  10. package/dist/types/common/src/keys.d.ts +1 -1
  11. package/dist/types/common/src/utility-types.d.ts +0 -1
  12. package/dist/types/common/src/utils.d.ts +44 -35
  13. package/dist/types/element/src/Scene.d.ts +4 -4
  14. package/dist/types/element/src/binding.d.ts +6 -4
  15. package/dist/types/element/src/bounds.d.ts +2 -10
  16. package/dist/types/element/src/collision.d.ts +2 -2
  17. package/dist/types/element/src/comparisons.d.ts +7 -7
  18. package/dist/types/element/src/dragElements.d.ts +3 -3
  19. package/dist/types/element/src/duplicate.d.ts +3 -3
  20. package/dist/types/element/src/fractionalIndex.d.ts +2 -2
  21. package/dist/types/element/src/frame.d.ts +7 -3
  22. package/dist/types/element/src/heading.d.ts +2 -1
  23. package/dist/types/element/src/image.d.ts +1 -11
  24. package/dist/types/element/src/index.d.ts +1 -0
  25. package/dist/types/element/src/linearElementEditor.d.ts +1 -2
  26. package/dist/types/element/src/mutateElement.d.ts +3 -1
  27. package/dist/types/element/src/newElement.d.ts +6 -6
  28. package/dist/types/element/src/renderElement.d.ts +0 -6
  29. package/dist/types/element/src/resizeElements.d.ts +10 -10
  30. package/dist/types/element/src/resizeTest.d.ts +1 -1
  31. package/dist/types/element/src/selection.d.ts +3 -7
  32. package/dist/types/element/src/shape.d.ts +8 -7
  33. package/dist/types/element/src/textMeasurements.d.ts +1 -3
  34. package/dist/types/{excalidraw/data → element/src}/transform.d.ts +3 -3
  35. package/dist/types/element/src/transformHandles.d.ts +3 -23
  36. package/dist/types/element/src/typeChecks.d.ts +2 -4
  37. package/dist/types/element/src/utils.d.ts +3 -1
  38. package/dist/types/excalidraw/actions/actionAddToLibrary.d.ts +114 -178
  39. package/dist/types/excalidraw/actions/actionAlign.d.ts +0 -1
  40. package/dist/types/excalidraw/actions/actionBoundText.d.ts +44 -87
  41. package/dist/types/excalidraw/actions/actionCanvas.d.ts +263 -510
  42. package/dist/types/excalidraw/actions/actionClipboard.d.ts +85 -128
  43. package/dist/types/excalidraw/actions/actionCropEditor.d.ts +21 -43
  44. package/dist/types/excalidraw/actions/actionDeleteSelected.d.ts +74 -142
  45. package/dist/types/excalidraw/actions/actionDistribute.d.ts +0 -1
  46. package/dist/types/excalidraw/actions/actionDuplicateSelection.d.ts +2 -3
  47. package/dist/types/excalidraw/actions/actionElementLink.d.ts +41 -63
  48. package/dist/types/excalidraw/actions/actionElementLock.d.ts +45 -88
  49. package/dist/types/excalidraw/actions/actionEmbeddable.d.ts +41 -63
  50. package/dist/types/excalidraw/actions/actionExport.d.ts +85 -170
  51. package/dist/types/excalidraw/actions/actionFinalize.d.ts +1 -2
  52. package/dist/types/excalidraw/actions/actionFlip.d.ts +0 -1
  53. package/dist/types/excalidraw/actions/actionFrame.d.ts +208 -329
  54. package/dist/types/excalidraw/actions/actionGroup.d.ts +48 -99
  55. package/dist/types/excalidraw/actions/actionLinearEditor.d.ts +149 -207
  56. package/dist/types/excalidraw/actions/actionLink.d.ts +43 -65
  57. package/dist/types/excalidraw/actions/actionMenu.d.ts +35 -57
  58. package/dist/types/excalidraw/actions/actionNavigate.d.ts +14 -17
  59. package/dist/types/excalidraw/actions/actionProperties.d.ts +59 -102
  60. package/dist/types/excalidraw/actions/actionSelectAll.d.ts +24 -50
  61. package/dist/types/excalidraw/actions/actionStyles.d.ts +20 -42
  62. package/dist/types/excalidraw/actions/actionTextAutoResize.d.ts +3 -3
  63. package/dist/types/excalidraw/actions/actionToggleGridMode.d.ts +41 -63
  64. package/dist/types/excalidraw/actions/actionToggleObjectsSnapMode.d.ts +41 -63
  65. package/dist/types/excalidraw/actions/actionToggleSearchMenu.d.ts +35 -57
  66. package/dist/types/excalidraw/actions/actionToggleStats.d.ts +40 -62
  67. package/dist/types/excalidraw/actions/actionToggleViewMode.d.ts +41 -63
  68. package/dist/types/excalidraw/actions/actionToggleZenMode.d.ts +41 -63
  69. package/dist/types/excalidraw/actions/actionZindex.d.ts +8 -9
  70. package/dist/types/excalidraw/actions/manager.d.ts +1 -1
  71. package/dist/types/excalidraw/actions/register.d.ts +2 -2
  72. package/dist/types/excalidraw/appState.d.ts +12 -12
  73. package/dist/types/excalidraw/clipboard.d.ts +7 -31
  74. package/dist/types/excalidraw/components/Actions.d.ts +1 -1
  75. package/dist/types/excalidraw/components/App.d.ts +32 -40
  76. package/dist/types/excalidraw/components/Card.d.ts +1 -3
  77. package/dist/types/excalidraw/components/ColorPicker/ColorInput.d.ts +2 -4
  78. package/dist/types/excalidraw/components/ColorPicker/ColorPicker.d.ts +0 -1
  79. package/dist/types/excalidraw/components/ColorPicker/colorPickerUtils.d.ts +0 -1
  80. package/dist/types/excalidraw/components/ColorPicker/keyboardNavHandlers.d.ts +0 -1
  81. package/dist/types/excalidraw/components/CommandPalette/types.d.ts +0 -1
  82. package/dist/types/excalidraw/components/ConvertElementTypePopup.d.ts +2 -2
  83. package/dist/types/excalidraw/components/DarkModeToggle.d.ts +1 -1
  84. package/dist/types/excalidraw/components/DefaultSidebar.d.ts +9 -13
  85. package/dist/types/excalidraw/components/ElementLinkDialog.d.ts +1 -1
  86. package/dist/types/excalidraw/components/Ellipsify.d.ts +1 -2
  87. package/dist/types/excalidraw/components/ErrorDialog.d.ts +1 -1
  88. package/dist/types/excalidraw/components/ExcalidrawLogo.d.ts +0 -1
  89. package/dist/types/excalidraw/components/EyeDropper.d.ts +0 -1
  90. package/dist/types/excalidraw/components/FilledButton.d.ts +1 -0
  91. package/dist/types/excalidraw/components/FontPicker/keyboardNavHandlers.d.ts +0 -1
  92. package/dist/types/excalidraw/components/HelpDialog.d.ts +1 -1
  93. package/dist/types/excalidraw/components/InlineIcon.d.ts +2 -2
  94. package/dist/types/excalidraw/components/LibraryMenuControlButtons.d.ts +1 -1
  95. package/dist/types/excalidraw/components/LibraryMenuHeaderContent.d.ts +1 -2
  96. package/dist/types/excalidraw/components/LibraryUnit.d.ts +2 -3
  97. package/dist/types/excalidraw/components/LoadingMessage.d.ts +0 -1
  98. package/dist/types/excalidraw/components/MobileToolBar.d.ts +0 -1
  99. package/dist/types/excalidraw/components/Modal.d.ts +0 -1
  100. package/dist/types/excalidraw/components/OverwriteConfirm/OverwriteConfirm.d.ts +1 -1
  101. package/dist/types/excalidraw/components/RadioGroup.d.ts +0 -1
  102. package/dist/types/excalidraw/components/RadioSelection.d.ts +4 -4
  103. package/dist/types/excalidraw/components/ScrollableList.d.ts +0 -1
  104. package/dist/types/excalidraw/components/Sidebar/Sidebar.d.ts +15 -21
  105. package/dist/types/excalidraw/components/Sidebar/SidebarHeader.d.ts +1 -1
  106. package/dist/types/excalidraw/components/Sidebar/SidebarTab.d.ts +1 -2
  107. package/dist/types/excalidraw/components/Sidebar/SidebarTabTrigger.d.ts +1 -2
  108. package/dist/types/excalidraw/components/Sidebar/SidebarTabTriggers.d.ts +1 -2
  109. package/dist/types/excalidraw/components/Sidebar/SidebarTabs.d.ts +1 -2
  110. package/dist/types/excalidraw/components/Spinner.d.ts +4 -4
  111. package/dist/types/excalidraw/components/Stats/CanvasGrid.d.ts +0 -1
  112. package/dist/types/excalidraw/components/Stats/Collapsible.d.ts +0 -1
  113. package/dist/types/excalidraw/components/Stats/DragInput.d.ts +0 -1
  114. package/dist/types/excalidraw/components/Stats/index.d.ts +7 -8
  115. package/dist/types/excalidraw/components/TTDDialog/Chat/ChatHistoryMenu.d.ts +15 -0
  116. package/dist/types/excalidraw/components/TTDDialog/Chat/ChatInterface.d.ts +27 -0
  117. package/dist/types/excalidraw/components/TTDDialog/Chat/ChatMessage.d.ts +14 -0
  118. package/dist/types/excalidraw/components/TTDDialog/Chat/TTDChatPanel.d.ts +26 -0
  119. package/dist/types/excalidraw/components/TTDDialog/Chat/index.d.ts +3 -0
  120. package/dist/types/excalidraw/components/TTDDialog/Chat/useChatAgent.d.ts +8 -0
  121. package/dist/types/excalidraw/components/TTDDialog/MermaidToExcalidraw.d.ts +3 -2
  122. package/dist/types/excalidraw/components/TTDDialog/TTDContext.d.ts +13 -0
  123. package/dist/types/excalidraw/components/TTDDialog/TTDDialog.d.ts +4 -25
  124. package/dist/types/excalidraw/components/TTDDialog/TTDDialogOutput.d.ts +2 -2
  125. package/dist/types/excalidraw/components/TTDDialog/TTDDialogPanel.d.ts +13 -9
  126. package/dist/types/excalidraw/components/TTDDialog/TTDDialogTab.d.ts +1 -2
  127. package/dist/types/excalidraw/components/TTDDialog/TTDDialogTabTrigger.d.ts +1 -2
  128. package/dist/types/excalidraw/components/TTDDialog/TTDDialogTabTriggers.d.ts +1 -2
  129. package/dist/types/excalidraw/components/TTDDialog/TTDDialogTrigger.d.ts +1 -1
  130. package/dist/types/excalidraw/components/TTDDialog/TTDPreviewPanel.d.ts +9 -0
  131. package/dist/types/excalidraw/components/TTDDialog/TextToDiagram.d.ts +8 -0
  132. package/dist/types/excalidraw/components/TTDDialog/common.d.ts +16 -16
  133. package/dist/types/excalidraw/components/TTDDialog/hooks/useChatManagement.d.ts +13 -0
  134. package/dist/types/excalidraw/components/TTDDialog/hooks/useMermaidRenderer.d.ts +14 -0
  135. package/dist/types/excalidraw/components/TTDDialog/hooks/useTextGeneration.d.ts +7 -0
  136. package/dist/types/excalidraw/components/TTDDialog/types.d.ts +91 -0
  137. package/dist/types/excalidraw/components/TTDDialog/useTTDChatStorage.d.ts +22 -0
  138. package/dist/types/excalidraw/components/TTDDialog/utils/TTDStreamFetch.d.ts +24 -0
  139. package/dist/types/excalidraw/components/TTDDialog/utils/chat.d.ts +10 -0
  140. package/dist/types/excalidraw/components/TTDDialog/utils/mermaidValidation.d.ts +1 -0
  141. package/dist/types/excalidraw/components/Toast.d.ts +3 -3
  142. package/dist/types/excalidraw/components/Trans.d.ts +2 -2
  143. package/dist/types/excalidraw/components/dropdownMenu/DropdownMenu.d.ts +30 -33
  144. package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuContent.d.ts +5 -5
  145. package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuGroup.d.ts +3 -3
  146. package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItem.d.ts +12 -19
  147. package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItemContent.d.ts +5 -4
  148. package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItemContentRadio.d.ts +0 -1
  149. package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItemCustom.d.ts +2 -2
  150. package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuItemLink.d.ts +6 -6
  151. package/dist/types/excalidraw/components/dropdownMenu/DropdownMenuTrigger.d.ts +3 -4
  152. package/dist/types/excalidraw/components/dropdownMenu/common.d.ts +1 -1
  153. package/dist/types/excalidraw/components/hoc/withInternalFallback.d.ts +1 -1
  154. package/dist/types/excalidraw/components/hyperlink/helpers.d.ts +1 -1
  155. package/dist/types/excalidraw/components/icons.d.ts +16 -12
  156. package/dist/types/excalidraw/components/live-collaboration/LiveCollaborationTrigger.d.ts +2 -13
  157. package/dist/types/excalidraw/components/main-menu/DefaultItems.d.ts +2 -2
  158. package/dist/types/excalidraw/components/main-menu/MainMenu.d.ts +26 -29
  159. package/dist/types/excalidraw/components/shapes.d.ts +1 -1
  160. package/dist/types/excalidraw/components/welcome-screen/WelcomeScreen.Center.d.ts +6 -6
  161. package/dist/types/excalidraw/components/welcome-screen/WelcomeScreen.d.ts +15 -16
  162. package/dist/types/excalidraw/data/blob.d.ts +321 -3
  163. package/dist/types/excalidraw/data/encode.d.ts +4 -4
  164. package/dist/types/excalidraw/data/encryption.d.ts +5 -5
  165. package/dist/types/excalidraw/data/filesystem.d.ts +2 -2
  166. package/dist/types/excalidraw/data/index.d.ts +3 -3
  167. package/dist/types/excalidraw/data/json.d.ts +159 -2
  168. package/dist/types/excalidraw/data/library.d.ts +24 -9
  169. package/dist/types/excalidraw/data/restore.d.ts +25 -10
  170. package/dist/types/excalidraw/editor-jotai.d.ts +11 -11
  171. package/dist/types/excalidraw/errors.d.ts +14 -0
  172. package/dist/types/excalidraw/hooks/useOutsideClick.d.ts +1 -2
  173. package/dist/types/excalidraw/hooks/useScrollPosition.d.ts +1 -2
  174. package/dist/types/excalidraw/i18n.d.ts +2 -2
  175. package/dist/types/excalidraw/index.d.ts +4 -4
  176. package/dist/types/excalidraw/renderer/helpers.d.ts +6 -4
  177. package/dist/types/excalidraw/renderer/interactiveScene.d.ts +8 -6
  178. package/dist/types/excalidraw/scene/Renderer.d.ts +5 -2
  179. package/dist/types/excalidraw/scene/export.d.ts +2 -2
  180. package/dist/types/excalidraw/scene/scroll.d.ts +1 -6
  181. package/dist/types/excalidraw/scene/types.d.ts +7 -2
  182. package/dist/types/excalidraw/snapping.d.ts +5 -5
  183. package/dist/types/excalidraw/subset/harfbuzz/harfbuzz-bindings.d.ts +1 -1
  184. package/dist/types/excalidraw/subset/harfbuzz/harfbuzz-loader.d.ts +1 -1
  185. package/dist/types/excalidraw/subset/harfbuzz/harfbuzz-wasm.d.ts +1 -1
  186. package/dist/types/excalidraw/subset/woff2/woff2-loader.d.ts +2 -2
  187. package/dist/types/excalidraw/subset/woff2/woff2-wasm.d.ts +1 -1
  188. package/dist/types/excalidraw/types.d.ts +1 -2
  189. package/dist/types/excalidraw/wysiwyg/textWysiwyg.d.ts +2 -2
  190. package/dist/types/math/src/polygon.d.ts +2 -2
  191. package/dist/types/math/src/range.d.ts +1 -3
  192. package/dist/types/math/src/segment.d.ts +3 -3
  193. package/dist/types/utils/src/bbox.d.ts +1 -1
  194. package/dist/types/utils/src/export.d.ts +5 -5
  195. package/dist/types/utils/src/shape.d.ts +6 -6
  196. package/dist/types/utils/src/withinBounds.d.ts +2 -2
  197. package/package.json +7 -1
  198. 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 HTMLBRElement | HTMLDivElement | HTMLInputElement | HTMLSelectElement | HTMLTextAreaElement;
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 HTMLBRElement | HTMLDivElement | HTMLInputElement | HTMLTextAreaElement;
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?: ((fromValue: number, toValue: number, progress: number, key: K) => number | undefined) | undefined;
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 | undefined;
77
- onStart?: (() => void) | undefined;
78
- onEnd?: (() => void) | undefined;
79
- onCancel?: (() => void) | undefined;
78
+ duration?: number;
79
+ onStart?: () => void;
80
+ onEnd?: () => void;
81
+ onCancel?: () => void;
80
82
  }) => () => void;
81
- export declare const chunk: <T extends unknown>(array: readonly T[], size: number) => T[][];
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") => boolean;
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 | null | undefined) => K | undefined;
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 string | {
163
+ export declare const arrayToMap: <T extends {
163
164
  id: string;
164
- }>(items: Map<string, T> | readonly T[]) => 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?: ((value: T) => string | number) | undefined) => {
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> | readonly T[]) => Iterable<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> | readonly T[]) => 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: () => "iframe" | "top";
202
+ export declare const getFrame: () => "top" | "iframe";
202
203
  export declare const isRunningInIframe: () => boolean;
203
- export declare const isPromiseLike: (value: any) => value is Promise<any>;
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]?: ((a: T[key], b: T[key]) => boolean) | undefined; } | (keyof T extends K[number] ? K extends readonly (keyof T)[] ? K : {
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
- }) | undefined, debug?: boolean) => boolean;
214
- export declare const composeEventHandlers: <E>(originalEventHandler?: ((event: E) => void) | undefined, ourEventHandler?: ((event: E) => void) | undefined, { checkForDefaultPrevented }?: {
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 unknown>(func: (opts: T) => R) => ((opts: T) => R) & {
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>(collection: Set<T> | Record<T, any> | Map<T, any> | readonly T[], value: string) => value is T;
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
- } : never;
247
- type Unbrand<T> = T extends Map<infer E, infer F> ? Map<E, F> : T extends Set<infer E> ? Set<E> : T extends Array<infer E> ? Array<E> : RemoveAllBrands<T>;
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 ubranded type. Optionally you can explicitly supply current value
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 const toBrandedType: <BrandedType, CurrentType = BrandedType>(value: Unbrand<BrandedType>) => CurrentType & BrandedType;
255
- export declare const promiseTry: <TValue, TArgs extends unknown[]>(fn: (...args: TArgs) => TValue | PromiseLike<TValue>, ...args: TArgs) => Promise<TValue>;
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: ReadonlySet<T> | readonly T[], getValue?: ((item: T) => R) | undefined) => R | null;
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 "COMPLEX_BINDINGS">(flag: F) => FEATURE_FLAGS[F];
272
- export declare const setFeatureFlag: <F extends "COMPLEX_BINDINGS">(flag: F, value: FEATURE_FLAGS[F]) => void;
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(): Map<string, Ordered<NonDeletedExcalidrawElement>> & import("@excalidraw/common/utility-types").MakeBrand<"NonDeletedSceneElementsMap">;
25
+ getNonDeletedElementsMap(): NonDeletedSceneElementsMap;
26
26
  getElementsIncludingDeleted(): readonly OrderedExcalidrawElement[];
27
- getElementsMapIncludingDeleted(): Map<string, Ordered<ExcalidrawElement>> & import("@excalidraw/common/utility-types").MakeBrand<"SceneElementsMap">;
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").ExcalidrawTextElement | import("@excalidraw/element/types").ExcalidrawRectangleElement | import("@excalidraw/element/types").ExcalidrawDiamondElement | import("@excalidraw/element/types").ExcalidrawFrameElement | import("@excalidraw/element/types").ExcalidrawMagicFrameElement | import("@excalidraw/element/types").ExcalidrawEmbeddableElement | import("@excalidraw/element/types").ExcalidrawImageElement | import("@excalidraw/element/types").ExcalidrawIframeElement | import("@excalidraw/element/types").ExcalidrawSelectionElement | import("@excalidraw/element/types").ExcalidrawEllipseElement | import("@excalidraw/element/types").ExcalidrawLinearElement | import("@excalidraw/element/types").ExcalidrawFreeDrawElement | null;
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
- shiftKey?: boolean;
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?: ((p: GlobalPoint) => GlobalPoint) | undefined) => Bounds;
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?: ((element: ExcalidrawBindableElement) => number) | undefined) => NonDeleted<ExcalidrawBindableElement>[];
18
- export declare const getHoveredElementForBinding: (point: Readonly<GlobalPoint>, elements: readonly Ordered<NonDeletedExcalidrawElement>[], elementsMap: NonDeletedSceneElementsMap, toleranceFn?: ((element: ExcalidrawBindableElement) => number) | undefined) => NonDeleted<ExcalidrawBindableElement> | null;
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) => boolean;
3
- export declare const hasStrokeColor: (type: ElementOrToolType) => boolean;
4
- export declare const hasStrokeWidth: (type: ElementOrToolType) => boolean;
5
- export declare const hasStrokeStyle: (type: ElementOrToolType) => boolean;
6
- export declare const canChangeRoundness: (type: ElementOrToolType) => boolean;
7
- export declare const toolIsArrow: (type: ElementOrToolType) => boolean;
8
- export declare const canHaveArrowheads: (type: ElementOrToolType) => boolean;
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 | undefined;
27
+ widthAspectRatio?: number | null;
28
28
  originOffset?: {
29
29
  x: number;
30
30
  y: number;
31
- } | null | undefined;
32
- informMutation?: boolean | undefined;
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 | undefined;
21
- overrides?: ((data: {
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>) | undefined;
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 | undefined;
29
+ ignoreLogs?: true;
30
30
  reconciliationContext?: {
31
31
  localElements: ReadonlyArray<ExcalidrawElement>;
32
32
  remoteElements: ReadonlyArray<ExcalidrawElement>;
33
- } | undefined;
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").ExcalidrawTextElement | import("./types").ExcalidrawRectangleElement | import("./types").ExcalidrawDiamondElement | import("./types").ExcalidrawFrameElement | import("./types").ExcalidrawMagicFrameElement | import("./types").ExcalidrawEmbeddableElement | import("./types").ExcalidrawImageElement | import("./types").ExcalidrawIframeElement | import("./types").ExcalidrawSelectionElement | import("./types").ExcalidrawEllipseElement | import("./types").ExcalidrawLinearElement | import("./types").ExcalidrawFreeDrawElement)[];
35
- export declare const omitPartialGroups: (elements: ExcalidrawElement[], frame: ExcalidrawFrameLikeElement, allElementsMap: ElementsMap) => (import("./types").ExcalidrawTextElement | import("./types").ExcalidrawRectangleElement | import("./types").ExcalidrawDiamondElement | import("./types").ExcalidrawFrameElement | import("./types").ExcalidrawMagicFrameElement | import("./types").ExcalidrawEmbeddableElement | import("./types").ExcalidrawImageElement | import("./types").ExcalidrawIframeElement | import("./types").ExcalidrawSelectionElement | import("./types").ExcalidrawEllipseElement | import("./types").ExcalidrawLinearElement | import("./types").ExcalidrawFreeDrawElement)[];
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, selectedElements?: readonly ExcalidrawElement[]) => ExcalidrawElement[];
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: readonly [minX: number, minY: number, maxX: number, maxY: number], p: Readonly<Point>) => Heading;
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>, force?: boolean) => 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 | undefined;
51
- endArrowhead?: Arrowhead | null | undefined;
52
- points?: readonly import("@excalidraw/math").LocalPoint[] | undefined;
53
- elbowed?: T | undefined;
54
- fixedSegments?: readonly import("./types").FixedSegment[] | null | undefined;
55
- } & Omit<Omit<ExcalidrawGenericElement, "id" | "isDeleted" | "updated" | "type">, "link" | "strokeColor" | "backgroundColor" | "fillStyle" | "strokeWidth" | "strokeStyle" | "roundness" | "roughness" | "opacity" | "width" | "height" | "angle" | "seed" | "version" | "versionNonce" | "index" | "groupIds" | "frameId" | "boundElements" | "locked" | "customData"> & Partial<Pick<Omit<ExcalidrawGenericElement, "id" | "isDeleted" | "updated" | "type">, "link" | "strokeColor" | "backgroundColor" | "fillStyle" | "strokeWidth" | "strokeStyle" | "roundness" | "roughness" | "opacity" | "width" | "height" | "angle" | "seed" | "version" | "versionNonce" | "index" | "groupIds" | "frameId" | "boundElements" | "locked" | "customData">>) => T extends true ? NonDeleted<ExcalidrawElbowArrowElement> : NonDeleted<ExcalidrawArrowElement>;
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 | undefined;
21
- shouldResizeFromCenter?: boolean | undefined;
22
- shouldInformMutation?: boolean | undefined;
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 | undefined;
26
- nextHeight?: number | undefined;
27
- shouldMaintainAspectRatio?: boolean | undefined;
28
- shouldResizeFromCenter?: boolean | undefined;
29
- flipByX?: boolean | undefined;
30
- flipByY?: boolean | undefined;
31
- originalBoundingBox?: BoundingBox | undefined;
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 "./bounds";
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: string | null;
31
- selectedElementIds: Readonly<{
32
- [id: string]: true;
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 set: <T extends ExcalidrawElement>(element: T, shape: T["type"] extends keyof ElementShapes ? ElementShapes[T["type"]] : Drawable) => WeakMap<ExcalidrawElement, ElementShape>;
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 import("./types").ExcalidrawTextElement | import("./types").ExcalidrawRectangleElement | import("./types").ExcalidrawDiamondElement | import("./types").ExcalidrawFrameElement | import("./types").ExcalidrawMagicFrameElement | import("./types").ExcalidrawEmbeddableElement | import("./types").ExcalidrawImageElement | import("./types").ExcalidrawIframeElement | import("./types").ExcalidrawEllipseElement | ExcalidrawLinearElement | import("./types").ExcalidrawArrowElement | ExcalidrawFreeDrawElement>(element: T, renderConfig: {
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
- } | null) => ((T["type"] extends keyof ElementShapes ? ElementShapes[T["type"]] | undefined : ElementShape | undefined) & ({} | null)) | (T["type"] extends keyof ElementShapes ? ElementShapes[T["type"]] : Drawable | null);
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][];