@handlewithcare/react-prosemirror 3.0.4 → 3.0.6

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 (33) hide show
  1. package/README.md +36 -6
  2. package/dist/cjs/components/ChildNodeViews.js +3 -1
  3. package/dist/cjs/components/CursorWrapper.js +6 -11
  4. package/dist/cjs/components/ProseMirror.js +2 -2
  5. package/dist/cjs/components/WidgetView.js +1 -0
  6. package/dist/cjs/hooks/useComponentEventListeners.js +37 -4
  7. package/dist/cjs/hooks/useEditor.js +4 -6
  8. package/dist/cjs/plugins/beforeInputPlugin.js +32 -2
  9. package/dist/cjs/testing/editorViewTestHelpers.js +1 -1
  10. package/dist/esm/components/ChildNodeViews.js +3 -1
  11. package/dist/esm/components/CursorWrapper.js +7 -12
  12. package/dist/esm/components/ProseMirror.js +2 -2
  13. package/dist/esm/components/WidgetView.js +1 -0
  14. package/dist/esm/hooks/useComponentEventListeners.js +44 -11
  15. package/dist/esm/hooks/useEditor.js +4 -6
  16. package/dist/esm/plugins/beforeInputPlugin.js +33 -3
  17. package/dist/esm/testing/editorViewTestHelpers.js +1 -1
  18. package/dist/tsconfig.tsbuildinfo +1 -1
  19. package/dist/types/components/CursorWrapper.d.ts +2 -4
  20. package/dist/types/components/WidgetViewComponentProps.d.ts +4 -3
  21. package/dist/types/contexts/EditorContext.d.ts +2 -3
  22. package/dist/types/hooks/useComponentEventListeners.d.ts +11 -10
  23. package/dist/types/hooks/useEditor.d.ts +3 -3
  24. package/dist/types/hooks/useEditorEventListener.d.ts +1 -1
  25. package/dist/types/props.d.ts +1 -1
  26. package/dist/types/testing/editorViewTestHelpers.d.ts +1 -0
  27. package/package.json +1 -1
  28. package/dist/cjs/plugins/componentEventListeners.js +0 -35
  29. package/dist/cjs/plugins/componentEventListenersPlugin.js +0 -35
  30. package/dist/esm/plugins/componentEventListeners.js +0 -25
  31. package/dist/esm/plugins/componentEventListenersPlugin.js +0 -25
  32. package/dist/types/plugins/componentEventListeners.d.ts +0 -4
  33. package/dist/types/plugins/componentEventListenersPlugin.d.ts +0 -4
@@ -1,5 +1,3 @@
1
1
  import React from "react";
2
- export declare const CursorWrapper: React.ForwardRefExoticComponent<{
3
- widget: import("../decorations/ReactWidgetType.js").ReactWidgetDecoration;
4
- getPos: () => number;
5
- } & React.HTMLAttributes<HTMLElement> & React.RefAttributes<HTMLImageElement>>;
2
+ import { WidgetViewComponentProps } from "./WidgetViewComponentProps.js";
3
+ export declare const CursorWrapper: React.ForwardRefExoticComponent<Omit<WidgetViewComponentProps<React.AllHTMLAttributes<HTMLElement>>, "ref"> & React.RefAttributes<HTMLImageElement>>;
@@ -1,6 +1,7 @@
1
- import { HTMLAttributes } from "react";
1
+ import { AllHTMLAttributes, LegacyRef } from "react";
2
2
  import { ReactWidgetDecoration } from "../decorations/ReactWidgetType.js";
3
- export type WidgetViewComponentProps = {
3
+ export type WidgetViewComponentProps<Attributes = AllHTMLAttributes<HTMLElement>> = Attributes & {
4
4
  widget: ReactWidgetDecoration;
5
5
  getPos: () => number;
6
- } & HTMLAttributes<HTMLElement>;
6
+ ref: LegacyRef<any>;
7
+ };
@@ -1,10 +1,9 @@
1
- import type { DOMEventMap, Decoration } from "prosemirror-view";
1
+ import type { DOMEventMap } from "prosemirror-view";
2
2
  import { MutableRefObject } from "react";
3
3
  import { AbstractEditorView } from "../AbstractEditorView.js";
4
- import type { EventHandler } from "../plugins/componentEventListeners.js";
4
+ import type { EventHandler } from "../hooks/useComponentEventListeners.js";
5
5
  export interface EditorContextValue {
6
6
  view: AbstractEditorView;
7
- cursorWrapper: Decoration | null;
8
7
  flushSyncRef: MutableRefObject<boolean>;
9
8
  registerEventListener<EventType extends keyof DOMEventMap>(eventType: EventType, handler: EventHandler<EventType>): void;
10
9
  unregisterEventListener<EventType extends keyof DOMEventMap>(eventType: EventType, handler: EventHandler<EventType>): void;
@@ -1,5 +1,6 @@
1
- import type { DOMEventMap } from "prosemirror-view";
2
- import { EventHandler } from "../plugins/componentEventListeners.js";
1
+ import type { DOMEventMap, EditorView } from "prosemirror-view";
2
+ export type EventHandler<EventType extends keyof DOMEventMap = keyof DOMEventMap> = (view: EditorView, event: DOMEventMap[EventType]) => boolean | void;
3
+ export type HandleDOMEvents = Record<keyof DOMEventMap, EventHandler | undefined>;
3
4
  /**
4
5
  * Produces a plugin that can be used with ProseMirror to handle DOM
5
6
  * events at the EditorView.dom element.
@@ -14,20 +15,20 @@ import { EventHandler } from "../plugins/componentEventListeners.js";
14
15
  * @privateRemarks
15
16
  *
16
17
  * This hook uses a combination of mutable and immutable updates to give
17
- * us precise control over when we re-create the ProseMirror plugin.
18
+ * us precise control over when we re-create the event listeners.
18
19
  *
19
- * The plugin has a mutable reference to the set of handlers for each
20
+ * The hook has a mutable reference to the set of handlers for each
20
21
  * event type, but the set of event types is static. This means that we
21
- * need to produce a new ProseMirror plugin whenever a new event type is
22
- * registered. We avoid producing a new ProseMirrer plugin in any other
23
- * scenario to avoid the performance overhead of reconfiguring the plugins
24
- * in the EditorView.
22
+ * need to produce a new handleDOMEVents record whenever a new event type is
23
+ * registered. We avoid producing a new record in any other
24
+ * scenario to avoid the performance overhead of re-registering the event
25
+ * listeners in the EditorView.
25
26
  *
26
27
  * To accomplish this, we shallowly clone the registry whenever a new event
27
28
  * type is registered.
28
29
  */
29
- export declare function useComponentEventListeners(): {
30
+ export declare function useComponentEventListeners(handleDOMEventsProp: HandleDOMEvents | undefined): {
30
31
  registerEventListener: (eventType: keyof DOMEventMap, handler: EventHandler) => void;
31
32
  unregisterEventListener: (eventType: keyof DOMEventMap, handler: EventHandler) => void;
32
- componentEventListenersPlugin: import("prosemirror-state").Plugin<any>;
33
+ handleDOMEvents: HandleDOMEvents;
33
34
  };
@@ -20,11 +20,11 @@ export interface UseEditorOptions extends EditorProps {
20
20
  export declare function useEditor<T extends HTMLElement = HTMLElement>(mount: T | null, options: UseEditorOptions): {
21
21
  editor: {
22
22
  view: AbstractEditorView;
23
- cursorWrapper: Decoration | null;
24
23
  flushSyncRef: import("react").MutableRefObject<boolean>;
25
- registerEventListener: (eventType: keyof import("prosemirror-view").DOMEventMap, handler: import("../plugins/componentEventListeners.js").EventHandler<keyof import("prosemirror-view").DOMEventMap>) => void;
26
- unregisterEventListener: (eventType: keyof import("prosemirror-view").DOMEventMap, handler: import("../plugins/componentEventListeners.js").EventHandler<keyof import("prosemirror-view").DOMEventMap>) => void;
24
+ registerEventListener: (eventType: keyof import("prosemirror-view").DOMEventMap, handler: import("./useComponentEventListeners.js").EventHandler<keyof import("prosemirror-view").DOMEventMap>) => void;
25
+ unregisterEventListener: (eventType: keyof import("prosemirror-view").DOMEventMap, handler: import("./useComponentEventListeners.js").EventHandler<keyof import("prosemirror-view").DOMEventMap>) => void;
27
26
  isStatic: boolean;
28
27
  };
28
+ cursorWrapper: Decoration | null;
29
29
  state: EditorState;
30
30
  };
@@ -1,5 +1,5 @@
1
1
  import type { DOMEventMap } from "prosemirror-view";
2
- import type { EventHandler } from "../plugins/componentEventListeners.js";
2
+ import type { EventHandler } from "./useComponentEventListeners.js";
3
3
  /**
4
4
  * Attaches an event listener at the `EditorView`'s DOM node. See
5
5
  * [the ProseMirror docs](https://prosemirror.net/docs/ref/#view.EditorProps.handleDOMEvents)
@@ -960,7 +960,7 @@ export declare function mergeReactProps(a: HTMLProps<HTMLElement>, b: HTMLProps<
960
960
  "aria-colindextext"?: string | undefined;
961
961
  "aria-colspan"?: number | undefined;
962
962
  "aria-controls"?: string | undefined;
963
- "aria-current"?: boolean | "false" | "true" | "page" | "step" | "location" | "date" | "time" | undefined;
963
+ "aria-current"?: boolean | "false" | "true" | "step" | "page" | "location" | "date" | "time" | undefined;
964
964
  "aria-describedby"?: string | undefined;
965
965
  "aria-description"?: string | undefined;
966
966
  "aria-details"?: string | undefined;
@@ -1,4 +1,5 @@
1
1
  import { Node } from "prosemirror-model";
2
+ import { Selection } from "prosemirror-state";
2
3
  import { doc } from "prosemirror-test-builder";
3
4
  import { EditorView as EditorViewT } from "prosemirror-view";
4
5
  import { Props } from "../components/ProseMirror.js";
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@handlewithcare/react-prosemirror",
3
- "version": "3.0.4",
3
+ "version": "3.0.6",
4
4
  "license": "Apache-2.0",
5
5
  "type": "module",
6
6
  "main": "dist/cjs/index.js",
@@ -1,35 +0,0 @@
1
- "use strict";
2
- Object.defineProperty(exports, "__esModule", {
3
- value: true
4
- });
5
- Object.defineProperty(exports, "componentEventListeners", {
6
- enumerable: true,
7
- get: function() {
8
- return componentEventListeners;
9
- }
10
- });
11
- const _prosemirrorstate = require("prosemirror-state");
12
- const _reactdom = require("react-dom");
13
- function componentEventListeners(eventHandlerRegistry) {
14
- const domEventHandlers = {};
15
- for (const [eventType, handlers] of eventHandlerRegistry.entries()){
16
- function handleEvent(view, event) {
17
- for (const handler of handlers){
18
- let handled = false;
19
- (0, _reactdom.unstable_batchedUpdates)(()=>{
20
- handled = !!handler.call(this, view, event);
21
- });
22
- if (handled || event.defaultPrevented) return true;
23
- }
24
- return false;
25
- }
26
- domEventHandlers[eventType] = handleEvent;
27
- }
28
- const plugin = new _prosemirrorstate.Plugin({
29
- key: new _prosemirrorstate.PluginKey("@handlewithcare/react-prosemirror/componentEventListeners"),
30
- props: {
31
- handleDOMEvents: domEventHandlers
32
- }
33
- });
34
- return plugin;
35
- }
@@ -1,35 +0,0 @@
1
- /* Copyright (c) The New York Times Company */ "use strict";
2
- Object.defineProperty(exports, "__esModule", {
3
- value: true
4
- });
5
- Object.defineProperty(exports, "createComponentEventListenersPlugin", {
6
- enumerable: true,
7
- get: function() {
8
- return createComponentEventListenersPlugin;
9
- }
10
- });
11
- const _prosemirrorstate = require("prosemirror-state");
12
- const _reactdom = require("react-dom");
13
- function createComponentEventListenersPlugin(eventHandlerRegistry) {
14
- const domEventHandlers = {};
15
- for (const [eventType, handlers] of eventHandlerRegistry.entries()){
16
- function handleEvent(view, event) {
17
- for (const handler of handlers){
18
- let handled = false;
19
- (0, _reactdom.unstable_batchedUpdates)(()=>{
20
- handled = !!handler.call(this, view, event);
21
- });
22
- if (handled || event.defaultPrevented) return true;
23
- }
24
- return false;
25
- }
26
- domEventHandlers[eventType] = handleEvent;
27
- }
28
- const plugin = new _prosemirrorstate.Plugin({
29
- key: new _prosemirrorstate.PluginKey("componentEventListeners"),
30
- props: {
31
- handleDOMEvents: domEventHandlers
32
- }
33
- });
34
- return plugin;
35
- }
@@ -1,25 +0,0 @@
1
- import { Plugin, PluginKey } from "prosemirror-state";
2
- import { unstable_batchedUpdates as batch } from "react-dom";
3
- export function componentEventListeners(eventHandlerRegistry) {
4
- const domEventHandlers = {};
5
- for (const [eventType, handlers] of eventHandlerRegistry.entries()){
6
- function handleEvent(view, event) {
7
- for (const handler of handlers){
8
- let handled = false;
9
- batch(()=>{
10
- handled = !!handler.call(this, view, event);
11
- });
12
- if (handled || event.defaultPrevented) return true;
13
- }
14
- return false;
15
- }
16
- domEventHandlers[eventType] = handleEvent;
17
- }
18
- const plugin = new Plugin({
19
- key: new PluginKey("@handlewithcare/react-prosemirror/componentEventListeners"),
20
- props: {
21
- handleDOMEvents: domEventHandlers
22
- }
23
- });
24
- return plugin;
25
- }
@@ -1,25 +0,0 @@
1
- /* Copyright (c) The New York Times Company */ import { Plugin, PluginKey } from "prosemirror-state";
2
- import { unstable_batchedUpdates as batch } from "react-dom";
3
- export function createComponentEventListenersPlugin(eventHandlerRegistry) {
4
- const domEventHandlers = {};
5
- for (const [eventType, handlers] of eventHandlerRegistry.entries()){
6
- function handleEvent(view, event) {
7
- for (const handler of handlers){
8
- let handled = false;
9
- batch(()=>{
10
- handled = !!handler.call(this, view, event);
11
- });
12
- if (handled || event.defaultPrevented) return true;
13
- }
14
- return false;
15
- }
16
- domEventHandlers[eventType] = handleEvent;
17
- }
18
- const plugin = new Plugin({
19
- key: new PluginKey("componentEventListeners"),
20
- props: {
21
- handleDOMEvents: domEventHandlers
22
- }
23
- });
24
- return plugin;
25
- }
@@ -1,4 +0,0 @@
1
- import { Plugin } from "prosemirror-state";
2
- import { DOMEventMap, EditorView } from "prosemirror-view";
3
- export type EventHandler<EventType extends keyof DOMEventMap = keyof DOMEventMap> = (this: Plugin, view: EditorView, event: DOMEventMap[EventType]) => boolean | void;
4
- export declare function componentEventListeners(eventHandlerRegistry: Map<keyof DOMEventMap, Iterable<EventHandler>>): Plugin<any>;
@@ -1,4 +0,0 @@
1
- import { Plugin } from "prosemirror-state";
2
- import { DOMEventMap, EditorView } from "prosemirror-view";
3
- export type EventHandler<EventType extends keyof DOMEventMap = keyof DOMEventMap> = (this: Plugin, view: EditorView, event: DOMEventMap[EventType]) => boolean | void;
4
- export declare function createComponentEventListenersPlugin(eventHandlerRegistry: Map<keyof DOMEventMap, Set<EventHandler>>): Plugin<any>;