Skip to content

An AI skill that turns books into animated, narrated, interactive web experiences

feat(linear-algebra): start the book: linked 2D system, 3D space, pilot chapter 1

yzr407d3fdc4eb5
diff --git a/site/linear-algebra/ch01/audio/en/draw.mp3 b/site/linear-algebra/ch01/audio/en/draw.mp3
new file mode 100644
index 0000000..40a09e8
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/draw.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/final1.mp3 b/site/linear-algebra/ch01/audio/en/final1.mp3
new file mode 100644
index 0000000..0c4435c
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/final1.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/final2.mp3 b/site/linear-algebra/ch01/audio/en/final2.mp3
new file mode 100644
index 0000000..e7c0811
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/final2.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/final3.mp3 b/site/linear-algebra/ch01/audio/en/final3.mp3
new file mode 100644
index 0000000..73e45a4
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/final3.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/final4.mp3 b/site/linear-algebra/ch01/audio/en/final4.mp3
new file mode 100644
index 0000000..9faf737
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/final4.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/finish.mp3 b/site/linear-algebra/ch01/audio/en/finish.mp3
new file mode 100644
index 0000000..ed499fc
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/finish.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/flat.mp3 b/site/linear-algebra/ch01/audio/en/flat.mp3
new file mode 100644
index 0000000..24194ad
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/flat.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/intro.mp3 b/site/linear-algebra/ch01/audio/en/intro.mp3
new file mode 100644
index 0000000..2b21ddb
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/intro.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/off.mp3 b/site/linear-algebra/ch01/audio/en/off.mp3
new file mode 100644
index 0000000..3c036fa
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/off.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/origin.mp3 b/site/linear-algebra/ch01/audio/en/origin.mp3
new file mode 100644
index 0000000..4e19c44
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/origin.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/points.mp3 b/site/linear-algebra/ch01/audio/en/points.mp3
new file mode 100644
index 0000000..22a824b
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/points.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/q1.mp3 b/site/linear-algebra/ch01/audio/en/q1.mp3
new file mode 100644
index 0000000..02c0b24
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/q1.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/q2.mp3 b/site/linear-algebra/ch01/audio/en/q2.mp3
new file mode 100644
index 0000000..a7064f0
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/q2.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/q3.mp3 b/site/linear-algebra/ch01/audio/en/q3.mp3
new file mode 100644
index 0000000..50a3c45
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/q3.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/slide.mp3 b/site/linear-algebra/ch01/audio/en/slide.mp3
new file mode 100644
index 0000000..569917b
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/slide.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/tilt.mp3 b/site/linear-algebra/ch01/audio/en/tilt.mp3
new file mode 100644
index 0000000..ddd9b69
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/tilt.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/timings.js b/site/linear-algebra/ch01/audio/en/timings.js
new file mode 100644
index 0000000..accd8c7
--- /dev/null
+++ b/site/linear-algebra/ch01/audio/en/timings.js
@@ -0,0 +1,720 @@
+window.TIMINGS = {
+ "intro": {
+ "dur": 12.744,
+ "marks": {
+ "sub": 3.138,
+ "move": 9.609
+ },
+ "cues": [
+ [
+ 0.104,
+ "Chapter one."
+ ],
+ [
+ 1.12,
+ "One equation, one line."
+ ],
+ [
+ 3.138,
+ "In this chapter you'll see that an equation with two unknowns is really a picture: a straight line."
+ ],
+ [
+ 9.609,
+ "And when you change its numbers, the line moves."
+ ]
+ ]
+ },
+ "unknowns": {
+ "dur": 51.84,
+ "marks": {
+ "eq": 4.128,
+ "q": 6.081,
+ "x1": 11.68,
+ "y3": 16.146,
+ "ok1": 17.708,
+ "pair1": 20.677,
+ "r2": 28.06,
+ "r3": 32.695,
+ "r4": 37.513,
+ "many": 42.643
+ },
+ "cues": [
+ [
+ 0.117,
+ "Here's an equation with two unknowns, x and y."
+ ],
+ [
+ 4.128,
+ "x plus y equals four."
+ ],
+ [
+ 6.081,
+ "An unknown is just a number we haven't found yet."
+ ],
+ [
+ 9.258,
+ "So, which numbers make this true?"
+ ],
+ [
+ 11.68,
+ "Let's try x equals one."
+ ],
+ [
+ 13.646,
+ "Then one plus y has to be four, so y must be three."
+ ],
+ [
+ 17.708,
+ "One plus three is four."
+ ],
+ [
+ 19.635,
+ "It works."
+ ],
+ [
+ 20.677,
+ "So x equals one, y equals three is a solution."
+ ],
+ [
+ 25.143,
+ "We write it as a pair: one, three."
+ ],
+ [
+ 28.06,
+ "Try x equals two."
+ ],
+ [
+ 29.596,
+ "Two plus two is four, so y is two."
+ ],
+ [
+ 32.695,
+ "x equals four: four plus zero is four, so y is zero."
+ ],
+ [
+ 37.513,
+ "Negative numbers are allowed too."
+ ],
+ [
+ 39.635,
+ "Negative one plus five is four."
+ ],
+ [
+ 42.643,
+ "One equation, and already four solutions."
+ ],
+ [
+ 45.911,
+ "In fact there are endlessly many, and every one of them is a pair: an x and a y."
+ ]
+ ]
+ },
+ "points": {
+ "dur": 42.792,
+ "marks": {
+ "axes": 2.552,
+ "p1": 6.979,
+ "p2": 13.398,
+ "p3": 15.625,
+ "p4": 18.932,
+ "look": 22.461,
+ "line": 24.128,
+ "half": 25.99,
+ "halfp": 30.846,
+ "rule": 33.112,
+ "name": 38.906
+ },
+ "cues": [
+ [
+ 0.104,
+ "A pair of numbers is also a point."
+ ],
+ [
+ 2.552,
+ "Here are the x axis, going right, and the y axis, going up."
+ ],
+ [
+ 6.979,
+ "The pair one, three means: start at the middle, go one step right, then three steps up."
+ ],
+ [
+ 13.398,
+ "Two, two: two right, two up."
+ ],
+ [
+ 15.625,
+ "Four, zero: four right, and no steps up."
+ ],
+ [
+ 18.932,
+ "Negative one, five: one step left, five up."
+ ],
+ [
+ 22.461,
+ "Now look at the four points."
+ ],
+ [
+ 24.128,
+ "They sit on one straight line."
+ ],
+ [
+ 25.99,
+ "And it isn't only whole numbers."
+ ],
+ [
+ 27.786,
+ "One and a half plus two and a half is four, and that point is on the line too."
+ ],
+ [
+ 33.112,
+ "Every point on this line is a solution."
+ ],
+ [
+ 35.938,
+ "And every solution is a point on this line."
+ ],
+ [
+ 38.906,
+ "So the equation x plus y equals four is this line."
+ ]
+ ]
+ },
+ "off": {
+ "dur": 23.16,
+ "marks": {
+ "p": 2.279,
+ "sum": 3.88,
+ "no": 7.161,
+ "above": 10.469,
+ "p2": 13.75,
+ "below": 17.852,
+ "end": 19.375
+ },
+ "cues": [
+ [
+ 0.091,
+ "What about a point that's not on the line?"
+ ],
+ [
+ 2.279,
+ "Take three, three."
+ ],
+ [
+ 3.88,
+ "Three plus three is six, not four."
+ ],
+ [
+ 7.161,
+ "So three, three is not a solution."
+ ],
+ [
+ 10.469,
+ "And it sits above the line, where the sum is too big."
+ ],
+ [
+ 13.75,
+ "Now take one, one."
+ ],
+ [
+ 15.195,
+ "One plus one is two."
+ ],
+ [
+ 16.823,
+ "Too small."
+ ],
+ [
+ 17.852,
+ "It sits below the line."
+ ],
+ [
+ 19.375,
+ "Only on the line is x plus y exactly four."
+ ]
+ ]
+ },
+ "q1": {
+ "dur": 4.776,
+ "marks": {},
+ "cues": [
+ [
+ 0.091,
+ "Quick check."
+ ],
+ [
+ 1.172,
+ "Click any point that solves x minus y equals two."
+ ]
+ ]
+ },
+ "slide": {
+ "dur": 30.384,
+ "marks": {
+ "four": 2.969,
+ "six": 5.755,
+ "up": 8.216,
+ "zero": 12.474,
+ "origin": 13.854,
+ "neg": 21.237,
+ "par": 25.143
+ },
+ "cues": [
+ [
+ 0.104,
+ "Now let's change the numbers and watch the line."
+ ],
+ [
+ 2.969,
+ "Here is x plus y equals four again."
+ ],
+ [
+ 5.755,
+ "Change the four into a six."
+ ],
+ [
+ 8.216,
+ "The line slides up."
+ ],
+ [
+ 9.57,
+ "Its points now add up to six instead of four."
+ ],
+ [
+ 12.474,
+ "Change it to zero."
+ ],
+ [
+ 13.854,
+ "Now the line runs through the origin, the point zero, zero, because zero plus zero is zero."
+ ],
+ [
+ 21.237,
+ "Make it negative three, and the line slides further down."
+ ],
+ [
+ 25.143,
+ "Notice: changing the right side only slides the line."
+ ],
+ [
+ 29.193,
+ "It never turns it."
+ ]
+ ]
+ },
+ "tilt": {
+ "dur": 45.24,
+ "marks": {
+ "two": 3.425,
+ "steep": 8.008,
+ "why": 10.534,
+ "xa": 15.208,
+ "cross": 18.594,
+ "ya": 22.188,
+ "four": 26.745,
+ "three": 28.281,
+ "minus": 35.195,
+ "lean": 37.995,
+ "sum": 39.909
+ },
+ "cues": [
+ [
+ 0.104,
+ "The numbers in front of x and y do something else."
+ ],
+ [
+ 3.425,
+ "Change x plus y equals four into two x plus y equals four."
+ ],
+ [
+ 8.008,
+ "The line turns."
+ ],
+ [
+ 9.336,
+ "It's steeper now."
+ ],
+ [
+ 10.534,
+ "Here's why."
+ ],
+ [
+ 11.484,
+ "Where the line crosses the x axis, y is zero."
+ ],
+ [
+ 15.208,
+ "So two x equals four, and x equals two."
+ ],
+ [
+ 18.594,
+ "The line used to cross at four."
+ ],
+ [
+ 20.586,
+ "Now it crosses at two."
+ ],
+ [
+ 22.188,
+ "On the y axis, x is zero, so y is still four."
+ ],
+ [
+ 26.745,
+ "Same point as before."
+ ],
+ [
+ 28.281,
+ "Make it four x plus y equals four, and the line turns more."
+ ],
+ [
+ 32.982,
+ "It crosses the x axis at one."
+ ],
+ [
+ 35.195,
+ "Now try minus x plus y equals four."
+ ],
+ [
+ 37.995,
+ "The line leans the other way."
+ ],
+ [
+ 39.909,
+ "So the right side slides the line, and the numbers in front of x and y turn it."
+ ]
+ ]
+ },
+ "draw": {
+ "dur": 58.848,
+ "marks": {
+ "eq": 5.664,
+ "x0": 8.906,
+ "y2": 13.177,
+ "p1": 14.57,
+ "y0": 18.19,
+ "x3": 22.409,
+ "p2": 24.362,
+ "line": 28.073,
+ "check": 30.729,
+ "ex2": 43.711,
+ "a": 47.018,
+ "b": 52.253,
+ "line2": 55.234
+ },
+ "cues": [
+ [
+ 0.104,
+ "So how do you draw a line from its equation, fast?"
+ ],
+ [
+ 3.216,
+ "Find two points, and connect them."
+ ],
+ [
+ 5.664,
+ "Take two x plus three y equals six."
+ ],
+ [
+ 8.906,
+ "First, set x to zero."
+ ],
+ [
+ 11.185,
+ "Then three y equals six, so y is two."
+ ],
+ [
+ 14.57,
+ "That's the point zero, two, on the y axis."
+ ],
+ [
+ 18.19,
+ "Next, set y to zero."
+ ],
+ [
+ 20.495,
+ "Then two x equals six, so x is three."
+ ],
+ [
+ 24.362,
+ "That's the point three, zero, on the x axis."
+ ],
+ [
+ 28.073,
+ "Connect the two points, and there's the line."
+ ],
+ [
+ 30.729,
+ "Check a third point to be safe: six, minus two."
+ ],
+ [
+ 34.701,
+ "Two times six is twelve, three times minus two is minus six, and twelve minus six is six."
+ ],
+ [
+ 42.656,
+ "It's on the line."
+ ],
+ [
+ 43.711,
+ "One more: x minus two y equals four."
+ ],
+ [
+ 47.018,
+ "x zero gives minus two y equals four, so y is minus two."
+ ],
+ [
+ 52.253,
+ "y zero gives x equals four."
+ ],
+ [
+ 55.234,
+ "Connect zero, minus two and four, zero."
+ ]
+ ]
+ },
+ "q2": {
+ "dur": 3.552,
+ "marks": {},
+ "cues": [
+ [
+ 0.104,
+ "Quick check."
+ ],
+ [
+ 1.107,
+ "Where does this line cross the axes?"
+ ]
+ ]
+ },
+ "origin": {
+ "dur": 36.48,
+ "marks": {
+ "eq": 2.24,
+ "x0": 4.844,
+ "y0": 8.125,
+ "same": 12.096,
+ "x1": 17.604,
+ "p": 23.451,
+ "line": 24.779,
+ "note": 29.062
+ },
+ "cues": [
+ [
+ 0.104,
+ "One case needs a little care."
+ ],
+ [
+ 2.24,
+ "Two x minus y equals zero."
+ ],
+ [
+ 4.844,
+ "Set x to zero: then y is zero."
+ ],
+ [
+ 8.125,
+ "Set y to zero: then x is zero."
+ ],
+ [
+ 12.096,
+ "Both times we land on the same point, the origin."
+ ],
+ [
+ 15.312,
+ "One point isn't enough to draw a line."
+ ],
+ [
+ 17.604,
+ "So pick another x, say one."
+ ],
+ [
+ 19.831,
+ "Two minus y equals zero, so y is two."
+ ],
+ [
+ 23.451,
+ "The point one, two."
+ ],
+ [
+ 24.779,
+ "Now we have two points, and the line goes through the origin."
+ ],
+ [
+ 29.062,
+ "This happens whenever the right side is zero."
+ ],
+ [
+ 32.305,
+ "Keep this line in mind: it's the first equation in our next chapter."
+ ]
+ ]
+ },
+ "flat": {
+ "dur": 24.912,
+ "marks": {
+ "eq1": 1.55,
+ "zero": 2.826,
+ "h": 8.763,
+ "eq2": 12.331,
+ "v": 16.81,
+ "sum": 21.12
+ },
+ "cues": [
+ [
+ 0.104,
+ "What if a letter is missing?"
+ ],
+ [
+ 1.55,
+ "y equals two."
+ ],
+ [
+ 2.826,
+ "That's really zero x plus y equals two."
+ ],
+ [
+ 6.003,
+ "x can be anything, and y must be two."
+ ],
+ [
+ 8.763,
+ "So the line is flat: every point at height two."
+ ],
+ [
+ 12.331,
+ "And x equals three is zero y plus x equals three."
+ ],
+ [
+ 16.81,
+ "y can be anything, x must be three."
+ ],
+ [
+ 19.505,
+ "The line stands straight up."
+ ],
+ [
+ 21.12,
+ "A zero in front of a letter means that letter is free."
+ ]
+ ]
+ },
+ "q3": {
+ "dur": 7.032,
+ "marks": {},
+ "cues": [
+ [
+ 0.104,
+ "Your turn."
+ ],
+ [
+ 1.068,
+ "Change the numbers, or drag the line, until it passes through both marked points."
+ ]
+ ]
+ },
+ "wrap": {
+ "dur": 23.808,
+ "marks": {
+ "w1": 0.977,
+ "w2": 6.849,
+ "w3": 10.312,
+ "w4": 15.508,
+ "end": 21.693
+ },
+ "cues": [
+ [
+ 0.104,
+ "To sum up."
+ ],
+ [
+ 0.977,
+ "An equation in x and y has many solutions, and each is a pair of numbers."
+ ],
+ [
+ 6.849,
+ "Drawn as points, the solutions make a straight line."
+ ],
+ [
+ 10.312,
+ "The right side slides the line."
+ ],
+ [
+ 12.76,
+ "The numbers in front of x and y turn it."
+ ],
+ [
+ 15.508,
+ "To draw the line, set x to zero, then y to zero, and connect the two points."
+ ],
+ [
+ 21.693,
+ "Now try the chapter practice."
+ ]
+ ]
+ },
+ "final1": {
+ "dur": 3.0,
+ "marks": {},
+ "cues": [
+ [
+ 0.104,
+ "Chapter practice."
+ ],
+ [
+ 1.523,
+ "Is the point a solution?"
+ ]
+ ]
+ },
+ "final2": {
+ "dur": 2.256,
+ "marks": {},
+ "cues": [
+ [
+ 0.104,
+ "Next, find the missing number."
+ ]
+ ]
+ },
+ "final3": {
+ "dur": 3.504,
+ "marks": {},
+ "cues": [
+ [
+ 0.091,
+ "Now find where each line crosses the axes."
+ ]
+ ]
+ },
+ "final4": {
+ "dur": 3.072,
+ "marks": {},
+ "cues": [
+ [
+ 0.104,
+ "Last set."
+ ],
+ [
+ 1.185,
+ "Make the line with your hands."
+ ]
+ ]
+ },
+ "finish": {
+ "dur": 8.424,
+ "marks": {},
+ "cues": [
+ [
+ 0.104,
+ "Well done."
+ ],
+ [
+ 1.094,
+ "That's the end of chapter one, one equation, one line."
+ ],
+ [
+ 4.805,
+ "Next: two equations, and the one point they share."
+ ]
+ ]
+ }
+};
diff --git a/site/linear-algebra/ch01/audio/en/unknowns.mp3 b/site/linear-algebra/ch01/audio/en/unknowns.mp3
new file mode 100644
index 0000000..447b718
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/unknowns.mp3 differ
diff --git a/site/linear-algebra/ch01/audio/en/wrap.mp3 b/site/linear-algebra/ch01/audio/en/wrap.mp3
new file mode 100644
index 0000000..62fa31d
Binary files /dev/null and b/site/linear-algebra/ch01/audio/en/wrap.mp3 differ
diff --git a/site/linear-algebra/ch01/index.html b/site/linear-algebra/ch01/index.html
new file mode 100644
index 0000000..699a488
--- /dev/null
+++ b/site/linear-algebra/ch01/index.html
@@ -0,0 +1,392 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>One Equation, One Line</title>
+<link rel="stylesheet" href="../lib/engine.css">
+<link rel="expect" href="#bar" blocking="render"><!-- hold the first frame until the player exists, so the page transition can run -->
+</head>
+<body>
+<script src="../lib/engine.js"></script>
+<script src="../lib/math.js"></script>
+<script src="../lib/linsys.js"></script>
+<script src="audio/en/timings.js"></script>
+<script>
+'use strict';
+const CHAPTER = { number: 1, title: 'One Equation, One Line', minutes: 10, language: 'en' };
+
+/* ---------- chapter drawing helpers ---------- */
+const LINE = LS_ROW[0]; // the one equation's line: blue, as row 1 everywhere in the book
+const CARD = { x: 40, y: 290, w: 720, cls: 'side' }; // question card under the equation, beside the plane
+const say = (p, parts, x, y, t0, { size = 40, fill = COL.chalk, anchor = 'start' } = {}) => { const e = M(p, [].concat(parts), { x, y, size, fill, anchor, o: 0 }); show(e, t0); return e; };
+const text = (p, str, x, y, t0, { size = 30, fill = COL.chalk, anchor = 'start', weight = 500 } = {}) => { const e = T(p, str, { x, y, size, fill, anchor, weight, o: 0 }); show(e, t0); return e; };
+// One equation a·x + b·y = c in the top left, the plane on the right; the line hidden until a beat shows it.
+const oneLine = (p, a, b, c, { t0 = .1, hidden = false, hidePlane = false } = {}) => {
+ const sys = linsys(p, { rows: 1, A: [[a, b], [0, 0]], b: [c, 0], eq: [90, 200], t0, hidePlane });
+ if (hidden) put(sys.lines[0].l, { o: 0 });
+ return sys;
+};
+const flash = (sys, key, t0) => sys.num(key).forEach(e => { tw(e, { c_fill: COL.task }, t0, .25); tw(e, { c_fill: COL.chalk }, t0 + 1.2, .6); });
+const pairStr = (x, y) => `(${num(x)}, ${num(y)})`;
+// A point of the plane with its label, dropped in from a little above.
+const drop = (sys, x, y, t0, color = COL.chalk, label = pairStr(x, y), dx = 16, dy = -16, into) => sys.P.dot(x, y, color, t0, { label, dx, dy, into });
+// Two dashed guide lines from the axes to a point (or one, on an axis).
+const guides = (sys, x, y, t0, into) => {
+ const { PX, PY } = sys.P, g = G(into, { o: 0 });
+ path(g, `M${PX(x)} ${PY(0)}V${PY(y)}M${PX(0)} ${PY(y)}H${PX(x)}`, { stroke: COL.dim, 'stroke-width': 2, 'stroke-dasharray': '6 7', fill: 'none' });
+ show(g, t0, .4);
+ return g;
+};
+
+/* ---------- practice data ---------- */
+const YN = [['y', 'Yes', null, 'Y'], ['n', 'No', null, 'N']];
+const SOLQ = [
+ { parts: ['Is ', $m('(2, 1)'), ' a solution of ', $m('x + 3y = 5'), '?'], ans: ['y'], why: '2 + 3·1 = 5. Yes.' },
+ { parts: ['Is ', $m('(1, 2)'), ' a solution of ', $m('x + 3y = 5'), '?'], ans: ['n'], why: '1 + 3·2 = 7, not 5. Order matters: x comes first.' },
+ { parts: ['Is ', $m('(−1, 2)'), ' a solution of ', $m('2x + y = 0'), '?'], ans: ['y'], why: '2·(−1) + 2 = −2 + 2 = 0. Yes.' },
+ { parts: ['Is ', $m('(3, 1)'), ' a solution of ', $m('x − y = 4'), '?'], ans: ['n'], why: '3 − 1 = 2, not 4.' },
+ { parts: ['Is ', $m('(0, −3)'), ' a solution of ', $m('4x − y = 3'), '?'], ans: ['y'], why: '4·0 − (−3) = 0 + 3 = 3. Yes.' },
+ { parts: ['Is ', $m('(5, 5)'), ' a solution of ', $m('x + y = 5'), '?'], ans: ['n'], why: '5 + 5 = 10, not 5.' },
+];
+const MISSQ = [
+ { parts: ['x + y = 7, x = 3: y = ', { box: '4' }], why: '3 + y = 7, so y = 4.', hint: 'Put 3 in place of x. What must y be?' },
+ { parts: ['2x + y = 10, x = 4: y = ', { box: '2' }], why: '8 + y = 10, so y = 2.', hint: '2 times 4 is 8. What makes 8 + y equal 10?' },
+ { parts: ['x − y = 5, y = 2: x = ', { box: '7' }], why: 'x − 2 = 5, so x = 7.', hint: 'Put 2 in place of y. What minus 2 is 5?' },
+ { parts: ['3x + 2y = 12, x = 0: y = ', { box: '6' }], why: '0 + 2y = 12, so y = 6.', hint: 'With x = 0 the 3x part is 0. Then 2y = 12.' },
+ { parts: ['x + 4y = 2, y = −1: x = ', { box: '6' }], why: 'x − 4 = 2, so x = 6.', hint: '4 times −1 is −4. What minus 4 is 2?' },
+ { parts: ['−x + y = 3, x = −2: y = ', { box: '1' }], why: '2 + y = 3, so y = 1. (Minus negative two is plus two.)', hint: '−x with x = −2 is +2.' },
+];
+const CROSSQ = [
+ { parts: ['x + 2y = 8: x-axis at (', { box: '8' }, ', 0), y-axis at (0, ', { box: '4' }, ')'], why: 'y = 0 gives x = 8; x = 0 gives 2y = 8, y = 4.' },
+ { parts: ['3x + y = 6: x-axis at (', { box: '2' }, ', 0), y-axis at (0, ', { box: '6' }, ')'], why: 'y = 0 gives 3x = 6, x = 2; x = 0 gives y = 6.' },
+ { parts: ['4x − 2y = 8: x-axis at (', { box: '2' }, ', 0), y-axis at (0, ', { box: '-4' }, ')'], why: 'y = 0 gives 4x = 8, x = 2; x = 0 gives −2y = 8, y = −4.' },
+ { parts: ['−x + 3y = 6: x-axis at (', { box: '-6' }, ', 0), y-axis at (0, ', { box: '2' }, ')'], why: 'y = 0 gives −x = 6, x = −6; x = 0 gives 3y = 6, y = 2.' },
+];
+const TURNQ = [
+ { parts: ['x + y = 4 becomes x + y = 9'], ans: ['s'], why: 'Only the right side changed: the line slides.' },
+ { parts: ['x + y = 4 becomes 3x + y = 4'], ans: ['t'], why: 'The number in front of x changed: the line turns.' },
+ { parts: ['2x − y = 1 becomes 2x − y = −5'], ans: ['s'], why: 'Only the right side changed.' },
+ { parts: ['2x − y = 1 becomes 2x + y = 1'], ans: ['t'], why: 'The number in front of y changed from −1 to 1: the line turns.' },
+];
+
+/* ---------- beats: [id, title, run(m, D), { ask }?] ---------- */
+const BEATS = [
+ ['intro', 'One equation, one line', (m, D) => {
+ const g = G(scene, { o: 0, y: 24 });
+ T(g, 'Unit 1, Chapter 1', { x: 800, y: 320, size: 28, fill: COL.dim, anchor: 'middle' });
+ T(g, 'One Equation, One Line', { x: 800, y: 430, size: 88, weight: 600, anchor: 'middle' });
+ tw(g, { o: 1, y: 0 }, .2, 1.1, out);
+ const r = text(scene, 'an equation in x and y is a picture', 800, 560, m('sub'), { size: 36, fill: COL.dim, anchor: 'middle' });
+ // a small line that turns as the narration says the numbers move it
+ const lg = G(scene, { x: 800, y: 680, o: 0 });
+ path(lg, 'M-160 0H160', { stroke: LINE, 'stroke-width': 6, 'stroke-linecap': 'round' });
+ show(lg, m('move'), .4); tw(lg, { r: -18 }, m('move') + .5, 1.2); tw(lg, { y: 650 }, m('move') + 1.8, .8);
+ tw(g, { o: 0, y: -24 }, D - .9, .8); hide(r, D - .9, .8); hide(lg, D - .9, .8);
+ }],
+
+ ['unknowns', 'Two unknowns', (m) => {
+ const p = S.p = panel(0);
+ text(p, 'One equation, two unknowns', 60, 110, .2, { size: 40, weight: 600 });
+ const sys = S.sys = oneLine(p, 1, 1, 4, { t0: m('eq') - .3, hidden: true, hidePlane: true });
+ const q = text(p, 'an unknown = a number we have not found yet', 90, 300, m('q'), { size: 28, fill: COL.dim });
+ hide(q, m('x1') - .4, .4);
+ // the table of tries: x, y, x + y
+ const tx = [130, 250, 420], ty = 330, rh = 64;
+ const head = G(p, { o: 0 });
+ ['x', 'y', 'x + y'].forEach((h, j) => M(head, [h], { x: tx[j], y: ty, size: 34, fill: COL.dim, anchor: 'middle' }));
+ path(head, `M70 ${ty + 18}H560`, { stroke: COL.faint, 'stroke-width': 2 });
+ show(head, m('x1'));
+ const rows = [[1, 3], [2, 2], [4, 0], [-1, 5]];
+ const at = [[m('x1'), m('y3'), m('ok1')], [m('r2'), m('r2') + .9, m('r2') + 2], [m('r3'), m('r3') + .9, m('r3') + 2], [m('r4'), m('r4') + 1.2, m('r4') + 2.4]];
+ rows.forEach(([x, y], i) => {
+ const yy = ty + 66 + i * rh;
+ say(p, [num(x)], tx[0], yy, at[i][0], { size: 38, anchor: 'middle', fill: COL.whole });
+ say(p, [num(y)], tx[1], yy, at[i][1], { size: 38, anchor: 'middle', fill: COL.nat });
+ say(p, [`${num(x)} + ${y} = 4`], tx[2], yy, at[i][2], { size: 34, anchor: 'middle' });
+ text(p, '✓', 540, yy, at[i][2] + .3, { size: 34, fill: COL.good, anchor: 'middle', weight: 700 });
+ });
+ // each solution becomes a chip on the right: a pair (x, y)
+ const lab = text(p, 'solutions', 1160, 260, m('pair1') - .3, { size: 30, fill: COL.dim, anchor: 'middle' });
+ S.chips = rows.map(([x, y], i) => {
+ const c = chip(p, [pairStr(x, y)], COL.chalk, { x: 1040 + (i % 2) * 240, y: 340 + Math.floor(i / 2) * 100, size: 38 });
+ put(c, { o: 0, s: .6 });
+ tw(c, { o: 1, s: 1 }, i ? at[i][2] + .5 : m('pair1') + .4, .5, back);
+ return c;
+ });
+ [[1, tx[0], COL.whole, -34], [3, tx[1], COL.nat, 34]].forEach(([n, x, fill, dx]) => {
+ const f = M(p, [String(n)], { x, y: ty + 66, size: 38, fill, anchor: 'middle', o: 0 });
+ tw(f, { o: 1 }, m('pair1'), .1);
+ tw(f, { x: 1040 + dx * .65, y: 353 }, m('pair1'), .9); // into the chip (1, 3)
+ hide(f, m('pair1') + .9, .2);
+ });
+ const order = text(p, 'x first, then y', 1040, 400, m('pair1') + 3, { size: 24, fill: COL.dim, anchor: 'middle' });
+ hide(order, m('r2') + .5, .4);
+ const extra = [[0, 4], [3, 1], [6, -2], [0.5, 3.5], [-3, 7], [10, -6]].map(([x, y], i) => {
+ const c = chip(p, [pairStr(x, y)], COL.dim, { x: 980 + (i % 3) * 180, y: 520 + Math.floor(i / 3) * 70, size: 28 });
+ put(c, { o: 0, s: .5 }); tw(c, { o: .8, s: 1 }, m('many') + 1 + i * .55, .4, back);
+ return c;
+ });
+ const more = text(p, '… and endlessly many more', 1160, 690, m('many') + 4.6, { size: 30, fill: COL.task, anchor: 'middle', weight: 600 });
+ S.unk = [lab, more, ...extra];
+ }],
+
+ ['points', 'Pairs are points', (m) => {
+ const p = S.p, sys = S.sys, { PX, PY } = sys.P;
+ S.unk.forEach(e => hide(e, .1, .4));
+ show(sys.stage, m('axes') - .4, .6);
+ const pts = [[1, 3, 'p1'], [2, 2, 'p2'], [4, 0, 'p3'], [-1, 5, 'p4']];
+ S.chips.forEach((c, i) => {
+ const [x, y, mk_] = pts[i], t = m(mk_);
+ tw(c, { x: PX(x) + (x < 0 ? -78 : 78), y: PY(y) - 4, s: .62 }, t, 1.1);
+ if (i === 0) { // the first one walks: right, then up
+ sys.P.walk(1, 3, t + 1.2, { into: p });
+ } else drop(sys, x, y, t + .9, COL.chalk, '');
+ });
+ show(sys.lines[0].l, m('line'), 1);
+ drop(sys, 1.5, 2.5, m('halfp'), COL.task, '');
+ const hl = say(p, ['1.5 + 2.5 = 4'], 1330, PY(2.5) - 16, m('half') + .4, { size: 30, fill: COL.task, anchor: 'start' });
+ hide(hl, m('rule'), .5);
+ const probe = G(p, { o: 0 }), pr = mk('circle', { r: 12, fill: COL.task, stroke: COL.board, 'stroke-width': 3 }, probe);
+ const pt = T(probe, '', { x: 20, y: -18, size: 28, fill: COL.task, font: MATH, weight: 600 });
+ show(probe, m('rule') - .2, .3);
+ prog(q => {
+ const x = -1.5 + q * 7, y = 4 - x;
+ put(probe, { x: PX(x), y: PY(y) });
+ const rx = Math.round(x * 10) / 10, ry = Math.round(y * 10) / 10, s = `${num(rx)} + ${ry < 0 ? `(${num(ry)})` : num(ry)} = 4`;
+ if (pt.textContent !== s) pt.textContent = s;
+ }, m('rule') - .2, m('name') - m('rule') + .2, io);
+ hide(probe, m('name') + .2, .4);
+ S.rule = G(p, { o: 0 });
+ T(S.rule, 'on the line = a solution', { x: 90, y: 680, size: 36, weight: 600, fill: LINE });
+ show(S.rule, m('rule'));
+ tw(sys.lines[0].l, { 'a_stroke-width': 10 }, m('name'), .35); tw(sys.lines[0].l, { 'a_stroke-width': 5 }, m('name') + .9, .6);
+ flash(sys, 'b0', m('name')); flash(sys, 'a00', m('name')); flash(sys, 'a01', m('name'));
+ }],
+
+ ['off', 'Off the line', (m) => {
+ const p = S.p, sys = S.sys;
+ hide(S.rule, .1, .4);
+ drop(sys, 3, 3, m('p'), COL.bad);
+ say(p, ['3 + 3 = 6'], 90, 680, m('sum'), { size: 38, fill: COL.bad });
+ const no = text(p, 'not 4: not a solution', 300, 680, m('no'), { size: 30, fill: COL.bad, weight: 600 });
+ sys.P.half(1, 1, 4, COL.nat, m('above'), { o: .09 });
+ text(p, 'sum too big', 1330, 200, m('above') + .3, { size: 28, fill: COL.nat, weight: 600, anchor: 'middle' });
+ drop(sys, 1, 1, m('p2'), COL.whole);
+ say(p, ['1 + 1 = 2'], 90, 750, m('p2') + .6, { size: 38, fill: COL.whole });
+ text(p, 'not 4 either', 300, 750, m('p2') + 1.6, { size: 30, fill: COL.whole, weight: 600 });
+ sys.P.half(-1, -1, -4, COL.whole, m('below'), { o: .08 });
+ text(p, 'sum too small', 960, 720, m('below') + .3, { size: 28, fill: COL.whole, weight: 600, anchor: 'middle' });
+ tw(sys.lines[0].l, { 'a_stroke-width': 10 }, m('end'), .35); tw(sys.lines[0].l, { 'a_stroke-width': 5 }, m('end') + .9, .6);
+ hide(no, m('end') + 2, .5);
+ }],
+
+ ['q1', 'Quick check', () => {
+ const p = panel(0);
+ text(p, 'Quick check', 60, 110, .2, { size: 40, weight: 600 });
+ S.sys = oneLine(p, 1, -1, 2, { hidden: true });
+ }, { ask: done => quiz(CARD, [{
+ id: 'c-point', prompt: ['Click any point that solves ', $m('x − y = 2'), '.'],
+ build: pickPoint(S.sys.P, [2, 0], (x, y) => `${pairStr(x, y)} works: ${num(x)} − ${y < 0 ? `(${num(y)})` : num(y)} = 2. Every point on the line does too.`,
+ (x, y) => `${num(x)} − ${y < 0 ? `(${num(y)})` : num(y)} = ${num(x - y)}, not 2. Try a pair where x is 2 more than y, like (3, 1).`,
+ () => fx(S.sys.lines[0].l, { o: 1 }, .3, .8), (x, y) => x - y === 2),
+ }], done) }],
+
+ ['slide', 'The right side slides it', (m) => {
+ const p = panel(0);
+ text(p, 'Change the right side', 60, 110, .2, { size: 40, weight: 600 });
+ const sys = S.sys = oneLine(p, 1, 1, 4);
+ const ghost = S.ghost = G(p, {});
+ const keep = (c, t) => { const l = sys.P.line(0, c, 1, c - 1, LINE, t, { into: ghost, dash: '10 10', w: 3 }); tw(l, { o: .35 }, t + .6, .4); };
+ keep(4, m('six'));
+ sys.to({ b0: 6 }, m('six'), 1.4); flash(sys, 'b0', m('six'));
+ keep(6, m('zero'));
+ sys.to({ b0: 0 }, m('zero'), 1.6); flash(sys, 'b0', m('zero'));
+ drop(sys, 0, 0, m('origin'), COL.task, '(0, 0)', 16, 34);
+ say(p, ['0 + 0 = 0'], 90, 330, m('origin') + .5, { size: 38, fill: COL.task });
+ keep(0, m('neg'));
+ sys.to({ b0: -3 }, m('neg'), 1.4); flash(sys, 'b0', m('neg'));
+ const n = G(p, { o: 0 });
+ T(n, 'right side changes:', { x: 90, y: 460, size: 32, fill: COL.dim });
+ T(n, 'the line slides, never turns', { x: 90, y: 510, size: 36, weight: 600, fill: COL.task });
+ show(n, m('par'));
+ S.slideNote = n;
+ }],
+
+ ['tilt', 'The other numbers turn it', (m) => {
+ const p = S.p = panel(0); // a fresh picture: the ghosts and notes of 'slide' go
+ text(p, 'Change the numbers in front of x and y', 60, 110, .2, { size: 40, weight: 600 });
+ const sys = S.sys = oneLine(p, 1, 1, 4);
+ sys.to({ a00: 2 }, m('two'), 1.6); flash(sys, 'a00', m('two'));
+ const old = sys.P.line(0, 4, 4, 0, LINE, m('two'), { dash: '10 10', w: 3 }); tw(old, { o: .35 }, m('two') + .6, .4);
+ // where it crosses the x axis
+ const work = G(p, {});
+ say(work, ['on the x-axis, y = 0:'], 90, 330, m('why'), { size: 32, fill: COL.dim });
+ const w1 = say(work, ['2x = 4, x = 2'], 90, 385, m('xa'), { size: 40 });
+ const g1 = guides(sys, 2, 0, m('cross'), p);
+ const c2 = drop(sys, 2, 0, m('cross'), COL.task, '', 10, 36), c2l = say(p, ['(2, 0)'], sys.P.PX(2) + 6, sys.P.PY(0) + 40, m('cross') + .2, { size: 26, fill: COL.task });
+ const was = drop(sys, 4, 0, m('cross') + .8, COL.faint, '', 10, 36);
+ say(work, ['on the y-axis, x = 0:'], 90, 460, m('ya'), { size: 32, fill: COL.dim });
+ say(work, ['y = 4'], 90, 515, m('ya') + 1.2, { size: 40 });
+ drop(sys, 0, 4, m('four'), COL.task, '(0, 4) same', 16, -10);
+ [g1, was, c2, c2l].forEach(e => hide(e, m('three') - .3, .3));
+ sys.to({ a00: 4 }, m('three'), 1.4); flash(sys, 'a00', m('three'));
+ hide(w1, m('three') - .3, .3);
+ say(work, ['4x = 4, x = 1'], 90, 385, m('three') + 1, { size: 40 });
+ const c1 = drop(sys, 1, 0, m('three') + 2.4, COL.task, '(1, 0)', 10, 36);
+ hide(work, m('minus') - .3, .4); hide(c1, m('minus') - .3, .4);
+ sys.to({ a00: -1 }, m('minus'), 1.8); flash(sys, 'a00', m('minus'));
+ const n = G(p, { o: 0 });
+ T(n, 'right side: slides the line', { x: 90, y: 630, size: 34, weight: 600, fill: COL.task });
+ T(n, 'numbers in front of x, y: turn it', { x: 90, y: 682, size: 34, weight: 600, fill: COL.whole });
+ show(n, m('sum'));
+ }],
+
+ ['draw', 'Draw it from two points', (m) => {
+ const p = panel(0);
+ text(p, 'Drawing a line: find two points', 60, 110, .2, { size: 40, weight: 600 });
+ const sys = S.sys = oneLine(p, 2, 3, 6, { t0: m('eq') - .3, hidden: true });
+ const l = sys.lines[0].l;
+ const steps = G(p, {});
+ say(steps, ['x = 0:'], 90, 330, m('x0'), { size: 32, fill: COL.dim });
+ say(steps, ['3y = 6, y = 2'], 220, 330, m('x0') + 1.5, { size: 38 });
+ drop(sys, 0, 2, m('p1'), COL.task, '(0, 2)', 16, -16, steps);
+ say(steps, ['y = 0:'], 90, 400, m('y0'), { size: 32, fill: COL.dim });
+ say(steps, ['2x = 6, x = 3'], 220, 400, m('y0') + 1.5, { size: 38 });
+ drop(sys, 3, 0, m('p2'), COL.task, '(3, 0)', 10, 36, steps);
+ show(l, m('line'), .9);
+ say(steps, ['check (6, −2):'], 90, 480, m('check'), { size: 32, fill: COL.dim });
+ say(steps, ['2·6'], 90, 535, m('check') + 3, { size: 36 });
+ say(steps, ['+ 3·(−2)'], 150, 535, m('check') + 5.2, { size: 36 });
+ say(steps, ['= 12 − 6'], 300, 535, m('check') + 8, { size: 36 });
+ say(steps, ['= 6 ✓'], 455, 535, m('check') + 10.6, { size: 36, fill: COL.good });
+ drop(sys, 6, -2, m('check') + 1, COL.good, '(6, −2)', -96, 10, steps);
+ // second example: the same plane, a new equation
+ hide(steps, m('ex2') - .5, .4);
+ hide(l, m('ex2') - .5, .3);
+ sys.to({ a00: 1, a01: -2, b0: 4 }, m('ex2'), .1);
+ const s2 = G(p, {});
+ say(s2, ['x = 0:'], 90, 330, m('a'), { size: 32, fill: COL.dim });
+ say(s2, ['−2y = 4, y = −2'], 220, 330, m('a') + 2, { size: 38 });
+ drop(sys, 0, -2, m('a') + 3, COL.irr, '(0, −2)', 16, 34);
+ say(s2, ['y = 0:'], 90, 400, m('b'), { size: 32, fill: COL.dim });
+ say(s2, ['x = 4'], 220, 400, m('b') + 1, { size: 38 });
+ drop(sys, 4, 0, m('b') + 1.5, COL.irr, '(4, 0)', 10, -16);
+ show(l, m('line2'), .9);
+ }],
+
+ ['q2', 'Quick check', () => {
+ const p = panel(0);
+ text(p, 'Quick check', 60, 110, .2, { size: 40, weight: 600 });
+ S.sys = oneLine(p, 3, 2, 6);
+ }, { ask: done => quiz(CARD, [{
+ id: 'c-cross', prompt: ['Where does ', $m('3x + 2y = 6'), ' cross the axes?'],
+ build: blanks([
+ { parts: ['x-axis (y = 0): (', { box: '2' }, ', 0)'], why: 'y = 0 gives 3x = 6, so x = 2.', hint: 'Put y = 0. Then 3x = 6.',
+ fx: () => S.sys.P.dot(2, 0, COL.good, 0, { run: fx }) },
+ { parts: ['y-axis (x = 0): (0, ', { box: '3' }, ')'], why: 'x = 0 gives 2y = 6, so y = 3.', hint: 'Put x = 0. Then 2y = 6.',
+ fx: () => S.sys.P.dot(0, 3, COL.good, 0, { run: fx }) },
+ ]),
+ }], done) }],
+
+ ['origin', 'When the right side is zero', (m) => {
+ const p = panel(0);
+ text(p, 'When the right side is zero', 60, 110, .2, { size: 40, weight: 600 });
+ const sys = S.sys = oneLine(p, 2, -1, 0, { t0: m('eq') - .3, hidden: true });
+ say(p, ['x = 0:'], 90, 330, m('x0'), { size: 32, fill: COL.dim });
+ say(p, ['−y = 0, y = 0'], 220, 330, m('x0') + 1, { size: 38 });
+ say(p, ['y = 0:'], 90, 400, m('y0'), { size: 32, fill: COL.dim });
+ say(p, ['2x = 0, x = 0'], 220, 400, m('y0') + 1, { size: 38 });
+ const o = drop(sys, 0, 0, m('x0') + 2, COL.task, '(0, 0)', 16, 34);
+ pulse(o, m('same')); pulse(o, m('same') + 1.2);
+ text(p, 'the same point twice: not enough for a line', 90, 470, m('same') + .6, { size: 30, fill: COL.bad, weight: 600 });
+ say(p, ['x = 1:'], 90, 550, m('x1'), { size: 32, fill: COL.dim });
+ say(p, ['2 − y = 0, y = 2'], 220, 550, m('x1') + 2, { size: 38 });
+ drop(sys, 1, 2, m('p'), COL.task);
+ show(sys.lines[0].l, m('line'), .9);
+ const n = G(p, { o: 0 });
+ T(n, 'right side 0 → the line passes through (0, 0)', { x: 90, y: 650, size: 32, weight: 600, fill: COL.task });
+ show(n, m('note'));
+ }],
+
+ ['flat', 'A missing letter', (m) => {
+ const p = panel(0);
+ text(p, 'When a letter is missing', 60, 110, .2, { size: 40, weight: 600 });
+ const big = say(p, ['y = 2'], 90, 330, m('eq1') - .2, { size: 54 });
+ const sys = S.sys = oneLine(p, 0, 1, 2, { t0: m('zero') - .2, hidden: true });
+ flash(sys, 'a00', m('zero') + .4);
+ show(sys.lines[0].l, m('h'), .9);
+ const hd = G(p, {});
+ [-3, 0, 3].forEach((x, i) => drop(sys, x, 2, m('h') + .6 + i * .3, COL.task, '', 0, 0, hd));
+ const fr = text(p, 'x is free, y must be 2', 90, 400, m('h') + .4, { size: 32, fill: COL.task, weight: 600 });
+ [big, hd, fr].forEach(e => hide(e, m('eq2') - .3, .3));
+ const big2 = say(p, ['x = 3'], 90, 330, m('eq2'), { size: 54 });
+ sys.to({ a00: 1, a01: 0, b0: 3 }, m('eq2') + .8, 1.8);
+ flash(sys, 'a01', m('eq2') + 1.5);
+ text(p, 'y is free, x must be 3', 90, 400, m('v') + .4, { size: 32, fill: COL.task, weight: 600 });
+ text(p, '0 in front of a letter = that letter is free', 90, 690, m('sum'), { size: 32, weight: 600 });
+ }],
+
+ ['q3', 'Your turn', () => {
+ const p = panel(0);
+ text(p, 'Your turn', 60, 110, .2, { size: 40, weight: 600 });
+ const sys = S.sys = oneLine(p, 1, 2, 2);
+ drop(sys, 0, 3, .5, COL.task); drop(sys, 3, 0, .7, COL.task, '(3, 0)', 10, 36);
+ }, { ask: done => quiz(CARD, [{
+ id: 'c-make', prompt: ['Make the line pass through ', $m('(0, 3)'), ' and ', $m('(3, 0)'), '. Drag a number sideways, or drag the line.'],
+ build: lsTask(S.sys, v => (v.a00 || v.a01) && v.a01 * 3 === v.b0 && v.a00 * 3 === v.b0,
+ 'x + y = 3 (or any multiple, like 2x + 2y = 6): both points add up to 3.',
+ 'Put each point into your equation. Both must give the right side exactly. Try equal numbers in front of x and y.',
+ () => S.sys.set({ a00: 1, a01: 1, b0: 3 })),
+ }], done) }],
+
+ ['wrap', 'Summary', (m) => {
+ const p = panel(0);
+ [['An equation in x and y has many solutions: pairs (x, y).', 'w1'], ['Drawn as points, the solutions make a straight line.', 'w2'],
+ ['The right side slides the line; the numbers in front of x and y turn it.', 'w3'], ['To draw it: set x = 0, then y = 0, and connect the points.', 'w4']].forEach(([str, mark], i) => {
+ const g = G(p, { x: -16, y: 230 + i * 130, o: 0 });
+ mk('circle', { cx: 150, cy: -12, r: 26, fill: COL.task }, g);
+ T(g, String(i + 1), { x: 150, y: -1, size: 30, fill: COL.board, weight: 700, anchor: 'middle' });
+ T(g, str, { x: 210, size: 36, weight: 600 });
+ tw(g, { o: 1, x: 0 }, m(mark), .6);
+ });
+ }],
+ ['final1', 'Chapter practice', () => { panel(0); }, { ask: done => quiz(SCREEN, [{
+ id: 'p-sol', prompt: ['Is the point a solution? Put x and y into the equation and check.'],
+ build: grid(SOLQ, YN, { multi: false, text: true }),
+ }], done, 'Chapter practice · set 1 of 4') }],
+ ['final2', 'Chapter practice', () => {}, { ask: done => quiz(SCREEN, [{
+ id: 'p-miss', prompt: ['Find the missing number so that the pair is a solution.'],
+ build: blanks(MISSQ),
+ }], done, 'Chapter practice · set 2 of 4') }],
+ ['final3', 'Chapter practice', () => {}, { ask: done => quiz(SCREEN, [{
+ id: 'p-cross', prompt: ['Where does each line cross the axes?'],
+ build: blanks(CROSSQ),
+ }, {
+ id: 'p-turn', prompt: ['Does the change slide the line or turn it?'],
+ build: grid(TURNQ, [['s', 'Slides', COL.task, 'S'], ['t', 'Turns', COL.whole, 'T']], { multi: false, text: true }),
+ }], done, 'Chapter practice · set 3 of 4') }],
+ ['final4', 'Chapter practice', () => {
+ const p = panel(0);
+ text(p, 'Make the line', 60, 110, .2, { size: 40, weight: 600 });
+ S.sys = oneLine(p, 1, 1, 1);
+ }, { ask: done => quiz(CARD, [{
+ id: 'p-flat', prompt: ['Make a flat line through every point at height ', $m('y = −2'), '.'],
+ build: lsTask(S.sys, v => v.a00 === 0 && v.a01 !== 0 && v.b0 === -2 * v.a01, 'y = −2: a 0 in front of x leaves x free.',
+ 'Put 0 in front of x. Then make the right side say y = −2.', () => S.sys.set({ a00: 0, a01: 1, b0: -2 })),
+ }, {
+ id: 'p-thru', prompt: ['Make a line through ', $m('(0, 0)'), ' and ', $m('(2, 1)'), '.'],
+ build: lsTask(S.sys, v => (v.a00 || v.a01) && v.b0 === 0 && 2 * v.a00 + v.a01 === 0, 'x − 2y = 0: (2, 1) gives 2 − 2 = 0.',
+ 'Through (0, 0) means the right side is 0. Then (2, 1) must give 0 too.', () => S.sys.set({ a00: 1, a01: -2, b0: 0 })),
+ }, {
+ id: 'p-int', prompt: ['Make a line that crosses the x-axis at ', $m('(3, 0)'), ' and the y-axis at ', $m('(0, −1)'), '.'],
+ build: lsTask(S.sys, v => v.b0 !== 0 && 3 * v.a00 === v.b0 && -v.a01 === v.b0, 'x − 3y = 3: (3, 0) gives 3, and (0, −1) gives 3.',
+ 'Both points must give the same right side. (3, 0) gives 3 times the x number; (0, −1) gives minus the y number.', () => S.sys.set({ a00: 1, a01: -3, b0: 3 })),
+ }], done, 'Chapter practice · set 4 of 4') }],
+ ['finish', 'Finished', () => { panel(0); }, { ask: finishCard }],
+].map(([id, title, run, extra]) => ({ id, title, run, ...extra }));
+
+boot();
+</script>
+</body>
+</html>
diff --git a/site/linear-algebra/index.html b/site/linear-algebra/index.html
new file mode 100644
index 0000000..a3be85b
--- /dev/null
+++ b/site/linear-algebra/index.html
@@ -0,0 +1,73 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>BOOK TITLE</title>
+<meta name="description" content="ONE SENTENCE ABOUT THE BOOK.">
+<link rel="icon" href="data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 64 64'%3E%3Crect width='64' height='64' rx='14' fill='%231d2b27'/%3E%3Ctext x='32' y='45' text-anchor='middle' font-size='48' fill='%23f0b45a'%3E∞%3C/text%3E%3C/svg%3E">
+<link rel="stylesheet" href="lib/units.css">
+<link rel="stylesheet" href="lib/contents.css">
+<script src="lib/units.js"></script>
+<script src="lib/contents.js"></script>
+<script src="unit-art.js"></script>
+<!-- <script src="refs.js"></script> a book that cites works: its reference list, built by the skill's scripts/refs.py -->
+<link rel="expect" href="#ch01" blocking="render">
+<!-- The book's own look, if it differs from the chalkboard: override the tokens of lib/contents.css here, e.g.
+<style>
+:root { --board: #fcfaf3; --chalk: #26241f; --top-bg: rgba(252, 250, 243, .9); --top-line: #ddd5c3; color-scheme: light; }
+</style> -->
+</head>
+<body>
+<section id="cover">
+ <div class="chalk" aria-hidden="true"><!-- a few faint formulas or phrases from the book, drawn in chalk -->
+ <span style="left:7%;top:13%;--d:1.6">PHRASE ONE</span>
+ <span style="right:8%;top:17%;--d:1.9">PHRASE TWO</span>
+ <span style="left:5%;bottom:20%;--d:2.2">PHRASE THREE</span>
+ <span style="right:6%;bottom:15%;--d:2.5">PHRASE FOUR</span>
+ </div>
+ <svg class="mascot draw" id="guide" width="210" height="147"></svg>
+ <p class="kicker">An animated book</p>
+ <h1>BOOK <i>&amp;</i> TITLE</h1>
+ <p class="lede">ONE OR TWO SENTENCES ABOUT WHAT THE READER WILL SEE AND DO.</p>
+ <div class="acts">
+ <a class="btn go" href="#contents" data-t="open">Open the book<svg viewBox="0 0 16 16"><path d="M6 2.5 11.5 8 6 13.5 4.6 12.1 8.7 8 4.6 3.9z"/></svg></a>
+ <a class="btn quiet" id="resume" hidden></a>
+ </div>
+ <p class="meta" id="meta"></p>
+</section>
+
+<main id="contents">
+ <header class="top">
+ <a class="home" href="#book" aria-label="Back to the cover" data-t-label="toCover"><svg class="mascot" id="guideSmall" width="52" height="36"></svg><strong>BOOK <i>&amp;</i> TITLE</strong></a>
+ <span class="prog" id="prog"></span>
+ </header>
+ <div id="units"></div>
+ <p class="refs-more" id="refsMore" hidden><a href="#references"><b data-t="references">References</b><span id="refsCount"></span><i data-t="viewAll">View all →</i></a></p>
+</main>
+
+<main id="refpage" aria-labelledby="refsTitle">
+ <header class="top">
+ <a class="back" href="#contents" data-t="backToContents">← Contents</a>
+ <span class="rp-book" id="rpBook"></span>
+ </header>
+ <section class="refs" id="references">
+ <h1 id="refsTitle" tabindex="-1" data-t="references">References</h1>
+ <p class="lead" data-t="refsLead">Every work cited in the lessons.</p>
+ <ol id="refList"></ol>
+ </section>
+</main>
+
+<script>
+// Units and chapters are numbered in order from start (a book whose scope starts mid-way, e.g. at unit 3, chapter 9,
+// keeps the original numbers). Add a chapter here when its lesson is ready.
+Contents.book({
+ start: { unit: 1, chapter: 1 },
+ units: [ // [unit title, [[chapter title, minutes], ...]]
+ ['First unit', [['First chapter', 8]]],
+ ],
+ hues: ['#f4a48c', '#86c9e8', '#f3c95c', '#e8a0c8', '#8fd6b0', '#bba8ee', '#f0b45a'], // one colour per unit, cycling
+});
+</script>
+</body>
+</html>
diff --git a/site/linear-algebra/lib/book.css b/site/linear-algebra/lib/book.css
new file mode 100644
index 0000000..1d09772
--- /dev/null
+++ b/site/linear-algebra/lib/book.css
@@ -0,0 +1,15 @@
+/* This book's own settings, imported by engine.css. The engine files next to this one are the same in every book
+ and are replaced when the engine is updated; this file is not.
+ Settings (uncomment to use):
+:root {
+ --math-font: "Avenir Next", Arial, sans-serif; face for numbers and formulas (default: a serif, see engine.js)
+ --progress-key: "progress"; localStorage key shared with the cover (default: one per book folder)
+ --page: #e9e5d8; --board: #fbfaf5; --panel: #fff; --edge: #d8d2c0; a light board: the palette at the top of
+ --chalk: #1d1d1f; --dim: #6a6a6e; --faint: #c4bfae; engine.css, redefined; the stage, cards,
+ --task: #e2589b; --quiz: #1f6fc5; --good: #3f8a1d; --bad: #d9473a; bar and COL follow (#rrggbb for the ink
+ --on-fill: #fff; --vignette: rgba(90, 70, 30, .08); color-scheme: light; and board colours COL reads)
+ --rule: #ece8e0; --track: #e6e2d5; --track-ask: #cfdeeb; and the shades between them
+ --bar-edge: #eae6da; --hover: #efede6; --veil: #e9e5d8;
+}
+ Style overrides go here too. They come before the engine's rules, so make each selector more specific than the
+ engine's, e.g. ':root .card.band' for '.card.band'. */
diff --git a/site/linear-algebra/lib/contents.css b/site/linear-algebra/lib/contents.css
new file mode 100644
index 0000000..d8f7f70
--- /dev/null
+++ b/site/linear-algebra/lib/contents.css
@@ -0,0 +1,137 @@
+/* The book's cover and contents (index.html): the chalkboard look, the cover, the guide, the chapter grid and the
+ page-to-page motion. A book's own <style> after this file sets its theme: the colour and font tokens below, and the
+ few rules a theme redraws (e.g. body::before for the paper). */
+:root {
+ --page: #0f1613; --board: #1d2b27; --panel: #22322d; --edge: #3a5047;
+ --chalk: #ece8dc; --dim: #9aaba3; --faint: #5d7068; --task: #f0b45a; --quiz: #86c9e8; --good: #8fd6b0;
+ --ui: "Avenir Next", "Segoe UI", "Helvetica Neue", Arial, sans-serif;
+ --book: "Iowan Old Style", Palatino, Georgia, serif;
+ --ease: cubic-bezier(.2, .8, .2, 1);
+ --top-bg: rgba(22, 33, 29, .86); --top-line: #2a3b35; /* the sticky contents header */
+ --lift: rgba(0, 0, 0, .3); /* a card's shadow on hover */
+ color-scheme: dark;
+}
+* { box-sizing: border-box; }
+html { scroll-padding-top: 90px; }
+body { margin: 0; min-height: 100svh; background: var(--board); color: var(--chalk); font: 18px/1.5 var(--ui); }
+/* Chalkboard: the same grain and vignette as the lesson stage. */
+body::before { content: ""; position: fixed; inset: 0; z-index: -1; pointer-events: none;
+ background: radial-gradient(ellipse at 50% 42%, transparent 55%, rgba(0, 0, 0, .38)),
+ url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='240' height='240'%3E%3Cfilter id='g'%3E%3CfeTurbulence type='fractalNoise' baseFrequency='.85' numOctaves='2' seed='7'/%3E%3CfeColorMatrix values='0 0 0 0 .92 0 0 0 0 .95 0 0 0 0 .9 0 0 0 .07 0'/%3E%3C/filter%3E%3Crect width='240' height='240' filter='url(%23g)'/%3E%3C/svg%3E"); }
+a { color: inherit; }
+a:focus-visible { outline: 3px solid var(--task); outline-offset: 3px; }
+.kicker { margin: 0; font-size: 15px; font-weight: 600; letter-spacing: .16em; text-transform: uppercase; color: var(--quiz); }
+
+/* ---------- cover ---------- */
+#cover { position: relative; min-height: 100svh; display: flex; flex-direction: column; align-items: center; justify-content: center;
+ padding: 48px 16px 64px; text-align: center; overflow: hidden; }
+.open #cover, body:not(.open) #contents { display: none; }
+/* #references is its own view: the full list, reached from one link at the end of the contents. */
+body:not(.refsview) #refpage, .refsview #cover, .refsview #contents { display: none; }
+#cover > * { animation: rise .8s var(--ease) backwards; }
+#cover .mascot { animation: none; margin-bottom: 26px; view-transition-name: guide; }
+#cover .kicker { animation-delay: .9s; }
+#cover h1 { animation-delay: 1s; }
+#cover .lede { animation-delay: 1.12s; }
+#cover .acts { animation-delay: 1.24s; }
+#cover .meta { animation-delay: 1.36s; }
+h1 { margin: 14px 0 18px; font: 500 clamp(44px, 8.4vw, 92px)/1.02 var(--book); letter-spacing: -.01em; view-transition-name: book; }
+h1 i { color: var(--task); font-style: italic; }
+.lede { max-width: 34em; margin: 0 0 34px; color: var(--dim); font-size: clamp(17px, 2.2vw, 20px); text-wrap: balance; }
+.acts { display: flex; flex-wrap: wrap; gap: 12px; justify-content: center; }
+.btn { display: inline-flex; align-items: center; gap: 12px; padding: 14px 30px; border-radius: 999px; font-weight: 600; font-size: 19px; text-decoration: none;
+ transition: transform .25s var(--ease), background-color .25s, border-color .25s; }
+.btn[hidden] { display: none; }
+.btn:hover { transform: translateY(-2px); }
+.btn.go { background: var(--chalk); color: var(--board); }
+.btn.quiet { border: 1.5px solid var(--edge); color: var(--chalk); }
+.btn.quiet:hover { border-color: var(--dim); }
+.btn svg { width: 15px; height: 15px; fill: currentColor; }
+.meta { margin: 30px 0 0; color: var(--faint); font-size: 15px; letter-spacing: .04em; }
+/* Faint chalk notes around the edges of the board. */
+.chalk { position: absolute; inset: 0; z-index: -1; pointer-events: none; animation: none !important; }
+.chalk span { position: absolute; font: italic 400 clamp(22px, 3vw, 38px) var(--book); color: var(--chalk); opacity: 0; white-space: nowrap;
+ animation: chalk 1.6s ease-out forwards, drift 14s ease-in-out infinite alternate; animation-delay: calc(var(--d) * 1s), calc(var(--d) * 1s); }
+@keyframes chalk { to { opacity: .075; } }
+@keyframes drift { to { translate: 0 -10px; } }
+@keyframes rise { from { opacity: 0; transform: translateY(16px); } }
+
+/* ---------- the guide: an infinity sign whose loops are its eyes ---------- */
+.mascot { display: block; overflow: visible; }
+.mascot .mbody { transform-box: view-box; transform-origin: 60px 46px; animation: bob 3.4s ease-in-out infinite; }
+.mascot .pupil { transform-box: fill-box; transform-origin: center; animation: blink 5s infinite; }
+.mascot .joy { display: none; }
+#cover:has(.go:hover, .go:focus-visible) .pupil { display: none; }
+#cover:has(.go:hover, .go:focus-visible) .joy { display: inline; }
+.draw .loop { stroke-dasharray: 1 1; animation: draw 1.3s cubic-bezier(.6, 0, .3, 1) .15s backwards; }
+.draw .face { animation: pop .45s var(--ease) 1.25s backwards; }
+@keyframes draw { from { stroke-dashoffset: 1; } }
+@keyframes pop { from { opacity: 0; transform: scale(.6); } }
+.draw .face { transform-box: view-box; transform-origin: 60px 44px; }
+@keyframes bob { 50% { transform: translateY(-3px) rotate(-2deg); } }
+@keyframes blink { 0%, 93%, 100% { transform: scaleY(1); } 96% { transform: scaleY(.1); } }
+
+/* ---------- contents ---------- */
+.top { position: sticky; top: 0; z-index: 2; display: flex; align-items: center; gap: 14px; padding: 12px max(16px, calc(50% - 590px));
+ background: var(--top-bg); backdrop-filter: blur(10px); -webkit-backdrop-filter: blur(10px); border-bottom: 1px solid var(--top-line); }
+.home { display: flex; align-items: center; gap: 12px; text-decoration: none; border-radius: 10px; }
+.home .mascot { view-transition-name: guide; }
+.home strong { font: 500 22px/1.1 var(--book); view-transition-name: book; }
+.home strong i { color: var(--task); }
+.prog { margin-left: auto; color: var(--dim); font-size: 15px; white-space: nowrap; }
+.prog b { color: var(--good); font-weight: 600; }
+main#contents { padding-bottom: 80px; }
+.grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(min(100%, 290px), 1fr)); gap: 12px; }
+.ch { display: grid; grid-template-columns: auto minmax(0, 1fr); grid-template-rows: 1fr auto; column-gap: 16px; row-gap: 8px; min-height: 112px;
+ padding: 16px 18px 14px 16px; border-radius: 16px; background: var(--panel); border: 1.5px solid var(--edge); border-left: 6px solid var(--c);
+ text-decoration: none; transition: transform .3s var(--ease), border-color .3s, box-shadow .3s; }
+.ch:hover { transform: translateY(-3px); border-color: var(--c); box-shadow: 0 14px 34px var(--lift); }
+.ch b { grid-row: span 2; min-width: 1.15em; font: 500 42px/1 var(--book); color: var(--c); font-variant-numeric: lining-nums tabular-nums; }
+.ch span { font-size: 18px; line-height: 1.3; }
+.ch small { color: var(--dim); font-size: 14px; }
+.ch.done small::before { content: var(--done, "✓ Finished · "); color: var(--good); font-weight: 600; }
+.ch.last small::after { content: var(--last, " · Last opened"); color: var(--quiz); }
+.ch.here:focus-visible { outline-color: var(--c); }
+.ch.here { animation: here 1.8s ease-out .3s; }
+@keyframes here { 0% { box-shadow: 0 0 0 0 var(--c); } 25% { box-shadow: 0 0 0 5px var(--c); } 100% { box-shadow: 0 0 0 14px transparent; } }
+/* ---------- references: every source the book cites, linked to its DOI or catalogue record ---------- */
+.refs-more { max-width: 1212px; margin: 44px auto 0; padding: 0 16px; }
+.refs-more[hidden] { display: none; }
+.refs-more a { display: flex; flex-wrap: wrap; align-items: baseline; gap: 4px 14px; padding: 16px 20px; border-radius: 16px; background: var(--panel);
+ border: 1.5px solid var(--edge); text-decoration: none; transition: border-color .3s; }
+.refs-more a:hover { border-color: var(--dim); }
+.refs-more b { font: 500 22px/1.2 var(--book); }
+.refs-more span { color: var(--dim); font-size: 15px; }
+.refs-more i { margin-left: auto; font-style: normal; color: var(--quiz); font-weight: 600; font-size: 15px; }
+#refpage { padding-bottom: 80px; }
+.top .back { display: inline-flex; align-items: center; gap: 8px; padding: 6px 4px; font-weight: 600; text-decoration: none; color: var(--quiz); border-radius: 8px; }
+.top .rp-book { margin-left: auto; font: 500 18px/1.2 var(--book); color: var(--dim); }
+.top .rp-book i { color: var(--task); }
+.refs { max-width: 1212px; margin: 32px auto 0; padding: 0 16px; }
+.refs h1 { margin: 0 0 8px; font: 500 clamp(32px, 5vw, 44px)/1.1 var(--book); view-transition-name: none; }
+.refs .lead { margin: 0 0 26px; max-width: 46em; color: var(--dim); }
+.refs ol { margin: 0; padding: 0; list-style: none; color: var(--dim); font-size: 16px; line-height: 1.5; }
+.refs li { margin: 0 0 10px; padding-left: 2em; text-indent: -2em; }
+.refs a { color: var(--chalk); text-underline-offset: 3px; overflow-wrap: anywhere; }
+.refs a:hover { color: var(--quiz); }
+.stagger .top { animation: rise .6s var(--ease) backwards; }
+.stagger .unit h2, .stagger .ch { animation: rise .6s var(--ease) backwards; animation-delay: calc(min(var(--i), 14) * 32ms + 80ms); }
+
+/* ---------- page-to-page motion ---------- */
+@view-transition { navigation: auto; }
+/* Firefox flickers through view transitions (the header blinks for several frames): it switches without one, and the
+ contents still rise in. -moz-orient exists only in Firefox. */
+@supports (-moz-orient: inline) { @view-transition { navigation: none; } }
+::view-transition-group(*) { animation-duration: .5s; animation-timing-function: var(--ease); }
+::view-transition-old(lesson), ::view-transition-new(lesson) { height: 100%; object-fit: cover; }
+::view-transition-old(lesson) { animation-duration: .18s; }
+@media (max-width: 560px) {
+ .home strong { font-size: 18px; }
+ #contents .top { flex-wrap: wrap; gap: 8px 12px; }
+ .ch { min-height: 0; }
+ .chalk span:not(:nth-child(3), :nth-child(4), :nth-child(7)) { display: none; }
+}
+@media (prefers-reduced-motion: reduce) {
+ *, *::before, ::view-transition-group(*), ::view-transition-old(*), ::view-transition-new(*) { animation: none !important; transition: none !important; }
+ .chalk span { opacity: .075; }
+}
diff --git a/site/linear-algebra/lib/contents.js b/site/linear-algebra/lib/contents.js
new file mode 100644
index 0000000..0bacf99
--- /dev/null
+++ b/site/linear-algebra/lib/contents.js
@@ -0,0 +1,226 @@
+/* The book's cover and contents (index.html): interface text, the chapter list with reading progress, the guide,
+ and the cover ↔ contents ↔ lesson motion. Load it in <head>; after the markup, the page calls
+ Contents.book({ units, start, hues }) with its chapter list. With refs.js (REFS, built by the skill's
+ scripts/refs.py) loaded first, the page also gets its References view (#references). */
+'use strict';
+// Observe aborted incoming transitions before the first rendering opportunity.
+addEventListener('pagereveal', e => e.viewTransition?.ready.catch(() => {}));
+
+const Contents = (() => {
+ // Interface text in the page's <html lang>, as in the lessons; missing keys fall back to English.
+ // A value is a string or plural forms { one, few, many, other } chosen by vars.n.
+ const TRANSLATIONS = {
+ en: {
+ open: 'Open the book', toCover: 'Back to the cover', resume: 'Continue · Chapter {n}', unit: 'Unit {n}', minutes: '{n} min',
+ meta: '{chapters}{samples} · {units} · with sound', metaChapters: { one: '{n} chapter', other: '{n} chapters' },
+ metaUnits: { one: '{n} unit', other: '{n} units' }, metaSamples: { one: ' + {n} sample', other: ' + {n} samples' }, samples: 'Sample chapters, another look',
+ chapterCount: { one: '{n} chapter', other: '{n} chapters' }, finished: '{done} of {n} finished',
+ doneMark: '✓ Finished · ', lastMark: ' · Last opened',
+ references: 'References', viewAll: 'View all →', backToContents: '← Contents',
+ refsLead: 'Every work cited in the lessons. Each link opens the work’s DOI or library record in a new tab; works with no reliable online record are listed without a link.',
+ refsCount: { one: '{n} work cited in the lessons', other: '{n} works cited in the lessons' },
+ refsAllLinked: ', each linked to its source', refsSomeLinked: ', {n} linked to their sources',
+ },
+ ru: {
+ open: 'Открыть книгу', toCover: 'К обложке', resume: 'Продолжить · Глава {n}', unit: 'Раздел {n}', minutes: '{n} мин',
+ meta: '{chapters}{samples} · {units} · со звуком',
+ metaChapters: { one: '{n} глава', few: '{n} главы', many: '{n} глав', other: '{n} главы' },
+ metaUnits: { one: '{n} раздел', few: '{n} раздела', many: '{n} разделов', other: '{n} раздела' },
+ metaSamples: { one: ' + {n} пробная', few: ' + {n} пробные', many: ' + {n} пробных', other: ' + {n} пробной' },
+ samples: 'Пробные главы в другом стиле',
+ chapterCount: { one: '{n} глава', few: '{n} главы', many: '{n} глав', other: '{n} главы' }, finished: 'Пройдено {done} из {n}',
+ doneMark: '✓ Пройдено · ', lastMark: ' · Открыта последней',
+ references: 'Список литературы', viewAll: 'Весь список →', backToContents: '← Оглавление',
+ refsLead: 'Все работы, которые цитируются в уроках. Ссылка открывает DOI или библиотечную запись в новой вкладке; работы без надёжной записи в сети даны без ссылки.',
+ refsCount: { one: '{n} работа цитируется в уроках', few: '{n} работы цитируются в уроках', many: '{n} работ цитируются в уроках', other: '{n} работы цитируются в уроках' },
+ refsAllLinked: ', у каждой есть ссылка на источник', refsSomeLinked: ', ссылок на источник: {n}',
+ },
+ zh: {
+ open: '打开这本书', toCover: '返回封面', resume: '继续 · 第 {n} 章', unit: '第 {n} 单元', minutes: '{n} 分钟',
+ meta: '{chapters}{samples} · {units} · 有配音', metaChapters: '{n} 章', metaUnits: '{n} 个单元',
+ metaSamples: ' + {n} 个示例章', samples: '示例章,另一种风格',
+ chapterCount: '{n} 章', finished: '已完成 {done} / {n}',
+ doneMark: '✓ 已完成 · ', lastMark: ' · 上次打开',
+ references: '参考文献', viewAll: '查看全部 →', backToContents: '← 目录',
+ refsLead: '课程中引用的全部作品。每个链接会在新标签页中打开该作品的 DOI 或图书馆记录;没有可靠在线记录的作品不附链接。',
+ refsCount: '课程中引用了 {n} 部作品', refsAllLinked: ',均链接到来源', refsSomeLinked: ',其中 {n} 部链接到来源',
+ },
+ ja: {
+ open: '本を開く', toCover: '表紙に戻る', resume: '続きから · 第{n}章', unit: '単元 {n}', minutes: '{n}分',
+ meta: '{chapters}{samples} · {units} · 音声つき', metaChapters: '{n}章', metaUnits: '{n}単元',
+ metaSamples: ' + サンプル{n}章', samples: 'サンプル章(別のスタイル)',
+ chapterCount: '{n}章', finished: '{n}章中 {done}章 完了',
+ doneMark: '✓ 完了 · ', lastMark: ' · 最後に開いた章',
+ references: '参考文献', viewAll: 'すべて見る →', backToContents: '← 目次',
+ refsLead: '授業で引用したすべての著作です。リンクは著作の DOI または図書館の記録を新しいタブで開きます。信頼できるオンライン記録のない著作はリンクなしで載せています。',
+ refsCount: '授業で引用した著作 {n} 件', refsAllLinked: '、すべて出典へのリンクつき', refsSomeLinked: '、うち {n} 件は出典へのリンクつき',
+ },
+ };
+ // the same lookup as translate() in engine.js (the two pages never load each other's file): keep them in step
+ const LANGUAGE = (document.documentElement.lang || 'en').toLowerCase().split('-')[0];
+ function translate(key, vars = {}) {
+ const language = TRANSLATIONS[LANGUAGE]?.[key] !== undefined ? LANGUAGE : 'en';
+ let text = TRANSLATIONS[language][key] ?? key;
+ if (typeof text === 'object') {
+ let rules;
+ try { rules = new Intl.PluralRules(language); } catch { rules = new Intl.PluralRules('en'); }
+ text = text[rules.select(vars.n)] ?? text.other;
+ }
+ return text.replace(/\{(\w+)\}/g, (placeholder, name) => name in vars ? vars[name] : placeholder);
+ }
+ const $ = id => document.getElementById(id);
+ const id = n => 'ch' + String(n).padStart(2, '0');
+ const esc = s => s.replace(/&/g, '&amp;').replace(/</g, '&lt;').replace(/"/g, '&quot;');
+ const HUES = ['#f4a48c', '#86c9e8', '#f3c95c', '#e8a0c8', '#8fd6b0', '#bba8ee', '#f0b45a'];
+
+ // Fixed interface text: data-t replaces an element's first text, data-t-label its aria-label.
+ function translatePage() {
+ for (const element of document.querySelectorAll('[data-t]')) element.firstChild.nodeValue = translate(element.dataset.t);
+ for (const element of document.querySelectorAll('[data-t-label]')) element.setAttribute('aria-label', translate(element.dataset.tLabel));
+ document.documentElement.style.setProperty('--done', JSON.stringify(translate('doneMark')));
+ document.documentElement.style.setProperty('--last', JSON.stringify(translate('lastMark')));
+ }
+
+ // Reading progress { done: [chapter numbers], last }, written by the lessons. The engine and this page derive the
+ // same key from the book's folder; a book that predates that passes its own key.
+ function progress(key) {
+ let P = {};
+ try {
+ const saved = JSON.parse(localStorage.getItem(key) || '{}');
+ if (saved && typeof saved === 'object' && !Array.isArray(saved)) P = saved;
+ } catch {}
+ return { last: P.last, done: new Set(Array.isArray(P.done) ? P.done.filter(n => Number.isInteger(n) && n > 0) : []) };
+ }
+
+ // The chapter cards, unit by unit, with progress, the header count, the cover's meta line and its resume button.
+ // A unit's optional third entry { unit, chapter, sample, href } numbers it from elsewhere in the book; a sample chapter,
+ // made to show another look, is not counted with the book's chapters, and a unit of samples has no unit number.
+ // With href, the sample lives in another book folder (its own progress): its card links there and leaves this book's
+ // numbering and progress alone. A chapter's own third entry { href, chapter } does the same for that chapter alone;
+ // without href, its chapter is only the number shown on the card.
+ // start.label is the number shown for start.chapter (folders keep the book's numbers; lessons set CHAPTER.label).
+ function contents(units, start, hues, P) {
+ let n = start.chapter - 1, total = 0, i = 0, away = 0; // i staggers the entrance, in reading order
+ const samples = new Set(), shown = k => k - start.chapter + (start.label ?? start.chapter);
+ $('units').innerHTML = units.map(([name, chs, o = {}], u) => {
+ if (o.chapter && !o.href) n = o.chapter - 1;
+ return `<section class="unit" style="--c:${hues[u % hues.length]};--i:${i++}">${Units.header(u, o.sample ? translate('samples') : translate('unit', { n: o.unit ?? u + start.unit }), name)}<div class="grid">` +
+ chs.map(([t, min, c = {}], k) => {
+ const href = c.href ?? o.href;
+ if (href) { away++; return `<a class="ch" href="${href}" style="--i:${i++}"><b>${c.chapter ?? (o.chapter ?? 1) + k}</b><span>${esc(t)}</span><small>${translate('minutes', { n: min })}</small></a>`; }
+ n++; if (o.sample) samples.add(n); else total++;
+ const cls = 'ch' + (P.done.has(n) ? ' done' : '') + (P.last === n ? ' last' : '');
+ return `<a class="${cls}" id="${id(n)}" href="${id(n)}/" style="--i:${i++}"><b>${c.chapter ?? shown(n)}</b><span>${esc(t)}</span><small>${translate('minutes', { n: min })}</small></a>`;
+ }).join('') + '</div></section>';
+ }).join('');
+ // A unit's sketch draws itself the first time the unit scrolls into view.
+ Units.watch();
+ const finished = [...P.done].filter(k => k >= start.chapter && k <= n && !samples.has(k)).length;
+ $('prog').innerHTML = finished ? translate('finished', { done: `<b>${finished}</b>`, n: total }) : translate('chapterCount', { n: total });
+ $('meta').textContent = translate('meta', {
+ chapters: translate('metaChapters', { n: total }),
+ samples: samples.size + away ? translate('metaSamples', { n: samples.size + away }) : '',
+ units: translate('metaUnits', { n: units.filter(x => !x[2]?.sample).length }) });
+ const last = Number.isInteger(P.last) && $(id(P.last));
+ if (last) {
+ const r = $('resume');
+ r.hidden = false;
+ r.href = last.getAttribute('href');
+ r.textContent = translate('resume', { n: last.querySelector('b').textContent });
+ }
+ }
+
+ // The References view, from refs.js: full entries, each linked to its DOI or catalogue record. It appears as one
+ // link at the end of the contents only when the book cites something.
+ function references() {
+ const all = Object.values(typeof REFS === 'object' && REFS ? REFS : {});
+ if (!$('refList') || !all.length) return;
+ $('refList').innerHTML = all.sort((a, b) => a.ref.localeCompare(b.ref)).map(r => `<li>${esc(r.ref)}${r.url
+ ? ` <a href="${esc(r.url)}" target="_blank" rel="noopener">${esc(r.url.replace(/^https?:\/\//, ''))}</a>` : ''}</li>`).join('');
+ const linked = all.filter(r => r.url).length;
+ $('refsCount').textContent = translate('refsCount', { n: all.length }) +
+ (linked === all.length ? translate('refsAllLinked') : translate('refsSomeLinked', { n: linked }));
+ $('rpBook').innerHTML = document.querySelector('#contents .home strong')?.innerHTML || '';
+ $('refsMore').hidden = false;
+ }
+
+ // The guide, drawn the same way as in the lessons, in the page's chalk (ink) colour.
+ 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 guides(ink) {
+ for (const svg of document.querySelectorAll('svg.mascot')) {
+ svg.setAttribute('viewBox', '0 0 120 84');
+ svg.setAttribute('aria-hidden', 'true');
+ const ln = `fill="none" stroke="${ink}" stroke-linecap="round" stroke-linejoin="round"`;
+ svg.innerHTML = `<g class="mbody"><path class="loop" pathLength="1" d="${lemniscate(60, 40, 52, 1.5)}" ${ln} stroke-width="6"/><g class="face">` +
+ [33, 87].map(x => `<circle class="pupil" cx="${x}" cy="40" r="6.5" fill="${ink}"/><path class="joy" d="M${x - 7} 43Q${x} 32 ${x + 7} 43" ${ln} stroke-width="4"/>`).join('') +
+ `<path d="M55 62Q60 67 65 62" ${ln} stroke-width="3.5"/></g></g>`;
+ }
+ }
+
+ // The cover, the contents and the references share this page: no hash or #book shows the cover, #references the
+ // reference list, #contents or #chNN the contents.
+ // Lessons link back with #chNN, so the reader lands on the chapter they just left.
+ function views() {
+ const reduced = matchMedia('(prefers-reduced-motion: reduce)').matches;
+ function show(animate) {
+ const refs = location.hash === '#references';
+ const open = location.hash.length > 1 && location.hash !== '#book' && !refs;
+ const apply = () => {
+ document.body.classList.toggle('open', open);
+ document.body.classList.toggle('refsview', refs);
+ document.body.classList.toggle('stagger', animate && open);
+ const here = open ? $(location.hash.slice(1)) : null;
+ document.querySelectorAll('.here').forEach(e => e.classList.remove('here'));
+ if (here?.classList.contains('ch')) { here.scrollIntoView({ block: 'center' }); here.classList.add('here'); }
+ else scrollTo(0, 0);
+ if (animate) {
+ const heading = document.querySelector(refs ? '#refsTitle' : open ? '#contents .home' : '#cover h1');
+ heading?.setAttribute('tabindex', '-1');
+ heading?.focus({ preventScroll: true });
+ }
+ };
+ if (animate && document.startViewTransition && !reduced && !CSS.supports('-moz-orient', 'inline')) {
+ const transition = document.startViewTransition(apply);
+ // Navigation can interrupt either promise; the new view is already applied.
+ transition.ready.catch(() => {});
+ transition.finished.catch(() => {});
+ } else apply();
+ }
+ addEventListener('hashchange', () => show(true));
+ show(false);
+
+ // Between pages, the chosen card grows into the lesson frame and the frame shrinks back into its card.
+ let named = null;
+ const name = el => {
+ if (named) named.style.viewTransitionName = '';
+ named = el;
+ if (el) el.style.viewTransitionName = 'lesson';
+ };
+ document.addEventListener('click', e => { const a = e.target.closest('a[href^="ch"]'); if (a) name(a); });
+ addEventListener('pagereveal', e => {
+ const target = (location.hash.length > 1 && $(location.hash.slice(1))?.closest('.ch')) || (named?.offsetParent && named);
+ name(e.viewTransition && target ? target : null);
+ e.viewTransition?.finished.then(() => name(null), () => name(null));
+ });
+ }
+
+ // units: [[unit title, [[chapter title, minutes], ...], { unit, chapter, sample, href }?], ...]. Chapters are numbered in
+ // order from start (a book whose scope starts mid-way keeps the original numbers in its folders, and may show them
+ // from start.label). hues: one colour per unit, cycling.
+ function book({ units, start = { unit: 1, chapter: 1 }, hues = HUES, progressKey, ink } = {}) {
+ translatePage();
+ contents(units, start, hues, progress(progressKey ?? 'animebook:progress:' + new URL('.', location.href).pathname));
+ references();
+ guides(ink || getComputedStyle(document.documentElement).getPropertyValue('--chalk').trim() || '#ece8dc');
+ views();
+ }
+
+ return { book, translate };
+})();
diff --git a/site/linear-algebra/lib/engine.css b/site/linear-algebra/lib/engine.css
new file mode 100644
index 0000000..7fc7cc5
--- /dev/null
+++ b/site/linear-algebra/lib/engine.css
@@ -0,0 +1,288 @@
+@import url(volume.css);
+@import url(book.css); /* this book's own settings and overrides (not shared), before the rules below */
+/* The palette. lib/book.css may redefine any of it in its own ':root' (this one has no specificity), e.g. a light board
+ with dark ink: the stage, COL in engine.js, the cards and the player bar all follow. Colours are #rrggbb. The last
+ lines are shades between those colours, written out so the dark board stays exact: a palette of its own sets them too
+ (the light set in book.css). */
+:where(:root) {
+ --page: #0f1613; --board: #1d2b27; --panel: #22322d; --edge: #3a5047;
+ --chalk: #ece8dc; --dim: #9aaba3; --faint: #5d7068;
+ --task: #f0b45a; --quiz: #86c9e8; --good: #8fd6b0; --bad: #f08c7a;
+ --ui: "Avenir Next", "Segoe UI", "Helvetica Neue", Arial, sans-serif;
+ --vignette: rgba(0, 0, 0, .35); /* the stage's darkened edges; a light board wants a faint, warm one */
+ color-scheme: dark;
+ --rule: #2e433b; /* lines between answer rows */
+ --track: #2f4640; --track-ask: #2d4a57; /* the player bar's steps, and its question steps */
+ --bar-edge: #2a3b35; --hover: #2b3f36; /* the bar's top line, the volume control under the pointer */
+ --veil: #0a100e; /* behind the help panel and the captions */
+}
+* { box-sizing: border-box; }
+html, body { height: 100%; margin: 0; overflow: hidden; background: var(--page); }
+body { color: var(--chalk); font: 26px/1.4 var(--ui); }
+button { font: inherit; color: inherit; cursor: pointer; }
+button:focus-visible, [tabindex]:focus-visible { outline: 3px solid var(--task); outline-offset: 3px; }
+button[hidden] { display: none; }
+
+/* One fixed 1600×960 frame (900 stage + 60 controls), scaled to fit the window. Fixed, not absolute: a frame wider
+ than a phone would otherwise widen the phone's layout viewport, and fit() would scale to that wider width. */
+#frame { position: fixed; left: 50%; top: 50%; width: var(--sw, 1600px); height: calc(var(--sh, 900px) + 60px); transform: translate(-50%, -50%) scale(var(--k, .5));
+ border-radius: 20px; overflow: hidden; background: var(--board); box-shadow: 0 0 0 1px var(--edge), 0 30px 80px rgba(0, 0, 0, .45); }
+#stage { position: absolute; left: 0; top: 0; width: var(--sw, 1600px); height: var(--sh, 900px); display: block;
+ background: radial-gradient(75% 75% at 50% 45%, rgba(0,0,0,0) 60%, var(--vignette)), var(--grain, none), var(--board); }
+#ui { position: absolute; left: 0; top: 0; width: var(--sw, 1600px); height: var(--sh, 900px); pointer-events: none; }
+#ui > * { pointer-events: auto; }
+
+.cover { position: absolute; left: 0; top: 0; width: var(--sw, 1600px); height: var(--sh, 900px); display: grid; place-items: center; background: color-mix(in srgb, var(--page) 50%, transparent); border: 0; }
+.cover[hidden] { display: none; }
+.cover > div { display: flex; flex-direction: column; align-items: center; }
+.cover-k { margin: 0 0 10px; text-align: center; font-size: 22px; font-weight: 600; letter-spacing: .14em; text-transform: uppercase; color: var(--quiz); }
+.cover-t { margin: 0 0 44px; max-width: min(1200px, calc(var(--sw, 1600px) - 100px)); text-align: center; font: 500 64px/1.15 "Iowan Old Style", Palatino, Georgia, serif; color: var(--chalk); text-wrap: balance; }
+.cover > div > * { animation: rise .7s cubic-bezier(.2, .8, .2, 1) backwards; }
+.cover-t { animation-delay: .08s; }
+.cover .go { animation-delay: .18s; }
+.cover small { animation-delay: .26s; }
+@keyframes rise { from { opacity: 0; transform: translateY(14px); } }
+.cover .go { display: inline-flex; align-items: center; gap: 16px; padding: 20px 40px; border-radius: 999px; background: var(--chalk); color: var(--board); font-weight: 600; font-size: 32px; }
+.cover small { display: block; margin-top: 22px; font-size: 22px; text-align: center; color: var(--dim); }
+.paused-mark { position: absolute; left: 0; top: 0; width: var(--sw, 1600px); height: var(--sh, 900px); display: none; place-items: center; pointer-events: none; }
+.paused .paused-mark { display: grid; }
+.paused-mark div { padding: 14px 30px; border-radius: 999px; background: color-mix(in srgb, var(--page) 85%, transparent); color: var(--dim); font-size: 22px; }
+
+/* Question cards inside the picture. */
+.card { position: absolute; padding: 20px 26px; border-radius: 20px; background: color-mix(in srgb, var(--panel) 97%, transparent); border: 1.5px solid var(--edge); border-left: 7px solid var(--quiz); box-shadow: 0 14px 44px rgba(0, 0, 0, .35); }
+.card.band { display: grid; grid-template-columns: auto minmax(0, 1fr) auto auto; grid-template-areas: "pic head body acts" "pic fb body acts"; column-gap: 28px; align-items: center; align-content: center; min-height: 150px; }
+.band .mascot { grid-area: pic; }
+.band .head { grid-area: head; align-self: end; }
+.band .fb { grid-area: fb; align-self: start; }
+.band .body { grid-area: body; }
+.band .acts { grid-area: acts; }
+.side .mascot { float: right; margin: -2px -4px 6px 10px; }
+.kicker { margin: 0 0 4px; font-size: 20px; font-weight: 600; color: var(--quiz); }
+.prompt { margin: 0; font-size: 28px; line-height: 1.35; }
+.side .prompt { font-size: 24px; }
+.body:empty { display: none; }
+.side .body { margin-top: 14px; }
+.opts { display: flex; gap: 12px; flex-wrap: wrap; }
+.opt { padding: 8px 24px; border-radius: 999px; border: 2px solid var(--edge); background: transparent; color: var(--chalk); font-size: 24px; min-height: 58px; display: inline-flex; align-items: center; }
+.opt:hover:not(:disabled) { border-color: var(--dim); }
+.opt[aria-pressed="true"] { background: var(--c, var(--chalk)); border-color: var(--c, var(--chalk)); color: var(--on-fill, #1b2320); font-weight: 600; }
+.opt.good { border-color: var(--good); box-shadow: 0 0 0 3px color-mix(in srgb, var(--good) 35%, transparent); }
+.opt.bad { border-color: var(--bad); color: var(--bad); }
+.opt:disabled { cursor: default; }
+.fb { margin-top: 8px; font-size: 22px; line-height: 1.4; color: var(--chalk); }
+.fb:empty { display: none; }
+.fb.ok::before { content: "✓ "; color: var(--good); font-weight: 700; }
+.fb.no::before { content: "✗ "; color: var(--bad); font-weight: 700; }
+.fb ul { margin: 6px 0 0; padding-left: 22px; }
+.side .fb { max-height: 110px; overflow: auto; font-size: 20px; }
+.acts { display: flex; gap: 12px; align-items: center; }
+.side .acts { margin-top: 16px; }
+.side .acts { flex-wrap: wrap; gap: 10px; }
+.side .btn { padding: 8px 16px; font-size: 20px; }
+.card.side { padding: 18px 22px; }
+.btn { padding: 10px 28px; border-radius: 999px; border: 0; background: var(--chalk); color: var(--board); font-weight: 600; font-size: 22px; white-space: nowrap; }
+.btn.quiet { background: transparent; color: var(--dim); border: 1.5px solid var(--edge); }
+.btn.go { background: var(--quiz); color: var(--on-fill, #10242e); } /* --on-fill: text on a coloured fill */
+.btn:disabled { background: var(--edge); color: var(--dim); cursor: default; }
+
+.grid .row { display: grid; grid-template-columns: 170px minmax(0, 1fr) 34px; gap: 16px; align-items: center; padding: 5px 0 5px 12px; border-bottom: 1px solid var(--rule); }
+.grid .num { display: flex; justify-content: flex-end; align-items: center; font-size: 26px; }
+.grid.text .row { grid-template-columns: minmax(0, 1fr) auto 34px; }
+.grid.text .num { justify-content: flex-start; }
+.grid .opts { gap: 8px; }
+.grid .opt { padding: 3px 16px; min-height: 42px; font-size: 20px; }
+.grid .mark { font-weight: 700; text-align: center; }
+.grid .mark.good { color: var(--good); }
+.grid .mark.bad { color: var(--bad); }
+.grid .why { grid-column: 1 / -1; font-size: 19px; color: var(--dim); padding-left: 186px; }
+.grid.text .why { padding-left: 0; }
+.grid .why:empty { display: none; }
+
+.hit { cursor: pointer; }
+.hit .ring { fill: transparent; stroke: var(--chalk); stroke-width: 2.5; stroke-opacity: 0; }
+.hit:hover .ring, .hit:focus .ring { stroke-opacity: .7; }
+.hit.bad .ring { stroke: var(--bad); stroke-opacity: 1; }
+.hit.good .ring { stroke: var(--good); stroke-opacity: 1; stroke-width: 4; }
+.tok { cursor: grab; touch-action: none; } /* a finger drags the chip instead of scrolling the page */
+
+/* Controls strip, part of the frame. */
+#bar { position: absolute; left: 0; top: var(--sh, 900px); width: var(--sw, 1600px); height: 60px; display: flex; align-items: center; gap: 10px; padding: 0 20px; background: color-mix(in srgb, var(--page) 50%, var(--board)); border-top: 1px solid var(--bar-edge); }
+.icon { width: 44px; height: 44px; border-radius: 50%; border: 1px solid var(--edge); background: var(--panel); display: grid; place-items: center; flex: none; padding: 0; }
+.icon svg { width: 18px; height: 18px; fill: var(--chalk); }
+.icon .i-pause { display: none; }
+.is-playing .icon .i-play { display: none; }
+.is-playing .icon .i-pause { display: block; }
+.segs { flex: 1; display: flex; gap: 4px; height: 30px; align-items: center; min-width: 0; margin: 0 8px; }
+.seg { position: relative; display: block; min-width: 0; height: 8px; border-radius: 4px; background: var(--track); border: 0; padding: 0; overflow: hidden; }
+.seg:hover { height: 12px; }
+.seg i { position: absolute; left: 0; top: 0; bottom: 0; width: 0; background: var(--chalk); }
+.seg.ask { background: var(--track-ask); }
+.seg.ask i { background: var(--quiz); }
+.step { width: 300px; flex: none; color: var(--dim); font-size: 19px; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; text-align: right; }
+/* Keep the control strip usable without scaling down its touch targets. */
+@media (max-width: 700px) {
+ #frame { top: calc(50% - 50px); overflow: visible; }
+ #bar { width: calc(var(--sw, 1600px) * var(--k)); height: auto; flex-wrap: wrap; gap: 6px; padding: 8px;
+ transform: scale(calc(1 / var(--k))); transform-origin: left top; border-radius: 0 0 12px 12px; }
+ #bar .icon { width: 36px; height: 40px; }
+ .step { display: none; }
+ #bHelp { display: none; } /* keyboard shortcuts; room for the speed button on a phone */
+ #bar .icon.speed { width: 36px; min-width: 0; padding: 0; font-size: 12px; letter-spacing: -.3px; }
+ .segs { order: 1; }
+ .segs { min-width: 80px; margin: 0; }
+ :root.full #bar { transform-origin: left bottom; border-radius: 0; }
+}
+/* Full screen: the stage fills the screen and the controls lie over its foot, out of sight until the pointer moves
+ (engine.js wake(): .awake), while paused or ended (.held) and while the pointer is on them. */
+:root.full #frame { top: 50%; height: var(--sh, 900px); border-radius: 0; box-shadow: none; }
+:root.full #bar { top: auto; bottom: 0; transition: opacity .3s; border-top: 0;
+ background: linear-gradient(transparent, color-mix(in srgb, var(--page) 85%, transparent)); }
+:root.full #frame:not(.awake):not(.held) #bar:not(:hover):not(:focus-within) { opacity: 0; pointer-events: none; }
+:root.full #frame:not(.awake):not(.held):not(:has(#bar:hover)) { cursor: none; }
+/* A touch screen has no hover to bring the controls back, and a tap that answers a question would cover the card with
+ them: there full screen keeps them, full size, under the stage (fit() leaves them room). */
+@media (pointer: coarse) {
+ :root.full #frame { top: calc(50% - 30px); overflow: visible; }
+ :root.full #frame #bar { top: var(--sh, 900px); bottom: auto; width: calc(var(--sw, 1600px) * var(--k)); height: auto; flex-wrap: wrap;
+ gap: 6px; padding: 8px; transform: scale(calc(1 / var(--k))); transform-origin: left top; background: none; opacity: 1 !important; pointer-events: auto !important; }
+ :root.full #bar .icon { width: 40px; height: 40px; }
+ :root.full .step, :root.full #bHelp { display: none; }
+ :root.full .segs { order: 1; min-width: 80px; margin: 0; }
+}
+@media (pointer: coarse) and (max-width: 700px) { :root.full #frame { top: calc(50% - 55px); } }
+
+.sound-note { position: absolute; left: 24px; top: 20px; margin: 0; padding: 8px 18px; border-radius: 12px; background: color-mix(in srgb, var(--page) 85%, transparent); color: var(--dim); font-size: 19px; }
+.sound-note[hidden] { display: none; }
+.blanks .brow { padding: 8px 0; border-bottom: 1px solid var(--rule); }
+.blanks .brow:last-child { border-bottom: 0; }
+.blanks .bline { line-height: 64px; white-space: nowrap; }
+.blanks .mark { display: inline-block; margin-left: 14px; font-weight: 700; }
+.blanks .mark.good { color: var(--good); animation: pop .35s ease-out; }
+.blanks .mark.bad { color: var(--bad); }
+.blanks .why { font-size: 19px; color: var(--dim); line-height: 1.35; }
+.blanks .why:empty { display: none; }
+.box { height: 52px; margin: 0 6px; padding: 0 6px; border: 0; border-bottom: 3px solid var(--quiz); border-radius: 8px 8px 0 0; background: color-mix(in srgb, var(--chalk) 7%, transparent); color: var(--chalk); font: 32px var(--math-font, "STIX Two Text", "Cambria Math", "Iowan Old Style", Palatino, Georgia, serif); text-align: center; vertical-align: -6px; }
+.box:focus { outline: none; background: color-mix(in srgb, var(--quiz) 16%, transparent); }
+.box.good { border-color: var(--good); }
+.box.bad { border-color: var(--bad); }
+.box:disabled { opacity: 1; }
+kbd { display: inline-block; min-width: 1.5em; padding: 0 .4em; margin-left: .5em; border: 1.5px solid currentColor; border-radius: 6px; font: 600 .7em/1.5 var(--ui); text-align: center; vertical-align: .12em; opacity: .6; }
+.opt kbd { margin: 0 .6em 0 0; }
+.keys { margin: 6px 0 0; font-size: 18px; color: var(--dim); }
+.keys kbd { margin: 0 .15em; }
+.grid .row.cur { background: color-mix(in srgb, var(--chalk) 5%, transparent); box-shadow: inset 4px 0 var(--quiz); }
+.help { position: absolute; left: 0; top: 0; width: var(--sw, 1600px); height: var(--sh, 900px); display: grid; place-items: center; background: color-mix(in srgb, var(--veil) 72%, transparent); }
+.help[hidden] { display: none; }
+.help-box { width: min(1120px, calc(var(--sw, 1600px) - 80px)); padding: 40px 50px; border-radius: 22px; background: var(--panel); border: 1.5px solid var(--edge); }
+.help h2 { margin: 0 0 22px; font-size: 32px; font-weight: 600; }
+.help h3 { margin: 0 0 12px; font-size: 20px; font-weight: 600; color: var(--quiz); }
+.help-cols { display: grid; grid-template-columns: 1fr 1fr; gap: 44px; }
+.help-cols:has(> [hidden]) { grid-template-columns: 1fr; }
+.help dl { margin: 0; display: grid; grid-template-columns: 150px 1fr; row-gap: 10px; font-size: 22px; }
+.help dt { text-align: right; padding-right: 18px; white-space: nowrap; }
+.help dt kbd { margin: 0 0 0 .3em; opacity: .9; }
+.help dd { margin: 0; color: var(--dim); }
+.help-close { margin: 26px 0 0; font-size: 18px; color: var(--dim); }
+.icon.txt { font-size: 20px; font-weight: 700; color: var(--dim); }
+/* Optional captions of the narration, one sentence at a time. Off by default: teaching text lives in the picture. */
+.caption { position: absolute; left: 50%; bottom: 78px; transform: translateX(-50%); width: max-content; max-width: min(1180px, calc(var(--sw, 1600px) - 80px)); padding: 10px 24px; border-radius: 14px; background: color-mix(in srgb, var(--veil) 82%, transparent); color: var(--chalk); font-size: 28px; line-height: 1.35; text-align: center; pointer-events: none; }
+.caption[hidden] { display: none; }
+.icon.cc { font-size: 15px; font-weight: 700; color: var(--dim); }
+.icon.cc[aria-pressed="true"] { background: var(--chalk); border-color: var(--chalk); color: var(--board); }
+.card.side { overflow: auto; }
+svg.m { display: inline-block; overflow: visible; }
+.card b { font-weight: 700; } /* not 'bolder' (900 under a 600 prompt) */
+.card { animation: card-in .45s cubic-bezier(.2, .9, .3, 1.15); }
+.fb:not(:empty) { animation: fb-in .3s ease-out; }
+.opt.bad, .grid .mark.bad { animation: shake .4s; }
+.grid .mark.good { animation: pop .35s ease-out; }
+@keyframes card-in { from { opacity: 0; transform: translateY(24px) scale(.98); } }
+@keyframes fb-in { from { opacity: 0; transform: translateY(8px); } }
+@keyframes pop { 0% { transform: scale(.3); opacity: 0; } 70% { transform: scale(1.3); } }
+@keyframes shake { 20% { transform: translateX(-8px); } 40% { transform: translateX(8px); } 60% { transform: translateX(-5px); } 80% { transform: translateX(5px); } }
+/* Full-screen chapter practice. */
+.card.screen { height: 900px; padding: 50px 70px; border: 0; border-radius: 0; background: transparent; box-shadow: none; animation: screen-in .5s ease-out; max-height: none; overflow: visible; }
+.screen .kicker { font-size: 22px; }
+.screen .prompt { font-size: 40px; font-weight: 600; }
+.screen .body { margin-top: 30px; }
+.card.screen { display: flex; flex-direction: column; }
+.screen .head { order: 1; } .screen .body { order: 2; }
+.screen .fb { order: 3; max-width: min(1080px, calc(var(--sw, 1600px) - 140px)); margin: 26px 0 0; font-size: 24px; } /* feedback right under the answers */
+/* Practice screens: the bottom 130 px hold the buttons. Long answers scroll inside the body, so the feedback under
+ them stays in view after a wrong answer adds a 'why' line to each row. */
+.card.screen:not(.sort):not(.fin) { padding-bottom: 130px; }
+.card.screen:not(.sort):not(.fin) > .head, .card.screen:not(.sort):not(.fin) > .fb { flex: none; }
+.card.screen:not(.sort):not(.fin) > .body { flex: 0 1 auto; min-height: 0; overflow-y: auto; }
+.screen .acts { position: absolute; right: 70px; bottom: 48px; }
+.screen .grid .row { grid-template-columns: 200px minmax(0, 1fr) 40px; padding: 9px 0 9px 12px; }
+/* a long label (a system of equations) widens the label column for every row instead of running off the card's left */
+.screen .grid:not(.text) { display: grid; grid-template-columns: minmax(200px, max-content) minmax(0, 1fr) 40px; }
+.screen .grid:not(.text) > .row { grid-column: 1 / -1; grid-template-columns: subgrid; }
+.screen .grid.text .row { grid-template-columns: minmax(0, 1fr) auto 40px; }
+.screen .grid .opt { font-size: 22px; min-height: 50px; padding: 4px 20px; }
+.screen .grid .why { padding-left: 216px; font-size: 20px; }
+.screen .grid.text .why { padding-left: 0; }
+#ui > .screen.sort { pointer-events: none; }
+.screen.sort > * { pointer-events: auto; }
+.screen.sort .head { position: absolute; right: 34px; top: 40px; width: 330px; }
+.screen.sort .prompt { font-size: 28px; }
+.screen.sort .fb { position: absolute; margin: 0; left: auto; right: 34px; bottom: 116px; width: 330px; max-height: 240px; overflow: auto; font-size: 20px; }
+.screen.sort .acts { right: 34px; }
+.fin .finwrap { display: flex; flex-direction: column; align-items: center; justify-content: center; height: 100%; text-align: center; padding-bottom: 60px; }
+.fin .mascot { margin-bottom: 28px; }
+.fin .fb, .fin .acts { position: static; }
+.fin .fb { order: 0; margin: 0; } /* result lines, not answer feedback: keep them above the buttons */
+.fin .acts { margin-top: 30px; }
+@keyframes screen-in { from { opacity: 0; } }
+
+/* The guide: an infinity sign whose loops are its eyes. */
+.mascot { display: block; flex: none; overflow: visible; }
+.mascot .mbody { transform-box: view-box; transform-origin: 60px 46px; animation: bob 3.4s ease-in-out infinite; }
+.mascot .eyes { transition: transform .3s; }
+.mascot .pupil { transform-box: fill-box; transform-origin: center; animation: blink 5s infinite; }
+.mascot .joy, .mascot .flat { display: none; }
+.mascot.happy .pupil { display: none; }
+.mascot.happy .joy { display: inline; }
+.mascot.happy .mbody { animation: hop .55s ease-out 2, bob 3.4s ease-in-out 1.1s infinite; }
+.mascot.oops .eyes { transform: translate(-3px, 4px); }
+.mascot.oops .smile { display: none; }
+.mascot.oops .flat { display: inline; }
+.mascot.oops .mbody { animation: wobble .5s ease-in-out, bob 3.4s ease-in-out .5s infinite; }
+@keyframes bob { 50% { transform: translateY(-3px) rotate(-2deg); } }
+@keyframes blink { 0%, 93%, 100% { transform: scaleY(1); } 96% { transform: scaleY(.1); } }
+@keyframes hop { 40% { transform: translateY(-12px) rotate(4deg); } }
+@keyframes wobble { 25% { transform: rotate(-8deg); } 75% { transform: rotate(6deg); } }
+@media (prefers-reduced-motion: reduce) { .card, .fb, .opt, .grid .mark, .mascot * { animation: none !important; } }
+
+a.icon { text-decoration: none; }
+/* Citations (cite() and plain-text labels found in refs.js) and the finish card's source list open the source in a new tab. */
+a.cite { cursor: pointer; }
+a.cite text, a.cite tspan { text-decoration: underline; text-decoration-thickness: 1.5px; text-underline-offset: 5px; }
+a.cite:hover text, a.cite:hover tspan { fill: var(--quiz); }
+a.cite:focus { outline: none; }
+a.cite:focus-visible text, a.cite:focus-visible tspan { fill: var(--task); }
+a.cite:focus-visible { outline: 3px solid var(--task); outline-offset: 6px; border-radius: 4px; }
+#ui a.cite { color: inherit; text-decoration: underline; text-underline-offset: 3px; }
+#ui a.cite:hover { color: var(--quiz); }
+.fin .srcs { margin: 26px 0 0; max-width: min(1100px, calc(var(--sw, 1600px) - 100px)); font-size: 19px; line-height: 1.45; color: var(--dim); text-align: left; }
+.fin .srcs h2 { margin: 0 0 6px; font-size: 18px; font-weight: 600; letter-spacing: .14em; text-transform: uppercase; color: var(--quiz); }
+.fin .srcs ol { margin: 0; padding-left: 0; list-style: none; max-height: 190px; overflow: auto; }
+.fin .srcs li { padding-left: 2em; text-indent: -2em; margin: 0 0 6px; }
+.fin .srcs a { color: var(--chalk); text-underline-offset: 3px; }
+.fin .srcs a:hover { color: var(--quiz); }
+.fin .srcs a:focus-visible { outline: 3px solid var(--task); outline-offset: 2px; }
+a.btn { text-decoration: none; display: inline-block; }
+/* Page-to-page motion: the contents card grows into this frame, and shrinks back on the way out. */
+@view-transition { navigation: auto; }
+#frame { view-transition-name: lesson; }
+::view-transition-group(lesson) { animation-duration: .5s; animation-timing-function: cubic-bezier(.2, .8, .2, 1); }
+::view-transition-old(lesson), ::view-transition-new(lesson) { height: 100%; object-fit: cover; }
+::view-transition-old(lesson) { animation-duration: .18s; }
+@media (prefers-reduced-motion: reduce) { .cover > div > * { animation: none; } ::view-transition-group(*), ::view-transition-old(*), ::view-transition-new(*) { animation: none !important; } }
+/* The finish screen speaks the same type as the chapter cover and the contents page. */
+.fin .kicker { font-size: 20px; letter-spacing: .14em; text-transform: uppercase; }
+.fin .prompt { margin: 6px 0 14px; font: 500 56px/1.15 "Iowan Old Style", Palatino, Georgia, serif; }
+.icon.speed { width: auto; min-width: 44px; padding: 0 10px; border-radius: 22px; font-size: 16px; }
+/* An upright stage is seen at about half the scale of a wide one on the same screen: bigger caption text. */
+:root[data-stage="portrait"] .step { width: 120px; } /* the 900-wide bar keeps room for the steps */
+:root[data-stage="portrait"] .caption { font-size: 38px; bottom: 60px; }
diff --git a/site/linear-algebra/lib/engine.js b/site/linear-algebra/lib/engine.js
new file mode 100644
index 0000000..b59277b
--- /dev/null
+++ b/site/linear-algebra/lib/engine.js
@@ -0,0 +1,1786 @@
+// 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(() => {}));
+
+// The engine's state and helpers live in one closure. Only the names declared at the end of this file are global (the
+// API that chapters, math.js, book libraries and the scripts use), so a chapter may name its own helpers anything else
+// (clock, fit, frame, last, ui, …).
+let seeking = false; // true while seek() replays the beats before its target
+let captions = false; // the reader's captions setting (C)
+const ENGINE = (() => {
+
+/* ---------- interface language ---------- */
+// The page's <html lang> picks the interface text; CHAPTER.language picks the audio folder. Set both alike.
+// A value is a string or plural forms { one, few, many, other } chosen by vars.n. Missing keys fall back to English.
+const TRANSLATIONS = {
+ en: {
+ decimalSign: '.', stageLabel: 'Lesson animation', stageLabelTitled: 'Lesson animation: {title}',
+ shortcuts: 'Keyboard shortcuts', lesson: 'Lesson', questions: 'Questions',
+ helpPlay: 'Play or pause', helpStep: 'Previous or next step', helpStepInQuestion: 'Change step during a question', helpRestart: 'Start over',
+ helpCaptions: 'Captions on or off', helpSpeed: 'Slower or faster', helpFullScreen: 'Full screen', helpList: 'Show this list',
+ helpChoose: 'Choose an answer or a ring', helpTrueFalse: 'True or false', helpRows: 'Move between rows',
+ helpNumberLine: 'Move along the number line, or pick a number to sort', helpEnter: 'Check, then continue',
+ helpShowAnswer: 'Show the answer', helpLeaveBox: 'Leave an answer box', helpClose: 'Press {key} to close.',
+ paused: 'Paused. Press space or click to continue.',
+ soundFailed: 'Sound could not play. The lesson continues with the on-screen text.',
+ startLesson: 'Start lesson', startFilm: 'Play', aboutMinutesFilm: 'About {n} minutes, with sound.', coverKeys: 'Press {space} to start, {help} for shortcuts.', spaceKey: 'Space',
+ chapterNumber: 'Chapter {n}', aboutMinutes: 'About {n} minutes, with sound and quick checks.',
+ allChapters: 'All chapters', playLabel: 'Play or pause (space)', backLabel: 'Previous step (left arrow)', restartLabel: 'Restart lesson',
+ checksInLesson: 'Quick checks and practice are in the interactive lesson.',
+ volumeLabel: 'Adjust volume', volumeTitle: 'Volume (0 = muted)', volumeSlider: 'Volume',
+ helpLabel: 'Keyboard shortcuts (?)', speedLabel: 'Playback speed (< and >)', captionsLabel: 'Captions (C)', fullScreenLabel: 'Full screen', goToStep: 'Go to step {n}: {title}',
+ quickCheck: 'Quick check', countOf: 'question {k} of {n}', check: 'Check', showAnswer: 'Show answer', nextQuestion: 'Next question', continue: 'Continue',
+ correct: 'Correct. ', notQuite: 'Not quite. ', answerPrefix: 'Answer: ', keysPrefix: 'Keys: ',
+ hintMove: ' move, ', hintChoose: ' choose', hintChooseOrClickGrid: ' choose, or click the grid', hintMoveAlongLine: ' move along the line, ',
+ hintChooseOrClick: ' choose, or click', hintRow: ' row, ', hintTypeFraction: 'type numbers like 3/4 or −2 1/4, ', hintTypeNumber: 'type the number, ',
+ hintTypeDecimal: 'type the number, ', hintNextBox: ' next box, ', hintCheck: ' check, ', hintLeaveBox: ' leave the box',
+ hintPickNumber: ' pick a number, ', hintPickRing: ' choose its ring',
+ rowsRight: '{r} of {n} right. Fix the rows marked ✗ and check again.',
+ choicesShown: 'the correct choices are now selected.', numbersShown: 'the correct numbers are filled in.',
+ notPlacedYet: '{x} is not placed yet.',
+ realRingIsEmpty: '{x}: every real number is rational or irrational, so that space has no numbers of its own.',
+ ringsRight: '{r} of {n} in the right ring.', ringsShown: 'every number is now in its smallest ring.',
+ chipPlaced: '{x}, placed in {ring}', chipNotPlaced: '{x}, not placed', pointLabel: 'The point {v}', answerBox: 'Answer',
+ stepsLeftOfZero: '{n} steps left of 0',
+ natural: 'Natural', whole: 'Whole', integers: 'Integers', rational: 'Rational', irrational: 'Irrational', real: 'Real', integerColumn: 'Integer',
+ trueLabel: 'True', falseLabel: 'False',
+ chapterComplete: 'Chapter {n} complete', quickChecks: 'Quick checks', chapterPractice: 'Chapter practice', sources: 'Sources in this chapter', opensSource: '{label}, opens the source in a new tab',
+ firstTryScore: '{name}: {r} of {t} right on the first try.', notAttempted: '{name}: not attempted.',
+ watchAgain: 'Watch again', nextChapter: 'Next chapter',
+ },
+ ru: {
+ decimalSign: ',', stageLabel: 'Анимация урока', stageLabelTitled: 'Анимация урока: {title}',
+ shortcuts: 'Горячие клавиши', lesson: 'Урок', questions: 'Вопросы',
+ helpPlay: 'Пуск или пауза', helpStep: 'Предыдущий или следующий шаг', helpStepInQuestion: 'Сменить шаг во время вопроса', helpRestart: 'Начать сначала',
+ helpCaptions: 'Субтитры вкл. или выкл.', helpSpeed: 'Медленнее или быстрее', helpFullScreen: 'Полноэкранный режим', helpList: 'Показать этот список',
+ helpChoose: 'Выбрать ответ или круг', helpTrueFalse: 'Верно или неверно', helpRows: 'Перейти между строками',
+ helpNumberLine: 'Двигаться по числовой прямой или выбрать число для сортировки', helpEnter: 'Проверить, затем продолжить',
+ helpShowAnswer: 'Показать ответ', helpLeaveBox: 'Выйти из поля ответа', helpClose: 'Нажмите {key}, чтобы закрыть.',
+ paused: 'Пауза. Нажмите пробел или щёлкните, чтобы продолжить.',
+ soundFailed: 'Звук не воспроизводится. Урок продолжится с текстом на экране.',
+ startLesson: 'Начать урок', startFilm: 'Смотреть', aboutMinutesFilm: { one: 'Около {n} минуты, со звуком.', few: 'Около {n} минут, со звуком.', many: 'Около {n} минут, со звуком.', other: 'Около {n} минуты, со звуком.' }, coverKeys: '{space} — начать, {help} — горячие клавиши.', spaceKey: 'Пробел',
+ chapterNumber: 'Глава {n}',
+ aboutMinutes: { one: 'Около {n} минуты, со звуком и проверками.', few: 'Около {n} минут, со звуком и проверками.',
+ many: 'Около {n} минут, со звуком и проверками.', other: 'Около {n} минуты, со звуком и проверками.' },
+ allChapters: 'Все главы', playLabel: 'Пуск или пауза (пробел)', backLabel: 'Предыдущий шаг (стрелка влево)', restartLabel: 'Начать урок заново',
+ checksInLesson: 'Проверочные вопросы и практика — в интерактивном уроке.',
+ volumeLabel: 'Настроить громкость', volumeTitle: 'Громкость (0 — без звука)', volumeSlider: 'Громкость',
+ helpLabel: 'Горячие клавиши (?)', speedLabel: 'Скорость воспроизведения (< и >)', captionsLabel: 'Субтитры (C)', fullScreenLabel: 'Полный экран', goToStep: 'Перейти к шагу {n}: {title}',
+ quickCheck: 'Проверь себя', countOf: 'вопрос {k} из {n}', check: 'Проверить', showAnswer: 'Показать ответ', nextQuestion: 'Следующий вопрос', continue: 'Продолжить',
+ correct: 'Верно. ', notQuite: 'Не совсем. ', answerPrefix: 'Ответ: ', keysPrefix: 'Клавиши: ',
+ hintMove: ' двигаться, ', hintChoose: ' выбрать', hintChooseOrClickGrid: ' выбрать или щёлкнуть по сетке', hintMoveAlongLine: ' двигаться по прямой, ',
+ hintChooseOrClick: ' выбрать или щёлкнуть', hintRow: ' строка, ', hintTypeFraction: 'вводите числа вида 3/4 или −2 1/4, ', hintTypeNumber: 'введите число, ',
+ hintTypeDecimal: 'вводите числа вида 0,75, ', hintNextBox: ' следующее поле, ', hintCheck: ' проверить, ', hintLeaveBox: ' выйти из поля',
+ hintPickNumber: ' выбрать число, ', hintPickRing: ' выбрать его круг',
+ rowsRight: 'Верно {r} из {n}. Исправьте строки с ✗ и проверьте снова.',
+ choicesShown: 'правильные варианты отмечены.', numbersShown: 'правильные числа вписаны.',
+ notPlacedYet: '{x}: ещё не размещено.',
+ realRingIsEmpty: '{x}: каждое действительное число рационально или иррационально, поэтому своих чисел у этой области нет.',
+ ringsRight: 'В нужном круге: {r} из {n}.', ringsShown: 'каждое число теперь в своём наименьшем круге.',
+ chipPlaced: '{x}, в круге «{ring}»', chipNotPlaced: '{x}, не размещено', pointLabel: 'Точка {v}', answerBox: 'Ответ',
+ stepsLeftOfZero: { one: '{n} шаг влево от 0', few: '{n} шага влево от 0', many: '{n} шагов влево от 0', other: '{n} шага влево от 0' },
+ natural: 'Натуральные', whole: 'Целые неотрицательные', integers: 'Целые', rational: 'Рациональные', irrational: 'Иррациональные', real: 'Действительные', integerColumn: 'Целые',
+ trueLabel: 'Верно', falseLabel: 'Неверно',
+ chapterComplete: 'Глава {n} пройдена', quickChecks: 'Проверь себя', chapterPractice: 'Практика по главе', sources: 'Источники этой главы', opensSource: '{label}, источник откроется в новой вкладке',
+ firstTryScore: '{name}: {r} из {t} верно с первой попытки.', notAttempted: '{name}: не выполнялось.',
+ watchAgain: 'Смотреть снова', nextChapter: 'Следующая глава',
+ },
+ zh: {
+ decimalSign: '.', stageLabel: '课程动画', stageLabelTitled: '课程动画:{title}',
+ shortcuts: '键盘快捷键', lesson: '课程', questions: '题目',
+ helpPlay: '播放或暂停', helpStep: '上一步或下一步', helpStepInQuestion: '答题时切换步骤', helpRestart: '从头开始',
+ helpCaptions: '打开或关闭字幕', helpSpeed: '减速或加速', helpFullScreen: '全屏', helpList: '显示此列表',
+ helpChoose: '选择答案或圆环', helpTrueFalse: '对或错', helpRows: '在各行之间移动',
+ helpNumberLine: '在数轴上移动,或选一个数来分类', helpEnter: '检查,然后继续',
+ helpShowAnswer: '显示答案', helpLeaveBox: '离开答题框', helpClose: '按 {key} 关闭。',
+ paused: '已暂停。按空格键或点击继续。',
+ soundFailed: '声音无法播放。课程将借助屏幕上的文字继续。',
+ startLesson: '开始上课', startFilm: '播放', aboutMinutesFilm: '约 {n} 分钟,有配音。', coverKeys: '按 {space} 开始,按 {help} 查看快捷键。', spaceKey: '空格',
+ chapterNumber: '第 {n} 章', aboutMinutes: '约 {n} 分钟,含配音和随堂小测。',
+ allChapters: '全部章节', playLabel: '播放或暂停(空格)', backLabel: '上一步(左方向键)', restartLabel: '重新开始本课',
+ checksInLesson: '小测验和练习在互动课程里。',
+ volumeLabel: '调节音量', volumeTitle: '音量(0 为静音)', volumeSlider: '音量',
+ helpLabel: '键盘快捷键(?)', speedLabel: '播放速度(< 和 >)', captionsLabel: '字幕(C)', fullScreenLabel: '全屏', goToStep: '跳到第 {n} 步:{title}',
+ quickCheck: '小测', countOf: '第 {k}/{n} 题', check: '检查', showAnswer: '显示答案', nextQuestion: '下一题', continue: '继续',
+ correct: '正确。', notQuite: '还不对。', answerPrefix: '答案:', keysPrefix: '按键:',
+ hintMove: ' 移动,', hintChoose: ' 选择', hintChooseOrClickGrid: ' 选择,或点击网格', hintMoveAlongLine: ' 沿数轴移动,',
+ hintChooseOrClick: ' 选择,或点击', hintRow: ' 换行,', hintTypeFraction: '可输入 3/4 或 −2 1/4 这样的数,', hintTypeNumber: '输入数字,',
+ hintTypeDecimal: '输入数字,', hintNextBox: ' 下一个框,', hintCheck: ' 检查,', hintLeaveBox: ' 离开答题框',
+ hintPickNumber: ' 选一个数,', hintPickRing: ' 选它所在的圆环',
+ rowsRight: '{n} 行中对了 {r} 行。改正标 ✗ 的行,再检查一次。',
+ choicesShown: '正确选项已经选上。', numbersShown: '正确的数已经填上。',
+ notPlacedYet: '{x} 还没有放好。',
+ realRingIsEmpty: '{x}:每个实数不是有理数就是无理数,所以这一块没有只属于它的数。',
+ ringsRight: '{n} 个中有 {r} 个放在了正确的圆环里。', ringsShown: '每个数现在都在它所属的最小圆环里。',
+ chipPlaced: '{x},放在「{ring}」', chipNotPlaced: '{x},未放置', pointLabel: '点 {v}', answerBox: '答案',
+ stepsLeftOfZero: '0 左边 {n} 步',
+ natural: '正整数', whole: '非负整数', integers: '整数', rational: '有理数', irrational: '无理数', real: '实数', integerColumn: '整数',
+ trueLabel: '对', falseLabel: '错',
+ chapterComplete: '第 {n} 章完成', quickChecks: '小测', chapterPractice: '本章练习', sources: '本章引用的文献', opensSource: '{label},在新标签页中打开来源',
+ firstTryScore: '{name}:第一次就答对 {r} / {t}。', notAttempted: '{name}:未作答。',
+ watchAgain: '再看一遍', nextChapter: '下一章',
+ },
+ ja: {
+ decimalSign: '.', stageLabel: '授業アニメーション', stageLabelTitled: '授業アニメーション:{title}',
+ shortcuts: 'キーボードショートカット', lesson: '授業', questions: '問題',
+ helpPlay: '再生/一時停止', helpStep: '前または次のステップ', helpStepInQuestion: '問題の途中でステップを移動', helpRestart: '最初から',
+ helpCaptions: '字幕のオン/オフ', helpSpeed: '遅く/速く', helpFullScreen: '全画面', helpList: 'この一覧を表示',
+ helpChoose: '答えまたは輪を選ぶ', helpTrueFalse: '正しい/誤り', helpRows: '行を移動',
+ helpNumberLine: '数直線上を移動、または分類する数を選ぶ', helpEnter: '答え合わせ、そして次へ',
+ helpShowAnswer: '答えを表示', helpLeaveBox: '解答欄から出る', helpClose: '{key} で閉じる。',
+ paused: '一時停止中。スペースキーかクリックで再開します。',
+ soundFailed: '音声を再生できません。画面の文字で授業を続けます。',
+ startLesson: '授業を始める', startFilm: '再生', aboutMinutesFilm: '約{n}分、音声つき。', coverKeys: '{space} で開始、{help} でショートカット一覧。', spaceKey: 'スペース',
+ chapterNumber: '第{n}章', aboutMinutes: '約{n}分、音声と確認問題つき。',
+ allChapters: 'すべての章', playLabel: '再生/一時停止(スペース)', backLabel: '前のステップ(左矢印)', restartLabel: '授業を最初から',
+ checksInLesson: '確認問題と練習はインタラクティブな授業の中にあります。',
+ volumeLabel: '音量を調整', volumeTitle: '音量(0 でミュート)', volumeSlider: '音量',
+ helpLabel: 'キーボードショートカット(?)', speedLabel: '再生速度(< と >)', captionsLabel: '字幕(C)', fullScreenLabel: '全画面', goToStep: 'ステップ {n}:{title} へ移動',
+ quickCheck: '確認問題', countOf: '問 {k}/{n}', check: '答え合わせ', showAnswer: '答えを見る', nextQuestion: '次の問題', continue: '続ける',
+ correct: '正解。', notQuite: 'おしい。', answerPrefix: '答え:', keysPrefix: 'キー:',
+ hintMove: ' 移動、', hintChoose: ' 選ぶ', hintChooseOrClickGrid: ' 選ぶ、またはマス目をクリック', hintMoveAlongLine: ' 数直線上を移動、',
+ hintChooseOrClick: ' 選ぶ、またはクリック', hintRow: ' 行、', hintTypeFraction: '3/4 や −2 1/4 のように入力、', hintTypeNumber: '数を入力、',
+ hintTypeDecimal: '数を入力、', hintNextBox: ' 次の欄、', hintCheck: ' 答え合わせ、', hintLeaveBox: ' 欄から出る',
+ hintPickNumber: ' 数を選ぶ、', hintPickRing: ' その輪を選ぶ',
+ rowsRight: '{n} 行中 {r} 行正解。✗ の行を直して、もう一度答え合わせ。',
+ choicesShown: '正しい選択肢を選びました。', numbersShown: '正しい数を入れました。',
+ notPlacedYet: '{x} はまだ置かれていません。',
+ realRingIsEmpty: '{x}:実数はどれも有理数か無理数なので、この部分だけに入る数はありません。',
+ ringsRight: '{n} 個中 {r} 個が正しい輪に入っています。', ringsShown: 'どの数も、入るいちばん小さい輪に移しました。',
+ chipPlaced: '{x}、「{ring}」に配置', chipNotPlaced: '{x}、未配置', pointLabel: '点 {v}', answerBox: '答え',
+ stepsLeftOfZero: '0 から左へ {n}',
+ natural: '自然数', whole: '0 以上の整数', integers: '整数', rational: '有理数', irrational: '無理数', real: '実数', integerColumn: '整数',
+ trueLabel: '正しい', falseLabel: '誤り',
+ chapterComplete: '第{n}章 完了', quickChecks: '確認問題', chapterPractice: '章末練習', sources: 'この章の出典', opensSource: '{label}(出典を新しいタブで開く)',
+ firstTryScore: '{name}:1 回目で {t} 問中 {r} 問正解。', notAttempted: '{name}:未挑戦。',
+ watchAgain: 'もう一度見る', nextChapter: '次の章へ',
+ },
+};
+// <html data-stage="portrait"> turns the stage upright: 900 wide, 1600 tall. Landscape (1600×900) otherwise.
+const PORTRAIT = document.documentElement.dataset.stage === 'portrait';
+const SW = PORTRAIT ? 900 : 1600, SH = PORTRAIT ? 1600 : 900;
+document.documentElement.style.setProperty('--sw', SW + 'px');
+document.documentElement.style.setProperty('--sh', SH + 'px');
+const LANGUAGE = (document.documentElement.lang || 'en').toLowerCase().split('-')[0];
+const pluralRules = {};
+// Interface text in LANGUAGE: translate('chapterNumber', { n: 3 }) → 'Chapter 3'. Chapters may use it too, e.g. for practice labels.
+// contents.js has its own copy for the contents page: keep the two in step.
+function translate(key, vars = {}) {
+ const language = TRANSLATIONS[LANGUAGE]?.[key] !== undefined ? LANGUAGE : 'en';
+ let text = TRANSLATIONS[language][key] ?? key;
+ if (typeof text === 'object') {
+ try { pluralRules[language] ??= new Intl.PluralRules(language); } catch { pluralRules[language] = new Intl.PluralRules('en'); }
+ text = text[pluralRules[language].select(vars.n)] ?? text.other;
+ }
+ return text.replace(/\{(\w+)\}/g, (placeholder, name) => name in vars ? vars[name] : placeholder);
+}
+const DECIMAL_SIGN = translate('decimalSign'); // shown by num() and accepted by answer boxes
+const isLatinLetter = key => /^[a-z]$/i.test(key);
+// A letter shortcut on any keyboard layout: the typed letter, or the same physical key when the layout types a non-Latin letter.
+const isShortcut = (event, letter) => event.key.toLowerCase() === letter.toLowerCase()
+ || (isLatinLetter(letter) && !isLatinLetter(event.key) && event.code === 'Key' + letter.toUpperCase());
+// A punctuation shortcut (code 'Comma', 'Period') on a layout that types a non-Latin letter on that key.
+const isShortcutCode = (event, code) => /^\p{L}$/u.test(event.key) && !isLatinLetter(event.key) && event.code === code;
+
+document.body.insertAdjacentHTML('afterbegin', `<div id="frame">
+ <svg id="stage" viewBox="0 0 ${SW} ${SH}" role="img" aria-label="${translate('stageLabel')}">
+ <g id="scene"></g>
+ </svg>
+ <div id="ui"></div>
+ <div class="paused-mark"><div>${translate('paused')}</div></div>
+ <div class="caption" id="caption" hidden></div>
+ <div class="help" id="help" hidden role="dialog" aria-label="${translate('shortcuts')}">
+ <div class="help-box">
+ <h2>${translate('shortcuts')}</h2>
+ <div class="help-cols">
+ <div><h3>${translate('lesson')}</h3><dl>
+ <dt><kbd>${translate('spaceKey')}</kbd></dt><dd>${translate('helpPlay')}</dd>
+ <dt><kbd>←</kbd><kbd>→</kbd></dt><dd>${translate('helpStep')}</dd>
+ <dt><kbd>Shift</kbd><kbd>←</kbd><kbd>→</kbd></dt><dd>${translate('helpStepInQuestion')}</dd>
+ <dt><kbd>Home</kbd></dt><dd>${translate('helpRestart')}</dd>
+ <dt><kbd>C</kbd></dt><dd>${translate('helpCaptions')}</dd>
+ <dt><kbd>&lt;</kbd><kbd>&gt;</kbd></dt><dd>${translate('helpSpeed')}</dd>
+ <dt><kbd>F</kbd></dt><dd>${translate('helpFullScreen')}</dd>
+ <dt><kbd>?</kbd></dt><dd>${translate('helpList')}</dd>
+ </dl></div>
+ <div><h3>${translate('questions')}</h3><dl>
+ <dt><kbd>1</kbd>–<kbd>6</kbd></dt><dd>${translate('helpChoose')}</dd>
+ <dt><kbd>T</kbd><kbd>F</kbd></dt><dd>${translate('helpTrueFalse')}</dd>
+ <dt><kbd>↑</kbd><kbd>↓</kbd></dt><dd>${translate('helpRows')}</dd>
+ <dt><kbd>←</kbd><kbd>→</kbd></dt><dd>${translate('helpNumberLine')}</dd>
+ <dt><kbd>Enter</kbd></dt><dd>${translate('helpEnter')}</dd>
+ <dt><kbd>S</kbd></dt><dd>${translate('helpShowAnswer')}</dd>
+ <dt><kbd>Esc</kbd></dt><dd>${translate('helpLeaveBox')}</dd>
+ </dl></div>
+ </div>
+ <p class="help-close">${translate('helpClose', { key: '<kbd>Esc</kbd>' })}</p>
+ </div>
+ </div>
+ <p class="sound-note" id="soundNote" hidden>${translate('soundFailed')}</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><span id="coverGo">${translate('startLesson')}</span></span>
+ <small><span id="coverMeta"></span> ${translate('coverKeys', { space: `<kbd>${translate('spaceKey')}</kbd>`, help: '<kbd>?</kbd>' })}</small>
+ </div></button>
+ <div id="bar">
+ <a class="icon" id="bHome" href="../" aria-label="${translate('allChapters')}" title="${translate('allChapters')}">
+ <svg viewBox="0 0 18 18"><path d="M2 2h6v6H2zM10 2h6v6h-6zM2 10h6v6H2zM10 10h6v6h-6z"/></svg>
+ </a>
+ <button class="icon" id="bPlay" aria-label="${translate('playLabel')}">
+ <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="${translate('backLabel')}">
+ <svg viewBox="0 0 18 18"><path d="M3 2h2.5v14H3zM16 2v14L6.5 9z"/></svg>
+ </button>
+ <button class="icon" id="bRestart" aria-label="${translate('restartLabel')}">
+ <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="${translate('helpLabel')}" title="${translate('helpLabel')}">?</button>
+ <button class="icon txt speed" id="bSpeed" aria-label="${translate('speedLabel')}" title="${translate('speedLabel')}">1×</button>
+ <button class="icon cc" id="bCC" aria-pressed="false" aria-label="${translate('captionsLabel')}" title="${translate('captionsLabel')}">CC</button>
+ <button class="icon" id="bFull" aria-label="${translate('fullScreenLabel')}">
+ <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 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
+// The board and ink colours come from the palette in engine.css, which lib/book.css may redefine (a light board):
+// the picture, the cards and the player bar then agree. The six hues are the chapters' meanings, set in JS.
+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' };
+{ // a canvas reads any CSS colour back as #rrggbb, the form colour tweens mix; a missing or bad one keeps the default
+ const c = document.createElement('canvas').getContext('2d');
+ for (const k of ['chalk', 'dim', 'faint', 'task', 'good', 'bad', 'board']) { c.fillStyle = COL[k]; c.fillStyle = bookSetting('--' + k) || COL[k]; COL[k] = c.fillStyle; }
+}
+const MATH = bookSetting('--math-font') || '"STIX Two Text","Cambria Math","Iowan Old Style",Palatino,Georgia,serif';
+const NAME = { nat: translate('natural'), whole: translate('whole'), int: translate('integers'), rat: translate('rational'), irr: translate('irrational'), real: translate('real') };
+// Card positions inside the picture. BAND and the screens follow the stage; RIGHT and TOPR are placed for the wide
+// stage's number line and map and have no upright layout yet.
+const BAND = { x: 96 * SW / 1600, y: SH - 214, w: SW - 192 * SW / 1600, 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: SW, cls: 'screen' };
+const SORT_SCREEN = { x: 0, y: 0, w: SW, 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;
+ // _tf starts unset: an element never moved keeps a transform attribute it was made with
+ if (tf !== (e._tf ?? null)) { 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 });
+}
+// A citation drawn in the picture that opens its source (REFS from ../refs.js, built by scripts/refs.py) in a new tab.
+// cite(p, key, opts) takes T's options; str overrides the label (default REFS[key].cite). Returns the <a>; animate it like T.
+const CITED = new Set();
+function cite(parent, key, { str, ...opts } = {}) {
+ const r = (typeof REFS === 'object' && REFS) ? REFS[key] : null;
+ if (!r) throw new Error(`cite: no reference "${key}" in refs.js`);
+ CITED.add(key);
+ if (!r.url) return T(parent, str || r.cite, opts);
+ linkStage();
+ const a = mk('a', { class: 'cite', href: r.url, target: '_blank', rel: 'noopener', 'aria-label': translate('opensSource', { label: r.cite }) }, parent);
+ const { o = 1, x = 0, y = 0, ...rest } = opts;
+ T(a, str || r.cite, { ...rest, fill: rest.fill || COL.chalk });
+ return put(a, { x, y, o });
+}
+// Any text in the picture or a card that equals a reference's cite label or one of its match strings (case-insensitive)
+// becomes a link to the source, so chapters write citations as plain text. Watched by citeObs (set up after the player).
+let CITE_RE = null, CITE_KEY = null;
+function citeIndex() {
+ if (CITE_RE !== null) return CITE_RE;
+ CITE_KEY = new Map();
+ for (const [k, r] of Object.entries(typeof REFS === 'object' && REFS ? REFS : {}))
+ for (const s of [r.cite, ...(r.match || [])]) if (s) CITE_KEY.set(s.toLowerCase(), k);
+ const alts = [...CITE_KEY.keys()].sort((a, b) => b.length - a.length).map(s => s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&'));
+ return (CITE_RE = alts.length ? new RegExp(alts.join('|'), 'gi') : false);
+}
+function autoCite(root) {
+ const re = citeIndex();
+ if (!re) return;
+ const nodes = [];
+ if (root.nodeType === 3) nodes.push(root);
+ else if (root.nodeType === 1) for (let w = document.createTreeWalker(root, NodeFilter.SHOW_TEXT), n; (n = w.nextNode());) nodes.push(n);
+ for (const n of nodes) {
+ const host = n.parentElement;
+ if (!host || host.closest('a, button, input, script, style, kbd')) continue; // no links inside controls
+ const ms = [...n.data.matchAll(re)];
+ if (!ms.length) continue;
+ const svg = host.namespaceURI === NS, frag = document.createDocumentFragment();
+ let i = 0, made = 0;
+ for (const m of ms) {
+ const k = CITE_KEY.get(m[0].toLowerCase()), r = REFS[k];
+ CITED.add(k);
+ if (!r.url) continue; // a work with no reliable online record stays plain text but is still listed
+ frag.append(n.data.slice(i, m.index));
+ const a = svg ? mk('a', { href: r.url }) : document.createElement('a');
+ if (!svg) a.href = r.url;
+ a.setAttribute('class', 'cite');
+ a.setAttribute('target', '_blank');
+ a.setAttribute('rel', 'noopener');
+ a.setAttribute('aria-label', translate('opensSource', { label: m[0] }));
+ if (svg) mk('tspan', {}, a).textContent = m[0]; else a.textContent = m[0];
+ frag.append(a);
+ i = m.index + m[0].length;
+ made++;
+ }
+ if (!made) continue; // replacing the node unchanged would re-trigger the observer
+ if (svg) linkStage();
+ frag.append(n.data.slice(i));
+ n.replaceWith(frag);
+ }
+}
+// The stage is announced as one image; once it holds a link it becomes a group, so the link stays reachable.
+function linkStage() { document.getElementById('stage').setAttribute('role', 'group'); }
+// Links that have faded out (or sit in a faded group) must not take clicks or Tab focus.
+function syncLinks() {
+ for (const a of scene.querySelectorAll('a.cite')) {
+ let o = 1;
+ for (let e = a; e && e !== scene; e = e.parentNode) o *= +(e.getAttribute('opacity') ?? 1);
+ const on = o > .5;
+ if (on === a._on) continue;
+ a._on = on;
+ a.style.pointerEvents = on ? '' : 'none';
+ if (on) { a.removeAttribute('tabindex'); a.removeAttribute('aria-hidden'); }
+ else { a.setAttribute('tabindex', '-1'); a.setAttribute('aria-hidden', 'true'); }
+ }
+}
+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) | 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, ascent = 0, descent = 0;
+ for (const p of parts) {
+ if (typeof p === 'string') cx += text(p, cx, 0, size);
+ 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);
+ 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 - 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));
+}
+// The maths helpers (number lines, tiles, fractions, planes, the number map, sorter) are in math.js.
+// 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' });
+ 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 = `${-bottom}px`; // line up the math baseline with the text baseline
+ return svg;
+}
+
+
+/* ---------- 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, ease) => tw(e, { o: 1 }, t0, dur, ease);
+const hide = (e, t0, dur = .5, ease) => tw(e, { o: 0 }, t0, dur, ease);
+const draw = (e, t0, dur = .9, ease) => tw(e, { d: 1 }, t0, dur, ease);
+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 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. A beat holds its picture for HOLD s
+// after its narration and last tween; with { tail: true } f keeps running through that hold (t up to the beat's end)
+// instead of freezing at D, for motion that never stops, as in a film. A camera runs through the hold too when anything
+// in its beat does (its tail is 'follow'), so a follow shot keeps up with a tailed subject. f also gets the run's end
+// (for a tail, the beat's real end), so a move can land on it, as a whip at the end of a beat does. Under music that
+// end is where the beat really leaves, up to HOLD early (P.back, see frameStep), so the move is still seen landing.
+// A tail's own D does not lengthen the beat: it runs to the end whatever it is (so D + HOLD adds no second hold).
+const clockRun = (f, D, { tail = false } = {}) => { const w = { t0: 0, dur: D, ease: lin, tail }; f(0, D); w.pf = q => f(q * w.dur, w.tail ? w.dur - P.back : w.dur); TW.push(w); };
+// 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 = SW / 2, y = SH / 2, z, r = 0, bg = COL.board } = {}) {
+ const [bx, by, bw, bh] = box || [0, 0, SW, SH];
+ 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 / SW, bh / SH) : 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, { tail: 'follow' });
+ return cam;
+}
+
+/* ---------- scene ---------- */
+const scene = document.getElementById('scene');
+const S = {};
+const AXIS = { o: SW / 2, 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 ? '−' : '') + String(Math.abs(v)).replace('.', DECIMAL_SIGN);
+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.
+// It then leaves the page: a long film otherwise keeps every earlier beat's picture (a documentary's maps: megabytes).
+function retire(e) {
+ if (seeking) { e.remove(); return; }
+ e.style.transition = 'opacity .15s linear';
+ e.style.opacity = '0';
+ setTimeout(() => e.remove(), 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); };
+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);
+}
+
+/* ---------- shared answer columns ---------- */
+const TF = [['t', translate('trueLabel'), null, 'T'], ['f', translate('falseLabel'), 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 ? translate('firstTryScore', { name, r, t }) : translate('notAttempted', { name }));
+ progress(p => { p.done = [...new Set([...(p.done || []), CHAPTER.number])]; });
+ const home = h('a', 'btn quiet', translate('allChapters'));
+ home.href = $('bHome').href;
+ const again = h('button', 'btn' + (CHAPTER.next ? ' quiet' : ' go'), [translate('watchAgain'), kbd(CHAPTER.next ? 'R' : 'Enter')]);
+ again.onclick = restart;
+ const next = CHAPTER.next && h('button', 'btn go', [translate('nextChapter'), kbd('Enter')]);
+ if (next) next.onclick = () => { location.href = CHAPTER.next; };
+ P.keys = e => e.key === 'Enter' ? ((next ? next.onclick() : restart()), true)
+ : isShortcut(e, 'r') ? (restart(), true) : false;
+ const guide = mascotEl(240);
+ c.append(h('div', 'finwrap', [guide, h('p', 'kicker', translate('chapterComplete', { n: CHAPTER.label ?? CHAPTER.number })), h('p', 'prompt', CHAPTER.title),
+ line(translate('quickChecks'), sum('c-')), line(translate('chapterPractice'), sum('p-')), h('div', 'acts', next ? [home, again, next] : [home, again]), sources()].filter(Boolean)));
+ 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);
+// The chapter's sources: every key passed to cite() plus CHAPTER.refs, as full references that link to the source.
+function sources() {
+ for (const m of citeObs.takeRecords()) for (const n of m.addedNodes) autoCite(n); // link text added just now (a seek to the end)
+ const keys = [...new Set([...(CHAPTER.refs || []), ...CITED])].filter(k => typeof REFS === 'object' && REFS?.[k]);
+ if (!keys.length) return null;
+ const items = keys.map(k => REFS[k]).sort((a, b) => a.ref.localeCompare(b.ref)).map(r => {
+ if (!r.url) return h('li', '', r.ref);
+ const a = h('a', '', r.url.replace(/^https?:\/\//, ''));
+ Object.assign(a, { href: r.url, target: '_blank', rel: 'noopener' });
+ return h('li', '', [r.ref + ' ', a]);
+ });
+ return h('section', 'srcs', [h('h2', '', translate('sources')), h('ol', '', items)]);
+}
+const uiW = (str, size) => { ctx2d.font = `600 ${size}px ${UI}`; return ctx2d.measureText(str).width; };
+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, SH - 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 = translate('quickCheck')) {
+ 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');
+ fb.setAttribute('role', 'status'); // screen readers announce right or wrong
+ const bCheck = h('button', 'btn', [translate('check'), kbd('Enter')]), bShow = h('button', 'btn quiet', [translate('showAnswer'), kbd('S')]);
+ const bNext = h('button', 'btn go', [k < qs.length - 1 ? translate('nextQuestion') : translate('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 ? translate('correct') : translate('notQuite'), ...[].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('', [translate('answerPrefix'), ...[].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 (isShortcut(e, 's') && !bShow.hidden) { bShow.click(); return true; }
+ return false;
+ };
+ const kick = label + (qs.length > 1 ? ' · ' + translate('countOf', { k: k + 1, n: 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', [translate('keysPrefix'), ...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; },
+ };
+};
+// A choice question from the chapter's item bank: ITEMS from ./items.js, built by scripts/items.py from the
+// mcq-item-writer JSON. mcq('ID', onRight?) returns a quiz entry, so quiz(TOPR, [mcq('MB-03-01')], done) asks it.
+function mcq(id, onRight) {
+ const it = (typeof ITEMS === 'object' && ITEMS) ? ITEMS[id] : null;
+ if (!it) throw new Error(`mcq: no item "${id}" in items.js`);
+ return { id, prompt: it.prompt, build: choice(it.opts, it.right, it.why, it.no, onRight) };
+}
+// The shared body of the stage tap questions: each target ring is a focusable button that answers on click or Enter,
+// and ← / → move the focus between them. targets: [{ g, label, ok, wrong }], wrong() shakes and returns the explanation.
+const stageTap = (api, targets, show, yes, onRight, hint) => {
+ let locked = false, cur = -1;
+ const gs = targets.map(({ g, label, ok, wrong }) => {
+ g.classList.add('hit');
+ g.setAttribute('tabindex', 0);
+ g.setAttribute('role', 'button');
+ g.setAttribute('aria-label', label);
+ const act = () => {
+ if (locked) return;
+ if (ok) { g.classList.add('good'); onRight?.(); api.grade(true, yes); }
+ else { g.classList.add('bad'); api.grade(false, wrong()); }
+ };
+ g.addEventListener('click', act);
+ keyAct(g, act);
+ return g;
+ });
+ return {
+ reveal() { gs[show].classList.add('good'); onRight?.(); return yes; },
+ lock() { locked = true; },
+ hint,
+ 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 a point on the stage number line.
+const tap = (values, right, yes, no, onRight) => (body, api) => {
+ const L = qlayer();
+ const targets = values.map(v => {
+ const g = G(L, { x: X(v), y: Y0 });
+ mk('circle', { r: 30, class: 'ring' }, g);
+ return { g, label: translate('pointLabel', { v: num(v) }), ok: v === right, wrong: () => { shakeFx(S.dots[v]); return no(v); } };
+ });
+ return stageTap(api, targets, values.lastIndexOf(right), yes, onRight,
+ [kbd('←'), kbd('→'), translate('hintMoveAlongLine'), kbd('Enter'), translate('hintChoose')]);
+};
+// 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();
+ const targets = idx.map(i => {
+ const e = row[i], w = e._w + 18, g = G(L, { x: e._px, y: row.y });
+ mk('rect', { class: 'ring', x: -w / 2, y: -row.size * .95, width: w, height: row.size * 1.3, rx: 12 }, g);
+ return { g, label: e.textContent.trim(), ok: i === right, wrong: () => { shakeFx(e); return no(i); } };
+ });
+ return stageTap(api, targets, idx.indexOf(right), yes, onRight,
+ [kbd('←'), kbd('→'), translate('hintMove'), kbd('Enter'), translate('hintChoose')]);
+};
+// 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();
+ const targets = items.map((it, i) => {
+ const [x, y, w, hh] = it.box, g = G(L);
+ mk('rect', { class: 'ring', x, y, width: w, height: hh, rx: 12 }, g);
+ return { g, label: it.label, ok: i === right, wrong: () => { shakeFx(it.el); return no(i); } };
+ });
+ return stageTap(api, targets, right, yes, onRight,
+ [kbd('←'), kbd('→'), translate('hintMove'), kbd('Enter'), translate('hintChooseOrClick')]);
+};
+// 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 ? [] : [translate('rowsRight', { r: right, n: rows.length })], { 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 : translate('choicesShown');
+ },
+ lock() { locked = true; showCur(); rows.forEach(r => r.bs.forEach(b => { b.disabled = true; })); },
+ hint: [...(single ? [] : [kbd('↑'), kbd('↓'), translate('hintRow')]), ...(/\d/.test(hot[0]) ? [kbd(hot[0]), '–', kbd(hot[hot.length - 1])] : hot.map(kbd)), translate('hintChoose')],
+ 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 => isShortcut(e, x));
+ 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, a currency sign before or after ($5, -$5, 5 €), thousands grouped by spaces (any kind)
+// or, where the decimal sign is a point, by commas, and a decimal comma when DECIMAL_SIGN is ','. Never evaluates the text as code.
+function rat(str) {
+ let t = String(str).trim().replace(/^[−–]/, '-').replace(/\s+/g, ' ').replace(/^(-?) ?\p{Sc} ?|(?<=\d) ?\p{Sc}$/gu, '$1');
+ const group = DECIMAL_SIGN === ',' ? ' ' : '[, ]'; // one kind of separator throughout: 1,000 000 is not a number
+ t = t.replace(new RegExp(`^(-?\\d{1,3})(${group})(\\d{3}(?:\\2\\d{3})*)(?=$|[.,])`), (_, head, sep, rest) => head + rest.split(sep).join(''));
+ if (DECIMAL_SIGN === ',') t = t.replace(/^(-?\d+),(\d+)$/, '$1.$2'); // 0,75 where the decimal sign is a comma
+ 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', translate('answerBox'));
+ 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;
+ };
+ // not on the frame ?beat=N opens before the lesson has started: there Space starts it rather than typing a space
+ requestAnimationFrame(() => { if (P.started) 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 ? [] : [translate('rowsRight', { r: right, n: rows.length })];
+ 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 : translate('numbersShown');
+ },
+ lock() { all.forEach(b => { b.disabled = true; }); },
+ hint: [translate(all.some(b => b.dataset.ans.includes('/')) ? 'hintTypeFraction' : all.some(b => /[.,]/.test(b.dataset.ans)) ? 'hintTypeDecimal' : 'hintTypeNumber'),
+ kbd('Tab'), translate('hintNextBox'), kbd('Enter'), translate('hintCheck'), kbd('Esc'), translate('hintLeaveBox')],
+ };
+};
+
+/* ---------- sound effects and music ----------
+ sfx(beat, at, name, vol, bed): play audio/sfx/<name>.mp3 when the clock of beat `beat` passes `at` in normal playback
+ (a seek past it fires nothing), at half volume (vol 2 is full). A long ambience is listed in SFX_BED with its length
+ (SFX_BED.birds = 10): a seek into it joins it part-way. A beat function runs again at every seek; an effect is listed once.
+ An effect still loading when it is due plays late, joined part-way, for up to a second (or its bed).
+ music(file, beats, gain, fade): a looping track under the listed beats (all of them by default). Its place is the
+ length of its earlier beats plus the clock. It ducks to 30 % under the whole beat, or 70 % in the music-only lead-in
+ (`pre`) of the beats in window.MUSIC_UP_IN_PRE (true: every beat). It crossfades over `fade` s (0: a cut), and
+ window.MUSIC_OFF = { beat: t => true } fades it out for a moment.
+ export.py reads SFX, BGM and these settings, and mixes the film by the same rules.
+ Films only (a chapter without questions): effects and music go through one Web Audio graph, so ducks, fades and the
+ volume slider reach them on phones too (iOS ignores an element's .volume). A pause holds them; a seek stops the effects.
+ When a clip loading or buffering holds the film's clock, the music runs on and then eases back (5 % slower or faster),
+ or jumps back once if it is more than a second out. */
+const SND = { sfx: [], bed: {}, bgm: [], len: [], on: [], wait: [], buf: {}, ctx: null, out: null, last: { i: -1, t: 0 }, duck: .3 };
+const everyBeat = () => { try { return BEATS.map(b => b.id); } catch { return undefined; } }; // undefined until BEATS is defined
+// window properties, not declarations: a book with its own older sfx() or BGM declares them over these
+Object.assign(window, { SFX: SND.sfx, SFX_BED: SND.bed, BGM: SND.bgm,
+ sfx(beat, at, name, vol = 1, bed = SND.bed[name] || 0) {
+ const e = SND.sfx.find(x => x.beat === beat && x.at === at && x.name === name);
+ if (e) Object.assign(e, { vol, bed }); else SND.sfx.push({ beat, at, name, vol, bed });
+ sfxLoad(name);
+ },
+ // without beats, every beat: boot() fills them in when music() comes before BEATS
+ music(file, beats = everyBeat(), gain = 1, fade = .8) {
+ const m = { n: file, beats, gain, fade, v: 0, a: Object.assign(new Audio(file), { preload: 'auto', loop: true, volume: 0 }) };
+ SND.bgm.push(m);
+ if (SND.ctx) bgmWire(m);
+ },
+});
+// An effect is fetched and decoded at once, before the first click builds the sound graph: decoding needs no running
+// context (an AudioBuffer plays in any), so an effect due in the first second after Play, or after an early seek, is
+// ready instead of dropped on a slow line.
+let DECODER = null;
+function sfxLoad(name) {
+ const s = SND.buf[name] ??= { data: fetch(`audio/sfx/${name}.mp3`).then(r => r.ok ? r.arrayBuffer() : null).catch(() => null) };
+ const ctx = SND.ctx || (window.OfflineAudioContext && (DECODER ??= new OfflineAudioContext(2, 1, 44100)));
+ if (ctx && !s.decoded) s.decoded = s.data.then(d => d && ctx.decodeAudioData(d)).then(b => { s.b = b; }, () => {});
+}
+function sfxPlay(e, late) {
+ const ctx = SND.ctx, src = ctx.createBufferSource(), g = ctx.createGain();
+ src.buffer = SND.buf[e.name].b; src._sfx = e.name; g.gain.value = src._vol = .5 * e.vol;
+ src.playbackRate.value = P.rate;
+ src.connect(g).connect(SND.out);
+ src.start(0, late && !e.bed ? 0 : Math.max(0, P.t - e.at)); // a late one-shot starts from its attack
+ SND.on.push(src);
+ src.onended = () => { const k = SND.on.indexOf(src); if (k >= 0) SND.on.splice(k, 1); };
+}
+function bgmWire(m) {
+ m.g = SND.ctx.createGain();
+ SND.ctx.createMediaElementSource(m.a).connect(m.g).connect(SND.out);
+ m.a.volume = 1;
+}
+// A browser starts sound only after a click or a key: the first one builds the graph (films only) and readies the music.
+function soundUnlock() {
+ if (typeof BEATS === 'undefined') return; // the chapter's script has not run yet
+ if (!SND.ctx && window.AudioContext && (!BEATS.some(b => b.ask) || CHAPTER.film)) { // a film with a question (CHAPTER.film) keeps its sound
+ if (navigator.audioSession) navigator.audioSession.type = 'playback'; // iOS: the silent switch must not mute the film
+ SND.ctx = new AudioContext();
+ SND.out = SND.ctx.createGain();
+ SND.out.connect(SND.ctx.destination);
+ for (const n in SND.buf) sfxLoad(n);
+ for (const m of SND.bgm) bgmWire(m);
+ }
+ if (SND.ctx && SND.ctx.state !== 'running' && SND.ctx.state !== 'closed') SND.ctx.resume().catch(() => {}); // also iOS 'interrupted'
+ for (const m of SND.bgm) if (!m.blessed) { // iOS lets an element play later only if it once played inside a click
+ m.blessed = true; m.a.muted = true;
+ m.a.play().then(() => { if (!m.cur) m.a.pause(); m.a.muted = false; }, () => { m.a.muted = false; m.blessed = false; });
+ }
+}
+// a touch activates the page on touchend or click, not on pointerdown
+for (const type of ['pointerdown', 'touchend', 'click', 'keydown']) addEventListener(type, soundUnlock, true);
+// Safari (and every iOS browser) stops a media element for .3-.6 s at each playbackRate change, so easing the music
+// back would only push it further out: there it keeps the film's rate and seeks instead.
+const RATE_STALLS = /AppleWebKit/.test(navigator.userAgent) && !/Chrome\/|Android/.test(navigator.userAgent);
+function soundTick(dt) {
+ const id = BEATS[P.i]?.id, pre = BEATS[P.i]?.pre || 0, on = P.started && P.playing && !P.waiting && !P.done, L = SND.last;
+ // a film waiting for the reader (CHAPTER.film, a question beat after its narration): the music plays on, louder
+ const wait = P.started && P.playing && P.waiting && !P.done && !!CHAPTER.film;
+ const held = P.started && !P.playing && !P.done, ctx = SND.ctx;
+ if (ctx?.state === 'running' && held) ctx.suspend();
+ else if (ctx && ctx.state !== 'running' && ctx.state !== 'closed' && !held) ctx.resume().catch(() => {});
+ // the clock ran on (or stood still, paused) in the same beat; anything else is a seek, a replay or the next beat
+ const same = L.i === P.i && P.t >= L.t && P.t - Math.max(0, L.t) < Math.max(.5, dt * P.rate + .25);
+ if (!same) { while (SND.on.length) SND.on.pop().stop(); SND.wait = []; }
+ // a beat that has just begun fires its effects from 0 on; a seek fires nothing it skipped, but joins a bed
+ const from = same ? L.t : P.t < .25 ? -1 : P.t, seeked = !same || L.pend;
+ if (on && ctx) {
+ for (const e of SND.sfx) {
+ if (e.beat !== id || !(e.at > from && e.at <= P.t || seeked && e.bed && e.at < P.t && P.t < e.at + e.bed)) continue;
+ if (SND.buf[e.name]?.b) sfxPlay(e); else SND.wait.push(e);
+ }
+ SND.wait = SND.wait.filter(e => P.t - e.at < (e.bed || 1) && !(SND.buf[e.name]?.b && (sfxPlay(e, true), true)));
+ for (const s of SND.on) if (s.playbackRate.value !== P.rate) s.playbackRate.value = P.rate;
+ }
+ SND.last = { i: P.i, t: on ? P.t : from, pend: !on && (!same || !!L.pend) };
+ const vol = +($('volume')?.value ?? 1), up = window.MUSIC_UP_IN_PRE;
+ if (SND.out) SND.out.gain.value = vol;
+ if (!SND.bgm.length || BEATS.some(b => b.ask) && !CHAPTER.film) return; // a lesson with questions plays no music
+ // the film's clock moved this frame (a clip loading or buffering holds it), or jumped (a seek, a replay)
+ const runs = on && same && P.t > L.t, jump = !same && !(L.i === P.i - 1 && P.t < .5);
+ if (!held) SND.duck += Math.max(-dt, Math.min(dt, (wait || P.t < pre && (up === true || up?.includes?.(id)) ? .7 : .3) - SND.duck));
+ for (const m of SND.bgm) {
+ const k = m.beats.indexOf(id), current = (on || wait) && k >= 0 && !window.MUSIC_OFF?.[id]?.(P.t);
+ if (jump) m.off = 0; // a seek or a replay puts every track back where the film's own timing says
+ if (wait && current) m.off = (m.off || 0) + dt * P.rate; // the time it ran on while the reader decided
+ m.cur = current;
+ if (!held) m.v = m.fade > 0 ? Math.max(0, Math.min(1, m.v + (current ? 1 : -1) * dt / m.fade)) : +current;
+ const g = m.v * m.gain * SND.duck;
+ if (m.g) m.g.gain.value = g; else m.a.volume = Math.min(1, g * vol);
+ if (current) {
+ // where the film is: the beats before this one in the track as they really ran (P.end), plus now
+ const dur = m.a.duration || Infinity;
+ const want = (m.beats.slice(0, k).reduce((s, b) => s + (SND.len[BEATS.findIndex(x => x.id === b)] || 0), 0) + P.t + (m.off || 0)) % dur;
+ let d = m.a.currentTime - want;
+ if (d > dur / 2) d -= dur; else if (d < -dur / 2) d += dur;
+ // a start, a jump, or more than a second out once the clock runs again: seek. Less: ease back while the clock runs,
+ // from .25 s out until .05 s
+ const ok = runs && !m.a.seeking;
+ // (once more after a jump: the element plays on while it seeks)
+ // Where a rate change stalls, starting and seeking stall too: once a second the music's lag is learnt (m.lead),
+ // seeks aim that far ahead, and a quarter second out is then worth a seek.
+ let far = m.settle ? .25 : 1;
+ m.sought ??= clock;
+ if (RATE_STALLS && ok && clock - m.sought > 1) {
+ m.sought = clock; m.lead = Math.max(0, Math.min(.6, (m.lead || 0) - d)); far = .25;
+ }
+ if (m.a.paused || jump && Math.abs(d) > .05 || ok && Math.abs(d) > far) {
+ m.a.currentTime = (want + (RATE_STALLS && m.lead || 0)) % dur; d = 0; m.settle = !ok; m.sought = clock;
+ } else if (ok) m.settle = false;
+ if (Math.abs(d) > .25) m.fix = true; else if (Math.abs(d) < .05) m.fix = false;
+ // a frame where the clock stood still keeps the rate it had
+ const rate = !m.fix || RATE_STALLS ? P.rate : ok ? P.rate * (1 - Math.sign(d) * .05) : m.a.playbackRate;
+ if (Math.abs(m.a.playbackRate - rate) > .001) m.a.playbackRate = rate;
+ if (m.a.paused) m.a.play().catch(() => {});
+ } else {
+ if (m.a.playbackRate !== P.rate) m.a.playbackRate = P.rate;
+ if (m.v === 0 && !m.a.paused) m.a.pause();
+ }
+ }
+ if (!on && !wait && !P.done) for (const m of SND.bgm) m.a.pause();
+}
+
+/* ---------- player ---------- */
+const P = { i: 0, t: 0, end: 1, back: 0, 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], pre = b.pre || 0; // pre: seconds of picture before the narration starts
+ const m = (k, off = 0) => {
+ if (!(k in tm.marks)) throw new Error(`${b.id}: missing mark ${k}`);
+ return pre + tm.marks[k] + off;
+ };
+ S.cleared = false;
+ b.run(m, pre + tm.dur);
+ if (S.cleared && b.lead !== false && CHAPTER.lead !== false && !pre) leadIn(); // CHAPTER.lead false: no beat gets one (a film)
+ TW.sort((a, c) => a.t0 - c.t0);
+ // runs that last to the end anyway (tails, follow cameras) do not set it: only the narration and the other tweens do,
+ // and minDur, the least the whole beat lasts (two mirrored beats run the same seconds)
+ const end = Math.max(Math.max(pre + tm.dur, ...TW.filter(w => !w.tail).map(w => w.t0 + w.dur)) + HOLD, b.minDur || 0);
+ const tail = TW.some(w => w.tail === true);
+ for (const w of TW) if (w.tail === true || tail && w.tail === 'follow') w.dur = end - w.t0;
+ return SND.len[i] = end; // the music places itself by how long each beat really runs
+}
+const HOLD = .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 pre = BEATS[i].pre || 0, t = BEATS[i].ask && !CHAPTER.film ? 0 : frac * (pre + TIMINGS[BEATS[i].id].dur); // a film's question beats seek like any other
+ if (t < .3) return;
+ P.t = t;
+ evalTo(t);
+ if (P.audio) P.audio.currentTime = Math.max(0, t - pre);
+}
+function start(i, play) {
+ stopAudio(); clearCards();
+ // P.gen counts starts: a done() kept from an earlier start of this same beat (a step replayed) no longer counts
+ const gen = P.gen = (P.gen || 0) + 1;
+ Object.assign(P, { i, t: 0, waiting: false, done: false, afail: false, stall: 0, lost: 0, back: 0 });
+ P.end = runBeat(i);
+ evalTo(0);
+ const a = P.audio = beatClip(i, true);
+ if (a) { // a beat with no narration ({ dur }) has no clip: wall time drives its clock
+ 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 = Math.max(0, P.t - (BEATS[P.i].pre || 0)); } // sound came back late: rejoin the picture where it is
+ };
+ }
+ const b = BEATS[i];
+ if (b.ask) b.ask(() => {
+ if (P.gen !== gen || P.done) return;
+ evalTo(Infinity);
+ if (i + 1 < BEATS.length) start(i + 1, true);
+ else { P.done = true; setPlaying(false); filmDone(); }
+ });
+ 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) {
+ if (TIMINGS[BEATS[i].id]?.silent) return null;
+ // the clip's length rides on the URL: regenerated narration gets a new address, so a browser cache cannot pair new
+ // timings with an old clip
+ const src = `audio/${CHAPTER.language || 'en'}/${BEATS[i].id}.mp3?v=${TIMINGS[BEATS[i].id]?.dur ?? ''}`;
+ 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;
+ const lead = v && P.t < (BEATS[P.i]?.pre || 0);
+ if (v && !P.waiting && !a.ended && !P.afail && !lead) a.play().catch(e => { if (P.audio === a && e.name === 'NotAllowedError') soundFailed(); });
+ else if (lead && !a._unlocked) { // the clip starts later, outside this click: play it silently now so the browser allows that
+ a._unlocked = true; a.muted = true;
+ a.play().then(() => { if (P.t < (BEATS[P.i].pre || 0)) { a.pause(); a.currentTime = 0; } a.muted = false; }, () => { a.muted = false; });
+ } else a.pause();
+}
+function beatDone() {
+ // Steps finish; continuous motion (tails) stays where the clock is: a beat under music ends up to HOLD early, and
+ // jumping its tails to their end would move them a few px on the last frame
+ evalTo(Infinity, TW.filter(w => !w.tail));
+ 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); filmDone(); }
+}
+// A chapter that ends on its last frame, with no closing card of questions (a picture book), is finished there: it
+// counts as done, and CHAPTER.next is offered over that frame. Seeking or replaying clears the button with the cards.
+function filmDone() {
+ progress(p => { p.done = [...new Set([...(p.done || []), CHAPTER.number])]; });
+ document.activeElement?.blur(); // a last question's Continue keeps focus, and Enter would press it again
+ // as on the finish card: Enter opens the next chapter (or replays), R and Space replay
+ const go = () => { if (CHAPTER.next) location.href = CHAPTER.next; else restart(); };
+ P.keys = e => e.key === 'Enter' ? (go(), true) : isShortcut(e, 'r') ? (restart(), true) : false;
+ if (!CHAPTER.next) return;
+ const next = h('button', 'btn go', [translate('nextChapter'), kbd('Enter')]);
+ next.onclick = go;
+ const c = card({ x: 0, y: SH - 130, w: 0, cls: 'side' }, 'next');
+ Object.assign(c.style, { left: 'auto', right: '40px', width: 'auto' });
+ c.append(h('div', 'acts', [next]));
+}
+let last = performance.now();
+function frame(now) {
+ frameStep(now, .1);
+ requestAnimationFrame(frame);
+}
+function frameStep(now, most) {
+ const raw = Math.max(0, now - last) / 1000, dt = Math.min(most, raw);
+ 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, t0 = P.t;
+ // While the clip plays, its clock drives the picture; before it starts or after it ends, wall time does.
+ const pre = BEATS[P.i].pre || 0;
+ if (a && P.t < pre) { // the picture's lead before the narration, on wall time; then the clip starts
+ P.t += dt * P.rate;
+ if (P.t >= pre && !P.afail) { a.muted = false; a.currentTime = P.t - pre; a.play().catch(e => { if (P.audio === a && e.name === 'NotAllowedError') soundFailed(); }); }
+ } else if (a && !P.afail && !a.ended) {
+ if (a.currentTime > 0) { P.t = Math.max(P.t, pre + 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;
+ // P.lost: how long the clock stood still while the film played (a clip getting going, buffering). Music runs on
+ // through it, so a beat under music gives that time back from its closing hold: each beat then lasts as long in
+ // real time as on the music's timeline, and the music stays with the picture instead of drifting ahead beat by beat.
+ P.lost += raw * P.rate - (P.t - t0); // real time: a long frame moves the music by all of it
+ const back = P.back = SND.bgm.some(m => m.beats.includes(BEATS[P.i].id)) ? Math.max(0, Math.min(HOLD, P.lost)) : 0;
+ evalTo(P.t);
+ if (P.t >= P.end - back) beatDone();
+ }
+ soundTick(dt);
+ syncLinks();
+ ui();
+}
+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', translate('goToStep', { n: i + 1, title: 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;
+ });
+}
+// ui() runs on every frame, paused or not: it writes only what changed, so an idle lesson does no layout work.
+let stepText = '';
+const setWidth = (f, w) => { if (f._w !== w) { f._w = w; f.style.width = w + '%'; } };
+function ui() {
+ segs.forEach((f, k) => setWidth(f, k < P.i || P.done ? 100 : k > P.i ? 0 : Math.min(100, P.t / P.end * 100)));
+ const fr = $('frame');
+ fr.classList.toggle('is-playing', P.playing && !P.done && !P.waiting);
+ fr.classList.toggle('held', P.started && (!P.playing || P.done)); // paused or ended: full screen keeps the controls
+ fr.classList.toggle('paused', P.started && !P.playing && !P.waiting && !P.done && !BEATS[P.i].ask);
+ const step = `${P.i + 1} / ${BEATS.length} ${BEATS[P.i].title}`;
+ if (step !== stepText) { stepText = step; $('stepName').textContent = step; }
+ const b = BEATS[P.i];
+ let text = '';
+ // a question's caption shows while its narration plays, clear of the cards; a full-screen card already shows the
+ // question, so it has none
+ const asking = !!b.ask;
+ if (P.started && !P.done && !(asking && (P.waiting || $('ui').querySelector('.card.screen')))) {
+ // a cue is [start, line], [start, line, end] or [start, line, end, 1]: with an end, the caption clears once its
+ // words are over; a 1 marks a line in another language, whose subtitle shows even with captions off (as does every
+ // cue of a beat whose timings say forced: true, from tts.py or eleven.py)
+ // the last line without an end clears a second after the narration, so it does not sit on a closing title
+ const cues = TIMINGS[b.id].cues;
+ for (const [k, [t, line, end = k === cues.length - 1 ? TIMINGS[b.id].dur + 1 : null, forced]] of cues.entries()) {
+ if (t + (b.pre || 0) > P.t + .05) break;
+ text = (captions || forced || TIMINGS[b.id].forced) && !(end != null && P.t > end + (b.pre || 0)) ? line : '';
+ }
+ }
+ if (text !== capText) { capText = text; $('caption').textContent = text; $('caption').hidden = !text; }
+ if (text) placeCaption(asking);
+}
+// Above a bottom band, or centred left of a card in the bottom right; elsewhere the caption keeps its place.
+let capAt = '';
+function placeCaption(asking) {
+ const c = asking ? $('ui').querySelector('.card.band, .card.side') : null;
+ let at = '';
+ if (c?.classList.contains('band')) at = `${SH + 60 - c.offsetTop + 12}||`;
+ else if (c && c.offsetLeft > 800 && c.offsetTop + c.offsetHeight > 700) at = `|${c.offsetLeft / 2}|${c.offsetLeft - 60}`;
+ if (at === capAt) return;
+ capAt = at;
+ const [bottom, left, width] = at.split('|'), s = $('caption').style;
+ Object.assign(s, { bottom: bottom && bottom + 'px', left: left && left + 'px', maxWidth: width && width + 'px' });
+}
+let capText = '';
+try { captions = localStorage.getItem('captions') === '1'; } catch {}
+function setCaptions(on, save = true) {
+ captions = on;
+ $('bCC').setAttribute('aria-pressed', String(on));
+ if (save) try { localStorage.setItem('captions', on ? '1' : '0'); } catch {}
+}
+setCaptions(captions, false); // only the reader's own choice is stored, so a book can still pick the first-time default
+function hideCover() {
+ P.started = true; $('cover').hidden = true;
+ // a question that ?beat=N opened before the start (its box waited unfocused, so Space started) now takes the typing
+ if (BEATS[P.i].ask) $('ui').querySelector('input.box:not(:disabled)')?.focus({ preventScroll: true });
+}
+function togglePlay() {
+ if (!P.started) { turnPhone(); hideCover(); return setPlaying(true); }
+ if (P.done) return restart(); // the end of a film (or of a chapter whose last step is a question): play again
+ if (P.waiting) 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 => {
+ if (e.target.closest('a.cite')) { if (P.playing && !P.waiting) setPlaying(false); return; } // opening a source pauses the lesson
+ const b = BEATS[P.i];
+ if (!b.ask && !P.done && !e.target.closest('.qlayer')) togglePlay(); // a tap on a finished film's last frame does nothing
+});
+const citeObs = new MutationObserver(ms => { for (const m of ms) for (const n of m.addedNodes) autoCite(n); });
+citeObs.observe(scene, { childList: true, subtree: true });
+citeObs.observe($('ui'), { childList: true, subtree: true });
+$('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();
+// Full screen also turns the screen to the stage's orientation where the browser allows it (Android browsers lock
+// orientation only in full screen; iOS has no lock, so there the reader turns the phone). On a phone held across the
+// stage's orientation, starting the lesson goes full screen the same way, since the stage would otherwise be a strip.
+function goFull() {
+ return document.documentElement.requestFullscreen?.({ navigationUI: 'hide' })
+ .then(() => screen.orientation?.lock?.(PORTRAIT ? 'portrait' : 'landscape')).catch(() => {});
+}
+function turnPhone() {
+ const phone = matchMedia('(pointer: coarse)').matches && Math.min(screen.width, screen.height) <= 600;
+ if (phone && !document.fullscreenElement && (innerHeight > innerWidth) !== PORTRAIT) goFull();
+}
+const toggleFull = () => document.fullscreenElement ? document.exitFullscreen() : goFull();
+// In full screen the stage fills the screen and the controls lie over its foot: they show while the pointer moves (a
+// tap on a phone) or a key is pressed, for 2.5 s after, while paused and while the pointer is on them.
+document.addEventListener('fullscreenchange', () => {
+ document.documentElement.classList.toggle('full', !!document.fullscreenElement);
+ fit(); wake();
+ if (!document.fullscreenElement) try { screen.orientation?.unlock?.(); } catch {}
+});
+let wakeT = 0;
+function wake() { $('frame').classList.add('awake'); clearTimeout(wakeT); wakeT = setTimeout(() => $('frame').classList.remove('awake'), 2500); }
+for (const type of ['pointermove', 'pointerdown', 'keydown']) addEventListener(type, wake, true);
+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);
+}
+// Review notes, only with ?review in the URL: N pauses and asks for a note on this moment, Shift+N copies every
+// note of the chapter (one line each, with the ?beat=N&t=S that reopens it) and offers to clear them.
+const REVIEW = new URLSearchParams(location.search).has('review');
+const REVIEW_KEY = 'papermorph:review:' + location.pathname;
+const reviewNotes = () => { try { return JSON.parse(localStorage.getItem(REVIEW_KEY) || '[]'); } catch { return []; } };
+function reviewNote() {
+ if (P.playing) setPlaying(false);
+ const at = `?beat=${P.i}&t=${P.t.toFixed(1)}`, note = prompt(`Note at ${BEATS[P.i].id} ${at}`);
+ if (!note) return;
+ try { localStorage.setItem(REVIEW_KEY, JSON.stringify([...reviewNotes(), `ch${String(CHAPTER.number).padStart(2, '0')} ${at} (${BEATS[P.i].id}): ${note}`])); } catch {}
+}
+function reviewCopy() {
+ const notes = reviewNotes(), text = notes.join('\n');
+ console.log(text);
+ navigator.clipboard?.writeText(text).catch(() => {});
+ if (confirm(`${notes.length} notes copied (also in the console). Clear them?`)) try { localStorage.removeItem(REVIEW_KEY); } catch {}
+}
+// 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 (REVIEW && isShortcut(e, 'n')) { e.preventDefault(); e.shiftKey ? reviewCopy() : reviewNote(); 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 || P.done; // after the end no question holds the arrows
+ 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 (isShortcut(e, 'c')) setCaptions(!captions);
+ else if (k === '<' || k === ',' || isShortcutCode(e, 'Comma')) stepSpeed(-1);
+ else if (k === '>' || k === '.' || isShortcutCode(e, 'Period')) stepSpeed(1);
+ else if (isShortcut(e, '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;
+// full screen: the stage alone, except that a touch screen keeps the controls under it (engine.css)
+const fit = () => document.documentElement.style.setProperty('--k', document.fullscreenElement
+ ? Math.min(innerWidth / SW, (innerHeight - (matchMedia('(pointer: coarse)').matches ? innerWidth <= 700 ? 110 : 60 : 0)) / SH)
+ : Math.min(innerWidth / (SW + 40), (innerHeight - (innerWidth <= 700 ? 120 : 0)) / (SH + 100)));
+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.
+function boot() {
+ // a beat with no narration: { dur } in its fourth slot stands in for its clip and its TIMINGS entry
+ window.TIMINGS ??= {};
+ for (const b of BEATS) if (!TIMINGS[b.id] && b.dur != null) TIMINGS[b.id] = { dur: b.dur, marks: {}, cues: [], silent: true };
+ for (const m of SND.bgm) { // music() above BEATS plays under every beat
+ m.beats ??= BEATS.map(b => b.id);
+ const lost = m.beats.filter(id => !BEATS.some(b => b.id === id));
+ if (lost.length) console.warn(`music('${m.n}'): no beat ${lost.join(', ')} in BEATS`);
+ }
+ $('coverK').textContent = translate('chapterNumber', { n: CHAPTER.label ?? 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', translate('stageLabelTitled', { title: CHAPTER.title }));
+ const film = !!CHAPTER.film || !BEATS.some(b => b.ask); // a picture book or a film: no "lesson" or "quick checks" on its cover
+ if (film) $('coverGo').textContent = translate('startFilm');
+ if (film && (!BEATS.some(b => b.ask) || CHAPTER.questionKeys === false)) { // nothing to answer with keys (or its own controls): the help lists no question keys and needs no column titles
+ const shift = [...$('help').querySelectorAll('dt')].find(e => e.textContent.startsWith('Shift'));
+ for (const e of [$('help').querySelector('.help-cols > :last-child'), $('help').querySelector('h3'), shift, shift.nextElementSibling]) e.hidden = true;
+ }
+ $('coverMeta').textContent = translate(film ? 'aboutMinutesFilm' : 'aboutMinutes', { n: num(CHAPTER.minutes) });
+ buildSegs();
+ const qs = new URLSearchParams(location.search);
+ if (qs.has('lengths')) { // each beat's voice against its length on screen: a tween or a run past the voice lengthens it
+ reset(); seeking = true;
+ try { for (let k = 0; k < BEATS.length; k++) { runBeat(k); evalTo(Infinity); } } finally { seeking = false; }
+ console.log(`?lengths: beat, voice (pre + clip), on screen (hold included), and the time past voice + ${HOLD} s hold\n` + BEATS.map((b, i) => {
+ const v = (b.pre || 0) + TIMINGS[b.id].dur, over = SND.len[i] - HOLD - v;
+ return `${b.id.padEnd(16)} ${v.toFixed(2).padStart(6)} ${SND.len[i].toFixed(2).padStart(6)}${over > .005 ? ` +${over.toFixed(2)}` : ''}`;
+ }).join('\n'));
+ }
+ if (qs.has('beat')) {
+ $('cover').hidden = true;
+ seek(Math.max(0, Math.min(BEATS.length - 1, qs.get('beat') | 0)), false);
+ P.t = +(qs.get('t') || 0);
+ evalTo(P.t);
+ if (P.audio) P.audio.currentTime = Math.max(0, P.t - (BEATS[P.i].pre || 0));
+ } else seek(0, false);
+ requestAnimationFrame(frame);
+ // A hidden tab gets no animation frames: a timer keeps the film going, so a beat that ends there still starts the next
+ // one (a tab playing sound keeps its timers). Its ticks come late, so they may move the clock further at once.
+ setInterval(() => { if (document.hidden) frameStep(performance.now(), 1.5); }, 250);
+}
+return { TRANSLATIONS, PORTRAIT, SW, SH, LANGUAGE, translate, DECIMAL_SIGN, isShortcut, NS, UI, BOOK, bookSetting,
+ COL, MATH, NAME, BAND, RIGHT, TOPR, SCREEN, SORT_SCREEN, $m, mk, st, put, render, G, path, T, cite, ctx2d, textW, F,
+ R, E, TX, $tex, texGraphic, texPart, OV, M, chip, tokens, layRow, collapse, mathEl, io, out, back, lin, tw, prog,
+ show, hide, draw, pop, pulse, stream, mix, evalTo, soft, clockRun, camera, scene, S, AXIS, X, Y0, num, reset, tick,
+ dot, arrow, panel, retire, header, fx, fxp, finishFx, pulseFx, shakeFx, floatText, TF, $, kbd, sources, uiW, SCORE,
+ h, rich, card, mascotEl, quiz, qlayer, keyAct, choice, mcq, tap, tapEls, pickEls, grid, rat, gcd, lowest, blanks,
+ SND, P, HOLD, clearCards, seek, seekInto, start, setSpeed, setPlaying, setCaptions, hideCover, restart, boot,
+ finishCard };
+})();
+
+// The API, one global each: lint.py reads these declarations, and a chapter that declares one of them again stops
+// with an error, as before.
+const TRANSLATIONS = ENGINE.TRANSLATIONS, PORTRAIT = ENGINE.PORTRAIT, SW = ENGINE.SW, SH = ENGINE.SH,
+ LANGUAGE = ENGINE.LANGUAGE, translate = ENGINE.translate, DECIMAL_SIGN = ENGINE.DECIMAL_SIGN,
+ isShortcut = ENGINE.isShortcut, NS = ENGINE.NS, UI = ENGINE.UI, BOOK = ENGINE.BOOK,
+ bookSetting = ENGINE.bookSetting, COL = ENGINE.COL, MATH = ENGINE.MATH, NAME = ENGINE.NAME, BAND = ENGINE.BAND,
+ RIGHT = ENGINE.RIGHT, TOPR = ENGINE.TOPR, SCREEN = ENGINE.SCREEN, SORT_SCREEN = ENGINE.SORT_SCREEN, $m = ENGINE.$m,
+ mk = ENGINE.mk, st = ENGINE.st, put = ENGINE.put, render = ENGINE.render, G = ENGINE.G, path = ENGINE.path,
+ T = ENGINE.T, cite = ENGINE.cite, ctx2d = ENGINE.ctx2d, textW = ENGINE.textW, F = ENGINE.F, R = ENGINE.R,
+ E = ENGINE.E, TX = ENGINE.TX, $tex = ENGINE.$tex, texGraphic = ENGINE.texGraphic, texPart = ENGINE.texPart,
+ OV = ENGINE.OV, M = ENGINE.M, chip = ENGINE.chip, tokens = ENGINE.tokens, layRow = ENGINE.layRow,
+ collapse = ENGINE.collapse, mathEl = ENGINE.mathEl, io = ENGINE.io, out = ENGINE.out, back = ENGINE.back,
+ lin = ENGINE.lin, tw = ENGINE.tw, prog = ENGINE.prog, show = ENGINE.show, hide = ENGINE.hide, draw = ENGINE.draw,
+ pop = ENGINE.pop, pulse = ENGINE.pulse, stream = ENGINE.stream, mix = ENGINE.mix, evalTo = ENGINE.evalTo,
+ soft = ENGINE.soft, clockRun = ENGINE.clockRun, camera = ENGINE.camera, scene = ENGINE.scene, S = ENGINE.S,
+ AXIS = ENGINE.AXIS, X = ENGINE.X, Y0 = ENGINE.Y0, num = ENGINE.num, reset = ENGINE.reset, tick = ENGINE.tick,
+ dot = ENGINE.dot, arrow = ENGINE.arrow, panel = ENGINE.panel, retire = ENGINE.retire, header = ENGINE.header,
+ fx = ENGINE.fx, fxp = ENGINE.fxp, finishFx = ENGINE.finishFx, pulseFx = ENGINE.pulseFx, shakeFx = ENGINE.shakeFx,
+ floatText = ENGINE.floatText, TF = ENGINE.TF, $ = ENGINE.$, kbd = ENGINE.kbd, sources = ENGINE.sources,
+ uiW = ENGINE.uiW, SCORE = ENGINE.SCORE, h = ENGINE.h, rich = ENGINE.rich, card = ENGINE.card,
+ mascotEl = ENGINE.mascotEl, quiz = ENGINE.quiz, qlayer = ENGINE.qlayer, keyAct = ENGINE.keyAct,
+ choice = ENGINE.choice, mcq = ENGINE.mcq, tap = ENGINE.tap, tapEls = ENGINE.tapEls, pickEls = ENGINE.pickEls,
+ grid = ENGINE.grid, rat = ENGINE.rat, gcd = ENGINE.gcd, lowest = ENGINE.lowest, blanks = ENGINE.blanks,
+ SND = ENGINE.SND, P = ENGINE.P, HOLD = ENGINE.HOLD, clearCards = ENGINE.clearCards, seek = ENGINE.seek,
+ seekInto = ENGINE.seekInto, start = ENGINE.start, setSpeed = ENGINE.setSpeed, setPlaying = ENGINE.setPlaying,
+ setCaptions = ENGINE.setCaptions, hideCover = ENGINE.hideCover, restart = ENGINE.restart, boot = ENGINE.boot;
+// Hooks: scorm-bridge.js wraps these two, and the engine calls progress() through this global.
+let finishCard = ENGINE.finishCard;
+// 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 {}
+}
diff --git a/site/linear-algebra/lib/linsys.js b/site/linear-algebra/lib/linsys.js
new file mode 100644
index 0000000..1dfe20e
--- /dev/null
+++ b/site/linear-algebra/lib/linsys.js
@@ -0,0 +1,263 @@
+// A 2 × 2 system (or one equation, rows: 1) drawn three ways from one state: the equations, the matrix form and the plane.
+// Every number on screen is the same value: scrub one (drag sideways, or focus it and press ↑/↓) and the lines,
+// the columns and the other copy follow; drag a line or an arrow tip in the plane and the numbers follow.
+// The beat moves it with sys.to(); a question turns the reader's hands on with sys.live(true).
+// Loads after engine.js and math.js (it uses plane()).
+const LS_ROW = [COL.whole, COL.nat], LS_COLS = [COL.irr, COL.real], LS_B = COL.task;
+
+function linsys(p, { A = [[2, -1], [-1, 2]], b = [0, 3], eq = [90, 250], mat = [90, 560], size = 54, plane: po = {}, view = 'row', rows = 2, hidePlane = false, sol: readout = rows === 2, t0 = .1 } = {}) {
+ const RI = rows === 2 ? [0, 1] : [0];
+ if (rows === 1) mat = null;
+ const v = { a00: A[0][0], a01: A[0][1], a10: A[1][0], a11: A[1][1], b0: b[0], b1: b[1] };
+ const RANGE = { a00: 9, a01: 9, a10: 9, a11: 9, b0: 30, b1: 30 };
+ // The plane sits in its own holder, so a beat can keep it hidden (hidePlane) and show sys.stage later.
+ const holder = G(p, { o: hidePlane ? 0 : 1 });
+ const P2 = plane(holder, { cx: 1160, cy: 450, u: 52, x0: -6, x1: 6, y0: -6, y1: 6, t0, ...po });
+ const { PX, PY } = P2, bx = [P2.x0, P2.x1], by = [P2.y0, P2.y1];
+ const svg = $('stage'), listeners = [], slots = [];
+ let live = false, plan = { ...v };
+
+ const fmt = (n, one = false) => {
+ const r = Math.round(n * 10) / 10, s = Number.isInteger(r) ? String(Math.abs(r)) : Math.abs(r).toFixed(1);
+ return (r < 0 ? '−' : '') + (one && Math.abs(r) === 1 ? '' : s);
+ };
+ const setText = (e, s) => { if (e.textContent !== s) e.textContent = s; };
+ const pt = e => { const q = svg.createSVGPoint(); q.x = e.clientX; q.y = e.clientY; const w = q.matrixTransform(P2.g.getScreenCTM().inverse()); return [(w.x - P2.cx) / P2.u, (P2.cy - w.y) / P2.u]; };
+ const clamp = (k, n) => Math.max(-RANGE[k], Math.min(RANGE[k], n));
+
+ /* ---------- numbers you can scrub ---------- */
+ // A slot is a number (and the letter after it) with a hit box; key names which value it shows.
+ function slot(g, key, x, y, { anchor = 'end', letter = '', one = false, fill = COL.chalk, w = 96 } = {}) {
+ const box = mk('rect', { x: anchor === 'end' ? x - w : anchor === 'middle' ? x - w / 2 : x, y: y - size * .85, width: w + (letter ? size * .6 : 0), height: size * 1.1, rx: 10, fill: 'transparent' }, g);
+ const t = T(g, '', { x, y, size, fill, font: MATH, anchor });
+ const l = letter ? T(g, letter, { x: x + 3, y, size, fill, font: MATH }) : null;
+ l?.setAttribute('font-style', 'italic');
+ t.style.pointerEvents = 'none'; if (l) l.style.pointerEvents = 'none'; // the box under them takes the drag
+ const s = { key, t, box, one, set: () => setText(t, fmt(v[key], one) || (one ? '' : '0')) };
+ box.setAttribute('aria-label', key);
+ let drag = null;
+ box.addEventListener('pointerdown', e => {
+ if (!live) return;
+ e.preventDefault();
+ drag = { x: e.clientX, from: Math.round(v[key]) };
+ box.setPointerCapture(e.pointerId);
+ });
+ box.addEventListener('pointermove', e => {
+ if (!drag) return;
+ const k = svg.getScreenCTM().a; // screen px per stage px
+ edit({ [key]: clamp(key, drag.from + Math.round((e.clientX - drag.x) / k / 22)) });
+ });
+ const end = () => { drag = null; };
+ box.addEventListener('pointerup', end);
+ box.addEventListener('lostpointercapture', end);
+ box.addEventListener('keydown', e => {
+ if (!live) return;
+ if (e.key === 'Enter') { e.preventDefault(); e.stopPropagation(); box.blur(); P.keys?.(e); return; } // Enter checks, as in an answer box
+ const d = { ArrowUp: 1, ArrowRight: 1, ArrowDown: -1, ArrowLeft: -1 }[e.key];
+ if (!d) return;
+ e.preventDefault(); e.stopPropagation(); // the player's ←/→ must not leave the beat
+ edit({ [key]: clamp(key, Math.round(v[key]) + d) });
+ });
+ slots.push(s);
+ return s;
+ }
+
+ /* ---------- the equations ---------- */
+ const E = G(p, { o: 0 }), eqRows = [];
+ RI.forEach(i => {
+ const y = eq[1] + i * 92, x = eq[0];
+ const bar = mk('rect', { x: x - 34, y: y - size * .7, width: 8, height: size * .8, rx: 4, fill: LS_ROW[i] }, E);
+ const a = slot(E, `a${i}0`, x + 110, y, { letter: 'x', one: true });
+ const sign = T(E, '+', { x: x + 190, y, size, fill: COL.chalk, font: MATH, anchor: 'middle' });
+ const bb = slot(E, `a${i}1`, x + 262, y, { letter: 'y', one: true });
+ T(E, '=', { x: x + 330, y, size, fill: COL.chalk, font: MATH, anchor: 'middle' });
+ const c = slot(E, `b${i}`, x + 368, y, { anchor: 'start' });
+ eqRows.push({ bar, a, sign, bb, c });
+ });
+ // The second term shows its size; the sign between carries its sign.
+ eqRows.forEach((r, i) => {
+ const right = eq[0] + 262;
+ r.bb.set = () => {
+ setText(r.sign, v[`a${i}1`] < 0 ? '−' : '+');
+ setText(r.bb.t, fmt(Math.abs(v[`a${i}1`]), true));
+ const x = Math.min(eq[0] + 200, right - (r.bb.t.textContent ? r.bb.t.getComputedTextLength() : 0) - size * .55); // a wide coefficient pushes the sign left
+ if (st(r.sign).x !== x) put(r.sign, { x });
+ };
+ });
+ const sol = G(E, {});
+
+ /* ---------- the matrix form ---------- */
+ const Mx = G(p, { o: 0 });
+ if (mat) {
+ const [mx, my] = mat, cw = 92, rh = 74, ms = size * .85;
+ const bracket = (x, w, color = COL.chalk) => {
+ const top = my - ms * .95, bot = my + rh + ms * .35;
+ path(Mx, `M${x + 14} ${top}H${x}V${bot}H${x + 14}M${x + w - 14} ${top}H${x + w}V${bot}H${x + w - 14}`, { stroke: color, 'stroke-width': 3, fill: 'none' });
+ };
+ bracket(mx, cw * 2 + 20);
+ const msl = (key, x, y, fill) => { const s = slot(Mx, key, x, y, { anchor: 'middle', fill, w: 80 }); s.t.setAttribute('font-size', ms); return s; };
+ [0, 1].forEach(i => [0, 1].forEach(j => msl(`a${i}${j}`, mx + 10 + cw * (j + .5), my + rh * i, LS_COLS[j])));
+ bracket(mx + cw * 2 + 40, 70);
+ ['x', 'y'].forEach((n, i) => T(Mx, n, { x: mx + cw * 2 + 75, y: my + rh * i, size: ms, fill: COL.chalk, font: MATH, anchor: 'middle' }).setAttribute('font-style', 'italic'));
+ T(Mx, '=', { x: mx + cw * 2 + 150, y: my + rh / 2 + 10, size: ms, fill: COL.chalk, font: MATH, anchor: 'middle' });
+ bracket(mx + cw * 2 + 190, 100);
+ [0, 1].forEach(i => msl(`b${i}`, mx + cw * 2 + 240, my + rh * i, LS_B));
+ [['A', mx + cw + 10], ['x', mx + cw * 2 + 75], ['b', mx + cw * 2 + 240]].forEach(([n, x]) => {
+ const t = T(Mx, n, { x, y: my + rh + 78, size: 34, fill: COL.dim, font: MATH, anchor: 'middle', weight: n === 'x' ? 400 : 700 });
+ if (n === 'x') t.setAttribute('font-style', 'italic');
+ });
+ }
+
+ /* ---------- the plane: rows as lines, columns as arrows ---------- */
+ const ROWV = G(P2.g, { o: view === 'col' ? 0 : 1 }), COLV = G(P2.g, { o: view === 'row' || rows === 1 ? 0 : 1 });
+ if (rows === 1) COLV.style.display = 'none';
+ // The part of a·x + b·y = c inside the grid, as [x1, y1, x2, y2] in plane units, or null.
+ const clipLine = (a, b2, c) => {
+ const ps = [];
+ if (Math.abs(b2) > 1e-9) for (const X of bx) { const Y = (c - a * X) / b2; if (Y >= by[0] - 1e-9 && Y <= by[1] + 1e-9) ps.push([X, Y]); }
+ if (Math.abs(a) > 1e-9) for (const Y of by) { const X = (c - b2 * Y) / a; if (X >= bx[0] - 1e-9 && X <= bx[1] + 1e-9) ps.push([X, Y]); }
+ if (ps.length < 2) return null;
+ ps.sort((m, n) => m[0] - n[0] || m[1] - n[1]);
+ return [...ps[0], ...ps[ps.length - 1]];
+ };
+ const lines = RI.map(i => {
+ const hit = path(ROWV, '', { stroke: 'transparent', 'stroke-width': 30, fill: 'none' });
+ const l = path(ROWV, '', { stroke: LS_ROW[i], 'stroke-width': 5, fill: 'none', 'stroke-linecap': 'round' });
+ l.style.pointerEvents = 'none';
+ return { hit, l };
+ });
+ const meet = G(ROWV, { o: 0 });
+ mk('circle', { r: 11, fill: COL.chalk, stroke: COL.board, 'stroke-width': 3 }, meet);
+ const meetT = T(meet, '', { x: 18, y: -16, size: 30, fill: COL.chalk, font: MATH, weight: 600 });
+
+ const arrowD = (xa, ya, xb, yb) => {
+ const a = [PX(xa), PY(ya)], c = [PX(xb), PY(yb)], L = Math.hypot(c[0] - a[0], c[1] - a[1]);
+ if (L < 1) return '';
+ const ux = (c[0] - a[0]) / L, uy = (c[1] - a[1]) / L, hl = Math.min(18, L * .45);
+ return `M${a[0]} ${a[1]}L${c[0] - ux * hl * .6} ${c[1] - uy * hl * .6}M${c[0] - hl * ux - 9 * uy} ${c[1] - hl * uy + 9 * ux}L${c[0]} ${c[1]}L${c[0] - hl * ux + 9 * uy} ${c[1] - hl * uy - 9 * ux}Z`;
+ };
+ const arrow = (color, w = 5, dash) => path(COLV, '', { stroke: color, fill: color, 'stroke-width': w, 'stroke-linejoin': 'round', ...(dash ? { 'stroke-dasharray': dash, 'fill-opacity': .5 } : {}) });
+ const combo = [arrow(LS_COLS[0], 4, '10 8'), arrow(LS_COLS[1], 4, '10 8')]; // x·col1, then y·col2 from its tip
+ const cols = [arrow(LS_COLS[0]), arrow(LS_COLS[1])], bArrow = arrow(LS_B, 6);
+ const tips = [[LS_COLS[0], 'col0'], [LS_COLS[1], 'col1'], [LS_B, 'b']].map(([color, k]) => {
+ const g = G(COLV, {});
+ mk('circle', { r: 22, fill: 'transparent' }, g);
+ const ring = mk('circle', { r: 13, fill: 'none', stroke: color, 'stroke-width': 3, 'stroke-dasharray': '4 4' }, g);
+ ring.style.opacity = 0;
+ return { g, ring, k };
+ });
+ const tipLabels = [0, 1, 2].map(() => G(COLV, {}));
+
+ // Drag in the plane: a line slides to pass through the pointer (its right side changes);
+ // an arrow tip goes to the nearest grid point (a column of A, or b).
+ const dragIn = (el, onPoint) => {
+ let on = false;
+ el.addEventListener('pointerdown', e => { if (!live) return; e.preventDefault(); on = true; el.setPointerCapture(e.pointerId); onPoint(pt(e)); });
+ el.addEventListener('pointermove', e => { if (on) onPoint(pt(e)); });
+ el.addEventListener('pointerup', () => { on = false; });
+ el.addEventListener('lostpointercapture', () => { on = false; });
+ };
+ lines.forEach(({ hit }, i) => dragIn(hit, ([X, Y]) => edit({ [`b${i}`]: clamp(`b${i}`, Math.round(v[`a${i}0`] * X + v[`a${i}1`] * Y)) })));
+ const grid = (n, lo, hi) => Math.max(lo, Math.min(hi, Math.round(n)));
+ tips.forEach(({ g, k }) => dragIn(g, ([X, Y]) => {
+ const x = grid(X, bx[0], bx[1]), y = grid(Y, by[0], by[1]);
+ edit(k === 'b' ? { b0: x, b1: y } : k === 'col0' ? { a00: x, a10: y } : { a01: x, a11: y });
+ }));
+
+ /* ---------- one state, drawn everywhere ---------- */
+ const solve = () => {
+ if (rows === 1) return {};
+ const det = v.a00 * v.a11 - v.a01 * v.a10;
+ if (Math.abs(det) > 1e-9) return { x: (v.b0 * v.a11 - v.a01 * v.b1) / det, y: (v.a00 * v.b1 - v.b0 * v.a10) / det };
+ const same = Math.abs(v.a00 * v.b1 - v.b0 * v.a10) < 1e-9 && Math.abs(v.a01 * v.b1 - v.b0 * v.a11) < 1e-9;
+ return { none: !same, many: same };
+ };
+ const frac = n => { // exact when the numbers are whole: a fraction in lowest terms, else one decimal
+ const det = Math.round(v.a00 * v.a11 - v.a01 * v.a10), num = Math.round(n * det);
+ if (!Object.values(v).every(Number.isInteger) || !det) return [fmt(n)];
+ const g = gcd(Math.abs(num), Math.abs(det)) || 1, nn = num / g * Math.sign(det), dd = Math.abs(det) / g;
+ return dd === 1 ? [fmt(nn)] : [nn < 0 ? '−' : '', F(Math.abs(nn), dd)];
+ };
+ let solKey = '';
+ function draw() {
+ slots.forEach(s => s.set());
+ lines.forEach(({ hit, l }, i) => {
+ const c = clipLine(v[`a${i}0`], v[`a${i}1`], v[`b${i}`]), d = c ? `M${PX(c[0])} ${PY(c[1])}L${PX(c[2])} ${PY(c[3])}` : '';
+ if (l.getAttribute('d') !== d) { l.setAttribute('d', d); hit.setAttribute('d', d); }
+ });
+ const s = solve(), inGrid = s.x !== undefined && s.x >= bx[0] && s.x <= bx[1] && s.y >= by[0] && s.y <= by[1];
+ put(meet, { x: inGrid ? PX(s.x) : 0, y: inGrid ? PY(s.y) : 0, o: inGrid ? 1 : 0 });
+ if (inGrid) setText(meetT, `(${fmt(s.x)}, ${fmt(s.y)})`);
+ const c0 = [v.a00, v.a10], c1 = [v.a01, v.a11], bb = [v.b0, v.b1];
+ [[cols[0], c0], [cols[1], c1], [bArrow, bb]].forEach(([e, [x, y]], i) => {
+ e.setAttribute('d', arrowD(0, 0, x, y));
+ put(tips[i].g, { x: PX(x), y: PY(y) });
+ const n = Math.hypot(x, y) || 1;
+ put(tipLabels[i], { x: PX(x) + x / n * 30, y: PY(y) - y / n * 30 + 10 });
+ });
+ const reach = s.x !== undefined && Math.abs(s.x) <= 12 && Math.abs(s.y) <= 12;
+ combo[0].setAttribute('d', reach ? arrowD(0, 0, s.x * c0[0], s.x * c0[1]) : '');
+ combo[1].setAttribute('d', reach ? arrowD(s.x * c0[0], s.x * c0[1], bb[0], bb[1]) : '');
+ // The readout under the equations, rebuilt only when it changes.
+ const key = s.x !== undefined ? frac(s.x).join() + '|' + frac(s.y).join() : s.none ? 'none' : 'many';
+ if (readout && key !== solKey) {
+ solKey = key;
+ sol.replaceChildren();
+ const y = eq[1] + 92 + 104;
+ if (s.x !== undefined) M(sol, ['x = ', ...frac(s.x), ', y = ', ...frac(s.y)], { x: eq[0], y, size: 40, fill: COL.task, anchor: 'start' });
+ else T(sol, s.none ? 'parallel lines: no solution' : 'the same line: every point on it solves both', { x: eq[0], y: y - 4, size: 32, fill: COL.task, weight: 600 });
+ }
+ listeners.forEach(f => f(v, s));
+ }
+ function edit(to) {
+ let changed = false;
+ for (const k in to) if (v[k] !== to[k]) { v[k] = to[k]; changed = true; }
+ if (changed) draw();
+ }
+ draw();
+ show(E, t0 + .2); show(Mx, t0 + .4);
+
+ return {
+ v, P: P2, stage: holder, E, M: Mx, lines, cols, bArrow, combo, meet, ROWV, COLV, solve,
+ // Move the numbers to new values over dur seconds, on the beat clock (deterministic, so seeking replays it).
+ to(next, at, dur = 1.2, ease = io) {
+ const from = { ...plan };
+ plan = { ...plan, ...next };
+ const goal = { ...plan };
+ prog(q => edit(Object.fromEntries(Object.keys(goal).map(k => [k, from[k] + (goal[k] - from[k]) * q]))), at, dur, ease);
+ },
+ // Show the row picture, the column picture, or both.
+ view(which, at, dur = .6) {
+ tw(ROWV, { o: which === 'col' ? 0 : 1 }, at, dur);
+ tw(COLV, { o: which === 'row' ? 0 : 1 }, at, dur);
+ },
+ // Hands on: scrub numbers and drag in the plane. Turned off by sys.live(false) or by leaving the beat.
+ live(on) {
+ live = on;
+ for (const s of slots) {
+ s.box.style.cursor = on ? 'ew-resize' : '';
+ s.box.setAttribute('stroke', on ? COL.faint : 'none');
+ s.box.setAttribute('stroke-dasharray', '4 6');
+ if (on) s.box.setAttribute('tabindex', 0); else s.box.removeAttribute('tabindex');
+ }
+ lines.forEach(({ hit }) => { hit.style.cursor = on ? 'move' : ''; });
+ tips.forEach(({ g, ring }) => { g.style.cursor = on ? 'grab' : ''; ring.style.opacity = on ? 1 : 0; });
+ },
+ set: edit, // at once, for a reader's action or an answer shown
+ num: key => slots.filter(s => s.key === key).map(s => s.t), // every text that shows this value (to flash it)
+ eqRows,
+ onChange(f) { listeners.push(f); },
+ labels(names) { names.forEach((n, i) => { tipLabels[i].replaceChildren(); M(tipLabels[i], [n], { size: 30, fill: [LS_COLS[0], LS_COLS[1], LS_B][i] }); }); },
+ };
+}
+
+// A question that is a task on the system: the reader changes it until test(v, s) holds, then checks.
+const lsTask = (sys, test, why, hint, reveal) => (body, api) => {
+ sys.live(true);
+ return {
+ check: () => { const ok = test(sys.v, sys.solve()); api.grade(ok, ok ? why : hint); },
+ reveal: () => { reveal?.(); return why; },
+ lock: () => sys.live(false),
+ hint: [kbd('Tab'), 'pick a number', kbd('↑'), kbd('↓'), 'change it, or drag in the picture'],
+ };
+};
diff --git a/site/linear-algebra/lib/math.js b/site/linear-algebra/lib/math.js
new file mode 100644
index 0000000..19a26f5
--- /dev/null
+++ b/site/linear-algebra/lib/math.js
@@ -0,0 +1,698 @@
+// Papermorph maths helpers: number lines, tiles, fractions, planes, dice, the number map, sorter.
+// A maths chapter loads this right after engine.js; it uses the engine's globals as it loads.
+'use strict';
+// 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('→'), translate('hintMove'), kbd('Enter'), translate('hintChooseOrClickGrid')],
+ 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);
+}
+
+/* ---------- 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;
+}
+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)); }
+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 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(translate('stepsLeftOfZero', { n: -n }), X(n / 2), Y0 - 100, COL.int);
+}
+const FAMILIES = ['nat', 'whole', 'int', 'rat', 'irr', 'real'];
+const FAM_COLS = FAMILIES.map(k => [k, k === 'int' ? translate('integerColumn') : NAME[k], COL[k]]);
+const RING_KEYS = ['nat', 'whole', 'int', 'rat', 'irr', 'real']; // number keys 1–6 in sorting questions
+// 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.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.region ? translate('chipPlaced', { x: c.say, ring: NAME[c.region] }) : translate('chipNotPlaced', { x: c.say }));
+ 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);
+ });
+ // A cancelled drag (a system gesture, a lost capture) drops the chip where it is instead of leaving it stuck to no pointer.
+ c.addEventListener('lostpointercapture', () => {
+ if (!drag) return;
+ const moved = drag.moved;
+ drag = null;
+ if (moved) place(c, st(c).x, st(c).y);
+ });
+ 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', '', translate('notPlacedYet', { x: c.say }))); 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'
+ ? translate('realRingIsEmpty', { x: c.say })
+ : c.why));
+ }
+ const all = right === chips.length;
+ api.grade(all, all ? [] : [translate('ringsRight', { r: right, n: chips.length }), 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 translate('ringsShown');
+ },
+ lock() { locked = true; choose(null); },
+ hint: [kbd('←'), kbd('→'), translate('hintPickNumber'), kbd('1'), '–', kbd('6'), translate('hintPickRing')],
+ 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;
+ },
+ };
+};
diff --git a/site/linear-algebra/lib/space3.js b/site/linear-algebra/lib/space3.js
new file mode 100644
index 0000000..f5f0928
--- /dev/null
+++ b/site/linear-algebra/lib/space3.js
@@ -0,0 +1,479 @@
+// Space in three dimensions, drawn in SVG, and lin3: the 3 × 3 twin of linsys (equations, matrix form and space).
+// World axes: x to the right, y into the page (depth), z up; the floor is z = 0. The camera turns about the z axis (yaw)
+// and looks down at the floor (pitch); the projection is orthographic with a gentle perspective, so the near side of
+// the cube is a little larger and depth reads in motion. Everything re-projects when the camera moves: a beat turns it
+// on the beat clock (view.turn, view.drift), so seeking replays it; the reader orbits it by dragging empty space while
+// it is live (an ask), as an offset of its own that the beat clock never touches and a rebuilt beat starts without.
+// Loads after engine.js (and linsys.js, whose lsTask works on lin3 as it is).
+const S3_ROW = [COL.whole, COL.nat, COL.int], S3_COLS = [COL.irr, COL.real, COL.rat], S3_B = COL.task;
+const S3_DIST = 10; // camera distance in half-widths of the cube: larger is flatter
+
+const S3_det = m => m[0][0] * (m[1][1] * m[2][2] - m[1][2] * m[2][1]) - m[0][1] * (m[1][0] * m[2][2] - m[1][2] * m[2][0]) + m[0][2] * (m[1][0] * m[2][1] - m[1][1] * m[2][0]);
+const S3_cross = (a, b) => [a[1] * b[2] - a[2] * b[1], a[2] * b[0] - a[0] * b[2], a[0] * b[1] - a[1] * b[0]];
+const S3_dot = (a, b) => a[0] * b[0] + a[1] * b[1] + a[2] * b[2];
+// Rank of a matrix given as rows, by elimination.
+function S3_rank(rows) {
+ const m = rows.map(r => [...r]);
+ let rank = 0;
+ for (let c = 0; c < m[0].length && rank < m.length; c++) {
+ let piv = rank;
+ for (let r = rank + 1; r < m.length; r++) if (Math.abs(m[r][c]) > Math.abs(m[piv][c])) piv = r;
+ if (Math.abs(m[piv][c]) < 1e-9) continue;
+ [m[rank], m[piv]] = [m[piv], m[rank]];
+ for (let r = 0; r < m.length; r++) if (r !== rank) { const f = m[r][c] / m[rank][c]; m[r] = m[r].map((x, j) => x - f * m[rank][j]); }
+ rank++;
+ }
+ return rank;
+}
+// The part of a·x + b·y + c·z = d inside the cube ±R, as its corners in order around the edge, or null.
+function S3_cut(a, b, c, d, R) {
+ const n = [a, b, c];
+ if (Math.hypot(a, b, c) < 1e-9) return null;
+ const pts = [];
+ for (let i = 0; i < 3; i++) for (const s of [-R, R]) for (const t of [-R, R]) { // the 12 edges, axis i along each
+ const A = [0, 0, 0];
+ A[(i + 1) % 3] = s; A[(i + 2) % 3] = t;
+ const B = [...A];
+ A[i] = -R; B[i] = R;
+ const fa = S3_dot(n, A) - d, fb = S3_dot(n, B) - d;
+ if (fa * fb > 0 || fa === fb) continue;
+ const q = fa / (fa - fb), P = A.map((x, j) => x + (B[j] - x) * q);
+ if (!pts.some(o => Math.hypot(o[0] - P[0], o[1] - P[1], o[2] - P[2]) < 1e-6)) pts.push(P);
+ }
+ if (pts.length < 3) return null;
+ const m = [0, 1, 2].map(j => pts.reduce((s, p) => s + p[j], 0) / pts.length);
+ const ax = [0, 0, 0];
+ ax[[0, 1, 2].reduce((lo, j) => Math.abs(n[j]) < Math.abs(n[lo]) ? j : lo, 0)] = 1;
+ const u = S3_cross(n, ax), w = S3_cross(n, u), ang = p => { const r = p.map((x, j) => x - m[j]); return Math.atan2(S3_dot(w, r), S3_dot(u, r)); };
+ return pts.sort((p, q) => ang(p) - ang(q));
+}
+// The line where two planes [a, b, c, d] meet, clipped to the cube, as [from, to], or null.
+function S3_meet(P, Q, R) {
+ const u = S3_cross(P, Q);
+ if (Math.hypot(...u) < 1e-9) return null;
+ const M = [P.slice(0, 3), Q.slice(0, 3), u], r = [P[3], Q[3], 0], D = S3_det(M);
+ const o = [0, 1, 2].map(j => S3_det(M.map((row, i) => row.map((c, l) => l === j ? r[i] : c))) / D);
+ let lo = -Infinity, hi = Infinity;
+ for (let j = 0; j < 3; j++) {
+ if (Math.abs(u[j]) < 1e-12) { if (Math.abs(o[j]) > R) return null; continue; }
+ const t1 = (-R - o[j]) / u[j], t2 = (R - o[j]) / u[j];
+ lo = Math.max(lo, Math.min(t1, t2)); hi = Math.min(hi, Math.max(t1, t2));
+ }
+ return hi - lo > 1e-9 ? [o.map((x, j) => x + u[j] * lo), o.map((x, j) => x + u[j] * hi)] : null;
+}
+
+function space3(p, { cx = 1150, cy = 450, size = 640, range: R = 4, yaw = -30, pitch = 22, t0 = .1 } = {}) {
+ const g = G(p, { o: 0 }), svg = $('stage'), k = size / (3.4 * R), dist = S3_DIST * R;
+ const cam = { yaw, pitch }, user = { yaw: 0, pitch: 0 }, drifts = [], items = [], sorted = [], hooks = [];
+ let plan = { yaw, pitch }, live = false, queued = false, sortKey = '', ca = 1, sa = 0, cb = 1, sb = 0;
+ const PITCH = [-15, 80];
+
+ const proj = ([x, y, z]) => {
+ const xr = x * ca - y * sa, yr = x * sa + y * ca, up = z * cb + yr * sb, dep = yr * cb - z * sb, f = dist / (dist + dep);
+ return [cx + k * f * xr, cy - k * f * up, dep];
+ };
+ // The world point shown at (sx, sy) at depth dep: a point dragged in the plane facing the reader keeps its depth.
+ const unproj = (sx, sy, dep) => {
+ const f = dist / (dist + dep), xr = (sx - cx) / k / f, up = (cy - sy) / k / f, yr = up * sb + dep * cb, z = up * cb - dep * sb;
+ return [xr * ca + yr * sa, -xr * sa + yr * ca, z];
+ };
+ const n1 = n => Math.round(n * 10) / 10;
+ const D = pts => pts.map((q, i) => (i ? 'L' : 'M') + n1(q[0]) + ' ' + n1(q[1])).join('');
+ const att = (e, key, val) => { if (e.getAttribute(key) !== val) e.setAttribute(key, val); };
+ // An arrow in screen space; its head shrinks with the arrow, so a foreshortened arrow keeps its shape.
+ const arrowD = (a, c, w = 9) => {
+ const L = Math.hypot(c[0] - a[0], c[1] - a[1]);
+ if (L < 1) return '';
+ const ux = (c[0] - a[0]) / L, uy = (c[1] - a[1]) / L, hl = Math.min(18, L * .45), hw = w * Math.min(1, L / 40);
+ return `M${n1(a[0])} ${n1(a[1])}L${n1(c[0] - ux * hl * .6)} ${n1(c[1] - uy * hl * .6)}M${n1(c[0] - hl * ux - hw * uy)} ${n1(c[1] - hl * uy + hw * ux)}L${n1(c[0])} ${n1(c[1])}L${n1(c[0] - hl * ux + hw * uy)} ${n1(c[1] - hl * uy - hw * ux)}Z`;
+ };
+
+ // One redraw per frame however many tweens moved the camera or the data: queued, run before the browser paints.
+ function redraw() {
+ queued = false;
+ const a = (cam.yaw + drifts.reduce((s, d) => s + d, 0) + user.yaw) * Math.PI / 180;
+ const b = Math.max(PITCH[0], Math.min(PITCH[1], cam.pitch + user.pitch)) * Math.PI / 180;
+ ca = Math.cos(a); sa = Math.sin(a); cb = Math.cos(b); sb = Math.sin(b);
+ items.forEach(f => f());
+ hooks.forEach(f => f(proj));
+ // Painter's order for the polygons: far first. Each sits in a group of polygons only, so appending reorders them.
+ const order = sorted.filter(it => it.e.isConnected).sort((m, n) => n.dep - m.dep), key = order.map(it => it.id).join();
+ if (key !== sortKey) { sortKey = key; order.forEach(it => it.e.parentNode.appendChild(it.e)); }
+ }
+ const dirty = () => { if (!queued) { queued = true; queueMicrotask(redraw); } };
+
+ /* ---------- the frame: floor grid, cube, axes ---------- */
+ const orbit = mk('rect', { x: cx - size / 2 - 60, y: cy - 420, width: size + 120, height: 840, fill: 'transparent' }, g);
+ const frame = G(g), content = G(g), polys = G(content);
+ const floor = path(frame, '', { stroke: COL.chalk, 'stroke-opacity': .09, 'stroke-width': 1.5 });
+ const cube = path(frame, '', { stroke: COL.chalk, 'stroke-opacity': .16, 'stroke-width': 1.5 });
+ const C = [-R, R];
+ items.push(() => {
+ let d = '';
+ for (let i = -R; i <= R; i++) d += D([proj([i, -R, 0]), proj([i, R, 0])]) + D([proj([-R, i, 0]), proj([R, i, 0])]);
+ att(floor, 'd', d);
+ d = '';
+ for (const s of C) for (const t of C) d += D([proj([-R, s, t]), proj([R, s, t])]) + D([proj([s, -R, t]), proj([s, R, t])]) + D([proj([s, t, -R]), proj([s, t, R])]);
+ att(cube, 'd', d);
+ });
+ ['x', 'y', 'z'].forEach((name, i) => {
+ const at = s => { const q = [0, 0, 0]; q[i] = s; return proj(q); };
+ const line = path(frame, '', { stroke: COL.chalk, fill: COL.chalk, 'stroke-width': 3 });
+ const ticks = path(frame, '', { stroke: COL.dim, 'stroke-width': 2 });
+ const ints = [];
+ for (let j = -R; j <= R; j++) if (j) ints.push(j);
+ const shown = ints.filter(j => R < 4 || j % 2 === 0), nums = shown.map(j => T(frame, num(j), { size: 17, fill: COL.dim, font: MATH, anchor: 'middle' }));
+ const label = T(frame, name, { size: 32, fill: COL.chalk, font: MATH, anchor: 'middle' });
+ label.setAttribute('font-style', 'italic');
+ items.push(() => {
+ const A = at(-R), B = at(R + .7), L = Math.hypot(B[0] - A[0], B[1] - A[1]) || 1;
+ let nx = (A[1] - B[1]) / L, ny = (B[0] - A[0]) / L; // the side of the axis below it, or left of an upright one
+ if (ny - nx < 0) { nx = -nx; ny = -ny; }
+ att(line, 'd', arrowD(A, B));
+ att(ticks, 'd', ints.map(j => { const q = at(j); return D([[q[0] - nx * 6, q[1] - ny * 6], [q[0] + nx * 6, q[1] + ny * 6]]); }).join(''));
+ const o = L / (2 * R + .7) < 28 ? 0 : 1; // numbers on an axis that points at the reader would pile up
+ shown.forEach((j, n) => { const q = at(j); put(nums[n], { x: n1(q[0] + nx * 20), y: n1(q[1] + ny * 20 + 6), o }); });
+ const q = at(R + 1.1);
+ put(label, { x: n1(q[0]), y: n1(q[1] + 11) });
+ });
+ });
+
+ /* ---------- things in space: they re-project with the camera; set() moves them ---------- */
+ function point(pos, { color = COL.chalk, r = 10, label = '', size: ls = 28, into = content } = {}) {
+ const e = G(into, {});
+ mk('circle', { r, fill: color, stroke: COL.board, 'stroke-width': 3 }, e);
+ const t = T(e, label, { x: r + 8, y: -r - 6, size: ls, fill: color, font: MATH, weight: 600 });
+ const it = { e, pos, t, set(q) { it.pos = q; dirty(); }, label(s) { if (t.textContent !== s) t.textContent = s; } };
+ items.push(() => { const q = it.pos && proj(it.pos); put(e, q ? { x: n1(q[0]), y: n1(q[1]), o: 1 } : { o: 0 }); });
+ dirty();
+ return it;
+ }
+ function line(a, b, { color = COL.chalk, w = 3, dash, head = false, into = content } = {}) {
+ const e = path(into, '', { stroke: color, 'stroke-width': w, ...(head ? { fill: color } : {}), ...(dash ? { 'stroke-dasharray': dash, 'fill-opacity': .5 } : {}) });
+ const it = { e, a, b, set(a2, b2) { it.a = a2; it.b = b2; dirty(); } };
+ items.push(() => {
+ const A = it.a && proj(it.a), B = it.b && proj(it.b);
+ att(e, 'd', !A || !B ? '' : head ? arrowD(A, B, w + 5) : D([A, B]));
+ });
+ dirty();
+ return it;
+ }
+ let polyN = 0;
+ function poly(pts, { color = COL.chalk, fo = .14, w = 3, into = polys } = {}) {
+ const e = path(into, '', { stroke: color, fill: color, 'fill-opacity': fo, 'stroke-width': w });
+ e.style.pointerEvents = 'none';
+ const it = { e, pts, dep: 0, id: polyN++, set(q) { it.pts = q; dirty(); } };
+ items.push(() => {
+ const S = it.pts && it.pts.length > 2 ? it.pts.map(proj) : null;
+ att(e, 'd', S ? D(S) + 'Z' : '');
+ it.dep = S ? S.reduce((s, q) => s + q[2], 0) / S.length : 0;
+ });
+ sorted.push(it);
+ dirty();
+ return it;
+ }
+ // The plane a·x + b·y + c·z = d, as far as it lies inside the cube; hidden when a, b and c are all 0.
+ function plane(a, b, c, d, opts) {
+ const it = poly(null, opts);
+ it.set = (...q) => { it.coef = q; it.pts = S3_cut(...q, R); dirty(); };
+ it.set(a, b, c, d);
+ return it;
+ }
+
+ /* ---------- the camera ---------- */
+ // The reader turns the view by dragging empty space, only while it is live.
+ let drag = null;
+ orbit.addEventListener('pointerdown', e => {
+ if (!live) return;
+ e.preventDefault();
+ drag = { x: e.clientX, y: e.clientY, yaw: user.yaw, pitch: user.pitch, k: svg.getScreenCTM().a };
+ orbit.setPointerCapture(e.pointerId);
+ });
+ orbit.addEventListener('pointermove', e => {
+ if (!drag) return;
+ user.yaw = drag.yaw + (e.clientX - drag.x) / drag.k * .4;
+ user.pitch = Math.max(PITCH[0] - cam.pitch, Math.min(PITCH[1] - cam.pitch, drag.pitch + (e.clientY - drag.y) / drag.k * .4));
+ dirty();
+ });
+ const end = () => { drag = null; };
+ orbit.addEventListener('pointerup', end);
+ orbit.addEventListener('lostpointercapture', end);
+
+ dirty();
+ show(g, t0, .5);
+ return {
+ g, content, polys, k, R, proj, unproj, point, line, poly, plane,
+ arrow: (a, b, opts) => line(a, b, { w: 5, ...opts, head: true }),
+ seg: line,
+ redraw: dirty,
+ // f(proj) runs after every redraw: for chapter drawing that follows the camera (a label, a hit box).
+ on(f) { hooks.push(f); dirty(); },
+ // A pointer event in the view's own coordinates (the stage's, unless the panel moved).
+ local(e) { const q = svg.createSVGPoint(); q.x = e.clientX; q.y = e.clientY; const w = q.matrixTransform(g.getScreenCTM().inverse()); return [w.x, w.y]; },
+ // Turn the camera to { yaw, pitch } (degrees) over dur seconds on the beat clock, from where earlier turns left it.
+ turn(next, at, dur = 1.5, ease = soft) {
+ const from = { ...plan };
+ plan = { ...plan, ...next };
+ const goal = { ...plan };
+ prog(q => { cam.yaw = from.yaw + (goal.yaw - from.yaw) * q; cam.pitch = from.pitch + (goal.pitch - from.pitch) * q; dirty(); }, at, dur, ease);
+ },
+ // A slow turn about z, added to the turns: from `at` for dur seconds, or to the end of the beat without lengthening it.
+ drift(degPerSec, at = 0, dur) {
+ const i = drifts.push(0) - 1;
+ if (dur === undefined) clockRun(t => { drifts[i] = degPerSec * Math.max(0, t - at); dirty(); }, 0, { tail: true });
+ else prog(q => { drifts[i] = degPerSec * dur * q; dirty(); }, at, dur, lin);
+ },
+ live(on) { live = on; orbit.style.cursor = on ? 'grab' : ''; },
+ };
+}
+
+/* ---------- lin3: a 3 × 3 system, equations, matrix form and space from one state ---------- */
+// Every number on screen is the same value: scrub one (drag sideways, or focus it and press ↑/↓) and the planes, the
+// columns and the other copy follow; drag a plane by its edge (it slides along its normal: d changes) or an arrow tip
+// (it moves in the plane facing you, to the nearest lattice point) and the numbers follow.
+function lin3(p, { A = [[2, -1, 0], [-1, 2, -1], [0, -3, 4]], b = [0, -1, 4], eq = [90, 180], mat = [100, 490], size = 46, space: so = {}, view = 'row', sol: readout = true, t0 = .1 } = {}) {
+ const I = [0, 1, 2], v = {}, RANGE = {};
+ I.forEach(i => { I.forEach(j => { v[`a${i}${j}`] = A[i][j]; RANGE[`a${i}${j}`] = 9; }); v[`b${i}`] = b[i]; RANGE[`b${i}`] = 30; });
+ const V = space3(p, { t0, ...so }), R = V.R, svg = $('stage'), listeners = [], slots = [];
+ let live = false, plan = { ...v };
+
+ const fmt = (n, one = false) => {
+ const r = Math.round(n * 10) / 10, s = Number.isInteger(r) ? String(Math.abs(r)) : Math.abs(r).toFixed(1);
+ return (r < 0 ? '−' : '') + (one && Math.abs(r) === 1 ? '' : s);
+ };
+ const setText = (e, s) => { if (e.textContent !== s) e.textContent = s; };
+ const clamp = (key, n) => Math.max(-RANGE[key], Math.min(RANGE[key], n));
+ const col = j => [v[`a0${j}`], v[`a1${j}`], v[`a2${j}`]], bv = () => [v.b0, v.b1, v.b2];
+ const Am = () => I.map(i => I.map(j => v[`a${i}${j}`]));
+
+ /* ---------- numbers you can scrub (as in linsys) ---------- */
+ function slot(g, key, x, y, { anchor = 'end', letter = '', one = false, fill = COL.chalk, w = 80, fs = size } = {}) {
+ const box = mk('rect', { x: anchor === 'end' ? x - w : anchor === 'middle' ? x - w / 2 : x, y: y - fs * .85, width: w + (letter ? fs * .6 : 0), height: fs * 1.1, rx: 10, fill: 'transparent' }, g);
+ const t = T(g, '', { x, y, size: fs, fill, font: MATH, anchor });
+ const l = letter ? T(g, letter, { x: x + 3, y, size: fs, fill, font: MATH }) : null;
+ l?.setAttribute('font-style', 'italic');
+ t.style.pointerEvents = 'none'; // Firefox hit-tests the text over the box: the box must get the pointer
+ if (l) l.style.pointerEvents = 'none';
+ const s = { key, t, l, box, one, set: () => setText(t, fmt(v[key], one) || (one ? '' : '0')) };
+ box.setAttribute('aria-label', key);
+ let drag = null;
+ box.addEventListener('pointerdown', e => {
+ if (!live) return;
+ e.preventDefault();
+ drag = { x: e.clientX, from: Math.round(v[key]) };
+ box.setPointerCapture(e.pointerId);
+ });
+ box.addEventListener('pointermove', e => {
+ if (!drag) return;
+ const k = svg.getScreenCTM().a; // screen px per stage px
+ edit({ [key]: clamp(key, drag.from + Math.round((e.clientX - drag.x) / k / 22)) });
+ });
+ const end = () => { drag = null; };
+ box.addEventListener('pointerup', end);
+ box.addEventListener('lostpointercapture', end);
+ box.addEventListener('keydown', e => {
+ if (!live) return;
+ const d = { ArrowUp: 1, ArrowRight: 1, ArrowDown: -1, ArrowLeft: -1 }[e.key];
+ if (!d) return;
+ e.preventDefault(); e.stopPropagation(); // the player's ←/→ must not leave the beat
+ edit({ [key]: clamp(key, Math.round(v[key]) + d) });
+ });
+ slots.push(s);
+ return s;
+ }
+
+ /* ---------- the equations: a x + b y + c z = d ---------- */
+ const E = G(p, { o: 0 });
+ I.forEach(i => {
+ const y = eq[1] + i * 70, x = eq[0];
+ mk('rect', { x: x - 34, y: y - size * .7, width: 8, height: size * .8, rx: 4, fill: S3_ROW[i] }, E);
+ const terms = ['x', 'y', 'z'].map((n, j) => ({ s: slot(E, `a${i}${j}`, x + 92 + 135 * j, y, { letter: n, one: true }), sign: j ? T(E, '+', { x: x + 30 + 135 * j, y, size, fill: COL.chalk, font: MATH, anchor: 'middle' }) : null }));
+ T(E, '=', { x: x + 442, y, size, fill: COL.chalk, font: MATH, anchor: 'middle' });
+ slot(E, `b${i}`, x + 475, y, { anchor: 'start' });
+ // Later terms show their size and the sign before them carries their sign; a term that is 0 stays, faint.
+ terms.forEach(({ s, sign }, j) => {
+ const key = `a${i}${j}`;
+ s.set = () => {
+ const n = v[key], zero = Math.round(n * 10) === 0, o = zero ? '.35' : '';
+ if (sign) { setText(sign, n < 0 ? '−' : '+'); sign.style.opacity = o; }
+ setText(s.t, zero ? '0' : fmt(sign ? Math.abs(n) : n, true));
+ s.t.style.opacity = o; s.l.style.opacity = o;
+ };
+ });
+ });
+ const sol = G(E, {});
+
+ /* ---------- the matrix form ---------- */
+ const Mx = G(p, { o: 0 });
+ if (mat) {
+ const [mx, my] = mat, cw = 76, rh = 50, ms = Math.round(size * .85);
+ const bracket = (x, w) => {
+ const top = my - ms * .95, bot = my + 2 * rh + ms * .35;
+ path(Mx, `M${x + 14} ${top}H${x}V${bot}H${x + 14}M${x + w - 14} ${top}H${x + w}V${bot}H${x + w - 14}`, { stroke: COL.chalk, 'stroke-width': 3, fill: 'none' });
+ };
+ bracket(mx, cw * 3 + 20);
+ I.forEach(i => I.forEach(j => slot(Mx, `a${i}${j}`, mx + 10 + cw * (j + .5), my + rh * i, { anchor: 'middle', fill: S3_COLS[j], w: 66, fs: ms })));
+ const xv = mx + cw * 3 + 40;
+ bracket(xv, 64);
+ ['x', 'y', 'z'].forEach((n, i) => T(Mx, n, { x: xv + 32, y: my + rh * i, size: ms, fill: COL.chalk, font: MATH, anchor: 'middle' }).setAttribute('font-style', 'italic'));
+ T(Mx, '=', { x: xv + 110, y: my + rh + 12, size: ms, fill: COL.chalk, font: MATH, anchor: 'middle' });
+ bracket(xv + 150, 96);
+ I.forEach(i => slot(Mx, `b${i}`, xv + 198, my + rh * i, { anchor: 'middle', fill: S3_B, w: 80, fs: ms }));
+ [['A', mx + 10 + cw * 1.5], ['x', xv + 32], ['b', xv + 198]].forEach(([n, x]) => {
+ const t = T(Mx, n, { x, y: my + 2 * rh + 58, size: 28, fill: COL.dim, font: MATH, anchor: 'middle', weight: n === 'x' ? 400 : 700 });
+ if (n === 'x') t.setAttribute('font-style', 'italic');
+ });
+ }
+
+ /* ---------- the space: rows as planes, columns as arrows ---------- */
+ const ROWV = G(V.content, { o: view === 'col' ? 0 : 1 }), COLV = G(V.content, { o: view === 'row' ? 0 : 1 });
+ const usable = (g, on) => { g.style.pointerEvents = on ? '' : 'none'; };
+ usable(ROWV, view !== 'col'); usable(COLV, view !== 'row');
+ const planeG = G(ROWV, {});
+ const planes = I.map(i => V.plane(0, 0, 0, 0, { color: S3_ROW[i], into: planeG }));
+ const lines = I.map(() => V.seg(null, null, { color: COL.chalk, w: 2.5, dash: '7 7', into: ROWV }));
+ lines.forEach(l => l.e.setAttribute('stroke-opacity', .75));
+ const meet = V.point(null, { color: COL.chalk, r: 11, into: ROWV });
+ // A plane is dragged by its edge: a wide, invisible copy of its outline.
+ const hits = planes.map((pl, i) => {
+ const h = path(ROWV, '', { stroke: 'transparent', 'stroke-width': 26, fill: 'none' });
+ h.addEventListener('pointerenter', () => { if (live) pl.e.setAttribute('stroke-width', 6); });
+ h.addEventListener('pointerleave', () => pl.e.setAttribute('stroke-width', 3));
+ return h;
+ });
+
+ const combo = I.map(j => V.arrow(null, null, { color: S3_COLS[j], w: 4, dash: '10 8', into: COLV })); // x·col1, y·col2, z·col3 tip to tail
+ // b goes under the columns and wider: when b is a column (z = 1 and the rest 0) both still show
+ const bArrow = V.arrow(null, null, { color: S3_B, w: 9, into: COLV }), cols = I.map(j => V.arrow(null, null, { color: S3_COLS[j], into: COLV }));
+ const tipKeys = [0, 1, 2, 'b'], tipColor = [...S3_COLS, S3_B];
+ const tipOf = k => k === 'b' ? bv() : col(k);
+ const tips = tipKeys.map((k, n) => {
+ const g = G(COLV, {});
+ mk('circle', { r: 22, fill: 'transparent' }, g);
+ const ring = mk('circle', { r: 13, fill: 'none', stroke: tipColor[n], 'stroke-width': 3, 'stroke-dasharray': '4 4' }, g);
+ ring.style.opacity = 0;
+ return { g, ring, k };
+ });
+ const tipLabels = tipKeys.map((k, n) => T(COLV, '', { size: 28, fill: tipColor[n], font: MATH, weight: 600 }));
+ V.on(proj => {
+ planes.forEach((pl, i) => { const d = pl.e.getAttribute('d'); if (hits[i].getAttribute('d') !== d) hits[i].setAttribute('d', d); });
+ const O = proj([0, 0, 0]);
+ tips.forEach(({ g, k }, n) => {
+ const q = proj(tipOf(k)), L = Math.hypot(q[0] - O[0], q[1] - O[1]) || 1, ux = (q[0] - O[0]) / L, uy = (q[1] - O[1]) / L;
+ put(g, { x: Math.round(q[0] * 10) / 10, y: Math.round(q[1] * 10) / 10 });
+ // beside the tip, a column's on the arrow's right-hand side and b's on its left (b often lies along a column);
+ // past the tip is where a dashed mix often runs on
+ const side = k === 'b' ? -1 : 1, nx = -uy * side, ny = ux * side, t = tipLabels[n], anchor = nx > .35 ? 'start' : nx < -.35 ? 'end' : 'middle';
+ if (t.getAttribute('text-anchor') !== anchor) t.setAttribute('text-anchor', anchor);
+ put(t, { x: Math.round(q[0] + ux * 14 + nx * 20), y: Math.round(q[1] + uy * 14 + ny * 24 + 9) });
+ });
+ });
+
+ const dragIn = (el, onDown, onMove) => {
+ let on = null;
+ el.addEventListener('pointerdown', e => { if (!live) return; e.preventDefault(); e.stopPropagation(); on = onDown(V.local(e)); el.setPointerCapture(e.pointerId); });
+ el.addEventListener('pointermove', e => { if (on) onMove(on, V.local(e)); });
+ el.addEventListener('pointerup', () => { on = null; });
+ el.addEventListener('lostpointercapture', () => { on = null; });
+ };
+ // A plane slides along its normal n = (a, b, c): moving it by t·n raises d by t·|n|²; t comes from the pointer's
+ // motion along the normal as drawn on screen.
+ hits.forEach((h, i) => dragIn(h, at => {
+ const n = I.map(j => v[`a${i}${j}`]), c = planes[i].pts ? I.map(j => planes[i].pts.reduce((s, q) => s + q[j], 0) / planes[i].pts.length) : [0, 0, 0];
+ const P0 = V.proj(c), P1 = V.proj(c.map((x, j) => x + n[j]));
+ return { at, d0: v[`b${i}`], n2: S3_dot(n, n), ns: [P1[0] - P0[0], P1[1] - P0[1]] };
+ }, (s, [x, y]) => {
+ const t = ((x - s.at[0]) * s.ns[0] + (y - s.at[1]) * s.ns[1]) / Math.max(s.ns[0] ** 2 + s.ns[1] ** 2, 400);
+ edit({ [`b${i}`]: clamp(`b${i}`, Math.round(s.d0 + t * s.n2)) });
+ }));
+ const lattice = n => Math.max(-R, Math.min(R, Math.round(n))) || 0; // never −0
+ tips.forEach(({ g, k }) => dragIn(g, () => ({ dep: V.proj(tipOf(k))[2] }), (s, [x, y]) => {
+ const q = V.unproj(x, y, s.dep).map(lattice);
+ edit(k === 'b' ? { b0: q[0], b1: q[1], b2: q[2] } : { [`a0${k}`]: q[0], [`a1${k}`]: q[1], [`a2${k}`]: q[2] });
+ }));
+
+ /* ---------- one state, drawn everywhere ---------- */
+ const solve = () => {
+ const M = Am(), bb = bv(), det = S3_det(M);
+ if (Math.abs(det) > 1e-9) {
+ const [x, y, z] = I.map(j => S3_det(M.map((r, i) => r.map((c, l) => l === j ? bb[i] : c))) / det);
+ return { x, y, z };
+ }
+ const rA = S3_rank(M), rAb = S3_rank(M.map((r, i) => [...r, bb[i]]));
+ return rA < rAb ? { none: true } : { many: true, rank: rA };
+ };
+ const exact = n => { // a fraction in lowest terms when the numbers are whole, else one decimal
+ const det = Math.round(S3_det(Am())), num = Math.round(n * det);
+ if (!Object.values(v).every(Number.isInteger) || !det) return [fmt(n)];
+ const g = gcd(Math.abs(num), Math.abs(det)) || 1, nn = num / g * Math.sign(det), dd = Math.abs(det) / g;
+ return dd === 1 ? [fmt(nn)] : [nn < 0 ? '−' : '', F(Math.abs(nn), dd)];
+ };
+ const MANY = ['every point solves all three', 'infinitely many solutions: the three planes are one plane', 'infinitely many solutions: the planes share a line'];
+ let solKey = '';
+ function draw() {
+ slots.forEach(s => s.set());
+ const rows = I.map(i => [v[`a${i}0`], v[`a${i}1`], v[`a${i}2`], v[`b${i}`]]);
+ planes.forEach((pl, i) => pl.set(...rows[i]));
+ [[0, 1], [0, 2], [1, 2]].forEach(([i, j], n) => lines[n].set(...(S3_meet(rows[i], rows[j], R) || [null, null])));
+ const s = solve(), one = s.x !== undefined, X = one ? [s.x, s.y, s.z] : null;
+ const inCube = one && X.every(c => Math.abs(c) <= R + 1e-9);
+ meet.set(inCube ? X : null);
+ if (inCube) meet.label(`(${X.map(c => fmt(c)).join(', ')})`);
+ const O = [0, 0, 0], bb = bv();
+ I.forEach(j => cols[j].set(O, col(j)));
+ bArrow.set(O, bb);
+ const reach = one && X.every(c => Math.abs(c) <= 12);
+ let at = O;
+ I.forEach(j => { const nxt = j === 2 ? bb : at.map((c, l) => c + X?.[j] * col(j)[l]); combo[j].set(reach ? at : null, reach ? nxt : null); at = reach ? nxt : O; });
+ const key = one ? X.map(c => exact(c).join()).join('|') : s.none ? 'none' : 'many' + s.rank;
+ if (readout && key !== solKey) {
+ solKey = key;
+ sol.replaceChildren();
+ const y = eq[1] + 2 * 70 + 78;
+ if (one) M(sol, ['x = ', ...exact(s.x), ', y = ', ...exact(s.y), ', z = ', ...exact(s.z)], { x: eq[0], y, size: 38, fill: COL.task, anchor: 'start' });
+ else T(sol, s.none ? 'no solution: no point lies on all three planes' : MANY[s.rank], { x: eq[0], y: y - 4, size: 28, fill: COL.task, weight: 600 });
+ }
+ listeners.forEach(f => f(v, s));
+ }
+ function edit(to) {
+ let changed = false;
+ for (const key in to) if (v[key] !== to[key]) { v[key] = to[key]; changed = true; }
+ if (changed) draw();
+ }
+ draw();
+ show(E, t0 + .2); show(Mx, t0 + .4);
+
+ return {
+ v, space: V, E, M: Mx, planes, lines, meet, cols, bArrow, combo, ROWV, COLV, solve,
+ // Move the numbers to new values over dur seconds, on the beat clock (deterministic, so seeking replays it).
+ to(next, at, dur = 1.2, ease = io) {
+ const from = { ...plan };
+ plan = { ...plan, ...next };
+ const goal = { ...plan };
+ prog(q => edit(Object.fromEntries(Object.keys(goal).map(key => [key, from[key] + (goal[key] - from[key]) * q]))), at, dur, ease);
+ },
+ // Show the row picture, the column picture, or both; only what shows can be dragged.
+ view(which, at, dur = .6) {
+ tw(ROWV, { o: which === 'col' ? 0 : 1 }, at, dur);
+ tw(COLV, { o: which === 'row' ? 0 : 1 }, at, dur);
+ prog(() => { usable(ROWV, which !== 'col'); usable(COLV, which !== 'row'); }, at, 0, lin);
+ },
+ // Hands on: scrub numbers, drag planes and tips, orbit the space. Turned off by sys.live(false) or by leaving the beat.
+ live(on) {
+ live = on;
+ V.live(on);
+ for (const s of slots) {
+ s.box.style.cursor = on ? 'ew-resize' : '';
+ s.box.setAttribute('stroke', on ? COL.faint : 'none');
+ s.box.setAttribute('stroke-dasharray', '4 6');
+ if (on) s.box.setAttribute('tabindex', 0); else s.box.removeAttribute('tabindex');
+ }
+ hits.forEach(h => { h.style.cursor = on ? 'move' : ''; });
+ tips.forEach(({ g, ring }) => { g.style.cursor = on ? 'grab' : ''; ring.style.opacity = on ? 1 : 0; });
+ },
+ set: edit, // at once, for a reader's action or an answer shown
+ onChange(f) { listeners.push(f); },
+ // Names beside the arrow tips: col 1, col 2, col 3, b.
+ labels(names) { names.forEach((n, i) => { tipLabels[i].textContent = n; tipLabels[i].setAttribute('font-style', /^[a-z]$/.test(n) ? 'italic' : 'normal'); }); },
+ };
+}
diff --git a/site/linear-algebra/lib/units.css b/site/linear-algebra/lib/units.css
new file mode 100644
index 0000000..e9c62cb
--- /dev/null
+++ b/site/linear-algebra/lib/units.css
@@ -0,0 +1,79 @@
+/* The unit headers of a book's contents page, the same in every book: a strip of chalkboard per unit, with the unit's
+ label and title and a sketch of its ideas (UNIT_ART, from the book's own unit-art.js) drawn in the unit colour --c.
+ Markup and the scroll observer are in units.js. Uses the contents page's --book, --ui, --chalk and --ease. */
+.unit { position: relative; max-width: 1212px; margin: 0 auto; padding: 28px 16px 0; }
+.unit h2 { position: relative; display: flex; flex-wrap: wrap; align-items: baseline; gap: 4px 14px; min-height: 168px; margin: 0 0 16px; padding-top: 130px; font: 500 28px/1.2 var(--book); }
+.unit .grid { position: relative; }
+.unit::before { content: ""; position: absolute; inset: 0 16px auto; height: 208px; border-radius: 22px; pointer-events: none;
+ background: radial-gradient(ellipse 46% 90% at 74% 55%, color-mix(in srgb, var(--c) 11%, transparent), transparent 70%); }
+.unit-art { position: absolute; top: 20px; right: 28px; width: min(580px, 56%); height: auto; overflow: visible; pointer-events: none;
+ color: var(--c); fill: none; stroke: currentColor; stroke-width: 2.6; stroke-linecap: round; stroke-linejoin: round; opacity: .78; }
+.unit-art text { fill: currentColor; stroke: none; font-family: var(--book); font-style: italic; }
+.unit-art .a { color: var(--chalk); opacity: .55; }
+.unit-art .faint { opacity: .22; }
+.unit-art .d { stroke-dasharray: 1 1; stroke-dashoffset: 1; }
+.unit-art .t { opacity: 0; }
+.seen .unit-art .d { animation: art-draw 1.1s cubic-bezier(.5, 0, .3, 1) forwards; animation-delay: calc(var(--k) * 55ms + 120ms); }
+.seen .unit-art .t { animation: art-fade .6s ease-out forwards; animation-delay: calc(var(--k) * 55ms + 300ms); }
+.seen .unit-art .a.t { animation-name: art-fade-a; }
+@keyframes art-draw { to { stroke-dashoffset: 0; } }
+@keyframes art-fade { to { opacity: 1; } }
+@keyframes art-fade-a { to { opacity: .55; } }
+/* After the drawing, each sketch keeps one small motion that belongs to its topic. */
+.unit-art g { transform-box: fill-box; }
+.seen .unit-art .swap-a { animation: swap-a 6s var(--ease) 2.4s infinite; }
+.seen .unit-art .swap-b { animation: swap-b 6s var(--ease) 2.4s infinite; }
+@keyframes swap-a { 0%, 30%, 100% { transform: none; } 45%, 80% { transform: translate(80px, 0); } 37% { transform: translate(40px, -30px); } 88% { transform: translate(40px, 30px); } }
+@keyframes swap-b { 0%, 30%, 100% { transform: none; } 45%, 80% { transform: translate(-80px, 0); } 37% { transform: translate(-40px, 30px); } 88% { transform: translate(-40px, -30px); } }
+.seen .unit-art .step { animation: art-fade .6s ease-out forwards, step 4s ease-in-out infinite; animation-delay: calc(var(--k) * 55ms + 300ms), calc(var(--k) * 300ms + 2s); }
+@keyframes step { 0%, 20%, 100% { fill-opacity: 1; } 10% { fill-opacity: .3; } }
+.unit-art .hop, .unit-art .ride { offset-rotate: 0deg; }
+.seen .unit-art .hop { animation: art-fade .4s ease-out 2s forwards, along 3.4s linear 2s infinite; }
+.unit-art .orbit { offset-rotate: 0deg; }
+.seen .unit-art .orbit { animation: art-fade .4s ease-out 2s forwards, along 9s linear 2s infinite; }
+.seen .unit-art .ride { animation: art-fade .4s ease-out 2s forwards, along 4s ease-in-out 2s infinite alternate; }
+@keyframes along { from { offset-distance: 0%; } to { offset-distance: 100%; } }
+.unit-art .pie { stroke: currentColor; stroke-linecap: butt; stroke-dasharray: 0 100; }
+.seen .unit-art .pie { animation: art-fade .4s ease-out 1.6s forwards, pie 5s var(--ease) 1.6s infinite; }
+@keyframes pie { 0% { stroke-dasharray: 0 100; } 35%, 85% { stroke-dasharray: 25 100; } 100% { stroke-dasharray: 0 100; } }
+.seen .unit-art .tilt { transform-box: view-box; transform-origin: 300px 72px; animation: tilt 4.8s ease-in-out 2s infinite; }
+@keyframes tilt { 0%, 100% { transform: rotate(0); } 30% { transform: rotate(-4deg); } 60% { transform: rotate(2deg); } }
+.seen .unit-art .spin { transform-box: view-box; transform-origin: 320px 95px; animation: spin 5s cubic-bezier(.2, .7, .2, 1) 2s infinite; }
+@keyframes spin { from { transform: rotate(0); } 70%, to { transform: rotate(1530deg); } }
+.seen .unit-art .feed-in { animation: feed-in 4s ease-in-out 2s infinite; }
+.seen .unit-art .feed-out { opacity: 0; animation: feed-out 4s ease-in-out 2s infinite; }
+@keyframes feed-in { 0% { transform: none; opacity: 1; } 40% { transform: translate(100px, 0); opacity: 0; } 41%, 100% { transform: none; opacity: 0; } 95% { opacity: 1; } }
+@keyframes feed-out { 0%, 45% { transform: translate(-40px, 0); opacity: 0; } 70%, 90% { transform: none; opacity: 1; } 100% { opacity: 0; } }
+.unit-art .cell { opacity: .25; }
+.seen .unit-art .cell { animation: cell 5s ease-in-out infinite; animation-delay: calc(var(--j) * .5s + 2s); }
+@keyframes cell { 0%, 100% { opacity: .25; } 15%, 60% { opacity: 1; } }
+.unit-art .cut, .unit-art .shade { opacity: 0; }
+.seen .unit-art .cut { animation: cut 4s ease-in-out 2s infinite; }
+@keyframes cut { 0%, 100% { opacity: 0; } 30%, 70% { opacity: .5; } }
+.seen .unit-art .shade { animation: shade 1s ease-out 1.6s forwards; }
+@keyframes shade { to { opacity: .14; } }
+.seen .unit-art .diag { animation: art-draw 1.1s cubic-bezier(.5, 0, .3, 1) forwards, redraw 4s ease-in-out 2.5s infinite; }
+@keyframes redraw { 0%, 15% { stroke-dashoffset: 1; } 50%, 100% { stroke-dashoffset: 0; } }
+.seen .unit-art .root { animation: art-fade .4s ease-out 1.8s forwards, root 2.4s ease-in-out 2.2s infinite; }
+@keyframes root { 0%, 100% { r: 7px; } 50% { r: 11px; } }
+.seen .unit-art .breathe { transform-box: view-box; transform-origin: 380px 140px; animation: breathe 4s ease-in-out 2s infinite alternate; }
+@keyframes breathe { from { transform: scaleY(1); } to { transform: scaleY(.35); } }
+/* The label and the title share a line when they fit; a long title wraps below the label instead of running off. */
+.unit h2 .title { min-width: 0; text-wrap: balance; }
+.unit h2 .label { font: 600 14px var(--ui); letter-spacing: .14em; text-transform: uppercase; color: var(--c); white-space: nowrap; }
+/* Keep the sketches cheap: each is its own layer, so its loop repaints only itself, and loops pause while their unit is
+ off screen or under the sticky bar (units.js toggles .live), so the bar's blur is not redrawn every frame. */
+.unit-art { will-change: transform; contain: layout style; }
+.unit:not(.live) .unit-art, .unit:not(.live) .unit-art * { animation-play-state: paused; }
+@media (max-width: 560px) {
+ .unit-art { width: calc(100% - 32px); right: 16px; opacity: .32; }
+ .unit h2 { min-height: 0; padding-top: 104px; font-size: 24px; }
+}
+@media (prefers-reduced-motion: reduce) {
+ .unit-art * { animation: none !important; }
+ .unit-art .d { stroke-dashoffset: 0; }
+ .unit-art .t, .unit-art .cell { opacity: 1; }
+ .unit-art .a.t { opacity: .55; }
+ .unit-art .shade { opacity: .14; }
+ .unit-art .pie { stroke-dasharray: 25 100; }
+}
diff --git a/site/linear-algebra/lib/units.js b/site/linear-algebra/lib/units.js
new file mode 100644
index 0000000..e9e8c27
--- /dev/null
+++ b/site/linear-algebra/lib/units.js
@@ -0,0 +1,26 @@
+// The unit headers of a book's contents page, the same in every book; styled by units.css. The sketches come from
+// the book's own unit-art.js (window.UNIT_ART, one SVG body per unit, viewBox 0 0 600 180).
+// Units.header(u, label, title) the sketch and heading for unit u, as HTML to put first in its <section class="unit">
+// Units.watch() draw each sketch the first time its unit scrolls into view, and run its loop only
+// while the unit is on screen
+'use strict';
+(() => {
+ const esc = s => String(s).replace(/&/g, '&amp;').replace(/</g, '&lt;');
+ const header = (u, label, title) =>
+ `<svg class="unit-art" viewBox="0 0 600 180" aria-hidden="true">${window.UNIT_ART?.[u] || ''}</svg>` +
+ `<h2><span class="label">${esc(label)}</span><span class="title">${esc(title)}</span></h2>`;
+
+ function watch(root = document) {
+ const units = root.querySelectorAll('.unit');
+ if (!('IntersectionObserver' in window)) return units.forEach(u => u.classList.add('seen', 'live'));
+ // The first sight draws the sketch; leaving the screen (or sliding under the sticky bar) pauses it.
+ const first = new IntersectionObserver(es => es.forEach(e => {
+ if (e.isIntersecting) { e.target.classList.add('seen'); first.unobserve(e.target); }
+ }), { threshold: .25 });
+ const live = new IntersectionObserver(es => es.forEach(e => e.target.classList.toggle('live', e.isIntersecting)),
+ { rootMargin: '-64px 0px 0px 0px' });
+ units.forEach(u => { first.observe(u); live.observe(u); });
+ }
+
+ window.Units = { header, watch };
+})();
diff --git a/site/linear-algebra/lib/volume.css b/site/linear-algebra/lib/volume.css
new file mode 100644
index 0000000..106dd36
--- /dev/null
+++ b/site/linear-algebra/lib/volume.css
@@ -0,0 +1,24 @@
+/* Volume control for the player bar (volume.js); imported by engine.css. */
+.volume { display: flex; align-items: center; flex: none; width: 44px; height: 44px; overflow: hidden;
+ border: 1px solid var(--edge); border-radius: 999px; background: var(--panel); color: var(--chalk); transition: width .18s ease; }
+.volume .icon { width: 42px; height: 42px; border: 0; background: transparent; }
+.volume:hover, .volume:focus-within { width: 166px; gap: 10px; padding-right: 12px; }
+.volume:hover { background: var(--hover, #2b3f36); border-color: var(--faint); }
+.volume:has(:focus-visible) { outline: 2px solid var(--task); outline-offset: 3px; }
+.volume .icon:focus-visible { outline: none; }
+.volume input { appearance: none; flex: none; width: 0; height: 42px; margin: 0; opacity: 0; background: transparent; cursor: pointer; }
+.volume:hover input, .volume:focus-within input { width: 100px; opacity: 1; }
+.volume input:focus-visible { outline: none; }
+.volume input::-webkit-slider-runnable-track { height: 4px; border-radius: 999px;
+ background: linear-gradient(to right, var(--chalk) var(--volume, 100%), var(--faint) var(--volume, 100%)); }
+.volume input::-webkit-slider-thumb { appearance: none; width: 12px; height: 12px; margin-top: -4px; border: 0; border-radius: 50%; background: var(--chalk); }
+.volume input::-moz-range-track { height: 4px; border-radius: 999px; background: var(--faint); }
+.volume input::-moz-range-progress { height: 4px; border-radius: 999px; background: var(--chalk); }
+.volume input::-moz-range-thumb { width: 12px; height: 12px; border: 0; border-radius: 50%; background: var(--chalk); }
+@media (max-width: 700px) {
+ .volume { width: 36px; height: 40px; }
+ #bar .volume .icon { width: 34px; height: 38px; }
+ .volume:hover, .volume:focus-within { width: 158px; }
+ .volume input { height: 38px; }
+}
+@media (prefers-reduced-motion: reduce) { .volume { transition: none; } }
diff --git a/site/linear-algebra/lib/volume.js b/site/linear-algebra/lib/volume.js
new file mode 100644
index 0000000..4ea3a55
--- /dev/null
+++ b/site/linear-algebra/lib/volume.js
@@ -0,0 +1,23 @@
+/* Volume control for the player bar: a speaker button that opens a slider. engine.js loads this file and reads
+ #volume when it starts each beat's audio, so the control is the same in every book. */
+'use strict';
+{
+ document.getElementById('bHelp').insertAdjacentHTML('beforebegin', `<div class="volume">
+ <button class="icon" id="bVolume" aria-label="${translate('volumeLabel')}" aria-controls="volume" title="${translate('volumeTitle')}">
+ <svg viewBox="0 0 24 24" aria-hidden="true">
+ <path d="M3 9v6h4l5 4V5L7 9z" fill="currentColor"/>
+ <path d="M16 8a6 6 0 0 1 0 8m3-11a10 10 0 0 1 0 14" fill="none" stroke="currentColor" stroke-width="1.8" stroke-linecap="round"/>
+ </svg>
+ </button>
+ <input id="volume" type="range" min="0" max="1" step="0.05" value="1" aria-label="${translate('volumeSlider')}">
+ </div>`);
+ const input = document.getElementById('volume');
+ document.getElementById('bVolume').onclick = () => input.focus();
+ const apply = () => {
+ input.style.setProperty('--volume', +input.value * 100 + '%');
+ if (P.audio) P.audio.volume = +input.value;
+ };
+ // the volume carries over to the next chapter; a muted slider does not, so a new visit always has sound
+ try { const v = +localStorage.getItem('papermorph:volume'); if (v) { input.value = v; apply(); } } catch {}
+ input.oninput = () => { apply(); try { localStorage.setItem('papermorph:volume', input.value); } catch {} };
+}
diff --git a/site/linear-algebra/sandbox3/audio/en/timings.js b/site/linear-algebra/sandbox3/audio/en/timings.js
new file mode 100644
index 0000000..88c65b2
--- /dev/null
+++ b/site/linear-algebra/sandbox3/audio/en/timings.js
@@ -0,0 +1 @@
+window.TIMINGS = {};
diff --git a/site/linear-algebra/sandbox3/index.html b/site/linear-algebra/sandbox3/index.html
new file mode 100644
index 0000000..e3beb08
--- /dev/null
+++ b/site/linear-algebra/sandbox3/index.html
@@ -0,0 +1,84 @@
+<!doctype html>
+<html lang="en">
+<head>
+<meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<title>Sandbox: Space in 3D</title>
+<link rel="stylesheet" href="../lib/engine.css">
+<link rel="expect" href="#bar" blocking="render"><!-- hold the first frame until the player exists, so the page transition can run -->
+</head>
+<body>
+<script src="../lib/engine.js"></script>
+<script src="../lib/math.js"></script>
+<script src="../lib/linsys.js"></script>
+<script src="../lib/space3.js"></script>
+<script src="audio/en/timings.js"></script>
+<script>
+'use strict';
+// SANDBOX: silent beats to try space3.js and lin3 (the 3 × 3 system) before a chapter uses them.
+const CHAPTER = { number: 99, title: 'Sandbox: Space in 3D', minutes: 2, language: 'en' };
+const CARD = { x: 40, y: 668, w: 720, cls: 'side' };
+const title = (p, str, t0) => { const e = T(p, str, { x: 60, y: 110, size: 40, weight: 600, o: 0 }); show(e, t0); return e; };
+const sys3 = (p, view) => lin3(p, { view });
+const TARGET = (v, s) => s.x === 1 && s.y === 1 && s.z === 1;
+
+const BEATS = [
+ ['plane', 'One plane', (m, D) => {
+ const p = panel(0);
+ title(p, 'One equation in x, y, z is a plane', .1);
+ const V = space3(p);
+ const pl = V.plane(1, 1, 1, 3, { color: S3_ROW[0] });
+ V.drift(8);
+ const eqG = G(p, { o: 0 });
+ show(eqG, .4);
+ let shown = '';
+ const setD = d => {
+ pl.set(1, 1, 1, d);
+ const s = num(Math.round(d * 10) / 10);
+ if (s !== shown) { shown = s; eqG.replaceChildren(); M(eqG, ['x + y + z = ', s], { x: 90, y: 280, size: 56, fill: S3_ROW[0], anchor: 'start' }); }
+ };
+ setD(3);
+ prog(q => setD(3 - 5 * q), 3, 2.2); // the right side changes: the plane slides, its tilt stays
+ prog(q => setD(-2 + 5 * q), 6, 2);
+ }, { dur: 9 }],
+ ['rows', 'The row picture', (m, D) => {
+ const p = panel(0);
+ title(p, 'Three planes meet in a point', .1);
+ const sys = S.sys = sys3(p, 'row');
+ sys.space.turn({ yaw: 25, pitch: 30 }, 1.5, 3.5);
+ sys.space.drift(5, 5);
+ pulse(sys.meet.e, 5.5);
+ }, { dur: 9 }],
+ ['cols', 'The column picture', (m, D) => {
+ const p = panel(0);
+ title(p, 'Or: a mix of the columns', .1);
+ const sys = S.sys = sys3(p, 'col');
+ sys.labels(['col 1', 'col 2', 'col 3', 'b']);
+ sys.space.drift(6);
+ sys.to({ b0: 1, b1: 1, b2: 1 }, 4, 1.6); // a new b needs a new mix
+ }, { dur: 9 }],
+ ['try1', 'Your turn: planes', () => {
+ const p = panel(0);
+ title(p, 'Your turn', .1);
+ S.sys = sys3(p, 'row');
+ }, { dur: 1.5, ask: done => quiz(CARD, [{
+ id: 'p-meet', prompt: ['Make the three planes meet at ', $m('(1, 1, 1)'), ': drag a plane by its edge, or scrub a number.'],
+ build: lsTask(S.sys, TARGET, 'All three planes pass through (1, 1, 1): the right sides are 1, 0 and 1.',
+ 'Put x = 1, y = 1, z = 1 into each equation: that is the right side it needs.', () => S.sys.set({ b0: 1, b1: 0, b2: 1 })),
+ }], done) }],
+ ['try2', 'Your turn: columns', () => {
+ const p = panel(0);
+ title(p, 'Your turn', .1);
+ S.sys = sys3(p, 'col');
+ S.sys.labels(['col 1', 'col 2', 'col 3', 'b']);
+ }, { dur: 1.5, ask: done => quiz(CARD, [{
+ id: 'c-mix', prompt: ['Drag the tip of ', $m('b'), ' until the mix is ', $m('1·col 1 + 1·col 2 + 1·col 3'), '.'],
+ build: lsTask(S.sys, TARGET, 'col 1 + col 2 + col 3 = (1, 0, 1): b sits at the end of the three columns laid tip to tail.',
+ 'Add the three columns one after another: where do you end up?', () => S.sys.set({ b0: 1, b1: 0, b2: 1 })),
+ }], done) }],
+ ['finish', 'Finished', () => { panel(0); }, { dur: .5, ask: finishCard }],
+].map(([id, title, run, extra]) => ({ id, title, run, ...extra }));
+boot();
+</script>
+</body>
+</html>
diff --git a/site/linear-algebra/unit-art.js b/site/linear-algebra/unit-art.js
new file mode 100644
index 0000000..daaa2cb
--- /dev/null
+++ b/site/linear-algebra/unit-art.js
@@ -0,0 +1,23 @@
+// Chalk sketches for the unit headers on the contents page, one per unit, drawn in the unit's colour.
+// Each entry is the inside of an SVG with viewBox 0 0 600 180; keep the left ~200 px light (the unit title sits there
+// on narrow screens). Classes, styled in lib/units.css:
+// d a stroke that draws itself in when the unit scrolls into view (--k orders the strokes)
+// t text or a filled shape that fades in
+// a faint chalk white instead of the unit colour; faint even fainter
+// A sketch may add one looping motion after it is drawn: give an element a class that lib/units.css animates (swap-a,
+// hop, orbit, ride, spin, tilt, breathe, ...), or add your own .seen .unit-art .NAME rule and keyframes in a <style> in index.html.
+'use strict';
+(() => {
+ let k = 0;
+ const P = (d, cls = '', extra = '') => `<path class="d ${cls}" pathLength="1" style="--k:${k++}" d="${d}" ${extra}/>`;
+ const Tx = (x, y, s, size = 24, cls = '', anchor = 'start') => `<text class="t ${cls}" style="--k:${k++}" x="${x}" y="${y}" font-size="${size}" text-anchor="${anchor}">${s}</text>`;
+ const C = (cx, cy, r, cls = '') => `<circle class="d ${cls}" pathLength="1" style="--k:${k++}" cx="${cx}" cy="${cy}" r="${r}"/>`;
+ const reset = s => { k = 0; return s; };
+
+ window.UNIT_ART = [
+ // 1 An example: a number line with a dot hopping along it.
+ reset(P('M228 130H572') + Array.from({ length: 7 }, (_, i) => P(`M${250 + i * 50} 122v16`, 'a')).join('') +
+ `<circle class="t hop" r="8" fill="currentColor" stroke="none" style="--k:${k++};offset-path:path('M250 116Q275 84 300 116Q325 84 350 116Q375 84 400 116')"/>` +
+ Tx(250, 60, 'a sketch of this unit', 26) + C(530, 70, 24, 'a')),
+ ];
+})();