@maniclang/workbench 0.1.11

package/examples/manic-ml-logits-sampling.manic

@@ -0,0 +1,112 @@
+// manic-ml-logits-sampling.manic — ML7 acceptance story
+// The same LM projection is viewed at two temperatures, then top-p sampling
+// filters, renormalizes, and makes one reproducible next-token choice.
+
+title("Manic ML — How a Transformer Chooses the Next Token");
+canvas("16:9");
+template("mono");
+
+creator(me, "@anish2good name=Manic_ML tagline=Models_made_visible yt=zarigatongy x=@anish2good web=8gwifi.org/manic accent=cyan secondary=magenta footer=compact cta=Follow_the_computation safe=clean");
+socials(me);
+
+let u = (w+h-abs(w-h))/1440;
+
+if h > 1.45*w {
+  watermark(manicMark, (w*0.15, h*0.06), "Made With Manic");
+  text(kicker, (cx, h*0.07), "MANIC ML · LOGITS → PROBABILITIES → TOKEN");
+  text(headline, (cx, h*0.115), "How does a transformer choose its next word?");
+  text(caption, (cx, h*0.83), "One hidden vector. One full distribution. One reproducible choice.");
+
+  tokenize(words, (cx, h*0.17), "the model learned to", word, w*0.78);
+  embedding(context, words, (cx, h*0.42), "seeded 6 37", sinusoidal, w*0.88, h*0.34);
+  transformer(block, context, (cx, h*0.47), "heads=2 mask=causal mlp=12 activation=gelu norm=pre dropout=0 mode=inference seed=41", w*0.90, h*0.50);
+  logits(cool, block, 4, (cx, h*0.51), "reason | predict | learn | adapt | explain | .", 0.55, w*0.86, h*0.54, 73);
+  logits(warm, block, 4, (cx, h*0.51), "reason | predict | learn | adapt | explain | .", 1.45, w*0.86, h*0.54, 73);
+}
+else if w > 1.25*h {
+  watermark(manicMark, (w*0.17, h*0.09), "Made With Manic");
+  text(kicker, (cx, h*0.065), "MANIC ML · LOGITS → PROBABILITIES → TOKEN");
+  text(headline, (cx, h*0.13), "How does a transformer choose its next word?");
+  text(caption, (cx, h*0.82), "One hidden vector. One full distribution. One reproducible choice.");
+
+  tokenize(words, (cx, h*0.21), "the model learned to", word, w*0.64);
+  embedding(context, words, (cx, h*0.50), "seeded 6 37", sinusoidal, w*0.88, h*0.42);
+  transformer(block, context, (cx, h*0.50), "heads=2 mask=causal mlp=12 activation=gelu norm=pre dropout=0 mode=inference seed=41", w*0.90, h*0.58);
+  logits(cool, block, 4, (cx, h*0.51), "reason | predict | learn | adapt | explain | .", 0.55, w*0.78, h*0.54, 73);
+  logits(warm, block, 4, (cx, h*0.51), "reason | predict | learn | adapt | explain | .", 1.45, w*0.78, h*0.54, 73);
+}
+else {
+  watermark(manicMark, (w*0.18, h*0.08), "Made With Manic");
+  text(kicker, (cx, h*0.065), "MANIC ML · LOGITS → PROBABILITIES → TOKEN");
+  text(headline, (cx, h*0.155), "How does a transformer choose its next word?");
+  text(caption, (cx, h*0.82), "One hidden vector. One full distribution. One reproducible choice.");
+
+  tokenize(words, (cx, h*0.21), "the model learned to", word, w*0.70);
+  embedding(context, words, (cx, h*0.50), "seeded 6 37", sinusoidal, w*0.88, h*0.40);
+  transformer(block, context, (cx, h*0.50), "heads=2 mask=causal mlp=12 activation=gelu norm=pre dropout=0 mode=inference seed=41", w*0.90, h*0.55);
+  logits(cool, block, 4, (cx, h*0.51), "reason | predict | learn | adapt | explain | .", 0.55, w*0.82, h*0.54, 73);
+  logits(warm, block, 4, (cx, h*0.51), "reason | predict | learn | adapt | explain | .", 1.45, w*0.82, h*0.54, 73);
+}
+
+size(kicker, 17*u); color(kicker, dim); bold(kicker); hidden(kicker);
+size(headline, 29*u); bold(headline); wrap(headline, w*0.88); hidden(headline);
+size(caption, 18*u); color(caption, dim); wrap(caption, w*0.86); hidden(caption);
+hidden(words);
+hidden(context);
+hidden(block);
+hidden(cool);
+hidden(warm);
+
+step("prompt") {
+  par {
+    show(kicker, 0.28);
+    show(headline, 0.42);
+    show(words.labels, 0.28);
+    show(words.source, 0.34);
+    show(words.tokens, 0.62);
+    show(words.indices, 0.62);
+    show(caption, 0.28);
+    say(caption, "The prompt becomes an ordered token lane.", 0.34);
+  }
+}
+wait(0.45);
+
+step("hidden-state") {
+  seq {
+    fade(words, 0.28);
+    par {
+      show(block.output, 0.70);
+      show(block.labels, 0.26);
+      say(caption, "The transformer MLP ends at a hidden representation—not probabilities.", 0.40);
+    }
+    pulse(block.output, 0.72);
+  }
+}
+wait(0.45);
+
+step("cool-temperature") {
+  seq {
+    fade(block, 0.30);
+    sample(cool, "greedy", 3.4, smooth);
+    say(caption, "Low temperature sharpens every candidate. Greedy keeps only the maximum.", 0.42);
+  }
+}
+wait(0.65);
+
+step("warm-temperature") {
+  seq {
+    fade(cool, 0.30);
+    sample(warm, "top-p 0.90 seed=17", 3.8, smooth);
+    say(caption, "Higher temperature spreads the full softmax. Top-p keeps the smallest 90% nucleus, renormalizes it, then samples.", 0.46);
+  }
+}
+wait(0.75);
+
+step("takeaway") {
+  par {
+    pulse(warm.temperature, 0.70);
+    pulse(warm.probabilities, 0.70);
+    say(caption, "Temperature reshapes probability. Sampling turns that distribution into one reproducible next token.", 0.44);
+  }
+}
+wait(1.30);

package/examples/manic-ml-scalar-to-tensor.manic

@@ -0,0 +1,143 @@
+// manic-ml-scalar-to-tensor.manic — ML foundation story
+// One value gains an axis, then rows, then stacked channels. The ML-specific
+// surface is only tensor(...); ordinary Manic verbs own the explanation.
+
+title("Manic ML — From Scalar to Tensor");
+canvas("16:9");
+template("mono");
+
+creator(me, "@anish2good name=Manic_ML tagline=Models_made_visible yt=zarigatongy x=@anish2good web=8gwifi.org/manic accent=cyan secondary=magenta footer=compact cta=Build_the_dimensions safe=clean");
+socials(me);
+
+let u = (w+h-abs(w-h))/1440;
+let cell = 38*u;
+
+if h > 1.45*w {
+  watermark(manicMark, (w*0.15, h*0.06), "Made With Manic");
+  text(kicker, (cx, h*0.065), "MANIC ML · DATA FOUNDATIONS");
+  text(headline, (cx, h*0.105), "One value gains dimensions");
+  text(caption, (cx, h*0.84), "Begin with one measured value.");
+
+  tensor(scalar, (cx, h*0.20), "7", cell, gold);
+  tensor(vector, (cx, h*0.35), "7 2 -1 4", cell, cyan);
+  tensor(matrix, (cx, h*0.53), "7 2 -1; 4 0 3; 1 5 6", cell, magenta);
+  tensor(volume, (cx, h*0.72), "7 2 -1; 4 0 3; 1 5 6 | 2 4 8; 1 3 9; 0 5 6", cell, lime);
+
+  text(scalarTitle, (cx, h*0.155), "SCALAR · RANK 0");
+  text(vectorTitle, (cx, h*0.295), "VECTOR · RANK 1");
+  text(matrixTitle, (cx, h*0.445), "MATRIX · RANK 2");
+  text(volumeTitle, (cx, h*0.625), "TENSOR · RANK 3");
+
+  arrow(grow1, (cx, h*0.245), (cx, h*0.285));
+  arrow(grow2, (cx, h*0.395), (cx, h*0.435));
+  arrow(grow3, (cx, h*0.585), (cx, h*0.615));
+}
+else if w > 1.25*h {
+  watermark(manicMark, (w*0.17, h*0.09), "Made With Manic");
+  text(kicker, (cx, h*0.075), "MANIC ML · DATA FOUNDATIONS");
+  text(headline, (cx, h*0.14), "One value gains dimensions");
+  text(caption, (cx, h*0.82), "Begin with one measured value.");
+
+  tensor(scalar, (w*0.11, h*0.46), "7", cell, gold);
+  tensor(vector, (w*0.34, h*0.46), "7 2 -1 4", cell, cyan);
+  tensor(matrix, (w*0.61, h*0.46), "7 2 -1; 4 0 3; 1 5 6", cell, magenta);
+  tensor(volume, (w*0.86, h*0.46), "7 2 -1; 4 0 3; 1 5 6 | 2 4 8; 1 3 9; 0 5 6", cell, lime);
+
+  text(scalarTitle, (w*0.11, h*0.34), "SCALAR · RANK 0");
+  text(vectorTitle, (w*0.34, h*0.34), "VECTOR · RANK 1");
+  text(matrixTitle, (w*0.61, h*0.34), "MATRIX · RANK 2");
+  text(volumeTitle, (w*0.86, h*0.34), "TENSOR · RANK 3");
+
+  arrow(grow1, (w*0.17, h*0.46), (w*0.23, h*0.46));
+  arrow(grow2, (w*0.44, h*0.46), (w*0.51, h*0.46));
+  arrow(grow3, (w*0.70, h*0.46), (w*0.76, h*0.46));
+}
+else {
+  watermark(manicMark, (w*0.18, h*0.08), "Made With Manic");
+  text(kicker, (cx, h*0.06), "MANIC ML · DATA FOUNDATIONS");
+  text(headline, (cx, h*0.17), "One value gains dimensions");
+  text(caption, (cx, h*0.84), "Begin with one measured value.");
+
+  tensor(scalar, (w*0.24, h*0.34), "7", cell, gold);
+  tensor(vector, (w*0.73, h*0.34), "7 2 -1 4", cell, cyan);
+  tensor(matrix, (w*0.24, h*0.65), "7 2 -1; 4 0 3; 1 5 6", cell, magenta);
+  tensor(volume, (w*0.73, h*0.65), "7 2 -1; 4 0 3; 1 5 6 | 2 4 8; 1 3 9; 0 5 6", cell, lime);
+
+  text(scalarTitle, (w*0.24, h*0.235), "SCALAR · RANK 0");
+  text(vectorTitle, (w*0.73, h*0.235), "VECTOR · RANK 1");
+  text(matrixTitle, (w*0.24, h*0.505), "MATRIX · RANK 2");
+  text(volumeTitle, (w*0.73, h*0.505), "TENSOR · RANK 3");
+
+  arrow(grow1, (w*0.34, h*0.34), (w*0.50, h*0.34));
+  arrow(grow2, (w*0.73, h*0.40), (w*0.36, h*0.56));
+  arrow(grow3, (w*0.35, h*0.65), (w*0.50, h*0.65));
+}
+
+size(kicker, 19*u); color(kicker, dim); bold(kicker); hidden(kicker);
+size(headline, 34*u); bold(headline); wrap(headline, w*0.82); hidden(headline);
+size(caption, 21*u); color(caption, dim); wrap(caption, w*0.78); hidden(caption);
+
+size(scalarTitle, 17*u); bold(scalarTitle); color(scalarTitle, dim); hidden(scalarTitle);
+size(vectorTitle, 17*u); bold(vectorTitle); color(vectorTitle, dim); hidden(vectorTitle);
+size(matrixTitle, 17*u); bold(matrixTitle); color(matrixTitle, dim); hidden(matrixTitle);
+size(volumeTitle, 17*u); bold(volumeTitle); color(volumeTitle, dim); hidden(volumeTitle);
+
+color(grow1, dim); stroke(grow1, 2.5*u); hidden(grow1);
+color(grow2, dim); stroke(grow2, 2.5*u); hidden(grow2);
+color(grow3, dim); stroke(grow3, 2.5*u); hidden(grow3);
+
+hidden(scalar.cells); hidden(scalar.values); hidden(scalar.labels);
+hidden(vector.cells); hidden(vector.values); hidden(vector.labels);
+hidden(matrix.cells); hidden(matrix.values); hidden(matrix.labels);
+hidden(volume.cells); hidden(volume.values); hidden(volume.labels);
+
+step("scalar") {
+  show(kicker, 0.35);
+  show(headline, 0.45);
+  show(caption, 0.40);
+  show(scalarTitle, 0.30);
+  par {
+    show(scalar.cells, 0.55);
+    show(scalar.values, 0.55);
+  }
+}
+wait(0.55);
+
+step("vector") {
+  par {
+    show(grow1, 0.35);
+    show(vectorTitle, 0.30);
+    show(vector.cells, 0.60);
+    show(vector.values, 0.60);
+    say(caption, "Repeat the value along one ordered axis: position now matters.", 0.40);
+  }
+}
+wait(0.60);
+
+step("matrix") {
+  par {
+    show(grow2, 0.35);
+    show(matrixTitle, 0.30);
+    show(matrix.cells, 0.65);
+    show(matrix.values, 0.65);
+    say(caption, "Add rows to the columns: one axis becomes a two-dimensional matrix.", 0.40);
+  }
+}
+wait(0.65);
+
+step("tensor") {
+  par {
+    show(grow3, 0.35);
+    show(volumeTitle, 0.30);
+    show(volume.cells, 0.70);
+    show(volume.values, 0.70);
+    say(caption, "Stack matrices as channels: the same values now carry depth and context.", 0.40);
+  }
+}
+wait(0.75);
+
+step("one-family") {
+  pulse(volume.channel1, 0.75);
+  say(caption, "Scalar, vector, and matrix are all tensors—distinguished by their axes.", 0.45);
+}
+wait(1.50);

package/examples/manic-ml-token-embedding.manic

@@ -0,0 +1,110 @@
+// manic-ml-token-embedding.manic — ML5 acceptance story
+// A repeated word keeps one seeded educational token embedding, while exact
+// sinusoidal position makes each occurrence a different model input.
+
+title("Manic ML — From Words to Positioned Embeddings");
+canvas("16:9");
+template("mono");
+
+creator(me, "@anish2good name=Manic_ML tagline=Models_made_visible yt=zarigatongy x=@anish2good web=8gwifi.org/manic accent=cyan secondary=magenta footer=compact cta=Follow_the_representation safe=clean");
+socials(me);
+
+let u = (w+h-abs(w-h))/1440;
+
+if h > 1.45*w {
+  watermark(manicMark, (w*0.16, h*0.055), "Made With Manic");
+  text(kicker, (cx, h*0.055), "MANIC ML · EMBEDDINGS");
+  text(headline, (cx, h*0.095), "A word needs meaning—and a place");
+  text(caption, (cx, h*0.84), "Start with text. Keep every boundary and every number inspectable.");
+
+  tokenize(words, (cx, h*0.19), "the cat chased the cat", word, w*0.80);
+  embedding(context, words, (cx, h*0.50), "seeded 6 37", sinusoidal, w*0.90, h*0.48);
+}
+else if w > 1.25*h {
+  watermark(manicMark, (w*0.16, h*0.08), "Made With Manic");
+  text(kicker, (cx, h*0.07), "MANIC ML · EMBEDDINGS");
+  text(headline, (cx, h*0.125), "A word needs meaning—and a place");
+  text(caption, (cx, h*0.84), "Start with text. Keep every boundary and every number inspectable.");
+
+  tokenize(words, (cx, h*0.23), "the cat chased the cat", word, w*0.68);
+  embedding(context, words, (cx, h*0.54), "seeded 6 37", sinusoidal, w*0.90, h*0.48);
+}
+else {
+  watermark(manicMark, (w*0.18, h*0.08), "Made With Manic");
+  text(kicker, (cx, h*0.06), "MANIC ML · EMBEDDINGS");
+  text(headline, (cx, h*0.17), "A word needs meaning—and a place");
+  text(caption, (cx, h*0.83), "Start with text. Keep every boundary and every number inspectable.");
+
+  tokenize(words, (cx, h*0.30), "the cat chased the cat", word, w*0.76);
+  embedding(context, words, (cx, h*0.60), "seeded 6 37", sinusoidal, w*0.90, h*0.38);
+}
+
+size(kicker, 18*u); color(kicker, dim); bold(kicker); hidden(kicker);
+size(headline, 32*u); bold(headline); wrap(headline, w*0.84); hidden(headline);
+size(caption, 20*u); color(caption, dim); wrap(caption, w*0.82); hidden(caption);
+hidden(words);
+hidden(context);
+
+step("sentence") {
+  show(kicker, 0.30);
+  show(headline, 0.42);
+  show(words.labels, 0.35);
+  show(words.source, 0.40);
+  show(caption, 0.35);
+}
+wait(0.55);
+
+step("tokens") {
+  par {
+    show(words.tokens, 0.75);
+    show(words.indices, 0.75);
+    say(caption, "Word tokenization turns the sentence into five ordered identities.", 0.38);
+  }
+}
+wait(0.60);
+
+step("lookup") {
+  fade(words, 0.35);
+  par {
+    show(context.labels, 0.40);
+    show(context.tokens, 0.55);
+    show(context.vectors, 0.95);
+    say(caption, "A seeded educational lookup gives each token identity one six-number vector.", 0.40);
+  }
+}
+wait(0.60);
+
+step("same-word") {
+  par {
+    pulse(context.row1, 0.70);
+    pulse(context.row4, 0.70);
+    say(caption, "Both copies of cat reuse the same base embedding. The lookup depends on the token—not its location.", 0.42);
+  }
+}
+wait(0.65);
+
+step("position") {
+  par {
+    show(context.positions, 1.00);
+    show(context.operators, 0.45);
+    say(caption, "Sinusoidal position adds a deterministic coordinate for places 0 through 4.", 0.42);
+  }
+}
+wait(0.65);
+
+step("model-input") {
+  par {
+    show(context.combined, 1.00);
+    say(caption, "Token vector plus position becomes the model input. The repeated word now carries two different locations.", 0.42);
+  }
+}
+wait(0.70);
+
+step("takeaway") {
+  par {
+    pulse(context.row1, 0.72);
+    pulse(context.row4, 0.72);
+    say(caption, "Meaning says what the token is. Position says where this occurrence belongs.", 0.42);
+  }
+}
+wait(1.40);

package/examples/manic-ml-transformer-attention.manic

@@ -0,0 +1,102 @@
+// manic-ml-transformer-attention.manic — ML4 acceptance story
+// Explicit token embeddings become Q/K/V, one query row becomes normalized
+// attention weights, values mix, a residual is added, and a real output
+// projection produces top-k probabilities.
+
+title("Manic ML — One Transformer Attention Head");
+canvas("16:9");
+template("mono");
+
+creator(me, "@anish2good name=Manic_ML tagline=Models_made_visible yt=zarigatongy x=@anish2good web=8gwifi.org/manic accent=cyan secondary=magenta footer=compact cta=Follow_the_attention safe=clean");
+socials(me);
+
+let u = (w+h-abs(w-h))/1440;
+
+if h > 1.45*w {
+  watermark(manicMark, (w*0.15, h*0.06), "Made With Manic");
+  text(kicker, (cx, h*0.065), "MANIC ML · SELF-ATTENTION");
+  text(headline, (cx, h*0.105), "One token finds context");
+  text(caption, (cx, h*0.84), "Start with explicit token embeddings—not decorative wires.");
+
+  attention(head, (cx, h*0.38), "Art | ificial | intelligence | transforms | business",
+    "1 0.2 -0.4 0.7; 0.8 0.1 -0.3 0.6; -0.2 1 0.5 0.3; 0.1 0.6 0.9 -0.2; 0.7 -0.1 0.4 1",
+    w*0.82, h*0.40, 23);
+  topk(next, head, 3, (cx, h*0.71), "business | work | world | industry | future | people", 4, w*0.72, h*0.18, 29);
+}
+else if w > 1.25*h {
+  watermark(manicMark, (w*0.17, h*0.09), "Made With Manic");
+  text(kicker, (cx, h*0.075), "MANIC ML · SELF-ATTENTION");
+  text(headline, (cx, h*0.14), "One token finds context");
+  text(caption, (cx, h*0.83), "Start with explicit token embeddings—not decorative wires.");
+
+  attention(head, (w*0.40, h*0.48), "Art | ificial | intelligence | transforms | business",
+    "1 0.2 -0.4 0.7; 0.8 0.1 -0.3 0.6; -0.2 1 0.5 0.3; 0.1 0.6 0.9 -0.2; 0.7 -0.1 0.4 1",
+    w*0.68, h*0.58, 23);
+  topk(next, head, 3, (w*0.84, h*0.52), "business | work | world | industry | future | people", 4, w*0.26, h*0.34, 29);
+}
+else {
+  watermark(manicMark, (w*0.18, h*0.08), "Made With Manic");
+  text(kicker, (cx, h*0.06), "MANIC ML · SELF-ATTENTION");
+  text(headline, (cx, h*0.13), "One token finds context");
+  text(caption, (cx, h*0.84), "Start with explicit token embeddings—not decorative wires.");
+
+  attention(head, (cx, h*0.39), "Art | ificial | intelligence | transforms | business",
+    "1 0.2 -0.4 0.7; 0.8 0.1 -0.3 0.6; -0.2 1 0.5 0.3; 0.1 0.6 0.9 -0.2; 0.7 -0.1 0.4 1",
+    w*0.84, h*0.42, 23);
+  topk(next, head, 3, (cx, h*0.72), "business | work | world | industry | future | people", 4, w*0.72, h*0.18, 29);
+}
+
+size(kicker, 19*u); color(kicker, dim); bold(kicker); hidden(kicker);
+size(headline, 34*u); bold(headline); wrap(headline, w*0.82); hidden(headline);
+size(caption, 21*u); color(caption, dim); wrap(caption, w*0.78); hidden(caption);
+hidden(head); hidden(next);
+
+step("tokens") {
+  show(kicker, 0.35);
+  show(headline, 0.45);
+  show(caption, 0.40);
+  show(head.labels, 0.40);
+  show(head.tokens, 0.60);
+}
+wait(0.55);
+
+step("projections") {
+  par {
+    show(head.q, 0.55);
+    show(head.k, 0.55);
+    show(head.v, 0.55);
+    say(caption, "Each embedding is projected into a Query, Key, and Value vector.", 0.40);
+  }
+}
+wait(0.60);
+
+step("scores") {
+  show(head.matrix, 0.70);
+  say(caption, "Scaled dot products become one softmax row: every weight is positive and the row sums to 100%.", 0.45);
+}
+wait(0.65);
+
+step("attend") {
+  par {
+    attend(head, 3, 5.20, smooth);
+    say(caption, "Focus intelligence: Q asks, K measures relevance, and weighted V carries the context.", 0.45);
+    seq {
+      par { cam((cx, h*0.46), 0.75, smooth); zoom(1.07, 0.75, smooth); }
+      wait(3.45);
+      par { cam((cx, cy), 0.85, smooth); zoom(1.0, 0.85, smooth); }
+    }
+  }
+}
+wait(0.75);
+
+step("prediction") {
+  show(next, 0.70);
+  say(caption, "The residual plus attention mix enters an output projection and a truthful softmax ranking.", 0.45);
+}
+wait(0.80);
+
+step("takeaway") {
+  pulse(next.rank0, 0.75);
+  say(caption, "Attention is selective information flow—not every connection shouting at once.", 0.45);
+}
+wait(1.50);

package/examples/manic-ml-transformer-block.manic

@@ -0,0 +1,116 @@
+// manic-ml-transformer-block.manic — ML6 acceptance story
+// One persistent token lane passes through multi-head causal attention,
+// concatenation, two residual paths, pre-normalization, and a GELU MLP.
+
+title("Manic ML — Inside One Transformer Block");
+canvas("16:9");
+template("mono");
+
+creator(me, "@anish2good name=Manic_ML tagline=Models_made_visible yt=zarigatongy x=@anish2good web=8gwifi.org/manic accent=cyan secondary=magenta footer=compact cta=Follow_the_computation safe=clean");
+socials(me);
+
+let u = (w+h-abs(w-h))/1440;
+
+if h > 1.45*w {
+  watermark(manicMark, (w*0.15, h*0.06), "Made With Manic");
+  text(kicker, (cx, h*0.065), "MANIC ML · TRANSFORMER BLOCK");
+  text(headline, (cx, h*0.105), "Inside one transformer block");
+  text(caption, (cx, h*0.84), "Follow one token lane through every computed stage.");
+
+  tokenize(words, (cx, h*0.15), "the cat slept because it dreamed", word, w*0.82);
+  embedding(context, words, (cx, h*0.41), "seeded 6 37", sinusoidal, w*0.90, h*0.38);
+  transformer(block, context, (cx, h*0.49), "heads=2 mask=causal mlp=12 activation=gelu norm=pre dropout=0 mode=inference seed=41", w*0.90, h*0.56);
+}
+else if w > 1.25*h {
+  watermark(manicMark, (w*0.17, h*0.09), "Made With Manic");
+  text(kicker, (cx, h*0.065), "MANIC ML · TRANSFORMER BLOCK");
+  text(headline, (cx, h*0.14), "Inside one transformer block");
+  text(caption, (cx, h*0.82), "Follow one token lane through every computed stage.");
+
+  tokenize(words, (cx, h*0.22), "the cat slept because it dreamed", word, w*0.72);
+  embedding(context, words, (cx, h*0.54), "seeded 6 37", sinusoidal, w*0.90, h*0.48);
+  transformer(block, context, (cx, h*0.52), "heads=2 mask=causal mlp=12 activation=gelu norm=pre dropout=0 mode=inference seed=41", w*0.92, h*0.62);
+}
+else {
+  watermark(manicMark, (w*0.18, h*0.08), "Made With Manic");
+  text(kicker, (cx, h*0.06), "MANIC ML · TRANSFORMER BLOCK");
+  text(headline, (cx, h*0.13), "Inside one transformer block");
+  text(caption, (cx, h*0.83), "Follow one token lane through every computed stage.");
+
+  tokenize(words, (cx, h*0.23), "the cat slept because it dreamed", word, w*0.78);
+  embedding(context, words, (cx, h*0.52), "seeded 6 37", sinusoidal, w*0.90, h*0.44);
+  transformer(block, context, (cx, h*0.52), "heads=2 mask=causal mlp=12 activation=gelu norm=pre dropout=0 mode=inference seed=41", w*0.90, h*0.57);
+}
+
+size(kicker, 18*u); color(kicker, dim); bold(kicker); hidden(kicker);
+size(headline, 30*u); bold(headline); wrap(headline, w*0.86); hidden(headline);
+size(caption, 19*u); color(caption, dim); wrap(caption, w*0.84); hidden(caption);
+hidden(words);
+hidden(context);
+hidden(block);
+
+step("tokens") {
+  par {
+    show(kicker, 0.28);
+    show(headline, 0.42);
+    show(words.labels, 0.30);
+    show(words.source, 0.36);
+    show(words.tokens, 0.70);
+    show(words.indices, 0.70);
+    show(caption, 0.32);
+    say(caption, "Six ordered tokens begin as one persistent lane.", 0.36);
+  }
+}
+wait(0.55);
+
+step("model-input") {
+  seq {
+    fade(words, 0.32);
+    par {
+      show(context.labels, 0.32);
+      show(context.tokens, 0.42);
+      show(context.vectors, 0.82);
+      say(caption, "Each identity receives a stable lookup vector.", 0.36);
+    }
+    par {
+      show(context.positions, 0.72);
+      show(context.operators, 0.34);
+      show(context.combined, 0.78);
+      say(caption, "Position is added exactly. These six vectors are the block input.", 0.38);
+    }
+  }
+}
+wait(0.60);
+
+step("encode") {
+  seq {
+    par {
+      fade(context, 0.34);
+      fade(caption, 0.24);
+    }
+    par {
+      encode(block, 6.2, smooth);
+      seq {
+        par { cam((cx - w*0.25, h*0.52), 0.75, smooth); zoom(1.08, 0.75, smooth); }
+        wait(1.35);
+        cam((cx + w*0.17, h*0.52), 1.15, smooth);
+        wait(1.50);
+        par { cam((cx, cy), 0.85, smooth); zoom(1.0, 0.85, smooth); }
+      }
+    }
+  }
+}
+wait(0.70);
+
+step("takeaway") {
+  seq {
+    show(caption, 0.20);
+    par {
+      pulse(block.residual1, 0.72);
+      pulse(block.residual2, 0.72);
+      pulse(block.output, 0.72);
+      say(caption, "Attention shares context. The MLP reshapes each token. Residuals keep its identity continuous.", 0.42);
+    }
+  }
+}
+wait(1.35);

package/examples/manic-promo.manic

@@ -0,0 +1,64 @@
+// manic-promo — a generative promo built from the `cloud` primitive alone.
+// Five particle swarms fly in and assemble into words: MANIC at the centre,
+// with 3B1B, Manim, Animation and Generative claiming the four corners. Each
+// word is `cloud(...) from text("…")` — the glyphs are filled with points whose
+// homes arrive as `hx`/`hy`; the block re-centres and scales that home to its
+// slot, then blends the swarm in from a golden-angle scatter over time `t`.
+// One primitive, five words, no art assets. Change the words and it just works.
+//
+//   manic examples/manic-promo.manic
+title("manic — generative animation, from a swarm");
+canvas(1080, 1080);
+template("black");
+
+// --- centre: MANIC, big, a cycling rainbow ---------------------------------
+cloud(manic, 2000, #ffffff, 0.96) from text("MANIC") {
+  let a = 0.5 * (1 + tanh((t - mod(i * 7, 29) * 0.04 - 1.0) * 2.2));
+  let px = (hx - 540) * 0.62 + 540;
+  let py = (hy - 540) * 0.62 + 540;
+  let sx = 540 + cos(i * 2.39996) * (420 + mod(i * 97, 260));
+  let sy = 540 + sin(i * 2.39996) * (420 + mod(i * 97, 260));
+  let x = sx * (1 - a) + px * a;
+  let y = sy * (1 - a) + py * a;
+  let r = 2.4;
+  let hue = mod(hx * 0.4 + t * 22, 360);
+}
+
+// --- four corners: the world manic plays in --------------------------------
+cloud(tl, 780, #3b8ee0, 0.95) from text("3B1B") {
+  let a = 0.5 * (1 + tanh((t - 2.4) * 2.2));
+  let px = (hx - 540) * 0.34 + 250;
+  let py = (hy - 540) * 0.34 + 240;
+  let x = (250 + cos(i * 2.39996) * 460) * (1 - a) + px * a;
+  let y = (240 + sin(i * 2.39996) * 460) * (1 - a) + py * a;
+  let r = 2;
+}
+
+cloud(tr, 820, #46e2c8, 0.95) from text("Manim") {
+  let a = 0.5 * (1 + tanh((t - 2.7) * 2.2));
+  let px = (hx - 540) * 0.34 + 830;
+  let py = (hy - 540) * 0.34 + 240;
+  let x = (830 + cos(i * 2.39996) * 460) * (1 - a) + px * a;
+  let y = (240 + sin(i * 2.39996) * 460) * (1 - a) + py * a;
+  let r = 2;
+}
+
+cloud(bl, 1000, #f0a54e, 0.95) from text("Animation") {
+  let a = 0.5 * (1 + tanh((t - 3.0) * 2.2));
+  let px = (hx - 540) * 0.30 + 250;
+  let py = (hy - 540) * 0.30 + 840;
+  let x = (250 + cos(i * 2.39996) * 460) * (1 - a) + px * a;
+  let y = (840 + sin(i * 2.39996) * 460) * (1 - a) + py * a;
+  let r = 2;
+}
+
+cloud(br, 1050, #b06ef0, 0.95) from text("Generative") {
+  let a = 0.5 * (1 + tanh((t - 3.3) * 2.2));
+  let px = (hx - 540) * 0.30 + 830;
+  let py = (hy - 540) * 0.30 + 840;
+  let x = (830 + cos(i * 2.39996) * 460) * (1 - a) + px * a;
+  let y = (840 + sin(i * 2.39996) * 460) * (1 - a) + py * a;
+  let r = 2;
+}
+
+wait(12);