@algorisys/tinyfly 0.117.0 → 0.118.0
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 +6 -6
- package/docs/editor-guide.md +1 -1
- package/docs/examples.md +1 -1
- package/docs/getting-started.md +1 -1
- package/docs/gsap-compat.md +1 -1
- package/docs/llm-guide.md +3 -1
- package/docs/maps.md +2 -2
- package/docs/math.md +35 -9
- package/docs/teaching.md +1 -1
- package/lib/addons/characters.js +1654 -1649
- package/lib/addons/math.js +1684 -1254
- package/lib/browser/tinyfly-math.iife.js +4 -4
- package/lib/browser/tinyfly.iife.js +1 -1
- package/lib/browser/tinyfly.js +6 -1
- package/lib/browser/tinyfly.umd.js +1 -1
- package/lib/types/math/discrete/graph-search.d.ts +38 -0
- package/lib/types/math/discrete/set-expression.d.ts +33 -0
- package/lib/types/math/figure/display-list.d.ts +8 -0
- package/lib/types/math/figure/figure-spec.d.ts +68 -1
- package/lib/types/math/figure/items/discrete.d.ts +23 -0
- package/lib/types/math/figure/items/shapes.d.ts +3 -0
- package/lib/types/math/index.d.ts +4 -1
- package/lib/types/math/presets/discrete.d.ts +49 -0
- package/lib/types/math/tex/glyph-metrics.d.ts +8 -0
- package/lib/types/math/tex/tex-parser.d.ts +2 -1
- package/llms-full.txt +51 -18
- package/llms.txt +31 -31
- package/package.json +1 -1
- package/skills/tinyfly/SKILL.md +2 -1
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), 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 and
|
|
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))
|
|
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.
|
|
287
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/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.
|
|
324
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/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.
|
|
423
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/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.
|
|
532
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/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, equation steps, embeds and explorables (`src/math`) |
|
|
842
|
+
| Maths figures, TeX, calculus, probability, discrete maths, equation steps, embeds and explorables (`src/math`) | 105 |
|
|
843
843
|
| Entry boundaries | 3 |
|
|
844
844
|
|
|
845
845
|
## Contributing
|
package/docs/editor-guide.md
CHANGED
|
@@ -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.
|
|
1146
|
+
`https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/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.
|
|
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`.
|
|
747
747
|
|
|
748
748
|
---
|
|
749
749
|
|
package/docs/getting-started.md
CHANGED
|
@@ -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.
|
|
188
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly.iife.js"></script>
|
|
189
189
|
<script>
|
|
190
190
|
tinyfly.to('.box', { x: 200, duration: 1 })
|
|
191
191
|
</script>
|
package/docs/gsap-compat.md
CHANGED
|
@@ -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.
|
|
77
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/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
|
@@ -274,7 +274,9 @@ lesson page (`<figure data-tinyfly-math>`), an explorable and a video
|
|
|
274
274
|
`point` with `on` and `x`) take numbers or number-value names for `at`, `n`,
|
|
275
275
|
`to`, `order`, and publish `\\val{ID.slope}`, `ID.sum`, `ID.value` for TeX. Probability items
|
|
276
276
|
(`histogram`, `distribution`, `galton`, `scatter`, `bayes`) take a distribution as data
|
|
277
|
-
(`{ kind: 'normal', mean: 'mu', sd: 1 }`) and draw seeded samples, never `Math.random`.
|
|
277
|
+
(`{ kind: 'normal', mean: 'mu', sd: 1 }`) and draw seeded samples, never `Math.random`. Discrete:
|
|
278
|
+
`graph` (nodes with `at`, or `tree: { root }`; `search` stepped by `step`), `venn` (`highlight: "(A | B)'"`),
|
|
279
|
+
`clock` (`modulus`, `value`). See `docs/math.md`.
|
|
278
280
|
|
|
279
281
|
## Your own behaviours
|
|
280
282
|
|
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.
|
|
18
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
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>
|
|
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
|
@@ -83,6 +83,9 @@ Some names are reserved, because a track on them would move the whole figure:
|
|
|
83
83
|
| `galton` | `rows?`, `balls` (fractional: the next ball on its way), `spacing?`, `top?`, `seed?` |
|
|
84
84
|
| `scatter` | `points: { kind: 'uniform', x, y }` or `{ kind: 'linear', slope, intercept, noise, x }`, `count`, `inside?` (an expression in x and y, true when ≤ 0), `fit?`, `seed?` |
|
|
85
85
|
| `bayes` | `prior`, `truePositive`, `falsePositive`, `at?`, `size?`, `labels?` |
|
|
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
|
+
| `venn` | `sets` (two or three `{ id, label?, color? }`), `highlight?` (a set expression), `highlightColor?`, `at?`, `radius?`, `universe?` |
|
|
88
|
+
| `clock` | `modulus`, `value`, `at?`, `radius?` |
|
|
86
89
|
|
|
87
90
|
`point` also rides a curve: `{ on: 'sin(x)', x: 'p' }` is the point (p, sin p), and
|
|
88
91
|
`hollow: true` draws an open circle for a hole or a limit. `function` takes
|
|
@@ -108,6 +111,23 @@ Items work out numbers that TeX can show with `\val{…}`:
|
|
|
108
111
|
| `galton` | `ID.landed` |
|
|
109
112
|
| `scatter` | `ID.count`, `ID.inside`, `ID.ratio`, `ID.slope`, `ID.intercept`, `ID.r` |
|
|
110
113
|
| `bayes` | `ID.prior`, `ID.posterior`, `ID.positive`, `ID.truePositive`, `ID.falsePositive` |
|
|
114
|
+
| `graph` with a search | `ID.visited`, `ID.steps`, and for Dijkstra `ID.d.NODE` (∞ until known) |
|
|
115
|
+
| `clock` | `ID.hour` (value mod modulus), `ID.turns` |
|
|
116
|
+
|
|
117
|
+
### Graphs, searches and sets
|
|
118
|
+
|
|
119
|
+
A search is shown step by step: `step` counts the nodes finished, and its
|
|
120
|
+
fractional part draws the edge the search is crossing to the next one. Finished
|
|
121
|
+
nodes are yellow; nodes waiting in the queue (breadth first), the stack (depth
|
|
122
|
+
first) or the open set (Dijkstra) are blue; yellow edges are how each node was
|
|
123
|
+
reached. Neighbours are taken in the order the nodes are listed, so a search
|
|
124
|
+
always tells the same story (`searchEvents` returns it as data). A tree lays
|
|
125
|
+
itself out from its root when nodes have no `at` (`treeLayout`), which is how
|
|
126
|
+
`recursionTreeFigure` draws the calls a recursive function makes.
|
|
127
|
+
|
|
128
|
+
Venn regions are set expressions: `A | B`, `A & B`, `A - B`, `A ^ B`, `A'` (or
|
|
129
|
+
`!A`), with brackets; `∪ ∩ ∖ △ ¬` work too. Each cell of the region is drawn as
|
|
130
|
+
the universe clipped inside and outside the circles, the same in canvas and SVG.
|
|
111
131
|
|
|
112
132
|
### Distributions and randomness
|
|
113
133
|
|
|
@@ -187,7 +207,7 @@ lesson's step options (`duration`, `easing`, `delay`).
|
|
|
187
207
|
<figcaption>The determinant is the area of the unit square after the map.</figcaption>
|
|
188
208
|
</figure>
|
|
189
209
|
|
|
190
|
-
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.
|
|
210
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/cdn/tinyfly-math.iife.js" data-tinyfly-auto></script>
|
|
191
211
|
```
|
|
192
212
|
|
|
193
213
|
The figure draws itself into an SVG and redraws from the timeline whenever the
|
|
@@ -253,9 +273,9 @@ Equations are typeset by a built-in TeX subset, with no KaTeX or MathJax:
|
|
|
253
273
|
- `\sum`, `\prod` and `\int`, with limits above and below in display style
|
|
254
274
|
- Named operators: `\sin \cos \tan \log \ln \exp \det \lim \max \min` …
|
|
255
275
|
- Greek letters
|
|
256
|
-
- Symbols: `\cdot \times \pm \le \ge \ne \approx \to \infty \partial \nabla \in` …
|
|
276
|
+
- Symbols: `\cdot \times \pm \le \ge \ne \approx \to \infty \partial \nabla \in \cup \cap \triangle \varnothing` …
|
|
257
277
|
- Matrices: `\begin{pmatrix|bmatrix|vmatrix|matrix} … \end{…}`
|
|
258
|
-
- `\text{…}`, `\color{name}{…}`, and spacing `\, \; \quad`
|
|
278
|
+
- `\binom{n}{k}`, `\text{…}`, `\color{name}{…}`, and spacing `\, \; \quad`
|
|
259
279
|
- `\left( … \right)`, with delimiters at their natural size
|
|
260
280
|
- `\id{name}{…}`, which names a term
|
|
261
281
|
- `\val{name}` and `\val{name:digits}` for live values
|
|
@@ -293,6 +313,11 @@ their own.
|
|
|
293
313
|
| `monteCarloPiFigure({ count })` | Points in a square; the share inside the circle ≈ π/4 |
|
|
294
314
|
| `regressionFigure({ slope, intercept, noise, count })` | Noisy points and the least-squares line |
|
|
295
315
|
| `bayesFigure({ prior, sensitivity, falsePositive })` | A medical test as areas: P(condition given a positive) |
|
|
316
|
+
| `graphSearchFigure({ search, start })` | Breadth- or depth-first search on a sample graph, with its queue or stack (`step`) |
|
|
317
|
+
| `shortestPathFigure({ start, target })` | Dijkstra on the weighted sample graph, distances shown (`step`) |
|
|
318
|
+
| `recursionTreeFigure({ n })` | The call tree of naive recursive Fibonacci, in call order (`step`) |
|
|
319
|
+
| `vennFigure({ sets, highlight, label })` | Two or three sets with a region shaded |
|
|
320
|
+
| `clockFigure({ modulus, value })` | Clock arithmetic (`value`) |
|
|
296
321
|
|
|
297
322
|
Each returns a plain figure to change or extend. In each, `M` starts at the
|
|
298
323
|
identity unless `matrix` is given.
|
|
@@ -301,13 +326,14 @@ identity unless `matrix` is given.
|
|
|
301
326
|
|
|
302
327
|
- Gallery: **Linear Map**, **Eigenvectors**, **Equation Steps**, **Matrix Lesson**,
|
|
303
328
|
**Derivative**, **Riemann Sums**, **Taylor Series**, **Galton Board**, **Central Limit
|
|
304
|
-
Theorem**, **Monte Carlo
|
|
305
|
-
|
|
306
|
-
|
|
307
|
-
`
|
|
329
|
+
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/`.
|
|
308
334
|
|
|
309
335
|
## Next
|
|
310
336
|
|
|
311
|
-
|
|
312
|
-
|
|
337
|
+
AI/ML (networks with flowing activations, gradient descent on a loss surface,
|
|
338
|
+
decision boundaries) builds on the same figure model.
|
|
313
339
|
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.
|
|
28
|
+
<script src="https://cdn.jsdelivr.net/gh/algorisys-oss/tinyfly@v0.118.0/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
|