@algorisys/tinyfly 0.118.0 → 0.119.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -47,7 +47,7 @@ A lightweight, API-driven animation engine and visual editor for creating high-p
47
47
  - **Full screen** - `data-fullscreen="true"` adds a button that fills the screen with the figure, through the Fullscreen API or, on iPhone, an overlay; the drawing scales to the screen whatever the page's figure CSS says
48
48
  - **Scenarios** - Several timelines on one figure, and the reader chooses which plays: a group of options, a stepped slider, or clickable parts of the SVG (`data-tinyfly-choose`). Switching undoes the previous scenario's drawing and keeps the reader at the same step
49
49
  - **Authoring kit** - `lesson()` step builder and diagram primitives (array cells, pointer, stack, queue / channel, table, pipeline) in `@algorisys/tinyfly/teach`
50
- - **Maths animations** - `@algorisys/tinyfly/math`: figures as JSON (a grid a matrix warps, î and ĵ, vectors, function plots that break at asymptotes, polygons whose area shows the determinant, eigenlines, TeX labels; calculus: tangents and secants with exact slopes, Riemann sums, signed areas, Taylor polynomials from symbolic derivatives, limits; probability: seeded histograms, distributions with shaded probabilities, a Galton board, the central limit theorem, Monte Carlo π, regression and Bayes as areas; discrete: graphs searched step by step (BFS, DFS, Dijkstra) with their queue or stack, recursion trees, Venn diagrams of any set expression, clock arithmetic), a built-in TeX subset (fractions, roots, sums and integrals with limits, matrices, Greek, live values) whose equations rewrite step by step with terms gliding, and ready linear algebra, calculus, probability and discrete maths figures. One layout feeds lesson-page embeds (`<figure data-tinyfly-math>`, stepped with captions and questions), explorables where readers drag î and ĵ, and 9:16 or 16:9 videos ([guide](docs/math.md))
50
+ - **Maths animations** - `@algorisys/tinyfly/math`: figures as JSON (a grid a matrix warps, î and ĵ, vectors, function plots that break at asymptotes, polygons whose area shows the determinant, eigenlines, TeX labels; calculus: tangents and secants with exact slopes, Riemann sums, signed areas, Taylor polynomials from symbolic derivatives, limits; probability: seeded histograms, distributions with shaded probabilities, a Galton board, the central limit theorem, Monte Carlo π, regression and Bayes as areas; discrete: graphs searched step by step (BFS, DFS, Dijkstra) with their queue or stack, recursion trees, Venn diagrams of any set expression, clock arithmetic; AI/ML: neural networks with activations flowing, gradient descent on contoured loss surfaces, attention heatmaps, logistic regression finding its decision boundary, k-means), a built-in TeX subset (fractions, roots, sums and integrals with limits, matrices, Greek, live values) whose equations rewrite step by step with terms gliding, and ready linear algebra, calculus, probability, discrete maths and AI/ML figures. One layout feeds lesson-page embeds (`<figure data-tinyfly-math>`, stepped with captions and questions), explorables where readers drag î and ĵ, and 9:16 or 16:9 videos ([guide](docs/math.md))
51
51
  - **Build tools** - `npx @algorisys/tinyfly validate` catches broken figures in CI; `render` writes a frame to static SVG for RSS, email and print
52
52
 
53
53
  ### Video from Code
@@ -284,7 +284,7 @@ GSAP-shaped functions at the top level. Teaching embeds are included: add
284
284
  itself.
285
285
 
286
286
  ```html
287
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly.iife.js"></script>
287
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly.iife.js"></script>
288
288
  <script>
289
289
  tinyfly.to('.box', { x: 200, rotate: 90, duration: 1, ease: 'power2.out' })
290
290
 
@@ -321,7 +321,7 @@ A teaching figure needs no code at all:
321
321
  <script type="application/json" data-tinyfly-timeline>{ …timeline JSON with markers… }</script>
322
322
  <figcaption>Appending to a full slice</figcaption>
323
323
  </figure>
324
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly.iife.js" data-tinyfly-auto></script>
324
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly.iife.js" data-tinyfly-auto></script>
325
325
  ```
326
326
 
327
327
  See [Teaching Animations](docs/teaching.md).
@@ -420,7 +420,7 @@ Without a build step, the player bundle puts the same functions on a `tinyfly` g
420
420
  <div data-tinyfly="box" style="width: 60px; height: 60px; background: #4a9eff;"></div>
421
421
  </div>
422
422
 
423
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly-player.iife.js"></script>
423
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly-player.iife.js"></script>
424
424
  <script>
425
425
  tinyfly.play('#animation', './animation.json', { loop: -1 })
426
426
  </script>
@@ -529,7 +529,7 @@ Or skip the code entirely with declarative embeds (see [Teaching Animations](doc
529
529
  <svg viewBox="0 0 720 200">…</svg>
530
530
  <script type="application/json" data-tinyfly-timeline>{ …timeline JSON… }</script>
531
531
  </figure>
532
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
532
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
533
533
  ```
534
534
 
535
535
  ### Audio / Video Sync
@@ -839,7 +839,7 @@ Characters browser suite checks 74 desktop/mobile scenarios per browser.
839
839
  | Docs viewer and `llms.txt` (`src/docs`) | 18 |
840
840
  | Embeds, teaching kit, framework hooks, landing (`src/embed`, `src/teach`, `src/frameworks`, `src/landing`) | 33 |
841
841
  | Headless rendering and audio (`src/headless`) | 63 |
842
- | Maths figures, TeX, calculus, probability, discrete maths, equation steps, embeds and explorables (`src/math`) | 105 |
842
+ | Maths figures, TeX, calculus, probability, discrete maths, AI/ML, equation steps, embeds and explorables (`src/math`) | 119 |
843
843
  | Entry boundaries | 3 |
844
844
 
845
845
  ## Contributing
@@ -1143,7 +1143,7 @@ The dialog shows the generated HTML/JavaScript code with a **Copy Code** button.
1143
1143
  **Steps to embed:**
1144
1144
  1. Build the player: `npm run build:player`
1145
1145
  2. Copy `lib/player/tinyfly-player.iife.js` to your project (or load
1146
- `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly-player.iife.js`
1146
+ `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly-player.iife.js`
1147
1147
  instead; see [Deployment](DEPLOYMENT.md))
1148
1148
  3. Copy the generated code into your HTML
1149
1149
  4. Adjust the script `src` path if needed
package/docs/examples.md CHANGED
@@ -743,7 +743,7 @@ For simple website embedding without a build system.
743
743
  </html>
744
744
  ```
745
745
 
746
- Build the player with `npm run build:player` to generate `lib/player/tinyfly-player.iife.js`, or load it from the CDN: `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly-player.iife.js`.
746
+ Build the player with `npm run build:player` to generate `lib/player/tinyfly-player.iife.js`, or load it from the CDN: `https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly-player.iife.js`.
747
747
 
748
748
  ---
749
749
 
@@ -185,7 +185,7 @@ with a GSAP-style call (durations are in seconds here):
185
185
  ```html
186
186
  <div class="box" style="width:60px;height:60px;background:#4a9eff"></div>
187
187
 
188
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly.iife.js"></script>
188
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly.iife.js"></script>
189
189
  <script>
190
190
  tinyfly.to('.box', { x: 200, duration: 1 })
191
191
  </script>
@@ -74,7 +74,7 @@ Without a build step, the all-in-one bundle exposes the same functions on a
74
74
  global — `tinyfly.to()`, `tinyfly.timeline()` and so on:
75
75
 
76
76
  ```html
77
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly.iife.js"></script>
77
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly.iife.js"></script>
78
78
  <script>
79
79
  tinyfly.to('.box', { x: 200, duration: 1 })
80
80
  </script>
package/docs/llm-guide.md CHANGED
@@ -276,7 +276,9 @@ lesson page (`<figure data-tinyfly-math>`), an explorable and a video
276
276
  (`histogram`, `distribution`, `galton`, `scatter`, `bayes`) take a distribution as data
277
277
  (`{ kind: 'normal', mean: 'mu', sd: 1 }`) and draw seeded samples, never `Math.random`. Discrete:
278
278
  `graph` (nodes with `at`, or `tree: { root }`; `search` stepped by `step`), `venn` (`highlight: "(A | B)'"`),
279
- `clock` (`modulus`, `value`). See `docs/math.md`.
279
+ `clock` (`modulus`, `value`). AI/ML: `network` (`flow`), `descent` (`steps`, exact gradient),
280
+ `contours`, `heatmap` (`softmax: true` for attention), `classifier` (`epochs`), `kmeans`
281
+ (`iteration`); all seeded. See `docs/math.md`.
280
282
 
281
283
  ## Your own behaviours
282
284
 
package/docs/maps.md CHANGED
@@ -14,8 +14,8 @@ On a page with no build step, load the maps add-on after the browser bundle; it
14
14
  adds to the same `tinyfly` global:
15
15
 
16
16
  ```html
17
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly.iife.js"></script>
18
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly-maps.iife.js"></script>
17
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly.iife.js"></script>
18
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly-maps.iife.js"></script>
19
19
  ```
20
20
 
21
21
  It is a separate script because the offline world map it carries adds about
package/docs/math.md CHANGED
@@ -86,6 +86,12 @@ Some names are reserved, because a track on them would move the whole figure:
86
86
  | `graph` | `nodes: [{ id, at?, label? }]`, `edges` (`[from, to, weight?]` or objects), `directed?`, `tree?: { root, spacing?, at? }`, `search?: { kind: 'bfs' \| 'dfs' \| 'dijkstra', start }`, `step?`, `frontier?` (screen px), `weights?`, `radius?` |
87
87
  | `venn` | `sets` (two or three `{ id, label?, color? }`), `highlight?` (a set expression), `highlightColor?`, `at?`, `radius?`, `universe?` |
88
88
  | `clock` | `modulus`, `value`, `at?`, `radius?` |
89
+ | `network` | `layers` (`[3, 5, 4, 2]`), `activation?: 'sigmoid' \| 'tanh' \| 'relu'`, `inputs?`, `flow?`, `seed?`, `at?`, `size?`, `labels?: { inputs?, outputs? }`, `radius?` |
90
+ | `heatmap` | `cells` (rows, top first; `softmax?` per row) or `expr` in x and y with `region?`, `resolution?`; `range?`, `colormap?: 'viridis' \| 'heat' \| 'diverging'`, `rowLabels?`, `colLabels?`, `values?`, `at?`, `size?` |
91
+ | `contours` | `expr` in x and y, `levels?` (a count or the levels), `region?`, `resolution?`, `colormap?` |
92
+ | `descent` | `expr` in x and y, `start`, `rate`, `steps`, `momentum?` |
93
+ | `classifier` | `epochs`, `centres?`, `count?`, `spread?`, `rate?`, `start?: [w₁, w₂, b]`, `probability?`, `seed?` |
94
+ | `kmeans` | `centres` (the true clusters), `iteration`, `k?`, `count?`, `spread?`, `seed?` |
89
95
 
90
96
  `point` also rides a curve: `{ on: 'sin(x)', x: 'p' }` is the point (p, sin p), and
91
97
  `hollow: true` draws an open circle for a hole or a limit. `function` takes
@@ -113,6 +119,31 @@ Items work out numbers that TeX can show with `\val{…}`:
113
119
  | `bayes` | `ID.prior`, `ID.posterior`, `ID.positive`, `ID.truePositive`, `ID.falsePositive` |
114
120
  | `graph` with a search | `ID.visited`, `ID.steps`, and for Dijkstra `ID.d.NODE` (∞ until known) |
115
121
  | `clock` | `ID.hour` (value mod modulus), `ID.turns` |
122
+ | `network` | `ID.out0`, `ID.out1` … (the outputs) |
123
+ | `descent` | `ID.x`, `ID.y`, `ID.loss`, `ID.step` |
124
+ | `classifier` | `ID.accuracy`, `ID.loss`, `ID.epoch` |
125
+ | `kmeans` | `ID.inertia`, `ID.iteration`, `ID.iterations` |
126
+
127
+ ### Machine learning
128
+
129
+ Everything is seeded and worked out exactly, so a figure trains the same way
130
+ every time:
131
+
132
+ - **Networks** draw seeded weights: blue edges add, red ones subtract, and
133
+ thicker edges count more. `flow` moves activations layer by layer, with
134
+ pulses on the edges being fed.
135
+ - **Descent** takes exact partial derivatives of its expression, so the path
136
+ follows the true gradient. A step size that diverges stops cleanly.
137
+ - **Classifiers** train logistic regression by full-batch gradient descent,
138
+ starting from a deliberately wrong line that visibly turns into place.
139
+ - **k-means** runs Lloyd's algorithm from the points nearest the middle of the
140
+ data, so the centroids travel; a fractional `iteration` glides them.
141
+ - **Heatmaps and contours** colour through a colormap. Dimmed cells are
142
+ pre-mixed with the background, so neighbours never leave seams. Contours are
143
+ traced by marching squares and joined into whole curves.
144
+
145
+ The pieces are also available on their own: `seededNetwork`, `forward`,
146
+ `descentPath`, `trainLogistic`, `kmeansHistory`, `contourLines`, `colorAt`.
116
147
 
117
148
  ### Graphs, searches and sets
118
149
 
@@ -207,7 +238,7 @@ lesson's step options (`duration`, `easing`, `delay`).
207
238
  <figcaption>The determinant is the area of the unit square after the map.</figcaption>
208
239
  </figure>
209
240
 
210
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly-math.iife.js" data-tinyfly-auto></script>
241
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly-math.iife.js" data-tinyfly-auto></script>
211
242
  ```
212
243
 
213
244
  The figure draws itself into an SVG and redraws from the timeline whenever the
@@ -318,6 +349,12 @@ their own.
318
349
  | `recursionTreeFigure({ n })` | The call tree of naive recursive Fibonacci, in call order (`step`) |
319
350
  | `vennFigure({ sets, highlight, label })` | Two or three sets with a region shaded |
320
351
  | `clockFigure({ modulus, value })` | Clock arithmetic (`value`) |
352
+ | `neuralNetworkFigure({ layers, activation, inputs })` | A forward pass (`flow`, inputs `in0` …) |
353
+ | `gradientDescentFigure({ expr, start, rate, momentum })` | Descent on a narrow valley over its contours (`steps`, `rate`, `momentum`) |
354
+ | `attentionFigure({ tokens, scores })` | Attention weights, softmaxed per row, with token labels |
355
+ | `decisionBoundaryFigure({ rate, spread })` | Logistic regression finding the line between two clusters (`epochs`) |
356
+ | `kmeansFigure({ centres, k })` | k-means finding clusters (`iteration`) |
357
+ | `activationFigure()` | Sigmoid, tanh and ReLU |
321
358
 
322
359
  Each returns a plain figure to change or extend. In each, `M` starts at the
323
360
  identity unless `matrix` is given.
@@ -327,13 +364,15 @@ identity unless `matrix` is given.
327
364
  - Gallery: **Linear Map**, **Eigenvectors**, **Equation Steps**, **Matrix Lesson**,
328
365
  **Derivative**, **Riemann Sums**, **Taylor Series**, **Galton Board**, **Central Limit
329
366
  Theorem**, **Monte Carlo π**, **Bayes: a Positive Test**, **Graph Search**, **Recursion
330
- Tree**, **Set Operations** and **Clock Arithmetic**.
331
- - Videos: `linear-map-short.mjs`, `riemann-short.mjs`, `galton-short.mjs` and
332
- `graph-search-short.mjs` (9:16); `eigen-explainer.mjs`, `taylor-explainer.mjs`,
333
- `clt-explainer.mjs` and `de-morgan-explainer.mjs` (16:9), in `examples/headless-video/`.
367
+ Tree**, **Set Operations**, **Clock Arithmetic**, **Neural Network**, **Gradient Descent**,
368
+ **Decision Boundary**, **K-Means** and **Attention Weights**.
369
+ - Videos: `linear-map-short.mjs`, `riemann-short.mjs`, `galton-short.mjs`,
370
+ `graph-search-short.mjs` and `gradient-descent-short.mjs` (9:16); `eigen-explainer.mjs`,
371
+ `taylor-explainer.mjs`, `clt-explainer.mjs`, `de-morgan-explainer.mjs` and
372
+ `neural-network-explainer.mjs` (16:9), in `examples/headless-video/`.
334
373
 
335
374
  ## Next
336
375
 
337
- AI/ML (networks with flowing activations, gradient descent on a loss surface,
338
- decision boundaries) builds on the same figure model.
376
+ Characters can already stand beside a figure in a video; letting them point at
377
+ named parts of it (a vector's tip, an equation term) is planned. See `todo.md`.
339
378
  See `todo.md` for their status.
package/docs/teaching.md CHANGED
@@ -25,7 +25,7 @@ path for all of that:
25
25
  </figure>
26
26
 
27
27
  <!-- once, anywhere on the page (a site-wide footer is fine) -->
28
- <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
28
+ <script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.119.1/cdn/tinyfly-embed.iife.js" data-tinyfly-auto></script>
29
29
  ```
30
30
 
31
31
  Every `[data-tinyfly-embed]` mounts when the page is ready, with no per-post