retiam 2.0.1 → 2.0.3

package/dist/src/engine/animation/Animation.d.ts

@@ -120,6 +120,7 @@ export declare abstract class Animation {
      * @returns `true` when the animation completed during this step.
      */
     step(dt: number): boolean;
+    private _advanceTimelineStep;
     /**
      * Resets the interval accumulator timer.
      */

package/dist/src/engine/entities/composites/text/mathjaxInterop.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Vite reloads can leave MathML factories from a different MathJax module copy.
+ * MathJax's constructor-only check then passes a MathML node to the TeX stack as
+ * a stack item; its isKind('stop') throws because MathML has no 'stop' class.
+ */
+export declare function ensureMathJaxNodeCompatibility(): void;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "retiam",
-  "version": "2.0.1",
+  "version": "2.0.3",
   "description": "WebGPU powered animation engine",
   "type": "module",
   "main": "./dist/retiam.es.js",
@@ -16,6 +16,10 @@
       "types": "./bin/third-party.d.ts",
       "import": "./bin/third-party.js"
     },
+    "./explainer/plan": {
+      "types": "./dist/libs/explainer/plan.d.ts",
+      "import": "./dist/libs/explainer/plan.js"
+    },
     "./*": {
       "types": "./dist/libs/*/index.d.ts",
       "import": "./dist/libs/*/index.js"
@@ -31,6 +35,7 @@
     "dist/libs/**/*.d.ts",
     "dist/src/**/*.d.ts",
     "bin",
+    "agent",
     "LICENSE",
     "COMMERCIAL_LICENSE.md",
     "THIRD_PARTY_NOTICES.md",
@@ -42,9 +47,8 @@
   ],
   "scripts": {
     "dev": "vite",
-    "prebuild": "node tools/prepare-release.mjs",
-    "build": "npm run licenses:check && tsc && vite build",
-    "prepack": "npm run build",
+    "build": "tsc && vite build",
+    "prepack": "node tools/prepare-release.mjs && npm run build",
     "build:watch": "vite build --watch",
     "export": "node ./bin/cli.js export",
     "render": "node ./bin/cli.js render",
@@ -56,13 +60,16 @@
     "start": "npm run dev",
     "resolve": "npm i",
     "test": "node --experimental-vm-modules node_modules/jest/bin/jest.js",
-    "test:distribution": "node --import tsx --test test/library_portability_test.ts test/package_contents_test.mjs test/render_config_test.mjs",
+    "test:distribution": "node --import tsx --test test/library_portability_test.ts test/package_contents_test.mjs test/render_config_test.mjs test/cdn_build_test.ts test/mathjax_interop_test.ts",
     "test:create": "node --test test/create_retiam_test.mjs",
+    "test:agent": "node --test test/agent_workflow_test.mjs test/snapshot_test.mjs test/tts_project_test.mjs",
+    "test:tts": "node --test test/elevenlabs_tts_test.mjs",
+    "test:tex": "node --import tsx --test test/mathjax_interop_test.ts",
+    "test:explainer": "node --import tsx --test test/explainer_plan_test.ts && node --test test/explainer_project_test.mjs",
     "test:shading": "npm run build && node --test test/shading_test.mjs test/shading_browser.test.mjs",
     "test:studio-layout": "node --test test/studio_layout.test.mjs",
     "licenses:generate": "node tools/generate-third-party-notices.mjs",
-    "licenses:check": "node tools/generate-third-party-notices.mjs --check",
-    "test:licenses": "node --test test/third_party_notices_test.mjs test/release_metadata_test.mjs",
+    "test:licenses": "node --test test/third_party_notices_test.mjs",
     "unit-test": "ts-node-esm test/test.ts",
     "gen-context": "ts-node tools/context_gen/context_generator.ts ./src",
     "gen-index": "node ./tools/index_generator/generate-index.cjs"
@@ -121,4 +128,4 @@
     "woff2-encoder": "^2.0.0",
     "ws": "^8.16.0"
   }
-}
+}

package/readme.md

@@ -5,23 +5,24 @@ Retiam is a TypeScript animation engine built on WebGPU. Write scenes for mathem
 **[Documentation](https://abhilasbiswas.github.io/retiam-docs/)** · [Getting started](https://abhilasbiswas.github.io/retiam-docs/getting-started/) · [Examples](https://abhilasbiswas.github.io/retiam-docs/examples-catalog/) · [API reference](https://abhilasbiswas.github.io/retiam-docs/api-core/)
 
 Retiam is **free for noncommercial use** under the [Retiam Noncommercial
-License](https://unpkg.com/retiam@2.0.1/LICENSE). Commercial development,
+License](https://unpkg.com/retiam/LICENSE). Commercial development,
 internal business use, paid client work, and products, services or content that earn revenue directly or
 indirectly require a separate paid written commercial license before use.
 This includes advertising, sponsorships, subscriptions, and monetized videos
 or courses, even when Retiam is only one part of a larger project.
 Contact [abhilasbiswas@gmail.com](mailto:abhilasbiswas@gmail.com) for
-[commercial licensing](https://unpkg.com/retiam@2.0.1/COMMERCIAL_LICENSE.md).
+[commercial licensing](https://unpkg.com/retiam/COMMERCIAL_LICENSE.md).
 
 The full terms are included in the npm package. After installation, read
 `node_modules/retiam/LICENSE` and `node_modules/retiam/COMMERCIAL_LICENSE.md`.
-The public links above show the terms for this release without requiring
-access to the private engine repository.
+The public links show the latest published terms without requiring access to
+the private engine repository. The installed files contain the terms supplied
+with your installed version.
 
 Your independently authored code and original outputs remain your own.
 Earlier ISC permissions and third-party licenses remain unaffected. Keep the
-[third-party notices](https://unpkg.com/retiam@2.0.1/THIRD_PARTY_NOTICES.md) and
-[license texts](https://unpkg.com/retiam@2.0.1/THIRD_PARTY_LICENSES.txt) with
+[third-party notices](https://unpkg.com/retiam/THIRD_PARTY_NOTICES.md) and
+[license texts](https://unpkg.com/retiam/THIRD_PARTY_LICENSES.txt) with
 redistributed Retiam code. These files are also installed in
 `node_modules/retiam/`. Source maintainers can find provenance review limits
 and notice-generation commands in `docs/LICENSING.md` in the engine checkout.
@@ -431,12 +432,31 @@ Import shared scene primitives from `retiam` and specialized functionality from
 | `retiam/highlights` | Emphasis and attention animations |
 | `retiam/physics` | 2D and 3D physics integrations |
 | `retiam/rough` | RoughJS styling integration |
-| `retiam/tts` | Microsoft Edge speech synthesis, narration, and subtitles |
+| `retiam/tts` | Edge and ElevenLabs speech synthesis, expressive narration, and subtitles |
+| `retiam/tts/node` | Speech preparation in Node without the WebGPU renderer |
 
 See the [library guide](https://abhilasbiswas.github.io/retiam-docs/libraries/) for import boundaries and examples. `roughjs` is a required production dependency and is installed automatically.
 
 Built-in fonts and imported engine assets are included in the library package. Application media is managed separately. Edge speech synthesis in the browser requires a compatible service. See [asset workflows](https://abhilasbiswas.github.io/retiam-docs/asset-workflows/) and [speech and subtitles](https://abhilasbiswas.github.io/retiam-docs/speech-subtitles/) for setup.
 
+Initialize ElevenLabs directly on its provider; no ElevenLabs Vite plugin is needed:
+
+```ts
+import { ElevenLabsTTSProvider, TTS } from 'retiam/tts';
+
+const provider = new ElevenLabsTTSProvider();
+await provider.init({ apiKey, voiceId, modelId: 'eleven_v3' });
+TTS.setProvider(provider);
+const audio = await TTS.synthesize('[curious] What changes if we move this point?', {
+  displayText: 'What changes if we move this point?',
+});
+```
+
+Supply credentials from the caller; browser-supplied keys are visible in that browser.
+Node preparation scripts can use `retiam/tts/node` with the same provider API and
+save `audio.rawBuffer` as MP3. The [narration guide](agent/skill/references/tts.md)
+covers expressive delivery, caching, subtitles, and lesson preparation.
+
 MSDF font generation runs in a browser worker using the WASM supplied by
 `@zappar/msdf-generator`, a production dependency. The repository's font-baking
 tools, including `msdf-bmfont-xml` and `msdf-atlas-gen`, remain development tools.