From f54fe7b559efe6c4c1bb2d04764812f059546cf6 Mon Sep 17 00:00:00 2001 From: Apsides Labs Date: Fri, 6 Nov 2026 18:10:36 +0530 Subject: [PATCH 1/3] docs: list reference/ and document the two worked examples --- README.md | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/README.md b/README.md index bc5582a..b51069c 100644 --- a/README.md +++ b/README.md @@ -162,12 +162,25 @@ integrated loudness -14.2 LUFS · true peak -1.6 dBTP `make test` builds a three-line film end to end in about two minutes and asserts fourteen things about the result. See [`docs/qa.md`](docs/qa.md). +## Two worked examples + +| Folder | Engine | Timing source | Film | +|---|---|---|---| +| `films/everest` | three.js | Piper line alignments | The Mountain Nobody Saw, 36.6 s | +| `films/kuch-bhi-kaise-bechein` | three.js | Piper line alignments | the Hindi shop explainer, 85 s | +| `reference/` | Babylon.js | edge-tts word boundaries | Slow as Molasses, 56.6 s | + +`reference/` sits outside `kit/` on purpose. It is the same script-to-frames contract +with a second renderer and a second timing source — word-level rather than line-level — +and it has its own build steps in [`reference/README.md`](reference/README.md). + ## Layout ``` kit/ voice, music, mix, render, encode, qa, doctor, build, make kit/lib/ three.js, loaders, scene-kit, OutlineEffect, Devanagari font, rigged avatar films/ one directory per film: film.json and scene.js (built on scene-kit) +reference/ a second worked example: Babylon.js, word-level timing templates/ starter film.json, scene.js and index.html docs/ format reference, scene-kit, styles, safe areas, speed, portability, qa assets/ logo and banner From 83ca766923f608838b91ca1fcf37b854cce6b56d Mon Sep 17 00:00:00 2001 From: Apsides Labs Date: Fri, 6 Nov 2026 18:10:39 +0530 Subject: [PATCH 2/3] chore: ignore reference build output (frames, voice, audio) --- .gitignore | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/.gitignore b/.gitignore index fedcd20..acea6e0 100644 --- a/.gitignore +++ b/.gitignore @@ -8,3 +8,8 @@ __pycache__/ *.pyc .DS_Store .cache/ +frames/ +voice/ +reference/frames/ +reference/voice/ +reference/audio/ From 55b22603d33a6c54542add9e5c07180035d9ee15 Mon Sep 17 00:00:00 2001 From: Apsides Labs Date: Fri, 6 Nov 2026 18:10:41 +0530 Subject: [PATCH 3/3] ci: also compile and parse reference/src --- .github/workflows/ci.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index 6871fd7..db30607 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -14,13 +14,13 @@ jobs: - uses: actions/setup-node@v4 with: { node-version: "20" } - name: Python syntax - run: python -m py_compile kit/*.py + run: python -m py_compile kit/*.py reference/src/*.py - name: JavaScript syntax run: | node --check kit/render.js # scene files are ES modules; parse them as .mjs so --check does not # treat `import` as a CommonJS syntax error - for f in $(ls kit/lib/*.js films/*/scene.js templates/scene.js 2>/dev/null); do + for f in $(ls kit/lib/*.js films/*/scene.js templates/scene.js reference/src/scene.js 2>/dev/null); do cp "$f" /tmp/check.mjs node --check /tmp/check.mjs echo "ok $f"