textmode.js 0.9.0-beta.1 → 0.9.0-beta.2

package/dist/types/textmode/AnimationController.d.ts

@@ -74,12 +74,24 @@ export declare class AnimationController {
      * Get the number of milliseconds since the animation started.
      * Returns 0 if the animation has not started yet.
      */
-    $millis(): number;
+    get $millis(): number;
+    /**
+     * Set the elapsed milliseconds by adjusting the start time.
+     * This allows seeking/scrubbing in animations.
+     * @param value The new elapsed time in milliseconds
+     */
+    set $millis(value: number);
     /**
      * Get the number of seconds since the animation started.
      * Returns 0 if the animation has not started yet.
      */
-    $secs(): number;
+    get $secs(): number;
+    /**
+     * Set the elapsed seconds by adjusting the start time.
+     * This allows seeking/scrubbing in animations.
+     * @param value The new elapsed time in seconds
+     */
+    set $secs(value: number);
     /**
      * Get the time in milliseconds between the current frame and the last frame.
      * Useful for frame-rate-independent animations.

package/dist/types/textmode/Textmodifier.d.ts

@@ -96,6 +96,7 @@ export declare class Textmodifier extends Textmodifier_base implements ITextmodi
     get layers(): LayerManager;
     get filters(): TextmodeFilterManager;
     get conversions(): TextmodeConversionManager;
+    get isRenderingFrame(): boolean;
 }
 export interface Textmodifier extends IRenderingMixin, IAnimationMixin, IMouseMixin, ITouchMixin, IKeyboardMixin {
 }

package/dist/types/textmode/mixins/interfaces/IAnimationMixin.d.ts

@@ -24,14 +24,16 @@ export interface IAnimationMixin {
      */
     frameRate(fps?: number): number | void;
     /**
-     * Returns the number of milliseconds since the sketch started running.
+     * Get the number of milliseconds since the sketch started running.
      *
-     * `millis()` keeps track of how long a sketch has been running in milliseconds
+     * `millis` keeps track of how long a sketch has been running in milliseconds
      * (thousandths of a second). This information is often helpful for timing events
      * and animations.
      *
      * Time tracking begins before the code in {@link setup} runs. If loading screen is
-     * enabled, `millis()` begins tracking as soon as the loading screen starts.
+     * enabled, `millis` begins tracking as soon as the loading screen starts.
+     *
+     * This property is connected to {@link secs} - setting one will affect the other.
      *
      * @returns Number of milliseconds since starting the sketch.
      *
@@ -43,7 +45,7 @@ export interface IAnimationMixin {
      *   t.background(0);
      *
      *   // Get the number of seconds the sketch has run
-     *   const seconds = t.millis() / 1000;
+     *   const seconds = t.millis / 1000;
      *
      *   t.text(`Running time: ${seconds.toFixed(1)} sec`, 10, 10);
      * });
@@ -56,23 +58,42 @@ export interface IAnimationMixin {
      * t.draw(() => {
      *   t.background(0);
      *
-     *   // Use millis() for smooth animation
-     *   const time = t.millis() / 1000;
+     *   // Use millis for smooth animation
+     *   const time = t.millis / 1000;
      *   const x = Math.sin(time) * 20 + 40;
      *
      *   t.char('O', Math.floor(x), 10);
      * });
      * ```
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({ width: 800, height: 600 });
+     *
+     * // Seek to a specific time in the animation
+     * t.millis = 5000; // Jump to 5 seconds
+     * ```
+     */
+    get millis(): number;
+    /**
+     * Set the elapsed milliseconds by adjusting the internal start time.
+     *
+     * This allows seeking/scrubbing in animations. Setting `millis` will also
+     * affect the value returned by {@link secs} since they are connected.
+     *
+     * @param value The new elapsed time in milliseconds
      */
-    millis(): number;
+    set millis(value: number);
     /**
-     * Returns the number of seconds since the sketch started running.
+     * Get the number of seconds since the sketch started running.
      *
-     * `secs()` is a convenience method that returns the elapsed time in seconds
-     * instead of milliseconds. Equivalent to `millis() / 1000`.
+     * `secs` is a convenience property that returns the elapsed time in seconds
+     * instead of milliseconds. Equivalent to `millis / 1000`.
      *
      * Time tracking begins before the code in {@link setup} runs. If loading screen is
-     * enabled, `secs()` begins tracking as soon as the loading screen starts.
+     * enabled, `secs` begins tracking as soon as the loading screen starts.
+     *
+     * This property is connected to {@link millis} - setting one will affect the other.
      *
      * @returns Number of seconds since starting the sketch.
      *
@@ -83,15 +104,32 @@ export interface IAnimationMixin {
      * t.draw(() => {
      *   t.background(0);
      *
-     *   // Use secs() for smooth time-based animations
-     *   const angle = t.secs() * Math.PI;
+     *   // Use secs for smooth time-based animations
+     *   const angle = t.secs * Math.PI;
      *   const x = Math.sin(angle) * 10;
      *
      *   t.text(`X: ${x.toFixed(2)}`, 10, 10);
      * });
      * ```
+     *
+     * @example
+     * ```javascript
+     * const t = textmode.create({ width: 800, height: 600 });
+     *
+     * // Seek to a specific time in the animation
+     * t.secs = 10; // Jump to 10 seconds (equivalent to t.millis = 10000)
+     * ```
+     */
+    get secs(): number;
+    /**
+     * Set the elapsed seconds by adjusting the internal start time.
+     *
+     * This allows seeking/scrubbing in animations. Setting `secs` will also
+     * affect the value returned by {@link millis} since they are connected.
+     *
+     * @param value The new elapsed time in seconds
      */
-    secs(): number;
+    set secs(value: number);
     /**
      * Returns the time in milliseconds between the current frame and the previous frame.
      *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "textmode.js",
-  "version": "0.9.0-beta.1",
+  "version": "0.9.0-beta.2",
   "description": "textmode.js is a lightweight creative coding library for creating real-time ASCII art on the web.",
   "type": "module",
   "types": "./dist/types/index.d.ts",