🤖 Merge PR DefinitelyTyped#73749 [@wordpress/block-editor] Add blockParent selectors by @joshualip-plaudit

Author: joshualip-plaudit

types/wordpress__block-editor/package.json

@@ -1,17 +1,17 @@
 {
     "private": true,
     "name": "@types/wordpress__block-editor",
-    "version": "11.5.9999",
+    "version": "14.21.9999",
     "projects": [
         "https://github.com/WordPress/gutenberg/tree/master/packages/block-editor/README.md"
     ],
     "dependencies": {
         "@types/react": "^18",
         "@types/wordpress__blocks": "*",
-        "@wordpress/components": "^27.2.0",
-        "@wordpress/data": "^9.13.0",
-        "@wordpress/element": "^5.0.0",
-        "@wordpress/keycodes": "^3.54.0",
+        "@wordpress/components": "^29.12.0",
+        "@wordpress/data": "^10.26.0",
+        "@wordpress/element": "^6.26.0",
+        "@wordpress/keycodes": "^4.26.0",
         "react-autosize-textarea": "^7.1.0"
     },
     "devDependencies": {
@@ -29,6 +29,10 @@
         {
             "name": "Dennis Snell",
             "githubUsername": "dmsnell"
+        },
+        {
+            "name": "Joshua Lipstone",
+            "githubUsername": "joshualip-plaudit"
         }
     ]
 }

types/wordpress__block-editor/store/selectors.d.ts

@@ -118,6 +118,31 @@ export function getBlockName(clientId: string): string | null;
  */
 export function getBlockOrder(rootClientId?: string): string[];
 
+/**
+ * Returns a block's parents' client IDs given its client ID
+ *
+ * @param clientId - Block client ID.
+ * @param ascending - If true, the client ids will be returned from closest to farthest instead of the default of farthest to closest
+ *
+ * @returns The client IDs of all parent blocks
+ */
+export function getBlockParents(clientId: string, ascending?: boolean): string[];
+
+/**
+ * Returns a block's parents' client IDs given its client ID pre-filtered to only include blocks with the passed blockNames
+ *
+ * @param clientId - Block client ID.
+ * @param blockName - the name or names of the block types to which the parents list should be filtered
+ * @param ascending - If true, the client ids will be returned from closest to farthest instead of the default of farthest to closest
+ *
+ * @returns The client IDs of all parent blocks filtered by the passed block name or names
+ */
+export function getBlockParentsByBlockName(
+    clientId: string,
+    blockName: string | string[],
+    ascending?: boolean,
+): string[];
+
 /**
  * Given a block client ID, returns the root block from which the block is nested, an empty string
  * for top-level blocks, or `null` if the block does not exist.

types/wordpress__block-editor/wordpress__block-editor-tests.tsx

@@ -566,6 +566,12 @@ select("core/block-editor").getAdjacentBlockClientId("foo");
 select("core/block-editor").getAdjacentBlockClientId("foo", -1);
 select("core/block-editor").getAdjacentBlockClientId("foo", 1);
 
+// $ExpectType string[]
+select("core/block-editor").getBlockParents("foo");
+select("core/block-editor").getBlockParentsByBlockName("foo", ["core/query"]);
+select("core/block-editor").getBlockParents("foo", true);
+select("core/block-editor").getBlockParentsByBlockName("foo", ["core/query"], true);
+
 {
     const blockProps: UseBlockProps.Merged & UseBlockProps.Reserved = be.useBlockProps();
     blockProps;