@maniclang/workbench 0.1.11

package/examples/test.manic

@@ -0,0 +1,61 @@
+title("Why Thanos Feels Powerful");
+canvas("9:16");
+template("shorts");
+
+creator(brand,"name=Endgame_Feat_Breakdown footer=none safe=shorts accent=violet secondary=gold");
+
+text(head,(cx,110),"Why Thanos feels unstoppable"); size(head,58); color(head,fg); hidden(head);
+text(sub,(cx,175),"Endgame battle-feat breakdown"); size(sub,30); color(sub,dim); hidden(sub);
+
+equation(thesis,(cx,315),`\textcolor{violet}{\mathrm{POWER}} \approx \textcolor{gold}{\mathrm{STRENGTH}} + \textcolor{cyan}{\mathrm{DURABILITY}} + \textcolor{lime}{\mathrm{CONTROL}}`,52);
+hidden(thesis);
+
+line(rule,(cx-300,380),(cx+300,380)); color(rule,dim); hidden(rule);
+
+text(cap,(cx,h-120),""); size(cap,30); color(cap,dim); sticky(cap); hidden(cap);
+
+rect(r1,(cx,540),920,150); outlined(r1); color(r1,violet); hidden(r1);
+rect(bar1,(170,540),12,112); color(bar1,violet); hidden(bar1);
+text(n1,(245,520),"01"); size(n1,42); color(n1,violet); hidden(n1);
+text(d1,(320,515),"RAW STRENGTH\nHe wins the shove and the clinch."); size(d1,33); color(d1,fg); hidden(d1);
+tag(r1,feat1); tag(bar1,feat1); tag(n1,feat1); tag(d1,feat1);
+
+rect(r2,(cx,740),920,150); outlined(r2); color(r2,gold); hidden(r2);
+rect(bar2,(170,740),12,112); color(bar2,gold); hidden(bar2);
+text(n2,(245,720),"02"); size(n2,42); color(n2,gold); hidden(n2);
+text(d2,(320,715),"DURABILITY\nHe keeps fighting after heavy hits."); size(d2,33); color(d2,fg); hidden(d2);
+tag(r2,feat2); tag(bar2,feat2); tag(n2,feat2); tag(d2,feat2);
+
+rect(r3,(cx,940),920,150); outlined(r3); color(r3,cyan); hidden(r3);
+rect(bar3,(170,940),12,112); color(bar3,cyan); hidden(bar3);
+text(n3,(245,920),"03"); size(n3,42); color(n3,cyan); hidden(n3);
+text(d3,(320,915),"CONTROL\nWeapon skill, timing, and battlefield pressure."); size(d3,33); color(d3,fg); hidden(d3);
+tag(r3,feat3); tag(bar3,feat3); tag(n3,feat3); tag(d3,feat3);
+
+rect(endbox,(cx,1160),920,138); outlined(endbox); color(endbox,fg); hidden(endbox);
+text(endtxt,(cx,1140),"THAT COMBO IS WHY HE FEELS SO DANGEROUS"); size(endtxt,30); color(endtxt,fg); hidden(endtxt);
+text(endsub,(cx,1190),"Not one power — a stack of advantages."); size(endsub,28); color(endsub,dim); hidden(endsub);
+tag(endbox,final); tag(endtxt,final); tag(endsub,final);
+
+show(head,0.45);
+show(sub,0.35);
+show(thesis,0.55);
+show(rule,0.25);
+show(cap,0.2);
+say(cap,"He looks unstoppable because the whole fight stacks in his favor.");
+wait(0.25);
+
+show(feat1,0.45);
+say(cap,"First: raw strength. He can overpower the push.");
+wait(0.2);
+
+show(feat2,0.45);
+say(cap,"Second: durability. He absorbs punishment and keeps moving.");
+wait(0.2);
+
+show(feat3,0.45);
+say(cap,"Third: control. He uses weapons, timing, and space.");
+wait(0.2);
+
+show(final,0.5);
+say(cap,"That is why the Endgame battle feels so overwhelming.");

package/examples/text-guide.manic

@@ -0,0 +1,304 @@
+// How text works — a guide you can watch
+//
+// Text is the one primitive every scene uses, and the one with the most behaviour hiding behind it.
+// This is that behaviour, demonstrated: what a bare `text` does, what happens to a line too long for
+// where it sits, how to pin an edge, how to set line height, the two different ways to run text
+// downwards, and why `caption` exists beside `text` at all.
+//
+// Each section shows the call and the result side by side, so the guide is also its own worked
+// example — read the source next to the frame it produces.
+
+title("how text works");
+canvas("16:9");
+template("black");
+
+text(brand, (640, 26), "maniclang.com");
+display(brand);
+size(brand, 15);
+color(brand, dim);
+
+text(head, (640, 74), "How text works");
+size(head, 34);
+bold(head);
+color(head, fg);
+
+// ── 1 · the default ──
+
+text(s1, (640, 150), "1 · a bare label is one line, centred on its point");
+size(s1, 20);
+color(s1, gold);
+hidden(s1);
+
+text(c1, (640, 200), "text(hello, (640, 300), \"one line\", 30)");
+size(c1, 19);
+color(c1, dim);
+hidden(c1);
+
+text(hello, (640, 300), "one line");
+size(hello, 30);
+color(hello, fg);
+hidden(hello);
+
+dot(anchor1, (640, 300), 4);
+color(anchor1, coral);
+hidden(anchor1);
+
+// ── 2 · too long for its room ──
+
+text(s2, (640, 150), "2 · a line too long for its room wraps — it is never clipped");
+size(s2, 20);
+color(s2, gold);
+hidden(s2);
+
+text(c2, (640, 200), "no wrap set: the renderer uses the room the point actually has");
+size(c2, 19);
+color(c2, dim);
+hidden(c2);
+
+text(longone, (400, 320), "This label sits left of centre, so it can only use twice its distance to the near edge — and that is exactly what it wraps to.");
+size(longone, 21);
+color(longone, cyan);
+hidden(longone);
+
+rect(room, (400, 320), 760, 130);
+outlined(room);
+outline(room, dim);
+stroke(room, 1);
+hidden(room);
+
+text(c2b, (640, 470), "wrap(id, 300) chooses a narrower column than the frame allows");
+size(c2b, 19);
+color(c2b, dim);
+hidden(c2b);
+
+text(narrow, (980, 340), "A column you chose yourself, three hundred pixels wide.");
+size(narrow, 19);
+color(narrow, magenta);
+wrap(narrow, 300);
+hidden(narrow);
+
+// ── 3 · which edge is pinned ──
+
+text(s3, (640, 150), "3 · align pins an edge to the point");
+size(s3, 20);
+color(s3, gold);
+hidden(s3);
+
+line(rule3, (640, 230), (640, 560));
+color(rule3, dim);
+stroke(rule3, 1);
+untraced(rule3);
+
+text(al, (640, 270), "align(id, left)\nboth lines start here");
+size(al, 21);
+color(al, cyan);
+align(al, left);
+hidden(al);
+
+text(ac, (640, 390), "align(id, center)\nthe default");
+size(ac, 21);
+color(ac, fg);
+hidden(ac);
+
+text(ar, (640, 510), "align(id, right)\nboth lines end here");
+size(ar, 21);
+color(ar, coral);
+align(ar, right);
+hidden(ar);
+
+// ── 4 · line height ──
+
+text(s4, (640, 150), "4 · leading is line height, as a multiple of the size");
+size(s4, 20);
+color(s4, gold);
+hidden(s4);
+
+text(l1, (300, 380), "leading\n1.0\ntight");
+size(l1, 22);
+color(l1, cyan);
+leading(l1, 1.0);
+hidden(l1);
+
+text(l2, (640, 380), "default\n1.4\nprose");
+size(l2, 22);
+color(l2, fg);
+hidden(l2);
+
+text(l3, (980, 380), "leading\n2.2\nairy");
+size(l3, 22);
+color(l3, magenta);
+leading(l3, 2.2);
+hidden(l3);
+
+// ── 5 · downwards, two different ways ──
+
+text(s5, (640, 150), "5 · downwards: rotate the line, or stack the letters");
+size(s5, 20);
+color(s5, gold);
+hidden(s5);
+
+text(c5a, (300, 250), "rot(id, -90)");
+size(c5a, 19);
+color(c5a, dim);
+hidden(c5a);
+
+text(rotated, (300, 420), "ROTATED", 34);
+color(rotated, cyan);
+rot(rotated, -90);
+hidden(rotated);
+
+text(c5b, (640, 250), "rot(id, 90)");
+size(c5b, 19);
+color(c5b, dim);
+hidden(c5b);
+
+text(rotated2, (640, 420), "ROTATED", 34);
+color(rotated2, teal);
+rot(rotated2, 90);
+hidden(rotated2);
+
+text(c5c, (980, 250), "vertical(id)");
+size(c5c, 19);
+color(c5c, dim);
+hidden(c5c);
+
+text(stacked, (980, 420), "UPRIGHT", 34);
+color(stacked, gold);
+vertical(stacked);
+hidden(stacked);
+
+text(s5b, (640, 610), "the letters turn with the line, or stay the right way up — that is the whole difference");
+size(s5b, 17);
+color(s5b, fg);
+hidden(s5b);
+
+// ── 6 · caption is text per word ──
+
+text(s6, (640, 150), "6 · caption makes one entity PER WORD, so words can be timed");
+size(s6, 20);
+color(s6, gold);
+hidden(s6);
+
+text(c6, (640, 210), "text(id, …) is one entity   ·   caption(id, …) is {id}.w0, {id}.w1, …");
+size(c6, 19);
+color(c6, dim);
+hidden(c6);
+
+text(oneunit, (640, 320), "one entity, moves and fades as a whole");
+size(oneunit, 22);
+color(oneunit, cyan);
+hidden(oneunit);
+
+caption(perword, "one entity per word so each can be timed", (640, 440), 22, gold);
+hidden(perword);
+
+text(s6b, (640, 560), "which is what karaoke and wordpop need — and why a caption cannot wrap");
+size(s6b, 17);
+color(s6b, fg);
+hidden(s6b);
+
+// ── 7 · colour by hue, and per word ──
+
+text(s7, (640, 150), "7 · hue colours text by angle — and a caption word by word");
+size(s7, 20);
+color(s7, gold);
+hidden(s7);
+
+text(c7, (640, 210), "hue(id, degrees, [saturation], [lightness])   ·   to(id, hue, 320, 2) cycles it");
+size(c7, 19);
+color(c7, dim);
+hidden(c7);
+
+text(h1, (330, 300), "hue(h1, 200)", 26);
+hue(h1, 200);
+hidden(h1);
+
+text(h2, (950, 300), "hue(h2, 40, 0.9, 0.55)", 26);
+hue(h2, 40, 0.9, 0.55);
+hidden(h2);
+
+caption(spectrum, "one hue per word across a caption", (640, 420), 26, fg);
+for i in 0..6 { hue(spectrum.w{i}, i*54, 0.95, 0.62); }
+hidden(spectrum);
+
+text(s7b, (640, 530), "a caption is words, so each word can take its own colour");
+size(s7b, 17);
+color(s7b, fg);
+hidden(s7b);
+
+text(s7c, (640, 585), "gradients are shapes-and-strokes only — text is tinted, not filled");
+size(s7c, 18);
+color(s7c, dim);
+hidden(s7c);
+
+// ═══════════════════════════════════════════════════════════════════
+//  the run
+// ═══════════════════════════════════════════════════════════════════
+
+wait(0.6);
+
+// 1 · the default
+par { show(s1, 0.5); show(c1, 0.4); }
+par { show(hello, 0.5); show(anchor1, 0.3); }
+wait(2.4);
+
+// 2 · overflow
+par { fade(s1, 0.4); fade(c1, 0.4); fade(hello, 0.4); fade(anchor1, 0.3); }
+par { show(s2, 0.5); show(c2, 0.4); }
+par { show(room, 0.5); show(longone, 0.6); }
+wait(2.6);
+par { show(c2b, 0.4); show(narrow, 0.6); }
+wait(2.6);
+
+// 3 · alignment
+par { fade(s2, 0.4); fade(c2, 0.4); fade(c2b, 0.4); fade(room, 0.4); fade(longone, 0.4); fade(narrow, 0.4); }
+show(s3, 0.5);
+draw(rule3, 0.6);
+show(al, 0.5);
+show(ac, 0.5);
+show(ar, 0.5);
+wait(2.6);
+
+// 4 · leading
+par { fade(s3, 0.4); fade(rule3, 0.4); fade(al, 0.4); fade(ac, 0.4); fade(ar, 0.4); }
+show(s4, 0.5);
+par { show(l1, 0.5); show(l2, 0.5); show(l3, 0.5); }
+wait(2.6);
+
+// 5 · downwards
+par { fade(s4, 0.4); fade(l1, 0.4); fade(l2, 0.4); fade(l3, 0.4); }
+show(s5, 0.5);
+par { show(c5a, 0.4); show(rotated, 0.5); }
+par { show(c5b, 0.4); show(rotated2, 0.5); }
+par { show(c5c, 0.4); show(stacked, 0.5); }
+wait(0.6);
+show(s5b, 0.5);
+wait(2.6);
+
+// 6 · caption
+par {
+  fade(s5, 0.4); fade(c5a, 0.4); fade(c5b, 0.4); fade(c5c, 0.4);
+  fade(rotated, 0.4); fade(rotated2, 0.4); fade(stacked, 0.4); fade(s5b, 0.4);
+}
+par { show(s6, 0.5); show(c6, 0.4); }
+par { show(oneunit, 0.5); pulse(oneunit); }
+wait(0.8);
+show(perword, 0.4);
+karaoke(perword, 3.2);
+wait(0.4);
+show(s6b, 0.5);
+wait(2.4);
+
+// 7 · hue
+par { fade(s6, 0.4); fade(c6, 0.4); fade(oneunit, 0.4); fade(perword, 0.4); fade(s6b, 0.4); }
+par { show(s7, 0.5); show(c7, 0.4); }
+par { show(h1, 0.5); show(h2, 0.5); }
+wait(0.5);
+show(spectrum, 0.5);
+wait(0.6);
+par { show(s7b, 0.4); show(s7c, 0.4); }
+to(h1, hue, 320, 2.4);
+wait(2.6);
+
+dot(dot, (616, 336), 6);
+color(dot, cyan);

package/examples/textbook-coordinate-worlds.manic

@@ -0,0 +1,129 @@
+// ============================================================================
+// textbook-coordinate-worlds.manic — number line → coordinate plane → space
+// ============================================================================
+
+title("A Point Gets an Address — From 1D to 3D");
+canvas("9:16");
+template("blueprint");
+watermark(manicMark, (220, 175), "Made With Manic");
+creator(me, "@anish2good name=Manic_Math 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),"COORDINATE GEOMETRY"); size(kicker,21); bold(kicker); color(kicker,cyan); hidden(kicker);
+text(headline,(540,228),"A point gains one coordinate at a time"); size(headline,32); bold(headline); hidden(headline);
+text(phase,(540,300),"1D · THE NUMBER LINE"); size(phase,23); bold(phase); color(phase,gold); hidden(phase);
+text(narration,(540,1328),"One direction needs one number: move three units along x."); size(narration,26); bold(narration); wrap(narration,850); hidden(narration);
+text(principle,(540,1392),"Every new perpendicular direction adds one coordinate."); size(principle,20); color(principle,dim); hidden(principle);
+equation(address,(540,1490),`P=\textcolor{cyan}{(3)}`,44); hidden(address);
+text(takeaway,(540,1572),"THE POINT STAYS THE SAME · ITS ADDRESS BECOMES MORE PRECISE"); size(takeaway,18); bold(takeaway); color(takeaway,gold); hidden(takeaway);
+
+camera3((0,0,14),(0,0,0),38);
+
+// One persistent point begins at the origin, then gains y and z coordinates.
+point3(P,(0,0,0),0.18); color(P,gold); hidden(P);
+text(pLabel,(0,0),"P"); size(pLabel,34); bold(pLabel); color(pLabel,gold); hidden(pLabel); label3(pLabel,P,0.34);
+point3(origin,(0,0,0),0.10); color(origin,fg); hidden(origin);
+text(originLabel,(0,0),"O"); size(originLabel,34); color(originLabel,dim); hidden(originLabel); label3(originLabel,origin,0.36);
+
+line3(xAxis,(-4,0,0),(4,0,0)); color(xAxis,cyan); thick(xAxis,0.045); untraced(xAxis); hidden(xAxis); tag(xAxis,axes);
+line3(yAxis,(0,-3,0),(0,3,0)); color(yAxis,magenta); thick(yAxis,0.045); untraced(yAxis); hidden(yAxis); tag(yAxis,axes);
+line3(zAxis,(0,0,0),(0,0,4)); color(zAxis,lime); thick(zAxis,0.045); untraced(zAxis); hidden(zAxis); tag(zAxis,axes);
+
+point3(xEnd,(4,0,0),0.01); hidden(xEnd);
+point3(yEnd,(0,3,0),0.01); hidden(yEnd);
+point3(zEnd,(0,0,4),0.01); hidden(zEnd);
+text(xLabel,(0,0),"x"); size(xLabel,34); bold(xLabel); color(xLabel,cyan); hidden(xLabel); label3(xLabel,xEnd,0.38);
+text(yLabel,(0,0),"y"); size(yLabel,34); bold(yLabel); color(yLabel,magenta); hidden(yLabel); label3(yLabel,yEnd,0.38);
+text(zLabel,(0,0),"z"); size(zLabel,34); bold(zLabel); color(zLabel,lime); hidden(zLabel); label3(zLabel,zEnd,0.38);
+
+// Tick marks remain quiet so the address, rather than decoration, leads.
+for i in -4..5 {
+  line3(xTick{i},(i,-0.10,0),(i,0.10,0)); color(xTick{i},cyan); thick(xTick{i},0.025); untraced(xTick{i}); hidden(xTick{i}); tag(xTick{i},xTicks);
+}
+for i in -3..4 {
+  line3(yTick{i},(-0.10,i,0),(0.10,i,0)); color(yTick{i},magenta); thick(yTick{i},0.025); untraced(yTick{i}); hidden(yTick{i}); tag(yTick{i},yTicks);
+}
+for i in 1..5 {
+  line3(zTick{i},(-0.10,0,i),(0.10,0,i)); color(zTick{i},lime); thick(zTick{i},0.025); untraced(zTick{i}); hidden(zTick{i}); tag(zTick{i},zTicks);
+}
+
+grid3(plane,(0,0,0),4,1); color(plane,blue); opacity(plane,0.22); hidden(plane); tag(plane,world2d);
+cube3(space,(0,0,2),(8,6,4)); color(space,blue); hidden(space); tag(space,world3d);
+finish3(space,"material=glass shading=flat mesh=0.18 depth=0.22 shadow=0.10");
+
+// Guides expose how each coordinate is read from the axes.
+line3(xGuide,(0,0,0),(3,0,0)); color(xGuide,cyan); thick(xGuide,0.065); untraced(xGuide); hidden(xGuide); tag(xGuide,guides);
+line3(yGuide,(3,0,0),(3,2,0)); color(yGuide,magenta); thick(yGuide,0.065); untraced(yGuide); hidden(yGuide); tag(yGuide,guides);
+line3(zGuide,(3,2,0),(3,2,3)); color(zGuide,lime); thick(zGuide,0.065); untraced(zGuide); hidden(zGuide); tag(zGuide,guides);
+
+point3(xFoot,(3,0,0),0.11); color(xFoot,cyan); hidden(xFoot);
+point3(xyFoot,(3,2,0),0.11); color(xyFoot,magenta); hidden(xyFoot);
+project3(shadow,P,"xy"); color(shadow,magenta); hidden(shadow);
+link3(drop,P,shadow,0.12); color(drop,lime); thick(drop,0.025); hidden(drop);
+
+step("one number locates the point") {
+  seq {
+    par { show(kicker,0.35); show(headline,0.55); show(phase,0.40); show(narration,0.45); show(principle,0.40); show(address,0.50); view3(xAxis,"top",0.9,smooth,1.65); }
+    par { show(origin,0.20); show(originLabel,0.25); show(P,0.25); show(pLabel,0.25); draw(xAxis,1.10,smooth); show(xLabel,0.25); show(xTicks,0.35); }
+    par { shift3(P,(3,0,0),1.65,smooth); draw(xGuide,1.65,smooth); }
+    par { show(xFoot,0.25); pulse(P,0.65); pulse(address,0.65); }
+    wait(0.60);
+  }
+}
+
+step("the plane adds a second direction") {
+  seq {
+    par {
+      say(phase,"2D · THE COORDINATE PLANE",0.45,smooth);
+      say(narration,"Open a perpendicular y-direction, then move two units sideways.",0.55,smooth);
+      rewrite(address,`P=\textcolor{cyan}{(3},\textcolor{magenta}{2)}`,0.95,smooth);
+      show(plane,0.80); draw(yAxis,1.35,smooth); show(yLabel,0.30); show(yTicks,0.40);
+      view3(plane,"top",1.55,smooth,1.55);
+    }
+    par { shift3(P,(0,2,0),1.75,smooth); draw(yGuide,1.75,smooth); }
+    par { show(xyFoot,0.25); pulse(guides,0.80); pulse(address,0.80); }
+    wait(0.70);
+  }
+}
+
+step("read the ordered pair") {
+  seq {
+    say(narration,"First read x, then y. Order matters: (3,2) is not (2,3).",0.50,smooth);
+    par { pulse(xGuide,0.60); pulse(yGuide,0.60); }
+    wait(0.85);
+  }
+}
+
+step("space adds height") {
+  seq {
+    par {
+      say(phase,"3D · COORDINATE SPACE",0.45,smooth);
+      say(narration,"Raise a z-axis out of the plane and lift the point three units.",0.55,smooth);
+      rewrite(address,`P=\textcolor{cyan}{(3},\textcolor{magenta}{2},\textcolor{lime}{3)}`,1.05,smooth);
+      to(space,opacity,0.14,2.40,smooth);
+      draw(zAxis,1.55,smooth); show(zLabel,0.30); show(zTicks,0.40);
+      view3(space,"isometric",2.35,smooth,1.48);
+    }
+    par {
+      shift3(P,(0,0,3),2.15,smooth);
+      draw(zGuide,2.15,smooth);
+      show(shadow,0.30); show(drop,0.30);
+    }
+    par { pulse(P,0.70); pulse(address,0.70); }
+    wait(0.70);
+  }
+}
+
+step("one point three coordinates") {
+  seq {
+    par {
+      show(takeaway,0.45);
+      say(phase,"ONE ADDRESS · THREE DIRECTIONS",0.50,smooth);
+      say(narration,"x says across, y says sideways, and z says how high.",0.55,smooth);
+      say(principle,"1D: (x) · 2D: (x,y) · 3D: (x,y,z)",0.55,smooth);
+      view3(space,"fit",1.70,smooth,1.55);
+    }
+    par { pulse(axes,0.90); pulse(P,0.90); roll3(3,1.55,smooth); }
+    wait(1.80);
+  }
+}

package/examples/textbook-doubly-list.manic

@@ -0,0 +1,33 @@
+// ============================================================================
+//  textbook-doubly-list.manic  —  the paper/support treatment on the ALGO kit
+// ----------------------------------------------------------------------------
+//  Proof the textbook look is DOMAIN-AGNOSTIC: the same `template("paper")` page,
+//  the same std `support` hatch primitive, and the same `color`/`say` staging —
+//  here on the algo kit's doubly linked list instead of a physics sim. Nothing
+//  about `support`/`paper` knows about physics; they compose over any kit.
+// ============================================================================
+
+title("Doubly linked list — textbook style");
+canvas("16:9");
+template("paper");                       // the white exam-paper page (engine theme)
+
+text(hdr, (cx, 66), "Doubly linked list");
+color(hdr, fg); size(hdr, 30); bold(hdr); display(hdr);
+support(rule, (cx, 102), 380, "down");   // a hatched section rule — a std primitive, in an ALGO scene
+
+// the algo-kit structure — the paper theme's palette REMAP turns the sim's
+// neon colours into ink automatically (light boxes, dark text, muted pointers),
+// so no recolouring is needed. The bare id `dll` also broadcasts now, e.g.
+// `hidden(dll)` / `flash(dll, cyan)` address the whole list at once.
+list(dll, "3 8 5 2", (cx, 340), doubly, 80, 58);
+
+text(cap, (cx, 628), ""); color(cap, fg); size(cap, 22); display(cap);
+
+say(cap, "each node = [ ·prev | data | next· ] — data plus two pointers");
+wait(1.1);
+say(cap, "insert 7 after node 1: the prev/next pointers re-thread — nothing shifts");
+insert(dll, 1, "7");
+wait(0.9);
+say(cap, "remove the head: the list simply re-points past it");
+remove(dll, 0);
+wait(1.2);

package/examples/textbook-function-to-solid.manic

@@ -0,0 +1,126 @@
+// ============================================================================
+// textbook-function-to-solid.manic — interval → graph → solid of revolution
+// ============================================================================
+
+title("The Revolving Semicircle — From 1D to 3D");
+canvas("9:16");
+template("neon");
+watermark(manicMark,(220,175),"Made With Manic");
+creator(me,"@anish2good name=Manic_Math 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),"SOLIDS OF REVOLUTION"); size(kicker,21); bold(kicker); color(kicker,cyan); hidden(kicker);
+text(headline,(540,228),"A 1D domain grows into a 3D sphere"); size(headline,41); bold(headline); hidden(headline);
+text(phase,(540,300),"1D · CHOOSE THE DOMAIN"); size(phase,23); bold(phase); color(phase,gold); hidden(phase);
+text(narration,(540,1328),"Begin with every x-value from −2 to 2 on a number line."); size(narration,26); bold(narration); wrap(narration,850); hidden(narration);
+text(principle,(540,1392),"The interval controls where the graph exists."); size(principle,20); color(principle,dim); hidden(principle);
+equation(formula,(540,1488),`x\in\textcolor{cyan}{[-2,2]}`,44); hidden(formula);
+text(takeaway,(540,1572),"DOMAIN → PROFILE → ROTATION → VOLUME"); size(takeaway,18); bold(takeaway); color(takeaway,gold); hidden(takeaway);
+
+camera3((0,-14,1.8),(0,0,0.7),39);
+
+// The x-axis and interval are the 1D seed for the whole construction.
+line3(xAxis,(-2.6,0,0),(2.6,0,0)); color(xAxis,dim); thick(xAxis,0.035); untraced(xAxis); hidden(xAxis);
+line3(domain,(-2,0,0),(2,0,0)); color(domain,cyan); thick(domain,0.09); untraced(domain); hidden(domain); tag(domain,profile);
+point3(leftEnd,(-2,0,0),0.13); color(leftEnd,cyan); hidden(leftEnd);
+point3(rightEnd,(2,0,0),0.13); color(rightEnd,cyan); hidden(rightEnd);
+point3(origin,(0,0,0),0.09); color(origin,fg); hidden(origin);
+point3(xEnd,(2.6,0,0),0.01); hidden(xEnd);
+text(xLabel,(0,0),"x"); size(xLabel,23); bold(xLabel); color(xLabel,fg); hidden(xLabel); label3(xLabel,xEnd,0.30);
+
+// The upper semicircle is a textbook profile: y = sqrt(4 - x^2).
+curve3(semicircle,"-2+4*t","0","sqrt(4-(-2+4*t)^2)",(0,1)); color(semicircle,magenta); thick(semicircle,0.065); untraced(semicircle); hidden(semicircle); tag(semicircle,profile);
+param3(region,
+  "-2+4*u",
+  "0",
+  "v*sqrt(4-(-2+4*u)^2)",
+  (0,1),(0,1),32);
+color(region,magenta); hidden(region); tag(region,profile);
+finish3(region,"material=glass shading=flat mesh=0.18 depth=0.18 shadow=0.08");
+
+// Three sample heights explain how the graph rises from the domain.
+line3(heightA,(-1,0,0),(-1,0,1.732)); color(heightA,gold); thick(heightA,0.035); untraced(heightA); hidden(heightA); tag(heightA,samples); tag(heightA,profile);
+line3(heightB,(0,0,0),(0,0,2)); color(heightB,gold); thick(heightB,0.035); untraced(heightB); hidden(heightB); tag(heightB,samples); tag(heightB,profile);
+line3(heightC,(1,0,0),(1,0,1.732)); color(heightC,gold); thick(heightC,0.035); untraced(heightC); hidden(heightC); tag(heightC,samples); tag(heightC,profile);
+point3(apex,(0,0,2),0.10); color(apex,gold); hidden(apex); tag(apex,profile);
+
+// Rotating the filled profile around x generates a radius-2 sphere.
+param3(sphere,
+  "2*cos(u)",
+  "2*sin(u)*cos(v)",
+  "2*sin(u)*sin(v)",
+  (0,3.1416),(0,6.2832),38);
+color(sphere,blue); hidden(sphere); tag(sphere,solid);
+finish3(sphere,"material=glass shading=smooth mesh=0.24 depth=0.34 shadow=0.16");
+curve3(equator,"0","2*cos(t)","2*sin(t)",(0,6.2832)); color(equator,cyan); thick(equator,0.035); untraced(equator); hidden(equator); tag(equator,solid);
+curve3(meridian,"2*cos(t)","0","2*sin(t)",(0,6.2832)); color(meridian,magenta); thick(meridian,0.035); untraced(meridian); hidden(meridian); tag(meridian,solid);
+
+step("mark the one dimensional domain") {
+  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.50); view3(domain,"front",0.9,smooth,1.72); }
+    par { draw(xAxis,0.90,smooth); draw(domain,1.35,smooth); show(leftEnd,0.25); show(rightEnd,0.25); show(origin,0.25); show(xLabel,0.25); }
+    par { pulse(domain,0.75); pulse(formula,0.75); }
+    wait(0.65);
+  }
+}
+
+step("the function supplies height") {
+  seq {
+    par {
+      say(phase,"2D · DRAW THE PROFILE",0.45,smooth);
+      say(narration,"At each x, the function supplies a height above the axis.",0.55,smooth);
+      say(principle,"The interval becomes the base of an upper semicircle.",0.45,smooth);
+      rewrite(formula,`y=\textcolor{magenta}{\sqrt{4-x^2}},\quad -2\le x\le2`,1.05,smooth);
+      draw(semicircle,2.10,smooth);
+      stagger(0.22) { show(heightA,0.20); show(heightB,0.20); show(heightC,0.20); }
+      stagger(0.22) { draw(heightA,0.65,smooth); draw(heightB,0.65,smooth); draw(heightC,0.65,smooth); }
+    }
+    par { show(apex,0.25); pulse(samples,0.75); }
+    wait(0.70);
+  }
+}
+
+step("fill the generating region") {
+  seq {
+    par {
+      say(narration,"The curve and the x-axis enclose the region that will rotate.",0.50,smooth);
+      to(region,opacity,0.26,1.65,smooth);
+      view3(region,"front",1.40,smooth,1.62);
+    }
+    par { pulse(region,0.75); pulse(semicircle,0.75); }
+    wait(0.75);
+  }
+}
+
+step("rotate the profile into space") {
+  seq {
+    par {
+      say(phase,"3D · ROTATE ABOUT THE x-AXIS",0.45,smooth);
+      say(narration,"Sweep the entire semicircle through 360° around its diameter.",0.55,smooth);
+      say(principle,"Every point traces a circle; together those circles form a sphere.",0.50,smooth);
+      rewrite(formula,`x^2+y^2+z^2=\textcolor{gold}{4}`,1.05,smooth);
+      turn3(profile,(0,0,0),x,360,3.10,smooth);
+      to(sphere,opacity,0.34,3.10,smooth);
+      show(equator,0.45); draw(equator,2.15,smooth);
+      show(meridian,0.45); draw(meridian,2.15,smooth);
+      view3(solid,"isometric",2.60,smooth,1.55);
+    }
+    par { pulse(solid,0.85); roll3(4,1.50,smooth); }
+    wait(0.75);
+  }
+}
+
+step("read the solid of revolution") {
+  seq {
+    par {
+      show(takeaway,0.45);
+      say(phase,"THE SAME RADIUS · A NEW DIMENSION",0.50,smooth);
+      say(narration,"The 2D radius is still 2, but rotation has filled 3D volume.",0.55,smooth);
+      say(principle,"A semicircle rotated about its diameter generates a sphere.",0.50,smooth);
+      rewrite(formula,`V=\frac{4}{3}\pi(2)^3=\textcolor{gold}{\frac{32\pi}{3}}`,1.15,smooth);
+      view3(solid,"fit",1.65,smooth,1.58);
+    }
+    par { pulse(sphere,0.90); pulse(formula,0.90); roll3(3,1.50,smooth); }
+    wait(1.90);
+  }
+}