@excalidraw/excalidraw 0.18.0-a30e1b2 → 0.18.0-a8acc82

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 (175) hide show
  1. package/dist/dev/chunk-6MX365WZ.js +5666 -0
  2. package/dist/dev/chunk-6MX365WZ.js.map +7 -0
  3. package/dist/dev/chunk-CP5DND7P.js +7 -0
  4. package/dist/dev/chunk-CP5DND7P.js.map +7 -0
  5. package/dist/dev/{chunk-CARD3WJZ.js → chunk-QF5FRM6O.js} +7 -2
  6. package/dist/dev/chunk-QF5FRM6O.js.map +7 -0
  7. package/dist/dev/data/{image-AYLHSOBV.js → image-GQCFJKGM.js} +3 -3
  8. package/dist/dev/index.css +187 -21
  9. package/dist/dev/index.css.map +3 -3
  10. package/dist/dev/index.js +15073 -16288
  11. package/dist/dev/index.js.map +4 -4
  12. package/dist/dev/locales/{en-E3O5XSXJ.js → en-SMAPCEOQ.js} +2 -2
  13. package/dist/dev/subset-shared.chunk.js +1 -1
  14. package/dist/dev/subset-worker.chunk.js +1 -1
  15. package/dist/prod/chunk-A66AFZZU.js +7 -0
  16. package/dist/prod/chunk-I4UNSFV6.js +12 -0
  17. package/dist/prod/chunk-R2M7VUMD.js +4 -0
  18. package/dist/prod/data/image-JWK7QZ22.js +1 -0
  19. package/dist/prod/index.css +1 -1
  20. package/dist/prod/index.js +27 -20
  21. package/dist/prod/locales/{en-44IKVKYT.js → en-TYY6KWIJ.js} +1 -1
  22. package/dist/prod/subset-shared.chunk.js +1 -1
  23. package/dist/prod/subset-worker.chunk.js +1 -1
  24. package/dist/types/common/src/constants.d.ts +38 -7
  25. package/dist/types/common/src/utils.d.ts +7 -5
  26. package/dist/types/element/src/Scene.d.ts +10 -6
  27. package/dist/types/element/src/align.d.ts +3 -2
  28. package/dist/types/element/src/binding.d.ts +11 -8
  29. package/dist/types/element/src/bounds.d.ts +12 -4
  30. package/dist/types/element/src/collision.d.ts +18 -12
  31. package/dist/types/element/src/cropElement.d.ts +1 -1
  32. package/dist/types/element/src/delta.d.ts +41 -9
  33. package/dist/types/element/src/distance.d.ts +2 -2
  34. package/dist/types/element/src/distribute.d.ts +2 -1
  35. package/dist/types/element/src/dragElements.d.ts +1 -1
  36. package/dist/types/element/src/flowchart.d.ts +1 -1
  37. package/dist/types/element/src/fractionalIndex.d.ts +8 -2
  38. package/dist/types/element/src/frame.d.ts +2 -2
  39. package/dist/types/element/src/groups.d.ts +1 -0
  40. package/dist/types/element/src/index.d.ts +42 -0
  41. package/dist/types/element/src/linearElementEditor.d.ts +15 -24
  42. package/dist/types/element/src/mutateElement.d.ts +1 -1
  43. package/dist/types/element/src/newElement.d.ts +3 -2
  44. package/dist/types/element/src/positionElementsOnGrid.d.ts +2 -0
  45. package/dist/types/element/src/renderElement.d.ts +4 -1
  46. package/dist/types/element/src/resizeElements.d.ts +2 -1
  47. package/dist/types/element/src/selection.d.ts +0 -5
  48. package/dist/types/element/src/shape.d.ts +42 -0
  49. package/dist/types/element/src/sizeHelpers.d.ts +2 -1
  50. package/dist/types/element/src/store.d.ts +19 -9
  51. package/dist/types/element/src/textElement.d.ts +2 -2
  52. package/dist/types/element/src/transformHandles.d.ts +2 -2
  53. package/dist/types/element/src/typeChecks.d.ts +16 -1
  54. package/dist/types/element/src/types.d.ts +10 -4
  55. package/dist/types/element/src/utils.d.ts +16 -6
  56. package/dist/types/element/src/zindex.d.ts +3 -3
  57. package/dist/types/excalidraw/actions/actionAddToLibrary.d.ts +24 -15
  58. package/dist/types/excalidraw/actions/actionAlign.d.ts +8 -8
  59. package/dist/types/excalidraw/actions/actionBoundText.d.ts +16 -10
  60. package/dist/types/excalidraw/actions/actionCanvas.d.ts +134 -94
  61. package/dist/types/excalidraw/actions/actionClipboard.d.ts +53 -33
  62. package/dist/types/excalidraw/actions/actionCropEditor.d.ts +8 -5
  63. package/dist/types/excalidraw/actions/actionDeleteSelected.d.ts +27 -17
  64. package/dist/types/excalidraw/actions/actionDistribute.d.ts +4 -4
  65. package/dist/types/excalidraw/actions/actionDuplicateSelection.d.ts +2 -2
  66. package/dist/types/excalidraw/actions/actionElementLink.d.ts +8 -5
  67. package/dist/types/excalidraw/actions/actionElementLock.d.ts +31 -26
  68. package/dist/types/excalidraw/actions/actionEmbeddable.d.ts +8 -5
  69. package/dist/types/excalidraw/actions/actionExport.d.ts +94 -67
  70. package/dist/types/excalidraw/actions/actionFinalize.d.ts +66 -19
  71. package/dist/types/excalidraw/actions/actionFlip.d.ts +4 -4
  72. package/dist/types/excalidraw/actions/actionFrame.d.ts +81 -69
  73. package/dist/types/excalidraw/actions/actionGroup.d.ts +20 -14
  74. package/dist/types/excalidraw/actions/actionLinearEditor.d.ts +534 -7
  75. package/dist/types/excalidraw/actions/actionLink.d.ts +10 -7
  76. package/dist/types/excalidraw/actions/actionMenu.d.ts +26 -17
  77. package/dist/types/excalidraw/actions/actionNavigate.d.ts +16 -10
  78. package/dist/types/excalidraw/actions/actionProperties.d.ts +145 -83
  79. package/dist/types/excalidraw/actions/actionSelectAll.d.ts +10 -7
  80. package/dist/types/excalidraw/actions/actionStyles.d.ts +12 -9
  81. package/dist/types/excalidraw/actions/actionToggleGridMode.d.ts +10 -7
  82. package/dist/types/excalidraw/actions/actionToggleObjectsSnapMode.d.ts +10 -7
  83. package/dist/types/excalidraw/actions/actionToggleSearchMenu.d.ts +10 -7
  84. package/dist/types/excalidraw/actions/actionToggleStats.d.ts +10 -7
  85. package/dist/types/excalidraw/actions/actionToggleViewMode.d.ts +10 -7
  86. package/dist/types/excalidraw/actions/actionToggleZenMode.d.ts +10 -7
  87. package/dist/types/excalidraw/actions/actionZindex.d.ts +10 -10
  88. package/dist/types/excalidraw/actions/index.d.ts +1 -1
  89. package/dist/types/excalidraw/actions/types.d.ts +3 -2
  90. package/dist/types/excalidraw/appState.d.ts +20 -10
  91. package/dist/types/excalidraw/clipboard.d.ts +64 -1
  92. package/dist/types/excalidraw/components/Actions.d.ts +8 -5
  93. package/dist/types/excalidraw/components/App.d.ts +22 -21
  94. package/dist/types/excalidraw/components/ButtonIcon.d.ts +1 -0
  95. package/dist/types/excalidraw/components/ColorPicker/ColorInput.d.ts +2 -1
  96. package/dist/types/excalidraw/components/ColorPicker/ColorPicker.d.ts +7 -2
  97. package/dist/types/excalidraw/components/ColorPicker/CustomColorList.d.ts +1 -1
  98. package/dist/types/excalidraw/components/ColorPicker/Picker.d.ts +2 -3
  99. package/dist/types/excalidraw/components/ColorPicker/PickerColorList.d.ts +2 -3
  100. package/dist/types/excalidraw/components/ColorPicker/ShadeList.d.ts +2 -2
  101. package/dist/types/excalidraw/components/ColorPicker/TopPicks.d.ts +1 -1
  102. package/dist/types/excalidraw/components/ColorPicker/colorPickerUtils.d.ts +1 -1
  103. package/dist/types/excalidraw/components/ColorPicker/keyboardNavHandlers.d.ts +1 -1
  104. package/dist/types/excalidraw/components/ConvertElementTypePopup.d.ts +2 -28
  105. package/dist/types/excalidraw/components/ElementLinkDialog.d.ts +1 -1
  106. package/dist/types/excalidraw/components/Ellipsify.d.ts +4 -0
  107. package/dist/types/excalidraw/components/FontPicker/FontPicker.d.ts +2 -1
  108. package/dist/types/excalidraw/components/FontPicker/FontPickerTrigger.d.ts +2 -1
  109. package/dist/types/excalidraw/components/PropertiesPopover.d.ts +1 -0
  110. package/dist/types/excalidraw/components/{ButtonIconSelect.d.ts → RadioSelection.d.ts} +1 -1
  111. package/dist/types/excalidraw/components/Range.d.ts +3 -3
  112. package/dist/types/excalidraw/components/Stats/Angle.d.ts +1 -1
  113. package/dist/types/excalidraw/components/Stats/CanvasGrid.d.ts +1 -1
  114. package/dist/types/excalidraw/components/Stats/Dimension.d.ts +1 -1
  115. package/dist/types/excalidraw/components/Stats/DragInput.d.ts +12 -2
  116. package/dist/types/excalidraw/components/Stats/FontSize.d.ts +1 -1
  117. package/dist/types/excalidraw/components/Stats/MultiAngle.d.ts +1 -1
  118. package/dist/types/excalidraw/components/Stats/MultiDimension.d.ts +1 -1
  119. package/dist/types/excalidraw/components/Stats/MultiFontSize.d.ts +1 -1
  120. package/dist/types/excalidraw/components/Stats/MultiPosition.d.ts +1 -1
  121. package/dist/types/excalidraw/components/Stats/Position.d.ts +1 -1
  122. package/dist/types/excalidraw/components/Stats/utils.d.ts +1 -1
  123. package/dist/types/excalidraw/components/UnlockPopup.d.ts +8 -0
  124. package/dist/types/excalidraw/components/hyperlink/Hyperlink.d.ts +1 -1
  125. package/dist/types/excalidraw/components/hyperlink/helpers.d.ts +2 -1
  126. package/dist/types/excalidraw/components/icons.d.ts +9 -0
  127. package/dist/types/excalidraw/components/shapes.d.ts +129 -1
  128. package/dist/types/excalidraw/data/blob.d.ts +3 -7
  129. package/dist/types/excalidraw/data/reconcile.d.ts +1 -0
  130. package/dist/types/excalidraw/data/restore.d.ts +6 -1
  131. package/dist/types/excalidraw/data/transform.d.ts +1 -1
  132. package/dist/types/excalidraw/data/types.d.ts +4 -1
  133. package/dist/types/excalidraw/eraser/index.d.ts +0 -2
  134. package/dist/types/excalidraw/fonts/Fonts.d.ts +1 -1
  135. package/dist/types/excalidraw/history.d.ts +21 -5
  136. package/dist/types/excalidraw/hooks/useTextEditorFocus.d.ts +14 -0
  137. package/dist/types/excalidraw/index.d.ts +11 -10
  138. package/dist/types/excalidraw/lasso/index.d.ts +1 -0
  139. package/dist/types/excalidraw/lasso/utils.d.ts +2 -1
  140. package/dist/types/excalidraw/renderer/helpers.d.ts +4 -4
  141. package/dist/types/excalidraw/renderer/staticScene.d.ts +4 -1
  142. package/dist/types/excalidraw/scene/Renderer.d.ts +1 -2
  143. package/dist/types/excalidraw/scene/index.d.ts +2 -2
  144. package/dist/types/excalidraw/snapping.d.ts +2 -2
  145. package/dist/types/excalidraw/types.d.ts +24 -13
  146. package/dist/types/math/src/angle.d.ts +2 -0
  147. package/dist/types/math/src/constants.d.ts +3 -0
  148. package/dist/types/math/src/curve.d.ts +32 -0
  149. package/dist/types/math/src/index.d.ts +1 -0
  150. package/dist/types/math/src/point.d.ts +1 -1
  151. package/dist/types/math/src/rectangle.d.ts +2 -0
  152. package/dist/types/math/src/segment.d.ts +1 -0
  153. package/dist/types/math/src/vector.d.ts +4 -2
  154. package/dist/types/utils/src/bbox.d.ts +1 -1
  155. package/dist/types/utils/src/index.d.ts +1 -1
  156. package/dist/types/utils/src/withinBounds.d.ts +1 -1
  157. package/history.ts +108 -45
  158. package/package.json +13 -10
  159. package/dist/dev/chunk-CARD3WJZ.js.map +0 -7
  160. package/dist/dev/chunk-ETWEPOFC.js +0 -18701
  161. package/dist/dev/chunk-ETWEPOFC.js.map +0 -7
  162. package/dist/dev/chunk-RS23HYC4.js +0 -7
  163. package/dist/dev/chunk-RS23HYC4.js.map +0 -7
  164. package/dist/prod/chunk-6BSJPDKJ.js +0 -33
  165. package/dist/prod/chunk-FGHASORR.js +0 -12
  166. package/dist/prod/chunk-SBKTMZM7.js +0 -7
  167. package/dist/prod/data/image-VAYKYPXV.js +0 -1
  168. package/dist/types/element/src/Shape.d.ts +0 -17
  169. package/dist/types/element/src/ShapeCache.d.ts +0 -25
  170. package/dist/types/element/src/shapes.d.ts +0 -23
  171. package/dist/types/excalidraw/components/ButtonSelect.d.ts +0 -9
  172. package/dist/types/excalidraw/visualdebug.d.ts +0 -41
  173. package/dist/types/utils/src/collision.d.ts +0 -8
  174. /package/dist/dev/data/{image-AYLHSOBV.js.map → image-GQCFJKGM.js.map} +0 -0
  175. /package/dist/dev/locales/{en-E3O5XSXJ.js.map → en-SMAPCEOQ.js.map} +0 -0
@@ -1 +1 @@
1
- import{A,B,C,D,E,F,G,H,I,J,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}from"../chunk-FGHASORR.js";import"../chunk-SRAX5OIU.js";export{f as alerts,e as buttons,l as canvasError,s as clearCanvasDialog,C as colorPicker,A as colors,I as commandPalette,v as confirmDialog,J as default,i as element,b as elementLink,x as encrypted,p as errorDialog,m as errorSplash,g as errors,q as exportDialog,G as fontList,j as headings,r as helpDialog,k as hints,w as imageExportDialog,a as labels,c as library,E as mermaid,D as overwriteConfirm,t as publishDialog,u as publishSuccessDialog,F as quickSearch,o as roomDialog,d as search,n as shareDialog,y as stats,z as toast,h as toolBar,H as userList,B as welcomeScreen};
1
+ import{A,B,C,D,E,F,G,H,I,J,a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p,q,r,s,t,u,v,w,x,y,z}from"../chunk-I4UNSFV6.js";import"../chunk-SRAX5OIU.js";export{f as alerts,e as buttons,l as canvasError,s as clearCanvasDialog,C as colorPicker,A as colors,I as commandPalette,v as confirmDialog,J as default,i as element,b as elementLink,x as encrypted,p as errorDialog,m as errorSplash,g as errors,q as exportDialog,G as fontList,j as headings,r as helpDialog,k as hints,w as imageExportDialog,a as labels,c as library,E as mermaid,D as overwriteConfirm,t as publishDialog,u as publishSuccessDialog,F as quickSearch,o as roomDialog,d as search,n as shareDialog,y as stats,z as toast,h as toolBar,H as userList,B as welcomeScreen};
@@ -1 +1 @@
1
- import{a,b,c,d}from"./chunk-LS7FJGPW.js";import"./chunk-SBKTMZM7.js";import"./chunk-SRAX5OIU.js";export{a as Commands,b as subsetToBase64,c as subsetToBinary,d as toBase64};
1
+ import{a,b,c,d}from"./chunk-LS7FJGPW.js";import"./chunk-A66AFZZU.js";import"./chunk-SRAX5OIU.js";export{a as Commands,b as subsetToBase64,c as subsetToBinary,d as toBase64};
@@ -1 +1 @@
1
- import{a as r,c as t}from"./chunk-LS7FJGPW.js";import"./chunk-SBKTMZM7.js";import"./chunk-SRAX5OIU.js";var s=import.meta.url?new URL(import.meta.url):void 0;typeof window>"u"&&typeof self<"u"&&(self.onmessage=async e=>{switch(e.data.command){case r.Subset:let a=await t(e.data.arrayBuffer,e.data.codePoints);self.postMessage(a,{transfer:[a]});break}});export{s as WorkerUrl};
1
+ import{a as r,c as t}from"./chunk-LS7FJGPW.js";import"./chunk-A66AFZZU.js";import"./chunk-SRAX5OIU.js";var s=import.meta.url?new URL(import.meta.url):void 0;typeof window>"u"&&typeof self<"u"&&(self.onmessage=async e=>{switch(e.data.command){case r.Subset:let a=await t(e.data.arrayBuffer,e.data.codePoints);self.postMessage(a,{transfer:[a]});break}});export{s as WorkerUrl};
@@ -8,10 +8,12 @@ export declare const isChrome: boolean;
8
8
  export declare const isSafari: boolean;
9
9
  export declare const isIOS: boolean;
10
10
  export declare const isBrave: () => boolean;
11
+ export declare const isMobile: boolean;
11
12
  export declare const supportsResizeObserver: boolean;
12
13
  export declare const APP_NAME = "Excalidraw";
13
14
  export declare const TEXT_AUTOWRAP_THRESHOLD = 36;
14
15
  export declare const DRAGGING_THRESHOLD = 10;
16
+ export declare const MINIMUM_ARROW_SIZE = 20;
15
17
  export declare const LINE_CONFIRM_THRESHOLD = 8;
16
18
  export declare const ELEMENT_SHIFT_TRANSLATE_AMOUNT = 5;
17
19
  export declare const ELEMENT_TRANSLATE_AMOUNT = 1;
@@ -89,6 +91,7 @@ export declare const CLASSES: {
89
91
  ZOOM_ACTIONS: string;
90
92
  SEARCH_MENU_INPUT_WRAPPER: string;
91
93
  CONVERT_ELEMENT_TYPE_POPUP: string;
94
+ SHAPE_ACTIONS_THEME_SCOPE: string;
92
95
  };
93
96
  export declare const CJK_HAND_DRAWN_FALLBACK_FONT = "Xiaolai";
94
97
  export declare const WINDOWS_EMOJI_FALLBACK_FONT = "Segoe UI Emoji";
@@ -111,10 +114,19 @@ export declare const FONT_FAMILY: {
111
114
  "Liberation Sans": number;
112
115
  Assistant: number;
113
116
  };
117
+ export declare const SANS_SERIF_GENERIC_FONT = "sans-serif";
118
+ export declare const MONOSPACE_GENERIC_FONT = "monospace";
119
+ export declare const FONT_FAMILY_GENERIC_FALLBACKS: {
120
+ "sans-serif": number;
121
+ monospace: number;
122
+ };
114
123
  export declare const FONT_FAMILY_FALLBACKS: {
115
- Xiaolai: number;
116
124
  "Segoe UI Emoji": number;
125
+ "sans-serif": number;
126
+ monospace: number;
127
+ Xiaolai: number;
117
128
  };
129
+ export declare function getGenericFontFamilyFallback(fontFamily: number): keyof typeof FONT_FAMILY_GENERIC_FALLBACKS;
118
130
  export declare const getFontFamilyFallbacks: (fontFamily: number) => Array<keyof typeof FONT_FAMILY_FALLBACKS>;
119
131
  export declare const THEME: {
120
132
  readonly LIGHT: "light";
@@ -165,6 +177,14 @@ export declare const IMAGE_MIME_TYPES: {
165
177
  readonly avif: "image/avif";
166
178
  readonly jfif: "image/jfif";
167
179
  };
180
+ export declare const STRING_MIME_TYPES: {
181
+ readonly text: "text/plain";
182
+ readonly html: "text/html";
183
+ readonly json: "application/json";
184
+ readonly excalidraw: "application/vnd.excalidraw+json";
185
+ readonly excalidrawlib: "application/vnd.excalidrawlib+json";
186
+ readonly excalidrawlibIds: "application/vnd.excalidrawlib.ids+json";
187
+ };
168
188
  export declare const MIME_TYPES: {
169
189
  readonly svg: "image/svg+xml";
170
190
  readonly png: "image/png";
@@ -175,14 +195,15 @@ export declare const MIME_TYPES: {
175
195
  readonly ico: "image/x-icon";
176
196
  readonly avif: "image/avif";
177
197
  readonly jfif: "image/jfif";
198
+ readonly "excalidraw.svg": "image/svg+xml";
199
+ readonly "excalidraw.png": "image/png";
200
+ readonly binary: "application/octet-stream";
178
201
  readonly text: "text/plain";
179
202
  readonly html: "text/html";
180
203
  readonly json: "application/json";
181
204
  readonly excalidraw: "application/vnd.excalidraw+json";
182
205
  readonly excalidrawlib: "application/vnd.excalidrawlib+json";
183
- readonly "excalidraw.svg": "image/svg+xml";
184
- readonly "excalidraw.png": "image/png";
185
- readonly binary: "application/octet-stream";
206
+ readonly excalidrawlibIds: "application/vnd.excalidrawlib.ids+json";
186
207
  };
187
208
  export declare const ALLOWED_PASTE_MIME_TYPES: readonly ["text/plain", "text/html", ...("image/svg+xml" | "image/png" | "image/jpeg" | "image/gif" | "image/webp" | "image/bmp" | "image/x-icon" | "image/avif" | "image/jfif")[]];
188
209
  export declare const EXPORT_IMAGE_TYPES: {
@@ -196,7 +217,7 @@ export declare const EXPORT_DATA_TYPES: {
196
217
  readonly excalidrawLibrary: "excalidrawlib";
197
218
  readonly excalidrawClipboardWithAPI: "excalidraw-api/clipboard";
198
219
  };
199
- export declare const EXPORT_SOURCE: string;
220
+ export declare const getExportSource: () => string;
200
221
  export declare const IMAGE_RENDER_TIMEOUT = 500;
201
222
  export declare const TAP_TWICE_TIMEOUT = 300;
202
223
  export declare const TOUCH_CTX_MENU_TIMEOUT = 500;
@@ -217,9 +238,12 @@ export declare const URL_HASH_KEYS: {
217
238
  readonly addLibrary: "addLibrary";
218
239
  };
219
240
  export declare const DEFAULT_UI_OPTIONS: AppProps["UIOptions"];
220
- export declare const MQ_MAX_WIDTH_PORTRAIT = 730;
241
+ export declare const MQ_MAX_MOBILE = 599;
221
242
  export declare const MQ_MAX_WIDTH_LANDSCAPE = 1000;
222
243
  export declare const MQ_MAX_HEIGHT_LANDSCAPE = 500;
244
+ export declare const MQ_MIN_TABLET: number;
245
+ export declare const MQ_MAX_TABLET = 1400;
246
+ export declare const MQ_MIN_WIDTH_DESKTOP = 1440;
223
247
  export declare const MQ_RIGHT_SIDEBAR_MIN_WIDTH = 1229;
224
248
  export declare const MAX_DECIMALS_FOR_SVG_EXPORT = 2;
225
249
  export declare const EXPORT_SCALES: number[];
@@ -280,7 +304,7 @@ export declare const DEFAULT_SIDEBAR: {
280
304
  readonly name: "default";
281
305
  readonly defaultTab: "library";
282
306
  };
283
- export declare const LIBRARY_DISABLED_TYPES: Set<"embeddable" | "image" | "iframe">;
307
+ export declare const LIBRARY_DISABLED_TYPES: Set<"embeddable" | "iframe" | "image">;
284
308
  export declare const TOOL_TYPE: {
285
309
  readonly selection: "selection";
286
310
  readonly lasso: "lasso";
@@ -326,3 +350,10 @@ export declare enum UserIdleState {
326
350
  AWAY = "away",
327
351
  IDLE = "idle"
328
352
  }
353
+ /**
354
+ * distance at which we merge points instead of adding a new merge-point
355
+ * when converting a line to a polygon (merge currently means overlaping
356
+ * the start and end points)
357
+ */
358
+ export declare const LINE_POLYGON_POINT_MERGE_DISTANCE = 20;
359
+ export declare const DOUBLE_TAP_POSITION_THRESHOLD = 35;
@@ -1,5 +1,4 @@
1
- import { type GlobalPoint } from "@excalidraw/math";
2
- import type { ExcalidrawBindableElement, FontFamilyValues, FontString, ExcalidrawElement } from "@excalidraw/element/types";
1
+ import type { ExcalidrawBindableElement, FontFamilyValues, FontString } from "@excalidraw/element/types";
3
2
  import type { ActiveTool, AppState, ToolType, UnsubscribeCallback, Zoom } from "@excalidraw/excalidraw/types";
4
3
  import type { MaybePromise } from "./utility-types";
5
4
  import type { EVENT } from "./constants";
@@ -138,6 +137,8 @@ export declare const tupleToCoors: (xyTuple: readonly [number, number]) => {
138
137
  export declare const muteFSAbortError: (error?: Error) => void;
139
138
  export declare const findIndex: <T>(array: readonly T[], cb: (element: T, index: number, array: readonly T[]) => boolean, fromIndex?: number) => number;
140
139
  export declare const findLastIndex: <T>(array: readonly T[], cb: (element: T, index: number, array: readonly T[]) => boolean, fromIndex?: number) => number;
140
+ /** returns the first non-null mapped value */
141
+ export declare const mapFind: <T, K>(collection: readonly T[], iteratee: (value: T, index: number) => K | null | undefined) => K | undefined;
141
142
  export declare const isTransparent: (color: string) => boolean;
142
143
  export declare const isBindingFallthroughEnabled: (el: ExcalidrawBindableElement) => boolean;
143
144
  export type ResolvablePromise<T> = Promise<T> & {
@@ -196,7 +197,7 @@ export declare const wrapEvent: <T extends Event>(name: EVENT, nativeEvent: T) =
196
197
  }>;
197
198
  export declare const updateObject: <T extends Record<string, any>>(obj: T, updates: Partial<T>) => T;
198
199
  export declare const isPrimitive: (val: any) => boolean;
199
- export declare const getFrame: () => "iframe" | "top";
200
+ export declare const getFrame: () => "top" | "iframe";
200
201
  export declare const isRunningInIframe: () => boolean;
201
202
  export declare const isPromiseLike: (value: any) => value is Promise<any>;
202
203
  export declare const queryFocusableElements: (container: HTMLElement | null) => HTMLElement[];
@@ -259,8 +260,9 @@ export declare const safelyParseJSON: (json: string) => Record<string, any> | nu
259
260
  */
260
261
  export declare const escapeDoubleQuotes: (str: string) => string;
261
262
  export declare const castArray: <T>(value: T | T[]) => T[];
262
- export declare const elementCenterPoint: (element: ExcalidrawElement, xOffset?: number, yOffset?: number) => GlobalPoint;
263
263
  /** hack for Array.isArray type guard not working with readonly value[] */
264
264
  export declare const isReadonlyArray: (value?: any) => value is readonly any[];
265
- export declare const sizeOf: (value: readonly number[] | Readonly<Map<any, any>> | Record<any, any>) => number;
265
+ export declare const sizeOf: (value: readonly unknown[] | Readonly<Map<string, unknown>> | Readonly<Record<string, unknown>> | ReadonlySet<unknown>) => number;
266
+ export declare const reduceToCommonValue: <T, R = T>(collection: ReadonlySet<T> | readonly T[], getValue?: ((item: T) => R) | undefined) => R | null;
267
+ export declare const isMobileOrTablet: () => boolean;
266
268
  export {};
@@ -1,11 +1,11 @@
1
- import { type ElementUpdate } from "@excalidraw/element/mutateElement";
1
+ import { type ElementUpdate } from "@excalidraw/element";
2
2
  import type { ExcalidrawElement, NonDeletedExcalidrawElement, NonDeleted, ExcalidrawFrameLikeElement, ElementsMapOrArray, 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;
6
6
  type SceneStateCallbackRemover = () => void;
7
7
  export type ExcalidrawElementsIncludingDeleted = readonly ExcalidrawElement[];
8
- declare class Scene {
8
+ export declare class Scene {
9
9
  private callbacks;
10
10
  private nonDeletedElements;
11
11
  private nonDeletedElementsMap;
@@ -27,7 +27,9 @@ declare class Scene {
27
27
  getElementsMapIncludingDeleted(): Map<string, Ordered<ExcalidrawElement>> & import("@excalidraw/common/utility-types").MakeBrand<"SceneElementsMap">;
28
28
  getNonDeletedElements(): readonly Ordered<NonDeletedExcalidrawElement>[];
29
29
  getFramesIncludingDeleted(): readonly ExcalidrawFrameLikeElement[];
30
- constructor(elements?: ElementsMapOrArray | null);
30
+ constructor(elements?: ElementsMapOrArray | null, options?: {
31
+ skipValidation?: true;
32
+ });
31
33
  getSelectedElements(opts: {
32
34
  selectedElementIds: AppState["selectedElementIds"];
33
35
  /**
@@ -55,7 +57,9 @@ declare class Scene {
55
57
  * @returns whether a change was made
56
58
  */
57
59
  mapElements(iteratee: (element: ExcalidrawElement) => ExcalidrawElement): boolean;
58
- replaceAllElements(nextElements: ElementsMapOrArray): void;
60
+ replaceAllElements(nextElements: ElementsMapOrArray, options?: {
61
+ skipValidation?: true;
62
+ }): void;
59
63
  triggerUpdate(): void;
60
64
  onUpdate(cb: SceneStateCallback): SceneStateCallbackRemover;
61
65
  destroy(): void;
@@ -66,11 +70,11 @@ declare class Scene {
66
70
  getElementIndex(elementId: string): number;
67
71
  getContainerElement: (element: (ExcalidrawElement & {
68
72
  containerId: ExcalidrawElement["id"] | null;
69
- }) | null) => 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").ExcalidrawTextElement | 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;
70
74
  getElementsFromId: (id: string) => ExcalidrawElement[];
71
75
  mutateElement<TElement extends Mutable<ExcalidrawElement>>(element: TElement, updates: ElementUpdate<TElement>, options?: {
72
76
  informMutation: boolean;
73
77
  isDragging: boolean;
74
78
  }): TElement;
75
79
  }
76
- export default Scene;
80
+ export {};
@@ -1,7 +1,8 @@
1
- import type Scene from "./Scene";
1
+ import type { AppState } from "@excalidraw/excalidraw/types";
2
+ import type { Scene } from "./Scene";
2
3
  import type { ExcalidrawElement } from "./types";
3
4
  export interface Alignment {
4
5
  position: "start" | "center" | "end";
5
6
  axis: "x" | "y";
6
7
  }
7
- export declare const alignElements: (selectedElements: ExcalidrawElement[], alignment: Alignment, scene: Scene) => ExcalidrawElement[];
8
+ export declare const alignElements: (selectedElements: ExcalidrawElement[], alignment: Alignment, scene: Scene, appState: Readonly<AppState>) => ExcalidrawElement[];
@@ -2,7 +2,7 @@ import { type GlobalPoint } from "@excalidraw/math";
2
2
  import type { LocalPoint } from "@excalidraw/math";
3
3
  import type { AppState } from "@excalidraw/excalidraw/types";
4
4
  import { type Heading } from "./heading";
5
- import type Scene from "./Scene";
5
+ import type { Scene } from "./Scene";
6
6
  import type { Bounds } from "./bounds";
7
7
  import type { ElementUpdate } from "./mutateElement";
8
8
  import type { ExcalidrawBindableElement, ExcalidrawElement, NonDeleted, ExcalidrawLinearElement, NonDeletedExcalidrawElement, ElementsMap, NonDeletedSceneElementsMap, ExcalidrawElbowArrowElement, FixedPoint } from "./types";
@@ -16,10 +16,13 @@ export declare const shouldEnableBindingForPointerEvent: (event: React.PointerEv
16
16
  export declare const isBindingEnabled: (appState: AppState) => boolean;
17
17
  export declare const FIXED_BINDING_DISTANCE = 5;
18
18
  export declare const BINDING_HIGHLIGHT_THICKNESS = 10;
19
- export declare const BINDING_HIGHLIGHT_OFFSET = 4;
20
19
  export declare const bindOrUnbindLinearElement: (linearElement: NonDeleted<ExcalidrawLinearElement>, startBindingElement: ExcalidrawBindableElement | null | "keep", endBindingElement: ExcalidrawBindableElement | null | "keep", scene: Scene) => void;
21
20
  export declare const bindOrUnbindLinearElements: (selectedElements: NonDeleted<ExcalidrawLinearElement>[], isBindingEnabled: boolean, draggingPoints: readonly number[] | null, scene: Scene, zoom?: AppState["zoom"]) => void;
22
21
  export declare const getSuggestedBindingsForArrows: (selectedElements: NonDeleted<ExcalidrawElement>[], elementsMap: NonDeletedSceneElementsMap, zoom: AppState["zoom"]) => SuggestedBinding[];
22
+ export declare const maybeSuggestBindingsForLinearElementAtCoords: (linearElement: NonDeleted<ExcalidrawLinearElement>, pointerCoords: {
23
+ x: number;
24
+ y: number;
25
+ }[], scene: Scene, zoom: AppState["zoom"], oppositeBindingBoundElement?: ExcalidrawBindableElement | null) => ExcalidrawBindableElement[];
23
26
  export declare const maybeBindLinearElement: (linearElement: NonDeleted<ExcalidrawLinearElement>, appState: AppState, pointerCoords: {
24
27
  x: number;
25
28
  y: number;
@@ -46,11 +49,11 @@ export declare const updateBindings: (latestElement: ExcalidrawElement, scene: S
46
49
  };
47
50
  zoom?: AppState["zoom"];
48
51
  }) => void;
49
- export declare const getHeadingForElbowArrowSnap: (p: Readonly<GlobalPoint>, otherPoint: Readonly<GlobalPoint>, bindableElement: ExcalidrawBindableElement | undefined | null, aabb: Bounds | undefined | null, origPoint: GlobalPoint, zoom?: AppState["zoom"]) => Heading;
50
- export declare const bindPointToSnapToElementOutline: (arrow: ExcalidrawElbowArrowElement, bindableElement: ExcalidrawBindableElement, startOrEnd: "start" | "end") => GlobalPoint;
51
- export declare const avoidRectangularCorner: (element: ExcalidrawBindableElement, p: GlobalPoint) => GlobalPoint;
52
- export declare const snapToMid: (element: ExcalidrawBindableElement, p: GlobalPoint, tolerance?: number) => GlobalPoint;
53
- export declare const calculateFixedPointForElbowArrowBinding: (linearElement: NonDeleted<ExcalidrawElbowArrowElement>, hoveredElement: ExcalidrawBindableElement, startOrEnd: "start" | "end") => {
52
+ export declare const getHeadingForElbowArrowSnap: (p: Readonly<GlobalPoint>, otherPoint: Readonly<GlobalPoint>, bindableElement: ExcalidrawBindableElement | undefined | null, aabb: Bounds | undefined | null, origPoint: GlobalPoint, elementsMap: ElementsMap, zoom?: AppState["zoom"]) => Heading;
53
+ export declare const bindPointToSnapToElementOutline: (arrow: ExcalidrawElbowArrowElement, bindableElement: ExcalidrawBindableElement, startOrEnd: "start" | "end", elementsMap: ElementsMap) => GlobalPoint;
54
+ export declare const avoidRectangularCorner: (element: ExcalidrawBindableElement, elementsMap: ElementsMap, p: GlobalPoint) => GlobalPoint;
55
+ export declare const snapToMid: (element: ExcalidrawBindableElement, elementsMap: ElementsMap, p: GlobalPoint, tolerance?: number) => GlobalPoint;
56
+ export declare const calculateFixedPointForElbowArrowBinding: (linearElement: NonDeleted<ExcalidrawElbowArrowElement>, hoveredElement: ExcalidrawBindableElement, startOrEnd: "start" | "end", elementsMap: ElementsMap) => {
54
57
  fixedPoint: FixedPoint;
55
58
  };
56
59
  export declare const fixDuplicatedBindingsAfterDuplication: (duplicatedElements: ExcalidrawElement[], origIdToDuplicateId: Map<ExcalidrawElement["id"], ExcalidrawElement["id"]>, duplicateElementsMap: NonDeletedSceneElementsMap) => void;
@@ -101,7 +104,7 @@ export declare class BindableElement {
101
104
  */
102
105
  static rebindAffected: (elements: ElementsMap, bindableElement: ExcalidrawElement | undefined, updateElementWith: (affected: ExcalidrawElement, updates: ElementUpdate<ExcalidrawElement>) => void) => void;
103
106
  }
104
- export declare const getGlobalFixedPointForBindableElement: (fixedPointRatio: [number, number], element: ExcalidrawBindableElement) => GlobalPoint;
107
+ export declare const getGlobalFixedPointForBindableElement: (fixedPointRatio: [number, number], element: ExcalidrawBindableElement, elementsMap: ElementsMap) => GlobalPoint;
105
108
  export declare const getGlobalFixedPoints: (arrow: ExcalidrawElbowArrowElement, elementsMap: ElementsMap) => [GlobalPoint, GlobalPoint];
106
109
  export declare const getArrowLocalFixedPoints: (arrow: ExcalidrawElbowArrowElement, elementsMap: ElementsMap) => LocalPoint[];
107
110
  export declare const normalizeFixedPoint: <T extends FixedPoint | null>(fixedPoint: T) => T extends null ? null : FixedPoint;
@@ -1,4 +1,4 @@
1
- import type { Degrees, GlobalPoint, LineSegment } from "@excalidraw/math";
1
+ import type { Degrees, GlobalPoint, LineSegment, LocalPoint } from "@excalidraw/math";
2
2
  import type { AppState } from "@excalidraw/excalidraw/types";
3
3
  import type { Drawable, Op } from "roughjs/bin/core";
4
4
  import type { Arrowhead, ElementsMap, ElementsMapOrArray, ExcalidrawElement, ExcalidrawFreeDrawElement, ExcalidrawLinearElement, NonDeleted } from "./types";
@@ -26,7 +26,8 @@ export type SceneBounds = readonly [
26
26
  ];
27
27
  export declare class ElementBounds {
28
28
  private static boundsCache;
29
- static getBounds(element: ExcalidrawElement, elementsMap: ElementsMap): Bounds;
29
+ private static nonRotatedBoundsCache;
30
+ static getBounds(element: ExcalidrawElement, elementsMap: ElementsMap, nonRotated?: boolean): Bounds;
30
31
  private static calculateBounds;
31
32
  }
32
33
  export declare const getElementAbsoluteCoords: (element: ExcalidrawElement, elementsMap: ElementsMap, includeBoundText?: boolean) => [number, number, number, number, number, number];
@@ -43,6 +44,7 @@ export declare const getElementLineSegments: (element: ExcalidrawElement, elemen
43
44
  */
44
45
  export declare const getRectangleBoxAbsoluteCoords: (boxSceneCoords: RectangleBox) => number[];
45
46
  export declare const getDiamondPoints: (element: ExcalidrawElement) => number[];
47
+ export declare const getCubicBezierCurveBound: (p0: GlobalPoint, p1: GlobalPoint, p2: GlobalPoint, p3: GlobalPoint) => Bounds;
46
48
  export declare const getMinMaxXYFromCurvePathOps: (ops: Op[], transformXY?: ((p: GlobalPoint) => GlobalPoint) | undefined) => Bounds;
47
49
  export declare const getBoundsFromPoints: (points: ExcalidrawFreeDrawElement["points"]) => Bounds;
48
50
  /** @returns number in pixels */
@@ -50,7 +52,7 @@ export declare const getArrowheadSize: (arrowhead: Arrowhead) => number;
50
52
  /** @returns number in degrees */
51
53
  export declare const getArrowheadAngle: (arrowhead: Arrowhead) => Degrees;
52
54
  export declare const getArrowheadPoints: (element: ExcalidrawLinearElement, shape: Drawable[], position: "start" | "end", arrowhead: Arrowhead) => number[] | null;
53
- export declare const getElementBounds: (element: ExcalidrawElement, elementsMap: ElementsMap) => Bounds;
55
+ export declare const getElementBounds: (element: ExcalidrawElement, elementsMap: ElementsMap, nonRotated?: boolean) => Bounds;
54
56
  export declare const getCommonBounds: (elements: ElementsMapOrArray, elementsMap?: ElementsMap) => Bounds;
55
57
  export declare const getDraggedElementsBounds: (elements: ExcalidrawElement[], dragOffset: {
56
58
  x: number;
@@ -72,10 +74,16 @@ export interface BoundingBox {
72
74
  width: number;
73
75
  height: number;
74
76
  }
75
- export declare const getCommonBoundingBox: (elements: ExcalidrawElement[] | readonly NonDeleted<ExcalidrawElement>[]) => BoundingBox;
77
+ export declare const getCommonBoundingBox: (elements: readonly ExcalidrawElement[] | readonly NonDeleted<ExcalidrawElement>[]) => BoundingBox;
76
78
  /**
77
79
  * returns scene coords of user's editor viewport (visible canvas area) bounds
78
80
  */
79
81
  export declare const getVisibleSceneBounds: ({ scrollX, scrollY, width, height, zoom, }: AppState) => SceneBounds;
80
82
  export declare const getCenterForBounds: (bounds: Bounds) => GlobalPoint;
83
+ /**
84
+ * Get the axis-aligned bounding box for a given element
85
+ */
86
+ export declare const aabbForElement: (element: Readonly<ExcalidrawElement>, elementsMap: ElementsMap, offset?: [number, number, number, number]) => Bounds;
87
+ export declare const pointInsideBounds: <P extends GlobalPoint | LocalPoint>(p: P, bounds: Bounds) => boolean;
81
88
  export declare const doBoundsIntersect: (bounds1: Bounds | null, bounds2: Bounds | null) => boolean;
89
+ export declare const elementCenterPoint: (element: ExcalidrawElement, elementsMap: ElementsMap, xOffset?: number, yOffset?: number) => GlobalPoint;
@@ -1,20 +1,18 @@
1
- import { type GeometricShape } from "@excalidraw/utils/shape";
2
- import type { GlobalPoint, LineSegment, LocalPoint } from "@excalidraw/math";
1
+ import type { GlobalPoint, LineSegment } from "@excalidraw/math";
3
2
  import type { FrameNameBounds } from "@excalidraw/excalidraw/types";
4
3
  import type { ElementsMap, ExcalidrawElement } from "./types";
5
4
  export declare const shouldTestInside: (element: ExcalidrawElement) => boolean;
6
- export type HitTestArgs<Point extends GlobalPoint | LocalPoint> = {
7
- x: number;
8
- y: number;
5
+ export type HitTestArgs = {
6
+ point: GlobalPoint;
9
7
  element: ExcalidrawElement;
10
- shape: GeometricShape<Point>;
11
- threshold?: number;
8
+ threshold: number;
9
+ elementsMap: ElementsMap;
12
10
  frameNameBound?: FrameNameBounds | null;
13
11
  };
14
- export declare const hitElementItself: <Point extends GlobalPoint | LocalPoint>({ x, y, element, shape, threshold, frameNameBound, }: HitTestArgs<Point>) => boolean;
15
- export declare const hitElementBoundingBox: (x: number, y: number, element: ExcalidrawElement, elementsMap: ElementsMap, tolerance?: number) => boolean;
16
- export declare const hitElementBoundingBoxOnly: <Point extends GlobalPoint | LocalPoint>(hitArgs: HitTestArgs<Point>, elementsMap: ElementsMap) => boolean;
17
- export declare const hitElementBoundText: <Point extends GlobalPoint | LocalPoint>(x: number, y: number, textShape: GeometricShape<Point> | null) => boolean;
12
+ export declare const hitElementItself: ({ point, element, threshold, elementsMap, frameNameBound, }: HitTestArgs) => boolean;
13
+ export declare const hitElementBoundingBox: (point: GlobalPoint, element: ExcalidrawElement, elementsMap: ElementsMap, tolerance?: number) => boolean;
14
+ export declare const hitElementBoundingBoxOnly: (hitArgs: HitTestArgs, elementsMap: ElementsMap) => boolean;
15
+ export declare const hitElementBoundText: (point: GlobalPoint, element: ExcalidrawElement, elementsMap: ElementsMap) => boolean;
18
16
  /**
19
17
  * Intersect a line with an element for binding test
20
18
  *
@@ -23,4 +21,12 @@ export declare const hitElementBoundText: <Point extends GlobalPoint | LocalPoin
23
21
  * @param offset
24
22
  * @returns
25
23
  */
26
- export declare const intersectElementWithLineSegment: (element: ExcalidrawElement, line: LineSegment<GlobalPoint>, offset?: number) => GlobalPoint[];
24
+ export declare const intersectElementWithLineSegment: (element: ExcalidrawElement, elementsMap: ElementsMap, line: LineSegment<GlobalPoint>, offset?: number, onlyFirst?: boolean) => GlobalPoint[];
25
+ /**
26
+ * Check if the given point is considered inside the element's border
27
+ *
28
+ * @param point
29
+ * @param element
30
+ * @returns
31
+ */
32
+ export declare const isPointInElement: (point: GlobalPoint, element: ExcalidrawElement, elementsMap: ElementsMap) => boolean;
@@ -1,7 +1,7 @@
1
1
  import type { TransformHandleType } from "./transformHandles";
2
2
  import type { ElementsMap, ExcalidrawImageElement, ImageCrop } from "./types";
3
3
  export declare const MINIMAL_CROP_SIZE = 10;
4
- export declare const cropElement: (element: ExcalidrawImageElement, transformHandle: TransformHandleType, naturalWidth: number, naturalHeight: number, pointerX: number, pointerY: number, widthAspectRatio?: number) => {
4
+ export declare const cropElement: (element: ExcalidrawImageElement, elementsMap: ElementsMap, transformHandle: TransformHandleType, naturalWidth: number, naturalHeight: number, pointerX: number, pointerY: number, widthAspectRatio?: number) => {
5
5
  x: number;
6
6
  y: number;
7
7
  width: number;
@@ -1,7 +1,7 @@
1
1
  import type { ExcalidrawElement, Ordered, OrderedExcalidrawElement, SceneElementsMap } from "@excalidraw/element/types";
2
2
  import type { DTO, ValueOf } from "@excalidraw/common/utility-types";
3
3
  import type { AppState, ObservedAppState } from "@excalidraw/excalidraw/types";
4
- import type { ElementUpdate } from "./mutateElement";
4
+ import { StoreSnapshot } from "./store";
5
5
  /**
6
6
  * Represents the difference between two objects of the same type.
7
7
  *
@@ -15,7 +15,7 @@ export declare class Delta<T> {
15
15
  readonly deleted: Partial<T>;
16
16
  readonly inserted: Partial<T>;
17
17
  private constructor();
18
- static create<T>(deleted: Partial<T>, inserted: Partial<T>, modifier?: (delta: Partial<T>) => Partial<T>, modifierOptions?: "deleted" | "inserted"): Delta<T>;
18
+ static create<T>(deleted: Partial<T>, inserted: Partial<T>, modifier?: (delta: Partial<T>, partialType: "deleted" | "inserted") => Partial<T>, modifierOptions?: "deleted" | "inserted" | "both"): Delta<T>;
19
19
  /**
20
20
  * Calculates the delta between two objects.
21
21
  *
@@ -29,12 +29,16 @@ export declare class Delta<T> {
29
29
  }>(prevObject: T, nextObject: T, modifier?: (partial: Partial<T>) => Partial<T>, postProcess?: (deleted: Partial<T>, inserted: Partial<T>) => [Partial<T>, Partial<T>]): Delta<T>;
30
30
  static empty(): Delta<unknown>;
31
31
  static isEmpty<T>(delta: Delta<T>): boolean;
32
+ /**
33
+ * Merges two deltas into a new one.
34
+ */
35
+ static merge<T>(delta1: Delta<T>, delta2: Delta<T>, delta3?: Delta<T>): Delta<T>;
32
36
  /**
33
37
  * Merges deleted and inserted object partials.
34
38
  */
35
39
  static mergeObjects<T extends {
36
40
  [key: string]: unknown;
37
- }>(prev: T, added: T, removed: T): T;
41
+ }>(prev: T, added: T, removed?: T): T;
38
42
  /**
39
43
  * Merges deleted and inserted array partials.
40
44
  */
@@ -55,6 +59,14 @@ export declare class Delta<T> {
55
59
  * Compares if object2 contains any different value compared to the object1.
56
60
  */
57
61
  static isRightDifferent<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): boolean;
62
+ /**
63
+ * Compares if shared properties of object1 and object2 contain any different value (aka inner join).
64
+ */
65
+ static isInnerDifferent<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): boolean;
66
+ /**
67
+ * Compares if any properties of object1 and object2 contain any different value (aka full join).
68
+ */
69
+ static isDifferent<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): boolean;
58
70
  /**
59
71
  * Returns sorted object1 keys that have distinct values.
60
72
  */
@@ -63,6 +75,14 @@ export declare class Delta<T> {
63
75
  * Returns sorted object2 keys that have distinct values.
64
76
  */
65
77
  static getRightDifferences<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): string[];
78
+ /**
79
+ * Returns sorted keys of shared object1 and object2 properties that have distinct values (aka inner join).
80
+ */
81
+ static getInnerDifferences<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): string[];
82
+ /**
83
+ * Returns sorted keys that have distinct values between object1 and object2 (aka full join).
84
+ */
85
+ static getDifferences<T extends {}>(object1: T, object2: T, skipShallowCompare?: boolean): string[];
66
86
  /**
67
87
  * Iterator comparing values of object properties based on the passed joining strategy.
68
88
  *
@@ -86,18 +106,24 @@ export interface DeltaContainer<T> {
86
106
  * @returns a tuple of the next object `T` with applied `Delta`s, and `boolean`, indicating whether the applied deltas resulted in a visible change.
87
107
  */
88
108
  applyTo(previous: T, ...options: unknown[]): [T, boolean];
109
+ /**
110
+ * Squashes the current delta with the given one.
111
+ */
112
+ squash(delta: DeltaContainer<T>): this;
89
113
  /**
90
114
  * Checks whether all `Delta`s are empty.
91
115
  */
92
116
  isEmpty(): boolean;
93
117
  }
94
118
  export declare class AppStateDelta implements DeltaContainer<AppState> {
95
- readonly delta: Delta<ObservedAppState>;
119
+ delta: Delta<ObservedAppState>;
96
120
  private constructor();
121
+ static create(delta: Delta<ObservedAppState>): AppStateDelta;
97
122
  static calculate<T extends ObservedAppState>(prevAppState: T, nextAppState: T): AppStateDelta;
98
123
  static restore(appStateDeltaDTO: DTO<AppStateDelta>): AppStateDelta;
99
124
  static empty(): AppStateDelta;
100
125
  inverse(): AppStateDelta;
126
+ squash(delta: AppStateDelta): this;
101
127
  applyTo(appState: AppState, nextElements: SceneElementsMap): [AppState, boolean];
102
128
  isEmpty(): boolean;
103
129
  /**
@@ -106,7 +132,6 @@ export declare class AppStateDelta implements DeltaContainer<AppState> {
106
132
  * @returns `true` if a visible change is found, `false` otherwise.
107
133
  */
108
134
  private filterInvisibleChanges;
109
- private static convertToAppStateKey;
110
135
  private static filterSelectedElements;
111
136
  private static filterSelectedGroups;
112
137
  private static stripElementsProps;
@@ -118,7 +143,10 @@ export declare class AppStateDelta implements DeltaContainer<AppState> {
118
143
  private static postProcess;
119
144
  private static orderAppStateKeys;
120
145
  }
121
- type ElementPartial<T extends ExcalidrawElement = ExcalidrawElement> = Omit<ElementUpdate<Ordered<T>>, "seed">;
146
+ type ElementPartial<TElement extends ExcalidrawElement = ExcalidrawElement> = Omit<Partial<Ordered<TElement>>, "id" | "updated" | "seed">;
147
+ export type ApplyToOptions = {
148
+ excludedProperties?: Set<keyof ElementPartial>;
149
+ };
122
150
  /**
123
151
  * Elements change is a low level primitive to capture a change between two sets of elements.
124
152
  * It does so by encapsulating forward and backward `Delta`s, allowing to time-travel in both directions.
@@ -135,6 +163,8 @@ export declare class ElementsDelta implements DeltaContainer<SceneElementsMap> {
135
163
  private static satisfiesAddition;
136
164
  private static satisfiesRemoval;
137
165
  private static satisfiesUpdate;
166
+ private static satisfiesCommmonInvariants;
167
+ private static satisfiesUniqueInvariants;
138
168
  private static validate;
139
169
  /**
140
170
  * Calculates the `Delta`s between the previous and next set of elements.
@@ -151,12 +181,13 @@ export declare class ElementsDelta implements DeltaContainer<SceneElementsMap> {
151
181
  /**
152
182
  * Update delta/s based on the existing elements.
153
183
  *
154
- * @param elements current elements
184
+ * @param nextElements current elements
155
185
  * @param modifierOptions defines which of the delta (`deleted` or `inserted`) will be updated
156
186
  * @returns new instance with modified delta/s
157
187
  */
158
- applyLatestChanges(elements: SceneElementsMap, modifierOptions: "deleted" | "inserted"): ElementsDelta;
159
- applyTo(elements: SceneElementsMap, elementsSnapshot: Map<string, OrderedExcalidrawElement>): [SceneElementsMap, boolean];
188
+ applyLatestChanges(prevElements: SceneElementsMap, nextElements: SceneElementsMap, modifierOptions?: "deleted" | "inserted"): ElementsDelta;
189
+ applyTo(elements: SceneElementsMap, snapshot?: StoreSnapshot["elements"], options?: ApplyToOptions): [SceneElementsMap, boolean];
190
+ squash(delta: ElementsDelta): this;
160
191
  private static createApplier;
161
192
  private static createGetter;
162
193
  private static applyDelta;
@@ -183,6 +214,7 @@ export declare class ElementsDelta implements DeltaContainer<SceneElementsMap> {
183
214
  * should be rebound (if possible) with the current element ~ bindings should be bidirectional.
184
215
  */
185
216
  private static rebindAffected;
217
+ static redrawElements(nextElements: SceneElementsMap, changedElements: Map<string, OrderedExcalidrawElement>): SceneElementsMap;
186
218
  private static redrawTextBoundingBoxes;
187
219
  private static redrawBoundArrows;
188
220
  private static reorderElements;
@@ -1,3 +1,3 @@
1
1
  import type { GlobalPoint } from "@excalidraw/math";
2
- import type { ExcalidrawBindableElement } from "./types";
3
- export declare const distanceToBindableElement: (element: ExcalidrawBindableElement, p: GlobalPoint) => number;
2
+ import type { ElementsMap, ExcalidrawElement } from "./types";
3
+ export declare const distanceToElement: (element: ExcalidrawElement, elementsMap: ElementsMap, p: GlobalPoint) => number;
@@ -1,6 +1,7 @@
1
+ import type { AppState } from "@excalidraw/excalidraw/types";
1
2
  import type { ElementsMap, ExcalidrawElement } from "./types";
2
3
  export interface Distribution {
3
4
  space: "between";
4
5
  axis: "x" | "y";
5
6
  }
6
- export declare const distributeElements: (selectedElements: ExcalidrawElement[], elementsMap: ElementsMap, distribution: Distribution) => ExcalidrawElement[];
7
+ export declare const distributeElements: (selectedElements: ExcalidrawElement[], elementsMap: ElementsMap, distribution: Distribution, appState: Readonly<AppState>) => ExcalidrawElement[];
@@ -1,6 +1,6 @@
1
1
  import type { AppState, NormalizedZoomValue, NullableGridSize, PointerDownState } from "@excalidraw/excalidraw/types";
2
2
  import type { NonDeletedExcalidrawElement } from "@excalidraw/element/types";
3
- import type Scene from "./Scene";
3
+ import type { Scene } from "./Scene";
4
4
  export declare const dragSelectedElements: (pointerDownState: PointerDownState, _selectedElements: NonDeletedExcalidrawElement[], offset: {
5
5
  x: number;
6
6
  y: number;
@@ -1,6 +1,6 @@
1
1
  import type { AppState, PendingExcalidrawElements } from "@excalidraw/excalidraw/types";
2
2
  import { type ElementsMap, type ExcalidrawBindableElement, type ExcalidrawElement, type ExcalidrawFlowchartNodeElement } from "./types";
3
- import type Scene from "./Scene";
3
+ import type { Scene } from "./Scene";
4
4
  type LinkDirection = "up" | "right" | "down" | "left";
5
5
  export declare const getLinkDirectionFromKey: (key: string) => LinkDirection;
6
6
  export declare const getPredecessors: (node: ExcalidrawBindableElement, elementsMap: ElementsMap, direction: LinkDirection) => ExcalidrawBindableElement[];
@@ -1,4 +1,4 @@
1
- import type { ElementsMap, ExcalidrawElement, OrderedExcalidrawElement } from "./types";
1
+ import type { ElementsMap, ExcalidrawElement, OrderedExcalidrawElement, SceneElementsMap } from "./types";
2
2
  export declare class InvalidFractionalIndexError extends Error {
3
3
  code: "ELEMENT_HAS_INVALID_INDEX";
4
4
  }
@@ -44,8 +44,14 @@ export declare const orderByFractionalIndex: (elements: OrderedExcalidrawElement
44
44
  */
45
45
  export declare const syncMovedIndices: (elements: readonly ExcalidrawElement[], movedElements: ElementsMap) => OrderedExcalidrawElement[];
46
46
  /**
47
- * Synchronizes all invalid fractional indices with the array order by mutating passed elements.
47
+ * Synchronizes all invalid fractional indices within the array order by mutating elements in the passed array.
48
48
  *
49
49
  * WARN: in edge cases it could modify the elements which were not moved, as it's impossible to guess the actually moved elements from the elements array itself.
50
50
  */
51
51
  export declare const syncInvalidIndices: (elements: readonly ExcalidrawElement[]) => OrderedExcalidrawElement[];
52
+ /**
53
+ * Synchronizes all invalid fractional indices within the array order by creating new instances of elements with corrected indices.
54
+ *
55
+ * WARN: in edge cases it could modify the elements which were not moved, as it's impossible to guess the actually moved elements from the elements array itself.
56
+ */
57
+ export declare const syncInvalidIndicesImmutable: (elements: readonly ExcalidrawElement[]) => SceneElementsMap | undefined;
@@ -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").ExcalidrawRectangleElement | import("./types").ExcalidrawDiamondElement | import("./types").ExcalidrawFrameElement | import("./types").ExcalidrawMagicFrameElement | import("./types").ExcalidrawEmbeddableElement | import("./types").ExcalidrawImageElement | import("./types").ExcalidrawIframeElement | import("./types").ExcalidrawTextElement | 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").ExcalidrawRectangleElement | import("./types").ExcalidrawDiamondElement | import("./types").ExcalidrawFrameElement | import("./types").ExcalidrawMagicFrameElement | import("./types").ExcalidrawEmbeddableElement | import("./types").ExcalidrawImageElement | import("./types").ExcalidrawIframeElement | import("./types").ExcalidrawTextElement | 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[];
@@ -31,3 +31,4 @@ export declare const getNonDeletedGroupIds: (elements: ElementsMap) => Set<strin
31
31
  export declare const elementsAreInSameGroup: (elements: readonly ExcalidrawElement[]) => boolean;
32
32
  export declare const isInGroup: (element: NonDeletedExcalidrawElement) => boolean;
33
33
  export declare const getNewGroupIdsForDuplication: (groupIds: ExcalidrawElement["groupIds"], editingGroupId: AppState["editingGroupId"], mapper: (groupId: GroupId) => GroupId) => string[];
34
+ export declare const getSelectedElementsByGroup: (selectedElements: ExcalidrawElement[], elementsMap: ElementsMap, appState: Readonly<AppState>) => ExcalidrawElement[][];