@antha/engine 0.5.0 → 0.6.1

package/dist/antha-engine.d.ts

@@ -9,6 +9,10 @@ import { type AnthaLogger } from './logger/antha-logger.js';
  * @category Internal
  */
 export type ModInstanceId = Branded<string, 'antha-mod-instance-id'>;
+/** A timestamp measured from the start of an {@link AnthaEngine}. */
+export type EngineTime = Branded<number, 'antha-engine-time'>;
+/** Creates an {@link EngineTime} from a millisecond offset from an engine's start. */
+export declare function createEngineTime(time: number): EngineTime;
 /**
  * Parameters passed to the execute callback in {@link AnthaMod}.
  *
@@ -275,7 +279,7 @@ export declare class AnthaEngine<State extends AnyObject = AnyObject> {
      */
     readonly state: Partial<State>;
     /** Total milliseconds elapsed since the engine started. Updated each tick. */
-    totalMs: DOMHighResTimeStamp;
+    totalMs: EngineTime;
     /** When the engine started running its loop. */
     engineStartTime: DOMHighResTimeStamp;
     /**

package/dist/antha-engine.js

@@ -5,6 +5,10 @@ import { css, html } from 'element-vir';
 import { Observable } from 'observavir';
 import { AnthaUi } from './antha-ui.element.js';
 import { browserAnthaLogger } from './logger/browser-antha-logger.js';
+/** Creates an {@link EngineTime} from a millisecond offset from an engine's start. */
+export function createEngineTime(time) {
+    return applyBrand(time);
+}
 /**
  * Return this from a mod's `execute` callback to instruct {@link AnthaEngine} that the mod's current
  * execution should not count toward the mod's frequency schedule. This is useful when a mod needs a
@@ -138,7 +142,7 @@ export class AnthaEngine {
      */
     state;
     /** Total milliseconds elapsed since the engine started. Updated each tick. */
-    totalMs = 0;
+    totalMs = createEngineTime(0);
     /** When the engine started running its loop. */
     engineStartTime = performance.now();
     /**
@@ -220,7 +224,7 @@ export class AnthaEngine {
         /** Clear the array as we're about to populate it. */
         this.currentTemplateArray.length = 0;
         const executionStart = performance.now();
-        this.totalMs = executionStart - this.engineStartTime;
+        this.totalMs = createEngineTime(executionStart - this.engineStartTime);
         /**
          * Use a plain `for` loop instead of `awaitedForEach` so that synchronous mods execute
          * without microtask boundaries between them. Only yield when a mod actually returns a

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@antha/engine",
-    "version": "0.5.0",
+    "version": "0.6.1",
     "description": "The Antha game engine (for the web).",
     "keywords": [
         "vir",