feat: Adds property typing for an object attribute

.changeset/brave-dragons-laugh.md

@@ -0,0 +1,58 @@
+---
+"@wpengine/wp-graphql-content-blocks": minor
+---
+
+Adds support for specifying typed and queryable properties for object attributes in block.json.
+
+Example: Defining a Typed Object in `block.json`:
+
+```json
+"attributes": {
+  "film": {
+    "type": "object",
+    "default": {
+      "id": 0,
+      "title": "Film Title",
+      "director": "Director Name",
+      "__typed": {
+        "id": "integer",
+        "title": "string",
+        "director": "string",
+        "year": "string"
+      }
+    }
+  }
+}
+```
+
+In this example, the `film` attribute is an object with defined types for each property (`id`, `title`, `director`, and optionally `year`).
+
+Querying Object Properties in GraphQL:
+
+
+```graphql
+fragment Film on MyPluginFilmBlock {
+    attributes {
+        film {
+            id,
+            title,
+            director,
+            year
+        }
+    },
+}
+
+query GetAllPostsWhichSupportBlockEditor {
+    posts {
+        edges {
+            node {
+                editorBlocks {
+                    __typename
+                    name
+                    ...Film
+                }
+            }
+        }
+    }
+}
+```

README.md

@@ -86,6 +86,64 @@ If the resolved block has values for those fields, it will return them, otherwis
 }
 ```
 
+## Querying Object Types with Typed Properties
+
+You can now query object-type block attributes with each property, provided the `__typed` structure is defined in the block's JSON configuration. 
+This allows you to query individual properties of the object for finer control and enhanced usability.
+
+Example: Defining a Typed Object in `block.json`:
+
+```json
+"attributes": {
+  "film": {
+    "type": "object",
+    "default": {
+      "id": 0,
+      "title": "Film Title",
+      "director": "Director Name",
+      "__typed": {
+        "id": "integer",
+        "title": "string",
+        "director": "string",
+        "year": "string"
+      }
+    }
+  }
+}
+```
+
+In this example, the `film` attribute is an object with defined types for each property (`id`, `title`, `director`, and optionally `year`).
+
+Querying Object Properties in GraphQL:
+
+
+```graphql
+fragment Film on MyPluginFilmBlock {
+    attributes {
+        film {
+            id,
+            title,
+            director,
+            year
+        }
+    },
+}
+
+query GetAllPostsWhichSupportBlockEditor {
+    posts {
+        edges {
+            node {
+                editorBlocks {
+                    __typename
+                    name
+                    ...Film
+                }
+            }
+        }
+    }
+}
+```
+
 ## What about innerBlocks?
 
 In order to facilitate querying `innerBlocks` fields more efficiently you want to use `editorBlocks(flat: true)` instead of `editorBlocks`.