@excalidraw/element 0.18.0-2a82821 → 0.18.0-2b1c2a9

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 (160) hide show
  1. package/dist/dev/index.js +5570 -3546
  2. package/dist/dev/index.js.map +4 -4
  3. package/dist/prod/index.js +12 -12
  4. package/dist/types/common/src/colors.d.ts +19 -0
  5. package/dist/types/common/src/constants.d.ts +3 -0
  6. package/dist/types/common/src/keys.d.ts +2 -0
  7. package/dist/types/common/src/points.d.ts +1 -1
  8. package/dist/types/common/src/utils.d.ts +1 -43
  9. package/dist/types/element/src/Scene.d.ts +1 -1
  10. package/dist/types/element/src/align.d.ts +2 -2
  11. package/dist/types/element/src/arrowEndpointText.d.ts +49 -0
  12. package/dist/types/element/src/arrows/focus.d.ts +5 -2
  13. package/dist/types/element/src/binding.d.ts +17 -8
  14. package/dist/types/element/src/bounds.d.ts +5 -9
  15. package/dist/types/element/src/bucketFill.d.ts +110 -0
  16. package/dist/types/element/src/collision.d.ts +1 -1
  17. package/dist/types/element/src/comparisons.d.ts +4 -4
  18. package/dist/types/element/src/convertToShape.d.ts +23 -0
  19. package/dist/types/element/src/distribute.d.ts +2 -2
  20. package/dist/types/element/src/dragElements.d.ts +27 -0
  21. package/dist/types/element/src/duplicate.d.ts +3 -3
  22. package/dist/types/element/src/embeddable.d.ts +2 -2
  23. package/dist/types/element/src/flowchart.d.ts +7 -7
  24. package/dist/types/element/src/fractionalIndex.d.ts +2 -2
  25. package/dist/types/element/src/frame.d.ts +4 -4
  26. package/dist/types/element/src/groups.d.ts +9 -9
  27. package/dist/types/element/src/index.d.ts +4 -1
  28. package/dist/types/element/src/linearElementEditor.d.ts +27 -10
  29. package/dist/types/element/src/newElement.d.ts +14 -0
  30. package/dist/types/element/src/renderElement.d.ts +0 -3
  31. package/dist/types/element/src/resizeElements.d.ts +2 -2
  32. package/dist/types/element/src/selection.d.ts +5 -5
  33. package/dist/types/element/src/shape.d.ts +12 -0
  34. package/dist/types/element/src/sortElements.d.ts +10 -0
  35. package/dist/types/element/src/textElement.d.ts +13 -9
  36. package/dist/types/element/src/transform.d.ts +2 -2
  37. package/dist/types/element/src/typeChecks.d.ts +25 -25
  38. package/dist/types/element/src/types.d.ts +9 -1
  39. package/dist/types/element/src/utils.d.ts +7 -3
  40. package/dist/types/element/src/zindex.d.ts +2 -2
  41. package/dist/types/excalidraw/actions/actionAddToLibrary.d.ts +36 -12
  42. package/dist/types/excalidraw/actions/actionAlign.d.ts +6 -6
  43. package/dist/types/excalidraw/actions/actionBoundText.d.ts +24 -8
  44. package/dist/types/excalidraw/actions/actionCanvas.d.ts +146 -931
  45. package/dist/types/excalidraw/actions/actionClipboard.d.ts +24 -8
  46. package/dist/types/excalidraw/actions/actionCropEditor.d.ts +12 -4
  47. package/dist/types/excalidraw/actions/actionDeleteSelected.d.ts +38 -13
  48. package/dist/types/excalidraw/actions/actionDeselect.d.ts +9 -4
  49. package/dist/types/excalidraw/actions/actionDistribute.d.ts +2 -3
  50. package/dist/types/excalidraw/actions/actionElementLink.d.ts +12 -4
  51. package/dist/types/excalidraw/actions/actionElementLock.d.ts +25 -9
  52. package/dist/types/excalidraw/actions/actionExport.d.ts +26 -10
  53. package/dist/types/excalidraw/actions/actionFinalize.d.ts +1 -0
  54. package/dist/types/excalidraw/actions/actionFrame.d.ts +48 -197
  55. package/dist/types/excalidraw/actions/actionGroup.d.ts +39 -23
  56. package/dist/types/excalidraw/actions/actionLinearEditor.d.ts +16 -6
  57. package/dist/types/excalidraw/actions/actionLink.d.ts +13 -5
  58. package/dist/types/excalidraw/actions/actionMenu.d.ts +12 -4
  59. package/dist/types/excalidraw/actions/actionProperties.d.ts +43 -24
  60. package/dist/types/excalidraw/actions/actionSelectAll.d.ts +17 -9
  61. package/dist/types/excalidraw/actions/actionStyles.d.ts +12 -4
  62. package/dist/types/excalidraw/actions/actionTextAutoResize.d.ts +1 -1
  63. package/dist/types/excalidraw/actions/actionToggleArrowBinding.d.ts +13 -5
  64. package/dist/types/excalidraw/actions/actionToggleGridMode.d.ts +16 -9
  65. package/dist/types/excalidraw/actions/actionToggleMidpointSnapping.d.ts +13 -5
  66. package/dist/types/excalidraw/actions/actionToggleObjectsSnapMode.d.ts +13 -5
  67. package/dist/types/excalidraw/actions/actionToggleSearchMenu.d.ts +16 -9
  68. package/dist/types/excalidraw/actions/actionToggleShapeSwitch.d.ts +1 -1
  69. package/dist/types/excalidraw/actions/actionToggleStats.d.ts +13 -5
  70. package/dist/types/excalidraw/actions/actionToggleViewMode.d.ts +14 -6
  71. package/dist/types/excalidraw/actions/actionToggleZenMode.d.ts +13 -5
  72. package/dist/types/excalidraw/actions/index.d.ts +1 -2
  73. package/dist/types/excalidraw/actions/manager.d.ts +1 -0
  74. package/dist/types/excalidraw/actions/shortcuts.d.ts +1 -1
  75. package/dist/types/excalidraw/actions/types.d.ts +8 -4
  76. package/dist/types/excalidraw/appState.d.ts +9 -4
  77. package/dist/types/excalidraw/components/Actions.d.ts +17 -12
  78. package/dist/types/excalidraw/components/App.arrowText.d.ts +104 -0
  79. package/dist/types/excalidraw/components/App.bucketFill.d.ts +48 -0
  80. package/dist/types/excalidraw/components/App.cursor.d.ts +38 -0
  81. package/dist/types/excalidraw/components/App.d.ts +372 -67
  82. package/dist/types/excalidraw/components/App.drawshape.d.ts +55 -0
  83. package/dist/types/excalidraw/components/App.flowchart.d.ts +21 -0
  84. package/dist/types/excalidraw/components/App.viewport.d.ts +73 -0
  85. package/dist/types/excalidraw/components/ColorPicker/ColorPicker.d.ts +9 -3
  86. package/dist/types/excalidraw/components/ColorPicker/CustomColorList.d.ts +3 -1
  87. package/dist/types/excalidraw/components/ColorPicker/Picker.d.ts +3 -1
  88. package/dist/types/excalidraw/components/ColorPicker/PickerColorList.d.ts +9 -2
  89. package/dist/types/excalidraw/components/ColorPicker/ShadeList.d.ts +4 -2
  90. package/dist/types/excalidraw/components/ColorPicker/TopPicks.d.ts +8 -1
  91. package/dist/types/excalidraw/components/ColorPicker/keyboardNavHandlers.d.ts +2 -1
  92. package/dist/types/excalidraw/components/ColorPicker/topPicksDnD.d.ts +31 -0
  93. package/dist/types/excalidraw/components/ConvertElementTypePopup.d.ts +1 -1
  94. package/dist/types/excalidraw/components/CursorHint.d.ts +46 -0
  95. package/dist/types/excalidraw/components/{ToolButton.d.ts → IconButton.d.ts} +16 -19
  96. package/dist/types/excalidraw/components/Island.d.ts +7 -0
  97. package/dist/types/excalidraw/components/LaserPointerButton.d.ts +2 -4
  98. package/dist/types/excalidraw/components/LayerUI.d.ts +5 -2
  99. package/dist/types/excalidraw/components/LockButton.d.ts +3 -4
  100. package/dist/types/excalidraw/components/MagicButton.d.ts +0 -2
  101. package/dist/types/excalidraw/components/MobileMenu.d.ts +4 -4
  102. package/dist/types/excalidraw/components/MobileToolbar.d.ts +9 -0
  103. package/dist/types/excalidraw/components/PenModeButton.d.ts +2 -5
  104. package/dist/types/excalidraw/components/Popover.d.ts +1 -3
  105. package/dist/types/excalidraw/components/{ButtonIcon.d.ts → RadioButton.d.ts} +2 -5
  106. package/dist/types/excalidraw/components/Stats/Angle.d.ts +2 -2
  107. package/dist/types/excalidraw/components/Stats/Dimension.d.ts +2 -2
  108. package/dist/types/excalidraw/components/Stats/DragInput.d.ts +2 -2
  109. package/dist/types/excalidraw/components/Stats/MultiAngle.d.ts +2 -2
  110. package/dist/types/excalidraw/components/Stats/MultiDimension.d.ts +2 -2
  111. package/dist/types/excalidraw/components/Stats/MultiPosition.d.ts +2 -2
  112. package/dist/types/excalidraw/components/Stats/Position.d.ts +3 -3
  113. package/dist/types/excalidraw/components/Stats/utils.d.ts +1 -1
  114. package/dist/types/excalidraw/components/ToolPopover.d.ts +3 -6
  115. package/dist/types/excalidraw/components/Toolbar.d.ts +11 -0
  116. package/dist/types/excalidraw/components/Tools.d.ts +146 -0
  117. package/dist/types/excalidraw/components/UserList.d.ts +3 -2
  118. package/dist/types/excalidraw/components/ViewportStatusFrame/ViewportStatusFrame.d.ts +11 -0
  119. package/dist/types/excalidraw/components/canvases/InteractiveCanvas.d.ts +2 -0
  120. package/dist/types/excalidraw/components/footer/Footer.d.ts +3 -1
  121. package/dist/types/excalidraw/components/hyperlink/helpers.d.ts +2 -2
  122. package/dist/types/excalidraw/components/icons.d.ts +4 -1
  123. package/dist/types/excalidraw/components/main-menu/DefaultItems.d.ts +1 -1
  124. package/dist/types/excalidraw/components/positionElementBesideCursor.d.ts +26 -0
  125. package/dist/types/excalidraw/components/shapeActionPredicates.d.ts +39 -0
  126. package/dist/types/excalidraw/data/blob.d.ts +28 -12
  127. package/dist/types/excalidraw/data/index.d.ts +4 -4
  128. package/dist/types/excalidraw/data/json.d.ts +20 -12
  129. package/dist/types/excalidraw/drawShapeTrail.d.ts +16 -0
  130. package/dist/types/excalidraw/fonts/Fonts.d.ts +3 -2
  131. package/dist/types/excalidraw/hooks/useAppStateValue.d.ts +29 -0
  132. package/dist/types/excalidraw/hooks/useTextEditorFocus.d.ts +5 -5
  133. package/dist/types/excalidraw/lasso/utils.d.ts +2 -0
  134. package/dist/types/excalidraw/renderer/animation.d.ts +1 -0
  135. package/dist/types/excalidraw/renderer/helpers.d.ts +7 -0
  136. package/dist/types/excalidraw/renderer/interactiveScene.d.ts +1 -3
  137. package/dist/types/excalidraw/scene/Renderer.d.ts +12 -11
  138. package/dist/types/excalidraw/scene/export.d.ts +3 -3
  139. package/dist/types/excalidraw/scene/index.d.ts +1 -1
  140. package/dist/types/excalidraw/scene/types.d.ts +4 -3
  141. package/dist/types/excalidraw/snapping.d.ts +7 -7
  142. package/dist/types/excalidraw/types.d.ts +410 -20
  143. package/dist/types/excalidraw/viewport.d.ts +275 -0
  144. package/dist/types/excalidraw/wysiwyg/textWysiwyg.d.ts +2 -3
  145. package/dist/types/laser-pointer/src/state.d.ts +1 -0
  146. package/dist/types/math/src/curve.d.ts +19 -12
  147. package/dist/types/math/src/index.d.ts +1 -0
  148. package/dist/types/math/src/pca.d.ts +79 -0
  149. package/dist/types/math/src/polygon.d.ts +25 -1
  150. package/dist/types/math/src/segment.d.ts +6 -0
  151. package/dist/types/utils/src/export.d.ts +3 -3
  152. package/package.json +4 -4
  153. package/dist/types/excalidraw/actions/actionEmbeddable.d.ts +0 -172
  154. package/dist/types/excalidraw/components/FollowMode/FollowMode.d.ts +0 -10
  155. package/dist/types/excalidraw/components/HandButton.d.ts +0 -10
  156. package/dist/types/excalidraw/components/MobileToolBar.d.ts +0 -10
  157. package/dist/types/excalidraw/components/shapes.d.ts +0 -270
  158. package/dist/types/excalidraw/cursor.d.ts +0 -5
  159. package/dist/types/excalidraw/scene/scroll.d.ts +0 -18
  160. package/dist/types/excalidraw/scene/zoom.d.ts +0 -12
@@ -0,0 +1,275 @@
1
+ import type { SceneBounds } from "@excalidraw/element";
2
+ import type { Bounds } from "@excalidraw/common";
3
+ import type { ExcalidrawElement } from "@excalidraw/element/types";
4
+ import type { AppState, NormalizedZoomValue, Offsets, PointerCoords, ScrollConstraints, ViewportOffsets, Zoom } from "./types";
5
+ /** default rubberband overscroll give for scroll locks, in viewport px */
6
+ export declare const DEFAULT_OVERSCROLL = 150;
7
+ type ZoomOptions = {
8
+ viewportX: number;
9
+ viewportY: number;
10
+ nextZoom: NormalizedZoomValue;
11
+ };
12
+ export type AnimationOptions = {
13
+ duration?: number;
14
+ };
15
+ export type SetViewportRect = {
16
+ x: number;
17
+ y: number;
18
+ width?: number;
19
+ height?: number;
20
+ };
21
+ export type SetViewportOptions = {
22
+ /**
23
+ * what to show in the viewport: an explicit scene-coordinate box/rect,
24
+ * element(s), or an element id / element-link URL.
25
+ *
26
+ * IMPORTANT: if supplying ExcalidrawElement(s), only non-deleted elements
27
+ * that actually exist on the canvas are considered. If you want to navigate
28
+ * to elements that's not on canvas yet, supply their bounds by using
29
+ * `getCommonBounds` (see {@link getCommonBounds}).
30
+ */
31
+ target: Bounds | SetViewportRect | ExcalidrawElement | readonly ExcalidrawElement[] | string;
32
+ /**
33
+ * @see https://developer.mozilla.org/en-US/docs/Web/CSS/Reference/Properties/object-fit
34
+ *
35
+ * - `scale-down` - zoom out so the target fits the viewport, never zooming past 100%
36
+ * - `contain` - zoom the target so it fills the viewport (may exceed 100%)
37
+ * - `none` - keep the current zoom, only center the target in the viewport
38
+ */
39
+ fit?: "scale-down" | "contain" | "none";
40
+ lock?: {
41
+ /** constraints panning to the target box */
42
+ scroll?: ScrollConstraints["lockScroll"];
43
+ /** makes the resolved zoom the minimum zoom */
44
+ zoom?: ScrollConstraints["lockZoom"];
45
+ /**
46
+ * Rubberband give past the lock, in viewport px (zoom-independent): how
47
+ * far the user can pan beyond the constraint before snapping back.
48
+ * `true` (default) uses {@link DEFAULT_OVERSCROLL}, `false` disables
49
+ * (rigid lock), a number sets the give explicitly.
50
+ */
51
+ overscroll?: boolean | number;
52
+ };
53
+ animation?: AnimationOptions | boolean;
54
+ /**
55
+ * CSS-style per-side viewport insets, in viewport pixels
56
+ * (zoom-independent) — static values, editor-UI-derived (`ui`), or a
57
+ * combination. See {@link ViewportOffsets}.
58
+ */
59
+ offsets?: ViewportOffsets;
60
+ };
61
+ type Viewport = Pick<AppState, "scrollX" | "scrollY" | "zoom">;
62
+ /**
63
+ * Clamps a proposed scroll/zoom against the active lock (`scrollConstraints`).
64
+ * Returns the input scroll/zoom unchanged when there is no lock.
65
+ * `overscroll` (screen px, zoom-independent) is rubberband give past the
66
+ * resting clamp — pass 0 for a hard clamp.
67
+ */
68
+ export declare const constrainScrollState: (state: Pick<AppState, "scrollX" | "scrollY" | "zoom" | "width" | "height" | "scrollConstraints">, overscroll?: number) => Viewport;
69
+ /**
70
+ * Resolves a focal-point zoom against the active scroll constraints while
71
+ * preserving the current rubberband displacement in screen pixels. This lets
72
+ * zoom and scroll-constraint snap-back compose without either visually
73
+ * cancelling the other.
74
+ */
75
+ export declare const getViewportForZoomWithScrollConstraints: (opts: ZoomOptions, state: AppState) => Viewport;
76
+ export declare const zoomToFitBounds: ({ bounds, appState, canvasOffsets, fit, minZoom, maxZoom, steppedZoom, }: {
77
+ bounds: SceneBounds;
78
+ canvasOffsets?: Offsets;
79
+ appState: Readonly<AppState>;
80
+ fit?: SetViewportOptions["fit"];
81
+ minZoom?: number;
82
+ maxZoom?: number;
83
+ steppedZoom?: boolean;
84
+ }) => {
85
+ appState: {
86
+ scrollX: number;
87
+ scrollY: number;
88
+ zoom: {
89
+ value: NormalizedZoomValue;
90
+ };
91
+ contextMenu: {
92
+ items: import("./components/ContextMenu").ContextMenuItems;
93
+ top: number;
94
+ left: number;
95
+ } | null;
96
+ showWelcomeScreen: boolean;
97
+ isLoading: boolean;
98
+ errorMessage: React.ReactNode;
99
+ activeEmbeddable: {
100
+ element: import("@excalidraw/element/types").NonDeletedExcalidrawElement;
101
+ state: "hover" | "active";
102
+ } | null;
103
+ newElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawNonSelectionElement> | null;
104
+ resizingElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
105
+ multiElement: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawLinearElement> | null;
106
+ selectionElement: import("@excalidraw/element/types").NonDeletedExcalidrawElement | null;
107
+ isBindingEnabled: boolean;
108
+ boxSelectionMode: import("./types").BoxSelectionMode;
109
+ bindingPreference: "enabled" | "disabled";
110
+ isMidpointSnappingEnabled: boolean;
111
+ suggestedBinding: {
112
+ element: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawBindableElement>;
113
+ midPoint?: import("@excalidraw/math").GlobalPoint;
114
+ } | null;
115
+ hoveredArrowTextAnchor: {
116
+ elementId: import("@excalidraw/element/types").ExcalidrawArrowElement["id"];
117
+ anchor: "start" | "end" | "label";
118
+ } | null;
119
+ frameToHighlight: import("@excalidraw/element/types").NonDeleted<import("@excalidraw/element/types").ExcalidrawFrameLikeElement> | null;
120
+ frameRendering: {
121
+ enabled: boolean;
122
+ name: boolean;
123
+ outline: boolean;
124
+ clip: boolean;
125
+ };
126
+ editingFrame: import("@excalidraw/element/types").ExcalidrawFrameLikeElement["id"] | null;
127
+ elementsToHighlight: readonly import("@excalidraw/element/types").NonDeletedExcalidrawElement[] | null;
128
+ editingTextElement: import("@excalidraw/element/types").ExcalidrawTextElement | null;
129
+ activeTool: {
130
+ lastActiveTool: import("./types").ActiveTool | null;
131
+ locked: boolean;
132
+ fromSelection: boolean;
133
+ } & import("./types").ActiveTool;
134
+ preferredSelectionTool: {
135
+ type: "selection" | "lasso";
136
+ initialized: boolean;
137
+ };
138
+ penMode: boolean;
139
+ penDetected: boolean;
140
+ exportBackground: boolean;
141
+ exportEmbedScene: boolean;
142
+ exportWithDarkMode: boolean;
143
+ exportScale: number;
144
+ currentItemStrokeColor: string;
145
+ currentItemBackgroundColor: string;
146
+ currentItemFillStyle: ExcalidrawElement["fillStyle"];
147
+ currentItemStrokeWidthKey: import("@excalidraw/common").StrokeWidthKey;
148
+ currentItemStrokeStyle: ExcalidrawElement["strokeStyle"];
149
+ currentItemRoughness: number;
150
+ currentItemStrokeVariability: import("@excalidraw/element/types").StrokeVariability;
151
+ currentItemOpacity: number;
152
+ currentItemFontFamily: import("@excalidraw/element/types").FontFamilyValues;
153
+ currentItemFontSize: number;
154
+ currentItemTextAlign: import("@excalidraw/element/types").TextAlign;
155
+ currentItemStartArrowhead: import("@excalidraw/element/types").Arrowhead | null;
156
+ currentItemEndArrowhead: import("@excalidraw/element/types").Arrowhead | null;
157
+ currentHoveredFontFamily: import("@excalidraw/element/types").FontFamilyValues | null;
158
+ currentItemRoundness: import("@excalidraw/element/types").StrokeRoundness;
159
+ currentItemArrowType: "sharp" | "round" | "elbow";
160
+ viewBackgroundColor: string;
161
+ scrollConstraints: ScrollConstraints | null;
162
+ cursorButton: "up" | "down";
163
+ scrolledOutside: boolean;
164
+ name: string | null;
165
+ isResizing: boolean;
166
+ isRotating: boolean;
167
+ openMenu: "canvas" | null;
168
+ openPopup: "canvasBackground" | "elementBackground" | "elementStroke" | "fontFamily" | "compactTextProperties" | "compactStrokeStyles" | "compactOtherProperties" | "compactArrowProperties" | null;
169
+ openSidebar: {
170
+ name: import("./types").SidebarName;
171
+ tab?: import("./types").SidebarTabName;
172
+ } | null;
173
+ openDialog: null | {
174
+ name: "imageExport" | "help" | "jsonExport";
175
+ } | {
176
+ name: "ttd";
177
+ tab: "text-to-diagram" | "mermaid";
178
+ } | {
179
+ name: "commandPalette";
180
+ } | {
181
+ name: "settings";
182
+ } | {
183
+ name: "elementLinkSelector";
184
+ sourceElementId: ExcalidrawElement["id"];
185
+ } | {
186
+ name: "charts";
187
+ data: import("./charts").Spreadsheet;
188
+ rawText: string;
189
+ };
190
+ defaultSidebarDockedPreference: boolean;
191
+ lastPointerDownWith: import("@excalidraw/element/types").PointerType;
192
+ selectedElementIds: Readonly<{
193
+ [id: string]: true;
194
+ }>;
195
+ hoveredElementIds: Readonly<{
196
+ [id: string]: true;
197
+ }>;
198
+ previousSelectedElementIds: {
199
+ [id: string]: true;
200
+ };
201
+ selectedElementsAreBeingDragged: boolean;
202
+ shouldCacheIgnoreZoom: boolean;
203
+ toast: {
204
+ message: React.ReactNode;
205
+ closable?: boolean;
206
+ duration?: number;
207
+ } | null;
208
+ zenModeEnabled: boolean;
209
+ theme: import("@excalidraw/element/types").Theme;
210
+ gridSize: number;
211
+ gridStep: number;
212
+ gridModeEnabled: boolean;
213
+ viewModeEnabled: boolean;
214
+ selectedGroupIds: {
215
+ [groupId: string]: boolean;
216
+ };
217
+ editingGroupId: import("@excalidraw/element/types").GroupId | null;
218
+ width: number;
219
+ height: number;
220
+ offsetTop: number;
221
+ offsetLeft: number;
222
+ fileHandle: FileSystemFileHandle | null;
223
+ collaborators: Map<import("./types").SocketId, import("./types").Collaborator>;
224
+ stats: {
225
+ open: boolean;
226
+ panels: number;
227
+ };
228
+ showHyperlinkPopup: false | "info" | "editor";
229
+ selectedLinearElement: import("@excalidraw/element").LinearElementEditor | null;
230
+ snapLines: readonly import("./snapping").SnapLine[];
231
+ originSnapOffset: {
232
+ x: number;
233
+ y: number;
234
+ } | null;
235
+ objectsSnapModeEnabled: boolean;
236
+ isCropping: boolean;
237
+ croppingElementId: ExcalidrawElement["id"] | null;
238
+ searchMatches: Readonly<{
239
+ focusedId: ExcalidrawElement["id"] | null;
240
+ matches: readonly import("./types").SearchMatch[];
241
+ }> | null;
242
+ activeLockedId: string | null;
243
+ lockedMultiSelections: {
244
+ [groupId: string]: true;
245
+ };
246
+ bindMode: import("@excalidraw/element/types").BindMode;
247
+ colorTopPicks: {
248
+ elementStroke: readonly string[] | null;
249
+ elementBackground: readonly string[] | null;
250
+ bucketFill: readonly string[] | null;
251
+ };
252
+ };
253
+ captureUpdate: "EVENTUALLY";
254
+ };
255
+ export declare const getClosestElementBounds: (elements: readonly ExcalidrawElement[], from: {
256
+ x: number;
257
+ y: number;
258
+ }) => Bounds;
259
+ export declare const centerScrollOn: ({ scenePoint, viewportDimensions, zoom, offsets, }: {
260
+ scenePoint: PointerCoords;
261
+ viewportDimensions: {
262
+ height: number;
263
+ width: number;
264
+ };
265
+ zoom: Zoom;
266
+ offsets?: Offsets;
267
+ }) => {
268
+ scrollX: number;
269
+ scrollY: number;
270
+ };
271
+ export declare const getScrollToContentState: (elements: readonly ExcalidrawElement[], appState: AppState) => {
272
+ scrollX: number;
273
+ scrollY: number;
274
+ };
275
+ export {};
@@ -1,8 +1,7 @@
1
- import type { ExcalidrawElement, ExcalidrawTextElement } from "@excalidraw/element/types";
1
+ import type { ExcalidrawTextElement } from "@excalidraw/element/types";
2
2
  import type App from "../components/App";
3
3
  type SubmitHandler = () => void;
4
- export declare const textWysiwyg: ({ id, onChange, onSubmit, getViewportCoords, element, canvas, excalidrawContainer, app, autoSelect, initialCaretSceneCoords, }: {
5
- id: ExcalidrawElement["id"];
4
+ export declare const textWysiwyg: ({ onChange, onSubmit, getViewportCoords, element, canvas, excalidrawContainer, app, autoSelect, initialCaretSceneCoords, }: {
6
5
  /**
7
6
  * textWysiwyg only deals with `originalText`
8
7
  *
@@ -6,6 +6,7 @@ export type SizeMappingDetails = {
6
6
  totalLength: number;
7
7
  };
8
8
  export type LaserPointerOptions = {
9
+ /** @default 2 */
9
10
  size: number;
10
11
  streamline: number;
11
12
  simplify: number;
@@ -16,20 +16,25 @@ export declare function curveIntersectLineSegment<Point extends GlobalPoint | Lo
16
16
  tolerance?: number;
17
17
  iterLimit?: number;
18
18
  }): Point[];
19
+ /**
20
+ * Finds the parameter on the Bezier curve whose point is closest to another
21
+ * point
22
+ *
23
+ * @param c The curve to test
24
+ * @param p The point to measure from
25
+ * @param tolerance The width of the search window under which the bisection
26
+ * stops refining the parameter
27
+ */
28
+ export declare function curveClosestParameter<Point extends GlobalPoint | LocalPoint>(c: Curve<Point>, p: Point, tolerance?: number): number;
19
29
  /**
20
30
  * Finds the closest point on the Bezier curve from another point
21
31
  *
22
- * @param x
23
- * @param y
24
- * @param P0
25
- * @param P1
26
- * @param P2
27
- * @param P3
28
- * @param tolerance
29
- * @param maxLevel
30
- * @returns
32
+ * @param c The curve to test
33
+ * @param p The point to measure from
34
+ * @param tolerance The width of the search window under which the bisection
35
+ * stops refining the parameter
31
36
  */
32
- export declare function curveClosestPoint<Point extends GlobalPoint | LocalPoint>(c: Curve<Point>, p: Point, tolerance?: number): Point | null;
37
+ export declare function curveClosestPoint<Point extends GlobalPoint | LocalPoint>(c: Curve<Point>, p: Point, tolerance?: number): Point;
33
38
  /**
34
39
  * Determines the distance between a point and the closest point on the
35
40
  * Bezier curve.
@@ -37,7 +42,7 @@ export declare function curveClosestPoint<Point extends GlobalPoint | LocalPoint
37
42
  * @param c The curve to test
38
43
  * @param p The point to measure from
39
44
  */
40
- export declare function curvePointDistance<Point extends GlobalPoint | LocalPoint>(c: Curve<Point>, p: Point): number;
45
+ export declare function curvePointDistance<Point extends GlobalPoint | LocalPoint>(c: Curve<Point>, p: Point, tolerance?: number): number;
41
46
  /**
42
47
  * Determines if the parameter is a Curve
43
48
  */
@@ -74,4 +79,6 @@ export declare function curveLengthAtParameter<P extends GlobalPoint | LocalPoin
74
79
  * @param percent A value between 0 and 1 representing the percentage of the curve's length
75
80
  * @returns The point at the specified percentage of curve length
76
81
  */
77
- export declare function curvePointAtLength<P extends GlobalPoint | LocalPoint>(c: Curve<P>, percent: number): P;
82
+ export declare function curvePointAtLength<P extends GlobalPoint | LocalPoint>(c: Curve<P>, percent: number,
83
+ /** pass the curve's total length when already known to skip recomputing it */
84
+ totalLength?: number): P;
@@ -2,6 +2,7 @@ export * from "./angle";
2
2
  export * from "./curve";
3
3
  export * from "./ellipse";
4
4
  export * from "./line";
5
+ export * from "./pca";
5
6
  export * from "./point";
6
7
  export * from "./polygon";
7
8
  export * from "./range";
@@ -0,0 +1,79 @@
1
+ import type { GlobalPoint, LocalPoint, Vector } from "./types";
2
+ /**
3
+ * The principal axes of a point set, i.e. the eigen decomposition of its
4
+ * 2x2 covariance matrix.
5
+ *
6
+ * The axes are orthonormal and ordered by variance, so `major` is the
7
+ * direction along which the points spread the most. Together with `centroid`
8
+ * they define a canonical frame: expressing the points in it removes
9
+ * translation and rotation, and dividing by `sqrt(majorVariance)` removes
10
+ * scale.
11
+ */
12
+ export type PrincipalAxes<Point extends GlobalPoint | LocalPoint> = {
13
+ centroid: Point;
14
+ /** Unit vector along the direction of largest variance. */
15
+ major: Vector;
16
+ /** Unit vector along the direction of smallest variance, normal to major. */
17
+ minor: Vector;
18
+ /** Variance along `major` (the larger eigenvalue, λ₁). */
19
+ majorVariance: number;
20
+ /** Variance along `minor` (the smaller eigenvalue, λ₂). */
21
+ minorVariance: number;
22
+ };
23
+ /**
24
+ * A point expressed in a principal axes frame: `u` along the major axis,
25
+ * `v` along the minor axis, both relative to the centroid.
26
+ */
27
+ export type PrincipalCoords = [u: number, v: number];
28
+ /**
29
+ * Compute the centroid of a point set.
30
+ */
31
+ export declare function centroid<Point extends GlobalPoint | LocalPoint>(points: readonly Point[]): Point;
32
+ /**
33
+ * Principal component analysis of a 2D point set.
34
+ *
35
+ * Computes the centroid and the eigen decomposition of the covariance matrix
36
+ * [[μ20, μ11], [μ11, μ02]].
37
+ *
38
+ * @param points At least two points; fewer leaves the axes degenerate.
39
+ * @returns The centroid, the orthonormal axes and their variances.
40
+ */
41
+ export declare function principalAxes<Point extends GlobalPoint | LocalPoint>(points: readonly Point[]): PrincipalAxes<Point>;
42
+ /**
43
+ * Express points in the frame of the given principal axes, making the point
44
+ * cloud rotation, scale and translation invariant.
45
+ */
46
+ export declare function principalCoords<Point extends GlobalPoint | LocalPoint>(points: readonly Point[], axes: PrincipalAxes<Point>, scale?: number): PrincipalCoords[];
47
+ /**
48
+ * Flip the major axis so that it points toward the denser end of the point
49
+ * cloud, resolving the 180° sign ambiguity of the eigenvector.
50
+ *
51
+ * @returns The axes with `major`/`minor` flipped if needed. Variances are
52
+ * unchanged, as they are invariant to axis sign.
53
+ */
54
+ export declare function orientPrincipalAxes<Point extends GlobalPoint | LocalPoint>(points: readonly Point[], axes: PrincipalAxes<Point>): PrincipalAxes<Point>;
55
+ /**
56
+ * Ratio of the minor to the major variance in [0, 1]
57
+ *
58
+ * @returns 0 is a perfectly straight stroke, 1 is a stroke with no preferred
59
+ * direction.
60
+ */
61
+ export declare function elongation<Point extends GlobalPoint | LocalPoint>(axes: PrincipalAxes<Point>): number;
62
+ /**
63
+ * The `order`-th standardized moment of a sample in a rotation and scale
64
+ * invariant way (sandardizing by sigma).
65
+ *
66
+ * @returns 0 for a degenerate (zero variance) sample.
67
+ */
68
+ export declare function standardizedMoment(values: readonly number[], order: number): number;
69
+ /**
70
+ * Third standardized moment: how lopsided a sample is.
71
+ *
72
+ */
73
+ export declare function skewness(values: readonly number[]): number;
74
+ /**
75
+ * Fourth standardized moment: how the mass is split between the tails and the
76
+ * middle of a sample. Not excess kurtosis, a normal sample gives 3.
77
+ *
78
+ */
79
+ export declare function kurtosis(values: readonly number[]): number;
@@ -3,4 +3,28 @@ export declare function polygon<Point extends GlobalPoint | LocalPoint>(...point
3
3
  export declare function polygonFromPoints<Point extends GlobalPoint | LocalPoint>(points: Point[]): Polygon<Point>;
4
4
  export declare const polygonIncludesPoint: <Point extends LocalPoint | GlobalPoint>(point: Point, polygon: Polygon<Point>) => boolean;
5
5
  export declare const polygonIncludesPointNonZero: <Point extends [number, number]>(point: Point, polygon: Point[]) => boolean;
6
- export declare const pointOnPolygon: <Point extends LocalPoint | GlobalPoint>(p: Point, poly: Polygon<Point>, threshold?: number) => boolean;
6
+ export declare function polygonIsClosed<Point extends LocalPoint | GlobalPoint>(polygon: readonly Point[], tolerance?: number): boolean;
7
+ /**
8
+ * The signed area of a polygon via the shoelace formula. Positive when the
9
+ * vertices wind counter-clockwise in a y-down coordinate system.
10
+ *
11
+ * The polygon may be given open or closed; a closing vertex
12
+ */
13
+ export declare function polygonSignedArea<Point extends LocalPoint | GlobalPoint>(polygon: readonly Point[], tolerance?: number): number;
14
+ export declare function polygonArea<Point extends LocalPoint | GlobalPoint>(polygon: readonly Point[], tolerance?: number): number;
15
+ /**
16
+ * The convex hull of a point set via Andrew's monotone chain.
17
+ *
18
+ * @returns The hull vertices in counter-clockwise order (y-down), without a
19
+ * repeated closing vertex.
20
+ */
21
+ export declare function convexHull<Point extends LocalPoint | GlobalPoint>(points: readonly Point[]): Point[];
22
+ /**
23
+ * Drop the points of a convex polygon that only contribute a shallow turn,
24
+ * merging each run of near-collinear points into one.
25
+ *
26
+ * @param polygon A convex polygon, as returned by `convexHull`.
27
+ * @param angleThreshold Minimum accumulated turn (radians) for a vertex to be
28
+ * kept.
29
+ */
30
+ export declare function simplifyConvexPolygon<Point extends LocalPoint | GlobalPoint>(polygon: readonly Point[], angleThreshold: number): Point[];
@@ -29,6 +29,11 @@ export declare const lineSegmentRotate: <Point extends LocalPoint | GlobalPoint>
29
29
  export declare const segmentsIntersectAt: <Point extends GlobalPoint | LocalPoint>(a: Readonly<LineSegment<Point>>, b: Readonly<LineSegment<Point>>) => Point | null;
30
30
  export declare const pointOnLineSegment: <Point extends LocalPoint | GlobalPoint>(point: Point, line: LineSegment<Point>, threshold?: number) => boolean;
31
31
  export declare const distanceToLineSegment: <Point extends LocalPoint | GlobalPoint>(point: Point, line: LineSegment<Point>) => number;
32
+ /**
33
+ * Returns the point at parameter `t` along the segment, where `t = 0` is the
34
+ * segment's start and `t = 1` its end. Not clamped.
35
+ */
36
+ export declare function lineSegmentPointAt<Point extends GlobalPoint | LocalPoint>(line: LineSegment<Point>, t: number): Point;
32
37
  /**
33
38
  * Returns the intersection point of a segment and a line
34
39
  *
@@ -38,3 +43,4 @@ export declare const distanceToLineSegment: <Point extends LocalPoint | GlobalPo
38
43
  */
39
44
  export declare function lineSegmentIntersectionPoints<Point extends GlobalPoint | LocalPoint>(l: LineSegment<Point>, s: LineSegment<Point>, threshold?: number): Point | null;
40
45
  export declare function lineSegmentsDistance<Point extends GlobalPoint | LocalPoint>(s1: LineSegment<Point>, s2: LineSegment<Point>): number;
46
+ export declare function lineSegmentClosestParameter<Point extends GlobalPoint | LocalPoint>(point: Point, line: LineSegment<Point>): number;
@@ -1,13 +1,13 @@
1
1
  import { MIME_TYPES } from "@excalidraw/common";
2
- import type { ExcalidrawElement, ExcalidrawFrameLikeElement, NonDeleted } from "@excalidraw/element/types";
2
+ import type { ExcalidrawFrameLikeElement, NonDeleted, NonDeletedExcalidrawElement } from "@excalidraw/element/types";
3
3
  import type { AppState, BinaryFiles } from "@excalidraw/excalidraw/types";
4
4
  export { MIME_TYPES };
5
5
  type ExportOpts = {
6
- elements: readonly NonDeleted<ExcalidrawElement>[];
6
+ elements: readonly NonDeletedExcalidrawElement[];
7
7
  appState?: Partial<Omit<AppState, "offsetTop" | "offsetLeft">>;
8
8
  files: BinaryFiles | null;
9
9
  maxWidthOrHeight?: number;
10
- exportingFrame?: ExcalidrawFrameLikeElement | null;
10
+ exportingFrame?: NonDeleted<ExcalidrawFrameLikeElement> | null;
11
11
  getDimensions?: (width: number, height: number) => {
12
12
  width: number;
13
13
  height: number;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@excalidraw/element",
3
- "version": "0.18.0-2a82821",
3
+ "version": "0.18.0-2b1c2a9",
4
4
  "type": "module",
5
5
  "types": "./dist/types/element/src/index.d.ts",
6
6
  "main": "./dist/prod/index.js",
@@ -63,8 +63,8 @@
63
63
  "build:esm": "rimraf dist && node ../../scripts/buildBase.js && yarn gen:types"
64
64
  },
65
65
  "dependencies": {
66
- "@excalidraw/common": "0.18.0-2a82821",
67
- "@excalidraw/math": "0.18.0-2a82821",
68
- "@excalidraw/fractional-indexing": "0.18.0-2a82821"
66
+ "@excalidraw/common": "0.18.0-2b1c2a9",
67
+ "@excalidraw/math": "0.18.0-2b1c2a9",
68
+ "@excalidraw/fractional-indexing": "0.18.0-2b1c2a9"
69
69
  }
70
70
  }