tinybase 3.1.0-beta.5 → 3.1.1

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

@@ -133,10 +133,7 @@ export type ValueSchema =
  * The NoTablesSchema type is a TablesSchema-like type for when one has not been
  * provided.
  *
- * This type is used internally to the TinyBase type system and you are not
- * expected to need to use it directly.
- *
- * @category Internal
+ * @category Schema
  */
 export type NoTablesSchema = {[tableId: Id]: {[cellId: Id]: {type: 'any'}}};
 
@@ -144,10 +141,7 @@ export type NoTablesSchema = {[tableId: Id]: {[cellId: Id]: {type: 'any'}}};
  * The NoValuesSchema type is a ValuesSchema-like type for when one has not been
  * provided.
  *
- * This type is used internally to the TinyBase type system and you are not
- * expected to need to use it directly.
- *
- * @category Internal
+ * @category Schema
  */
 export type NoValuesSchema = {[valueId: Id]: {type: 'any'}};
 
@@ -187,6 +181,12 @@ export type NoSchemas = [NoTablesSchema, NoValuesSchema];
  * The Tables type is the data structure representing all of the data in a
  * Store.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * {[tableId: Id]: Table};
+ * ```
+ *
  * A Tables object is used when setting all of the tables together with the
  * setTables method, and when getting them back out again with the getTables
  * method. A Tables object is a regular JavaScript object containing individual
@@ -221,6 +221,12 @@ export type Tables<
 /**
  * The Table type is the data structure representing the data in a single table.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * {[rowId: Id]: Row};
+ * ```
+ *
  * A Table is used when setting a table with the setTable method, and when
  * getting it back out again with the getTable method. A Table object is a
  * regular JavaScript object containing individual Row objects, keyed by their
@@ -244,6 +250,12 @@ export type Table<
 /**
  * The Row type is the data structure representing the data in a single row.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * {[cellId: Id]: Cell};
+ * ```
+ *
  * 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.
@@ -283,6 +295,12 @@ export type Row<
 /**
  * The Cell type is the data structure representing the data in a single cell.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * string | number | boolean;
+ * ```
+ *
  * 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.
@@ -310,6 +328,12 @@ export type Cell<
  * The CellOrUndefined type is a data structure representing the data in a
  * single cell, or the value `undefined`.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * Cell | undefined;
+ * ```
+ *
  * 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.
@@ -326,6 +350,12 @@ export type CellOrUndefined<
  * The Values type is the data structure representing all the keyed values in a
  * Store.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * {[valueId: Id]: Value};
+ * ```
+ *
  * A Values object is used when setting values with the setValues method, and
  * when getting them back out again with the getValues method. A Values object
  * is a regular JavaScript object containing individual Value objects, keyed by
@@ -364,6 +394,12 @@ export type Values<
  * The Value type is the data structure representing the data in a single keyed
  * value.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * string | number | boolean;
+ * ```
+ *
  * 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.
@@ -391,6 +427,12 @@ export type Value<
  * The ValueOrUndefined type is a data structure representing the data in a
  * single value, or the value `undefined`.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * Value | undefined;
+ * ```
+ *
  * 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.
@@ -407,6 +449,15 @@ export type ValueOrUndefined<
  * The TableCallback type describes a function that takes a Table's Id and a
  * callback to loop over each Row within it.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   tableId: Id,
+ *   forEachRow: (rowCallback: RowCallback) => void,
+ * ) => void;
+ * ```
+ *
  * 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.
@@ -434,6 +485,15 @@ export type TableCallback<
  * The RowCallback type describes a function that takes a Row's Id and a
  * callback to loop over each Cell within it.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   rowId: Id,
+ *   forEachCell: (cellCallback: CellCallback) => void,
+ * ) => void;
+ * ```
+ *
  * 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.
@@ -459,6 +519,12 @@ export type RowCallback<
  * The CellCallback type describes a function that takes a Cell's Id and its
  * value.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (cellId: Id, cell: Cell) => void;
+ * ```
+ *
  * 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.
@@ -491,6 +557,12 @@ export type CellCallback<
  * The ValueCallback type describes a function that takes a Value's Id and its
  * actual value.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (valueId: Id, value: Value) => void;
+ * ```
+ *
  * 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.
@@ -519,6 +591,12 @@ export type ValueCallback<
  * The MapCell type describes a function that takes an existing Cell value and
  * returns another.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (cell: CellOrUndefined) => Cell;
+ * ```
+ *
  * 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.
@@ -538,6 +616,12 @@ export type MapCell<
  * The MapValue type describes a function that takes an existing Value and
  * returns another.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (value: ValueOrUndefined) => Value;
+ * ```
+ *
  * 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.
@@ -555,6 +639,12 @@ export type MapValue<
  * The GetCell type describes a function that takes a Id and returns the Cell
  * value for a particular Row.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (cellId: Id) => CellOrUndefined;
+ * ```
+ *
  * 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.
@@ -573,6 +663,17 @@ export type GetCell<
  * The DoRollback type describes a function that you can use to rollback the
  * transaction if it did not complete to your satisfaction.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   changedCells: ChangedCells,
+ *   invalidCells: InvalidCells,
+ *   changedValues: ChangedValues,
+ *   invalidValues: InvalidValues,
+ * ) => boolean;
+ * ```
+ *
  * A DoRollback can be provided when calling the transaction method or the
  * finishTransaction method. See those methods for specific examples.
  *
@@ -599,6 +700,16 @@ export type DoRollback<Schemas extends OptionalSchemas> = (
  * The TransactionListener type describes a function that is used to listen to
  * the completion of a transaction for the Store.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   cellsTouched: boolean,
+ *   valuesTouched: boolean,
+ * ) => void;
+ * ```
+ *
  * A TransactionListener is provided when using the
  * addWillFinishTransactionListener and addDidFinishTransactionListener methods.
  * See those methods for specific examples.
@@ -631,6 +742,15 @@ export type TransactionListener<Schemas extends OptionalSchemas> = (
  * The TablesListener type describes a function that is used to listen to
  * changes to the whole Store.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   getCellChange: GetCellChange | undefined,
+ * ) => void;
+ * ```
+ *
  * A TablesListener is provided when using the addTablesListener method. See
  * that method for specific examples.
  *
@@ -656,6 +776,12 @@ export type TablesListener<Schemas extends OptionalSchemas> = (
  * The TableIdsListener type describes a function that is used to listen to
  * changes to the Table Ids in the Store.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (store: Store) => void;
+ * ```
+ *
  * A TableIdsListener is provided when using the addTableIdsListener method. See
  * that method for specific examples.
  *
@@ -672,6 +798,16 @@ export type TableIdsListener<Schemas extends OptionalSchemas> = (
  * The TableListener type describes a function that is used to listen to changes
  * to a Table.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   tableId: Id,
+ *   getCellChange: GetCellChange | undefined,
+ * ) => void;
+ * ```
+ *
  * A TableListener is provided when using the addTableListener method. See that
  * method for specific examples.
  *
@@ -704,6 +840,12 @@ export type TableListener<
  * The RowIdsListener type describes a function that is used to listen to
  * changes to the Row Ids in a Table.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (store: Store, tableId: Id) => void;
+ * ```
+ *
  * A RowIdsListener is provided when using the addRowIdsListener method. See
  * that method for specific examples.
  *
@@ -728,6 +870,20 @@ export type RowIdsListener<
  * The SortedRowIdsListener type describes a function that is used to listen to
  * changes to sorted Row Ids in a Table.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   tableId: Id,
+ *   cellId: Id | undefined,
+ *   descending: boolean,
+ *   offset: number,
+ *   limit: number | undefined,
+ *   sortedRowIds: Ids,
+ * ) => void;
+ * ```
+ *
  * A SortedRowIdsListener is provided when using the addSortedRowIdsListener
  * method. See that method for specific examples.
  *
@@ -769,6 +925,17 @@ export type SortedRowIdsListener<
  * The RowListener type describes a function that is used to listen to changes
  * to a Row.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   tableId: Id,
+ *   rowId: Id,
+ *   getCellChange: GetCellChange | undefined,
+ * ) => void;
+ * ```
+ *
  * A RowListener is provided when using the addRowListener method. See that
  * method for specific examples.
  *
@@ -805,6 +972,12 @@ export type RowListener<
  * The CellIdsListener type describes a function that is used to listen to
  * changes to the Cell Ids in a Row.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (store: Store, tableId: Id, rowId: Id) => void;
+ * ```
+ *
  * A CellIdsListener is provided when using the addCellIdsListener method. See
  * that method for specific examples.
  *
@@ -832,6 +1005,20 @@ export type CellIdsListener<
  * The CellListener type describes a function that is used to listen to changes
  * to a Cell.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   tableId: Id,
+ *   rowId: Id,
+ *   cellId: Id,
+ *   newCell: Cell,
+ *   oldCell: Cell,
+ *   getCellChange: GetCellChange | undefined,
+ * ) => void;
+ * ```
+ *
  * A CellListener is provided when using the addCellListener method. See that
  * method for specific examples.
  *
@@ -922,6 +1109,15 @@ export type CellListener<
  * The ValuesListener type describes a function that is used to listen to
  * changes to all the Values in a Store.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   getValueChange: GetValueChange | undefined,
+ * ) => void;
+ * ```
+ *
  * A ValuesListener is provided when using the addValuesListener method. See
  * that method for specific examples.
  *
@@ -947,6 +1143,12 @@ export type ValuesListener<Schemas extends OptionalSchemas> = (
  * The ValueIdsListener type describes a function that is used to listen to
  * changes to the Value Ids in a Store.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (store: Store) => void;
+ * ```
+ *
  * A ValueIdsListener is provided when using the addValueIdsListener method. See
  * that method for specific examples.
  *
@@ -963,6 +1165,18 @@ export type ValueIdsListener<Schemas extends OptionalSchemas> = (
  * The ValueListener type describes a function that is used to listen to changes
  * to a Value.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   valueId: Id,
+ *   newValue: Value,
+ *   oldValue: Value,
+ *   getValueChange: GetValueChange | undefined,
+ * ) => void;
+ * ```
+ *
  * A ValueListener is provided when using the addValueListener method. See that
  * method for specific examples.
  *
@@ -1027,6 +1241,18 @@ export type ValueListener<
  * The InvalidCellListener type describes a function that is used to listen to
  * attempts to set invalid data to a Cell.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   tableId: Id,
+ *   rowId: Id,
+ *   cellId: Id,
+ *   invalidCells: any[],
+ * ) => void;
+ * ```
+ *
  * A InvalidCellListener is provided when using the addInvalidCellListener
  * method. See that method for specific examples.
  *
@@ -1057,6 +1283,16 @@ export type InvalidCellListener<Schemas extends OptionalSchemas> = (
  * The InvalidValueListener type describes a function that is used to listen to
  * attempts to set invalid data to a Value.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (
+ *   store: Store,
+ *   valueId: Id,
+ *   invalidValues: any[],
+ * ) => void;
+ * ```
+ *
  * A InvalidValueListener is provided when using the addInvalidValueListener
  * method. See that method for specific examples.
  *
@@ -1083,6 +1319,12 @@ export type InvalidValueListener<Schemas extends OptionalSchemas> = (
  * The GetCellChange type describes a function that returns information about
  * any Cell's changes during a transaction.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (tableId: Id, rowId: Id, cellId: Id) => CellChange;
+ * ```
+ *
  * A GetCellChange function is provided to every listener when called due the
  * 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
@@ -1106,6 +1348,16 @@ export type GetCellChange<Schema extends OptionalTablesSchema> = <
 /**
  * The CellChange type describes a Cell's changes during a transaction.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * [
+ *   changed: boolean,
+ *   oldCell: CellOrUndefined,
+ *   newCell: CellOrUndefined,
+ * ];
+ * ```
+ *
  * This is returned by the GetCellChange function that is provided to every
  * 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
@@ -1124,6 +1376,12 @@ export type CellChange<
  * The GetValueChange type describes a function that returns information about
  * any Value's changes during a transaction.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * (valueId: Id) => ValueChange;
+ * ```
+ *
  * A GetValueChange function is provided to every listener when called due the
  * 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
@@ -1143,6 +1401,16 @@ export type GetValueChange<Schema extends OptionalValuesSchema> = <
 /**
  * The ValueChange type describes a Value's changes during a transaction.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * [
+ *   changed: boolean,
+ *   oldValue: ValueOrUndefined,
+ *   newValue: ValueOrUndefined,
+ * ];
+ * ```
+ *
  * This is returned by the GetValueChange function that is provided to every
  * listener when called. This array contains the previous value of a Value
  * before the current transaction, the new value after it, and a convenience
@@ -1161,6 +1429,18 @@ export type ValueChange<
  * a transaction, primarily used so that you can indicate whether the
  * transaction should be rolled back.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * {
+ *   [tableId: Id]: {
+ *     [rowId: Id]: {
+ *       [cellId: Id]: [CellOrUndefined, CellOrUndefined];
+ *     };
+ *   };
+ * };
+ * ```
+ *
  * A ChangedCells object is provided to the `doRollback` callback when using the
  * transaction method and the finishTransaction method. See those methods for
  * specific examples.
@@ -1222,6 +1502,14 @@ export type InvalidCells = {
  * transaction, primarily used so that you can indicate whether the transaction
  * should be rolled back.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * {
+ *   [valueId: Id]: [ValueOrUndefined, ValueOrUndefined];
+ * };
+ * ```
+ *
  * A ChangedValues object is provided to the `doRollback` callback when using
  * the transaction method and the finishTransaction method. See those methods
  * for specific examples.
@@ -1526,6 +1814,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The getTables method returns a Tables object containing the entire data of
    * the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getTables(): Tables;
+   * ```
+   *
    * 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.
@@ -1558,6 +1852,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The getTableIds method returns the Ids of every Table in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getTableIds(): 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.
    *
@@ -1590,6 +1890,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The getTable method returns an object containing the entire data of a
    * single Table in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getTable(tableId: Id): Table;
+   * ```
+   *
    * 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.
@@ -1625,6 +1931,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The getRowIds method returns the Ids of every Row in a given Table.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getRowIds(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.
    *
@@ -1660,6 +1972,18 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The getSortedRowIds method returns the Ids of every Row in a given Table,
    * sorted according to the values in a specified Cell.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getSortedRowIds(
+   *   tableId: Id,
+   *   cellId?: Id,
+   *   descending?: boolean,
+   *   offset?: number,
+   *   limit?: number,
+   * ): Ids;
+   * ```
+   *
    * The sorting of the rows is alphanumeric, and you can indicate whether it
    * should be in descending order. The `offset` and `limit` parameters are used
    * to paginate results, but default to `0` and `undefined` to return all
@@ -1767,6 +2091,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The getRow method returns an object containing the entire data of a single
    * Row in a given Table.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getRow(tableId: Id, rowId: Id): Row;
+   * ```
+   *
    * 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.
@@ -1807,6 +2137,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * 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:
+   *
+   * ```ts override
+   * getCellIds(tableId: Id, rowId: 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.
    *
@@ -1845,6 +2181,12 @@ 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.
@@ -1882,6 +2224,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The getValues method returns an object containing the entire set of keyed
    * Values in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getValues(): Values;
+   * ```
+   *
    * 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.
@@ -1912,6 +2260,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The getValueIds method returns the Ids of every Value in a Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getValueIds(): 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.
    *
@@ -1941,6 +2295,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The getValue method returns a single keyed Value in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * getValue(valueId: Id): ValueOrUndefined;
+   * ```
+   *
    * @param valueId The Id of the Value in the Store.
    * @returns The Value, or `undefined`.
    * @example
@@ -1990,6 +2350,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The hasTable method returns a boolean indicating whether a given Table
    * exists in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * hasTable(tableId: Id): boolean;
+   * ```
+   *
    * @param tableId The Id of a possible Table in the Store.
    * @returns Whether a Table with that Id exists.
    * @example
@@ -2010,6 +2376,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The hasRow method returns a boolean indicating whether a given Row exists
    * in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * hasRow(tableId: Id, rowId: Id): boolean;
+   * ```
+   *
    * @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.
@@ -2031,6 +2403,12 @@ 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;
+   * ```
+   *
    * @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.
@@ -2078,6 +2456,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The hasValue method returns a boolean indicating whether a given Value
    * exists in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * 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
@@ -2289,6 +2673,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The setTables method takes an object and sets the entire data of the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setTables(tables: Tables): Store;
+   * ```
+   *
    * This method will cause listeners to be called for any Table, Row, Cell, or
    * Id changes resulting from it.
    *
@@ -2338,6 +2728,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The setTable method takes an object and sets the entire data of a single
    * Table in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setTable(tableId: Id, table: Table): Store;
+   * ```
+   *
    * This method will cause listeners to be called for any Table, Row, Cell, or
    * Id changes resulting from it.
    *
@@ -2392,6 +2788,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The setRow method takes an object and sets the entire data of a single Row
    * in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setRow(tableId: Id, rowId: Id, row: Row): Store;
+   * ```
+   *
    * This method will cause listeners to be called for any Table, Row, Cell, or
    * Id changes resulting from it.
    *
@@ -2446,6 +2848,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addRow method takes an object and creates a new Row in the Store,
    * returning the unique Id assigned to it.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addRow(tableId: Id, row: Row, reuseRowIds?: boolean): Id | undefined;
+   * ```
+   *
    * This method will cause listeners to be called for any Table, Row, Cell, or
    * Id changes resulting from it.
    *
@@ -2461,8 +2869,17 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * Row is added to the Table. However it is likely to be a string
    * representation of an increasing integer.
    *
+   * The `reuseRowIds` parameter defaults to `true`, which means that if you
+   * delete a Row and then add another, the Id will be re-used - unless you
+   * delete the entire Table, in which case all Row Ids will reset. Otherwise,
+   * 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
+   * Row objects, defaulting to `true`.
    * @returns A reference to the Store.
    * @example
    * This example adds a single Row.
@@ -2496,12 +2913,19 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   addRow<TableId extends TableIdFromSchema<Schemas[0]>>(
     tableId: TableId,
     row: Row<Schemas[0], TableId, true>,
+    reuseRowIds?: boolean,
   ): Id | undefined;
 
   /**
    * The setPartialRow method takes an object and sets partial data of a single
    * Row in the Store, leaving other Cell values unaffected.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setPartialRow(tableId: Id, rowId: Id, partialRow: Row): Store;
+   * ```
+   *
    * This method will cause listeners to be called for any Table, Row, Cell, or
    * Id changes resulting from it.
    *
@@ -2557,6 +2981,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The setCell method sets the value of a single Cell in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setCell(tableId: Id, rowId: Id, cellId: Id, cell: Cell | MapCell): Store;
+   * ```
+   *
    * This method will cause listeners to be called for any Table, Row, Cell, or
    * Id changes resulting from it.
    *
@@ -2625,6 +3055,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The setValues method takes an object and sets all the Values in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setValues(values: Values): Store;
+   * ```
+   *
    * This method will cause listeners to be called for any Value or Id changes
    * resulting from it.
    *
@@ -2674,6 +3110,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The setPartialValues method takes an object and sets its Values in the
    * Store, but leaving existing Values unaffected.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setPartialValues(partialValues: Values): Store;
+   * ```
+   *
    * This method will cause listeners to be called for any Values or Id changes
    * resulting from it.
    *
@@ -2723,6 +3165,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The setValue method sets a single keyed Value in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setValue(valueId: Id, value: Value | MapValue): Store;
+   * ```
+   *
    * This method will cause listeners to be called for any Value, or Id changes
    * resulting from it.
    *
@@ -2781,6 +3229,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The setTablesJson method takes a string serialization of all of the Tables
    * in the Store and attempts to update them to that.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setTablesJson(tablesJson: Json): Store;
+   * ```
+   *
    * If the JSON cannot be parsed, this will fail silently. If it can be parsed,
    * it will then be subject to the same validation rules as the setTables
    * method (according to the Tables type, and matching any TablesSchema
@@ -2816,6 +3270,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The setValuesJson method takes a string serialization of all of the Values
    * in the Store and attempts to update them to those values.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setValuesJson(valuesJson: Json): Store;
+   * ```
+   *
    * If the JSON cannot be parsed, this will fail silently. If it can be parsed,
    * it will then be subject to the same validation rules as the setValues
    * method (according to the Values type, and matching any ValuesSchema
@@ -2851,6 +3311,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The setJson method takes a string serialization of all of the Tables and
    * Values in the Store and attempts to update them to those values.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setJson(tablesAndValuesJson: Json): Store;
+   * ```
+   *
    * From v3.0.0 onwards, the serialization should be of an array with two
    * entries. The first is the Tables object, the second the Values. In previous
    * versions (before the existence of the Values data structure), it was a sole
@@ -2910,6 +3376,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The setTablesSchema method lets you specify the TablesSchema of the tabular
    * part of the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setTablesSchema(tablesSchema: TablesSchema): Store;
+   * ```
+   *
    * Note that this may result in a change to data in the Store, as defaults are
    * applied or as invalid Table, Row, or Cell objects are removed. These
    * changes will fire any listeners to that data, as expected.
@@ -2945,6 +3417,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The setValuesSchema method lets you specify the ValuesSchema of the keyed
    * Values part of the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setValuesSchema(valuesSchema: ValuesSchema): Store;
+   * ```
+   *
    * Note that this may result in a change to data in the Store, as defaults are
    * applied or as invalid Values are removed. These changes will fire any
    * listeners to that data, as expected.
@@ -2977,6 +3455,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The setSchema method lets you specify the TablesSchema and ValuesSchema of
    * the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * setSchema(tablesSchema: TablesSchema, valuesSchema?: ValuesSchema): Store;
+   * ```
+   *
    * Note that this may result in a change to data in the Store, as defaults are
    * applied or as invalid Table, Row, Cell, or Value objects are removed. These
    * changes will fire any listeners to that data, as expected.
@@ -3045,6 +3529,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The delTables method lets you remove all of the data in a Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * delTables(): Store;
+   * ```
+   *
    * @returns A reference to the Store.
    * @example
    * This example removes the data of a Store.
@@ -3063,6 +3553,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The delTable method lets you remove a single Table from the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * delTable(tableId: Id): Store;
+   * ```
+   *
    * @param tableId The Id of the Table in the Store.
    * @returns A reference to the Store.
    * @example
@@ -3085,6 +3581,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The delRow method lets you remove a single Row from a Table.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * delRow(tableId: Id, rowId: Id): Store;
+   * ```
+   *
    * 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.
@@ -3109,6 +3611,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The delCell method lets you remove a single Cell from a Row.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * delCell(tableId: Id, rowId: Id, cellId: Id, forceDel?: boolean): Store;
+   * ```
+   *
    * When there is no TablesSchema applied to the Store, then if this is the
    * last Cell in its Row, then that Row will be removed. If, in turn, that is
    * the last Row in its Table, then that Table will be removed.
@@ -3198,6 +3706,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The delValues method lets you remove all the Values from a Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * delValues(): Store;
+   * ```
+   *
    * 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.
@@ -3237,6 +3751,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The delValue method lets you remove a single Value from a Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * delValue(valueId: Id): Store;
+   * ```
+   *
    * 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.
@@ -3277,6 +3797,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The delTablesSchema method lets you remove the TablesSchema of the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * delTablesSchema(): Store;
+   * ```
+   *
    * @returns A reference to the Store.
    * @example
    * This example removes the TablesSchema of a Store.
@@ -3298,6 +3824,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
   /**
    * The delValuesSchema method lets you remove the ValuesSchema of the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * delValuesSchema(): Store;
+   * ```
+   *
    * @returns A reference to the Store.
    * @example
    * This example removes the ValuesSchema of a Store.
@@ -3321,6 +3853,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The delSchema method lets you remove both the TablesSchema and ValuesSchema
    * of the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * delSchema(): Store;
+   * ```
+   *
    * Prior to v3.0.0, this method removed the TablesSchema only.
    *
    * @returns A reference to the Store.
@@ -3349,6 +3887,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * the Store, buffering all calls to the relevant listeners until it
    * completes.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * transaction<Return>(actions: () => Return, doRollback?: DoRollback): Return;
+   * ```
+   *
    * This method is useful for making bulk changes to the data in a Store, and
    * when you don't want listeners to be called as you make each change. Changes
    * are made silently during the transaction, and listeners relevant to the
@@ -3481,6 +4025,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * relevant listeners until it completes when you call the finishTransaction
    * method.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * startTransaction(): Store;
+   * ```
+   *
    * Transactions are useful for making bulk changes to the data in a Store, and
    * when you don't want listeners to be called as you make each change. Changes
    * are made silently during the transaction, and listeners relevant to the
@@ -3531,6 +4081,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * that has made multiple mutations to the Store, triggering all calls to the
    * relevant listeners.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * finishTransaction(doRollback?: DoRollback): Store;
+   * ```
+   *
    * Transactions are useful for making bulk changes to the data in a Store, and
    * when you don't want listeners to be called as you make each change. Changes
    * are made silently during the transaction, and listeners relevant to the
@@ -3628,6 +4184,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The forEachTable method takes a function that it will then call for each
    * Table in the Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * forEachTable(tableCallback: TableCallback): void;
+   * ```
+   *
    * This method is useful for iterating over the Table structure of the Store
    * in a functional style. The `tableCallback` parameter is a TableCallback
    * function that will be called with the Id of each Table, and with a function
@@ -3661,6 +4223,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The forEachRow method takes a function that it will then call for each Row
    * in a specified Table.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * forEachRow(tableId: Id, rowCallback: RowCallback): void;
+   * ```
+   *
    * This method is useful for iterating over the Row structure of the Table in
    * 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
@@ -3699,6 +4267,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The forEachCell method takes a function that it will then call for each
    * Cell in a specified Row.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * forEachCell(tableId: Id, rowId: Id, cellCallback: CellCallback): void;
+   * ```
+   *
    * 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.
@@ -3731,6 +4305,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The forEachValue method takes a function that it will then call for each
    * Value in a Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * forEachValue(valueCallback: ValueCallback): void;
+   * ```
+   *
    * 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.
@@ -3756,6 +4336,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addTablesListener method registers a listener function with the Store
    * that will be called whenever data in the Store changes.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addTablesListener(listener: TablesListener, mutator?: boolean): Id;
+   * ```
+   *
    * The provided listener is a TablesListener function, and will be called with
    * a reference to the Store and a GetCellChange function in case you need to
    * inspect any changes that occurred.
@@ -3820,6 +4406,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addTableIdsListener method registers a listener function with the Store
    * that will be called whenever the Table Ids in the Store change.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addTableIdsListener(listener: TableIdsListener, mutator?: boolean): Id;
+   * ```
+   *
    * The provided listener is a TableIdsListener function, and will be called
    * with a reference to the Store.
    *
@@ -3886,6 +4478,16 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addTableListener method registers a listener function with the Store
    * that will be called whenever data in a Table changes.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addTableListener(
+   *   tableId: IdOrNull,
+   *   listener: TableListener,
+   *   mutator?: boolean,
+   * ): Id;
+   * ```
+   *
    * The provided listener is a TableListener function, and will be called with
    * a reference to the Store, the Id of the Table that changed, and a
    * GetCellChange function in case you need to inspect any changes that
@@ -3983,6 +4585,16 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addRowIdsListener method registers a listener function with the Store
    * that will be called whenever the Row Ids in a Table change.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addRowIdsListener(
+   *   tableId: IdOrNull,
+   *   listener: RowIdsListener,
+   *   mutator?: boolean,
+   * ): Id;
+   * ```
+   *
    * The provided listener is a RowIdsListener function, and will be called with
    * a reference to the Store and the Id of the Table that changed.
    *
@@ -4076,6 +4688,20 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * Store that will be called whenever sorted (and optionally, paginated) Row
    * Ids in a Table change.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addSortedRowIdsListener(
+   *   tableId: Id,
+   *   cellId: Id | undefined,
+   *   descending: boolean,
+   *   offset: number,
+   *   limit: number | undefined,
+   *   listener: SortedRowIdsListener,
+   *   mutator?: boolean,
+   * ): Id;
+   * ```
+   *
    * The provided listener is a SortedRowIdsListener function, and will be
    * called with a reference to the Store, the Id of the Table whose Row Ids
    * sorting changed, the Cell Id being used to sort them, whether descending or
@@ -4314,6 +4940,17 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addRowListener method registers a listener function with the Store that
    * will be called whenever data in a Row changes.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addRowListener(
+   *   tableId: IdOrNull,
+   *   rowId: IdOrNull,
+   *   listener: RowListener,
+   *   mutator?: boolean,
+   * ): Id;
+   * ```
+   *
    * The provided listener is a RowListener function, and will be called with a
    * reference to the Store, the Id of the Table that changed, the Id of the Row
    * that changed, and a GetCellChange function in case you need to inspect any
@@ -4427,6 +5064,17 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addCellIdsListener method registers a listener function with the Store
    * that will be called whenever the Cell Ids in a Row change.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addCellIdsListener(
+   *   tableId: IdOrNull,
+   *   rowId: IdOrNull,
+   *   listener: CellIdsListener,
+   *   mutator?: boolean,
+   * ): Id;
+   * ```
+   *
    * The provided listener is a CellIdsListener function, and will be called
    * with a reference to the Store, the Id of the Table, and the Id of the Row
    * that changed.
@@ -4536,6 +5184,18 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addCellListener method registers a listener function with the Store
    * that will be called whenever data in a Cell changes.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addCellListener(
+   *   tableId: IdOrNull,
+   *   rowId: IdOrNull,
+   *   cellId: IdOrNull,
+   *   listener: CellListener,
+   *   mutator?: boolean,
+   * ): Id;
+   * ```
+   *
    * The provided listener is a CellListener function, and will be called with a
    * reference to the Store, the Id of the Table that changed, the Id of the Row
    * that changed, the Id of the Cell that changed, the new Cell value, the old
@@ -4664,6 +5324,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addValuesListener method registers a listener function with the Store
    * that will be called whenever the Values change.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addValuesListener(listener: ValuesListener, mutator?: boolean): Id;
+   * ```
+   *
    * The provided listener is a ValuesListener function, and will be called with
    * a reference to the Store and a GetValueChange function in case you need to
    * inspect any changes that occurred.
@@ -4725,6 +5391,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addValueIdsListener method registers a listener function with the Store
    * that will be called whenever the Value Ids in a Store change.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addValueIdsListener(listener: ValueIdsListener, mutator?: boolean): Id;
+   * ```
+   *
    * The provided listener is a ValueIdsListener function, and will be called
    * with a reference to the Store.
    *
@@ -4792,6 +5464,16 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The addValueListener method registers a listener function with the Store
    * that will be called whenever data in a Value changes.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addValueListener(
+   *   valueId: IdOrNull,
+   *   listener: ValueListener,
+   *   mutator?: boolean,
+   * ): Id;
+   * ```
+   *
    * The provided listener is a ValueListener function, and will be called with
    * a reference to the Store, the Id of the Value that changed, the new Value
    * value, the old Value, and a GetValueChange function in case you need to
@@ -4886,6 +5568,18 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * Store that will be called whenever invalid data was attempted to be written
    * to a Cell.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addInvalidCellListener(
+   *   tableId: IdOrNull,
+   *   rowId: IdOrNull,
+   *   cellId: IdOrNull,
+   *   listener: InvalidCellListener,
+   *   mutator?: boolean,
+   * ): Id;
+   * ```
+   *
    * The provided listener is an InvalidCellListener function, and will be
    * called with a reference to the Store, the Id of the Table, the Id of the
    * Row, and the Id of Cell that was being attempted to be changed. It is also
@@ -5117,6 +5811,16 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * Store that will be called whenever invalid data was attempted to be written
    * to a Value.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addInvalidValueListener(
+   *   valueId: IdOrNull,
+   *   listener: InvalidValueListener,
+   *   mutator?: boolean,
+   * ): Id;
+   * ```
+   *
    * The provided listener is an InvalidValueListener function, and will be
    * called with a reference to the Store and the Id of Value that was being
    * attempted to be changed. It is also given the invalid value of the Value,
@@ -5293,6 +5997,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * with the Store that will be called just before other non-mutating listeners
    * are called at the end of the transaction.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addWillFinishTransactionListener(listener: TransactionListener): Id;
+   * ```
+   *
    * This is useful if you need to know that a set of listeners are about to be
    * called at the end of a transaction, perhaps to batch _their_ consequences
    * together.
@@ -5385,6 +6095,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * with the Store that will be called just after other non-mutating listeners
    * are called at the end of the transaction.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * addDidFinishTransactionListener(listener: TransactionListener): Id;
+   * ```
+   *
    * This is useful if you need to know that a set of listeners have just been
    * called at the end of a transaction, perhaps to batch _their_ consequences
    * together.
@@ -5477,6 +6193,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The callListener method provides a way for you to manually provoke a
    * listener to be called, even if the underlying data hasn't changed.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * callListener(listenerId: Id): Store;
+   * ```
+   *
    * 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.
@@ -5594,6 +6316,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
    * The delListener method removes a listener that was previously added to the
    * Store.
    *
+   * This has schema-based typing. The following is a simplified representation:
+   *
+   * ```ts override
+   * delListener(listenerId: Id): Store;
+   * ```
+   *
    * 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.
    *
@@ -5659,6 +6387,12 @@ export interface Store<in out Schemas extends OptionalSchemas> {
  * The createStore function creates a Store, and is the main entry point into
  * the store module.
  *
+ * This has schema-based typing. The following is a simplified representation:
+ *
+ * ```ts override
+ * createStore(): Store;
+ * ```
+ *
  * Since (or perhaps _because_) it is the most important function in the whole
  * module, it is trivially simple.
  *