docs(core): update docstrings (time provider)

Author: postspectacular

packages/core/src/api.ts

@@ -39,6 +39,12 @@ export type Maybe<T> = T | undefined;
  * function returns false, the animation loop will be stopped (via
  * {@link GenArtAPI.stop}), otherwise the loop continues until stopped
  * explicitly.
+ *
+ * @remarks
+ * Arguments are information sourced from {@link TimeProvider.now}.
+ *
+ * @param time
+ * @param frame
  */
 export type UpdateFn = (time: number, frame: number) => boolean;
 

packages/core/src/api/time.ts

@@ -17,8 +17,13 @@ export interface TimeProvider {
 	 */
 	next(fn: (time: number, frame: number) => void): void;
 	/**
-	 * Returns tuple of current `[time, frame]` (where `time` is in
-	 * milliseconds and `frame` the current frame number)
+	 * Returns tuple of current `[time, frame]` (where `time` is the current
+	 * frame's number of milliseconds since start and `frame` the current frame
+	 * number).
+	 *
+	 * @remarks
+	 * Function is idempotent when called during a single frame update. Can also
+	 * be called via `$genart.timeProvider.now()`.
 	 */
 	now(): [number, number];
 }