@kopexa/editor-utils 17.0.46 → 17.1.0

package/dist/chunk-23NZ6BRW.mjs

@@ -0,0 +1,27 @@
+"use client";
+
+// src/update-node-attrs.ts
+function updateNodesAttr(tr, targets, attrName, next) {
+  if (!targets.length) return false;
+  let changed = false;
+  for (const { pos } of targets) {
+    const currentNode = tr.doc.nodeAt(pos);
+    if (!currentNode) continue;
+    const prevValue = currentNode.attrs[attrName];
+    const resolvedNext = typeof next === "function" ? next(prevValue) : next;
+    if (prevValue === resolvedNext) continue;
+    const nextAttrs = { ...currentNode.attrs };
+    if (resolvedNext === void 0) {
+      delete nextAttrs[attrName];
+    } else {
+      nextAttrs[attrName] = resolvedNext;
+    }
+    tr.setNodeMarkup(pos, void 0, nextAttrs);
+    changed = true;
+  }
+  return changed;
+}
+
+export {
+  updateNodesAttr
+};

package/dist/chunk-ID5T7EEZ.mjs

@@ -0,0 +1,90 @@
+"use client";
+
+// src/selection.ts
+import {
+  AllSelection,
+  NodeSelection,
+  TextSelection
+} from "@tiptap/pm/state";
+import { CellSelection, cellAround } from "@tiptap/pm/tables";
+import { findParentNodeClosestToPos } from "@tiptap/react";
+function getSelectedBlockNodes(editor) {
+  const { doc } = editor.state;
+  const { from, to } = editor.state.selection;
+  const blocks = [];
+  const seen = /* @__PURE__ */ new Set();
+  doc.nodesBetween(from, to, (node, pos) => {
+    if (!node.isBlock) return;
+    if (!seen.has(pos)) {
+      seen.add(pos);
+      blocks.push(node);
+    }
+    return false;
+  });
+  return blocks;
+}
+function getSelectedNodesOfType(selection, allowedNodeTypes) {
+  const results = [];
+  const allowed = new Set(allowedNodeTypes);
+  if (selection instanceof CellSelection) {
+    selection.forEachCell((node, pos) => {
+      if (allowed.has(node.type.name)) {
+        results.push({ node, pos });
+      }
+    });
+    return results;
+  }
+  if (selection instanceof NodeSelection) {
+    const { node, from: pos } = selection;
+    if (node && allowed.has(node.type.name)) {
+      results.push({ node, pos });
+    }
+    return results;
+  }
+  const { $anchor } = selection;
+  const cell = cellAround($anchor);
+  if (cell) {
+    const cellNode = selection.$anchor.doc.nodeAt(cell.pos);
+    if (cellNode && allowed.has(cellNode.type.name)) {
+      results.push({ node: cellNode, pos: cell.pos });
+      return results;
+    }
+  }
+  const parentNode = findParentNodeClosestToPos(
+    $anchor,
+    (node) => allowed.has(node.type.name)
+  );
+  if (parentNode) {
+    results.push({ node: parentNode.node, pos: parentNode.pos });
+  }
+  return results;
+}
+function selectionWithinConvertibleTypes(editor, types = []) {
+  var _a, _b;
+  if (!editor || types.length === 0) return false;
+  const { state } = editor;
+  const { selection } = state;
+  const allowed = new Set(types);
+  if (selection instanceof NodeSelection) {
+    const nodeType = (_b = (_a = selection.node) == null ? void 0 : _a.type) == null ? void 0 : _b.name;
+    return !!nodeType && allowed.has(nodeType);
+  }
+  if (selection instanceof TextSelection || selection instanceof AllSelection) {
+    let valid = true;
+    state.doc.nodesBetween(selection.from, selection.to, (node) => {
+      if (node.isTextblock && !allowed.has(node.type.name)) {
+        valid = false;
+        return false;
+      }
+      return valid;
+    });
+    return valid;
+  }
+  return false;
+}
+
+export {
+  getSelectedBlockNodes,
+  getSelectedNodesOfType,
+  selectionWithinConvertibleTypes
+};

package/dist/chunk-P55PLOHR.mjs

@@ -0,0 +1,34 @@
+"use client";
+
+// src/hooks/use-tiptap-editor.ts
+import { useCurrentEditor, useEditorState } from "@tiptap/react";
+import { useMemo } from "react";
+function useTiptapEditor(providedEditor) {
+  const { editor: coreEditor } = useCurrentEditor();
+  const mainEditor = useMemo(
+    () => providedEditor || coreEditor,
+    [providedEditor, coreEditor]
+  );
+  const editorState = useEditorState({
+    editor: mainEditor,
+    selector(context) {
+      if (!context.editor) {
+        return {
+          editor: null,
+          editorState: void 0,
+          canCommand: void 0
+        };
+      }
+      return {
+        editor: context.editor,
+        editorState: context.editor.state,
+        canCommand: context.editor.can
+      };
+    }
+  });
+  return editorState || { editor: null };
+}
+
+export {
+  useTiptapEditor
+};

package/dist/hooks/use-tiptap-editor.d.mts

@@ -0,0 +1,20 @@
+import { Editor } from '@tiptap/react';
+
+/**
+ * Hook that provides access to a Tiptap editor instance.
+ *
+ * Accepts an optional editor instance directly, or falls back to retrieving
+ * the editor from the Tiptap context if available. This allows components
+ * to work both when given an editor directly and when used within a Tiptap
+ * editor context.
+ *
+ * @param providedEditor - Optional editor instance to use instead of the context editor
+ * @returns The provided editor or the editor from context, whichever is available
+ */
+declare function useTiptapEditor(providedEditor?: Editor | null): {
+    editor: Editor | null;
+    editorState?: Editor["state"];
+    canCommand?: Editor["can"];
+};
+
+export { useTiptapEditor };

package/dist/hooks/use-tiptap-editor.d.ts

@@ -0,0 +1,20 @@
+import { Editor } from '@tiptap/react';
+
+/**
+ * Hook that provides access to a Tiptap editor instance.
+ *
+ * Accepts an optional editor instance directly, or falls back to retrieving
+ * the editor from the Tiptap context if available. This allows components
+ * to work both when given an editor directly and when used within a Tiptap
+ * editor context.
+ *
+ * @param providedEditor - Optional editor instance to use instead of the context editor
+ * @returns The provided editor or the editor from context, whichever is available
+ */
+declare function useTiptapEditor(providedEditor?: Editor | null): {
+    editor: Editor | null;
+    editorState?: Editor["state"];
+    canCommand?: Editor["can"];
+};
+
+export { useTiptapEditor };

package/dist/hooks/use-tiptap-editor.js

@@ -0,0 +1,58 @@
+"use client";
+"use strict";
+"use client";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/hooks/use-tiptap-editor.ts
+var use_tiptap_editor_exports = {};
+__export(use_tiptap_editor_exports, {
+  useTiptapEditor: () => useTiptapEditor
+});
+module.exports = __toCommonJS(use_tiptap_editor_exports);
+var import_react = require("@tiptap/react");
+var import_react2 = require("react");
+function useTiptapEditor(providedEditor) {
+  const { editor: coreEditor } = (0, import_react.useCurrentEditor)();
+  const mainEditor = (0, import_react2.useMemo)(
+    () => providedEditor || coreEditor,
+    [providedEditor, coreEditor]
+  );
+  const editorState = (0, import_react.useEditorState)({
+    editor: mainEditor,
+    selector(context) {
+      if (!context.editor) {
+        return {
+          editor: null,
+          editorState: void 0,
+          canCommand: void 0
+        };
+      }
+      return {
+        editor: context.editor,
+        editorState: context.editor.state,
+        canCommand: context.editor.can
+      };
+    }
+  });
+  return editorState || { editor: null };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  useTiptapEditor
+});

package/dist/hooks/use-tiptap-editor.mjs

@@ -0,0 +1,8 @@
+"use client";
+"use client";
+import {
+  useTiptapEditor
+} from "../chunk-P55PLOHR.mjs";
+export {
+  useTiptapEditor
+};

package/dist/index.d.mts

@@ -2,6 +2,9 @@ import * as _tiptap_core from '@tiptap/core';
 import { Node, Attrs } from '@tiptap/pm/model';
 import { Selection } from '@tiptap/pm/state';
 import { Editor } from '@tiptap/react';
+export { useTiptapEditor } from './hooks/use-tiptap-editor.mjs';
+export { getSelectedBlockNodes, getSelectedNodesOfType, selectionWithinConvertibleTypes } from './selection.mjs';
+export { updateNodesAttr } from './update-node-attrs.mjs';
 
 type OverflowPosition = "none" | "top" | "bottom" | "both";
 declare function findParentNodeOfType(selection: Selection, typeName: string): {

package/dist/index.d.ts

@@ -2,6 +2,9 @@ import * as _tiptap_core from '@tiptap/core';
 import { Node, Attrs } from '@tiptap/pm/model';
 import { Selection } from '@tiptap/pm/state';
 import { Editor } from '@tiptap/react';
+export { useTiptapEditor } from './hooks/use-tiptap-editor.js';
+export { getSelectedBlockNodes, getSelectedNodesOfType, selectionWithinConvertibleTypes } from './selection.js';
+export { updateNodesAttr } from './update-node-attrs.js';
 
 type OverflowPosition = "none" | "top" | "bottom" | "both";
 declare function findParentNodeOfType(selection: Selection, typeName: string): {

package/dist/index.js

@@ -27,16 +27,153 @@ __export(index_exports, {
   getActiveMarkAttrs: () => getActiveMarkAttrs,
   getEditorExtension: () => getEditorExtension,
   getElementOverflowPosition: () => getElementOverflowPosition,
+  getSelectedBlockNodes: () => getSelectedBlockNodes,
+  getSelectedNodesOfType: () => getSelectedNodesOfType,
   hasContentAbove: () => hasContentAbove,
   isEmptyNode: () => isEmptyNode,
   isExtensionAvailable: () => isExtensionAvailable,
   isMarkInSchema: () => isMarkInSchema,
   isNodeInSchema: () => isNodeInSchema,
   isNodeTypeSelected: () => isNodeTypeSelected,
-  isValidPosition: () => isValidPosition
+  isValidPosition: () => isValidPosition,
+  selectionWithinConvertibleTypes: () => selectionWithinConvertibleTypes,
+  updateNodesAttr: () => updateNodesAttr,
+  useTiptapEditor: () => useTiptapEditor
 });
 module.exports = __toCommonJS(index_exports);
+var import_state2 = require("@tiptap/pm/state");
+
+// src/hooks/use-tiptap-editor.ts
+var import_react = require("@tiptap/react");
+var import_react2 = require("react");
+function useTiptapEditor(providedEditor) {
+  const { editor: coreEditor } = (0, import_react.useCurrentEditor)();
+  const mainEditor = (0, import_react2.useMemo)(
+    () => providedEditor || coreEditor,
+    [providedEditor, coreEditor]
+  );
+  const editorState = (0, import_react.useEditorState)({
+    editor: mainEditor,
+    selector(context) {
+      if (!context.editor) {
+        return {
+          editor: null,
+          editorState: void 0,
+          canCommand: void 0
+        };
+      }
+      return {
+        editor: context.editor,
+        editorState: context.editor.state,
+        canCommand: context.editor.can
+      };
+    }
+  });
+  return editorState || { editor: null };
+}
+
+// src/selection.ts
 var import_state = require("@tiptap/pm/state");
+var import_tables = require("@tiptap/pm/tables");
+var import_react3 = require("@tiptap/react");
+function getSelectedBlockNodes(editor) {
+  const { doc } = editor.state;
+  const { from, to } = editor.state.selection;
+  const blocks = [];
+  const seen = /* @__PURE__ */ new Set();
+  doc.nodesBetween(from, to, (node, pos) => {
+    if (!node.isBlock) return;
+    if (!seen.has(pos)) {
+      seen.add(pos);
+      blocks.push(node);
+    }
+    return false;
+  });
+  return blocks;
+}
+function getSelectedNodesOfType(selection, allowedNodeTypes) {
+  const results = [];
+  const allowed = new Set(allowedNodeTypes);
+  if (selection instanceof import_tables.CellSelection) {
+    selection.forEachCell((node, pos) => {
+      if (allowed.has(node.type.name)) {
+        results.push({ node, pos });
+      }
+    });
+    return results;
+  }
+  if (selection instanceof import_state.NodeSelection) {
+    const { node, from: pos } = selection;
+    if (node && allowed.has(node.type.name)) {
+      results.push({ node, pos });
+    }
+    return results;
+  }
+  const { $anchor } = selection;
+  const cell = (0, import_tables.cellAround)($anchor);
+  if (cell) {
+    const cellNode = selection.$anchor.doc.nodeAt(cell.pos);
+    if (cellNode && allowed.has(cellNode.type.name)) {
+      results.push({ node: cellNode, pos: cell.pos });
+      return results;
+    }
+  }
+  const parentNode = (0, import_react3.findParentNodeClosestToPos)(
+    $anchor,
+    (node) => allowed.has(node.type.name)
+  );
+  if (parentNode) {
+    results.push({ node: parentNode.node, pos: parentNode.pos });
+  }
+  return results;
+}
+function selectionWithinConvertibleTypes(editor, types = []) {
+  var _a, _b;
+  if (!editor || types.length === 0) return false;
+  const { state } = editor;
+  const { selection } = state;
+  const allowed = new Set(types);
+  if (selection instanceof import_state.NodeSelection) {
+    const nodeType = (_b = (_a = selection.node) == null ? void 0 : _a.type) == null ? void 0 : _b.name;
+    return !!nodeType && allowed.has(nodeType);
+  }
+  if (selection instanceof import_state.TextSelection || selection instanceof import_state.AllSelection) {
+    let valid = true;
+    state.doc.nodesBetween(selection.from, selection.to, (node) => {
+      if (node.isTextblock && !allowed.has(node.type.name)) {
+        valid = false;
+        return false;
+      }
+      return valid;
+    });
+    return valid;
+  }
+  return false;
+}
+
+// src/update-node-attrs.ts
+function updateNodesAttr(tr, targets, attrName, next) {
+  if (!targets.length) return false;
+  let changed = false;
+  for (const { pos } of targets) {
+    const currentNode = tr.doc.nodeAt(pos);
+    if (!currentNode) continue;
+    const prevValue = currentNode.attrs[attrName];
+    const resolvedNext = typeof next === "function" ? next(prevValue) : next;
+    if (prevValue === resolvedNext) continue;
+    const nextAttrs = { ...currentNode.attrs };
+    if (resolvedNext === void 0) {
+      delete nextAttrs[attrName];
+    } else {
+      nextAttrs[attrName] = resolvedNext;
+    }
+    tr.setNodeMarkup(pos, void 0, nextAttrs);
+    changed = true;
+  }
+  return changed;
+}
+
+// src/index.ts
 function findParentNodeOfType(selection, typeName) {
   let depth = selection.$anchor.depth;
   while (depth > 0) {
@@ -117,7 +254,7 @@ function isNodeTypeSelected(editor, types = []) {
   const { state } = editor;
   const { selection } = state;
   if (selection.empty) return false;
-  if (selection instanceof import_state.NodeSelection) {
+  if (selection instanceof import_state2.NodeSelection) {
     const node = selection.node;
     return node ? types.includes(node.type.name) : false;
   }
@@ -184,11 +321,16 @@ function findSelectionPosition(params) {
   getActiveMarkAttrs,
   getEditorExtension,
   getElementOverflowPosition,
+  getSelectedBlockNodes,
+  getSelectedNodesOfType,
   hasContentAbove,
   isEmptyNode,
   isExtensionAvailable,
   isMarkInSchema,
   isNodeInSchema,
   isNodeTypeSelected,
-  isValidPosition
+  isValidPosition,
+  selectionWithinConvertibleTypes,
+  updateNodesAttr,
+  useTiptapEditor
 });

package/dist/index.mjs

@@ -1,4 +1,15 @@
 "use client";
+import {
+  getSelectedBlockNodes,
+  getSelectedNodesOfType,
+  selectionWithinConvertibleTypes
+} from "./chunk-ID5T7EEZ.mjs";
+import {
+  updateNodesAttr
+} from "./chunk-23NZ6BRW.mjs";
+import {
+  useTiptapEditor
+} from "./chunk-P55PLOHR.mjs";
 
 // src/index.ts
 import { NodeSelection } from "@tiptap/pm/state";
@@ -148,11 +159,16 @@ export {
   getActiveMarkAttrs,
   getEditorExtension,
   getElementOverflowPosition,
+  getSelectedBlockNodes,
+  getSelectedNodesOfType,
   hasContentAbove,
   isEmptyNode,
   isExtensionAvailable,
   isMarkInSchema,
   isNodeInSchema,
   isNodeTypeSelected,
-  isValidPosition
+  isValidPosition,
+  selectionWithinConvertibleTypes,
+  updateNodesAttr,
+  useTiptapEditor
 };

package/dist/selection.d.mts

@@ -0,0 +1,22 @@
+import { Node } from '@tiptap/pm/model';
+import { Selection } from '@tiptap/pm/state';
+import { Editor, NodeWithPos } from '@tiptap/react';
+
+declare function getSelectedBlockNodes(editor: Editor): Node[];
+/**
+ * Retrieves all nodes of specified types from the current selection.
+ * @param selection The current editor selection
+ * @param allowedNodeTypes An array of node type names to look for (e.g., ["image", "table"])
+ * @returns An array of objects containing the node and its position
+ */
+declare function getSelectedNodesOfType(selection: Selection, allowedNodeTypes: string[]): NodeWithPos[];
+/**
+ * Check whether the current selection is fully within nodes
+ * whose type names are in the provided `types` list.
+ *
+ * - NodeSelection → checks the selected node.
+ * - Text/AllSelection → ensures all textblocks within [from, to) are allowed.
+ */
+declare function selectionWithinConvertibleTypes(editor: Editor, types?: string[]): boolean;
+
+export { getSelectedBlockNodes, getSelectedNodesOfType, selectionWithinConvertibleTypes };

package/dist/selection.d.ts

@@ -0,0 +1,22 @@
+import { Node } from '@tiptap/pm/model';
+import { Selection } from '@tiptap/pm/state';
+import { Editor, NodeWithPos } from '@tiptap/react';
+
+declare function getSelectedBlockNodes(editor: Editor): Node[];
+/**
+ * Retrieves all nodes of specified types from the current selection.
+ * @param selection The current editor selection
+ * @param allowedNodeTypes An array of node type names to look for (e.g., ["image", "table"])
+ * @returns An array of objects containing the node and its position
+ */
+declare function getSelectedNodesOfType(selection: Selection, allowedNodeTypes: string[]): NodeWithPos[];
+/**
+ * Check whether the current selection is fully within nodes
+ * whose type names are in the provided `types` list.
+ *
+ * - NodeSelection → checks the selected node.
+ * - Text/AllSelection → ensures all textblocks within [from, to) are allowed.
+ */
+declare function selectionWithinConvertibleTypes(editor: Editor, types?: string[]): boolean;
+
+export { getSelectedBlockNodes, getSelectedNodesOfType, selectionWithinConvertibleTypes };

package/dist/selection.js

@@ -0,0 +1,111 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/selection.ts
+var selection_exports = {};
+__export(selection_exports, {
+  getSelectedBlockNodes: () => getSelectedBlockNodes,
+  getSelectedNodesOfType: () => getSelectedNodesOfType,
+  selectionWithinConvertibleTypes: () => selectionWithinConvertibleTypes
+});
+module.exports = __toCommonJS(selection_exports);
+var import_state = require("@tiptap/pm/state");
+var import_tables = require("@tiptap/pm/tables");
+var import_react = require("@tiptap/react");
+function getSelectedBlockNodes(editor) {
+  const { doc } = editor.state;
+  const { from, to } = editor.state.selection;
+  const blocks = [];
+  const seen = /* @__PURE__ */ new Set();
+  doc.nodesBetween(from, to, (node, pos) => {
+    if (!node.isBlock) return;
+    if (!seen.has(pos)) {
+      seen.add(pos);
+      blocks.push(node);
+    }
+    return false;
+  });
+  return blocks;
+}
+function getSelectedNodesOfType(selection, allowedNodeTypes) {
+  const results = [];
+  const allowed = new Set(allowedNodeTypes);
+  if (selection instanceof import_tables.CellSelection) {
+    selection.forEachCell((node, pos) => {
+      if (allowed.has(node.type.name)) {
+        results.push({ node, pos });
+      }
+    });
+    return results;
+  }
+  if (selection instanceof import_state.NodeSelection) {
+    const { node, from: pos } = selection;
+    if (node && allowed.has(node.type.name)) {
+      results.push({ node, pos });
+    }
+    return results;
+  }
+  const { $anchor } = selection;
+  const cell = (0, import_tables.cellAround)($anchor);
+  if (cell) {
+    const cellNode = selection.$anchor.doc.nodeAt(cell.pos);
+    if (cellNode && allowed.has(cellNode.type.name)) {
+      results.push({ node: cellNode, pos: cell.pos });
+      return results;
+    }
+  }
+  const parentNode = (0, import_react.findParentNodeClosestToPos)(
+    $anchor,
+    (node) => allowed.has(node.type.name)
+  );
+  if (parentNode) {
+    results.push({ node: parentNode.node, pos: parentNode.pos });
+  }
+  return results;
+}
+function selectionWithinConvertibleTypes(editor, types = []) {
+  var _a, _b;
+  if (!editor || types.length === 0) return false;
+  const { state } = editor;
+  const { selection } = state;
+  const allowed = new Set(types);
+  if (selection instanceof import_state.NodeSelection) {
+    const nodeType = (_b = (_a = selection.node) == null ? void 0 : _a.type) == null ? void 0 : _b.name;
+    return !!nodeType && allowed.has(nodeType);
+  }
+  if (selection instanceof import_state.TextSelection || selection instanceof import_state.AllSelection) {
+    let valid = true;
+    state.doc.nodesBetween(selection.from, selection.to, (node) => {
+      if (node.isTextblock && !allowed.has(node.type.name)) {
+        valid = false;
+        return false;
+      }
+      return valid;
+    });
+    return valid;
+  }
+  return false;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  getSelectedBlockNodes,
+  getSelectedNodesOfType,
+  selectionWithinConvertibleTypes
+});

package/dist/selection.mjs

@@ -0,0 +1,11 @@
+"use client";
+import {
+  getSelectedBlockNodes,
+  getSelectedNodesOfType,
+  selectionWithinConvertibleTypes
+} from "./chunk-ID5T7EEZ.mjs";
+export {
+  getSelectedBlockNodes,
+  getSelectedNodesOfType,
+  selectionWithinConvertibleTypes
+};

package/dist/update-node-attrs.d.mts

@@ -0,0 +1,16 @@
+import { Transaction } from '@tiptap/pm/state';
+import { NodeWithPos } from '@tiptap/react';
+
+/**
+ * Update a single attribute on multiple nodes.
+ *
+ * @param tr - The transaction to mutate
+ * @param targets - Array of { node, pos }
+ * @param attrName - Attribute key to update
+ * @param next - New value OR updater function receiving previous value
+ *               Pass `undefined` to remove the attribute.
+ * @returns true if at least one node was updated, false otherwise
+ */
+declare function updateNodesAttr<A extends string = string, V = unknown>(tr: Transaction, targets: readonly NodeWithPos[], attrName: A, next: V | ((prev: V | undefined) => V | undefined)): boolean;
+
+export { updateNodesAttr };

package/dist/update-node-attrs.d.ts

@@ -0,0 +1,16 @@
+import { Transaction } from '@tiptap/pm/state';
+import { NodeWithPos } from '@tiptap/react';
+
+/**
+ * Update a single attribute on multiple nodes.
+ *
+ * @param tr - The transaction to mutate
+ * @param targets - Array of { node, pos }
+ * @param attrName - Attribute key to update
+ * @param next - New value OR updater function receiving previous value
+ *               Pass `undefined` to remove the attribute.
+ * @returns true if at least one node was updated, false otherwise
+ */
+declare function updateNodesAttr<A extends string = string, V = unknown>(tr: Transaction, targets: readonly NodeWithPos[], attrName: A, next: V | ((prev: V | undefined) => V | undefined)): boolean;
+
+export { updateNodesAttr };

package/dist/update-node-attrs.js

@@ -0,0 +1,50 @@
+"use client";
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/update-node-attrs.ts
+var update_node_attrs_exports = {};
+__export(update_node_attrs_exports, {
+  updateNodesAttr: () => updateNodesAttr
+});
+module.exports = __toCommonJS(update_node_attrs_exports);
+function updateNodesAttr(tr, targets, attrName, next) {
+  if (!targets.length) return false;
+  let changed = false;
+  for (const { pos } of targets) {
+    const currentNode = tr.doc.nodeAt(pos);
+    if (!currentNode) continue;
+    const prevValue = currentNode.attrs[attrName];
+    const resolvedNext = typeof next === "function" ? next(prevValue) : next;
+    if (prevValue === resolvedNext) continue;
+    const nextAttrs = { ...currentNode.attrs };
+    if (resolvedNext === void 0) {
+      delete nextAttrs[attrName];
+    } else {
+      nextAttrs[attrName] = resolvedNext;
+    }
+    tr.setNodeMarkup(pos, void 0, nextAttrs);
+    changed = true;
+  }
+  return changed;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  updateNodesAttr
+});

package/dist/update-node-attrs.mjs

@@ -0,0 +1,7 @@
+"use client";
+import {
+  updateNodesAttr
+} from "./chunk-23NZ6BRW.mjs";
+export {
+  updateNodesAttr
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kopexa/editor-utils",
-  "version": "17.0.46",
+  "version": "17.1.0",
   "description": "utility components for our editor",
   "keywords": [
     "editor-utils"
@@ -25,16 +25,16 @@
     "url": "https://github.com/kopexa-grc/sight/issues"
   },
   "peerDependencies": {
+    "@tiptap/pm": "^3.20.0",
+    "@tiptap/react": "^3.20.0",
     "motion": ">=12.23.6",
     "react": ">=19.0.0-rc.0",
     "react-dom": ">=19.0.0-rc.0",
-    "@kopexa/theme": "17.22.7"
+    "@kopexa/theme": "17.23.0"
   },
   "dependencies": {
-    "@tiptap/pm": "^3.20.0",
-    "@tiptap/react": "^3.20.0",
-    "@kopexa/react-utils": "17.0.46",
-    "@kopexa/shared-utils": "17.0.46"
+    "@kopexa/react-utils": "17.0.49",
+    "@kopexa/shared-utils": "17.0.49"
   },
   "clean-package": "../../../clean-package.config.json",
   "module": "dist/index.mjs",