js-draw 1.21.1 → 1.21.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (187) hide show
  1. package/dist/Editor.css +4 -2
  2. package/dist/bundle.js +2 -2
  3. package/dist/bundledStyles.js +1 -1
  4. package/dist/cjs/toolbar/widgets/InsertImageWidget/ImageWrapper.d.ts +1 -1
  5. package/dist/cjs/tools/BaseTool.d.ts +61 -0
  6. package/dist/cjs/tools/BaseTool.js +179 -0
  7. package/dist/cjs/tools/Eraser.d.ts +60 -0
  8. package/dist/cjs/tools/Eraser.js +299 -0
  9. package/dist/cjs/tools/Eraser.test.d.ts +1 -0
  10. package/dist/cjs/tools/FindTool.d.ts +21 -0
  11. package/dist/cjs/tools/FindTool.js +137 -0
  12. package/dist/cjs/tools/FindTool.test.d.ts +1 -0
  13. package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.d.ts +17 -0
  14. package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.js +105 -0
  15. package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.test.d.ts +1 -0
  16. package/dist/cjs/tools/InputFilter/FunctionMapper.d.ts +12 -0
  17. package/dist/cjs/tools/InputFilter/FunctionMapper.js +21 -0
  18. package/dist/cjs/tools/InputFilter/InputMapper.d.ts +23 -0
  19. package/dist/cjs/tools/InputFilter/InputMapper.js +38 -0
  20. package/dist/cjs/tools/InputFilter/InputPipeline.d.ts +15 -0
  21. package/dist/cjs/tools/InputFilter/InputPipeline.js +54 -0
  22. package/dist/cjs/tools/InputFilter/InputPipeline.test.d.ts +1 -0
  23. package/dist/cjs/tools/InputFilter/InputStabilizer.d.ts +29 -0
  24. package/dist/cjs/tools/InputFilter/InputStabilizer.js +181 -0
  25. package/dist/cjs/tools/InputFilter/StrokeKeyboardControl.d.ts +21 -0
  26. package/dist/cjs/tools/InputFilter/StrokeKeyboardControl.js +84 -0
  27. package/dist/cjs/tools/PanZoom.d.ts +125 -0
  28. package/dist/cjs/tools/PanZoom.js +517 -0
  29. package/dist/cjs/tools/PanZoom.test.d.ts +1 -0
  30. package/dist/cjs/tools/PasteHandler.d.ts +23 -0
  31. package/dist/cjs/tools/PasteHandler.js +109 -0
  32. package/dist/cjs/tools/Pen.d.ts +54 -0
  33. package/dist/cjs/tools/Pen.js +335 -0
  34. package/dist/cjs/tools/Pen.test.d.ts +1 -0
  35. package/dist/cjs/tools/PipetteTool.d.ts +28 -0
  36. package/dist/cjs/tools/PipetteTool.js +69 -0
  37. package/dist/cjs/tools/ScrollbarTool.d.ts +18 -0
  38. package/dist/cjs/tools/ScrollbarTool.js +85 -0
  39. package/dist/cjs/tools/SelectionTool/SelectAllShortcutHandler.d.ts +9 -0
  40. package/dist/cjs/tools/SelectionTool/SelectAllShortcutHandler.js +32 -0
  41. package/dist/cjs/tools/SelectionTool/Selection.d.ts +72 -0
  42. package/dist/cjs/tools/SelectionTool/Selection.js +634 -0
  43. package/dist/cjs/tools/SelectionTool/SelectionHandle.d.ts +62 -0
  44. package/dist/cjs/tools/SelectionTool/SelectionHandle.js +141 -0
  45. package/dist/cjs/tools/SelectionTool/SelectionMenuShortcut.d.ts +32 -0
  46. package/dist/cjs/tools/SelectionTool/SelectionMenuShortcut.js +86 -0
  47. package/dist/cjs/tools/SelectionTool/SelectionTool.d.ts +42 -0
  48. package/dist/cjs/tools/SelectionTool/SelectionTool.js +500 -0
  49. package/dist/cjs/tools/SelectionTool/SelectionTool.selecting.test.d.ts +1 -0
  50. package/dist/cjs/tools/SelectionTool/SelectionTool.test.d.ts +1 -0
  51. package/dist/cjs/tools/SelectionTool/ToPointerAutoscroller.d.ts +23 -0
  52. package/dist/cjs/tools/SelectionTool/ToPointerAutoscroller.js +83 -0
  53. package/dist/cjs/tools/SelectionTool/TransformMode.d.ts +42 -0
  54. package/dist/cjs/tools/SelectionTool/TransformMode.js +155 -0
  55. package/dist/cjs/tools/SelectionTool/keybindings.d.ts +15 -0
  56. package/dist/cjs/tools/SelectionTool/keybindings.js +38 -0
  57. package/dist/cjs/tools/SelectionTool/types.d.ts +35 -0
  58. package/dist/cjs/tools/SelectionTool/types.js +14 -0
  59. package/dist/cjs/tools/SelectionTool/util/makeClipboardErrorHandlers.d.ts +6 -0
  60. package/dist/cjs/tools/SelectionTool/util/makeClipboardErrorHandlers.js +50 -0
  61. package/dist/cjs/tools/SelectionTool/util/showSelectionContextMenu.d.ts +5 -0
  62. package/dist/cjs/tools/SelectionTool/util/showSelectionContextMenu.js +43 -0
  63. package/dist/cjs/tools/SoundUITool.d.ts +26 -0
  64. package/dist/cjs/tools/SoundUITool.js +171 -0
  65. package/dist/cjs/tools/TextTool.d.ts +36 -0
  66. package/dist/cjs/tools/TextTool.js +285 -0
  67. package/dist/cjs/tools/TextTool.test.d.ts +1 -0
  68. package/dist/cjs/tools/ToolController.d.ts +73 -0
  69. package/dist/cjs/tools/ToolController.js +304 -0
  70. package/dist/cjs/tools/ToolController.test.d.ts +1 -0
  71. package/dist/cjs/tools/ToolEnabledGroup.d.ts +6 -0
  72. package/dist/cjs/tools/ToolEnabledGroup.js +13 -0
  73. package/dist/cjs/tools/ToolSwitcherShortcut.d.ts +16 -0
  74. package/dist/cjs/tools/ToolSwitcherShortcut.js +40 -0
  75. package/dist/cjs/tools/ToolbarShortcutHandler.d.ts +12 -0
  76. package/dist/cjs/tools/ToolbarShortcutHandler.js +34 -0
  77. package/dist/cjs/tools/UndoRedoShortcut.d.ts +8 -0
  78. package/dist/cjs/tools/UndoRedoShortcut.js +27 -0
  79. package/dist/cjs/tools/UndoRedoShortcut.test.d.ts +1 -0
  80. package/dist/cjs/tools/keybindings.d.ts +16 -0
  81. package/dist/cjs/tools/keybindings.js +58 -0
  82. package/dist/cjs/tools/lib.d.ts +14 -0
  83. package/dist/cjs/tools/lib.js +36 -0
  84. package/dist/cjs/tools/localization.d.ts +43 -0
  85. package/dist/cjs/tools/localization.js +45 -0
  86. package/dist/cjs/tools/util/StationaryPenDetector.d.ts +25 -0
  87. package/dist/cjs/tools/util/StationaryPenDetector.js +107 -0
  88. package/dist/cjs/tools/util/createMenuOverlay.d.ts +10 -0
  89. package/dist/cjs/tools/util/createMenuOverlay.js +126 -0
  90. package/dist/cjs/tools/util/createMenuOverlay.test.d.ts +1 -0
  91. package/dist/cjs/version.js +1 -1
  92. package/dist/mjs/toolbar/widgets/InsertImageWidget/ImageWrapper.d.ts +1 -1
  93. package/dist/mjs/tools/BaseTool.d.ts +61 -0
  94. package/dist/mjs/tools/BaseTool.mjs +177 -0
  95. package/dist/mjs/tools/Eraser.d.ts +60 -0
  96. package/dist/mjs/tools/Eraser.mjs +292 -0
  97. package/dist/mjs/tools/Eraser.test.d.ts +1 -0
  98. package/dist/mjs/tools/FindTool.d.ts +21 -0
  99. package/dist/mjs/tools/FindTool.mjs +131 -0
  100. package/dist/mjs/tools/FindTool.test.d.ts +1 -0
  101. package/dist/mjs/tools/InputFilter/ContextMenuRecognizer.d.ts +17 -0
  102. package/dist/mjs/tools/InputFilter/ContextMenuRecognizer.mjs +76 -0
  103. package/dist/mjs/tools/InputFilter/ContextMenuRecognizer.test.d.ts +1 -0
  104. package/dist/mjs/tools/InputFilter/FunctionMapper.d.ts +12 -0
  105. package/dist/mjs/tools/InputFilter/FunctionMapper.mjs +15 -0
  106. package/dist/mjs/tools/InputFilter/InputMapper.d.ts +23 -0
  107. package/dist/mjs/tools/InputFilter/InputMapper.mjs +36 -0
  108. package/dist/mjs/tools/InputFilter/InputPipeline.d.ts +15 -0
  109. package/dist/mjs/tools/InputFilter/InputPipeline.mjs +49 -0
  110. package/dist/mjs/tools/InputFilter/InputPipeline.test.d.ts +1 -0
  111. package/dist/mjs/tools/InputFilter/InputStabilizer.d.ts +29 -0
  112. package/dist/mjs/tools/InputFilter/InputStabilizer.mjs +175 -0
  113. package/dist/mjs/tools/InputFilter/StrokeKeyboardControl.d.ts +21 -0
  114. package/dist/mjs/tools/InputFilter/StrokeKeyboardControl.mjs +78 -0
  115. package/dist/mjs/tools/PanZoom.d.ts +125 -0
  116. package/dist/mjs/tools/PanZoom.mjs +510 -0
  117. package/dist/mjs/tools/PanZoom.test.d.ts +1 -0
  118. package/dist/mjs/tools/PasteHandler.d.ts +23 -0
  119. package/dist/mjs/tools/PasteHandler.mjs +103 -0
  120. package/dist/mjs/tools/Pen.d.ts +54 -0
  121. package/dist/mjs/tools/Pen.mjs +306 -0
  122. package/dist/mjs/tools/Pen.test.d.ts +1 -0
  123. package/dist/mjs/tools/PipetteTool.d.ts +28 -0
  124. package/dist/mjs/tools/PipetteTool.mjs +63 -0
  125. package/dist/mjs/tools/ScrollbarTool.d.ts +18 -0
  126. package/dist/mjs/tools/ScrollbarTool.mjs +79 -0
  127. package/dist/mjs/tools/SelectionTool/SelectAllShortcutHandler.d.ts +9 -0
  128. package/dist/mjs/tools/SelectionTool/SelectAllShortcutHandler.mjs +26 -0
  129. package/dist/mjs/tools/SelectionTool/Selection.d.ts +72 -0
  130. package/dist/mjs/tools/SelectionTool/Selection.mjs +606 -0
  131. package/dist/mjs/tools/SelectionTool/SelectionHandle.d.ts +62 -0
  132. package/dist/mjs/tools/SelectionTool/SelectionHandle.mjs +137 -0
  133. package/dist/mjs/tools/SelectionTool/SelectionMenuShortcut.d.ts +32 -0
  134. package/dist/mjs/tools/SelectionTool/SelectionMenuShortcut.mjs +83 -0
  135. package/dist/mjs/tools/SelectionTool/SelectionTool.d.ts +42 -0
  136. package/dist/mjs/tools/SelectionTool/SelectionTool.mjs +493 -0
  137. package/dist/mjs/tools/SelectionTool/SelectionTool.selecting.test.d.ts +1 -0
  138. package/dist/mjs/tools/SelectionTool/SelectionTool.test.d.ts +1 -0
  139. package/dist/mjs/tools/SelectionTool/ToPointerAutoscroller.d.ts +23 -0
  140. package/dist/mjs/tools/SelectionTool/ToPointerAutoscroller.mjs +77 -0
  141. package/dist/mjs/tools/SelectionTool/TransformMode.d.ts +42 -0
  142. package/dist/mjs/tools/SelectionTool/TransformMode.mjs +146 -0
  143. package/dist/mjs/tools/SelectionTool/keybindings.d.ts +15 -0
  144. package/dist/mjs/tools/SelectionTool/keybindings.mjs +32 -0
  145. package/dist/mjs/tools/SelectionTool/types.d.ts +35 -0
  146. package/dist/mjs/tools/SelectionTool/types.mjs +11 -0
  147. package/dist/mjs/tools/SelectionTool/util/makeClipboardErrorHandlers.d.ts +6 -0
  148. package/dist/mjs/tools/SelectionTool/util/makeClipboardErrorHandlers.mjs +45 -0
  149. package/dist/mjs/tools/SelectionTool/util/showSelectionContextMenu.d.ts +5 -0
  150. package/dist/mjs/tools/SelectionTool/util/showSelectionContextMenu.mjs +38 -0
  151. package/dist/mjs/tools/SoundUITool.d.ts +26 -0
  152. package/dist/mjs/tools/SoundUITool.mjs +165 -0
  153. package/dist/mjs/tools/TextTool.d.ts +36 -0
  154. package/dist/mjs/tools/TextTool.mjs +279 -0
  155. package/dist/mjs/tools/TextTool.test.d.ts +1 -0
  156. package/dist/mjs/tools/ToolController.d.ts +73 -0
  157. package/dist/mjs/tools/ToolController.mjs +275 -0
  158. package/dist/mjs/tools/ToolController.test.d.ts +1 -0
  159. package/dist/mjs/tools/ToolEnabledGroup.d.ts +6 -0
  160. package/dist/mjs/tools/ToolEnabledGroup.mjs +10 -0
  161. package/dist/mjs/tools/ToolSwitcherShortcut.d.ts +16 -0
  162. package/dist/mjs/tools/ToolSwitcherShortcut.mjs +34 -0
  163. package/dist/mjs/tools/ToolbarShortcutHandler.d.ts +12 -0
  164. package/dist/mjs/tools/ToolbarShortcutHandler.mjs +28 -0
  165. package/dist/mjs/tools/UndoRedoShortcut.d.ts +8 -0
  166. package/dist/mjs/tools/UndoRedoShortcut.mjs +21 -0
  167. package/dist/mjs/tools/UndoRedoShortcut.test.d.ts +1 -0
  168. package/dist/mjs/tools/keybindings.d.ts +16 -0
  169. package/dist/mjs/tools/keybindings.mjs +38 -0
  170. package/dist/mjs/tools/lib.d.ts +14 -0
  171. package/dist/mjs/tools/lib.mjs +14 -0
  172. package/dist/mjs/tools/localization.d.ts +43 -0
  173. package/dist/mjs/tools/localization.mjs +42 -0
  174. package/dist/mjs/tools/util/StationaryPenDetector.d.ts +25 -0
  175. package/dist/mjs/tools/util/StationaryPenDetector.mjs +103 -0
  176. package/dist/mjs/tools/util/createMenuOverlay.d.ts +10 -0
  177. package/dist/mjs/tools/util/createMenuOverlay.mjs +121 -0
  178. package/dist/mjs/tools/util/createMenuOverlay.test.d.ts +1 -0
  179. package/dist/mjs/version.mjs +1 -1
  180. package/package.json +4 -4
  181. package/src/tools/FindTool.css +7 -0
  182. package/src/tools/ScrollbarTool.scss +57 -0
  183. package/src/tools/SelectionTool/SelectionTool.scss +165 -0
  184. package/src/tools/SelectionTool/util/makeClipboardErrorHandlers.scss +15 -0
  185. package/src/tools/SoundUITool.scss +22 -0
  186. package/src/tools/tools.scss +6 -0
  187. package/src/tools/util/createMenuOverlay.scss +67 -0
@@ -0,0 +1,131 @@
1
+ // Displays a find dialog that allows the user to search for and focus text.
2
+ //
3
+ // @packageDocumentation
4
+ import TextComponent from '../components/TextComponent.mjs';
5
+ import ImageComponent from '../components/ImageComponent.mjs';
6
+ import BaseTool from './BaseTool.mjs';
7
+ import { toggleFindVisibleShortcutId } from './keybindings.mjs';
8
+ const cssPrefix = 'find-tool';
9
+ export default class FindTool extends BaseTool {
10
+ constructor(editor) {
11
+ super(editor.notifier, editor.localization.findLabel);
12
+ this.editor = editor;
13
+ this.currentMatchIdx = 0;
14
+ this.overlay = document.createElement('div');
15
+ this.fillOverlay();
16
+ editor.createHTMLOverlay(this.overlay);
17
+ this.overlay.style.display = 'none';
18
+ this.overlay.classList.add(`${cssPrefix}-overlay`);
19
+ }
20
+ canReceiveInputInReadOnlyEditor() {
21
+ return true;
22
+ }
23
+ getMatches(searchFor) {
24
+ const lowerSearchFor = searchFor.toLocaleLowerCase();
25
+ const matchingComponents = this.editor.image.getAllElements().filter(component => {
26
+ let text = '';
27
+ if (component instanceof TextComponent) {
28
+ text = component.getText();
29
+ }
30
+ else if (component instanceof ImageComponent) {
31
+ text = component.getAltText() ?? '';
32
+ }
33
+ else {
34
+ return false;
35
+ }
36
+ const hasLowercaseMatch = text.toLocaleLowerCase().indexOf(lowerSearchFor) !== -1;
37
+ const hasSameCaseMatch = text.indexOf(searchFor) !== -1;
38
+ return hasLowercaseMatch || hasSameCaseMatch;
39
+ });
40
+ return matchingComponents.map(match => match.getBBox());
41
+ }
42
+ focusCurrentMatch() {
43
+ const matches = this.getMatches(this.searchInput.value);
44
+ let matchIdx = this.currentMatchIdx % matches.length;
45
+ if (matchIdx < 0) {
46
+ matchIdx = matches.length + matchIdx;
47
+ }
48
+ if (matchIdx < matches.length) {
49
+ const undoable = false;
50
+ void this.editor.dispatch(this.editor.viewport.zoomTo(matches[matchIdx], true, true), undoable);
51
+ this.editor.announceForAccessibility(this.editor.localization.focusedFoundText(matchIdx + 1, matches.length));
52
+ }
53
+ }
54
+ toNextMatch() {
55
+ this.currentMatchIdx++;
56
+ this.focusCurrentMatch();
57
+ }
58
+ toPrevMatch() {
59
+ this.currentMatchIdx--;
60
+ this.focusCurrentMatch();
61
+ }
62
+ fillOverlay() {
63
+ const label = document.createElement('label');
64
+ this.searchInput = document.createElement('input');
65
+ const nextBtn = document.createElement('button');
66
+ const closeBtn = document.createElement('button');
67
+ // Math.random() ensures that the ID is unique (to allow us to refer to it
68
+ // with an htmlFor).
69
+ this.searchInput.setAttribute('id', `${cssPrefix}-searchInput-${Math.random()}`);
70
+ label.htmlFor = this.searchInput.getAttribute('id');
71
+ label.innerText = this.editor.localization.findLabel;
72
+ nextBtn.innerText = this.editor.localization.toNextMatch;
73
+ closeBtn.innerText = this.editor.localization.closeDialog;
74
+ this.searchInput.onkeydown = (ev) => {
75
+ if (ev.key === 'Enter') {
76
+ if (ev.shiftKey) {
77
+ this.toPrevMatch();
78
+ }
79
+ else {
80
+ this.toNextMatch();
81
+ }
82
+ }
83
+ else if (ev.key === 'Escape') {
84
+ this.setVisible(false);
85
+ }
86
+ else if (this.editor.shortcuts.matchesShortcut(toggleFindVisibleShortcutId, ev)) {
87
+ ev.preventDefault();
88
+ this.toggleVisible();
89
+ }
90
+ };
91
+ nextBtn.onclick = () => {
92
+ this.toNextMatch();
93
+ };
94
+ closeBtn.onclick = () => {
95
+ this.setVisible(false);
96
+ };
97
+ this.overlay.replaceChildren(label, this.searchInput, nextBtn, closeBtn);
98
+ }
99
+ isVisible() {
100
+ return this.overlay.style.display !== 'none';
101
+ }
102
+ setVisible(visible) {
103
+ if (visible !== this.isVisible()) {
104
+ this.overlay.style.display = visible ? 'block' : 'none';
105
+ if (visible) {
106
+ this.searchInput.focus();
107
+ this.editor.announceForAccessibility(this.editor.localization.findDialogShown);
108
+ }
109
+ else {
110
+ this.editor.focus();
111
+ this.editor.announceForAccessibility(this.editor.localization.findDialogHidden);
112
+ }
113
+ }
114
+ }
115
+ toggleVisible() {
116
+ this.setVisible(!this.isVisible());
117
+ }
118
+ onKeyPress(event) {
119
+ if (this.editor.shortcuts.matchesShortcut(toggleFindVisibleShortcutId, event)) {
120
+ this.toggleVisible();
121
+ return true;
122
+ }
123
+ return false;
124
+ }
125
+ setEnabled(enabled) {
126
+ super.setEnabled(enabled);
127
+ if (this.isEnabled()) {
128
+ this.setVisible(false);
129
+ }
130
+ }
131
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,17 @@
1
+ import { InputEvt } from '../../inputEvents';
2
+ import InputMapper from './InputMapper';
3
+ export default class ContextMenuRecognizer extends InputMapper {
4
+ private canShowContextMenu;
5
+ private contextMenuTriggerPointer;
6
+ private contextMenuStartPoint;
7
+ private stationaryDetector;
8
+ private clickTolerance;
9
+ constructor();
10
+ /**
11
+ * In general, only certain events (i.e. touchscreens) are expected to be able to
12
+ * create long-press menus. This method checks whether `event` was generated by
13
+ * one such device.
14
+ */
15
+ private canMakeLongPressMenuEvent;
16
+ onEvent(event: InputEvt): boolean;
17
+ }
@@ -0,0 +1,76 @@
1
+ import { InputEvtType, isPointerEvt } from '../../inputEvents.mjs';
2
+ import InputMapper from './InputMapper.mjs';
3
+ import StationaryPenDetector, { defaultStationaryDetectionConfig } from '../util/StationaryPenDetector.mjs';
4
+ import { PointerDevice } from '../../Pointer.mjs';
5
+ export default class ContextMenuRecognizer extends InputMapper {
6
+ constructor() {
7
+ super();
8
+ this.canShowContextMenu = false;
9
+ this.stationaryDetector = null;
10
+ this.clickTolerance = 12;
11
+ }
12
+ /**
13
+ * In general, only certain events (i.e. touchscreens) are expected to be able to
14
+ * create long-press menus. This method checks whether `event` was generated by
15
+ * one such device.
16
+ */
17
+ canMakeLongPressMenuEvent(event) {
18
+ const allowedDevices = [
19
+ PointerDevice.Touch,
20
+ ];
21
+ return event.allPointers.length === 1 && allowedDevices.includes(event.current.device);
22
+ }
23
+ onEvent(event) {
24
+ const sendContextMenuEvent = () => {
25
+ if (!isPointerEvt(event))
26
+ return false;
27
+ if (this.canShowContextMenu) {
28
+ const eventHandled = this.emit({
29
+ kind: InputEvtType.ContextMenu,
30
+ screenPos: event.current.screenPos,
31
+ canvasPos: event.current.canvasPos,
32
+ });
33
+ if (eventHandled) {
34
+ this.emit({
35
+ kind: InputEvtType.GestureCancelEvt,
36
+ });
37
+ return true;
38
+ }
39
+ }
40
+ return false;
41
+ };
42
+ if (event.kind === InputEvtType.PointerDownEvt) {
43
+ if (event.allPointers.length === 1) {
44
+ this.canShowContextMenu = true;
45
+ this.contextMenuTriggerPointer = event.current;
46
+ this.contextMenuStartPoint = event.current.screenPos;
47
+ if (this.canMakeLongPressMenuEvent(event)) {
48
+ this.stationaryDetector = new StationaryPenDetector(event.current, defaultStationaryDetectionConfig, sendContextMenuEvent);
49
+ }
50
+ }
51
+ else {
52
+ this.canShowContextMenu = false;
53
+ }
54
+ }
55
+ else if (event.kind === InputEvtType.PointerMoveEvt) {
56
+ if (this.canShowContextMenu) {
57
+ this.stationaryDetector?.onPointerMove(event.current);
58
+ // Only clicks/stationary long presses can create context menu events.
59
+ const deltaPosition = event.current.screenPos.minus(this.contextMenuStartPoint);
60
+ const threshold = this.clickTolerance;
61
+ if (deltaPosition.length() > threshold) {
62
+ this.canShowContextMenu = false;
63
+ }
64
+ }
65
+ }
66
+ else if (event.kind === InputEvtType.PointerUpEvt) {
67
+ this.stationaryDetector?.destroy();
68
+ if (this.contextMenuTriggerPointer?.id === event.current.id &&
69
+ this.contextMenuTriggerPointer.device === PointerDevice.RightButtonMouse &&
70
+ sendContextMenuEvent()) {
71
+ return true;
72
+ }
73
+ }
74
+ return this.emit(event);
75
+ }
76
+ }
@@ -0,0 +1,12 @@
1
+ import { InputEvt } from '../../inputEvents';
2
+ import InputMapper from './InputMapper';
3
+ /**
4
+ * An `InputMapper` that applies a function to all events it receives.
5
+ *
6
+ * Useful for automated testing.
7
+ */
8
+ export default class FunctionMapper extends InputMapper {
9
+ private fn;
10
+ constructor(fn: (event: InputEvt) => InputEvt);
11
+ onEvent(event: InputEvt): boolean;
12
+ }
@@ -0,0 +1,15 @@
1
+ import InputMapper from './InputMapper.mjs';
2
+ /**
3
+ * An `InputMapper` that applies a function to all events it receives.
4
+ *
5
+ * Useful for automated testing.
6
+ */
7
+ export default class FunctionMapper extends InputMapper {
8
+ constructor(fn) {
9
+ super();
10
+ this.fn = fn;
11
+ }
12
+ onEvent(event) {
13
+ return this.emit(this.fn(event));
14
+ }
15
+ }
@@ -0,0 +1,23 @@
1
+ import { InputEvt } from '../../inputEvents';
2
+ type OnEventCallback = (event: InputEvt) => boolean;
3
+ export interface InputEventListener {
4
+ onEvent: OnEventCallback;
5
+ }
6
+ /**
7
+ * Accepts input events and emits input events.
8
+ */
9
+ export default abstract class InputMapper implements InputEventListener {
10
+ #private;
11
+ constructor();
12
+ setEmitListener(listener: InputEventListener | OnEventCallback | null): void;
13
+ protected emit(event: InputEvt): boolean;
14
+ /**
15
+ * @returns true if the given `event` should be considered "handled" by the app and thus not
16
+ * forwarded to other targets. For example, returning "true" for a touchpad pinch event prevents
17
+ * the pinch event from zooming the webpage.
18
+ *
19
+ * Generally, this should return the result of calling `this.emit` with some event.
20
+ */
21
+ abstract onEvent(event: InputEvt): boolean;
22
+ }
23
+ export {};
@@ -0,0 +1,36 @@
1
+ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
2
+ if (kind === "m") throw new TypeError("Private method is not writable");
3
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
4
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
5
+ return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
6
+ };
7
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
8
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
9
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
10
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
11
+ };
12
+ var _InputMapper_listener;
13
+ /**
14
+ * Accepts input events and emits input events.
15
+ */
16
+ class InputMapper {
17
+ constructor() {
18
+ _InputMapper_listener.set(this, null);
19
+ }
20
+ // @internal
21
+ setEmitListener(listener) {
22
+ if (listener && typeof (listener) === 'object') {
23
+ __classPrivateFieldSet(this, _InputMapper_listener, (event) => {
24
+ return listener.onEvent(event) ?? false;
25
+ }, "f");
26
+ }
27
+ else {
28
+ __classPrivateFieldSet(this, _InputMapper_listener, listener, "f");
29
+ }
30
+ }
31
+ emit(event) {
32
+ return __classPrivateFieldGet(this, _InputMapper_listener, "f")?.call(this, event) ?? false;
33
+ }
34
+ }
35
+ _InputMapper_listener = new WeakMap();
36
+ export default InputMapper;
@@ -0,0 +1,15 @@
1
+ import { InputEvt } from '../../inputEvents';
2
+ import InputMapper from './InputMapper';
3
+ /**
4
+ * The composition of multiple `InputMapper`s.
5
+ */
6
+ export default class InputPipeline extends InputMapper {
7
+ #private;
8
+ onEvent(event: InputEvt): boolean;
9
+ /**
10
+ * Adds a new `InputMapper` to the *tail* of this pipeline.
11
+ * Note that an instance of an `InputMapper` can only be used in a single
12
+ * pipeline.
13
+ */
14
+ addToTail(mapper: InputMapper): void;
15
+ }
@@ -0,0 +1,49 @@
1
+ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
2
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
3
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
4
+ return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
5
+ };
6
+ var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
7
+ if (kind === "m") throw new TypeError("Private method is not writable");
8
+ if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
9
+ if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
10
+ return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
11
+ };
12
+ var _InputPipeline_head, _InputPipeline_tail;
13
+ import InputMapper from './InputMapper.mjs';
14
+ /**
15
+ * The composition of multiple `InputMapper`s.
16
+ */
17
+ class InputPipeline extends InputMapper {
18
+ constructor() {
19
+ super(...arguments);
20
+ _InputPipeline_head.set(this, null);
21
+ _InputPipeline_tail.set(this, null);
22
+ }
23
+ onEvent(event) {
24
+ if (__classPrivateFieldGet(this, _InputPipeline_head, "f") === null) {
25
+ return this.emit(event);
26
+ }
27
+ else {
28
+ return __classPrivateFieldGet(this, _InputPipeline_head, "f").onEvent(event);
29
+ }
30
+ }
31
+ /**
32
+ * Adds a new `InputMapper` to the *tail* of this pipeline.
33
+ * Note that an instance of an `InputMapper` can only be used in a single
34
+ * pipeline.
35
+ */
36
+ addToTail(mapper) {
37
+ if (!__classPrivateFieldGet(this, _InputPipeline_tail, "f")) {
38
+ __classPrivateFieldSet(this, _InputPipeline_head, mapper, "f");
39
+ __classPrivateFieldSet(this, _InputPipeline_tail, __classPrivateFieldGet(this, _InputPipeline_head, "f"), "f");
40
+ }
41
+ else {
42
+ __classPrivateFieldGet(this, _InputPipeline_tail, "f").setEmitListener(mapper);
43
+ __classPrivateFieldSet(this, _InputPipeline_tail, mapper, "f");
44
+ }
45
+ __classPrivateFieldGet(this, _InputPipeline_tail, "f").setEmitListener(event => this.emit(event));
46
+ }
47
+ }
48
+ _InputPipeline_head = new WeakMap(), _InputPipeline_tail = new WeakMap();
49
+ export default InputPipeline;
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,29 @@
1
+ import { InputEvt } from '../../inputEvents';
2
+ import InputMapper from './InputMapper';
3
+ import Viewport from '../../Viewport';
4
+ import Editor from '../../Editor';
5
+ declare enum StabilizerType {
6
+ IntertialStabilizer = 0
7
+ }
8
+ interface InputStabilizerOptions {
9
+ kind: StabilizerType.IntertialStabilizer;
10
+ mass: number;
11
+ springConstant: number;
12
+ frictionCoefficient: number;
13
+ maxPointDist: number;
14
+ minSimilarityToFinalize: number;
15
+ inertiaFraction: number;
16
+ velocityDecayFactor: number;
17
+ }
18
+ export default class InputStabilizer extends InputMapper {
19
+ private viewport;
20
+ private readonly options;
21
+ private stabilizer;
22
+ private lastPointerEvent;
23
+ constructor(viewport: Viewport, options?: InputStabilizerOptions);
24
+ private mapPointerEvent;
25
+ private emitPointerMove;
26
+ onEvent(event: InputEvt): boolean;
27
+ static fromEditor(editor: Editor): InputStabilizer;
28
+ }
29
+ export {};
@@ -0,0 +1,175 @@
1
+ import { InputEvtType, isPointerEvt } from '../../inputEvents.mjs';
2
+ import InputMapper from './InputMapper.mjs';
3
+ import { Vec2 } from '@js-draw/math';
4
+ import untilNextAnimationFrame from '../../util/untilNextAnimationFrame.mjs';
5
+ var StabilizerType;
6
+ (function (StabilizerType) {
7
+ StabilizerType[StabilizerType["IntertialStabilizer"] = 0] = "IntertialStabilizer";
8
+ })(StabilizerType || (StabilizerType = {}));
9
+ const defaultOptions = {
10
+ kind: StabilizerType.IntertialStabilizer,
11
+ mass: 0.4, // kg
12
+ springConstant: 100.0, // N/m
13
+ frictionCoefficient: 0.28,
14
+ maxPointDist: 10, // screen units
15
+ inertiaFraction: 0.75,
16
+ minSimilarityToFinalize: 0.0,
17
+ velocityDecayFactor: 0.1,
18
+ };
19
+ // Stabilizes input for a single cursor
20
+ class StylusInputStabilizer {
21
+ constructor(
22
+ // The initial starting point of the pointer.
23
+ start,
24
+ // Emits a pointer motion event, returns true if the event was handled.
25
+ updatePointer, options) {
26
+ this.updatePointer = updatePointer;
27
+ this.options = options;
28
+ this.runLoop = true;
29
+ this.lastUpdateTime = 0;
30
+ this.velocity = Vec2.zero;
31
+ this.strokePoint = start;
32
+ this.targetPoint = start;
33
+ this.targetInterval = 10; // ms
34
+ void this.loop();
35
+ }
36
+ async loop() {
37
+ this.lastUpdateTime = performance.now();
38
+ while (this.runLoop) {
39
+ this.update(false);
40
+ await untilNextAnimationFrame();
41
+ }
42
+ }
43
+ setTarget(point) {
44
+ this.targetPoint = point;
45
+ }
46
+ getNextVelocity(deltaTimeMs) {
47
+ const toTarget = this.targetPoint.minus(this.strokePoint);
48
+ const springForce = toTarget.times(this.options.springConstant);
49
+ const gravityAccel = 10;
50
+ const normalForceMagnitude = this.options.mass * gravityAccel;
51
+ const frictionForce = this.velocity.normalizedOrZero().times(-this.options.frictionCoefficient * normalForceMagnitude);
52
+ const acceleration = (springForce.plus(frictionForce)).times(1 / this.options.mass);
53
+ const decayFactor = this.options.velocityDecayFactor;
54
+ const springVelocity = this.velocity.times(1 - decayFactor).plus(acceleration.times(deltaTimeMs / 1000));
55
+ // An alternate velocity that goes directly towards the target.
56
+ const toTargetVelocity = toTarget.normalizedOrZero().times(springVelocity.length());
57
+ return toTargetVelocity.lerp(springVelocity, this.options.inertiaFraction);
58
+ }
59
+ update(force) {
60
+ const nowTime = performance.now();
61
+ const deltaTime = nowTime - this.lastUpdateTime;
62
+ const reachedTarget = this.strokePoint.eq(this.targetPoint);
63
+ if (deltaTime > this.targetInterval || force) {
64
+ if (!reachedTarget) {
65
+ let velocity;
66
+ let deltaX;
67
+ let parts = 1;
68
+ do {
69
+ velocity = this.getNextVelocity(deltaTime / parts);
70
+ deltaX = velocity.times(deltaTime / 1000);
71
+ parts++;
72
+ } while (deltaX.magnitude() > this.options.maxPointDist && parts < 10);
73
+ for (let i = 0; i < parts; i++) {
74
+ this.velocity = this.getNextVelocity(deltaTime / parts);
75
+ deltaX = this.velocity.times(deltaTime / 1000);
76
+ this.strokePoint = this.strokePoint.plus(deltaX);
77
+ // Allows the last updatePointer to be returned.
78
+ if (i < parts - 1) {
79
+ this.updatePointer(this.strokePoint, nowTime);
80
+ }
81
+ }
82
+ }
83
+ // Even if we have reached the target, ensure that lastUpdateTime is updated
84
+ // (prevent large deltaTime).
85
+ this.lastUpdateTime = nowTime;
86
+ if (force || !reachedTarget) {
87
+ return this.updatePointer(this.strokePoint, nowTime);
88
+ }
89
+ }
90
+ return false;
91
+ }
92
+ /** Finalizes the current stroke. */
93
+ finish() {
94
+ this.runLoop = false;
95
+ const toTarget = this.targetPoint.minus(this.strokePoint);
96
+ if (this.velocity.dot(toTarget) > this.options.minSimilarityToFinalize) {
97
+ // Connect the stroke to its end point
98
+ this.updatePointer(this.targetPoint, performance.now());
99
+ }
100
+ }
101
+ cancel() {
102
+ this.runLoop = false;
103
+ }
104
+ }
105
+ export default class InputStabilizer extends InputMapper {
106
+ constructor(viewport, options = defaultOptions) {
107
+ super();
108
+ this.viewport = viewport;
109
+ this.options = options;
110
+ this.stabilizer = null;
111
+ this.lastPointerEvent = null;
112
+ }
113
+ mapPointerEvent(event) {
114
+ // Don't store the last pointer event for use with pressure/button data --
115
+ // this information can be very different for a pointerup event.
116
+ if (isPointerEvt(event) && event.kind !== InputEvtType.PointerUpEvt) {
117
+ this.lastPointerEvent = event;
118
+ }
119
+ // Only apply smoothing if there is a single pointer.
120
+ if (event.kind === InputEvtType.GestureCancelEvt || event.allPointers.length > 1 || this.stabilizer === null) {
121
+ return this.emit(event);
122
+ }
123
+ this.stabilizer.setTarget(event.current.screenPos);
124
+ if (event.kind === InputEvtType.PointerMoveEvt) {
125
+ return this.stabilizer.update(true);
126
+ }
127
+ else if (event.kind === InputEvtType.PointerUpEvt) {
128
+ this.stabilizer.finish();
129
+ return this.emit(event);
130
+ }
131
+ else {
132
+ return this.emit(event);
133
+ }
134
+ }
135
+ // Assumes that there is exactly one pointer that is currently down.
136
+ emitPointerMove(screenPoint, timeStamp) {
137
+ if (!this.lastPointerEvent) {
138
+ return false;
139
+ }
140
+ const pointer = this.lastPointerEvent.current
141
+ .withScreenPosition(screenPoint, this.viewport)
142
+ .withTimestamp(timeStamp);
143
+ const event = {
144
+ kind: InputEvtType.PointerMoveEvt,
145
+ current: pointer,
146
+ allPointers: [pointer],
147
+ };
148
+ const handled = this.emit(event);
149
+ return handled;
150
+ }
151
+ onEvent(event) {
152
+ if (isPointerEvt(event) || event.kind === InputEvtType.GestureCancelEvt) {
153
+ if (event.kind === InputEvtType.PointerDownEvt) {
154
+ if (this.stabilizer === null) {
155
+ this.stabilizer = new StylusInputStabilizer(event.current.screenPos, (screenPoint, timeStamp) => this.emitPointerMove(screenPoint, timeStamp), this.options);
156
+ }
157
+ else if (event.allPointers.length > 1) {
158
+ // Do not attempt to stabilize multiple pointers.
159
+ this.stabilizer.cancel();
160
+ this.stabilizer = null;
161
+ }
162
+ }
163
+ const handled = this.mapPointerEvent(event);
164
+ if (event.kind === InputEvtType.PointerUpEvt || event.kind === InputEvtType.GestureCancelEvt) {
165
+ this.stabilizer?.cancel();
166
+ this.stabilizer = null;
167
+ }
168
+ return handled;
169
+ }
170
+ return this.emit(event);
171
+ }
172
+ static fromEditor(editor) {
173
+ return new InputStabilizer(editor.viewport);
174
+ }
175
+ }
@@ -0,0 +1,21 @@
1
+ import { InputEvt } from '../../inputEvents';
2
+ import InputMapper from './InputMapper';
3
+ import KeyboardShortcutManager from '../../shortcuts/KeyboardShortcutManager';
4
+ import Viewport from '../../Viewport';
5
+ import Editor from '../../Editor';
6
+ /**
7
+ * Provides keyboard shortcuts that provide some amount of control over
8
+ * drawing (e.g. snap to grid, plane lock).
9
+ */
10
+ export default class StrokeKeyboardControl extends InputMapper {
11
+ private shortcuts;
12
+ private viewport;
13
+ private snapToGridEnabled;
14
+ private angleLockEnabled;
15
+ private startPointCanvas;
16
+ constructor(shortcuts: KeyboardShortcutManager, viewport: Viewport);
17
+ private xyAxesSnap;
18
+ private mapPointerEvent;
19
+ onEvent(event: InputEvt): boolean;
20
+ static fromEditor(editor: Editor): StrokeKeyboardControl;
21
+ }