feat: enable resolveFields to access parent data

apps/docs/pages/docs/api-reference/configuration/component-config.mdx

@@ -414,10 +414,10 @@ const config = {
 
 #### Args
 
-| Prop     | Example                                                                   | Type   |
-| -------- | ------------------------------------------------------------------------- | ------ |
-| `data`   | `{ props: { title: "Hello, world" }, readOnly: {} }`                      | Object |
-| `params` | `{ appState: {}, changed: {}, fields: {}, lastData: {}, lastFields: {} }` | Object |
+| Prop     | Example                                                                               | Type   |
+| -------- | ------------------------------------------------------------------------------------- | ------ |
+| `data`   | `{ props: { title: "Hello, world" }, readOnly: {} }`                                  | Object |
+| `params` | `{ appState: {}, changed: {}, fields: {}, lastData: {}, lastFields: {}, parent: {} }` | Object |
 
 ##### `data.props`
 
@@ -461,6 +461,10 @@ The data object from the previous run of this function.
 
 The last fields object created by the previous run of this function.
 
+##### `params.parent`
+
+The parent data object if this item is within a [DropZone](/docs/api-reference/components/drop-zone).
+
 ### `resolvePermissions(data, params)`
 
 Dynamically set the [permissions](/docs/api-reference/permissions) for this component to toggle functionality. Can be used to control the permissions on a specific component instance. Inherits [`permissions`](#permissions). Supports asynchronous calls.

packages/core/components/Puck/components/Fields/index.tsx

@@ -16,6 +16,7 @@ import { getClassNameFactory } from "../../../../lib";
 import { ReactNode, useCallback, useEffect, useMemo, useState } from "react";
 import { ItemSelector } from "../../../../lib/get-item";
 import { getChanged } from "../../../../lib/get-changed";
+import { useParent } from "../../../../lib/use-parent";
 
 const getClassName = getClassNameFactory("PuckFields", styles);
 
@@ -37,6 +38,7 @@ type ComponentOrRootData = Omit<ComponentData<any>, "type">;
 
 const useResolvedFields = (): [FieldsType, boolean] => {
   const { selectedItem, state, config } = useAppContext();
+  const parent = useParent();
 
   const { data } = state;
 
@@ -101,6 +103,7 @@ const useResolvedFields = (): [FieldsType, boolean] => {
             lastFields: resolvedFields,
             lastData: lastData as ComponentData,
             appState: state,
+            parent,
           }
         );
       }
@@ -112,6 +115,7 @@ const useResolvedFields = (): [FieldsType, boolean] => {
           lastFields: resolvedFields,
           lastData: lastData as RootData,
           appState: state,
+          parent,
         });
       }
 

packages/core/lib/use-parent.ts

@@ -0,0 +1,19 @@
+import { useContext } from "react";
+import { useAppContext } from "../components/Puck/context";
+import { getItem, ItemSelector } from "./get-item";
+import { dropZoneContext } from "../components/DropZone";
+import { convertPathDataToBreadcrumbs } from "./use-breadcrumbs";
+
+export const useParent = (itemSelector?: ItemSelector) => {
+  const { selectedItem, state } = useAppContext();
+  const { pathData } = useContext(dropZoneContext) || {};
+  const item = itemSelector ? getItem(itemSelector, state.data) : selectedItem;
+  const breadcrumbs = convertPathDataToBreadcrumbs(item, pathData, state.data);
+
+  const lastItem = breadcrumbs[breadcrumbs.length - 1];
+  const parent = lastItem?.selector
+    ? getItem(lastItem.selector, state.data) ?? null
+    : null;
+
+  return parent || null;
+};

packages/core/types/Config.tsx

@@ -28,6 +28,7 @@ export type ComponentConfig<
       lastFields: Fields<FieldProps>;
       lastData: DataShape | null;
       appState: AppState;
+      parent: ComponentData | null;
     }
   ) => Promise<Fields<FieldProps>> | Fields<FieldProps>;
   resolveData?: (