@measured/puck 0.19.0-canary.32a6f78 → 0.19.0-canary.46835fd

package/dist/{chunk-FNRHXUGA.mjs → chunk-7N5DRY4G.mjs}

@@ -91,6 +91,49 @@ var init_react_import = __esm({
   }
 });
 
+// lib/transform-props.ts
+init_react_import();
+
+// lib/default-data.ts
+init_react_import();
+var defaultData = (data) => __spreadProps(__spreadValues({}, data), {
+  root: data.root || {},
+  content: data.content || []
+});
+
+// lib/transform-props.ts
+function transformProps(data, propTransforms) {
+  const mapItem = (item) => {
+    if (propTransforms[item.type]) {
+      return __spreadProps(__spreadValues({}, item), {
+        props: propTransforms[item.type](item.props)
+      });
+    }
+    return item;
+  };
+  const defaultedData = defaultData(data);
+  const rootProps = defaultedData.root.props || defaultedData.root;
+  let newRoot = __spreadValues({}, defaultedData.root);
+  if (propTransforms["root"]) {
+    if (defaultedData.root.props) {
+      newRoot.props = propTransforms["root"](rootProps);
+    } else {
+      newRoot = propTransforms["root"](rootProps);
+    }
+  }
+  const afterPropTransforms = __spreadProps(__spreadValues({}, defaultedData), {
+    root: newRoot,
+    content: defaultedData.content.map(mapItem),
+    zones: Object.keys(data.zones || {}).reduce(
+      (acc, zoneKey) => __spreadProps(__spreadValues({}, acc), {
+        [zoneKey]: data.zones[zoneKey].map(mapItem)
+      }),
+      {}
+    )
+  });
+  return afterPropTransforms;
+}
+
 // lib/resolve-all-data.ts
 init_react_import();
 
@@ -187,13 +230,6 @@ function resolveRootData(data, config, metadata) {
   });
 }
 
-// lib/default-data.ts
-init_react_import();
-var defaultData = (data) => __spreadProps(__spreadValues({}, data), {
-  root: data.root || {},
-  content: data.content || []
-});
-
 // lib/resolve-all-data.ts
 function resolveAllData(_0, _1) {
   return __async(this, arguments, function* (data, config, metadata = {}, onResolveStart, onResolveEnd) {
@@ -232,7 +268,9 @@ function resolveAllData(_0, _1) {
 
 // lib/root-droppable-id.ts
 init_react_import();
-var rootDroppableId = "default-zone";
+var rootAreaId = "root";
+var rootZone = "default-zone";
+var rootDroppableId = `${rootAreaId}:${rootZone}`;
 
 // lib/setup-zone.ts
 init_react_import();
@@ -258,11 +296,13 @@ export {
   __privateSet,
   __async,
   init_react_import,
+  rootAreaId,
+  rootZone,
   rootDroppableId,
   setupZone,
   getChanged,
   resolveComponentData,
   resolveRootData,
-  defaultData,
+  transformProps,
   resolveAllData
 };

package/dist/index.css

@@ -612,6 +612,19 @@ textarea._Input-input_g5w3n_26 {
   }
 }
 
+/* components/Sortable/styles.css */
+[data-dnd-placeholder] * {
+  opacity: 0 !important;
+}
+[data-dnd-placeholder] {
+  background: var(--puck-color-azure-09) !important;
+  border: none !important;
+  color: #00000000 !important;
+  opacity: 0.3 !important;
+  outline: none !important;
+  transition: none !important;
+}
+
 /* css-module:/home/runner/work/puck/puck/packages/core/components/ExternalInput/styles.module.css/#css-module-data */
 ._ExternalInput-actions_91ls0_1 {
   display: flex;

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { F as FieldProps, a as Field, D as DropZoneProps, C as Config, U as UserGenerics, b as Data, c as UiState, O as OnAction, P as Permissions, d as Plugin, e as Overrides, f as PuckAction, V as Viewports, I as IframeConfig, g as InitialHistory, M as Metadata, h as DefaultComponentProps, i as DefaultRootFieldProps, H as History, A as AppState, E as ExtractPropsFromConfig, j as ExtractRootPropsFromConfig, k as ComponentDataMap } from './resolve-all-data-D43Z4niC.mjs';
-export { W as Adaptor, L as ArrayField, s as ArrayState, a4 as AsFieldProps, B as BaseData, G as BaseField, u as ComponentConfig, x as ComponentData, z as Content, Z as CustomField, a1 as DefaultRootProps, a0 as DefaultRootRenderProps, l as Direction, m as DragAxis, Y as ExternalField, X as ExternalFieldWithAdaptor, q as FieldRenderFunctions, _ as Fields, r as ItemWithId, y as MappedItem, N as NumberField, Q as ObjectField, p as OverrideKey, t as PuckComponent, $ as PuckContext, K as RadioField, w as RootData, R as RootDataWithProps, v as RootDataWithoutProps, S as SelectField, T as TextField, J as TextareaField, n as Viewport, a5 as WithChildren, a2 as WithId, a3 as WithPuckProps, o as overrideKeys, a6 as resolveAllData } from './resolve-all-data-D43Z4niC.mjs';
+import { F as FieldProps, a as Field, D as DropZoneProps, C as Config, U as UserGenerics, b as Data, c as UiState, O as OnAction, P as Permissions, d as Plugin, e as Overrides, f as PuckAction, V as Viewports, I as IframeConfig, g as InitialHistory, M as Metadata, H as History, h as ComponentData, i as Fields, A as AppState, j as ComponentConfig } from './resolve-all-data-3XjIPfNh.mjs';
+export { K as Adaptor, G as ArrayField, r as ArrayState, a2 as AsFieldProps, B as BaseData, y as BaseField, w as ComponentDataMap, x as Content, W as CustomField, $ as DefaultComponentProps, Y as DefaultRootFieldProps, _ as DefaultRootProps, Z as DefaultRootRenderProps, k as Direction, l as DragAxis, Q as ExternalField, L as ExternalFieldWithAdaptor, a4 as ExtractPropsFromConfig, a5 as ExtractRootPropsFromConfig, p as FieldRenderFunctions, q as ItemWithId, v as MappedItem, N as NumberField, J as ObjectField, n as OverrideKey, s as PuckComponent, X as PuckContext, E as RadioField, u as RootData, R as RootDataWithProps, t as RootDataWithoutProps, S as SelectField, T as TextField, z as TextareaField, m as Viewport, a3 as WithChildren, a0 as WithId, a1 as WithPuckProps, o as overrideKeys, a7 as resolveAllData, a6 as transformProps } from './resolve-all-data-3XjIPfNh.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import { ReactNode, SyntheticEvent, ReactElement } from 'react';
+import react__default, { ReactNode, SyntheticEvent, ReactElement } from 'react';
 
 declare const ActionBar: {
     ({ label, children, }: {
@@ -93,7 +93,7 @@ declare const IconButton: ({ children, href, onClick, variant, type, disabled, t
     title: string;
 }) => react_jsx_runtime.JSX.Element;
 
-declare function Puck<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>({ children, config, data: initialData, ui: initialUi, onChange, onPublish, onAction, permissions, plugins, overrides, renderHeader, renderHeaderActions, headerTitle, headerPath, viewports, iframe: _iframe, dnd, initialHistory: _initialHistory, metadata, }: {
+type PuckProps<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
     children?: ReactNode;
     config: UserConfig;
     data: Partial<G["UserData"] | Data>;
@@ -122,7 +122,8 @@ declare function Puck<UserConfig extends Config = Config, G extends UserGenerics
     };
     initialHistory?: InitialHistory;
     metadata?: Metadata;
-}): react_jsx_runtime.JSX.Element;
+};
+declare function Puck<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>(props: PuckProps<UserConfig>): react_jsx_runtime.JSX.Element;
 declare namespace Puck {
     var Components: () => react_jsx_runtime.JSX.Element;
     var Fields: ({ wrapFields }: {
@@ -134,6 +135,11 @@ declare namespace Puck {
     }) => react_jsx_runtime.JSX.Element;
 }
 
+declare const renderContext: react__default.Context<{
+    config: Config;
+    data: Data;
+    metadata: Metadata;
+}>;
 declare function Render<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>({ config, data, metadata, }: {
     config: UserConfig;
     data: Partial<G["UserData"] | Data>;
@@ -142,58 +148,139 @@ declare function Render<UserConfig extends Config = Config, G extends UserGeneri
 
 declare function migrate(data: Data): Data;
 
-type PropTransform<Props extends DefaultComponentProps = DefaultComponentProps, RootProps extends DefaultComponentProps = DefaultRootFieldProps> = Partial<{
-    [ComponentName in keyof Props]: (props: Props[ComponentName] & {
-        [key: string]: any;
-    }) => Props[ComponentName];
-} & {
-    root: (props: RootProps & {
-        [key: string]: any;
-    }) => RootProps;
-}>;
-declare function transformProps<Props extends DefaultComponentProps = DefaultComponentProps, RootProps extends DefaultComponentProps = DefaultRootFieldProps>(data: Partial<Data>, propTransforms: PropTransform<Props, RootProps>): Data;
-
-type HistoryStore<D = any> = {
+type HistorySlice<D = any> = {
     index: number;
-    hasPast: boolean;
-    hasFuture: boolean;
+    hasPast: () => boolean;
+    hasFuture: () => boolean;
     histories: History<D>[];
     record: (data: D) => void;
     back: VoidFunction;
     forward: VoidFunction;
-    currentHistory: History;
-    nextHistory: History<D> | null;
-    prevHistory: History<D> | null;
+    currentHistory: () => History;
+    nextHistory: () => History<D> | null;
+    prevHistory: () => History<D> | null;
     setHistories: (histories: History[]) => void;
     setHistoryIndex: (index: number) => void;
+    initialAppState: D;
+};
+
+type NodeMethods = {
+    sync: () => void;
+};
+type PuckNode = {
+    id: string;
+    methods: NodeMethods;
+    data: ComponentData;
+    parentId: string | null;
+    zone: string;
+    path: string[];
+    index: number;
+    element: HTMLElement | null;
+};
+type NodesSlice = {
+    nodes: Record<string, PuckNode | undefined>;
+    registerNode: (id: string, node: Partial<PuckNode>) => void;
+    unregisterNode: (id: string, node?: Partial<PuckNode>) => void;
 };
 
 type PermissionsArgs<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
-    item?: G["UserComponentData"];
+    item?: G["UserComponentData"] | null;
     type?: keyof G["UserProps"];
     root?: boolean;
 };
-type GetPermissions<UserConfig extends Config = Config> = (params?: PermissionsArgs<UserConfig>) => Partial<Permissions>;
+type GetPermissions<UserConfig extends Config = Config> = (params?: PermissionsArgs<UserConfig>) => Permissions;
+type ResolvePermissions<UserConfig extends Config = Config> = (params?: PermissionsArgs<UserConfig>, force?: boolean) => void;
 type RefreshPermissions<UserConfig extends Config = Config> = (params?: PermissionsArgs<UserConfig>, force?: boolean) => void;
+type Cache = Record<string, {
+    lastPermissions: Partial<Permissions>;
+    lastData: ComponentData | null;
+}>;
+type PermissionsSlice = {
+    cache: Cache;
+    globalPermissions: Permissions;
+    resolvedPermissions: Record<string, Partial<Permissions> | undefined>;
+    getPermissions: GetPermissions<Config>;
+    resolvePermissions: ResolvePermissions<Config>;
+    refreshPermissions: RefreshPermissions<Config>;
+};
 
-declare const usePuck: <UserConfig extends Config = Config>() => {
-    appState: AppState<Data<ExtractPropsFromConfig<UserConfig>, ExtractRootPropsFromConfig<UserConfig>>>;
-    config: UserConfig;
+type ComponentOrRootData = Omit<ComponentData<any>, "type">;
+type FieldsSlice = {
+    fields: Fields | Partial<Fields>;
+    loading: boolean;
+    lastResolvedData: Partial<ComponentOrRootData>;
+};
+
+type Status = "LOADING" | "MOUNTED" | "READY";
+type ZoomConfig = {
+    autoZoom: number;
+    rootHeight: number;
+    zoom: number;
+};
+type ComponentState = Record<string, {
+    loadingCount: number;
+}>;
+type AppStore<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
+    state: G["UserAppState"];
     dispatch: (action: PuckAction) => void;
+    config: UserConfig;
+    componentState: ComponentState;
+    setComponentState: (componentState: ComponentState) => void;
+    setComponentLoading: (id: string) => void;
+    unsetComponentLoading: (id: string) => void;
+    resolveDataRuns: number;
+    resolveData: (newAppState: AppState) => void;
+    plugins: Plugin[];
+    overrides: Partial<Overrides>;
+    viewports: Viewports;
+    zoomConfig: ZoomConfig;
+    setZoomConfig: (zoomConfig: ZoomConfig) => void;
+    status: Status;
+    setStatus: (status: Status) => void;
+    iframe: IframeConfig;
+    selectedItem?: G["UserData"]["content"][0] | null;
+    setUi: (ui: Partial<UiState>, recordHistory?: boolean) => void;
+    getComponentConfig: (type?: string) => ComponentConfig | null | undefined;
+    onAction?: (action: PuckAction, newState: AppState, state: AppState) => void;
+    metadata: Metadata;
+    fields: FieldsSlice;
+    history: HistorySlice;
+    nodes: NodesSlice;
+    permissions: PermissionsSlice;
+};
+
+type WithGet<T> = T & {
+    get: () => T;
+};
+type UsePuckData<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
+    appState: AppState;
+    config: Config;
+    dispatch: AppStore["dispatch"];
     getPermissions: GetPermissions<UserConfig>;
     refreshPermissions: RefreshPermissions<UserConfig>;
+    selectedItem: G["UserComponentData"] | null;
     history: {
-        back: VoidFunction;
-        forward: VoidFunction;
-        setHistories: (histories: History[]) => void;
-        setHistoryIndex: (index: number) => void;
+        back: HistorySlice["back"];
+        forward: HistorySlice["forward"];
+        setHistories: HistorySlice["setHistories"];
+        setHistoryIndex: HistorySlice["setHistoryIndex"];
+        histories: HistorySlice["histories"];
+        index: HistorySlice["index"];
         hasPast: boolean;
         hasFuture: boolean;
-        histories: History<any>[];
-        index: number;
-        historyStore: HistoryStore | undefined;
     };
-    selectedItem: ComponentDataMap<ExtractPropsFromConfig<UserConfig>> | null;
 };
+type UsePuckStore<UserConfig extends Config = Config> = WithGet<UsePuckData<UserConfig>>;
+/**
+ * createUsePuck
+ *
+ * Create a typed usePuck hook, which is necessary because the user may provide a generic type but not
+ * a selector type, and TS does not currently support partial inference.
+ * Related: https://github.com/microsoft/TypeScript/issues/26242
+ *
+ * @returns a typed usePuck function
+ */
+declare function createUsePuck<UserConfig extends Config = Config>(): <T = UsePuckData<UserConfig, UserGenerics<UserConfig>>>(selector: (state: UsePuckStore<UserConfig>) => T) => T;
+declare function usePuck<UserConfig extends Config = Config>(): UsePuckStore<UserConfig>;
 
-export { Action, ActionBar, AppState, AutoField, Button, ComponentDataMap, Config, Data, DefaultComponentProps, DefaultRootFieldProps, Drawer, DropZone, ExtractPropsFromConfig, ExtractRootPropsFromConfig, Field, FieldLabel, FieldProps, Group, History, IconButton, IframeConfig, InitialHistory, Label, Metadata, OnAction, Overrides, Permissions, Plugin, Puck, PuckAction, Render, UiState, UserGenerics, Viewports, migrate, transformProps, usePuck };
+export { Action, ActionBar, AppState, AutoField, Button, ComponentConfig, ComponentData, Config, Data, Drawer, DropZone, Field, FieldLabel, FieldProps, Fields, Group, History, IconButton, IframeConfig, InitialHistory, Label, Metadata, OnAction, Overrides, Permissions, Plugin, Puck, PuckAction, Render, UiState, type UsePuckData, UserGenerics, Viewports, createUsePuck, migrate, renderContext, usePuck };

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { F as FieldProps, a as Field, D as DropZoneProps, C as Config, U as UserGenerics, b as Data, c as UiState, O as OnAction, P as Permissions, d as Plugin, e as Overrides, f as PuckAction, V as Viewports, I as IframeConfig, g as InitialHistory, M as Metadata, h as DefaultComponentProps, i as DefaultRootFieldProps, H as History, A as AppState, E as ExtractPropsFromConfig, j as ExtractRootPropsFromConfig, k as ComponentDataMap } from './resolve-all-data-D43Z4niC.js';
-export { W as Adaptor, L as ArrayField, s as ArrayState, a4 as AsFieldProps, B as BaseData, G as BaseField, u as ComponentConfig, x as ComponentData, z as Content, Z as CustomField, a1 as DefaultRootProps, a0 as DefaultRootRenderProps, l as Direction, m as DragAxis, Y as ExternalField, X as ExternalFieldWithAdaptor, q as FieldRenderFunctions, _ as Fields, r as ItemWithId, y as MappedItem, N as NumberField, Q as ObjectField, p as OverrideKey, t as PuckComponent, $ as PuckContext, K as RadioField, w as RootData, R as RootDataWithProps, v as RootDataWithoutProps, S as SelectField, T as TextField, J as TextareaField, n as Viewport, a5 as WithChildren, a2 as WithId, a3 as WithPuckProps, o as overrideKeys, a6 as resolveAllData } from './resolve-all-data-D43Z4niC.js';
+import { F as FieldProps, a as Field, D as DropZoneProps, C as Config, U as UserGenerics, b as Data, c as UiState, O as OnAction, P as Permissions, d as Plugin, e as Overrides, f as PuckAction, V as Viewports, I as IframeConfig, g as InitialHistory, M as Metadata, H as History, h as ComponentData, i as Fields, A as AppState, j as ComponentConfig } from './resolve-all-data-3XjIPfNh.js';
+export { K as Adaptor, G as ArrayField, r as ArrayState, a2 as AsFieldProps, B as BaseData, y as BaseField, w as ComponentDataMap, x as Content, W as CustomField, $ as DefaultComponentProps, Y as DefaultRootFieldProps, _ as DefaultRootProps, Z as DefaultRootRenderProps, k as Direction, l as DragAxis, Q as ExternalField, L as ExternalFieldWithAdaptor, a4 as ExtractPropsFromConfig, a5 as ExtractRootPropsFromConfig, p as FieldRenderFunctions, q as ItemWithId, v as MappedItem, N as NumberField, J as ObjectField, n as OverrideKey, s as PuckComponent, X as PuckContext, E as RadioField, u as RootData, R as RootDataWithProps, t as RootDataWithoutProps, S as SelectField, T as TextField, z as TextareaField, m as Viewport, a3 as WithChildren, a0 as WithId, a1 as WithPuckProps, o as overrideKeys, a7 as resolveAllData, a6 as transformProps } from './resolve-all-data-3XjIPfNh.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as react from 'react';
-import { ReactNode, SyntheticEvent, ReactElement } from 'react';
+import react__default, { ReactNode, SyntheticEvent, ReactElement } from 'react';
 
 declare const ActionBar: {
     ({ label, children, }: {
@@ -93,7 +93,7 @@ declare const IconButton: ({ children, href, onClick, variant, type, disabled, t
     title: string;
 }) => react_jsx_runtime.JSX.Element;
 
-declare function Puck<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>({ children, config, data: initialData, ui: initialUi, onChange, onPublish, onAction, permissions, plugins, overrides, renderHeader, renderHeaderActions, headerTitle, headerPath, viewports, iframe: _iframe, dnd, initialHistory: _initialHistory, metadata, }: {
+type PuckProps<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
     children?: ReactNode;
     config: UserConfig;
     data: Partial<G["UserData"] | Data>;
@@ -122,7 +122,8 @@ declare function Puck<UserConfig extends Config = Config, G extends UserGenerics
     };
     initialHistory?: InitialHistory;
     metadata?: Metadata;
-}): react_jsx_runtime.JSX.Element;
+};
+declare function Puck<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>(props: PuckProps<UserConfig>): react_jsx_runtime.JSX.Element;
 declare namespace Puck {
     var Components: () => react_jsx_runtime.JSX.Element;
     var Fields: ({ wrapFields }: {
@@ -134,6 +135,11 @@ declare namespace Puck {
     }) => react_jsx_runtime.JSX.Element;
 }
 
+declare const renderContext: react__default.Context<{
+    config: Config;
+    data: Data;
+    metadata: Metadata;
+}>;
 declare function Render<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>>({ config, data, metadata, }: {
     config: UserConfig;
     data: Partial<G["UserData"] | Data>;
@@ -142,58 +148,139 @@ declare function Render<UserConfig extends Config = Config, G extends UserGeneri
 
 declare function migrate(data: Data): Data;
 
-type PropTransform<Props extends DefaultComponentProps = DefaultComponentProps, RootProps extends DefaultComponentProps = DefaultRootFieldProps> = Partial<{
-    [ComponentName in keyof Props]: (props: Props[ComponentName] & {
-        [key: string]: any;
-    }) => Props[ComponentName];
-} & {
-    root: (props: RootProps & {
-        [key: string]: any;
-    }) => RootProps;
-}>;
-declare function transformProps<Props extends DefaultComponentProps = DefaultComponentProps, RootProps extends DefaultComponentProps = DefaultRootFieldProps>(data: Partial<Data>, propTransforms: PropTransform<Props, RootProps>): Data;
-
-type HistoryStore<D = any> = {
+type HistorySlice<D = any> = {
     index: number;
-    hasPast: boolean;
-    hasFuture: boolean;
+    hasPast: () => boolean;
+    hasFuture: () => boolean;
     histories: History<D>[];
     record: (data: D) => void;
     back: VoidFunction;
     forward: VoidFunction;
-    currentHistory: History;
-    nextHistory: History<D> | null;
-    prevHistory: History<D> | null;
+    currentHistory: () => History;
+    nextHistory: () => History<D> | null;
+    prevHistory: () => History<D> | null;
     setHistories: (histories: History[]) => void;
     setHistoryIndex: (index: number) => void;
+    initialAppState: D;
+};
+
+type NodeMethods = {
+    sync: () => void;
+};
+type PuckNode = {
+    id: string;
+    methods: NodeMethods;
+    data: ComponentData;
+    parentId: string | null;
+    zone: string;
+    path: string[];
+    index: number;
+    element: HTMLElement | null;
+};
+type NodesSlice = {
+    nodes: Record<string, PuckNode | undefined>;
+    registerNode: (id: string, node: Partial<PuckNode>) => void;
+    unregisterNode: (id: string, node?: Partial<PuckNode>) => void;
 };
 
 type PermissionsArgs<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
-    item?: G["UserComponentData"];
+    item?: G["UserComponentData"] | null;
     type?: keyof G["UserProps"];
     root?: boolean;
 };
-type GetPermissions<UserConfig extends Config = Config> = (params?: PermissionsArgs<UserConfig>) => Partial<Permissions>;
+type GetPermissions<UserConfig extends Config = Config> = (params?: PermissionsArgs<UserConfig>) => Permissions;
+type ResolvePermissions<UserConfig extends Config = Config> = (params?: PermissionsArgs<UserConfig>, force?: boolean) => void;
 type RefreshPermissions<UserConfig extends Config = Config> = (params?: PermissionsArgs<UserConfig>, force?: boolean) => void;
+type Cache = Record<string, {
+    lastPermissions: Partial<Permissions>;
+    lastData: ComponentData | null;
+}>;
+type PermissionsSlice = {
+    cache: Cache;
+    globalPermissions: Permissions;
+    resolvedPermissions: Record<string, Partial<Permissions> | undefined>;
+    getPermissions: GetPermissions<Config>;
+    resolvePermissions: ResolvePermissions<Config>;
+    refreshPermissions: RefreshPermissions<Config>;
+};
 
-declare const usePuck: <UserConfig extends Config = Config>() => {
-    appState: AppState<Data<ExtractPropsFromConfig<UserConfig>, ExtractRootPropsFromConfig<UserConfig>>>;
-    config: UserConfig;
+type ComponentOrRootData = Omit<ComponentData<any>, "type">;
+type FieldsSlice = {
+    fields: Fields | Partial<Fields>;
+    loading: boolean;
+    lastResolvedData: Partial<ComponentOrRootData>;
+};
+
+type Status = "LOADING" | "MOUNTED" | "READY";
+type ZoomConfig = {
+    autoZoom: number;
+    rootHeight: number;
+    zoom: number;
+};
+type ComponentState = Record<string, {
+    loadingCount: number;
+}>;
+type AppStore<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
+    state: G["UserAppState"];
     dispatch: (action: PuckAction) => void;
+    config: UserConfig;
+    componentState: ComponentState;
+    setComponentState: (componentState: ComponentState) => void;
+    setComponentLoading: (id: string) => void;
+    unsetComponentLoading: (id: string) => void;
+    resolveDataRuns: number;
+    resolveData: (newAppState: AppState) => void;
+    plugins: Plugin[];
+    overrides: Partial<Overrides>;
+    viewports: Viewports;
+    zoomConfig: ZoomConfig;
+    setZoomConfig: (zoomConfig: ZoomConfig) => void;
+    status: Status;
+    setStatus: (status: Status) => void;
+    iframe: IframeConfig;
+    selectedItem?: G["UserData"]["content"][0] | null;
+    setUi: (ui: Partial<UiState>, recordHistory?: boolean) => void;
+    getComponentConfig: (type?: string) => ComponentConfig | null | undefined;
+    onAction?: (action: PuckAction, newState: AppState, state: AppState) => void;
+    metadata: Metadata;
+    fields: FieldsSlice;
+    history: HistorySlice;
+    nodes: NodesSlice;
+    permissions: PermissionsSlice;
+};
+
+type WithGet<T> = T & {
+    get: () => T;
+};
+type UsePuckData<UserConfig extends Config = Config, G extends UserGenerics<UserConfig> = UserGenerics<UserConfig>> = {
+    appState: AppState;
+    config: Config;
+    dispatch: AppStore["dispatch"];
     getPermissions: GetPermissions<UserConfig>;
     refreshPermissions: RefreshPermissions<UserConfig>;
+    selectedItem: G["UserComponentData"] | null;
     history: {
-        back: VoidFunction;
-        forward: VoidFunction;
-        setHistories: (histories: History[]) => void;
-        setHistoryIndex: (index: number) => void;
+        back: HistorySlice["back"];
+        forward: HistorySlice["forward"];
+        setHistories: HistorySlice["setHistories"];
+        setHistoryIndex: HistorySlice["setHistoryIndex"];
+        histories: HistorySlice["histories"];
+        index: HistorySlice["index"];
         hasPast: boolean;
         hasFuture: boolean;
-        histories: History<any>[];
-        index: number;
-        historyStore: HistoryStore | undefined;
     };
-    selectedItem: ComponentDataMap<ExtractPropsFromConfig<UserConfig>> | null;
 };
+type UsePuckStore<UserConfig extends Config = Config> = WithGet<UsePuckData<UserConfig>>;
+/**
+ * createUsePuck
+ *
+ * Create a typed usePuck hook, which is necessary because the user may provide a generic type but not
+ * a selector type, and TS does not currently support partial inference.
+ * Related: https://github.com/microsoft/TypeScript/issues/26242
+ *
+ * @returns a typed usePuck function
+ */
+declare function createUsePuck<UserConfig extends Config = Config>(): <T = UsePuckData<UserConfig, UserGenerics<UserConfig>>>(selector: (state: UsePuckStore<UserConfig>) => T) => T;
+declare function usePuck<UserConfig extends Config = Config>(): UsePuckStore<UserConfig>;
 
-export { Action, ActionBar, AppState, AutoField, Button, ComponentDataMap, Config, Data, DefaultComponentProps, DefaultRootFieldProps, Drawer, DropZone, ExtractPropsFromConfig, ExtractRootPropsFromConfig, Field, FieldLabel, FieldProps, Group, History, IconButton, IframeConfig, InitialHistory, Label, Metadata, OnAction, Overrides, Permissions, Plugin, Puck, PuckAction, Render, UiState, UserGenerics, Viewports, migrate, transformProps, usePuck };
+export { Action, ActionBar, AppState, AutoField, Button, ComponentConfig, ComponentData, Config, Data, Drawer, DropZone, Field, FieldLabel, FieldProps, Fields, Group, History, IconButton, IframeConfig, InitialHistory, Label, Metadata, OnAction, Overrides, Permissions, Plugin, Puck, PuckAction, Render, UiState, type UsePuckData, UserGenerics, Viewports, createUsePuck, migrate, renderContext, usePuck };