prosemirror-view 1.32.7 → 1.33.1

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+## 1.33.1 (2024-02-15)
+
+### Bug fixes
+
+Fix a type error in the published type declarations in 1.33.0.
+
+## 1.33.0 (2024-02-15)
+
+### New features
+
+The `DecorationSource.forChild` method is now public.
+
 ## 1.32.7 (2023-12-18)
 
 ### Bug fixes

package/dist/index.d.cts

@@ -75,8 +75,8 @@ declare class Decoration {
         */
         key?: string;
         /**
-        Called when the widget decoration is removed as a result of
-        mapping
+        Called when the widget decoration is removed or the editor is
+        destroyed.
         */
         destroy?: (node: DOMNode) => void;
         /**
@@ -156,6 +156,10 @@ interface DecorationSource {
     document.
     */
     map: (mapping: Mapping, node: Node) => DecorationSource;
+    /**
+    Extract a DecorationSource containing decorations for the given child node at the given offset.
+    */
+    forChild(offset: number, child: Node): DecorationSource;
 }
 /**
 A collection of [decorations](https://prosemirror.net/docs/ref/#view.Decoration), organized in such
@@ -206,11 +210,21 @@ declare class DecorationSet implements DecorationSource {
     */
     remove(decorations: Decoration[]): DecorationSet;
     private removeInner;
+    forChild(offset: number, node: Node): DecorationSet | DecorationGroup;
     /**
     The empty set of decorations.
     */
     static empty: DecorationSet;
 }
+declare class DecorationGroup implements DecorationSource {
+    readonly members: readonly DecorationSet[];
+    constructor(members: readonly DecorationSet[]);
+    map(mapping: Mapping, doc: Node): DecorationSource;
+    forChild(offset: number, child: Node): DecorationSource | DecorationSet;
+    eq(other: DecorationGroup): boolean;
+    locals(node: Node): readonly any[];
+    static from(members: readonly DecorationSource[]): DecorationSource;
+}
 
 declare global {
     interface Node {

package/dist/index.d.ts

@@ -75,8 +75,8 @@ declare class Decoration {
         */
         key?: string;
         /**
-        Called when the widget decoration is removed as a result of
-        mapping
+        Called when the widget decoration is removed or the editor is
+        destroyed.
         */
         destroy?: (node: DOMNode) => void;
         /**
@@ -156,6 +156,10 @@ interface DecorationSource {
     document.
     */
     map: (mapping: Mapping, node: Node) => DecorationSource;
+    /**
+    Extract a DecorationSource containing decorations for the given child node at the given offset.
+    */
+    forChild(offset: number, child: Node): DecorationSource;
 }
 /**
 A collection of [decorations](https://prosemirror.net/docs/ref/#view.Decoration), organized in such
@@ -206,11 +210,21 @@ declare class DecorationSet implements DecorationSource {
     */
     remove(decorations: Decoration[]): DecorationSet;
     private removeInner;
+    forChild(offset: number, node: Node): DecorationSet | DecorationGroup;
     /**
     The empty set of decorations.
     */
     static empty: DecorationSet;
 }
+declare class DecorationGroup implements DecorationSource {
+    readonly members: readonly DecorationSet[];
+    constructor(members: readonly DecorationSet[]);
+    map(mapping: Mapping, doc: Node): DecorationSource;
+    forChild(offset: number, child: Node): DecorationSource | DecorationSet;
+    eq(other: DecorationGroup): boolean;
+    locals(node: Node): readonly any[];
+    static from(members: readonly DecorationSource[]): DecorationSource;
+}
 
 declare global {
     interface Node {

package/dist/index.js

@@ -4022,9 +4022,6 @@ class DecorationSet {
             return this;
         return local.length || children.length ? new DecorationSet(local, children) : empty;
     }
-    /**
-    @internal
-    */
     forChild(offset, node) {
         if (this == empty)
             return this;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "prosemirror-view",
-  "version": "1.32.7",
+  "version": "1.33.1",
   "description": "ProseMirror's view component",
   "type": "module",
   "main": "dist/index.cjs",

package/src/decoration.ts

@@ -179,8 +179,8 @@ export class Decoration {
     /// different keys.
     key?: string
 
-    /// Called when the widget decoration is removed as a result of
-    /// mapping
+    /// Called when the widget decoration is removed or the editor is
+    /// destroyed.
     destroy?: (node: DOMNode) => void
 
     /// Specs allow arbitrary additional properties.
@@ -258,7 +258,7 @@ export interface DecorationSource {
   map: (mapping: Mapping, node: Node) => DecorationSource
   /// @internal
   locals(node: Node): readonly Decoration[]
-  /// @internal
+  /// Extract a DecorationSource containing decorations for the given child node at the given offset.
   forChild(offset: number, child: Node): DecorationSource
   /// @internal
   eq(other: DecorationSource): boolean
@@ -413,7 +413,6 @@ export class DecorationSet implements DecorationSource {
     return local.length || children.length ? new DecorationSet(local, children) : empty
   }
 
-  /// @internal
   forChild(offset: number, node: Node): DecorationSet | DecorationGroup {
     if (this == empty) return this
     if (node.isLeaf) return DecorationSet.empty