@prosekit/core 0.2.5 → 0.2.6

package/dist/_tsup-dts-rollup.d.ts

@@ -41,7 +41,9 @@ declare type Action = (options: {
 }) => boolean;
 
 /**
- * Add the given mark to the inline content.
+ * Returns a command that adds the given mark with the given attributes.
+ *
+ * @public
  */
 declare function addMark(options: {
     /**
@@ -241,6 +243,11 @@ declare function defineBaseCommands(): Extension<{
             from?: number | undefined;
             to?: number | undefined;
         }];
+        setNodeAttrs: [options: {
+            type: string | NodeType_2;
+            attrs: Attrs_2;
+            pos?: number | undefined;
+        }];
         selectAll: [];
         addMark: [options: {
             type: string | MarkType_2;
@@ -748,6 +755,12 @@ declare function getNodeType(schema: Schema, type: string | NodeType): NodeType;
 export { getNodeType }
 export { getNodeType as getNodeType_alias_1 }
 
+/**
+ * Returns a command that inserts the given node at the current selection or at
+ * the given position.
+ *
+ * @public
+ */
 declare function insertNode(options: {
     node: ProseMirrorNode;
     pos?: number;
@@ -767,6 +780,11 @@ export declare function insertNodeAction({ node, pos, }: {
     pos?: number;
 }): Action;
 
+/**
+ * Returns a command that inserts the given text.
+ *
+ * @public
+ */
 export declare function insertText({ text, from, to, }: {
     text: string;
     from?: number;
@@ -1111,7 +1129,9 @@ export { ProseKitError }
 export { ProseKitError as ProseKitError_alias_1 }
 
 /**
- * Remove the given mark from the inline content.
+ * Returns a command that removes the given mark.
+ *
+ * @public
  */
 declare function removeMark(options: {
     /**
@@ -1138,6 +1158,11 @@ export declare const schemaFacet: Facet<SchemaPayload, SchemaPayload>;
 
 export declare type SchemaPayload = SchemaSpec;
 
+/**
+ * Returns a command that selects the whole document.
+ *
+ * @public
+ */
 export declare function selectAll(): Command;
 
 /**
@@ -1156,6 +1181,8 @@ export { SelectionJSON as SelectionJSON_alias_1 }
 /**
  * Returns a command that tries to set the selected textblocks to the given node
  * type with the given attributes.
+ *
+ * @public
  */
 declare function setBlockType(options: {
     type: NodeType | string;
@@ -1166,6 +1193,31 @@ declare function setBlockType(options: {
 export { setBlockType }
 export { setBlockType as setBlockType_alias_1 }
 
+/**
+ * Returns a command that set the attributes of the current node.
+ *
+ * @public
+ */
+declare function setNodeAttrs(options: {
+    /**
+     * The type of node to set the attributes of.
+     *
+     * If current node is not of this type, the command will do nothing.
+     */
+    type: string | NodeType;
+    /**
+     * The attributes to set.
+     */
+    attrs: Attrs;
+    /**
+     * The position of the node. Defaults to the position of the wrapping node
+     * containing the current selection.
+     */
+    pos?: number;
+}): Command;
+export { setNodeAttrs }
+export { setNodeAttrs as setNodeAttrs_alias_1 }
+
 export declare function setSelectionAround(tr: Transaction, pos: number): void;
 
 /**
@@ -1231,6 +1283,11 @@ export declare type ToCommandCreators<T extends CommandArgs> = {
     [K in keyof T]: CommandCreator<T[K]>;
 };
 
+/**
+ * Returns a command that toggles the given mark with the given attributes.
+ *
+ * @public
+ */
 declare function toggleMark({ type, attrs, }: {
     type: string | MarkType;
     attrs?: Attrs | null;
@@ -1238,6 +1295,12 @@ declare function toggleMark({ type, attrs, }: {
 export { toggleMark }
 export { toggleMark as toggleMark_alias_1 }
 
+/**
+ * Returns a command that set the selected textblocks to the given node type
+ * with the given attributes.
+ *
+ * @public
+ */
 declare function toggleNode({ type, attrs, }: {
     type: string | NodeType;
     attrs?: Attrs | null;
@@ -1317,6 +1380,12 @@ declare function withSkipCodeBlock(command: Command): Command;
 export { withSkipCodeBlock }
 export { withSkipCodeBlock as withSkipCodeBlock_alias_1 }
 
+/**
+ * Returns a command that wraps the selected textblock with the given node type
+ * with the given attributes.
+ *
+ * @public
+ */
 export declare function wrap({ nodeType, attrs, }: {
     nodeType: NodeType;
     attrs?: Attrs | null;

package/dist/prosekit-core.d.ts

@@ -2,6 +2,7 @@ export { addMark } from './_tsup-dts-rollup';
 export { insertNode } from './_tsup-dts-rollup';
 export { removeMark } from './_tsup-dts-rollup';
 export { setBlockType } from './_tsup-dts-rollup';
+export { setNodeAttrs } from './_tsup-dts-rollup';
 export { toggleMark } from './_tsup-dts-rollup';
 export { toggleNode } from './_tsup-dts-rollup';
 export { Editor } from './_tsup-dts-rollup';

package/dist/prosekit-core.js

@@ -161,6 +161,29 @@ function setBlockType(options) {
   };
 }
 
+// src/commands/set-node-attrs.ts
+function setNodeAttrs(options) {
+  return (state, dispatch) => {
+    var _a;
+    const nodeType = getNodeType(state.schema, options.type);
+    const pos = (_a = options.pos) != null ? _a : state.selection.$from.before();
+    const node = state.doc.nodeAt(pos);
+    if (!node || node.type !== nodeType) {
+      return false;
+    }
+    if (dispatch) {
+      const { tr } = state;
+      for (const [key, value] of Object.entries(options.attrs)) {
+        if (value !== void 0) {
+          tr.setNodeAttribute(pos, key, value);
+        }
+      }
+      dispatch(tr);
+    }
+    return true;
+  };
+}
+
 // src/commands/toggle-mark.ts
 import { toggleMark as baseToggleMark } from "@prosekit/pm/commands";
 import "@prosekit/pm/model";
@@ -1127,6 +1150,7 @@ function defineBaseCommands() {
     insertNode,
     wrap,
     setBlockType,
+    setNodeAttrs,
     selectAll,
     addMark,
     removeMark
@@ -1751,6 +1775,7 @@ export {
   pluginFacet,
   removeMark,
   setBlockType,
+  setNodeAttrs,
   stateFromJSON,
   toggleMark,
   toggleNode,

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@prosekit/core",
   "type": "module",
-  "version": "0.2.5",
+  "version": "0.2.6",
   "private": false,
   "author": {
     "name": "ocavue",

package/src/index.ts

@@ -2,6 +2,7 @@ export { addMark } from './commands/add-mark'
 export { insertNode } from './commands/insert-node'
 export { removeMark } from './commands/remove-mark'
 export { setBlockType } from './commands/set-block-type'
+export { setNodeAttrs } from './commands/set-node-attrs'
 export { toggleMark } from './commands/toggle-mark'
 export { toggleNode } from './commands/toggle-node'
 export { Editor, createEditor, type EditorOptions } from './editor/editor'