An AI skill that turns books into animated, narrated, interactive web experiences
JavaScript ai-agentsai-educationanimationclaudeclaude-codeclaude-skillsedtecheducationinteractive-textbookscormtext-to-video
Merge main into feat/latex: engine moved to engine/, MathJax opt-in per book
yzrc4335f479e76
diff --cc .claude/skills/papermorph/references/engine.mdindex d2eb830,44e9fc2..8fc80cc--- a/.claude/skills/papermorph/references/engine.md+++ b/.claude/skills/papermorph/references/engine.md@@@ -32,15 -33,6 +34,15 @@@ Many drawing helpers are mathematical bTopic helpers already in the engine: number lines (`numberLine`, `X(v)`, `Y0`, `tick`, `dot`, `move`, `landDot`, `brace`, `AXIS`), signed tiles (`tile`, `tiles`, `cancelPairs`), algebra tiles (`atile`, `tileRow`, `cancel`, `popIn`, sizes in `TS`), fraction rows (`fracRow`, `reduce`), a decimal point that hops (`pointRow`), a balance (`balance`), inequality graphs (`ray`, `segment`), a coordinate plane (`plane`: `PX/PY`, `dot`, `walk`, `line`, `arrow`, `stair`, `region`, `half`, `fn` for y = f(x); set `P.layer = panel(0)` so marks clear with the beat), scaled axes (`axes`), dot plots (`dataLine`), chance objects (`die`, `coin`, `spinner`, `outline`), area grids (`areaGrid` with `.cell`, `.ring`; `arc`), rectangles (`rect`, `bracketH`), vertical scales (`vAxis`, `thermometer`), the number-set diagram (`RINGS`, `buildVenn`, `regionAt`). Read the function in engine.js before first use.+## LaTeX+- A book whose formulas need more than `M()` parts (indices, sums, matrices, accents) uses the vendored MathJax: copy it when starting the book ([site.md](site.md#start-a-book-folder)) and load `<script src="../lib/mathjax.js"></script>` right after `engine.js` in every chapter.++A book whose formulas need more than `M()` parts (indices, sums, matrices, accents) uses the engine's vendored MathJax: add it with `engine.py <book> --latex` ([site.md](site.md#start-a-book-folder)) and load `<script src="../lib/mathjax.js"></script>` right after `engine.js` in every chapter.++- `TX('\\frac{a}{b}')` is a part like `F()`: it works in `M`, `tokens`, `chip`, `eqLine` (also as `sym`), `mathEl`, `blanks` and `grid`; `$tex(tex)` puts one in HTML text. 1 em is `size`; the baseline is at `y`.+- Formulas are set in text style, like `$…$`; write `\displaystyle` for large sums and fractions. Words go in `\text{…}` and use the book's math font.+- Mark a part with `\class{name}{…}` and tween it: `tw(texPart(e, 'name'), { c_color: COL.nat }, m('name'))`, or `show`/`hide` it. Parts change colour and opacity only; to move terms, make each one a token in `tokens()`.+- A TeX error or an unknown macro stops the page with the formula in the message. Every MathJax extension is included; turn on an optional one with `\require{physics}`, no network needed.+## Timing```js@@@ -87,9 -103,7 +113,9 @@@ Keep `<link rel="expect" href="#bar" bl- `M()` italicises 1–2 letter lowercase runs (variables) and runs of capitals, but keeps common short English words upright (by, my, an, if, in, is, of, or, …; capitalised: By, If, In, …). In maths write `by`, `my`, `an`, `By` to keep them italic. Units inside `M()` turn italic too: write them as words in `T()` text ("meters"). Never put an English sentence in `M()`.- Prompts, `grid` text rows and `choice` options are HTML: plain strings render as text, so wrap math in `$m(...)`.-- Prefix chapter-specific helpers when their names might collide with engine globals (`rect`, `popIn`, `eqLine`, `fit`, `slot`, `Y0`, `OV`, `camera`, `soft`, `clockRun`, `retire`, `seeking`, `BOOK`, `bookSetting`, …); a redeclaration stops the page script. `lint.py` lists every clash.+- In a JS string, double each TeX backslash (`'\\frac{a}{b}'`) or use `` String.raw`\frac{a}{b}` ``: `'\text'` is a tab followed by "ext".+- Write a formula wholly in TeX, an `eqLine` sign included (`sym: TX('\\le')`): TeX glyphs are smaller and lighter than `M()` text.- - Prefix chapter-specific helpers when their names might collide with engine globals (`rect`, `popIn`, `eqLine`, `fit`, `slot`, `Y0`, …); a redeclaration stops the page script.++- Prefix chapter-specific helpers when their names might collide with engine globals (`rect`, `popIn`, `eqLine`, `fit`, `slot`, `Y0`, `OV`, `camera`, `soft`, `clockRun`, `retire`, `seeking`, `BOOK`, `bookSetting`, `TX`, `texPart`, …); a redeclaration stops the page script. `lint.py` lists every clash.- Drag handling: re-parent (append) the element before `setPointerCapture`; moving a node drops its capture.- A card whose content is too long for `BAND` should become several `blanks` rows in a wider side card.- When a question beat is continued early, the engine finishes the beat's pending tweens first; don't rely on half-finished fades.diff --cc .claude/skills/papermorph/references/site.mdindex 7e9330d,af6dc40..2f72892--- a/.claude/skills/papermorph/references/site.md+++ b/.claude/skills/papermorph/references/site.md@@@ -18,16 -18,9 +18,15 @@@ cp "$SKILL/assets/templates/chapter.htmcp "$SKILL/assets/templates/narration.en.json" "content/$BOOK_ID/ch01/narration.en.json"```- Use the agreed primary language: rename the narration source, load `audio/<lang>/timings.js`, and set `CHAPTER.language` to match (default `en`). Choose the voice and translate the template's visible UI text as needed before the pilot.+ Use the pilot chapter's number in place of `ch01` when the pilot is not the first chapter. Use the agreed primary language: rename the narration source, load `audio/<lang>/timings.js`, and set `CHAPTER.language` to match (default `en`). Take `voice` and `rate` for each narration file from `style.json`, and translate the template's visible UI text as needed before the pilot.- If the book's formulas need LaTeX ([engine.md](engine.md#latex)), also copy MathJax with its license, and load `../lib/mathjax.js` right after `engine.js` in every chapter:++If the book's formulas need LaTeX ([engine.md](engine.md#latex)), add MathJax (with its license) to `lib/`, and load `../lib/mathjax.js` right after `engine.js` in every chapter:++```sh- cp "$SKILL/assets/vendor/mathjax/tex-svg-full.js" "$BOOK_SITE/lib/mathjax.js"- cp "$SKILL/assets/vendor/mathjax/LICENSE" "$BOOK_SITE/lib/mathjax-LICENSE.txt"++python3 "$SKILL/scripts/engine.py" "$BOOK_SITE" --latex # lib/mathjax.js; later syncs keep it in step+```+- Each book has its own engine, source materials, narration and optional tests. The engine and cover derive the same progress key from the book's URL folder. Keep existing books on their current paths; their legacy progress remains intact.+ Each book has its own engine copy (kept in step with `engine.py`, see [engine.md](engine.md)), source materials, narration and optional tests. The engine and cover derive the same progress key from the book's URL folder. Keep existing books on their current paths; their legacy progress remains intact.A chapter returns to its book's index. Preserve cover → contents → chapter navigation and the return from contents to cover. The book opens directly at `/<book>/`; it needs no parent index page. Keep existing books' navigation when editing them.diff --cc .claude/skills/papermorph/scripts/engine.pyindex 0000000,f3658fa..36b0ef2mode 000000,100644..100644--- a/.claude/skills/papermorph/scripts/engine.py+++ b/.claude/skills/papermorph/scripts/engine.py@@@ -1,0 -1,93 +1,101 @@@+ #!/usr/bin/env python3+ """Copy the Papermorph engine into books, or check that their copies match.++ python3 engine.py site/history # one book+ python3 engine.py site # every book in site/ (each folder with lib/engine.js)+ python3 engine.py site --check # report copies that differ; exit status 1 if any+ python3 engine.py site --from ../my-engine # a local engine folder (a fork, or one being fixed)+ python3 engine.py site --from you/fork@v2 # engine/ of a GitHub repo at a tag, branch or commit++ python3 engine.py site/stats --latex # also MathJax, for a book whose chapters use TX()++ The engine is not part of this skill: it is the engine/ folder of a repository, versioned by tags, and anyone may+ fork it. Without --from, ./engine is used when it exists (a checkout of that repository), otherwise DEFAULT.+ Each book keeps a full copy in lib/, so it runs on its own; fix the engine at its source and sync, never edit the+ copies. lib/book.css holds the book's own settings and overrides; it is created from the default and never-overwritten.++overwritten. MathJax (engine/vendor/mathjax) goes only into books that ask for it with --latex; after that, a book++with lib/mathjax.js keeps it in step like the rest.+ """+ import argparse, filecmp, io, shutil, sys, tarfile, tempfile, urllib.request+ from pathlib import Path++ DEFAULT = 'DozenTwelve/Papermorph@main'+ OWN = 'book.css'++LATEX = {'vendor/mathjax/tex-svg-full.js': 'mathjax.js', 'vendor/mathjax/LICENSE': 'mathjax-LICENSE.txt'}+++ def fetch(spec: str) -> Path:+ repo, _, ref = spec.partition('@')+ url = f'https://codeload.github.com/{repo}/tar.gz/{ref or "main"}'+ try:+ data = urllib.request.urlopen(url, timeout=60).read()+ except OSError as e:+ sys.exit(f'cannot download {url}: {e}')+ out = Path(tempfile.mkdtemp(prefix='papermorph-engine-'))+ with tarfile.open(fileobj=io.BytesIO(data)) as tar:+ for m in tar.getmembers():+ parts = m.name.split('/')- if m.isfile() and len(parts) == 3 and parts[1] == 'engine': # <repo>-<ref>/engine/<file>- (out / parts[2]).write_bytes(tar.extractfile(m).read())++ if m.isfile() and len(parts) >= 3 and parts[1] == 'engine': # <repo>-<ref>/engine/<path>++ dst = out.joinpath(*parts[2:])++ dst.parent.mkdir(parents=True, exist_ok=True)++ dst.write_bytes(tar.extractfile(m).read())+ if not (out / 'engine.js').exists():+ sys.exit(f'{spec} has no engine/engine.js')+ return out+++ def source(spec):+ if spec is None:+ spec = 'engine' if Path('engine/engine.js').exists() else DEFAULT+ path = Path(spec)+ if path.is_dir():+ if not (path / 'engine.js').exists():+ sys.exit(f'{path} has no engine.js')+ return path+ return fetch(spec)+++ def books(target: Path):+ if (target / 'lib' / 'engine.js').exists():+ return [target]+ found = sorted(p.parent.parent for p in target.glob('*/lib/engine.js'))+ if not found and (target / 'lib').is_dir(): # e.g. site/ with the bookshelf's lib/, before any book exists+ sys.exit(f'{target}/lib has no engine.js and no book folder below it has one: pass the book folder itself')+ return found or [target] # or a new book+++ def main():+ ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)+ ap.add_argument('target', type=Path, help='a book folder, or a folder of books')+ ap.add_argument('--from', dest='src', metavar='DIR|OWNER/REPO@REF', help=f'engine source (default ./engine, else {DEFAULT})')+ ap.add_argument('--check', action='store_true', help='only report differing copies')++ ap.add_argument('--latex', action='store_true', help='also copy MathJax, for TX() formulas')+ a = ap.parse_args()+ engine = source(a.src)+ shared = sorted(p for p in engine.iterdir() if p.suffix in ('.js', '.css') and p.name != OWN)+ stale = []+ for book in books(a.target):+ lib = book / 'lib'- for src in shared:- dst = lib / src.name++ pairs = [(src, lib / src.name) for src in shared]++ if a.latex or (lib / 'mathjax.js').exists():++ pairs += [(engine / src, lib / dst) for src, dst in LATEX.items()]++ for src, dst in pairs:+ if dst.exists() and filecmp.cmp(src, dst, shallow=False):+ continue+ stale.append(dst)+ if not a.check:+ lib.mkdir(parents=True, exist_ok=True)+ shutil.copyfile(src, dst)+ if not (lib / OWN).exists():+ stale.append(lib / OWN)+ if not a.check:+ shutil.copyfile(engine / OWN, lib / OWN)+ verb = 'differs' if a.check else 'updated'+ for p in stale:+ print(f'{verb}: {p}')+ if not stale:+ print('all engine copies match' if a.check else 'nothing to update')+ sys.exit(1 if a.check and stale else 0)+++ if __name__ == '__main__':+ main()diff --cc .claude/skills/papermorph/scripts/lint.pyindex 0000000,681df85..1e95df2mode 000000,100644..100644--- a/.claude/skills/papermorph/scripts/lint.py+++ b/.claude/skills/papermorph/scripts/lint.py@@@ -1,0 -1,199 +1,199 @@@+ #!/usr/bin/env python3+ """Fast static checks of a book's chapters, no browser: run before the delivery pass and after any edit.++ python3 lint.py site/<book> # every chapter+ python3 lint.py site/<book> ch12 ch13 # some chapters+ python3 lint.py site/<book> --content content/<book> --brief books/<book>++ Errors (exit status 1):+ global a top-level name in the chapter or a lib file it loads is also declared by the engine or another of+ its scripts; a second const/let/class stops the page script, a second function silently replaces one+ beat a beat id has no entry in audio/<lang>/timings.js or no MP3+ mark m('name') is not a mark of any beat+ stale the narration's text or [[marks]] differ from timings.js: run tts.py again+ style style.json is not valid JSON or lacks schema, tier, book, words, look or voice+ Warnings: a beat's m('name') not among that beat's own marks (beats built by shared helpers can mislead this);+ no beats recognised in a chapter.+ --content defaults to content/<book> (content/ for the first book's legacy layout), --brief to books/<book>.+ """+ import argparse, json, re, sys+ from pathlib import Path++ DECL = re.compile(r'(?<![\w$.])(?:async\s+)?(function\*?|const|let|var|class)\s+([A-Za-z_$][\w$]*)')+ SRC = re.compile(r'<script\s+src="([^"]+)"')+ INLINE = re.compile(r'<script>(.*?)</script>', re.S)+ BEAT = re.compile(r"\[\s*'(\w+)'\s*,\s*(['\"`])(?:\\.|(?!\2).)*\2\s*,\s*(?:\(\s*(?:m\b|\))|m\s*=>)") # ['id', 'title', (m, D) =>+ MCALL = re.compile(r"(?<![\w$.])m\(\s*'(\w+)'\s*[,)]")+ MARK = re.compile(r'\[\[(\w+)\]\]')+++ def depth0(text):+ """The code with strings, templates, comments and regex literals blanked, and a mask of brace depth 0."""+ out, top, depth, i, n = list(text), [False] * len(text), 0, 0, len(text)+ stack = [] # open template literals: brace depth at each ${+ prev = '' # last significant character, to tell a regex from a division+ def blank(a, b):+ for k in range(a, b):+ if out[k] != '\n':+ out[k] = ' '+ while i < n:+ c = text[i]+ if c in '\'"':+ j = i + 1+ while j < n and text[j] != c and text[j] != '\n':+ j += 2 if text[j] == '\\' else 1+ blank(i + 1, j); i = j + 1; prev = 'a'; continue+ if c == '`' or (c == '}' and stack and stack[-1] == depth):+ if c == '}':+ stack.pop()+ j = i + 1+ while j < n and text[j] != '`' and not (text[j] == '$' and text[j + 1:j + 2] == '{'):+ j += 2 if text[j] == '\\' else 1+ blank(i + 1, j)+ if j < n and text[j] == '$':+ stack.append(depth); i = j + 2; prev = '('; continue+ i = j + 1; prev = 'a'; continue+ if c == '/' and text[i + 1:i + 2] == '/':+ j = text.find('\n', i); j = n if j < 0 else j+ blank(i, j); i = j; continue+ if c == '/' and text[i + 1:i + 2] == '*':+ j = text.find('*/', i + 2); j = n if j < 0 else j + 2+ blank(i, j); i = j; continue+ if c == '/' and (prev in '(,=:[!&|?{};+-*%<>~^' or prev == ''):+ j, cls = i + 1, False+ while j < n and text[j] != '\n' and (text[j] != '/' or cls):+ if text[j] == '\\': j += 1+ elif text[j] == '[': cls = True+ elif text[j] == ']': cls = False+ j += 1+ blank(i + 1, j); i = j + 1; prev = 'a'; continue+ if c in '{([':+ depth += 1+ elif c in '})]':+ depth -= 1+ top[i] = depth == 0+ if not c.isspace():+ prev = 'a' if (c.isalnum() or c in '_$') else c+ if c.isalpha(): # keywords after which a slash starts a regex+ w = re.match(r'[A-Za-z]+', text[i:]).group(0)+ if w in ('return', 'typeof', 'case', 'in', 'of', 'new', 'delete', 'void', 'throw', 'else', 'do'):+ prev = '('+ top[i:i + len(w)] = [depth == 0] * len(w)+ i += len(w); continue+ i += 1+ return ''.join(out), top+++ def decls(text):+ """Top-level declarations of a script: name, kind and line."""+ code, top = depth0(text)+ return [(m.group(2), m.group(1), code.count('\n', 0, m.start()) + 1)+ for m in DECL.finditer(code) if top[m.start()]]+++ def timings(path):+ t = path.read_text(encoding='utf-8')+ return json.loads(t[t.index('{'):t.rindex('}') + 1])+++ def words(s):+ return re.sub(r'[^\w]+', ' ', MARK.sub('', s)).lower().split()+++ def lint_chapter(ch, content, out):+ err = lambda kind, msg: out.append(('E', kind, f'{ch.name}: {msg}'))+ warn = lambda kind, msg: out.append(('W', kind, f'{ch.name}: {msg}'))+ html = (ch / 'index.html').read_text(encoding='utf-8')+ inline = '\n'.join(INLINE.findall(html))+ # globals: every script the page loads, in order+ seen = {}+ for src in SRC.findall(html) + ['(chapter)']:+ if src == '(chapter)':+ text, name = inline, 'chapter'+ else:+ f = (ch / src).resolve()- if f.suffix != '.js' or not f.exists() or f.name == 'timings.js':++ if f.suffix != '.js' or not f.exists() or f.name in ('timings.js', 'mathjax.js'): # MathJax declares no globals+ continue+ text, name = f.read_text(encoding='utf-8'), f.name+ for ident, kind, line in decls(text):+ if ident in seen:+ first, k0 = seen[ident]+ what = 'replaces' if kind.startswith('function') and k0.startswith('function') else 'redeclares'+ err('global', f'{name}:{line} {what} {ident} from {first}')+ else:+ seen[ident] = (name, kind)+ # beats, audio, marks+ lang = (re.search(r"language:\s*'(\w+)'", inline) or [None, 'en'])[1]+ tpath = ch / 'audio' / lang / 'timings.js'+ if not tpath.exists():+ return err('beat', f'no audio/{lang}/timings.js')+ T = timings(tpath)+ starts = [(m.start(), m.group(1)) for m in BEAT.finditer(inline)]+ ids = [b for _, b in starts]+ if not ids:+ warn('beat', "no beats recognised (expected ['id', 'title', (m, D) => …]); marks were not checked")+ for b in ids:+ if b not in T:+ err('beat', f'beat {b} has no timings')+ elif not (ch / 'audio' / lang / f'{b}.mp3').exists():+ err('beat', f'beat {b} has no MP3')+ every = {k for v in T.values() for k in v.get('marks', {})}+ for i, (pos, b) in enumerate(starts):+ body = inline[pos:starts[i + 1][0] if i + 1 < len(starts) else len(inline)]+ for k in sorted(set(MCALL.findall(body))):+ if k not in every:+ err('mark', f"m('{k}') in beat {b} is not a mark of any beat")+ elif b in T and k not in T[b].get('marks', {}):+ warn('mark', f"m('{k}') in beat {b} is not one of its marks")+ # narration against the generated audio+ nar = content / ch.name / f'narration.{lang}.json'+ if nar.exists():+ N = json.loads(nar.read_text(encoding='utf-8-sig')).get('beats', {})+ for b, text in N.items():+ if b not in T:+ err('stale', f'narration beat {b} has no timings')+ continue+ if set(MARK.findall(text)) != set(T[b].get('marks', {})):+ err('stale', f'beat {b}: narration marks differ from timings.js')+ cues = ' '.join(c[1] for c in T[b].get('cues', []))+ if cues and words(text) != words(cues):+ err('stale', f'beat {b}: narration text differs from the generated audio')+++ def lint_style(brief, out):+ p = brief / 'style.json'+ if not p.exists():+ return+ try:+ s = json.loads(p.read_text(encoding='utf-8'))+ except ValueError as e:+ return out.append(('E', 'style', f'style.json: {e}'))+ missing = [k for k in ('schema', 'tier', 'book', 'words', 'look', 'voice') if k not in s]+ if missing:+ out.append(('E', 'style', f'style.json lacks {", ".join(missing)}'))+++ def main():+ ap = argparse.ArgumentParser(description=__doc__, formatter_class=argparse.RawDescriptionHelpFormatter)+ ap.add_argument('book', type=Path, help='the book folder in site/')+ ap.add_argument('chapters', nargs='*', help='chNN (default: all)')+ ap.add_argument('--content', type=Path)+ ap.add_argument('--brief', type=Path)+ a = ap.parse_args()+ root, slug = a.book.resolve().parent.parent, a.book.resolve().name+ content = a.content or next((c for c in (root / 'content' / slug, root / 'content') if c.is_dir()), root / 'content' / slug)+ chs = [a.book / c for c in a.chapters] if a.chapters else sorted(a.book.glob('ch[0-9]*'))+ out = []+ for ch in chs:+ if (ch / 'index.html').exists():+ lint_chapter(ch, content, out)+ lint_style(a.brief or root / 'books' / slug, out)+ for level, kind, msg in out:+ print(f'{"error" if level == "E" else "warn "} {kind:6} {msg}')+ n = sum(level == 'E' for level, _, _ in out)+ print(f'{len(chs)} chapters: {n} errors, {len(out) - n} warnings')+ sys.exit(1 if n else 0)+++ if __name__ == '__main__':+ main()diff --cc .gitattributesindex 54f7e38,0000000..f6284e1mode 100644,000000..100644--- a/.gitattributes+++ b/.gitattributes@@@ -1,2 -1,0 +1,2 @@@+# Vendored files stay byte-exact, so their checksums hold on every OS.- .claude/skills/papermorph/assets/vendor/** -text++engine/vendor/** -textdiff --cc engine/check_latex.pyindex 77af147,0000000..0948671mode 100644,000000..100644--- a/engine/check_latex.py+++ b/engine/check_latex.py@@@ -1,324 -1,0 +1,326 @@@+#!/usr/bin/env python3- """LaTeX regression for the Skill engine: TX() formulas drawn by the vendored MathJax.++"""LaTeX regression for the engine: TX() formulas drawn by the vendored MathJax.+- uv run --with playwright .claude/skills/papermorph/scripts/check_latex.py++ uv run --with playwright engine/check_latex.py+- No server is needed: the check answers every request itself with the Skill's engine, chapter template,++No server is needed: the check answers every request itself with this engine, the Skill's chapter template,+vendored MathJax, a real MP3 from an existing book and the test chapter below. The template chapter,+which has no TX, is compared with the engine at BASE_REF (default main) so that its output stays+identical; set BASE_REF to another commit, or to an empty string to skip that comparison.+No files are generated.+"""+import asyncio+import json+import os+import subprocess+from pathlib import Path+from urllib.parse import urlparse++from playwright.async_api import async_playwright+- SKILL = Path(__file__).resolve().parents[1]- ROOT = SKILL.parents[2]++ENGINE_DIR = Path(__file__).resolve().parent++ROOT = ENGINE_DIR.parent++SKILL = ROOT / ".claude/skills/papermorph"+SITE = ROOT / "site"+ORIGIN = "http://papermorph.test"+BASE_REF = os.environ.get("BASE_REF", "main")- ENGINE = SKILL / "assets/engine/engine.js"- MATHJAX = SKILL / "assets/vendor/mathjax/tex-svg-full.js"++ENGINE = ENGINE_DIR / "engine.js"++MATHJAX = ENGINE_DIR / "vendor/mathjax/tex-svg-full.js"+TEMPLATE = SKILL / "assets/templates/chapter.html"+++def timings(beats, marks):+ timing = {"dur": 6, "marks": marks, "cues": []}+ return "const TIMINGS = " + json.dumps({beat: timing for beat in beats})+++TEMPLATE_TIMINGS = timings(("intro", "idea", "q1", "wrap", "final1", "finish"), {"sub": 1, "note": 2, "w1": 3, "w2": 4})+TEST_TIMINGS = timings(("stage", "rows", "q1", "q2", "finish"), {"b": 1, "c": 1.5})++HEAD = """<!doctype html>+<html lang="en">+<head>+<meta charset="utf-8">+<title>LaTeX check</title>+<link rel="stylesheet" href="../lib/engine.css">+<link rel="expect" href="#bar" blocking="render">+</head>+<body>+<script src="../lib/engine.js"></script>+"""++# Every place that takes math parts gets a TX formula. The script between MathJax and the chapter counts conversions.+TEST_CHAPTER = HEAD + r"""<script src="../lib/mathjax.js"></script>+<script>+const texCalls = [], convert = MathJax.tex2svg;+MathJax.tex2svg = (tex, options) => { texCalls.push(tex); return convert(tex, options); };+</script>+<script src="audio/en/timings.js"></script>+<script>+'use strict';+const CHAPTER = { number: 1, title: 'LaTeX check', minutes: 1, language: 'en' };+const MATRIX = '\\left(\\begin{array}{c|c} a & b \\\\ \\hline c & d \\end{array}\\right)';+const BEATS = [+ ['stage', 'Formulas on the stage', (m) => {+ const p = panel(0);+ S.x = M(p, [TX('x')], { x: 120, y: 120, size: 48, anchor: 'start' });+ S.anchors = ['start', 'middle', 'end'].map((anchor, i) => M(p, [TX('\\frac{a}{b}+1')], { x: 800, y: 120 + i * 90, size: 40, anchor }));+ S.words = M(p, [TX('\\text{Привет, мир}+x')], { x: 120, y: 420, size: 48, anchor: 'start' });+ S.matrix = M(p, [TX(MATRIX)], { x: 1300, y: 420, size: 40 });+ S.mixed = M(p, ['f(x) = ', TX('\\sqrt{x}'), ' + ', F(1, 2)], { x: 800, y: 560, size: 44 });+ S.physics = M(p, [TX('\\require{physics}\\abs{x}')], { x: 1300, y: 600, size: 40 });+ S.parts = M(p, [TX('a^2 + \\class{b}{b^2} = c^2')], { x: 500, y: 760, size: 56, o: 0 });+ show(S.parts, .2);+ tw(texPart(S.parts, 'b'), { c_color: COL.nat }, m('b'));+ S.fading = M(p, [TX('\\class{gone}{2 +} x')], { x: 1100, y: 760, size: 56 });+ hide(texPart(S.fading, 'gone'), m('c'));+ }],+ ['rows', 'Rows, chips and fractions', (m) => {+ const p = panel(0);+ S.row = tokens(p, [[TX('\\dfrac{1}{2}')], '+', [TX('\\dfrac{1}{2}')]], { x: 800, y: 150, size: 48, anchor: 'middle' });+ S.collapsed = collapse(S.row, 0, 2, [TX('1')], m('c'));+ S.box = [...p.querySelectorAll(':scope > rect')].pop();+ S.eq = eqLine(p, TX('2x + 3'), TX('7'), 330, .2, { sym: TX('\\le') });+ S.chip = chip(p, [TX('\\dfrac{3}{4}')], COL.rat, { x: 300, y: 520 });+ S.chipPlain = chip(p, ['3'], COL.nat, { x: 500, y: 520 });+ S.frac = frac(p, [TX('x^2')], [TX('y_i')], 800, 520, .2, { anchor: 'middle' });+ S.sumWidth = [mathW([TX('\\sum_{i=1}^n x_i')], 40), M(p, [TX('\\sum_{i=1}^n x_i')], { x: 1200, y: 520, size: 40 })._w];+ }],+ ['q1', 'Typed answer', () => { panel(0); }, { ask: done => quiz(TOPR, [{+ id: 'c-norm', prompt: ['Find ', $tex('\\|x\\|_2'), ' for ', $tex('x = \\begin{pmatrix}3\\\\4\\end{pmatrix}'), '.'],+ build: blanks([{ parts: [TX('\\|x\\|_2'), ' = ', { box: '5' }], why: ['Because ', $tex('\\sqrt{9+16}=5'), '.'] }]),+ }], done) }],+ ['q2', 'Classify', () => { panel(0); }, { ask: done => quiz(SCREEN, [{+ id: 'p-sums', prompt: ['Is each statement true?'],+ build: grid([{ parts: [TX('\\int_0^1 x\\,dx = \\tfrac{1}{2}')], ans: ['t'], why: 'The area of a triangle.' },+ { parts: [TX('\\sum_{i=1}^{3} i = 5')], ans: ['f'], why: 'It is 6.' }], TF),+ }], done, 'Chapter practice 1 of 1') }],+ ['finish', 'Finished', () => { panel(0); }, { ask: finishCard }],+].map(([id, title, run, extra]) => ({ id, title, run, ...extra }));+boot();+</script>+</body>+</html>+"""++TYPO_PAGE = HEAD + r"""<script src="../lib/mathjax.js"></script>+<script>M(scene, [TX('\\fracc{a}{b}')]);</script>+</body></html>+"""++NO_MATHJAX_PAGE = HEAD + r"""<script>M(scene, [TX('x')]);</script>+</body></html>+"""+++def at_base_ref(path):+ """The file as committed at BASE_REF, or None when the comparison is skipped."""+ if not BASE_REF:+ return None+ relative = path.relative_to(ROOT).as_posix()+ result = subprocess.run(["git", "show", f"{BASE_REF}:{relative}"], cwd=ROOT, capture_output=True)+ return result.stdout.decode("utf-8") if result.returncode == 0 else None+++BASE_ENGINE = at_base_ref(ENGINE)+PAGES = {"base": TEMPLATE.read_text(encoding="utf-8"), "plain": TEMPLATE.read_text(encoding="utf-8"),+ "tex": TEST_CHAPTER, "typo": TYPO_PAGE, "nomathjax": NO_MATHJAX_PAGE}+++async def answer(route):+ variant, _, rest = urlparse(route.request.url).path.split("/__latex__/")[1].partition("/")+ if rest == "ch01/":+ await route.fulfill(content_type="text/html; charset=utf-8", body=PAGES[variant].encode("utf-8"))+ elif rest == "lib/engine.js":+ if variant == "base":+ await route.fulfill(content_type="text/javascript", body=BASE_ENGINE)+ else:+ await route.fulfill(path=ENGINE)- elif rest == "lib/engine.css":- await route.fulfill(path=SKILL / "assets/engine/engine.css")++ elif rest in ("lib/engine.css", "lib/volume.js", "lib/volume.css", "lib/book.css"):++ await route.fulfill(path=ENGINE_DIR / rest[4:])+ elif rest == "lib/mathjax.js":+ await route.fulfill(path=MATHJAX)+ elif rest.endswith("timings.js"):+ await route.fulfill(content_type="text/javascript", body=TEST_TIMINGS if variant == "tex" else TEMPLATE_TIMINGS)+ elif rest.startswith("ch01/audio/en/") and rest.endswith(".mp3"):+ # The pages have no narrated assets; exercise them with an existing, real MP3.+ await route.fulfill(path=SITE / "math-notebook/ch01/audio/en/intro.mp3")+ else:+ await route.fulfill(status=404, body="")+++async def open_page(browser, variant, errors, requests):+ page = await browser.new_page(viewport={"width": 1440, "height": 900})+ page.on("pageerror", lambda error: errors.append(str(error)))+ page.on("console", lambda message: message.type == "error" and errors.append(message.text))+ page.on("response", lambda response: response.status >= 400 and errors.append(f"HTTP {response.status} {response.url}"))+ page.on("request", lambda request: requests.append(request.url))+ await page.route("**/*", answer)+ await page.goto(f"{ORIGIN}/__latex__/{variant}/ch01/")+ return page+++async def snapshots(page):+ """The player's first frame, then the scene and cards of every beat, played to its end."""+ shots = [await page.evaluate("document.getElementById('frame').outerHTML")]+ for i in range(await page.evaluate("BEATS.length")):+ shots.append(await page.evaluate("""i => { seek(i, false); evalTo(Infinity);+ return document.getElementById('scene').innerHTML + document.getElementById('ui').innerHTML; }""", i))+ return shots+++async def check_template_unchanged(browser):+ if not BASE_ENGINE:+ print(f"SKIP template identity: engine not found at BASE_REF={BASE_REF!r}")+ return+ errors, requests, shots = [], [], {}+ for variant in ("base", "plain"):+ page = await open_page(browser, variant, errors, requests)+ await page.wait_for_function("typeof P !== 'undefined' && P.audio")+ shots[variant] = await snapshots(page)+ await page.close()+ assert not errors, errors+ for i, (old, new) in enumerate(zip(shots["base"], shots["plain"])):+ assert old.replace("/__latex__/base/", "/__latex__/plain/") == new, f"template output changed ({'first frame' if i == 0 else f'beat {i - 1}'})"+ print(f"PASS template without TX: identical to {BASE_REF} on the first frame and {len(shots['plain']) - 1} beats")+++STAGE = r"""() => {+ seek(0, false); evalTo(Infinity);+ const R = {}, k = 48 / 1000, [, top, width, height] = texGraphic('x').viewBox;+ const box = S.x.getBBox();+ R.baseline = [box.y, box.y + box.height, top * k, (top + height) * k];+ R.width = [S.x._w, width * k];+ R.anchors = S.anchors.map(e => { const b = e.getBBox(); return [b.x, b.x + b.width, e._w]; });+ const texts = S.words.querySelectorAll('text');+ const group = texts[0].closest('g[data-mml-node="mtext"]'), next = group.nextElementSibling;+ const shift = el => +(/translate\(([-\d.]+)/.exec(el.getAttribute('transform') || '') || [0, 0])[1];+ R.words = [texts.length, getComputedStyle(texts[0]).fontFamily, shift(next) - shift(group) - texts[0].getBBox().width];+ const line = S.matrix.querySelector('line[data-line]');+ R.matrixLine = line && getComputedStyle(line).strokeWidth;+ R.styles = document.querySelectorAll('#MJX-SVG-styles').length;+ R.partColor = texPart(S.parts, 'b').getAttribute('color');+ R.fadedOpacity = texPart(S.fading, 'gone').getAttribute('opacity');+ try { texPart(S.parts, 'nope'); R.unknownPart = 'no error'; } catch (error) { R.unknownPart = error.message; }+ R.mixed = S.mixed._w;+ return R;+}"""++ROWS = r"""() => {+ seek(1, false); // t = 0: the tokens are untouched and the collapse box is placed+ const rect = el => { const b = el.getBoundingClientRect(); return [b.left, b.top, b.right, b.bottom]; };+ const plainM = S.chipPlain.children[1];+ return {+ tokens: S.row.map(rect), box: rect(S.box),+ chip: [rect(S.chip._rect), rect(S.chip.children[1])],+ chipPlain: [S.chipPlain._rect.getAttribute('height'), String(34 * 1.45), plainM.getAttribute('transform'), `translate(0,${34 * .3}) rotate(0) scale(1)`],+ eq: S.eq.querySelectorAll('[data-mml-node="math"]').length,+ frac: S.frac.g.querySelectorAll('[data-mml-node="math"]').length,+ sumWidth: S.sumWidth,+ };+}"""++# Inline math in the cards: the drawing stays inside its viewBox; in running text its baseline is the text's.+INLINE = r"""() => [...document.querySelectorAll('#ui svg.m')].map(svg => {+ const [, y, , h] = svg.getAttribute('viewBox').split(' ').map(Number), b = svg.firstElementChild.getBBox();+ const r = svg.getBoundingClientRect(), scale = r.height / h;+ let gap = null;+ if (svg.closest('.prompt')) {+ const probe = document.createElement('span');+ probe.style.cssText = 'display:inline-block;width:0;height:0';+ svg.after(probe);+ gap = r.top - y * scale - probe.getBoundingClientRect().bottom;+ probe.remove();+ }+ return { inside: b.y >= y - .5 && b.y + b.height <= y + h + .5, gap, tex: !!svg.querySelector('[data-mml-node="math"]') };+})"""+++def close(a, b, tolerance):+ return abs(a - b) <= tolerance+++async def check_tex_chapter(browser):+ errors, requests = [], []+ page = await open_page(browser, "tex", errors, requests)+ await page.wait_for_function("typeof P !== 'undefined' && P.audio")++ stage = await page.evaluate(STAGE)+ top, bottom, want_top, want_bottom = stage["baseline"]+ assert close(top, want_top, .5) and close(bottom, want_bottom, .5), f"TX baseline: {stage['baseline']}"+ assert close(*stage["width"], .01), f"TX width: {stage['width']}"+ (s0, s1, w), (m0, m1, _), (e0, e1, _) = stage["anchors"]+ assert s0 >= -.5 and s1 <= w + 2, f"anchor start: {stage['anchors'][0]}"+ assert close(m0, s0 - w / 2, .5) and close(e0, s0 - w, .5), f"anchors: {stage['anchors']}"+ count, font, gap = stage["words"]+ assert count == 1 and "STIX Two Text" in font, f"\\text{{}} drawn as {count} text nodes in {font}"+ assert 210 <= gap <= 235, f"gap after \\text{{}}: {gap} (MathJax units, medium space 222)"+ assert stage["matrixLine"] == "70px", f"array rule width {stage['matrixLine']}"+ assert stage["styles"] == 1, f"{stage['styles']} MathJax stylesheets"+ assert stage["partColor"] == "#f4a48c" and stage["fadedOpacity"] == "0", f"texPart tweens: {stage['partColor']}, {stage['fadedOpacity']}"+ assert "nope" in stage["unknownPart"], stage["unknownPart"]+ assert stage["mixed"] > 0+ print("PASS stage: baseline, width, anchors, \\text{} in the book font, array rules, \\class parts, mixed parts, \\require")++ rows = await page.evaluate(ROWS)+ box = rows["box"]+ assert all(box[1] <= t[1] and box[3] >= t[3] for t in rows["tokens"]), f"collapse box {box} vs tokens {rows['tokens']}"+ pill, formula = rows["chip"]+ assert pill[1] <= formula[1] and pill[3] >= formula[3], f"chip {pill} vs formula {formula}"+ height, want_height, transform, want_transform = rows["chipPlain"]+ assert height == want_height and transform == want_transform, f"chip without TX changed: {rows['chipPlain']}"+ assert rows["eq"] == 3 and rows["frac"] == 2, f"eqLine {rows['eq']}, frac {rows['frac']}"+ assert close(*rows["sumWidth"], .01), f"mathW {rows['sumWidth']}"+ print("PASS rows: tokens and collapse, eqLine with a TeX sign, chips, frac, mathW")++ await page.evaluate("seek(2, false)")+ inline = await page.evaluate(INLINE)+ assert inline and all(i["inside"] for i in inline), f"inline math clipped: {inline}"+ assert all(i["tex"] for i in inline) and all(i["gap"] is None or abs(i["gap"]) <= 1.5 for i in inline), f"inline baselines: {inline}"+ await page.locator(".box").fill("5")+ await page.locator(".box").press("Enter")+ assert await page.locator(".fb.ok").count() == 1, "blanks with a TeX row did not accept 5"+ await page.evaluate("seek(3, false)")+ inline = await page.evaluate(INLINE)+ assert len(inline) == 2 and all(i["inside"] for i in inline), f"grid rows: {inline}"+ print("PASS cards: $tex prompts on the text baseline, blanks and grid rows, nothing clipped")++ for i in range(await page.evaluate("BEATS.length")):+ first, second = [await page.evaluate("i => { seek(i, false); evalTo(Infinity); return document.getElementById('scene').innerHTML; }", i) for _ in range(2)]+ assert first == second, f"seek({i}) is not repeatable"+ calls = await page.evaluate("[texCalls.length, new Set(texCalls).size]")+ assert calls[0] == calls[1], f"tex2svg ran {calls[0]} times for {calls[1]} formulas"+ assert await page.evaluate("document.querySelectorAll('#MJX-SVG-styles').length") == 1+ print(f"PASS replay: every beat repeatable, {calls[1]} formulas converted once each")++ assert not errors, errors- allowed = {"ch01/", "lib/engine.js", "lib/engine.css", "lib/mathjax.js", "ch01/audio/en/timings.js"}++ allowed = {"ch01/", "lib/engine.js", "lib/engine.css", "lib/volume.js", "lib/volume.css", "lib/book.css",++ "lib/mathjax.js", "ch01/audio/en/timings.js"}+ stray = [u for u in requests if not u.startswith(f"{ORIGIN}/__latex__/tex/")+ or (u.split("/__latex__/tex/")[1] not in allowed and not u.endswith(".mp3"))]+ assert not stray, f"unexpected requests: {stray}"+ print("PASS network: only the page's own files")+ await page.close()+++async def check_errors(browser):+ for variant, expected in (("typo", "\\fracc"), ("nomathjax", "needs lib/mathjax.js")):+ errors, requests = [], []+ page = await open_page(browser, variant, errors, requests)+ await page.wait_for_timeout(300)+ assert any(expected in e for e in errors), f"{variant}: expected an error with {expected!r}, got {errors}"+ await page.close()+ print("PASS errors: a TeX typo and a missing lib/mathjax.js stop the page with the formula named")+++async def main():+ async with async_playwright() as p:+ browser = await p.chromium.launch()+ await check_template_unchanged(browser)+ await check_tex_chapter(browser)+ await check_errors(browser)+ await browser.close()+++if __name__ == "__main__":+ asyncio.run(main())diff --cc engine/engine.jsindex 014800a,1bb24f1..207de8f--- a/engine/engine.js+++ b/engine/engine.js@@@ -146,50 -140,8 +140,51 @@@ const VAR = /(?<![A-Za-z°])(?:(?!(?:ofconst F = (n, d) => ({ f: [String(n), String(d)] }); // fractionconst R = (x, i) => ({ r: x && x.f ? x : String(x), i: i && String(i) }); // root of a number or of F(n, d); i = index, e.g. 3 for a cube rootconst E = x => ({ sup: String(x) }); // exponent, raised after the part before it+const TX = tex => ({ tex: String(tex) }); // LaTeX, drawn by MathJax; the book loads lib/mathjax.js right after this file+const $tex = tex => $m(TX(tex)); // LaTeX inline in HTML text+// MathJax takes this object as its configuration when lib/mathjax.js loads after the engine.+window.MathJax ??= {+ startup: { typeset: false }, // no page scan; formulas are converted on demand+ svg: { fontCache: 'none', mtextInheritFont: true }, // self-contained paths; \text{} in the book's math font+ tex: { packages: { '[-]': ['noerrors', 'noundefined'] }, // a typo stops the page, like a misspelt mark+ formatError: (_, error) => { throw error; } },+ options: { enableMenu: false },+};+const TEX_CACHE = new Map(); // TeX source -> { graphic, viewBox }; seek() redraws every earlier beat+// A copy of the formula's MathJax drawing: units of 1/1000 em, baseline at y = 0; viewBox is [x, y, width, height].+function texGraphic(tex) {+ let drawn = TEX_CACHE.get(tex);+ if (!drawn) {+ if (!window.MathJax?.tex2svg) throw new Error(`TX('${tex}') needs lib/mathjax.js: load ../lib/mathjax.js right after engine.js`);+ if (!document.getElementById('MJX-SVG-styles')) document.head.append(MathJax.svgStylesheet()); // draws table rules and frames+ let svg;+ try { svg = MathJax.tex2svg(tex, { display: false, family: MATH }).querySelector('svg'); } // family: \text{} is measured in the font it is drawn in+ catch (error) { throw new Error(`TX('${tex}'): ${error.message}`); }+ const graphic = mk('g');+ graphic.append(...svg.childNodes);+ drawn = { graphic, viewBox: svg.getAttribute('viewBox').split(' ').map(Number) };+ TEX_CACHE.set(tex, drawn);+ }+ return { graphic: drawn.graphic.cloneNode(true), viewBox: drawn.viewBox };+}+// The part of a TeX formula marked \class{name}{...}, ready for tw/fx on c_color and o.+// MathJax places the part with its own transform, so the tweens act on a group inside it.+function texPart(el, name) {+ const part = el.querySelector(`g.${CSS.escape(name)}`);+ if (!part) throw new Error(`texPart: no \\class{${name}}{…} in this formula`);+ if (!part._tweenGroup) {+ const group = mk('g');+ group.append(...part.childNodes);+ part.append(group);+ const color = part.closest('[color]')?.getAttribute('color'); // the formula's fill+ put(group, /^#[\da-f]{6}$/i.test(color) ? { c_color: color } : {});+ part._tweenGroup = group;+ }+ return part._tweenGroup;+}- // Math expression from parts: 'text' | F(n,d) | R(x) | E(exp) | TX(tex). Baseline at y; anchor start/middle/end.+ const OV = x => ({ ov: String(x) }); // digits under a repeat bar: ['0.', OV('3')] is 0.333…-// Math expression from parts: 'text' | F(n,d) | R(x) | E(exp) | OV(digits). Baseline at y; anchor start/middle/end.++// Math expression from parts: 'text' | F(n,d) | R(x) | E(exp) | OV(digits) | TX(tex). Baseline at y; anchor start/middle/end.+// _ascent and _descent are the TeX parts' height above and below the baseline (0 without TX).function M(parent, parts, { x = 0, y = 0, size = 36, fill = COL.chalk, anchor = 'middle', o = 1, s = 1 } = {}) {const g = G(parent, { x, y, o, s });const inner = mk('g', {}, g);@@@ -1385,7 -1420,7 +1490,7 @@@ const slot = (k, n) =>const r = RINGS[k];return [r.lx + [-72, 72, 0][n % 3], r.ly + 50 + 56 * Math.floor(n / 2)];};- const plain = parts => parts.map(p => typeof p === 'string' ? p : p.tex !== undefined ? p.tex : p.f ? p.f.join('/') : p.sup !== undefined ? '^' + p.sup : (p.i ? p.i : '') + '√' + (p.r.f ? p.r.f.join('/') : p.r)).join('');-const plain = parts => parts.map(p => typeof p === 'string' ? p : p.ov !== undefined ? p.ov + ' repeating' : p.f ? p.f.join('/') : p.sup !== undefined ? '^' + p.sup : (p.i ? p.i : '') + '√' + (p.r.f ? p.r.f.join('/') : p.r)).join('');++const plain = parts => parts.map(p => typeof p === 'string' ? p : p.ov !== undefined ? p.ov + ' repeating' : p.tex !== undefined ? p.tex : p.f ? p.f.join('/') : p.sup !== undefined ? '^' + p.sup : (p.i ? p.i : '') + '√' + (p.r.f ? p.r.f.join('/') : p.r)).join('');const sorter = (items, trayXY) => (body, api) => {const L = qlayer();const bg = mk('rect', { width: 1600, height: 900, fill: 'transparent' }, L);diff --cc engine/vendor/mathjax/LICENSEindex d645695,0000000..d645695mode 100644,000000..100644--- a/engine/vendor/mathjax/LICENSE+++ b/engine/vendor/mathjax/LICENSEdiff --cc engine/vendor/mathjax/README.mdindex ce48d8e,0000000..9dcca44mode 100644,000000..100644--- a/engine/vendor/mathjax/README.md+++ b/engine/vendor/mathjax/README.md@@@ -1,14 -1,0 +1,14 @@@+# MathJax (vendored)++`tex-svg-full.js` is the unmodified `es5/tex-svg-full.js` from npm `[email protected]`, licensed under Apache-2.0 (`LICENSE`, from the same package). It holds TeX input with every extension and SVG output with the TeX fonts in one file, so a book renders formulas offline.++| File | Bytes | sha256 |+| --- | --- | --- |+| `tex-svg-full.js` | 2275113 | `a4354ff94fd868aea0cc6eaaa79a57fda0588646fc46ee3700a349ee0a11cbe6` |+| `LICENSE` | 11358 | `cfc7749b96f63bd31c3c42b5c471bf756814053e847c10f3eb003417bc523d30` |++Source: `https://registry.npmjs.org/mathjax/-/mathjax-3.2.2.tgz`, also `https://cdn.jsdelivr.net/npm/[email protected]/es5/tex-svg-full.js`. The repository's `.gitattributes` keeps this folder byte-exact (`-text`), so the checksums hold on every OS.+- A book that uses LaTeX copies `tex-svg-full.js` to `lib/mathjax.js` and `LICENSE` to `lib/mathjax-LICENSE.txt` ([site.md](../../../references/site.md#start-a-book-folder)); its chapters load `../lib/mathjax.js` right after `engine.js`, which sets the MathJax configuration.++`engine.py <book> --latex` copies `tex-svg-full.js` to the book's `lib/mathjax.js` and `LICENSE` to `lib/mathjax-LICENSE.txt` ([site.md](../../../.claude/skills/papermorph/references/site.md#start-a-book-folder)); its chapters load `../lib/mathjax.js` right after `engine.js`, which sets the MathJax configuration.+- To update, replace both files from a newer 3.x release, update the version and checksums here, and run `scripts/check_latex.py`. MathJax 4 splits extensions and fonts into separate files and needs a different setup.++To update, replace both files from a newer 3.x release, update the version and checksums here, and run `engine/check_latex.py`. MathJax 4 splits extensions and fonts into separate files and needs a different setup.diff --cc engine/vendor/mathjax/tex-svg-full.jsindex b3388d2,0000000..b3388d2mode 100644,000000..100644--- a/engine/vendor/mathjax/tex-svg-full.js+++ b/engine/vendor/mathjax/tex-svg-full.jsdiff --cc site/elementary-algebra/lib/engine.jsindex e6ae7e8,1bb24f1..207de8f--- a/site/elementary-algebra/lib/engine.js+++ b/site/elementary-algebra/lib/engine.js@@@ -146,7 -140,8 +140,51 @@@ const VAR = /(?<![A-Za-z°])(?:(?!(?:ofconst F = (n, d) => ({ f: [String(n), String(d)] }); // fractionconst R = (x, i) => ({ r: x && x.f ? x : String(x), i: i && String(i) }); // root of a number or of F(n, d); i = index, e.g. 3 for a cube rootconst E = x => ({ sup: String(x) }); // exponent, raised after the part before it- // Math expression from parts: 'text' | F(n,d) | R(x) | E(exp). Baseline at y; anchor start/middle/end.++const TX = tex => ({ tex: String(tex) }); // LaTeX, drawn by MathJax; the book loads lib/mathjax.js right after this file++const $tex = tex => $m(TX(tex)); // LaTeX inline in HTML text++// MathJax takes this object as its configuration when lib/mathjax.js loads after the engine.++window.MathJax ??= {++ startup: { typeset: false }, // no page scan; formulas are converted on demand++ svg: { fontCache: 'none', mtextInheritFont: true }, // self-contained paths; \text{} in the book's math font++ tex: { packages: { '[-]': ['noerrors', 'noundefined'] }, // a typo stops the page, like a misspelt mark++ formatError: (_, error) => { throw error; } },++ options: { enableMenu: false },++};++const TEX_CACHE = new Map(); // TeX source -> { graphic, viewBox }; seek() redraws every earlier beat++// A copy of the formula's MathJax drawing: units of 1/1000 em, baseline at y = 0; viewBox is [x, y, width, height].++function texGraphic(tex) {++ let drawn = TEX_CACHE.get(tex);++ if (!drawn) {++ if (!window.MathJax?.tex2svg) throw new Error(`TX('${tex}') needs lib/mathjax.js: load ../lib/mathjax.js right after engine.js`);++ if (!document.getElementById('MJX-SVG-styles')) document.head.append(MathJax.svgStylesheet()); // draws table rules and frames++ let svg;++ try { svg = MathJax.tex2svg(tex, { display: false, family: MATH }).querySelector('svg'); } // family: \text{} is measured in the font it is drawn in++ catch (error) { throw new Error(`TX('${tex}'): ${error.message}`); }++ const graphic = mk('g');++ graphic.append(...svg.childNodes);++ drawn = { graphic, viewBox: svg.getAttribute('viewBox').split(' ').map(Number) };++ TEX_CACHE.set(tex, drawn);++ }++ return { graphic: drawn.graphic.cloneNode(true), viewBox: drawn.viewBox };++}++// The part of a TeX formula marked \class{name}{...}, ready for tw/fx on c_color and o.++// MathJax places the part with its own transform, so the tweens act on a group inside it.++function texPart(el, name) {++ const part = el.querySelector(`g.${CSS.escape(name)}`);++ if (!part) throw new Error(`texPart: no \\class{${name}}{…} in this formula`);++ if (!part._tweenGroup) {++ const group = mk('g');++ group.append(...part.childNodes);++ part.append(group);++ const color = part.closest('[color]')?.getAttribute('color'); // the formula's fill++ put(group, /^#[\da-f]{6}$/i.test(color) ? { c_color: color } : {});++ part._tweenGroup = group;++ }++ return part._tweenGroup;++}+ const OV = x => ({ ov: String(x) }); // digits under a repeat bar: ['0.', OV('3')] is 0.333…-// Math expression from parts: 'text' | F(n,d) | R(x) | E(exp) | OV(digits). Baseline at y; anchor start/middle/end.++// Math expression from parts: 'text' | F(n,d) | R(x) | E(exp) | OV(digits) | TX(tex). Baseline at y; anchor start/middle/end.++// _ascent and _descent are the TeX parts' height above and below the baseline (0 without TX).function M(parent, parts, { x = 0, y = 0, size = 36, fill = COL.chalk, anchor = 'middle', o = 1, s = 1 } = {}) {const g = G(parent, { x, y, o, s });const inner = mk('g', {}, g);@@@ -165,10 -160,10 +203,18 @@@return w;};const rule = (x1, x2, yy) => mk('path', { d: `M${x1} ${yy}H${x2}`, stroke: fill, 'stroke-width': lw, 'stroke-linecap': 'round' }, inner);-- let cx = 0;++ let cx = 0, ascent = 0, descent = 0;for (const p of parts) {if (typeof p === 'string') cx += text(p, cx, 0, size);-- else if (p.f) {++ else if (p.tex !== undefined) {++ const { graphic, viewBox: [, top, w, h] } = texGraphic(p.tex), k = size / 1000; // 1000 units = 1 em = size++ graphic.setAttribute('transform', `translate(${cx},0) scale(${k})`);++ graphic.setAttribute('color', fill); // MathJax paints with currentColor++ inner.append(graphic);++ ascent = Math.max(ascent, -top * k);++ descent = Math.max(descent, (top + h) * k);++ cx += w * k;++ } else if (p.f) {const fs = size * .72, [n, d] = p.f, wn = textW(n, fs), wd = textW(d, fs);const w = Math.max(wn, wd) + size * .2, bar = -size * .3;text(n, cx + (w - wn) / 2, bar - size * .12, fs);@@@ -197,6 -196,6 +247,8 @@@const dx = anchor === 'middle' ? -cx / 2 : anchor === 'end' ? -cx : 0;inner.setAttribute('transform', `translate(${dx},0)`);g._w = cx;++ g._ascent = ascent;++ g._descent = descent;return g;}// Pill-shaped number token, centred on (x, y).@@@ -204,7 -203,7 +256,13 @@@ function chip(parent, parts, color, {const g = G(parent, { x, y, o, s });const rect = mk('rect', {}, g);const m = M(g, parts, { size, y: size * .3 });-- const w = Math.max(m._w + 36, 64), h = size * (parts.some(p => p.f) ? 1.75 : 1.45);++ const w = Math.max(m._w + 36, 64);++ let h = size * (parts.some(p => p.f) ? 1.75 : 1.45);++ if (m._ascent) { // a TeX formula: centre it and grow the pill to fit++ const above = Math.max(size * 1.05, m._ascent), below = Math.max(size * .45, m._descent);++ put(m, { y: (above - below) / 2 });++ h = Math.max(h, m._ascent + m._descent + size * .4);++ }for (const [k, v] of Object.entries({ x: -w / 2, y: -h / 2, width: w, height: h, rx: h / 2, fill: COL.board, stroke: color, 'stroke-width': 2.5 })) rect.setAttribute(k, v);g._rect = rect;return g;@@@ -231,8 -230,8 +289,14 @@@ function layRow(els, { x, y, size, anchfunction collapse(row, i, j, parts, t0, { color = COL.task, fill = COL.chalk, live = false } = {}) {const run = live ? fx : tw, p = row[0].parentNode, { size, y } = row;const left = row[i]._px - row[i]._w / 2, right = row[j]._px + row[j]._w / 2;++ let above = size * .95, height = size * 1.3;++ const tall = row.slice(i, j + 1).filter(e => e._ascent); // TeX tokens may reach higher and lower than text++ if (tall.length) {++ above = Math.max(above, ...tall.map(e => e._ascent + 8));++ height = above + Math.max(size * .35, ...tall.map(e => e._descent + 8));++ }const box = put(mk('rect', { rx: 10, fill: 'none', stroke: color, 'stroke-width': 3 }, p),-- { o: 0, a_x: left - 8, a_y: y - size * .95, a_width: right - left + 16, a_height: size * 1.3 });++ { o: 0, a_x: left - 8, a_y: y - above, a_width: right - left + 16, a_height: height });run(box, { o: 1 }, t0, .3);run(box, { o: 0 }, t0 + 1.2, .3);const res = M(p, parts, { size, fill, o: 0, x: (left + right) / 2, y });@@@ -760,11 -759,11 +824,16 @@@ function brace(p, a, b, y, label, colorfunction mathEl(parts, size = 22) {const svg = mk('svg', { class: 'm', 'font-weight': 400 }); // widths are measured at normal weight, so a bold prompt must not thicken the mathconst m = M(svg, parts, { size, anchor: 'start', fill: 'currentColor' });-- const top = size * 1.05, h = size * 1.5;++ let top = size * 1.05, bottom = size * .45, h = size * 1.5;++ if (m._ascent) { // a TeX formula may reach higher and lower than text++ top = Math.max(top, m._ascent + size * .1);++ bottom = Math.max(bottom, m._descent + size * .1);++ h = top + bottom;++ }svg.setAttribute('viewBox', `0 ${-top} ${m._w + 2} ${h}`);svg.setAttribute('width', m._w + 2);svg.setAttribute('height', h);-- svg.style.verticalAlign = `${-size * .45}px`; // line up the math baseline with the text baseline++ svg.style.verticalAlign = `${-bottom}px`; // line up the math baseline with the text baselinereturn svg;}@@@ -1315,7 -1420,7 +1490,7 @@@ const slot = (k, n) =>const r = RINGS[k];return [r.lx + [-72, 72, 0][n % 3], r.ly + 50 + 56 * Math.floor(n / 2)];};- const plain = parts => parts.map(p => typeof p === 'string' ? p : p.f ? p.f.join('/') : p.sup !== undefined ? '^' + p.sup : (p.i ? p.i : '') + '√' + (p.r.f ? p.r.f.join('/') : p.r)).join('');-const plain = parts => parts.map(p => typeof p === 'string' ? p : p.ov !== undefined ? p.ov + ' repeating' : p.f ? p.f.join('/') : p.sup !== undefined ? '^' + p.sup : (p.i ? p.i : '') + '√' + (p.r.f ? p.r.f.join('/') : p.r)).join('');++const plain = parts => parts.map(p => typeof p === 'string' ? p : p.ov !== undefined ? p.ov + ' repeating' : p.tex !== undefined ? p.tex : p.f ? p.f.join('/') : p.sup !== undefined ? '^' + p.sup : (p.i ? p.i : '') + '√' + (p.r.f ? p.r.f.join('/') : p.r)).join('');const sorter = (items, trayXY) => (body, api) => {const L = qlayer();const bg = mk('rect', { width: 1600, height: 900, fill: 'transparent' }, L);diff --cc site/math-notebook/lib/engine.jsindex 8ecac77,1bb24f1..207de8f--- a/site/math-notebook/lib/engine.js+++ b/site/math-notebook/lib/engine.js@@@ -146,8 -140,8 +140,51 @@@ const VAR = /(?<![A-Za-z°])(?:(?!(?:ofconst F = (n, d) => ({ f: [String(n), String(d)] }); // fractionconst R = (x, i) => ({ r: x && x.f ? x : String(x), i: i && String(i) }); // root of a number or of F(n, d); i = index, e.g. 3 for a cube rootconst E = x => ({ sup: String(x) }); // exponent, raised after the part before it++const TX = tex => ({ tex: String(tex) }); // LaTeX, drawn by MathJax; the book loads lib/mathjax.js right after this file++const $tex = tex => $m(TX(tex)); // LaTeX inline in HTML text++// MathJax takes this object as its configuration when lib/mathjax.js loads after the engine.++window.MathJax ??= {++ startup: { typeset: false }, // no page scan; formulas are converted on demand++ svg: { fontCache: 'none', mtextInheritFont: true }, // self-contained paths; \text{} in the book's math font++ tex: { packages: { '[-]': ['noerrors', 'noundefined'] }, // a typo stops the page, like a misspelt mark++ formatError: (_, error) => { throw error; } },++ options: { enableMenu: false },++};++const TEX_CACHE = new Map(); // TeX source -> { graphic, viewBox }; seek() redraws every earlier beat++// A copy of the formula's MathJax drawing: units of 1/1000 em, baseline at y = 0; viewBox is [x, y, width, height].++function texGraphic(tex) {++ let drawn = TEX_CACHE.get(tex);++ if (!drawn) {++ if (!window.MathJax?.tex2svg) throw new Error(`TX('${tex}') needs lib/mathjax.js: load ../lib/mathjax.js right after engine.js`);++ if (!document.getElementById('MJX-SVG-styles')) document.head.append(MathJax.svgStylesheet()); // draws table rules and frames++ let svg;++ try { svg = MathJax.tex2svg(tex, { display: false, family: MATH }).querySelector('svg'); } // family: \text{} is measured in the font it is drawn in++ catch (error) { throw new Error(`TX('${tex}'): ${error.message}`); }++ const graphic = mk('g');++ graphic.append(...svg.childNodes);++ drawn = { graphic, viewBox: svg.getAttribute('viewBox').split(' ').map(Number) };++ TEX_CACHE.set(tex, drawn);++ }++ return { graphic: drawn.graphic.cloneNode(true), viewBox: drawn.viewBox };++}++// The part of a TeX formula marked \class{name}{...}, ready for tw/fx on c_color and o.++// MathJax places the part with its own transform, so the tweens act on a group inside it.++function texPart(el, name) {++ const part = el.querySelector(`g.${CSS.escape(name)}`);++ if (!part) throw new Error(`texPart: no \\class{${name}}{…} in this formula`);++ if (!part._tweenGroup) {++ const group = mk('g');++ group.append(...part.childNodes);++ part.append(group);++ const color = part.closest('[color]')?.getAttribute('color'); // the formula's fill++ put(group, /^#[\da-f]{6}$/i.test(color) ? { c_color: color } : {});++ part._tweenGroup = group;++ }++ return part._tweenGroup;++}const OV = x => ({ ov: String(x) }); // digits under a repeat bar: ['0.', OV('3')] is 0.333…- // Math expression from parts: 'text' | F(n,d) | R(x) | E(exp). Baseline at y; anchor start/middle/end.-// Math expression from parts: 'text' | F(n,d) | R(x) | E(exp) | OV(digits). Baseline at y; anchor start/middle/end.++// Math expression from parts: 'text' | F(n,d) | R(x) | E(exp) | OV(digits) | TX(tex). Baseline at y; anchor start/middle/end.++// _ascent and _descent are the TeX parts' height above and below the baseline (0 without TX).function M(parent, parts, { x = 0, y = 0, size = 36, fill = COL.chalk, anchor = 'middle', o = 1, s = 1 } = {}) {const g = G(parent, { x, y, o, s });const inner = mk('g', {}, g);@@@ -166,10 -160,10 +203,18 @@@return w;};const rule = (x1, x2, yy) => mk('path', { d: `M${x1} ${yy}H${x2}`, stroke: fill, 'stroke-width': lw, 'stroke-linecap': 'round' }, inner);-- let cx = 0;++ let cx = 0, ascent = 0, descent = 0;for (const p of parts) {if (typeof p === 'string') cx += text(p, cx, 0, size);-- else if (p.f) {++ else if (p.tex !== undefined) {++ const { graphic, viewBox: [, top, w, h] } = texGraphic(p.tex), k = size / 1000; // 1000 units = 1 em = size++ graphic.setAttribute('transform', `translate(${cx},0) scale(${k})`);++ graphic.setAttribute('color', fill); // MathJax paints with currentColor++ inner.append(graphic);++ ascent = Math.max(ascent, -top * k);++ descent = Math.max(descent, (top + h) * k);++ cx += w * k;++ } else if (p.f) {const fs = size * .72, [n, d] = p.f, wn = textW(n, fs), wd = textW(d, fs);const w = Math.max(wn, wd) + size * .2, bar = -size * .3;text(n, cx + (w - wn) / 2, bar - size * .12, fs);@@@ -202,6 -196,6 +247,8 @@@const dx = anchor === 'middle' ? -cx / 2 : anchor === 'end' ? -cx : 0;inner.setAttribute('transform', `translate(${dx},0)`);g._w = cx;++ g._ascent = ascent;++ g._descent = descent;return g;}// Pill-shaped number token, centred on (x, y).@@@ -209,7 -203,7 +256,13 @@@ function chip(parent, parts, color, {const g = G(parent, { x, y, o, s });const rect = mk('rect', {}, g);const m = M(g, parts, { size, y: size * .3 });-- const w = Math.max(m._w + 36, 64), h = size * (parts.some(p => p.f) ? 1.75 : 1.45);++ const w = Math.max(m._w + 36, 64);++ let h = size * (parts.some(p => p.f) ? 1.75 : 1.45);++ if (m._ascent) { // a TeX formula: centre it and grow the pill to fit++ const above = Math.max(size * 1.05, m._ascent), below = Math.max(size * .45, m._descent);++ put(m, { y: (above - below) / 2 });++ h = Math.max(h, m._ascent + m._descent + size * .4);++ }for (const [k, v] of Object.entries({ x: -w / 2, y: -h / 2, width: w, height: h, rx: h / 2, fill: COL.board, stroke: color, 'stroke-width': 2.5 })) rect.setAttribute(k, v);g._rect = rect;return g;@@@ -236,8 -230,8 +289,14 @@@ function layRow(els, { x, y, size, anchfunction collapse(row, i, j, parts, t0, { color = COL.task, fill = COL.chalk, live = false } = {}) {const run = live ? fx : tw, p = row[0].parentNode, { size, y } = row;const left = row[i]._px - row[i]._w / 2, right = row[j]._px + row[j]._w / 2;++ let above = size * .95, height = size * 1.3;++ const tall = row.slice(i, j + 1).filter(e => e._ascent); // TeX tokens may reach higher and lower than text++ if (tall.length) {++ above = Math.max(above, ...tall.map(e => e._ascent + 8));++ height = above + Math.max(size * .35, ...tall.map(e => e._descent + 8));++ }const box = put(mk('rect', { rx: 10, fill: 'none', stroke: color, 'stroke-width': 3 }, p),-- { o: 0, a_x: left - 8, a_y: y - size * .95, a_width: right - left + 16, a_height: size * 1.3 });++ { o: 0, a_x: left - 8, a_y: y - above, a_width: right - left + 16, a_height: height });run(box, { o: 1 }, t0, .3);run(box, { o: 0 }, t0 + 1.2, .3);const res = M(p, parts, { size, fill, o: 0, x: (left + right) / 2, y });@@@ -765,11 -759,11 +824,16 @@@ function brace(p, a, b, y, label, colorfunction mathEl(parts, size = 22) {const svg = mk('svg', { class: 'm', 'font-weight': 400 }); // widths are measured at normal weight, so a bold prompt must not thicken the mathconst m = M(svg, parts, { size, anchor: 'start', fill: 'currentColor' });-- const top = size * 1.05, h = size * 1.5;++ let top = size * 1.05, bottom = size * .45, h = size * 1.5;++ if (m._ascent) { // a TeX formula may reach higher and lower than text++ top = Math.max(top, m._ascent + size * .1);++ bottom = Math.max(bottom, m._descent + size * .1);++ h = top + bottom;++ }svg.setAttribute('viewBox', `0 ${-top} ${m._w + 2} ${h}`);svg.setAttribute('width', m._w + 2);svg.setAttribute('height', h);-- svg.style.verticalAlign = `${-size * .45}px`; // line up the math baseline with the text baseline++ svg.style.verticalAlign = `${-bottom}px`; // line up the math baseline with the text baselinereturn svg;}@@@ -1320,7 -1420,7 +1490,7 @@@ const slot = (k, n) =>const r = RINGS[k];return [r.lx + [-72, 72, 0][n % 3], r.ly + 50 + 56 * Math.floor(n / 2)];};--const plain = parts => parts.map(p => typeof p === 'string' ? p : p.ov !== undefined ? p.ov + ' repeating' : p.f ? p.f.join('/') : p.sup !== undefined ? '^' + p.sup : (p.i ? p.i : '') + '√' + (p.r.f ? p.r.f.join('/') : p.r)).join('');++const plain = parts => parts.map(p => typeof p === 'string' ? p : p.ov !== undefined ? p.ov + ' repeating' : p.tex !== undefined ? p.tex : p.f ? p.f.join('/') : p.sup !== undefined ? '^' + p.sup : (p.i ? p.i : '') + '√' + (p.r.f ? p.r.f.join('/') : p.r)).join('');const sorter = (items, trayXY) => (body, api) => {const L = qlayer();const bg = mk('rect', { width: 1600, height: 900, fill: 'transparent' }, L);diff --cc site/science/lib/engine.jsindex 0000000,1bb24f1..207de8fmode 000000,100644..100644--- a/site/science/lib/engine.js+++ b/site/science/lib/engine.js@@@ -1,0 -1,1802 +1,1872 @@@+ // Papermorph lesson engine: stage, drawing, timeline, questions, player.+ // A chapter page loads this file, defines CHAPTER and BEATS, then calls boot().+ 'use strict';+ // A fast follow-up navigation can abort the incoming page transition.+ addEventListener('pagereveal', e => e.viewTransition?.ready.catch(() => {}));+ document.body.insertAdjacentHTML('afterbegin', `<div id="frame">+ <svg id="stage" viewBox="0 0 1600 900" role="img" aria-label="Lesson animation">+ <g id="scene"></g>+ </svg>+ <div id="ui"></div>+ <div class="paused-mark"><div>Paused. Press space or click to continue.</div></div>+ <div class="caption" id="caption" hidden></div>+ <div class="help" id="help" hidden role="dialog" aria-label="Keyboard shortcuts">+ <div class="help-box">+ <h2>Keyboard shortcuts</h2>+ <div class="help-cols">+ <div><h3>Lesson</h3><dl>+ <dt><kbd>Space</kbd></dt><dd>Play or pause</dd>+ <dt><kbd>←</kbd><kbd>→</kbd></dt><dd>Previous or next step</dd>+ <dt><kbd>Shift</kbd><kbd>←</kbd><kbd>→</kbd></dt><dd>Change step during a question</dd>+ <dt><kbd>Home</kbd></dt><dd>Start over</dd>+ <dt><kbd>C</kbd></dt><dd>Captions on or off</dd>+ <dt><kbd><</kbd><kbd>></kbd></dt><dd>Slower or faster</dd>+ <dt><kbd>F</kbd></dt><dd>Full screen</dd>+ <dt><kbd>?</kbd></dt><dd>Show this list</dd>+ </dl></div>+ <div><h3>Questions</h3><dl>+ <dt><kbd>1</kbd>–<kbd>6</kbd></dt><dd>Choose an answer or a ring</dd>+ <dt><kbd>T</kbd><kbd>F</kbd></dt><dd>True or false</dd>+ <dt><kbd>↑</kbd><kbd>↓</kbd></dt><dd>Move between rows</dd>+ <dt><kbd>←</kbd><kbd>→</kbd></dt><dd>Move along the number line, or pick a number to sort</dd>+ <dt><kbd>Enter</kbd></dt><dd>Check, then continue</dd>+ <dt><kbd>S</kbd></dt><dd>Show the answer</dd>+ <dt><kbd>Esc</kbd></dt><dd>Leave an answer box</dd>+ </dl></div>+ </div>+ <p class="help-close">Press <kbd>Esc</kbd> to close.</p>+ </div>+ </div>+ <p class="sound-note" id="soundNote" hidden>Sound could not play. The lesson continues with the on-screen text.</p>+ <button class="cover" id="cover"><div>+ <p class="cover-k" id="coverK"></p>+ <h1 class="cover-t" id="coverT"></h1>+ <span class="go"><svg width="24" height="24" viewBox="0 0 18 18"><path d="M3 1.5v15l13-7.5z" fill="currentColor"/></svg>Start lesson</span>+ <small><span id="coverMeta"></span> Press <kbd>Space</kbd> to start, <kbd>?</kbd> for shortcuts.</small>+ </div></button>+ <div id="bar">+ <a class="icon" id="bHome" href="../" aria-label="All chapters" title="All chapters">+ <svg viewBox="0 0 18 18"><path d="M2 2h6v6H2zM10 2h6v6h-6zM2 10h6v6H2zM10 10h6v6h-6z"/></svg>+ </a>+ <button class="icon" id="bPlay" aria-label="Play or pause (space)">+ <svg class="i-play" viewBox="0 0 18 18"><path d="M4 2v14l12-7z"/></svg>+ <svg class="i-pause" viewBox="0 0 18 18"><path d="M3.5 2h4v14h-4zM10.5 2h4v14h-4z"/></svg>+ </button>+ <button class="icon" id="bBack" aria-label="Previous step (left arrow)">+ <svg viewBox="0 0 18 18"><path d="M3 2h2.5v14H3zM16 2v14L6.5 9z"/></svg>+ </button>+ <button class="icon" id="bRestart" aria-label="Restart lesson">+ <svg viewBox="0 0 18 18"><path d="M9 2.5a6.5 6.5 0 1 1-6.3 8.1l2-.5A4.5 4.5 0 1 0 9 4.5V7L4.5 3.5 9 0z"/></svg>+ </button>+ <div class="segs" id="segs"></div>+ <div class="step" id="stepName"></div>+ <button class="icon txt" id="bHelp" aria-label="Keyboard shortcuts (?)" title="Keyboard shortcuts (?)">?</button>+ <button class="icon txt speed" id="bSpeed" aria-label="Playback speed (< and >)" title="Playback speed (< and >)">1×</button>+ <button class="icon cc" id="bCC" aria-pressed="false" aria-label="Captions (C)" title="Captions (C)">CC</button>+ <button class="icon" id="bFull" aria-label="Full screen">+ <svg viewBox="0 0 18 18"><path d="M1 1h6v2H3v4H1zM11 1h6v6h-2V3h-4zM1 11h2v4h4v2H1zM15 11h2v6h-6v-2h4z"/></svg>+ </button>+ </div>+ </div>`);++ // Board colour, grain and vignette are a static CSS background of #stage (engine.css). The grain is a small noise+ // texture made once here: an SVG turbulence filter behind animated content is recomputed on every frame in Firefox.+ {+ const c = document.createElement('canvas'); c.width = c.height = 256;+ const x = c.getContext('2d'), d = x.createImageData(256, 256);+ for (let i = 0, s = 7; i < d.data.length; i += 4) { s = s * 16807 % 2147483647; d.data.set([235, 242, 230, 4 + s % 12], i); }+ x.putImageData(d, 0, 0);+ document.getElementById('stage').style.setProperty('--grain', `url(${c.toDataURL()})`);+ }++ /* ---------- drawing helpers ---------- */+ const NS = 'http://www.w3.org/2000/svg';+ const COL = { nat: '#f4a48c', whole: '#86c9e8', int: '#f3c95c', rat: '#e8a0c8', irr: '#8fd6b0', real: '#bba8ee',+ chalk: '#ece8dc', dim: '#9aaba3', faint: '#5d7068', task: '#f0b45a', good: '#8fd6b0', bad: '#f08c7a', board: '#1d2b27' };+ const UI = '"Avenir Next","Segoe UI","Helvetica Neue",Arial,sans-serif';+ // Book settings (lib/book.css, next to engine.css and imported by it): --math-font for numbers and formulas,+ // --progress-key for the localStorage key the cover and chapters share.+ const BOOK = getComputedStyle(document.documentElement);+ const bookSetting = name => BOOK.getPropertyValue(name).trim().replace(/^(["'])([^"']*)\1$/, '$2'); // unquote a lone string only+ const MATH = bookSetting('--math-font') || '"STIX Two Text","Cambria Math","Iowan Old Style",Palatino,Georgia,serif';+ const NAME = { nat: 'Natural', whole: 'Whole', int: 'Integers', rat: 'Rational', irr: 'Irrational', real: 'Real' };+ // Card positions inside the 1600×900 picture.+ const BAND = { x: 96, y: 686, w: 1408, cls: 'band' }; // bottom band (moves up when taller than the space left)+ const RIGHT = { x: 1258, y: 546, w: 330, cls: 'side', maxH: 346 }; // right of the number map+ const TOPR = { x: 960, y: 70, w: 624, cls: 'side', maxH: 470 }; // top right, above the number line+ const SCREEN = { x: 0, y: 0, w: 1600, cls: 'screen' };+ const SORT_SCREEN = { x: 0, y: 0, w: 1600, cls: 'screen sort' };+ const $m = (...parts) => ({ m: parts });++ function mk(tag, attrs = {}, parent) {+ const e = document.createElementNS(NS, tag);+ for (const k in attrs) e.setAttribute(k, attrs[k]);+ if (parent) parent.appendChild(e);+ return e;+ }+ // Every animated element keeps a small state object; render() writes it to the DOM.+ // Keys: x y s r o (transform/opacity), d (0..1 stroke drawn), a_<attr> numeric attr, c_<attr> hex colour.+ function st(e) { return e._st || (e._st = { x: 0, y: 0, s: 1, r: 0, o: 1 }); }+ function put(e, o) { Object.assign(st(e), o); render(e); return e; }+ // Unchanged transform/opacity are not rewritten: per-frame updates of still elements cost repaints (notably in Firefox).+ function render(e) {+ const s = e._st, tf = s.x || s.y || s.s !== 1 || s.r ? `translate(${s.x},${s.y}) rotate(${s.r}) scale(${s.s})` : null;+ if (tf !== e._tf) { if (tf) e.setAttribute('transform', tf); else e.removeAttribute('transform'); e._tf = tf; }+ if (s.o !== e._o) { e.setAttribute('opacity', s.o); e._o = s.o; }+ if (s.d !== undefined) {+ e.setAttribute('stroke-dashoffset', 1 - s.d);+ e.style.visibility = s.d < .002 ? 'hidden' : '';+ }+ for (const k in s) {+ if (k.startsWith('a_')) e.setAttribute(k.slice(2), s[k]);+ else if (k.startsWith('c_')) e.setAttribute(k.slice(2), s[k]);+ }+ }+ function G(parent, o = {}) { return put(mk('g', {}, parent), o); }+ function path(parent, d, attrs = {}, o = {}) {+ const p = mk('path', { d, fill: 'none', 'stroke-linecap': 'round', 'stroke-linejoin': 'round', ...attrs }, parent);+ if (o.d !== undefined) { p.setAttribute('pathLength', 1); p.setAttribute('stroke-dasharray', '1 1'); }+ return put(p, o);+ }+ function T(parent, str, { x = 0, y = 0, size = 30, fill = COL.chalk, font = UI, weight = 500, anchor = 'start', o = 1 } = {}) {+ const t = mk('text', { 'font-size': size, fill, 'font-family': font, 'font-weight': weight, 'text-anchor': anchor }, parent);+ t.textContent = str;+ t.style.whiteSpace = 'pre';+ return put(t, { x, y, o });+ }+ const ctx2d = document.createElement('canvas').getContext('2d');+ function textW(str, size, italic = false) { ctx2d.font = `${italic ? 'italic ' : ''}${size}px ${MATH}`; return ctx2d.measureText(str).width; }+ const VAR = /(?<![A-Za-z°])(?:(?!(?:of|in|is|to|or|at|on|by|as|an|if|it|be|no|so|up|we|my)(?![A-Za-z]))[a-z]{1,2}|(?!(?:If|In|It|Is|On|At|No|So|Or|An|As|To|By|Up)(?![A-Za-z]))[a-z]?[A-Z]{1,3}[a-z]?)(?![A-Za-z])/g; // capitals: A, PV, nRT // short lowercase runs are variables (a, x, ab), except short English words+ const F = (n, d) => ({ f: [String(n), String(d)] }); // fraction+ const R = (x, i) => ({ r: x && x.f ? x : String(x), i: i && String(i) }); // root of a number or of F(n, d); i = index, e.g. 3 for a cube root+ const E = x => ({ sup: String(x) }); // exponent, raised after the part before it++const TX = tex => ({ tex: String(tex) }); // LaTeX, drawn by MathJax; the book loads lib/mathjax.js right after this file++const $tex = tex => $m(TX(tex)); // LaTeX inline in HTML text++// MathJax takes this object as its configuration when lib/mathjax.js loads after the engine.++window.MathJax ??= {++ startup: { typeset: false }, // no page scan; formulas are converted on demand++ svg: { fontCache: 'none', mtextInheritFont: true }, // self-contained paths; \text{} in the book's math font++ tex: { packages: { '[-]': ['noerrors', 'noundefined'] }, // a typo stops the page, like a misspelt mark++ formatError: (_, error) => { throw error; } },++ options: { enableMenu: false },++};++const TEX_CACHE = new Map(); // TeX source -> { graphic, viewBox }; seek() redraws every earlier beat++// A copy of the formula's MathJax drawing: units of 1/1000 em, baseline at y = 0; viewBox is [x, y, width, height].++function texGraphic(tex) {++ let drawn = TEX_CACHE.get(tex);++ if (!drawn) {++ if (!window.MathJax?.tex2svg) throw new Error(`TX('${tex}') needs lib/mathjax.js: load ../lib/mathjax.js right after engine.js`);++ if (!document.getElementById('MJX-SVG-styles')) document.head.append(MathJax.svgStylesheet()); // draws table rules and frames++ let svg;++ try { svg = MathJax.tex2svg(tex, { display: false, family: MATH }).querySelector('svg'); } // family: \text{} is measured in the font it is drawn in++ catch (error) { throw new Error(`TX('${tex}'): ${error.message}`); }++ const graphic = mk('g');++ graphic.append(...svg.childNodes);++ drawn = { graphic, viewBox: svg.getAttribute('viewBox').split(' ').map(Number) };++ TEX_CACHE.set(tex, drawn);++ }++ return { graphic: drawn.graphic.cloneNode(true), viewBox: drawn.viewBox };++}++// The part of a TeX formula marked \class{name}{...}, ready for tw/fx on c_color and o.++// MathJax places the part with its own transform, so the tweens act on a group inside it.++function texPart(el, name) {++ const part = el.querySelector(`g.${CSS.escape(name)}`);++ if (!part) throw new Error(`texPart: no \\class{${name}}{…} in this formula`);++ if (!part._tweenGroup) {++ const group = mk('g');++ group.append(...part.childNodes);++ part.append(group);++ const color = part.closest('[color]')?.getAttribute('color'); // the formula's fill++ put(group, /^#[\da-f]{6}$/i.test(color) ? { c_color: color } : {});++ part._tweenGroup = group;++ }++ return part._tweenGroup;++}+ const OV = x => ({ ov: String(x) }); // digits under a repeat bar: ['0.', OV('3')] is 0.333…-// Math expression from parts: 'text' | F(n,d) | R(x) | E(exp) | OV(digits). Baseline at y; anchor start/middle/end.++// Math expression from parts: 'text' | F(n,d) | R(x) | E(exp) | OV(digits) | TX(tex). Baseline at y; anchor start/middle/end.++// _ascent and _descent are the TeX parts' height above and below the baseline (0 without TX).+ function M(parent, parts, { x = 0, y = 0, size = 36, fill = COL.chalk, anchor = 'middle', o = 1, s = 1 } = {}) {+ const g = G(parent, { x, y, o, s });+ const inner = mk('g', {}, g);+ const lw = size * .05;+ const text = (str, tx, ty, sz) => {+ const t = mk('text', { x: tx, y: ty, 'font-size': sz, 'font-family': MATH, fill }, inner);+ t.style.whiteSpace = 'pre';+ let w = 0, last = 0;+ const run = (piece, italic) => {+ if (!piece) return;+ mk('tspan', italic ? { 'font-style': 'italic' } : {}, t).textContent = piece;+ w += textW(piece, sz, italic);+ };+ for (const m of str.matchAll(VAR)) { run(str.slice(last, m.index), false); run(m[0], true); last = m.index + m[0].length; }+ run(str.slice(last), false);+ return w;+ };+ const rule = (x1, x2, yy) => mk('path', { d: `M${x1} ${yy}H${x2}`, stroke: fill, 'stroke-width': lw, 'stroke-linecap': 'round' }, inner);- let cx = 0;++ let cx = 0, ascent = 0, descent = 0;+ for (const p of parts) {+ if (typeof p === 'string') cx += text(p, cx, 0, size);- else if (p.f) {++ else if (p.tex !== undefined) {++ const { graphic, viewBox: [, top, w, h] } = texGraphic(p.tex), k = size / 1000; // 1000 units = 1 em = size++ graphic.setAttribute('transform', `translate(${cx},0) scale(${k})`);++ graphic.setAttribute('color', fill); // MathJax paints with currentColor++ inner.append(graphic);++ ascent = Math.max(ascent, -top * k);++ descent = Math.max(descent, (top + h) * k);++ cx += w * k;++ } else if (p.f) {+ const fs = size * .72, [n, d] = p.f, wn = textW(n, fs), wd = textW(d, fs);+ const w = Math.max(wn, wd) + size * .2, bar = -size * .3;+ text(n, cx + (w - wn) / 2, bar - size * .12, fs);+ text(d, cx + (w - wd) / 2, bar + size * .62, fs);+ rule(cx + size * .04, cx + w - size * .04, bar);+ cx += w + size * .04;+ } else if (p.r) {+ const fr = typeof p.r === 'object', mid = fr ? -size * .12 : -size * .3, bot = fr ? size * .45 : size * .06, top = fr ? -size * 1.12 : -size * .82;+ let x0 = cx + size * .04;+ if (p.i) { const iw = textW(p.i, size * .42); text(p.i, x0, mid - size * .14, size * .42); x0 += Math.max(0, iw - size * .12); } // index in the radical's crook+ let w;+ if (fr) { // a fraction under the radical, laid out like F()+ const fs = size * .72, [n, d] = p.r.f, wn = textW(n, fs), wd = textW(d, fs), bx = x0 + size * .56, bar = -size * .3;+ w = Math.max(wn, wd) + size * .2;+ text(n, bx + (w - wn) / 2, bar - size * .12, fs);+ text(d, bx + (w - wd) / 2, bar + size * .62, fs);+ mk('path', { d: `M${bx + size * .04} ${bar}H${bx + w - size * .04}`, stroke: fill, 'stroke-width': lw, 'stroke-linecap': 'round' }, inner);+ } else { w = textW(p.r, size); text(p.r, x0 + size * .56, 0, size); }+ mk('path', { d: `M${x0} ${mid}L${x0 + size * .1} ${mid - size * .06}L${x0 + size * .27} ${bot}L${x0 + size * .45} ${top}H${x0 + size * .56 + w + size * .06}`,+ fill: 'none', stroke: fill, 'stroke-width': lw, 'stroke-linejoin': 'round', 'stroke-linecap': 'round' }, inner);+ cx = x0 + size * .56 + w + size * .1;+ } else if (p.sup !== undefined) {+ cx += text(p.sup, cx + size * .03, -size * .45, size * .62) + size * .06;+ } else if (p.ov !== undefined) {+ const w = text(p.ov, cx, 0, size);+ rule(cx + size * .04, cx + w - size * .02, -size * .8);+ cx += w;+ }+ }+ const dx = anchor === 'middle' ? -cx / 2 : anchor === 'end' ? -cx : 0;+ inner.setAttribute('transform', `translate(${dx},0)`);+ g._w = cx;++ g._ascent = ascent;++ g._descent = descent;+ return g;+ }+ // Pill-shaped number token, centred on (x, y).+ function chip(parent, parts, color, { x = 0, y = 0, o = 1, s = 1, size = 34 } = {}) {+ const g = G(parent, { x, y, o, s });+ const rect = mk('rect', {}, g);+ const m = M(g, parts, { size, y: size * .3 });- const w = Math.max(m._w + 36, 64), h = size * (parts.some(p => p.f) ? 1.75 : 1.45);++ const w = Math.max(m._w + 36, 64);++ let h = size * (parts.some(p => p.f) ? 1.75 : 1.45);++ if (m._ascent) { // a TeX formula: centre it and grow the pill to fit++ const above = Math.max(size * 1.05, m._ascent), below = Math.max(size * .45, m._descent);++ put(m, { y: (above - below) / 2 });++ h = Math.max(h, m._ascent + m._descent + size * .4);++ }+ for (const [k, v] of Object.entries({ x: -w / 2, y: -h / 2, width: w, height: h, rx: h / 2, fill: COL.board, stroke: color, 'stroke-width': 2.5 })) rect.setAttribute(k, v);+ g._rect = rect;+ return g;+ }+ // A row of math tokens laid out left to right. Items: string | parts array | { t, fill }.+ // Each token is centred on its own x, so it can move alone (swaps, sliding parentheses). Spacing comes from the strings.+ function tokens(parent, items, { x = 0, y = 0, size = 44, fill = COL.chalk, anchor = 'start', o = 1 } = {}) {+ const els = items.map(it => {+ const spec = it && it.t !== undefined ? it : { t: it };+ return M(parent, [].concat(spec.t), { size, fill: spec.fill || fill, o });+ });+ return layRow(els, { x, y, size, anchor }, e => put(e, { x: e._px, y }));+ }+ // Place a row's tokens side by side. Each token keeps its planned centre in _px, so later steps+ // can be planned before earlier tweens have run.+ function layRow(els, { x, y, size, anchor }, move) {+ const total = els.reduce((a, e) => a + e._w, 0);+ let cx = anchor === 'middle' ? x - total / 2 : anchor === 'end' ? x - total : x;+ for (const e of els) { e._px = cx + e._w / 2; move(e); cx += e._w; }+ return Object.assign(els, { w: total, x, y, size, anchor });+ }+ // One simplification step: box tokens i..j, shrink them into a single result token, then close the gap.+ // Returns the new row. live = true runs on the question clock (inside ask) instead of the lesson clock.+ function collapse(row, i, j, parts, t0, { color = COL.task, fill = COL.chalk, live = false } = {}) {+ const run = live ? fx : tw, p = row[0].parentNode, { size, y } = row;+ const left = row[i]._px - row[i]._w / 2, right = row[j]._px + row[j]._w / 2;++ let above = size * .95, height = size * 1.3;++ const tall = row.slice(i, j + 1).filter(e => e._ascent); // TeX tokens may reach higher and lower than text++ if (tall.length) {++ above = Math.max(above, ...tall.map(e => e._ascent + 8));++ height = above + Math.max(size * .35, ...tall.map(e => e._descent + 8));++ }+ const box = put(mk('rect', { rx: 10, fill: 'none', stroke: color, 'stroke-width': 3 }, p),- { o: 0, a_x: left - 8, a_y: y - size * .95, a_width: right - left + 16, a_height: size * 1.3 });++ { o: 0, a_x: left - 8, a_y: y - above, a_width: right - left + 16, a_height: height });+ run(box, { o: 1 }, t0, .3);+ run(box, { o: 0 }, t0 + 1.2, .3);+ const res = M(p, parts, { size, fill, o: 0, x: (left + right) / 2, y });+ for (let k = i; k <= j; k++) run(row[k], { o: 0, s: .6 }, t0 + .8, .35);+ run(res, { o: 1 }, t0 + .95, .35);+ const next = [...row.slice(0, i), res, ...row.slice(j + 1)];+ return layRow(next, row, e => run(e, { x: e._px }, t0 + 1.3, .5));+ }+ // Vertical number line at x; Yf maps a value to its y. Labels sit on the left.+ function vAxis(p, { x, Yf, lo, hi, step = 1, t0 = .1, unit = '' }) {+ draw(path(p, `M${x} ${Yf(lo - .5)}V${Yf(hi + .5)}`, { stroke: COL.chalk, 'stroke-width': 3 }, { d: 0 }), t0, .8);+ for (let v = lo; v <= hi; v += step) {+ const g = G(p, { o: 0 });+ path(g, `M${x - 9} ${Yf(v)}H${x + 9}`, { stroke: COL.dim, 'stroke-width': 2.5 });+ T(g, num(v) + unit, { x: x - 46, y: Yf(v) + 9, size: 24, fill: v === 0 ? COL.chalk : COL.dim, font: MATH, anchor: 'end' });+ show(g, t0 + .2 + Math.abs(v - lo) * .02);+ }+ }+ // Thermometer from lo (bottom) to hi (top). set(v, t0, run) moves the column; run = tw (lesson) or fx (answer).+ function thermometer(p, { x = 800, bottom = 600, top = 200, lo = -10, hi = 15, step = 5, value = 0, color = COL.nat } = {}) {+ const Yt = v => bottom - (v - lo) / (hi - lo) * (bottom - top), bulb = bottom + 32, g = G(p);+ mk('rect', { x: x - 18, y: top - 24, width: 36, height: bulb - top + 24, rx: 18, fill: COL.board, stroke: COL.dim, 'stroke-width': 2.5 }, g);+ mk('circle', { cx: x, cy: bulb, r: 26, fill: color }, g);+ const merc = put(mk('rect', { x: x - 9, width: 18, rx: 9, fill: color }, g), { a_y: Yt(value), a_height: bulb - Yt(value) });+ for (let v = lo; v <= hi; v += step) {+ path(g, `M${x - 30} ${Yt(v)}H${x - 18}`, { stroke: COL.dim, 'stroke-width': 2 });+ T(g, `${num(v)}°`, { x: x - 40, y: Yt(v) + 9, size: 24, fill: v === 0 ? COL.chalk : COL.dim, font: MATH, anchor: 'end' });+ }+ return { g, merc, Yt, set: (v, t0, run = tw, dur = 1.2) => run(merc, { a_y: Yt(v), a_height: bulb - Yt(v) }, t0, dur) };+ }+ /* ---------- fractions: rows with strikable parts, bars and brackets ---------- */+ // A row of fractions and symbols whose numerators and denominators can be struck out one by one.+ // items: { f: [n, d], fill } | 'symbol text'. The fraction bars sit on y.+ function fracRow(p, items, { x = 800, y = 300, size = 60, anchor = 'middle', o = 0 } = {}) {+ const fs = size * .8, g = G(p, { o });+ const els = items.map(it => {+ if (typeof it === 'string') {+ const w = textW(it, size);+ return { w, draw(cx) { this.cx = cx; T(g, it, { x: cx, y: y + size * .33, size, font: MATH, fill: COL.chalk, anchor: 'middle' }); } };+ }+ const [n, d] = it.f.map(String), w = Math.max(textW(n, fs), textW(d, fs)) + size * .35, fill = it.fill || COL.chalk;+ return { w, n, d, draw(cx) {+ this.cx = cx;+ path(g, `M${cx - w / 2 + 4} ${y}H${cx + w / 2 - 4}`, { stroke: fill, 'stroke-width': size * .055 });+ this.num = T(g, n, { x: cx, y: y - size * .18, size: fs, font: MATH, fill, anchor: 'middle' });+ this.den = T(g, d, { x: cx, y: y + size * .78, size: fs, font: MATH, fill, anchor: 'middle' });+ } };+ });+ const total = els.reduce((a, e) => a + e.w, 0);+ let cx = anchor === 'middle' ? x - total / 2 : x;+ for (const e of els) { e.draw(cx + e.w / 2); cx += e.w; }+ return Object.assign(els, { g, y, size, x0: anchor === 'middle' ? x - total / 2 : x, w: total });+ }+ // Strike the numerator ('num') or denominator ('den') of fraction k and write its reduced value beside it.+ function reduce(row, k, part, value, color, t0, run = tw) {+ const e = row[k], { y, size } = row, top = part === 'num';+ const cy = top ? y - size * .42 : y + size * .52, g = row.g;+ const slash = path(g, `M${e.cx - size * .28} ${cy + size * .3}L${e.cx + size * .28} ${cy - size * .3}`, { stroke: color, 'stroke-width': 3.5 }, { d: 0 });+ const nv = T(g, String(value), { x: e.cx + size * .02, y: top ? y - size * .92 : y + size * 1.36, size: size * .5, font: MATH, fill: color, anchor: 'middle', o: 0 });+ run(slash, { d: 1 }, t0, .4); run(nv, { o: 1 }, t0 + .3, .4);+ run(e[part], { o: .45 }, t0 + .3, .4);+ }+ function rect(p, x, y, w, h, fill, o = 0, stroke = 'none') {+ return put(mk('rect', { x, y, width: w, height: h, fill, stroke, 'stroke-width': 2.5 }, p), { o });+ }+ function bracketH(p, x1, x2, y, label, color, t0) {+ draw(path(p, `M${x1} ${y - 10}V${y}H${x2}V${y - 10}`, { stroke: color, 'stroke-width': 3 }, { d: 0 }), t0, .5);+ show(T(p, label, { x: (x1 + x2) / 2, y: y + 32, size: 26, fill: color, font: MATH, anchor: 'middle', o: 0 }), t0 + .3);+ }++ /* ---------- decimal point that hops between digits (ch10, ch20) ---------- */+ // Digits in evenly spaced slots with a decimal point that can hop between them.+ // places = digits after the point (0 = point at the far right, hidden).+ function pointRow(p, digits, x, y, places, { size = 72, fill = COL.chalk, sign = '' } = {}) {+ const g = G(p, { o: 0 }), w = size * .7, n = digits.length, x0 = x - n * w / 2;+ if (sign) T(g, sign, { x: x0 - w * .6, y, size, fill, font: MATH, anchor: 'middle' });+ const ds = [...digits].map((c, i) => T(g, c, { x: x0 + i * w + w / 2, y, size, fill, font: MATH, anchor: 'middle' }));+ const px = k => x0 + (n - k) * w;+ const dot = mk('circle', { r: size * .065, fill: COL.task }, g);+ put(dot, { x: px(places), y: y - size * .02, o: places ? 1 : 0 });+ const trail = path(g, '', { stroke: COL.task, 'stroke-width': 2.5, 'stroke-dasharray': '5 6' });+ return { g, ds, dot, px, w,+ hop(from, to, t0, run = tw, dur = .55) {+ const steps = Math.abs(to - from);+ run(dot, { o: 1 }, t0, .2);+ let d = '';+ for (let k = 0; k < steps; k++) {+ const a = px(from + Math.sign(to - from) * k), b = px(from + Math.sign(to - from) * (k + 1));+ d += `M${a} ${y - 10}Q${(a + b) / 2} ${y - size * .9} ${b} ${y - 10}`;+ }+ trail.setAttribute('d', d);+ put(trail, { o: 0 }); run(trail, { o: .9 }, t0 + steps * dur, .3);+ (run === tw ? prog : fxp)(q => {+ const s = q * steps, k = Math.min(steps - 1, Math.floor(s)), f = s - k;+ const a = px(from + Math.sign(to - from) * k), b = px(from + Math.sign(to - from) * (k + 1));+ put(dot, { x: a + (b - a) * f, y: y - size * .02 - Math.sin(Math.PI * f) * size * .7 });+ }, t0, steps * dur, lin);+ } };+ }++ /* ---------- balance scale for equations (ch24, ch25) ---------- */+ // A balance scale. Its pans hang from the beam ends; tilt(deg, t0) rocks it (positive: left side down).+ function balance(p, { x = 800, y = 330, L = 300 } = {}) {+ const g = G(p, { o: 0 });+ path(g, `M${x} ${y}L${x - 50} ${y + 330}H${x + 50}Z`, { stroke: COL.dim, 'stroke-width': 3, fill: mix(COL.board, COL.dim, .15) });+ const beam = G(g, { x, y });+ path(beam, `M${-L} 0H${L}`, { stroke: COL.chalk, 'stroke-width': 6 });+ mk('circle', { r: 10, fill: COL.chalk }, beam);+ const pan = side => {+ const pg = G(g, { x: x + side * L, y });+ path(pg, 'M0 0L-90 110M0 0L90 110', { stroke: COL.dim, 'stroke-width': 2 });+ path(pg, 'M-110 110Q0 150 110 110Z', { stroke: side < 0 ? COL.whole : COL.nat, 'stroke-width': 3, fill: mix(COL.board, side < 0 ? COL.whole : COL.nat, .2) });+ return pg;+ };+ const Lp = pan(-1), Rp = pan(1);+ let angle = 0;+ const place = a => {+ const r = a * Math.PI / 180, dx = L * Math.cos(r), dy = L * Math.sin(r);+ put(beam, { r: -a }); put(Lp, { x: x - dx, y: y + dy }); put(Rp, { x: x + dx, y: y - dy });+ };+ return {+ g, L: Lp, R: Rp,+ // Content sits on a pan: text or math at (0, 90) in pan coordinates.+ load(side, parts, color, t0, size = 44) { const e = M(side < 0 ? Lp : Rp, parts, { y: 96, size, fill: color, o: 0 }); show(e, t0); return e; },+ tilt(a, t0, run = prog) { const from = angle; angle = a; run(q => place(from + (a - from) * back(q)), t0, .9); },+ };+ }+ /* ---------- algebra tiles (ch23, ch25) ---------- */+ const XL = 120, UN = 30; // length of x, size of 1+ const TS = { x2: [XL, XL, COL.real], x: [UN, XL, COL.whole], y: [UN, 90, COL.nat], one: [UN, UN, COL.int] };+ function atile(p, kind, x, y, neg = false, o = 0) {+ const [w, h, c] = TS[kind], g = G(p, { x, y, o, s: o ? 1 : .6 });+ mk('rect', { x: -w / 2, y: -h / 2, width: w, height: h, rx: 5, fill: neg ? COL.board : mix(COL.board, c, .55), stroke: neg ? COL.bad : c, 'stroke-width': neg ? 3.5 : 2.5, 'stroke-dasharray': neg ? '7 5' : '' }, g);+ g.kind = kind; g.neg = neg;+ return g;+ }+ const popIn = (els, t0, step = .08) => els.forEach((e, i) => tw(e, { o: 1, s: 1 }, t0 + i * step, .35, back));+ // n tiles of a kind in a row starting at x.+ const tileRow = (p, kind, n, x, y, neg = false, gap = 12) => Array.from({ length: n }, (_, i) => atile(p, kind, x + i * (TS[kind][0] + gap), y, neg));+ // Pair each negative tile with a positive one: they move together and vanish.+ function cancel(pos, negs, t0) {+ negs.forEach((n, i) => {+ const a = pos[i];+ tw(n, { x: st(a).x, y: st(a).y }, t0 + i * .3, .6);+ tw(n, { o: 0, s: .5 }, t0 + i * .3 + .7, .3); tw(a, { o: 0, s: .5 }, t0 + i * .3 + .7, .3);+ });+ }+ /* ---------- inequality graphs (ch26, ch27) ---------- */+ // Solution ray on the number line: endpoint v, closed or open circle, dir +1 (right) or −1 (left).+ function ray(p, v, closed, dir, t0, color = COL.task, run = tw) {+ const end = X(dir > 0 ? 5.7 : -5.7), g = G(p, { o: 1 });+ const line = path(g, `M${X(v)} ${Y0}H${end}`, { stroke: color, 'stroke-width': 7 }, { d: 0 });+ const head = path(g, `M${end - 18 * dir} ${Y0 - 13}L${end} ${Y0}L${end - 18 * dir} ${Y0 + 13}`, { stroke: color, 'stroke-width': 6 }, { o: 0 });+ const dot = G(g, { x: X(v), y: Y0, s: 0, o: 0 });+ mk('circle', { r: 13, fill: closed ? color : COL.board, stroke: color, 'stroke-width': 4 }, dot);+ run(dot, { s: 1, o: 1 }, t0, .4, back);+ run(line, { d: 1 }, t0 + .3, .8); run(head, { o: 1 }, t0 + 1, .2);+ return g;+ }+ // Segment between a and b on the number line, each end open or closed.+ function segment(p, a, b, ca, cb, t0, color = COL.task, run = tw) {+ const g = G(p, { o: 1 });+ const line = path(g, `M${X(a)} ${Y0}H${X(b)}`, { stroke: color, 'stroke-width': 7 }, { d: 0 });+ const ends = [[a, ca], [b, cb]].map(([v, c]) => {+ const d = G(g, { x: X(v), y: Y0, s: 0, o: 0 });+ mk('circle', { r: 13, fill: c ? color : COL.board, stroke: color, 'stroke-width': 4 }, d);+ run(d, { s: 1, o: 1 }, t0, .4, back);+ return d;+ });+ run(line, { d: 1 }, t0 + .3, .8);+ g.parentNode.appendChild(g); ends.forEach(e => g.appendChild(e));+ return g;+ }+ /* ---------- equation steps (ch25 onward) ---------- */+ // One line of an equation or inequality with its sign at xEq, so a column of steps lines up. note: grey hint on the right.+ function eqLine(p, L, R, y, t0, { xEq = 760, fill = COL.chalk, size = 50, note, sym = '=', symFill, noteX = 1180 } = {}) {+ const g = G(p, { o: 0 });+ M(g, [].concat(L), { x: xEq - size * .6, y, size, fill, anchor: 'end' });+ M(g, [sym], { x: xEq, y, size, fill: symFill || fill });+ M(g, [].concat(R), { x: xEq + size * .6, y, size, fill, anchor: 'start' });+ if (note) T(g, note, { x: noteX, y: y - 8, size: 26, fill: COL.task, weight: 600 });+ show(g, t0);+ return g;+ }+ /* ---------- data on a number line: dot plots (unit 7) ---------- */+ // Axis for data from lo to hi drawn between x0 and x1 at baseline y; every: label every n-th tick.+ // shape 'x' draws line-plot crosses instead of dots.+ // Returns D: D.V(value) -> x; D.dot(v, color, t0) stacks a dot above v; D.mark(v, color, t0, label) is a+ // balance triangle under the axis that can slide with D.slide(mark, v, t0).+ function dataLine(p, { lo, hi, x0 = 200, x1 = 1400, y = 600, step = 1, every = 1, t0 = .1, r = 13, size = 22, shape = 'dot' }) {+ const V = v => x0 + (v - lo) / (hi - lo) * (x1 - x0), g = G(p, { o: 0 });+ path(g, `M${x0 - 24} ${y}H${x1 + 24}`, { stroke: COL.dim, 'stroke-width': 3 });+ for (let v = lo, i = 0; v <= hi + 1e-9; v += step, i++) {+ path(g, `M${V(v)} ${y - 7}V${y + 7}`, { stroke: COL.dim, 'stroke-width': 2 });+ if (i % every === 0) T(g, num(+v.toFixed(6)), { x: V(v), y: y + 26 + size, size, fill: COL.dim, font: MATH, anchor: 'middle' });+ }+ show(g, t0);+ const D = {+ g, V, y, r, count: {},+ top: v => y - 6 - r - ((D.count[v] || 1) - 1) * (2 * r + 5),+ dot(v, color, t0, { run = tw, into = p, from } = {}) {+ D.count[v] = (D.count[v] || 0) + 1;+ let d;+ if (shape === 'x') { d = G(into); path(d, `M${-r * .75} ${-r * .75}L${r * .75} ${r * .75}M${r * .75} ${-r * .75}L${-r * .75} ${r * .75}`, { stroke: color, 'stroke-width': 5 }); }+ else d = mk('circle', { r, fill: color, stroke: COL.board, 'stroke-width': 2 }, into);+ put(d, { x: V(v), y: D.top(v), s: 0, o: 0 });+ if (from !== undefined) { put(d, { y: from, s: 1 }); run(d, { o: 1 }, t0, .2); run(d, { y: D.top(v) }, t0, .7, back); }+ else run(d, { s: 1, o: 1 }, t0, .45, back);+ return d;+ },+ dots: (vals, color, t0, gap = .15, opts) => vals.map((v, i) => D.dot(v, color, t0 + i * gap, opts)),+ mark(v, color, t0, label, { run = tw, into = p } = {}) {+ const m = G(into, { x: V(v), y, o: 0 });+ path(m, 'M0 4L-17 30H17Z', { fill: color, stroke: COL.board, 'stroke-width': 2 });+ if (label) T(m, label, { y: 64 + size, size: 24, fill: color, weight: 600, anchor: 'middle' });+ run(m, { o: 1 }, t0, .4);+ return m;+ },+ slide: (m, v, t0, run = tw, dur = 1.2) => run(m, { x: V(v) }, t0, dur),+ // Bracket above the data from a to b at height yb, with a label.+ span(a, b, yb, label, color, t0, { run = tw, into = p } = {}) {+ const g = G(into), l = path(g, `M${V(a)} ${yb + 12}V${yb}H${V(b)}V${yb + 12}`, { stroke: color, 'stroke-width': 3 }, { d: 0 });+ run(l, { d: 1 }, t0, .6);+ const t = M(g, [label], { x: (V(a) + V(b)) / 2, y: yb - 14, size: 28, fill: color, o: 0 });+ run(t, { o: 1 }, t0 + .4, .4);+ return g;+ },+ };+ return D;+ }+ /* ---------- chance: number cubes, coins, spinners (unit 7) ---------- */+ // A number cube face showing n pips, centred on (x, y).+ const PIPS = { 1: [[0, 0]], 2: [[-1, -1], [1, 1]], 3: [[-1, -1], [0, 0], [1, 1]], 4: [[-1, -1], [1, -1], [-1, 1], [1, 1]],+ 5: [[-1, -1], [1, -1], [0, 0], [-1, 1], [1, 1]], 6: [[-1, -1], [1, -1], [-1, 0], [1, 0], [-1, 1], [1, 1]] };+ function die(p, n, x, y, s = 96, o = 0) {+ const g = G(p, { x, y, o, s: o ? 1 : .6 });+ g._box = mk('rect', { x: -s / 2, y: -s / 2, width: s, height: s, rx: s * .18, fill: mix(COL.board, COL.chalk, .1), stroke: COL.chalk, 'stroke-width': 3 }, g);+ PIPS[n].forEach(([a, b]) => mk('circle', { cx: a * s * .26, cy: b * s * .26, r: s * .085, fill: COL.chalk }, g));+ return g;+ }+ // Spinner with equal sections; pointer starts straight up. land(k) is the rotation that points at section k.+ const SPIN = [COL.whole, COL.nat, COL.int, COL.whole, COL.irr, COL.nat, COL.whole, COL.int];+ function spinner(p, cx, cy, r, t0, cols = SPIN) {+ const g = G(p, { x: cx, y: cy, o: 0 }), n = cols.length, secs = [];+ cols.forEach((c, i) => {+ const a1 = (-90 + i * 360 / n) * Math.PI / 180, a2 = (-90 + (i + 1) * 360 / n) * Math.PI / 180;+ secs.push(path(g, `M0 0L${r * Math.cos(a1)} ${r * Math.sin(a1)}A${r} ${r} 0 0 1 ${r * Math.cos(a2)} ${r * Math.sin(a2)}Z`,+ { fill: mix(COL.board, c, .7), stroke: COL.board, 'stroke-width': 3 }));+ });+ mk('circle', { r, fill: 'none', stroke: COL.chalk, 'stroke-width': 3 }, g);+ const ptr = G(g);+ path(ptr, `M0 ${r * .12}V${-r * .78}M-14 ${-r * .66}L0 ${-r * .8}L14 ${-r * .66}`, { stroke: COL.chalk, 'stroke-width': 7 });+ mk('circle', { r: 12, fill: COL.chalk }, g);+ show(g, t0);+ return { g, secs, ptr, land: k => (k + .5) * 360 / n };+ }+ // Outline some spinner sections: a bright border that fades in.+ function outline(p, sp, ks, color, t0, run = tw) {+ return ks.map(k => { const e = sp.secs[k].cloneNode(); e.setAttribute('fill', 'none'); e.setAttribute('stroke', color); e.setAttribute('stroke-width', 7); sp.g.insertBefore(e, sp.ptr); put(e, { o: 0 }); run(e, { o: 1 }, t0, .4); return e; });+ }+ // A coin face.+ function coin(p, side, x, y, t0, r = 34, run = tw) {+ const g = G(p, { x, y, s: .5, o: 0 });+ mk('circle', { r, fill: mix(COL.board, side === 'H' ? COL.int : COL.rat, .5), stroke: side === 'H' ? COL.int : COL.rat, 'stroke-width': 3 }, g);+ T(g, side, { y: r * .36, size: r, fill: COL.chalk, weight: 700, anchor: 'middle' });+ run(g, { s: 1, o: 1 }, t0, .45, back);+ return g;+ }+ /* ---------- scaled axes for data and real-world graphs (ch41 onward) ---------- */+ // Axes with a scale on each; returns value -> pixel maps. ybreak draws a zigzag when y does not start at 0.+ function axes(p, { x0, y0, w, h, xs: [xlo, xhi, xst], ys: [ylo, yhi, yst], xl, yl, t0, ybreak }) {+ const PX = v => x0 + (v - xlo) / (xhi - xlo) * w, PY = v => y0 - (v - ylo) / (yhi - ylo) * h, g = G(p, { o: 0 });+ let d = '';+ for (let v = xlo + xst; v <= xhi + 1e-9; v += xst) d += `M${PX(v)} ${y0}V${y0 - h}`;+ for (let v = ylo + yst; v <= yhi + 1e-9; v += yst) d += `M${x0} ${PY(v)}H${x0 + w}`;+ mk('path', { d, stroke: COL.chalk, 'stroke-opacity': .1, 'stroke-width': 1.5, fill: 'none' }, g);+ path(g, `M${x0} ${y0 - h - 20}V${y0}H${x0 + w + 20}`, { stroke: COL.chalk, 'stroke-width': 3 });+ if (ybreak) path(g, `M${x0 - 10} ${y0 - 22}L${x0 + 10} ${y0 - 30}M${x0 - 10} ${y0 - 34}L${x0 + 10} ${y0 - 42}`, { stroke: COL.chalk, 'stroke-width': 3 });+ for (let v = xlo; v <= xhi + 1e-9; v += xst) T(g, String(v), { x: PX(v), y: y0 + 30, size: 20, fill: COL.dim, font: MATH, anchor: 'middle' });+ for (let v = ylo; v <= yhi + 1e-9; v += yst) T(g, String(v), { x: x0 - 14, y: PY(v) + 7, size: 20, fill: COL.dim, font: MATH, anchor: 'end' });+ T(g, xl, { x: x0 + w / 2, y: y0 + 66, size: 24, fill: COL.dim, anchor: 'middle' });+ T(g, yl, { x: x0, y: y0 - h - 36, size: 24, fill: COL.dim, anchor: 'middle' });+ show(g, t0);+ return { PX, PY };+ }+ /* ---------- area grids for multiplying and factoring polynomials (ch51 onward) ---------- */+ // Area grid from (x0, y0): column widths ws, row heights hs, factor terms along the top and the left side.+ function areaGrid(p, x0, y0, ws, hs, colLab, rowLab, t0, { size = 40 } = {}) {+ const xs = [x0], ys = [y0];+ ws.forEach(w => xs.push(xs.at(-1) + w)); hs.forEach(h => ys.push(ys.at(-1) + h));+ let d = '';+ xs.forEach(x => { d += `M${x} ${y0}V${ys.at(-1)}`; }); ys.forEach(y => { d += `M${x0} ${y}H${xs.at(-1)}`; });+ draw(path(p, d, { stroke: COL.chalk, 'stroke-width': 3 }, { d: 0 }), t0, .9);+ colLab.forEach((l, j) => show(M(p, [].concat(l), { x: (xs[j] + xs[j + 1]) / 2, y: y0 - 22, size, fill: COL.whole, o: 0 }), t0 + .3 + j * .15));+ rowLab.forEach((l, i) => show(M(p, [].concat(l), { x: x0 - 24, y: (ys[i] + ys[i + 1]) / 2 + size * .35, size, fill: COL.nat, anchor: 'end', o: 0 }), t0 + .3 + i * .15));+ const box = (i, j, pad) => ({ x: xs[j] + pad, y: ys[i] + pad, width: xs[j + 1] - xs[j] - 2 * pad, height: ys[i + 1] - ys[i] - 2 * pad });+ return {+ xs, ys,+ cell(i, j, parts, t0, { fill = COL.chalk, tint, run = tw, into = p } = {}) {+ if (tint) { const r = put(mk('rect', { ...box(i, j, 3), fill: tint }, into), { o: 0 }); into.insertBefore(r, into.firstChild); run(r, { o: .3 }, t0, .4); }+ const e = M(into, [].concat(parts), { x: (xs[j] + xs[j + 1]) / 2, y: (ys[i] + ys[i + 1]) / 2 + size * .35, size, fill, o: 0, s: .6 });+ run(e, { o: 1, s: 1 }, t0, .4, back);+ return e;+ },+ ring(i, j, color, t0, run = tw, into = p) { const r = put(mk('rect', { ...box(i, j, 8), rx: 12, fill: 'none', stroke: color, 'stroke-width': 4.5 }, into), { o: 0 }); run(r, { o: 1 }, t0, .3); return r; },+ };+ }+ // A curved arrow from (x1, y1) to (x2, y2) bending up (h < 0) or down (h > 0).+ function arc(p, x1, y1, x2, y2, h, color, t0, run = tw) {+ const mx = (x1 + x2) / 2, l = path(p, `M${x1} ${y1}Q${mx} ${y1 + h} ${x2} ${y2}`, { stroke: color, 'stroke-width': 3.5 }, { d: 0 });+ run(l, { d: 1 }, t0, .5);+ return l;+ }++ /* ---------- built-up fractions with math above and below the bar (ch60 onward) ---------- */+ // Width of math parts at a size, without leaving anything on the stage.+ function mathW(parts, size) { const e = M(scene, [].concat(parts), { size, o: 0 }), w = e._w; e.remove(); return w; }+ // A built-up fraction whose top and bottom are math parts (they may hold radicals); bar on y. Returns { g, w, t, b, x0 }.+ function frac(p, top, bot, x, y, t0, { size = 56, fill = COL.chalk, anchor = 'start', topFill, botFill } = {}) {+ const g = G(p, { o: 0 });+ const w = Math.max(mathW(top, size), mathW(bot, size)) + size * .3;+ const x0 = anchor === 'middle' ? x - w / 2 : x;+ const t = M(g, [].concat(top), { x: x0 + w / 2, y: y - size * .25, size, fill: topFill || fill });+ const b = M(g, [].concat(bot), { x: x0 + w / 2, y: y + size * 1.05, size, fill: botFill || fill });+ path(g, `M${x0} ${y}H${x0 + w}`, { stroke: fill, 'stroke-width': size * .05 });+ if (t0 !== undefined) show(g, t0);+ return { g, w, t, b, x0 };+ }++ /* ---------- coordinate plane (unit 6 onward) ---------- */+ // Grid centred on the origin at (cx, cy); u pixels per unit; x from x0 to x1, y from y0 to y1.+ // Returns { g, PX, PY, u, ... } with helpers to plot points, walk to a point, and draw lines.+ // The grid stays in p; marks go into P.layer (set it to the current panel so marks clear with the step) or opts.into.+ function plane(p, { cx = 800, cy = 450, u = 50, x0 = -6, x1 = 6, y0 = -6, y1 = 6, t0 = .1, labels = true, step = 1 } = {}) {+ const PX = x => cx + x * u, PY = y => cy - y * u, g = G(p, { o: 0 });+ let d = '';+ for (let x = x0; x <= x1; x++) if (x) d += `M${PX(x)} ${PY(y0)}V${PY(y1)}`;+ for (let y = y0; y <= y1; y++) if (y) d += `M${PX(x0)} ${PY(y)}H${PX(x1)}`;+ mk('path', { d, stroke: COL.chalk, 'stroke-opacity': .1, 'stroke-width': 1.5, fill: 'none' }, g);+ const ax = { stroke: COL.chalk, 'stroke-width': 3 };+ path(g, `M${PX(x0 - .5)} ${cy}H${PX(x1 + .5)}M${PX(x1 + .5) - 14} ${cy - 9}L${PX(x1 + .5)} ${cy}L${PX(x1 + .5) - 14} ${cy + 9}`, ax);+ path(g, `M${cx} ${PY(y0 - .5)}V${PY(y1 + .5)}M${cx - 9} ${PY(y1 + .5) + 14}L${cx} ${PY(y1 + .5)}L${cx + 9} ${PY(y1 + .5) + 14}`, ax);+ T(g, 'x', { x: PX(x1 + .5) + 10, y: cy + 30, size: 28, fill: COL.dim, font: MATH, anchor: 'middle' }).setAttribute('font-style', 'italic');+ T(g, 'y', { x: cx - 26, y: PY(y1 + .5) + 10, size: 28, fill: COL.dim, font: MATH, anchor: 'middle' }).setAttribute('font-style', 'italic');+ if (labels) {+ for (let x = x0; x <= x1; x += step) if (x) T(g, num(x), { x: PX(x), y: cy + 26, size: 18, fill: COL.dim, font: MATH, anchor: 'middle' });+ for (let y = y0; y <= y1; y += step) if (y) T(g, num(y), { x: cx - 12, y: PY(y) + 6, size: 18, fill: COL.dim, font: MATH, anchor: 'end' });+ }+ show(g, t0, .5);+ const P = {+ g, PX, PY, u, cx, cy, x0, x1, y0, y1, layer: null,+ dot(x, y, color, t0, { r = 10, label, run = tw, dx = 14, dy = -14, anchor = 'start', into = P.layer || p, open = false } = {}) {+ const d = G(into, { x: PX(x), y: PY(y), s: 0, o: 0 });+ mk('circle', open ? { r, fill: COL.board, stroke: color, 'stroke-width': 3.5 } : { r, fill: color, stroke: COL.board, 'stroke-width': 2 }, d);+ run(d, { s: 1, o: 1 }, t0, .4, back);+ if (label) { const l = M(into, [label], { x: PX(x) + dx, y: PY(y) + dy, size: 26, fill: color, anchor, o: 0 }); run(l, { o: 1 }, t0 + .2, .3); }+ return d;+ },+ // Walk from the origin: along x, then along y, drawing arrows; then a dot.+ walk(x, y, t0, { cx: colX = COL.whole, cy: colY = COL.nat, run = tw, color = COL.task, label, into = P.layer || p } = {}) {+ const a = path(into, `M${PX(0)} ${PY(0)}H${PX(x)}`, { stroke: colX, 'stroke-width': 5 }, { d: 0 });+ const b = path(into, `M${PX(x)} ${PY(0)}V${PY(y)}`, { stroke: colY, 'stroke-width': 5 }, { d: 0 });+ run(a, { d: 1 }, t0, .3 + Math.abs(x) * .12, lin);+ run(b, { d: 1 }, t0 + .4 + Math.abs(x) * .12, .3 + Math.abs(y) * .12, lin);+ return P.dot(x, y, color, t0 + .8 + (Math.abs(x) + Math.abs(y)) * .12, { run, label, into });+ },+ // Arrow from (xa, ya) to (xb, yb) with an optional label beside its middle.+ arrow(xa, ya, xb, yb, color, t0, { label, run = tw, into = P.layer || p } = {}) {+ const a = [PX(xa), PY(ya)], b = [PX(xb), PY(yb)], L = Math.hypot(b[0] - a[0], b[1] - a[1]), ux = (b[0] - a[0]) / L, uy = (b[1] - a[1]) / L;+ const l = path(into, `M${a[0]} ${a[1]}L${b[0]} ${b[1]}M${b[0] - 12 * ux - 8 * uy} ${b[1] - 12 * uy + 8 * ux}L${b[0]} ${b[1]}L${b[0] - 12 * ux + 8 * uy} ${b[1] - 12 * uy - 8 * ux}`, { stroke: color, 'stroke-width': 4 }, { d: 0 });+ run(l, { d: 1 }, t0, .5);+ if (label !== undefined) {+ const vert = Math.abs(uy) > Math.abs(ux);+ const t = M(into, [label], { x: (a[0] + b[0]) / 2 + (vert ? -24 : 0), y: (a[1] + b[1]) / 2 + (vert ? 9 : -12), size: 26, fill: color, anchor: vert ? 'end' : 'middle', o: 0 });+ run(t, { o: 1 }, t0 + .3, .3);+ }+ return l;+ },+ // One slope step from (x, y): rise first (irr green), then run (real violet).+ stair(x, y, rise, runX, t0, { run = tw, into = P.layer || p, labels = true } = {}) {+ P.arrow(x, y, x, y + rise, COL.irr, t0, { label: labels ? num(rise) : undefined, run, into });+ P.arrow(x, y + rise, x + runX, y + rise, COL.real, t0 + .6, { label: labels ? num(runX) : undefined, run, into });+ },+ // Shade the region where every a·x + b·y ≥ c in the list holds, clipped to the grid.+ region(list, color, t0, { run = tw, into = P.layer || p, o = .22 } = {}) {+ let pts = [[x0, y0], [x1, y0], [x1, y1], [x0, y1]];+ for (const [a, b, c] of list) {+ const f = ([x, y]) => a * x + b * y - c, next = [];+ pts.forEach((v, i) => {+ const w = pts[(i + 1) % pts.length], fv = f(v), fw = f(w);+ if (fv >= 0) next.push(v);+ if (fv * fw < 0) { const t = fv / (fv - fw); next.push([v[0] + t * (w[0] - v[0]), v[1] + t * (w[1] - v[1])]); }+ });+ pts = next;+ }+ const e = path(into, pts.length ? 'M' + pts.map(([x, y]) => `${PX(x)} ${PY(y)}`).join('L') + 'Z' : '', { fill: color, stroke: 'none' }, { o: 0 });+ into.insertBefore(e, into.firstChild);+ run(e, { o }, t0, .6);+ return e;+ },+ half: (a, b, c, color, t0, opts) => P.region([[a, b, c]], color, t0, opts),+ // Graph of y = f(x) for x from xa to xb, drawn on; the part outside the grid's y range is cut off.+ fn(f, xa, xb, color, t0, { run = tw, w = 4, into = P.layer || p, n = 160, dur = 1.2 } = {}) {+ let d = '', pen = false;+ for (let i = 0; i <= n; i++) {+ const x = xa + (xb - xa) * i / n, y = f(x), inside = y >= y0 - .5 && y <= y1 + .5;+ if (inside) { d += `${pen ? 'L' : 'M'}${PX(x).toFixed(1)} ${PY(y).toFixed(1)}`; pen = true; } else pen = false;+ }+ const l = path(into, d, { stroke: color, 'stroke-width': w }, { d: 0 });+ run(l, { d: 1 }, t0, dur);+ return l;+ },+ // Line through two points, extended to the edge of the grid.+ line(xa, ya, xb, yb, color, t0, { run = tw, w = 4, dash, into = P.layer || p } = {}) {+ const dx = xb - xa, dy = yb - ya, ts = [];+ const clip = (t, v, lo, hi) => { if (v >= lo - 1e-9 && v <= hi + 1e-9) ts.push(t); };+ if (dx) { for (const X of [x0, x1]) { const t = (X - xa) / dx; clip(t, ya + t * dy, y0, y1); } }+ if (dy) { for (const Y of [y0, y1]) { const t = (Y - ya) / dy; clip(t, xa + t * dx, x0, x1); } }+ const t1 = Math.min(...ts), t2 = Math.max(...ts);+ // A dashed line fades in: drawing it on would need the dash array for the reveal.+ const l = path(into, `M${PX(xa + t1 * dx)} ${PY(ya + t1 * dy)}L${PX(xa + t2 * dx)} ${PY(ya + t2 * dy)}`, { stroke: color, 'stroke-width': w, ...(dash ? { 'stroke-dasharray': dash } : {}) }, dash ? { o: 0 } : { d: 0 });+ run(l, dash ? { o: 1 } : { d: 1 }, t0, dash ? .6 : 1);+ return l;+ },+ };+ return P;+ }+ // Question: pick a grid point. ans = [x, y]; no(x, y) explains a wrong pick. Arrows move a cursor, Enter picks.+ // test(x, y), when given, accepts any point it approves; ans is then the point Show answer uses.+ const pickPoint = (P, ans, yes, no, onRight, test) => (body, api) => {+ const L = qlayer();+ let cur = [0, 0], locked = false;+ const cursor = G(L, { x: P.PX(0), y: P.PY(0) });+ mk('circle', { r: 16, fill: 'none', stroke: COL.task, 'stroke-width': 3 }, cursor);+ let tag = null;+ const moveTo = (x, y) => {+ cur = [Math.max(P.x0, Math.min(P.x1, x)), Math.max(P.y0, Math.min(P.y1, y))];+ put(cursor, { x: P.PX(cur[0]), y: P.PY(cur[1]) });+ tag?.remove();+ tag = M(L, [`(${num(cur[0])}, ${num(cur[1])})`], { x: P.PX(cur[0]) + 22, y: P.PY(cur[1]) - 18, size: 24, fill: COL.task, anchor: 'start' });+ };+ moveTo(0, 0);+ const pick = () => {+ if (locked) return;+ const [x, y] = cur;+ if (test ? test(x, y) : x === ans[0] && y === ans[1]) { P.dot(x, y, COL.good, 0, { run: fx, into: L }); onRight?.(); api.grade(true, typeof yes === 'function' ? yes(x, y) : yes); }+ else { const d = P.dot(x, y, COL.bad, 0, { run: fx, r: 8, into: L }); fx(d, { o: 0 }, 1.2, .4); shakeFx(cursor); api.grade(false, no(x, y)); }+ };+ const hit = mk('rect', { x: P.PX(P.x0 - .5), y: P.PY(P.y1 + .5), width: (P.x1 - P.x0 + 1) * P.u, height: (P.y1 - P.y0 + 1) * P.u, fill: 'transparent' }, L);+ L.insertBefore(hit, L.firstChild);+ hit.style.cursor = 'crosshair';+ hit.addEventListener('click', e => {+ if (locked) return;+ const s = $('stage'), pt = s.createSVGPoint(); pt.x = e.clientX; pt.y = e.clientY;+ const q = pt.matrixTransform(s.getScreenCTM().inverse());+ moveTo(Math.round((q.x - P.cx) / P.u), Math.round((P.cy - q.y) / P.u));+ pick();+ });+ return {+ reveal() { moveTo(...ans); P.dot(ans[0], ans[1], COL.good, 0, { run: fx, into: L }); onRight?.(); return typeof yes === 'function' ? yes(...ans) : yes; },+ lock() { locked = true; },+ hint: [kbd('←'), kbd('↑'), kbd('↓'), kbd('→'), ' move, ', kbd('Enter'), ' choose, or click the grid'],+ key(e) {+ if (locked) return false;+ const d = { ArrowLeft: [-1, 0], ArrowRight: [1, 0], ArrowUp: [0, 1], ArrowDown: [0, -1] }[e.key];+ if (d) { moveTo(cur[0] + d[0], cur[1] + d[1]); return true; }+ if (e.key === 'Enter') { pick(); return true; }+ return false;+ },+ };+ };+ /* ---------- signed numbers: number-line moves and plus/minus tiles ---------- */+ const POS = COL.whole, NEG = COL.nat; // positive: blue, negative: coral+ // Integer number line from lo to hi with arrows at both ends, drawn into S.line.+ function numberLine(t0 = .1, lo = -8, hi = 8) {+ const L = S.line;+ draw(path(L, `M${X(lo - .7)} ${Y0}H${X(hi + .7)}`, { stroke: COL.chalk, 'stroke-width': 3 }, { d: 0 }), t0, .8);+ for (const [x, d] of [[X(hi + .7), 1], [X(lo - .7), -1]]) {+ show(path(L, `M${x - 15 * d} ${Y0 - 10}L${x} ${Y0}L${x - 15 * d} ${Y0 + 10}`, { stroke: COL.chalk, 'stroke-width': 3 }, { o: 0 }), t0 + .7, .3);+ }+ for (let v = lo; v <= hi; v++) show(tick(v), t0 + .2 + Math.abs(v) * .04, .4);+ }+ // A move along the number line from a to b, drawn as an arrow at height y. run = tw (lesson) or fx (answer).+ function move(p, a, b, y, t0, run = tw) {+ const x1 = X(a), x2 = X(b), d = Math.sign(b - a), color = d > 0 ? POS : NEG;+ const dur = .35 + Math.abs(b - a) * .09;+ const line = path(p, `M${x1} ${y}H${x2}`, { stroke: color, 'stroke-width': 5 }, { d: 0 });+ const head = path(p, `M${x2 - 15 * d} ${y - 11}L${x2} ${y}L${x2 - 15 * d} ${y + 11}`, { stroke: color, 'stroke-width': 5 }, { o: 0 });+ const lab = T(p, (d > 0 ? '+' : '−') + Math.abs(b - a), { x: (x1 + x2) / 2, y: y - 16, size: 28, fill: color, font: MATH, anchor: 'middle', o: 0 });+ const drop = path(p, `M${x2} ${y + 12}V${Y0 - 14}`, { stroke: color, 'stroke-width': 2, 'stroke-dasharray': '5 6' }, { o: 0 });+ run(line, { d: 1 }, t0, dur, lin); run(head, { o: 1 }, t0 + dur - .1, .15);+ run(lab, { o: 1 }, t0 + .2, .3); run(drop, { o: .8 }, t0 + dur, .3);+ }+ function landDot(p, v, t0, color = COL.chalk, run = tw) {+ const g = G(p, { x: X(v), y: Y0, s: 0, o: 0 });+ mk('circle', { r: 12, fill: color, stroke: COL.board, 'stroke-width': 2 }, g);+ run(g, { s: 1, o: 1 }, t0, .45, back);+ return g;+ }+ function tile(p, sign, x, y, o = 0) {+ const c = sign > 0 ? POS : NEG, g = G(p, { x, y, o, s: o ? 1 : .6 });+ mk('rect', { x: -27, y: -27, width: 54, height: 54, rx: 10, fill: mix(COL.board, c, .45), stroke: c, 'stroke-width': 2.5 }, g);+ M(g, [sign > 0 ? '+' : '−'], { y: 13, size: 40 });+ return g;+ }+ const tiles = (p, n, sign, x0, y, gap = 70) => Array.from({ length: n }, (_, i) => tile(p, sign, x0 + i * gap, y));+ const popAll = (els, t0, step = .08) => els.forEach((e, i) => tw(e, { o: 1, s: 1 }, t0 + i * step, .35, back));+ // Circle each plus/minus pair, then let the pairs vanish: they make zero.+ function cancelPairs(p, tops, bottoms, t0) {+ tops.forEach((a, i) => {+ const b = bottoms[i], x = st(a).x, y1 = st(a).y, y2 = st(b).y;+ const ring = put(mk('rect', { rx: 18, fill: 'none', stroke: COL.dim, 'stroke-width': 2.5, 'stroke-dasharray': '8 6' }, p),+ { o: 0, a_x: x - 38, a_y: y1 - 38, a_width: 76, a_height: y2 - y1 + 76 });+ tw(ring, { o: 1 }, t0 + i * .2, .3);+ for (const e of [a, b, ring]) tw(e, { o: 0, ...(e === ring ? {} : { s: .5 }) }, t0 + 1.4 + i * .1, .4);+ });+ }+ function brace(p, a, b, y, label, color, t0) {+ const x1 = X(a), x2 = X(b);+ draw(path(p, `M${x1} ${y - 10}V${y}H${x2}V${y - 10}`, { stroke: color, 'stroke-width': 3 }, { d: 0 }), t0, .6);+ show(T(p, label, { x: (x1 + x2) / 2, y: y + 34, size: 26, fill: color, anchor: 'middle', o: 0 }), t0 + .4);+ }++ // Inline math for HTML text.+ function mathEl(parts, size = 22) {+ const svg = mk('svg', { class: 'm', 'font-weight': 400 }); // widths are measured at normal weight, so a bold prompt must not thicken the math+ const m = M(svg, parts, { size, anchor: 'start', fill: 'currentColor' });- const top = size * 1.05, h = size * 1.5;++ let top = size * 1.05, bottom = size * .45, h = size * 1.5;++ if (m._ascent) { // a TeX formula may reach higher and lower than text++ top = Math.max(top, m._ascent + size * .1);++ bottom = Math.max(bottom, m._descent + size * .1);++ h = top + bottom;++ }+ svg.setAttribute('viewBox', `0 ${-top} ${m._w + 2} ${h}`);+ svg.setAttribute('width', m._w + 2);+ svg.setAttribute('height', h);- svg.style.verticalAlign = `${-size * .45}px`; // line up the math baseline with the text baseline++ svg.style.verticalAlign = `${-bottom}px`; // line up the math baseline with the text baseline+ return svg;+ }++ /* ---------- number map geometry ---------- */+ const RINGS = {+ real: { cx: 640, cy: 470, rx: 610, ry: 390, lx: 640, ly: 128 },+ rat: { cx: 500, cy: 480, rx: 400, ry: 320, lx: 500, ly: 202 },+ int: { cx: 500, cy: 510, rx: 300, ry: 250, lx: 500, ly: 302 },+ whole: { cx: 500, cy: 540, rx: 210, ry: 180, lx: 500, ly: 400 },+ nat: { cx: 500, cy: 570, rx: 125, ry: 110, lx: 500, ly: 500 },+ irr: { cx: 1060, cy: 480, rx: 140, ry: 170, lx: 1060, ly: 360 },+ };+ const CHAIN = { nat: ['nat', 'whole', 'int', 'rat', 'real'], whole: ['whole', 'int', 'rat', 'real'], int: ['int', 'rat', 'real'], rat: ['rat', 'real'], irr: ['irr', 'real'], real: ['real'] };+ const ell = r => `M${r.cx} ${r.cy - r.ry}A${r.rx} ${r.ry} 0 1 1 ${r.cx} ${r.cy + r.ry}A${r.rx} ${r.ry} 0 1 1 ${r.cx} ${r.cy - r.ry}`;+ const inRing = (k, x, y) => { const r = RINGS[k]; return ((x - r.cx) / r.rx) ** 2 + ((y - r.cy) / r.ry) ** 2 <= 1; };+ function regionAt(x, y) {+ for (const k of ['nat', 'whole', 'int', 'rat', 'irr', 'real']) if (inRing(k, x, y)) return k;+ return null;+ }+ function buildVenn(parent, hidden) {+ const out = {};+ for (const k of ['real', 'rat', 'int', 'whole', 'nat', 'irr']) {+ const r = RINGS[k], g = G(parent);+ const fill = path(g, ell(r), { fill: mix(COL.board, COL[k], k === 'real' ? .1 : .16), stroke: 'none' }, { o: hidden ? 0 : 1 });+ const stroke = path(g, ell(r), { stroke: COL[k], 'stroke-width': 3 }, hidden ? { d: 0, 'a_stroke-width': 3 } : { 'a_stroke-width': 3 });+ const lab = T(g, NAME[k], { x: r.lx, y: r.ly, size: 26, fill: COL[k], weight: 600, anchor: 'middle', o: hidden ? 0 : 1 });+ out[k] = { g, fill, stroke, lab };+ }+ return out;+ }++ /* ---------- timeline ---------- */+ let TW = [];+ const io = p => p < .5 ? 4 * p * p * p : 1 - (-2 * p + 2) ** 3 / 2;+ const out = p => 1 - (1 - p) ** 3;+ const back = p => 1 + 2.2 * (p - 1) ** 3 + 1.2 * (p - 1) ** 2;+ const lin = p => p;+ function tw(e, to, t0, dur = .6, ease = io) { TW.push({ e, to, t0, dur, ease }); }+ function prog(pf, t0, dur, ease = io) { TW.push({ pf, t0, dur, ease }); }+ const show = (e, t0, dur = .5) => tw(e, { o: 1 }, t0, dur);+ const hide = (e, t0, dur = .5) => tw(e, { o: 0 }, t0, dur);+ const draw = (e, t0, dur = .9) => tw(e, { d: 1 }, t0, dur);+ const pop = (e, t0) => tw(e, { s: 1, o: 1 }, t0, .45, back);+ function pulse(e, t0, k = 1.7) { tw(e, { s: k }, t0, .22, out); tw(e, { s: 1 }, t0 + .22, .4); }+ function glow(key, t0) {+ const s = S.ring[key].stroke;+ tw(s, { 'a_stroke-width': 9 }, t0, .22, out); tw(s, { 'a_stroke-width': 3 }, t0 + .25, .5);+ }+ function glowRun(key, t0) { CHAIN[key].forEach((k, i) => glow(k, t0 + i * .3)); }+ function stream(t, str, t0, dur) { prog(q => { t.textContent = str.slice(0, Math.round(q * str.length)); }, t0, dur, lin); }+ function mix(a, b, q) {+ const h = c => [1, 3, 5].map(i => parseInt(c.slice(i, i + 2), 16));+ const A = h(a), B = h(b);+ return '#' + A.map((v, i) => Math.round(v + (B[i] - v) * q).toString(16).padStart(2, '0')).join('');+ }+ // A colour or attribute tween with no starting value in the state starts from the element's attribute.+ const fromAttr = (e, k) => k.startsWith('c_') ? e.getAttribute(k.slice(2)) : k.startsWith('a_') ? parseFloat(e.getAttribute(k.slice(2))) : undefined;+ function evalTo(t, list = TW) {+ for (const w of list) {+ if (w.done || t < w.t0) continue;+ if (!w.go) { w.go = 1; if (w.e) { const s = st(w.e); w.from = {}; for (const k in w.to) w.from[k] = s[k] ?? fromAttr(w.e, k); } }+ const p = w.dur ? Math.min(1, (t - w.t0) / w.dur) : 1, q = w.ease(p);+ if (w.e) {+ const s = st(w.e);+ for (const k in w.to) s[k] = k.startsWith('c_') ? mix(w.from[k], w.to[k], q) : w.from[k] + (w.to[k] - w.from[k]) * q;+ render(w.e);+ } else w.pf(q);+ if (p >= 1) w.done = 1;+ }+ }++ /* ---------- world clock and camera ---------- */+ const soft = p => (1 - Math.cos(Math.PI * p)) / 2; // gentle in-out, for camera moves+ // Continuous motion: f(t) runs on every frame of the beat with t in seconds from its start (0..D).+ // Keep f a pure function of t, so pause, seek and ?beat=N&t=S show the same frame.+ const clockRun = (f, D) => { f(0); prog(q => f(q * D), 0, D, lin); };+ // A camera looks at a world group through the stage (or a box, for split screen and picture-in-picture).+ // The view {x, y, z, r} is the world point at the centre, the zoom (screen px per world px) and the roll in degrees.+ // Moves are keyed on the beat clock: to(view, t0, dur, ease) blends each given key from its value at t0; a key may be a+ // function of t (follow). Unspecified keys keep following the earlier moves. dur 0 is a hard cut.+ let camN = 0;+ function camera(p, D, { box, x = 800, y = 450, z, r = 0, bg = COL.board } = {}) {+ const [bx, by, bw, bh] = box || [0, 0, 1600, 900];+ const el = G(p, { x: bx + bw / 2, y: by + bh / 2 });+ let hold = el;+ if (box) {+ const id = 'cam' + (++camN);+ mk('rect', { x: -bw / 2, y: -bh / 2, width: bw, height: bh, rx: 18 }, mk('clipPath', { id }, mk('defs', {}, el)));+ hold = G(el); hold.setAttribute('clip-path', `url(#${id})`);+ mk('rect', { x: -bw / 2, y: -bh / 2, width: bw, height: bh, fill: bg }, hold);+ }+ const view = mk('g', {}, hold), world = G(view);+ if (box) mk('rect', { x: -bw / 2, y: -bh / 2, width: bw, height: bh, rx: 18, fill: 'none', stroke: COL.faint, 'stroke-width': 2 }, el);+ const v0 = { x, y, z: z ?? (box ? Math.min(bw / 1600, bh / 900) : 1), r };+ const ops = [], shakes = [], layers = [];+ const val = (v, t) => typeof v === 'function' ? v(t) : v;+ // The view at time t after the first n moves; each move remembers the view it starts from.+ function at(t, n = ops.length) {+ const s = { ...v0 };+ for (let i = 0; i < n && ops[i].t0 <= t; i++) {+ const o = ops[i], a = o.from || (o.from = at(o.t0, i));+ const q = o.dur ? o.ease(Math.min(1, (t - o.t0) / o.dur)) : 1, b = {};+ for (const k in o.v) b[k] = val(o.v[k], t);+ if ('z' in b) s.z = a.z * (b.z / a.z) ** q; // even zoom speed+ // While zooming, x/y move so that one world point stays put on screen (when start and end allow it).+ const u = 'z' in b && Math.abs(b.z - a.z) > 1e-6 * a.z ? (1 / s.z - 1 / a.z) / (1 / b.z - 1 / a.z) : q;+ for (const k of ['x', 'y']) if (k in b) s[k] = a[k] + (b[k] - a[k]) * u;+ if ('r' in b) s.r = a.r + (b.r - a.r) * q;+ }+ return s;+ }+ function apply(t) {+ const s = at(t);+ let sx = 0, sy = 0;+ for (const k of shakes) if (t > k.t0 && t < k.t0 + k.dur) {+ const e = k.amp * Math.min(1, (t - k.t0) / .3, (k.t0 + k.dur - t) / .3), w = 2 * Math.PI * k.hz * t;+ sx += e * (Math.sin(w) + .5 * Math.sin(2.3 * w + 1)) / 1.5; sy += e * (Math.sin(1.7 * w + 2) + .5 * Math.sin(3.1 * w)) / 1.5;+ }+ const tf = `translate(${sx} ${sy}) rotate(${-s.r}) scale(${s.z}) translate(${-s.x} ${-s.y})`;+ if (tf !== view._tf) view.setAttribute('transform', view._tf = tf);+ const dx = s.x - v0.x, dy = s.y - v0.y;+ for (const L of layers) put(L.g, { x: L.wrap ? dx - ((L.k * dx) % L.wrap + L.wrap) % L.wrap : (1 - L.k) * dx, y: (1 - L.k) * dy });+ }+ const cam = { el, world, at,+ to(v, t0, dur = 1, ease = soft) { ops.push({ v, t0, dur, ease }); ops.sort((a, b) => a.t0 - b.t0); ops.forEach(o => delete o.from); return cam; },+ cut: (v, t0) => cam.to(v, t0, 0),+ shake(amp, t0, dur, hz = 7) { shakes.push({ amp, t0, dur, hz }); return cam; },+ // Parallax layer: k < 1 is far (moves slower than the camera), k > 1 near. With wrap = W the layer's content+ // repeats every W world px: draw one period plus the widest view, and the layer never runs out.+ layer(k = 1, wrap) { const g = G(world); layers.push({ g, k, wrap }); return g; },+ // Screen position of a world point at time t (k = 1 layers, no shake): for labels that track an object.+ screen(wx, wy, t) {+ const s = at(t), a = -s.r * Math.PI / 180, ux = (wx - s.x) * s.z, uy = (wy - s.y) * s.z;+ return [bx + bw / 2 + ux * Math.cos(a) - uy * Math.sin(a), by + bh / 2 + ux * Math.sin(a) + uy * Math.cos(a)];+ },+ // Put a screen-space label (text, anchor middle, outside the camera) over world point (wx, wy) at time t, kept+ // inside the frame or box by margin m; it fades out once the point itself leaves. Fade it in with a wrapper group.+ track(el, wx, wy, t, m = 24) {+ const [sx, sy] = cam.screen(wx, wy, t), str = el.textContent;+ if (el._tw?.[0] !== str) el._tw = [str, el.getComputedTextLength() / 2];+ const h = el._tw[1], away = Math.max(bx - sx, sx - bx - bw, 0);+ put(el, { x: Math.min(bx + bw - m - h, Math.max(bx + m + h, sx)), y: sy, o: Math.max(0, 1 - away / 80) });+ },+ };+ clockRun(apply, D);+ return cam;+ }++ /* ---------- scene ---------- */+ const scene = document.getElementById('scene');+ const S = {};+ const AXIS = { o: 800, u: 120 }; // number line: x of 0, pixels per unit; a chapter may change it+ const X = v => AXIS.o + AXIS.u * v, Y0 = 610;+ const num = v => (v < 0 ? '−' : '') + Math.abs(v);+ function reset() {+ scene.replaceChildren();+ for (const k in S) delete S[k];+ Object.assign(S, { dots: {}, tick: {}, rows: [], chips: [], samples: [], list: G(scene), line: G(scene), venn: G(scene) });+ }+ function tick(v) {+ const g = G(S.line, { o: 0 });+ path(g, `M${X(v)} ${Y0 - 11}V${Y0 + 11}`, { stroke: COL.dim, 'stroke-width': 2.5 });+ T(g, num(v), { x: X(v), y: Y0 + 50, size: 30, fill: COL.dim, font: MATH, anchor: 'middle' });+ return (S.tick[v] = g);+ }+ function dot(key, v, r = 9, name = v) {+ const g = G(S.line, { x: X(v), y: Y0, s: 0, o: 0 });+ mk('circle', { r, fill: COL[key], stroke: COL.board, 'stroke-width': 2 }, g);+ return (S.dots[name] = g);+ }+ const arrow = (x, dir) => `M${x - 15 * dir} ${Y0 - 10}L${x} ${Y0}L${x - 15 * dir} ${Y0 + 10}`;+ function panel(t0) {+ if (t0 < .5) S.cleared = true; // the old panel fades, or this is the first panel after the title+ const old = S.panel;+ if (old && t0 < .5) retire(old);+ else if (old) { // a panel change later in the beat stays on the beat clock+ hide(old, t0, .4);+ prog(q => { if (q === 1) old.style.display = 'none'; }, t0 + .4, 0, lin);+ }+ return (S.panel = G(scene));+ }+ // Take a beat's old picture away on wall time: a 150 ms fade, then out of rendering. On the beat clock the fade would+ // wait for the new clip's audio to start (a few hundred ms in Firefox) with the old, frozen scene still showing.+ // While seeking, the pictures passed on the way were never seen: they go at once.+ let seeking = false;+ function retire(e) {+ if (seeking) { e.style.display = 'none'; return; }+ e.style.transition = 'opacity .15s linear';+ e.style.opacity = '0';+ setTimeout(() => { e.style.display = 'none'; }, 160);+ }+ function header(p, str, t0, x = 1000, y = 170) {+ const h = T(p, str, { x, y, size: 30, fill: COL.dim, weight: 600, o: 0 });+ show(h, t0);+ return h;+ }++ /* ---------- question effects: run on wall time, independent of the lesson clock ---------- */+ let FX = [], clock = 0;+ function fx(e, to, delay = 0, dur = .5, ease = io) { FX.push({ e, to, t0: clock + delay, dur, ease }); }+ function fxp(pf, delay, dur, ease = io) { FX.push({ pf, t0: clock + delay, dur, ease }); }+ function finishFx() { FX.sort((a, b) => a.t0 - b.t0); evalTo(Infinity, FX); FX = []; }+ const pulseFx = (e, k = 1.8) => { if (!e) return; fx(e, { s: k }, 0, .22, out); fx(e, { s: 1 }, .22, .45); };+ const shakeFx = e => { if (!e) return; const x0 = st(e).x; fxp(q => put(e, { x: x0 + Math.sin(q * Math.PI * 6) * (1 - q) * 12 }), 0, .55, lin); };+ const glowFx = (key, delay = 0) => CHAIN[key].forEach((k, i) => {+ const s = S.ring[k].stroke;+ fx(s, { 'a_stroke-width': 9 }, delay + i * .28, .22, out); fx(s, { 'a_stroke-width': 3 }, delay + i * .28 + .25, .5);+ });+ function popDotFx(key, v, label) {+ const L = S.q || qlayer();+ const g = G(L, { x: X(v), y: Y0, s: 0, o: 0 });+ mk('circle', { r: 7, fill: COL[key], stroke: COL.board, 'stroke-width': 2 }, g);+ fx(g, { s: 1, o: 1 }, 0, .45, back);+ if (label) fx(M(L, label, { x: X(v) + 10, y: Y0 + 56, size: 28, fill: COL[key], o: 0 }), { o: 1 }, .3, .4);+ }+ function floatText(str, x, y, colr) {+ const t = T(S.q || qlayer(), str, { x, y: y + 14, size: 24, fill: colr, anchor: 'middle', weight: 600, o: 0 });+ fx(t, { o: 1, y }, 0, .5, out);+ }+ function hopsFx(n) {+ for (let k = 1; k <= -n; k++) {+ const a = X(1 - k), b = X(-k);+ fx(path(S.q, `M${a} ${Y0 - 12}Q${(a + b) / 2} ${Y0 - 84} ${b} ${Y0 - 12}`, { stroke: COL.int, 'stroke-width': 3 }, { d: 0 }), { d: 1 }, (k - 1) * .35, .35, lin);+ }+ floatText(`${-n} steps left of 0`, X(n / 2), Y0 - 100, COL.int);+ }++ /* ---------- shared answer columns ---------- */+ const FAMILIES = ['nat', 'whole', 'int', 'rat', 'irr', 'real'];+ const FAM_COLS = FAMILIES.map(k => [k, k === 'int' ? 'Integer' : NAME[k], COL[k]]);+ const TF = [['t', 'True', null, 'T'], ['f', 'False', null, 'F']];+ function finishCard() {+ const c = card(SCREEN, 'fin');+ const sum = pre => Object.entries(SCORE).filter(([k]) => k.startsWith(pre)).reduce((a, [, v]) => [a[0] + v.right, a[1] + v.total], [0, 0]);+ const line = (name, [r, t]) => h('p', 'fb', t ? `${name}: ${r} of ${t} right on the first try.` : `${name}: not attempted.`);+ progress(p => { p.done = [...new Set([...(p.done || []), CHAPTER.number])]; });+ const home = h('a', 'btn quiet', 'All chapters');+ home.href = $('bHome').href;+ const again = h('button', 'btn' + (CHAPTER.next ? ' quiet' : ' go'), ['Watch again', kbd(CHAPTER.next ? 'R' : 'Enter')]);+ again.onclick = restart;+ const next = CHAPTER.next && h('button', 'btn go', ['Next chapter', kbd('Enter')]);+ if (next) next.onclick = () => { location.href = CHAPTER.next; };+ P.keys = e => e.key === 'Enter' ? ((next ? next.onclick() : restart()), true)+ : (e.key === 'r' || e.key === 'R') ? (restart(), true) : false;+ const guide = mascotEl(240);+ c.append(h('div', 'finwrap', [guide, h('p', 'kicker', `Chapter ${CHAPTER.number} complete`), h('p', 'prompt', CHAPTER.title),+ line('Quick checks', sum('c-')), line('Chapter practice', sum('p-')), h('div', 'acts', next ? [home, again, next] : [home, again])]));+ setTimeout(() => mood(guide, 'happy'), 400);+ }++ /* ---------- in-picture cards ---------- */+ const $ = id => document.getElementById(id);+ // The volume control (volume.js, volume.css) lives in its own files next to this one, the same in every book.+ document.head.append(Object.assign(document.createElement('script'), { src: new URL('volume.js', document.currentScript.src) }));+ const kbd = s => h('kbd', '', s);+ const uiW = (str, size) => { ctx2d.font = `600 ${size}px ${UI}`; return ctx2d.measureText(str).width; };+ const RING_KEYS = ['nat', 'whole', 'int', 'rat', 'irr', 'real']; // number keys 1–6 in sorting questions+ const SCORE = {}; // question id -> first-attempt {right, total}++ function h(tag, cls, kids = []) {+ const e = document.createElement(tag);+ if (cls) e.className = cls;+ for (const k of [].concat(kids)) e.append(k);+ return e;+ }+ // Rich text: strings, DOM nodes, or $m(...) inline math.+ function rich(parts, size = 28) {+ const s = document.createElement('span');+ for (const p of [].concat(parts)) s.append(typeof p === 'string' || p instanceof Node ? p : mathEl(p.m, size));+ return s;+ }+ // A card at pos; a band card keeps its bottom on the stage: when its content grows (a long question, feedback),+ // it moves up rather than running under the player bar.+ function card(pos, cls) {+ const c = h('div', `card ${pos.cls} ${cls}`);+ Object.assign(c.style, { left: pos.x + 'px', top: pos.y + 'px', width: pos.w + 'px' });+ if (pos.maxH) c.style.maxHeight = pos.maxH + 'px';+ $('ui').append(c);+ if (pos.cls === 'band') {+ const fit = () => { c.style.top = Math.max(16, Math.min(pos.y, 900 - 16 - c.offsetHeight)) + 'px'; };+ const ro = new ResizeObserver(fit);+ ro.observe(c); fit();+ P.cleanup.push(() => ro.disconnect());+ }+ return c;+ }+ // The guide: an infinity sign whose two loops are its eyes. Drawn in SVG so it can blink, hop and wobble.+ function lemniscate(cx, cy, a, k) {+ let d = '';+ for (let i = 0; i <= 96; i++) {+ const t = i / 96 * 2 * Math.PI, sn = Math.sin(t), q = 1 + sn * sn;+ d += (i ? 'L' : 'M') + (cx + a * Math.cos(t) / q).toFixed(1) + ' ' + (cy + k * a * sn * Math.cos(t) / q).toFixed(1);+ }+ return d + 'Z';+ }+ function mascotEl(size = 100) {+ const svg = mk('svg', { class: 'mascot', viewBox: '0 0 120 84', width: size, height: size * .7, 'aria-hidden': 'true' });+ const body = mk('g', { class: 'mbody' }, svg);+ const line = { fill: 'none', stroke: COL.chalk, 'stroke-linecap': 'round', 'stroke-linejoin': 'round' };+ mk('path', { d: lemniscate(60, 40, 52, 1.5), ...line, 'stroke-width': 6 }, body);+ const eyes = mk('g', { class: 'eyes' }, body);+ for (const x of [33, 87]) {+ mk('circle', { class: 'pupil', cx: x, cy: 40, r: 6.5, fill: COL.chalk }, eyes);+ mk('path', { class: 'joy', d: `M${x - 7} 43Q${x} 32 ${x + 7} 43`, ...line, 'stroke-width': 4 }, body);+ }+ mk('path', { class: 'smile', d: 'M55 62Q60 67 65 62', ...line, 'stroke-width': 3.5 }, body);+ mk('path', { class: 'flat', d: 'M55 64H65', ...line, 'stroke-width': 3.5 }, body);+ return svg;+ }+ function mood(el, m) {+ el.classList.remove('happy', 'oops');+ void el.getBoundingClientRect(); // restart the CSS animation+ if (m) el.classList.add(m);+ }+ // A sequence of questions in one card. Each question: { id, prompt, build(body, api) -> { check?, reveal, lock? } }.+ function quiz(pos, qs, done, label = 'Quick check') {+ const c = card(pos, 'quiz');+ let k = 0;+ const show = () => {+ const q = qs[k];+ let first = true, resolved = false;+ const fb = h('div', 'fb'), body = h('div', 'body'), acts = h('div', 'acts');+ const bCheck = h('button', 'btn', ['Check', kbd('Enter')]), bShow = h('button', 'btn quiet', ['Show answer', kbd('S')]);+ const bNext = h('button', 'btn go', [k < qs.length - 1 ? 'Next question' : 'Continue', kbd('Enter')]);+ bShow.hidden = bNext.hidden = true;+ const guide = pos.cls === 'band' || pos.cls === 'side' ? mascotEl(pos.cls === 'band' ? 108 : 70) : null;+ const say = (cls, parts) => { fb.className = 'fb ' + cls; fb.replaceChildren(rich(parts, 24)); fb.style.animation = 'none'; void fb.offsetWidth; fb.style.animation = ''; };+ const resolve = () => {+ resolved = true;+ bCheck.hidden = bShow.hidden = true;+ ctl.lock?.();+ bNext.hidden = false;+ bNext.focus({ preventScroll: true });+ };+ const api = {+ grade(ok, msg, score) {+ if (resolved) return;+ if (first) { if (!Object.hasOwn(SCORE, q.id)) SCORE[q.id] = score || { right: +ok, total: 1 }; first = false; }+ say(ok ? 'ok' : 'no', [ok ? 'Correct. ' : 'Not quite. ', ...[].concat(msg || [])]);+ if (guide) {+ mood(guide, ok ? 'happy' : 'oops');+ if (!ok) setTimeout(() => { if (guide.classList.contains('oops')) mood(guide, null); }, 1600);+ }+ if (ok) resolve(); else bShow.hidden = false;+ },+ };+ const ctl = q.build(body, api);+ if (ctl.check) { bCheck.onclick = () => ctl.check(); acts.append(bCheck); }+ acts.append(bShow, bNext);+ bShow.onclick = () => { say('', ['Answer: ', ...[].concat(ctl.reveal())]); resolve(); };+ bNext.onclick = () => { if (k < qs.length - 1) { k++; show(); } else done(); };+ P.keys = e => {+ if (e.key === 'Enter' && resolved) { bNext.click(); return true; }+ if (!resolved && ctl.key?.(e)) return true;+ if (e.key === 'Enter' && !resolved && ctl.check) { bCheck.click(); return true; }+ if ((e.key === 's' || e.key === 'S') && !bShow.hidden) { bShow.click(); return true; }+ return false;+ };+ const kick = label + (qs.length > 1 ? ` ${k + 1} of ${qs.length}` : '');+ const head = h('div', 'head', [h('p', 'kicker', kick), h('p', 'prompt', [rich(q.prompt, pos.cls.startsWith('screen') ? 38 : 28)])]); // match the prompt's type size+ if (ctl.hint) head.append(h('p', 'keys', ['Keys: ', ...ctl.hint]));+ c.replaceChildren(...(guide ? [guide] : []), head, fb, body, acts);+ };+ show();+ }+ function qlayer() {+ S.q?.remove();+ S.q = G(scene);+ S.q.classList.add('qlayer');+ return S.q;+ }+ const keyAct = (el, fn) => el.addEventListener('keydown', e => { if (e.key === 'Enter' || e.key === ' ') { e.preventDefault(); fn(); } });++ /* ---------- question builders ---------- */+ // Single answer from buttons; each wrong option has its own explanation.+ const choice = (opts, right, yes, no, onRight) => (body, api) => {+ const row = h('div', 'opts');+ const bs = opts.map((o, i) => {+ const b = h('button', 'opt', [kbd(String(i + 1)), rich(o, 32)]);+ b.onclick = () => {+ if (i === right) { b.classList.add('good'); onRight?.(); api.grade(true, yes); }+ else { b.classList.add('bad'); b.disabled = true; api.grade(false, no[i]); }+ };+ row.append(b);+ return b;+ });+ body.append(row);+ return {+ reveal() { bs[right].classList.add('good'); onRight?.(); return yes; },+ lock() { bs.forEach(b => { b.disabled = true; }); },+ key(e) { const b = bs[+e.key - 1]; if (!b || b.disabled) return false; b.click(); return true; },+ };+ };+ // Tap a point on the stage number line.+ const tap = (values, right, yes, no, onRight) => (body, api) => {+ const L = qlayer(), hits = {};+ let locked = false;+ for (const v of values) {+ const g = G(L, { x: X(v), y: Y0 });+ g.classList.add('hit');+ g.setAttribute('tabindex', 0);+ g.setAttribute('role', 'button');+ g.setAttribute('aria-label', `The point ${num(v)}`);+ mk('circle', { r: 30, class: 'ring' }, g);+ const act = () => {+ if (locked) return;+ if (v === right) { g.classList.add('good'); onRight?.(); api.grade(true, yes); }+ else { g.classList.add('bad'); shakeFx(S.dots[v]); api.grade(false, no(v)); }+ };+ g.addEventListener('click', act);+ keyAct(g, act);+ hits[v] = g;+ }+ const gs = values.map(v => hits[v]);+ let cur = -1;+ return {+ reveal() { hits[right].classList.add('good'); onRight?.(); return yes; },+ lock() { locked = true; },+ hint: [kbd('←'), kbd('→'), ' move along the line, ', kbd('Enter'), ' choose'],+ key(e) {+ const d = e.key === 'ArrowRight' ? 1 : e.key === 'ArrowLeft' ? -1 : 0;+ if (!d || locked) return false;+ cur = cur < 0 ? (d > 0 ? 0 : gs.length - 1) : (cur + d + gs.length) % gs.length;+ gs[cur].focus();+ return true;+ },+ };+ };+ // Tap one token of a stage token row, e.g. the operation to do first. idx: tappable token indexes.+ const tapEls = (row, idx, right, yes, no, onRight) => (body, api) => {+ const L = qlayer();+ let locked = false, cur = -1;+ const hits = idx.map(i => {+ const e = row[i], w = e._w + 18, g = G(L, { x: e._px, y: row.y });+ g.classList.add('hit');+ g.setAttribute('tabindex', 0);+ g.setAttribute('role', 'button');+ g.setAttribute('aria-label', e.textContent.trim());+ mk('rect', { class: 'ring', x: -w / 2, y: -row.size * .95, width: w, height: row.size * 1.3, rx: 12 }, g);+ const act = () => {+ if (locked) return;+ if (i === right) { g.classList.add('good'); onRight?.(); api.grade(true, yes); }+ else { g.classList.add('bad'); shakeFx(e); api.grade(false, no(i)); }+ };+ g.addEventListener('click', act);+ keyAct(g, act);+ return g;+ });+ return {+ reveal() { hits[idx.indexOf(right)].classList.add('good'); onRight?.(); return yes; },+ lock() { locked = true; },+ hint: [kbd('←'), kbd('→'), ' move, ', kbd('Enter'), ' choose'],+ key(e) {+ const d = e.key === 'ArrowRight' ? 1 : e.key === 'ArrowLeft' ? -1 : 0;+ if (!d || locked) return false;+ cur = cur < 0 ? (d > 0 ? 0 : hits.length - 1) : (cur + d + hits.length) % hits.length;+ hits[cur].focus();+ return true;+ },+ };+ };+ // Click one of several stage objects (table cells, bars, small graphs). items: [{ el, box: [x, y, w, h], label }].+ const pickEls = (items, right, yes, no, onRight) => (body, api) => {+ const L = qlayer();+ let locked = false, cur = -1;+ const hits = items.map((it, i) => {+ const [x, y, w, hh] = it.box, g = G(L);+ g.classList.add('hit');+ g.setAttribute('tabindex', 0);+ g.setAttribute('role', 'button');+ g.setAttribute('aria-label', it.label);+ mk('rect', { class: 'ring', x, y, width: w, height: hh, rx: 12 }, g);+ const act = () => {+ if (locked) return;+ if (i === right) { g.classList.add('good'); onRight?.(); api.grade(true, yes); }+ else { g.classList.add('bad'); shakeFx(it.el); api.grade(false, no(i)); }+ };+ g.addEventListener('click', act);+ keyAct(g, act);+ return g;+ });+ return {+ reveal() { hits[right].classList.add('good'); onRight?.(); return yes; },+ lock() { locked = true; },+ hint: [kbd('←'), kbd('→'), ' move, ', kbd('Enter'), ' choose, or click'],+ key(e) {+ const d = e.key === 'ArrowRight' ? 1 : e.key === 'ArrowLeft' ? -1 : 0;+ if (!d || locked) return false;+ cur = cur < 0 ? (d > 0 ? 0 : hits.length - 1) : (cur + d + hits.length) % hits.length;+ hits[cur].focus();+ return true;+ },+ };+ };+ // Rows of toggles. items: { parts, ans: [keys], why }. parts are math parts (strings, F, R) unless text: true,+ // where they are rich text (strings and $m(...)). cols: [[key, label, colour?, shortcut?]]. multi: several per row.+ const grid = (items, cols, { multi = true, text = false } = {}) => (body, api) => {+ const wrap = h('div', 'grid' + (text ? ' text' : ''));+ const hot = cols.map((c, j) => c[3] || String(j + 1));+ let cur = 0, locked = false;+ const rows = items.map((it, ri) => {+ const opts = h('div', 'opts'), mark = h('div', 'mark'), why = h('div', 'why');+ const bs = cols.map(([key, lab, colr], j) => {+ const b = h('button', 'opt', [kbd(hot[j]), lab]);+ if (colr) b.style.setProperty('--c', colr);+ b.setAttribute('aria-pressed', 'false');+ b.onclick = () => {+ const on = b.getAttribute('aria-pressed') !== 'true';+ if (!multi) bs.forEach(x => x.setAttribute('aria-pressed', 'false'));+ b.setAttribute('aria-pressed', String(on));+ };+ opts.append(b);+ return b;+ });+ const el = h('div', 'row', [h('div', 'num', [text ? rich(it.parts, 26) : mathEl(it.parts, 32)]), opts, mark, why]);+ el.addEventListener('click', () => { cur = ri; showCur(); });+ wrap.append(el);+ const picked = () => cols.filter((c, i) => bs[i].getAttribute('aria-pressed') === 'true').map(c => c[0]);+ return { it, bs, mark, why, picked, el, played: false };+ });+ const single = rows.length === 1;+ const showCur = () => rows.forEach((r, i) => {+ const on = !single && !locked && i === cur;+ r.el.classList.toggle('cur', on);+ if (on && r.el.isConnected) r.el.scrollIntoView({ block: 'nearest' }); // a long practice list scrolls+ });+ showCur();+ body.append(wrap);+ const judge = r => {+ const p = r.picked(), ok = p.length === r.it.ans.length && r.it.ans.every(k => p.includes(k));+ r.mark.className = 'mark ' + (ok ? 'good' : 'bad');+ r.mark.textContent = ok ? '✓' : '✗';+ r.why.replaceChildren(ok || single ? '' : rich(r.it.why, 20));+ if (ok && !r.played) { r.played = true; r.it.fx?.(); }+ return ok;+ };+ return {+ check() {+ const right = rows.filter(judge).length;+ const all = right === rows.length;+ api.grade(all, single ? rows[0].it.why : all ? [] : [`${right} of ${rows.length} right. Fix the rows marked ✗ and check again.`], { right, total: rows.length });+ },+ reveal() {+ for (const r of rows) {+ r.bs.forEach((b, i) => b.setAttribute('aria-pressed', String(r.it.ans.includes(cols[i][0]))));+ judge(r);+ if (!single) r.why.replaceChildren(rich(r.it.why, 20));+ }+ return single ? rows[0].it.why : 'the correct choices are now selected.';+ },+ lock() { locked = true; showCur(); rows.forEach(r => r.bs.forEach(b => { b.disabled = true; })); },+ hint: [...(single ? [] : [kbd('↑'), kbd('↓'), ' row, ']), ...(/\d/.test(hot[0]) ? [kbd(hot[0]), '–', kbd(hot[hot.length - 1])] : hot.map(kbd)), ' choose'],+ key(e) {+ if (locked) return false;+ if ((e.key === 'ArrowDown' || e.key === 'ArrowUp') && !single) {+ cur = (cur + (e.key === 'ArrowDown' ? 1 : -1) + rows.length) % rows.length;+ showCur();+ return true;+ }+ const j = hot.findIndex(x => x.toLowerCase() === e.key.toLowerCase());+ if (j < 0) return false;+ rows[cur].bs[j].click();+ if (!multi && cur < rows.length - 1) { cur++; showCur(); }+ return true;+ },+ };+ };+ // Exact value of a typed answer: integer, decimal, fraction a/b or mixed number "w a/b"; returns [num, den] or null.+ // Accepts −, – or - as the sign. Never evaluates the text as code.+ function rat(str) {+ const t = String(str).trim().replace(/^[−–]/, '-').replace(/\s+/g, ' ');+ let m = t.match(/^(-?)(\d+)(?:\.(\d+))?$/);+ if (m) { const d = 10 ** (m[3] || '').length, n = (m[1] ? -1 : 1) * (Number(m[2]) * d + Number(m[3] || 0)); return Number.isSafeInteger(n) && Number.isSafeInteger(d) ? [n, d] : null; }+ m = t.match(/^(-?)(?:(\d+) )?(\d+) ?\/ ?(\d+)$/);+ if (m && Number(m[4]) > 0) { const d = Number(m[4]), n = (m[1] ? -1 : 1) * (Number(m[2] || 0) * d + Number(m[3])); return Number.isSafeInteger(n) && Number.isSafeInteger(d) ? [n, d] : null; }+ return null;+ }+ const gcd = (a, b) => { a = Math.abs(a); b = Math.abs(b); while (b) [a, b] = [b, a % b]; return a; };+ const lowest = ([n, d]) => gcd(n, d) === 1;+ // Fill-in boxes inside math. rows: [{ parts: [math parts and { box: '21' }], why, hint?, fx? }].+ // test(values), when given, judges the whole row from the typed numbers (e.g. a factor pair in either order); the boxes' answers are still what Show answer fills in.+ // Answers are exact numbers: "−5", "-5", "0.5", "3/4" and "2 1/4" all work, and equal values match ("6/8" = "3/4")+ // unless the box has lowest: true. hint is shown after a wrong try, why after a right one.+ const blanks = rowsIn => (body, api) => {+ const all = [];+ const rows = rowsIn.map(it => {+ const line = h('div', 'bline'), mark = h('span', 'mark'), why = h('div', 'why');+ let run = [];+ const flush = () => { if (run.length) line.append(mathEl(run, 34)); run = []; };+ const boxes = [];+ for (const p of it.parts) {+ if (p && p.box !== undefined) {+ flush();+ const b = h('input', 'box');+ Object.assign(b, { type: 'text', inputMode: 'decimal', autocomplete: 'off', spellcheck: false });+ b.setAttribute('aria-label', 'Answer');+ b.dataset.ans = p.box;+ if (p.lowest) b.dataset.lowest = '1';+ b.style.width = `${Math.max(2, String(p.box).length) + 2}ch`;+ line.append(b);+ boxes.push(b);+ all.push(b);+ } else run.push(p);+ }+ flush();+ line.append(mark);+ body.append(h('div', 'brow', [line, why]));+ return { it, boxes, mark, why, played: false };+ });+ body.classList.add('blanks');+ const single = rows.length === 1;+ const judge = r => {+ let ok = true;+ if (r.it.test) { // the row is judged as a whole, e.g. two factors in either order+ const vals = r.boxes.map(b => rat(b.value));+ ok = vals.every(Boolean) && !!r.it.test(vals.map(([n, d]) => n / d));+ r.boxes.forEach(b => { b.classList.toggle('good', ok); b.classList.toggle('bad', !ok); });+ } else for (const b of r.boxes) {+ const want = rat(b.dataset.ans), got = rat(b.value);+ const good = !!got && !!want && BigInt(got[0]) * BigInt(want[1]) === BigInt(want[0]) * BigInt(got[1]) && (!b.dataset.lowest || lowest(got));+ b.classList.toggle('good', good);+ b.classList.toggle('bad', !good);+ ok = ok && good;+ }+ r.mark.className = 'mark ' + (ok ? 'good' : 'bad');+ r.mark.textContent = ok ? '✓' : '✗';+ r.why.replaceChildren(ok || single ? '' : rich(r.it.hint ?? r.it.why, 20));+ if (ok && !r.played) { r.played = true; r.it.fx?.(); }+ return ok;+ };+ requestAnimationFrame(() => all[0]?.focus({ preventScroll: true }));+ return {+ check() {+ const right = rows.filter(judge).length, done = right === rows.length;+ const msg = single ? (done ? rows[0].it.why : rows[0].it.hint ?? rows[0].it.why)+ : done ? [] : [`${right} of ${rows.length} right. Fix the rows marked ✗ and check again.`];+ api.grade(done, msg, { right, total: rows.length });+ },+ reveal() {+ for (const r of rows) {+ r.boxes.forEach(b => { b.value = b.dataset.ans.replace('-', '−'); }); // shown exactly as authored+ judge(r);+ if (!single) r.why.replaceChildren(rich(r.it.why, 20));+ }+ return single ? rows[0].it.why : 'the correct numbers are filled in.';+ },+ lock() { all.forEach(b => { b.disabled = true; }); },+ hint: [all.some(b => b.dataset.ans.includes('/')) ? 'type numbers like 3/4 or −2 1/4, ' : 'type the number, ', kbd('Tab'), ' next box, ', kbd('Enter'), ' check, ', kbd('Esc'), ' leave the box'],+ };+ };+ // Drag number chips into the stage number map. items: [parts, smallest ring, explanation].+ const slot = (k, n) => {+ if (k === 'real') return [[940, 210], [1000, 760], [820, 800]][n % 3]; // inside Real, outside every other ring+ const r = RINGS[k];+ return [r.lx + [-72, 72, 0][n % 3], r.ly + 50 + 56 * Math.floor(n / 2)];+ };-const plain = parts => parts.map(p => typeof p === 'string' ? p : p.ov !== undefined ? p.ov + ' repeating' : p.f ? p.f.join('/') : p.sup !== undefined ? '^' + p.sup : (p.i ? p.i : '') + '√' + (p.r.f ? p.r.f.join('/') : p.r)).join('');++const plain = parts => parts.map(p => typeof p === 'string' ? p : p.ov !== undefined ? p.ov + ' repeating' : p.tex !== undefined ? p.tex : p.f ? p.f.join('/') : p.sup !== undefined ? '^' + p.sup : (p.i ? p.i : '') + '√' + (p.r.f ? p.r.f.join('/') : p.r)).join('');+ const sorter = (items, trayXY) => (body, api) => {+ const L = qlayer();+ const bg = mk('rect', { width: 1600, height: 900, fill: 'transparent' }, L);+ const svg = $('stage');+ const pt = e => { const p = svg.createSVGPoint(); p.x = e.clientX; p.y = e.clientY; return p.matrixTransform(svg.getScreenCTM().inverse()); };+ let sel = null, drag = null, locked = false;+ const label = c => c.setAttribute('aria-label', `${c.say}, ${c.region ? 'placed in ' + NAME[c.region] : 'not placed'}`);+ const outline = (c, colr, w = 2.5) => { c._rect.setAttribute('stroke', colr); c._rect.setAttribute('stroke-width', w); };+ const choose = c => {+ if (sel) outline(sel, COL.chalk);+ sel = c;+ if (sel) { outline(sel, COL.task, 4); L.append(sel); }+ };+ const select = c => choose(sel === c ? null : c);+ // Number badges next to the ring names, for keys 1–6.+ RING_KEYS.forEach((k, i) => {+ const r = RINGS[k], g = G(L, { x: r.lx - uiW(NAME[k], 26) / 2 - 24, y: r.ly - 9 });+ g.style.pointerEvents = 'none';+ mk('circle', { r: 14, fill: COL.board, stroke: COL[k], 'stroke-width': 1.5 }, g);+ T(g, String(i + 1), { y: 6.5, size: 18, fill: COL[k], anchor: 'middle', weight: 600 });+ });+ const place = (c, x, y) => {+ c.region = regionAt(x, y);+ if (!c.region) [x, y] = c.home;+ put(c, { x, y });+ outline(c, COL.chalk);+ c.querySelector('.mark')?.remove();+ if (sel === c) sel = null;+ label(c);+ };+ const chips = items.map(([parts, answer, why], i) => {+ const [x, y] = trayXY(i);+ const c = chip(L, parts, COL.chalk, { x, y, size: 32 });+ Object.assign(c, { answer, why, home: [x, y], region: null, say: plain(parts) });+ c.classList.add('tok');+ c.setAttribute('tabindex', 0);+ c.setAttribute('role', 'button');+ label(c);+ c.addEventListener('pointerdown', e => {+ if (locked) return;+ e.preventDefault();+ const p = pt(e);+ drag = { dx: p.x - st(c).x, dy: p.y - st(c).y, sx: p.x, sy: p.y, moved: false };+ L.append(c); // re-parent before capturing: moving a node drops its capture+ c.setPointerCapture(e.pointerId);+ });+ c.addEventListener('pointermove', e => {+ if (!drag) return;+ const p = pt(e);+ if (Math.hypot(p.x - drag.sx, p.y - drag.sy) > 6) drag.moved = true;+ if (drag.moved) put(c, { x: p.x - drag.dx, y: p.y - drag.dy });+ });+ c.addEventListener('pointerup', () => {+ if (!drag) return;+ const moved = drag.moved;+ drag = null;+ if (moved) place(c, st(c).x, st(c).y); else select(c);+ });+ keyAct(c, () => { if (!locked) select(c); });+ return c;+ });+ bg.addEventListener('pointerup', e => { if (sel && !locked) { const p = pt(e); place(sel, p.x, p.y); } });+ return {+ check() {+ let right = 0;+ const notes = h('ul');+ for (const c of chips) {+ c.querySelector('.mark')?.remove();+ if (!c.region) { notes.append(h('li', '', `${c.say} is not placed yet.`)); continue; }+ const ok = c.region === c.answer;+ right += ok;+ outline(c, ok ? COL.good : COL.bad, 4);+ if (ok) { pulseFx(c, 1.25); glowFx(c.answer, right * .15); } else shakeFx(c);+ const w = +c._rect.getAttribute('width');+ T(c, ok ? '✓' : '✗', { x: w / 2 + 4, y: -16, size: 26, fill: ok ? COL.good : COL.bad, weight: 700 }).classList.add('mark');+ if (!ok) notes.append(h('li', '', c.region === 'real'+ ? `${c.say}: every real number is rational or irrational, so that space has no numbers of its own.`+ : c.why));+ }+ const all = right === chips.length;+ api.grade(all, all ? [] : [`${right} of ${chips.length} in the right ring.`, notes], { right, total: chips.length });+ },+ reveal() {+ const count = {};+ chips.forEach((c, i) => {+ const n = count[c.answer] = (count[c.answer] ?? -1) + 1;+ const [x, y] = slot(c.answer, n);+ c.region = c.answer;+ c.querySelector('.mark')?.remove();+ outline(c, COL.good, 4);+ fx(c, { x, y }, i * .12, .8);+ });+ return 'every number is now in its smallest ring.';+ },+ lock() { locked = true; choose(null); },+ hint: [kbd('←'), kbd('→'), ' pick a number, ', kbd('1'), '–', kbd('6'), ' choose its ring'],+ key(e) {+ if (locked) return false;+ const d = e.key === 'ArrowRight' || e.key === 'ArrowDown' ? 1 : e.key === 'ArrowLeft' || e.key === 'ArrowUp' ? -1 : 0;+ if (d) {+ const i = sel ? chips.indexOf(sel) : d > 0 ? -1 : 0;+ choose(chips[(i + d + chips.length) % chips.length]);+ return true;+ }+ const ring = RING_KEYS[+e.key - 1];+ if (!ring || !sel) return false;+ const c = sel;+ place(c, ...slot(ring, chips.filter(x => x.region === ring && x !== c).length));+ choose(chips.find(x => !x.region) || null);+ return true;+ },+ };+ };++ /* ---------- player ---------- */+ const P = { i: 0, t: 0, end: 1, playing: false, waiting: false, done: false, started: false, audio: null, afail: false, stall: 0, cleanup: [], rate: 1, nextClip: null };+ function runBeat(i) {+ TW = [];+ const b = BEATS[i], tm = TIMINGS[b.id];+ const m = (k, off = 0) => {+ if (!(k in tm.marks)) throw new Error(`${b.id}: missing mark ${k}`);+ return tm.marks[k] + off;+ };+ S.cleared = false;+ b.run(m, tm.dur);+ if (S.cleared && b.lead !== false) leadIn();+ TW.sort((a, c) => a.t0 - c.t0);+ return Math.max(tm.dur, ...TW.map(w => w.t0 + w.dur)) + .6;+ }+ // A beat that clears the picture must not leave it empty while the narration has started.+ // If nothing appears before LEAD_MAX, the opening group (every tween that starts within LEAD_GROUP s of the+ // first reveal) moves earlier so it begins at LEAD_AT, just after the old panel has faded. Later steps keep their word timing.+ const LEAD_AT = .4, LEAD_MAX = .8, LEAD_GROUP = 1.2;+ function leadIn() {+ const reveals = TW.filter(w => {+ if (!w.e) return false;+ const s = st(w.e), to = w.to;+ return (to.o > 0 && s.o === 0) || (to.s > 0 && s.s === 0) || (to.d > 0 && (s.d ?? 1) === 0);+ });+ if (!reveals.length) return;+ const first = Math.min(...reveals.map(w => w.t0));+ if (first <= LEAD_MAX) return;+ for (const w of TW) if (w.t0 >= first && w.t0 < first + LEAD_GROUP) w.t0 -= first - LEAD_AT;+ }+ function stopAudio() {+ const a = P.audio;+ if (!a) return;+ a.onerror = null; a.pause(); a.removeAttribute('src'); a.load();+ P.audio = null;+ }+ function clearCards() {+ $('ui').replaceChildren();+ P.cleanup.forEach(f => f());+ P.cleanup = [];+ finishFx();+ P.keys = null;+ S.q?.remove();+ delete S.q;+ }+ // Rebuild the scene from scratch and fast-forward every earlier beat, so any step starts from its exact picture.+ function seek(i, play = P.playing) {+ stopAudio(); clearCards(); reset();+ seeking = true;+ try {+ for (let k = 0; k < i; k++) { runBeat(k); evalTo(Infinity); }+ start(i, play);+ } finally { seeking = false; }+ }+ // Jump to a point inside beat i (frac of its narration); question beats always start at their beginning.+ function seekInto(i, frac) {+ seek(i, true);+ const t = BEATS[i].ask ? 0 : frac * TIMINGS[BEATS[i].id].dur;+ if (t < .3) return;+ P.t = t;+ evalTo(t);+ if (P.audio) P.audio.currentTime = t;+ }+ function start(i, play) {+ stopAudio(); clearCards();+ Object.assign(P, { i, t: 0, waiting: false, done: false, afail: false, stall: 0 });+ P.end = runBeat(i);+ evalTo(0);+ const a = P.audio = beatClip(i, true);+ a.volume = +($('volume')?.value ?? 1);+ a.playbackRate = P.rate;+ // An aborted or superseded load (fast stepping, a reload) is not a failure: only a real error for the current clip+ // shows the note, and the note goes away as soon as a clip plays.+ a.onerror = () => { if (P.audio === a && a.error && a.error.code !== MediaError.MEDIA_ERR_ABORTED) soundFailed(); };+ a.onplaying = () => {+ if (P.audio !== a) return;+ $('soundNote').hidden = true;+ if (P.afail) { P.afail = false; a.currentTime = P.t; } // sound came back late: rejoin the picture where it is+ };+ const b = BEATS[i];+ if (b.ask) b.ask(() => { if (P.i === i) { evalTo(Infinity); start(i + 1, true); } });+ setPlaying(play);+ if (i + 1 < BEATS.length) beatClip(i + 1);+ }+ // The next beat's clip starts loading while this one plays, so a slow connection does not stall between beats.+ function beatClip(i, take) {+ const src = `audio/${CHAPTER.language || 'en'}/${BEATS[i].id}.mp3`;+ let a = P.nextClip?._src === src ? P.nextClip : null;+ if (!a) {+ if (P.nextClip && P.nextClip !== P.audio) { P.nextClip.removeAttribute('src'); P.nextClip.load(); } // abandon a stale preload+ a = Object.assign(new Audio(src), { preload: 'auto', _src: src });+ }+ P.nextClip = take ? null : a;+ return a;+ }+ // Playback speed: the audio clock drives the picture, so changing the clip's rate keeps them together.+ const SPEEDS = [.75, 1, 1.25, 1.5];+ function setSpeed(r) {+ P.rate = r;+ $('bSpeed').textContent = r + '×';+ if (P.audio) P.audio.playbackRate = r;+ try { localStorage.setItem('speed', String(r)); } catch {}+ }+ const stepSpeed = d => setSpeed(SPEEDS[Math.max(0, Math.min(SPEEDS.length - 1, SPEEDS.indexOf(P.rate) + d))]);+ function soundFailed() { P.afail = true; $('soundNote').hidden = false; }+ function setPlaying(v) {+ P.playing = v;+ const a = P.audio;+ if (!a) return;+ if (v && !P.waiting && !a.ended && !P.afail) a.play().catch(e => { if (P.audio === a && e.name === 'NotAllowedError') soundFailed(); });+ else a.pause();+ }+ function beatDone() {+ evalTo(Infinity);+ const b = BEATS[P.i];+ if (b.ask) P.waiting = true;+ else if (P.i < BEATS.length - 1) start(P.i + 1, true);+ else { P.done = true; setPlaying(false); }+ }+ let last = performance.now();+ function frame(now) {+ const dt = Math.min(.1, (now - last) / 1000);+ last = now;+ clock += dt;+ if (FX.length) { evalTo(clock, FX); FX = FX.filter(w => !w.done); }+ if (P.playing && !P.waiting && !P.done) {+ const a = P.audio;+ // While the clip plays, its clock drives the picture; before it starts or after it ends, wall time does.+ if (a && !P.afail && !a.ended) {+ if (a.currentTime > 0) { P.t = Math.max(P.t, a.currentTime); P.stall = 0; }+ else if ((P.stall += dt) > (a.readyState < 2 ? 8 : 15)) soundFailed(); // nothing to play after 8 s, or stuck for 15+ } else P.t += dt * P.rate;+ evalTo(P.t);+ if (P.t >= P.end) beatDone();+ }+ ui();+ requestAnimationFrame(frame);+ }+ let segs = [];+ function buildSegs() {+ segs = BEATS.map((b, i) => {+ const s = h('button', 'seg' + (b.ask ? ' ask' : ''), [h('i')]);+ s.style.flex = TIMINGS[b.id].dur + (b.ask ? 12 : 0);+ s.title = b.title;+ s.setAttribute('aria-label', `Go to step ${i + 1}: ${b.title}`);+ // A click lands at that point of the step; keyboard activation (no pointer position) starts the step.+ s.onclick = e => {+ const r = s.getBoundingClientRect();+ hideCover(); seekInto(i, e.detail ? (e.clientX - r.left) / r.width : 0);+ };+ $('segs').append(s);+ return s.firstChild;+ });+ }+ function ui() {+ segs.forEach((f, k) => { f.style.width = (k < P.i || P.done ? 100 : k > P.i ? 0 : Math.min(100, P.t / P.end * 100)) + '%'; });+ $('frame').classList.toggle('is-playing', P.playing && !P.done && !P.waiting);+ $('frame').classList.toggle('paused', P.started && !P.playing && !P.waiting && !P.done && !BEATS[P.i].ask);+ $('stepName').textContent = `${P.i + 1} / ${BEATS.length} ${BEATS[P.i].title}`;+ const b = BEATS[P.i];+ let text = '';+ if (captions && P.started && !b.ask && !P.done) {+ for (const [t, line] of TIMINGS[b.id].cues) { if (t > P.t + .05) break; text = line; }+ }+ if (text !== capText) { capText = text; $('caption').textContent = text; $('caption').hidden = !text; }+ }+ let captions = false, capText = '';+ try { captions = localStorage.getItem('captions') === '1'; } catch {}+ function setCaptions(on) {+ captions = on;+ $('bCC').setAttribute('aria-pressed', String(on));+ try { localStorage.setItem('captions', on ? '1' : '0'); } catch {}+ }+ setCaptions(captions);+ function hideCover() { P.started = true; $('cover').hidden = true; }+ function togglePlay() {+ if (!P.started) { hideCover(); return setPlaying(true); }+ if (P.waiting || P.done) return;+ setPlaying(!P.playing);+ }+ const back1 = () => seek(P.t > 2.5 || P.i === 0 ? P.i : P.i - 1);+ const restart = () => { for (const k in SCORE) delete SCORE[k]; hideCover(); seek(0, true); };+ $('cover').onclick = togglePlay;+ $('stage').addEventListener('click', e => {+ const b = BEATS[P.i];+ if (!b.ask && !e.target.closest('.qlayer')) togglePlay();+ });+ $('bPlay').onclick = togglePlay;+ $('bBack').onclick = () => { hideCover(); back1(); };+ $('bRestart').onclick = restart;+ $('bCC').onclick = () => setCaptions(!captions);+ $('bSpeed').onclick = () => setSpeed(SPEEDS[(SPEEDS.indexOf(P.rate) + 1) % SPEEDS.length]);+ try { const r = +localStorage.getItem('speed'); if (SPEEDS.includes(r)) setSpeed(r); } catch {}+ $('bFull').onclick = () => toggleFull();+ const toggleFull = () => document.fullscreenElement ? document.exitFullscreen() : document.documentElement.requestFullscreen?.();+ let helpResume = false;+ function toggleHelp() {+ const open = $('help').hidden;+ $('help').hidden = !open;+ if (open) { helpResume = P.playing; if (P.playing) setPlaying(false); }+ else if (helpResume) setPlaying(true);+ }+ // Every action has a key. A question's own keys (P.keys) come first; Shift reaches the player during a question.+ document.addEventListener('keydown', e => {+ if (e.altKey || e.metaKey || e.ctrlKey) return;+ const k = e.key;+ if (!$('help').hidden) { if (k === 'Escape' || k === '?') { e.preventDefault(); toggleHelp(); } return; }+ if (e.target.matches?.('input')) { // Keep native input keys; only answer boxes use Enter to check.+ if (k === 'Enter' && e.target.type !== 'range' && P.keys) { e.preventDefault(); P.keys(e); }+ else if (k === 'Escape') e.target.blur();+ return;+ }+ if (k === '?') { e.preventDefault(); toggleHelp(); return; }+ if ((k === 'Enter' || k === ' ') && e.target.closest?.('button, [tabindex], a')) return; // a Tab-focused control acts itself+ if (!P.started) { if (k === ' ' || k === 'Enter') { e.preventDefault(); togglePlay(); } return; }+ if (P.keys && !e.shiftKey && P.keys(e)) { e.preventDefault(); return; }+ const free = e.shiftKey || !P.keys;+ let used = true;+ if (k === ' ') togglePlay();+ else if (k === 'ArrowLeft' && free) back1();+ else if (k === 'ArrowRight' && free) { if (P.i < BEATS.length - 1) seek(P.i + 1); }+ else if (k === 'Home') restart();+ else if (k === 'c' || k === 'C') setCaptions(!captions);+ else if (k === '<' || k === ',') stepSpeed(-1);+ else if (k === '>' || k === '.') stepSpeed(1);+ else if (k === 'f' || k === 'F') toggleFull();+ else used = false;+ if (used) e.preventDefault();+ });+ // Mouse clicks should not leave focus on a control, so Enter and Space keep meaning "check" and "play".+ $('frame').addEventListener('mousedown', e => { if (e.target.closest('button, [tabindex]')) e.preventDefault(); });+ $('bHelp').onclick = toggleHelp;+ const fit = () => document.documentElement.style.setProperty('--k', Math.min(innerWidth / 1640, (innerHeight - (innerWidth <= 700 ? 120 : 0)) / 1000));+ addEventListener('resize', fit);+ fit();++ // Start the lesson once the chapter page has defined CHAPTER and BEATS.+ // ?beat=N&t=S opens a paused frame, for reviewing a single moment.+ // Per-book progress shared with the cover/contents at the parent URL folder.+ const BOOK_PROGRESS_KEY = bookSetting('--progress-key') || 'animebook:progress:' + new URL('../', location.href).pathname;+ function progress(f) {+ try {+ const saved = JSON.parse(localStorage.getItem(BOOK_PROGRESS_KEY) || '{}');+ const p = saved && typeof saved === 'object' && !Array.isArray(saved) ? saved : {};+ p.done = Array.isArray(p.done) ? p.done.filter(n => Number.isInteger(n) && n > 0) : [];+ f(p); localStorage.setItem(BOOK_PROGRESS_KEY, JSON.stringify(p));+ } catch {}+ }+ function boot() {+ $('coverK').textContent = `Chapter ${CHAPTER.number}`;+ $('coverT').textContent = CHAPTER.title;+ $('bHome').href = `../#ch${String(CHAPTER.number).padStart(2, '0')}`;+ progress(p => { p.last = CHAPTER.number; });+ document.getElementById('stage').setAttribute('aria-label', `Lesson animation: ${CHAPTER.title}`);+ $('coverMeta').textContent = `About ${CHAPTER.minutes} minutes, with sound and quick checks.`;+ buildSegs();+ const qs = new URLSearchParams(location.search);+ if (qs.has('beat')) {+ $('cover').hidden = true;+ seek(+qs.get('beat'), false);+ P.t = +(qs.get('t') || 0);+ evalTo(P.t);+ } else seek(0, false);+ requestAnimationFrame(frame);+ }