Feature Request: Function to Find the Closest Node by Type

[Aribaskar-jb]

Description

Description:
A utility function to find the closest node in the document tree using:

• An array of node type names (e.g., ['paragraph', 'heading', 'listItem']).
• A specified nodePos to locate the node.

Proposed Functionality:

1. Traverse the document tree starting from nodePos.
2. Match the closest node to one of the specified types in the array.
3. Return details like the node, its position, and optional metadata (e.g., depth).

Use Cases:

1. Custom Toolbar Actions:
   Identify the closest node of a specific type to enable or disable actions in a custom toolbar (e.g., toggling headings, lists, or formatting options).

2. Dynamic Node Manipulation:
   Find and update the attributes or content of the nearest matching node programmatically (e.g., setting attributes for a parent table or blockquote node).

3. Plugin Development:
   Streamline plugin logic by abstracting common operations like identifying the context of the current selection and traversing to find related parent nodes.

4. Validation of Nested Structures:
   Verify the presence of specific node types with specific attributes in a nested hierarchy for document structure validation or error highlighting.

5. Contextual Styling or Behavior:
   Change the behavior or styling of nodes dynamically based on the closest parent node that matches the specified type and attributes.

Type

New Tiptap API