UNPKG

@wordpress/data

Version:
162 lines 6.01 kB
export { default as withSelect } from "./components/with-select"; export { default as withDispatch } from "./components/with-dispatch"; export { default as withRegistry } from "./components/with-registry"; export { useDispatch } from "./components/use-dispatch"; export { AsyncModeProvider } from "./components/async-mode-provider"; export { createRegistry } from "./registry"; export { createSelector } from "./create-selector"; export { controls } from "./controls"; export { default as createReduxStore } from "./redux-store"; export { dispatch } from "./dispatch"; export { select } from "./select"; export { plugins }; /** * The combineReducers helper function turns an object whose values are different * reducing functions into a single reducing function you can pass to registerReducer. * * @type {import('./types').combineReducers} * @param {Object} reducers An object whose values correspond to different reducing * functions that need to be combined into one. * * @example * ```js * import { combineReducers, createReduxStore, register } from '@wordpress/data'; * * const prices = ( state = {}, action ) => { * return action.type === 'SET_PRICE' ? * { * ...state, * [ action.item ]: action.price, * } : * state; * }; * * const discountPercent = ( state = 0, action ) => { * return action.type === 'START_SALE' ? * action.discountPercent : * state; * }; * * const store = createReduxStore( 'my-shop', { * reducer: combineReducers( { * prices, * discountPercent, * } ), * } ); * register( store ); * ``` * * @return {Function} A reducer that invokes every reducer inside the reducers * object, and constructs a state object with the same shape. */ export const combineReducers: import("./types").combineReducers; /** * Given a store descriptor, returns an object containing the store's selectors pre-bound to state * so that you only need to supply additional arguments, and modified so that they return promises * that resolve to their eventual values, after any resolvers have ran. * * @param {StoreDescriptor|string} storeNameOrDescriptor The store descriptor. The legacy calling * convention of passing the store name is * also supported. * * @example * ```js * import { resolveSelect } from '@wordpress/data'; * import { store as myCustomStore } from 'my-custom-store'; * * resolveSelect( myCustomStore ).getPrice( 'hammer' ).then(console.log) * ``` * * @return {Object} Object containing the store's promise-wrapped selectors. */ export const resolveSelect: any; /** * Given a store descriptor, returns an object containing the store's selectors pre-bound to state * so that you only need to supply additional arguments, and modified so that they throw promises * in case the selector is not resolved yet. * * @param {StoreDescriptor|string} storeNameOrDescriptor The store descriptor. The legacy calling * convention of passing the store name is * also supported. * * @return {Object} Object containing the store's suspense-wrapped selectors. */ export const suspendSelect: any; /** * Given a listener function, the function will be called any time the state value * of one of the registered stores has changed. If you specify the optional * `storeNameOrDescriptor` parameter, the listener function will be called only * on updates on that one specific registered store. * * This function returns an `unsubscribe` function used to stop the subscription. * * @param {Function} listener Callback function. * @param {string|StoreDescriptor?} storeNameOrDescriptor Optional store name. * * @example * ```js * import { subscribe } from '@wordpress/data'; * * const unsubscribe = subscribe( () => { * // You could use this opportunity to test whether the derived result of a * // selector has subsequently changed as the result of a state update. * } ); * * // Later, if necessary... * unsubscribe(); * ``` */ export const subscribe: Function; /** * Registers a generic store instance. * * @deprecated Use `register( storeDescriptor )` instead. * * @param {string} name Store registry name. * @param {Object} store Store instance (`{ getSelectors, getActions, subscribe }`). */ export const registerGenericStore: Function; /** * Registers a standard `@wordpress/data` store. * * @deprecated Use `register` instead. * * @param {string} storeName Unique namespace identifier for the store. * @param {Object} options Store description (reducer, actions, selectors, resolvers). * * @return {Object} Registered store object. */ export const registerStore: Function; /** * Extends a registry to inherit functionality provided by a given plugin. A * plugin is an object with properties aligning to that of a registry, merged * to extend the default registry behavior. * * @param {Object} plugin Plugin object. */ export const use: any; /** * Registers a standard `@wordpress/data` store descriptor. * * @example * ```js * import { createReduxStore, register } from '@wordpress/data'; * * const store = createReduxStore( 'demo', { * reducer: ( state = 'OK' ) => state, * selectors: { * getValue: ( state ) => state, * }, * } ); * register( store ); * ``` * * @param {StoreDescriptor} store Store descriptor. */ export const register: any; export type StoreDescriptor = import("./types").StoreDescriptor<any>; import * as plugins from './plugins'; export { RegistryProvider, RegistryConsumer, useRegistry } from "./components/registry-provider"; export { default as useSelect, useSuspenseSelect } from "./components/use-select"; export { createRegistrySelector, createRegistryControl } from "./factory"; //# sourceMappingURL=index.d.ts.map