@maniclang/workbench 0.1.11

package/examples/textbook-tension.manic

@@ -0,0 +1,39 @@
+// ============================================================================
+//  textbook-tension.manic  —  a physics-textbook figure, manic style
+// ----------------------------------------------------------------------------
+//  Two support ropes at 60° / 30° meet at a knot; a string over a hanging pulley
+//  carries a 10 kg load on one side and anchors to the floor on the other. Drawn
+//  in the flat textbook look: `paper` theme, hatched `support` ceiling + floor,
+//  a green pulley wheel, and outlined labels. A STATIC figure, all base manic.
+// ============================================================================
+
+title("Tension in a rope over a pulley  (g = 10 m/s²)");
+canvas("16:9");
+template("paper");
+
+// hatched ceiling
+support(ceil, (cx, 110), 700);
+
+// the two support ropes meeting at the knot, with a dashed-style vertical ref
+line(t1, (553, 110), (cx, 260)); color(t1, fg); stroke(t1, 2);
+line(t2, (900, 110), (cx, 260)); color(t2, fg); stroke(t2, 2);
+line(vref, (cx, 110), (cx, 260)); color(vref, dim); stroke(vref, 1);
+
+text(a1, (588, 150), "60°"); color(a1, fg); size(a1, 22);
+text(a2, (852, 150), "30°"); color(a2, fg); size(a2, 22);
+text(t1l, (556, 210), "T₁"); color(t1l, fg); size(t1l, 24); bold(t1l);
+text(t2l, (820, 210), "T₂"); color(t2l, fg); size(t2l, 24); bold(t2l);
+
+// knot → hanging pulley
+line(drop, (cx, 260), (cx, 364)); color(drop, fg); stroke(drop, 2);
+circle(wheel, (cx, 430), 66); color(wheel, lime); outline(wheel, fg);
+circle(hub, (cx, 430), 5); color(hub, fg); filled(hub);
+
+// 10 kg load on the right side of the string
+line(ropeM, (706, 430), (706, 520)); color(ropeM, fg); stroke(ropeM, 2);
+rect(mbox, (706, 548), 84, 56); outlined(mbox); outline(mbox, fg); stroke(mbox, 2);
+text(ml, (792, 548), "10 Kg"); color(ml, fg); size(ml, 22); bold(ml);
+
+// the other side anchored to a hatched floor
+line(ropeF, (cx, 496), (cx, 600)); color(ropeF, fg); stroke(ropeF, 2);
+support(floor, (cx, 612), 150, "up");

package/examples/textbook-watermelon-sections.manic

@@ -0,0 +1,216 @@
+// ============================================================================
+// textbook-watermelon-sections.manic
+// Animated reconstruction of a textbook sketch: horizontal and vertical
+// sphere sections, then two perpendicular cuts producing 1/4 + 3/4.
+// ============================================================================
+
+title("Watermelon Sections — Slicing a Sphere");
+canvas("9:16");
+template("paper");
+watermark(manicMark,(220,175),"Made With Manic");
+creator(me,"@anish2good name=Manic_Geometry tagline=Textbooks_in_motion yt=zarigatongy x=@anish2good web=8gwifi.org/manic accent=cyan secondary=magenta footer=social safe=reels");
+socials(me);
+
+text(kicker,(540,164),"SECTIONS OF A SPHERE"); size(kicker,21); bold(kicker); color(kicker,cyan); hidden(kicker);
+text(headline,(540,228),"How a watermelon becomes ½, ¼, and ¾"); size(headline,36); bold(headline); hidden(headline);
+text(phase,(540,300),"THE TWO GREAT CIRCLES"); size(phase,23); bold(phase); color(phase,gold); hidden(phase);
+text(narration,(540,1328),"A central plane cuts a sphere in a great circle."); size(narration,26); bold(narration); wrap(narration,850); hidden(narration);
+text(principle,(540,1392),"Horizontal and vertical sections have the same radius."); size(principle,20); color(principle,dim); hidden(principle);
+equation(formula,(540,1488),`x^2+y^2+z^2=R^2`,43); hidden(formula);
+text(result,(540,1572),"ONE SPHERE · TWO PERPENDICULAR SECTION PLANES"); size(result,18); bold(result); color(result,gold); hidden(result);
+
+// Stable isometric framing in the portrait Creator media region.
+camera3((40.05,-39.35,23.41),(3.15,-2.45,-6.79),40);
+
+// Shared textbook guides: the horizontal ring lies in z=0 and the vertical
+// ring lies in y=0. Each chapter owns a duplicate so transitions stay simple.
+
+// --------------------------------------------------------------------------
+// Chapter 1 — horizontal cut, two hemispheres
+// --------------------------------------------------------------------------
+sphere3(hGuide,(0,0,0),3); color(hGuide,blue); hidden(hGuide); tag(hGuide,hScene);
+finish3(hGuide,"material=glass shading=smooth mesh=0.18 depth=0.28 shadow=0.12");
+curve3(hRing,"3*cos(t)","3*sin(t)","0",(0,6.2832)); color(hRing,cyan); thick(hRing,0.055); untraced(hRing); hidden(hRing); tag(hRing,hScene);
+curve3(hVerticalRing,"3*cos(t)","0","3*sin(t)",(0,6.2832)); color(hVerticalRing,dim); thick(hVerticalRing,0.035); untraced(hVerticalRing); hidden(hVerticalRing); tag(hVerticalRing,hScene);
+cube3(hPlane,(0,0,4.5),(7,7,0.08)); color(hPlane,cyan); hidden(hPlane); tag(hPlane,hScene);
+finish3(hPlane,"material=glass shading=flat mesh=0.08 depth=0.14 shadow=0.04");
+
+param3(hTopShell,
+  "3*sin(u)*cos(v)","3*sin(u)*sin(v)","3*cos(u)",
+  (0,1.5708),(0,6.2832),34);
+color(hTopShell,lime); hidden(hTopShell); tag(hTopShell,hTop); tag(hTopShell,hScene);
+finish3(hTopShell,"material=glass shading=smooth mesh=0.12 depth=0.24 shadow=0.10");
+param3(hBottomShell,
+  "3*sin(u)*cos(v)","3*sin(u)*sin(v)","3*cos(u)",
+  (1.5708,3.1416),(0,6.2832),34);
+color(hBottomShell,lime); hidden(hBottomShell); tag(hBottomShell,hBottom); tag(hBottomShell,hScene);
+finish3(hBottomShell,"material=glass shading=smooth mesh=0.12 depth=0.24 shadow=0.10");
+param3(hTopFace,"3*u*cos(v)","3*u*sin(v)","0",(0,1),(0,6.2832),30);
+color(hTopFace,magenta); hidden(hTopFace); tag(hTopFace,hTop); tag(hTopFace,hScene);
+finish3(hTopFace,"material=glass shading=flat mesh=0.30 depth=0.22 shadow=0.08");
+param3(hBottomFace,"3*u*cos(v)","3*u*sin(v)","0",(0,1),(0,6.2832),30);
+color(hBottomFace,magenta); hidden(hBottomFace); tag(hBottomFace,hBottom); tag(hBottomFace,hScene);
+finish3(hBottomFace,"material=glass shading=flat mesh=0.30 depth=0.22 shadow=0.08");
+
+// --------------------------------------------------------------------------
+// Chapter 2 — vertical cut, front and back hemispheres
+// --------------------------------------------------------------------------
+sphere3(vGuide,(0,0,0),3); color(vGuide,blue); hidden(vGuide); tag(vGuide,vScene);
+finish3(vGuide,"material=glass shading=smooth mesh=0.18 depth=0.28 shadow=0.12");
+curve3(vRing,"3*cos(t)","0","3*sin(t)",(0,6.2832)); color(vRing,lime); thick(vRing,0.055); untraced(vRing); hidden(vRing); tag(vRing,vScene);
+curve3(vHorizontalRing,"3*cos(t)","3*sin(t)","0",(0,6.2832)); color(vHorizontalRing,dim); thick(vHorizontalRing,0.035); untraced(vHorizontalRing); hidden(vHorizontalRing); tag(vHorizontalRing,vScene);
+cube3(vPlane,(0,-4.5,0),(7,0.08,7)); color(vPlane,lime); hidden(vPlane); tag(vPlane,vScene);
+finish3(vPlane,"material=glass shading=flat mesh=0.08 depth=0.14 shadow=0.04");
+
+param3(vFrontShell,
+  "3*sin(u)*cos(v)","3*sin(u)*sin(v)","3*cos(u)",
+  (0,3.1416),(3.1416,6.2832),34);
+color(vFrontShell,lime); hidden(vFrontShell); tag(vFrontShell,vFront); tag(vFrontShell,vScene);
+finish3(vFrontShell,"material=glass shading=smooth mesh=0.12 depth=0.24 shadow=0.10");
+param3(vBackShell,
+  "3*sin(u)*cos(v)","3*sin(u)*sin(v)","3*cos(u)",
+  (0,3.1416),(0,3.1416),34);
+color(vBackShell,lime); hidden(vBackShell); tag(vBackShell,vBack); tag(vBackShell,vScene);
+finish3(vBackShell,"material=glass shading=smooth mesh=0.12 depth=0.24 shadow=0.10");
+param3(vFrontFace,"3*u*cos(v)","0","3*u*sin(v)",(0,1),(0,6.2832),30);
+color(vFrontFace,cyan); hidden(vFrontFace); tag(vFrontFace,vFront); tag(vFrontFace,vScene);
+finish3(vFrontFace,"material=glass shading=flat mesh=0.30 depth=0.22 shadow=0.08");
+param3(vBackFace,"3*u*cos(v)","0","3*u*sin(v)",(0,1),(0,6.2832),30);
+color(vBackFace,cyan); hidden(vBackFace); tag(vBackFace,vBack); tag(vBackFace,vScene);
+finish3(vBackFace,"material=glass shading=flat mesh=0.30 depth=0.22 shadow=0.08");
+
+// --------------------------------------------------------------------------
+// Chapter 3 — perpendicular cuts, quarter removed and three quarters remain
+// --------------------------------------------------------------------------
+sphere3(qGuide,(0,0,0),3); color(qGuide,blue); hidden(qGuide); tag(qGuide,qScene);
+finish3(qGuide,"material=glass shading=smooth mesh=0.18 depth=0.28 shadow=0.12");
+curve3(qHRing,"3*cos(t)","3*sin(t)","0",(0,6.2832)); color(qHRing,cyan); thick(qHRing,0.045); untraced(qHRing); hidden(qHRing); tag(qHRing,qScene);
+curve3(qVRing,"3*cos(t)","0","3*sin(t)",(0,6.2832)); color(qVRing,lime); thick(qVRing,0.045); untraced(qVRing); hidden(qVRing); tag(qVRing,qScene);
+cube3(qHPlane,(0,0,4.5),(7,7,0.07)); color(qHPlane,cyan); hidden(qHPlane); tag(qHPlane,qScene);
+cube3(qVPlane,(0,-4.5,0),(7,0.07,7)); color(qVPlane,lime); hidden(qVPlane); tag(qVPlane,qScene);
+finish3(qHPlane,"material=glass shading=flat mesh=0.06 depth=0.12 shadow=0.03");
+finish3(qVPlane,"material=glass shading=flat mesh=0.06 depth=0.12 shadow=0.03");
+
+// Removed top-front quarter: one spherical patch plus two semicircular faces.
+param3(qShell,
+  "3*sin(u)*cos(v)","3*sin(u)*sin(v)","3*cos(u)",
+  (0,1.5708),(3.1416,6.2832),32);
+color(qShell,lime); hidden(qShell); tag(qShell,quarterPiece); tag(qShell,qScene);
+finish3(qShell,"material=glass shading=smooth mesh=0.14 depth=0.26 shadow=0.12");
+param3(qHFace,"3*u*cos(v)","3*u*sin(v)","0",(0,1),(3.1416,6.2832),28);
+color(qHFace,gold); hidden(qHFace); tag(qHFace,quarterPiece); tag(qHFace,qScene);
+finish3(qHFace,"material=glass shading=flat mesh=0.28 depth=0.22 shadow=0.08");
+param3(qVFace,"3*u*cos(v)","0","3*u*sin(v)",(0,1),(0,3.1416),28);
+color(qVFace,gold); hidden(qVFace); tag(qVFace,quarterPiece); tag(qVFace,qScene);
+finish3(qVFace,"material=glass shading=flat mesh=0.28 depth=0.22 shadow=0.08");
+
+// Remaining 3/4: top-back quarter plus the complete bottom hemisphere.
+param3(rTopBack,
+  "3*sin(u)*cos(v)","3*sin(u)*sin(v)","3*cos(u)",
+  (0,1.5708),(0,3.1416),32);
+color(rTopBack,lime); hidden(rTopBack); tag(rTopBack,remainder); tag(rTopBack,qScene);
+finish3(rTopBack,"material=glass shading=smooth mesh=0.14 depth=0.26 shadow=0.12");
+param3(rBottom,
+  "3*sin(u)*cos(v)","3*sin(u)*sin(v)","3*cos(u)",
+  (1.5708,3.1416),(0,6.2832),34);
+color(rBottom,lime); hidden(rBottom); tag(rBottom,remainder); tag(rBottom,qScene);
+finish3(rBottom,"material=glass shading=smooth mesh=0.14 depth=0.26 shadow=0.12");
+param3(rHFace,"3*u*cos(v)","3*u*sin(v)","0",(0,1),(3.1416,6.2832),28);
+color(rHFace,gold); hidden(rHFace); tag(rHFace,remainder); tag(rHFace,qScene);
+finish3(rHFace,"material=glass shading=flat mesh=0.28 depth=0.22 shadow=0.08");
+param3(rVFace,"3*u*cos(v)","0","3*u*sin(v)",(0,1),(0,3.1416),28);
+color(rVFace,gold); hidden(rVFace); tag(rVFace,remainder); tag(rVFace,qScene);
+finish3(rVFace,"material=glass shading=flat mesh=0.28 depth=0.22 shadow=0.08");
+
+step("read the two central sections") {
+  seq {
+    par { show(kicker,0.35); show(headline,0.55); show(phase,0.40); show(narration,0.45); show(principle,0.40); show(formula,0.55); show(result,0.45); }
+    to(hGuide,opacity,0.28,0.80,smooth);
+    par { show(hRing,0.25); draw(hRing,1.20,smooth); show(hVerticalRing,0.25); draw(hVerticalRing,1.20,smooth); }
+    par { pulse(hRing,0.70); pulse(hVerticalRing,0.70); roll3(3,1.30,smooth); }
+    wait(0.65);
+  }
+}
+
+step("horizontal cut makes two halves") {
+  seq {
+    par {
+      say(phase,"HORIZONTAL SECTION",0.45,smooth);
+      say(narration,"Slide a horizontal plane through the centre: z=0.",0.55,smooth);
+      say(principle,"The intersection is a horizontal great circle.",0.50,smooth);
+      rewrite(formula,`z=0\quad\Longrightarrow\quad x^2+y^2=R^2`,1.00,smooth);
+      say(result,"CUT → TWO ½-WATERMELONS",0.45,smooth);
+      show(hPlane,0.30);
+    }
+    par { shift3(hPlane,(0,0,-4.5),2.00,smooth); pulse(hRing,0.75); }
+    par {
+      fade(hGuide,0.55); fade(hPlane,0.45); fade(hRing,0.45); fade(hVerticalRing,0.45);
+      show(hTopShell,0.40); show(hBottomShell,0.40);
+      to(hTopFace,opacity,0.74,0.50,smooth); to(hBottomFace,opacity,0.74,0.50,smooth);
+    }
+    par { shift3(hTop,(-3.8,0,0.7),1.85,smooth); shift3(hBottom,(1.5,0,-0.2),1.85,smooth); }
+    par { pulse(hTopFace,0.80); pulse(hBottomFace,0.80); }
+    wait(0.75);
+  }
+}
+
+step("vertical cut makes two halves") {
+  seq {
+    par {
+      fade(hScene,0.65);
+      say(phase,"VERTICAL SECTION",0.45,smooth);
+      say(narration,"Turn the cutting plane upright and pass it through y=0.",0.55,smooth);
+      say(principle,"Its section is the same-size circle, seen vertically.",0.50,smooth);
+      rewrite(formula,`y=0\quad\Longrightarrow\quad x^2+z^2=R^2`,1.00,smooth);
+      say(result,"ANOTHER CUT → TWO ½-WATERMELONS",0.45,smooth);
+    }
+    par { to(vGuide,opacity,0.26,0.70,smooth); show(vHorizontalRing,0.25); draw(vHorizontalRing,0.90,smooth); show(vRing,0.25); draw(vRing,1.10,smooth); }
+    par { show(vPlane,0.30); shift3(vPlane,(0,4.5,0),2.00,smooth); pulse(vRing,0.75); }
+    par {
+      fade(vGuide,0.55); fade(vPlane,0.45); fade(vRing,0.45); fade(vHorizontalRing,0.45);
+      show(vFrontShell,0.40); show(vBackShell,0.40);
+      to(vFrontFace,opacity,0.74,0.50,smooth); to(vBackFace,opacity,0.74,0.50,smooth);
+    }
+    par { shift3(vFront,(-3.8,0,0.4),1.85,smooth); shift3(vBack,(1.5,0,-0.1),1.85,smooth); }
+    wait(0.75);
+  }
+}
+
+step("perpendicular cuts remove one quarter") {
+  seq {
+    par {
+      fade(vScene,0.65);
+      say(phase,"TWO PERPENDICULAR CUTS",0.45,smooth);
+      say(narration,"Now combine the horizontal and vertical central planes.",0.55,smooth);
+      say(principle,"Each cut halves one independent direction.",0.50,smooth);
+      rewrite(formula,`\frac12\times\frac12=\textcolor{gold}{\frac14}`,1.00,smooth);
+      say(result,"¼ CUT OUT · ¾ REMAINS",0.45,smooth);
+    }
+    par { to(qGuide,opacity,0.24,0.65,smooth); show(qHRing,0.25); draw(qHRing,0.90,smooth); show(qVRing,0.25); draw(qVRing,0.90,smooth); }
+    seq {
+      par { show(qHPlane,0.25); shift3(qHPlane,(0,0,-4.5),1.35,smooth); }
+      par { show(qVPlane,0.25); shift3(qVPlane,(0,4.5,0),1.35,smooth); }
+    }
+    par {
+      fade(qGuide,0.50); fade(qHPlane,0.40); fade(qVPlane,0.40); fade(qHRing,0.40); fade(qVRing,0.40);
+      show(qShell,0.35); to(qHFace,opacity,0.78,0.45,smooth); to(qVFace,opacity,0.78,0.45,smooth);
+      show(rTopBack,0.35); show(rBottom,0.35); to(rHFace,opacity,0.70,0.45,smooth); to(rVFace,opacity,0.70,0.45,smooth);
+    }
+    par { shift3(quarterPiece,(-3.8,0,0.8),1.90,smooth); shift3(remainder,(1.4,0,-0.15),1.90,smooth); }
+    wait(0.70);
+  }
+}
+
+step("compare the pieces") {
+  seq {
+    par {
+      say(phase,"FRACTIONS ARE GEOMETRY",0.50,smooth);
+      say(narration,"The removed corner is one quarter; the connected remainder is three quarters.",0.55,smooth);
+      say(principle,"Horizontal section · vertical section · quarter volume",0.55,smooth);
+      rewrite(formula,`1-\frac14=\textcolor{gold}{\frac34}`,1.00,smooth);
+      show(result,0.25); say(result,"¼ PIECE + ¾ WATERMELON = 1 WHOLE",0.50,smooth);
+    }
+    par { pulse(quarterPiece,0.90); pulse(remainder,0.90); roll3(3,1.50,smooth); }
+    wait(2.00);
+  }
+}

package/examples/thales-semicircle-short.manic

@@ -0,0 +1,53 @@
+// thales-semicircle-short — 9:16 quiz Short (~23s): the angle in a semicircle.
+// The vertex C slides along the arc during the think phase - the angle never
+// changes. Right-angle mark appears exactly at the reveal.
+title("Thales' Theorem in 20 Seconds");
+canvas("9:16");
+template("black");
+
+creator(me, "@anish2good name=Science_Lab yt=zarigatongy x=@anish2good web=8gwifi.org/manic footer=social accent=cyan");
+
+quiz(q, `AB is a diameter. What is $\angle ACB$?`, "layout=media-first");
+option(q, "60°");
+option(q, "90°", correct);
+option(q, "120°");
+option(q, "it depends on C");
+timing(q, "ask=4 options=4 think=8 reveal=3 hold=4");
+explain(q, "Any angle drawn from a diameter is a right angle - Thales' theorem, 2,600 years old.");
+
+// ---------- the figure (geo kit: exact by construction) ----------
+point(A, (cx - 190, 900), "A"); size(A.label, 34); hidden(A);
+point(B, (cx + 190, 900), "B"); size(B.label, 34); hidden(B);
+midpoint(O, A, B); label(O, "O"); size(O.label, 30); hidden(O);
+circle2(circ, O, A); outlined(circ); stroke(circ, 3); untraced(circ);
+point(C, (cx - 80, 728), "C"); size(C.label, 34); hidden(C);
+segment(dia, A, B); stroke(dia, 4); color(dia, gold); untraced(dia);
+segment(ca, C, A); stroke(ca, 4); color(ca, cyan); untraced(ca);
+segment(cb, C, B); stroke(cb, 4); color(cb, cyan); untraced(cb);
+rightangle(ra, A, C, B); color(ra, magenta); hidden(ra);
+
+socials(me);
+
+// ================= timeline =================
+par {
+  run(q);
+  seq {
+    // build the figure through the ask + options phases
+    wait(0.8);
+    par { show(A, 0.4); show(B, 0.4); }
+    draw(circ, 1.2);
+    draw(dia, 0.8);
+    show(O, 0.4);
+    show(C, 0.4);
+    par { draw(ca, 0.9); draw(cb, 0.9); }
+    // think phase: C wanders - the segments reflow, the angle holds
+    wait(2.0);
+    move(C, (cx + 122, 754), 1.6, smooth);
+    // land the right-angle mark exactly on the reveal (t = 16s)
+    wait(5.5);
+    show(ra, 0.4);
+    flash(ra, magenta);
+    cue(pop);
+  }
+}
+wait(0.5);

package/examples/three-d-v2-lab.manic

@@ -0,0 +1,83 @@
+canvas(1080, 1920);
+template("neon");
+title("3D relationships, not keyframes");
+creator(me, "@anish2good name=Manic yt=zarigatongy x=@anish2good web=8gwifi.org/manic footer=social safe=reels");
+socials(me);
+watermark(mark, (180, 88), "Made With Manic");
+
+camera3((8, -10, 7), (0, 0, 1), 42);
+grid3(floor, (0, 0, 0), 4, 1); color(floor, dim); opacity(floor, 0.28);
+
+text(kicker, (540, 174), "SPATIAL STORY"); size(kicker, 22); color(kicker, cyan);
+text(headline, (540, 242), "One point. Three relationships."); size(headline, 46);
+text(caption, (540, 1350), "Move the idea — the construction follows."); size(caption, 27); color(caption, dim);
+
+surface3(bowl, "0.16*(x^2+y^2)", (-3,3), (-3,3), 24);
+color(bowl, blue); opacity(bowl, 0.42);
+finish3(bowl, "shading=smooth mesh=0.18 depth=0.25 shadow=0.15");
+contour3(level, bowl, 0.7); color(level, gold); thick(level, 0.025);
+
+model3(beacon, "asset:models/manic-pyramid.obj", (-1.5, -0.4, 0.05), 0.8);
+color(beacon, magenta);
+finish3(beacon, "material=metal shading=flat mesh=0.20 depth=0.18 shadow=0.30");
+
+point3(probe, (0, 0, 0), 0.15); color(probe, lime);
+attach3(probe, beacon, (0, 0, 2.0), rigid);
+project3(shadow, probe, "xy"); color(shadow, cyan);
+link3(drop, probe, shadow, 0.12); color(drop, cyan); thick(drop, 0.018);
+
+text(probeLabel, (0,0), "live point"); size(probeLabel, 28); color(probeLabel, lime);
+label3(probeLabel, probe, 0.34);
+
+curve3(route, "3*cos(pi*t)", "2.4*sin(pi*t)", "0.8+1.4*t", (0,1));
+color(route, gold); untraced(route);
+curve3(spine, "-2.8+1.2*t", "-2.2", "0.15+1.8*t", (0,1)); hidden(spine);
+tube3(signal, spine, "0.025+0.075*t", 10); color(signal, gold); opacity(signal, 0.58);
+finish3(signal, "material=metal shading=smooth depth=0.20"); hidden(signal);
+
+tag(bowl, lab); tag(level, lab); tag(beacon, lab); tag(probe, lab);
+tag(shadow, lab); tag(drop, lab); tag(route, lab); tag(signal, lab);
+tag(spine, lab);
+
+step("frame the safe media area") {
+  par {
+    show(kicker, 0.35);
+    show(headline, 0.55);
+    show(caption, 0.45);
+    view3(lab, "isometric", 1.1, smooth, 1.55);
+  }
+  wait(0.5);
+}
+
+step("rigid attachment") {
+  par {
+    turn3(beacon, beacon, z, 110, 1.5, smooth);
+    orbit3(42, 28, 10.8, 1.5, smooth);
+  }
+  wait(0.35);
+}
+
+step("live projection") {
+  par {
+    shift3(beacon, (2.4, 0.8, 0.3), 1.5, smooth);
+    look3((0.4, 0.2, 1.1), 1.5, smooth);
+  }
+  wait(0.35);
+}
+
+step("transformed path travel") {
+  attach3(probe, none);
+  par {
+    draw(route, 2.2, smooth);
+    travel3(probe, route, 2.2, smooth);
+    rotate3(route, (0, 0, 24), 2.2, smooth);
+    show(signal, 0.55);
+  }
+  wait(0.7);
+}
+
+step("one bounded finish") {
+  flash(level, gold);
+  view3(lab, "fit", 1.0, smooth, 1.55);
+  wait(1.0);
+}

package/examples/three-d-v2-story.manic

@@ -0,0 +1,106 @@
+// three-d-v2-story.manic — a vertical creator story built on 3D V2
+
+title("From Signal to Satellite — A 3D Motion Story");
+canvas("9:16");
+template("shorts");
+watermark(manicMark, (164, 86), "Made With Manic");
+
+creator(me, "@anish2good name=Manic_3D tagline=Make_space_understandable yt=zarigatongy x=@anish2good web=8gwifi.org/manic accent=cyan secondary=magenta footer=social cta=Create_yours safe=reels");
+socials(me);
+
+text(kicker, (540, 164), "A 3D MOTION STORY");
+size(kicker, 22); bold(kicker); color(kicker, cyan); hidden(kicker);
+text(headline, (540, 226), "How a satellite finds its orbit");
+size(headline, 39); bold(headline); color(headline, fg); hidden(headline);
+text(chapter, (540, 300), "ACT 1 · BUILD ONE SYSTEM");
+size(chapter, 23); bold(chapter); color(chapter, gold); hidden(chapter);
+
+text(narration, (540, 1472), "Three parts. One mission.");
+size(narration, 30); bold(narration); color(narration, fg); hidden(narration);
+text(principle, (540, 1544), "Spatial motion stays readable when relationships survive the move.");
+size(principle, 22); color(principle, dim); wrap(principle, 820); hidden(principle);
+
+camera3((10, -14, 8), (0, 0, 1), 42);
+grid3(floor, (0, 0, 0), 7, 1); color(floor, dim); opacity(floor, 0.20);
+
+curve3(launchRoute, "-4 + 7*t", "-2 + 2.6*sin(pi*t)", "0.9 + 4.1*sin(pi*t)", (0, 1));
+color(launchRoute, cyan); thick(launchRoute, 0.045); untraced(launchRoute);
+
+cube3(core, (-4, -2, 0.9), (1.25, 0.95, 0.72)); color(core, gold); hidden(core);
+sphere3(lens, (-4, -2, 1.78), 0.34); color(lens, cyan); hidden(lens);
+cube3(panelA, (-4, -3.30, 0.9), (0.18, 2.1, 0.10)); color(panelA, magenta); hidden(panelA);
+cube3(panelB, (-4, -0.70, 0.9), (0.18, 2.1, 0.10)); color(panelB, magenta); hidden(panelB);
+
+tag(core, mission); tag(lens, mission); tag(panelA, mission); tag(panelB, mission);
+tag(panelA, solarArray); tag(panelB, solarArray);
+
+// The final observatory is only a blueprint. It never appears as a second object.
+sphere3(observatory, (3, -2, 1.05), 0.86); color(observatory, lime); hidden(observatory);
+
+text(lensLabel, (0, 0), "signal"); size(lensLabel, 21); color(lensLabel, cyan); hidden(lensLabel);
+pin3(lensLabel, lens);
+
+step("assemble") {
+  seq {
+    par {
+      show(kicker, 0.35);
+      show(headline, 0.50);
+      show(chapter, 0.35);
+      show(narration, 0.40);
+      show(principle, 0.40);
+      view3(mission, "isometric", 1.0, smooth, 1.55);
+    }
+    stagger(0.12) {
+      show(core, 0.35);
+      show(lens, 0.35);
+      show(panelA, 0.35);
+      show(panelB, 0.35);
+    }
+    attach3(lens, core, (0, 0, 0.88));
+    attach3(panelA, core, (0, -1.30, 0));
+    attach3(panelB, core, (0, 1.30, 0));
+    show(lensLabel, 0.30);
+    wait(0.45);
+  }
+}
+
+step("launch") {
+  seq {
+    par {
+      say(chapter, "ACT 2 · MOVE THE RELATIONSHIP", 0.45, smooth);
+      say(narration, "The craft travels. Every attached part remembers where it belongs.", 0.55, smooth);
+      view3(launchRoute, "fit", 1.1, smooth, 1.48);
+    }
+    par {
+      draw(launchRoute, 3.2, smooth);
+      travel3(core, launchRoute, 3.2, smooth);
+      say(principle, "attach3 carries context · travel3 carries identity", 0.55, smooth);
+    }
+    wait(0.45);
+  }
+}
+
+step("deploy") {
+  seq {
+    attach3(lens, none);
+    attach3(panelA, none);
+    attach3(panelB, none);
+    par {
+      say(chapter, "ACT 3 · DEPLOY THE IDEA", 0.45, smooth);
+      say(narration, "At orbit, only the changing parts move.", 0.50, smooth);
+      turn3(solarArray, core, z, 90, 1.25, smooth);
+      become3(core, observatory, 1.25, smooth);
+    }
+    par {
+      view3(mission, "isometric", 1.4, smooth, 1.58);
+      say(principle, "turn3 preserves the rig · become3 preserves the subject", 0.55, smooth);
+      fade(launchRoute, 0.65);
+    }
+    par {
+      view3(mission, "front", 2.2, smooth, 1.24);
+      pulse(lens, 0.75);
+      say(narration, "One persistent object. One continuous story.", 0.55, smooth);
+    }
+    wait(1.8);
+  }
+}

package/examples/three-d-v2.manic

@@ -0,0 +1,69 @@
+// three-d-v2.manic — the five creator-first spatial motion words
+
+title("3D V2 — Five Words for Spatial Stories");
+canvas("16:9");
+template("shorts");
+watermark(manicMark, (126, 64), "Made With Manic");
+
+creator(me, "@anish2good name=Manic_3D tagline=Spatial_stories yt=zarigatongy x=@anish2good web=8gwifi.org/manic accent=cyan secondary=magenta footer=social cta=Create_yours safe=clean");
+socials(me);
+
+camera3((10, -13, 8), (0, 0, 1), 42);
+grid3(floor, (0, 0, 0), 6, 1); color(floor, dim); opacity(floor, 0.24);
+
+// A route can be a line3, arrow3, or curve3.
+curve3(route, "-4 + 8*t", "-2 + 3*sin(pi*t)", "0.8 + 3.2*sin(pi*t)", (0, 1));
+color(route, cyan); thick(route, 0.035); untraced(route);
+
+cube3(ship, (-4, -2, 0.8), (1.4, 1.0, 0.65)); color(ship, gold);
+sphere3(sensor, (-4, -2, 1.65), 0.34); color(sensor, cyan);
+cube3(leftWing, (-4, -3.15, 0.8), (0.18, 1.8, 0.10)); color(leftWing, magenta);
+cube3(rightWing, (-4, -0.85, 0.8), (0.18, 1.8, 0.10)); color(rightWing, magenta);
+
+tag(ship, spacecraft); tag(sensor, spacecraft);
+tag(leftWing, spacecraft); tag(rightWing, spacecraft);
+tag(leftWing, wings); tag(rightWing, wings);
+
+// A hidden target is a blueprint. become3 keeps `ship` as the persistent id.
+sphere3(observatoryBlueprint, (4, -2, 0.95), 0.88);
+color(observatoryBlueprint, lime); hidden(observatoryBlueprint);
+
+text(caption, (640, 622), "FRAME · FOLLOW · TRAVEL · TRANSFORM · TURN");
+size(caption, 24); bold(caption); color(caption, fg); hidden(caption);
+
+step("frame-the-route") {
+  par {
+    view3(route, "fit", 1.0, smooth, 1.30);
+    show(caption, 0.45);
+  }
+}
+
+step("travel-as-one-system") {
+  attach3(sensor, ship, (0, 0, 0.85));
+  attach3(leftWing, ship, (0, -1.15, 0));
+  attach3(rightWing, ship, (0, 1.15, 0));
+  par {
+    draw(route, 2.8, smooth);
+    travel3(ship, route, 2.8, smooth);
+    say(caption, "attach3 + travel3", 0.55, smooth);
+  }
+}
+
+step("deploy-and-transform") {
+  seq {
+    attach3(sensor, none);
+    attach3(leftWing, none);
+    attach3(rightWing, none);
+    par {
+      turn3(wings, ship, z, 90, 1.1, smooth);
+      become3(ship, observatoryBlueprint, 1.1, smooth);
+      say(caption, "turn3 + become3", 0.55, smooth);
+    }
+    par {
+      view3(spacecraft, "isometric", 1.2, smooth, 1.35);
+      say(caption, "view3 settles the final composition", 0.55, smooth);
+      fade(route, 0.65);
+    }
+    wait(1.2);
+  }
+}

package/examples/three_d.manic

@@ -0,0 +1,39 @@
+title("3D coordinate space");
+canvas(1280, 720);
+template("terminal");
+
+camera3((8, -10, 6), (0, 0, 1), 45);
+grid3(floor, (0, 0, 0), 5, 1);
+color(floor, dim);
+axes3(world, (0, 0, 0), 4);
+
+cube3(box, (0, 0, 1), (2, 2, 2));
+color(box, magenta);
+sphere3(ball, (-2, 1, 1), 0.7);
+color(ball, lime);
+arrow3(vector, (0, 0, 0), (2.5, 2, 3));
+
+// a parametric helix (curve3), drawn on as a shaded tube
+curve3(spiral, "cos(t)*2.6", "sin(t)*2.6", "t*0.32", (0, 12));
+color(spiral, gold);
+thick(spiral, 0.08);
+
+// a height-field surface z = f(x,y) (surface3), filled + flat-shaded
+surface3(wave, "0.6*sin(x)*cos(y)", (-3.5, 3.5), (-3.5, 3.5), 24);
+color(wave, magenta);
+opacity(wave, 0.5);
+
+// filled, flat-shaded solids (prism3 / pyramid3)
+prism3(hex, (-3.6, -2.4, 1.2), 6, 0.9, 2.2);
+pyramid3(cone, (3.6, -2.4, 1.4), 22, 1.0, 2.6);
+
+// a 2D label glued to the moving sphere — tracks it as the camera orbits
+text(balltag, (0, 0), "ball");
+color(balltag, gold);
+pin3(balltag, ball);
+
+par {
+    rotate3(box, (0, 0, 360), 4, linear);
+    orbit3(70, 28, 11, 4, smooth);
+    move3(ball, (2, -1, 2), 4, inout);
+}

package/examples/timing-v2-scene.manic

@@ -0,0 +1,47 @@
+// Generic Timing v2 — one named clock coordinates a non-quiz physics scene.
+// `timed` runs the visual timer and places every `during` block at the exact
+// offset declared by `timing`; short blocks are padded, overruns are errors.
+title("Generic Timing v2 — Pendulum");
+canvas("16:9");
+template("mono");
+watermark(manicMark, (w*0.955-100, h*0.045+24), "Made With Manic");
+
+text(head, (315, 72), "ONE CLOCK. EVERY BEAT.");
+size(head, 30); bold(head); color(head, fg); hidden(head);
+text(sub, (315, 112), "Generic Timing v2 — not a quiz");
+size(sub, 18); color(sub, dim); hidden(sub);
+
+pendulum(p, (640, 245), 1.5, 42, 140, 0.03);
+untraced(p.path);
+
+equation(law, (640, 602), `T\approx2\pi\sqrt{L/g}`, 54);
+color(law, gold); hidden(law);
+text(note, (640, 655), "The scene and clock share the same named phases.");
+size(note, 21); color(note, dim); hidden(note);
+text(done, (640, 680), "INTRO  →  EXPERIMENT  →  INSIGHT  →  OUTRO");
+size(done, 18); color(done, cyan); hidden(done);
+
+// A fresh id creates a format-neutral timing controller. Its phases total
+// 10.4 seconds; no duplicate duration is passed to `timed` or `run`.
+timing(showclock, (970, 86), "intro=1.2 experiment=6 insight=2 outro=1.2");
+timerstyle(showclock,
+           "look=segments number=outside direction=drain size=small thickness=1.15 color=cyan track=dim label=MASTER_CLOCK font=display finish=pulse");
+
+timed(showclock) {
+  during("intro") {
+    par { show(head, 0.7); show(sub, 0.7); }
+  }
+
+  during("experiment") {
+    par { run(p, 6); draw(p.path, 6); }
+  }
+
+  during("insight") {
+    par { show(law, 0.6); show(note, 0.6); }
+    pulse(p.bob, 0.7);
+  }
+
+  during("outro") {
+    show(done, 0.6);
+  }
+}