tinybase 5.5.0-beta.0 → 6.0.0-beta.0

package/@types/mergeable-store/index.d.cts

@@ -823,8 +823,11 @@ export interface MergeableStore extends Store {
    * The method is generally intended to be used internally within TinyBase
    * itself and the return type is assumed to be opaque to applications that use
    * it.
+   *
+   * Since v5.4.2, this method can also take a function that returns the
+   * content.
    * @param content An array containing the tabular and keyed-value data to be
-   * set.
+   * set, or a function that returns the array.
    * @returns A reference to the MergeableStore.
    * @example
    * This example creates a new MergeableStore with default data, and
@@ -849,7 +852,7 @@ export interface MergeableStore extends Store {
    * @category Setter
    * @since v5.0.0
    */
-  setDefaultContent(content: Content): MergeableStore;
+  setDefaultContent(content: Content | (() => Content)): MergeableStore;
 
   /**
    * The getTransactionMergeableChanges method returns the net meaningful

package/@types/mergeable-store/index.d.ts

@@ -823,8 +823,11 @@ export interface MergeableStore extends Store {
    * The method is generally intended to be used internally within TinyBase
    * itself and the return type is assumed to be opaque to applications that use
    * it.
+   *
+   * Since v5.4.2, this method can also take a function that returns the
+   * content.
    * @param content An array containing the tabular and keyed-value data to be
-   * set.
+   * set, or a function that returns the array.
    * @returns A reference to the MergeableStore.
    * @example
    * This example creates a new MergeableStore with default data, and
@@ -849,7 +852,7 @@ export interface MergeableStore extends Store {
    * @category Setter
    * @since v5.0.0
    */
-  setDefaultContent(content: Content): MergeableStore;
+  setDefaultContent(content: Content | (() => Content)): MergeableStore;
 
   /**
    * The getTransactionMergeableChanges method returns the net meaningful

package/@types/mergeable-store/with-schemas/index.d.cts

@@ -1055,7 +1055,7 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * This has schema-based typing. The following is a simplified representation:
    *
    * ```ts override
-   * setDefaultContent(content: Content): MergeableStore;
+   * setDefaultContent(content: Content | (() => Content)): MergeableStore;
    * ```
    *
    * This differs from the setMergeableContent method in that all of the
@@ -1066,8 +1066,11 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * The method is generally intended to be used internally within TinyBase
    * itself and the return type is assumed to be opaque to applications that use
    * it.
+   *
+   * Since v5.4.2, this method can also take a function that returns the
+   * content.
    * @param content An array containing the tabular and keyed-value data to be
-   * set.
+   * set, or a function that returns the array.
    * @returns A reference to the MergeableStore.
    * @example
    * This example creates a new MergeableStore with default data, and
@@ -1092,7 +1095,9 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * @category Setter
    * @since v5.0.0
    */
-  setDefaultContent(content: Content<Schemas>): MergeableStore<Schemas>;
+  setDefaultContent(
+    content: Content<Schemas> | (() => Content<Schemas>),
+  ): MergeableStore<Schemas>;
 
   /**
    * The getTransactionMergeableChanges method returns the net meaningful

package/@types/mergeable-store/with-schemas/index.d.ts

@@ -1055,7 +1055,7 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * This has schema-based typing. The following is a simplified representation:
    *
    * ```ts override
-   * setDefaultContent(content: Content): MergeableStore;
+   * setDefaultContent(content: Content | (() => Content)): MergeableStore;
    * ```
    *
    * This differs from the setMergeableContent method in that all of the
@@ -1066,8 +1066,11 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * The method is generally intended to be used internally within TinyBase
    * itself and the return type is assumed to be opaque to applications that use
    * it.
+   *
+   * Since v5.4.2, this method can also take a function that returns the
+   * content.
    * @param content An array containing the tabular and keyed-value data to be
-   * set.
+   * set, or a function that returns the array.
    * @returns A reference to the MergeableStore.
    * @example
    * This example creates a new MergeableStore with default data, and
@@ -1092,7 +1095,9 @@ export interface MergeableStore<Schemas extends OptionalSchemas>
    * @category Setter
    * @since v5.0.0
    */
-  setDefaultContent(content: Content<Schemas>): MergeableStore<Schemas>;
+  setDefaultContent(
+    content: Content<Schemas> | (() => Content<Schemas>),
+  ): MergeableStore<Schemas>;
 
   /**
    * The getTransactionMergeableChanges method returns the net meaningful

package/@types/persisters/index.d.cts

@@ -928,6 +928,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * fails (for example when the Persister is remote and the environment is
    * offline). This allows you to fallback or instantiate a Store whether it's
    * loading from previously persisted storage or being run for the first time.
+   * Since v5.4.2, this parameter can also be a function that returns the
+   * content.
    *
    * This method is asynchronous because the persisted data may be on a remote
    * machine or a filesystem. Even for those storage types that are synchronous
@@ -983,7 +985,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * @category Load
    * @since v1.0.0
    */
-  load(initialContent?: Content): Promise<this>;
+  load(initialContent?: Content | (() => Content)): Promise<this>;
 
   /**
    * The startAutoLoad method gets persisted data from storage, and loads it
@@ -995,6 +997,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * fails (for example when the Persister is remote and the environment is
    * offline). This allows you to fallback or instantiate a Store whether it's
    * loading from previously persisted storage or being run for the first time.
+   * Since v5.4.2, this parameter can also be a function that returns the
+   * content.
    *
    * This method first runs a single call to the load method to ensure the data
    * is in sync with the persisted storage. It then continues to watch for
@@ -1040,7 +1044,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * @category Load
    * @since v1.0.0
    */
-  startAutoLoad(initialContent?: Content): Promise<this>;
+  startAutoLoad(initialContent?: Content | (() => Content)): Promise<this>;
 
   /**
    * The stopAutoLoad method stops the automatic loading of data from storage

package/@types/persisters/index.d.ts

@@ -928,6 +928,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * fails (for example when the Persister is remote and the environment is
    * offline). This allows you to fallback or instantiate a Store whether it's
    * loading from previously persisted storage or being run for the first time.
+   * Since v5.4.2, this parameter can also be a function that returns the
+   * content.
    *
    * This method is asynchronous because the persisted data may be on a remote
    * machine or a filesystem. Even for those storage types that are synchronous
@@ -983,7 +985,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * @category Load
    * @since v1.0.0
    */
-  load(initialContent?: Content): Promise<this>;
+  load(initialContent?: Content | (() => Content)): Promise<this>;
 
   /**
    * The startAutoLoad method gets persisted data from storage, and loads it
@@ -995,6 +997,8 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * fails (for example when the Persister is remote and the environment is
    * offline). This allows you to fallback or instantiate a Store whether it's
    * loading from previously persisted storage or being run for the first time.
+   * Since v5.4.2, this parameter can also be a function that returns the
+   * content.
    *
    * This method first runs a single call to the load method to ensure the data
    * is in sync with the persisted storage. It then continues to watch for
@@ -1040,7 +1044,7 @@ export interface Persister<Persist extends Persists = Persists.StoreOnly> {
    * @category Load
    * @since v1.0.0
    */
-  startAutoLoad(initialContent?: Content): Promise<this>;
+  startAutoLoad(initialContent?: Content | (() => Content)): Promise<this>;
 
   /**
    * The stopAutoLoad method stops the automatic loading of data from storage

package/@types/persisters/with-schemas/index.d.cts

@@ -1003,7 +1003,7 @@ export interface Persister<
    * This has schema-based typing. The following is a simplified representation:
    *
    * ```ts override
-   * load(initialContent?: Content): Promise<this>;
+   * load(initialContent?: Content | (() => Content)): Promise<this>;
    * ```
    *
    * The optional parameter allows you to specify what the initial content for
@@ -1011,6 +1011,8 @@ export interface Persister<
    * fails (for example when the Persister is remote and the environment is
    * offline). This allows you to fallback or instantiate a Store whether it's
    * loading from previously persisted storage or being run for the first time.
+   * Since v5.4.2, this parameter can also be a function that returns the
+   * content.
    *
    * This method is asynchronous because the persisted data may be on a remote
    * machine or a filesystem. Even for those storage types that are synchronous
@@ -1066,7 +1068,9 @@ export interface Persister<
    * @category Load
    * @since v1.0.0
    */
-  load(initialContent?: Content<Schemas, true>): Promise<this>;
+  load(
+    initialContent?: Content<Schemas, true> | (() => Content<Schemas, true>),
+  ): Promise<this>;
 
   /**
    * The startAutoLoad method gets persisted data from storage, and loads it
@@ -1076,7 +1080,7 @@ export interface Persister<
    * This has schema-based typing. The following is a simplified representation:
    *
    * ```ts override
-   * startAutoLoad(initialContent?: Content): Promise<this>;
+   * startAutoLoad(initialContent?: Content | (() => Content)): Promise<this>;
    * ```
    *
    * The optional parameter allows you to specify what the initial content for
@@ -1084,6 +1088,8 @@ export interface Persister<
    * fails (for example when the Persister is remote and the environment is
    * offline). This allows you to fallback or instantiate a Store whether it's
    * loading from previously persisted storage or being run for the first time.
+   * Since v5.4.2, this parameter can also be a function that returns the
+   * content.
    *
    * This method first runs a single call to the load method to ensure the data
    * is in sync with the persisted storage. It then continues to watch for
@@ -1129,7 +1135,9 @@ export interface Persister<
    * @category Load
    * @since v1.0.0
    */
-  startAutoLoad(initialContent?: Content<Schemas, true>): Promise<this>;
+  startAutoLoad(
+    initialContent?: Content<Schemas, true> | (() => Content<Schemas, true>),
+  ): Promise<this>;
 
   /**
    * The stopAutoLoad method stops the automatic loading of data from storage

package/@types/persisters/with-schemas/index.d.ts

@@ -1003,7 +1003,7 @@ export interface Persister<
    * This has schema-based typing. The following is a simplified representation:
    *
    * ```ts override
-   * load(initialContent?: Content): Promise<this>;
+   * load(initialContent?: Content | (() => Content)): Promise<this>;
    * ```
    *
    * The optional parameter allows you to specify what the initial content for
@@ -1011,6 +1011,8 @@ export interface Persister<
    * fails (for example when the Persister is remote and the environment is
    * offline). This allows you to fallback or instantiate a Store whether it's
    * loading from previously persisted storage or being run for the first time.
+   * Since v5.4.2, this parameter can also be a function that returns the
+   * content.
    *
    * This method is asynchronous because the persisted data may be on a remote
    * machine or a filesystem. Even for those storage types that are synchronous
@@ -1066,7 +1068,9 @@ export interface Persister<
    * @category Load
    * @since v1.0.0
    */
-  load(initialContent?: Content<Schemas, true>): Promise<this>;
+  load(
+    initialContent?: Content<Schemas, true> | (() => Content<Schemas, true>),
+  ): Promise<this>;
 
   /**
    * The startAutoLoad method gets persisted data from storage, and loads it
@@ -1076,7 +1080,7 @@ export interface Persister<
    * This has schema-based typing. The following is a simplified representation:
    *
    * ```ts override
-   * startAutoLoad(initialContent?: Content): Promise<this>;
+   * startAutoLoad(initialContent?: Content | (() => Content)): Promise<this>;
    * ```
    *
    * The optional parameter allows you to specify what the initial content for
@@ -1084,6 +1088,8 @@ export interface Persister<
    * fails (for example when the Persister is remote and the environment is
    * offline). This allows you to fallback or instantiate a Store whether it's
    * loading from previously persisted storage or being run for the first time.
+   * Since v5.4.2, this parameter can also be a function that returns the
+   * content.
    *
    * This method first runs a single call to the load method to ensure the data
    * is in sync with the persisted storage. It then continues to watch for
@@ -1129,7 +1135,9 @@ export interface Persister<
    * @category Load
    * @since v1.0.0
    */
-  startAutoLoad(initialContent?: Content<Schemas, true>): Promise<this>;
+  startAutoLoad(
+    initialContent?: Content<Schemas, true> | (() => Content<Schemas, true>),
+  ): Promise<this>;
 
   /**
    * The stopAutoLoad method stops the automatic loading of data from storage

package/@types/store/index.d.cts

@@ -2863,8 +2863,11 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
+   *
+   * Since v5.4.2, this method can also take a function that returns the
+   * content.
    * @param content An array containing the tabular and keyed-value data of the
-   * Store to be set.
+   * Store to be set, or a function that returns the array.
    * @returns A reference to the Store.
    * @example
    * This example sets the data of a Store.
@@ -2882,6 +2885,21 @@ export interface Store {
    * // -> {open: true, employees: 3}
    * ```
    * @example
+   * This example sets the data of a Store with the results of a function.
+   *
+   * ```js
+   * import {createStore} from 'tinybase';
+   *
+   * const store = createStore().setContent(() => [
+   *   {pets: {fido: {species: 'dog'}}},
+   *   {open: true, employees: 3},
+   * ]);
+   * console.log(store.getTables());
+   * // -> {pets: {fido: {species: 'dog'}}}
+   * console.log(store.getValues());
+   * // -> {open: true, employees: 3}
+   * ```
+   * @example
    * This example attempts to set the data of an existing Store with partly
    * invalid, and then completely invalid objects.
    *
@@ -2906,7 +2924,7 @@ export interface Store {
    * @category Setter
    * @since v4.0.0
    */
-  setContent(content: Content): this;
+  setContent(content: Content | (() => Content)): this;
 
   /**
    * The setTables method takes an object and sets the entire tabular data of

package/@types/store/index.d.ts

@@ -2863,8 +2863,11 @@ export interface Store {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
+   *
+   * Since v5.4.2, this method can also take a function that returns the
+   * content.
    * @param content An array containing the tabular and keyed-value data of the
-   * Store to be set.
+   * Store to be set, or a function that returns the array.
    * @returns A reference to the Store.
    * @example
    * This example sets the data of a Store.
@@ -2882,6 +2885,21 @@ export interface Store {
    * // -> {open: true, employees: 3}
    * ```
    * @example
+   * This example sets the data of a Store with the results of a function.
+   *
+   * ```js
+   * import {createStore} from 'tinybase';
+   *
+   * const store = createStore().setContent(() => [
+   *   {pets: {fido: {species: 'dog'}}},
+   *   {open: true, employees: 3},
+   * ]);
+   * console.log(store.getTables());
+   * // -> {pets: {fido: {species: 'dog'}}}
+   * console.log(store.getValues());
+   * // -> {open: true, employees: 3}
+   * ```
+   * @example
    * This example attempts to set the data of an existing Store with partly
    * invalid, and then completely invalid objects.
    *
@@ -2906,7 +2924,7 @@ export interface Store {
    * @category Setter
    * @since v4.0.0
    */
-  setContent(content: Content): this;
+  setContent(content: Content | (() => Content)): this;
 
   /**
    * The setTables method takes an object and sets the entire tabular data of

package/@types/store/with-schemas/index.d.cts

@@ -3965,7 +3965,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * This has schema-based typing. The following is a simplified representation:
    *
    * ```ts override
-   * setContent(content: Content): this;
+   * setContent(content: Content | (() => Content)): this;
    * ```
    *
    * This method will cause listeners to be called for any Table, Row, Cell,
@@ -3982,8 +3982,11 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
+   *
+   * Since v5.4.2, this method can also take a function that returns the
+   * content.
    * @param content An array containing the tabular and keyed-value data of the
-   * Store to be set.
+   * Store to be set, or a function that returns the array.
    * @returns A reference to the Store.
    * @example
    * This example sets the data of a Store.
@@ -4001,6 +4004,21 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {open: true, employees: 3}
    * ```
    * @example
+   * This example sets the data of a Store with the results of a function.
+   *
+   * ```js
+   * import {createStore} from 'tinybase';
+   *
+   * const store = createStore().setContent(() => [
+   *   {pets: {fido: {species: 'dog'}}},
+   *   {open: true, employees: 3},
+   * ]);
+   * console.log(store.getTables());
+   * // -> {pets: {fido: {species: 'dog'}}}
+   * console.log(store.getValues());
+   * // -> {open: true, employees: 3}
+   * ```
+   * @example
    * This example attempts to set the data of an existing Store with partly
    * invalid, and then completely invalid objects.
    *
@@ -4025,7 +4043,9 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * @category Setter
    * @since v4.0.0
    */
-  setContent(content: Content<Schemas, true>): this;
+  setContent(
+    content: Content<Schemas, true> | (() => Content<Schemas, true>),
+  ): this;
 
   /**
    * The setTables method takes an object and sets the entire tabular data of

package/@types/store/with-schemas/index.d.ts

@@ -3965,7 +3965,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * This has schema-based typing. The following is a simplified representation:
    *
    * ```ts override
-   * setContent(content: Content): this;
+   * setContent(content: Content | (() => Content)): this;
    * ```
    *
    * This method will cause listeners to be called for any Table, Row, Cell,
@@ -3982,8 +3982,11 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * The method returns a reference to the Store so that subsequent operations
    * can be chained in a fluent style.
+   *
+   * Since v5.4.2, this method can also take a function that returns the
+   * content.
    * @param content An array containing the tabular and keyed-value data of the
-   * Store to be set.
+   * Store to be set, or a function that returns the array.
    * @returns A reference to the Store.
    * @example
    * This example sets the data of a Store.
@@ -4001,6 +4004,21 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {open: true, employees: 3}
    * ```
    * @example
+   * This example sets the data of a Store with the results of a function.
+   *
+   * ```js
+   * import {createStore} from 'tinybase';
+   *
+   * const store = createStore().setContent(() => [
+   *   {pets: {fido: {species: 'dog'}}},
+   *   {open: true, employees: 3},
+   * ]);
+   * console.log(store.getTables());
+   * // -> {pets: {fido: {species: 'dog'}}}
+   * console.log(store.getValues());
+   * // -> {open: true, employees: 3}
+   * ```
+   * @example
    * This example attempts to set the data of an existing Store with partly
    * invalid, and then completely invalid objects.
    *
@@ -4025,7 +4043,9 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * @category Setter
    * @since v4.0.0
    */
-  setContent(content: Content<Schemas, true>): this;
+  setContent(
+    content: Content<Schemas, true> | (() => Content<Schemas, true>),
+  ): this;
 
   /**
    * The setTables method takes an object and sets the entire tabular data of

package/@types/synchronizers/synchronizer-ws-server/index.d.cts

@@ -700,7 +700,10 @@ export interface WsServer {
  * // On the server:
  * const webSocketServer = new WebSocketServer({port: 8047});
  * webSocketServer.on('connection', (_, request) => {
- *   console.log('Client address: ' + request.socket.remoteAddress);
+ *   const clientAddress = request.socket.remoteAddress;
+ *   if (clientAddress == '::1' || clientAddress == '::ffff:127.0.0.1') {
+ *     console.log('Local client connected');
+ *   }
  * });
  * const server = createWsServer(webSocketServer);
  *
@@ -709,7 +712,7 @@ export interface WsServer {
  *   createMergeableStore(),
  *   new WebSocket('ws://localhost:8047'),
  * );
- * // -> 'Client address: ::1'
+ * // -> 'Local client connected'
  *
  * synchronizer.destroy();
  * server.destroy();

package/@types/synchronizers/synchronizer-ws-server/index.d.ts

@@ -700,7 +700,10 @@ export interface WsServer {
  * // On the server:
  * const webSocketServer = new WebSocketServer({port: 8047});
  * webSocketServer.on('connection', (_, request) => {
- *   console.log('Client address: ' + request.socket.remoteAddress);
+ *   const clientAddress = request.socket.remoteAddress;
+ *   if (clientAddress == '::1' || clientAddress == '::ffff:127.0.0.1') {
+ *     console.log('Local client connected');
+ *   }
  * });
  * const server = createWsServer(webSocketServer);
  *
@@ -709,7 +712,7 @@ export interface WsServer {
  *   createMergeableStore(),
  *   new WebSocket('ws://localhost:8047'),
  * );
- * // -> 'Client address: ::1'
+ * // -> 'Local client connected'
  *
  * synchronizer.destroy();
  * server.destroy();

package/@types/synchronizers/synchronizer-ws-server/with-schemas/index.d.cts

@@ -727,7 +727,10 @@ export interface WsServer {
  * // On the server:
  * const webSocketServer = new WebSocketServer({port: 8047});
  * webSocketServer.on('connection', (_, request) => {
- *   console.log('Client address: ' + request.socket.remoteAddress);
+ *   const clientAddress = request.socket.remoteAddress;
+ *   if (clientAddress == '::1' || clientAddress == '::ffff:127.0.0.1') {
+ *     console.log('Local client connected');
+ *   }
  * });
  * const server = createWsServer(webSocketServer);
  *
@@ -736,7 +739,7 @@ export interface WsServer {
  *   createMergeableStore(),
  *   new WebSocket('ws://localhost:8047'),
  * );
- * // -> 'Client address: ::1'
+ * // -> 'Local client connected'
  *
  * synchronizer.destroy();
  * server.destroy();

package/@types/synchronizers/synchronizer-ws-server/with-schemas/index.d.ts

@@ -727,7 +727,10 @@ export interface WsServer {
  * // On the server:
  * const webSocketServer = new WebSocketServer({port: 8047});
  * webSocketServer.on('connection', (_, request) => {
- *   console.log('Client address: ' + request.socket.remoteAddress);
+ *   const clientAddress = request.socket.remoteAddress;
+ *   if (clientAddress == '::1' || clientAddress == '::ffff:127.0.0.1') {
+ *     console.log('Local client connected');
+ *   }
  * });
  * const server = createWsServer(webSocketServer);
  *
@@ -736,7 +739,7 @@ export interface WsServer {
  *   createMergeableStore(),
  *   new WebSocket('ws://localhost:8047'),
  * );
- * // -> 'Client address: ::1'
+ * // -> 'Local client connected'
  *
  * synchronizer.destroy();
  * server.destroy();

package/@types/ui-react/index.d.cts

@@ -499,6 +499,48 @@ export function useStoreIds(): Ids;
  */
 export function useStore(id?: Id): Store | undefined;
 
+/**
+ * The useStores hook is used to get a reference to all the Store objects named
+ * by Id within a Provider component context.
+ *
+ * A Provider component is used to wrap part of an application in a context. It
+ * can contain a default Store (or a set of Store objects named by Id) that can
+ * be easily accessed without having to be passed down as props through every
+ * component.
+ *
+ * The useStores hook lets you get a reference to the latter as an object.
+ * @returns An object containing all the Store objects named by Id.
+ * @example
+ * This example creates a Provider context into which a Store is provided, named
+ * by Id. A component within it then uses the useStores hook to get a reference
+ * to the Store again.
+ *
+ * ```jsx
+ * import {Provider, useStores} from 'tinybase/ui-react';
+ * import React from 'react';
+ * import {createRoot} from 'react-dom/client';
+ * import {createStore} from 'tinybase';
+ *
+ * const App = ({store}) => (
+ *   <Provider storesById={{petStore: store}}>
+ *     <Pane />
+ *   </Provider>
+ * );
+ * const Pane = () => (
+ *   <span>{useStores()['petStore'].getListenerStats().tables}</span>
+ * );
+ *
+ * const store = createStore();
+ * const app = document.createElement('div');
+ * createRoot(app).render(<App store={store} />); // !act
+ * console.log(app.innerHTML);
+ * // -> '<span>0</span>'
+ * ```
+ * @category Store hooks
+ * @since v5.4.1
+ */
+export function useStores(): {[storeId: Id]: Store};
+
 /**
  * The useStoreOrStoreById hook is used to get a reference to a Store object
  * from within a Provider component context, _or_ have it passed directly to