tinybase 5.0.0-beta.26 → 5.0.0-beta.28

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

@@ -8,6 +8,7 @@
  * of checkpoints change.
  * @packageDocumentation
  * @module checkpoints
+ * @since v1.0.0
  */
 
 import type {Id, IdOrNull, Ids} from '../common/index.d.cts';
@@ -28,6 +29,7 @@ import type {Store} from '../store/index.d.cts';
  *   the checkpoints in the redo stack for this Store). They are in
  *   chronological order with the newest checkpoint at the end of the array.
  * @category Identity
+ * @since v1.0.0
  */
 export type CheckpointIds = [Ids, Id | undefined, Ids];
 
@@ -41,6 +43,7 @@ export type CheckpointIds = [Ids, Id | undefined, Ids];
  * @param checkpointId The Id of the Checkpoint that the callback can operate
  * on.
  * @category Callback
+ * @since v1.0.0
  */
 export type CheckpointCallback = (checkpointId: Id, label?: string) => void;
 
@@ -55,6 +58,7 @@ export type CheckpointCallback = (checkpointId: Id, label?: string) => void;
  * object.
  * @param checkpoints A reference to the Checkpoints object that changed.
  * @category Listener
+ * @since v1.0.0
  */
 export type CheckpointIdsListener = (checkpoints: Checkpoints) => void;
 
@@ -70,6 +74,7 @@ export type CheckpointIdsListener = (checkpoints: Checkpoints) => void;
  * @param checkpoints A reference to the Checkpoints object that changed.
  * @param checkpointId The Id of the checkpoint that changed.
  * @category Listener
+ * @since v1.0.0
  */
 export type CheckpointListener = (
   checkpoints: Checkpoints,
@@ -84,16 +89,21 @@ export type CheckpointListener = (
  * A CheckpointsListenerStats object is returned from the getListenerStats
  * method.
  * @category Development
+ * @since v1.0.0
  */
 export type CheckpointsListenerStats = {
   /**
    * The number of CheckpointIdsListener functions registered with the
    * Checkpoints object.
+   * @category Stat
+   * @since v1.0.0
    */
   checkpointIds: number;
   /**
    * The number of CheckpointListener functions registered with the Checkpoints
    * object.
+   * @category Stat
+   * @since v1.0.0
    */
   checkpoint: number;
 };
@@ -164,10 +174,11 @@ export type CheckpointsListenerStats = {
  *
  * checkpoints.delListener(listenerId);
  * ```
- * @see Relationships And Checkpoints guides
+ * @see Using Checkpoints guide
  * @see Todo App demos
  * @see Drawing demo
  * @category Checkpoints
+ * @since v1.0.0
  */
 export interface Checkpoints {
   //
@@ -213,6 +224,7 @@ export interface Checkpoints {
    * // -> [['1', '2'], '3', []]
    * ```
    * @category Configuration
+   * @since v1.0.0
    */
   setSize(size: number): Checkpoints;
 
@@ -259,6 +271,7 @@ export interface Checkpoints {
    * // -> 'sale'
    * ```
    * @category Setter
+   * @since v1.0.0
    */
   addCheckpoint(label?: string): Id;
 
@@ -315,6 +328,7 @@ export interface Checkpoints {
    * // -> undefined
    * ```
    * @category Setter
+   * @since v1.0.0
    */
   setCheckpoint(checkpointId: Id, label: string): Checkpoints;
 
@@ -337,6 +351,7 @@ export interface Checkpoints {
    * // -> [['0'], '1', []]
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   getStore(): Store;
 
@@ -378,6 +393,7 @@ export interface Checkpoints {
    * // -> [['0'], '1', []]
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   getCheckpointIds(): CheckpointIds;
 
@@ -409,6 +425,7 @@ export interface Checkpoints {
    * // -> '1:sale'
    * ```
    * @category Iterator
+   * @since v1.0.0
    */
   forEachCheckpoint(checkpointCallback: CheckpointCallback): void;
 
@@ -432,6 +449,7 @@ export interface Checkpoints {
    * // -> false
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   hasCheckpoint(checkpointId: Id): boolean;
 
@@ -486,6 +504,7 @@ export interface Checkpoints {
    * // -> undefined
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   getCheckpoint(checkpointId: Id): string | undefined;
 
@@ -536,6 +555,7 @@ export interface Checkpoints {
    * checkpoints.delListener(listenerId);
    * ```
    * @category Listener
+   * @since v1.0.0
    */
   addCheckpointIdsListener(listener: CheckpointIdsListener): Id;
 
@@ -596,6 +616,7 @@ export interface Checkpoints {
    * checkpoints.delListener(listenerId);
    * ```
    * @category Listener
+   * @since v1.0.0
    */
   addCheckpointListener(
     checkpointId: IdOrNull,
@@ -640,6 +661,7 @@ export interface Checkpoints {
    * // The listener is not called.
    * ```
    * @category Listener
+   * @since v1.0.0
    */
   delListener(listenerId: Id): Checkpoints;
 
@@ -674,6 +696,7 @@ export interface Checkpoints {
    * // -> [[], '0', ['1']]
    * ```
    * @category Movement
+   * @since v1.0.0
    */
   goBackward(): Checkpoints;
 
@@ -757,6 +780,7 @@ export interface Checkpoints {
    * // The original change cannot be redone.
    * ```
    * @category Movement
+   * @since v1.0.0
    */
   goForward(): Checkpoints;
 
@@ -808,6 +832,7 @@ export interface Checkpoints {
    * // -> [['0'], '1', ['2']]
    * ```
    * @category Movement
+   * @since v1.0.0
    */
   goTo(checkpointId: Id): Checkpoints;
 
@@ -867,6 +892,7 @@ export interface Checkpoints {
    * checkpoints.delListener(listenerId);
    * ```
    * @category Lifecycle
+   * @since v1.0.0
    */
   clear(): Checkpoints;
 
@@ -954,6 +980,7 @@ export interface Checkpoints {
    * // -> 0
    * ```
    * @category Lifecycle
+   * @since v1.0.0
    */
   destroy(): void;
 
@@ -988,6 +1015,7 @@ export interface Checkpoints {
    * // -> {checkpointIds: 1, checkpoint: 1}
    * ```
    * @category Development
+   * @since v1.0.0
    */
   getListenerStats(): CheckpointsListenerStats;
   //
@@ -1027,5 +1055,6 @@ export interface Checkpoints {
  * // -> true
  * ```
  * @category Creation
+ * @since v1.0.0
  */
 export function createCheckpoints(store: Store): Checkpoints;

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

@@ -8,6 +8,7 @@
  * of checkpoints change.
  * @packageDocumentation
  * @module checkpoints
+ * @since v1.0.0
  */
 
 import type {Id, IdOrNull, Ids} from '../common/index.d.ts';
@@ -28,6 +29,7 @@ import type {Store} from '../store/index.d.ts';
  *   the checkpoints in the redo stack for this Store). They are in
  *   chronological order with the newest checkpoint at the end of the array.
  * @category Identity
+ * @since v1.0.0
  */
 export type CheckpointIds = [Ids, Id | undefined, Ids];
 
@@ -41,6 +43,7 @@ export type CheckpointIds = [Ids, Id | undefined, Ids];
  * @param checkpointId The Id of the Checkpoint that the callback can operate
  * on.
  * @category Callback
+ * @since v1.0.0
  */
 export type CheckpointCallback = (checkpointId: Id, label?: string) => void;
 
@@ -55,6 +58,7 @@ export type CheckpointCallback = (checkpointId: Id, label?: string) => void;
  * object.
  * @param checkpoints A reference to the Checkpoints object that changed.
  * @category Listener
+ * @since v1.0.0
  */
 export type CheckpointIdsListener = (checkpoints: Checkpoints) => void;
 
@@ -70,6 +74,7 @@ export type CheckpointIdsListener = (checkpoints: Checkpoints) => void;
  * @param checkpoints A reference to the Checkpoints object that changed.
  * @param checkpointId The Id of the checkpoint that changed.
  * @category Listener
+ * @since v1.0.0
  */
 export type CheckpointListener = (
   checkpoints: Checkpoints,
@@ -84,16 +89,21 @@ export type CheckpointListener = (
  * A CheckpointsListenerStats object is returned from the getListenerStats
  * method.
  * @category Development
+ * @since v1.0.0
  */
 export type CheckpointsListenerStats = {
   /**
    * The number of CheckpointIdsListener functions registered with the
    * Checkpoints object.
+   * @category Stat
+   * @since v1.0.0
    */
   checkpointIds: number;
   /**
    * The number of CheckpointListener functions registered with the Checkpoints
    * object.
+   * @category Stat
+   * @since v1.0.0
    */
   checkpoint: number;
 };
@@ -164,10 +174,11 @@ export type CheckpointsListenerStats = {
  *
  * checkpoints.delListener(listenerId);
  * ```
- * @see Relationships And Checkpoints guides
+ * @see Using Checkpoints guide
  * @see Todo App demos
  * @see Drawing demo
  * @category Checkpoints
+ * @since v1.0.0
  */
 export interface Checkpoints {
   //
@@ -213,6 +224,7 @@ export interface Checkpoints {
    * // -> [['1', '2'], '3', []]
    * ```
    * @category Configuration
+   * @since v1.0.0
    */
   setSize(size: number): Checkpoints;
 
@@ -259,6 +271,7 @@ export interface Checkpoints {
    * // -> 'sale'
    * ```
    * @category Setter
+   * @since v1.0.0
    */
   addCheckpoint(label?: string): Id;
 
@@ -315,6 +328,7 @@ export interface Checkpoints {
    * // -> undefined
    * ```
    * @category Setter
+   * @since v1.0.0
    */
   setCheckpoint(checkpointId: Id, label: string): Checkpoints;
 
@@ -337,6 +351,7 @@ export interface Checkpoints {
    * // -> [['0'], '1', []]
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   getStore(): Store;
 
@@ -378,6 +393,7 @@ export interface Checkpoints {
    * // -> [['0'], '1', []]
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   getCheckpointIds(): CheckpointIds;
 
@@ -409,6 +425,7 @@ export interface Checkpoints {
    * // -> '1:sale'
    * ```
    * @category Iterator
+   * @since v1.0.0
    */
   forEachCheckpoint(checkpointCallback: CheckpointCallback): void;
 
@@ -432,6 +449,7 @@ export interface Checkpoints {
    * // -> false
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   hasCheckpoint(checkpointId: Id): boolean;
 
@@ -486,6 +504,7 @@ export interface Checkpoints {
    * // -> undefined
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   getCheckpoint(checkpointId: Id): string | undefined;
 
@@ -536,6 +555,7 @@ export interface Checkpoints {
    * checkpoints.delListener(listenerId);
    * ```
    * @category Listener
+   * @since v1.0.0
    */
   addCheckpointIdsListener(listener: CheckpointIdsListener): Id;
 
@@ -596,6 +616,7 @@ export interface Checkpoints {
    * checkpoints.delListener(listenerId);
    * ```
    * @category Listener
+   * @since v1.0.0
    */
   addCheckpointListener(
     checkpointId: IdOrNull,
@@ -640,6 +661,7 @@ export interface Checkpoints {
    * // The listener is not called.
    * ```
    * @category Listener
+   * @since v1.0.0
    */
   delListener(listenerId: Id): Checkpoints;
 
@@ -674,6 +696,7 @@ export interface Checkpoints {
    * // -> [[], '0', ['1']]
    * ```
    * @category Movement
+   * @since v1.0.0
    */
   goBackward(): Checkpoints;
 
@@ -757,6 +780,7 @@ export interface Checkpoints {
    * // The original change cannot be redone.
    * ```
    * @category Movement
+   * @since v1.0.0
    */
   goForward(): Checkpoints;
 
@@ -808,6 +832,7 @@ export interface Checkpoints {
    * // -> [['0'], '1', ['2']]
    * ```
    * @category Movement
+   * @since v1.0.0
    */
   goTo(checkpointId: Id): Checkpoints;
 
@@ -867,6 +892,7 @@ export interface Checkpoints {
    * checkpoints.delListener(listenerId);
    * ```
    * @category Lifecycle
+   * @since v1.0.0
    */
   clear(): Checkpoints;
 
@@ -954,6 +980,7 @@ export interface Checkpoints {
    * // -> 0
    * ```
    * @category Lifecycle
+   * @since v1.0.0
    */
   destroy(): void;
 
@@ -988,6 +1015,7 @@ export interface Checkpoints {
    * // -> {checkpointIds: 1, checkpoint: 1}
    * ```
    * @category Development
+   * @since v1.0.0
    */
   getListenerStats(): CheckpointsListenerStats;
   //
@@ -1027,5 +1055,6 @@ export interface Checkpoints {
  * // -> true
  * ```
  * @category Creation
+ * @since v1.0.0
  */
 export function createCheckpoints(store: Store): Checkpoints;

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

@@ -8,6 +8,7 @@
  * of checkpoints change.
  * @packageDocumentation
  * @module checkpoints
+ * @since v1.0.0
  */
 
 import type {Id, IdOrNull, Ids} from '../../common/with-schemas/index.d.cts';
@@ -28,6 +29,7 @@ import type {OptionalSchemas, Store} from '../../store/with-schemas/index.d.cts'
  *   the checkpoints in the redo stack for this Store). They are in
  *   chronological order with the newest checkpoint at the end of the array.
  * @category Identity
+ * @since v1.0.0
  */
 export type CheckpointIds = [Ids, Id | undefined, Ids];
 
@@ -41,6 +43,7 @@ export type CheckpointIds = [Ids, Id | undefined, Ids];
  * @param checkpointId The Id of the Checkpoint that the callback can operate
  * on.
  * @category Callback
+ * @since v1.0.0
  */
 export type CheckpointCallback = (checkpointId: Id, label?: string) => void;
 
@@ -61,6 +64,7 @@ export type CheckpointCallback = (checkpointId: Id, label?: string) => void;
  * object.
  * @param checkpoints A reference to the Checkpoints object that changed.
  * @category Listener
+ * @since v1.0.0
  */
 export type CheckpointIdsListener<Schemas extends OptionalSchemas> = (
   checkpoints: Checkpoints<Schemas>,
@@ -87,6 +91,7 @@ export type CheckpointIdsListener<Schemas extends OptionalSchemas> = (
  * @param checkpoints A reference to the Checkpoints object that changed.
  * @param checkpointId The Id of the checkpoint that changed.
  * @category Listener
+ * @since v1.0.0
  */
 export type CheckpointListener<Schemas extends OptionalSchemas> = (
   checkpoints: Checkpoints<Schemas>,
@@ -101,16 +106,21 @@ export type CheckpointListener<Schemas extends OptionalSchemas> = (
  * A CheckpointsListenerStats object is returned from the getListenerStats
  * method.
  * @category Development
+ * @since v1.0.0
  */
 export type CheckpointsListenerStats = {
   /**
    * The number of CheckpointIdsListener functions registered with the
    * Checkpoints object.
+   * @category Stat
+   * @since v1.0.0
    */
   checkpointIds: number;
   /**
    * The number of CheckpointListener functions registered with the Checkpoints
    * object.
+   * @category Stat
+   * @since v1.0.0
    */
   checkpoint: number;
 };
@@ -181,10 +191,11 @@ export type CheckpointsListenerStats = {
  *
  * checkpoints.delListener(listenerId);
  * ```
- * @see Relationships And Checkpoints guides
+ * @see Using Checkpoints guide
  * @see Todo App demos
  * @see Drawing demo
  * @category Checkpoints
+ * @since v1.0.0
  */
 export interface Checkpoints<in out Schemas extends OptionalSchemas> {
   /**
@@ -235,6 +246,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> [['1', '2'], '3', []]
    * ```
    * @category Configuration
+   * @since v1.0.0
    */
   setSize(size: number): Checkpoints<Schemas>;
 
@@ -281,6 +293,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> 'sale'
    * ```
    * @category Setter
+   * @since v1.0.0
    */
   addCheckpoint(label?: string): Id;
 
@@ -343,6 +356,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> undefined
    * ```
    * @category Setter
+   * @since v1.0.0
    */
   setCheckpoint(checkpointId: Id, label: string): Checkpoints<Schemas>;
 
@@ -371,6 +385,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> [['0'], '1', []]
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   getStore(): Store<Schemas>;
 
@@ -412,6 +427,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> [['0'], '1', []]
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   getCheckpointIds(): CheckpointIds;
 
@@ -443,6 +459,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> '1:sale'
    * ```
    * @category Iterator
+   * @since v1.0.0
    */
   forEachCheckpoint(checkpointCallback: CheckpointCallback): void;
 
@@ -466,6 +483,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> false
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   hasCheckpoint(checkpointId: Id): boolean;
 
@@ -520,6 +538,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> undefined
    * ```
    * @category Getter
+   * @since v1.0.0
    */
   getCheckpoint(checkpointId: Id): string | undefined;
 
@@ -576,6 +595,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * checkpoints.delListener(listenerId);
    * ```
    * @category Listener
+   * @since v1.0.0
    */
   addCheckpointIdsListener(listener: CheckpointIdsListener<Schemas>): Id;
 
@@ -645,6 +665,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * checkpoints.delListener(listenerId);
    * ```
    * @category Listener
+   * @since v1.0.0
    */
   addCheckpointListener(
     checkpointId: IdOrNull,
@@ -695,6 +716,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // The listener is not called.
    * ```
    * @category Listener
+   * @since v1.0.0
    */
   delListener(listenerId: Id): Checkpoints<Schemas>;
 
@@ -735,6 +757,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> [[], '0', ['1']]
    * ```
    * @category Movement
+   * @since v1.0.0
    */
   goBackward(): Checkpoints<Schemas>;
 
@@ -824,6 +847,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // The original change cannot be redone.
    * ```
    * @category Movement
+   * @since v1.0.0
    */
   goForward(): Checkpoints<Schemas>;
 
@@ -881,6 +905,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> [['0'], '1', ['2']]
    * ```
    * @category Movement
+   * @since v1.0.0
    */
   goTo(checkpointId: Id): Checkpoints<Schemas>;
 
@@ -946,6 +971,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * checkpoints.delListener(listenerId);
    * ```
    * @category Lifecycle
+   * @since v1.0.0
    */
   clear(): Checkpoints<Schemas>;
 
@@ -1039,6 +1065,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> 0
    * ```
    * @category Lifecycle
+   * @since v1.0.0
    */
   destroy(): void;
 
@@ -1073,6 +1100,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
    * // -> {checkpointIds: 1, checkpoint: 1}
    * ```
    * @category Development
+   * @since v1.0.0
    */
   getListenerStats(): CheckpointsListenerStats;
 }
@@ -1117,6 +1145,7 @@ export interface Checkpoints<in out Schemas extends OptionalSchemas> {
  * // -> true
  * ```
  * @category Creation
+ * @since v1.0.0
  */
 export function createCheckpoints<Schemas extends OptionalSchemas>(
   store: Store<Schemas>,