@wordpress/data 10.41.0 → 10.41.1-next.v.202603102151.0

package/build-types/types.d.ts

@@ -1,7 +1,12 @@
 /**
  * External dependencies
  */
-import type { combineReducers as reduxCombineReducers } from 'redux';
+import type { combineReducers as reduxCombineReducers, Store as ReduxStore } from 'redux';
+/**
+ * Internal dependencies
+ */
+import type { DataEmitter } from './utils/emitter';
+import type { MetadataSelectors, MetadataActions } from './redux-store/metadata/types';
 type MapOf<T> = {
     [name: string]: T;
 };
@@ -24,7 +29,7 @@ export interface StoreDescriptor<Config extends AnyConfig = AnyConfig> {
      */
     instantiate: (registry: DataRegistry) => StoreInstance<Config>;
 }
-export interface ReduxStoreConfig<State, ActionCreators extends MapOf<ActionCreator>, Selectors> {
+export interface ReduxStoreConfig<State, ActionCreators, Selectors> {
     initialState?: State;
     reducer: (state: any, action: any) => any;
     actions?: ActionCreators;
@@ -33,9 +38,9 @@ export interface ReduxStoreConfig<State, ActionCreators extends MapOf<ActionCrea
     controls?: MapOf<Function>;
 }
 export type UseSelectReturn<F extends MapSelect | StoreDescriptor<any>> = F extends MapSelect ? ReturnType<F> : F extends StoreDescriptor<any> ? CurriedSelectorsOf<F> : never;
-export type UseDispatchReturn<StoreNameOrDescriptor> = StoreNameOrDescriptor extends StoreDescriptor<any> ? ActionCreatorsOf<ConfigOf<StoreNameOrDescriptor>> : StoreNameOrDescriptor extends undefined ? DispatchFunction : any;
+export type UseDispatchReturn<StoreNameOrDescriptor> = StoreNameOrDescriptor extends StoreDescriptor<any> ? ActionCreatorsOf<StoreNameOrDescriptor> : StoreNameOrDescriptor extends undefined ? DispatchFunction : any;
 export type DispatchFunction = <StoreNameOrDescriptor>(store: StoreNameOrDescriptor) => DispatchReturn<StoreNameOrDescriptor>;
-export type DispatchReturn<StoreNameOrDescriptor> = StoreNameOrDescriptor extends StoreDescriptor<any> ? ActionCreatorsOf<ConfigOf<StoreNameOrDescriptor>> : unknown;
+export type DispatchReturn<StoreNameOrDescriptor> = StoreNameOrDescriptor extends StoreDescriptor<any> ? ActionCreatorsOf<StoreNameOrDescriptor> : unknown;
 export type MapSelect = (select: SelectFunction, registry: DataRegistry) => any;
 export type SelectFunction = <S>(store: S) => CurriedSelectorsOf<S>;
 /**
@@ -45,7 +50,7 @@ export type SelectFunction = <S>(store: S) => CurriedSelectorsOf<S>;
 export type ListenerFunction = () => void;
 export type CurriedSelectorsOf<S> = S extends StoreDescriptor<ReduxStoreConfig<any, any, infer Selectors>> ? {
     [key in keyof Selectors]: CurriedState<Selectors[key]>;
-} : never;
+} & MetadataSelectors<S> : never;
 /**
  * Like CurriedState but wraps the return type in a Promise.
  * Used for resolveSelect where selectors return promises.
@@ -131,20 +136,206 @@ export interface SelectorWithCustomCurrySignature {
     CurriedSignature: Function;
     PromiseCurriedSignature?: Function;
 }
+/**
+ * A store name or store descriptor, used throughout the API.
+ */
+export type StoreNameOrDescriptor = string | StoreDescriptor;
+/**
+ * An isolated orchestrator of store registrations.
+ *
+ * Returned by `createRegistry`. Provides methods to register stores,
+ * select data, dispatch actions, and subscribe to changes.
+ */
 export interface DataRegistry {
+    batch: (callback: () => void) => void;
+    stores: Record<string, InternalStoreInstance>;
+    namespaces: Record<string, InternalStoreInstance>;
+    subscribe: (listener: ListenerFunction, storeNameOrDescriptor?: StoreNameOrDescriptor) => () => void;
+    select: {
+        <S extends StoreDescriptor<any>>(store: S): CurriedSelectorsOf<S>;
+        (store: StoreNameOrDescriptor): Record<string, (...args: any[]) => any>;
+    };
+    resolveSelect: {
+        <S extends StoreDescriptor<any>>(store: S): CurriedSelectorsResolveOf<S>;
+        (store: StoreNameOrDescriptor): Record<string, (...args: any[]) => Promise<any>>;
+    };
+    suspendSelect: {
+        <S extends StoreDescriptor<any>>(store: S): CurriedSelectorsOf<S>;
+        (store: StoreNameOrDescriptor): Record<string, (...args: any[]) => any>;
+    };
+    dispatch: {
+        <S extends StoreDescriptor<any>>(store: S): ActionCreatorsOf<S>;
+        (store: StoreNameOrDescriptor): Record<string, (...args: any[]) => any>;
+    };
+    use: (plugin: DataPlugin, options?: Record<string, unknown>) => DataRegistry;
     register: (store: StoreDescriptor<any>) => void;
-    dispatch: <S extends StoreDescriptor<any>>(store: S) => ActionCreatorsOf<ConfigOf<S>>;
+    registerGenericStore: (name: string, store: StoreInstance<AnyConfig>) => void;
+    registerStore: (storeName: string, options: ReduxStoreConfig<any, any, any>) => ReduxStore;
+    __unstableMarkListeningStores: <T>(callback: () => T, ref: {
+        current: string[] | null;
+    }) => T;
+}
+/**
+ * The plugin function signature.
+ */
+export type DataPlugin = (registry: DataRegistry, options?: Record<string, unknown>) => Partial<DataRegistry>;
+/**
+ * Status of a selector resolution.
+ */
+export type ResolutionStatus = 'resolving' | 'finished' | 'error';
+/**
+ * State value for a single resolution.
+ */
+export type ResolutionState = {
+    status: 'resolving';
+} | {
+    status: 'finished';
+} | {
+    status: 'error';
+    error: Error | unknown;
+};
+/**
+ * A normalized resolver with a `fulfill` method and optional `isFulfilled`.
+ */
+export interface NormalizedResolver {
+    /**
+     * The function to call to fulfill the resolver.
+     */
+    fulfill: (...args: any[]) => any;
+    /**
+     * Optional function to check if the resolver is already fulfilled.
+     */
+    isFulfilled?: (state: any, ...args: any[]) => boolean;
+    /**
+     * Optional function to check if the resolver should be invalidated.
+     */
+    shouldInvalidate?: (action: any, ...args: any[]) => boolean;
+}
+/**
+ * A bound selector with optional resolver metadata.
+ */
+export interface BoundSelector {
+    (...args: any[]): any;
+    /**
+     * Whether this selector has a resolver attached.
+     */
+    hasResolver: boolean;
+    /**
+     * Optional function to normalize the arguments.
+     */
+    __unstableNormalizeArgs?: (args: any[]) => any[];
+    /**
+     * Whether this selector is a registry selector.
+     */
+    isRegistrySelector?: boolean;
+    /**
+     * The registry instance this selector is bound to.
+     */
+    registry?: DataRegistry;
+}
+/**
+ * The shape of a store instance as seen internally by the registry.
+ * Extends the public StoreInstance with additional internal properties.
+ */
+export interface InternalStoreInstance<Config extends AnyConfig = AnyConfig> extends StoreInstance<Config> {
+    /**
+     * The Redux store instance (only for Redux-based stores).
+     */
+    store?: ReduxStore;
+    /**
+     * The internal emitter for pause/resume batching.
+     */
+    emitter: DataEmitter;
+    /**
+     * The combined reducer.
+     */
+    reducer?: (state: any, action: any) => any;
+    /**
+     * Bound actions object.
+     */
+    actions?: Record<string, ActionCreator>;
+    /**
+     * Bound selectors object.
+     */
+    selectors?: Record<string, Selector>;
+    /**
+     * Resolver definitions.
+     */
+    resolvers?: Record<string, NormalizedResolver>;
+    /**
+     * Returns resolve-wrapped selectors.
+     */
+    getResolveSelectors?: () => Record<string, (...args: any[]) => Promise<any>>;
+    /**
+     * Returns suspense-wrapped selectors.
+     */
+    getSuspendSelectors?: () => Record<string, (...args: any[]) => any>;
+}
+/**
+ * Control descriptor for the controls system.
+ */
+export interface ControlDescriptor {
+    /**
+     * The type of the control action.
+     */
+    type: string;
+    /**
+     * The store key to target.
+     */
+    storeKey: string;
+    /**
+     * The name of the selector (for select/resolveSelect controls).
+     */
+    selectorName?: string;
+    /**
+     * The name of the action (for dispatch controls).
+     */
+    actionName?: string;
+    /**
+     * Arguments for the selector or action.
+     */
+    args: any[];
+}
+/**
+ * Storage interface (Web Storage API subset).
+ */
+export interface StorageInterface {
+    getItem: (key: string) => string | null;
+    setItem: (key: string, value: string) => void;
+    removeItem?: (key: string) => void;
+    clear?: VoidFunction;
 }
 export type ConfigOf<S> = S extends StoreDescriptor<infer C> ? C : never;
-export type ActionCreatorsOf<Config extends AnyConfig> = Config extends ReduxStoreConfig<any, infer ActionCreators, any> ? PromisifiedActionCreators<ActionCreators> : never;
-export type PromisifiedActionCreators<ActionCreators extends MapOf<ActionCreator>> = {
-    [Action in keyof ActionCreators]: PromisifyActionCreator<ActionCreators[Action]>;
+export type ActionCreatorsOf<T> = T extends StoreDescriptor<ReduxStoreConfig<any, infer ActionCreators, any>> ? PromisifiedActionCreators<ActionCreators> & MetadataActions<T> : T extends ReduxStoreConfig<any, infer ActionCreators, any> ? PromisifiedActionCreators<ActionCreators> : never;
+export type PromisifiedActionCreators<ActionCreators> = {
+    [Action in keyof ActionCreators]: ActionCreators[Action] extends ActionCreator ? PromisifyActionCreator<ActionCreators[Action]> : ActionCreators[Action];
 };
-export type PromisifyActionCreator<Action extends ActionCreator> = (...args: Parameters<Action>) => Promise<ReturnType<Action> extends (..._args: any[]) => any ? ThunkReturnType<Action> : ReturnType<Action>>;
+export type PromisifyActionCreator<Action extends ActionCreator> = (...args: Parameters<Action>) => Promise<ReturnType<Action> extends (..._args: any[]) => any ? ThunkReturnType<Action> : ReturnType<Action> extends Generator<any, infer TReturn, any> ? TReturn : ReturnType<Action>>;
 export type ThunkReturnType<Action extends ActionCreator> = Awaited<ReturnType<ReturnType<Action>>>;
 type SelectorsOf<Config extends AnyConfig> = Config extends ReduxStoreConfig<any, any, infer Selectors> ? {
     [name in keyof Selectors]: Function;
 } : never;
+/**
+ * The argument object passed to every thunk function. When parameterized with
+ * a store descriptor, `dispatch`, `select`, and `resolveSelect` are fully
+ * typed against that store's actions and selectors.
+ *
+ * @example
+ * ```ts
+ * const myAction =
+ *     ( id: number ) =>
+ *     async ( { dispatch, select }: ThunkArgs< typeof myStore > ) => {
+ *         const record = select.getRecord( id );
+ *         dispatch.setLoading( true );
+ *     };
+ * ```
+ */
+export interface ThunkArgs<S extends StoreDescriptor = StoreDescriptor> {
+    dispatch: ActionCreatorsOf<S> & ((action: Record<string, unknown> | Function) => unknown);
+    select: CurriedSelectorsOf<S>;
+    resolveSelect: CurriedSelectorsResolveOf<S>;
+    registry: DataRegistry;
+}
 export type combineReducers = typeof reduxCombineReducers;
 export {};
 //# sourceMappingURL=types.d.ts.map

package/build-types/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAEX,eAAe,IAAI,oBAAoB,EACvC,KAAK,IAAI,UAAU,EACnB,MAAM,OAAO,CAAC;AAEf;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,KAAK,EACX,iBAAiB,EACjB,eAAe,EACf,MAAM,8BAA8B,CAAC;AAEtC,KAAK,KAAK,CAAE,CAAC,IAAK;IAAE,CAAE,IAAI,EAAE,MAAM,GAAI,CAAC,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,aAAa,GAAG,CAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAM,GAAG,GAAG,SAAS,CAAC;AAClE,MAAM,MAAM,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;AAC5C,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;AAEhC,MAAM,MAAM,SAAS,GAAG,gBAAgB,CAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAE,CAAC;AAE1D,MAAM,WAAW,aAAa,CAAE,MAAM,SAAS,SAAS;IACvD,YAAY,EAAE,MAAM,WAAW,CAAE,MAAM,CAAE,CAAC;IAC1C,UAAU,EAAE,MAAM,gBAAgB,CAAE,MAAM,CAAE,CAAC;IAC7C,SAAS,EAAE,CAAE,QAAQ,EAAE,MAAM,IAAI,KAAM,MAAM,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,eAAe,CAAE,MAAM,SAAS,SAAS,GAAG,SAAS;IACrE;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,WAAW,EAAE,CAAE,QAAQ,EAAE,YAAY,KAAM,aAAa,CAAE,MAAM,CAAE,CAAC;CACnE;AAED,MAAM,WAAW,gBAAgB,CAAE,KAAK,EAAE,cAAc,EAAE,SAAS;IAClE,YAAY,CAAC,EAAE,KAAK,CAAC;IACrB,OAAO,EAAE,CAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAM,GAAG,CAAC;IAC5C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,SAAS,CAAC,EAAE,KAAK,CAAE,QAAQ,CAAE,CAAC;IAC9B,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAE,QAAQ,CAAE,CAAC;CAC7B;AAGD,MAAM,MAAM,eAAe,CAAE,CAAC,SAAS,SAAS,GAAG,eAAe,CAAE,GAAG,CAAE,IACxE,CAAC,SAAS,SAAS,GAChB,UAAU,CAAE,CAAC,CAAE,GACf,CAAC,SAAS,eAAe,CAAE,GAAG,CAAE,GAChC,kBAAkB,CAAE,CAAC,CAAE,GACvB,KAAK,CAAC;AAGV,MAAM,MAAM,iBAAiB,CAAE,qBAAqB,IACnD,qBAAqB,SAAS,eAAe,CAAE,GAAG,CAAE,GACjD,gBAAgB,CAAE,qBAAqB,CAAE,GACzC,qBAAqB,SAAS,SAAS,GACvC,gBAAgB,GAChB,GAAG,CAAC;AAER,MAAM,MAAM,gBAAgB,GAAG,CAAE,qBAAqB,EACrD,KAAK,EAAE,qBAAqB,KACxB,cAAc,CAAE,qBAAqB,CAAE,CAAC;AAE7C,MAAM,MAAM,cAAc,CAAE,qBAAqB,IAChD,qBAAqB,SAAS,eAAe,CAAE,GAAG,CAAE,GACjD,gBAAgB,CAAE,qBAAqB,CAAE,GACzC,OAAO,CAAC;AAEZ,MAAM,MAAM,SAAS,GAAG,CACvB,MAAM,EAAE,cAAc,EACtB,QAAQ,EAAE,YAAY,KAClB,GAAG,CAAC;AAET,MAAM,MAAM,cAAc,GAAG,CAAE,CAAC,EAAI,KAAK,EAAE,CAAC,KAAM,kBAAkB,CAAE,CAAC,CAAE,CAAC;AAE1E;;;GAGG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,IAAI,CAAC;AAE1C,MAAM,MAAM,kBAAkB,CAAE,CAAC,IAAK,CAAC,SAAS,eAAe,CAC9D,gBAAgB,CAAE,GAAG,EAAE,GAAG,EAAE,MAAM,SAAS,CAAE,CAC7C,GACE;KACE,GAAG,IAAI,MAAM,SAAS,GAAI,YAAY,CAAE,SAAS,CAAE,GAAG,CAAE,CAAE;CAC3D,GAAG,iBAAiB,CAAE,CAAC,CAAE,GAC1B,KAAK,CAAC;AAET;;;;;;;GAOG;AACH,KAAK,uBAAuB,CAAE,CAAC,IAC9B,CAAC,SAAS,gCAAgC,GAAG;IAC5C,uBAAuB,EAAE,MAAM,CAAC,CAAC;CACjC,GACE,CAAC,GACD,CAAC,SAAS,gCAAgC,GAAG;IAC7C,gBAAgB,EAAE,CAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAM,MAAM,CAAC,CAAC;CACjD,GACD,CAAE,GAAG,IAAI,EAAE,CAAC,KAAM,OAAO,CAAE,CAAC,CAAE,GAC9B,CAAC,SAAS,CAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAM,MAAM,CAAC,GACrD,CAAE,GAAG,IAAI,EAAE,CAAC,KAAM,OAAO,CAAE,CAAC,CAAE,GAC9B,CAAC,CAAC;AAEN;;;GAGG;AACH,MAAM,MAAM,yBAAyB,CAAE,CAAC,IAAK,CAAC,SAAS,eAAe,CACrE,gBAAgB,CAAE,GAAG,EAAE,GAAG,EAAE,MAAM,SAAS,CAAE,CAC7C,GACE;KACE,GAAG,IAAI,MAAM,SAAS,GAAI,uBAAuB,CAClD,SAAS,CAAE,GAAG,CAAE,CAChB;CACA,GACD,KAAK,CAAC;AAET;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,KAAK,YAAY,CAAE,CAAC,IAAK,CAAC,SAAS,gCAAgC,GAChE,CAAC,CAAE,kBAAkB,CAAE,GACvB,CAAC,SAAS,CAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,MAAM,CAAC,KAAM,MAAM,CAAC,GACrD,CAAE,GAAG,IAAI,EAAE,CAAC,KAAM,CAAC,GACnB,CAAC,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,WAAW,gCAAgC;IAChD,gBAAgB,EAAE,QAAQ,CAAC;IAC3B,uBAAuB,CAAC,EAAE,QAAQ,CAAC;CACnC;AAED;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,eAAe,CAAC;AAE7D;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAC5B,KAAK,EAAE,CAAE,QAAQ,EAAE,MAAM,IAAI,KAAM,IAAI,CAAC;IACxC,MAAM,EAAE,MAAM,CAAE,MAAM,EAAE,qBAAqB,CAAE,CAAC;IAChD,UAAU,EAAE,MAAM,CAAE,MAAM,EAAE,qBAAqB,CAAE,CAAC;IACpD,SAAS,EAAE,CACV,QAAQ,EAAE,gBAAgB,EAC1B,qBAAqB,CAAC,EAAE,qBAAqB,KACzC,MAAM,IAAI,CAAC;IAChB,MAAM,EAAE;QACP,CAAE,CAAC,SAAS,eAAe,CAAE,GAAG,CAAE,EACjC,KAAK,EAAE,CAAC,GACN,kBAAkB,CAAE,CAAC,CAAE,CAAC;QAC3B,CACC,KAAK,EAAE,qBAAqB,GAC1B,MAAM,CAAE,MAAM,EAAE,CAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAM,GAAG,CAAE,CAAC;KAC/C,CAAC;IACF,aAAa,EAAE;QACd,CAAE,CAAC,SAAS,eAAe,CAAE,GAAG,CAAE,EACjC,KAAK,EAAE,CAAC,GACN,yBAAyB,CAAE,CAAC,CAAE,CAAC;QAClC,CACC,KAAK,EAAE,qBAAqB,GAC1B,MAAM,CAAE,MAAM,EAAE,CAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAM,OAAO,CAAE,GAAG,CAAE,CAAE,CAAC;KAC1D,CAAC;IACF,aAAa,EAAE;QACd,CAAE,CAAC,SAAS,eAAe,CAAE,GAAG,CAAE,EACjC,KAAK,EAAE,CAAC,GACN,kBAAkB,CAAE,CAAC,CAAE,CAAC;QAC3B,CACC,KAAK,EAAE,qBAAqB,GAC1B,MAAM,CAAE,MAAM,EAAE,CAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAM,GAAG,CAAE,CAAC;KAC/C,CAAC;IACF,QAAQ,EAAE;QACT,CAAE,CAAC,SAAS,eAAe,CAAE,GAAG,CAAE,EAAI,KAAK,EAAE,CAAC,GAAI,gBAAgB,CAAE,CAAC,CAAE,CAAC;QACxE,CACC,KAAK,EAAE,qBAAqB,GAC1B,MAAM,CAAE,MAAM,EAAE,CAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAM,GAAG,CAAE,CAAC;KAC/C,CAAC;IACF,GAAG,EAAE,CACJ,MAAM,EAAE,UAAU,EAClB,OAAO,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,OAAO,CAAE,KAC/B,YAAY,CAAC;IAClB,QAAQ,EAAE,CAAE,KAAK,EAAE,eAAe,CAAE,GAAG,CAAE,KAAM,IAAI,CAAC;IACpD,oBAAoB,EAAE,CACrB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,aAAa,CAAE,SAAS,CAAE,KAC7B,IAAI,CAAC;IACV,aAAa,EAAE,CACd,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,gBAAgB,CAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAE,KACtC,UAAU,CAAC;IAChB,6BAA6B,EAAE,CAAE,CAAC,EACjC,QAAQ,EAAE,MAAM,CAAC,EACjB,GAAG,EAAE;QAAE,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;KAAE,KAC7B,CAAC,CAAC;CACP;AAED;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CACxB,QAAQ,EAAE,YAAY,EACtB,OAAO,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,OAAO,CAAE,KAC/B,OAAO,CAAE,YAAY,CAAE,CAAC;AAE7B;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,WAAW,GAAG,UAAU,GAAG,OAAO,CAAC;AAElE;;GAEG;AACH,MAAM,MAAM,eAAe,GACxB;IAAE,MAAM,EAAE,WAAW,CAAA;CAAE,GACvB;IAAE,MAAM,EAAE,UAAU,CAAA;CAAE,GACtB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAAA;CAAE,CAAC;AAE/C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IAClC;;OAEG;IACH,OAAO,EAAE,CAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAM,GAAG,CAAC;IACnC;;OAEG;IACH,WAAW,CAAC,EAAE,CAAE,KAAK,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAM,OAAO,CAAC;IACxD;;OAEG;IACH,gBAAgB,CAAC,EAAE,CAAE,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAM,OAAO,CAAC;CAC9D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC7B,CAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAI,GAAG,CAAC;IACxB;;OAEG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB;;OAEG;IACH,uBAAuB,CAAC,EAAE,CAAE,IAAI,EAAE,GAAG,EAAE,KAAM,GAAG,EAAE,CAAC;IACnD;;OAEG;IACH,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B;;OAEG;IACH,QAAQ,CAAC,EAAE,YAAY,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB,CAAE,MAAM,SAAS,SAAS,GAAG,SAAS,CAC3E,SAAQ,aAAa,CAAE,MAAM,CAAE;IAC/B;;OAEG;IACH,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB;;OAEG;IACH,OAAO,EAAE,WAAW,CAAC;IACrB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,KAAM,GAAG,CAAC;IAC7C;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,aAAa,CAAE,CAAC;IAC1C;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,QAAQ,CAAE,CAAC;IACvC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAE,MAAM,EAAE,kBAAkB,CAAE,CAAC;IACjD;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,MAAM,CACjC,MAAM,EACN,CAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAM,OAAO,CAAE,GAAG,CAAE,CACpC,CAAC;IACF;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,MAAM,CAAE,MAAM,EAAE,CAAE,GAAG,IAAI,EAAE,GAAG,EAAE,KAAM,GAAG,CAAE,CAAC;CACxE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IACjC;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,IAAI,EAAE,GAAG,EAAE,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,CAAE,GAAG,EAAE,MAAM,KAAM,MAAM,GAAG,IAAI,CAAC;IAC1C,OAAO,EAAE,CAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAM,IAAI,CAAC;IAChD,UAAU,CAAC,EAAE,CAAE,GAAG,EAAE,MAAM,KAAM,IAAI,CAAC;IACrC,KAAK,CAAC,EAAE,YAAY,CAAC;CACrB;AAID,MAAM,MAAM,QAAQ,CAAE,CAAC,IAAK,CAAC,SAAS,eAAe,CAAE,MAAM,CAAC,CAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AAE7E,MAAM,MAAM,gBAAgB,CAAE,CAAC,IAAK,CAAC,SAAS,eAAe,CAC5D,gBAAgB,CAAE,GAAG,EAAE,MAAM,cAAc,EAAE,GAAG,CAAE,CAClD,GACE,yBAAyB,CAAE,cAAc,CAAE,GAAG,eAAe,CAAE,CAAC,CAAE,GAClE,CAAC,SAAS,gBAAgB,CAAE,GAAG,EAAE,MAAM,cAAc,EAAE,GAAG,CAAE,GAC5D,yBAAyB,CAAE,cAAc,CAAE,GAC3C,KAAK,CAAC;AAKT,MAAM,MAAM,yBAAyB,CAAE,cAAc,IAAK;KACvD,MAAM,IAAI,MAAM,cAAc,GAAI,cAAc,CAAE,MAAM,CAAE,SAAS,aAAa,GAC/E,sBAAsB,CAAE,cAAc,CAAE,MAAM,CAAE,CAAE,GAClD,cAAc,CAAE,MAAM,CAAE;CAC3B,CAAC;AAGF,MAAM,MAAM,sBAAsB,CAAE,MAAM,SAAS,aAAa,IAAK,CACpE,GAAG,IAAI,EAAE,UAAU,CAAE,MAAM,CAAE,KACzB,OAAO,CACX,UAAU,CAAE,MAAM,CAAE,SAAS,CAAE,GAAG,KAAK,EAAE,GAAG,EAAE,KAAM,GAAG,GACpD,eAAe,CAAE,MAAM,CAAE,GACzB,UAAU,CAAE,MAAM,CAAE,SAAS,SAAS,CAAE,GAAG,EAAE,MAAM,OAAO,EAAE,GAAG,CAAE,GACjE,OAAO,GACP,UAAU,CAAE,MAAM,CAAE,CACvB,CAAC;AAMF,MAAM,MAAM,eAAe,CAAE,MAAM,SAAS,aAAa,IAAK,OAAO,CACpE,UAAU,CAAE,UAAU,CAAE,MAAM,CAAE,CAAE,CAClC,CAAC;AAEF,KAAK,WAAW,CAAE,MAAM,SAAS,SAAS,IAAK,MAAM,SAAS,gBAAgB,CAC7E,GAAG,EACH,GAAG,EACH,MAAM,SAAS,CACf,GACE;KAAI,IAAI,IAAI,MAAM,SAAS,GAAI,QAAQ;CAAE,GACzC,KAAK,CAAC;AAET;;;;;;;;;;;;;;GAcG;AACH,MAAM,WAAW,SAAS,CAAE,CAAC,SAAS,eAAe,GAAG,eAAe;IACtE,QAAQ,EAAE,gBAAgB,CAAE,CAAC,CAAE,GAC9B,CAAE,CAAE,MAAM,EAAE,MAAM,CAAE,MAAM,EAAE,OAAO,CAAE,GAAG,QAAQ,KAAM,OAAO,CAAE,CAAC;IACjE,MAAM,EAAE,kBAAkB,CAAE,CAAC,CAAE,CAAC;IAChC,aAAa,EAAE,yBAAyB,CAAE,CAAC,CAAE,CAAC;IAC9C,QAAQ,EAAE,YAAY,CAAC;CACvB;AAED,MAAM,MAAM,eAAe,GAAG,OAAO,oBAAoB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@wordpress/data",
-	"version": "10.41.0",
+	"version": "10.41.1-next.v.202603102151.0+59e17f9ec",
 	"description": "Data module for WordPress.",
 	"author": "The WordPress Contributors",
 	"license": "GPL-2.0-or-later",
@@ -45,13 +45,13 @@
 	"types": "build-types",
 	"sideEffects": false,
 	"dependencies": {
-		"@wordpress/compose": "^7.41.0",
-		"@wordpress/deprecated": "^4.41.0",
-		"@wordpress/element": "^6.41.0",
-		"@wordpress/is-shallow-equal": "^5.41.0",
-		"@wordpress/priority-queue": "^3.41.0",
-		"@wordpress/private-apis": "^1.41.0",
-		"@wordpress/redux-routine": "^5.41.0",
+		"@wordpress/compose": "^7.41.1-next.v.202603102151.0+59e17f9ec",
+		"@wordpress/deprecated": "^4.41.1-next.v.202603102151.0+59e17f9ec",
+		"@wordpress/element": "^6.41.1-next.v.202603102151.0+59e17f9ec",
+		"@wordpress/is-shallow-equal": "^5.41.1-next.v.202603102151.0+59e17f9ec",
+		"@wordpress/priority-queue": "^3.41.1-next.v.202603102151.0+59e17f9ec",
+		"@wordpress/private-apis": "^1.41.1-next.v.202603102151.0+59e17f9ec",
+		"@wordpress/redux-routine": "^5.41.1-next.v.202603102151.0+59e17f9ec",
 		"deepmerge": "^4.3.0",
 		"equivalent-key-map": "^0.2.2",
 		"is-plain-object": "^5.0.0",
@@ -69,5 +69,5 @@
 	"publishConfig": {
 		"access": "public"
 	},
-	"gitHead": "8bfc179b9aed74c0a6dd6e8edf7a49e40e4f87cc"
+	"gitHead": "86db21e727d89e8f0dbba9300d2f97fd22b08693"
 }

package/src/components/async-mode-provider/{context.js → context.ts}

@@ -43,6 +43,5 @@ export const AsyncModeConsumer = Consumer;
  * It is possible to nest multiple levels of AsyncModeProvider to fine-tune the rendering behavior.
  *
  * @param {boolean} props.value Enable Async Mode.
- * @return {Component} The component to be rendered.
  */
 export default Provider;

package/src/components/async-mode-provider/{use-async-mode.js → use-async-mode.ts}

@@ -8,6 +8,6 @@ import { useContext } from '@wordpress/element';
  */
 import { Context } from './context';
 
-export default function useAsyncMode() {
+export default function useAsyncMode(): boolean {
 	return useContext( Context );
 }

package/src/components/registry-provider/{use-registry.js → use-registry.ts}

@@ -7,6 +7,7 @@ import { useContext } from '@wordpress/element';
  * Internal dependencies
  */
 import { Context } from './context';
+import type { DataRegistry } from '../../types';
 
 /**
  * A custom react hook exposing the registry context for use.
@@ -45,8 +46,8 @@ import { Context } from './context';
  * };
  * ```
  *
- * @return {import('../../types').DataRegistry} A custom react hook exposing the registry context value.
+ * @return A custom react hook exposing the registry context value.
  */
-export default function useRegistry() {
+export default function useRegistry(): DataRegistry {
 	return useContext( Context );
 }

package/src/components/use-dispatch/{use-dispatch-with-map.js → use-dispatch-with-map.ts}

@@ -8,6 +8,12 @@ import { useIsomorphicLayoutEffect } from '@wordpress/compose';
  * Internal dependencies
  */
 import useRegistry from '../registry-provider/use-registry';
+import type { DataRegistry } from '../../types';
+
+type DispatchMap = (
+	dispatch: DataRegistry[ 'dispatch' ],
+	registry: DataRegistry
+) => Record< string, ( ...args: unknown[] ) => unknown >;
 
 /**
  * Custom react hook for returning aggregate dispatch actions using the provided
@@ -15,15 +21,18 @@ import useRegistry from '../registry-provider/use-registry';
  *
  * Currently this is an internal api only and is implemented by `withDispatch`
  *
- * @param {Function} dispatchMap Receives the `registry.dispatch` function as
- *                               the first argument and the `registry` object
- *                               as the second argument.  Should return an
- *                               object mapping props to functions.
- * @param {Array}    deps        An array of dependencies for the hook.
- * @return {Object}  An object mapping props to functions created by the passed
- *                   in dispatchMap.
+ * @param dispatchMap Receives the `registry.dispatch` function as
+ *                    the first argument and the `registry` object
+ *                    as the second argument.  Should return an
+ *                    object mapping props to functions.
+ * @param deps        An array of dependencies for the hook.
+ * @return An object mapping props to functions created by the passed
+ *         in dispatchMap.
  */
-const useDispatchWithMap = ( dispatchMap, deps ) => {
+const useDispatchWithMap = (
+	dispatchMap: DispatchMap,
+	deps: unknown[]
+): Record< string, ( ...args: unknown[] ) => unknown > => {
 	const registry = useRegistry();
 	const currentDispatchMapRef = useRef( dispatchMap );
 
@@ -47,7 +56,7 @@ const useDispatchWithMap = ( dispatchMap, deps ) => {
 					}
 					return [
 						propName,
-						( ...args ) =>
+						( ...args: unknown[] ) =>
 							currentDispatchMapRef
 								.current( registry.dispatch, registry )
 								[ propName ]( ...args ),

package/src/components/use-dispatch/{use-dispatch.js → use-dispatch.ts}

@@ -2,15 +2,11 @@
  * Internal dependencies
  */
 import useRegistry from '../registry-provider/use-registry';
-
-/**
- * @typedef {import('../../types').StoreDescriptor<StoreConfig>} StoreDescriptor
- * @template {import('../../types').AnyConfig} StoreConfig
- */
-/**
- * @typedef {import('../../types').UseDispatchReturn<StoreNameOrDescriptor>} UseDispatchReturn
- * @template StoreNameOrDescriptor
- */
+import type {
+	StoreDescriptor,
+	AnyConfig,
+	UseDispatchReturn,
+} from '../../types';
 
 /**
  * A custom react hook returning the current registry dispatch actions creators.
@@ -18,12 +14,11 @@ import useRegistry from '../registry-provider/use-registry';
  * Note: The component using this hook must be within the context of a
  * RegistryProvider.
  *
- * @template {undefined | string | StoreDescriptor<any>} StoreNameOrDescriptor
- * @param {StoreNameOrDescriptor} [storeNameOrDescriptor] Optionally provide the name of the
- *                                                        store or its descriptor from which to
- *                                                        retrieve action creators. If not
- *                                                        provided, the registry.dispatch
- *                                                        function is returned instead.
+ * @param storeNameOrDescriptor Optionally provide the name of the
+ *                              store or its descriptor from which to
+ *                              retrieve action creators. If not
+ *                              provided, the registry.dispatch
+ *                              function is returned instead.
  *
  * @example
  * This illustrates a pattern where you may need to retrieve dynamic data from
@@ -56,13 +51,23 @@ import useRegistry from '../registry-provider/use-registry';
  * //
  * // <SaleButton>Start Sale!</SaleButton>
  * ```
- * @return {UseDispatchReturn<StoreNameOrDescriptor>} A custom react hook.
+ *
+ * @return The dispatch function or action creators for the store.
  */
-const useDispatch = ( storeNameOrDescriptor ) => {
+const useDispatch = <
+	StoreNameOrDescriptor extends
+		| undefined
+		| string
+		| StoreDescriptor< AnyConfig > = undefined,
+>(
+	storeNameOrDescriptor?: StoreNameOrDescriptor
+): UseDispatchReturn< StoreNameOrDescriptor > => {
 	const { dispatch } = useRegistry();
-	return storeNameOrDescriptor === void 0
-		? dispatch
-		: dispatch( storeNameOrDescriptor );
+	return (
+		storeNameOrDescriptor === void 0
+			? dispatch
+			: dispatch( storeNameOrDescriptor as StoreDescriptor< AnyConfig > )
+	) as UseDispatchReturn< StoreNameOrDescriptor >;
 };
 
 export default useDispatch;