diff --git a/packages/annotations/src/store/index.js b/packages/annotations/src/store/index.js
index 6a2b29f7f73c5..c50d25eff3872 100644
--- a/packages/annotations/src/store/index.js
+++ b/packages/annotations/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -22,7 +25,7 @@ const STORE_NAME = 'core/annotations';
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, {
reducer,
diff --git a/packages/block-directory/src/store/index.js b/packages/block-directory/src/store/index.js
index 144f11ab0a8c1..fd37ab9901b77 100644
--- a/packages/block-directory/src/store/index.js
+++ b/packages/block-directory/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
import { controls as dataControls } from '@wordpress/data-controls';
/**
@@ -40,6 +43,6 @@ export const storeConfig = {
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, storeConfig );
diff --git a/packages/block-editor/src/store/index.js b/packages/block-editor/src/store/index.js
index f7f4d3921700a..8dd9162d5ca27 100644
--- a/packages/block-editor/src/store/index.js
+++ b/packages/block-editor/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -38,7 +41,7 @@ export const storeConfig = {
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
const store = registerStore( STORE_NAME, {
...storeConfig,
diff --git a/packages/blocks/src/store/index.js b/packages/blocks/src/store/index.js
index b18a5b4756faf..52feae11b46ec 100644
--- a/packages/blocks/src/store/index.js
+++ b/packages/blocks/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -19,6 +22,6 @@ const STORE_NAME = 'core/blocks';
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, { reducer, selectors, actions } );
diff --git a/packages/core-data/src/index.js b/packages/core-data/src/index.js
index 7f8e3e31724a2..b87f7b8e90f2b 100644
--- a/packages/core-data/src/index.js
+++ b/packages/core-data/src/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
import { controls } from '@wordpress/data-controls';
/**
@@ -70,7 +73,7 @@ export const storeConfig = {
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
registerStore( STORE_NAME, storeConfig );
diff --git a/packages/data/README.md b/packages/data/README.md
index 8ce4f50d1a60a..dde5ee64b3b3c 100644
--- a/packages/data/README.md
+++ b/packages/data/README.md
@@ -432,24 +432,6 @@ _Returns_
- `Function`: Registry selector that can be registered with a store.
-# **createStoreDefinition**
-
-Creates a store definition to pass to store API methods.
-
-_Usage_
-
-```js
-const storeDefinition = createStoreDefinition( 'my-shop' );
-```
-
-_Parameters_
-
-- _storeName_ `string`: Unique namespace identifier for the store.
-
-_Returns_
-
-- `Object`: Store definition object.
-
# **dispatch**
Given the name of a registered store, returns an object of the store's action creators.
diff --git a/packages/data/src/factory.js b/packages/data/src/factory.js
index 8f289a675fd24..86c42c461ac97 100644
--- a/packages/data/src/factory.js
+++ b/packages/data/src/factory.js
@@ -85,14 +85,14 @@ export function createRegistryControl( registryControl ) {
*
* @example
* ```js
- * const storeDefinition = createStoreDefinition( 'my-shop' );
+ * const storeDefinition = __unstableCreateStoreDefinition( 'my-shop' );
* ```
*
* @param {string} storeName Unique namespace identifier for the store.
*
* @return {Object} Store definition object.
*/
-export function createStoreDefinition( storeName ) {
+export function __unstableCreateStoreDefinition( storeName ) {
return {
name: storeName,
toString() {
diff --git a/packages/data/src/index.js b/packages/data/src/index.js
index e7c6e20419bc8..56d5b68d70173 100644
--- a/packages/data/src/index.js
+++ b/packages/data/src/index.js
@@ -24,7 +24,7 @@ export { createRegistry } from './registry';
export {
createRegistrySelector,
createRegistryControl,
- createStoreDefinition,
+ __unstableCreateStoreDefinition,
} from './factory';
export { controls } from './controls';
diff --git a/packages/data/src/test/factory.js b/packages/data/src/test/factory.js
index 68fc2e01da228..b20b49d09dc36 100644
--- a/packages/data/src/test/factory.js
+++ b/packages/data/src/test/factory.js
@@ -1,17 +1,17 @@
/**
* Internal dependencies
*/
-import { createStoreDefinition } from '../factory';
+import { __unstableCreateStoreDefinition } from '../factory';
-describe( 'createStoreDefinition', () => {
+describe( '__unstableCreateStoreDefinition', () => {
it( 'creates store definition', () => {
- const result = createStoreDefinition( 'my-shop' );
+ const result = __unstableCreateStoreDefinition( 'my-shop' );
expect( result.name ).toBe( 'my-shop' );
} );
it( 'casts the definition to string', () => {
- const result = createStoreDefinition( 'my-shop' );
+ const result = __unstableCreateStoreDefinition( 'my-shop' );
expect( String( result ) ).toBe( 'my-shop' );
} );
diff --git a/packages/data/src/test/registry.js b/packages/data/src/test/registry.js
index a57edf25ea48f..7edf965ec1c36 100644
--- a/packages/data/src/test/registry.js
+++ b/packages/data/src/test/registry.js
@@ -7,7 +7,10 @@ import { castArray, mapValues } from 'lodash';
* Internal dependencies
*/
import { createRegistry } from '../registry';
-import { createRegistrySelector, createStoreDefinition } from '../factory';
+import {
+ createRegistrySelector,
+ __unstableCreateStoreDefinition,
+} from '../factory';
jest.useFakeTimers();
@@ -553,7 +556,9 @@ describe( 'createRegistry', () => {
it( 'should work with the store definition as param for select', () => {
const STORE_NAME = 'demo';
- const storeDefinition = createStoreDefinition( STORE_NAME );
+ const storeDefinition = __unstableCreateStoreDefinition(
+ STORE_NAME
+ );
registry.registerStore( STORE_NAME, {
reducer: ( state = 'OK' ) => state,
selectors: {
@@ -699,7 +704,9 @@ describe( 'createRegistry', () => {
it( 'should work with the store object as param for dispatch', async () => {
const STORE_NAME = 'demo';
- const storeDefinition = createStoreDefinition( STORE_NAME );
+ const storeDefinition = __unstableCreateStoreDefinition(
+ STORE_NAME
+ );
const store = registry.registerStore( STORE_NAME, {
reducer( state = 'OK', action ) {
if ( action.type === 'UPDATE' ) {
diff --git a/packages/edit-navigation/src/store/index.js b/packages/edit-navigation/src/store/index.js
index d69cbb1436c98..efc941df568ac 100644
--- a/packages/edit-navigation/src/store/index.js
+++ b/packages/edit-navigation/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -39,6 +42,6 @@ export const storeConfig = {
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, storeConfig );
diff --git a/packages/edit-post/src/store/index.js b/packages/edit-post/src/store/index.js
index c64f3e2eaeda0..ae49f41e99b61 100644
--- a/packages/edit-post/src/store/index.js
+++ b/packages/edit-post/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -19,7 +22,7 @@ import { STORE_NAME } from './constants';
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
const store = registerStore( STORE_NAME, {
reducer,
diff --git a/packages/edit-widgets/src/store/index.js b/packages/edit-widgets/src/store/index.js
index e88e3c23ad655..43035dd9d737b 100644
--- a/packages/edit-widgets/src/store/index.js
+++ b/packages/edit-widgets/src/store/index.js
@@ -2,7 +2,10 @@
* WordPress dependencies
*/
import apiFetch from '@wordpress/api-fetch';
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -41,7 +44,7 @@ export const storeConfig = {
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
const store = registerStore( STORE_NAME, storeConfig );
diff --git a/packages/editor/src/store/index.js b/packages/editor/src/store/index.js
index 107e15dce68f6..c828de0bf8f2d 100644
--- a/packages/editor/src/store/index.js
+++ b/packages/editor/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
import { controls as dataControls } from '@wordpress/data-controls';
/**
@@ -37,7 +40,7 @@ export const storeConfig = {
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, {
...storeConfig,
diff --git a/packages/interface/src/store/index.js b/packages/interface/src/store/index.js
index 60aa2673b674b..cd61db476eab3 100644
--- a/packages/interface/src/store/index.js
+++ b/packages/interface/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -18,7 +21,7 @@ import { STORE_NAME } from './constants';
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, {
reducer,
diff --git a/packages/keyboard-shortcuts/src/store/index.js b/packages/keyboard-shortcuts/src/store/index.js
index 5caf1e387b6b6..0302155d2304b 100644
--- a/packages/keyboard-shortcuts/src/store/index.js
+++ b/packages/keyboard-shortcuts/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -19,7 +22,7 @@ const STORE_NAME = 'core/keyboard-shortcuts';
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, {
reducer,
diff --git a/packages/notices/src/store/index.js b/packages/notices/src/store/index.js
index f5eab2df54b04..62fbaf44ddcb9 100644
--- a/packages/notices/src/store/index.js
+++ b/packages/notices/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -19,7 +22,7 @@ const STORE_NAME = 'core/notices';
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, {
reducer,
diff --git a/packages/nux/src/store/index.js b/packages/nux/src/store/index.js
index d60386dc54cc2..e85a0ccd1f18a 100644
--- a/packages/nux/src/store/index.js
+++ b/packages/nux/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -19,7 +22,7 @@ const STORE_NAME = 'core/nux';
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, {
reducer,
diff --git a/packages/reusable-blocks/src/store/index.js b/packages/reusable-blocks/src/store/index.js
index 409e67646df2d..78407be7a094d 100644
--- a/packages/reusable-blocks/src/store/index.js
+++ b/packages/reusable-blocks/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -20,7 +23,7 @@ const STORE_NAME = 'core/reusable-blocks';
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, {
actions,
diff --git a/packages/rich-text/src/store/index.js b/packages/rich-text/src/store/index.js
index e55fb8090e0cf..0c885ec2408f5 100644
--- a/packages/rich-text/src/store/index.js
+++ b/packages/rich-text/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -19,7 +22,7 @@ const STORE_NAME = 'core/rich-text';
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, {
reducer,
diff --git a/packages/viewport/src/store/index.js b/packages/viewport/src/store/index.js
index 4a4994af64738..b86310cae7491 100644
--- a/packages/viewport/src/store/index.js
+++ b/packages/viewport/src/store/index.js
@@ -1,7 +1,10 @@
/**
* WordPress dependencies
*/
-import { createStoreDefinition, registerStore } from '@wordpress/data';
+import {
+ __unstableCreateStoreDefinition,
+ registerStore,
+} from '@wordpress/data';
/**
* Internal dependencies
@@ -19,7 +22,7 @@ const STORE_NAME = 'core/viewport';
*
* @type {Object}
*/
-export const storeDefinition = createStoreDefinition( STORE_NAME );
+export const storeDefinition = __unstableCreateStoreDefinition( STORE_NAME );
export default registerStore( STORE_NAME, {
reducer,