tinybase 4.0.0-beta.4 → 4.0.0-beta.5

package/lib/types/with-schemas/store.d.ts

@@ -6,7 +6,6 @@
  * returns a new Store. From there, you can set and get data, register
  * listeners, and use other modules to build an entire app around the state and
  * tabular data within.
- *
  * @packageDocumentation
  * @module store
  */
@@ -31,7 +30,6 @@ import {Id, IdOrNull, Ids, Json} from './common.d';
  * A TablesSchema comprises a JavaScript object describing each Table, in turn a
  * nested JavaScript object containing information about each Cell and its
  * CellSchema. It is provided to the setTablesSchema method.
- *
  * @example
  * When applied to a Store, this TablesSchema only allows one Table called
  * `pets`, in which each Row may contain a string `species` Cell, and is
@@ -63,7 +61,6 @@ export type TablesSchema = {[tableId: Id]: {[cellId: Id]: CellSchema}};
  * If the default value is _not_ provided (or its type is incorrect), the Cell
  * may be missing from the Row, but when present you can be guaranteed it is of
  * the correct type.
- *
  * @example
  * When applied to a Store, this CellSchema ensures a boolean Cell is always
  * present, and defaults it to `false`.
@@ -84,7 +81,6 @@ export type CellSchema =
  *
  * A ValuesSchema comprises a JavaScript object describing each Value and its
  * ValueSchema. It is provided to the setValuesSchema method.
- *
  * @example
  * When applied to a Store, this ValuesSchema only allows one boolean Value
  * called `open`, that defaults to `false`.
@@ -95,7 +91,7 @@ export type CellSchema =
  * };
  * ```
  * @category Schema
- * @since v3.0
+ * @since v3.0.0
  */
 export type ValuesSchema = {[valueId: Id]: ValueSchema};
 
@@ -113,7 +109,6 @@ export type ValuesSchema = {[valueId: Id]: ValueSchema};
  * If the default value is _not_ provided (or its type is incorrect), the Value
  * may not be present in the Store, but when present you can be guaranteed it is
  * of the correct type.
- *
  * @example
  * When applied to a Store, this ValueSchema ensures a boolean Value is always
  * present, and defaults it to `false`.
@@ -122,7 +117,7 @@ export type ValuesSchema = {[valueId: Id]: ValueSchema};
  * const requiredBoolean: ValueSchema = {type: 'boolean', default: false};
  * ```
  * @category Schema
- * @since v3.0
+ * @since v3.0.0
  */
 export type ValueSchema =
   | {type: 'string'; default?: string}
@@ -132,7 +127,6 @@ export type ValueSchema =
 /**
  * The NoTablesSchema type is a TablesSchema-like type for when one has not been
  * provided.
- *
  * @category Schema
  */
 export type NoTablesSchema = {[tableId: Id]: {[cellId: Id]: {type: 'any'}}};
@@ -140,7 +134,6 @@ export type NoTablesSchema = {[tableId: Id]: {[cellId: Id]: {type: 'any'}}};
 /**
  * The NoValuesSchema type is a ValuesSchema-like type for when one has not been
  * provided.
- *
  * @category Schema
  */
 export type NoValuesSchema = {[valueId: Id]: {type: 'any'}};
@@ -148,7 +141,6 @@ export type NoValuesSchema = {[valueId: Id]: {type: 'any'}};
 /**
  * The OptionalTablesSchema type is used by generic types that can optionally
  * take a TablesSchema.
- *
  * @category Schema
  */
 export type OptionalTablesSchema = TablesSchema | NoTablesSchema;
@@ -156,7 +148,6 @@ export type OptionalTablesSchema = TablesSchema | NoTablesSchema;
 /**
  * The OptionalValuesSchema type is used by generic types that can optionally
  * take a ValuesSchema.
- *
  * @category Schema
  */
 export type OptionalValuesSchema = ValuesSchema | NoValuesSchema;
@@ -164,7 +155,6 @@ export type OptionalValuesSchema = ValuesSchema | NoValuesSchema;
 /**
  * The OptionalSchemas type is used by generic types that can optionally take
  * either or both of a TablesSchema and ValuesSchema.
- *
  * @category Schema
  */
 export type OptionalSchemas = [OptionalTablesSchema, OptionalValuesSchema];
@@ -172,7 +162,6 @@ export type OptionalSchemas = [OptionalTablesSchema, OptionalValuesSchema];
 /**
  * The NoSchemas type is used as a default by generic types that can optionally
  * take either or both of a TablesSchema and ValuesSchema.
- *
  * @category Schema
  */
 export type NoSchemas = [NoTablesSchema, NoValuesSchema];
@@ -191,7 +180,6 @@ export type NoSchemas = [NoTablesSchema, NoValuesSchema];
  * setTables method, and when getting them back out again with the getTables
  * method. A Tables object is a regular JavaScript object containing individual
  * Table objects, keyed by their Id.
- *
  * @example
  * ```js
  * const tables: Tables = {
@@ -231,7 +219,6 @@ export type Tables<
  * getting it back out again with the getTable method. A Table object is a
  * regular JavaScript object containing individual Row objects, keyed by their
  * Id.
- *
  * @example
  * ```js
  * const table: Table = {
@@ -259,7 +246,6 @@ export type Table<
  * A Row is used when setting a row with the setRow method, and when getting it
  * back out again with the getRow method. A Row object is a regular JavaScript
  * object containing individual Cell objects, keyed by their Id.
- *
  * @example
  * ```js
  * const row: Row = {species: 'dog', color: 'brown'};
@@ -304,7 +290,6 @@ export type Row<
  * A Cell is used when setting a cell with the setCell method, and when getting
  * it back out again with the getCell method. A Cell is a JavaScript string,
  * number, or boolean.
- *
  * @example
  * ```js
  * const cell: Cell = 'dog';
@@ -337,7 +322,6 @@ export type Cell<
  * This is used when describing a Cell that is present _or_ that is not present,
  * such as when it has been deleted, or when describing a previous state where
  * the Cell value has since been added.
- *
  * @category Store
  */
 export type CellOrUndefined<
@@ -360,13 +344,12 @@ export type CellOrUndefined<
  * when getting them back out again with the getValues method. A Values object
  * is a regular JavaScript object containing individual Value objects, keyed by
  * their Id.
- *
  * @example
  * ```js
  * const values: Values = {open: true, employees: 4};
  * ```
  * @category Store
- * @since v3.0
+ * @since v3.0.0
  */
 export type Values<
   Schema extends OptionalValuesSchema,
@@ -403,13 +386,12 @@ export type Values<
  * A Value is used when setting a value with the setValue method, and when
  * getting it back out again with the getValue method. A Value is a JavaScript
  * string, number, or boolean.
- *
  * @example
  * ```js
  * const value: Value = 'dog';
  * ```
  * @category Store
- * @since v3.0
+ * @since v3.0.0
  */
 export type Value<
   Schema extends OptionalValuesSchema,
@@ -436,9 +418,8 @@ export type Value<
  * This is used when describing a Value that is present _or_ that is not
  * present, such as when it has been deleted, or when describing a previous
  * state where the Value has since been added.
- *
  * @category Store
- * @since v3.0
+ * @since v3.0.0
  */
 export type ValueOrUndefined<
   Schema extends OptionalValuesSchema,
@@ -461,7 +442,6 @@ export type ValueOrUndefined<
  * A TableCallback is provided when using the forEachTable method, so that you
  * can do something based on every Table in the Store. See that method for
  * specific examples.
- *
  * @param tableId The Id of the Table that the callback can operate on.
  * @param forEachRow A function that will let you iterate over the Row objects
  * in this Table.
@@ -481,6 +461,28 @@ export type TableCallback<
   Params1 extends any[] = Truncate<Params2>,
 > = ((...params: Params2) => void) | ((...params: Params1) => void);
 
+/**
+ * The TableCellCallback type describes a function that takes a Cell's Id and
+ * the count of times it appears across a whole Table.
+ *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (cellId: Id, count: number) => void;
+ * ```
+ *
+ * A TableCellCallback is provided when using the forEachTableCell method, so
+ * that you can do something based on every Cell used across a Table. See that
+ * method for specific examples.
+ * @param cellId The Id of the Cell that the callback can operate on.
+ * @param count The number of times this Cell is used across a whole Table.
+ * @category Callback
+ */
+export type TableCellCallback<
+  Schema extends OptionalTablesSchema,
+  TableId extends TableIdFromSchema<Schema>,
+> = (cellId: CellIdFromSchema<Schema, TableId>, count: number) => void;
+
 /**
  * The RowCallback type describes a function that takes a Row's Id and a
  * callback to loop over each Cell within it.
@@ -497,7 +499,6 @@ export type TableCallback<
  * A RowCallback is provided when using the forEachRow method, so that you can
  * do something based on every Row in a Table. See that method for specific
  * examples.
- *
  * @param rowId The Id of the Row that the callback can operate on.
  * @param forEachRow A function that will let you iterate over the Cell values
  * in this Row.
@@ -528,7 +529,6 @@ export type RowCallback<
  * A CellCallback is provided when using the forEachCell method, so that you can
  * do something based on every Cell in a Row. See that method for specific
  * examples.
- *
  * @param cellId The Id of the Cell that the callback can operate on.
  * @param cell The value of the Cell.
  * @category Callback
@@ -566,11 +566,10 @@ export type CellCallback<
  * A ValueCallback is provided when using the forEachValue method, so that you
  * can do something based on every Value in a Store. See that method for
  * specific examples.
- *
  * @param valueId The Id of the Value that the callback can operate on.
  * @param value The Value itself.
  * @category Callback
- * @since v3.0
+ * @since v3.0.0
  */
 export type ValueCallback<
   Schema extends OptionalValuesSchema,
@@ -600,7 +599,6 @@ export type ValueCallback<
  * A MapCell can be provided in the setCell method to map an existing value to a
  * new one, such as when incrementing a number. See that method for specific
  * examples.
- *
  * @param cell The current value of the Cell to map to a new value.
  * @category Callback
  */
@@ -625,10 +623,9 @@ export type MapCell<
  * A MapValue can be provided in the setValue method to map an existing Value to
  * a new one, such as when incrementing a number. See that method for specific
  * examples.
- *
  * @param value The current Value to map to a new Value.
  * @category Callback
- * @since v3.0
+ * @since v3.0.0
  */
 export type MapValue<
   Schema extends OptionalValuesSchema,
@@ -648,7 +645,6 @@ export type MapValue<
  * A GetCell can be provided when setting definitions, as in the
  * setMetricDefinition method of a Metrics object, or the setIndexDefinition
  * method of an Indexes object. See those methods for specific examples.
- *
  * @param cellId The Id of the Cell to fetch the value for.
  * @category Callback
  */
@@ -795,7 +791,6 @@ export type ChangedValueIds<Schema extends OptionalValuesSchema> = {
  * call to get information about the changes made within the transaction (in
  * order to decide whether to do the rollback). See the GetTransactionChanges
  * and GetTransactionLog function types for more details.
- *
  * @param getTransactionChanges A function to be called to get the changes made
  * to the Store during the transaction, since v4.0.
  * @param getTransactionChanges A function to be called to get a more detailed
@@ -829,7 +824,6 @@ export type DoRollback<Schemas extends OptionalSchemas> = (
  * and, since v4.0, two functions that you can call to get information about the
  * changes made within the transaction. See the GetTransactionChanges and
  * GetTransactionLog function types for more details.
- *
  * @param store A reference to the Store that is completing a transaction.
  * @param getTransactionChanges A function to be called to get the changes made
  * to the Store during the transaction, since v4.0.
@@ -866,7 +860,6 @@ export type TransactionListener<Schemas extends OptionalSchemas> = (
  * Note that if the listener was manually forced to be called (with the
  * callListener method rather than due to a real change in the Store), the
  * GetCellChange function will not be present.
- *
  * @param store A reference to the Store that changed.
  * @param getCellChange A function that returns information about any Cell's
  * changes.
@@ -884,7 +877,10 @@ export type TablesListener<Schemas extends OptionalSchemas> = (
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * (store: Store) => void;
+ * (
+ *   store: Store,
+ *   getIdChanges: GetIdChanges | undefined,
+ * ) => void;
  * ```
  *
  * A TableIdsListener is provided when using the addTableIdsListener method. See
@@ -892,11 +888,16 @@ export type TablesListener<Schemas extends OptionalSchemas> = (
  *
  * When called, a TableIdsListener is given a reference to the Store.
  *
+ * Since v3.3, the listener is also passed a GetIdChanges function that can be
+ * used to query which Ids changed during the transaction.
  * @param store A reference to the Store that changed.
+ * @param getIdChanges A function that returns information about the Id changes,
+ * since v3.3.
  * @category Listener
  */
 export type TableIdsListener<Schemas extends OptionalSchemas> = (
   store: Store<Schemas>,
+  getIdChanges: GetIdChanges<TableIdFromSchema<Schemas[0]>> | undefined,
 ) => void;
 
 /**
@@ -923,7 +924,6 @@ export type TableIdsListener<Schemas extends OptionalSchemas> = (
  * Note that if the listener was manually forced to be called (with the
  * callListener method rather than due to a real change in the Store), the
  * GetCellChange function will not be present.
- *
  * @param store A reference to the Store that changed.
  * @param tableId The Id of the Table that changed.
  * @param getCellChange A function that returns information about any Cell's
@@ -941,6 +941,56 @@ export type TableListener<
   getCellChange: GetCellChange<Schemas[0]> | undefined,
 ) => void;
 
+/**
+ * The TableCellIdsListener type describes a function that is used to listen to
+ * changes to the Cell Ids that appear anywhere in a Table.
+ *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   tableId: Id,
+ *   getIdChanges: GetIdChanges | undefined,
+ * ) => void;
+ * ```
+ *
+ * A TableCellIdsListener is provided when using the addTableCellIdsListener
+ * method. See that method for specific examples.
+ *
+ * When called, a TableCellIdsListener is given a reference to the Store, the Id
+ * of the Table whose Cell Ids changed, and a GetIdChanges function that can be
+ * used to query which Ids changed during the transaction.
+ * @param store A reference to the Store that changed.
+ * @param tableId The Id of the Table that changed.
+ * @param getIdChanges A function that returns information about the Id changes.
+ * @category Listener
+ * @since v3.3.0
+ */
+export type TableCellIdsListener<
+  Schemas extends OptionalSchemas,
+  TableIdOrNull extends TableIdFromSchema<Schemas[0]> | null,
+  Params extends any[] = (
+    TableIdOrNull extends null ? TableIdFromSchema<Schemas[0]> : TableIdOrNull
+  ) extends infer TableId
+    ? TableId extends TableIdFromSchema<Schemas[0]>
+      ? [
+          store: Store<Schemas>,
+          tableId: TableId,
+          getIdChanges: GetIdChanges<CellIdFromSchema<Schemas[0], TableId>>,
+        ]
+      : never
+    : never,
+  Params3 extends any[] =
+    | Params
+    | [store: never, tableId: never, getIdChanges: never],
+  Params2 extends any[] = Truncate<Params3>,
+  // Params1 extends any[] = Truncate<Params2>,
+> = Params extends any
+  ? ((...params: Params3) => void) | ((...params: Params2) => void)
+  : // | ((...params: Params1) => void)
+    never;
+
 /**
  * The RowIdsListener type describes a function that is used to listen to
  * changes to the Row Ids in a Table.
@@ -948,7 +998,11 @@ export type TableListener<
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * (store: Store, tableId: Id) => void;
+ * (
+ *   store: Store,
+ *   tableId: Id,
+ *   getIdChanges: GetIdChanges | undefined,
+ * ) => void;
  * ```
  *
  * A RowIdsListener is provided when using the addRowIdsListener method. See
@@ -957,8 +1011,12 @@ export type TableListener<
  * When called, a RowIdsListener is given a reference to the Store, and the Id
  * of the Table whose Row Ids changed.
  *
+ * Since v3.3, the listener is also passed a GetIdChanges function that can be
+ * used to query which Ids changed during the transaction.
  * @param store A reference to the Store that changed.
  * @param tableId The Id of the Table that changed.
+ * @param getIdChanges A function that returns information about the Id changes,
+ * since v3.3.
  * @category Listener
  */
 export type RowIdsListener<
@@ -969,6 +1027,7 @@ export type RowIdsListener<
   tableId: TableIdOrNull extends null
     ? TableIdFromSchema<Schemas[0]>
     : TableIdOrNull,
+  getIdChanges: GetIdChanges<Id> | undefined,
 ) => void;
 
 /**
@@ -998,7 +1057,6 @@ export type RowIdsListener<
  * Ids returned, for pagination purposes. It also receives the sorted array of
  * Ids itself, so that you can use them in the listener without the additional
  * cost of an explicit call to getSortedRowIds.
- *
  * @param store A reference to the Store that changed.
  * @param tableId The Id of the Table whose sorted Row Ids changed.
  * @param cellId The Id of the Cell whose values were used for the sorting.
@@ -1007,7 +1065,7 @@ export type RowIdsListener<
  * @param limit The maximum number of Row Ids returned.
  * @param sortedRowIds The sorted Row Ids themselves.
  * @category Listener
- * @since v2.0
+ * @since v2.0.0
  */
 export type SortedRowIdsListener<
   Schemas extends OptionalSchemas,
@@ -1052,7 +1110,6 @@ export type SortedRowIdsListener<
  * Note that if the listener was manually forced to be called (with the
  * callListener method rather than due to a real change in the Store), the
  * GetCellChange function will not be present.
- *
  * @param store A reference to the Store that changed.
  * @param tableId The Id of the Table that changed.
  * @param rowId The Id of the Row that changed.
@@ -1080,7 +1137,12 @@ export type RowListener<
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * (store: Store, tableId: Id, rowId: Id) => void;
+ * (
+ *   store: Store,
+ *   tableId: Id,
+ *   rowId: Id,
+ *   getIdChanges: GetIdChanges | undefined,
+ * ) => void;
  * ```
  *
  * A CellIdsListener is provided when using the addCellIdsListener method. See
@@ -1089,22 +1151,42 @@ export type RowListener<
  * When called, a CellIdsListener is given a reference to the Store, the Id of
  * the Table that changed, and the Id of the Row whose Cell Ids changed.
  *
+ * Since v3.3, the listener is also passed a GetIdChanges function that can be
+ * used to query which Ids changed during the transaction.
  * @param store A reference to the Store that changed.
  * @param tableId The Id of the Table that changed.
  * @param rowId The Id of the Row that changed.
+ * @param getIdChanges A function that returns information about the Id changes,
+ * since v3.3.
  * @category Listener
  */
 export type CellIdsListener<
   Schemas extends OptionalSchemas,
   TableIdOrNull extends TableIdFromSchema<Schemas[0]> | null,
   RowIdOrNull extends IdOrNull,
-> = (
-  store: Store<Schemas>,
-  tableId: TableIdOrNull extends null
-    ? TableIdFromSchema<Schemas[0]>
-    : TableIdOrNull,
-  rowId: RowIdOrNull extends null ? Id : RowIdOrNull,
-) => void;
+  Params extends any[] = (
+    TableIdOrNull extends null ? TableIdFromSchema<Schemas[0]> : TableIdOrNull
+  ) extends infer TableId
+    ? TableId extends TableIdFromSchema<Schemas[0]>
+      ? [
+          store: Store<Schemas>,
+          tableId: TableId,
+          rowId: RowIdOrNull extends null ? Id : RowIdOrNull,
+          getIdChanges: GetIdChanges<CellIdFromSchema<Schemas[0], TableId>>,
+        ]
+      : never
+    : never,
+  Params4 extends any[] =
+    | Params
+    | [store: never, tableId: never, rowId: never, getIdChanges: never],
+  Params3 extends any[] = Truncate<Params4>,
+  // Params2 extends any[] = Truncate<Params3>,
+  // Params1 extends any[] = Truncate<Params2>,
+> = Params extends any
+  ? ((...params: Params4) => void) | ((...params: Params3) => void)
+  : //  | ((...params: Params2) => void)
+    // | ((...params: Params1) => void)
+    never;
 
 /**
  * The CellListener type describes a function that is used to listen to changes
@@ -1137,7 +1219,6 @@ export type CellIdsListener<
  * callListener method rather than due to a real change in the Store), the
  * GetCellChange function will not be present and the new and old values of the
  * Cell will be the same.
- *
  * @param store A reference to the Store that changed.
  * @param tableId The Id of the Table that changed.
  * @param rowId The Id of the Row that changed.
@@ -1233,7 +1314,6 @@ export type CellListener<
  * Note that if the listener was manually forced to be called (with the
  * callListener method rather than due to a real change in the Store), the
  * GetValueChange function will not be present.
- *
  * @param store A reference to the Store that changed.
  * @param getValueChange A function that returns information about any Value's
  * changes.
@@ -1251,7 +1331,10 @@ export type ValuesListener<Schemas extends OptionalSchemas> = (
  * This has schema-based typing. The following is a simplified representation:
  *
  * ```ts override
- * (store: Store) => void;
+ * (
+ *   store: Store,
+ *   getIdChanges: GetIdChanges | undefined,
+ * ) => void;
  * ```
  *
  * A ValueIdsListener is provided when using the addValueIdsListener method. See
@@ -1259,11 +1342,16 @@ export type ValuesListener<Schemas extends OptionalSchemas> = (
  *
  * When called, a ValueIdsListener is given a reference to the Store.
  *
+ * Since v3.3, the listener is also passed a GetIdChanges function that can be
+ * used to query which Ids changed during the transaction.
  * @param store A reference to the Store that changed.
+ * @param getIdChanges A function that returns information about the Id changes,
+ * since v3.3.
  * @category Listener
  */
 export type ValueIdsListener<Schemas extends OptionalSchemas> = (
   store: Store<Schemas>,
+  getIdChanges: GetIdChanges<ValueIdFromSchema<Schemas[1]>> | undefined,
 ) => void;
 
 /**
@@ -1294,7 +1382,6 @@ export type ValueIdsListener<Schemas extends OptionalSchemas> = (
  * callListener method rather than due to a real change in the Store), the
  * GetValueChange function will not be present and the new and old values of the
  * Value will be the same.
- *
  * @param store A reference to the Store that changed.
  * @param valueId The Id of the Value that changed.
  * @param newValue The new value of the Value that changed.
@@ -1302,7 +1389,7 @@ export type ValueIdsListener<Schemas extends OptionalSchemas> = (
  * @param getValueChange A function that returns information about any Value's
  * changes.
  * @category Listener
- * @since v3.0
+ * @since v3.0.0
  */
 export type ValueListener<
   Schemas extends OptionalSchemas,
@@ -1367,14 +1454,13 @@ export type ValueListener<
  * have been of absolutely any type. Since there could have been multiple failed
  * attempts to set the Cell within a single transaction, this is an array
  * containing each attempt, chronologically.
- *
  * @param store A reference to the Store that was being changed.
  * @param tableId The Id of the Table that was being changed.
  * @param rowId The Id of the Row that was being changed.
  * @param cellId The Id of the Cell that was being changed.
  * @param invalidCells An array of the values of the Cell that were invalid.
  * @category Listener
- * @since v1.1
+ * @since v1.1.0
  */
 export type InvalidCellListener<Schemas extends OptionalSchemas> = (
   store: Store<Schemas>,
@@ -1407,12 +1493,11 @@ export type InvalidCellListener<Schemas extends OptionalSchemas> = (
  * Since there could have been multiple failed attempts to set the Value within
  * a single transaction, this is an array containing each attempt,
  * chronologically.
- *
  * @param store A reference to the Store that was being changed.
  * @param valueId The Id of the Value that was being changed.
  * @param invalidValues An array of the Values that were invalid.
  * @category Listener
- * @since v3.0
+ * @since v3.0.0
  */
 export type InvalidValueListener<Schemas extends OptionalSchemas> = (
   store: Store<Schemas>,
@@ -1420,6 +1505,24 @@ export type InvalidValueListener<Schemas extends OptionalSchemas> = (
   invalidValues: any[],
 ) => void;
 
+/**
+ * The GetIdChanges type describes a function that returns information about the
+ * changes to a set of Ids during a transaction.
+ *
+ * A GetIdChanges function is provided to every listener when called due Ids in
+ * the Store changing. It returns an object where each key is an Id that
+ * changed. The listener can then easily identify which Ids have been added
+ * (those with the value `1`), and which have been removed (those with the value
+ * `-1`).
+ * @returns An object keyed by Id with a numerical value. 1 means the Id was
+ * added, and 1 means it was removed.
+ * @category Listener
+ * @since v3.3.0
+ */
+export type GetIdChanges<ValidId extends Id> = () => {
+  [Id in ValidId]?: 1 | -1;
+};
+
 /**
  * The GetCellChange type describes a function that returns information about
  * any Cell's changes during a transaction.
@@ -1434,7 +1537,6 @@ export type InvalidValueListener<Schemas extends OptionalSchemas> = (
  * Store changing. The listener can then fetch the previous value of a Cell
  * before the current transaction, the new value after it, and a convenience
  * flag that indicates that the value has changed.
- *
  * @param tableId The Id of the Table to inspect.
  * @param rowId The Id of the Row to inspect.
  * @param cellId The Id of the Cell to inspect.
@@ -1467,7 +1569,6 @@ export type GetCellChange<Schema extends OptionalTablesSchema> = <
  * listener when called. This array contains the previous value of a Cell before
  * the current transaction, the new value after it, and a convenience flag that
  * indicates that the value has changed.
- *
  * @category Listener
  */
 export type CellChange<
@@ -1491,7 +1592,6 @@ export type CellChange<
  * Store changing. The listener can then fetch the previous value of a Value
  * before the current transaction, the new value after it, and a convenience
  * flag that indicates that the value has changed.
- *
  * @param valueId The Id of the Value to inspect.
  * @returns A ValueChange array containing information about the Value's
  * changes.
@@ -1520,7 +1620,6 @@ export type GetValueChange<Schema extends OptionalValuesSchema> = <
  * listener when called. This array contains the previous value of a Value
  * before the current transaction, the new value after it, and a convenience
  * flag that indicates that the value has changed.
- *
  * @category Listener
  */
 export type ValueChange<
@@ -1558,9 +1657,8 @@ export type ValueChange<
  * two-part array will never contain two items of the same value (including two
  * `undefined` values), even if, during the transaction, a Cell was changed to a
  * different value and then changed back.
- *
  * @category Transaction
- * @since v1.2
+ * @since v1.2.0
  */
 export type ChangedCells<Schema extends OptionalTablesSchema> = {
   [TableId in TableIdFromSchema<Schema>]?: {
@@ -1596,9 +1694,8 @@ export type ChangedCells<Schema extends OptionalTablesSchema> = {
  * two-part array will never contain two items of the same value (including two
  * `undefined` values), even if, during the transaction, a Cell was changed to a
  * different value and then changed back.
- *
  * @category Transaction
- * @since v1.2
+ * @since v1.2.0
  */
 export type ChangedCell<
   Schema extends OptionalTablesSchema,
@@ -1622,9 +1719,8 @@ export type ChangedCell<
  * the Tables object, but one for which Cell values are listed in array (much
  * like the InvalidCellListener type) so that multiple failed attempts to change
  * a Cell during the transaction are described.
- *
  * @category Transaction
- * @since v1.2
+ * @since v1.2.0
  */
 export type InvalidCells = {
   [tableId: Id]: {[rowId: Id]: {[cellId: Id]: any[]}};
@@ -1658,9 +1754,8 @@ export type InvalidCells = {
  * array will never contain two items of the same value (including two
  * `undefined` values), even if, during the transaction, a Value was changed to
  * a different value and then changed back.
- *
  * @category Transaction
- * @since v3.0
+ * @since v3.0.0
  */
 export type ChangedValues<Schema extends OptionalValuesSchema> = {
   [ValueId in ValueIdFromSchema<Schema>]?: ChangedValue<Schema, ValueId>;
@@ -1688,9 +1783,8 @@ export type ChangedValues<Schema extends OptionalValuesSchema> = {
  * array will never contain two items of the same value (including two
  * `undefined` values), even if, during the transaction, a Value was changed to
  * a different value and then changed back.
- *
  * @category Transaction
- * @since v3.0
+ * @since v3.0.0
  */
 export type ChangedValue<
   Schema extends OptionalValuesSchema,
@@ -1712,9 +1806,8 @@ export type ChangedValue<
  * This type is an object containing each invalid Value's attempt listed in
  * array (much like the InvalidValueListener type) so that multiple failed
  * attempts to change a Value during the transaction are described.
- *
  * @category Transaction
- * @since v3.0
+ * @since v3.0.0
  */
 export type InvalidValues = {[valueId: Id]: any[]};
 
@@ -1754,9 +1847,8 @@ export type TransactionChanges<Schemas extends OptionalSchemas> = [
  * It is provided to the DoRollback callback and to a TransactionListener
  * listener when a transaction completes. See the TransactionChanges type for
  * more information and an example of the returned data structure.
- *
  * @category Transaction
- * @since v4.0
+ * @since v4.0.0
  */
 export type GetTransactionChanges<Schemas extends OptionalSchemas> =
   () => TransactionChanges<Schemas>;
@@ -1799,9 +1891,8 @@ export type GetTransactionChanges<Schemas extends OptionalSchemas> =
  * all changes have been reverted.
  *
  * See the documentation for the types of the inner objects for other details.
- *
  * @category Transaction
- * @since v4.0
+ * @since v4.0.0
  */
 export type TransactionLog<Schemas extends OptionalSchemas> = {
   cellsTouched: boolean;
@@ -1829,9 +1920,8 @@ export type TransactionLog<Schemas extends OptionalSchemas> = {
  * It is provided to the DoRollback callback and to a TransactionListener
  * listener when a transaction completes. See the TransactionLog type for more
  * information.
- *
  * @category Transaction
- * @since v4.0
+ * @since v4.0.0
  */
 export type GetTransactionLog<Schemas extends OptionalSchemas> =
   () => TransactionLog<Schemas>;
@@ -1844,7 +1934,6 @@ export type GetTransactionLog<Schemas extends OptionalSchemas> =
  * listener. Totals include both mutator and non-mutator listeners. A
  * StoreListenerStats object is returned from the getListenerStats method, and
  * is only populated in a debug build.
- *
  * @category Development
  */
 export type StoreListenerStats = {
@@ -1860,6 +1949,11 @@ export type StoreListenerStats = {
    * The number of TableListener functions registered with the Store.
    */
   table?: number;
+  /**
+   * The number of TableCellIdsListener functions registered with the Store,
+   * since v3.3.
+   */
+  tableCellIds?: number;
   /**
    * The number of RowIdsListener functions registered with the Store.
    */
@@ -2000,6 +2094,7 @@ export type StoreListenerStats = {
  * |Tables|getTables|setTables|delTables|addTablesListener|
  * |Table Ids|getTableIds|-|-|addTableIdsListener|
  * |Table|getTable|setTable|delTable|addTableListener|
+ * |Table Cell Ids|getTableCellIds|-|-|addTableCellIdsListener|
  * |Row Ids|getRowIds|-|-|addRowIdsListener|
  * |Row Ids (sorted)|getSortedRowIds|-|-|addSortedRowIdsListener|
  * |Row|getRow|setRow|delRow|addRowListener|
@@ -2060,7 +2155,6 @@ export type StoreListenerStats = {
  *
  * Finally, the getListenerStats method describes the current state of the
  * Store's listeners for debugging purposes.
- *
  * @example
  * This example shows a very simple lifecycle of a Store: from creation, to
  * adding and getting some data, and then registering and removing a listener.
@@ -2103,7 +2197,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * Note that this returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned objects are not made to the Store
    * itself.
-   *
    * @returns An array of a Tables object and a Values object.
    * @example
    * This example retrieves the content of a Store.
@@ -2125,7 +2218,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> [{}, {}]
    * ```
    * @category Getter
-   * @since v4.0
+   * @since v4.0.0
    */
   getContent(): [Tables<Schemas[0]>, Values<Schemas[1]>];
 
@@ -2142,7 +2235,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * Note that this returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned object are not made to the Store
    * itself.
-   *
    * @returns A Tables object containing the tabular data of the Store.
    * @example
    * This example retrieves the tabular data in a Store.
@@ -2179,7 +2271,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * Note that this returns a copy of, rather than a reference, to the list of
    * Ids, so changes made to the list are not made to the Store itself.
-   *
    * @returns An array of the Ids of every Table in the Store.
    * @example
    * This example retrieves the Table Ids in a Store.
@@ -2218,7 +2309,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * Note that this returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned object are not made to the Store
    * itself.
-   *
    * @param tableId The Id of the Table in the Store.
    * @returns An object containing the entire data of the Table.
    * @example
@@ -2247,6 +2337,50 @@ export interface Store<in out Schemas extends OptionalSchemas> {
     tableId: TableId,
   ): Table<Schemas[0], TableId>;
 
+  /**
+   * The getTableCellIds method returns the Ids of every Cell used across the
+   * whole Table.
+   *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getTableCellIds(tableId: Id): Ids;
+   * ```
+   *
+   * Note that this returns a copy of, rather than a reference, to the list of
+   * Ids, so changes made to the list are not made to the Store itself.
+   * @param tableId The Id of the Table in the Store.
+   * @returns An array of the Ids of every Cell used across the whole Table.
+   * @example
+   * This example retrieves the Cell Ids used across a whole Table.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {
+   *     fido: {species: 'dog', color: 'brown'},
+   *     felix: {species: 'cat', legs: 4},
+   *     cujo: {dangerous: true},
+   *   },
+   * });
+   * console.log(store.getTableCellIds('pets'));
+   * // -> ['species', 'color', 'legs', 'dangerous']
+   * ```
+   * @example
+   * This example retrieves the Cell Ids used across a Table that does not
+   * exist, returning an empty array.
+   *
+   * ```js
+   * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
+   * console.log(store.getTableCellIds('species'));
+   * // -> []
+   * ```
+   * @category Getter
+   * @since v3.3.0
+   */
+  getTableCellIds<TableId extends TableIdFromSchema<Schemas[0]>>(
+    tableId: TableId,
+  ): CellIdFromSchema<Schemas[0], TableId>[];
+
   /**
    * The getRowIds method returns the Ids of every Row in a given Table.
    *
@@ -2258,7 +2392,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * Note that this returns a copy of, rather than a reference, to the list of
    * Ids, so changes made to the list are not made to the Store itself.
-   *
    * @param tableId The Id of the Table in the Store.
    * @returns An array of the Ids of every Row in the Table.
    * @example
@@ -2315,7 +2448,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * addSortedRowIdsListener method.
    *
    * If the Table does not exist, an empty array is returned.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param cellId The Id of the Cell whose values are used for the sorting, or
    * `undefined` to sort by the Row Id itself.
@@ -2396,7 +2528,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> []
    * ```
    * @category Getter
-   * @since v2.0
+   * @since v2.0.0
    */
   getSortedRowIds<TableId extends TableIdFromSchema<Schemas[0]>>(
     tableId: TableId,
@@ -2419,7 +2551,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * Note that this returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned object are not made to the Store
    * itself.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @returns An object containing the entire data of the Row.
@@ -2453,7 +2584,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   ): Row<Schemas[0], TableId>;
 
   /**
-   * The getCellIds method returns the Ids of every Cell in a given Row, in a
+   * The getCellIds method returns the Ids of every Cell in a given Row in a
    * given Table.
    *
    * This has schema-based typing. The following is a simplified representation:
@@ -2464,7 +2595,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * Note that this returns a copy of, rather than a reference, to the list of
    * Ids, so changes made to the list are not made to the Store itself.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @returns An array of the Ids of every Cell in the Row.
@@ -2481,8 +2611,8 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> ['species', 'color']
    * ```
    * @example
-   * This example retrieves the Cell Ids of a Cell that does not exist,
-   * returning an empty array.
+   * This example retrieves the Cell Ids of a Row that does not exist, returning
+   * an empty array.
    *
    * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
@@ -2499,13 +2629,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The getCell method returns the value of a single Cell in a given Row, in a
    * given Table.
-   *
-   * This has schema-based typing. The following is a simplified representation:
-   *
-   * ```ts override
-   * getCell(tableId: Id, rowId: Id, cellId: Id): CellOrUndefined;
-   * ```
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @param cellId The Id of the Cell in the Row.
@@ -2513,6 +2636,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * @example
    * This example retrieves a single Cell.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getCell(tableId: Id, rowId: Id, cellId: Id): CellOrUndefined;
+   * ```
+   *
    * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog', color: 'brown'}},
@@ -2552,7 +2681,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * Note that this returns a copy of, rather than a reference to the underlying
    * data, so changes made to the returned object are not made to the Store
    * itself.
-   *
    * @returns An object containing the set of keyed Values in the Store.
    * @example
    * This example retrieves the set of keyed Values in the Store.
@@ -2572,7 +2700,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {}
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getValues(): Values<Schemas[1]>;
 
@@ -2587,7 +2715,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * Note that this returns a copy of, rather than a reference, to the list of
    * Ids, so changes made to the list are not made to the Store itself.
-   *
    * @returns An array of the Ids of every Value in the Store.
    * @example
    * This example retrieves the Value Ids in a Store.
@@ -2607,12 +2734,16 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> []
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getValueIds(): ValueIdFromSchema<Schemas[1]>[];
 
   /**
    * The getValue method returns a single keyed Value in the Store.
+   * @param valueId The Id of the Value in the Store.
+   * @returns The Value, or `undefined`.
+   * @example
+   * This example retrieves a single Value.
    *
    * This has schema-based typing. The following is a simplified representation:
    *
@@ -2620,11 +2751,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * getValue(valueId: Id): ValueOrUndefined;
    * ```
    *
-   * @param valueId The Id of the Value in the Store.
-   * @returns The Value, or `undefined`.
-   * @example
-   * This example retrieves a single Value.
-   *
    * ```js
    * const store = createStore().setValues({open: true, employees: 3});
    * console.log(store.getValue('employees'));
@@ -2639,7 +2765,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> undefined
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getValue<ValueId extends ValueIdFromSchema<Schemas[1]>>(
     valueId: ValueId,
@@ -2648,7 +2774,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The hasTables method returns a boolean indicating whether any Table objects
    * exist in the Store.
-   *
    * @returns Whether any Tables exist.
    * @example
    * This example shows simple existence checks.
@@ -2668,6 +2793,10 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The hasTable method returns a boolean indicating whether a given Table
    * exists in the Store.
+   * @param tableId The Id of a possible Table in the Store.
+   * @returns Whether a Table with that Id exists.
+   * @example
+   * This example shows two simple Table existence checks.
    *
    * This has schema-based typing. The following is a simplified representation:
    *
@@ -2675,11 +2804,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * hasTable(tableId: Id): boolean;
    * ```
    *
-   * @param tableId The Id of a possible Table in the Store.
-   * @returns Whether a Table with that Id exists.
-   * @example
-   * This example shows two simple Table existence checks.
-   *
    * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.hasTable('pets'));
@@ -2692,21 +2816,54 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   hasTable(tableId: TableIdFromSchema<Schemas[0]>): boolean;
 
   /**
-   * The hasRow method returns a boolean indicating whether a given Row exists
-   * in the Store.
+   * The hasTableCell method returns a boolean indicating whether a given Cell
+   * exists anywhere in a Table, not just in a specific Row.
+   * @param tableId The Id of a possible Table in the Store.
+   * @param cellId The Id of a possible Cell in the Table.
+   * @returns Whether a Cell with that Id exists anywhere in that Table.
+   * @example
+   * This example shows two simple Cell existence checks.
    *
    * This has schema-based typing. The following is a simplified representation:
    *
    * ```ts override
-   * hasRow(tableId: Id, rowId: Id): boolean;
+   * hasTableCell(tableId: Id, cellId: Id): boolean;
    * ```
    *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {fido: {species: 'dog'}, felix: {legs: 4}},
+   * });
+   * console.log(store.hasTableCell('pets', 'species'));
+   * // -> true
+   * console.log(store.hasTableCell('pets', 'legs'));
+   * // -> true
+   * console.log(store.hasTableCell('pets', 'color'));
+   * // -> false
+   * ```
+   * @category Getter
+   * @since v3.3.0
+   */
+  hasTableCell<TableId extends TableIdFromSchema<Schemas[0]>>(
+    tableId: TableId,
+    cellId: CellIdFromSchema<Schemas[0], TableId>,
+  ): boolean;
+
+  /**
+   * The hasRow method returns a boolean indicating whether a given Row exists
+   * in the Store.
    * @param tableId The Id of a possible Table in the Store.
    * @param rowId The Id of a possible Row in the Table.
    * @returns Whether a Row with that Id exists in that Table.
    * @example
    * This example shows two simple Row existence checks.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * hasRow(tableId: Id, rowId: Id): boolean;
+   * ```
+   *
    * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.hasRow('pets', 'fido'));
@@ -2720,14 +2877,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
 
   /**
    * The hasCell method returns a boolean indicating whether a given Cell exists
-   * in the Store.
-   *
-   * This has schema-based typing. The following is a simplified representation:
-   *
-   * ```ts override
-   * hasCell(tableId: Id, rowId: Id, cellId: Id): boolean;
-   * ```
-   *
+   * in a given Row in a given Table.
    * @param tableId The Id of a possible Table in the Store.
    * @param rowId The Id of a possible Row in the Table.
    * @param cellId The Id of a possible Cell in the Row.
@@ -2735,6 +2885,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * @example
    * This example shows two simple Cell existence checks.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * hasCell(tableId: Id, rowId: Id, cellId: Id): boolean;
+   * ```
+   *
    * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    * console.log(store.hasCell('pets', 'fido', 'species'));
@@ -2753,7 +2909,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The hasTables method returns a boolean indicating whether any Values exist
    * in the Store.
-   *
    * @returns Whether any Values exist.
    * @example
    * This example shows simple existence checks.
@@ -2767,13 +2922,17 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> true
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   hasValues(): boolean;
 
   /**
    * The hasValue method returns a boolean indicating whether a given Value
    * exists in the Store.
+   * @param valueId The Id of a possible Value in the Store.
+   * @returns Whether a Value with that Id exists in the Store.
+   * @example
+   * This example shows two simple Value existence checks.
    *
    * This has schema-based typing. The following is a simplified representation:
    *
@@ -2781,11 +2940,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * hasValue(valueId: Id): boolean;
    * ```
    *
-   * @param valueId The Id of a possible Value in the Store.
-   * @returns Whether a Value with that Id exists in the Store.
-   * @example
-   * This example shows two simple Value existence checks.
-   *
    * ```js
    * const store = createStore().setValues({open: true});
    * console.log(store.hasValue('open'));
@@ -2794,14 +2948,13 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> false
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   hasValue(valueId: ValueIdFromSchema<Schemas[1]>): boolean;
 
   /**
    * The getTablesJson method returns a string serialization of all of the
    * Tables in the Store.
-   *
    * @returns A string serialization of all of the Tables in the Store.
    * @example
    * This example serializes the contents of a Store.
@@ -2820,14 +2973,13 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> '{}'
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getTablesJson(): Json;
 
   /**
    * The getValuesJson method returns a string serialization of all of the keyed
    * Values in the Store.
-   *
    * @returns A string serialization of all of the Values in the Store.
    * @example
    * This example serializes the keyed value contents of a Store.
@@ -2846,7 +2998,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> '{}'
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getValuesJson(): Json;
 
@@ -2858,7 +3010,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * first is the Tables object, the second the Values. In previous versions
    * (before the existence of the Values data structure), it was a sole object
    * of Tables.
-   *
    * @returns A string serialization of the Tables and Values in the Store.
    * @example
    * This example serializes the tabular and keyed value contents of a Store.
@@ -2889,7 +3040,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * If no TablesSchema has been set on the Store (or if it has been removed
    * with the delTablesSchema method), then it will return the serialization of
    * an empty object, `{}`.
-   *
    * @returns A string serialization of the TablesSchema of the Store.
    * @example
    * This example serializes the TablesSchema of a Store.
@@ -2913,7 +3063,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> '{}'
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getTablesSchemaJson(): Json;
 
@@ -2924,7 +3074,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * If no ValuesSchema has been set on the Store (or if it has been removed
    * with the delValuesSchema method), then it will return the serialization of
    * an empty object, `{}`.
-   *
    * @returns A string serialization of the ValuesSchema of the Store.
    * @example
    * This example serializes the ValuesSchema of a Store.
@@ -2945,7 +3094,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> '{}'
    * ```
    * @category Getter
-   * @since v3.0
+   * @since v3.0.0
    */
   getValuesSchemaJson(): Json;
 
@@ -2957,7 +3106,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * first is the TablesSchema object, the second the ValuesSchema. In previous
    * versions (before the existence of the ValuesSchema data structure), it was
    * a sole object of TablesSchema.
-   *
    * @returns A string serialization of the TablesSchema and ValuesSchema of the
    * Store.
    * @example
@@ -3013,7 +3161,6 @@ 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.
-   *
    * @param content An array containing the tabular and keyed-value data of the
    * Store to be set.
    * @example
@@ -3050,7 +3197,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {pets: {felix: {species: 'cat'}}}
    * ```
    * @category Setter
-   * @since v4.0
+   * @since v4.0.0
    */
   setContent([tables, values]: [
     Tables<Schemas[0], true>,
@@ -3080,7 +3227,6 @@ 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.
-   *
    * @param tables The data of the Store to be set.
    * @example
    * This example sets the tabular data of a Store.
@@ -3136,7 +3282,6 @@ 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.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param table The data of a single Table to be set.
    * @example
@@ -3196,7 +3341,6 @@ 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.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @param row The data of a single Row to be set.
@@ -3263,7 +3407,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * if you specify `reuseRowIds` to be `false`, then the Id will be a
    * monotonically increasing string representation of an increasing integer,
    * regardless of any you may have previously deleted.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param row The data of a single Row to be added.
    * @param reuseRowIds Whether Ids should be recycled from previously deleted
@@ -3327,7 +3470,6 @@ 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.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @param partialRow The partial data of a single Row to be set.
@@ -3389,7 +3531,6 @@ 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.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @param cellId The Id of the Cell in the Row.
@@ -3463,7 +3604,6 @@ 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.
-   *
    * @param values The Values object to be set.
    * @returns A reference to the Store.
    * @example
@@ -3490,7 +3630,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {employees: 3}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setValues(values: Values<Schemas[1], true>): Store<Schemas>;
 
@@ -3518,7 +3658,6 @@ 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.
-   *
    * @param partialValues The Values to be set.
    * @returns A reference to the Store.
    * @example
@@ -3546,7 +3685,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {open: true, employees: 3}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setPartialValues(partialValues: Values<Schemas[1], true>): Store<Schemas>;
 
@@ -3572,7 +3711,6 @@ 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.
-   *
    * @param valueId The Id of the Value in the Store.
    * @param value The Value to be set, or a MapValue function to update it.
    * @returns A reference to the Store.
@@ -3606,7 +3744,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {employees: 3}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setValue<ValueId extends ValueIdFromSchema<Schemas[1]>>(
     valueId: ValueId,
@@ -3635,7 +3773,6 @@ 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.
-   *
    * @param transactionChanges The TransactionChanges to apply to the Store.
    * @returns A reference to the Store.
    * @example
@@ -3657,7 +3794,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {}
    * ```
    * @category Setter
-   * @since v4.0
+   * @since v4.0.0
    */
   setTransactionChanges(
     transactionChanges: TransactionChanges<Schemas>,
@@ -3677,7 +3814,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * it will then be subject to the same validation rules as the setTables
    * method (according to the Tables type, and matching any TablesSchema
    * associated with the Store).
-   *
    * @param tablesJson A string serialization of all of the Tables in the Store.
    * @returns A reference to the Store.
    * @example
@@ -3700,7 +3836,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setTablesJson(tablesJson: Json): Store<Schemas>;
 
@@ -3718,7 +3854,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * it will then be subject to the same validation rules as the setValues
    * method (according to the Values type, and matching any ValuesSchema
    * associated with the Store).
-   *
    * @param valuesJson A string serialization of all of the Values in the Store.
    * @returns A reference to the Store.
    * @example
@@ -3741,7 +3876,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setValuesJson(valuesJson: Json): Store<Schemas>;
 
@@ -3766,7 +3901,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * method (according to the Tables type, and matching any TablesSchema
    * associated with the Store), and the setValues method (according to the
    * Values type, and matching any ValuesSchema associated with the Store).
-   *
    * @param tablesAndValuesJson A string serialization of all of the Tables and
    * Values in the Store.
    * @returns A reference to the Store.
@@ -3826,7 +3960,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * When no longer needed, you can also completely remove an existing
    * TablesSchema with the delTablesSchema method.
-   *
    * @param tablesSchema The TablesSchema to be set for the Store.
    * @returns A reference to the Store.
    * @example
@@ -3845,7 +3978,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {pets: {0: {species: 'dog', sold: false}}}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setTablesSchema<TS extends TablesSchema>(
     tablesSchema: TS,
@@ -3867,7 +4000,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * When no longer needed, you can also completely remove an existing
    * ValuesSchema with the delValuesSchema method.
-   *
    * @param valuesSchema The ValuesSchema to be set for the Store.
    * @returns A reference to the Store.
    * @example
@@ -3883,7 +4015,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {open: false}
    * ```
    * @category Setter
-   * @since v3.0
+   * @since v3.0.0
    */
   setValuesSchema<VS extends ValuesSchema>(
     valuesSchema: VS,
@@ -3908,7 +4040,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (before the existence of the ValuesSchema data structure), only the first
    * was present. For backwards compatibility the new second parameter is
    * optional.
-   *
    * @param tablesSchema The TablesSchema to be set for the Store.
    * @param valuesSchema The ValuesSchema to be set for the Store.
    * @returns A reference to the Store.
@@ -3966,6 +4097,9 @@ export interface Store<in out Schemas extends OptionalSchemas> {
 
   /**
    * The delTables method lets you remove all of the data in a Store.
+   * @returns A reference to the Store.
+   * @example
+   * This example removes the data of a Store.
    *
    * This has schema-based typing. The following is a simplified representation:
    *
@@ -3973,10 +4107,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * delTables(): Store;
    * ```
    *
-   * @returns A reference to the Store.
-   * @example
-   * This example removes the data of a Store.
-   *
    * ```js
    * const store = createStore().setTables({pets: {fido: {species: 'dog'}}});
    *
@@ -3990,6 +4120,10 @@ export interface Store<in out Schemas extends OptionalSchemas> {
 
   /**
    * The delTable method lets you remove a single Table from the Store.
+   * @param tableId The Id of the Table in the Store.
+   * @returns A reference to the Store.
+   * @example
+   * This example removes a Table from a Store.
    *
    * This has schema-based typing. The following is a simplified representation:
    *
@@ -3997,11 +4131,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * delTable(tableId: Id): Store;
    * ```
    *
-   * @param tableId The Id of the Table in the Store.
-   * @returns A reference to the Store.
-   * @example
-   * This example removes a Table from a Store.
-   *
    * ```js
    * const store = createStore().setTables({
    *   pets: {fido: {species: 'dog'}},
@@ -4026,7 +4155,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * ```
    *
    * If this is the last Row in its Table, then that Table will be removed.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @returns A reference to the Store.
@@ -4072,7 +4200,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * invalid Row (according to the TablesSchema), in fact the whole Row is
    * deleted to retain the integrity of the Table. Therefore, this flag should
    * be used with caution.
-   *
    * @param tableId The Id of the Table in the Store.
    * @param rowId The Id of the Row in the Table.
    * @param cellId The Id of the Cell in the Row.
@@ -4153,7 +4280,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * If there is a ValuesSchema applied to the Store and it specifies a default
    * value for any Value Id, then deletion will result in it being set back to
    * its default value.
-   *
    * @returns A reference to the Store.
    * @example
    * This example removes all Values from a Store without a ValuesSchema.
@@ -4182,7 +4308,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {open: false}
    * ```
    * @category Deleter
-   * @since v3.0
+   * @since v3.0.0
    */
   delValues(): Store<Schemas>;
 
@@ -4198,7 +4324,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * If there is a ValuesSchema applied to the Store and it specifies a default
    * value for this Value Id, then deletion will result in it being set back to
    * its default value.
-   *
    * @param valueId The Id of the Value in the Row.
    * @returns A reference to the Store.
    * @example
@@ -4228,12 +4353,15 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {open: false, employees: 3}
    * ```
    * @category Deleter
-   * @since v3.0
+   * @since v3.0.0
    */
   delValue(valueId: ValueIdFromSchema<Schemas[1]>): Store<Schemas>;
 
   /**
    * The delTablesSchema method lets you remove the TablesSchema of the Store.
+   * @returns A reference to the Store.
+   * @example
+   * This example removes the TablesSchema of a Store.
    *
    * This has schema-based typing. The following is a simplified representation:
    *
@@ -4241,10 +4369,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * delTablesSchema(): Store;
    * ```
    *
-   * @returns A reference to the Store.
-   * @example
-   * This example removes the TablesSchema of a Store.
-   *
    * ```js
    * const store = createStore().setTablesSchema({
    *   pets: {species: {type: 'string'}},
@@ -4261,6 +4385,9 @@ export interface Store<in out Schemas extends OptionalSchemas> {
 
   /**
    * The delValuesSchema method lets you remove the ValuesSchema of the Store.
+   * @returns A reference to the Store.
+   * @example
+   * This example removes the ValuesSchema of a Store.
    *
    * This has schema-based typing. The following is a simplified representation:
    *
@@ -4268,10 +4395,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * delValuesSchema(): Store;
    * ```
    *
-   * @returns A reference to the Store.
-   * @example
-   * This example removes the ValuesSchema of a Store.
-   *
    * ```js
    * const store = createStore().setValuesSchema({
    *   sold: {type: 'boolean', default: false},
@@ -4281,7 +4404,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> '{}'
    * ```
    * @category Deleter
-   * @since v3.0
+   * @since v3.0.0
    */
   delValuesSchema<
     TablesSchema extends OptionalTablesSchema = Schemas[0],
@@ -4298,7 +4421,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * ```
    *
    * Prior to v3.0, this method removed the TablesSchema only.
-   *
    * @returns A reference to the Store.
    * @example
    * This example removes the TablesSchema and ValuesSchema of a Store.
@@ -4316,7 +4438,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> '[{},{}]'
    * ```
    * @category Deleter
-   * @since v3.0
+   * @since v3.0.0
    */
   delSchema(): Store<NoSchemas>;
 
@@ -4354,7 +4476,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * `getTransactionLog` parameters, which inform you of the net changes that
    * have been made during the transaction, at different levels of detail. See
    * the DoRollback documentation for more details.
-   *
    * @param actions The function to be executed as a transaction.
    * @param doRollback An optional callback that should return `true` if you
    * want to rollback the transaction at the end. Since v1.2.
@@ -4487,7 +4608,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * that are asynchronous or not occurring inline to your code. You must
    * remember to also call the finishTransaction method explicitly when it is
    * done, of course.
-   *
    * @returns A reference to the Store.
    * @example
    * This example makes changes to two Cells, first outside, and secondly
@@ -4512,7 +4632,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> 'Fido changed'
    * ```
    * @category Transaction
-   * @since v1.3
+   * @since v1.3.0
    */
   startTransaction(): Store<Schemas>;
 
@@ -4550,7 +4670,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * `getTransactionLog` parameters, which inform you of the net changes that
    * have been made during the transaction, at different levels of detail. See
    * the DoRollback documentation for more details.
-   *
    * @param doRollback An optional callback that should return `true` if you
    * want to rollback the transaction at the end.
    * @returns A reference to the Store.
@@ -4616,7 +4735,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> {open: true}
    * ```
    * @category Transaction
-   * @since v1.3
+   * @since v1.3.0
    */
   finishTransaction(doRollback?: DoRollback<Schemas>): Store<Schemas>;
 
@@ -4635,7 +4754,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * function that will be called with the Id of each Table, and with a function
    * that can then be used to iterate over each Row of the Table, should you
    * wish.
-   *
    * @param tableCallback The function that should be called for every Table.
    * @example
    * This example iterates over each Table in a Store, and lists each Row Id
@@ -4659,6 +4777,44 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    */
   forEachTable(tableCallback: TableCallback<Schemas[0]>): void;
 
+  /**
+   * The forEachTableCell method takes a function that it will then call for
+   * each Cell used across the whole Table.
+   *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * forEachTableCell(tableId: Id, tableCellCallback: TableCellCallback): void;
+   * ```
+   *
+   * This method is useful for iterating over the Cell structure of the Table in
+   * a functional style. The `tableCellCallback` parameter is a
+   * TableCellCallback function that will be called with the Id of each Cell and
+   * the count of Rows in the Table in which it appears.
+   * @param tableId The Id of the Table containing the Cells to iterate over.
+   * @param tableCellCallback The function that should be called for every Cell
+   * Id used across the whole Table.
+   * @example
+   * This example iterates over each Cell Id used across the whole Table.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {fido: {species: 'dog'}, felix: {species: 'cat', legs: 4}},
+   * });
+   * store.forEachTableCell('pets', (cellId, count) => {
+   *   console.log(`${cellId}: ${count}`);
+   * });
+   * // -> 'species: 2'
+   * // -> 'legs: 1'
+   * ```
+   * @category Iterator
+   * @since v3.3.0
+   */
+  forEachTableCell<TableId extends TableIdFromSchema<Schemas[0]>>(
+    tableId: TableId,
+    tableCellCallback: TableCellCallback<Schemas[0], TableId>,
+  ): void;
+
   /**
    * The forEachRow method takes a function that it will then call for each Row
    * in a specified Table.
@@ -4673,7 +4829,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * a functional style. The `rowCallback` parameter is a RowCallback function
    * that will be called with the Id of each Row, and with a function that can
    * then be used to iterate over each Cell of the Row, should you wish.
-   *
    * @param tableId The Id of the Table to iterate over.
    * @param rowCallback The function that should be called for every Row.
    * @example
@@ -4716,7 +4871,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * This method is useful for iterating over the Cell structure of the Row in a
    * functional style. The `cellCallback` parameter is a CellCallback function
    * that will be called with the Id and value of each Cell.
-   *
    * @param tableId The Id of the Table containing the Row to iterate over.
    * @param rowId The Id of the Row to iterate over.
    * @param cellCallback The function that should be called for every Cell.
@@ -4754,7 +4908,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * This method is useful for iterating over the Value structure of the Store
    * in a functional style. The `valueCallback` parameter is a ValueCallback
    * function that will be called with the Id and value of each Value.
-   *
    * @param valueCallback The function that should be called for every Value.
    * @example
    * This example iterates over each Value in a Store, and lists its value.
@@ -4768,7 +4921,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * // -> 'employees: 3'
    * ```
    * @category Iterator
-   * @since v3.0
+   * @since v3.0.0
    */
   forEachValue(valueCallback: ValueCallback<Schemas[1]>): void;
 
@@ -4793,7 +4946,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param listener The function that will be called whenever data in the Store
    * changes.
    * @param mutator An optional boolean that indicates that the listener mutates
@@ -4866,7 +5018,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param listener The function that will be called whenever the Table Ids in
    * the Store change.
    * @param mutator An optional boolean that indicates that the listener mutates
@@ -4944,7 +5095,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever data in the
    * matching Table changes.
@@ -5021,6 +5171,122 @@ export interface Store<in out Schemas extends OptionalSchemas> {
     mutator?: boolean,
   ): Id;
 
+  /**
+   * The addTableCellIdsListener method registers a listener function with the
+   * Store that will be called whenever the Cell Ids that appear anywhere in a
+   * Table change.
+   *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addTableCellIdsListener(
+   *   tableId: IdOrNull,
+   *   listener: TableCellIdsListener,
+   *   mutator?: boolean,
+   * ): Id;
+   * ```
+   *
+   * The provided listener is a TableCellIdsListener function, and will be
+   * called with a reference to the Store and the Id of the Table that changed.
+   *
+   * By default, such a listener is only called when a Cell Id is added or
+   * removed from the whole of the Table. To listen to all changes in the Table,
+   * use the addTableListener method.
+   *
+   * You can either listen to a single Table (by specifying its Id as the
+   * method's first parameter) or changes to any Table (by providing a `null`
+   * wildcard).
+   *
+   * Use the optional mutator parameter to indicate that there is code in the
+   * listener that will mutate Store data. If set to `false` (or omitted), such
+   * mutations will be silently ignored. All relevant mutator listeners (with
+   * this flag set to `true`) are called _before_ any non-mutator listeners
+   * (since the latter may become relevant due to changes made in the former).
+   * The changes made by mutator listeners do not fire other mutating listeners,
+   * though they will fire non-mutator listeners.
+   * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
+   * @param listener The function that will be called whenever the Cell Ids that
+   * appear anywhere in a Table change.
+   * @param mutator An optional boolean that indicates that the listener mutates
+   * Store data.
+   * @returns A unique Id for the listener that can later be used to call it
+   * explicitly, or to remove it.
+   * @example
+   * This example registers a listener that responds to any change to the Cell
+   * Ids that appear anywhere in a Table.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {fido: {species: 'dog', color: 'brown'}},
+   * });
+   * const listenerId = store.addTableCellIdsListener('pets', (store) => {
+   *   console.log('Cell Ids in pets table changed');
+   *   console.log(store.getTableCellIds('pets'));
+   * });
+   *
+   * store.setRow('pets', 'felix', {species: 'cat', legs: 4});
+   * // -> 'Cell Ids in pets table changed'
+   * // -> ['species', 'color', 'legs']
+   *
+   * store.delListener(listenerId);
+   * ```
+   * @example
+   * This example registers a listener that responds to any change to the Cell
+   * Ids that appear anywhere in any Table.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {fido: {species: 'dog', color: 'brown'}},
+   *   species: {dog: {price: 5}},
+   * });
+   * const listenerId = store.addTableCellIdsListener(
+   *   null,
+   *   (store, tableId) => {
+   *     console.log(`Cell Ids in ${tableId} table changed`);
+   *     console.log(store.getTableCellIds(tableId));
+   *   },
+   * );
+   *
+   * store.setRow('pets', 'felix', {species: 'cat', legs: 4});
+   * // -> 'Cell Ids in pets table changed'
+   * // -> ['species', 'color', 'legs']
+   *
+   * store.setRow('species', 'cat', {price: 4, friendly: true});
+   * // -> 'Cell Ids in species table changed'
+   * // -> ['price', 'friendly']
+   *
+   * store.delListener(listenerId);
+   * ```
+   * @example
+   * This example registers a listener that responds to the Cell Ids that appear
+   * anywhere in a Table, and which also mutates the Store itself.
+   *
+   * ```js
+   * const store = createStore().setTables({
+   *   pets: {fido: {species: 'dog', color: 'brown'}},
+   * });
+   * const listenerId = store.addTableCellIdsListener(
+   *   'pets',
+   *   (store, tableId) => store.setCell('meta', 'update', tableId, true),
+   *   true, // mutator
+   * );
+   *
+   * store.setRow('pets', 'felix', {species: 'cat', legs: 4});
+   * console.log(store.getTable('meta'));
+   * // -> {update: {pets: true}}
+   *
+   * store.delListener(listenerId);
+   * ```
+   * @category Listener
+   */
+  addTableCellIdsListener<
+    TableIdOrNull extends TableIdFromSchema<Schemas[0]> | null,
+  >(
+    tableId: TableIdOrNull,
+    listener: TableCellIdsListener<Schemas, TableIdOrNull>,
+    mutator?: boolean,
+  ): Id;
+
   /**
    * The addRowIdsListener method registers a listener function with the Store
    * that will be called whenever the Row Ids in a Table change.
@@ -5052,7 +5318,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever the Row Ids in
    * the Table change.
@@ -5170,7 +5435,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to.
    * @param cellId The Id of the Cell whose values are used for the sorting, or
    * `undefined` to sort by the Row Id itself.
@@ -5219,7 +5483,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * store.delListener(listenerId);
    * ```
    * @example
-   * This 111example registers a listener that responds to any change to a
+   * This example registers a listener that responds to any change to a
    * paginated section of the sorted Row Ids of a specific Table.
    *
    * ```js
@@ -5351,7 +5615,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v2.0
+   * @since v2.0.0
    */
   addSortedRowIdsListener<
     TableId extends TableIdFromSchema<Schemas[0]>,
@@ -5412,7 +5676,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param rowId The Id of the Row to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever data in the
@@ -5538,7 +5801,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param rowId The Id of the Row to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever the Cell Ids in
@@ -5658,7 +5920,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param rowId The Id of the Row to listen to, or `null` as a wildcard.
    * @param cellId The Id of the Cell to listen to, or `null` as a wildcard.
@@ -5781,7 +6042,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param listener The function that will be called whenever data in the
    * Values changes.
    * @param mutator An optional boolean that indicates that the listener mutates
@@ -5823,7 +6083,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v3.0
+   * @since v3.0.0
    */
   addValuesListener(listener: ValuesListener<Schemas>, mutator?: boolean): Id;
 
@@ -5851,7 +6111,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param listener The function that will be called whenever the Value Ids in
    * the Store change.
    * @param mutator An optional boolean that indicates that the listener mutates
@@ -5893,7 +6152,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v3.0
+   * @since v3.0.0
    */
   addValueIdsListener(
     listener: ValueIdsListener<Schemas>,
@@ -5929,7 +6188,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * (since the latter may become relevant due to changes made in the former).
    * The changes made by mutator listeners do not fire other mutating listeners,
    * though they will fire non-mutator listeners.
-   *
    * @param valueId The Id of the Value to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever data in the
    * matching Value changes.
@@ -5995,7 +6253,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v3.0
+   * @since v3.0.0
    */
   addValueListener<ValueIdOrNull extends ValueIdFromSchema<Schemas[1]> | null>(
     valueId: ValueIdOrNull,
@@ -6060,7 +6318,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * To help understand all of these schema-based conditions, please see the
    * TablesSchema example below.
-   *
    * @param tableId The Id of the Table to listen to, or `null` as a wildcard.
    * @param rowId The Id of the Row to listen to, or `null` as a wildcard.
    * @param cellId The Id of the Cell to listen to, or `null` as a wildcard.
@@ -6236,7 +6493,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v1.1
+   * @since v1.1.0
    */
   addInvalidCellListener(
     tableId: IdOrNull,
@@ -6294,7 +6551,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * To help understand all of these schema-based conditions, please see the
    * ValuesSchema example below.
-   *
    * @param valueId The Id of the Value to listen to, or `null` as a wildcard.
    * @param listener The function that will be called whenever an attempt to
    * write invalid data to the matching Value was made.
@@ -6424,7 +6680,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * store.delListener(listenerId);
    * ```
    * @category Listener
-   * @since v3.0
+   * @since v3.0.0
    */
   addInvalidValueListener(
     valueId: IdOrNull,
@@ -6450,7 +6706,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * Note that a TransactionListener added to the Store with this method can
    * mutate the Store, and its changes will be treated as part of the
    * transaction that is starting.
-   *
    * @returns A unique Id for the listener that can later be used to remove it.
    * @example
    * This example registers a listener that is called at start end of the
@@ -6513,7 +6768,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * mutate the Store itself, and its changes will be treated as part of the
    * transaction that is starting (and may fire non-mutating listeners after
    * this).
-   *
    * @returns A unique Id for the listener that can later be used to remove it.
    * @example
    * This example registers a listener that is called at the end of the
@@ -6583,7 +6837,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *   .delListener(listenerId3);
    * ```
    * @category Listener
-   * @since v1.3
+   * @since v1.3.0
    */
   addWillFinishTransactionListener(listener: TransactionListener<Schemas>): Id;
 
@@ -6616,7 +6870,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * Note that a TransactionListener added to the Store with this method
    * _cannot_ mutate the Store itself, and attempts to do so will fail silently.
-   *
    * @returns A unique Id for the listener that can later be used to remove it.
    * @example
    * This example registers a listener that is called at the end of the
@@ -6686,7 +6939,7 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *   .delListener(listenerId3);
    * ```
    * @category Listener
-   * @since v1.3
+   * @since v1.3.0
    */
   addDidFinishTransactionListener(listener: TransactionListener<Schemas>): Id;
 
@@ -6703,7 +6956,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * This is useful when you are using mutator listeners to guarantee that data
    * conforms to programmatic conditions, and those conditions change such that
    * you need to update the Store in bulk.
-   *
    * @param listenerId The Id of the listener to call.
    * @returns A reference to the Store.
    * @example
@@ -6825,7 +7077,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    *
    * Use the Id returned by whichever method was used to add the listener. Note
    * that the Store may re-use this Id for future listeners added to it.
-   *
    * @param listenerId The Id of the listener to remove.
    * @returns A reference to the Store.
    * @example
@@ -6863,7 +7114,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * return an empty object. The method is intended to be used during
    * development to ensure your application is not leaking listener
    * registrations, for example.
-   *
    * @returns A StoreListenerStats object containing Store listener statistics.
    * @example
    * This example gets the listener statistics of a small and simple Store.
@@ -6896,7 +7146,6 @@ export interface Store<in out Schemas extends OptionalSchemas> {
  *
  * Since (or perhaps _because_) it is the most important function in the whole
  * module, it is trivially simple.
- *
  * @returns A reference to the new Store.
  * @example
  * This example creates a Store.