js-draw 1.21.2 → 1.21.3

Sign up to get free protection for your applications and to get access to all the features.
Files changed (183) hide show
  1. package/dist/bundle.js +1 -1
  2. package/dist/cjs/tools/BaseTool.d.ts +61 -0
  3. package/dist/cjs/tools/BaseTool.js +179 -0
  4. package/dist/cjs/tools/Eraser.d.ts +60 -0
  5. package/dist/cjs/tools/Eraser.js +299 -0
  6. package/dist/cjs/tools/Eraser.test.d.ts +1 -0
  7. package/dist/cjs/tools/FindTool.d.ts +21 -0
  8. package/dist/cjs/tools/FindTool.js +137 -0
  9. package/dist/cjs/tools/FindTool.test.d.ts +1 -0
  10. package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.d.ts +17 -0
  11. package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.js +105 -0
  12. package/dist/cjs/tools/InputFilter/ContextMenuRecognizer.test.d.ts +1 -0
  13. package/dist/cjs/tools/InputFilter/FunctionMapper.d.ts +12 -0
  14. package/dist/cjs/tools/InputFilter/FunctionMapper.js +21 -0
  15. package/dist/cjs/tools/InputFilter/InputMapper.d.ts +23 -0
  16. package/dist/cjs/tools/InputFilter/InputMapper.js +38 -0
  17. package/dist/cjs/tools/InputFilter/InputPipeline.d.ts +15 -0
  18. package/dist/cjs/tools/InputFilter/InputPipeline.js +54 -0
  19. package/dist/cjs/tools/InputFilter/InputPipeline.test.d.ts +1 -0
  20. package/dist/cjs/tools/InputFilter/InputStabilizer.d.ts +29 -0
  21. package/dist/cjs/tools/InputFilter/InputStabilizer.js +181 -0
  22. package/dist/cjs/tools/InputFilter/StrokeKeyboardControl.d.ts +21 -0
  23. package/dist/cjs/tools/InputFilter/StrokeKeyboardControl.js +84 -0
  24. package/dist/cjs/tools/PanZoom.d.ts +125 -0
  25. package/dist/cjs/tools/PanZoom.js +517 -0
  26. package/dist/cjs/tools/PanZoom.test.d.ts +1 -0
  27. package/dist/cjs/tools/PasteHandler.d.ts +23 -0
  28. package/dist/cjs/tools/PasteHandler.js +109 -0
  29. package/dist/cjs/tools/Pen.d.ts +54 -0
  30. package/dist/cjs/tools/Pen.js +335 -0
  31. package/dist/cjs/tools/Pen.test.d.ts +1 -0
  32. package/dist/cjs/tools/PipetteTool.d.ts +28 -0
  33. package/dist/cjs/tools/PipetteTool.js +69 -0
  34. package/dist/cjs/tools/ScrollbarTool.d.ts +18 -0
  35. package/dist/cjs/tools/ScrollbarTool.js +85 -0
  36. package/dist/cjs/tools/SelectionTool/SelectAllShortcutHandler.d.ts +9 -0
  37. package/dist/cjs/tools/SelectionTool/SelectAllShortcutHandler.js +32 -0
  38. package/dist/cjs/tools/SelectionTool/Selection.d.ts +72 -0
  39. package/dist/cjs/tools/SelectionTool/Selection.js +634 -0
  40. package/dist/cjs/tools/SelectionTool/SelectionHandle.d.ts +62 -0
  41. package/dist/cjs/tools/SelectionTool/SelectionHandle.js +141 -0
  42. package/dist/cjs/tools/SelectionTool/SelectionMenuShortcut.d.ts +32 -0
  43. package/dist/cjs/tools/SelectionTool/SelectionMenuShortcut.js +86 -0
  44. package/dist/cjs/tools/SelectionTool/SelectionTool.d.ts +42 -0
  45. package/dist/cjs/tools/SelectionTool/SelectionTool.js +500 -0
  46. package/dist/cjs/tools/SelectionTool/SelectionTool.selecting.test.d.ts +1 -0
  47. package/dist/cjs/tools/SelectionTool/SelectionTool.test.d.ts +1 -0
  48. package/dist/cjs/tools/SelectionTool/ToPointerAutoscroller.d.ts +23 -0
  49. package/dist/cjs/tools/SelectionTool/ToPointerAutoscroller.js +83 -0
  50. package/dist/cjs/tools/SelectionTool/TransformMode.d.ts +42 -0
  51. package/dist/cjs/tools/SelectionTool/TransformMode.js +155 -0
  52. package/dist/cjs/tools/SelectionTool/keybindings.d.ts +15 -0
  53. package/dist/cjs/tools/SelectionTool/keybindings.js +38 -0
  54. package/dist/cjs/tools/SelectionTool/types.d.ts +35 -0
  55. package/dist/cjs/tools/SelectionTool/types.js +14 -0
  56. package/dist/cjs/tools/SelectionTool/util/makeClipboardErrorHandlers.d.ts +6 -0
  57. package/dist/cjs/tools/SelectionTool/util/makeClipboardErrorHandlers.js +50 -0
  58. package/dist/cjs/tools/SelectionTool/util/showSelectionContextMenu.d.ts +5 -0
  59. package/dist/cjs/tools/SelectionTool/util/showSelectionContextMenu.js +43 -0
  60. package/dist/cjs/tools/SoundUITool.d.ts +26 -0
  61. package/dist/cjs/tools/SoundUITool.js +171 -0
  62. package/dist/cjs/tools/TextTool.d.ts +36 -0
  63. package/dist/cjs/tools/TextTool.js +285 -0
  64. package/dist/cjs/tools/TextTool.test.d.ts +1 -0
  65. package/dist/cjs/tools/ToolController.d.ts +73 -0
  66. package/dist/cjs/tools/ToolController.js +304 -0
  67. package/dist/cjs/tools/ToolController.test.d.ts +1 -0
  68. package/dist/cjs/tools/ToolEnabledGroup.d.ts +6 -0
  69. package/dist/cjs/tools/ToolEnabledGroup.js +13 -0
  70. package/dist/cjs/tools/ToolSwitcherShortcut.d.ts +16 -0
  71. package/dist/cjs/tools/ToolSwitcherShortcut.js +40 -0
  72. package/dist/cjs/tools/ToolbarShortcutHandler.d.ts +12 -0
  73. package/dist/cjs/tools/ToolbarShortcutHandler.js +34 -0
  74. package/dist/cjs/tools/UndoRedoShortcut.d.ts +8 -0
  75. package/dist/cjs/tools/UndoRedoShortcut.js +27 -0
  76. package/dist/cjs/tools/UndoRedoShortcut.test.d.ts +1 -0
  77. package/dist/cjs/tools/keybindings.d.ts +16 -0
  78. package/dist/cjs/tools/keybindings.js +58 -0
  79. package/dist/cjs/tools/lib.d.ts +14 -0
  80. package/dist/cjs/tools/lib.js +36 -0
  81. package/dist/cjs/tools/localization.d.ts +43 -0
  82. package/dist/cjs/tools/localization.js +45 -0
  83. package/dist/cjs/tools/util/StationaryPenDetector.d.ts +25 -0
  84. package/dist/cjs/tools/util/StationaryPenDetector.js +107 -0
  85. package/dist/cjs/tools/util/createMenuOverlay.d.ts +10 -0
  86. package/dist/cjs/tools/util/createMenuOverlay.js +126 -0
  87. package/dist/cjs/tools/util/createMenuOverlay.test.d.ts +1 -0
  88. package/dist/cjs/version.js +1 -1
  89. package/dist/mjs/tools/BaseTool.d.ts +61 -0
  90. package/dist/mjs/tools/BaseTool.mjs +177 -0
  91. package/dist/mjs/tools/Eraser.d.ts +60 -0
  92. package/dist/mjs/tools/Eraser.mjs +292 -0
  93. package/dist/mjs/tools/Eraser.test.d.ts +1 -0
  94. package/dist/mjs/tools/FindTool.d.ts +21 -0
  95. package/dist/mjs/tools/FindTool.mjs +131 -0
  96. package/dist/mjs/tools/FindTool.test.d.ts +1 -0
  97. package/dist/mjs/tools/InputFilter/ContextMenuRecognizer.d.ts +17 -0
  98. package/dist/mjs/tools/InputFilter/ContextMenuRecognizer.mjs +76 -0
  99. package/dist/mjs/tools/InputFilter/ContextMenuRecognizer.test.d.ts +1 -0
  100. package/dist/mjs/tools/InputFilter/FunctionMapper.d.ts +12 -0
  101. package/dist/mjs/tools/InputFilter/FunctionMapper.mjs +15 -0
  102. package/dist/mjs/tools/InputFilter/InputMapper.d.ts +23 -0
  103. package/dist/mjs/tools/InputFilter/InputMapper.mjs +36 -0
  104. package/dist/mjs/tools/InputFilter/InputPipeline.d.ts +15 -0
  105. package/dist/mjs/tools/InputFilter/InputPipeline.mjs +49 -0
  106. package/dist/mjs/tools/InputFilter/InputPipeline.test.d.ts +1 -0
  107. package/dist/mjs/tools/InputFilter/InputStabilizer.d.ts +29 -0
  108. package/dist/mjs/tools/InputFilter/InputStabilizer.mjs +175 -0
  109. package/dist/mjs/tools/InputFilter/StrokeKeyboardControl.d.ts +21 -0
  110. package/dist/mjs/tools/InputFilter/StrokeKeyboardControl.mjs +78 -0
  111. package/dist/mjs/tools/PanZoom.d.ts +125 -0
  112. package/dist/mjs/tools/PanZoom.mjs +510 -0
  113. package/dist/mjs/tools/PanZoom.test.d.ts +1 -0
  114. package/dist/mjs/tools/PasteHandler.d.ts +23 -0
  115. package/dist/mjs/tools/PasteHandler.mjs +103 -0
  116. package/dist/mjs/tools/Pen.d.ts +54 -0
  117. package/dist/mjs/tools/Pen.mjs +306 -0
  118. package/dist/mjs/tools/Pen.test.d.ts +1 -0
  119. package/dist/mjs/tools/PipetteTool.d.ts +28 -0
  120. package/dist/mjs/tools/PipetteTool.mjs +63 -0
  121. package/dist/mjs/tools/ScrollbarTool.d.ts +18 -0
  122. package/dist/mjs/tools/ScrollbarTool.mjs +79 -0
  123. package/dist/mjs/tools/SelectionTool/SelectAllShortcutHandler.d.ts +9 -0
  124. package/dist/mjs/tools/SelectionTool/SelectAllShortcutHandler.mjs +26 -0
  125. package/dist/mjs/tools/SelectionTool/Selection.d.ts +72 -0
  126. package/dist/mjs/tools/SelectionTool/Selection.mjs +606 -0
  127. package/dist/mjs/tools/SelectionTool/SelectionHandle.d.ts +62 -0
  128. package/dist/mjs/tools/SelectionTool/SelectionHandle.mjs +137 -0
  129. package/dist/mjs/tools/SelectionTool/SelectionMenuShortcut.d.ts +32 -0
  130. package/dist/mjs/tools/SelectionTool/SelectionMenuShortcut.mjs +83 -0
  131. package/dist/mjs/tools/SelectionTool/SelectionTool.d.ts +42 -0
  132. package/dist/mjs/tools/SelectionTool/SelectionTool.mjs +493 -0
  133. package/dist/mjs/tools/SelectionTool/SelectionTool.selecting.test.d.ts +1 -0
  134. package/dist/mjs/tools/SelectionTool/SelectionTool.test.d.ts +1 -0
  135. package/dist/mjs/tools/SelectionTool/ToPointerAutoscroller.d.ts +23 -0
  136. package/dist/mjs/tools/SelectionTool/ToPointerAutoscroller.mjs +77 -0
  137. package/dist/mjs/tools/SelectionTool/TransformMode.d.ts +42 -0
  138. package/dist/mjs/tools/SelectionTool/TransformMode.mjs +146 -0
  139. package/dist/mjs/tools/SelectionTool/keybindings.d.ts +15 -0
  140. package/dist/mjs/tools/SelectionTool/keybindings.mjs +32 -0
  141. package/dist/mjs/tools/SelectionTool/types.d.ts +35 -0
  142. package/dist/mjs/tools/SelectionTool/types.mjs +11 -0
  143. package/dist/mjs/tools/SelectionTool/util/makeClipboardErrorHandlers.d.ts +6 -0
  144. package/dist/mjs/tools/SelectionTool/util/makeClipboardErrorHandlers.mjs +45 -0
  145. package/dist/mjs/tools/SelectionTool/util/showSelectionContextMenu.d.ts +5 -0
  146. package/dist/mjs/tools/SelectionTool/util/showSelectionContextMenu.mjs +38 -0
  147. package/dist/mjs/tools/SoundUITool.d.ts +26 -0
  148. package/dist/mjs/tools/SoundUITool.mjs +165 -0
  149. package/dist/mjs/tools/TextTool.d.ts +36 -0
  150. package/dist/mjs/tools/TextTool.mjs +279 -0
  151. package/dist/mjs/tools/TextTool.test.d.ts +1 -0
  152. package/dist/mjs/tools/ToolController.d.ts +73 -0
  153. package/dist/mjs/tools/ToolController.mjs +275 -0
  154. package/dist/mjs/tools/ToolController.test.d.ts +1 -0
  155. package/dist/mjs/tools/ToolEnabledGroup.d.ts +6 -0
  156. package/dist/mjs/tools/ToolEnabledGroup.mjs +10 -0
  157. package/dist/mjs/tools/ToolSwitcherShortcut.d.ts +16 -0
  158. package/dist/mjs/tools/ToolSwitcherShortcut.mjs +34 -0
  159. package/dist/mjs/tools/ToolbarShortcutHandler.d.ts +12 -0
  160. package/dist/mjs/tools/ToolbarShortcutHandler.mjs +28 -0
  161. package/dist/mjs/tools/UndoRedoShortcut.d.ts +8 -0
  162. package/dist/mjs/tools/UndoRedoShortcut.mjs +21 -0
  163. package/dist/mjs/tools/UndoRedoShortcut.test.d.ts +1 -0
  164. package/dist/mjs/tools/keybindings.d.ts +16 -0
  165. package/dist/mjs/tools/keybindings.mjs +38 -0
  166. package/dist/mjs/tools/lib.d.ts +14 -0
  167. package/dist/mjs/tools/lib.mjs +14 -0
  168. package/dist/mjs/tools/localization.d.ts +43 -0
  169. package/dist/mjs/tools/localization.mjs +42 -0
  170. package/dist/mjs/tools/util/StationaryPenDetector.d.ts +25 -0
  171. package/dist/mjs/tools/util/StationaryPenDetector.mjs +103 -0
  172. package/dist/mjs/tools/util/createMenuOverlay.d.ts +10 -0
  173. package/dist/mjs/tools/util/createMenuOverlay.mjs +121 -0
  174. package/dist/mjs/tools/util/createMenuOverlay.test.d.ts +1 -0
  175. package/dist/mjs/version.mjs +1 -1
  176. package/package.json +4 -4
  177. package/src/tools/FindTool.css +7 -0
  178. package/src/tools/ScrollbarTool.scss +57 -0
  179. package/src/tools/SelectionTool/SelectionTool.scss +165 -0
  180. package/src/tools/SelectionTool/util/makeClipboardErrorHandlers.scss +15 -0
  181. package/src/tools/SoundUITool.scss +22 -0
  182. package/src/tools/tools.scss +6 -0
  183. package/src/tools/util/createMenuOverlay.scss +67 -0
@@ -0,0 +1,61 @@
1
+ import { EditorNotifier } from '../types';
2
+ import { WheelEvt, PointerEvt, KeyPressEvent, KeyUpEvent, PasteEvent, CopyEvent, InputEvt, GestureCancelEvt, PointerDownEvt, PointerMoveEvt, PointerUpEvt, ContextMenuEvt } from '../inputEvents';
3
+ import ToolEnabledGroup from './ToolEnabledGroup';
4
+ import InputMapper, { InputEventListener } from './InputFilter/InputMapper';
5
+ import { ReactiveValue } from '../util/ReactiveValue';
6
+ export default abstract class BaseTool implements InputEventListener {
7
+ #private;
8
+ private notifier;
9
+ readonly description: string;
10
+ protected constructor(notifier: EditorNotifier, description: string);
11
+ /** Override this to allow this tool to be enabled in a read-only editor */
12
+ canReceiveInputInReadOnlyEditor(): boolean;
13
+ setInputMapper(mapper: InputMapper | null): void;
14
+ getInputMapper(): InputMapper | null;
15
+ private dispatchEventToCallback;
16
+ onEvent(event: InputEvt): boolean;
17
+ /**
18
+ * Returns true iff the tool handled the event and thus should receive additional
19
+ * events.
20
+ */
21
+ onPointerDown(_event: PointerDownEvt): boolean;
22
+ onPointerMove(_event: PointerMoveEvt): void;
23
+ /**
24
+ * Returns true iff there are additional pointers down and the tool should
25
+ * remain active to handle the additional events.
26
+ *
27
+ * For most purposes, this should return `false` or nothing.
28
+ */
29
+ onPointerUp(_event: PointerUpEvt): boolean | void;
30
+ onGestureCancel(_event: GestureCancelEvt): void;
31
+ onWheel(_event: WheelEvt): boolean;
32
+ onCopy(_event: CopyEvent): boolean;
33
+ onPaste(_event: PasteEvent): boolean;
34
+ onKeyPress(_event: KeyPressEvent): boolean;
35
+ onKeyUp(_event: KeyUpEvent): boolean;
36
+ onContextMenu(_event: ContextMenuEvt): boolean;
37
+ /**
38
+ * Return true if, while this tool is active, `_event` can be delivered to
39
+ * another tool that is higher priority than this.
40
+ * @internal May be renamed
41
+ */
42
+ eventCanBeDeliveredToNonActiveTool(_event: PointerEvt): boolean;
43
+ setEnabled(enabled: boolean): void;
44
+ isEnabled(): boolean;
45
+ /**
46
+ * Returns a {@link ReactiveValue} that updates based on whether this tool is
47
+ * enabled.
48
+ *
49
+ * @example
50
+ * ```ts
51
+ * const tool = new SomeTool();
52
+ *
53
+ * // Watch for changes in enabled status
54
+ * tool.enabledValue().onUpdate(enabled => doSomething(enabled));
55
+ * ```
56
+ */
57
+ enabledValue(): ReactiveValue<boolean>;
58
+ setToolGroup(group: ToolEnabledGroup): void;
59
+ getToolGroup(): ToolEnabledGroup | null;
60
+ onDestroy(): void;
61
+ }
@@ -0,0 +1,177 @@
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 _BaseTool_enabled, _BaseTool_group, _BaseTool_inputMapper, _BaseTool_readOnlyEditorChangeListener;
13
+ import { EditorEventType } from '../types.mjs';
14
+ import { InputEvtType } from '../inputEvents.mjs';
15
+ import { ReactiveValue } from '../util/ReactiveValue.mjs';
16
+ class BaseTool {
17
+ constructor(notifier, description) {
18
+ this.notifier = notifier;
19
+ this.description = description;
20
+ _BaseTool_enabled.set(this, void 0);
21
+ _BaseTool_group.set(this, null);
22
+ _BaseTool_inputMapper.set(this, null);
23
+ _BaseTool_readOnlyEditorChangeListener.set(this, null);
24
+ __classPrivateFieldSet(this, _BaseTool_enabled, ReactiveValue.fromInitialValue(true), "f");
25
+ __classPrivateFieldGet(this, _BaseTool_enabled, "f").onUpdate(enabled => {
26
+ // Ensure that at most one tool in the group is enabled.
27
+ if (enabled) {
28
+ __classPrivateFieldGet(this, _BaseTool_group, "f")?.notifyEnabled(this);
29
+ this.notifier.dispatch(EditorEventType.ToolEnabled, {
30
+ kind: EditorEventType.ToolEnabled,
31
+ tool: this,
32
+ });
33
+ }
34
+ else {
35
+ this.notifier.dispatch(EditorEventType.ToolDisabled, {
36
+ kind: EditorEventType.ToolDisabled,
37
+ tool: this,
38
+ });
39
+ }
40
+ });
41
+ }
42
+ /** Override this to allow this tool to be enabled in a read-only editor */
43
+ canReceiveInputInReadOnlyEditor() {
44
+ return false;
45
+ }
46
+ setInputMapper(mapper) {
47
+ __classPrivateFieldSet(this, _BaseTool_inputMapper, mapper, "f");
48
+ if (mapper) {
49
+ mapper.setEmitListener(event => this.dispatchEventToCallback(event));
50
+ }
51
+ }
52
+ getInputMapper() {
53
+ return __classPrivateFieldGet(this, _BaseTool_inputMapper, "f");
54
+ }
55
+ dispatchEventToCallback(event) {
56
+ let exhaustivenessCheck;
57
+ switch (event.kind) {
58
+ case InputEvtType.PointerDownEvt:
59
+ return this.onPointerDown(event);
60
+ case InputEvtType.PointerMoveEvt:
61
+ this.onPointerMove(event);
62
+ break;
63
+ case InputEvtType.PointerUpEvt:
64
+ return this.onPointerUp(event) ?? false;
65
+ case InputEvtType.GestureCancelEvt:
66
+ this.onGestureCancel(event);
67
+ break;
68
+ case InputEvtType.WheelEvt:
69
+ return this.onWheel(event);
70
+ case InputEvtType.KeyPressEvent:
71
+ return this.onKeyPress(event);
72
+ case InputEvtType.KeyUpEvent:
73
+ return this.onKeyUp(event);
74
+ case InputEvtType.CopyEvent:
75
+ return this.onCopy(event);
76
+ case InputEvtType.PasteEvent:
77
+ return this.onPaste(event);
78
+ case InputEvtType.ContextMenu:
79
+ return this.onContextMenu(event);
80
+ default:
81
+ exhaustivenessCheck = event;
82
+ return exhaustivenessCheck;
83
+ }
84
+ return true;
85
+ }
86
+ // @internal
87
+ onEvent(event) {
88
+ if (__classPrivateFieldGet(this, _BaseTool_inputMapper, "f")) {
89
+ return __classPrivateFieldGet(this, _BaseTool_inputMapper, "f").onEvent(event);
90
+ }
91
+ return this.dispatchEventToCallback(event);
92
+ }
93
+ /**
94
+ * Returns true iff the tool handled the event and thus should receive additional
95
+ * events.
96
+ */
97
+ onPointerDown(_event) { return false; }
98
+ onPointerMove(_event) { }
99
+ /**
100
+ * Returns true iff there are additional pointers down and the tool should
101
+ * remain active to handle the additional events.
102
+ *
103
+ * For most purposes, this should return `false` or nothing.
104
+ */
105
+ onPointerUp(_event) { }
106
+ onGestureCancel(_event) { }
107
+ onWheel(_event) {
108
+ return false;
109
+ }
110
+ onCopy(_event) {
111
+ return false;
112
+ }
113
+ onPaste(_event) {
114
+ return false;
115
+ }
116
+ onKeyPress(_event) {
117
+ return false;
118
+ }
119
+ onKeyUp(_event) {
120
+ return false;
121
+ }
122
+ onContextMenu(_event) {
123
+ return false;
124
+ }
125
+ /**
126
+ * Return true if, while this tool is active, `_event` can be delivered to
127
+ * another tool that is higher priority than this.
128
+ * @internal May be renamed
129
+ */
130
+ eventCanBeDeliveredToNonActiveTool(_event) {
131
+ return true;
132
+ }
133
+ setEnabled(enabled) {
134
+ __classPrivateFieldGet(this, _BaseTool_enabled, "f").set(enabled);
135
+ }
136
+ isEnabled() {
137
+ return __classPrivateFieldGet(this, _BaseTool_enabled, "f").get();
138
+ }
139
+ /**
140
+ * Returns a {@link ReactiveValue} that updates based on whether this tool is
141
+ * enabled.
142
+ *
143
+ * @example
144
+ * ```ts
145
+ * const tool = new SomeTool();
146
+ *
147
+ * // Watch for changes in enabled status
148
+ * tool.enabledValue().onUpdate(enabled => doSomething(enabled));
149
+ * ```
150
+ */
151
+ enabledValue() {
152
+ return __classPrivateFieldGet(this, _BaseTool_enabled, "f");
153
+ }
154
+ // Connect this tool to a set of other tools, ensuring that at most one
155
+ // of the tools in the group is enabled.
156
+ setToolGroup(group) {
157
+ if (this.isEnabled()) {
158
+ group.notifyEnabled(this);
159
+ }
160
+ __classPrivateFieldSet(this, _BaseTool_group, group, "f");
161
+ }
162
+ getToolGroup() {
163
+ if (__classPrivateFieldGet(this, _BaseTool_group, "f")) {
164
+ return __classPrivateFieldGet(this, _BaseTool_group, "f");
165
+ }
166
+ return null;
167
+ }
168
+ // Called when the tool is removed/when the editor is destroyed.
169
+ // Subclasses that override this method **must call super.onDestroy()**.
170
+ onDestroy() {
171
+ __classPrivateFieldGet(this, _BaseTool_readOnlyEditorChangeListener, "f")?.remove();
172
+ __classPrivateFieldSet(this, _BaseTool_readOnlyEditorChangeListener, null, "f");
173
+ __classPrivateFieldSet(this, _BaseTool_group, null, "f");
174
+ }
175
+ }
176
+ _BaseTool_enabled = new WeakMap(), _BaseTool_group = new WeakMap(), _BaseTool_inputMapper = new WeakMap(), _BaseTool_readOnlyEditorChangeListener = new WeakMap();
177
+ export default BaseTool;
@@ -0,0 +1,60 @@
1
+ import { GestureCancelEvt, KeyPressEvent, PointerEvt } from '../inputEvents';
2
+ import BaseTool from './BaseTool';
3
+ import Editor from '../Editor';
4
+ import { MutableReactiveValue } from '../util/ReactiveValue';
5
+ export declare enum EraserMode {
6
+ PartialStroke = "partial-stroke",
7
+ FullStroke = "full-stroke"
8
+ }
9
+ export interface InitialEraserOptions {
10
+ thickness?: number;
11
+ mode?: EraserMode;
12
+ }
13
+ /**
14
+ * A tool that allows a user to erase parts of an image.
15
+ */
16
+ export default class Eraser extends BaseTool {
17
+ private editor;
18
+ private lastPoint;
19
+ private isFirstEraseEvt;
20
+ private thickness;
21
+ private thicknessValue;
22
+ private modeValue;
23
+ private toRemove;
24
+ private toAdd;
25
+ private eraseCommands;
26
+ private addCommands;
27
+ constructor(editor: Editor, description: string, options?: InitialEraserOptions);
28
+ /**
29
+ * @returns a tool that briefly enables the eraser when a physical eraser is used.
30
+ * This tool should be added to the tool list after the primary tools.
31
+ */
32
+ makeEraserSwitcherTool(): BaseTool;
33
+ private clearPreview;
34
+ private getSizeOnCanvas;
35
+ private drawPreviewAt;
36
+ /**
37
+ * @returns the eraser rectangle in canvas coordinates.
38
+ *
39
+ * For now, all erasers are rectangles or points.
40
+ */
41
+ private getEraserRect;
42
+ /** Erases in a line from the last point to the current. */
43
+ private eraseTo;
44
+ onPointerDown(event: PointerEvt): boolean;
45
+ onPointerMove(event: PointerEvt): void;
46
+ onPointerUp(event: PointerEvt): void;
47
+ onGestureCancel(_event: GestureCancelEvt): void;
48
+ onKeyPress(event: KeyPressEvent): boolean;
49
+ /** Returns the side-length of the tip of this eraser. */
50
+ getThickness(): number;
51
+ /** Sets the side-length of this' tip. */
52
+ setThickness(thickness: number): void;
53
+ /**
54
+ * Returns a {@link MutableReactiveValue} that can be used to watch
55
+ * this tool's thickness.
56
+ */
57
+ getThicknessValue(): MutableReactiveValue<number>;
58
+ /** @returns An object that allows switching between a full stroke and a partial stroke eraser. */
59
+ getModeValue(): MutableReactiveValue<EraserMode>;
60
+ }
@@ -0,0 +1,292 @@
1
+ import { EditorEventType } from '../types.mjs';
2
+ import BaseTool from './BaseTool.mjs';
3
+ import { Vec2, LineSegment2, Color4, Rect2, Path } from '@js-draw/math';
4
+ import Erase from '../commands/Erase.mjs';
5
+ import { PointerDevice } from '../Pointer.mjs';
6
+ import { decreaseSizeKeyboardShortcutId, increaseSizeKeyboardShortcutId } from './keybindings.mjs';
7
+ import { ReactiveValue } from '../util/ReactiveValue.mjs';
8
+ import EditorImage from '../image/EditorImage.mjs';
9
+ import uniteCommands from '../commands/uniteCommands.mjs';
10
+ import { pathToRenderable } from '../rendering/RenderablePathSpec.mjs';
11
+ export var EraserMode;
12
+ (function (EraserMode) {
13
+ EraserMode["PartialStroke"] = "partial-stroke";
14
+ EraserMode["FullStroke"] = "full-stroke";
15
+ })(EraserMode || (EraserMode = {}));
16
+ /** Handles switching from other primary tools to the eraser and back */
17
+ class EraserSwitcher extends BaseTool {
18
+ constructor(editor, eraser) {
19
+ super(editor.notifier, editor.localization.changeTool);
20
+ this.editor = editor;
21
+ this.eraser = eraser;
22
+ }
23
+ onPointerDown(event) {
24
+ if (event.allPointers.length === 1 && event.current.device === PointerDevice.Eraser) {
25
+ const toolController = this.editor.toolController;
26
+ const enabledPrimaryTools = toolController.getPrimaryTools().filter(tool => tool.isEnabled());
27
+ if (enabledPrimaryTools.length) {
28
+ this.previousEnabledTool = enabledPrimaryTools[0];
29
+ }
30
+ else {
31
+ this.previousEnabledTool = null;
32
+ }
33
+ this.previousEraserEnabledState = this.eraser.isEnabled();
34
+ this.eraser.setEnabled(true);
35
+ if (this.eraser.onPointerDown(event)) {
36
+ return true;
37
+ }
38
+ else {
39
+ this.restoreOriginalTool();
40
+ }
41
+ }
42
+ return false;
43
+ }
44
+ onPointerMove(event) {
45
+ this.eraser.onPointerMove(event);
46
+ }
47
+ restoreOriginalTool() {
48
+ this.eraser.setEnabled(this.previousEraserEnabledState);
49
+ if (this.previousEnabledTool) {
50
+ this.previousEnabledTool.setEnabled(true);
51
+ }
52
+ }
53
+ onPointerUp(event) {
54
+ this.eraser.onPointerUp(event);
55
+ this.restoreOriginalTool();
56
+ }
57
+ onGestureCancel(event) {
58
+ this.eraser.onGestureCancel(event);
59
+ this.restoreOriginalTool();
60
+ }
61
+ }
62
+ /**
63
+ * A tool that allows a user to erase parts of an image.
64
+ */
65
+ export default class Eraser extends BaseTool {
66
+ constructor(editor, description, options) {
67
+ super(editor.notifier, description);
68
+ this.editor = editor;
69
+ this.lastPoint = null;
70
+ this.isFirstEraseEvt = true;
71
+ this.toAdd = new Set();
72
+ // Commands that each remove one element
73
+ this.eraseCommands = [];
74
+ this.addCommands = [];
75
+ this.thickness = options?.thickness ?? 10;
76
+ this.thicknessValue = ReactiveValue.fromInitialValue(this.thickness);
77
+ this.thicknessValue.onUpdate(value => {
78
+ this.thickness = value;
79
+ this.editor.notifier.dispatch(EditorEventType.ToolUpdated, {
80
+ kind: EditorEventType.ToolUpdated,
81
+ tool: this,
82
+ });
83
+ });
84
+ this.modeValue = ReactiveValue.fromInitialValue(options?.mode ?? EraserMode.FullStroke);
85
+ this.modeValue.onUpdate(_value => {
86
+ this.editor.notifier.dispatch(EditorEventType.ToolUpdated, {
87
+ kind: EditorEventType.ToolUpdated,
88
+ tool: this,
89
+ });
90
+ });
91
+ }
92
+ /**
93
+ * @returns a tool that briefly enables the eraser when a physical eraser is used.
94
+ * This tool should be added to the tool list after the primary tools.
95
+ */
96
+ makeEraserSwitcherTool() {
97
+ return new EraserSwitcher(this.editor, this);
98
+ }
99
+ clearPreview() {
100
+ this.editor.clearWetInk();
101
+ }
102
+ getSizeOnCanvas() {
103
+ return this.thickness / this.editor.viewport.getScaleFactor();
104
+ }
105
+ drawPreviewAt(point) {
106
+ this.clearPreview();
107
+ const size = this.getSizeOnCanvas();
108
+ const renderer = this.editor.display.getWetInkRenderer();
109
+ const rect = this.getEraserRect(point);
110
+ const rect2 = this.getEraserRect(this.lastPoint ?? point);
111
+ const fill = {
112
+ fill: Color4.transparent,
113
+ stroke: { width: size / 10, color: Color4.gray },
114
+ };
115
+ renderer.drawPath(pathToRenderable(Path.fromConvexHullOf([...rect.corners, ...rect2.corners]), fill));
116
+ }
117
+ /**
118
+ * @returns the eraser rectangle in canvas coordinates.
119
+ *
120
+ * For now, all erasers are rectangles or points.
121
+ */
122
+ getEraserRect(centerPoint) {
123
+ const size = this.getSizeOnCanvas();
124
+ const halfSize = Vec2.of(size / 2, size / 2);
125
+ return Rect2.fromCorners(centerPoint.minus(halfSize), centerPoint.plus(halfSize));
126
+ }
127
+ /** Erases in a line from the last point to the current. */
128
+ eraseTo(currentPoint) {
129
+ if (!this.isFirstEraseEvt && currentPoint.distanceTo(this.lastPoint) === 0) {
130
+ return;
131
+ }
132
+ this.isFirstEraseEvt = false;
133
+ // Currently only objects within eraserRect or that intersect a straight line
134
+ // from the center of the current rect to the previous are erased. TODO: Erase
135
+ // all objects as if there were pointerMove events between the two points.
136
+ const eraserRect = this.getEraserRect(currentPoint);
137
+ const line = new LineSegment2(this.lastPoint, currentPoint);
138
+ const region = Rect2.union(line.bbox, eraserRect);
139
+ const intersectingElems = this.editor.image.getElementsIntersectingRegion(region).filter(component => {
140
+ return component.intersects(line) || component.intersectsRect(eraserRect);
141
+ });
142
+ // Only erase components that could be selected (and thus interacted with)
143
+ // by the user.
144
+ const eraseableElems = intersectingElems.filter(elem => elem.isSelectable());
145
+ if (this.modeValue.get() === EraserMode.FullStroke) {
146
+ // Remove any intersecting elements.
147
+ this.toRemove.push(...eraseableElems);
148
+ // Create new Erase commands for the now-to-be-erased elements and apply them.
149
+ const newPartialCommands = eraseableElems.map(elem => new Erase([elem]));
150
+ newPartialCommands.forEach(cmd => cmd.apply(this.editor));
151
+ this.eraseCommands.push(...newPartialCommands);
152
+ }
153
+ else {
154
+ const toErase = [];
155
+ const toAdd = [];
156
+ for (const targetElem of eraseableElems) {
157
+ toErase.push(targetElem);
158
+ // Completely delete items that can't be divided.
159
+ if (!targetElem.withRegionErased) {
160
+ continue;
161
+ }
162
+ // Completely delete items that are completely or almost completely
163
+ // contained within the eraser.
164
+ const grownRect = eraserRect.grownBy(eraserRect.maxDimension / 3);
165
+ if (grownRect.containsRect(targetElem.getExactBBox())) {
166
+ continue;
167
+ }
168
+ // Join the current and previous rectangles so that points between events are also
169
+ // erased.
170
+ const erasePath = Path.fromConvexHullOf([
171
+ ...eraserRect.corners, ...this.getEraserRect(this.lastPoint ?? currentPoint).corners
172
+ ].map(p => this.editor.viewport.roundPoint(p)));
173
+ toAdd.push(...targetElem.withRegionErased(erasePath, this.editor.viewport));
174
+ }
175
+ const eraseCommand = new Erase(toErase);
176
+ const newAddCommands = toAdd.map(elem => EditorImage.addElement(elem));
177
+ eraseCommand.apply(this.editor);
178
+ newAddCommands.forEach(command => command.apply(this.editor));
179
+ const finalToErase = [];
180
+ for (const item of toErase) {
181
+ if (this.toAdd.has(item)) {
182
+ this.toAdd.delete(item);
183
+ }
184
+ else {
185
+ finalToErase.push(item);
186
+ }
187
+ }
188
+ this.toRemove.push(...finalToErase);
189
+ for (const item of toAdd) {
190
+ this.toAdd.add(item);
191
+ }
192
+ this.eraseCommands.push(new Erase(finalToErase));
193
+ this.addCommands.push(...newAddCommands);
194
+ }
195
+ this.drawPreviewAt(currentPoint);
196
+ this.lastPoint = currentPoint;
197
+ }
198
+ onPointerDown(event) {
199
+ if (event.allPointers.length === 1 || event.current.device === PointerDevice.Eraser) {
200
+ this.lastPoint = event.current.canvasPos;
201
+ this.toRemove = [];
202
+ this.toAdd.clear();
203
+ this.isFirstEraseEvt = true;
204
+ this.drawPreviewAt(event.current.canvasPos);
205
+ return true;
206
+ }
207
+ return false;
208
+ }
209
+ onPointerMove(event) {
210
+ const currentPoint = event.current.canvasPos;
211
+ this.eraseTo(currentPoint);
212
+ }
213
+ onPointerUp(event) {
214
+ this.eraseTo(event.current.canvasPos);
215
+ const commands = [];
216
+ if (this.addCommands.length > 0) {
217
+ this.addCommands.forEach(cmd => cmd.unapply(this.editor));
218
+ // Remove items from toAdd that are also present in toRemove -- adding, then
219
+ // removing these does nothing, and can break undo/redo.
220
+ for (const item of this.toAdd) {
221
+ if (this.toRemove.includes(item)) {
222
+ this.toAdd.delete(item);
223
+ this.toRemove = this.toRemove.filter(other => other !== item);
224
+ }
225
+ }
226
+ for (const item of this.toRemove) {
227
+ if (this.toAdd.has(item)) {
228
+ this.toAdd.delete(item);
229
+ this.toRemove = this.toRemove.filter(other => other !== item);
230
+ }
231
+ }
232
+ commands.push(...[...this.toAdd].map(a => EditorImage.addElement(a)));
233
+ this.addCommands = [];
234
+ }
235
+ if (this.eraseCommands.length > 0) {
236
+ // Undo commands for each individual component and unite into a single command.
237
+ this.eraseCommands.forEach(cmd => cmd.unapply(this.editor));
238
+ this.eraseCommands = [];
239
+ const command = new Erase(this.toRemove);
240
+ commands.push(command);
241
+ }
242
+ if (commands.length === 1) {
243
+ this.editor.dispatch(commands[0]); // dispatch: Makes undo-able.
244
+ }
245
+ else {
246
+ this.editor.dispatch(uniteCommands(commands));
247
+ }
248
+ this.clearPreview();
249
+ }
250
+ onGestureCancel(_event) {
251
+ this.addCommands.forEach(cmd => cmd.unapply(this.editor));
252
+ this.eraseCommands.forEach(cmd => cmd.unapply(this.editor));
253
+ this.eraseCommands = [];
254
+ this.addCommands = [];
255
+ this.clearPreview();
256
+ }
257
+ onKeyPress(event) {
258
+ const shortcuts = this.editor.shortcuts;
259
+ let newThickness;
260
+ if (shortcuts.matchesShortcut(decreaseSizeKeyboardShortcutId, event)) {
261
+ newThickness = this.getThickness() * 2 / 3;
262
+ }
263
+ else if (shortcuts.matchesShortcut(increaseSizeKeyboardShortcutId, event)) {
264
+ newThickness = this.getThickness() * 3 / 2;
265
+ }
266
+ if (newThickness !== undefined) {
267
+ newThickness = Math.min(Math.max(1, newThickness), 200);
268
+ this.setThickness(newThickness);
269
+ return true;
270
+ }
271
+ return false;
272
+ }
273
+ /** Returns the side-length of the tip of this eraser. */
274
+ getThickness() {
275
+ return this.thickness;
276
+ }
277
+ /** Sets the side-length of this' tip. */
278
+ setThickness(thickness) {
279
+ this.thicknessValue.set(thickness);
280
+ }
281
+ /**
282
+ * Returns a {@link MutableReactiveValue} that can be used to watch
283
+ * this tool's thickness.
284
+ */
285
+ getThicknessValue() {
286
+ return this.thicknessValue;
287
+ }
288
+ /** @returns An object that allows switching between a full stroke and a partial stroke eraser. */
289
+ getModeValue() {
290
+ return this.modeValue;
291
+ }
292
+ }
@@ -0,0 +1 @@
1
+ export {};
@@ -0,0 +1,21 @@
1
+ import Editor from '../Editor';
2
+ import { KeyPressEvent } from '../inputEvents';
3
+ import BaseTool from './BaseTool';
4
+ export default class FindTool extends BaseTool {
5
+ private editor;
6
+ private overlay;
7
+ private searchInput;
8
+ private currentMatchIdx;
9
+ constructor(editor: Editor);
10
+ canReceiveInputInReadOnlyEditor(): boolean;
11
+ private getMatches;
12
+ private focusCurrentMatch;
13
+ private toNextMatch;
14
+ private toPrevMatch;
15
+ private fillOverlay;
16
+ private isVisible;
17
+ private setVisible;
18
+ private toggleVisible;
19
+ onKeyPress(event: KeyPressEvent): boolean;
20
+ setEnabled(enabled: boolean): void;
21
+ }