@xyflow/react 12.5.4 → 12.5.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 (87) hide show
  1. package/dist/esm/components/Edges/SimpleBezierEdge.d.ts +10 -0
  2. package/dist/esm/components/Edges/SimpleBezierEdge.d.ts.map +1 -1
  3. package/dist/esm/contexts/NodeIdContext.d.ts +1 -1
  4. package/dist/esm/hooks/useConnection.d.ts +4 -0
  5. package/dist/esm/hooks/useConnection.d.ts.map +1 -1
  6. package/dist/esm/hooks/useEdges.d.ts +1 -1
  7. package/dist/esm/hooks/useHandleConnections.d.ts +8 -8
  8. package/dist/esm/hooks/useHandleConnections.d.ts.map +1 -1
  9. package/dist/esm/hooks/useInternalNode.d.ts +2 -2
  10. package/dist/esm/hooks/useKeyPress.d.ts +23 -4
  11. package/dist/esm/hooks/useKeyPress.d.ts.map +1 -1
  12. package/dist/esm/hooks/useNodeConnections.d.ts +6 -6
  13. package/dist/esm/hooks/useNodeConnections.d.ts.map +1 -1
  14. package/dist/esm/hooks/useNodes.d.ts +1 -1
  15. package/dist/esm/hooks/useNodesData.d.ts +7 -5
  16. package/dist/esm/hooks/useNodesData.d.ts.map +1 -1
  17. package/dist/esm/hooks/useNodesEdgesState.d.ts +32 -6
  18. package/dist/esm/hooks/useNodesEdgesState.d.ts.map +1 -1
  19. package/dist/esm/hooks/useNodesInitialized.d.ts +3 -2
  20. package/dist/esm/hooks/useNodesInitialized.d.ts.map +1 -1
  21. package/dist/esm/hooks/useOnSelectionChange.d.ts +1 -2
  22. package/dist/esm/hooks/useOnSelectionChange.d.ts.map +1 -1
  23. package/dist/esm/hooks/useOnViewportChange.d.ts +5 -6
  24. package/dist/esm/hooks/useOnViewportChange.d.ts.map +1 -1
  25. package/dist/esm/hooks/useReactFlow.d.ts +0 -2
  26. package/dist/esm/hooks/useReactFlow.d.ts.map +1 -1
  27. package/dist/esm/hooks/useStore.d.ts +8 -5
  28. package/dist/esm/hooks/useStore.d.ts.map +1 -1
  29. package/dist/esm/hooks/useUpdateNodeInternals.d.ts +5 -4
  30. package/dist/esm/hooks/useUpdateNodeInternals.d.ts.map +1 -1
  31. package/dist/esm/hooks/useViewport.d.ts +3 -3
  32. package/dist/esm/index.js +108 -82
  33. package/dist/esm/index.mjs +108 -82
  34. package/dist/esm/store/initialState.d.ts.map +1 -1
  35. package/dist/esm/types/component-props.d.ts +234 -116
  36. package/dist/esm/types/component-props.d.ts.map +1 -1
  37. package/dist/esm/types/edges.d.ts +11 -1
  38. package/dist/esm/types/edges.d.ts.map +1 -1
  39. package/dist/esm/types/store.d.ts +3 -2
  40. package/dist/esm/types/store.d.ts.map +1 -1
  41. package/dist/esm/utils/changes.d.ts +6 -6
  42. package/dist/esm/utils/general.d.ts +11 -7
  43. package/dist/esm/utils/general.d.ts.map +1 -1
  44. package/dist/style.css +11 -0
  45. package/dist/umd/components/Edges/SimpleBezierEdge.d.ts +10 -0
  46. package/dist/umd/components/Edges/SimpleBezierEdge.d.ts.map +1 -1
  47. package/dist/umd/contexts/NodeIdContext.d.ts +1 -1
  48. package/dist/umd/hooks/useConnection.d.ts +4 -0
  49. package/dist/umd/hooks/useConnection.d.ts.map +1 -1
  50. package/dist/umd/hooks/useEdges.d.ts +1 -1
  51. package/dist/umd/hooks/useHandleConnections.d.ts +8 -8
  52. package/dist/umd/hooks/useHandleConnections.d.ts.map +1 -1
  53. package/dist/umd/hooks/useInternalNode.d.ts +2 -2
  54. package/dist/umd/hooks/useKeyPress.d.ts +23 -4
  55. package/dist/umd/hooks/useKeyPress.d.ts.map +1 -1
  56. package/dist/umd/hooks/useNodeConnections.d.ts +6 -6
  57. package/dist/umd/hooks/useNodeConnections.d.ts.map +1 -1
  58. package/dist/umd/hooks/useNodes.d.ts +1 -1
  59. package/dist/umd/hooks/useNodesData.d.ts +7 -5
  60. package/dist/umd/hooks/useNodesData.d.ts.map +1 -1
  61. package/dist/umd/hooks/useNodesEdgesState.d.ts +32 -6
  62. package/dist/umd/hooks/useNodesEdgesState.d.ts.map +1 -1
  63. package/dist/umd/hooks/useNodesInitialized.d.ts +3 -2
  64. package/dist/umd/hooks/useNodesInitialized.d.ts.map +1 -1
  65. package/dist/umd/hooks/useOnSelectionChange.d.ts +1 -2
  66. package/dist/umd/hooks/useOnSelectionChange.d.ts.map +1 -1
  67. package/dist/umd/hooks/useOnViewportChange.d.ts +5 -6
  68. package/dist/umd/hooks/useOnViewportChange.d.ts.map +1 -1
  69. package/dist/umd/hooks/useReactFlow.d.ts +0 -2
  70. package/dist/umd/hooks/useReactFlow.d.ts.map +1 -1
  71. package/dist/umd/hooks/useStore.d.ts +8 -5
  72. package/dist/umd/hooks/useStore.d.ts.map +1 -1
  73. package/dist/umd/hooks/useUpdateNodeInternals.d.ts +5 -4
  74. package/dist/umd/hooks/useUpdateNodeInternals.d.ts.map +1 -1
  75. package/dist/umd/hooks/useViewport.d.ts +3 -3
  76. package/dist/umd/index.js +2 -2
  77. package/dist/umd/store/initialState.d.ts.map +1 -1
  78. package/dist/umd/types/component-props.d.ts +234 -116
  79. package/dist/umd/types/component-props.d.ts.map +1 -1
  80. package/dist/umd/types/edges.d.ts +11 -1
  81. package/dist/umd/types/edges.d.ts.map +1 -1
  82. package/dist/umd/types/store.d.ts +3 -2
  83. package/dist/umd/types/store.d.ts.map +1 -1
  84. package/dist/umd/utils/changes.d.ts +6 -6
  85. package/dist/umd/utils/general.d.ts +11 -7
  86. package/dist/umd/utils/general.d.ts.map +1 -1
  87. package/package.json +4 -4
@@ -1 +1 @@
1
- {"version":3,"file":"useOnSelectionChange.d.ts","sourceRoot":"","sources":["../../src/hooks/useOnSelectionChange.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAElE,MAAM,MAAM,2BAA2B,CAAC,QAAQ,SAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,SAAS,IAAI,GAAG,IAAI,IAAI;IACpG,QAAQ,EAAE,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,SAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,SAAS,IAAI,GAAG,IAAI,EAAE,EAC/F,QAAQ,GACT,EAAE,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAYjD"}
1
+ {"version":3,"file":"useOnSelectionChange.d.ts","sourceRoot":"","sources":["../../src/hooks/useOnSelectionChange.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAElE,MAAM,MAAM,2BAA2B,CAAC,QAAQ,SAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,SAAS,IAAI,GAAG,IAAI,IAAI;IACpG,+BAA+B;IAC/B,QAAQ,EAAE,qBAAqB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;CACrD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,oBAAoB,CAAC,QAAQ,SAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,SAAS,IAAI,GAAG,IAAI,EAAE,EAC/F,QAAQ,GACT,EAAE,2BAA2B,CAAC,QAAQ,EAAE,QAAQ,CAAC,QAYjD"}
@@ -1,19 +1,18 @@
1
1
  import type { OnViewportChange } from '@xyflow/system';
2
2
  export type UseOnViewportChangeOptions = {
3
+ /** Gets called when the viewport starts changing. */
3
4
  onStart?: OnViewportChange;
5
+ /** Gets called when the viewport changes. */
4
6
  onChange?: OnViewportChange;
7
+ /** Gets called when the viewport stops changing. */
5
8
  onEnd?: OnViewportChange;
6
9
  };
7
10
  /**
8
11
  * The `useOnViewportChange` hook lets you listen for changes to the viewport such
9
- *as panning and zooming. You can provide a callback for each phase of a viewport
10
- *change: `onStart`, `onChange`, and `onEnd`.
12
+ * as panning and zooming. You can provide a callback for each phase of a viewport
13
+ * change: `onStart`, `onChange`, and `onEnd`.
11
14
  *
12
15
  * @public
13
- * @param params.onStart - gets called when the viewport starts changing
14
- * @param params.onChange - gets called when the viewport changes
15
- * @param params.onEnd - gets called when the viewport stops changing
16
- *
17
16
  * @example
18
17
  * ```jsx
19
18
  *import { useCallback } from 'react';
@@ -1 +1 @@
1
- {"version":3,"file":"useOnViewportChange.d.ts","sourceRoot":"","sources":["../../src/hooks/useOnViewportChange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,0BAA0B,QAc3F"}
1
+ {"version":3,"file":"useOnViewportChange.d.ts","sourceRoot":"","sources":["../../src/hooks/useOnViewportChange.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAIvD,MAAM,MAAM,0BAA0B,GAAG;IACvC,qDAAqD;IACrD,OAAO,CAAC,EAAE,gBAAgB,CAAC;IAC3B,6CAA6C;IAC7C,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,oDAAoD;IACpD,KAAK,CAAC,EAAE,gBAAgB,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,0BAA0B,QAc3F"}
@@ -3,8 +3,6 @@ import type { ReactFlowInstance, Node, Edge } from '../types';
3
3
  * This hook returns a ReactFlowInstance that can be used to update nodes and edges, manipulate the viewport, or query the current state of the flow.
4
4
  *
5
5
  * @public
6
- * @returns ReactFlowInstance
7
- *
8
6
  * @example
9
7
  * ```jsx
10
8
  *import { useCallback, useState } from 'react';
@@ -1 +1 @@
1
- {"version":3,"file":"useReactFlow.d.ts","sourceRoot":"","sources":["../../src/hooks/useReactFlow.ts"],"names":[],"mappings":"AAiBA,OAAO,KAAK,EACV,iBAAiB,EACjB,IAAI,EACJ,IAAI,EAKL,MAAM,UAAU,CAAC;AAIlB;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,YAAY,CAAC,QAAQ,SAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,SAAS,IAAI,GAAG,IAAI,KAAK,iBAAiB,CAC3G,QAAQ,EACR,QAAQ,CACT,CAiPA"}
1
+ {"version":3,"file":"useReactFlow.d.ts","sourceRoot":"","sources":["../../src/hooks/useReactFlow.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EACV,iBAAiB,EACjB,IAAI,EACJ,IAAI,EAKL,MAAM,UAAU,CAAC;AAIlB;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,YAAY,CAAC,QAAQ,SAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,SAAS,IAAI,GAAG,IAAI,KAAK,iBAAiB,CAC3G,QAAQ,EACR,QAAQ,CACT,CAiPA"}
@@ -5,9 +5,13 @@ import type { Edge, Node, ReactFlowState } from '../types';
5
5
  * state management library, so you should check out their docs for more details.
6
6
  *
7
7
  * @public
8
- * @param selector
9
- * @param equalityFn
10
- * @returns The selected state slice
8
+ * @param selector - A selector function that returns a slice of the flow's internal state.
9
+ * Extracting or transforming just the state you need is a good practice to avoid unnecessary
10
+ * re-renders.
11
+ * @param equalityFn - A function to compare the previous and next value. This is incredibly useful
12
+ * for preventing unnecessary re-renders. Good sensible defaults are using `Object.is` or importing
13
+ * `zustand/shallow`, but you can be as granular as you like.
14
+ * @returns The selected state slice.
11
15
  *
12
16
  * @example
13
17
  * ```ts
@@ -22,8 +26,7 @@ declare function useStore<StateSlice = unknown>(selector: (state: ReactFlowState
22
26
  /**
23
27
  * In some cases, you might need to access the store directly. This hook returns the store object which can be used on demand to access the state or dispatch actions.
24
28
  *
25
- * @returns The store object
26
- *
29
+ * @returns The store object.
27
30
  * @example
28
31
  * ```ts
29
32
  * const store = useStoreApi();
@@ -1 +1 @@
1
- {"version":3,"file":"useStore.d.ts","sourceRoot":"","sources":["../../src/hooks/useStore.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI3D;;;;;;;;;;;;;;;;;;GAkBG;AACH,iBAAS,QAAQ,CAAC,UAAU,GAAG,OAAO,EACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,UAAU,EAC/C,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,KAAK,OAAO,cASvD;AAED;;;;;;;;;;;;;GAaG;AACH,iBAAS,WAAW,CAAC,QAAQ,SAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,SAAS,IAAI,GAAG,IAAI;;;;EAiB9E;AAED,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}
1
+ {"version":3,"file":"useStore.d.ts","sourceRoot":"","sources":["../../src/hooks/useStore.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAI3D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,iBAAS,QAAQ,CAAC,UAAU,GAAG,OAAO,EACpC,QAAQ,EAAE,CAAC,KAAK,EAAE,cAAc,KAAK,UAAU,EAC/C,UAAU,CAAC,EAAE,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,KAAK,OAAO,cASvD;AAED;;;;;;;;;;;;GAYG;AACH,iBAAS,WAAW,CAAC,QAAQ,SAAS,IAAI,GAAG,IAAI,EAAE,QAAQ,SAAS,IAAI,GAAG,IAAI;;;;EAiB9E;AAED,OAAO,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC"}
@@ -1,12 +1,13 @@
1
1
  import type { UpdateNodeInternals } from '@xyflow/system';
2
2
  /**
3
3
  * When you programmatically add or remove handles to a node or update a node's
4
- *handle position, you need to let React Flow know about it using this hook. This
5
- *will update the internal dimensions of the node and properly reposition handles
6
- *on the canvas if necessary.
4
+ * handle position, you need to let React Flow know about it using this hook. This
5
+ * will update the internal dimensions of the node and properly reposition handles
6
+ * on the canvas if necessary.
7
7
  *
8
8
  * @public
9
- * @returns function for updating node internals
9
+ * @returns Use this function to tell React Flow to update the internal state of one or more nodes
10
+ * that you have changed programmatically.
10
11
  *
11
12
  * @example
12
13
  * ```jsx
@@ -1 +1 @@
1
- {"version":3,"file":"useUpdateNodeInternals.d.ts","sourceRoot":"","sources":["../../src/hooks/useUpdateNodeInternals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,gBAAgB,CAAC;AAI9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAkB5D"}
1
+ {"version":3,"file":"useUpdateNodeInternals.d.ts","sourceRoot":"","sources":["../../src/hooks/useUpdateNodeInternals.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,mBAAmB,EAAsB,MAAM,gBAAgB,CAAC;AAI9E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4CG;AACH,wBAAgB,sBAAsB,IAAI,mBAAmB,CAkB5D"}
@@ -1,11 +1,11 @@
1
1
  import type { Viewport } from '@xyflow/system';
2
2
  /**
3
3
  * The `useViewport` hook is a convenient way to read the current state of the
4
- *{@link Viewport} in a component. Components that use this hook
5
- *will re-render **whenever the viewport changes**.
4
+ * {@link Viewport} in a component. Components that use this hook
5
+ * will re-render **whenever the viewport changes**.
6
6
  *
7
7
  * @public
8
- * @returns The current viewport
8
+ * @returns The current viewport.
9
9
  *
10
10
  * @example
11
11
  *